› Integration › Import settings › Handle import events › Step 1: Create a process map to handle import events

Step 1: Create a process map to handle import events

Use the following procedure to create a process map that, when embedded into your main process map to identify whether the document is imported successfully and handle any unsuccessful document import.

Procedure
  1. Navigate to Workflow > Business processes and select New.
  2. Specify a Name for the process map such as Handle Import Events.
  3. On the Category list, select Default Category.
  4. Create a process variable, "ErrorMessage" of type String. See Create process variables.
  5. Create the following three process events: IMPORTRUN, IMPORTDUPLICATE, and CHECKEVENT. See Create a process event.
  6. Add the following three flows for the process map:
    1. Create a flow for a successful import event
    2. Create a flow for a duplicate import event
    3. Create a flow for a timeout

Create a flow for a successful import event

Use the following procedure to create a flow to signify whether documents are successfully imported.

Procedure
  1. Select the Start node and on the satellite, select the Activity icon Activity icon.

    An activity node is added.

  2. Select the activity node and enter a Name as Successful Import.
  3. On the Type list, select Synchronization.
  4. In the Activity properties panel, select the Dependents tab.
  5. Right-click in the rule editor and select Process events.
  6. In the events list, select IMPORTRUN.
  7. In the rule editor, set the condition as IMPORTRUN > 0.
  8. Select the Successful Import node and on the satellite, select the End icon Satellite - End node icon.

The process map may look similar to the following.

successful event

Create flow for a duplicate document import event

Use the following procedure to create a flow that triggers an event and prevents duplicate documents from being imported.

Procedure
  1. In the Handle Import Events map, select the Start node and on the satellite, select the Activity icon Activity icon.

    An activity node is added.

  2. Select the activity node and enter Name as Duplicate Import.
  3. On the Type list, select Synchronization.
  4. In the Activity properties panel, select the Dependents tab.
  5. Right-click in the rule editor and select Process events.
  6. In the events list, select IMPORTDUPLICATE.
  7. Select the Duplicate Import node and, on the satellite, select the Activity icon Activity icon.

    An activity node is added.

  8. Select the activity node and enter Name as Set Error Message.
  9. On the Type list, select .Net.
  10. Select Configure.

    The Configure .Net activity dialog box is displayed.

  11. In the Assembly file path box, select Default Category.
  12. On the Category list, select System Category and then select TotalAgility.Sdk.dll.
  13. On the Class list, select TotalAgility.Sdk.JobService.
  14. On the Method list, select UpdateJobVariables.
  15. In the Value box of the sessionId parameter, select Server variable and then select Default Category.
  16. On the Category list, select System Category and then select SPP_SYSTEM_SESSION_ID.
  17. Select for UpdatedVariable[ ].
  18. In the Id parameter value box, select ErrorMessage.
  19. Select the Edit icon next to the Value box of the Variable Type parameter and enter 8.
  20. Select the Edit icon next to the Value box of the Value parameter and enter a custom error message as Terminated due to import duplicate error, and then select OK.
  21. Select the Set Error Message node and on satellite, select the Activity icon Activity icon.

    An activity node is added.

  22. Select the activity node and enter Name as Terminate Job.
  23. On the Type list, select .Net.
  24. Select Configure.

    The Configure .Net activity screen is displayed.

  25. Repeat steps 11 to 16.
  26. Select OK.
  27. Select the Terminate Job node and, on the satellite, select the End icon Satellite - End node icon.

The process map may look similar to the following.

Duplicate import event

Create flow for a timeout

Use the following procedure to create a flow so that if no event (IMPORTRUN or IMPORTDUPLICATE) is triggered for a configured timeout, the process moves to the next node in the map.

Procedure
  1. In the Handle Import Events map, select the Start node and on the satellite, select the Activity icon Activity icon.

    An activity node is added.

  2. Select the activity node and enter Name as Timeout.
  3. On the Type list, select Synchronization.
  4. In the Activity properties panel, select the Time and cost tab.
  5. In Triggers, select for Process.
  6. In Target duration, select After and set the value of Minutes to 30.
  7. On the Process list, select Raise Event For Duplicate Import. See Create map for raising event.
  8. Select OK.
  9. In the Activity properties panel, select the Dependents tab.
  10. Right-click in the rule editor and select Process events.
  11. In the events list, select CHECKEVENT.
  12. In the rule editor, set the condition as CHECKEVENT > 0.
  13. Select the Timeout node and, on the satellite, select End icon Satellite - End node icon.

The final process map may look similar to the following.

Process map with the timeout event activity