Managing an endpoint definition from the UI

You can create and manage endpoint definitions using the Graphical Designer.

About this task

Defining an endpoint enables you to configure connection details for an external system once and reuse them across multiple tasks. This approach centralizes the management of credentials and URLs, enhancing security and maintainability.

Procedure

  1. Click Design to access the My workspaces page.
  2. Click New workspace or open an existing workspace to access the Graphical Designer.
  3. From the palette, select the Assets tab.
  4. Click Add new (+ icon) and select Endpoint from the drop-down menu.
  5. In the General information section, specify the following details:
    • Folder: Select the folder where you want to save the endpoint definition.
    • Name: Enter a unique name for the endpoint.
    • Description: Optionally, provide a description to identify the purpose of the connection.
  6. In the Endpoint type field, search for and select the specific task plug-in associated with the external system (for example, RESTful, Database, or AmazonBedrock).
    Note: The selection you make here determines which connection fields appear in the next step.
  7. In the Connection section, enter the specific parameters required to establish the connection.

    These fields vary based on the endpoint type selected. Common parameters include Service URL, Port, Database name, and Authentication details (such as User, Password, or API Key).

    Important: If you are configuring an endpoint for cross dependencies (connecting to a remote HCL Universal Orchestrator or HCL Workload Automation for Z engine), the test connection action explicitly fails and returns a 403 Forbidden error if the provided API Key is valid but is not of the Cross dependencies type.
  8. Optionally, configure the Monitoring settings to enable proactive availability checks:
    • Monitored frequency: Specify the interval at which the system checks the endpoint status (range: 1 minute to 24 hours).
    • Workstation: Select the workstation that runs the connectivity test. If left blank, the default CLOUD workstation is used.
  9. Click Add to save the definition to the database.

Results

You have successfully created an endpoint. You can now reference this endpoint in compatible task definitions to handle external connections.