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. Workflow-Sample
- 2017-01-10 (Telephone survey Process): Episode 517: Method of Starting up a Large Number of Workflows
- 2015-07-21 (Acceptance of Updated Information): Tributary in Each Subsidiary Merges to Form Mainstream
- 2015-04-27: Cooperation of Invoicing Flow and Accounting System
- 2015-04-13: Platforming the Translation Workflow
- 2015-03-02: Outsourcer - Outsourcee, Cooperate Workflow Platform
- 2015-02-09: Workflow Starts Automatically at '3,2,1, Action!'
- 2014-12-22: Using SaaS Workflow for Backend of Smartphone App for Business
- 2014-12-15: Labor Saving of Mailing Work, the Backend for it
- 2014-11-25: Importing the Records of Decision-making of the Past in Bulk
- 2014-10-06: Data Structure of an 'In-house Questionnaire' that Gathers n Answers to One Project
- 2013-12-02: Processin Business Data in Child Process (Translating) (Document Translation flow)
- 2013-05-31: Automation for Invoice PDF (Invoicing flow)
- 2013-04-08: Age of Cloud-based Workflow Capable of Running Even a Core System of 1 Million Dollar Worth (Orders-Operation-Bill Issuance)
Comments
0 comments
Please sign in to leave a comment.