Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

  1. 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: 

    For Content Based Routing: Box, Dropbox, Email, FTP, File, Google Drive, REST WebHook, SOAP WebHook, JMS, Database

    For Context Based Routing: Box, Dropbox, Email, FTP, File, Google Drive, REST WebHook, SOAP WebHook (as context based routing needs file names, these are the applications that support file transfer).

    No Routing: All apps

    Info
    • If you select REST Webhook as a Source, 
      • Adeptia Connect creates the OAS 3.0 standards API documentation for the Transaction based on this Template. You can work with the API Document by following the details given on the page Using API Documentation for REST Webhook Transaction.
      • You can configure the Template to delete the attachments that are saved after the successful execution of a Transaction based on that Template.

    The next screen differs depending on the chosen Source application.

  2. Uncheck the Partner will define this step (if checked) checkbox and then select the Source application account. You can click Test to test the connection to your account.

    Info
    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 C: Supported Applications.

    You can also allow the Partner to define this step by clicking Partner will define this step check box. The Partner will define this step while Creating a Transaction using this Template.



  3. Click Next.

  4. Select the trigger from the drop-down list and On the Choose Trigger screen, select the trigger event to trigger the data transfer and click Next.

    Info

    The list of triggers differs for selected Source application. For the complete list of triggers of the supported applications, refer to Appendix C: Supported Applications.


  5. Click Next to add the configuration details.

  6. Provide the configuration details of your account.

    You can allow your partner to define this step by selecting Partner will define this step check box. Partner will define these steps while Creating a Transaction using this Template.

    Info
    In case you have selected Content/Context based routing then only company can define this step.


    Info

    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.Image Removed


    Field Name

    Description

    Folder LocationFolder location from where to pick files.
    Process all the existing records/filesTo process all the existing files from the specified location.
    Send mail notification for no data on triggerSelecting this option will send the mail notification whenever there is no data found on trigger.
    Send mail notification for error on triggerSelecting this option will send the mail notification whenever there is an error on trigger.
    Delete file on successDelete the file once it is processed.
    File typeFile format to process the files. Multiple file formats are separated by a comma. Use *.* to process all file formats.
    File excludeType 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 boxFile Stable TimeYou 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
    field.
    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.

    Image Modified

    CRON EXPRESSION: Define the specific time schedule for the Transaction to trigger. For more information on how to define Cron Expression, click here.

    Image Added
    Image Removed

    Info
    • It is mandatory to define the first cron expression, if you have selected cron as a Trigger type. For example, if you have set a calender event to run every 5 minutes from Monday to Sunday, you can set the cron expression as "0 0/5 * ? * MON, TUE, WED, THU, FRI, SAT * ".
    • You may make use of the second cron expression to define another condition or address a condition supplementary to the first one. For example, if you have set a calender event to run every 5 minutes from Monday to Sunday, but do not want the same event to run from 12 AM to 12 PM on Sundays, the second cron expression can be defined as "0 0/5 13-23? * SUN * ". 
    • The firing schedule you define in the second cron expression must not overlap the one defined in the first cron expression.


    File Stable Time

    Provide the waiting time (for the file to become stable) after which the trigger happens. 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.  

    Info
    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.

    Image Modified

    The Source application account and configuration details screen differ depending on the chosen Source application.

  7. 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  option in the Action on Misfire Event drop-down list field. If you do not wish to enable misfire handling for your file event then, select the 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 field lists the APIs to connect to the FTP Server.  The options changes 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 Factory

    SFTP

    J2SCH (VFS) 
    Secured Inet Factory 
    J2SSH

    FTPS

    J2SCH (VFS) 
    Secured Inet Factory

    Select 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 in the Connector field.

  8. Click Next to define the Routing Criteria. This is applicable only if you have selected context based routing as a Routing Type.

  9. Select the routing criteria based on which different data files will be sent to the Partners. 

    CriteriaConditionParameter
    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:

    1. Select the file name from the Criteria drop-down listin the Criteria field.

    2. Select the type of condition from the Condition drop-down listin the Condition field.

    3. Enter the parameter name in the Parameter field.

    4. 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 field then Transaction will fetch all the records containing CUST147 only such as CUST147.txt, CUST147.docx. 

  10. Click Next to select the source layout and format. This screen appears only if you have selected a file application, for example, FTP, Google Drive or REST WebHook application. 

  11. Select the source data format and source data layout for the Source application. Source data format is the format in which the data of the source file exists, for example, text, excel. Source data layout is the layout of the source file. You can either use the existing layout or create a new layout. To create a new layout, click . For more information, refer to Layouts

    You can also allow the Partner to define this step by clicking Partner will define this step check box. The Partner will define this step while creating a Transaction using this Template.




    Once you select this option, you need to follow the steps given below: 

    1. Select Auto generate layout name and description checkbox if you want to auto generate the activity name and description while creating the Transaction. You can not change the automatically generated name and description.

      The defined format of the auto generated name and description are explained below:


      Name : Layout_transactionId_sequenceId
      Description : Layout_transactionName

      Info
      By default, this checkbox is enabled for Create New and Select from the List or Create New policy and disabled for Default policy.


    2. Select the type of access policy from the drop-down listin Access Policy field. It helps the user to define the policy to displays the activity at the time of creating the transactions by another user of the same partner. The following policies are:

      • Default Policy : Using this policy, user can view all layouts and also can create a new layout while creating a Transaction.
      • Create New : User can only create a new layout while layout while creating a Transaction. No layout is displayed from the drop-down list of layout field. 
      • Select from the List or Create New : Using this policy, user can create a new layout or user can define a custom list of layouts which will appear at transaction end.



        You can select the type of schema like Text, Excel, etc. from in the drop-down list of  Schema Type field. You can also search the schema from the Search box.

  12. Click Next to define the subsequent source application. This screen appears only if the Process Flow is using multiple source applications. 

    Info
    You can choose from the following applications only - Database, Email, FTP, File, and JMS.


  13. Repeat all the above steps to define the subsequent source application(s). You can also allow your Partner to define this step or all steps of the application by clicking Partner will define this step check box. The Partner will define this step while creating a Transaction using this Template.



  14. Click Next to provide the definition of other activities, if any.

    The next step differs depending on the selected process flow. If the process flow has content based routing activity then in the next step, you need to define the routing else define the Destination application.

    Next Step

    Defining the destination application of the Template

    Defining a Custom Outbound Routing