Try OpenEdge Now
skip to main content
Managed Adapters Guide
OpenEdge Managed Adapter : Working with the OpenEdge Adapter : Configuring the OpenEdge Adapter
 

Configuring the OpenEdge Adapter

You can add and configure the OpenEdge adapter workstep in your process by performing the following procedures.
To configure the OpenEdge adapter:
1. Click the Assign Participants link in the Tasks pane. Expand the Adapters > Managed > OEAdapters folder and drag the default GenericOEAdapter (or a previously configured OpenEdge adapter instance) to your Content pane, creating a OpenEdge adapter workstep.
2. Double-click the workstep to open its Properties view, and click the Configuration tab. This tab includes the Configure button and the Change mapping button for defining the adapter configuration and mapping respectively.
3. Click Configure to open the configurator box of the OpenEdge Adapter Configurator.
Note: You can also open the OpenEdge Adapter Configurator using the Managed Adapter Browser (available only from Progress Developer Studio for OpenEdge) functionality. In addition to configuring, you can use the Managed Adapter Browser to perform functions like creating a copy, renaming, deleting, as well as importing and exporting the configuration information. For more information, refer to the "Using the Managed Adapter Browser" section of the OpenEdge Getting Started: Developing BPM Applications with Developer Studio.
4. You can use the Input file box to load a BPM invocation (BIZOE) or an R-code (*.r) file.
Note: You can also load an OpenEdge procedure (*.p) file if you have installed Progress Developer Studio for OpenEdge.
*To load a file from a file directory (local or remote machine), click File System and select the file to be loaded as the input file.
*To load a file from the project workspace, click Workspace and select the file available in the project workspace. This functionality is available only if you have installed Progress Developer Studio for OpenEdge with BPM modules.
*After loading a file, if you modify the specified file, click Reload to reload the updated file.
5. You can use the Service Connection Details section to set (or modify) the connection details (as described in the following table) to the OpenEdge application server.
Field
Description
Host name
To specify the host machine name (local or remote) of the OpenEdge application server.
Service name/Port
To specify the port address or service name of the host machine.
Application service
Modify (if required) the name of the application service.
User name/ Password
To enter the user name and password to connect to the specified OpenEdge application server. These fields are enabled only if you select the Session-managed option in the Session mode drop-down list.
AppServer Info
This box is enabled only if you select the Session-managed option in the Session mode drop-down list. Specify a user-defined character string to be passed to the AppServer connect procedure, which is executed each time a client connects to the AppServer.
Protocol
Select the protocol from this drop-down list. Available options are http and AppServer.
Session model
Available options are Session-free and Session-managed.
Note: For information regarding operating models and session model types in OpenEdge application server, see OpenEdge Application Server: Developing AppServer applications.
Use SSL
Select this checkbox if you want to use SSL authentication.
Direct connect
Select this checkbox if the -H and -S parameters are interpreted as the network address and TCP/IP port number of the AppServer connection. Note: This checkbox is disabled if you selected http from the Protocol menu.
6. Click Runtime Properties to open the Runtime Properties dialog box, which display the runtime properties with their default values. The available properties vary depending on the session model selected in the Session model drop-down list. Modify the default values, if required. A valid certificate should be present in <dlc>\certs\psccerts.jar. If a valid certificate is not present, in the adapter Runtime Properties change No host verification property value to 1. For more information regarding the runtime properties, see OpenEdge runtime properties.
7. In the Procedure Details section, you can view the contents of the selected input file. The Show members without annotations and the Generate annotations checkboxes are enabled only if you have selected a procedure (*.p) file as the input file.
*Select the Show members without annotations checkbox to list all the procedures and functions without annotations in the right pane of the Procedure Details section. If the main procedure file contains internal procedures and functions, the left pane of the Procedure Details section lists these elements in a tree structure.
*Select the Generate annotations checkbox to generate annotations for a procedure or function in the right pane of the Procedure Details section. The procedure or function files are automatically updated with the annotations. If you generate annotations for a procedure or a function that is open in the OpenEdge Editor, the annotations are reflected when you save the open procedure or function file. If you select the Show members without annotations checkbox, the Generate annotations checkbox is also selected.
8. Click OK to save the save your changes in OpenEdge Adapter Configurator dialog box. The Dataslot Mapping dialog box appears.
* OpenEdge runtime properties