You can launch the execution of an interface:

• From the interface details,
• From the external system details: in this case, several interfaces may be run in succession with a single launch,
• By an automatic job,
• By calling up a Web Service.

Also see Examples of exchange files.

 

Launching execution

from the interface details

1. On the action menu of the list , select "Launch interface run."
   → The application displays a pop-up of settings to be entered.

 

From the external system details

1. Open the detail form of the External system on which the interfaces to be launched are configured.
   → The list of interfaces is displayed.
   
   
2. Order the execution using the "Order" column, if necessary (see External system [General]).
   
   
3. Tick the interfaces to be run. On the action menu of the list , select "Launch interface run."
   → The application displays a pop-up of settings to be entered.

 

By an automatic job

1. Create an automatic job for:
   • EXCHOUTJOB, for export interfaces.
   • EXCHINJOB, for import interfaces.

See Standard jobs.

 

By calling up a Web Service

The Web Service methods to be called are:

• processSynchronous for an import,
• exportSynchronous for an export.

The description of the Web service containing these methods is available at the address:

http://<serveur>:8080/xnet-xnet/ExchangeGatewayServiceImpl?wsdl
where <server> is the name of the machine where CARL Source is installed.

 

Launch settings

Output interface

1. Check "Download results" to obtain the output file or files on your workstation.
   
   
2. Check "Asynchronous execution" to allow the interface to execute as a background task: a memo will be sent to you as soon as processing is complete.
   
   
3. Next, for each object to be exported, choose the filter to be applied from among the custom filters of the function, as applicable.
   
   
4. You can delete objects from the list if desired. If this is done, they will not be processed on this run of the interface.
   Before execution starts, if all objects were deleted and the list is empty, an error message is displayed, as follows: "The export was not executed due to an error: No integration objects present on interface execution."
   
   
5. Click on the "Confirm" button.
   → CARL Source launches the data export. Depending on the case, the result file will be downloaded or generated in the indicated location at the connection point of each external system.

Comments:

 

Input interface

1. Choose where CARL Source needs to find the data being exported:
   • Default value: Use of the connection point of each external system,
   • Connection point: Use of a connection point specific to the test, to be selected from among the connection points configured in CARL Source,
   • Downloaded file: The data is in a file that you select using the "Browse..." button and that you send to CARL Source by clicking on "Send."
     
     
2. Check "Asynchronous execution" to allow the interface to execute as a background task: a memo will be sent to you as soon as processing is complete.
   
   
3. For flat files, select the encoding of the input file for proper handling of special characters.
   In the case of XML files, the encoding is filled in in the file header, for example: <?xml version="1.0" encoding="UTF-8"?>.
   
   
4. Next, click on the "Confirm" button.
   → CARL Source starts importing the data with the specified content.

 

Run results

After execution, the results are displayed in the history of exchanges.