Accessing components

Before you can view information about or include an EAServer component on your Web page, you must make sure a profile exists for the server that contains a component you want to use. A connection from a Web target to EAServer uses the Internet Inter-ORB Protocol (IIOP). You must make sure the EAServer has an IIOP listener configured before you set up a connection for your Web target.

With a connection to the server established, you can:

You can drag and drop an EAServer component from the System Tree to a 4GL Web page that is open in the Page view of the HTML editor. This opens the Page Properties dialog box to the EAServer page and adds the component to the list of components available to the Web page.

StepsTo define an EAServer connection profile:

  1. Select Tools>EAServer Profile from the PowerBuilder menu

    or

    Right-click anywhere in the Components tab page of the System Tree and select EAServer Servers from the pop-up menu.

    The EAServer Server Profiles dialog box displays.

    Shown is the E A Server Profiles dialog box. It has columns for Profile Name, Server Name, Port, Log in Name, and Password with sample data displayed for remote and local profiles. At right are buttons labeled Add, Remove, Configure, Text, and Done.
  2. Edit the list of EAServer profiles.

    You can add, modify (configure), or remove EAServer connections as needed. You can also select a connection and test it. You should make sure the server is running before you test the connection.

  3. Click Done to save your changes.

    An item representing the server appears under the EAServer Servers node on the Components tab page of the System Tree.

Viewing components

After you establish a connection to an EAServer for your Web target, you can see the components and the methods for those components installed on the server.

Shown is the Components tab page of the System Tree with an expanded entry for E A Server Servers showing the servers remote, q a machine, and local. The local server is expanded.

You can view the list of server components that you have added to a page from the Page Properties dialog box for 4GL Web pages. When you add a Web DataWindow DTC to a page, you can select a DataWindow component from the Web DataWindow DTC Properties dialog box; the DataWindow HTMLGenerator105 component is selected and enabled by default.

Getting information about components and methods

After you define a connection, you can get information about components and component methods from the System Tree.

StepsTo get information about EAServer components and methods:

  1. From the Components tab of the System Tree, expand the EAServer Servers branch.

  2. Expand the appropriate server and package to find the component you want information about or Expand the appropriate server, package, and component to find the method you want information about.

  3. Right-click the component or method and select Properties from the pop-up menu.

    The properties dialog box for the selected component or method displays:

    Shown is the General tab of the properties dialog box with  e j b Activate ( ) displayed in the Method Name text field at top, followed by fields for Module : : Interface, Component, and E A Server, which displays as local host : 9000. A Parameters tab is also available.

    Method properties have a Parameters tab to display the parameters of the component method.

  4. (Optional) Click the Parameter tab to see information about the parameters the method uses.