Low-code designer > App builder / Counters

Counters

Counters are sets of rules for generating serial numbers of app items. For example, they can be used to generate item names by template.

Counters can be configured for workspaces and for apps. Workspace counters are used for continuous numbering of items stored in several apps within a workspace, whereas app counters are applied to items within one app.

начало внимание

If a workspace counter is used for numbering in several apps, these apps cannot be exported individually.

конец внимание

Workspace counters

A counter created within a workspace allows for sequential numbering of items across multiple apps. To create a workspace counter:

  1. Click the app gear icon icon next to the workspaces name and select Counters.

counters 2

  1. On the page that opens, click + Counter.

counters 3

  1. Fill out the fields:

counters-3

  • Name*. Enter a name for the counter, for example, Agreement counter.
  • Start value*. Specify the value that numbering will start from, for example, 1.
  • Increment*. Specify the value by which numbers will be incremented. For example, if the increment is 1, numbers will be assigned in the following sequence: 1, 2, 3, 4, etc.
  1. Click Create to apply the changes.

counters-4

  1. Within the workspace, open the apps that you wish to link with continuous numbering. In the settings of each app, specify the created workspace counter.

To set different numbering for separate groups of apps, configure multiple counters in the workspace.

App counters

A counter in an app assigns sequential numbers to items recorded in the Index system field from the app context.

By default, every app has with a counter with a increment of 1. You can edit it: adjust the increment, set the next number and the method of assigning numbers, and also establish continuous numbering with other apps. To do this:

  1. Click the app gear icon icon next to the apps name and select Counter in the menu.

counter-4

  1. In the settings window, choose the type of counter that you want to use and configure its settings:

counters-6

  • App. The numbering of items is carried out within the app:
    • Increment*. Specify the increment with which numbers are assigned to items.
    • Next number. The value from which numbering will start or continue. It can be changed.
    • Assign an index number when creating an item. Enable this option so the number is assigned at the moment the item creation form is opened, not after saving it. For example, to ensure the items name, including its number, is formed immediately and does not change after saving. The number is considered used, even if the user closed the creation form. Therefore, enabling this setting may result in gaps in numbering.
  • Workspace. Configure continuous numbering for items of multiple apps within the workspace:
    • Counter*. Specify the counter created for the workspace. Its settings will be used for the numbering of items in the app.
    • Assign an index number when creating an item. Enable this option so the number is assigned at the moment the item creation form is opened, not after saving it. The number is considered used, even if the user closed the creation form. Therefore, enabling this setting may result in gaps in the numbering.
  1. Click Save.

The counter settings will be applied for all subsequently created items.

Edit counter settings

After saving the settings, sequential numbers are automatically assigned to app items. You can edit a counter.

For the app, change the settings as described in the App counters section.

To edit the counter created for a workspace, click the gear icon next to the workspace name and select Counters. Open the counter from the list, edit its name and increment, then click Save.

counters-7

The new settings will be applied for assigning numbers to new items.

Set the next value

You can manually set the sequential number from which numbering will continue. For example, to reset the numbering, you can set the value to 1.

For an app counter, go to its settings and in the Next number field, click Edit. Enter the new value and save the settings.

For the workspace, go to the list of counters. Next to the counter name, click the three-dots-task-icon icon and select Set Next Value.

counters-8

In the window that opens, enter the desired Next number* and click Set to apply the changes.

counters-9

Continuous numbering of items will continue from the specified value.

Found a typo? Highlight the text, press ctrl + enter and notify us