Trading Networks 10.3 | Administering and Monitoring B2B Transactions | Managing File Transfers with ActiveTransfer | Managing Events | Executing a Trading Networks Service
 
Executing a Trading Networks Service
Prerequisites:
*If you need to send large files to Trading Networks, configure your target Trading Networks appropriately. For details on how to configure Trading Networks to process large files, see the Trading Networks documentation.
*For remote installations of ActiveTransfer and Trading Networks, list the remote server aliases of the remote Trading Network instances in the parameter mft.aliases.tn. For details on mft.aliases.tn, see mft.aliases.tn.
*If you have ActiveTransfer, list remote server aliases of ActiveTransfer nodes in the parameter mft.group.aliases. For details on mft.group.aliases, see mft.group.aliases.
Use this procedure to create an event action that sends a file to Trading Networks for processing. For details on how ActiveTransfer and Trading Networks file transfers work, see How does ActiveTransfer work with Trading Networks?.
*To execute a Trading Networks service
1. In My webMethods: Administration > Integration > Managed File Transfer > Event Management.
2. Select the server instance. For details, see Selecting the Instance to Work With.
3. Click the tab containing the event for which you are creating the file operation action (Post-Processing Events or Scheduled Events).
4. Select the event in the event list.
5. In the Actions section, click the Select Action list.
6. In the resulting dialog box, click the Select Category list, and then select Execute Trading Networks Service.
7. In the Select Type box and do one of the following:
*If you want to execute the Trading Networks service wm.tn:receive to process XML document types, select XML.
*If you want to execute the Trading Networks service wm.tn:receive to process EDI document types, select EDI.
*If you want to execute a particular Trading Networks service to process flat file document types, do the following:
1. Select Flat File.
2. In the Package box, select a package.
3. In the Service box, select your document gateway service for processing and sending the flat file to Trading Networks.
For details on flat file processing, see the Trading Networks documentation.
Note:
If you are submitting flat files to a remote Trading Networks instance, you must have the document gateway service defined on your local Integration Server. This local service is used for the configuration of input and output parameters in My webMethods Server. For details on the document gateway service, see the Trading Networks documentation.
8. Click OK.
9. In the Source Filter box, enter the name of the file whose transfer will trigger this event. By default, ActiveTransfer Server considers all files.
Note:
You can use wildcard characters to filter the file names. For example, enter *.zip to trigger the event only when zip files are uploaded or downloaded. To trigger an event based on a name string in the zip files, use the name string in the Source Filter box, preceded and followed by wildcard characters. For example, enter *invoice*.zip to trigger the event based on the file URLs, when zip files containing the character string invoice in their file names are uploaded or downloaded. If you define a Source Filter for an action, the action acts only on the files that are filtered out.
For information on the use of wildcards in ActiveTransfer Server, see Use of Special Characters in Search.
10. If you want to use regular expression in the source filter, specify a valid regular expression in Source Filter and select Use regular expression.
Examples for regular expressions:
(.(?!purchaseorder))*
Excludes files with the file URL containing purchaseorder
.*/out/.*
Include files with the file URL containing the folder out
^abc(.*)123$
Includes anything that starts with abc and ends with 123. Matches abc123, abcxyz123, but not abcxyz123def
NEW-((*.doc)|(*_backup_*))
Includes anything starting with NEW- that either ends in .doc, or is followed by the string _backup_
11. In the Configure input to IS service section, specify values for the input parameters of the Trading Networks service that you selected, and add any content types as required, respectively. For more information about the Trading Networks services and their signatures, see the Trading Networks documentation.
Note:
ActiveTransfer post-processing and scheduled events on remote Trading Networks does not support TN_params document type as input for the Trading Networks Service action execution. For Flat File documents, the input parameter field supports only String values for services.
12. In the Extract Service Output section, list the variables that you want to assign to the output parameters of the service and the path (iData path) of the output parameter.
13. If you want to execute an error action if the file operation fails, select Execute error action.
14. Click Save.
15. If you selected the Execute error action check box, define an error action as described in Defining an Error Action.
16. If you are finished defining actions for this event, activate the event as described in Activating an Event.
Result:
The “Execute a Trading Networks Service” action, runs the specified Trading Networks service for each file in the list that is passed on to the action by the previous action. This action does not modify the list of files from the previous action.