Links

Example: Query Data Stored in Web Entries

Follow an example that uses the Allow Query String Data setting for Web Entries in Start Event elements.

Overview

Intended audience: Process designers, Web designers, graphic designers, software developers
Tags: Embed Code, Allow Query String Data, Web Entry, Start Event
This example demonstrates how to configure Web Entry in Start Events. Save your query string information in the Request data by using the Allow query string data setting. This use case can be useful when sharing a Web Entry with multiple participating stakeholders: the shared query string data is stored for different countries as this example demonstrates. If you do not want to show the URL information that could result complex to the users, with this use case you can embed the Web Entry in a HTML file.
Follow these guidelines to use the Allow query string data setting for a Web Entry in a Start Event element:
  1. 1.
    Design a Form-type Screen with two Line Input controls and a Submit Button control.
  2. 2.
    Use the Variable Name setting values for the Line Input controls as Code and Name respectively as shown below. For this example, exclude the value for the Line Input control that has the Variable Name setting Code.
  3. 3.
    Design a Process with the following elements:
  4. 4.
    Assign your created Screen to the Start Event element as Web Entry and the Form Task element.
  5. 5.
    Configure the Web Entry in the Start Event element as follows:
    1. 1.
      In the Mode setting, select Anonymous.
    2. 2.
      In the Screen Associated setting, select a screen to display for the Web Entry.
    3. 3.
      In the Completed Action setting, select Screen.
    4. 4.
      In the Screen For Completed setting, select a Screen that displays after the Web Entry is submitted.
    5. 5.
      Check the Allow query string data setting, and it automatically save your string data information when running a request, otherwise, additional information in the URL will not be stored.
    6. 6.
      In the Web Entry URL setting, click Copy to use the URL to start a Request.
  6. 6.
    Start a Request of this Process.
When starting a Request through this Start Event element using the Allow query string data setting in this example, the Web Entry uses the following URL https://{ServerURL}/webentry/15/node_9?country=usa. {ServerURL} is the name of the ProcessMaker instance. The information after the quotation mark country=usa stores in the Data section as follows:
The HTML file with the embedded code can be as follows:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="Content-Security-Policy" content="frame-ancestors http://{ServerURL}">
<title>Document</title>
</head>
<body>
<iframe src="http://{ServerURL}/webentry/15/node_9?country=usa" frameborder="1"></iframe>
</body>
</html>