The Context tab displays all of the app's properties. Each property corresponds to a separate field where users enter data on the Create, View, and Edit pages. Each field is used to enter data of a specific type. For example, the Contractor field property has the Full Name type. On the app page, it will appear as a field for entering the contactor’s full name.
Add a property
You can add new properties and specify if you want them to be used amongst the parameters in the app item search. To do that, click +Add and fill in the fields:
- Display Name*. Name of the property that will be displayed on the create, view and edit pages of app items.
- Property Name*. Property name used when working with APIs, scripts, tables, etc. The value for the field is generated automatically. Please note, that you can change it only when creating the property.
- Tip. Additional information that explains how to fill in the field on the create, view, or edit page. For example, Choose from the list or Enter the phone number in the following format: +49 2ХХ ХХХ ХХ ХХ.
- Type*. Property type, for example, String, Date/Time, Files, etc.
- Search and sort by field. If you check this box, the property will be used in advanced search of app items. For every app property with this option enabled, an index is created in the PostgreSQL database.
- Full text search. The value of the property will be used in full text search. This option only becomes available for fields of String type in case you have checked the previous option.
- Set a formula for the field. This option is only available for String, Number, and Money types. You can specify a formula so that the value of this field is calculated automatically. For more information, see Calculated fields.
- Show only when a condition is met. You can hide or show certain fields depending on the conditions that you specify. For more information, see Calculated fields.
Please note that the set of fields in this window may differ depending on the selected property type.
After you have filled out all the fields, click Create.
The added property can be edited. To do this, click on its name, make changes, and save them.
Delete a property
There are two ways to delete a property:
- Soft deletion. It allows you to restore the property later. After such deletion, the code specified in the property name is saved. You will not be able to create a new property with the same code.
- Permanent deletion. It permanently deletes the property and its code specified in the property name. After that, you can create a new property with the code that was used in the deleted variable.
Bulk actions can be applied to either method. Hold down the Ctrl key on your keyboard and select the properties you want to delete.
Soft deletion
Select the property from the list and click Delete in the upper right corner of the window.
To restore the property, enable the Show deleted variables option, select the desired property from the list that appears, and click Restore.
Please note the properties from the list of deleted variables:
- Are not exported together with the app to another company.
- Are retained in subsequent versions of the app.
If a property is added in a specific version of the app, it will remain soft-deleted in previous versions of the app.
Permanently delete property
You can permanently delete a property without the possibility to recover:
- First, check that the property is not used in business processes, widgets, scripts, or other apps.
- In the Deleted variables list, select the desired row and click Delete in the upper right corner of the window.
- If the current app contains items, a window will appear for exporting them to prevent data loss. Select an action:
- Export data now. A form for exporting app data will open.
- Continue anyway. Proceed to delete the property without exporting data.
- In the window that opens, confirm the property deletion.
Please note that permanently deleted properties are not saved in any version of the app.
After making all changes, save the form settings.
Features of context saving in app versions
If app versioning is enabled in the system, a new app version is created each time its context is changed. You can restore the previous app version to make it the current one.
The following rules apply to variables in the app context:
- An added variable is saved in subsequent versions of the app. When restoring a previous version where this variable did not yet exist, it will be marked as soft deleted.
- If you delete a variable:
- A soft-deleted variable is saved in subsequent versions with the option to restore it. The code of such a variable cannot be used to create a new variable.
- A permanently deleted variable and its code are not saved in any version of the app. You can create a new variable with the same code.
Let’s look at a step-by-step example of restoring previous versions of the app.
App versions |
Action sequence |
Changes in the app context |
Version 1 |
Create an app. |
- |
Версия 2 |
Add variable A to the app context. |
Variable А is added. |
Version 3 |
Restore app version 1. |
Variable A is marked as soft-deleted as it is not found in version 1. |
Version 4 |
Add variable B to the app context. |
|
Version 5 |
Restore app version 2. |
|
Found a typo? Select it and press Ctrl+Enter to send us feedback