Suomi.fi for Service Developers
Go directly to contents.

Codelist extensions

The Reference Data tool provides a mechanism that allows code list editors to extend the content of the code list for different purposes in a controlled manner. Currently, around ten extension types are available in the Reference Data tool.

More detailed instructions are available on GitHubOpens in a new window. (in Finnish).

The key parts of the extension mechanism in the Reference Data tool are extension type, extension and member.

Extension type

  • The extension type defines the additional properties that can be linked to the code list and their semantics.
  • Currently, around ten different extension types are available in the Reference Data tool, each of them linking their own views and/or data fields as part of the code list.
  • The supported extension types have been described in more detail in the section Supported extension types.

Extension

  • The properties provided by the extension type are activated by creating an extension to the codelist.
  • An extension is created to the codelist and a suitable extension type is selected for it according to which additional properties are needed for the codelist.

Member

  • The actual content of the extension consists of members.
  • A member contains the additional information fields defined by the extension type as well as references to codes.

The extension types provided by the Reference Data tool can be divided into two categories in terms of their key characteristics. 

hierarchy extensions and code extensions. Hierarchy extensions can be used to form hierarchic compilations of codes. Code extensions in turn can be used to add new information fields to codes.

Hierarchy extensions

  • Make it possible to compile hierarchic structures of codes.
  • Link predetermined information fields to the members of the hierarchy, for example, the name and similar specifiers.
  • They are quite versatile and can be used widely in various use cases to structure existing codes.
  • Do not impose restrictions on the number of extensions of the same extension type in one code list.

Code extensions

  • Extend the code with predefined data fields.
  • Have typically been tailored for a specific purpose and restrict the permitted values of fields.
  • Impose the restriction that there can be only one extension of a certain extension type in one code list.

The extension types supported by the Reference Data tool are presented in this table.

Extension type

Archetype

Description

Definition hierarchy

Hierarchy extension

Enables the creation of an alternative hierarchy of codes. The hierarchy can incorporate codes from one or multiple code sets, and from each code set either the entire set or a selected subset of codes can be included. Each member of the hierarchy can be assigned a descriptive label to clarify its role within the hierarchy.

Calculation hierarchy

Hierarchy extension

Functionally equivalent to the Definition hierarchy extension, but additionally supports defining aggregation and comparison operators for each member of the hierarchy

Code map

Hierarchy extension

Enables the creation of one-way linkage between codes. The codes to be linked may come from one or more codelists.

DPM Metric

Code extension

Adds the fields required by the Metric concept defined in the Data Point Modeling (DPM) methodology to the code’s data structure. This enables representing DPM Metric concepts as codes within the Reference Data tool.

DPM Explicit Domain

Code extension

Functionally equivalent to the DPM Metric extension but includes the fields required by the DPM Explicit Domain concept.

DPM Typed Domain

Code extension

Functionally equivalent to the DPM Metric extension, but includes the fields required by the DPM Typed Domain concept.

DPM Dimension

Code extension

Functionally equivalent to the DPM Metric extension, but includes the fields required by the DPM Dimension concept.


Updated: 20/11/2025

Are you satisfied with the content on this page?