Creating a PowerBuilder .NET Web Forms target

Project name

Name of the .NET Web Forms project.

Project library

Library where you want to store the .NET Web Forms project.

Web application name

Name of the .NET Web Forms application. By default, this is the name of the application for the current PowerBuilder target.

Application URL preview

Address for starting the .NET Web Forms application in a browser (minus the default.aspx or default.htm start-up file name).

Resource file and directory list

Specifies a list of resource files, or directories containing resource files, that you want to deploy with the project.

When you select a directory, the resource files in all of its subdirectories are also selected by default. However, after you complete the wizard, you can clear the check box in the Recursive column on the Resource Files tab page for the project. If you do that, the resource files in the selected directory, but not in any of its subdirectories, are selected for deployment.

Win32 dynamic library file list

Specifies any Win32 DLLs that you want to include with your project. Modules in this list are deployed to the bin directory in the application Web site under the virtual root folder.

JavaScript file list

Specifies JavaScript files you want to deploy with the project.

Generate setup file option and Setup file name

Select this option and a setup file name if you are not deploying directly to an IIS server.

Direct deploy to IIS and IIS server address

Select this option to deploy to an IIS server and enter the address of the server where you want to deploy the .NET Web Forms application.

General

Includes radio button options that determine whether the project is deployed as a debug build (default selection) or a release build. You use debug builds for debugging purposes. Release builds have better performance, but when you run a release build in the debug mode, the debugger does not stop at breakpoints.

Also includes the Enable DEBUG Symbol check box that you can select to activate code inside conditional compilation blocks using the DEBUG symbol. This selection does not affect and is not affected by the project’s debug build or release build setting. This check box is selected by default.

Resource Files

The wizard automatically includes the resource files from all subdirectories of a directory that you add to the wizard’s Resource Files page. In the Project painter, a check box displays under the Recursive column for each directory in the Resource Files page list box. You can clear the check box to deploy only the files in the directory that is listed.

Library Files

The Library Files tab has separate list boxes for target libraries (PBLs and PBDs) and for dynamic Win32 library files (DLLs) that you want to deploy with your project. The PBLs you select are generated as PBDs.

By default, all target libraries are selected, but you need to select a PBL only if it contains DataWindow or Query objects that you use in your application. If your target library list includes a PBD file that contains other types of PowerBuilder objects, such as functions or user objects, you cannot reference those objects in your Web Forms application.

These types of objects must be contained in a PBL file rather than in a PBD file before you deploy them to a Web Forms target. For a Web Services client, you can import a PBX file into a target PBL using the Import PB Extension item on the library’s pop-up menu, rather than using the PBD file that contains the SoapConnection and SoapError classes.

Configuration

On this Project painter page, you can modify global properties for the project before it is deployed. You or the application server manager can also change global properties after the project is deployed.

For more information about global properties, see “Global Web configuration properties”.

Version

You can specify version information for the project on this Project painter page. The version information includes values for the product name, company name, description, and copyright, as well as major, minor, build, and revision version numbers for the product, file, and assembly that you generate when you build the project. The values you enter display in the generated assembly file's Properties dialog box in Windows Explorer. They are viewable on the Web Forms server, but are not typically available to end users of Web Forms applications.

Post-build

You can use this Project painter page to select an application, such as a code obfuscator program, to process the generated Web Forms application immediately after it is deployed. You can select different applications for post-build processing of debug and run versions of your project.

Run

Contains the Application field where you can enter the path to a browser you want to have run the Web Forms application and the Arguments field where you can enter the URL for the Web Forms application. By default, the path to the Internet Explorer browser is displayed for the Application field. The Arguments field is populated by default with the value for the project’s Application URL Preview, with Localhost as the default server name.