When you run a Web DataWindow application using EAServer, the definitions of your DataWindow objects must be available on the server.
The Web DataWindow Container project wizard simplifies this process. It packages all the DataWindows from workspace PBLs into a single PBD that you deploy as a component to EAServer. The container includes an interface to a customized version of the Web DataWindow server component (HTMLGenerator80) that it can use to generate the DataWindows as HTML.
Because you are using a customized component instead of the preinstalled HTML generator component, you can set properties for your component in Jaguar Manager. Setting properties reduces the number of method calls required to configure the component and can result in improved performance, maintainability, and scalability.
SetDWObjectEx method If you are using the Web DataWindow DTC, you can select a DataWindow from the container component on the DataWindow page of the Web DataWindow property sheet. If you are not using the DTC, you must reference these DataWindows in code, using the new SetDWObjectEx method.
After you create DataWindow objects , open the New dialog box and start the Web DataWindow Container wizard from the Project page.
The choices you make in the wizard are similar to those you make for other EAServer components, such as whether to support instance pooling or live editing. The package and component can have any names you want, with the exception that you cannot name the package DataWindow (the name of the package that contains the preinstalled HTML generator component).You cannot set component type or transaction support properties.
Building the Web DataWindow Container project presets some of the properties of the component that you would otherwise need to set in Jaguar Manager. You can specify a database profile in the wizard or Project painter to set the com.sybase.datawindow.trans.dbms and other database transaction properties. If you want calls to component methods to be written to the server log, select Enable Trace to set the com.sybase.datawindow.trace property.
Connection cache Specifying a profile sets database transaction properties for the component, but you still need to create a connection cache in Jaguar Manager for the database the component will access. From the Web DataWindow DTC, you can override the connection information that you deploy with the container component.
Service classes In PowerBuilder 7, you used service classes if you wanted to include additional server-side validation for the update and retrieval process. In PowerBuilder 8, you can use new server-side scripting capabilities to handle validation on the page server, so you may not need to include any service classes in the server component.
If you do need to add a service class to your project (for example to obtain SQL syntax), create a custom class user object with a user-defined event that implements the SQLPreview event. The custom class user object must be in the same library as the DataWindow objects or in its library list. Then select the class in the Select Objects dialog box in the Project painter for your Web DataWindow Container project.
Select Objects dialog box The user objects you select for a Web DataWindow Container project are deployed as server service classes. They cannot be accessed from a client as independent components—as can the objects you select for other types of projects using the same dialog box.