Defining a Pass-Thru Inbound Source Application
After you have provided the definition of the Template, the next step while creating a Template is to define the Source application. A Source application is an application from where data is received. After defining the Source application, you must choose a Trigger.
A Trigger is an event that initiates the data exchange. For example, in an FTP Source application, if you choose On File Created as a trigger, then data exchange will initiate when the new file is created to the source FTP.
To select and configure the Source application of the Template:
Select the Source application and click Next.
However, depending upon the routing type you chose while defining the template list of available apps will vary.
The next screen differs depending on the chosen Source application.You can either define the next step by clearing Partner will define this step check box or allow your Partner to define these steps. Partner will define these steps while Creating a Transaction using this Template.
If you are defining this step then select the Source application account. You can either use an existing account or create a new one. Click
to add a new account. For information on how to add an account, refer to Appendix D: Supported Applications.
Click Test to test the connection to your account.You can either define the next step by clearing Partner will define this step check box or allow your Partner to define these steps. Partner will define these steps while Creating a Transaction using this Template.
If you are defining this step then select the trigger from the drop-down list and click Next.The list of triggers differs for the selected Source application. For the complete list of triggers of the supported applications, refer to Appendix C: Supported Applications.
Provide the configuration details of your account.
You can either define this step by clearing Partner will define this step check box or allow your Partner to define these steps. Partner will define these steps while Creating a Transaction using this Template.In case you have selected Context based routing then only company can define this step.If you are defining this step then for FTP or DropBox applications only, you can define the folder location using Partner parameters in the following format:
$$Partner.{PartnerParameterName}$$
where,
PartnerParameterName is the name of the parameter that you have configured for the Partner.
Ensure that you have configured the specified parameter for the Partner for which you are creating this Template.
Field Name
Description
Folder Location Folder location from where to pick files. Process all the existing records/files To process all the existing files from the specified location. Send mail notification for no data on trigger Selecting this option will send the mail notification whenever there is no data found on trigger. Send mail notification for error on trigger Selecting this option will send the mail notification whenever there is an error on trigger. Delete file on success Delete the file once it is processed. File type File format to process the files. Multiple file formats are separated by a comma. Use *.* to process all file formats. File exclude Type the file format to exclude the file type while transaction is running. Multiple file formats are separated by a comma. For example if you want to exclude text files from the FTP location, type .txt in the text box. Trigger Type You can set trigger through POLLING and CRON EXPRESSION.
POLLING: The time interval during which the Transaction triggers. By default, Transaction triggers after every 10 minutes. Select No polling option to trigger Transaction manually.
CRON EXPRESSION: Define the specific time schedule for the Transaction to trigger. For more information on how to define Cron Expression, click here.
File Stable Time You can set file stable time in the text box and select time unit from the drop-down list. This option is applicable for On File Created and On File Modified Trigger Type. The trigger will wait for the specified time for the file to become stable. For example, if you choose 30 Seconds in the stable time then system will wait for 30 seconds for the file to go stable before it triggers the transaction.
The Source application account and configuration details screen differ depending on the chosen Source application.Expand Other Settings and provides the detail.
Select Trigger in Sequence check box to trigger the Transaction in sequential manner. If you do not select the Trigger in Sequence check box then the associated Transaction will trigger concurrently.
If you want to enable misfire handling for your file event then, select the Run Once option from the Action on Misfire Event drop-down list. If you do not wish to enable misfire handling for your file event then, select the Ignore Misfire option. For more details, refer to Handling Misfire Event.
The Run Once option will run only one collective instance of all the misfires for a particular event. Whereas the Ignore Misfire option will not run a misfired event.
The default value for Action on Misfire Event field is set to Run Once for all of the earlier events.The Connector drop-down lists the APIs to connect to the FTP Server. The options changes as per your selection of the protocols that you want to use to establish FTP connection.
Protocol
Options
FTP
Native
Secured Inet FactorySFTP
J2SCH (VFS)
Secured Inet Factory
J2SSHFTPS
J2SCH (VFS)
Secured Inet FactorySelect Verbose check box, if you want to create a log file of your FTP activity. This check box is enabled only if you select Secure Inet Factory from the Connector drop-down list box.
Click Next to define the Routing Criteria. This is applicable only if you have selected context based routing as a Routing Type.
Select the routing criteria based on which different data files will be sent to the Partners.
Criteria Condition Parameter Currently, only File Name is supported. A condition to filter the files.
Equals: Select this option to allow your Partner to provide the exact file name with its extension.
Contains: Select this option to allow your Partner to provide any part of the file name.
A variable name for the specified condition. On the Routing Criteria screen:
Select the file name from the Criteria drop-down list.
Select the type of condition from the Condition drop-down list.
Enter the parameter name in the Parameter field.
Select the Ignore Case check box if you want the search to be case insensitive.
For example, here in the example, cust_id is specified as a variable name. The Partner needs to specify the value for the variable name (cust_id) at the time of creating a Transaction. Suppose, the value specified is CUST147. When the Transaction will execute, it will fetch all the records containing CUST147 such as CUST14789.txt, CUST1478.xls, CUST147.docx.
If you have specified Equals in the Condition drop-down list then Transaction will fetch all the records containing CUST147 only such as CUST147.txt, CUST147.docx.
Click Next to encrypt data.
You can either define this step by clearing Partner will define this step check box or allow your Partner to define these steps. Partner will define these steps while Creating a Transaction using this Template.
Select the Is Source File encrypted? check box if the source file is in the encrypted format. The below fields appears. Provide the details in the corresponding fields.
Field Name
Description
Key Manager Select the Key Manager from the list. To create a Key Manager, visit Account > Security Settings. To create a Key Manager, click here. Key Name The default value is the default. Private Key Password Password of the key. Confirm Password Confirm the password of the key. Click Next to select the Destination application.
Next Step