Sockets are part of the process that accesses an external system to read and write information. If the default Sacumen connector is not suitable, you can implement your own. We recommend that you use the Maven connector prototype to create a new connector design. Alternatively, you can define a new application or connector definition in Sacumen using the wizard launched from the Connector submenu of the Develop menu.
This page describes the connector structure and summarizes the connector development features available in Sacumen.
Binder structure
The connector is implemented in Sacumen in two parts: definition and application. This allows you to change the application without changing the definition. You can create multiple applications for one definition.
Common definition
A connector definition is an external connector interface visible to the user (the icon used to identify the connector in the connector configuration wizard and Sacumen) and visible to the Sacumen engine (input and output)
Connector app
The connector applet consists of the application logic contained in the Java class. You can create any number of applications that match a given definition. However, in this process, there is a one-to-one relationship between the connector definition and the connector implementation.
The Java class must implement the defines the following methods:
- Set Input Parameters to get configuration parameters
- Use validate Input Parameters to verify that the connector configuration is set correctly
- To run the linker and return a map containing all outputs, run
- Connect and create a connector
- Disconnect to end the connection
You can find more information about APIs, methods and related objects in the Javadoc documentation.
Import and export connectors to Sacumen
You can import a connector created with the Connector Development Toolkit or a connector exported from another Sacumen program. The linker is imported as a zip file.
- In Sacumen go to the menu Develop, Linker, Import Linker…
- Download the zip file.
The imported fastener will be available in the Add Fasteners dialog.
You can also export a connector using the options in the Programming menu. The linker is exported as a zip file and can be imported into another instance of Sacumen. You must specify the definition and application to export.
Binder test
To test a connector independently of the process, go to the Programming menu; select Connector…, then Test Connector…. Select the connector you want to test, use the wizard to configure the required test information and then click on Test. The connector works and the results are reported.
You must import the connector into Sacumen before testing.
Constitution
Implement the transaction with a connector
Configuring the connector consists of two steps.
- When you add a connector to a group or task, the behavior of the connector is configured.
- When you configure the process for an application, you define and implement each connector it contains. You must also specify the connector dependency as a transaction dependency.
If a connector is specified in the configuration, the connector code is attached to the task file when creating the deployment process that references the configuration.
If you are running Enterprise or Performance after deployment, you can upgrade the connector deployment to a running system.
