Appeon Developer User Guide
Total Page：16
File Type：pdf, Size：1020Kb
Appeon Developer User Guide Appeon® for PowerBuilder® 2015 FOR WINDOWS & UNIX & LINUX DOCUMENT ID: ADC20231-01-0700-01 LAST REVISED: October 15, 2014 Copyright © 2000-2014 by Appeon Corporation. All rights reserved. This publication pertains to Appeon software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Appeon Corporation. Appeon, the Appeon logo, Appeon Developer, Appeon Enterprise Manager, AEM, Appeon Server and Appeon Server Web Component are registered trademarks of Appeon Corporation. Sybase, Adaptive Server Anywhere, Adaptive Server Enterprise, iAnywhere, PowerBuilder, Sybase Central, and Sybase jConnect for JDBC are trademarks or registered trademarks of Sybase, Inc. Java and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. All other company and product names used herein may be trademarks or registered trademarks of their respective companies. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies. Appeon Corporation, 1/F, Shell Industrial Building, 12 Lee Chung Street, Chai Wan District, Hong Kong. Contents 1 About This Book .................................................................................................... 1 1.1 Audience ...................................................................................................... 1 1.2 How to use this book .................................................................................. 1 1.3 Related documents ...................................................................................... 2 1.4 If you need help .......................................................................................... 4 2 Introduction ............................................................................................................. 5 2.1 Appeon Developer toolbar in PowerBuilder ................................................. 5 2.2 Web and/or Mobile application development with Appeon Developer ......... 6 3 Before You Begin .................................................................................................. 8 3.1 Installing Appeon for PowerBuilder ............................................................. 8 3.2 Configuring application database connectivity ............................................. 8 3.3 Starting Appeon Server ............................................................................... 8 4 Configuring Appeon Developer ............................................................................ 11 4.1 Using Appeon Developer Configuration Wizard ........................................ 11 4.1.1 Configuring basic settings ............................................................... 12 4.1.2 Selecting PBL file(s) ........................................................................ 14 4.1.3 Configuring deployment settings ..................................................... 15 4.1.4 Selecting DB Type(s) ...................................................................... 16 4.1.5 Declaring transaction object(s) ........................................................ 16 4.1.6 Selecting image files ....................................................................... 19 4.1.7 Selecting INI files ............................................................................. 19 4.1.8 Selecting External files .................................................................... 20 4.1.9 Summary .......................................................................................... 21 4.2 Using Configure Tool ................................................................................. 22 4.2.1 Managing application profiles .......................................................... 22 4.2.1.1 Application Profiles tab page ................................................. 23 4.2.1.2 Application profile settings ..................................................... 24 4.2.2 Managing database type profiles ..................................................... 49 4.2.3 Managing server profiles ................................................................. 52 4.2.3.1 Server Profiles tab page ........................................................ 52 4.2.3.2 Appeon Server profile settings .............................................. 53 4.2.3.3 Web Server profile settings ................................................... 56 4.2.4 Managing deployment profiles ......................................................... 61 4.2.4.1 Deployment Profiles tab page ............................................... 62 4.2.4.2 Deployment profile settings ................................................... 62 4.2.5 Managing data source profiles ........................................................ 64 5 Using UFA Tool ................................................................................................... 69 5.1 Analyzing an application ............................................................................ 70 5.1.1 Tasks required before you perform feature analysis ....................... 70 5.1.2 Accessing the UFA tool ................................................................... 71 5.1.3 Performing feature analysis ............................................................. 72 5.1.4 Undetected Unsupported Features .................................................. 74 5.2 Working with UFA Report .......................................................................... 76 5.2.1 Modifying unsupported features ...................................................... 77 5.2.2 Manipulating the UFA Report .......................................................... 79 5.2.2.1 Opening or saving a UFA Report .......................................... 79 5.2.2.2 Selecting report view mode ................................................... 80 5.2.2.3 Searching for UFA Report items ........................................... 80 5.2.2.4 Filtering UFA Report items .................................................... 80 5.2.2.5 Specifying report display level ............................................... 83 5.2.2.6 Defining the priority settings of unsupported features ............ 84 5.2.2.7 Customizing the general settings of the UFA Report ............. 85 6 Deploying PowerBuilder Applications .................................................................. 86 6.1 Deployment performance ........................................................................... 86 6.1.1 Speed of Deployment Process ........................................................ 86 6.1.2 Deployment duration for full deployments ....................................... 87 6.1.3 Deployment duration for incremental deployments .......................... 87 6.2 Deployment process .................................................................................. 88 6.2.1 Preparing the PowerBuilder application .......................................... 88 6.2.2 Specifying the deployment settings ................................................. 88 6.2.2.1 Selecting the deployment mode ............................................ 90 6.2.3 Deploying the PowerBuilder application .......................................... 91 7 Debugging Appeon Web Applications ................................................................. 98 7.1 Important Requirements ............................................................................ 98 7.2 Introduction to the debugging procedure ................................................... 99 7.3 Starting Appeon Debugger ........................................................................ 99 7.3.1 Views in Appeon Debugger ........................................................... 101 7.4 Setting breakpoints .................................................................................. 102 7.4.1 Code lines that can be set as breakpoints .................................... 102 7.4.2 Methods for setting breakpoints .................................................... 103 7.5 Running the application in debug mode .................................................. 104 7.6 Examining an application at a breakpoint ................................................ 104 7.6.1 Special variable and expression handlings ................................... 104 7.6.2 Adding variables or expressions to Watch view ............................ 105 7.6.3 Changing the value of a variable or expression ............................ 106 7.6.4 Evaluating an expression .............................................................. 107 7.6.5 Examining context in Call Stack view ............................................ 107 7.6.6 Stepping through the application ................................................... 107 7.7 Fixing the code/stopping the debug procedure ....................................... 107 8 Running Appeon Applications ............................................................................ 108 8.1 Requirements ..........................................................................................