Skip to main content

Data label collections

A data label collection is a subset of a data label category. It can contain all labels of the category, several of them, or just one. A label can belong to any number of collections.

Collections serve two purposes in your app:

note

A collection always contains labels of a single category.

Prerequisites​

  • A Nooxl App is open and Design mode is active ().
  • The target data label category has at least one label.

Create a collection​

  1. Open Data and labels and enter Design mode.
  2. Next to the category, click the collections icon to list its collections.
  3. Click the red plus () to open the create dialog.
Create data label collection dialog with category, choice type and Save
  • 1 Select the category (the dialog prefills the name with the category name).
  • 2 Choose the selection type (see below) and add the labels.
  • 3 Click Save.

Selection type​

TypeBehavior
All labelsAlways contains every label of the category, including labels created later.
One labelExactly one label; the collection is renamed automatically to that label.
Selected labelsA chosen subset; you can sort the labels by different methods (default is their order/rank).

Grant permissions​

If Grant permissions is enabled, users who can view a model that uses the collection automatically get access to all included labels. If it is disabled, you must grant label access explicitly in Collaboration.

Edit or delete a collection​

  1. Open Data and labels → category → collections icon.
  2. Click Edit data label collection to change it, or open it and use the trash can icon to delete it (only possible when it is not locked — see below).

Use Clean up on the collection list to delete all unused collections of a category at once.

Usage and locking​

A collection tracks where it is used. In the collection dialog you can see the usage count and open a usage dialog that lists the models and cell storage sections that reference it.

Locking behavior:

  • Using a collection only as a dataset selection does not lock it — it stays fully editable.
  • A collection becomes locked once it is used by a section (markup) in a published template version. While locked, existing labels cannot be removed (you can still add labels).

Screenshot placeholder

  • 1 The usage count and lock indicator.
  • 2 The usage dialog lists the model and the storage section.
note

To change a locked collection's labels, the depending published template version must be revised first. See revisions.