Home

Appeon Developer User Guide - Appeon for PowerBuilder 2013

1. 12 1 1 Undeploying with the Deployment Profile mode Step 1 Select the Deployment Profile radio button in the Specify Undeployment Mode window and click Next to continue Appeon Developer User Guide Page 171 Undeploying Appeon Applications Appeon for PowerBuilder 2013 Step 2 Select a Web or mobile application from the Application list box as shown in the following figure The Application list box lists all the application profile names Be sure to choose one that has been deployed and is intended for undeployment The application and the deployment profile used in the last deployment will be selected by default Step 3 Select the deployment profile that is used to deploy the Web or mobile application from the Deployment Profile list box as shown in the following figure Click Next to continue Figure 12 3 Deployment Profile Mode window x Application Undeployment Wizard x Deployment Profile Mode To undeploy an application from the servers select the Application that you want to undeploy and the Deployment Profile containing the servers where the application has been deployed Undeploy a Specified Application Application REESE E E Deployment Profile Local Deployment gt Step 4 Select the Appeon Server s or Web Server s that are intended for undeployment as shown in the following figure The Appeon Server s and Web Server s defined in the deployment profile selected in the previo
2. Release ASE only Specify the version number of ASE database Step 4 Specify the Enclose table and column names in double quotes option It determines whether Appeon Developer encloses the names of tables columns indexes and constraints in double quotes when it generates the database syntax during deployment Notes 1 When this option is selected verify that the quoted_identifier setting is set to ON in the database server 2 Clear the check box of this option when the updated table name of DataWindow contains the owner name Step 5 Click Test Connection to test the connection to the database 4 2 3 Managing server profiles A server profile is a set of parameters for Appeon Developer to connect to and deploy applications to a particular Appeon Server or Web server Creating and using server profiles is the easiest way to manage your application deployments because you can e Select one or more Appeon Server profiles and Web Server profiles to set up a deployment profile e Easily add edit and remove server profiles e Test connections in server profiles If the connection is successful it means that the application can be deployed to the server configured in the server profile e Manage which applications are accessible from the Appeon Developer shortcut Run button The shortcut lists the applications that are deployed to the default server profiles 4 2 3 1 Server Profiles tab page There are two main pa
3. Transaction Object 3 Additional Files Image Folder C Users Public Documents Appeon Developer2013 INI Files NET COM Components DLL OCX Files Misc Settings Developer Log Mode Summary mode Allama te rename the uncrun Ver 4 T Cancel 4 2 2 Managing database type profiles Database type profiles configuration is the easiest way to manage the database types that Appeon Deployment Wizard supports for application deployments You can configure database type profiles in the DB Type Profiles tab and apply a database type profile for an application deployment by selecting the profile in the Appeon Developer Configuration Wizard or in the DB Settings tab of the application profile settings Database type profiles in Appeon Developer are different from database profiles in PowerBuilder e You only need to configure one database type profile for a given database type For example if application A connects to ASA database d1 and application B connects to ASA database d2 you can use the database type profile Sybase ASA 7 S 9 10 1 1 12 for both applications although the connection information in the profile Sybase ASA 7 8 9 10 1 1 12 sets up connection to ASA database d1 Appeon Developer User Guide Page 41 Configuring Appeon Developer Appeon for PowerBuilder 2013 e Database type profiles are not used for setting up connections with application databases Instead they are mainly used by Appeon Deployment Wizard to call th
4. Appeon Developer User Guide Page 199 Extended Toolkit Appeon for PowerBuilder 2013 run them For your convenience Appeon provides a compressed folder structure which can be decompressed under any directory To decompress and create the folder structure and the required files take the following steps Step 1 Run SilentInstall exe in the Toolkit Silent Install under the Appeon Developer installation directory for example C Program Files Appeon Developer2013 Toolkit Silent Install Step 2 Select where to create the folder structure Click OK Figure 17 14 Specify the location Silent Install Create the folder structure For silent install under the Following directory To change the directory click Browse C Program Files Appeon Silent Install Browse Cancel After the creation a folder named Setup is created with the following sub folders and files Figure 17 15 Folder structure go p C Program Files 4ppeon Silent Install Setup v 4 Search p File Edit View Tools Help Ej Organize v Favorite Links Name i Date modified Type Size J Appeon 2 26 2009 5 51PM File Folder IE Documents x i m msvcp60 dll 2 26 2009 5 51PM DLL File 393 KB E van jB Setup exe 2 26 2009 5 51PM Application 128 KB p Music _ SilentInstall tt 2 26 2009 5 51PM Text Document 3KB More K Uninstallexe 2 26 2009 5 51PM Application 124 KB Folders v B appeon_workarounds110e lt B appeon_wor
5. Select Package Type App Name sales Select Application Specify the directory where the install folder will reside Configure App Settings Specify Destination Folder E Packaging Process E Finish Step 7 Wait until the package process is complete Click Next when the package process is complete Appeon Developer User Guide Page 157 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 38 Package process Appeon Application Package Wizard Please wait while the packaging tool performs the requested operation This may take several Welcome minutes Select Package Type Run Information Select Application Configure App Settings Specity Destination Folder Packaging Process l E Finish lt Back Next gt Cancel Erish Step 8 Click Finish Appeon Developer User Guide Page 158 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 39 Package complete Appeon Application Package Wizard x Finished packaging the application Welcome Select Package Type Select Application PP The package wizard has finished packaging the application Configure App Settings Click Finish to exit the wizard Specify Destination Folder To compile the package into an IPA file and distribute it to others please follow instructions in Packaging Process are is Tutorial 4 Package Distribute Native Mobile Apps Finish Back Next gt
6. e PUBLIC PROTECTED PRIVATE qualifier in the variable declaration Forced conversion Forced conversion between types Window Multiple MDI windows in an application Overloading overriding functions e Dynamic calling for overloaded functions e Dynamic calling for overriding functions Using the return value of some supported functions The return value of the Open or OpenSheet functions User functions Remote procedure call RPC Operators The operator with embedded SQL statements Stored procedure e Stored procedures declared in the conditional statement e DB2 stored procedures e Stored procedures placed inside an Oracle package e Oracle stored procedures with Appeon unsupported features Cursor declare requirement Appeon Developer User Guide e Cursor declared in the conditional statement Page 66 Using UFA Tool Appeon for PowerBuilder 2013 If a cursor is declared for retrieving rows from table X the table X insert delete update is modified during the cursor declare close period Cursor statements The following two syntax 1 UPDATE TableName SetStatement WHERE CURRENT OF CursorName 2 DELETE FROM TableName WHERE CURRENT OF CursorName DataWindow data e Unsupported features in the DataWindow dot notations You expressions must make sure the specifications about dot notations are satisfied in the application Otherwise
7. Security Settings Internet Zone EXS Settings 9 Activex controls and plug ins a 9 Allow previously unused Activex controls to run without pror Disable Enable 9 Allow Scriptlets Disable Enable Prompt 9 Automatic prompting for Activex controls C Disable Enable Binary and script behaviors Administrator approved Disable Enable Sl Nienlay vidan and snimstian an a mahnana khak daare nak rice 4 Ai Takes effect after you restart Internet Explorer Reset custom settings Resetto Medium high default v Reset Cancel Step 4 Check the Enable or the Prompt recommended radio button for the following options e Download signed ActiveX controls and plug ins and Download unsigned ActiveX controls in Windows XP e Initialize and script ActiveX controls not marked as safe e Run ActiveX controls and plug ins e Script ActiveX controls marked safe for scripting e File download e Active scripting e Allow active content to run in files on My Computer If the version of Internet Explorer is 6 0 SP2 If Enable is selected the ActiveX control will download automatically without prompting If Prompt is selected your approval will be required before downloading takes place Note If running the Appeon Web application for the first time in Internet Explorer 8 on Windows XP be sure to set Download signed ActiveX control to Enable Do not set to Prompt or
8. the Appeon Workspace Emulator emulates select a scale percentage from the percentage dropdown list box change the view orientation by 90 CW or by 90 CCW or exit the Appeon Workspace Emulator from the Appeon Workspace Emulator toolbar as shown in the following figure Figure 9 2 Appeon Workspace Emulator Toolbar Emulator Toolbar 400 Rotate Let Rotate Right For detailed instructions on using Appeon Workspace please refer to the Appeon Workspace User Guide Appeon Developer User Guide Page 120 Using Information Manager Appeon for PowerBuilder 2013 10 Using Information Manager Information Manager provides easy access to all the available reports or log files generated during the application migration process including debug development and deployment The reports are categorized as follows Analysis The log files are categorized as follows Deploy Log and Analysis Log The following table provides a brief description of all the reports generated during the Web or mobile migration process and the report types they are associated with Table 10 1 Report Description Description Analysis Report is generated during a feature analysis or application deployment and records the unsupported features in the application After you click this button the UFA Report Window will be displayed For detailed instructions refer to Section 5 2 Working with UFA Report The following table provides a
9. Appeon Developer Configuration Wizard nee Please specify the transaction object s used in the Welcome application and the corresponding data source s Configure basic settings Transaction Object Data Source DB Type Select PBL files Configure deployment settings Select DB types Declare transaction object s E Select image files E Select INI files E Deploy External Files Configure Add Delete E Summary Click Add to create the mapping of the transaction object and the data source of an application Appeon Developer User Guide Page 15 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 7 Add a transaction object Add Transaction Object xa Transaction Object Database Type Sybase ASE 12 x 15 x 7 Data Source If your ppeon Server is the NET edition you can also select edit add or delete the data source in the below Data Source group box Data Source Appeon Server v Selected Name DB Host Edit Add Delete Cancel Step 1 Input the transaction object name used by the application to the Transaction Object text box Step 2 Select the database type from the Database Type dropdown list box Step 3 Specify the data source name in the Data Source text box The data source should connect to the same database that the transaction object connects to Make sure that the data source exists in all Appeon Servers sel
10. Command Line Settings Language Options Configure options for the application language Language Options Performance Configure additional settings to tweak the application s run time performance Performance Settings Parsing Options Allow Deployment Wizard to rename the identifiers unsupported by JavaScript or XML Appeon Developer Logs Set the log writing mode for Deploy Log and Analysis Log You may view manage these logs in the Information Manager 5 Off mode Summary mode Debug mode Appeon Developer log writing mode The log writing mode determines the content of the log files generated by Appeon Developer including the deployment logs and feature analysis logs Select the desired mode from the Appeon Developer Logs box as shown in the following figure Appeon Developer User Guide Page 36 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 23 Log writing mode Q Application Profile Configuration mym ___ Web Service Profiles n i Runtime Settings Summary Basic Settings DB Settings Additional Fies Misc Settings Command Line Arguments Configure how command line arguments used in the PowerBuilder m application will be handled on the Web or Mobile Command Line Settings Language Options Configure options for the application language Language Options Performance Configure additional settings to tweak the application s run time z
11. OK Cancel The following table introduces the elements in the Deploy External Files dialog box Table 4 4 Deploy External Files dialog box Column Description Register Allows you to select whether the file will be automatically registered after it is downloaded to the Client at runtime Click Select All to select all files and Unselect All to de select all of them If you choose not to automatically register a file you can register it manually after it is downloaded File Name Lists the added files Click the header of this column to display the files in alphabetical order File Path Displays the file location The following table describes how to add and remove files in the Deploy External Files dialog box Table 4 5 Deploy External Files dialog box To Do This Do This To add files Click the Add button A standard File Selection dialog box is displayed And then select the files from your local machine The files can be stored in any location To remove files Select a file or multiple files using Ctrl or Shift keys and click the Delete button to remove the selected files from the list To save the Click OK settings Appeon will copy the files to a temporary folder and then deploy them to the Web Server during deployment Appeon Developer User Guide Page 30 Configuring Appeon Developer Appeon for PowerBuilder 2013 How the deployed DLL OCX files work on Web
12. Parameter EAServerUserName Description Specifies the user name to connect to EAServer Accepted Values A valid user name on EAServer Default Value None Appeon Developer User Guide Page 203 Extended Toolkit Appeon for PowerBuilder 2013 Example EAServerUserName jagadmin Table 17 11 Parameter for EAServer password Parameter EAServerPass Word Description Specifies the password to connect to EAServer Accepted Values A valid password for the current user name Default Value None Example EAServerPassWord 17 2 3 4 Appeon Server Port Username and Password Specify the Appeon Server port number user name and password Table 17 12 Parameter for Appeon Server port Parameter AppeonServerPort Description Specifies the HTTP port number of Appeon Server Accepted Values A valid port If both EAServer and AppeonServer parameters are set to Yes port 9988 is the only available port that can be used Default Value None Example AppeonServerPort 9988 Table 17 13 Parameter for Appeon Server username Parameter AppeonServerUserName Description Specifies the user name for deploying an application to Appeon Server This deployment user name can be created using the Security tool in AEM Accepted Values A valid deployment user name on Appeon Server Default Value None Example AppeonServerUserName Table 17 14 Parameter
13. Select Appeon Developer Version Reaister Appeon Developer toolbar in different PowerBuilder versions PowerBuilder Version Appeon Developer Versic PowerBuilder9 0 a PowerBuilderl 0 0 PowerBuilder10 5 640023 0 PowerBuilder11 0 PowerBuilder11 5 6 2 0023 00 Step 3 Click OK to register or unregister the selected Appeon Developer version with the PowerBuilder version Appeon Developer User Guide Page 212 Technical Support Appeon for PowerBuilder 2013 18 Technical Support You can get technical support by clicking the Get Support icon in the Appeon Developer toolbar appearing in the PowerBuilder IDE or launching the Appeon Help from the Windows start menu Get support for Appeon for PowerBuilder 2013 Please send your email to lt support appeon com gt for technical support and be prepared to provide the following files listed in the following table to Appeon Technical Support This will aid debugging Table 18 1 Files required for technical support File Type File Name Appeon Server configuration For EAServer WebLogic WebSphereJEUS JBoss a All files in the appeonserver repository lt instancename gt config folder For NET IIS All files in the appeonserver AEM config folder Yappeonserver indicates the Appeon Server installation path Appeon Server log file For EAServer WebLogic WebSphere JEUS JBoss All files in the appeonserver repository lt instancename gt
14. The main difference is that Appeon Debugger runs the generated JavaScript code but not the PowerBuilder source code and shows the execution results of the JavaScript code This chapter assumes that you are familiar with the functions of PowerBuilder Debugger therefore it does not provide descriptions of common debugging features but focuses on introducing the specialties of Appeon Debugger For common debugging features refer to the Debugging an application section in the PowerBuilder User s Guide Note 1 The Appeon Debugger only works with IE 9 0 or older versions in this version of Appeon for PowerBuilder 2013 but will support to work on IE 10 0 in the next version However this only affacts the debugger IE 10 0 and Windows 8 is natively supported for running Appeon Web applications 2 Appeon Mobile 1 0 provides no debug tool but you can still take advantage of Appeon Debugger to debug the business logic of the mobile application 7 1 Important Requirements To start and use Appeon Debugger successfully be aware of the following important prerequisites and note 1 Microsoft script debugger must have been correctly installed and registered on the same machine and script debugging is enabled in Internet Explorer Otherwise you may encounter problems in starting and using Appeon Debugger e Modify the Window registration table this step is required for IE 8 only In order to make sure that the Appeon Debugger work correctl
15. To successfully call the deployed DLL OCX files in the Web application you need to make sure that the DLL OCX files are successfully downloaded and installed to the Client during the initial run of the deployed Web application Appeon Enterprise Manager AEM provides options for manually or automatically downloading and installing the DLL OCX files and for specifying the installation location by default the files are saved to the SystemRoot system32 AppeonPlugin folder on the client machine SystemRoot indicates the folder where Windows is installed For detailed instructions refer to the Appeon Server Configuration Guide 4 2 1 2 4 Misc Settings The Misc Settings tab page enables you to modify settings for command line arguments application languages It is automatically disabled when you are using an English version of Appeon for Powerbuilder and log writing modes and allows you to configure the runtime performance and parsing options Figure 4 17 Misc settings Application Profile Configuration mx pp g meso Web Service Profiles Runtime Settings Summa Basic Settings DB Settings Additional Files Misc Settings Command Line Arguments Configure how command line arguments used in the PowerBuilder application will be handled on the Web or Mobile Command Line Settings Language Options Configure options for the application language z Language Options Performance Configure additional
16. gt 1 Then messagebox Alert Connection to database failed Halt CLOSE X 4 1 lt gt b Source Browser Source History lt gt fh Local Global Instance A Ah Call Stack Breakpoints h Watch A Method 2 Setting a breakpoint in the Breakpoints Variables or Watch view Step 1 Right click the Breakpoints Variables or Watch view Step 2 Select Breakpoints from the popup menu to add a breakpoint using the Edit Breakpoints dialog Method 3 Removing or adding a breakpoint at runtime When the application is already running in debug mode you can still change the way the debug works by removing or adding breakpoints at runtime Double click a line in the Source view or select Insert Breakpoint from the popup menu in the Source view 7 5 Running the application in debug mode Click Start on the Appeon Debugger toolbar The application starts to run in the Internet Explorer It works normally until it reaches a statement containing a breakpoint At this point it stops so that you can examine the application in the Appeon Debugger Appeon Developer User Guide Page 94 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 Figure 7 4 Application running in debugger mode E Debugger aes File View X Dle O OW amp amp AX H H Windows H E Menus H a User Objects H E Functions Arguments fi string commandline Ch ee ee Returns
17. it will cause errors e The return values of the DataWindow dot notations are assigned to user objects DataWindow lastpos lastposw mode pageAcross expressiontuncuon pageCountAcross __ profileint profilestring stdev var varp Partly supported features User interface interactions Some partly supported features such as DataWindow Modify and Describe functions Unsupported features in the UI such as shortcut key Enumerated data type Default values of enumerate type variable Data source The data sources of dynamically created DataWindows are stored procedures with input parameters Dynamic calls Dynamically call the method of a menu object Dynamically call the method that contains reference arguments Others PBX PSR for example dw dataobject psr Unsupported DBParm parameters Encoding parameter of the Blob functions filename amp importtype arguments of ImportFile ImportString amp ImportClipboard filename can only be a text file TXT Property defined in the string variable Structure member has comment property Appeon Developer User Guide Page 67 Using UFA Tool Appeon for PowerBuilder 2013 System events For a complete list of undetected system events refer to Undetected Features in Appeon Features Help 5 2 Working with UFA Report This section describes e How to modify unsupported features You can use the UFA Report to effectively
18. localhost 9988 for EAServer Appeon Server HTTP port Optional Specifies the port number that your Web Server accepts for HTTP connections If it is not specified the default port is 80 If several Web Servers are running on the same machine make sure that the port specified is a port of the Appeon Web Server Application Specifies the application name It is the name that you input in the Application name URL field in Application Profiles Entry file For Web applications only Specifies the name of the entry page x32_index htm for 32 bit system or x64_index htm for 64 bit system for example appeondemo x32_index htm x32_index htm can be omitted appeondemo cannot be omitted or appeondemo x64_index htm x64_index htm cannot be omitted Appeon Developer User Guide Page 107 Running Appeon Applications Appeon for PowerBuilder 2013 8 2 2 Running Appeon applications There are more than one method to run the Web application and the mobile application Web applications will be run in Internet Explorer You can use the following two methods to run a Web application in Internet Explorer Typing the URL of the Web application in Internet Explorer address bar You can always use this method to access the application on the condition that the computer meets Section 8 1 Requirements e Launching the deployed Web application from the Appeon Developer Run button Run is a sho
19. log folder For NET IIS All files in the appeonserver AEM Log folder Appeon Server Repository For EAServer DB appeonserver db AppeonServer db For NET IIS All files in the appeonserver AEM db folder For WebLogic WebSphere JEUS JBoss appeonserver db appeondb script Appeon license file For EAServer WebLogic WebSphere JEUS JBoss appeonserver license appeon For NET IIS appeonserver AEM bin license appeon Web Server configuration file httpd conf Web Page file Web server path application name window name html Web server path application name window name js Web server path application name all DataWindows on window xml Appeon Developer User Guide Page 213 Technical Support Appeon for PowerBuilder 2013 File Type File Name Note If the window named includes inheritance then also supply all ancestor HTML and JavaScript files PowerBuilder exported PowerBuilder application path exported window name srw pout codec PowerBuilder application path exported DataWindow names srd Note Exported windows should include exported ancestor windows and exported ancestor user objects Appeon Developer User Guide Page 214 Index Appeon for PowerBuilder 2013 Index A access Appeon applications 107 access UFA tool 62 activate Code Insight 178 add variables or expressions to Watch view 96 Additional Files 27 analyze an application 61 Appeon DataWindow m
20. ts Lose ta Lite te Loe eta Lite 14 40 17 Analyzing unsupported features for Menu m_report_category_summe 14 40 17 Analyzing unsupported features for Menu m_report_customer_summ 14 40 17 Analyzing unsupported features for Menu m_report_order_date 14 40 18 Analyzing unsupported features for Menu m_report_ordertype 14 40 18 Analyzing unsupported features for Structure strgeneral 14 40 18 Analyzing unsupported features for Structure strrpt_options 14 40 18 Analyzing unsupported features for Structure str_rptparm 14 40 18 Finished analyzing unsupported features 4 WW p A View Log Close Step 5 Click Close when the analysis is completed The UFA Report is loaded into the UFA Report Window 5 1 4 Undetected Unsupported Features Appeon Unsupported Features Analysis is capable of highlighting the majority of unsupported features contained in the PowerBuilder application There are still a small number of features that the Unsupported Features Analysis will not detect so they will not be listed in the UFA Report An application containing unsupported features can still be converted to the Web or to the Mobile and may work correctly depending on the type and number of unsupported features If the deployed application does not work correctly and the UFA Report does not indicate any unsupported features that are likely to cause such problems the problems may be caused by unsupported features that have not b
21. 1 Configuring basic settings The basic settings refer to the settings of an application that are essential for deployment including application profile name web folder project type device type mobile app name mobile app icon and mobile app description For more information about them refer to Section 4 2 1 2 1 Basic Settings in Section 4 2 Using Configure Tool Appeon Developer User Guide Page 10 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 2 Configure basic settings of an application Appeon Developer Configuration Wizard Please configure the following options Welcome Application Profile Name appname Configure basic settings Web Folder appname Project Type D E Configure deployment settings Device Type Tae o E Select DB types vce ype Tablet E Select PBL files E Declare transaction object s Mobile App Name sitll Mobile App Icon Browse E Select image files Mobile App Description E Select INI files E Deploy External Files E Summary Step 1 Specify the application profile name in the Application Profile Name text box The application profile name is used to identify the PowerBuilder application during the entire PowerBuilder to Web or PowerBuilder to Mobile process Step 2 Specify the application URL in the Web Folder text box The specified text is also used as the name of the folder created under the Web root of the Web ser
22. 2 4 1 Filtering by objects Step 1 Select the Edit gt Filter by Object menu Or right click in the unsupported feature list treeview and select Filter by Object The Filter by Object dialog box is displayed as shown in the following figure Figure 5 10 Filter by object Filter by Object s Object List Filter Object s g Application appeontest ft appeontest pbl lt Deselect lt lt Deselect All Cancel Step 2 Make sure that the unsupported objects you want to display in the report are on the right list box whereas the unsupported objects you want to hide are on the left listbox Click OK To quickly select all objects of the same type right click the list and select an object type The UFA Report hides the unsupported objects that are on the left listbox in the Filter by Object window 5 2 2 4 2 Filtering by categories Step 1 Select the Edit gt Filter by Category menu Or right click in the unsupported feature list treeview and select Filter by Category The Filter by Category dialog box is displayed as shown in the following figure Appeon Developer User Guide Page 72 Using UFA Tool Appeon for PowerBuilder 2013 Figure 5 11 Filter by Category Filter by Category Category List Filter Category s External visual userobject a External class userobject Select System object or control Duplicate objects Select All DW control DW
23. 4 2 3 Managing server profiles Appeon Developer User Guide Page 138 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 16 Specify server settings OB App on Application Deployment Server Settings Please select the Appeon Server and the Web Server Appeon Servers Selected Profile Name Server Type Edt ERE 192 0 1 56 EAServer add 1 Web Servers Delete Selected Profile Name Edt ai EJ 192 0 1 56_EAServer er Step 6 Select whether to deploy EAServer components After NVO components are deployed you must generate stub skeleton in EAServer dd dd Detailed instructions are provided in Generating Stub Skeleton in EAServer in the Migration Guidelines for Appeon Web Appeon Developer User Guide Page 139 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 17 Specify EAServer settings oe a pp on App cation Deploymen EAServer Settings a Please select whether to deploy EAServer components A n Please select whether to deploy EAServer components To deploy components please specify the EAServer configuration settings Note if the EAServer Components option is not selected the step for selecting NYO components will be skipped Me t Components Profile Name Server Name Port Number Login Edit Add Delete 4 m r If EAServer components are used in the applicatio
24. 5 2 2 7 Customizing the general settings of the UFA Report 76 6 Deploying PowerBuilder Applications cccccccceeeeeeeeeeeeeeneeeeeeeeseeeeeeeeeeeeteees 77 6 1 Deployment performance sssssssseeeeseesrnrtesserrtrresserrnntnssertnnnnneeerrnnnneenet 77 6 1 1 Speed of Deployment Process cceeeeeeeeeeeeeeeeeeeeeeeeteeeeeeeeeees 77 6 1 2 Deployment duration for full deployments eeeeeeeeeeeeeeeeeeteeeees 78 6 1 3 Deployment duration for incremental deployments 00 78 6 2 Deployment Process cccceeeeeeseeeeeeeeeeseeeeeeeeseeeaaaeeeeeeeeeseeceeeeeeeeeenaaeaes 79 6 2 1 Preparing the PowerBuilder application cccceeeeeeeeeeeeeeeeeeees 79 6 2 2 Specifying the deployment settings eeeeeeeeeeeeeeeeeeeeeeeeneeees 79 6 2 2 1 Selecting the deployment mode c cceeeeeeeeeeeteeeeeeeeeees 81 6 2 3 Deploying the PowerBuilder application ceeeeeceeeeeeeeeeeeees 82 7 Debugging Appeon Web Applications ccccccccceeeeeeeeeeeeeeeeeeeeeeeeeeeneeeeeeeetenes 89 7 1 Important Requirements cece eeeeee cece ee eeeeee eee eeeeceeaeeeeeeeeteeenaeeeeeeeeeenaaees 89 7 2 Introduction to the debugging procedure ccceccceeeeeeeeeeeeeeetteeeeeeeeeees 90 7 3 Starting Appeon Debugger ccecceceecceeeeeeeeseeeeeeeeeeesaaaaeeeeseeeeeeeeeeeees 90 7 3 1 Views in Appeon Debugger ccccesses
25. Appeon Developer User Guide Page 124 Packaging Applications Appeon for PowerBuilder 2013 11 1 2 Packaging instructions To package an executable deployment project and the related settings take the following steps Step 1 Start the servers as the package wizard will pack settings of Appeon Server AEM and NVOs if any Step 2 Click the Package Gal button on the Appeon Developer toolbar to open the Appeon Application Package Wizard Step 3 Select or create a profile from the dropdown list box and click Next to proceed A profile is a configuration file containing configurations that you specify when packaging the application You can select an existing profile or create one by entering a name in the text field The profile will be automatically saved and listed for selection next time when you launch the Appeon Application Package Wizard again Figure 11 1 Welcome page Appeon Application Package Wizard Welcome to the Appeon Application Package Welcome Wizard E Select Package Type E Select Application Please select an existing profile or create a new one E Select Appeon Server E Configure EAServer Profile E Select NVOs E Select AEM Settings E Specify Destination Folder E Packaging Process E Finish Step 4 Select the Package a Deployment Project radio button To package an Xcode project for a native mobile app follow detailed instructions in Packaging a native mobile project To cust
26. Appeon Developer to apply the correct database driver type for generating correct database syntax for PowerBuilder SQL statements Set the database types for the application Select the database type s used by the application as shown in the following figure Appeon Developer User Guide Page 25 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 14 Database types Q Application Profile Configuration Web Service Profiles Runtime Settings Summary Basic Settings i DE Settings Additional Files _ Misc Settings Database Type Select the Database Type used by this application The selected database type must be configured Click Configure to configure a database type Used Supported Database Types Configured Sybase ASE 12 x 15 x No 3 Sybase IQ No Oracle 10q 11g No Orsele Qi Na Configure Transaction Object Configure data sources for transaction objects used in the application v Start transaction when executing stored procedures Transaction Object Data Source DB Type sqica appeonsample Sybase 454 8 9 10 Edit Add Delete Cancel The following table describes each element on the DB Type tab Table 4 3 Database type settings Column Description Used You can click the check boxes to select the database types used by the application More than one database type can be selected but only the configured database types are selectable Supported
27. Appeon Web applications or in Appeon Workspace on various mobile devices Appeon Mobile applications Then automatically deploy the generated Web or mobile application files to Appeon Server The third task results in a bona fide Web application or a native mobile application with the look and feel of the source PowerBuilder application For detailed information about the Web or mobile conversion please refer to the Appeon Migration Guide Appeon Developer User Guide Page 6 Before You Begin Appeon for PowerBuilder 2013 3 Before You Begin 3 1 Installing Appeon for PowerBuilder Follow the Appeon Installation Guide carefully make sure that both Appeon Developer and Appeon Server have been installed Verify that Appeon Developer has been installed to the Developer PC Verify that Appeon Server has been installed to the application server such as SAP Sybase EAServer SAP NetWeaver Application Server Oracle WebLogic IBM WebSphere TmaxSoft JEUS JBoss or Microsoft NET Framework IIS Once Appeon Server has been installed the machine hosting Appeon Server is then referred to as Appeon Server If using a separate Web Server e g Apache instead of the application server built in Web server verify that the Appeon Server Web Component has been installed to the Web Server Verify that all system requirements have been met for the Developer PC Web Server Appeon Server and the Database Server Refer to the Appeon Installation
28. Cancel Step 9 Go to the folder App Name_install under the specified location you will find the following two zip files Copy them to the Mac machine e App Name zip the application file package e AppeonMobile framework zip the mobile client libraries Then follow the instructions in Package amp Distribute Native Mobile Apps in Appeon Mobile Tutorials to compile them into an IPA file 11 3 Customizing and packaging Appeon Workspace To customize Appeon Workspace and package it as an Xcode project follow steps below Step 1 Click the Package Gl button on the Appeon Developer toolbar to open the Appeon Application Package Wizard Step 2 Select or create a profile from the dropdown list box and click Next to proceed A profile is a configuration file containing the settings that you specify when packaging the application You can select an existing profile or create one by entering a name in the text field The profile will be automatically saved and listed for selection next time when you launch the Appeon Application Package Wizard again Appeon Developer User Guide Page 159 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 40 Welcome page Appeon Application Package Wizard Welcome to the Appeon Application Package Welcome Wizard E Select Package Type E Select Application Please select an existing profile or create a new one E Select Appeon Server E Configure EAServer Profile E Select NVO
29. Deployment Profiles tab page ceceeeeeeeeeeetteeeeeeeeeees 54 4 2 4 2 Deployment profile settings cceeeeeeeeeceeeeeeeeeeeeeeeeeees 54 4 2 5 Managing data source profiles ccccccceeeeeseeeeeeeeeeeeeeeeeeeeeeeeneee 56 SUSMA UFA OOM ena e ide ists tee adh AEE S EEE AAE OAE AEREE 60 5 1 Analyzing an application snaring aE Eai 61 5 1 1 Tasks required before you perform feature analysis 00 61 5 1 2 ACcessing the UFA TOO eien aia EAE REENE 62 5 1 3 Performing feature analysis icc csitecaces vhcauidl tec ca ceinetcteed taaceneeda lanenetxe 63 5 1 4 Undetected Unsupported Features ccccceeeeeeeeeesseeeeeeeennnnnaaaes 65 5 2 Working with WRAREDOMN s nedeo eaa tetrad aa aiae a aa dia aeiia 68 5 2 1 Modifying unsupported features ssseeseeeesesieneeeesererrnnnseerrnrn reesen 68 5 2 2 Manipulating the UFA Report ssssssssssesesenesssssrnrrresserrnnnnnsserrnnnnneeene 70 5 2 2 1 Opening or saving a UFA Report ssessssseeesesssssreessssrrerrrsesee 70 5 2 2 2 Selecting report view MOE ceeeeeeececeeeeeeeeeeeeeeeeeeeeaeeees 71 5 2 2 3 Searching for UFA Report items cceceeeeeeeeeeeeeeeeeeteeees 71 5 2 2 4 Filtering UFA Report items cccceceseeeeeeeeeeeeeteeeeeeeeeeenees 71 5 2 2 5 Specifying report display level cceeeeeeeeeeeeeeeeeeeeeeeeees 74 5 2 2 6 Defining the priority settings of unsupported features 75
30. I visit the webpage Every time I start Internet Explorer gooseseccesesosecossesseseosssseg neasecesseoncsuaneessvostled J Never Disk space to use 8 1024MB 50 i Recommended 50 250M8 Current location C Users Administrator 4ppData Local Microsoft Windows Tempo Internet Files Move folder view objects view files History Specify how many days Internet Explorer should save the list of websites you have visited a Days to keep pages in history 20 S Cancel Step 4 Verify that the Disk space to use scroll box is set to at least 200 MB Click OK in the Settings window 8 1 2 2 Advanced settings for temporary Internet Explorer files folder During development the Temporary Internet Files folder should be set to automatically empty each time Internet Explorer is closed This will force Internet Explorer to re download the entire application every time it is opened to ensure the latest version of the application is present and to prevent interference from outdated cached files Here are the necessary steps required to configure Internet Explorer to flush its temporary files each time the browser is closed Step 1 Click the Advanced tab in the Internet Options window as shown in the following figure Step 2 Check the Empty Temporary Internet files folder when browser is closed check box under the Security section as shown in the following figure Appeon Developer User Gui
31. Insight is a tool designed to help you write Appeon supported PowerScript code more quickly by providing a lookup and paste service inside the PowerBuilder Script view You can use it to develop PowerBuilder applications that are free of Appeon unsupported features and tailored to Web or mobile migration The usage of Code Insight is similar to that of PowerBuilder AutoScript The following table describes the differences between the PowerBuilder AutoScript and Appeon Code Insight Table 13 1 Comparison between AutoScript and Code Insight PowerBuilder AutoScript Appeon Code Insight Effective Functions events variables properties and Items referred in dot for templates for PowerBuilder DO FOR IF and notations CHOOSE statements What pops A list of properties variables methods or 1 A list of properties up statements variables or methods 2 The Appeon unsupported properties variables or methods that are marked with a red icon left to them Ways to Two ways to use AutoScript Only one way to use Code use it Insight e Turn automatic popup on to pop up a list automatically when you pause while typing or Ss ae Insight e Invoke AutoScript only once when you need it Step 2 Configure the by selecting the menu items default PBT file Step 3 Enable Code Insight Refer to the following sections for detailed instructions Priority When Code Insight is activated AutoScript will be automatically tu
32. PowerBuilder extends the capabilities of PowerBuilder allowing a new or existing PowerBuilder application to be converted into a bona fide Web application or a native mobile application using only PowerBuilder skills Appeon Developer provides a set of tools that enable the entire PowerBuilder to Web or PowerBuilder to Mobile process to take place within the PowerBuilder IDE These tools are accessed via a toolbar in the PowerBuilder IDE which automatically loads each time PowerBuilder is opened Figure 2 1 Appeon Developer toolbar embedded in the PowerBuilder IDE File Run Tools Window Help ih Elle o ol CGR SD EH ti CITESEER Os 9h 2 Bw XxX w HR Os Appeon Developer converts a PowerBuilder application by parsing the PBLs source code of PowerBuilder applications and generating a set of corresponding HTML JavaScript and XML files When deployed by Appeon Server these generated files form an exact Web based or mobile OS based replica of the source PowerBuilder application Any user can open a standard Microsoft Web browser and access the Web based version of the original PowerBuilder application over the Internet an intranet or an extranet or access the native mobile application deployed by Appeon using a mobile device such as an iPhone an iPad etc 2 1 Appeon Developer toolbar in PowerBuilder All the Appeon Developer tools conform to the US Government Section 508 Accessibility Guidelines The follo
33. PowerBuilder 2013 7 3 1 Views in Appeon Debugger Appeon Debugger contains all the views provided by PowerBuilder Debugger except for Instances View and Objects in Memory view Each Appeon Debugger view shows almost the same information as its counterpart in PowerBuilder Debugger The following table summarizes the general differences between the two Table 7 1 Comparing the views in Appeon Debugger and PowerBuilder Debugger Unique to Appeon Debugger Unique to PowerBuilder Debugger Unavailable in PowerBuilder Unavailable in Appeon Debugger Debugger Source Identifies Appeon unsupported e Ancestor Script popup menu item features with the icon gt e Descendant Script popup menu item Source None List of system events or the events Browser and functions defined in parent classes or some special events such as Menu OnCreate event Source None None History Variables The values of variables e Parent and Shared views unsupported by Appeon are marked as unsupported e Parent popup menu item The Global view displays all Shared popup menu item global variables used in the application while PowerBuilder e Break on changes popup menu item Debugger only displays instantiated global variables Call Stack None None Breakpoints None e Setting special breakpoints e Setting occasional or conditional breakpoints e Setting a breakpoint when a variable changes Watch Appeon Debugger handles some Br
34. PowerBuilder and load target application Enables PowerBuilder to automatically start and load the target application when you click the Edit or Edit Source button in the UFA Report window e Filter Previous Results Allows you to filter only the results of a previous filter It narrows a filter that resulted in too many data the first time If you want to search all data of the report leave this option as unselected Appeon Developer User Guide Page 76 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 6 Deploying PowerBuilder Applications Appeon Deployment Wizard deploys PowerBuilder applications to be Web or mobile applications The deployment should take place only after the application has undergone careful analysis and is in compliance with the Basic and Architectural Requirements defined in Appeon Features Help The Appeon Deployment Wizard handles the deployment in five steps 1 Exports the PowerBuilder application source code 2 Analyzes the PowerBuilder application to verify that it does not contain unsupported features 3 Parses the PowerBuilder source code PBL files into Web or mobile application files that are stored on the local machine 4 Uploads the DataWindow syntax to Appeon Server 5 Transfers local application files to the Web Server by either file copy or FTP Notes 1 Deploying to an SSL Web Server is no different than deploying to a standard Web Server You only need to make sure th
35. Style External function Property Method Event Function Shared variable Data type GOTO Function argument Global symbol Label lt Deselect Function returned value Variable name Identifier not found Function not found 4 il p m lt lt Deselect All Cancel Step 2 Make sure the categories of the unsupported features you want to display in the report are on the right listbox whereas the categories of the unsupported features you want to hide are on the left listbox Click OK The UFA Report hides unsupported features that belong to the categories that are on the left in the Filter by Category window 5 2 2 4 3 Filtering by priorities Step 1 Select the Edit gt Filter by Priority menu Or right click in the unsupported feature list treeview and select Filter by Priority The Filter by Priorities dialog box is displayed as shown in the following figure Appeon Developer User Guide Page 73 Using UFA Tool Appeon for PowerBuilder 2013 Figure 5 12 Filter by Priority Filter by Priority Exa Priorities to filter MiHave to modif bessssssssessssses Suggest to modify Can be ignored Cancel Step 2 Uncheck the priorities of the unsupported features which you want to hide For example if you want to hide the features that can be ignored uncheck the Can be ignored option Step 3 Click OK The UFA Report only displays uns
36. This column lists all the database types that are supported by Appeon Database Types Configured This column is identical to the Configured column in the Section 4 2 2 Managing database type profiles tab It indicates whether a profile has been configured for the database type If this column of the desired database type is No you must click the Configure button to configure a profile for it before you can use it Configuring a database type profile in this tab is the same as configuring it in the DB Type Profiles tab Once a database type profile is configured Appeon Developer User Guide Page 26 Configuring Appeon Developer Appeon for PowerBuilder 2013 Column Description successfully the Configured column in both this tab and the DB Type Profiles tab changes from No to Yes Specify the transaction object and the data source Click Add or Edit to configure a transaction object and specify the corresponding data source Refer to Section 4 1 5 Declaring transaction object s for detailed description Start transaction when executing stored procedures It is strongly recommended that you keep this option enabled The only circumstance you may consider disabling it is when there is commit statement executed inside a stored procedure SP and there is no need to commit in the PB code the reason is that by default Appeon Server will start a transaction once an SP is executed and the end user
37. This detection can mislead Developer into selecting incremental deployment mode because the folder will exist in the following situations Table 6 6 Situations when the folder exists The folder will exist if you have In this case choose Performed an unsupported feature analysis on the application before Incremental it has undergone a full deployment The folder is created during deployment mode analysis Undeployed an Appeon deployed application from servers using the Full deployment Application Undeployment Wizard The folder is preserved mode Deployed the application using a previous version of Appeon Full deployment Developer The folder is preserved unless you delete it manually mode This legacy folder can be detected by the new Appeon Developer 6 2 3 Deploying the PowerBuilder application The deployment process of an application contains three major deployment tasks Different deployment modes perform different tasks The following table describes the tasks performed during each deployment mode Table 6 7 Different tasks performed during each deployment mode Deployment Task Full Incremental Deploy Already Deployment Deployment Generated Application Task 1 Application Source Code Export Exports the source code of the original PowerBuilder application Task 2 Application File Generation Y Y Partial IN Appeon Developer User Guide Page 82 Deploying PowerBuilder Applic
38. Windows XP 2003 or if using IE 7 0 or earlier you must log in as a member of the Administrator group so you have the permissions to successfully download and register the ActiveX control If you are using IE 8 0 or 9 0 on Windows XP 2003 or if using IE 7 0 or earlier ask your administrator to assign the current login account to the Administrators group so that it can successfully download and register the Xcelerator plug in After that you can use any account to log into Windows and run the application 8 1 2 Internet Explorer settings Note This is required for the Web application only Settings in Internet Explorer can affect the deployed Web application Sometimes outdated files that are cached in the browser can interfere with how a Web application functions and can cause errors when they are re deployed many times Internet Explorer s settings may also block proxy connections or ActiveX control downloads when the Web application is opened Therefore you need to make sure you configure Internet Explorer s settings accordingly Note that you may need to have the administrator rights to modify certain settings 8 1 2 1 Settings for temporary Internet files Sometimes cached files in Internet Explorer can cause problems when accessing the converted Web application after deployment In order to avoid the risk of providing stale data it is imperative that Internet Explorer has the cache options set to Automatically and that there is suffici
39. all configurations of an application profile It lists the configurations in a treeview structure and allows you to review and modify their values directly Use the following two methods to input or modify the configuration property values e For properties that you can input or select values by using a text field radio buttons or dropdown list such as Mode Application URL PBL version etc you can directly double click their Property Values column and then input modify or select values e For properties that you can add delete multiple items by using a dialog box such as application PBLs INI files etc you can right click the property name in the Application column and then select Add or Delete All from the popup menu Appeon Developer User Guide Page 40 Configuring Appeon Developer Appeon for PowerBuilder 2013 The configuration changes you make in this Summary tab page will be immediately synchronized to the other tab pages but only after you click the OK button the changes will be saved Figure 4 27 Summary tab Q Application Profile Configuration Basic Settings DB Settings Additional Files Web Service Profiles Runtime Settings Applications Property Values sales A Basic Settings Project Type Universal Mode Release Appication URL http web server port sales PBL Version PowerBuilder 11 5 Application PBLs DB Settings Database Type Sybase ASA 8 9 10 11 12
40. and connection method https or http in the Appeon Server Profile Configuration page The default username is admin and the default password is admin The username and password settings for AEM can be modified in Security settings in AEM Refer to Security in the Appeon Server Configuration Guide for more information Appeon Developer User Guide Page 185 Converting screen size between dots and PBUs Appeon for PowerBuilder 2013 15 Converting screen size between dots and PBUs rere The Size Calculator FFF tool in the Appeon Developer toolbar is used to conveniently convert the display size between dots and PBUs As we all know PowerBuilder uses PowerBuilder units to measure the size while Appeon uses dots as the measurement unit which is the same with the popular mobile OS providers such as Apple GOS Google Android and Microsoft Windows Phone When you design the UI in PowerBuilder you may want to know what the size would be in iOS Android or Windows Phone or you may already determine the size in iOS Android or Windows Phone and want to know how to design the size correspondingly in PowerBuilder In either case you can use the Size Calculator tool to convert the size from PBU to Dot or from Dot to PBU Figure 15 1 Size Calculator rer e ree Size Calculator Language English PB Unit Ki DOT PBU PEU gt DOT Dot is referred as point in iOS Both Point and Dot are used interchangeably in both Ap
41. at the same time and multiple Appeon Developer versions can run on the same machine The Appeon Developer Toolbar register tool enables you to register or unregister one Appeon Developer version to more than one PowerBuilder version or different Appeon Developer versions to different PowerBuilder versions so that you can easily and flexibly select which Appeon Developer version and PowerBuilder version to use Following are steps to use the Appeon Developer Toolbar register tool Step 1 Select Start gt Programs gt Appeon Mobile 1 0 for PowerBuilder gt Appeon Developer gt Toolbar Register Tool Figure 17 16 Registry tool tx Appeon Developer Toolbar Registry Ex Select Appeon Developer Version Register Appeon Developer toolbar in different PowerBuilder versions PowerBuilder Version Appeon Developer Versic PowerBuilder9 0 PowerBuilder 0 0 PowerBuilder 0 5 PowerBuilder 1 0 PowerBuilder 1 5 6 2 0023 00 m 4 pi r Cancel The PowerBuilder versions existing on this computer will be listed Step 2 Select the Appeon Developer version to be registered in the PowerBuilder version If you want to unregister an Appeon Developer version from a PowerBuilder version clear the selection in the Appeon Developer Version column Appeon Developer User Guide Page 211 Extended Toolkit Appeon for PowerBuilder 2013 Figure 17 17 Register toolbar to PowerBuilder peon Developer Toolbar Registry
42. configuration of the installation wizard The installation wizard will use the settings in the config xml file If you do not want to use the deploy config file simply skip this option and click Next to configure the settings step by step Appeon Developer User Guide Page 136 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 14 Select the configuration file BE Appeon Application Deployment Select an Existing Deploy config File Please select an existing deploy config file for quick config The wizard automatically loads the configuration file for the current package and uses the settings in this file as the default settings for the subsequent steps You can modify the settings in this file or select another configuration file Note You can clear the configuration file path in the Destination File box and click Next to configure the settings manually Destination File Appeon WebAppPackageappeon_ code examples _install ini confia xm Browse Step 4 Input the Application Profile Name and the Application URL for the application and click Next The Application Profile Name is used as the application name to identify an application If you want to install multiple instances of the same application on the same server you can run the setup package repeatedly and specify different Application Profile Name here For example input appeon_code_examples_test as the Application Profi
43. for appeon applications 107 use Appeon DataWindow menu 111 DataWindow printing 115 find 111 SaveAs 116 sort and filter 112 use Information Manager 121 use UFA tool 60 V view report and log 121 views in Appeon Debugger 92 Page 216 Index Appeon for PowerBuilder 2013 W Web application uninstall program patch 206 Web applications 205 Web Server path 204 Web Server profile settings 48 Web service profiles 38 Appeon Developer User Guide Page 217
44. in Standard Display in landscape on iPad 768 x 1004 pixels Landscape iPad Launch Image Specify the launch image for the standard display in Standard Display in portrait on iPad 1024 x 768 pixels Portrait Appeon Devel oper User Guide Page 163 Packaging Applications Appeon for PowerBuilder 2013 Group Parameter Description iPad Launch Image Specify the launch image for the retina display in Retina Display in landscape on iPad 1536 x 2008 pixels Landscape iPad Launch Image Specify the launch image for the retina display in portrait Retina Display in on iPad 2048 x 1496 pixels Portrait Replacing the Workspace Banner The banner in the Appeon Workspace is an HTML Web app You can design your own workspace banner and replace the Appeon Workspace Banner e Replace the banner Click the Workspace Banner to select your own HTML Web app Make sure that the app contains an index html file under the root directory of the app The index html file is the default file that the Workspace Banner loads e Banner size the height is 248 pixels for iPad including iPad 2 3 4 and mini and 124 pixels for iPhone including iPhone 4 4S and 5 the width is subject to the device usually the same width as the device screen For iPad 2 3 4 and mini the width in Portrait view is 768 pixels and the width in Landscape view is 1024 pixels For iPhone 4 4S and 5 the width in Portrai
45. in the following figure Figure 8 21 Save As window ic Save As san Save in mn ee ex Er ame Size Type Date modified a lj Administrator j l Public Save as type Text with headers txt gt Cancel Note If the DataWindow without any data is saved as the HTML file or the XML file on the Web the DataWindow header will not be saved whereas it will be saved on PB 8 3 2 5 Additional Enhanced Features In addition to the popup menu Find Find Next Find Previous Sort Filter Print Save As File Appeon offers more features for users to manage DataWindows on the Web Users can place DataWindow columns in a different order by dragging and dropping them to new positions When navigating an editable DataWindow users can use the popup menu to quickly edit the contents These features are always available and require no extra coding to be enabled The following steps show you how to access them Step 1 Select a column header in the Web DataWindow and the selected location is highlighted as shown in the following figure Step 2 Drag and drop it to the desired location and the location to be dropped is highlighted as well Appeon Developer User Guide Page 117 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 22 Select a column header E Catalog Manager Categories Category Name Clothing assorted sports and casual clothing Category Description ass
46. in the Priority Name column Step 4 Click Save to save the priority settings Appeon Developer User Guide Page 75 Using UFA Tool Appeon for PowerBuilder 2013 Click Reset to Default to restore the system default priority settings 5 2 2 7 Customizing the general settings of the UFA Report You can define your preference settings of the UFA Report window These settings include default report view mode display formats of PBLs feature count unsupported source code edition and filtering The new settings will be saved as the default settings Select the Tools gt Options menu in the UFA Report window The General Settings window is displayed as shown in the following figure Figure 5 15 General Settings dialog box General Settings xa Default Report View Hierarchy Priority Summary Tree View Display Display Full Path of PBL Files V Display Unsupported Feature Count Edit Source z Auto start PowerBuilder and load target application Filter 4V Filter Previous Results e Default Report View group box Select the default view mode of the UFA Report For detailed description of each view mode refer to Section 5 2 2 2 Selecting report view mode Display Full Path of PBL Files Displays the full path and the file name of the PBLs in the UFA Report e Display Unsupported Feature Count Displays the total number of the unsupported features in the UFA Report e Auto start
47. mostly the same as in PowerBuilder Debugger If the results are different there are two possible reasons 1 The deployment of the application contains an error In this case determine the cause of the error and correct the problem 2 Appeon Debugger handles some variables and expressions differently from PowerBuilder Debugger Such differences are introduced below Be aware of them so not be false alarmed and conduct unnecessary complex examination work Appeon Debugger does NOT support the following when examining variables e Expanding the values of ClassDefinition PowerObject and Any variables Appeon Developer User Guide Page 95 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 e Expanding the runtime values of System variables Instead it just expands the inherent properties of such variables For example with a Window type variable w_1 PowerBuilder Debugger shows all the values of all the controls and variables contained in w_1 while Appeon Debugger only shows the values of the Window properties of for w_1 Appeon Debugger gives different results when evaluating the following expressions e It reports errors for expressions that contain unsupported code e If the same expression is added multiple times in different context into the Watch Appeon Debugger regards it as one expression and evaluates its value according to the context of the breakpoint e Appeon Debugger does not validate expressio
48. oe J Ready Nothing Selected 5 2 2 Manipulating the UFA Report 5 2 2 1 Opening or saving a UFA Report You can open or save a UFA Report using the File menu in the UFA Report window e To open an existing UFA Report select the File gt Open Report menu The Open UFA Report dialog box is displayed If there is no UFA report available select New Analysis and click OK to analyze an application Figure 5 8 Open UFA Report Open the existing UFA report of an application sales_application_demo gt Open the UFA report from Ic Program Files 4ppeon Developer6 2 Project s O New Analysis e To save a UFA Report select the File gt Save menu Appeon Developer User Guide Page 70 Using UFA Tool Appeon for PowerBuilder 2013 To save a UFA Report with a new name select the File gt Save As menu 5 2 2 2 Selecting report view mode You can view the UFA Report in four different modes Go to the View menu in the UFA Report window and select the desired mode e Category Enables you to view the unsupported features in the following categories Unsupported Objects Unsupported PowerScript Unsupported Embedded SQL and Others e Hierarchy Enables you to view the unsupported features in hierarchical order PBL Object Control Method Event Function e Priority Enables you to view the unsupported features in priorities you can go to the Tools gt Define Priority menu to defi
49. platform and then install the application to remote servers running on Unix Linux e The target Web servers must have the Appeon Server Web Component correctly installed e The packaged EAServer components if any can only be installed to EAServer application server 11 1 4 2 Installing an application The generated deployment project runs on the Windows platform only Therefore you will need to copy the deployment project to a computer running Windows and then install the Appeon Developer User Guide Page 135 Packaging Applications Appeon for PowerBuilder 2013 application to any number of Appeon Servers and Web servers located in the same network area Installing an application using the deployment project is the same as deploying an application using the Appeon Deployment Wizard Step 1 Start the target Appeon Server s and Web server s where you want to install the application Verify that the target Web servers already have Appeon Server Web Component installed Step 2 Run the Setup exe file in the generated deployment project The Appeon Application Deployment wizard is displayed Click Next to proceed Figure 11 13 Welcome page a Appeon Application Deployment xa Welcome to the Appeon Deployment Wizard This wizard will install the packaged Appeon application on your computer To continue click Next To exit the wizard click Cancel Step 3 Select the deploy config file config xml to ease your
50. profiles you have created are listed More than one Appeon Server can be selected Web Server Select a check box to include the Web Server in the deployment profile All the Web Server profiles are listed More than one Web Server can be selected Note If the server type of Appeon Server profile is NET then the server type of Web Server profile must be Microsoft IIS Click OK to save the new settings and return to the Deployment Profiles tab Appeon Developer User Guide Page 55 Configuring Appeon Developer Appeon for PowerBuilder 2013 4 2 5 Managing data source profiles Note This Data Source Profiles tool works for Microsoft NET Framework US but does not work for EAServer 6 x JBoss JEUS WebLogic NetWeaver and WebSphere To create data source for EAServer 6 x JBoss JEUS WebLogic NetWeaver and WebSphere refer to Database Connection Setup in the Appeon Server Configuration Guide Appeon applications use JDBC data sources created in Appeon Server to connect to the database The Data Source Profile tab allows you to maintain a storage of data sources which you can specify to use for Appeon applications Its function is the same as the one provided in AEM and changes made on the tab or AEM are automatically synchronized Figure 4 38 Data source profile amp Appeon Developer Configuration Application Profiles DB Type Profiles Server Profiles Deployment Profiles Data Source Prof
51. remove unsupported features in the application e How to manipulate the UFA Report in the UFA Report Window You can adjust the view of the UFA Report so it suits your preferences 5 2 1 Modifying unsupported features When the UFA Report is loaded you can view all the unsupported features in the left treeview and modify them one by one Step 1 Expand the unsupported feature list treeview and select the unsupported item The detailed analysis of the selected method will be displayed on the right of the window as shown in the following figure Figure 5 5 Unsupported feature details g Unsupported Feature Analysis Report appeontest Loe e File Edit View Tools Help Cs a2 Mee K CT i Code Diagnosis All unsupported items in the application appeontest 1 2 22 errr reer eee eee E peii Unsupported object 18 unsupported features eee i zzi System object or control 18 unsupported feat Pemp croate pele E fe variabledefinition 2 unsupported features Line Number El fe exception 2 unsupported features fe tracetree 2 unsupported features Location S Te neces 2 unsupported teatuias Cb 10 clicked event function of w_ufa in ufa pbl El Ta profiling 2 unsupported features 4 fe olestream 2 unsupported features Fm olestorage 2 unsupported features Unsupported Item Fe pipeline 2 unsupported features Pipeline Bufa pbl w_ufa cb_10 clicked Type E Ta Ipl_t
52. screen under iOS Settings gt App Name after the app is installed on the 10S based device Appeon Developer User Guide Page 155 Packaging Applications Appeon for PowerBuilder 2013 Group Value Description App URL Specify the app URL The URL supports both HTTP and HTTPs formats for example https 192 0 0 201 sales The URL can be changed in the screen under 10S Settings gt App Name after the app is installed on the i0S based device Startup Orientation _ Set the initial interface orientation when the app starts SSL Verify Peer Enable or disable the SSL peer verification SSL Verify Host Enable or disable the SSL hostname verification Connection Timeout Specify the timeout seconds for your app connecting to seconds the server Record Logs Option to record app logs Titlebar Full Screen by Set whether to display your app in full screen by default Icon Default Xcode App Major Version Specify the version number for your app App Build No Specify the build number for your app i0S iPhone App Icon Specify the app icon for the standard display on iPhone Standard Display 57 x 57 pixels iPhone App Icon Specify the app icon for the retina display on iPhone Retina Display 114 x 114 pixels iPhone Launch Image Specify the launch image for the standard display on Standard Display iPhone 320 x 480 pixels iPhone Launch Image Specify the launch image for the reti
53. settings parsing options Web service profiles and runtime settings 4 2 1 Managing application profiles The Configure tool provides an Application Profiles tab for you to modify the settings specified in the Appeon Developer Configuration Wizard and use the following advanced functions e Specify the default application profile e Select the file generation mode for an application e Delete an application profile e Boost the application runtime performance e Specify parsing options e Specify runtime settings e Configure Web Service profiles Appeon Developer User Guide Page 20 Configuring Appeon Developer Appeon for PowerBuilder 2013 4 2 1 1 Application Profiles tab page When you click the Configure button 2 on the Appeon Developer toolbar the Appeon Developer Configuration window appears with the Application Profiles tab selected by default as shown in the following figure Figure 4 12 Appeon Developer Configuration Window 2E Appeon Developer Configuration Application Profiles DB Type Profiles Server Profiles Deployment Profiles Data Source Profiles Application Profiles Configure the PowerBuilder applications you intend to deploy to the Web or to the Mobile Default Name Hisi Type Mode PBL Version Edit PO sales Universal soo codeexamples Release PowerBuilder 17 acf e Release PowerBuilder 17 Delete sapteched Universal Release PowerBuilder 17 order Universal Release PowerBuilde
54. small or trivial features which will not compromise application functionality even if they are not modified or worked around To customize or change priority levels for unsupported features take the following steps Step 1 Select the Tools gt Define Priority menu The Define Priority window is displayed as shown in the following figure Figure 5 14 Define Priority dialog box Define Priority axa Define Priorities Set priority for unsupported features Categories of unsupported features Priority Suggest to modify External visual userobject Have to modify Can be ignored External class userabject Have to modify System object or control Have to modify Duplicate objects Have to modify DW control Have to modify DW Style Have to modify External function Have to modify Shared variable Have to modify Data type Have to modify GOTO Have to modify Global symbol Have to modify Label Have to modify Function returned value Have to modify Variable name Have to modify Identifier not found Have to modify Function not found Have to modify Auto_Instantiation NVO evaluation Have to modify Keyword Have to modify Dynamic SOL Have to modify Other reason Have to modify Add Modify Delete Reset to Default OK l Cancel Step 2 Add modify or delete the system default priorities in the left Priority Level box Step 3 Change priority levels of unsupported feature types by selecting a priority level
55. specify how to deploy the AEM settings A n Please select whether to deploy the AEM settings and data source settings to the specified Appeon Server goeseesososeesesoessoeseesesesoes n F Data Source If a data source with the same name already exists in the Appeon Server then Overwrite it Do not overwrite it Step 9 Specify the destination folder for the undeployment tool and the log file and click Next Figure 11 21 Specify location for the Appeon Undeployment Tool S AS Appeon Application Deployment Install the Appeon Undeployment Tool F Please select the folder where the Appeon Undeploymen A Please specify where the Appeon Undeployment Tool will reside The deploy config file and the deploy log will also be stored in this folder Destination Folder Browse C Program Files 4ppeon Undeploy appeon_code examples Appeon Developer User Guide Page 142 Packaging Applications Appeon for PowerBuilder 2013 Step 10 Specify the destination file and source file that you want to replace for the Appeon application package and click Next Files also called destination file under the wcode folder of Appeon application package can be replaced by files of the same type also called source file so that the source file will be installed instead of the destination file When you click the Add button the File Replacement dialog box is opened To select the destination file clic
56. temporary Internet files folder to be emptied each time the browser is closed is recommended only during the development stage Once your Web application is ready for production deployment and frequent changes are not being made to the application this setting can be disabled once again unchecked This setting should be reset once development is complete so the Web application can be cached in each Client PC for better Client side performance Using this set of guidelines caching files should be enabled when they are needed for performance improvement and disabled during the development and debugging stages 8 1 2 3 Advanced settings for proxy server If the Client visits the Web application through a proxy server you need to select the Use HTTP 1 1 through proxy connections option under the HTTP 1 1 settings section as shown in the following figure The following steps detail the configuration needed in Internet Explorer Step 1 Click the Advanced tab in the Internet Options window as shown in the following figure Appeon Developer User Guide Page 102 Running Appeon Applications Appeon for PowerBuilder 2013 Step 2 Check the Use HTTP 1 1 through proxy connections check box under the HTTP 1 1 settings section as shown in the following figure Figure 8 4 Proxy connection settings Internet Options ex General Security Privacy Content Connections Programs Advanced Settings Never a Use i
57. the Deployment Profile tab Table 4 12 Instructions to use the Deployment Profile tab Use this button To Default radio Specify the default deployment profile used for Web or mobile button deployment Edit button Modify an existing deployment profile This will open the Deployment Profile Configuration dialog box Add button Create a new deployment profile This will open the Deployment Profile Configuration dialog box Delete button Remove a deployment profile 4 2 4 2 Deployment profile settings In the Deployment Profile Configuration dialog box set up the necessary configuration as shown in the following figure Appeon Developer User Guide Page 54 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 37 Deployment Profile Deployment Profile Configuration E Profile Name Local Deployment Appeon Server Web Server Deploy to one or more Appeon Servers Deploy to one or more Web Servers Local Appeon Server ra Local Web Server tence The following table describes the settings on the Deployment Profile Configuration dialog box Table 4 13 Deployment Profile settings In this field You can Profile Name Type the deployment profile name You can use names that are easy to remember and identify such as Test Deployment Remote Deployment Appeon Select a check box to include the Appeon Server in the deployment profile et All the Appeon Server
58. the Mobile Image Path Configure basic settings C Users Public D ocuments 4ppeon D eveloper201 3 appeondemo S ales4pplic Select PBL files Configure deployment settings Include Subfolders Select DB types Declare transaction objects Select image files E Select INI files E Deploy External Files E Summary Cancel Einish 4 1 7 Selecting INI files If a PowerBuilder application uses an initialization INI file which contains user preferences specify the INI file so that Appeon can deploy the file for the application Click Add File to add one or multiple INI files or click Add Directory to add all INI files in the selected directory For detailed information about the INI files refer to Deploy INI Files Appeon Developer User Guide Page 17 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 9 Select INI files Appeon Developer Configuration Wizard Please select the INI file s to be deployed with the Welcome application if there are any Click Next to proceed File List Configure basic settings a Select PBL files Configure deployment settings Select DB types Declare transaction object s Select image files Select INI files as 4 b Add File Add Directory E Deploy External Files E Summary Cancel Einish 4 1 8 Selecting External files If your application calls any custom user external files such a
59. the correct type of database driver for Select PBL files generating the correct database syntax for PowerBuilder SQL statements in the application Configure deployment settings Select DB types Used Supported Database Types Configured E Declare transaction object s Sybase ASE 12 x 15 x No J Sybase ASA 8 9 10 11 12 J Sybase IQ No a E Select image files Oracle 10g 11g No E Select INI files L Oracle Si No Oracle 8i No a Deploy External Files i maureen Anan anac sannan Te Edt Iest E Summary If the database type is not configured The Configured column is indicated with No you should select it and click the Edit button to create a profile for it For detailed instructions on creating a database type profile refer to Section 4 2 2 Managing database type profiles 4 1 5 Declaring transaction object s When the application is deployed to the Web or to the Mobile Appeon Server handles the database connection using data sources rather than transaction objects defined in Appeon Developer User Guide Page 14 Configuring Appeon Developer Appeon for PowerBuilder 2013 the PowerBuilder application You must associate the transaction objects used by the PowerBuilder application with proper data sources created in Appeon Server You can create modify or delete the mapping between transaction objects and data sources either in Appeon Developer or AEM Figure 4 6 Specify transaction objects
60. the likelihood of forgetting to add a required PBL e Click the Add button and add PBL files without using an application Target You can add one or multiple PBL files at the same time To select multiple files hold down the Ctrl key and choose which files to add e Copy and paste Ctrl C and Ctrl V the path list of PBLs into the Application PBLs field Note If you do not want Appeon to automatically update the PBLs every time you open this tab the Basic Settings tab in the Application Profile Configuration window or you deploy your application uncheck the Keep PBT Updated check box It is kindly recommended that you keep this option checked or you need to manually add the new PBLs or revised PBLs if there is any each time you perform a deployment 4 2 1 2 2 DB Settings The DB Settings tab allows you to specify the database types and the transaction objects that the application uses as shown in the following figure When configuring the database types it is not necessary to specify the actual databases that the application uses it can be any database of the same type However when specifying the transaction objects you must specify the actual transaction objects that the application uses What the DB Type is used for PowerBuilder SQL statements must be converted into the correct database syntax before they can be used to retrieve data from the database that the Web or mobile application connects to The DB Type settings enable
61. will be able to see details of this transaction in the Active Transactions tab in AEM when commit is executed inside the SP the transaction will end and disappear from the database end but as there is no commit in the PB code this transaction will still appear as an active transaction in AEM which will mislead end users to think this is an uncommitted transaction To avoid this misunderstanding you can disable this option so Appeon Server will not start a transaction when an SP is executed 4 2 1 2 3 Additional Files Additional files refer to the files that are outside the application source code but are necessary for running the PowerBuilder application including INI files NET COM components image files and external files such as DLL OCX files text files etc Appeon Developer User Guide Page 27 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 15 Additional Files tab 2 Application Profile Configuration mj Web Service Profiles Runtime Settings Summary Basic Settings DB Settings Additional Files Misc Settings Deploy INI Files IF your application stores configuration information in INI files Appeon can perserve the same behavior on the Web and on the Mobile Select the INI files used within your application Add Remove Deploy NET COM components IF your application uses NET COM components select the files and Appeon will deploy them to th
62. you can set a breakpoint to the FOR statement but the application will be suspended for only once when this statement is executed 7 4 2 Methods for setting breakpoints You can set breakpoints in the Source Breakpoints Variables or Watch view before or after the application starts to run in debug mode Method 1 Setting a breakpoint in the Source view Step 1 Select the script to display in the Source View Select a function or event in the Source Browser view to display its script in the Source View or right click on the Source view and select Select Script from the popup menu to select the script to be displayed Step 2 Right click a line in the Source view and select Insert Breakpoints from the popup menu Once a breakpoint is set a red circle displays at the beginning of the line Appeon Developer User Guide Page 93 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 Figure 7 3 Breakpoints are set E Debugger Ea File View E open string commandline return long for sales_application_demo of sales_application_demgq amp Application ajia H Windows cs E Menus H a User Objects H fa Functions SQLCA DBHS ODBC SQLCA AutoCommit False SQLCA DBParm ConnectString DSN AppeonSample UID dba P CONNECT m If SQLCA SQLCode lt gt 6 Then MessageBox Alert Connection to database failed Halt CLOSE Return End If 0PEN w_logon 7 If Message StringParm lt
63. 2 5 1 Installing Appeon Server EAServer and or Appeon F218 6 are Miola Pee Ore Ramee eae tr ema Ree er PORTE ee en eee een 210 17 2 5 2 Uninstalling Appeon Server EAServer and or Appeon PDPIICAN ONS stich tee Saree aoe he TAL ee et AN Ee 210 NG 32 OO TANS AEA E EEA A AAA yikes 210 17 3 Appeon Developer Toolbar Register Tool ceeceeeeeeeeeeeneeeeeeeteees 211 18 Technical Support cz sccieus ee Rice taeh taal ttelteat te hence els eet agdaclds cia ewhidde ennenen 213 TCO T E es eet nen tak Ee el Ihe Ak AIS lS ted AEA a NE hat Od 215 About This Book Appeon for PowerBuilder 2013 1 About This Book 1 1 Audience This book is written for PowerBuilder developers using Appeon Developer 1 2 How to use this book There are sixteen chapters in this book Chapter 1 About This Book A general description of this book Chapter 2 Introduction An overview of Appeon Developer Chapter 3 Before you begin Some important instructions that you MUST follow before using Appeon Developer Chapter 4 Configuring Appeon Developer Instructions for configuring Appeon Developer Chapter 5 Using UFA Tool Instructions for analyzing the unsupported features in a PowerBuilder application Chapter 6 Deploying PowerBuilder Applications Instructions for deploying PowerBuilder applications to the Web or the Mobile Chapter 7 Debugging Appeon Web Applications Instructions for using Appeon Debugger to debug an Appeon Web application C
64. 4ppeon D eveloper201 3 appeondemo salesapplicationdemo sales_ C Users Public D ocuments Appeon D eveloper201 3 appeondemo salesapplicationdemo sales_ Add l Remove Cancel Application Profile Name The application profile name is used to identify the PowerBuilder application during the entire PowerBuilder to Web or PowerBuilder to mobile process It is also used in the appeondb database on Appeon Server to identify the DataWindow syntax profile and registry information for an Appeon application The Profile Name cannot contain double byte characters such as Chinese Korean or Japanese characters or special characters such as lt gt orl Web Folder A URL of the Appeon Web or mobile application can contain a combination of letters underscores _ and numbers The specified folder is also used as the name of the folder created under the Web Root of the Web Server for storing the Web or mobile application files when the application is deployed Project Type The Project Type determines whether your PowerBuilder application will be configured for the Web migration process or the mobile migration process This means the application will be analyzed deployed run packaged and undeployed as a Web application or as a mobile application Avoid setting application URLs as existing folder names in the Web server Web root because 1 If a Web or mobile application uses an existing folder und
65. 8 9 Run Mode window E Appeon Download Center Windows Internet Explorer koJkE Sed ej http localhost appeontutord v 5 x Live Search 2 File Edit View Favorites Tools Help we we Appeon Download Center a B 7 v Page v G Tools v p Appeon Web Application Mode Run Now For high speed network The application runs immediately and files are downloaded only when needed Recommended for broadband connection such as xDSL Puneet For low speed network All files will be downloaded before the application runs Recommended for narrowband connection such as modem or ISDN Appeon Done A Internet Protected Mode Off 100 v Appeon Developer User Guide Page 110 Running Appeon Applications Appeon for PowerBuilder 2013 8 3 Appeon DataWindow menu Note This section is for Web applications only Appeon provides a Web enhancement the Appeon DataWindow menu for all DataWindows deployed to the Web When right clicking on a deployed DataWindow you can access the Appeon DataWindow popup menus Find Find Next Find Previous Sort Filter Print and Save As File Obsolete as shown in the following figure Figure 8 10 Appeon DataWindow popup menu Find Find Next Find Previous Sort Filter Print Save ss File 8 3 1 Enabling Appeon DataWindow menu To use the Appeon DataWindow menu you must enable it by using the following two functions appeonextfuncs of_popmenu and appeonex
66. AE E FE AE E AE AE E AE AE AE AE E AE AE AE AEE FE Enter the Port Username and Password of Appeon Server HTH AE FE FE AE FE FE AE FE AE FE FE AE FE FE AE FE HE FE FE AE FE FE FE FE HE E FE AE FE FE FE FE HE AE FE AE E FE AE FE FE E FE FE E FE AE AE FE AE FE FE E FE FE AE FE AE FE EE E E AppeonServerPort 9988 AppeonServerUserName AppeonServerPassWord Har aE aE aE HE EH FE FE EH aE Ea EE Ea aE Ea Enter the Web root of Web server FE FEAE HE aE aE He EH AE FE FE AE EEE EE Ea EEE aaa WebServerRootPath C Program Files Sybase EAServer html HT HE EH FE HE HHH EH AE FE FE HE EE EE EE EE EEE Ea Enter the path of Setup Log APBLog txt Hat a aE aE HEE a HE a EE EE HE aE aE EE EE aE aE HE aE EE EEE aE aE EE aE a EE a EE LOGPaicia es lee Hae a aE aE HE a aE aE A aE aE aE aE HE aE HE EE EE aE aE HE aE aE aE EE aE a aE Ea Ea EE Ea EE Enter the Web application number FE HEE HH EHH HH EH AE FE HE Ee EE a EE EEE WebApplications 1 HT HEH HE AE FE HE AE FE AE EH AE FE FE HE EE Ea EEE Web Application Configuration ConnectCache Og imo installi is install Owereyjrenice air esse Be AMSCalil MEE OVS te LE GRISE Appeon Developer User Guide Page 208 Extended Toolkit Appeon for PowerBuilder 2013 EAServerNVO Yes or No AEM Yes or No HEGRE HE HEHEHE FE FE FE FE HE HHH HEE HH EEE EE EEE HH FE FE TE FE AE EEE EE EE EERE WebApplicationl Web Application Name
67. Appeon Developer User Guide Appeon for PowerBuilder 2013 FOR WINDOWS amp UNIX amp LINUX DOCUMENT ID DC20238 01 065 1 01 LAST REVISED May 15 2013 Copyright 2000 2013 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 subparagr
68. Appeon Mobile E Installation Guide for Appeon Web Installation Guide on Cloud Platform G Development Guidelines for Appeon Mc a Migration Guidelines for Appeon Web Features Help for Appeon Mobile a Features Help for Appeon Web Appeon Developer User Guide Workarounds amp AP Guide Appeon Workspace User Guide Appeon Server Configuration Guide for Appeon Server Configuration Guide for AQ Web Server Configuration Guide Troubleshooting Appeon Perfomance Tuning Guide H Testing Appeon Web Applications with 4 m7 J Appeon Developer User Guide Appeon for PowerBuilder 2013 Help This help includes information about Appeon for PowerBuilder 2013 which consists of two products Appeon Mobile 1 0 and Appeon Web 6 6 m Getting Started with Appeon for PowerBuilder Introduction to Appeon New Features Appeon Mobile 1 0 Tutorials Installing Appeon for PowerBuilder Installation Guide for Appeon Mobile 1 0 Inntalintinen Onan fine Maman WAiak O A y Page 189 Extended Toolkit Appeon for PowerBuilder 2013 17 Extended Toolkit Appeon provides extended tools to ease your PowerBuilder to Web or PowerBuilder to mobile process These tools include e DLL OCX Files Package Tool It is designed as a solution for packaging and installing large sized DLL OCX files Note This tool is effective for the Web application only e Appeon Silent Insta
69. Disable otherwise Internet Explorer will crash Appeon Developer User Guide Page 105 Running Appeon Applications Appeon for PowerBuilder 2013 8 1 3 Language setting requirements Note This is required for the Web application only The language of the data in the database used by the application should match the Windows operating system language settings on the machine where Appeon Server is installed If the language settings conflict problems will occur when the Web application is run Verify that the language of the data in the database used by the Appeon deployed Web application matches the language settings of the client operating system Step 1 Select Windows Start gt Settings gt Control Panel Step 2 Click Regional Options as shown in the following figure Figure 8 7 Regional Options 4 Regional and Language Options xs Formats Location Keyboards and Languages Administrative i Some software and services provide you with local information such as news and weather Current location United States hd Cancel Apply Step 3 Verify that the language selected in the Your locale location list box and the language checked as default in the Language settings for the system settings are the same The language can be from different regions as long as it is the same language This configuration is not required for English language applications Appeon Developer User Guide Page 106
70. Find Find Find where employee_emp_id T Find what 148 up 7 Search Step 3 The first row that matches the search criteria will be highlighted Step 4 Right click and select Find Previous or Find Next to highlight the rows one at a time that match the criteria 8 3 2 2 Sort and filter The user can sort data by the column in ascending or descending order or filter data using a number of functions To sort data Step 1 Right click the Web DataWindow and select Sort from the popup menu as shown in the following figure Appeon Developer User Guide Page 112 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 13 Sort Datawindow Department Name State Employee Employee Emp ID Last Name First Finance MA 148 Jordan Julie MA 390 Davidson JoAnn Find Next ina MA i f Kristen MA Find Previous res MA Sort Janet MA Filter Jennifer MA John MA Print Melissa M Save As File lane MA 318 Crow John MA 409 Weaver Bruce MA 591 Barletta Irene m Step 2 Specify the column used to sort the data in the DataWindow by clicking on the column name in the left list box The column name appears on the right as shown in the following figure Figure 8 14 Specify sort column employee_emp_Iname employee_emp_fname employee_salary employee_state Specify Sort Colurnns fea 1 Drag and Drop items 2 Double click column to edit Source Data C
71. Guide for details 3 2 Configuring application database connectivity Perform the following database configurations for all prospective PowerBuilder applications that will be deployed with Appeon Developer 1 Set up the database used by the PowerBuilder application to interface with Appeon Server and the JDBC driver Refer to the documentation from appropriate database vendors for instructions 2 Create the data source in Appeon Server Appeon provides systematic instructions for certified database systems Refer to Setting up Appeon Server data sources in the Appeon Server Configuration Guide for more information 3 Map the transaction object in the target PowerBuilder application to the newly created data source for the prospective Web or mobile application You can either dynamically set up the mapping via PowerScript following the instructions in Dynamic transaction object to data source mapping in the Appeon Server Configuration Guide or establish the mapping statically in Appeon Developer or AEM 3 3 Starting Appeon Server Appeon Developer interacts with Appeon Server and Web server during Web or mobile deployment Web or mobile applications are deployed to one or more Appeon Servers and one or more Web servers You should verify that the Appeon Server and Web server are running before deployment If you use the application server built in Web server as the Web server you only need to start the application server Appeon Server For e
72. IDE and make code changes in the original PowerBuilder application Redeploy the application and run the application in Internet Explorer to verify if the problem has been corrected If the problem still exists and you need to return to Appeon Debugger to redeploy the application Otherwise the latest code changes will not be reflected in Appeon Debugger Appeon Developer User Guide Page 98 Running Appeon Applications Appeon for PowerBuilder 2013 8 Running Appeon Applications Appeon Web applications are accessed via Microsoft Internet Explorer and Appeon Mobile applications are accessed via Appeon Workspace Confirm that the Web Server s and Appeon Server s hosting the Web or mobile applications are running and verify that the Web browser meets the necessary requirements outlined in the Appeon Installation Guide 8 1 Requirements 8 1 1 Windows account privileges Note This is required for the Web application only When you run an Appeon Web application for the first time the Xcelerator plug in ActiveX controls for improving the runtime performance of Web applications must be downloaded to the client Different Internet Explorer versions require different privileges for installing the ActiveX control For example if using IE 8 0 or 9 0 on Windows Vista 7 2008 you do not need administrative privileges to download and register the ActiveX control You can log into the machine as a normal user However if using IE 8 0 or 9 0 on
73. PowerBuilder Applications Appeon for PowerBuilder 2013 Description detailed instructions refer to Section 5 2 Working with UFA Report Step 3 Click the Finish button to close the Appeon Deployment Wizard or click Finish and Debug to close the Appeon Deployment Wizard and open Appeon Debugger to debug the application or click the Finish and Run button to close the Appeon Deployment Wizard and then select a project loader from the dialog box that appears to automatically launch the newly deployed application Note When you click Finish and Debug or Finish and Run to run the application please make sure the database connection from Appeon Server to the database server has been properly configured For detailed instructions refer to the Server Configuration Guide Figure 6 7 Project Loader Select Project Loader Project Loader JE Browser Orientation Landscape ETE Appeon Developer User Guide Page 88 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 7 Debugging Appeon Web Applications Sometimes a deployed application may not behave well although the original application does In these situations you can examine the execution results of the JavaScript code in the deployed application using Appeon Debugger The usage of Appeon Debugger is similar to that of PowerBuilder Debugger You set breakpoints or watch variables in the PowerBuilder source code same as in PowerBuilder Debugger
74. Progress Deployment Information Appeon Deployment Wizard deploys all required files to the Appeon Server s and Web Servers You can run the deployed application once the deployment is finished Time Run Information 13 36 45 Connecting to Appeon Server localhost G 13 36 45 Deploying application name to Appeon Server localhost m 0 Cancel Click the Cancel button or press the Esc key to terminate Task 3 If you cancel Task 3 during a Full Deployment only some of the application files will have been uploaded to the server and the application will not run correctly To correct this select Incremental Deployment or Deploy Already Generated Application as the deployment mode the next time you attempt to deploy the application Step 2 After Task 3 has been completed click the Next button at the bottom of the Appeon Deployment Wizard to display the deployment report page as shown in the following figure Appeon Developer User Guide Page 86 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Figure 6 6 Appeon Deployment Wizard si Appeon Deployment Wizard sales o lee Deployment Information Application deployed sales Deployment mode Full Application Deployment Deployment profile used Local Deployment Deployment Task Summary Task Status Time Task 1 Application Source Code Export Completed lt 1 Minutes Task 2 Appeon Application File Generation Completed lt 1 Mi
75. Project sales_application UFA_Report xml Close Step 2 Select the application in the top dropdown listbox Step 3 Select a report type or log type in the left box and the corresponding report button or log files are displayed in the right box If there is more than one log file generated the log files are listed in order according to the date and time of generation the latest log will be listed at the top You can open one log at a time or open several logs at one time select a continuous range of log files by holding down Shift and click log files or select a disconnected range of log files by holding down Ctrl and clicking log files Then click View to open the selected log files The View and Delete buttons will be disabled if no log files were generated Note For Deploy Log you can click View All to view all information such as errors warnings and process description or click View Warning to view warnings only or click View Errors to view errors only Step 4 Click the report button or log file to view the report or log You can continue with other operations while the Information Manager opens For example you can perform feature analysis deploy the application or run the Web or mobile application If any new reports or logs are generated when the Information Manager is still open the new reports or logs are not reflected in the Information Manager immediately You need to refresh Information Manager in eit
76. Running Appeon Applications Appeon for PowerBuilder 2013 8 1 4 Disabling anti pop up software Note This is required for the Web application only If anti popup software example Popup Stopper by Panicware is installed and is active on the Client machine it will not allow any browser pop ups to occur This can cause certain operations to become disabled in the converted Web applications such as the enhanced Web features detailed below or other operations that automatically load an Internet Explorer window or popup To prevent any problems it is recommended that users disable any anti popup software while using the converted Web applications 8 2 Accessing Appeon applications 8 2 1 URLs for Appeon applications A typical URL for a mobile application is similar to the following e http 192 0 0 80 8080 appeondemo A typical URL for a Web application is similar to one of the following e http 192 0 0 80 8080 appeondemo x32_index htm e http 192 0 0 80 8080 appeondemo x64_index htm A complete application URL consists of five parts Table 8 1 Application URL Application Description URL Protocol Uses http typically If your Web Server is configured as an SSL Web Server use https IP address Uses the IP address or domain name of the Web Server Using localhost or domain _ listeners in a production environment is not recommended although the name Appeon installation program has created an HTTP listener
77. Server m HTTP Server localhost HTTP Pott 80 Local Server Settings FTP File Transfer Settings Web Root Path C inetpub wwwroot 21 E g for EAS erver Web Server this should be the full path to ZJAGUAR ZS html Browse File Compression Settings for War Jar Test Settings Appeon Compression After entering the Web Server settings we recommend that you test the settings by clicking the JDK Compression Path button below Bre Test Web Server Settings Caneel The following table lists detailed instructions for how to specify the properties for a Web Server profile Table 4 11 Instructions for creating a Web Server profile Property Instructions Profile Profile Name Assign a name to the Web Server profile Settings You should use names that are easy to remember and identify such as Web Server for Test or Production Web Server File Transfer Use Local Server if the Web Server is on the local Type machine Appeon Developer User Guide Page 48 Configuring Appeon Developer Appeon for PowerBuilder 2013 Property Instructions Use Remote Server if the Web Server locates remotely Web Server Settings Server Type Select the Web server type Appeon supports the following Web Server types Apache EAServer IIS JBoss WebLogic WebSphere NetWeaver Application Server and JEUS HTTP Server Enter the IP address or the machine name of Web Server HTTP Po
78. Settings E Specify Destination Folder E Packaging Process E Finish Appeon Developer User Guide Page 130 Packaging Applications Appeon for PowerBuilder 2013 Step 9 Select whether AEM settings and data sources for the current application will be packaged and click Next The AEM settings will be saved in the AEM xml file and data sources will be saved in the config xml file Figure 11 8 Select AEM settings and data source Appeon Application Package Wizard You can select to package the AEM settings and Welcome the application server data source settings for the current Appeon application Select Package Type Please select whether to package SEM settings and data source settings Select Application Please note that these settings can only apply to Appeon Server of the same type from J2EE to J2EE or from NET to NET Select Appeon Server JEM Settings Configure EAServer Profile Data Source Settings for EAServer or IIS only Select NVOs Select AEM Settings E Specify Destination Folder E Packaging Process E Finish Step 10 Specify the storage location for the generated package and click Next The generated package will be stored under a folder named Application Profile Name_install under the specified location Appeon Developer User Guide Page 131 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 9 Specify destination location for the package Appeon Appli
79. The Language Settings dialog box is displayed as shown in the following figure Figure 4 20 Application language settings 28 Language Settings Ex Language Please specify the language for system prompts and messages System Prompt Language English b Cancel Step 2 Select a language from the System Prompt Language dropdown list box System prompts are error messages informational messages warnings notices and prompts that are displayed when you run Appeon applications Step 3 Click OK to save the settings Performance Settings Appeon recommends that you take advantage of the performance settings to boost the application s runtime performance To achieve the best performance perform the following steps Step 1 Click the Performance Settings on the Misc Settings tab The Performance Settings dialog box is displayed as shown in the following figure Appeon Developer User Guide Page 33 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 21 Performance settings Q Performance Settings Performance Boosters Merge files Performance Analyzer For Web only Data is not encrypted during the transmission if this option is enabled Strongly recommend to disable it when transfer applications to the live or production environment Performance Analyzer compliance Appeon Activex Download For Web only Download Activex files in a single thread Cancel Step 2 S
80. This option enables you to do a feature analysis of the whole application or PBL s in the application or objects in the application e Use the first two tasks in Appeon Deployment Wizard When you use Appeon Deployment Wizard to deploy an application the first task the wizard performs is a feature analysis of the whole application This section mainly gives instructions on the first option using the Unsupported Features Analysis tool For more information about the second option refer to Section 6 2 Deployment process Step 1 Select the File gt New Report menu in the UFA Report window The New UFA Report dialog box appears as shown in the following figure Appeon Developer User Guide Page 63 Using UFA Tool Appeon for PowerBuilder 2013 Figure 5 3 New UFA Report dialog box New UFA Report x Application Profile sales_application_demo B Please select the objects to be included in the analysis of unsupported features D ve sales_application_demo cam C Program Files 4ppeon D eveloper6 2 appeondemo salesapplic cam C Program Files Appeon D eveloper6 2 appeondemo salesapplic cam C Program Files Appeon D eveloper6 2 appeondemo salesapplic 4 mW b V Display Full Path Refresh Cancel The following table gives a brief description of the elements in the New UFA Report dialog box Table 5 4 New UFA Report window Element Description Application profile _ Provides a
81. ab pages for you to edit the required application information Table 4 2 Application Profiles settings Settings To make changes effective you must Basic Settings The application profile name project Perform a full or type application URL PBL version incremental deployment on the application Appeon Developer User Guide Page 22 Configuring Appeon Developer Appeon for PowerBuilder 2013 411 Settings and PBL location of an application See Section 4 2 1 2 1 Basic Settings To make changes effective you must DB Settings The database types transaction objects and the corresponding data sources See Section 4 2 1 2 2 DB Settings Perform a full or incremental deployment on the application Additional Files INI files LNET COM components image files and External files See Section 4 2 1 2 3 Additional Files Perform a full or incremental deployment on the application Misc Settings Command line arguments application language runtime performance parsing option and log writing mode See Section 4 2 1 2 4 Misc Settings Perform a full deployment on the application Web Service The WSDL file service name and port for the Perform a full or Profiles Web service s See Section 4 2 1 2 5 Web incremental deployment on Service Profiles the application Runtime Company name and application name P
82. ager Step 1 Click the AEM button on the Appeon Developer toolbar If more than one Appeon Server profile is configured the Select an AEM URL to run page is displayed as shown in the following figure All Appeon Server profiles and corresponding AEM URLs are listed The Appeon Server configured as the default server is highlighted and selected If only one Appeon Server profile is configured the entry page of AEM is displayed Figure 14 1 Select an AEM URL to run WP Select an AEM URL to run Appeon Server Profile Name AEM URL 192 0 1 56 http 192 0 1 56 8080 4EM http localhost 7001 AEM es Appeon Developer User Guide Page 184 Launching Appeon Enterprise Manager Appeon for PowerBuilder 2013 Step 2 Select an AEM URL and click Run as shown in the following figure The entry page of AEM is loaded in an Internet Explorer page as shown in the following figure Figure 14 2 Appeon Enterprise Manager entry page a Appeon Enterprise Manager AEM Windows Internet Explorer Brim o9 le http localhost AEM a x p Bing _ gt ol Favorites Appeon Enterprise Manager AEM A E mh v Pager Safetyy Toolky Welcome to use Appeon Enterprise Manager User Name admin Password The AEM URL is automatically entered into the Internet Explorer address bar when you click the Run button You can configure AEM s URL
83. ake sure the Web Server profile can be successfully used for application deployments Test Web Server settings by clicking the Test Web Server Settings button Do NOT proceed to the next step until the testing succeeds If the Web Server is a remote server refer to Section 4 2 3 3 1 Two requirements for FTP settings to make sure the configuration for the Web Server profile is successful If the Web Server is an SSL Web server refer to Section 4 2 3 3 2 If the Web Server is an SSL Web Server to make sure the configuration for the Web Server profile is successful 4 2 3 3 1 Two requirements for FTP settings If you configure a Web Server profile for a remote Web Server make sure the FTP settings in the Web Server profile meet the following two requirements e The user name and password for accessing the FTP server should have permission to read and write files to the FTP server of the Web Server e The FTP home directory should be mapped to the Web root of the Web Server Appeon Developer User Guide Page 50 Configuring Appeon Developer Appeon for PowerBuilder 2013 The following steps use the Microsoft IIS FTP service as an example to show you how to fulfill the requirements You should find that the settings for other FTP types are similar to the settings for Microsoft IIS FTP Step 1 On the FTP server Web Server open the Internet Services Manager in Administrative Tools as shown in the followin
84. aking changes deployment and re deploys files for the time than a full to an already fully changed objects only deployment deployed application s The Deployment Wizard source code or features ote in the application continues even if it finds fil unsupported features during this Pee process Deploy Bypasses the object exporting Much less time When you intend to Already and file generation tasks and than a Full or 1 deploy the files Generated only re deploys the Web or Incremental for the changed Application san see a the changed Deployment objects to the server 9 Pi ee neg after an Incremental appicaion Deployment has been cancelled during the Web or mobile deployment Task 3 Appeon Developer User Guide Page 81 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Deployment What It Does Elapsed Time When To Use It Mode 2 refresh the set of files on the server after a Full Deployment has been cancelled during the Web or mobile deployment Task 3 3 deploy the application to a different server Appeon Developer will automatically set the default deployment mode by detecting whether a folder named after the application exists in the Appeon Developer2013 Projects directory on the Developer machine If the folder is detected the application will be regarded as an already deployed application and incremental deployment mode is selected otherwise full deployment mode is selected
85. al button on the Appeon Developer toolbar to open the Appeon Application Package Wizard Step 2 Select or create a profile from the dropdown list box and click Next to proceed A profile is a configuration file containing the settings that you specify when packaging the application You can select an existing profile or create one by entering a name in the text field The profile will be automatically saved and listed for selection next time when you launch the Appeon Application Package Wizard again Figure 11 33 Welcome page Appeon Application Package Wizard Welcome to the Appeon Application Package Welcome Wizard E Select Package Type E Select Application Please select an existing profile or create a new one E Select Appeon Server E Configure EAServer Profile E Select NVOs E Select AEM Settings E Specify Destination Folder E Packaging Process E Finish Step 3 Select the Package a Native Mobile Project radio button To package a deployment project that can install the application to servers follow detailed instructions in Packaging a deployment project To customize Appeon Workspace and then package Appeon Workspace to an Xcode project follow detailed instructions in Customizing and packaging Appeon Workspace Appeon Developer User Guide Page 152 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 34 Select package type Welcome Please select a package type Select Packa
86. an application verify that it is not in use To continue click Next To exit the wizard click Cancel Step 3 Select an existing deploy config file to automatically use the configuration previously used for the deployment wizard Figure 11 26 Select the configuration file Appeon Application Undeployment Select an Existing Deploy config File Please select an existing deploy config file f The wizard automatically loads the configuration file for the current package and uses the settings in this file as the default settings for the subsequent steps You can modify the settings in this file or select another configuration file Note ou can clear the configuration file path in the Destination File box and click Next to configure the settings manually Destination File AppeoniWebsppPackageappeon_code_examples_install iniconfia xm Browse Appeon Developer User Guide Page 146 Packaging Applications Appeon for PowerBuilder 2013 Step 4 Specify the Application URL Figure 11 27 Specify Application URL ppeon Application Undeployment Specify Undeployment Settings Please input the undeployment settings i Please specify the URL for the application to undeploy Application Profile Name appeon_code_examples Application URL http web server port Eee eee ees Step 5 Select the Appeon Server s and Web server s where application will be undeployed To cr
87. anager AEM FEE Size Calculator Converts the display size between Dots Points and PB Units i Appeon Launches Appeon Workspace Emulator Workspace Emulator 2 Help Searches browses prints copies and pastes useful information from the Appeon user guides lt Get Support Displays the product version and the support information The Check Update button in it allows you to check the Appeon updates Apart from Code Insight and Information only one Appeon Developer toolbar function can be launched at any given time This prevents an Appeon Developer process from interfering with another 2 2 Web and or Mobile application development with Appeon Developer For either developing a new Web or native mobile application or migrating an existing PowerBuilder application onto the Web or to the Mobile you need to perform three key tasks in Appeon Developer Analyze Modify and Deploy Automatically Appeon Developer User Guide Page 5 Introduction Appeon for PowerBuilder 2013 If you use Appeon for PowerBuilder for developing a new Web or native mobile application the first step is to write a new PowerBuilder application refer to Web RAD with Appeon for PowerBuilder in the Appeon Migration Guide It is recommended that the new PowerBuilder application conforms to Appeon coding styles as laid out in Appeon Features Help then you will expend less effort in the first two tasks Analyze and Modify e Task 1 Analyze You n
88. anager AEM will be Settings automatically generated after you specify the Server and Server Port The URL will be in the following format http server port AEM for example http localhost 9988 AEM Note 1 If you use EAServer as Appeon Server the Appeon installation program creates an HTTP listener localhost 9988 for Appeon Server If the Appeon Server configured is a local computer the following URL should always work http localhost 9988 AEM 2 Do not use a localhost listener in a production environment Connection Select HTTP or HTTPS to connect to AEM method If the Web server is configured as an SSL Web Server check the HTTPS secure option Otherwise check the HTTP insecure option Deployment Deployment The Get State button can get the state of the Deployment Security Security Security settings in AEM If Deployment Security is set Settings to ON the state will be Enabled and you must specify the deployment user name and password By default the Deployment Security in AEM is OFF so the state is Disabled Username Enter the username used to deploy the application The username and password for the deployment security feature are configured in Appeon Enterprise Manager AEM The username can be left blank if the deployment security feature is turned off in AEM Password Enter the password used to deploy the application The username and password for the deployment securi
89. aph 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 i ADOUE TIS BOOK Seasstate ee eee a leet ee E liad eaten ital e a a 1 A PUGUGIICE EAEE ni euiecieaig leit totale ET 1 12 OW TO USE this BOOK sniene ee rede voles aa EAEE a Sa aiSia 1 1 3 Related GOCGUIMGNIS siisii a aaa E aaa aia 2 T4 f you meed hel a e aaa eea eE EARE EENE EEEE EAE AE ERENCE 3 PAAA iole O CH OM EREE E AE 4 2 1 Appeon Developer toolbar in PowerBuilder ccceceeeeeeeeeseteeeeeeeeeees 4 2 2 Web and or Mobile application development with Appeon Developer 5 3 B fore VOU GOIN si cecees tee ot cache ak ces nE read eds AA AEEA A EREE AEEA 7 3 1 Installing Appeon for PowerBuilder ecscccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 7 3 2 Configuring application database connectivity ceeeeerteeteteeeeeeeeeeeees 7 320 DIAMING APPCOM SOI srera ie tle sce let eerie tio E AEA Sa 7 4 Configuring Appeon Developer ccccececcccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeenaeaeeeeeeeeeee 9 4 1 Using Appeon Developer Configuration Wizard ccceeeeeeeeeeeeeeeeeteees 9 4 1 1 Configuring basic settings secs cs vecece cs tvedevceet selackcdcreeneeaalaeetsacauanng 10 4 1 2 Selecting PBL Tile S cices tact oitiaceecentettre es Risiceiael sees cee helate
90. at the SSL Web Server is set up correctly and is fully functional For detailed instructions on configuring a Web Server as an SSL Web Server refer to the corresponding documents provided by the Web server vendor 2 If you want to re deploy an application which is now running online or on a mobile device e You can incrementally deploy the application while keeping the application running online or on a mobile device if non database related source code and image files are changed e You must shut down the running deployed application and then full or incrementally deploy the application if the INI files or database related source code are changed Otherwise the application may have runtime problems such as database connection failure or missing tables or fields 6 1 Deployment performance The deployment process can be very CPU and memory intensive so we recommend that you use a developer computer that conforms to the recommended specifications outlined in System Requirements section of the Appeon Installation Guide for a Developer PC to run Appeon Developer Be sure to close any unnecessary programs and Windows services in order to have an optimal amount of memory available for the deployment process 6 1 1 Speed of Deployment Process The table below benchmarks the time taken or speed to compile various applications in PowerBuilder and deploy to the Web or mobile with Appeon In general the results indicate that the speed of the Appeo
91. ata Appeon Developer User Guide Page 202 Extended Toolkit Appeon for PowerBuilder 2013 Table 17 6 Parameter for EAServer path Parameter EAServerPath Description If the EAServer parameter is set to No this specifies the path of an existing EAServer The specified path will be validated If the EAServer parameter is set to Yes this indicates where EAServer will be installed Accepted Values A valid path Default Value None Example EAServerPath C Program Files Sybase EAServer Table 17 7 Parameter for ASA path Parameter ASAPath Description Specifies the ASA installation path The specified path will be validated Accepted Values A valid path Default Value None Example ASAPath C Program Files Sybase Shared AS A802 17 2 3 3 EAServer Host Name Port Username and Password Specify the EAServer host name port number user name and password Table 17 8 Parameter for EAServer name Parameter EAServerName Description Specifies the IP address of EAServer Accepted Values A valid IP address Default Value None Example EAServerName localhost Table 17 9 Parameter for EAServer port Parameter EAServerPort Description Specifies the port number of EAServer Accepted Values A valid port Default Value None Example EAServerPort 9000 Table 17 10 Parameter for EAServer username
92. ateess 12 4 1 3 Configuring deployment settings ccccceseeeeeeeeeeeeeeteeeeeeeteeenees 13 4 1 4 Selecting DB Type S scnsctectaicieinecckaiete eldis istees iattieceleeedianiatgcueieies 14 4 1 5 Declaring transaction object S cceeeeeeeseceeeeeeeeeeeeeeeeeeeeeeeeeeees 14 4 1 6 Selecting image files Aiicrerut cen aos ee temo ein 17 Ack Selecting IN MIG Sinon nan a aaa aaea A aE eter laut 17 4 1 8 Selecting External files xicsitccesscisiatinioeteoteslatsteccpieisipicteedcendabanialince 18 AVS SUMMA serren n e As iaee EEEE AAE tae EE AAEE 19 4 2 Using GContiqure Tool reneenipiaa aaaea a E E 20 4 2 1 Managing application profiles ssesessseeneneeeeenernresererrnnrsserrrrenneeee 20 4 2 1 1 Application Profiles tab page ccceceessseeceeeeeeeeeeseeeeees 21 4 2 1 2 Application profile settings 2 0 0 0 eecececceeeeeeeeeeeeeeeeeeeeeeeeees 22 4 2 2 Managing database type profiles ccccceeeeeeeeeeeeeeeeeeeneeeeeeeeees 41 4 2 3 Managing Server profiles ccccceeeeeeeeeseeeeeeeeeeeeeeeeeeeeeneneaeeeeees 44 4 2 3 1 Server Profiles tab page cicicisisiststctiseiiiecteintdint hatealicdseiateiaaett 44 4 2 3 2 Appeon Server profile settings cccceeeeeeeeeeeeeeeeeeeeeees 45 4 2 3 3 Web Server profile settings ccceeeeeesececeeeeeeeeeeeeeeeees 48 4 2 4 Managing deployment profiles ccceeeeeecceeeeeeeeeeeeeeeeeeeeeeeeeees 53 4 2 4 1
93. ations Appeon for PowerBuilder 2013 Deployment Task Full Incremental Deploy Already Deployment Deployment Generated Application Analyzes unsupported features and generates Web or mobile application files Task 3 Web or Mobile Deployment Y Y Partial Y Deploys the generated Web or mobile application files to Appeon Server Figure 6 2 Full application deployment 49 Appeon Deployment Wizard sales o k The Application Deployment Wizard will guide you through the automated conversion process Please ensure that the correct PowerBuilder application and deployment settings have been selected and press Next to continue PowerBuilder Application Application to be deployed aglai x Deployment profile Local Deployment X Deployment mode Full Application Deployment z Unattended Deployment Reporting Options Generate Unsupported Features Analysis Report tes As shown in the above figure the application to be deployed is the sales_application_demo and the deployment mode is Full Application Deployment The following are the complete steps in the deployment process Step 1 Click Next The Appeon Deployment Wizard begins Task 1 Application Source Code Export as shown in the following figure Appeon Developer User Guide Page 83 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Figure 6 3 Task 1 Application Source Code Ex
94. available on the Server Profiles tab page for you to modify create or remove Appeon Server or Web Server profiles Section 4 2 3 2 Appeon Server profile settings and Section 4 2 3 3 Web Server profile settings provide instructions on how to configure the properties for an Appeon Server or Web Server profile when you modify or create a new server profile 4 2 3 2 Appeon Server profile settings Before you edit or add an Appeon Server profile make sure that the Appeon Server specified in the profile is running and that the Appeon Developer computer can successfully connect to the Appeon Server computer If you want to deploy the application to an Appeon Server cluster you must create profiles for each participating Appeon Server and deploy the application to all Appeon Servers in the cluster Appeon Developer User Guide Page 45 Configuring Appeon Developer Appeon for PowerBuilder 2013 The following figure shows the Appeon Server Profile Configuration window that displays when you click the Edit or Add button in the Appeon Server group box of the Server Profiles tab page Figure 4 31 Appeon Server Profile 2E Appeon Server Profile Configuration Profile Settings Appeon Server Settings Profile Name Server Type J2EE NET Server localhost Server Port http 80 AEM Settings Deployment Security Settings When using HTTPS please make sure you have Deployment Security Disabled Get State configured a
95. base or dynamically generated To resolve this you can copy the image files directly to the Deployment Path images folder but make sure that the file names are all lowercase otherwise the Web or mobile application may fail to load them Deploy External Files If your application calls any custom user DLL OCX files for Web applications only which are also called external non system DLL OCX files in this tab or if your application calls any other external files such as text files you can specify them here and deploy them to the Web server Deploying DLL OCX files is used as an example in this guide If there are many large size DLL OCX files in your application and they could be slow to download from the Web server at runtime you may prefer to use the DLL OCX File Packaging tool provided by Appeon to package the files into one setup program see Chapter 17 Extended Toolkit for detailed instructions then distribute the setup program to the users and have the users install the files to each Client Click Option in the Deploy External Files group box to open the Deploy External Files dialog box as shown in the following figure and select the required external files to be deployed Appeon Developer User Guide Page 29 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 16 External Files Automatically Deploy and Download Q Deploy External Files Sx External Files Register File Name File Path Add
96. brief description of all the log files generated during the Web or mobile migration process and the log types they are associated with Table 10 2 Log Type Description Log Type Description Deploy Log Deploy Log is generated during application deployment and records the deployment process status All log files are named according to the following format Log Type i e DeployWizardLog or FeatureAnalysisLog time when the log file is generated yyyy mm dd hh mm ss xml For example DeployWizardLog_20050220101918 xml Analysis Log Analysis Log is generated during the feature analysis process and records the analyzing status 10 1 Viewing the reports and logs Step 1 Click the Information button on the Appeon Developer toolbar and the Information Manager is displayed as shown in the following figure Appeon Developer User Guide Page 121 Using Information Manager Appeon for PowerBuilder 2013 Figure 10 1 Information Manager Information Manager sales_application_demo Please select an application sales_application_demo 7 a Appeon Application Unsupported Feature Analysis Report Ed Analysis To generate the Unsupported Feature Analysis Report the application must be K Performance analyzed by running Unsupported Feature Analysis or Application Deployment Wizard B 48 Appeon Developer K Deploy Log Analysis Report K Analysis Log C Program Files 4ppeon Developer6 2
97. cation 77 82 deployment duration for full deployments 78 deployment duration for incremental deployments 78 deployment performance 77 deployment process 79 deployment profile settings 54 deployment profiles tab 54 develop with Code Insight 178 disable anti pop up software 107 DLL OCX files package tool 190 E EAServer and ASA path 202 EAServer host name port username password 203 enable Appeon DataWindow menu 111 enable Code Insight 181 evaluate an expression 98 examine an application at a breakpoint 95 examine context in Call Stack view 98 export or import an application profile 22 extended toolkit 190 F filter UFA report items 71 find 111 fix code stop the debug procedure 98 I If you need help 3 install an application 135 Page 215 Index Appeon for PowerBuilder 2013 install and uninstall an Appeon application 135 install and uninstall DLL OCX files 194 install Appeon for PowerBuilder 7 install Appeon Server EAServer and Appeon applications 210 install DLL OCX files 194 installation types 202 internet explorer settings 99 L language setting requirements 106 launch Appeon Enterprise Manager 184 184 launch application from Run button 108 Launching Appeon Workspace Emulator 119 M manage application profile 20 manage data source profile 56 manage database type profiles 41 manage deployment profiles 53 manage server profiles 44 manipulate UFA r
98. cation Package Wizard The packaging tool will create a folder named Welcome Application Profile Name_install to store the packaged application Select Package Type Where do you want to place the folder Select Application Application Profile Name sales Select Appeon Server Specify the directory where the install folder will reside Configure EAServer Profile C Program Files 4ppeon AppPackage s Select NVOs Select AEM Settings Specity Destination Folder E Packaging Process E Finish EZE Step 11 Wait while the wizard is packing files and settings Appeon Developer User Guide Page 132 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 10 Application packaging status window Appeon Application Package Wizard ese Please wait while the packaging tool performs the Welcome requested operation This may take several minutes Select Package Type Time Run Information 16 57 38 Packing files 16 57 38 Connecting to Appeon Server localhost Select Application Select Appeon Server Configure EAServer Profile Select NVOs Select AEM Settings Specity Destination Folder Packaging Process E Finish Next gt Finish Step 12 Once the operation is complete click Finish to exit the package wizard To view the log information generated during the packaging process select the View Package Log box and then click Finish The log file will be displayed Appeo
99. ck Test to verify the connection and the click OK to finish the creation Figure 11 30 Edit EAServer profile E Edit E Server Profile om Profile Name Server Name Port Number Login Name Password Note Input the real IP address in the Server Name field For example 192 0 0 1 Test Cancel Step 7 If the EAServer Components option is selected in the previous step select the EAServer profile from the list and the components to undeploy Click Next to proceed Appeon Developer User Guide Page 149 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 31 Select EAServer components ppeon Application Undeployment EAServer Components Please select which EAServer componen Please select which EAServer components will be undeployed from EAServer EAServer List 192 0 1 56 OS Component List Step 8 Wait while the wizard is removing files and settings Step 9 Once the operation is complete click Finish to exit the undeployment wizard To view the log information generated during the uninstall process select the View Log box and then click Finish The log file will be displayed Appeon Developer User Guide Page 150 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 32 Undeployment complete ea Appeon Application Undeployment Finished undeploying the Appeon application The undeployment wizard has finished removing the application and the related s
100. click the Watch view and select Insert from the popup menu Step 2 Type valid PowerScript expression in the New Expression dialog box and click OK to add it to the Watch view 7 6 3 Changing the value of a variable or expression To change the value of a variable in the Watch view Step 1 Double click a variable or right click a variable and select Edit Variable The Modify Value dialog box will be displayed Step 2 In the Modify Value dialog box type a new value for the variable in the New Value box click OK to close the Modify Value dialog box and continue debugging the application with the variable set to the new value Figure 7 6 Modify value Modify Value Variable string commandline Current Value Null E Cancel New Value To modify an expression in the Watch view Step 1 Double click an expression or right click an expression and select Edit Expression The Modify Expression dialog box will be displayed Appeon Developer User Guide Page 97 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 Step 2 In the Modify Expression dialog box type the new expression in the New Value box and click OK Notice that it is unsupported to select the Null check box in the Modify Value or Modify Expression dialog to set the value of the variable or expression to null 7 6 4 Evaluating an expression To evaluate an expression in the Quick Watch dialog box and add it to the Watch view St
101. ct NVOs Select AEM Settings E Specify Destination Folder E Packaging Process E Finish If EAServer components are used in the application select the Package EAServer Components option and then create connection profiles for EAServers which host the components Follow instructions below to create EAServer profiles e Click Add to create an EAServer profile e In the Edit EAServer Profile dialog box input the following connection parameters profile name host name or IP address port number user name and password e Click Test to ensure that the connection is successful e Click OK to save the new EAServer profile Appeon Developer User Guide Page 129 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 6 Edit EAServer profile Server Name Port Number Login Name Password Note Input the real IP address in the Server Name field It cannot be 127 0 0 1 or localhost Step 8 If the Package EAServer Components option is selected in the previous step select which components to package and click Next The selected NVOs will be packaged as ComponentName jar and saved under the NVO server profile name package folder Figure 11 7 Select NVOs Appeon Application Package zani Please select EAServer components to package Welcome Select Package Type co Select Application Select Appeon Server Configure EAServer Profile Select NVOs E Select AEM
102. ction Selected Profile Name Mode LO ee L Release codeexamples Release act Debug Js The following table gives a brief introduction of the columns Table 11 1 Application Package Wizard Column Description Selected Identical to the default application profile selected in the Appeon Developer Configuration window Profile Name Identical to the application profiles configured in the Appeon Developer Configuration window Mode Identical to the current mode the application profile is set to in the Appeon Developer Configuration window It is recommended that the packaged applications should be available in Release mode as this mode prevents most forms of reverse engineering and like application packaging it protects the author s intellectual property Step 6 Select the Appeon Server whose settings will be packaged and click Next The Appeon Server settings such as the server type and the Appeon Server version will be saved to the config xml file in the INI folder of the generated package If necessary modify this file using the config exe tool after the packaging is complete refer to Section 11 1 3 Modifying the deploy config file Appeon Developer User Guide Page 127 Packaging Applications Appeon for PowerBuilder 2013 All the configured Appeon Servers selected into the default deployment profile in the Appeon Developer Configuration window are listed as sh
103. de Page 101 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 3 Empty Temporary Internet Files folder when browser is closed internet Options General Security Privacy Content Connections Programs Advanced Settings C Do not search from the Address bar a Just display the results in the main window 4 Security F Allow active content from CDs to run on My Computer Allow active content to run in files on My Computer Allow software to run or install even if the signature is inv Check for publisher s certificate revocation Check For server certificate revocation Check For signatures on downloaded programs Do not save encrypted pages to disk sis Empty Temporary Internet Files Folder when browser is cle Enable Integrated Windows Authentication Enable memory protection to help mitigate online attacks Enable native XMLHTTP support bd 4 w p SS S Takes effect after you restart Internet Explorer Restore advanced settings Reset Internet Explorer settings Deletes all temporary files disables browser Reset add ons and resets all the changed settings You should only use this if your browser is in an unusable state 0K Cancel Apply Step 3 Click Apply in the Advanced tab and then OK in the Internet Options window to allow the settings to take effect Allowing the
104. de window X Application Undeployment Wizard 3 Specify Undeployment Mode You can undeploy an application deployed using a specific deployment profile by choosing Deployment Profile mode If you are unsure of the application name use Appeon Server mode to list all applications deployed to a specific Appeon Server Undeployment Mode Deployment Profile kant a a D Appeon Server a The following table shows when and how to use each mode Table 12 1 Undeployment modes When To Use It How To Use It Deployment If you clearly know which Select an application to be undeployed and Profile mode application you want to delete its associated deployment profile from which server For detailed instructions refer to Section 12 1 1 Undeploying with the Deployment Profile mode Appeon When you are uncertain of Specify an Appeon Server by selecting Server mode the name of the application an Appeon Server profile The selected you want to undeploy or an Appeon Server will refer to all the Web application profile does not exist or mobile applications that are deployed for the application you want Then you can choose one Web or mobile to undeploy but you clearly application for undeployment know the Appeon Server hosting the Web or mobile application intended for undeployment For detailed instructions refer to Section 12 1 2 Undeploying with the Appeon Server mode
105. e Figure 12 10 Undeployment settings X Application Undeployment Wizard Ready to Undeploy Application Click Undeploy to begin undeploying the application If you want to review or change any settings click Back Current Settings Undeployment Mode tAppeon Server Appeon Server A amp ppeon Server Local Appeon Server Appl amp ication pet_world Appeon Servers and Web Servers Appeon Server Local Anpeon Server Jij The undeployment process begins as shown in the following figure Appeon Developer User Guide Page 176 Undeploying Appeon Applications Appeon for PowerBuilder 2013 Figure 12 11 Appeon Application Undeployment Application Undeployment Wizard e Undeployment Status Information Undeployment Status Time Run Information D 16 58 26 Undeploying application from Appeon Server D 16 58 26 Connecting to ppeon Server localhost E3 16 58 26 Deleting application files from Appeon Server 16 58 26 Deleted application files from Appeon Server suce G 16 58 26 Connecting to Web server Local Web Server 16 58 26 Deleting application files from Web server D 16 58 26 Deleted application files from Web server success 100 Step 6 Click Finish to close the dialog box as shown in the above figure Appeon Developer User Guide Page 177 Developing with Code Insight Appeon for PowerBuilder 2013 13 Developing with Code Insight Code
106. e DLLOCX log file in the generated package Appeon Developer User Guide Page 196 Extended Toolkit Appeon for PowerBuilder 2013 Figure 17 9 Installation complete Finished DLL OCX File Installation Wizard Setup has finished installing DLL OCX package on your computer Click Finish to exit V Let wizard restart the system now Recommended Restart the system to ensure that the DLL OCX files will work correctly Select whether to let wizard restart the system now or restart the system later by yourself 17 1 2 2 Uninstalling DLL OCX files Step 1 On a client machine run the Setup exe file in the generated package The DLL OCX File Installation Wizard starts as shown in the following figure Click Next to proceed Appeon Developer User Guide Page 197 Extended Toolkit Appeon for PowerBuilder 2013 Figure 17 10 DLL OCX File Installation Wizard This wizard will help you setup DLL OCX files for distribution Click Next to proceed Cancel Step 2 Select Uninstall and click Next to proceed If you select to reinstall the files you will run through the same process as a new installation as described in Section 17 1 2 1 Installing DLL OCX files Figure 17 11 Reinstall or uninstall Maintenance Mode Please select one of the following options Uninstall Step 3 Click Yes to confirm the uninstall Appeon Developer User Guide Page 198 Extended Toolkit Appe
107. e server Add Remove Deploy Image Files If your application uses image files select the folder where those image files are stored and Appeon will deploy the files to the Web or to the Mobile C Users Public Documents 4ppeon Developer201 3 appeondemo salesapplicatior Browse _ Include Subfolders Deploy External Files If your application uses external non system files such as DLL OCX TXT etc select the files and Appeon will deploy them to the server Cancel Deploy INI Files If a PowerBuilder application uses an initialization INI file which contains user preferences specify the INI file in this tab so that Appeon can deploy the file for the application Click Add to add the INI file s into the Deploy INI Files list box How INI files are supported in Appeon During deployment the specified INI file s are converted to XML file s and deployed to Appeon Server The XML file s act as mock INI file s When a Client runs the deployed application for the first time a copy of the XML file is created in Appeon Server and keeps the Client s profile information For a Client to use the correct profile information in its subsequent visits to the application the Client browser must be cookie enabled Otherwise each time the Client visits the application a new copy of the XML file is created in Appeon Server and the new copy only contains the information of the original INI file You can d
108. e applications There are three ways to launch the Appeon Workspace Emulator l Launch Appeon Workspace Emulator from the Appeon Developer Run button If the application is deployed to the Mobile then when you click Run in the Run Application window Appeon Workspace Emulator will be launched and the application will be automatically run in Appeon Workspace Emulator For details please refer to Section 8 2 2 1 Launching applications from the Run button 2 Launch Appeon Workspace Emulator from the Appeon Developer Appeon Workspace Emulator button HB On the click of the Appeon Workspace Emulator icon on the Appeon Developer Toolbar you directly open the Appeon Workspace Emulator as shown in the following figure Appeon Workspace Emulator for iPad You will need to add the application in Appeon Workspace first before you can run it 3 Launch Appeon Workspace Emulator from Windows Start gt All Programs gt Appeon for PowerBuilder 2013 gt Appeon Developer gt Appeon Workspace Emulator Appeon Developer User Guide Page 119 Launching Appeon Workspace Emulator Appeon for PowerBuilder 2013 Figure 9 1 Appeon Workspace Emulator Appeon Workspace Emulator Appeon Workspace to Easy Fast Cross OS Mobilize your enterprise apps at your fingertips LEARN MORE gt gt Add App Tap here to add a new app After you have launched the Appeon Workspace Emulator you can select a device that
109. e associates specified Web Server s and Appeon Server s as a group used for Web or mobile deployment You may create several deployment profiles e g local deployment test deployment production deployment and so on and set the most commonly used profile as the default profile A deployment profile is based on server profiles Before configuring the deployment profiles make sure you have set up one server profile for each of the Appeon Servers and Web Servers to be used for the Web or mobile conversion You can add as many deployment profiles as you need but there can be only one default deployment profile Appeon Developer User Guide Page 53 Configuring Appeon Developer Appeon for PowerBuilder 2013 4 2 4 1 Deployment Profiles tab page On the Deployment Profile tab you can edit add or delete deployment profiles and specify a default deployment profile Figure 4 36 Deployment Profile tab page 2E Appeon Developer Configuration Application Profiles DB Type Profiles Server Profiles Deployment Profiles Data Source Profiles Deployment Profiles Configure the deployment profiles for your applications 4 deployment profile is a collection of Appeon Servers and Web Servers that you will deploy Web or Mobile applications to Default Profile Name Deployment Type Number of Servers Edit aaa Local Deployment Add a cancel The following table describes the tasks you can perform on
110. e following user documents to assist you in understanding Appeon for PowerBuilder and its capabilities e Introduction to Appeon Guides you through all the documents included in Appeon for PowerBuilder e New Features Guide Introduces new features and changes in Appeon for PowerBuilder e Appeon Mobile Tutorials Gives instructions on deploying running and debugging Appeon applications distributing native mobile apps and configuring Appeon server clusters e Appeon Installation Guide Provides instructions on how to install Appeon for PowerBuilder successfully e Development Guidelines for Appeon Mobile Introduces general guidelines on developing apps with Appeon Mobile e Migration Guidelines for Appeon Web A process oriented guide that illustrates the complete diagram of the Appeon Web migration procedure and various topics related to steps in the procedure and includes a tutorial that walks the user through the entire process of deploying a small PowerBuilder application to the Web e Features Help for Appeon Provides a detailed list of supported PowerBuilder features which can be converted to the Web Mobile with Appeon as well as which features are unsupported e Appeon Developer User Guide Appeon Developer User Guide Page 2 About This Book Appeon for PowerBuilder 2013 Provides instructions on how to use the Appeon Developer toolbar in Appeon for PowerBuilder e Workarounds amp API Guide Provides re
111. e it effective make sure you have 1 Configured the PBT file of the current application as the default PBT file in the Code Insight Configuration window Appeon Developer User Guide Page 181 Developing with Code Insight Appeon for PowerBuilder 2013 Status Detailed Steps 2 Opened an object of the current application in a painter not in the Source editor by double clicking it in the Workspace or selecting Edit from the popup menu After taking the above steps Code Insight becomes effective g Code Insight is enabled and effective You can develop an application with the assistance of Code Insight 13 2 Coding with Code Insight When Code Insight is enabled and effective for an application you can start editing the objects of the application using Code Insight For example take the following steps to add a new control and use Code Insight to edit it Step 1 Add a button to the current object in the painter Step 2 Save the object by clicking the Save button on the PowerBar Note Saving the object enables Code Insight to generate the supported and unsupported feature list for the new content Code Insight cannot detect the new content unless the object is saved Step 3 Double click the button to open the Script view and pause for a few seconds after typing an identifier followed by a dot for example pause after This If there is more than one property variable method or statement
112. e relevant database driver for converting PowerBuilder SQL statements To modify a database type profile take the following steps Step 1 Click the Configure button on the Appeon Developer toolbar and select the DB Type Profiles tab on the Application Developer Configuration page as shown in the following figure The Database Type column lists all the database types that are supported by Appeon and the Configured column indicates whether a database type profile has been configured Figure 4 28 DB Type Profiles 2 Appeon Developer Configuration Ea Application Profiles DB Type Profiles Server Profiles Deployment Profiles Data Source Profiles Database Type Configuration The Database Type profile tells Appeon for PowerBuilder which database type is used to convert PowerBuilder SOL statements Configure the profiles below then associate profiles with individual application in the Application Profiles DB Settings tab Supported Database Types Configured Sybase ASE 12 15 Sybase ASA 8 9 10 11 12 Yes Sybase IQ No E Oracle 109 119 No Oracle 9i No Oracle 8i No a MSSQLServer 2000 2005 2008 No IBM DB2 UDB 8 x 9 5 No IBM Informix 9 10 No X Step 2 Select a database type profile for example Sybase ASE 12 x 15 x and click the Configure button to configure the database type profile as shown in the following figure Appeon Developer User Guide Page 42 Configu
113. e same as those in the Configure tool therefore only basic descriptions will be provided in this section For detailed descriptions refer to Section 4 2 Using Configure Tool Click the Config Wizard button on the Appeon Developer toolbar to launch the Appeon Developer Configuration Wizard Carefully read the notes and requirements on the Welcome page of the Appeon Developer Configuration wizard Click Next to proceed Appeon Developer User Guide Page 9 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 1 Welcome page Welcome E Configure basic settings E Select PBL files E Configure deployment settings E Select DB types E Declare transaction object s E Select image files E Select INI files E Deploy External Files E Summary Appeon Developer Configuration Wizard Welcome to the Appeon Developer Configuration Wizard The Appeon Developer Configuration Wizard will quide you through all the steps required for deploying an application to the Web or to the Mobile Please verify the following before configuration 1 The database in use by the application is running and connected successfully 2 The application has been compiled with the Full Build command in a supported PowerBuilder version 3 The application runs normally in PowerBuilder 4 All PBLs have been optimized in PowerBuilder using the Optimize command 5 Application Server is started 4 1
114. eak on changes popup menu item expressions in a unique way Although the views of Appeon Debugger and PowerBuilder Debugger look similar they cannot be used together For example the breakpoints set in Appeon Debugger cannot be recognized by PowerBuilder Debugger and vice versa 7 4 Setting breakpoints 7 4 1 Code lines that can be set as breakpoints Pay attention to the following do s and don ts before setting breakpoints Appeon Developer User Guide Page 92 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 1 Do set breakpoints to the code lines supported by Appeon 2 Do set simple breakpoints to script don t set special breakpoints such as breakpoints triggered when a statement has been executed a specified number of times an occasional breakpoint when a specified expression is true a conditional breakpoint or when the value of a variable changes 3 To set a SQL statement that spans multiple lines as a breakpoint do set the breakpoint at the first line don t set breakpoints at the other lines If you try to set a breakpoint at the other lines the breakpoint will be set to the line that follows the SQL statement 4 To set a PowerScript non SQL statement which spans multiple lines with continuation characters amp as a breakpoint do set the breakpoint at the last line of the statement and if it is set at the other lines the breakpoint icon is still added to the last line Note
115. eate the Appeon Server profile and Web server profile refer to Section 4 2 3 Managing server profiles Appeon Developer User Guide Page 147 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 28 Specify server settings Server Settings Please select the Appeon Server and the Appeon Servers Selected Profile Name Server Type 192 0 1 56 Web Servers Selected Profile Name Iv 192 0 1 56_EAServer Step 6 Select whether to undeploy EAServer components Figure 11 29 Undeploy EAServer components r 4 Appeon Application Undeployment marane EAServer Settings Please select whether to undeploy E Please select whether to undeploy EAServer components To undeploy components please specify the EAServer configuration settings Note if the EAServer Components option is not selected the step for selecting NYO components will be skipped Profile Name Server Name Port Number Login Appeon Developer User Guide Page 148 Packaging Applications Appeon for PowerBuilder 2013 Select the EAServer Components option and then create connection profiles for EAServers where you want to undeploy the components Follow instructions below to create EAServer profiles e Click Add to open the EAServer Connection dialog box e Input the connection parameters profile name host name or IP address port number user name and password e Cli
116. eckbox checked if you want Appeon to automatically update the PBLs every time you deploy an application This ensures that any newly added PBLs will be deployed and yet avoid missing PBLs after deployment 4 1 3 Configuring deployment settings The deployment settings associate the Appeon Server s and Web server s as a group used for the application deployment Figure 4 4 Select the Appeon Server and Web server Appeon Developer Configuration Wizard Please select the Appeon Server s and Web server s Welcome that your application will be deployed to Configure basic settings Deployment Profile Name Local Deployment z Select PBL files Appeon Servers Configure deployment settings Selected Name Edit E Select DB types v Local Appeon Server ane E Declare transaction object s Delete Web Servers E Select image files s Selected Name Edit E Select INI files v Local Web Server D E Deploy External Files Delete E Summary Step 1 Select an existing deployment profile To create or modify a deployment profile you must use the Configure tool For detailed instructions refer to Section 4 2 4 2 Deployment profile settings Step 2 Select the check boxes to include the Appeon Server s and the Web server s in the deployment profile All the Appeon Server profiles and Web server profiles you have created are listed More than one Appeon Server and one Web s
117. ected for this application deployment If the data source does not exist you can create it by following instructions in Section 4 2 5 Managing data source profiles After you create a data source you can select the Selected column to associate the data source with the transaction object Note The data source tool will be available if Appeon Server is installed to Microsoft NET Framework lIS and will not be available if Appeon Server is installed to EAServer 6 x WebLogic WebSphere JBoss NetWeaver Application Server or JEUS You should go to the corresponding application server administration console to configure the data source for EAServer 6 x WebLogic WebSphere JBoss NetWeaver Application Server or JEUS For detailed instructions refer to Database Connection Setup in the Appeon Server Configuration Guide Appeon Developer User Guide Page 16 Configuring Appeon Developer Appeon for PowerBuilder 2013 4 1 6 Selecting image files Click Browse to specify which folder contains the image files that will be used in the Web or mobile application Select Include Subfolders to deploy the sub folders under the specified directory For detailed information about the image files refer to Deploy Images Figure 4 8 Select image files Appeon Developer Configuration Wizard If your application uses image files select the folder Welcome where those image files are stored and Appeon will deploy the files to the Web or to
118. eding to specify them When you run the config exe file in the generated package an XML File Configuration dialog is displayed and loads the Application URL setting Appeon Server settings and Web server settings from the config xml file You can modify these settings on the corresponding tab pages and then click OK to save them to the config xml file The instructions to modify these settings are the same as to modify in the Appeon Developer Configuration window see Section 4 2 Using Configure Tool for detailed instructions Important Note If using JEUS as the target Web server be sure to use the default Application Profile Name and Application URL Changing the default Application Profile Name and Application URL will cause the application files unaccessible Appeon Developer User Guide Page 134 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 12 Configuring the XML file ig XML File Configuration x App URL Appeon Server Web Server App URL Setting http web server port Cancel 11 1 4 Installing and uninstalling an Appeon application 11 1 4 1 Points to note before installation Be aware of the following points before you run the deployment project to install an Appeon application e The Setup program of the generated deployment project runs on the Windows platform only To install applications to servers running on Unix Linux you must run the Setup program on the Windows
119. eed to analyze the application PBLs for unsupported PowerBuilder objects and features using the PowerBuilder IDE extended with Appeon Developer General rules of thumb regarding how the application should be structured are outlined in Basic and Architectural Requirements in Appeon Features Help The application must meet these requirements before the analysis can begin The first step results in an analysis report highlighting unsupported PowerBuilder objects and code within the application e Task 2 Modify Next work around or remove the unsupported PowerBuilder objects and code that prevent the Web or mobile application from running using standard PowerBuilder programming Appeon Features Help and Appeon Code Examples an Appeon demo PowerBuilder application will guide you through this process by providing information regarding supported PowerBuilder features as well as example code for implementing these features Then perform a full build of the application in PowerBuilder ensure that there are no bugs in the PowerBuilder code and that the application functions correctly The second task results in a PowerBuilder application that is ready for automatic conversion to the Web or to the Mobile e Task 3 Deploy automatically At the push of a button you can now automatically generate a precise replica of the PowerBuilder application that deploys to the n Tier architecture and can be accessed by standard Internet Explorer Web browsers
120. eeeeeeeeeeeeeeeeeeeeeeeeennneeeeees 92 7 4 Setting breakpoints eee eeeeeeeeeeeeeeeeeeeeeeeeeeeeeaeaeeeeeseseeeaaaaeeeeeeeeeeaees 92 7 4 1 Code lines that can be set as breakpoints cceceeeeeeeeeeeeeteeeees 92 7 4 2 Methods for setting breakpoints cccceeeeeeeeeeeeeeeeteeeeeeeeteeeenaees 93 7 5 Running the application in debug MOE ceeeeeeeeeeeeeeeeeteeeeeeeteeeeeteeeees 94 7 6 Examining an application at a breakpoint cccceeeeeeeeeeeeeeeeeeteeeeeeeeeees 95 7 6 1 Special variable and expression handlings cceeeeeeeeeeeeeeeees 95 7 6 2 Adding variables or expressions to Watch VieW c cceeeeeeees 96 7 6 3 Changing the value of a variable or expression cccceeeeeeeeeees 97 7 6 4 Evaluating an expression ccceeeeeeeeeeeeeeeeeeeeeeeeeeeaeeeeeeeeeeeeeteeeees 98 7 6 5 Examining context in Call Stack view ccceeceeseceeeeeeeeeeseeeteeeees 98 7 6 6 Stepping through the application cceeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 98 7 7 Fixing the code stopping the debug procedure cccceeeeeeseeeeeeeeeeeees 98 8 Running Appeon Applications cccccceeeeeeeeeeeeeeeeeeeeeeeeaaeeeeeeeeeeeeeneeeeeeeeeenaees 99 8 1 gtsie Olds 1aai sl a ommree nee er ae E tere en mere rt eer yearn err a r EAEE E ES EA ARREA 99 8 1 1 Windows account privileges eeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 99 8 1 2 Internet Explorer
121. eeeeeeeeeeeeeeeeeeeeeeeeneeeeeeeeeeenneeeeeeeeeee 121 10 1 Viewing the reports and lOQS ceeeeeeecee eee eeeeeeeeeeeeeeeeneeaaeeeeeeeeeeeeaees 121 11 Packaging Applications sciiscis cts tenniueteceonetsecn ui ceadatien ll lade tiene ah waduedeadedeaieueaetie 124 11 1 Packaging a deployment project 0 cceceeeeeeeeeeeeeeeeeeeeeeeeeeneeeeeeeteeenees 124 11 1 1 What can be packaged 0 eeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeneeeeeeeeeeeeees 124 11 1 2 Packaging instructions citi shit cated toi i eee es ilu eee tia 125 11 1 3 Modifying the deploy config file eeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 134 11 1 4 Installing and uninstalling an Appeon application 00c 135 11 1 4 1 Points to note before installation eceeeeeeeeeeeeeeeeees 135 11 1 4 2 Installing an application wcciitev ewe ele ine ads 135 11 1 4 3 Uninstalling an application 0 0 0 cceeeeeeeeeeeeeeteeeeeeeeeeees 145 11 2 Packaging a native mobile project cceeeeeeeeeeeeeeeeteeeeeeeeeeeeeeeeees 151 11 2 1 Points to check before packaging ccceeeeeeeeeeeeeeeeeeeeneeees 151 11 2 2 Packaging instructions s sicti tet Ge i i i oe ht 151 11 3 Customizing and packaging Appeon Workspace eeeeeeeeeeeeeeees 159 12 Undeploying Appeon Applications cccccceseeeeeeeeeeeeeeeeeeeeeeeeseeeeeeeeeeeeeaaees 170 12 1 Undeploying instructions 5 c2 shail catacerpered deca dedsenpes ve ctenoededua
122. een detected In this case it is strongly recommended that you carefully read the undetected features listed below and examine your application to determine if it contains any of these features Table 5 5 Undetected features Naming conventions e Duplicate object names No two objects should have the same name in an application whether they are of the same type or not The Unsupported Features Analysis cannot detect whether object names are duplicated in an application Appeon Developer User Guide Page 65 Using UFA Tool Appeon for PowerBuilder 2013 e More than one application object Having more than one application object in an application is unsupported The Unsupported Features Analysis cannot detect whether more than one application object is present e Applications named as objects or controls Application names that have the same name as PowerBuilder control object types are not supported The Unsupported Features Analysis cannot detect whether this unsupported issue is present in an application Null values e Unsupported operation e Expressions with Null values ASCII characters Unsupported special ASCII characters e Vertical tab v Non visual UserObject A NonVisualObject object assigned to an autoinstantiated NVO or an autoinstantiated NVO assigned to a NonVisualObject object Variables and constants e Instance variables have identical names as global variables e longlong variable
123. elect the performance features based on your needs The following table describes how to use the performance features Table 4 6 Performance features Setting Description When To Use 10X Web File Compresses files when they are transferred over the Always Compression network Merge files Merges the small files during the application deployment In the The small files will be downloaded to the client in one file production package at one call instead of being downloaded one by stage one at separate calls Performance Enables the application to be deployed in a method In the Analyzer compliant with the Performance Analyzer tool development cOMpHAnee The application deployed with this option can run with ser for Web licati the Performance Analyzer tool at runtime to diagnose ap ADOOS Tiie performance issues For more about the Performance only Analyzer tool see Appeon Performance Analyzer in Appeon Performance Tuning Guide Note as the data is not encrypted during transmission at runtime therefore this option is recommended to use only at the test or development stage Download Downloads the two ActiveX files in the same thread at Always ActiveX runtime Appeon Developer User Guide Page 34 Configuring Appeon Developer Appeon for PowerBuilder 2013 Setting Description When To Use files ina Using the same thread to download the two ActiveX single thread files can speed up the download under
124. elete the XML files that are unused for a period using Appeon Enterprise Manager AEM For more information on how to maintain XML files in Appeon Server refer to Auto Cleanup in the Appeon Server Configuration Guide Appeon Developer User Guide Page 28 Configuring Appeon Developer Appeon for PowerBuilder 2013 Deploy NET COM components If a PowerBuilder application uses NET COM components which contains executable files exe and COM COM components specify the NET COM components file in this tab so that Appeon can deploy the file for the application Click Add to add the NET COM components file s into the Deploy NET COM components list box Deploy Images Click Browse to specify which folder contains the image files that will be used in the Web or mobile application If you do not specify the path of the image files the path to the application PBL files will be displayed as the default path of the image files The image files can be in any format supported by PowerBuilder apart from e unsupported run length encoded RLE and e unsupported Windows metafile WMF All the image files in the specified folder will be deployed to the Deployment Path images folder in the Web Server Deployment Path stands for the folder storing the Web application files or the mobile application files The image files may fail to be displayed on the Web or in Appeon Workspace or on mobile devices if the file names are stored in the data
125. emp 1 unsupported features Pipeline El te atraybounds 2 unsupported features Unsupported embedded SAL 0 unsupported fat System object or control pipeline of type pipeline is unsupported Other 0 unsupported features Priority Have to modify E Unsupported powerscript 0 unsupported features Reason Appeon Developer User Guide Page 68 Using UFA Tool Appeon for PowerBuilder 2013 The right text box shows a detailed code diagnosis on the unsupported code in seven aspects the Unsupported Code Line Number Location Unsupported Item Type Reason and Priority Step 2 View the workaround for the unsupported item by right clicking the unsupported item in the unsupported feature list treeview and selecting Workarounds solutions e Go To Workarounds Online Opens the online Workarounds amp API Guide at URL http Www appeon com support documents workarounds 2013 e Go To Local Workarounds Opens the local Workarounds amp API Guide installed with Appeon Help as shown in the following figure Figure 5 6 Local Workarounds Guide Workarounds amp API Guide Fo S ees a tf amp P Hide Previous Next Back Print Options Contents Index Search PipeLine object Dy Workarounds amp API Guide Prev System Objects Next T Appeon Workarounds PBL Refer 5 Q Workarounds for Unsupported Fe QJ Objects amp Controls 2 Extemal user object I BD UserOb
126. ent disk space on the Client to enable the Web files to be cached To set the cache options Step 1 Open Internet Explorer and select Tools gt Internet Options as shown in the following figure Appeon Developer User Guide Page 99 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 1 Internet Options in Internet Explorer General Security Privacy Content Connections Programs Advanced Home page AA To create home page tabs type each address on its own line a Bina about blank Use current Use default Use blank Browsing history T Delete temporary files history cookies saved passwords and web form information Delete Settings Search a Change search defaults Tabs Change how webpages are displayed in tabs Appearance Colors Languages Fonts Accessibility Step 2 Click the Settings button in the Temporary Internet Files group box Step 3 Select the Automatically radio button to check for newer versions of stored pages as shown in the figure below Appeon Developer User Guide Page 100 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 2 Temporary Internet File Settings Temporary Internet Files and History Settings Temporary Internet Files Internet Explorer stores copies of webpages images and media for faster viewing later Check for newer versions of stored pages D Every time
127. enu 111 Appeon Developer toolbar in PowerBuilder 4 Appeon Developer toolbar register tool 211 Appeon for PowerBuilder help 188 Appeon Server port username and password 204 Appeon Server profile settings 45 Appeon Silent Installer 199 application profile settings 22 Additional Files 27 basic settings 23 DB settings 25 Misc Settings 31 runtime settings 39 summary 40 Web service profiles 38 application profile tab 21 delete an application profile 22 export or import an application profile 22 select an application file generation mode 21 specify default application profile 21 B basic settings 23 burn installation CD 209 C change value of a variable or expression 97 code lines that can set breakpoints 92 code with Code Insight 182 configure Appeon Developer 9 configure application database connectivity 7 configure basic settings 10 configure Code Insight 179 configure deployment settings 13 Appeon Developer User Guide convert screen size between dots and PBUs 186 copy installation programs 201 create folder structure of Silent Installer 199 customize and package Appeon Workspace 159 customize configuration file 201 customize general settings of UFA report 76 D DataWindow printing 115 DB settings 25 debug Appeon Web applications 89 declare transaction objects 14 define priority settings of unsupported features 75 delete an application profile 22 deploy PowerBuilder appli
128. eon application WebApp folder Each CD must contain the following four files right under the Setup folder that is place the following files in the same directory level of the AS EAServer and WebApp folders e Setup exe Appeon Developer User Guide Page 209 Extended Toolkit Appeon for PowerBuilder 2013 e SilentInstall txt e Uninstall exe e msvcp60 dll 17 2 5 Running Appeon Silent Installer for End Users This section provides some additional instructions for end users on using the Appeon Silent Installer to install uninstall EAServer Appeon Server Appeon Server EBF and or Appeon applications 17 2 5 1 Installing Appeon Server EAServer and or Appeon applications Before running the Appeon Silent Installer be aware that 1 The Setup exe program can only be run on the Windows platform 2 The Appeon Server and the Web server must reside on the same machine Start the silent installation by running the Setup exe file on the installation CD By default the configuration file in the same location of the Setup exe file will be used during the installation process To use a configuration file residing in a different location run the Setup exe file from the command line and append the configuration file location for example Setup exe d setuptmp SilentInstall txt 17 2 5 2 Uninstalling Appeon Server EAServer and or Appeon applications To silently uninstall EAServer Appeon Server Appeon Server EBF and or Appe
129. ep 1 Change the variable or expression in the Expression box Step 2 Click Reevaluate to display the new value in the tree view Step 3 Optional Click Add Watch to add the expression to the Watch view 7 6 5 Examining context in Call Stack view You can examine the context of the application by clicking the code lines in the call stack To show a different context from the Call Stack view e Double click a line or right click a line and select Set Context Once a function is selected in the Call Stack view the Variable views the Source view and the Watch view will all be updated 7 6 6 Stepping through the application You can use the Step In Step Over Step Out Run To Cursor and Set Next Statement commands to step through an application Using these commands in Appeon Debugger is no different from using them in PowerBuilder Debugger 7 7 Fixing the code stopping the debug procedure Once you locate the cause of the erroneous execution results you can stop the debugging procedure return to the PowerBuilder application to fix the code and re deploy the application to verify that the error has been corrected To stop the debugging process close Internet Explorer where the application is running or select Stop on the toolbar The breakpoints you set to the application will be saved when Appeon Debugger is closed and will be available when Appeon Debugger is re opened When fixing the code you must return to the PowerBuilder
130. eployed application including the WSDL file service name and port to be used by the Web service After you specify the PBL files of the application in the Basic Settings tab the Web service proxy objects WSDL files service and port which are used in the application are automatically added to the Web Service Profiles tab as shown in the following figure A valid WSDL file must meet the following requirements e The WSDL file must be a wsdl or asmx file e The WSDL file must reside on the local computer Appeon cannot access the WSDL file in a remote machine e WSDL files used in the same application cannot have the same name even if they reside in different locations Figure 4 24 Web Server Profiles tab Application Profile Configuration x Basic Settings DB Settings Additional Files Misc Settings Web Service Profiles Runtime Settings Summary Web Service Configuration The Web service proxy object accesses the WSDL file for obtaining the service and port information of the Web service Please specify the correct WSDL file service and port for each Web service proxy object Used Proxy Object WSDL File Service Port Select All Deselect All Invert Selection Configure Appeon Developer User Guide Page 38 Configuring Appeon Developer Appeon for PowerBuilder 2013 Choose which proxy object s will be invoked in the deployed application by selecting the Used column of the objec
131. eport 70 method for setting breakpoint 93 Misc Settings 31 modify deploy config file 134 modify unsupported features 68 O open or save UFA report 70 P package a deployment project 124 package and install Appeon applications 124 package DLL OCX files 190 package native mobile projects 151 perform feature analysis 63 prepare PowerBuilder application 79 R Related documents 2 resource language 207 run Appeon application 99 108 run Appeon silent installer 210 run application in debug mode 94 runtime settings 39 SaveAs 116 Appeon Developer User Guide search for UFA report items 71 select a run mode 110 select an application file generation mode 21 select DB types 14 select External files 18 select image files 17 select INI files 17 select PBL files 12 select report view mode 71 server profile tab 44 set breakpoint 92 setup log path 205 sort and filter 112 special variable and expression handlings 95 specify default application profile 21 specify deployment settings 79 speed of deployment process 77 start Appeon Debugger 90 start Appeon Server 7 step through application 98 summary 19 40 T technical support 213 U undeploy Appeon applications 170 undeploy instructions 170 undeploy with Appeon Server mode 174 undeploy with Deployment Profile mode 171 undetected unsupported features 65 uninstall an application 145 uninstall DLL OCX files 197 URL
132. er data source of the configured database type from the dropdown list It is not necessary to specify the actual databases that the application uses Click ODBC Administrator to configure an ODBC data source if it is not available User ID Type in a recognized set user name to login to the database If no user name has been set leave this field blank Password __ Type in the password used to log in to the database If no password has been set leave this field blank Native Interface Select this option if you use a native database interface Specify the server name IP User ID Password and the database name Appeon Developer User Guide Page 43 Configuring Appeon Developer Appeon for PowerBuilder 2013 Note Not all the listed database types are supported by Appeon for the native database interface If Sybase IQ Sybase ASA 7 8 9 10 11 12 or IBM DB2 is your database type the Native Interface option is disabled Table 4 9 Native database interface settings Setting Instructions Server Enter the machine name or IP address of the server where the target database resides User ID Type in a recognized set user name to login to the database If no user name has been set leave this field blank Password Type in the password used to login to the database If no password has been set leave this field blank Database Specify the name of the database that will be used by the application
133. er the Web root as the Appeon Developer User Guide Page 24 Configuring Appeon Developer Appeon for PowerBuilder 2013 application URL a large number of Web or mobile files belonging to the application will be deployed to that folder making it difficult to use the folder for its original purpose 2 If a Web or mobile application uses a folder that is reserved for the Web server or Appeon Server some important files belonging to the Web server or Appeon Server may be replaced or even removed when the application is undeployed The following are folder names reserved for the Web server or Appeon Server that should not be used as application URLs appeon classes docs images ir wst and WEB INF The application URL for an application profile can be changed and the Web or mobile files stored at the Web Server can have different versions for the Client to access but Appeon only remembers the application URL in the last deployment and performs the application packaging and application undeployment based on the Web or mobile files generated in the corresponding folder Application PBL files Select the PBL version and add application PBL files using any of the following methods e Click the browse button and choose to add an application Target file pbt By adding PBLs using an application Target all PBLs in the Target are automatically added to the application PBLs list This is the recommended way to add PBLs as it reduces
134. erform a full or Settings displayed on the Web application downloading incremental deployment on page and mobile application name icon the application and description displayed in the Appeon Workspace and the target mobile device the application apply for See Section 4 2 1 2 6 Runtime Settings Summary A summary view of the settings Perform a full deployment See the Section 4 2 1 2 7 Summary section for more details on the application 4 2 1 2 1 Basic Settings After you click Add or Edit on the Application Profiles tab the Application Profile Configuration window is displayed with the Basic Settings tab selected by default as shown in the following figure The Basic Settings tab allows you to modify the web folder project typ PBT application PBL version and PBL location Appeon Developer User Guide Page 23 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 13 Basic Settings Application Profile Configuration Ea Web Service Profiles Runtime Settings Summary Basic Settings DB Settings Additional Files Misc Settings Application Profile Name sales Web Folder sales Project Type Application PBLs PBT Keep PBT Updated PBL Version PowerBuilder 11 5 v Select the PBT or PBL files used in your application C Users Public Documents 4ppeon Developer201 S appeondemo salesapplicationdemo sales_ C Users Public D ocuments
135. erver can be selected If the required Appeon Server profiles or Web server profiles are not available click the Add button to create them Refer to Section 4 2 3 2 Appeon Server profile settings for detailed Appeon Developer User Guide Page 13 Configuring Appeon Developer Appeon for PowerBuilder 2013 instructions on creating an Appeon Server profile and refer to Section 4 2 3 3 Web Server profile settings for detailed instructions on creating a Web server profile Step 3 Click Next to proceed When the Next button is clicked the wizard will test the connection to the Appeon Server and the Web server If the connection is successful the deployment profile is saved with the associated Appeon Server s and Web server s 4 1 4 Selecting DB Type s The database type is required during the application deployment if the application connects to one or more databases Select the database type s used by the application by selecting the check boxes from the Used column of the database type Figure 4 5 Database types Appeon Developer Configuration Wizard Select the database type s used by your application Welcome Note You must specify the database type s that your application uses but it is not Configure basic settings necessary to specify the exact database s used in this particular application This setting enables Appeon Developer to apply
136. ettings from the computer goccsesccossosescesssoe HePiccsccsevcssseastek Click Finish to exit the wizard Baci Tanca 11 2 Packaging a native mobile project 11 2 1 Points to check before packaging Apple follows some guidelines to review the app before it approves and posts the app to the iOS App Store To get the app approved you may need to carefully read the App Store Review Guidelines and verify the app is in compliance with these guidelines The following lists the most common areas and reasons we have found so far that will cause the app to be rejected by Apple 1 Check that if your app includes UI controls for quitting the app For example a button labeling Quit Exit etc You d better remove any mechanism for quitting the app as this is not in compliance with the iOS Human Interface Guidelines as required by the App Store Review Guidelines 2 Check that if you app appears to be for demonstration or trial purposes only For example demo trial test or beta is displayed on the app UI app description or release notes You d better remove any these references and complete or fully configure any partially implemented features 11 2 2 Packaging instructions To package an Xcode project for native mobile apps to be distributed on iOS follow steps below Appeon Developer User Guide Page 151 Packaging Applications Appeon for PowerBuilder 2013 Step 1 Click the Package
137. ff the user name and password specified in the data source will be used to connect to the database Pooling Select whether to use the connection pool Refer to Setting up Appeon Server data sources in the Appeon Server Configuration Guide for how to specify the settings for different JDBC drivers and database types Appeon Developer User Guide Page 59 Using UFA Tool Appeon for PowerBuilder 2013 5 Using UFA Tool Unsupported Features Analysis UFA tool helps you analyze an application for unsupported features The following table gives brief descriptions of the unsupported features report Table 5 1 UFA Report UFA Report Purpose of the report What is reported Enables you to work around or remove unsupported features in order to make the PowerBuilder application suitable for Appeon Web or mobile migration Most of the unsupported PowerBuilder coding features including keyword event data type system function control itself and its property function event object itself and its property function event IMPORTANT There are still some unsupported features that cannot be reported These undetected features though only a small number may make up the largest proportion of your workload depending on how they are used so we strongly recommend you carefully check the list in Section 5 1 4 Undetected Unsupported Features How to generate the report Use the Unsupported Features A
138. fig to open the Code Insight Configuration window as shown in the following figure Figure 13 2 Code Insight Configuration window PBT Files tab fii Code Insight Configuration Ez PBT Files System Add the PBT files to the list PBT File Name PBT File Path C Program Files 4ppeon Developer6 2 apped sales_application_demo Add Delete Cancel Appeon Developer User Guide Page 179 Developing with Code Insight Appeon for PowerBuilder 2013 Figure 13 3 Code Insight Configuration window System tab Code Insight Configuration Ea PBT Files System Auto List v Functions Controls vV Properties v Events v Variables Feature Type Both Types Supported Unsupported Cane _ The Code Insight Configuration window contains two tab pages where you can manage the PBT files and specify what displays in the list Table 13 3 Code Insight Configuration window Select this To do this Detailed Steps tab PBT File Add the PBT files 1 Click Add tab page 2 Search and select the PBT file in the common dialog box 3 Click Open in the common dialog box 4 Click OK Delete the PBT files 1 Select the PBT file you want to delete 2 Click Delete to delete the selected PBT file 3 Click OK NOTE The default PBT file cannot be deleted Set the default PBT file 1 Select the check box in front of a PBT file 2 Click OK Appeon Developer Use
139. for Appeon Server password Parameter AppeonServerPass Word Description Specifies the password for deploying an application to Appeon Server Accepted Values A valid deployment password for the current user name Default Value None Example AppeonServerPassWord 17 2 3 5 Web Server Path Specify the Web root of the Web server Appeon Developer User Guide Page 204 Extended Toolkit Appeon for PowerBuilder 2013 Table 17 15 Parameter for Web server Web root Parameter WebServerRootPath Description Specifies the document root of the Web server If the WebApplication parameter is set to No this parameter will not take effect If the WebApplication parameter is set to Yes the specified document root will be validated Accepted Values A valid path Default Value None Example WebServerRootPath C Program Files Sybase EAServer htm1 17 2 3 6 Setup Log Path Specify the log file path Table 17 16 Parameter for log file path Parameter LogPath Description Specifies the path for the setup log file APBLog txt Accepted Values A valid path Default Value None Example LogPath c log 17 2 3 7 Web Applications Specify the number of Web applications application name data source transaction object and database type Table 17 17 Parameter for number of the Web applications Parameter WebApplications Description Specif
140. g figure Figure 4 33 FTP configuration vy Internet Information Services MS 6 0 Manager Colea Ta File Action View Window Help Elx e9 200E os b mls e4 Internet Information Service Description Identifier State IP address Pe a SA TESTO297VISTA local cc ENEY Es AE T RETE 4 ei FTP Sites E E Default FTP Site 4 m p 4 m p Step 2 Right click on Default FTP Site and select Properties in the popup menu The Default FTP Site Properties window is displayed Step 3 Go to the Home Directory tab and verify that e The Local Path is the full path to the Web Server document root If the Web Server is an Appeon Server Web Server running on Windows the local path is the full path to EAServer document root JAGUAR html As shown in the following figure if the Web Server is an IIS server the local path is C Inetpub wwwroot JAGUAR is the EAServer installation directory for example C Program Files Sybase EAServer e The Write property of the FTP Site Directory is enabled Appeon Developer User Guide Page 51 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 34 FTP site properties FTP Site Security Accounts Messages Home Directory Directory Security The content for this resource should come from A directory located on this computer A directory located on another computer FTP site directory Local path igram Files Sybase EAServer html Read write Log v
141. ge Type Package a Deployment Project E Select Application E Configure App Settings Customize and Package Appeon Workspace E Specify Destination Folder E Packaging Process E Finish fi Step 4 Select the profile of the application that you want to package and click Next Only applications that have been deployed will be listed here for selection If the application you intend to package is not listed here you would need to deploy the target application using the Appeon Deployment Wizard first See Chapter 6 Deploying PowerBuilder Applications Appeon Developer User Guide Page 153 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 35 Select app to be packaged Appeon Application Package Wizard xa Welcome Select Package Type Selected App Name Mode Device Type L O a ee act Debug Js Both Select Application E Configure App Settings E Specify Destination Folder E Packaging Process E Finish Please select an application to package Only application that have been deployed will be listed below for selection The following table gives a brief introduction of the columns Table 11 2 Application Package Wizard Column Description Selected Identical to the default application profile selected in the Appeon Developer Configuration window Profile Name Identical to the application profiles configured in the Appeon Developer Configuration windo
142. hapter 8 Running Appeon Applications Instructions for running Appeon applications after deployment Chapter 9 Launching Appeon Workspace Emulator Instructions for launching Appeon Workspace Chapter 10 Using Information Manager Instructions for viewing reports and log files generated in the Appeon migration process Chapter 11 Packaging Applications Instructions for using Appeon application package tool to generate a deployment package a native mobile project or customization and package for Appeon Workspace Chapter 12 Undeploying Appeon Applications Instructions on how to undeploy Appeon applications Chapter 13 Developing with Code Insight Instructions on how to use the Appeon Code Insight feature Chapter 14 Launching Appeon Enterprise Manager Appeon Developer User Guide Page 1 About This Book Appeon for PowerBuilder 2013 Instructions for launching Appeon Enterprise Manager from Appeon Developer Chapter 15 Converting screen size between pixels and PBUs Instructions for using Appeon Size Calculator Chapter 16 Appeon for PowerBuilder Help Instructions for launching the Appeon HTML help file Chapter 17 Extended Toolkit Instructions for using the extended tools provided by Appeon the DLL OCX Files Package tool the Appeon Silent Installer and the Appeon Developer Toolbar Register tool Chapter 18 Technical Support Important information for technical support 1 3 Related documents Appeon provides th
143. he target PowerBuilder application on the same Developer machine where you will use the packaging wizard to pack this application later this will generate a complete set of files on the local Developer machine where the package wizard will be able to obtain and pack files 2 The deployed application can run correctly 11 1 Packaging a deployment project 11 1 1 What can be packaged The package wizard allows you to pack the following files and settings into an executable deployment project e Mandatory Web or mobile application files Include all application files DataWindow syntax INI files image files DLL OCX files etc e Mandatory application profile Appeon Server profile and Web server profile settings Include the profile name Application URL PowerBuilder version file encryption performance settings server type Appeon Server version Appeon Server and Web server connection settings AEM data sources etc All these settings will be saved to the configuration files in the INI folder of the generated package Of these configuration files you can modify the config xml file using the config exe tool For detailed information refer to Section 11 1 3 Modifying the deploy config file e Optional EAServer components When the Appeon Server is of type EAServer you can package the local or remote EAServer components used by the application Note that EAServer components work with EAServer application server only
144. her of the following ways e Close the Information Manager and open it again or Appeon Developer User Guide Page 122 Using Information Manager Appeon for PowerBuilder 2013 e Select a different application and then select the original application again in the Information Manager Appeon Developer User Guide Page 123 Packaging Applications Appeon for PowerBuilder 2013 11 Packaging Applications The Appeon Application Package Wizard helps PowerBuilder developers to e Generate portable deployment packages for Web and or mobile applications so the user can directly deploy the Web and or mobile application to servers without installing Appeon Developer and using it to do Web or mobile deployments The PowerBuilder developers do not need to provide the source PowerBuilder application to the user this protects the author s intellectual property rights Refer to Packaging a deployment project e Generate Xcode projects for native mobile applications so the user can compile the Xcode project to an IPA file and distribute it to iOS App Store or for Ad Hoc deployment Refer to Packaging a native mobile project e Customize Appeon Workspace and generate the Xcode project for Appeon Workspace Refer to Customizing and packaging Appeon Workspace Before using the Appeon Application Package Wizard verify that 1 The target PowerBuilder application has been deployed as required You must have performed a full deployment on t
145. ials to compile them into an IPA file Appeon Developer User Guide Page 169 Undeploying Appeon Applications Appeon for PowerBuilder 2013 12 Undeploying Appeon Applications The Application Undeployment Wizard removes a deployed application from the associated Appeon Server s and Web Server s including all DataWindows from the Appeon Server s all the Web or mobile application files from the Web Server s and all the Transaction Object mappings from AEM This is the only way that an Appeon deployed application should be removed Any other method may not fully remove the application and may cause errors 12 1 Undeploying instructions Step 1 Verify that the Appeon Server and the Web Server s hosting the Appeon application to be undeployed are running before you proceed with undeployment Step 2 Click the Undeploy button in the Appeon Developer toolbar The Application Undeployment Wizard is displayed as shown in the following figure Figure 12 1 Application Undeployment Wizard X Application Undeployment Wizard Ex This wizard helps you undeploy an application from an Appeon Server Click Next to proceed Step 3 Click Next to continue The Specify Undeployment Mode window is displayed as shown in the following figure prompting you to select an undeployment mode Appeon Developer User Guide Page 170 Undeploying Appeon Applications Appeon for PowerBuilder 2013 Figure 12 2 Specify Undeployment Mo
146. ication Step 3 Click Appeon Debugger on the Appeon Developer toolbar Appeon Developer User Guide Page 90 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 The Select a target window is displayed Figure 7 1 Select an application ect a targ Select the target to debug locally sales_application_demo E appeon_code_examples E appeon_acf_demo pet_world Po appeontest Step 4 Select an application from the list and click OK Appeon Debugger starts and the selected application is loaded in the Appeon Debugger The menu bar of the debugger provides three simple menus File View and Help The toolbar is almost the same as that in PowerBuilder Debugger except that the Start Remote button is currently unavailable Figure 7 2 Appeon Debugger EATE coo File View KLL RT EO a amp AIX E open string commandline return long for sales_application_demo of sales_application_demgq Application H Windows EJ Menus a User Objects E Functions EE Arguments ff string commandline Returns none f f Author laihaichun Date 2663 12 36 Modify History z 4i m r lt gt Source Browser Source History A lt gt h Local A Global Instance LA gt fh Call Stack Breakpoints_ Watch Appeon Developer User Guide Page 91 Debugging Appeon Web Applications Appeon for
147. ication Deployment Available Reports Unsupported Feature Analysis report available Analysis Report Time Run Information z 13 36 41 Generating Appeon application files for Menu m_report_ordertype 13 36 41 Generating Appeon application files for Structure str_general 13 36 41 Generating Appeon application files for Structure str_rpt_options 13 36 41 Generating Appeon application files for Structure str_rptparm 13 36 42 Generating other files ms dts te ms a m Cancel After Task 2 is completed Task 3 Web or Mobile Deployment will automatically start as shown in the following figure or click Next at the bottom of the Appeon Deployment Wizard to begin Task 3 if the Unattended Deployment option is not selected Confirm that the Web Server and Appeon Server have been started and correctly configured in Appeon Developer Configuration otherwise deployment will fail If deployment fails a Retry button appears so you can retry Task 3 without running through a full deployment again Appeon Developer User Guide Page 85 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Figure 6 5 Task 3 Web or Mobile Deployment a Appeon Deployment Wizard sales Lo 2 ea Deployment Task Status Deployment Task Status Time Task 1 Application Source Code Export Completed lt 1 Minutes Task 2 Appeon Application File Generation Completed lt 1 Minutes Task 3 Appeon Application Deployment In
148. ication to run Appeon Developer User Guide Page 108 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 8 Run Application window 3s Run Application exa All applications deployed to the default Appeon Server and default Web Server are listed below Select an application to run pet_world obtutor sales_application_demo Project Loader Appeon Simulator iPad v Orientation Landscape X Default Appeon Server Local Appeon Server Default Web Server Local Web Server i Only applications deployed to the Default Appeon Server and Default Web Server are listed in the Run Application window If you have deployed an application to several different folders on the same Web Server Appeon Developer will only remember the URL used in the last deployment although the URLs to access the other folders used in the previous deployments will also be valid Step 3 Select an application from the application list Step 4 Select a project loader for the application from the Project Loader dropdown list box e For Web applications IE Browser is the only selectable project loader and is automatically selected by default the Orientation dropdown list box is automatically disabled e For mobile applications Appeon Emulators either for iPad or for iPhone are the only selectable project loaders and the Appeon Emulator iPad is automatically selected by default you also need to
149. ide Page 201 Extended Toolkit Appeon for PowerBuilder 2013 17 2 3 1 Installation Types Specify whether to install EAServer Appeon Server and Appeon applications Table 17 2 Parameter for installing EAServer Parameter EAServer Description Specifies whether to install EAServer If you do not want to install EAServer using this setup program make sure that a supported EAServer was installed already Accepted Values Yes Install EAServer No Not to install EAServer instead use an existing EAServer Default Value None Example EAServer yes Table 17 3 Parameter for installing Appeon Server Parameter AppeonServer Description Specifies whether to install Appeon Server Accepted Values Yes No Default Value None Example Appeon Server yes Table 17 4 Parameter for installing Appeon Server EBF Parameter AppeonServerEBF Description Specifies whether to apply Appeon Server EBF Accepted Values Yes No Default Value None Example Appeon Server EBF yes Table 17 5 Parameter for installing Web Application Parameter WebApplication Description Specifies whether to install Web applications Accepted Values Yes No Default Value None Example WebApplication yes 17 2 3 2 EAServer and ASA Path Specify the path of EAServer and ASA ASA is required because Appeon Server has an ASA database for storing the sensitive system d
150. ies the number of Web applications that you want to install Accepted Values Any number greater than zero Default Value None Example WebApplications 2 If more than one application will be installed create the following parameters through incrementing by 1 for example WebApplication2 EAServerNVO2 ConnectCache2 and AEM2 for the second application WebApplication3 EAServerNVO3 ConnectCache3 and AEM3 for the third application etc Table 17 18 Parameter for the Web application 1 Parameter WebApplication Description Specifies the actual name of the first Web application Appeon Developer User Guide Page 205 Extended Toolkit Appeon for PowerBuilder 2013 Accepted Values An alphanumeric string Default Value None Example Examples for the first application WebApplication appeon_sales_application_demo Examples for the second application WebApplication2 appeon_code_examples Table 17 19 Parameter for EAServer NVO 1 Parameter EAServerNVO1 Description Specifies whether to install NVO components Accepted Values Yes No Default Value None Example EAServerNVO1 Yes To make data sources work on the target Appeon Server be sure to install the required database drivers to the target Appeon Server For more information on database drivers refer to Database Connection Setup in the Appeon Server Configuratio
151. iles Data Source Configure the data source only if your Appeon Server is installed on IIS Data sources in the selected Appeon Servers will be automatically displayed Appeon Server z Name DB Host Edit Cancel Follow the instructions below to create a data source on the Data Source Profile tab Step 1 Select an Appeon Server from the Appeon Server list box Only the configured Appeon Server profiles are listed The data sources existing on the application server will be displayed Appeon Developer User Guide Page 56 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 39 Data sources existing on the application server Application Profiles DB Type Profiles Server Profiles Deployment Profiles Data Source Profiles Data Source Configure the data source only if your Appeon Server is installed on IIS Data sources in the selected Appeon Servers will be automatically displayed Appeon Server Local Appeon Server Name DB Host appeonsample AppeonS ampleForServer appeonsample2 AppeonS ample2F orServer youhoops YouHoopsF orServer SAPTechEd2012 SAPTechE d201 2ForServer Step 2 Click the Add button to create a data source in the application server The Add dialog box is displayed Appeon Developer User Guide Page 57 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 40 Add a data source 5 Add Data Source x Name U
152. is complete click Finish to exit the installation wizard To run the application immediately select the Run Application Now option and click Finish Or you can run the application later from the Windows Start Programs Appeon Web Application ApplicationName To view the log information generated during the installation process select the View Log box and then click Finish The log file will be displayed Appeon Developer User Guide Page 144 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 24 Deployment complete oe Appeon Application Deployment xa Finished deploying the Appeon application The deployment wizard has finished installing the application and the related settings to the computer View Log Click Finish to exit the wizard 11 1 4 3 Uninstalling an application Step 1 Start the Appeon Server s and or Web server s where you intend to uninstall the application Step 2 Select Windows Start gt All Programs gt Appeon Application gt Undeploy ApplicationName The Appeon Application Undeployment Wizard is displayed Click Next to proceed Appeon Developer User Guide Page 145 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 25 Appeon Application Undeployment wizard a Appeon Application Undeployment Welcome to the Appeon Undeployment Wizard This wizard will remove the Appeon application from the specified computer Note before undeploying
153. isits Directory listing style O UNIX Step 4 Go to the Directory Security tab and verify that the Granted Access option is checked as shown in the following figure Appeon Developer User Guide Page 52 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 35 Directory security r Default FTP Site Properties Exa FTP Site Security Accounts Messages Home Directory TCP IP address access restrictions By default all computers willbe gf Granted access Except those listed below Denied access Access IP address Subnet mask 0c Cea C et 4 2 3 3 2 If the Web Server is an SSL Web Server If the Web Server is an SSL or secure Web Server you can configure the Web Server profile following the configuration instructions for non SSL Web Servers except for the following two points 1 You need to configure an HTTPS listener and port number for the Web Server 2 You must specify an HTTP not HTTPS listener and its port number in the HTTP server settings of the Web Server profile because Appeon Developer must use the HTTP protocol when deploying the Appeon application files to the server After the application is deployed to the Web server you can input https instead of http and the HTTPS port in the URL to access the application for example https 192 0 0 80 818 1 appeondemo 4 2 4 Managing deployment profiles A deployment profil
154. ject object ve 5 Uy System Objects Description m Application object m System Controls PipeLine object The Pipeline object including its properties functions and events is unsupported H System Functions Workaround T PowerSoript Reference g ae j D low Reference Add a server NVO and deploy it to EAServer to work around this issue The detailed steps are a m parameters in Datab a Yorkaround Techniques for Step 1 Encapsulate the Pipeline object including its properties functions and events in a server NVO and deploy the NVO to T FAQ amp Workarounds EAServer component Step 2 Call the interface function of the component and pass the Pipeline object name and relevant parameters to it Step 3 Call the functions properties or events of the Pipeline object in the component to implement the same functionalities as the original PipeLine object The limitation of this workaround is that only the system Pipeline object can be used in the NVO That is to say user defined objects inherited from Pipeline objects are unsupported in the NVO Prev Up Next m Application object System Objects Home Step 3 Modify the unsupported source code in the PowerBuilder painter according to the Workarounds amp API Guide Right click the unsupported item in the unsupported feature list treeview and select Edit or Edit Source to open the source code in the PowerBuilder Script view e Edit Displays
155. k Browse to display the Open file dialog which will automatically open the wcode folder of Appeon application package so you can conveniently select a file from the wcode folder or from its subfolder To select the source file click Browse to navigate to the folder where the source file is stored Figure 11 22 Specify files to replace for the application package Ge Replace Files Please specify the files that you want to replace for the No Destination File Source File Step 11 Wait while the wizard is installing files and settings Appeon Developer User Guide Page 143 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 23 Deploying the application Lx ie Anpeon Application Deployment Deploying the Application j p A The deployment wizard is performing the requested opera Please wait while the deployment wizard is deploying the application This may take several minutes Time Run Information 18 19 23 Deploying application name to Appeon Server 18 19 24 Deploying INI file s to Appeon Server 18 19 24 Deploying DataWindow SOL to Appeon Server 18 19 24 Committing changes to Appeon Server 18 19 25 Deploying embedded SOL to Appeon Server 18 19 25 Committing changes to Appeon Server 18 19 25 Deploying DataWindow Syntax to Appeon Server ee Gy aa 2888 1 r lt Back Next gt Step 12 Once the operation
156. k OK Appeon Developer User Guide Page 115 Running Appeon Applications Appeon for PowerBuilder 2013 The DataWindow will be printed directly to the local printer Figure 8 19 Print setup window s E Print Setup Printer Name Appeon PDFPrinter from SZxC J6168 uc Status Ready Type Apple Color Laserwiter 12 600 Where T5001 Comment Paper Orientation Size Letter 6 Portrait Source Automatically Select M C Landscape 8 3 2 4 SaveAs Obsolete This feature is obsolete since Appeon Web 6 6 The user can save the contents of a DataWindow in different file formats Step 1 Right click the DataWindow and select Save As File from the popup menu as shown in the following figure Figure 8 20 Save As File Datawindow Department Name State Employee Employee Emp ID Last Name First Finance MA 148 Jordan Julie E Finance MA 390 Davidson JoAnn Finance MA Find we Finance MA RE Denis Finance MA i Kristen Finance MA pina reipi Mary Anr Finance MA Sort Janet Finance MA Filter Jennifer Finance MA 7 John Marketing MA Print Melissa Marketing MA Save As File Jane Marketing MA 318 Crow John Marketing MA 409 Weaver Bruce Marketing MA 591 Barletta lrene zy iP 1 P Appeon Developer User Guide Page 116 Running Appeon Applications Appeon for PowerBuilder 2013 Step 2 Specify the file location file name and file type in the Save As window as shown
157. karounds115e B appeondemo B Appeontnstall d CodelnSight B icon B language i Project D res B Template J Toolkit J DLL amp OCX Package B Register Toolbar J Silent Install J GNU_gs707 J Help6 1 I 5 items Disk free space 1 36 GB i Computer m The following is a brief introduction to each folder in the Appeon Silent Installer Setup The root directory of the Silent Installer It contains the Appeon folder the Setup exe Uninstall exe SilentInstall txt and msvcp60 dll files Appeon Developer User Guide Page 200 Extended Toolkit Appeon for PowerBuilder 2013 e Appeon It contains the AS AS EBF EAServer and WebApp directory e AS It stores the installation program of Appeon Server e AS EBF It stores the installation program of Appeon Server EBF e EAServer It stores the installation program of EAServer e WebApp It stores the Web application files packaged by the Appeon application packaging tool e Setup exe The setup program for launching the silent installation e SilentInstall txt The configuration file which can be modified to customize the installation e Uninstall exe The uninstall program for silently removing what has been installed with Appeon Silent Installer e msvcp60 dll The DLL file for Appeon Silent Installer 17 2 2 Copying installation program of EAServer Appeon Server Appeon Server EBF or Appeon applications After the required folders and files are genera
158. l EAServerNVO1 YES AEM1 YES Conme cteachei g iy FE FEAE FE FE AE FE HE E FE AE FE FE AE FE HE AE FE AE FE FE FE FE HE FE FE AE FE FE AE FE FE AE FE AE FE FE AE FE FE AE FE AE FE TE AE FE FE AE FE AE E TE AE FE FE AE FE FE AE FE AE E FEAE FE HEHE Uninstall Path FE FEAE HE aE He EH EH eH EE EE EEE EEE aaa UninstallWebAppPath C uninstallwebapp aT HH EHH HHH EH AE FE FE HE E FE AE FE HE a EE a EEE Language default EN EN English JP Japanse HTH EH HT E FE AE EH AE FE FE AE EE E FE AE FE FE FE FE Ea EE Ea EE EEE a Language EN 17 2 4 Burning installation CDs After configuration is completed you can burn installation CDs with the customized silent installer the entire setup folder and distribute CDs to your end users The Appeon Silent Installer can be provided in one two or three CDs In one CD Installing the Appeon Server AS folder Appeon Server EBF AS EBF folder EAServer EAServer folder and the Appeon Web application WebApp folder In two CDs One for installing the Appeon Server AS folder Appeon Server EBF AS EBF folder and EA Server EAServer folder and the other for installing the Appeon application WebApp folder In three CDs One for installing the Appeon Server AS folder and Appeon Server EBF AS EBF folder one for installing EAServer EAServer folder and one for installing the App
159. le Click the Delete button to delete a selected application profile Note You cannot delete the default application profile Deleting the application profile will automatically delete the temporary fold for the application profile on the Developer machine The folder has the same name as the application profile and is created in the Project folder under the root directory where Appeon Developer is installed e g C Program Files Appeon Developer2013 4 2 1 1 4 Exporting Importing an application profile The Export and Import buttons are mainly to back up and restore the configuration of application profile s for instance if you want to transfer the configuration of application profile s to another Appeon Developer e Click the Export button to export the selected application profile s In the pop up dialog box type a file name then the selected application profile s will be saved into the file as XML file format To select multiple application profiles you can use Shift click or Ctrl click or drag the mouse pointer to create a selection e Click the Import button to import application profile s from the XML file which is generated by using the Export button If the application profile being imported has the same name as an existing application profile you will be asked to overwrite or ignore the existing application profile 4 2 1 2 Application profile settings The Application Profiles Configuration window provides seven t
160. le Name in the first installation and input appeon_code_examples_production as the Application Profile Name in the second installation The Application Profile Name will be used as the application name to distinguish the multiple application instances on the same server so they can be run independently from each other Important Note If using JEUS as the target Web server be sure to use the default Application Profile Name and Application URL Changing the default Application Profile Name and Application URL will cause the application files unaccessible Appeon Developer User Guide Page 137 Packaging Applications Appeon for PowerBuilder 2013 Specify Deployment Settings Please specify the profile name and the URL for the applica Please specify the URL for the application Application Profile Name Elssi isiisisis SSE sles Application URL http web serverport appeon_code_examples Step 5 Configure and select profiles for the Appeon Server s and the Web server s where the application will be installed To install the application to more than one Appeon Servers please make sure the Appeon Servers are of the same version such as 2013 as the Appeon Server selected for packaging To install the application to an Appeon Server cluster please create an Appeon Server profile for each Appeon Server in the cluster For detailed instructions on how to create the Appeon Server profile and Web server profile refer to Section
161. list of application profiles for you to select and analyze dropdown list Only application profiles configured in the Appeon Developer Configuration window will be listed Search field Searches for PBLs or objects that contains the text you enter Treeview of objects Gives the treeviews of PBLs and objects for the application selected in the application dropdown list and allows you to select the whole application or only some objects to analyze Display Full Path Gives you options to display or hide the full path of the PBLs and option objects in the treeview Refresh button Refreshes the PBL and object list in the treeview Step 2 Select the application that you want to analyze from the Application profile dropdown list The default target to analyze is the default application profile in the Appeon Developer Configuration window Appeon Developer User Guide Page 64 Using UFA Tool Appeon for PowerBuilder 2013 Step 3 Check the PBLs and or objects in the treeview for which you want to generate the UFA Report The treeview lists all the PBLs and objects contained in the selected target By default all objects are selected Step 4 Click the OK button to start the feature analysis The feature analysis of the selected objects begins as shown in the following figure Figure 5 4 Unsupported Features Analysis Process dialog Unsupported Features Analysis Process 25 Time Run Information A
162. listener for the SSL connection to this Appeon Server Username and Password should be configured in AEM AEM http localhost 80 AEM Connection Method HTTP HTTPS Test Settings After entering the Appeon Server settings we recommend you test the settings by clicking the button below Test Appeon Server Settings Cancel The following table lists detailed instructions on how to specify the properties for an Appeon Server profile Table 4 10 Appeon Server profile properties Property Instructions Profile Profile Name __ Assign a name to the Appeon Server profile Settings You should use names that are easy to remember and identify for example Appeon Server for Test or Remote Appeon Server Appeon Server Type Select J2EE if Appeon Server is installed to EAServer Server JBoss JEUS WebLogic or WebSphere select NET if Settings Appeon Server is installed to Microsoft NET Framework Server Enter the IP address or the machine name of Appeon Server Server Port Enter the HTTP port number used by Appeon Server http Note Do not enter an HTTPS port here Appeon Developer must use an HTTP port to connect with Appeon Server though the Appeon deployed application can be connected with an HTTPS port Appeon Developer User Guide Page 46 Configuring Appeon Developer Appeon for PowerBuilder 2013 Property Instructions AEM AEM URL The URL for Appeon Enterprise M
163. ll not block the download configure Internet Explorer s settings using the following steps Step 1 Open Internet Explorer and navigate to Tools gt Internet Options gt Security Step 2 Verify that you selected an appropriate Web content zone Appeon recommends you select the Trusted sites zone and add the Web application URL to the Trusted sites Appeon Developer User Guide Page 103 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 5 Select a Web content zone Security Privacy Content Connections Programs Advanced Select a zone to view or change security settings 9o y O Internet E Trusted sites Restricted sites Local intranet This zone is for all websites that are found on your intranet Security level for this zone Allowed levels for this zone All Low Minimal safequards and warning prompts are provided Most content is downloaded and run without prompts All active content can run c Appropriate for sites that you absolutely trust Enable Protected Mode requires restarting Internet Explorer Custom level Default level Reset all zones to default level Step 3 Click the Custom Level button in the Security tab The Security Settings page is displayed as shown in the following figure Appeon Developer User Guide Page 104 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 6 Security Settings page
164. ller Installs EAServer Appeon Server Appeon Server EBF Emergency Bug Fix and Appeon Web applications in the silent mode Note This tool is effective for the Web application only e Appeon Developer Toolbar Register Tool Enables you to register or unregister one Appeon Developer version to more than one PowerBuilder version or different Appeon Developer versions to different PowerBuilder versions 17 1 DLL OCX Files Package Tool Note This tool is effective for the Web application only DLL and OCX files are frequently used in PowerBuilder client server application Appeon offers you two ways to distribute DLL OCX files Table 17 1 Two ways to distribute DLL OCX lt files When to use Which tool to use Deploy DLL OCX files to There are only a few DLL In the Additional Files tab the server and then download OCX files or the files are of the Application Profiles them to the client at runtime small Configuration window Refer to Deploy External Files for details Package DLL OCX files There are many DLL OCX Use the DLL OCX file and install them to the client files or the files are large and packaging wizard Refer to before the application is run the client machine is fixed the following sections for for the first time detailed information 17 1 1 Packaging DLL OCX files Step 1 Run the EonDLLOCX exe file under the Toolkit DLL amp OCX Package folder in the Appeon Developer installa
165. ments for the Developer machine refer to System Requirements section in the Appeon Installation Guide Step 2 Close any unnecessary running programs or Windows services in order to have the maximum amount of memory available for Features Analysis Step 3 Perform an incremental build or object regeneration for the PowerBuilder application Right click on the application target and select a build option for example Incremental Build as shown in the following figure Figure 5 1 Incremental Build r AppecnDemo PowerBuilder xN File Run Tools Window Help ike ellae Seo agra BDH as Be Q Gq klk DA Bl as o0 KW HE R O ai 5 s AppeonDemo C WUsers Public Documents Appeon Developer 20 13 AppeonDer appeon_acf_demo C 2 al me trem me a a eee aL Ar el mer appeon_code_exampl New Developer 20 appeon_code_exampl Appeon Deve appeonmobiledemo q Search Hoper2013 A mobile_order C U Set as Current Target Developer Remove Target Library List Migrate Incremental Build Full Build Deploy Run Debug Show gt Properties lt m p Version 11 5 Build 1502 Ready The following table shows you which type of build options you should select for the application Table 5 2 Recommended build options Build Option What It Does Recommended For Regenerate Refreshes the timestamp for a Object level Features Analysis If the object PowerBuilder object is rege
166. n select the EA Server Components option and then create connection profiles for EAServers where you want to deploy the components Follow instructions below to create EAServer profiles e Click Add to open the Edit EAServer Profile dialog box e Input the connection parameters profile name host name or IP address port number user name and password e Click Test to verify the connection and the click OK to finish the creation Figure 11 18 Edit EAServer Profile rofile Name Server Name Port Number Login Name Password Note Input the real IP address in the Server Name field For example 192 0 0 1 Appeon Developer User Guide Page 140 Packaging Applications Appeon for PowerBuilder 2013 Step 7 If the EAServer Components option is selected in the previous step select the EAServer profile from the list and the components to deploy Click Next to proceed Figure 11 19 Deploy NVOs Deploy N Os Please select which EAServer components to deploy Please select which EAServer components will be deployed to the specified EAS erver EAServer List 192 0 1 56 8 Component List Step 8 Select whether to install AEM settings and data sources for the current application and click Next Appeon Developer User Guide Page 141 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 20 Deploy AEM settings AS Appeon Application Deployment Deploy AEM Settings a Please
167. n Developer User Guide Page 133 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 11 Application packaging finished Appeon Application Package Wizard Finished packaging the application Welcome Select Package Type The package wizard has finished packaging the application Select Application Select Appeon Server S Configure EAServer Profile Select NVOs Select AEM Settings Click Finish to exit the wizard Specify Destination Folder Packaging Process Finish Back Next gt Cancel After the application is successfully packaged all the necessary application files will be packaged into an executable deployment project under the Application Profile Name_install folder under the specified location You can copy the deployment project to other computers and deploy the application to any Appeon Servers and Web Servers by following instructions in Section 11 1 4 Installing and uninstalling an Appeon application 11 1 3 Modifying the deploy config file The deploy config file config xml is created during the packaging process and includes the default settings of the application application profile Appeon Server profile Web server profile EAServer profile EAServer components and data sources You can modify the config xml file using the config exe tool to have identical settings of the target environment so that the user can run the installation very conveniently without ne
168. n Guide Table 17 20 Parameter for data source 1 Parameter ConnectCachel Description Specifies whether to install data sources Accepted Values 0 Not to install data sources 1 Install and overwrite existing data sources 2 Install but not to overwrite existing data sources Default Value None Example ConnectCache1 1 Table 17 21 Parameter for AEM 1 Parameter AEM1 Description Specifies whether to install AEM settings Accepted Values Yes No Default Value None Example AEM1 Yes 17 2 3 8 Web Application Uninstall Program Path Specify the directory for the Web application uninstall program A shortcut for the uninstall program will be created in Windows Start menu Appeon Developer User Guide Page 206 Extended Toolkit Appeon for PowerBuilder 2013 Table 17 22 Parameter for the uninstall program path Parameter UninstallWebAppPath Description Specifies where the uninstall program for Web applications will reside Accepted Values A valid path Default Value None Example UninstallWebAppPath C uninstallwebapp 17 2 3 9 Resource Language Specify the language of the messages displayed during the installation or uninstallation process Table 17 23 Parameter for the resource language Parameter Language Description Specifies the language of UI messages Accepted Values EN English JP Japanese Default Value EN E
169. n Wizard This wizard will help you setup DLL OC files for distribution Click Next to proceed Cancel Step 2 Specify the location where the DLL OCX files will be installed Click Next to start the installation process The default installation location is SystemRoot system32 AppeonPlugin SystemRoot indicates the folder where Windows is installed typically C Windows if you specify a custom location in AEM see Appeon Server Configuration Guide for details then specify the same location here Appeon Developer User Guide Page 195 Extended Toolkit Appeon for PowerBuilder 2013 Figure 17 8 Specify the installation location Specify Installation Location Specify the directory where the DLL OC files will be installed m Specify Installation Location C Windows system32 AppeonPlugin Browse Cancel Step 3 Wait until the installation is complete During the installation process the DLL OCX files will first be copied to the specified location and then registered if they have been selected for auto registration during the packaging process Step 4 When the installation is complete select the Let wizard restart the system now option and click Finish to close the installation wizard and restart your machine To view the log information generated during the process select the View Log box and click Finish The log file will be automatically opened You can also manually open th
170. n by Whether to display the app in full screen by default when Default it is opened Language Default Language Select the languages to package and specify the default language of your workspace UI The workspace UI can be displayed in English French Simplified Chinese Traditional Chinese Japanese Korean Italian and Spanish You can select to package which languages To display the workspace UI in other languages refer to Adding and customizing UI languages 164 for details Xcode App Major Version The version number of your workspace App Build Version The build number of your workspace i0S iPhone App Icon Specify the app icon for the standard display on iPhone Standard Display 57 x 57 pixels iPhone App Icon Specify the app icon for the retina display on iPhone Retina Display 114 x 114 pixels iPhone Launch Image Specify the launch image for the standard display on Standard Display iPhone 320 x 480 pixels iPhone Launch Image Specify the launch image for the retina display on iPhone Retina Display 640 x 960 pixels iPhone 5 Launch Specify the launch image for the retina display on iPhone Image 5 640 x 1136 pixels iPad App Icon Specify the app icon for the standard display on iPad 72 Standard Display x 72 pixels iPad App Icon Specify the app icon for the retina display on iPad 144 x Retina Display 144 pixels iPad Launch Image Specify the launch image for the standard display
171. n deployment process is similar to the speed of the PowerBuilder compilation build process Appeon Developer User Guide Page 77 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Table 6 1 Appeon Application Deployment Time Benchmarks PB EXE w PBDs PB EXE w DLLs Appeon Sales Application 20 seconds 50 seconds 22 seconds Demo 5 55M Appeon Code 1 minutes 3 seconds 12 minutes 37 1 minutes 12 seconds Example Demo seconds 20 5M ACF Demo 21 5M 2 minutes 5 seconds 24 minutes 46 2 minutes 12 seconds seconds As a general rule of thumb each additional megabyte of PBLs will add approximately 8 seconds to the full deployment process For example it would take 4 minutes to deploy a 30MB PFC application This would only apply for the initial or full deployment All subsequent deployments should take no more than few minutes or even possibly as little as a few seconds This rule of thumb applies to hardware configurations that meet the minimum Developer PC requirements stated in the Appeon Installation Guide Machines with a slower clock speed will take longer to perform the deployment 6 1 2 Deployment duration for full deployments Remember the following main points regarding the deployment time e The process is very CPU and memory intensive e The size and complexity of the application affect the deployment time The following is an example of how long it takes to deploy an applicati
172. na display on iPhone Retina Display 640 x 960 pixels iPhone 5 Launch Image Specify the launch image for the retina display on iPhone 5 640 x 1136 pixels iPad App Icon Specify the app icon for the standard display on iPad 72 Standard Display x 72 pixels iPad App Icon Specify the app icon for the retina display on iPad 144 x Retina Display 144 pixels iPad Launch Image _ Specify the launch image for the standard display in Standard Display in landscape on iPad 768 x 1004 pixels Landscape iPad Launch Image _ Specify the launch image for the standard display in Standard Display in portrait on iPad 1024 x 768 pixels Portrait iPad Launch Image __ Specify the launch image for the retina display in Retina Display in landscape on iPad 1536 x 2008 pixels Landscape Appeon Developer User Guide Page 156 Packaging Applications Appeon for PowerBuilder 2013 Description iPad Launch Image Specify the launch image for the retina display in portrait Retina Display in on iPad 2048 x 1496 pixels Portrait Step 6 Specify the storage location for the package and click Next The generated package will be stored under a folder named App Name_install under the specified location Figure 11 37 Specify directory Appeon Application Package Wizard x The package tool will create a folder named App Name_install to store the packaged application Welcome
173. nalysis tool or perform the first two tasks in Appeon Deployment Wizard Features These features apply for the report Automatic incremental analysis After the first analysis the subsequent analysis is automatically incremental to save time but the report generated still contains all the information as if it were a full analysis Analysis at application PBL or object level You can choose to generate UFA Report for an application PBL s in the application or object s in the application This chapter describes e How to use the UFA tool to analyze an application and generate the UFA Report e Undetected unsupported features There are a small number of unsupported features that the UFA Report cannot detect e How to use the UFA tool to work around unsupported features effectively e How to use the UFA tool to manipulate the UFA Report For example you can adjust the view of the UFA Report so it suits your preferences Appeon Developer User Guide Page 60 Using UFA Tool Appeon for PowerBuilder 2013 5 1 Analyzing an application 5 1 1 Tasks required before you perform feature analysis Step 1 Make sure that the computer is powerful enough to support feature analysis Unsupported Features Analysis is CPU and memory intensive A faster CPU can speed up the process Additional memory is useful for ensuring that RAM will not be exhausted when analyzing a large application Regarding system require
174. ne the priorities of the PowerBuilder features Have to modify Suggest to modify Can be ignored e Summary Enables you to view summary information of each unsupported feature You can set the default view mode in the Tools gt Options menu For detailed descriptions refer to Section 5 2 2 7 Customizing the general settings of the UFA Report 5 2 2 3 Searching for UFA Report items To do a quick search you can directly enter the text that you want to search in the search field of the UFA Report window Or follow steps below to use the standard Find Text dialog box Step 1 Select the Edit gt Find menu Or right click in the unsupported feature list treeview and select Find Step 2 In the Find Text box enter the text that you want to search Step 3 Select any other options that you want Step 4 Click Find Next Figure 5 9 Find Text Find Text A mi E Match case Close Use as wildcard Help Wrap at beginning or end Te 5 2 2 4 Filtering UFA Report items Filtering helps you restrict the number of the unsupported features displayed in the UFA Report and quickly find the target unsupported features especially when there are a large number of unsupported features in the application Appeon Developer User Guide Page 71 Using UFA Tool Appeon for PowerBuilder 2013 You can filter the unsupported features by the objects they reside in or by the feature types or by the priorities 5 2
175. nerated the object will be analyzed even if no change has made to it Appeon Developer User Guide Page 61 Using UFA Tool Appeon for PowerBuilder 2013 Build Option What It Does Recommended For Incremental Refreshes the objects that Application level Features Analysis have been changed Full Refreshes all objects Not recommended Step 4 Perform PBL optimization for the PowerBuilder application The purpose of PBL optimization is to remove gaps from libraries and defragment the storage of objects to get rid of potential problems in PBL files 5 1 2 Accessing the UFA tool Click the Analyze button 4 in the Appeon Developer toolbar to launch the UFA tool The Unsupported Feature Analysis Report window UFA Report window will be displayed Figure 5 2 UFA Report Window t Unsupported Feature Analysis Report sales_application_demo o e File Edit View Tools Help Ooh 4m 8 ese X gt UFA Summary fe Al unsupported items in the application sales_applicat Unsupported abject 0 Unsupported powerscript 0 Unsupported embedded SQL 0 Other O UFA Report window provides a variety of menus to help you manage unsupported features The following table gives a brief description of these menus Some of them are also listed as shortcut menus on the toolbar Table 5 3 UFA Report Window Menu Description File Generates a UFA report See Section 5 1 3 Performing feature anal
176. nline AutoComplete C Use most recent order when switching tabs with Ctrl Tab V Use Passive FTP For firewall and DSL modem compatibility Z Use smooth scrolling HTTP 1 1 settings Z Use HTTP 1 1 m ma K Use HTTP 1 1 through proxy connections International F Always show encoded addresses Send IDN server names my Isl Send IDN server names for Intranet addresses Send UTF 8 URLs J Show Information Bar for encoded addresses 4 w p S Takes effect after you restart Internet Explorer Restore advanced settings Reset Internet Explorer settings Deletes all temporary files disables browser E add ons and resets all the changed settings a You should only use this if your browser is in an unusable state cancel __ apply Step 3 Click Apply in the Advanced tab and then OK in the Internet Options window to allow the settings to take effect 8 1 2 4 Security settings for ActiveX controls and Appeon Xcelerator plug in download If the Web application calls OLE objects DLL files or runs executable programs on the Client then when the Web application is run for the first time on the Client the user will need to download an ActiveX control for executing functions that involve client side integration and the Appeon Xcelerator plug in for improving the runtime performance of Web applications from the Web Server To ensure that Internet Explorer wi
177. nnamed Database Driver Informix Native Driver v IBM Informix Server Pott 1433 Database Name User Name Password Character Set ASCII Session Mode DEFAULT Maximum Connection Pool Size 100 Minimum Connection Pool Size 10 0 Command Timeout seconds 30 Connection Lifetime seconds D Other Options Dynamic Database Connection v Pooling Cis cance The following table provides instructions for how to specify the data source settings Table 4 14 Instructions to specify data source settings Settings Instructions Name Type the name of the data source The data source name can contain a combination of letters underscores _ dot and numbers Do not use double byte characters such as Chinese Korean or Japanese characters or leave a leading or trailing space Driver Select the driver type for the data source Host Type the database host Port Type the database port Appeon Developer User Guide Page 58 Configuring Appeon Developer Appeon for PowerBuilder 2013 Settings Instructions Database Name Type the database name ODBC Data Type the data source name only when the driver type is ODBC JDBC Source Bridge User Name Type the database login username The username is set on the database server Password Type the database login password The password is set on the database server Maximum Specify the maximum number of connec
178. none faa a Sr Se SSS SS SSS SS SS SE SSeS Se ST SSS SESS a L Author laihaichun Date 2063 12 36 Pf Pee Sees n ese Sas es sees eee ess eae Sse sess eas esesee te s s Modify History fi PPPeeSes ss arses sesess sees esse ess eaSeSssesessessasssesese CopyRight 2663 7 Appeon Inc f fH SSS SSS SSS SSS SSS SSS SSS SSS SSS SS SS SSS SS SS SSS SSS SS SSSSSSSa D SQLCA DBMS ODBC SQLCA AutoCommit False SQLCA DBParm ConnectString DSN AppeonSample UID dba P CONNECT If SQLCA SQLCode lt gt 6 Then MessageBox Alert Connection to database failed Halt CLOSE X lt ii 4 gt h Source Browser Source History L string commandline sales_application_demo open string commandline return long 19 4 lt T gt Call Stack Breakpoints h Watch J lt P gt Local Global Instance J a 7 6 Examining an application at a breakpoint Appeon Debugger provides a Quick Watch function and the Variables Watch and Call Stack views that work the same as PowerBuilder Debugger for examining the state of the application It does not provide Break on Changes and TipWatch functions nor the Object in Memory view 7 6 1 Special variable and expression handlings Appeon Debugger watches the variable and expression results out of JavaScript code but not PowerBuilder code This is the main difference with PowerBuilder Debugger Despite the difference the results shall be
179. ns Therefore if an expression does not pass validation in PowerBuilder PowerBuilder Debugger does not give evaluation results however Appeon Debugger may give a result sometimes even an incomprehensible result such as object 3 for the expression this 3 e If two expressions are interconnected because the evaluation results of the expressions are dependent on the orders they are executed and the ordering may follow different rules in PowerBuilder Debugger and Appeon Debugger Appeon Debugger may produce different results from PowerBuilder Debugger 7 6 2 Adding variables or expressions to Watch view Method 1 Adding variables or expressions to Watch with the Quick Watch Step 1 Select a variable or expression or place the cursor to a variable or expression in the Source view right click and select Quick Watch from the popup menu or press Shift F9 The variable or the expression will be added to the Expression box on the Quick Watch dialog Step 2 Click the Add Watch button to add the variable or expression to the Watch view Appeon Developer User Guide Page 96 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 Figure 7 5 Quick Watch Quick Watch x Expression SOLCA AutoCommil Add Watch Current Value Change Value TH boolean SQOLCA AutoCommit false Reevaluate _Add watch crore ae cee Close Method 2 Adding variables or expressions directly in the Watch Step 1 Right
180. nutes Task 3 Appeon Application Deployment Completed lt 1 Minutes Total Time Elapsed for Automatic Conversion lt 3 Minutes Log Information Warnings and Errors Summary Errors O Warnings 0 Reports Features Analysis report available Analysis Report Finish Finish and Debug Finish and Run Table 6 8 Deployment report page Element Description Deployment Displays the name of the application deployed the deployment mode Information used and the deployment profile used Deployment Task Displays the status and time of each of the three deployment tasks Summary as well as the total time for the entire PowerBuilder to Web or PowerBuilder to mobile conversion process Log Information Displays the number of errors and warnings that occurred during the deployment process Click the View Log button to view the errors and warnings generated during the deployment process The log file can be managed in the Information Manager For detailed instructions refer to Chapter 10 Using Information Manager Available Reports Displays the reports Analysis Report generated during the deployment process mainly Task 2 e Analysis Report button This report is available if the Generate Unsupported Feature Analysis Report option on the Appeon Deployment Wizard is selected before deployment After you click this button the UFA Report Window will be displayed For Appeon Developer User Guide Page 87 Deploying
181. o specify the deployment settings for an application Table 6 4 Appeon Deployment Wizard settings Setting Description Application to be Select an application to be deployed ene The default application is listed by default The application chosen for deployment will become the default application under Application Profiles in Appeon Developer Configuration Deployment Select a deployment profile to be used in the Web or mobile deployment ee The selected deployment profile determines which Appeon Server s and Web Server s the application will be deployed to You must make sure the Appeon Server s and Web Server s are started before you perform the deployment Deployment Select one of the three available deployment modes Mode list box e Full Application Deployment e Incremental Application Deployment e Deploy Already Generated Application Unattended Specify whether the whole deployment process will automatically Deployment proceed without displaying the Next button or waiting for interaction check box If you want to view the messages or reports generated at each step you can set the unattended deployment to false the wizard will require you to click the Next button to start the next task until the whole conversion is complete Appeon Developer User Guide Page 80 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Setting Advanced button Generate Unsupported Feat
182. ode 10S 4 m r See the following table for details Table 11 4 Workspace settings Group Parameter General Display Name Description Specify the name of your workspace that will appear in App Store For the name to display completely it should be about 12 letters but it depends on the width of each individual letter for example w takes more room than i The Display Name will also be used as name of the generated package Workspace Banner Whether to display the Workspace Banner in your workspace Workspace Banner Specify the URL to your own banner The default page Package of your own banner must be index html and the URL must point to index html Refer to Replacing the Workspace Banner 164 for details SSL Verify Peer Enable or disable the SSL peer verification SSL Verify Host Enable or disable the SSL hostname Verification Appeon Developer User Guide Page 162 Packaging Applications Appeon for PowerBuilder 2013 Group Parameter Description Connection Timeout Specify the timeout seconds for your app connecting to seconds the server Record Logs Option to record app logs Help Path Specify the path of your help file The startup page of your help must be index html ApplicationEnable Edit App Enable or disable the Add App and Delete App functions Default App Specify the default app The deployed apps are listed Full Scree
183. olumns Click Verify to test whether the filter expression is valid Click OK to accept the filter as shown in the following figure The DataWindow automatically refreshes and the data is filtered Appeon Developer User Guide Page 114 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 17 Specify Filter employee_emp_id lt 130 Functions Columns department_dept_name employee_emp_id employee_emp_Iname employee_emp_fname employee_salary employee_state casef x when athenby 8 3 2 3 DataWindow printing The Print menu provides user ability to print DataWindows directly on printers connected to the Client Step 1 Right click the DataWindow and select Print from following figure Figure 8 18 Print file with physical printers the popup menu as shown in the Datawindow Department Name State Employee Employee ID Last Name Finance MA 148 Jordan Finance MA 390 Davidson Finance MA Find Next Finance MA i Finance MA Find Previous Finance MA Sort Finance MA Filter Finance MA Marketing MA Print Marketing MA Save As File Marketing MA 318 Crow Marketing MA 409 Weaver Marketing MA 591 Barletta Te Emp First Julie JoAnn Denis Kristen Mary Anr Janet Jennifer John Melissa Jane John Bruce lrene Step 2 Specify the printer settings and paper settings in the Print Setup window as shown in the following figure Clic
184. olumns Ascending department_dept_name employee_emp_id Step 3 Check the Ascending check box to sort the data in ascending order or uncheck the Ascending check box to sort the data in descending order Click OK to accept the changes The DataWindow automatically refreshes and the data is sorted If you want to edit the selected column double click it to open the Modify Expression dialog as shown in the following figure Appeon Developer User Guide Page 113 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 15 Modify Expression dialog Modify Expression Functions Columns department_dept_name employee_emp_id employee_emp_Iname employee_emp_fname employee_salary employee_state casef x when athenby To filter data Step 1 Right click the Web DataWindow and select Filter from the popup menu as shown in the following figure Figure 8 16 Filter Datawindow Department Name State Employee Employee Emp ID Last Name First Finance MA 148 Jordan Julie E Finance MA 390 Davidson JoAnn Finance MA Find Next Denis Finance MA f i Kristen Finance MA Hinaao Mary Anr Finance MA Sort Janet Finance MA Filter Jennifer Finance MA 7 John Marketing MA Print Melissa Marketing MA Save As File Jane Marketing MA 318 Crow John Marketing MA 409 Weaver Bruce Marketing MA 591 Barletta lrene 7 in Step 2 Specify the filter by selecting the functions and c
185. omize Appeon Workspace and then package Appeon Workspace to an Xcode project follow detailed instructions in Customizing and packaging Appeon Workspace Appeon Developer User Guide Page 125 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 2 Select package type Welcome Please select a package type Select Package Type Select Application Select Appeon Server Package a Native Mobile Project Configure EAServer Profile Customize and Package Appeon Workspace Select NVOs Select AEM Settings Specify Destination Folder Packaging Process Finish Step 5 Select the profile of the application that you want to package and click Next Only applications that have been deployed will be listed here for selection If the application you intend to package is not listed here you would need to deploy the target application using the Appeon Deployment Wizard first See Chapter 6 Deploying PowerBuilder Applications Appeon Developer User Guide Page 126 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 3 Select an application Appeon Application Package Wizard Welcome Select Package Type Select Application E Select Appeon Server E Configure EAServer Profile E Select NVOs E Select AEM Settings E Specify Destination Folder E Packaging Process E Finish Please select an application to package Only application that have been deployed will be listed below for sele
186. on Undeployment Status Time Run Information 16 55 09 Undeploying application from Appeon Server 16 55 09 Connecting to Appeon Server localhost 16 55 10 Deleting application files from Appeon Server 16 55 11 Deleted application files from Appeon Server succ 16 55 11 Connecting to Web server Local Web Server 16 55 11 Deleting application files from Web server 16 55 11 Deleted application files from Web server success Mos lt Back Cancel 12 1 2 Undeploying with the Appeon Server mode Step 1 Select the Appeon Server radio button in the Specify Undeployment Mode window as shown in the following figure and click Next to continue Figure 12 7 Specify Undeployment Mode window X Application Undeployment Wizard X Specify Undeployment Mode You can undeploy an application deployed using a specific deployment profile by choosing Deployment Profile mode If you are unsure of the application name use Appeon Server mode to list all applications deployed to a specific Appeon Server Undeployment Mode Deployment Profile Appeon Developer User Guide Page 174 Undeploying Appeon Applications Appeon for PowerBuilder 2013 Step 2 Select the Appeon Server that contains the Web or mobile application to be undeployed from the Appeon Server list box as shown in the following figure The Appeon Server list box lists all the Appeon Server profile names Make sure the selected Appeon Serve
187. on applications Run Uninstall exe on the installation CD The uninstall program will automatically load the SilentInstall txt file on the same CD and remove what has been installed with Appeon Silent Installer To uninstall Appeon applications from Windows Start menu Select Windows Start gt Programs gt Appeon Application gt Undeploy Appeon Web Application Or run the uninstall program under the location specified by the UninstallWebAppPath parameter You will go through the same process as those in Section 11 1 4 3 Uninstalling an application in the Packaging and Installing Appeon Applications chapter 17 2 5 3 FAQs 1 What happens if EAServer is started during the process of silent installation Appeon Silent Installer will shut down the EAServer and continue the installation 2 What happens if EAServer or Appeon Server was already installed during the process of silent installation Appeon Silent Installer will overwrite the existing EAServer or Appeon Server Appeon Developer User Guide Page 210 Extended Toolkit Appeon for PowerBuilder 2013 3 What happens if the names of NVO packages for a Web application are duplicated Appeon Silent Installer will still deploy the first NVO package but will not deploy the second NVO package This activity will be recorded in the log file 17 3 Appeon Developer Toolbar Register Tool Appeon Developer can run with PowerBuilder 8 9 10 10 5 11 11 5 12 and 12 5
188. on for PowerBuilder 2013 Figure 17 12 Uninstall confirmation Question xs Q Are you sure you want to uninstall DLL OCX Package Step 4 Wait until the uninstall is complete Step 5 When uninstall is complete click OK to exit Figure 17 13 Uninstall complete DLL OCX File Uninstall Ex o DLL OCX File was successfully removed from your computer 17 2 Appeon Silent Installer Windows EAServer only Notes 1 This tool is effective for the Web application only 2 This tool does not work in NET JBoss JEUS WebLogic and WebSphere versions To help ISVs create an easy to use Appeon installation package for the end users Appeon specially provides a silent installer which can be customized to install EAServer Appeon Server Appeon Server EBF Emergency Bug Fix and Appeon applications in the silent mode This guide provides some useful instructions for ISVs on e Creating folder structure of Silent Installer e Copying installation program of EAServer Appeon Server Appeon Server EBF or Web applications e Customizing configuration file e Burning installation CDs Additional instructions are also provided for end users on e Running Appeon Silent Installer for End Users 17 2 1 Creating folder structure of Silent Installer The installation program files of EAServer Appeon Server Appeon Server EBF and Web application must be placed in the required folder structure so that Appeon Silent Installer can
189. on with 3 69 MB in PBLs and images using full deployment Table 6 2 Deployment duration Deployment Task Elapsed Time Task 1 Application Source Code Export 8 seconds Task 2 Application File Generation 27 seconds Task 3 Web or Mobile Deployment 15 seconds for a local deployment Test environment a single CPU Intel P4 1 8 GHz with 256 MB RAM and 60 GB IDE hard drive All of the generated application files deployed to the server are a combined 1 25 MB in size 6 1 3 Deployment duration for incremental deployments Since the initial full deployment can be time consuming Appeon provides an Incremental Deployment for maintaining or upgrading an already deployed application This feature only re deploys the incremental changes that have been made in the application Appeon can detect whether an object has been modified and re deploy only the changed objects Appeon Developer User Guide Page 78 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 6 2 Deployment process 6 2 1 Preparing the PowerBuilder application Appeon recommends that you perform a build and PBL optimization on the PowerBuilder application before performing an Appeon Application Deployment The following table shows you which type of build options you should select for the application Table 6 3 Build options Build Option What It Does When To Perform Incremental build Refreshes the objects that have been Before a full o
190. onfirmation dialog option A dialog box is displayed after you launch an application from the Appeon Developer toolbar but before the application starts This dialog box enables you to specify the arguments for the application e Specify the default command arguments field The specified default arguments are directly attached to the application URL when the application is run from the Appeon Developer toolbar If both options are selected A dialog box pops up with the default arguments filled in as shown in the following figure You can either change the default arguments or leave them alone Figure 4 19 Command line argument dialog box Request Parameter lt i ee Please specify the command line argument to be passed to the application Click the Cancel button if you do not want to pass command line argument Cancel Appeon Developer User Guide Page 32 Configuring Appeon Developer Appeon for PowerBuilder 2013 To run an application with arguments from Clients type the application URL with the arguments The format of an application URL with arguments is http AppURL index htm Arg Value Arg Value indicates the arguments that will be passed to the application The arguments must be separated by commas if there are more than one argument Application Language Step 1 Click Language Options only available when you are using a version of Appeon for PowerBuilder other than English on the Misc Settings tab
191. orted sports accessories assorted toiletries Step 3 Right click on an item in an editable HTML DataWindow and a menu pops up as shown in the following figure The user can select the following menu items from the popup menu to perform quick editing Undo Cut Copy Paste Delete Select All Figure 8 23 Popup menu for quick edition E Catalog Manager Products eo SKU Category Product Name Unit Price Description 3 Add 4 000 02 Clothing Pants 36 00 Pants khaki ae ee T Shirt wi ar en Remove z Undo 4 000 04 Clothing Shorts i 3 Modify 4 000 08 Clothing T Shirt Bl Cut ue Mody 4 010 10 Clothing T Shirt BI Copy ack Save amp 222 22 Clothing Polo Shirt parte 4 555 55 Clothing Polo Shirt Delete B 000 00 Shoes Running B 000 01 Shoes Walking Select AII KM Jes Sindak Right to left Reading order C 000 06 Accessories Sunglass Show Unicode control characters E C 000 07 Accessories Socks Catt a Bek Brow Insert Unicode control character gt C 234 34 Accessories Sports W Open IME d silver Reconver sion x Show All Filter Close i Appeon Developer User Guide Page 118 Launching Appeon Workspace Emulator Appeon for PowerBuilder 2013 9 Launching Appeon Workspace Emulator Appeon provides a shortcut of the mobile device emulator which is the Appeon Workspace emulating various mobile devices on the Windows platform to conveniently run your Appeon deployed mobil
192. ou to deploy the application For detailed information refer to Chapter 6 Deploying PowerBuilder Applications After the configuration is complete the application will be added to the Application Profiles tab of the Configure tool where you can manage or change any settings of the application For detailed instructions refer to Section 4 2 Using Configure Tool Appeon Developer User Guide Page 19 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 11 Summary page Appeon Developer Configuration Wizard The following is the summary of settings for your application deployment To change any settings click Back Welcome Configure basic settings Koplication Profile Name a appname E Select PBL files Application URL appname Configure deployment settings Project Type p Mobile Select DB types Mobile App Icon None Declare transaction object s Mobile App Description None Device Type Tablet Select image files Mobile App Name appname Select INI files Deployment Option X 4 m Deploy External Files Deploy the application now Summary 4 2 Using Configure Tool The Configure tool allows you to modify the settings of existing application profiles database type profiles Appeon Server profiles Web server profiles deployment profiles and data source profiles and specify the advanced settings for an application profile such as the performance
193. ou want to review or change any settings click Back Current Settings Application Name pet_world Package Location C Program Files 4ppeonappeontest BLL OCX Information Register DLL OC files No C Windows systemavifile dll No C Windows systemavicap dll 17 1 2 Installing and uninstalling DLL OCX files You will use the same setup program Setup exe file in the generated package for installing and uninstalling DLL OCX files e If the DLL OCX files are not installed on the client when you run the setup program you will be guided to install the files Refer to Section 17 1 2 1 Installing DLL OCX files for detailed instructions e If the DLL OCX files are already installed on the client when you run the setup program you will be guided to reinstall or uninstall the files If you select to reinstall the files you will run through the same process as a new installation as described in Section 17 1 2 1 Installing DLL OCX files If you select to uninstall the files refer to Section 17 1 2 2 Uninstalling DLL OCX files for detailed instruction 17 1 2 1 Installing DLL OCX files Step 1 On a client machine run the Setup exe file in the generated package The DLL OCX File Installation Wizard starts as shown in the following figure Click Next to proceed Appeon Developer User Guide Page 194 Extended Toolkit Appeon for PowerBuilder 2013 Figure 17 7 DLL OCX File Installatio
194. own in the following figure The selected Appeon Server determines that its AEM settings will be packaged and that the packaged application can only be installed to Appeon Servers of the same version such as 2013 but not necessarily the same type Figure 11 4 Select an Appeon Server Appeon Application Package Wizard Welcome Select Package Type Select Application Select Appeon Server E Configure EAServer Profile E Select NVOs E Select AEM Settings E Specify Destination Folder E Packaging Process E Finish Please select an Appeon Server from the following list Note To package EAServer NVOs you must select an Appeon Server of type EAServer Otherwise the steps for selecting EAServer profile and NYO components will be skipped Selected Appeon Server Profile Name Sere Local Appeon Server Step 7 If the selected Appeon Server is of type EAServer select whether to package EAServer components Appeon Developer User Guide Page 128 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 5 Configure EAServer profiles Appeon Application Package Wizard Please select whether to package EAServer Welcome components Select Package Type Note If the Package EAServer Components option is not selected the Select Application step for selecting NYO components will be skipped Select Appeon Server Configure EAServer Profile Profile Name Server Name Port Number E Sele
195. particular network for Web conditions applications only Parsing options Unsupported identifiers refer to identifiers that are supported in PowerBuilder but unsupported in Appeon due to the different naming convention between PowerScript and JavaScript XML For detailed explanation of such unsupported identifiers refer to Identifiers in the Appeon Features Help With this automatic renaming option enabled when the Appeon Deployment Wizard deploys an application it automatically detects unsupported identifiers in the application and renames these identifiers to supported ones in the files it generates for the application while keeping the application source code unchanged After the deployment you can get the list of all the identifiers that are renamed in the deployment log in Chapter 10 Using Information Manager The automatic renaming feature will not work if the option is disabled In this case you must rename the unsupported identifiers by yourself following the guidance of the UFA report and Appeon Features Help Appeon Developer User Guide Page 35 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 22 Parsing options Web Service Profiles Runtime Settings Summar Basic Settings DB Settings Additional Files Misc Settings Command Line Arguments Configure how command line arguments used in the PowerBuilder 3 z application will be handled on the Web or Mobile
196. peon documentation and product UI For details please refer to the Development Guidelines for Appeon Mobile To utilize the tool to convert the size do the following cre Step 1 Click the size calculator icon FFF in the Appeon Developer toolbar Step 2 Input the size then select a language and then click one of the conversion buttons according to your needs e The DPI stands for Dot Per Inch This is fixed 96 for simplicity e Language indicates the language of the operating system of the mobile device Currently only English and Japanese are supported For Dot to PBU Appeon Developer User Guide Page 186 Converting screen size between dots and PBUs Appeon for PowerBuilder 2013 Input the size in the corresponding text boxes under the DOT group box and then select a preferred language from the Language dropdown list box On the click of the DOT to PBU DUT gt PBU button the results appear in the corresponding text boxes under the PB Unit group box For PBU to Dot Input the size in the corresponding text boxes under the PB Unit group box and then select a preferred language from the Language dropdown list box On the click of the PBU to DOT PBU gt DOT button the results appear in the corresponding text boxes under the DOT group box Appeon Developer User Guide Page 187 Appeon for PowerBuilder Help Appeon for PowerBuilder 2013 16 Appeon for PowerBuilder Help Appeon provides a comprehen
197. performance Performance Settings Parsing Options v Allow Deployment Wizard to rename the identifiers unsupported by JavaScript or XML Appeon Developer Logs Set the log writing mode for Deploy Log and Analysis Log You may view manage these logs in the Information Manager Off mode Summary mode Debug mode OK Cancel The logging options enable you to select the level of information contained in the logs according to your needs Table 4 7 Log writing options Mode Description Off mode Generates no log files This mode offers the fastest performance since nothing is written to a log file Summary Generates log files with basic execution information mode This is useful for tracking errors that have occurred but inadequate for Default detailed troubleshooting Use this mode once the application is stable Debug mode Generates log files with detailed execution information for troubleshooting obscure and esoteric issues This is useful for technical support but performance speed will slow down when using this mode Appeon Developer User Guide Page 37 Configuring Appeon Developer Appeon for PowerBuilder 2013 You can view or delete these log files For detailed instructions refer to Chapter 10 Using Information Manager 4 2 1 2 5 Web Service Profiles A Web service profile contains the settings for the Web service s to be invoked in the Appeon d
198. port a Task 1 Application Source Code Export Appeon Deployment Deployment Task Status Deployment Task Status Task 2 Appeon Application File Generation Task 3 Appeon Application Deployment Important Information Please do not modify the application PBLs during task 1 In Progress Time Time 13 36 27 G 13 36 27 G 13 36 27 G 13 36 27 G 13 36 27 Run Information Exporting object Window type w_set_filtercust_order Exporting object Window type w_set_filter Exporting object Window type w_rpt_order_type Exporting object Window type w_rpt_order_date_summary Exporting object Window type w_rpt_order_customer_summary FE unarna ohiast Rusimndeuil time hu rt antions mW lan 4 10 Cancel After Task 1 is completed Task 2 Application File Generation will automatically start as shown in the following figure if the Unattended Deployment option is selected otherwise you must click Next at the bottom of the Appeon Deployment Wizard to begin Task 2 Appeon Developer User Guide Page 84 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Figure 6 4 Task 2 Application File Generation ri Appeon Deployment Wizard sales Lo amp nese Deployment Task Status Deployment Task Status Time Task 1 Application Source Code Export Completed lt 1 Minutes Task 2 Appeon Application File Generation In Progress Task 3 Appeon Appl
199. r changed incremental deployment Full build Refreshes all objects Not recommended Optimize PBLs Removes unused space in the PBLs After building the as stored on disk and reduces object application but prior to fragmentation deployment Performing an incremental build in PowerBuilder is necessary because when modifications are made to a parent class the child class does not reflect the changes unless one of three things occurs 1 The child class is opened and saved 2 An incremental build is performed 3 A full build is performed 6 2 2 Specifying the deployment settings Click the Deploy button in the Appeon Developer toolbar The Appeon Deployment Wizard is displayed Appeon Developer User Guide Page 79 Deploying PowerBuilder Applications Appeon for PowerBuilder 2013 Figure 6 1 Appeon Deployment Wizard Appeon Deployment Wizard sales Lo mesa The Application Deployment Wizard will quide you through the automated conversion process Please ensure that the correct PowerBuilder application and deployment settings have been selected and press Next to continue PowerBuilder Application Application to be deployed sales X Deployment profile Local Deployment Deployment mode Full pplication Deployment sd v Unattended Deployment Advanced Reporting Options Generate Unsupported Features Analysis Report ss The following table describes how t
200. r 17 Export appname Mobile Release PowerBuilder 17 Import 4 m p Caneel 4 2 1 1 1 Specifying the default application profile To specify which application profile will be used as the default application profile select the Default radio button The PowerBuilder application defined in the default application profile is selected for unsupported features analysis PowerBuilder to Web or PowerBuilder to mobile conversion application packaging and application undeployment 4 2 1 1 2 Selecting an application file generation mode To specify a mode for Web or mobile file generation click the Mode list box If you change the mode you must perform a full deployment to make the new mode effective Table 4 1 File generation mode Description Use in the Debug PS JS__ Generates unencrypted JavaScript files for debug Web or mobile use application debugging and tuning stage Appeon Developer User Guide Page 21 Configuring Appeon Developer Appeon for PowerBuilder 2013 Mode Description Use in the The PowerBuilder source code is provided as comments in the JavaScript files for easy reference Debug JS Generates unencrypted JavaScript files for debug Web or mobile use application debugging No PowerBuilder source code is provided in the and tuning stapes JavaScript files Release Generates encrypted JavaScript files Production stage 4 2 1 1 3 Deleting an application profi
201. r Guide Page 180 Developing with Code Insight Appeon for PowerBuilder 2013 Select this To do this Detailed Steps tab NOTE 1 only one PBT file can be set to the default PBT 2 Code Insight can only be effective to the default PBT System tab Specify what to display 1 In the Auto List group box opt to automatically page in the list display functions events properties controls and or variables in the list 2 In the Application Type group box opt to display only the unsupported features and or the supported features for Web applications or and Mobile applications 3 In the Feature Type group box opt to display only the unsupported features and or the supported features in the list 4 Click OK 13 1 2 Enabling Code Insight After you complete the configuration you can enable Code Insight and use it to develop the PowerBuilder application Click on the icon of Code Insight and select Enable from the status area icon menu as shown in the following figure Figure 13 4 Enable Code Insight Enable Config ielected Quit U The Code Insight icon appears in one of the following statuses Table 13 4 Enable Code Insight Status Detailed Steps D Code Insight remains disabled This happens when the PBT File list in the Code Insight Configuration window is empty Make sure you have added the PBT file to the list of Code Insight is enabled but ineffective in the current application To mak
202. r is running Step 3 Select the application to be undeployed from the Application list box and click Next as shown in the following figure The Application list box lists all the Web or mobile applications deployed to the selected Appeon Server Figure 12 8 Appeon Server Mode window x Application Undeployment Wizard Ea Deployment Profile Mode To undeploy the specified application from an Appeon Server select the Appeon Server that your application is deployed to and the application you want to undeploy Undeploy from a Specified Appeon Server Appeon Server JEE EE Application pet_world Step 4 Select the Appeon Server s or Web Server s that are intended for undeployment as shown in the following figure The Appeon Server s and Web Server s defined in the default deployment profile are listed Click Next to continue Appeon Developer User Guide Page 175 Undeploying Appeon Applications Appeon for PowerBuilder 2013 Figure 12 9 Ready to Undeploy Application window X Application Undeployment Wizard Confirm Appeon Servers and Web Servers Application Confirm Appeon Server for Undeployment Undeploy Appeon Server Local Appeon Server lt Confirm Web Server for Undeployment Undeploy Web Server Local Web Server Step 5 Click Undeploy to confirm the undeployment settings and start the undeployment process as shown in the following figur
203. ring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 29 Database Type configuration Q Database Type Profile Configuration xa For each database type used in your application s you must provide an ODBC or Native Interface connection to a database of that type in order for Appeon Developer to connect to the data source during deployment You need only provide one connection to each type of database used in your application Database Settings Database Type Sybase ASA 8 9 10 11 12 Database Interface ODBC Interface Native Interface Syntax V Enclose table and column names in Quotes Outer Join Syntax ANSI T ODBC Interface Native Interface Data Source AppeonS ample v User ID Password ODBC Administrator Test Connection Cancel Step 3 Specify the information needed for setting up the database type profile Outer Join Syntax Specify how Appeon format the SQL syntax for outer joins you can select corresponding format from the drop down list in the Database Settings frame Regardless of the settings in PowerBuilder it is recommended to use ANSI as the outer join syntax format in Appeon ODBC Interface Select this option if you use an ODBC interface Specify the ODBC data source User ID and Password Table 4 8 ODBC interface settings Setting Instructions Data Source All the data sources configured in Windows ODBC Administrator are listed Select a prop
204. rned off 13 1 Activating Code Insight Click the Code Insight button aol in the Appeon Developer toolbar to launch Code Insight At the click of the Code Insight button an icon will appear in the status area of the task bar Code Insight has five status icons Table 13 2 Status of Code Insight _ Disabled Code Insight is disabled T Loading Code Insight is analyzing the default PBT and generating the supported and unsupported feature list based on the analysis result Appeon Developer User Guide Page 178 Developing with Code Insight Appeon for PowerBuilder 2013 Icon Status Description Off Code Insight is enabled but ineffective On Code Insight is enabled and effective in the current application Gray This icon appears anytime the PowerBuilder IDE loses focus even if Code Insight is disabled 13 1 1 Configuring Code Insight Before you can enable Code Insight for a PowerBuilder application you need to configure the PBT file of the desired application as the default PBT file You can also specify the Appeon feature sets and the feature types for which feature list will be displayed Step 1 Click on the icon of Code Insight and the status area icon menu pops up with three items Enable or Disable Config and Quit as shown in the following figure Figure 13 1 The status area icon menu Enable Config Selected Quit ma Step 2 Click Con
205. rt Enter the Web Server port number Note Do not enter an HTTPS port here even though the Web server is configured as an SSL Web server because Appeon Developer must use an HTTP port to connect with Web server However you can access the deployed application with the HTTPS port Local Server Settings Web Root Path Enter the home directory of the Web server for example for Apache the home directory is lt apache root gt htdocs for EAServer the home directory is C Program Files Sybase EAServer6 html for IIS the home directory is C Inetpub wwwroot for JBoss 5 the home directory is lt jboss5 root gt server lt instance name gt deploy for JBoss 7 the home directory is lt jboss7 root gt standalone deployments for WebLogic 8 the home directory is C bea user_projects domains appeon_domain applications for WebLogic 9 10 the home directory is C bea user_projects domains appeon_domain autodeploy for WebSphere the home directory is C I BM WebSphere6 AppServer installableApps for JEUS the home directory is lt jeus root gt webhome app_home Click the Browse button to select the home directory of the Web server Note For NetWeaver Application Servers specify any path and then deploy the War file in the NetWeaver s administrative console FTP File Transfer Settings FTP Port Appeon Developer User Guide Enter the FTP server port number The typical FTP port is po
206. rt 21 If you use a remote Web Server Appeon Developer will upload the files to Web Server using FTP protocol Note that Appeon Developer works as a passive FTP client when Page 49 Configuring Appeon Developer Appeon for PowerBuilder 2013 Property Instructions uploading files So you need to make sure that you are using passive FTP and the FTP data port and command port are configured properly in the firewall FTP Username Enter the username for FTP login If the FTP server offers anonymous access then the username should be anonymous FTP Password Enter the password for FTP login If no password is set for the FTP server or the FTP Username is anonymous leave this field blank File Compression Settings for War Jar Appeon Compression Select to use the Appeon compression method to compress the application files into WAR or JAR packages when deployed to JBoss WebSphere JEUS or WebLogic Web server JDK Compression Select to use the JDK compression method to compress the application files into WAR or JAR packages when deployed to JBoss WebSphere JEUS or WebLogic Web server Click Browse to specify the location of JDK 1 4 or above for example C j2sdk1 4 2_04 To ensure the most compatibility JDK compression is recommended for J2EE servers such as JBoss WebSphere JEUS and WebLogic After the profile configuration perform the following steps to m
207. rtcut to Web applications that are deployed to the default Appeon Server and Web Server Mobile applications will be run in the Appeon Workspace You can use the following two methods to run a Mobile application in Appeon Workspace e Accessing the mobile application in Appeon Workspace You can always run the Appeon Workspace and run a deployed mobile application there For detailed instructions refer to Appeon Workspace User Guide Launching the mobile application from the Appeon Developer Run button Run is a shortcut to mobile applications that are deployed to the default Appeon Server and Web Server As you can see from the above both the Web application and the mobile application can be run from the Appeon Developer Run button This section talks about this method in details 8 2 2 1 Launching applications from the Run button You can launch the application by clicking the Run button in the Appeon Developer toolbar Appeon Developer automatically remembers the URLs of the applications that are deployed to the default Appeon Server and Web Server To run an application from the Appeon Developer toolbar Step 1 Verify that the default Appeon Server and Web Server in the Server Profiles settings have been started Step 2 Click the Run button 4 on the Appeon Developer toolbar If more than one application is deployed the Run Application window is displayed as shown in the following figure prompting you to select which appl
208. rts on the Server Profiles tab page as shown in the following figure The upper part is for management of Appeon Server profiles while the lower part is for management of Web server profiles Appeon Developer User Guide Page 44 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 30 Server Profiles amp Appeon Developer Configuration x Application Profiles DB Type Profiles Server Profiles Deployment Profiles Data Source Profiles Appeon Server Configure the Appeon Servers used in your organization Default Profile Name Server Type Edit a Local Appeon Server NET Add Delete Web Server Configure your Web Servers for your Web or Mobile applications Default Profile Name Server Type Edit o Local Web Server Microsoft IIS Add Cancel 4 2 3 1 1 Default server profiles You can select an Appeon Server profile or a Web Server profile as the DEFAULT server profile on the Server Profiles tab page Appeon Developer s Run shortcut reads the default server profiles and lists the applications that are deployed to default server profiles enabling you to quickly access them Applications that are deployed to non default server profiles are not available in the shortcut For details about the shortcut refer to Chapter 8 Running Appeon Applications 4 2 3 1 2 Edit add or delete server profiles Two sets of Edit Add and Delete buttons are
209. s E Select AEM Settings E Specify Destination Folder E Packaging Process E Finish Ca eres ie Step 3 Select the Customize and Package Appeon Workspace radio button and click Next To package a deployment project that can install the app to servers follow detailed instructions in Packaging a deployment project To package an Xcode project for a native mobile app follow detailed instructions in Packaging a native mobile project Appeon Developer User Guide Page 160 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 41 Select package type Welcome Select Package Type E Configure Appeon Workspace E Select Application E Specify Destination Folder E Packaging Process E Finish Please select a package type Package a Deployment Project Package a Native Mobile Project nd Package Appeon Workspace EE Step 4 Customize Appeon Workspace according to your needs and then click Next Appeon Developer User Guide Page 161 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 42 Workspace parameters fa Appeon Application Package Wizard Welcome Select Package Type Configure Appeon Workspace E Select Application E Specify Destination Folder E Packaging Process E Finish Please customize the following Appeon Workspace settings to suit your needs Name Value Eg General Application Fe Language Xc
210. s UNIX Run the appeonserver sh file in the appeon bin folder for Linux example jboss 5 1 0GA appeon bin appeonserver sh JEUS Windows Select Start gt All Programs gt Appeon for PowerBuilder 2013 gt Appeon Server for JEUS gt Start JEUS UNIX Run the appeonserver sh file in the appeon bin folder for Linux example tmaxsoft JEUS6 0 appeon bin appeonserver sh EAServer Windows Select Windows Start gt All Programs gt Appeon for PowerBuilder 2013 gt Appeon Server for EAServer gt Start EAServer UNIX Run the appeonserverstart sh file in the appeon bin folder for Linux example JAGUAR appeon bin appeonserverstart sh You can run EAServer Appeon Server in different modes debug and normal using different Java runtime versions and different Java VMs For details on how to specify the mode options in the above syntax refer to the EAServer System Administration Guide Appeon Developer User Guide Page 8 Configuring Appeon Developer Appeon for PowerBuilder 2013 4 Configuring Appeon Developer The settings configured in Appeon Developer are critical they are used throughout the entire PowerBuilder to Web or PowerBuilder to Mobile process Appeon Developer settings determine which PowerBuilder application will be converted to the Web or to the Mobile and the manner in which it will be deployed Before you attempt to use any other functionality on the toolbar complete
211. s DLL OCX files text files etc you can specify them here and deploy them to the Web or the Mobile Or you can use the External File Packaging tool provided by Appeon to package the files and install them to the client For detailed instructions refer to Section 17 1 1 Packaging DLL OCX files Click Add File or Add Directory to add external files to the table Then select the Auto Register column if the file needs to be automatically registered after it is downloaded to the client If you choose not to automatically register a file you can register it manually after it is downloaded For more information about the external files refer to Deploy External Files Appeon Developer User Guide Page 18 Configuring Appeon Developer Appeon for PowerBuilder 2013 Figure 4 10 Select External files Appeon Developer Configuration Wizard Please select the external file s to be deployed with the Welcome application if there are any Click Next to proceed Configure basic settings Auto Register File Name Select PBL files Configure deployment settings Select DB types Declare transaction object s Select image files Select INI files Deploy External Files Add File Add Directory Delete E Summary 4 1 9 Summary Review the settings Click Finish to complete the configuration If the Deploy the application now option is selected the Appeon Deployment Wizard will be launched for y
212. select an orientation for the application in the Orientation dropdown list box By default if you have selected Appeon Emulator iPad as the project loader the landscape orientation is automatically selected and if you have selected the Appeon Emulator iPhone as the project loader the portrait orientation is automatically selected Step 5 Click Run Appeon Developer User Guide Page 109 Running Appeon Applications Appeon for PowerBuilder 2013 e For Web applications it will be automatically loaded in the IE browser e For mobile applications it will be automatically loaded in the Appeon Workspace Emulator which is Appeon Workspace running on the Windows platform 8 2 2 2 Selecting a run mode Note This is for the Web application only When you run a Web application for the first time a run mode selection page will be displayed if you have enabled the Allow user to select run mode option in AEM see Appeon Server Configuration Guide for details This page allows you to select from the following run modes as shown in the following figure e Run Now The application runs immediately and files will be downloaded only when used This mode is recommended for high speed network e Run After Download Files will be downloaded before the application runs This mode is recommended for low speed network You can also set a run mode to be the default mode in AEM see Appeon Server Configuration Guide for details Figure
213. settings ccceeeesccceeeeeeeeeeseeeeeeeeeeeeeeeeeeeeeeeee 99 8 1 3 Language setting requirements ceeeeeeeeeeeeeeeeeeeeeeeeeeseeeeeeees 106 8 1 4 Disabling anti POP UP software 0 ec eeeeeeeeeeeeeeteeeeeeeeeeeeetteeeeees 107 8 2 Accessing Appeon applications ccccceceeeeeeeeeeeeneeeeeeeeeeeeeteeeeeeeeeeenees 107 8 2 1 URLs for Appeon applications cccccceeeeeeeeeeeeeeeeeeeeeteeeeeeeteees 107 8 2 2 Running Appeon applications cccccceeeeeeeeeeeeeeeeeeeeteeeeeeeteee 108 8 2 2 1 Launching applications from the Run button 00 108 8 2 2 2 Selecting a run MOE eee eeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 110 8 3 Appeon DataWindow Menu ccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeennaeeeeeeeeeeees 111 8 3 1 Enabling Appeon DataWindow menu sssssseessssssseeeesseerrrrnssssrrre 111 8 3 2 Using Appeon DataWindow Menu ccceeeeeeeeeeeeeeeeeteeeeeeeeeeees 111 8 3 2 1 FINA eae aE eE a E a A tte beetle aED 111 8 3 2 2 Sort and filter oo cece E E 112 8 3 2 3 DataWindow printing ccccccceeceeeeeeeeeeeeeeeeeeeeeeeeeeeneneeaees 115 8 3 2 4 SaveAs Obsolete 220 cccc ec ceetces co eete ee eeaceeadiecdec nde 116 8 3 2 5 Additional Enhanced Features cccccccesseeeeeeeeeeeeeeeeeeees 117 9 Launching Appeon Workspace Emulator cccccccceeeeeeeeeeseeeeeeeeeeeeeeeeeeneeeees 119 10 Using Information Manager ccccceccceee
214. settings to tweak the application s run time performance Performance Settings Parsing Options V Allow Deployment Wizard to rename the identifiers unsupported by JavaScript or XML Appeon Developer Logs Set the log writing mode for Deploy Log and Analysis Log You may view manage these logs in the Information Manager Off mode Summary mode Debug mode OK Cancel Command Line Arguments Appeon Developer User Guide Page 31 Configuring Appeon Developer Appeon for PowerBuilder 2013 If an application needs to use command line arguments enable the command line argument option as shown in the following figure Click Command Line Settings on the Misc Settings tab The Command Line Settings dialog box is displayed as shown in the following figure Figure 4 18 Command Line Settings dialog box 2E Command Line Settings Ss You can pass a command line argument to an Appeon application by appending the string to the application URL for example http eb4ppURL index htm ArgValue Launch Application from Developer Shortcut Show the argument input confirmation dialog Cancel e Require a command line argument for the application option Enables the command line argument option With this check box selected the following two options will be enabled Note that they are effective only if you run the application from the Appeon Developer toolbar e Show argument input c
215. shown in the following figure Avoid using the unsupported features Figure 13 6 Appeon unsupported features displayed in popup window ClassDefinition ClientEdge ColumnsPerPage ControlMenu TS bbe l l a TS Step 4 Select a supported property variable or method from the popup list You can use Code Insight to help develop an application free of unsupported features and suitable for migration Appeon Developer User Guide Page 183 Launching Appeon Enterprise Manager Appeon for PowerBuilder 2013 14 Launching Appeon Enterprise Manager Appeon Enterprise Manager AEM is a Web based application that manages the converted Web or mobile applications and Appeon Server over the Internet an intranet or an extranet It includes a comprehensive set of easy to use tools for system configuration system maintenance performance optimization and application security AEM is included when Appeon Server is installed AEM is accessible from any Client s Web browser or it is possible to access AEM through the AEM button that resides on the Appeon Developer toolbar Clicking the AEM button will automatically open a Web browser window and load the AEM entry page 14 1 Requirements Before launching AEM verify that 1 The Appeon Server hosting AEM has been started 2 You have correctly specified the host name and port of the Appeon Server in the Appeon Server Profile Configuration page 14 2 Launching Appeon Enterprise Man
216. sive HTML help system that contains e Introduction to Appeon e New Features Guide e Appeon Mobile Tutorials e Installation Guide for Appeon Mobile e Installation Guide for Appeon Web e Installation Guide for Cloud Platform e Development Guidelines for Appeon Mobile e Migration Guidelines for Appeon Web e Features Help for Appeon Mobile e Features Help for Appeon Web e Appeon Developer User Guide e Workarounds amp API Guide e Appeon Workspace User Guide e Appeon Server Configuration Guide for NET e Appeon Server Configuration Guide for J2EE e Web Server Configuration Guide e Troubleshooting e Appeon Performance Tuning Guide e Testing Appeon Web Applications with QTP Appeon for PowerBuilder Help is in compiled HTML format so that you can search by index or by typing keywords navigate back and forth or print a specified page To access Appeon HTML Help Step 1 Click the Help button D in the Appeon Developer toolbar Step 2 Click the corresponding help book to access the detailed help information as shown in the following figure Appeon Developer User Guide Page 188 Appeon for PowerBuilder Help Appeon for PowerBuilder 2013 Figure 16 1 Appeon for PowerBuilder Help i 2E e gt Hide Locate Back Forward Stop a f Refresh Home Print Options Contents Search Favores Introduction to Appeon New Features Guide ae Appeon Mobile Tutorials A Installation Guide for
217. skchceresernende 170 12 1 1 Undeploying with the Deployment Profile mode 00 171 12 1 2 Undeploying with the Appeon Server mode ccceeeeeeeeeeeees 174 13 Developing with Code Insight 2 0 0 0 eeeeccceeeeeeeeeeeeeeeeeeeeeeeaeeeeeeeeeeaeeeeeeeennees 178 13 1 Activating Code Insight 2282 2 cl eke eek eh ee RE oars nelnteeohennienens tbs 178 13 1 1 Configuring Code Insight dc oe ee eh ean erates 179 13 1 2 Enabling Code Insight scctecsccntice icewateccesdenae ss welnddcmdedecb sce teceep ances 181 13 2 Coding with Code Insight lt scies thee os ass eels Cale baa ai aes caele 182 14 Launching Appeon Enterprise Manager ccccccceececeeeeeeeeeeeeeeeeeeeeeeeeneneeeeees 184 14 1 Requirements cuits shaded tte una aeeie ae eE h ie Si le ie ot 184 14 2 Launching Appeon Enterprise Manager cccccceseeeeeeeeeeeeeeeenneeeees 184 15 Converting screen size between dots and PBUS ccceeesceeeeeeeeeeeeeeeeteees 186 16 Appeon for PowerBuilder Help cccesseeesesseeenesseeceesseeeeeeseseeeesessscestees 188 17 Extended TOOK Suess he ee he Mei teeter ie le ete Ne eee 190 17 1 DLL OCX Files Package Tool cccccceeeeeseseceeeeeeeeseeeeeeeeeeeesneeeeees 190 17 1 1 Packaging DLL OCX MleSscctetny Ae ea kh eG ede Aiea 190 17 1 2 Installing and uninstalling DLL OCX files eeeeeeeeereeeeee 194 17 1 2 1 Installing DEL OCX files wise cee cece ce esc enacted ies 194 17 1 2 2 Unins
218. solutions for issues such as unsupported features etc encountered when using Appeon for PowerBuilder e Appeon Workspace User Guide Gives a general introduction on Appeon Workspace and provides detailed instructions on how to use the app e Appeon Server Configuration Guide Provides instructions on how to configure Appeon Server Monitor establish connections between Appeon Servers and database servers and configure AEM for maintaining Appeon Server and Appeon deployed applications e Web Server Configuration Guide Describes configuration instructions for Web Servers to work with a single Appeon Server or an Appeon Server cluster e Troubleshooting Provides information on troubleshooting issues covering topics such as product installation application deployment AEM and Appeon application runtime issues e Appeon Performance Tuning Guide Provides instructions on how to modify a PowerBuilder application to achieve better performance from its corresponding Web mobile application Testing Appeon Web Applications with QTP Provides instructions on how to test Appeon Web applications with QTP 1 4 If you need help If you have any questions about this product or need assistance during the installation process access the Technical Support Web site at http www appeon com support Appeon Developer User Guide Page 3 Introduction Appeon for PowerBuilder 2013 2 Introduction Appeon Developer a component of Appeon for
219. space as the application s description after deployment Step 8 Click Next 4 1 2 Selecting PBL file s Specify the version and the location of the PowerBuilder application source code Figure 4 3 Select PBLs Appeon Developer Configuration Wizard Select the PBL files used in your application Welcome Configure basic settings PBT daia Keep PBT Updated E Configure deployment settings PBL Version PowerBuilder 11 5 A E Select DB types E Declare transaction object s eee E Select image files E Select INI files E E Deploy External Files 4 p E Summary You can add application PBLs using one of the following methods Method 1 Select the PBT file to automatically add the PBL files Details are as follows e Click the browse button to select the PBT file When a PBT file is selected all PBL files contained in the selected PBT are added to the PBL File List This is the recommended method to add PBLs as it reduces the likelihood of forgetting to add a required PBL Method 2 You can also add PBL files without specifying the workspace and PBT file first Appeon Developer User Guide Page 12 Configuring Appeon Developer Appeon for PowerBuilder 2013 e Click Add to add one or multiple PBL files This is the only method you can take when using the Configure tool Refer to Section 4 2 1 2 1 Basic Settings for detailed instructions Note Keep the Keep PBT Updated ch
220. t Click Select All to select all objects click Deselect All to deselect all objects or click Invert Selection to select all objects which were not selected and deselect the previously selected objects If the WSDL file service and port are not automatically specified for a proxy object follow the steps below to select them Step 1 Select the proxy object and click Configure The Configure dialog appears as shown in the following figure Figure 4 25 Configure dialog box 2E Configure achcheckverifysoap Ee Proxy Object achcheckverifysoap WSDL File Browse Service v Port v cancel Step 2 Click Browse to select a WSDL file on the local computer and then select the service and port A WSDL file may contain multiple services and each service may contain multiple ports Step 3 Click OK to save the configuration and return to the Web Service Profiles tab 4 2 1 2 6 Runtime Settings The Runtime Settings tab specifies 1 the company name and the application name that will be displayed on the Appeon Download Center when the Web application starts 2 the mobile application name icon and application description that will be displayed in Appeon Workspace 3 the device type on which the mobile application will run You can use any image with any size as the mobile application icon For better display quality we kindly recommend you to use the icons with 86 x 86 pixels for devices with relatively low resolu
221. t nor be located with the Run To Cursor or Set Next Statement commands in the debugger 7 2 Introduction to the debugging procedure Although Appeon Debugger is used for debugging the JavaScript in the deployed application breakpoints are not set in the JavaScript but directly in the PowerBuilder code loaded in the Appeon Debugger Source view The generated JavaScript is invisible throughout the entire process however the results shown in the Watch view are the execution results of the JavaScript The debugger procedure with Appeon Debugger is the typical 5 step procedure as with PowerBuilder Debugger Step 1 Start the debugger Step 2 Set breakpoints Step 3 Run the application in debug mode Step 4 Examine the application at the breakpoints by watching variables and expressions and monitoring the call stack You may also step through the application after a breakpoint to closely examine the effects of each code Step 5 Fix the code The actions performed in each step are not very different from those required in PowerBuilder Debugger However there are some special requirements related with the actions and the action results are from the running of JavaScript Continue reading the following sections for detailed descriptions of these debugging steps 7 3 Starting Appeon Debugger To start Appeon Debugger Step 1 Close the other Appeon Developer tools Step 2 Start Appeon Server and the Web server that host the Web appl
222. t need to be registered Register File Name Appeon Developer User Guide Page 192 Extended Toolkit Appeon for PowerBuilder 2013 Step 4 Specify the location where the package will be created A folder named Package will be created under this location Figure 17 4 Specify the package location Specify Package Location Specify the directory where the DLL OCX package will reside Specify Package Location C Program FilesAppeonappeontest Step 5 Review the settings and click Next to generate the package Figure 17 5 Review settings Review Settings Click Next to begin packaging files If you want to review or change any settings click Back Current Settings Application Name pet_world Package Location C Program Files 4ppeon appeontest BLL OCX Information Register DBLL OC files No C Windows systemavifile dll No C Windows system avicap dll Appeon Developer User Guide Page 193 Extended Toolkit Appeon for PowerBuilder 2013 Step 6 Wait until the file packaging process is complete Step 7 When packaging is complete click Finish to close the wizard To view the log information generated during the process select the View Log box and then click Finish The log file will be automatically opened You can also manually open the DLLOCX log file in the generated package Figure 17 6 Packaging complete Review Settings Click Next to begin packaging files If y
223. t view is 320 pixels and the width in Landscape view for iPhone 4 4S is 480 and for iPhone 5 is 568 pixels Important Notes 1 Keep the banner height as 248 pixels for iPad and 124 pixels for iPhone and the width same as the device screen 2 There are different widths for portrait and for landscape on a device if your workspace supports both orientations 3 Pay attention to the compatibilities of the related JavaScript Adding and customizing UI language packages The workspace UI can be displayed in English French Simplified Chinese Traditional Chinese Japanese Korean Italian and Spanish To add the other language packages to Appeon Workspace 1 Navigate to Appeon Developer2013 AppTemplate iOS AppeonWS bundle config Aws under the Appeon Developer installation directory and open the languages xml file in a text editor and uncomment the line of script that corresponds to the language you want to add It is recommended that you back up this file before modifying it For example to add the support for German find the corresponding line of script or add it if it is not pre defined and then remove the comment as shown below lt lang code de name Deutsch c gt The value of code must be used as the name of the language file in the next step The value of name will be displayed in the Language tool of Appeon Workspace Appeon Developer User Guide Page 164 Packaging Applications Appeon for PowerB
224. talling DLL OCX files 20 0 0 e eee ceeeeeeeeeeeeeeeeeeeeeeeeeteees 197 17 2 Appeon Silent Installer Windows EAServer only eeeceeeeeeeeeees 199 17 2 1 Creating folder structure of Silent Installer cc eee 199 17 2 2 Copying installation program of EAServer Appeon Server Appeon Server EBF or Appeon applications eeeeeeeeseeeeeeeeteees 201 17 2 3 Customizing configuration file ccccceeeeeeeeeeeeeeeeeeeeeneeeeeeeeeees 201 17 2 3 1 Installation TYPOS nckccdetecn thse leeedeelendchaakeuevbecenoccndadtetbcetagne 202 17 2 3 2 EAServer and ASA Path os ccc cecetce vets tess eats hte ee cece 202 17 2 3 3 EAServer Host Name Port Username and Password 203 17 2 3 4 Appeon Server Port Username and Password 5 204 17 2 3 5 Web Server Path cic ct ss ctl ccendedaal catthentpcnancdendecneunve sce tateene 204 17 2 3 6 Setup Log Path ratte cree tits eek i ik el a hee ate 205 17 2 3 7 Web Applications ccccceecceeeeeeeeeeeeeeeeeeeeeseeeeeeeeeeeeeees 205 17 2 3 8 Web Application Uninstall Program Path 00 0 e 206 17 2 3 9 Resource Language cccecssseeeeeeeeeeneeeeeeeeeeeeeeeeeeees 207 17 2 3 10 Silentinstall txt example ccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeees 207 17 2 4 Burning installation CDS 20 0 0 ee eee ceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaeees 209 17 2 5 Running Appeon Silent Installer for End Users 210 17
225. ted you can start copying the installation program files of Appeon Server EAServer and Appeon applications to the corresponding folder To copy the EAServer installation program to Appeon Silent Installer Copy all files and folders from the directory where setup exe file resides to the EAServer folder of Appeon Silent Installer To copy the Appeon Server installation program to Appeon Silent Installer Copy all files from the ASP folder on the Appeon installation CD to the AS folder of Appeon Silent Installer To copy the Appeon Server EBF installation program to Appeon Silent Installer Copy all files from the asebf folder on the Appeon installation CD to the AS EBF folder of Appeon Silent Installer To copy Web application packages to Appeon Silent Installer Step 1 Verify that the Web application packages have already been generated using the Appeon application packaging tool If no package is generated follow steps in Section 11 1 Packaging a deployment project in the Packaging a deployment project chapter Step 2 Copy the generated packages to the WebApp folder of Appeon Silent Installer 17 2 3 Customizing configuration file With Appeon Silent Installer you can customize the installation program using the configuration file SilentInstall txt The following is a detailed description of each parameter in the SilentInstall txt file Each parameter contains no default value Appeon Developer User Gu
226. tfuncs of_popmenuon that are defined in the Appeon Workarounds PBL For detailed instructions on how to use these functions in a DataWindow refer to AppeonExtFuncs object in the Workarounds amp API Guide 8 3 2 Using Appeon DataWindow Menu Appeon DataWindows menu have the following features Find Find Next Find Previous Sort Filter Print and Save As File Obsolete Perform the following steps to use the menu in the Web DataWindows 8 3 2 1 Find The user can search for data using the Find Find Next and Find Previous functions Step 1 Right click the Web DataWindow and select Find from the popup menu as shown in the following figure Appeon Developer User Guide Page 111 Running Appeon Applications Appeon for PowerBuilder 2013 Figure 8 11 Find DataWindow Department Name State Employee Employee Emp ID Last Name First Finance MA 148 Jordan Julie Finance MA 390 Davidson JoAnn Finance MA Find Next Denis Finance MA f i Kristen Finance MA SURI Mary Anr Finance MA Sort Janet Finance MA Filter Jennifer Finance MA John Marketing MA Print Melissa Marketing MA Save As File Jane Marketing MA 318 Crow John Marketing MA 409 Weaver Bruce Marketing MA 591 Barletta lrene ri am r Step 2 Select the column and search scope and input criteria for the search Use the Find function to find all rows where the orders count column is equal to 2 as shown in the following figure Figure 8 12
227. that could be inserted the Code Insight feature list pops up for you to select a supported property variable or method as shown in the following figure Figure 13 5 Develop an application with Code Insight AppeonDemo PowerBuilder File Edit View Insert Format Design Run Tools Window Help nie e Alae Seanagal n RRA k l a 9 S a o ZE x OSH eas oHaxw oor t s E a Taral yi BIU amp 3 E 97 e A xl E w_logon sales_application_demo C Users Public Documents Appeon Developer 6 AppeonDemo SalesApplicationDemo sales_main pbl inherited from window W gt E J z 7 E Script open for w Jogon returns long Dy x Properties w_logon inherited from window of x mulogon open returns long pbm_open EJE senera scroli Toolbar other this S activate 3 animationtime E arrangesheets arrangetypes arrangetype sbackcolor EZborder E bringtotop E cb_1 GBeb_2 center ClientEdge ContextHelp R Transparency 0 OpenAnimation e Layouthopen Event List Function List Declare Instance Variables A Properties Control List Non Visual Object List Ready 0001 0006 Nothing Selected Appeon Developer User Guide Page 182 Developing with Code Insight Appeon for PowerBuilder 2013 The unsupported properties variables or methods in the popup list will have a red icon in front as
228. the following tasks 1 Set up an application profile for each of the PowerBuilder applications intended for conversion Each application profile tells Appeon Developer important information about the application such as which PBLs compose the PowerBuilder application the database type etc During the application profile setup set up a profile for the database type used by the application This enables Appeon Developer to generate the correct database syntax 2 Set up at least one Appeon Server profile and one Web Server profile This enables Appeon Developer to utilize the Appeon Server and Web Server for deployment 3 Set up at least one deployment profile which links at least one Appeon Server and one Web Server together This tells Appeon Developer where to deploy the Web or the mobile application Appeon provides a Config Wizard 3 to quickly configure an application With your specifications the wizard creates the application profile database type profile Appeon Server profile Web server profile data source profile and transaction object mapping After creation all these profiles can be modified in the Configure tool 28 Besides modifying the above profile settings the Configure tool provides you with advanced settings such as performance settings parsing options Web Services profiles runtime settings etc 4 1 Using Appeon Developer Configuration Wizard The settings in Appeon Developer Configuration Wizard are th
229. the source code of the event or function which contains the unsupported feature This button is available only if the unsupported code resides in an event or function and it is not DataWindow related e Edit Source Displays all source code of the object which contains the unsupported feature This button is always available The PowerBuilder Script view automatically opens as shown in the following figure Appeon Developer User Guide Page 69 Using UFA Tool Appeon for PowerBuilder 2013 Figure 5 7 Unsupported code in the PowerBuilder painter Edit iew Insert Format Design Run Tools Window Help E SS DRARBRSD SH mw i g ql X K k ASG SZ MHMXK WFR Ori Be gt 5 o BR x i818 CLV AE 2 Gt hy ee lei T Tahoma 10 B IU a 4 x UnsupportTool C Program Fil E UnsupportTool C Pro 7 ufa pbi c program fie v Sopen returns long pbm_ v General Scroll Toolbar Other ufa G Properties ao Title E Events Pipeline Ipl_temp Daed O Functions a E Structures p _temp create Pipeline Tag w_ufa a Properties sle_ text Ip _temp CLassName MenuName Events G Functions V Visible G Structures W Enabled Controls TitleBar ControlMenu MaxBox W MinBox ClientEdge l lt Jj ar a Event List Function List Declare Instance Variables 4 Properties Control List Non Visua_
230. tion directory The DLL OCX File Packaging Wizard starts as shown in the following figure Click Next to proceed Appeon Developer User Guide Page 190 Extended Toolkit Appeon for PowerBuilder 2013 Figure 17 1 DLL OCX File Packaging Wizard This wizard will help you package DLL OC files for distribution Click Next to proceed Step 2 Select an application and click Next Only application profiles that are already configured with DLL OCX files will be listed For configuring DLL OCX files for an application profile refer to Deploy External Files When Next is clicked the pre configured DLL OCX files will be automatically added for you Or skip the selection and click Next to manually add the DLL OCX files Appeon Developer User Guide Page 191 Extended Toolkit Appeon for PowerBuilder 2013 Specify Application Select the application of which DLL OCX files need to be packaged Note the application must be configured to deploy with DLL OC files in 4ppeon Developer Configuration Note you can skip this step and go to the next step directly Step 3 Click Add to add the DLL OCX files select the Register box to automatically register the file when installed and click Next to proceed The DLL OCX files will be automatically added if you select the application of which files are already configured in the previous step Specify DLL OCX Files Add DLL OCX files for packing and select files tha
231. tions such as iPad 2 and 172 x 172 pixels for devices with high resolution such as iPad 4 Icons smaller than the above recommended will be automatically stretched to the proper size for the corresponding devices and icons larger than the above recommended will be automatically compressed to the proper size for the corresponding Appeon Developer User Guide Page 39 Configuring Appeon Developer Appeon for PowerBuilder 2013 devices Therefore for convenience you can always use the one with 172 x 172 pixels or larger for any application The supported formats are PNG recommended GIF JPG BMP and ICO Figure 4 26 Runtime Settings dialog box amp Application Profile Configuration an Basic Settings i DB Settings Additional Files Mise Settings i Web Service Profiles Runtime Settings Summary Web App Settings You can customize the company and application names displayed when application files are being downloaded Company Name Application Name Appeon Web Application Mobile App Settings You can specify the application name icon and description displayed in the Appeon Workspace Device Type Both Mobile pp Name Sales pp Demo Mobile App Icon C Users Public D ocuments 4ppeon Developer201 3 appeor Browse Mobile App Description 4 sales app that tracks customers orders and product information Cancel 4 2 1 2 7 Summary The Summary tab offers a summary view of
232. tions Appeon Server opens and Connection pools on startup Pool Size Minimum Specify the minimum number of connections Appeon Server opens and Connection pools on startup Pool Size Connection Specify the timeout period for the connection Timeout Command Specify the timeout period for the commands Timeout Connection Specify the lifetime period for the pooled connection Lifetime To be specific you can specify the timeout period from the time a connection is created to the time when the connection returns to the pool If the actual lifetime of a connection exceeds that specified in Connection Lifetime the connection will be terminated It is recommended to be used in cluster configuration when forcing the load balancing between a running server and a server just brought online If the value is set to 0 the pooled connection allows the maximum connection timeout Other Options Specify the connection_authentication property for ASA database The value should be authentic_code authentic_code is the key word text after should be the authorization code Appeon Server will automatically set the connection_authentication property when connecting with the ASA database This setting is effective to ASA database only Dynamic Select whether to enable dynamic database connection pees When it is on the LogID and LogPass of the Transaction object will pnhnecnon be used to connect to the database when it is o
233. ty feature are configured in AEM The password can be left blank if the deployment security feature is turned off in AEM After profile configuration perform the following steps to make sure the Appeon Server profile can be successfully used for application deployments e Check whether the deployment security settings are configured correctly The username and password in the deployment security settings must be the same as those configured in AEM Make sure you get the correct deployment username and password from the AEM administrator Appeon Developer User Guide Page 47 Configuring Appeon Developer Appeon for PowerBuilder 2013 Test Appeon Server settings by clicking the Test Appeon Server Settings button Do NOT proceed to the next step until the testing succeeds 4 2 3 3 Web Server profile settings Before you edit or add a Web Server profile make sure the Web Server specified in the profile is running and that the Appeon Developer computer can successfully connect to the Web Server computer The following figure shows the Web Server Profile Configuration window that displays when you click the Edit or Add button in the Web Server group box of the Server Profiles tab page Figure 4 32 Web Server profile configuration window Q Web Server Profile Configuration xa Profile Settings Web Server Settings Profile Name Local Web Server Server Type Microsoft IIS z File Transfer Type Local
234. uide Page 165 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 44 Select apps to be packaged with your Workspace Fil Appeon Application Package Wizard Welcome Select Package Type Configure Appeon Workspace Select Application E Specify Destination Folder E Packaging Process E Finish Please select the application s to package Only applications that have been deployed will be listed below for selection App Name codeexamples acf sapteched order Step 6 Specify the storage location for the generated package and click Next The generated package will be stored under a folder named Display Name_install under the specified location Appeon Developer User Guide Page 166 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 45 Specify the directory Appeon Application Package Wizard The package tool will create a folder named Display Name_install to store the packaged Welcome application Select Package Type Display Name sales Configure Appeon Workspace Specify the directory where the install folder will reside Select Application Specity Destination Folder E Packaging Process E Finish Eza Step 7 Wait until the package process is complete Click Next when the package process is complete Appeon Developer User Guide Page 167 Packaging Applications Appeon for PowerBuilder 2013 Fig
235. uilder 2013 2 Make a copy of an existing language file under Appeon Developer2013 AppTemplate iOS AppeonWS bundle config Aws lang put the copy under the same directory and name the copy after the value of code Take German for example the language file must be named as de xml Then open the file and translate the content into the language you want to add 3 In the Package tool click the button in the Default Language field The language you added will be displayed for selection Make sure the Selected check box of the language is checked Figure 11 43 Language Fi Appeon Application Package Wizard Please customize the following wee Language er ez reess Select Package Typ Configure Appeon V E Select Application E Specify Destination E Packaging Process E Finish In addition you can customize the UI text by editing the language file under Appeon Developer2013 AppTemplate iOS AppeonWS bundle config Aws lang For example you can open en xml and change the text id 1 from Appeon Workspace to ABC Workspace so ABC Workspace will display in the center of workspace titlebar instead of Appeon Workspace Step 5 Optional Select the apps you want to package into the workspace and specify the corresponding URLs The apps deployed in Appeon Developer are listed by default and multiple apps can be selected Appeon Developer User G
236. upported features of the specified priorities 5 2 2 5 Specifying report display level You can quickly expand or collapse a node of the unsupported feature list treeview by selecting Expand Sub node or Collapse Sub node from the Edit menu or from the popup menu on any node You can also specify the display level using the following steps Step 1 Select the Edit gt Display Level menu Step 2 In the Display Level box enter the number of the level at which the unsupported feature list treeview will display Figure 5 13 Display Level Display Level Exes Select hierarchical level of the tree view display Cancel Step 3 Click OK The UFA Report only displays unsupported features of the specified level Appeon Developer User Guide Page 74 Using UFA Tool Appeon for PowerBuilder 2013 5 2 2 6 Defining the priority settings of unsupported features By default Appeon divides all unsupported features into three priority levels e Have to modify The features flagged with Have to modify are important in the application and will cause significant functionality loss if they are not modified or worked around e Suggest to modify The features flagged with Suggest to modify will not necessarily cause functionality loss if they are not modified or worked around You can decide whether to modify them according to their functionalities in the application e Can be ignored The features flagged with Can be ignored are
237. ure 11 46 Packaging process Appeon Application Package Wizard Please wait while the packaging tool performs the requested operation This may take several Welcome minutes Select Package Type Run Information Configure Appeon Workspace Select Application Specity Destination Folder Packaging Process kk lt E Finish lt Back Next gt Cancel Finish Step 8 Click Finish Appeon Developer User Guide Page 168 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 47 Package complete Appeon Application Package Wizard xs Finished packaging the application Welcome Select Package Type Wl Miew Package Log Configure Appeon Workspace The package wizard has finished packaging the application Select Application Click Finish to exit the wizard Specity Destination Folder To compile the package into an IPA file and distribute it to others please follow instructions in Packaging Process E EE F Tutorial 4 Package Distribute Native Mobile Apps Finish lt Back Next gt Cancel Step 9 Go to the folder Display Name_install under the specified location you will find the following two zip files Copy them to the Mac machine e Display Name zip the zip package of the workspace e AppeonMobile framework zip the mobile client library Then follow the instructions in Package amp Distribute Native Mobile Apps in Appeon Mobile Tutor
238. ures Analysis Report check box Description Select the types of objects or files that will be uploaded to servers DataWindow objects other objects INI files external DLL OCX files or image files By default all objects and files will be uploaded This button is effective only for the Deploy Already Generated Application option When use this function verify that the target servers are the same ones used in the application deployments Specify whether to generate an unsupported feature analysis report during deployment This report lists all unsupported PowerBuilder coding features in the application You can use this report to remove or work around the unsupported features For detailed instructions refer to Section 5 2 Working with UFA Report 6 2 2 1 Selecting the deployment mode The following table describes the three different deployment modes and guides you in choosing the proper deployment mode Table 6 5 Deployment mode Deployment What It Does Elapsed Time When To Use It Mode Full Exports all PowerBuilder Depends on 1 The first time an deployment application objects and code the size and application is deployed generates the corresponding complexity of to the Web or to files for the Web or mobile the PowerBuilder mobile lication and depl l fil lication eee 2 After making changes to any ESQL Incremental Exports objects re generates Up to 80 less After m
239. us step are listed Click Next to continue Appeon Developer User Guide Page 172 Undeploying Appeon Applications Appeon for PowerBuilder 2013 Figure 12 4 Confirm Appeon Servers and Web Servers Confirm Appeon Servers and Web Servers Application sales_application_demo Confirm Appeon Server for Undeployment Undeploy Appeon Server Local Appeon Server lt Confirm Web Server for Undeployment Undeploy Web Server T Local Web Server Step 5 Click Undeploy to confirm the undeployment settings and start the undeployment process as shown in the following figure Figure 12 5 Confirm undeployment settings X Application Undeployment Wizard Ready to Undeploy Application Click Undeploy to begin undeploying the application If you want to review or change any settings click Back Current Settings Undeployment Mode amp Deployment Profile amp Deployment Profile Application sales_application_demo amp Deployment Profile Local Deployment Appeon Servers and Web Servers Appeon Server Local Anpeon Server TT The undeployment process begins as shown in the following figure Step 6 Click Finish to close the dialog box Appeon Developer User Guide Page 173 Undeploying Appeon Applications Appeon for PowerBuilder 2013 Figure 12 6 Undeployment in Progress x Application Undeployrent Wizard e Undeployment Status Informati
240. ver for storing the files when the application is deployed Step 3 Select a project type from the Project Type dropdown list box Select Mobile if you intend to deploy your PowerBuilder application to mobile devices select Web if you intend to deploy your PowerBuilder application to the Web select Universal if you intend to deploy your PowerBuilder application to both the Web and Mobile Step 4 For mobile apps Select a device type from the Device Type dropdown list box Tablet Smartphone and Both are listed for choices For applications that are designed for tablets select Tablet for applications that are designed for smartphones select Smartphone for applications that are designed for both devices select Both Step 5 For mobile apps Enter an app name in the Mobile App Name text box The mobile app name specified will be displayed in the Appeon Workspace home screen after the application is deployed to the Appeon Workspace Step 6 For mobile apps Specify an icon for your mobile applications by clicking the Browse button Appeon Developer User Guide Page 11 Configuring Appeon Developer Appeon for PowerBuilder 2013 The icon specified will be displayed on the Appeon Workspace home screen after your application is deployed to Appeon Workspace Step 7 For mobile apps Enter a brief description in the Mobile App Description text box The description will be displayed on the home screen of Appeon Work
241. w Mode Identical to the current mode the application profile is set to in the Appeon Developer Configuration window It is recommended that the packaged applications should be available in Release mode as this mode prevents most forms of reverse engineering and like application packaging it protects the author s intellectual property Device Type Identical to the current device type settings in the Appeon Developer Configuration window Step 5 Specify the parameters for the app and then click Next Appeon Developer User Guide Page 154 Packaging Applications Appeon for PowerBuilder 2013 Figure 11 36 Configure app parameters Hj Appeon Application Package Wizard Please specify the app settings Welcome Name Value enera Titlebar icons E Xcode iOS Select Package Type Select Application Configure App Settings E Specify Destination Folder E Packaging Process E Finish See the following table for details on each parameter Table 11 3 App parameters Group Value Description General App Name Specify the name of your app that will appear on the App Store For the name to display completely it should be about 12 letters but it depends on the width of each individual letter for example w takes more room than i The App Name will also be used as name of the generated package App Description Provide the description of your app that will appear in the
242. wing figure represents the user interface of the Appeon Developer toolbar Figure 2 2 Appeon Developer toolbar Aste ESATE RESIES ILA The Appeon Developer toolbar has 15 buttons The following table describes the functionality of each button Appeon Developer User Guide Page 4 Introduction Appeon for PowerBuilder 2013 Table 2 1 Appeon Developer toolbar functions Button Name Function E3 Config Wizard Provides a wizard for quick configuration of Appeon Developer for Web or mobile conversion gt t Configure Sets configurations of Appeon Developer for Web or mobile conversion ad or Analyze Analyzes application source code for unsupported features before deployment This analysis can cover the whole application at object level or within an inheritance hierarchy It displays as in PowerBuilder 11 5 Code Insight Develops PowerBuilder applications that are free of Appeon unsupported features E Deploy Starts the complete process of deploying a PowerBuilder application to the Web or Mobile Zs Run Runs the deployed Web application in Internet Explorer or the deployed mobile application in Appeon Workspace Emulator U Appeon Debugs Appeon applications Debugger Information Manages logs and reports Package Packages Appeon application files for installation x Undeploy Undeploys Web or mobile applications from Web Server s and Appeon Server s ye AEM Launches Appeon Enterprise M
243. xample if you use EAServer as the Appeon Server and EAServer HTTP Server as the Web server you only need to start the EAServer Appeon Server Otherwise start both the Web server and Appeon Server Refer to the documents provided by the Web server vender for how to start the Web server and refer to the following instructions to start the Appeon Server Appeon Developer User Guide Page 7 Before You Begin Appeon for PowerBuilder 2013 Table 3 1 How to start Appeon Server Appeon Operating Detailed Instructions Server System NET Windows Select Start gt All Programs gt Appeon for PowerBuilder 2013 gt Appeon Server for NET gt ITS Manager WebLogic Windows Select Windows Start gt All Programs gt Appeon for PowerBuilder 2013 gt Appeon Server for WebLogic gt Instances gt InstanceName gt Start WebLogic UNIX Run the appeonserver sh file in the appeon bin folder for Linux example BEA_HOME user_projects domains mydomain appeon bin appeonserver sh WebSphere Windows Select Windows Start gt All Programs gt Appeon for PowerBuilder 2013 gt Appeon Server for WebSphere gt Start WebSphere UNIX Run the appeonserver sh file in the appeon bin folder for Linux example WebSphere A ppServer appeon bin appeonserver sh JBoss Windows Select Start gt All Programs gt Appeon for PowerBuilder 2013 gt Appeon Server for JBoss gt Instances gt InstanceName gt Start JBos
244. xample Language EN 17 2 3 10 Silentinstall txt example The following example shows a sample SilentInstall txt file FEFE FE EE HEE EE EEE HH HE E TE FE EE EE FE HE EE FE HE E EE EE EE EE ERE E E EEE EE E E E E E E E HH E E EE HEH Configure installation type Yes or No HT HE FE AE FE HH EH AE FE FE FE EH EE a EEE EE aE EEE EAServer Yes Appeon Server Yes Appeon Server EBF Yes WebApplication Yes HEHEHE EE HE FE AE FE EE HHH HEHE HH THEE FE HEE HE HEHE EE HERE EE E E E EH E E E E E RE Enter the path of the EAServer installed or you want to install HT HE EHH HHH EH AE FE HE HE EE EE EEE EAServerPath C Program Files Sybase EAServer HT HHT EHH HHH EH AE FE FE HE FE E FE AE FE EE EEE Enter the ASA path HT HHT EHH HHH EHH FE AE FE EE Ea EEE Appeon Developer User Guide Page 207 Extended Toolkit Appeon for PowerBuilder 2013 ASAPath C Program Files Sybase Shared ASA802 HERE RHEE EEE HH EE HE HE HH EE HH EH HE EH HE EH HH FE HE HH HEE HE HE HE HE BE HE EE Enter the Port Username and Password of EHAServer FE FE FE FE FE FE FE FE FE FE FE FE HE FE FE FE FE FE FE FE FE EEE HEE HE EEE HEE HE EEE HEE HEE HEE HEE HEHE HEH HEH EAServerName localhost EAServerPort 9000 EAServerUserName jagadmin BASS Wei PASEMNOLTC HY AE AE E AE AE E FE AE AE AE E FE AE FE AE AE E FE AE AE AE AE FE AE E AE AE E FE E E AE E FE AE E AE AE E FE AE E AE AE FE AE E AE
245. y you need to modify the Windows registration table after the installation of the Microsoft script debugger For 64 bit machines follow the steps below 1 Go tt HKEY_LOCAL_MACHINE SOFTWARE Wow6432Node Microsoft Internet Explorer Main 2 Add one DWORD value TabProcGrowth 0 For 32 bit machines follow the steps below 1 Go to HKEY_LOCAL_MACHINE SOFTWARE Microsoft Internet Explorer Main 2 Add one DWORD value TabProcGrowth 0 Enable the script debugging option Simply uncheck the Disable script Debugging checkbox under the Advanced Internet Options menu Appeon Developer User Guide Page 89 Debugging Appeon Web Applications Appeon for PowerBuilder 2013 For detailed instructions and solutions refer to the Appeon Debugger section in the Appeon Troubleshooting Guide 2 A script in the deployed application must meet all of the following requirements to be debugged otherwise Appeon Debugger will simply ignore it e The script is deployed in the Debug JS or Debug PS JS mode using the local Appeon Developer If you have changed the application PBLs or the local application files and the remote application files are not the same you must re deploy the application Or the newly added code will not be selectable in Appeon Debugger e The original PowerScript code of the script is supported by Appeon If the code is unsupported it is marked with a icon in the Appeon Debugger Source view and cannot be set as breakpoin
246. ysis Appeon Developer User Guide Page 62 Using UFA Tool Appeon for PowerBuilder 2013 Menu Description Opens or saves a UFA report See Section 5 2 2 1 Opening or saving a UFA Report Edit Opens and modifies the unsupported source code in the PowerBuilder painter See Section 5 2 1 Modifying unsupported features Searches for the unsupported features See Section 5 2 2 3 Searching for UFA Report items Filters the unsupported features according to objects unsupported feature types or priorities See Section 5 2 2 4 Filtering UFA Report items Expands or collapses treeview Displays the report in the specified level See Section 5 2 2 5 Specifying report display level View Selects a display mode of the objects in the Unsupported Feature List treeview See Section 5 2 2 2 Selecting report view mode Tools Accesses the workaround for the selected unsupported feature Defines the priority settings of UFA Report items See Section 5 2 2 6 Defining the priority settings of unsupported features Customizes the general settings of the UFA Report See Section 5 2 2 7 Customizing the general settings of the UFA Report Help Provides the version number of the UFA tool 5 1 3 Performing feature analysis There are two ways to perform a feature analysis of an application e Use the Unsupported Features Analysis tool

Appeon Developer User Guide - Appeon for PowerBuilder 2013

Contents

Download Pdf Manuals

Related Search

Related Contents