By placing a [Message Start Event (HTTP)] (which is the mechanism for starting a Process triggered by an HTTP request) a new Issue that uses the request data will be automatically started every time it receives an HTTP request. For example, you can establish inter-system links, such as launching a "payment reminder process", from a core system.
1. Usage Examples of the [Message Start Event (HTTP)]
- a. Starting from Other Systems
- "Error Address Corresponding flow" will be Started automatically by the customer management system
- b. Launching from Other Apps
- Automatically pass the Order data in the "Contract flow" to the "Production flow"
2. Setting [Message Start Event (HTTP)]
- 1. Receiving Data Item
- Set the Data editing permissions in the [Message Start Event (HTTP)] Settings to Editable for all Data items
- After releasing the Model, you will be able to see the Starting URL (request URL) in the URL/Parameter Details found in the Event Settings. This must be used as the "Access URL" when using corresponding "Throwing" Events in linked workflows
- As a data receiving parameter, you can specify the [Field Name] set in the data item
3. Preparing the Data Transmission Mechanism (External Settings)
- 1. Request URI
- Specify App ID and Event Node number using the Parameter Details
- 2. POST body parameter
- Specify "API key" and "business data to be substituted"
$ curl https://sample.questetra.net/System/Event/IntermediateMessage/123/0/start \ -d "key=XYZXYZ" \ -d "data[0].input=foo" \ --data-urlencode "data[1].input=日本語"
- Request parameters can be either GET or POST (POST is recommended, GET is partially prohibited)
- File data are transmitted by POST multipart
- The use of the system variable ${var[applicationRoot]} is valid for communication on the same workflow infrastructure
- The value of the API key can be arbitrarily set
- It is possible to filter the source IP address for each triggering URL (M312)
R2182: Error Notification of HTTP Start
R2210: Naming Convention for Data Receiving Parameter
When using [Catching Message Intermediate Event (HTTP)], refer to "M226: Standing by HTTP Request".
Config. Items: Message Start Event (HTTP)
A. Corresponding with JSON-Webhook, etc.
- Place a [Message Start Event (Webhook)] at the beginning of the flow
Change the auto-start node from [Message Start Event (HTTP)] to [Message Start Event (Webhook)] - Set the receiving method
Specify the method and content-type (e.g. "POST application/json"、"PUT text/xml", etc.） - Set the storage location of the Body section
Specify String type multiple-line Data Item in which received data will be stored - Define the Response
Insert Issue data as necessary （"application/json;charset=UTF-8","text/xml;charset=UTF-8"）
- Even though it is possible to set patterns that are cannot be set with normal REST communication, it is not recommended (e.g. GET communication specifying Content-Type, etc.）
- In many cases, some automatic processing Steps are placed downstream to extract the necessary information from the received data
- Even if the Query parameter has been given [Message Start Event (Webhook)] ignores the query part
X. Tutorial
X. BPMN Icons
- 2019-04-05： Message Start Event (HTTP)
Comments
0 comments
Please sign in to leave a comment.