23.11 Manage legends

23.11.1 About legends

You can create, edit, clone, delete, show details and translate legends to make the maps you’re setting up for your users meaningful. You create maps in the GIS app.

Note

Continuous legends must consist of legend items that end and start with the same value, for example: 0-50 and 50-80. Do not set legend items like this: 0-50 and 51-80. This will create gaps in your legend.

23.11.2 Create or edit a legend

Note

It is not allowed to have gaps in a legend.

It is not allowed to have overlapping legend items.

  1. Open the Maintenance app and click Other > Legend .

  2. Click the add button.

  3. In the Name field, type the legend name.

  4. (Optional) In the Code field, assign a code.

  5. Create the legend items you want to have in your legend:

    1. Select Start value and End value .

    2. Select Number of legend items .

    3. Select a color scheme.

    4. Click Create legend items .

    Tip

    Click the options menu to edit or delete a legend item.

  6. (Optional) Add more legend items:

    1. Click the add button.

    2. Enter a name and select a start value, an end value and a color.

    3. Click OK .

  7. (Optional) Change the color scales.

    1. Click the colour scale to view a list of color scale options, and select a color scale.

    2. To customize a color scale, click the add button. In the Edit legend item dialog, click the color scale button and hand-pick colors, or enter your color values.

  8. Click Save .

Legend item Start value End value
Low bad 0 50
Medium 50 80
High good 80 100
Too high 100 1000

23.11.3 Clone metadata objects

Cloning a data element or other objects can save time when you create many similar objects.

  1. Open the Maintenance app and find the type of metadata object you want to clone.

  2. In the object list, click the options menu and select Clone .

  3. Modify the options you want.

  4. Click Save .

23.11.4 Change sharing settings for metadata objects

You can assign different sharing settings to metadata objects, for example organisation units and tracked entity attributes. These sharing settings control which users and users groups that can view or edit a metadata object.

Some metadata objects also allows you to change the sharing setting of data entry for the object. These additional settings control who can view or enter data in form fields using the metadata.

Note

The default setting is that everyone ( Public access ) can find, view and edit metadata objects.

  1. Open the Maintenance app and find the type of metadata object you want to modify.

  2. In the object list, click the context menu and select Sharing settings .

  3. (Optional) Add users or user groups: search for a user or a user group and select it. The user or user group is added to the list.

  4. Change sharing settings for the access groups you want to modify.

    • Can edit and view : The access group can view and edit the object.

    • Can view only : The access group can view the object.

    • No access (only applicable to Public access ): The public won’t have access to the object.

  5. Change data sharing settings for the access groups you want to modify.

    • Can capture data : The access group can view and capture data for the object.

    • Can view data : The access group can view data for the object.

    • No access : The access group won’t have access to data for the object.

  6. Click Close .

23.11.5 Delete metadata objects

Note

You can only delete a data element and other data element objects if no data is associated to the data element itself.

Warning

Any data set that you delete from the system is irrevocably lost. All data entry forms, and section forms which may have been developed will also be removed. Make sure that you have made a backup of your database before deleting any data set in case you need to restore it at some point in time.

  1. Open the Maintenance app and find the type of metadata object you want to delete.

  2. In the object list, click the options menu and select Delete .

  3. Click Confirm .

23.11.6 Display details of metadata objects

  1. Open the Maintenance app and find the type of metadata object you want to view.

  2. In the object list, click the options menu and select Show details .

23.11.7 Translate metadata objects

DHIS2 provides functionality for translations of database content, for example data elements, data element groups, indicators, indicator groups or organisation units. You can translate these elements to any number of locales. A locale represents a specific geographical, political, or cultural region.

Tip

To activate a translation, open the System Settings app, click > > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object you want to translate.

  2. In the object list, click the options menu and select Translate .

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. Select a locale.

  4. Type a Name , Short name and Description .

  5. Click Save .

23.11.8 Assign a legend to indicator or data element

You can assign a legend to an indicator or a data element in the Maintenance app, either when you create the object or edit it. When you then select the indicator or data element in the GIS app, the system automatically selects the assigned legend.

23.11.9 See also