Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles / workflow

Trigger Infor ION Workflow from an External Application

0.00/5 (No votes)
6 Feb 2023CPOL2 min read 3.1K  
Integrate/trigger your workflow with an external application using ION APIs
In this post, you will see how to take the help of ION APIs to integrate/trigger your workflow with an external application.

It is a very common scenario to integrate/trigger your workflow with an external application. With the help of ION APIs, we can do this.

The Context

Image 1

Infor ION WF

Firstly, let’s create a very simple WF which will send a notification to the user.
  1. Login to the ION Desk.
  2. Go to the Workflows menu in the Monitors and Workflows section. Then, Add New Workflow
  3. Give it a name KG_WF_TriggerFromApp and fill in the Description if you want.
  4. Click on the Start Icon in the WF designer canvas to see the Workflow properties. Add the below two parameters:
    Name Type Input
    PurchageOrderNo STRING YES
    SourceApp STRING YES
  5. Drag and drop the Notification function between Start and End of the workflow. Provide the following configuration in the Notification Properties section.
    1. In the Notification Tab:
      1. Give it a name.
      2. Enter the message, like “You have received a purchase order from [SourceApp]”. You can select the parameter SourceApp by hitting CTRL+SPACE in the message text box.
    2. Go to the Content tab and select the two parameters we created from the left table and add them to the right table. This is to include values of parameters in the notification.

      Image 2

    3. Go to the Distribution tab and add the User to be notified.

      Image 3

  6. Save the WF and activate it.

Infor ION API

Infor ION API provides a POST API under IONProcessApplicationServer to start a workflow. The API has two required parameters:

  1. logicalId - to differentiate the application
  2. StartWorkflowJSONBody – to specify WF Name, instance, input variables and structures.

    Image 4

Invoking the API

In this example, I’m using the Postman client to mimic the external call. Refer to my post to configure the Postman to call ION APIs.

  1. Create a new POST request in the Postman client.
  2. Paste the API endpoint from the ION API documentation. The URL is similar to https://[ Your CloudSuite URL and Tenent ]/IONSERVICES/process/application/v1/workflow/start.
  3. Add a Query Parameter as:

    Image 5

  4. Go to the Body tab and add the following JSON payload and Send.

    Image 6

The Output

  1. Postman response.

    Image 7

  2. Workflow instance from the ION Desk.

    Image 8

  3. The notification in my Inbox.

    Image 9

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)