KB Article #182471

ADVANCED ROUTING: Append contents of multiple files into a single file

Problem

How do you aggregate the information contained in multiple files uploaded in SecureTransport into a single text file?


Resolution

Requirements

This scenario is possible with the setup that is outlined below. Here are the summarized requirements:


  1. A trigger file must be sent to SecureTransport;
  2. The server configuration option AdvancedRouting.PublishToAccount.allowSelfOverwrite must be set to true;
  3. In the AR's Publish To Account step, it is mandatory to use the Append to existing file collision setting.


Implementation

I. Assign a Route to the account that will be used to receive the data.

The Route must have the following setup:


An AR template must be assigned to the account in the Routes tab, and a new route must be created:



A Publish To Account step must be created inside the route:



The Publish To Account step must be configured as shown on this picture:



II. Create an AR subscription in the account that will be used to receive the data.

The basic required settings are Subscription Folder, Route name, and Trigger condition. These settings are outlined in the Administrator's Guide in more details.



Note: The trigger condition in this example is the default one that is available through the context help button. The purpose of the condition is to set the AR subscription to be triggered only when a file with the extension .trigger is uploaded in the same folder. The trigger file itself will not be processed and can therefore be empty.


III. Change the server configuration option to allow overwriting of the existing file with the same name:


IV. Execute the flow

With the setup and changes made above, you are now ready to execute the flow. In this example, multiple text files are uploaded to the AR subscription folder (named AR in our context). When this is done, a trigger file must be uploaded that has the .trigger extension.


As a result, all of the information in the uploaded text files is appended in the file specified by the Publish To Account step.