Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Appeon Developer User Guide Appeon® 6.5.1 for PowerBuilder® FOR WINDOWS & UNIX

Appeon Developer User Guide Appeon® 6.5.1 for PowerBuilder® FOR WINDOWS & UNIX & LINUX DOCUMENT ID: DC20238-01-0651-01 LAST REVISED: December 29, 2011 Copyright © 2000-2011 by Appeon Corporation. All rights reserved. This publication pertains to Appeon software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Appeon Corporation. Appeon, the Appeon logo, Appeon Developer, Appeon Enterprise Manager, AEM, Appeon Server and Appeon Server Web Component are registered trademarks of Appeon Corporation. Sybase, Adaptive Server Anywhere, Adaptive Server Enterprise, iAnywhere, PowerBuilder, Sybase Central, and Sybase jConnect for JDBC are trademarks or registered trademarks of Sybase, Inc. Java and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. All other company and product names used herein may be trademarks or registered trademarks of their respective companies. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies. Appeon Corporation, 1/F, Shell Industrial Building, 12 Lee Chung Street, Chai Wan District, Hong Kong. Contents 1 About This Book ................................................................................................... 1 1.1 Audience ..................................................................................................... 1 1.2 How to use this book .................................................................................. 1 1.3 Related documents ..................................................................................... 2 1.4 If you need help .......................................................................................... 3 2 Introduction ............................................................................................................ 4 2.1 Appeon Developer toolbar in PowerBuilder ................................................ 4 2.2 Web application development with Appeon Developer ............................... 5 3 Before You Begin .................................................................................................. 7 3.1 Installing Appeon for PowerBuilder ............................................................. 7 3.2 Configuring application database connectivity ............................................ 7 3.3 Starting Appeon Server ............................................................................... 7 4 Configuring Appeon Developer ............................................................................. 9 4.1 Using Appeon Developer Configuration Wizard .......................................... 9 4.1.1 Configuring basic settings ............................................................... 10 4.1.2 Selecting PBL file(s) ....................................................................... 11 4.1.3 Configuring deployment settings ..................................................... 13 4.1.4 Selecting DB Type(s) ...................................................................... 14 4.1.5 Declaring transaction object(s) ........................................................ 14 4.1.6 Selecting image files ....................................................................... 17 4.1.7 Selecting INI files ............................................................................ 17 4.1.8 Selecting DLL/OCX files ................................................................. 18 4.1.9 Configuring command line options .................................................. 19 4.1.10 Configuring language options ....................................................... 20 4.1.11 Specifying log mode ..................................................................... 21 4.1.12 Summary ....................................................................................... 22 4.2 Using Configure Tool ................................................................................ 23 4.2.1 Managing application profiles .......................................................... 23 4.2.1.1 Application Profiles tab page ................................................ 24 4.2.1.2 Application profile settings .................................................... 25 4.2.2 Managing database type profiles .................................................... 43 4.2.3 Managing server profiles ................................................................. 46 4.2.3.1 Server Profiles tab page ....................................................... 47 4.2.3.2 Appeon Server profile settings .............................................. 47 4.2.3.3 Web Server profile settings ................................................... 50 4.2.4 Managing deployment profiles ........................................................ 55 4.2.4.1 Deployment Profiles tab page ............................................... 56 4.2.4.2 Deployment profile settings ................................................... 56 4.2.5 Managing connection cache profiles ............................................... 58 5 Using UFA Tool .................................................................................................. 62 5.1 Analyzing an application ........................................................................... 63 5.1.1 Tasks required before you perform feature analysis ....................... 63 5.1.2 Accessing the UFA tool .................................................................. 65 5.1.3 Performing feature analysis ............................................................ 67 5.1.4 Undetected Unsupported Features ................................................. 69 5.2 Working with UFA Report ......................................................................... 72 5.2.1 Modifying unsupported features ...................................................... 72 5.2.2 Manipulating the UFA Report .......................................................... 74 5.2.2.1 Opening or saving a UFA Report .......................................... 74 5.2.2.2 Selecting report view mode .................................................. 75 5.2.2.3 Searching for UFA Report items ........................................... 75 5.2.2.4 Filtering UFA Report items ................................................... 76 5.2.2.5 Specifying report display level .............................................. 78 5.2.2.6 Defining the priority settings of unsupported features ........... 79 5.2.2.7 Customizing the general settings of the UFA Report ............. 80 5.3 Working with Heavy Window Report ......................................................... 81 5.3.1 How a heavy window is measured ................................................. 81 5.3.2 Reading Heavy Window Report ...................................................... 81 5.3.3 Making heavy windows lighter ........................................................ 82 6 Deploying PowerBuilder Applications .................................................................. 83 6.1 Deployment performance .......................................................................... 83 6.1.1 Speed of Web Deployment Process ............................................... 83 6.1.2 Deployment duration for full deployments ....................................... 84 6.1.3 Deployment duration for incremental deployments ......................... 84 6.2 Deployment process ................................................................................. 85 6.2.1 Preparing the PowerBuilder application .......................................... 85 6.2.2 Specifying the deployment settings ................................................. 85 6.2.2.1 Selecting the deployment mode ............................................ 87 6.2.3 Deploying the PowerBuilder application .......................................... 89 7 Debugging Appeon Web Applications ................................................................. 95 7.1 Important Requirements ............................................................................ 95 7.2 Introduction to the debugging procedure .................................................. 95 7.3 Starting Appeon Debugger ........................................................................ 96 7.3.1 Views in Appeon Debugger ............................................................ 97 7.4 Setting breakpoints ................................................................................... 98 7.4.1 Code lines that can be set as breakpoints ...................................... 98 7.4.2 Methods for setting breakpoints ...................................................... 99 7.5 Running the application in debug mode .................................................. 100 7.6 Examining an application at a breakpoint ............................................... 100 7.6.1 Special variable and expression handlings ................................... 100 7.6.2 Adding variables or expressions to Watch view ............................ 101 7.6.3 Changing the value of a variable or expression ............................ 102 7.6.4 Evaluating an expression .............................................................. 103 7.6.5 Examining context in Call Stack view ........................................... 103 7.6.6 Stepping through the application ................................................... 103 7.7 Fixing the code/stopping the debug procedure ....................................... 103 8 Running Web Applications ................................................................................ 104 8.1 Requirements .......................................................................................... 104 8.1.1 Windows account privileges .......................................................... 104 8.1.2 Internet Explorer settings .............................................................. 104 8.1.2.1 Settings for temporary Internet files .................................... 104 8.1.2.2 Advanced settings for temporary Internet Explorer files folder ............................................................................................... 106 8.1.2.3 Advanced settings for proxy server ..................................... 107 8.1.2.4 Security settings for ActiveX controls and Appeon Xcelerator plug-in download ............................................................ 108 8.1.3 Language setting requirements ..................................................... 111 8.1.4 Disabling anti pop-up software ...................................................... 112 8.2 Accessing Web applications ................................................................... 112 8.2.1 URLs for Web applications ........................................................... 112 8.2.2 Running Web applications ............................................................ 112 8.2.2.1 Launching Web applications from Run button ..................... 113 8.2.2.2 Selecting a run mode .......................................................... 114 8.3 Appeon DataWindow menu .................................................................... 115 8.3.1 Enabling Appeon DataWindow menu ............................................ 115 8.3.2 Using Appeon DataWindow Menu ................................................ 115 8.3.2.1 Find ..................................................................................... 115 8.3.2.2 Sort and filter ...................................................................... 116 8.3.2.3 DataWindow printing ........................................................... 119 8.3.2.4 SaveAs ................................................................................ 120 8.3.2.5 Additional Enhanced Features ............................................ 121 9 Using Information Manager ............................................................................... 123 9.1 Viewing the reports and logs .................................................................. 123 10 Packaging and Installing Web Applications ..................................................... 126 10.1 Packaging a Web application ................................................................ 126 10.1.1 What can be packaged? ............................................................. 126 10.1.2 Important requirements ............................................................... 127 10.1.3 Packaging instructions ................................................................ 127 10.1.4 Modifying the deploy-config file ................................................... 136 10.2 Installing and uninstalling a Web application ......................................... 137 10.2.1 Points to note before installation ................................................. 137 10.2.2 Installing an application ............................................................... 137 10.2.3 Uninstalling an application .......................................................... 147 11 Undeploying Web Applications ........................................................................ 154 11.1 Undeploying instructions ....................................................................... 154 11.1.1 Undeploying with the Deployment Profile mode .......................... 155 11.1.2 Undeploying with the Appeon Server mode ................................ 158 12 Developing with Code Insight ......................................................................... 162 12.1 Activating Code Insight ......................................................................... 162 12.1.1 Configuring Code Insight ............................................................ 163 12.1.2 Enabling Code Insight ................................................................. 165 12.2 Coding with Code Insight ...................................................................... 166 13 Launching Appeon Enterprise Manager .......................................................... 168 13.1 Requirements ........................................................................................ 168 13.2 Launching Appeon Enterprise Manager ................................................ 168 14 Appeon for PowerBuilder Help ........................................................................ 170 15 Extended Toolkit .............................................................................................. 172 15.1 DLL/OCX Files Package Tool ............................................................... 172 15.1.1 Packaging DLL/OCX files ............................................................ 172 15.1.2 Installing and uninstalling DLL/OCX files .................................... 176 15.1.2.1 Installing DLL/OCX files .................................................... 176 15.1.2.2 Uninstalling DLL/OCX files ................................................ 179 15.2 Appeon Silent Installer (Windows EAServer only) ................................. 181 15.2.1 Creating folder structure of Silent Installer .................................. 181 15.2.2 Copying installation program of EAServer, Appeon Server, Appeon Server EBF or Web applications .............................................. 183 15.2.3 Customizing configuration file ..................................................... 183 15.2.3.1 Installation Types .............................................................. 184 15.2.3.2 EAServer and ASA Path ................................................... 184 15.2.3.3 EAServer Host Name, Port, Username and Password ...... 185 15.2.3.4 Appeon Server Port, Username and Password ................. 186 15.2.3.5 Web Server Path .............................................................. 186 15.2.3.6 Setup Log Path ................................................................. 187 15.2.3.7 Web Applications .............................................................. 187 15.2.3.8 Web Application Uninstall Program Path .......................... 188 15.2.3.9 Resource Language .......................................................... 189 15.2.3.10 SilentInstall.txt example .................................................. 189 15.2.4 Burning installation CDs .............................................................. 191 15.2.5 Running Appeon Silent Installer (for End Users) ......................... 192 15.2.5.1 Installing Appeon Server, EAServer and/or Web applications ..................................................................................... 192 15.2.5.2 Uninstalling Appeon Server, EAServer and/or Web applications ..................................................................................... 192 15.2.5.3 FAQs ................................................................................. 192 15.3 Appeon Developer Toolbar Register Tool ............................................. 193 16 Technical Support ........................................................................................... 195 Index ..................................................................................................................... 197 About This Book Appeon 6.5.1 for PowerBuilder Appeon Developer User Guide Page 1 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. Chapter 7: Debugging Appeon Web Applications Instructions for using Appeon Debugger to debug an Appeon Web application. uploads/S4/ appeon-developer-user-guide.pdf