Create an Output Contract

Output Contracts define how Data Mover connects with an actor to deliver files.

The creation of the Output Contract consists of the same main steps as the Input Contract:

1. Define the contract info. This step defines the details of the contract, its name, type, and how it must be processed.

2. Associate the contract with the actor. This step defines the details of the actor that Data Mover needs to access to collect or send the files.

3. Define the contract actions. This step defines the trigger that will start the contract and the workflow associated with the contract.

4. Set the contract variables. This step defines the interaction between the contract and the workflow, setting the variables that will be initialized.

Define the contract info

To create a new Output Contract, go to Design → Contracts and click the New button to open the New Contract window.

As you can see on the left of the window, the wizard guides you through 3 subsequent steps:

• INFO

• ACTOR

• ACTIONS

To create an Output Contract, complete the fields in the INFO section as follows:

• Name: assign an identification name to the Contract. It is suggested to assign a name that can be easily identified at any time.

• Description: enter a description for the Contract you are creating.

• Contract Type: in the drop-down list, select Output.

• Execution Queue: by default a Contract is associated with the default queue. Queues order the tasks designed in the contract and define how they must be processed. To assign a contract to a different queue, open the drop-down menu and select another queue among those available. Details about queues can be found in the Job Queues section of this documentation.

After you have filled in all the fields click the CONTINUE button.

Associate the contract with the actor

You will access the ACTORS section of the wizard where you must select the actor your contract will be associated to. Choose a Partner or Application from the drop-down list; if needed, a Search field is available to look for specific names. The list will be filtered as soon as you start typing an alpha-numeric character and all actors containing that character will be listed.

Now that an actor is selected, click the CONTINUE button.

Define the contract actions

This step defines the trigger that will start the contract and the workflow associated with the contract.

Enter the Action name. If you are satisfied with the system-generated name, you can leave it as it is. If you are not, enter a different name.

Select the Trigger type that will execute the contract. Possible options are listed on the Trigger types page and subpages.

Select the Workflow from the drop-down menu. A brief description of the template and a visual representation of the workflow will appear in the lower section of the window. For more information about workflows, refer to the Workflows section.

Once all the fields have been selected, click on the SAVE button. The wizard will be closed, and you will be directed to the New Contract page to configure action variables.

Set the contract variables

The New Contract page consists of different sections, shown in this figure:

In the panel at the top of the page, you can edit the Name, Description and Execution Queue of the Contract.

The Name, Status, Contract type and Actor associated with your Contract are displayed in the panel on the right of the page. The status of the contract will appear as ENABLED. The toggle button cannot be set to DISABLED if the Contract is associated to an active FEL. The status of the contract is also shown in the Contracts column of the Contracts page. You can change the actor associated with the contract by selecting one of the entries in the Actor drop-down menu.

The action selected in the wizard will appear in the Actions section of this page. The icon next to the Action Name signals that the action variables have not been configured yet. To configure the action variables, click on the icon to expand the Action row.

Fill in the action variables, setting mandatory and optional parameters. The detailed list of all the variables associated with System and Error Workflow templates, refer to the Workflow templates for output contracts and Error Workflow Templates pages. As a general rule, the variable name and/or the description of the variable in the workflow template and in the output contract action are the same.

Once all the variables are set, this icon will appear next to the Action Name and the status of the contract will change to READY. You can add a new action by clicking the button below the Action variables row.