Codelists

From FMR Knowledge Base
Jump to navigation Jump to search

Overview

Codelists provide an enumerated list of allowable values. Codelists can be used by Dimensions, Concepts, and Metadata Attributes to define the allowable content for both data and metadata reporting. Each Codelist contains zero to many Codes, each Code much belong to a Codelist.

See this article for more information on authoring and maintaining structures.

Wizard

From the Items menu, select the Codelist Page and use the maintenance button to create a codelist. Cogs.PNG

Step 1 - High Level Details

The steps in a Codelist Wizard includes step 1 which provides the generic, high level details about the Codelist. See this article for more information on authoring and maintaining structures.

Codelists have an additional feature - Validity Type as shown below.


Codelists - Step 1


Options available:

Standard - only permits validity periods to be applied on the Codelist itself.

Item - permits validity to be applied on the items in the Codelist.

Template - is used to define a Codelist Template which automatically generates other versions of this Codelist. The other generated versions are created from the validity periods set on individual items. When the Template is submitted to the Registry, the Registry constructs these further Codelists. Each of these generated Codelists will be assigned a specific version and will have start and end dates on the Codelist (rather than the individual codes).

Step 2 - Import Codes

The second step allows the user to import Codes from CSV. CSV text can be copied and pasted into the text field. On clicking ‘Next’, the CSV is checked for correctness. If valid, Codes are created and added to the Codelist.

Codelists - step 2

When importing Codes, it is important to note that the following:

  1. If you select a Template or Item type, you will see 6 columns instead of 4 to allow you to enter the position of the start and end period data. Take care when entering the position numbers.
  2. Codes will be added to the Codelist, and therefore this step can be used to add additional Codes to an existing scheme.
  3. The delimiter used is defined in the drop-down list above the text area.
  4. The import language for the name and description fields is defined in the drop-down list above the text area.
  5. If a Code already exists it will be modified based on the information supplied on this page, this includes the addition of new or description in a new language into an existing Codelist.
  6. Sub Codes can be created by using parent Code Id field. This is shown in the image above where UK, FR and DE are sub-codes of EUR.
  7. The same number of delimiters are required for each line, even if there is no information for the field, shown above where ‘Europe’ includes an additional comma followed by no text (since it has no Parent Code Id).
  8. If a field contains the delimiter (for example if a name includes a comma) then the text can be put in double quotes.

Step 3 - Manual Editing

The third step is to manually add, edit, delete and re-order by ID or Name, Ascending or Descending.


Codelists - Step 3

Step 4 - Order & Hierarchy

The fourth step displays the codes and their hierarchy in the sort order you have specified.


Codelists - Step 4

The list can be edited (including adding new codes) by clicking the Show CSV button.


Codelists - Show CSV

All fields are mandatory, but leaving any fields blank (except for ID and Name) is permitted and will clear their value.

The order of each code in the CSV dictates the order they will be inserted into the Codelist.

Put each Code on its own line.

Values may be wrapped with quotation marks "" if you need the delimiter in the value. If you need both the delimiter and a quotation mark, then the quotation marks within the value must be specified with two quotation marks. e.g., "Example of ""expert"", or ""advanced""".

There should not be a space between each value if quotation marks are used. e.g.,: valid: "D","DAILY" invalid: "D", "DAILY"