ProcessMaker API Documentation
ProcessMaker Examples

What is an Environment Variable?

Understand how to use Environment Variables in ProcessMaker.

Overview

In ProcessMaker, an Environment Variable is a secure, abstract proxy for any sensitive information that you need to use in a Process. Any Environment Variable can be re-used in any Process to abstract information securely throughout your organization.

You do not need to know the sensitive information that the Environment Value represents. The Process Owner creates the placeholder for that sensitive information, and then the value for the ProcessMaker Environment Value is entered or read via a Script during a Request.

Below are a few examples how to use Environment Variables:

  • A Request participant's username and password may be entered into a Screen as part of a Task that passes each Environment Variable's value securely to a third-party service.

  • A Request participant's credit card information securely interacts with an online payment processing service through multiple Environment Variables.

  • A Request participant's banking information securely interacts with a bank to make transactions securely while following compliance protocols.

ProcessMaker has default Environment Variables:

Environment Variable

Description

HOST_URL

Domain for the ProcessMaker instance.

API_HOST

ProcessMaker instance API to which to make all our RESTful API calls.

API_TOKEN

Token a Script uses to authenticate to our API host. Note that this API token is only valid for the lifetime of the Script: after the Script runs and the Script Executor's Docker container from which that Script ran, its API token is no longer valid.

Use a Script to get the value of these Environment Variables. See Environment Variable Syntax, Usage, and Examples.

Related Topics