HTML Datawindow
\The Sandbox \PB History & Future \New In PB7 \HTML DW
What is the
Configuration for
Trying the
Customized Server
Data Validation


The HTML DataWindow is a thin-client DataWindow implementation for web applications that provides most of the data manipulation, presentation, and scripting capabilities of the PowerBuilder DataWindow without requiring any PowerBuilder DLLs on the client.

Web DataWindow  The HTML DataWindow is also called the Web DataWindow; both terms refer to the same technology.

The HTML DataWindow has three parts:

  • A server component installed in a component transaction server such as Jaguar CTS or Microsoft MTS
  • The server component uses a DataWindow object to retrieve data and generate HTML. You can use the generic server component and configure it from a script or, in Jaguar, you can install a custom server component and configure it specifically for your application.

  • An application server, such as PowerDynamo or Microsoft Active Server Pages
  • Server-side scripts in a page template build a web page using HTML for the DataWindow generated by the server component.

  • A client control, which is part of the generated HTML
  • The control responds to user actions and requests updated pages from the application server.

How it works  The way the HTML DataWindow works can be summarized in these steps:

  1. The user requests the URL for the page template.
  2. Server-side scripts in the template run, calling server component methods that generate HTML DataWindow code.
  3. The web page with the HTML DataWindow is delivered to the browser.
  4. The user interacts with the DataWindow client control.
  5. Actions by the user cause the URL with added action parameters to be sent to the server. The server-side script communicates the actions to the server component. The action are applied, which cause modifications to the regenerated DataWindow and the cycle continues with step 2.

PowerSite has a design-time control that makes it easy to create server-side scripts that use the HTML DataWindow. You can also write server-side scripts yourself that interact with the server component.


A typical way to use the HTML DataWindow in PowerSite is to:

  1. Define DataWindow objects in PowerBuilder or DataWindow Builder.
  2. Copy the PBL or PBD containing the DataWindow to the Jaguar server.
  3. Use Jaguar Manager to set up a custom component with a DataWindow object and a connection cache.
  4. In PowerSite, create a web page and insert the HTML DataWindow design-time control. You can use a wizard or the editor.
  5. Select the Jaguar component for the design-time control. The design-time control fills in the property sheet with the component settings.
  6. If desired, write client-side scripts for events of the HTML DataWindow client control.
  7. Deploy the web page to a web server.

You can also use the PowerDynamo development environment to develop page templates, server-side scripts, and client-side scripts for the HTML DataWindow.

For more information

These topics are in the DataWindow Programmer's Guide section of the Help:

What is the HTML DataWindow
Configuration for the HTML DataWindow using EAStudio
Trying out the HTML DataWindow with PowerDynamo and Jaguar
Alternate configurations
Developing an HTML DataWindow application
Using a customized server component in Jaguar
Using server-side data validation

There is also information in these books:

The DataWindow Reference documents properties and methods of the HTML DataWindow server component and events and methods of the client control.

The PowerSite Reference in PowerSite InstaHelp documents the object model that you would use to write scripts for the PowerSite HTML DataWindow design-time control.

PowerSite Concepts and Procedures in PowerSite InstaHelp has information on using the design-time control.

PBL Peeper PB Help PB History
& Future About Us Feedback Site Map