Configuring the Clarify Connector in Harmony

This Clarify Connector in Harmony is used to integrate inbound and outbound file transfers directly with Cleo Clarify. The inbox and outbox of each Cleo Harmony/VLTrader host to be integrated with Clarify must point to an instance of this connector.

1. From the Templates tab, right-click the Generic Clarify connector and select Clone and Activate. The new connector appears on the Active tab, but should be renamed.
2. In the Host alias field, rename your new Clarify connector. Provide a descriptive name, such as “production”, “dev”, “test”, etc.
   
3. From the Clarify tab, in the Clarify Servers field, specify the Clarify host(s) to which you want to connect, using the Host:port format.
   For example: clarify_host_1:15801
   Note: For a Server Cluster, all servers in the cluster can be defined in this one field. You must specify multiple Cleo Clarify hosts by using a semicolon-separated list. For example:

   devmachine1:14091;devmachine2:14091;devmachine3:14901

4. Click Apply to save all changes.
   In the Cluster example above, Harmony will attempt to connect to the first Clarify server from the list. If one is unavailable, then Harmony attempts each subsequent server in the list. If none of the servers on the list are connected, then the transfer fails.
5. An optional but recommended step is to define Clarify Connector directory structures using custom directory variables. This allows you to define these structures once, and then have them available for selection from the Inbox and Outbox pull-down menus in any Harmony Connection.
   To create custom directory variables:

   • (For Web UI): go to Administration > File System > Directories

   • (For native UI): select Configure > Options in the menu bar (or click Options in the toolbar)

   To send files to Clarify, the required directory structure is as follows:

   clarify:<Clarify_Connector_Alias>/%host%/toclarify

   To receive files from Clarify, the required directory structure is as follows:

   clarify:<Clarify_Connector_Alias>/%host%/fromclarify

   

   After creating and saving the custom variables in the above example, they would now be options for the Connector Inbox and Outbox drop-down menus.

   

   Next Steps: Configure an AS2 host, an FTP host or an inbound listener to reference your Clarify connector. The Clarify Connector only supports the AS2, FTP, and SFTP protocols to the extent that Cleo Dashboards will associate the file flow between Cleo Harmony/VLTrader and Cleo Clarify. By configuring the Inbox /Outbox of your host, you are setting it to reference custom directory variables to then reference the Clarify Connector, which will move data between Clarify.

   The example below shows how a host (as2_to_clarify) has been configured to include server address and inbox and outboxes directories. Once configured, the inbox references a Custom Directory Variable which references a Clarify Connector, which will send data to Clarify.

   

   The example below shows how a host (as2_from_clarify) has been configured to include server address and inbox and outboxes directories. Once configured, the outbox references a Custom Directory Variable which references a Clarify Connector, which will receive data from Clarify.