Connections

In order to be able to see a particular project or create connections in a project, you need to be a project owner. Contact your organization owner to change your project role.

Xponent has connections that define the base level of connectivity (supported connection types include database, message queue, web service etc). Connections are used to communicate with external systems. An adaptor uses a connection to do a particular operation.

For Example:  A single connection may have many adaptors.

• Database Read, Write, Delete, and Listener etc. 
• Message Queue Read, Write, and Listener etc.

For all connectors using AWS keys requiring rotation, this process must occur at the predetermined frequency. From now onwards updating connection and credential details in the Hub will automatically propagate the changes to all deployed graphs using that connector. There's no need to stop and redeploy graphs; the application detects all affected graphs and applies the changes accordingly.

Creating a New Connection

To create a connection in a project, navigate to the project admin page, choose Projects from the left-hand side menu, and then choose the desired project from the list.

1. Go to Project Settings and select the Connections tab. 
2. Click the Create Connection button. The Create Connection window is displayed.
   
3. Choose the required connection Type from the dropdown menu.
4. Create the Connection Name in the pop-up window. Provide a functional name rather than a development stage name

For Example:
CustomerDB rather than DevelopmentDB. It makes easier to propagate the connection through multiple environments.

Depending on the connection type, you will see different parameters to complete before the connection is ready:

To enable the Test Connection, it is mandatory to save the changes.

Testing a Connection

Once the connection details have been saved, the Test Connection button appears below the connection details.

• Click the Test Connection button to test the connection. It will confirm whether we can reach the service or not.

After successfully testing the connection, the button name changes to Connection Verified.

Publishing a Connection

Once you have successfully tested the connection, the Publish Connection button will be enabled. Publishing connections will propagate the updated connection details to all deployed graphs using that connection without the need to stop and restart the graphs.

The Publish button will initially appear greyed out. It will be activated and turn green only after meeting the following criteria:

• The connection must be used in a deployed graph.
• The connection must have had edits made to it since the graph was deployed.
• The connection has been tested and passed.

• Click the Publish Connection button to publish the configured connection. 

A pop-up will display the total number of deployed graphs that will be impacted. Before publishing, it will inform you that the engine will temporarily stop the graphs while acquiring the new connection details, after which the graphs will be automatically restarted. 

The number displayed in the pop-up will change based on the impacted deployed graphs

• Click Yes to publish the connection credentials. Afterward, all deployed graphs will immediately start using the new connection credentials.
• Click Cancel if you are not sure or ready to make this change. Cancelling means that the connection details will not be published; however, the connection details that you updated in the Hub will be saved in the Hub, and you'll see a status of Unpublished Edits.

Encountering issues while publishing connection details is common, often due to factors like invalid credentials or network problems. The initial troubleshooting step involves attempting the process again and carefully verifying the connection details.

Now all connection statuses can be identified using the following indicators:

• Published: Indicates that the connection is published to the engine, and all impacted deployed graphs are using the current connection and credentials details.
• Unpublished Edits: Indicates connection details have been changed and saved to the hub but not yet published to the engine.

Expand or Collapse the Connection

The selection of the Expand icon will expand the list of the same type of connections.

Selection of the Collapse icon will collapse the list of the same type of connections.

Deleting a Connection

The selection of the Delete icon will delete the related connection.

Changing a Connection Name

Selection of the required connection allows you to modify the name.

• Click Save Edits to save the modified name.

Related Pages

• Database Connection
• Email Connection
• File Connection
• Kafka Connection
• Message Queue Connection
• SOAP Web Service Connection
• Batch Connection
• REST Web Service Connection
• Environments
• Creating a Project
• Deploying a Project