App parameters hold values that are used repeatedly in your application. They can be edited independently without editing the object where the app parameter is used. It means that once you configure a parameter, it can be managed in one central place and reused throughout the app.
To be able to use an app parameter in a DataPart, you need to define them in your app beforehand.
Note: As app objects, app parameter names must be unique within an app.
Steps to insert app parameters
- In the bottom left corner, select Settings.
- In the upper right corner, select the Create app parameter button.
- In the panel that opens:
- Enter the app parameter name.
- From a dropdown, select a parameter type: Text , Number, Date, Date/Time , URL.
- Enter the value for a parameter. For instance, you can add a footer disclaimer that can be used throughout your app.
- Optionally, you can provide a description of a parameter to note how and where this parameter is used.
- Click Create.
Once the app parameter is created, you can use it in your application.
Using parameters in your app
There are two ways to insert a parameter in your DataPart. You can do it with a parameter picker or by typing the query directly in the text.
To use a parameter picker, select the Insert Parameter icon that is available in all DataParts that accept parameters usage. Then, from a dropdown, select the parameter type and its value.
To insert a parameter manually, type it in the text area in the following format [@app:Parameter_Name].
Note: By default, parameters are rendered as a string. Formatting a parameter name changes its rendering and formatting.