What is Request Data?

Understand how Requests are represented in ProcessMaker Platform.


While ProcessMaker Platform is a low-code, intelligent BPM platform for enterprises, our goal is to deliver simplicity, but to allow complexity. ProcessMaker Platform is easy to use, and allows you to design customized processes and end-user experiences without understanding what Request data is. However, understanding how Requests are represented in ProcessMaker Platform takes your designing potential to the next level.

Before discussing the foundation for Request data, let's understand what Request data is. Each Request can be unique even though it was started from the same Process. Each Process is designed to determine business decisions based on information in each Request. Below are a few examples that may cause each Request to be unique:

  • Different users participate in each Request. Different users may be authorized to start Requests for a Process (called Request starters). Requests may even be started anonymously via a website or portal.

  • Each of these Request participants enter unique information into each Request. Information is entered into a Request via a Task. Each Task displays a Screen that allows each Request participant to enter information, read information, and/or make business decisions such as approving or rejecting requests based on information entered in previous Tasks.

  • Based on information entered into each Request, workflow routes differently. One Request for a Process may route to one user, but route to a different user for another Request because of information entered into each Request. For example, in a purchase request Process, if the total amount for a purchase request in one Request is $500, but in a different Request that total amount is $10,000, then each Request may route to a different user for approval based on business decisions designed in that Process on the total cost on items for purchase.

  • Scripts that run during a Request may call external data sources, such as Application Program Interfaces (APIs), or run an application, and then return data that affect how each Request routes.

  • Each Request may access information stored in a Collection that affects how each Request routes. Functioning similarly to a database, Collections provide ease and flexibility to design custom data views for information storage and reporting without integrating into an organization's IT infrastructure.

As each Request routes, ProcessMaker Platform accumulates data that represents and contains the information entered into each Request. As data accumulates for each Request, this data affects how each Request routes through the Process. Your user account may allow you to view and edit the accumulated Request data.

Understanding how ProcessMaker Platform represents Request data allows you to design more robust ProcessMaker Platform assets, including but not limited to the following:

  • Design Processes that route workflow in complex ways, such as synchronizing parallel workflow to one point in each Request so that Request participants may complete Tasks before determining further business decisions.

  • Design how Screens display information in Tasks, such as displaying options derived from that Request or a third-party data source in a multi-select Select List control.

  • Monitor when specific information is entered into a Task's Screen, then run a Script or call an external data source.

  • Develop how Scripts run in Requests, such as manipulating Request data and/or calling a third-party API based on Request data.

  • Use Request data to change a Collections and vice versa.

pageWhat is a Request Variable?pageWhat is a Request?pageWhat is JSON?pageWhat is a Task?pageWhat is a Screen?pageWhat is a Script?

Last updated

© Copyright 2000-2024 ProcessMaker Inc. All rights reserved.