Skip to content

Metadata management

nancyespinoza edited this page Feb 24, 2023 · 21 revisions

Content

Metadata Management

This guide will help you to edit, create or remove health areas, donors, projects and indicators. All of these are configured as option sets objects, thus it is necessary to have an user with access to edit, update and delete this type of object.

The following images are from servers 2.35 and above

Health Areas

For all the actions below follow the next steps to open the correct option set.

  1. Open Maintenance app.
  1. Open Option set menu (in Other section).
  1. Search for RDQA - Health Areas.

Back to top

Action: Update an existing Health Area

  1. In the Options section select the health area you want to update.

  2. Change the Name, Color or Icon parameter according to your needs.

  3. Save changes.

Back to top

Action: Add a new Health Area

  1. In the Options section click on ADD OPTION button.
  1. Add the name of the health area.

  2. Add the code. We recommend to use letters or letters and numbers.

  3. OPTIONAL - Select a color and Icon.

  4. Save new option.

For each health area it is necessary to create an option group which will contain all the indicators related to the health area created.

  1. Open Option group object.

  2. Click on the "+" button.

  1. Add a name and short name.

  2. Select RDQA - Indicators in the option set parameter.

  1. Select all the new indicators that are related to the health area.

  2. Save the option group.

Back to top

Action: Remove a Health Area

  1. Click on the 3 dot menu in the health area you want to remove.

  2. Select Delete option.

Back to top

RDQA Indicators

For all the actions below follow the next steps to open the correct option set.

  1. Open Maintenance app.
  1. Open Option set menu (in Other section).
  1. Search for RDQA - Indicators.

Back to top

Action: Update an existing Indicator

  1. In the Options section select the indicator you want to update.

  2. Change the Name, Color or Icon parameter according to your needs.

Back to top

Action: Add a new Indicator

  1. In the Options section click on ADD OPTION button.

  2. Add the name of the health area.

  3. Add the code. We recommend to use letters or letters and numbers.

  4. OPTIONAL - Select a color and Icon.

  5. Save new option.

We recommend to create an "other" indicator if there is a new health area. This will prevent blocking the data entry in case the user can't find the indicator to assess.

  1. Exit the option set and open Option group object.
  1. Select the health area group that the indicator belongs to.

  2. Add the new indicator to the list and save changes.

Back to top

Action: Remove an Indicator

  1. Open Maintenance app.

  2. Open Option Group object.

  3. Select the health area group that the indicator belongs to.

  4. Remove the indicator from the list and save changes.

These steps don't remove the indicator from the option set but will remove it from the form. This will prevent the user from selecting the wrong indicator.

Back to top

RDQA Indicators - Form Logic

For all the actions below follow the next steps to open the correct program rules.

  1. Open Maintenance app.
  1. Select Program Menu and open Program rule section.
  1. Filter the rules by RDQA Program.

Back to top

Hide/Show Indicators according to health area

These rules manage the logic of hiding and showing the list of RDQA indicators in the data verification stage according to the health area selected in the registration form.

Back to top

To update rules names:

  1. Select any rule from PR34 to PR41.

  2. Change the name of the rule.

Back to top

To create a new rule:

Follow these steps if you added a new health area to the option set.

  1. Click on the 3 dot menu of any rule from PR34 to PR 41 and select clone.
  1. Change the name of the rule.
  1. In the rule expression change the code in single quote to the one from the new health area (see the code in the option).
  1. In the rule action, click on the current show option group action and change the group to the new one (which is the one according to the health area).

  2. Click on commit and then save the program rule.

Back to top

Donors

For all the actions below follow the next steps to open the correct option set.

  1. Open Maintenance app.
  1. Open Option set menu (in Other section).
  1. Search for RDQA - Donor List.

Back to top

Action: Update an existing Donor.

  1. In the Options section select the donor you want to update.

  2. Change the Name, Color or Icon parameter according to your needs.

Back to top

Action: Add a new Donor

  1. In the Options section click on ADD OPTION button.

  2. Add the name of the donor.

  3. Add the code. We recommend to use letters or letters and numbers.

  4. OPTIONAL - Select a color and Icon.

  5. Save new option.

Back to top

Action: Remove a Donor

  1. Click on the 3 dot menu in the donor you want to remove.

  2. Select Delete option.

Back to top

Projects

For all the actions below follow the next steps to open the correct option set.

  1. Open Maintenance app.
  1. Open Option set menu (in Other section).
  1. Search for RDQA - Project List.

Back to top

Action: Update an existing Project

  1. In the Options section select the project you want to update.

  2. Change the Name, Color or Icon parameter according to your needs.

Back to top

Action: Add a new Project

  1. In the Options section click on ADD OPTION button.

  2. Add the name of the project.

  3. Add the code. We recommend to use letters or letters and numbers.

  4. OPTIONAL - Select a color and Icon.

  5. Save new option.

Back to top

Action: Remove a Project

  1. Click on the 3 dot menu in the project you want to remove.

  2. Select Delete option.

Back to top

Remove Donor AND/OR Project fields from the form

  1. Open maintenance App.
  1. Open RDQA - Program.
  1. Open Data Verification Stage.
  1. In the Create data entry form section remove the fields by clicking the "X".

Remove:

  • RDQA - Donor List AND RDQA - Donor List - Other AND/OR
  • RDQA - Project AND RDQA - Project - Other

Back to top

PSI protocol for new metatada requirements

PSI utilises a centralized metadata management. The primary benefit of this approach is the establishment of a single source in charge of adding any new information to the different option sets. RDQA program elements use specific naming conventions and sharings, meaning that if a change is required, it must be asked through the correct channels.

If a health area, indicator, donor or project needs to be added or removed, create a ticket in the PSI Digital Health & Monitoring Helpdesk.

Back to top

Clone this wiki locally