Specifying Gateways and Connectors

Select the Connectors tab to access the Nodes − Connectors page.

This example illustrates the Nodes – Node Connectors page.

Nodes - Connectors page

Use this page to specify the integration gateway and target connector the node uses for integrations.

At least one gateway with at least one target connector must be defined and configured. If the current node is remote, it can use the default local node’s gateway or any other installed gateway as its local gateway. If the current node has its own gateway installed, the default local node’s database must contain a definition for it, configured as a remote gateway.

Specifying a Gateway and Target Connector for the Current Node

To specify a gateway and connector for the current node:

  1. From the Gateway ID field, click the Lookup button to select the gateway ID for the gateway you want the current node to use.

    When the default local node sends a message to any other node, the message first goes to the default local node’s local gateway through its PeopleSoft listening connector, regardless of the gateway ID you select here.

    • If you specify a remote gateway ID, the local gateway uses its default remote gateway connector (specified in the integrationGateway.properties file) to route messages to the remote gateway through the remote gateway’s PeopleSoft listening connector. The remote gateway sends the messages directly to the current node, using the connector you specify in the next step.

      Note:

      The default remote gateway connector setting initially specifies the HTTP target connector, which is unlikely to change unless you develop a custom target connector.

    • If you specify the local gateway ID, the local gateway sends messages directly to the current node, using the connector you specify in the next step.

  2. From the Connector ID field, select a connector ID from the list of connectors registered with the selected gateway.

    Specify the target connector appropriate to the communication method preferred by the current node. If the node is a PeopleSoft application with Integration Broker installed, select PSFTTARGET. If the node is a PeopleSoft 8.1x application, select PSFT81TARGET.

    The rows on the Properties and Data Type/Description tabs are automatically populated with the connector’s properties that are designated Required in the gateway definition. The fields on these tabs are the same as those on the Connector Properties page. If the connector has multiple instances of a required property defined, only the instance designated as Default appears.

    See Editing Connector Properties.

  3. From the Delivery Mode drop-down list box, select a delivery mode. The options are:

    • Guaranteed. (Default.)

    • Best Effort.

    These options are discussed in detail elsewhere in this PeopleBook.

    See Setting Target Connector Delivery Modes.

  4. Click the Save button.

Note:

You can override the gateway and connector selection for individual outbound transactions.

Working With Connector Properties

Properties that appear on the Nodes – Connectors page are copies of the specified connector’s required properties.

This example illustrates the Node – Connectors page with the HTTP target connector defined. The default properties for this connector appear in the Properties grid.

Nodes - Connectors page with http target connector defined

You can use this page to:

  • Add an instance of a non-required property.

  • Add a new instance of a required property.

  • Modify the value or description of a property instance.

  • Remove a property instance.

Information about appropriate modifications might come from PeopleSoft, from the connector’s developer, or from your own experience and requirements.

Important:

Don’t remove a required property unless you replace it with another instance of the same property. Without all of its required properties, the connector is unlikely to work correctly.

You must encrypt any password connector property values. The Connector tab features access to the Password Encryption Utility that enables you to encrypt a password value and paste it into the appropriate field on the page. To access the utility, click the Password Encryption Utility arrow.

Accessing the Integration Gateway Properties File

The Connectors tab features a Gateway Setup Properties link you can use to access the integrationGateway.properties file directly from this tab.

Testing Connector Configurations

The Connectors tab features a Ping Node button you can use to test your configuration.

If the ping is successful, a window displays with a message indicating that the gateway is active and the PeopleTools version that you are running. If the ping is not successful, a window displays with a message indicating the gateway could not be found.

Related Topics