Difference between revisions of "Metadata Structure Definition"

From FMR Knowledge Base
Jump to navigation Jump to search
(Wizard)
Line 1: Line 1:
[[Category:FMR_Structures_Reference]]
+
[[Category:Authoring_and_maintaining_structures_using_the_FRM_UI]]
  
=='''??? Should this be metadatastructures?'''==
+
'''??? Should this be metadatastructures?'''
  
===Overview===
+
=Overview=
  
 
The Metadata Structure Definition (MSD) is similar to the Data Structure Definition (DSD), it defines the structure and allowable content of a Metadata Report (a DSD defines the structure and allowable content of a Dataset). The MSD also defines what types of artefact in the Fusion Registry the Metadata Report can be reported for.
 
The Metadata Structure Definition (MSD) is similar to the Data Structure Definition (DSD), it defines the structure and allowable content of a Metadata Report (a DSD defines the structure and allowable content of a Dataset). The MSD also defines what types of artefact in the Fusion Registry the Metadata Report can be reported for.
  
 +
Note: Details on authoring Reference Metadata can be found in the Reference Metadata Management guide.
  
[[File:MSD.PNG|1000px]]<br>
+
=Wizard=
 +
From the main menu, select the Metadata Structures Page and use the maintenance button to create a Metadata Structure [[File :cogs.PNG|40px]]<br>
 +
See this article [https://fmrwiki.sdmxcloud.org/All_Structures_-_FMR for more information on authoring and maintaining structures.]
  
The Metadata Structure Definition (MSD) provides a template for Metadata Reports, and is used to assist in authoring and validation of a Metadata Report. When a user authors a Metadata Report, the report must conform to the MSD this is analogous to a user reporting data which must conform to the Data Structure Definition (DSD). There are a few main differences between a DSD and a MSD. Once such difference is that a MSD contains the definition of allowable Targets, these define what the Metadata Report can be authored against, a DSD does not have this concept. The MSD contains a hierarchy of Reported Attributes, a Reported Attribute is almost identical to a DSD Component (Dimension or Attribute) however a DSD Component is not hierarchical.
+
==Step 1 - High Level Details==
 
+
The steps in a MSD Wizard includes step 1 which provides the generic, high level details about the Metadata Structure Definition. See this article [https://fmrwiki.sdmxcloud.org/All_Structures_-_FMR for more information on authoring and maintaining structures.]
 
 
[[File:msd1.PNG|800px]]<br>
 
 
 
Note: Details on authoring Reference Metadata can be found in the Reference Metadata Management guide.
 
 
 
===Wizard===
 
The steps in a MSD Wizard includes step 1 which provides the generic, high level details about the Metadata Structure Definition. See [[https://fmrwiki.sdmxcloud.org/Category:FMR_Structures_Reference Structure creating in the Structures Reference options.]]<br>
 
  
 +
==Step 2 - Report Attachments==
 
The second step requires information on the Report and allowable Targets. Targets can include Data related targets, this includes:
 
The second step requires information on the Report and allowable Targets. Targets can include Data related targets, this includes:
 
* Observation
 
* Observation
Line 31: Line 28:
 
[[File:msd2.PNG|800px]]<br>
 
[[File:msd2.PNG|800px]]<br>
  
 +
==Step 3 - Build Report==
 
The third step is used to build the report template definition, by building the Report Attributes hierarchy. Each Reported Attribute must reference a Concept (which provides the name and description). This step can be used to build a hierarchy by using drag and drop.
 
The third step is used to build the report template definition, by building the Report Attributes hierarchy. Each Reported Attribute must reference a Concept (which provides the name and description). This step can be used to build a hierarchy by using drag and drop.
  
 +
==Step 4 - Allowable Content==
 
The final step in the Metadata Structure Wizard is to specify the allowable content for each Metadata Attribute. Content type includes formats such as HTML, String, Numerical and enumerated formats, amongst others. For textual content (HTML, String) the MSD can also define if multilingual text is supported. If multilingual support is set to true in the definition then Metadata can be reported for the Attribute in multiple languages.
 
The final step in the Metadata Structure Wizard is to specify the allowable content for each Metadata Attribute. Content type includes formats such as HTML, String, Numerical and enumerated formats, amongst others. For textual content (HTML, String) the MSD can also define if multilingual text is supported. If multilingual support is set to true in the definition then Metadata can be reported for the Attribute in multiple languages.
  
Line 41: Line 40:
  
 
As shown in the above contact report, this step also allows the user to specify the minimum number of times the Attribute can appear in the Report. A Min Occurs of 1 would indicate that the Attributes appearance is mandatory. If Max Occurs is left empty then this will be interpreted as unbounded (it can be reported multiple times with no imposed limit). In the above example there is no upper limit on the number of Contacts, but there must be at least one. In the above example each Contact must have 1 Address but no more than 2. Each Address must have a house number or name, a Street, Country and post/zip code. The list of countries will be provided by the Reference Area Codelist that the COUNTRY Attribute has been linked to.
 
As shown in the above contact report, this step also allows the user to specify the minimum number of times the Attribute can appear in the Report. A Min Occurs of 1 would indicate that the Attributes appearance is mandatory. If Max Occurs is left empty then this will be interpreted as unbounded (it can be reported multiple times with no imposed limit). In the above example there is no upper limit on the number of Contacts, but there must be at least one. In the above example each Contact must have 1 Address but no more than 2. Each Address must have a house number or name, a Street, Country and post/zip code. The list of countries will be provided by the Reference Area Codelist that the COUNTRY Attribute has been linked to.
 
 
 
Back to [[https://fmrwiki.sdmxcloud.org/Category:FMR_Structures_Reference Structures Reference options]]
 

Revision as of 06:33, 24 September 2020


??? Should this be metadatastructures?

Overview

The Metadata Structure Definition (MSD) is similar to the Data Structure Definition (DSD), it defines the structure and allowable content of a Metadata Report (a DSD defines the structure and allowable content of a Dataset). The MSD also defines what types of artefact in the Fusion Registry the Metadata Report can be reported for.

Note: Details on authoring Reference Metadata can be found in the Reference Metadata Management guide.

Wizard

From the main menu, select the Metadata Structures Page and use the maintenance button to create a Metadata Structure Cogs.PNG
See this article for more information on authoring and maintaining structures.

Step 1 - High Level Details

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

Step 2 - Report Attachments

The second step requires information on the Report and allowable Targets. Targets can include Data related targets, this includes:

  • Observation
  • Series
  • Code in the context of a Dataflow
  • Concept in the context of a Dimension

Structure targets can include any Identifiable Structure, or specific structures can be selected.


Msd2.PNG

Step 3 - Build Report

The third step is used to build the report template definition, by building the Report Attributes hierarchy. Each Reported Attribute must reference a Concept (which provides the name and description). This step can be used to build a hierarchy by using drag and drop.

Step 4 - Allowable Content

The final step in the Metadata Structure Wizard is to specify the allowable content for each Metadata Attribute. Content type includes formats such as HTML, String, Numerical and enumerated formats, amongst others. For textual content (HTML, String) the MSD can also define if multilingual text is supported. If multilingual support is set to true in the definition then Metadata can be reported for the Attribute in multiple languages.

If the Metadata Attribute is used simply as a presentational node then it can be set to allow no content. A presentational node can be used if an Attribute has child Attributes, as shown in the following example:


Msd3.PNG

As shown in the above contact report, this step also allows the user to specify the minimum number of times the Attribute can appear in the Report. A Min Occurs of 1 would indicate that the Attributes appearance is mandatory. If Max Occurs is left empty then this will be interpreted as unbounded (it can be reported multiple times with no imposed limit). In the above example there is no upper limit on the number of Contacts, but there must be at least one. In the above example each Contact must have 1 Address but no more than 2. Each Address must have a house number or name, a Street, Country and post/zip code. The list of countries will be provided by the Reference Area Codelist that the COUNTRY Attribute has been linked to.