If you would like to upgrade to a newer long-term support version of Studio Pro, see Moving from Mendix Studio Pro 8 to 9.
Constants
Introduction
Constants are used to define configuration values. These can differ per environment.
When running the application on a licensed Mendix Cloud environment, SAP BTP, or Private Cloud you can configure the constant values for each environment separately using the Model Options tab of the Environment Details page to set your constants.
For other cloud environments – for example, Insights Hub – the constants can be accessed as Environment Variables in, for instance, Cloud Foundry. The constant is exposed with the name module + . + constant (for example, mymodule.myconstant
).
When running the application locally or in a Free App environment, the values defined in Studio Pro are used.
Constants can be used in the following:
- Expressions – by prefixing the full name of the constant with
@
- Consumed web services – in this case, the constant is a URL that specifies where the web service is located; this can vary based on the environment in which the application is running, so that you can, for example use different web services for development and production
Common Properties
Name
The name of the constant. This name is used to refer to it.
Documentation
This field is for documentation purposes only: end-users will never see it, and it does not influence the behavior of your application
Type Properties
Type
The data type of the constant. This determines what kind of values a constant can hold. Supported data types are string, Boolean, date and time, decimal, and integer/long.
Value Properties
Default Value
This property is the default value of the constant. This value is used when running locally or in a Free App environment. When running locally, the value can be overridden in the currently selected configuration.
Exposed to Client
This property defines whether the constant is accessible from client-side expressions (expressions in nanoflows and pages).
Option | Description |
---|---|
Yes | The constant will be sent to the client and will be accessible from client-side expressions |
No (default) | The constant will not be sent to the client and will be only accessible from microflow expressions |
When a constant is exposed to the client, Mendix Runtime sends its value to the client so that in addition to microflow expressions, it will also be accessible from nanoflows and page expressions. This means that you should not use sensitive data or secrets such as passwords when a constant is exposed to the client.
For a web or hybrid online app, changes to constant’s values are reflected when a user refreshes the browser or restarts the app. For an offline-first application, the app stores the constants’ values for offline use. The app updates the constant’s values in the following cases:
- When a user logs in or logs out in the app.
- When you deploy a new version of the app that contains domain model changes used in the offline-first app.