Starting a Process from Outside of Questetra BPM Suite (Preparatory Chapter)

• Starting a Process from Outside of Questetra BPM Suite (Preparatory Chapter)
• Starting a Process from Outside of Questetra BPM Suite (curl Chapter)
• Starting a Process from Outside of Questetra BPM Suite (Python Chapter)
• Starting a Process from Outside of Questetra BPM Suite (Error Chapter)

Starting a Process by Curl Commands or External Programs

When you want to Start a new Process in Questetra BPM Suite you usually follow a procedure like log in, then open the Start page and so on. However, if you set a Message Start Event (HTTP) in a Workflow App you can start a Process by sending an HTTP request from a curl command or your own program. This makes it possible to automatically start a Process without human intervention, and to build cooperation between systems.

The Message Start Event (HTTP) is, just like a normal Start Event, placed and used in the Workflow diagram. A user starts a new Process by clicking the “Start and Operate First Step” button manually for a Start Event, whereas with a Message Start Event (HTTP) a Process will be started when it receives an HTTP request from an external system. An endpoint is given to each Message Start Event (HTTP), and it can be used from the external system.

In this series of posts I will deal with the following content.

• Settings of Message Start Event
• Settings of IP Address Filter
• Starting a Process using Curl Command
• Starting a Process using Python

In this post I will cover up to doing Settings of IP Address Filter.

Settings of Message Start Event (HTTP)

To see how a Message Start Event (HTTP) works let’s create a simple App. Create a new App, then draw a Workflow diagram like the following figure. The Message Start Event (HTTP) icon is listed in the Start Event category in the advanced palette.

Concerning Data Items, only a Title is required for the moment, and for Data editing permissions, in the Message Start Event (HTTP) set the Title to “Editable”, and in the Check Task set it to “Only display”.

By default the Swimlane will be set to your account, so you can leave this as it is.

Once you’ve finished making the above settings save the App and release it. By doing this the endpoint is determined. In the Workflow diagram on the App details screen open the Message Start Event (HTTP) properties and you should be able to click the URL / Parameter Details button. Click it to open the Message Start Event (HTTP) Detail screen where you can confirm the endpoint URL and the Parameter names.

Setting the IP Address Filter

Let’s learn how to register the IP address used to access the endpoint to Questetra BPM Suite. With the default settings, all access to the Message Start Event (HTTP) from external networks is denied.

To go to the IP address filter settings, go to the System Settings and in the left menu under the Security section click on IP Address Filtering. Let’s set the access permissions for the Message Start Event (HTTP) of the App you created earlier.

Specifying Path Prefix

You can set the IP address filter for each path prefix. To restrict the IP address to a specific Message Start Event (HTTP) add an item Message Start Event (HTTP) – a specific node. You can select it in the pull-down menu in Path Prefix in the “Message Start Event/Receive Task Configuration” section. A Path Prefix for a particular node is as follows.

The processModelInfoId part refers to the number assigned to each application, and nodeNumber refers to the number assigned to each node on the workflow diagram. Since these two numbers are also included in the endpoint URL of the Message Start Event (HTTP), I recommend you check them. For example, if the endpoint URL is;

the processModelInfoId is 8, and the nodeNumber is 0. Confirm the endpoint URL from the workflow diagram on the app detail screen.

Another way to confirm the App ID is available, since the processModelInfoId is equal to the App ID without the “m”. For the nodeNumber, it is indicated on the properties screen of each node on the Workflow diagram.

Specifying IP addresses to permit access

You can specify an IP address to permit for each Path Prefix. Please enter the IP address in the following manner.

• Enter a global IP address.
• Please use IPv4 as IPv6 is not supported.
• Specification of IP address can be both single and ranged.
  • Please use a Subnet Mask for ranged specification. (e.g. 69.208.0.0/22)
• Access from all global IP addresses is permitted if 0.0.0.0/0 is specified.
• Access from all global IP addresses is denied if nothing is specified (blank).

In addition, longer Path Prefixes are preferentially applied to the IP address filter settings. For example, even if 0.0.0.0/0 is permitted for the Global Configuration and for a /System/-level Path Prefix, if a stricter IP address filter is set for a specific node, the setting to that node will be applied. The order of the setting items does not affect the priority. Let’s try setting a narrow range of access permissions, such as a single IP address to the Message Start Event (HTTP) of the App you created earlier. Then open the Message Start Event (HTTP) Details through the Workflow diagram and confirm the Allowed Hosts/Networks. You see that the settings value has been applied preferentially since the Path Prefix is longer than the other settings items.

At this point, we are ready to start the Process from outside. In the next post, I will mention methods of starting a Process, even without a browser, from a command line using Curl command.

Next: Starting a Process from Outside of Questetra BPM Suite (curl Chapter)

Appendix: Details of IP address filtering settings

Enabling/disabling of IP address filtering

It can be set using the Enable IP Address Filtering checkbox. When you uncheck the box to disable it the following settings items will vanish since filtering is not performed. Basically, please do not disable it.

Global Configuration

You can specify an accessible IP address for your entire Questetra BPM Suite environment. The access permission here also applies to icons and events other than the Message Start Event/Receive Task.

Message Start Event/Receive Task Configuration

You can specify the access permission to a range finer than the Global Configuration. As we used the Message Start Event (HTTP) in this article, you can select from;

• all
• Message Start Event (HTTP) – all apps
• Message Start Event (HTTP) – a specific app
• Message Start Event (HTTP) – a specific node

The Path Prefix will not be determined until the target App is created if using “- a specific app”, and until the App is Released if using ” – a specific node”. The format of the Path Prefix is as the following.