Difference between revisions of "Agency Scheme V10"

From FMR Knowledge Base
Jump to navigation Jump to search
(→‎Identity)
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
[[Category:SDMX Structures]]
+
[[Category:SDMX 2.1 Structures]]
 +
== Overview ==
 +
[[File:SDMX Agency Diagram.PNG|Agency Diagram|thumbnail]]
 +
An Agency Scheme contains a non-hierarchic list of [[Agency V10|Agencies]] and is a type of [[Organisational_Schemes V10|Organsiation Scheme]].
 +
 
 +
Agencies own and maintain [[Maintainable V10|Maintainable]] structures.
  
−
== Overview ==
+
The top-level Agency Scheme is the scheme for which SDMX is the maintenance agency and is termed the "SDMX Agency Scheme". Every Agency in every Agency Scheme must be related directly or indirectly via intervening Agency Schemes, to an Agency registered in the SDMX Agency Scheme. In this way each Agency can be identified uniquely by the combination of Agencies in the path from the SDMX Agency Scheme to the Agency Scheme in which it resides, plus its own identity in that scheme.
−
An SDMX Agency Scheme is a container for all [[Agency|Agencies]] and is a sub class of [[Organisational_Schemes|Organsiation Scheme]].
 
  
−
The "top-level" agency is SDMX and this Agency Scheme is maintained by SDMX.
+
In practice, organisations implementing SDMX create an Agency for themselves in a local copy of the SDMX Agency Scheme. Organisations can ask to be added to the master SDMX Agency Scheme which is maintained in the [https://registry.sdmx.org SDMX Global Registry], however for many this is unnecessary unless planning to publish structures for global use.
  
−
Agencies registered in the top-level scheme can themselves maintain a single Agency Scheme. SDMX is an agency in the SDMX agency scheme. Agencies in this scheme can themselves maintain a single Agency Scheme and so on.
+
Organisations can define sub-agencies by setting their own Agency as the owner rather than SDMX. Sub-agencies have IDs of the form ''[Agency ID].[Sub-agency]'', for instance ''XYZ.DEPTA''. In theory, Sub-agencies can themselves have Sub-agencies, but this approach is rarely used in practice.
  
 
==Structure Properties==
 
==Structure Properties==
 
{| class="wikitable"
 
{| class="wikitable"
 
! scope=row style="text-align: left;" | Structure Type  
 
! scope=row style="text-align: left;" | Structure Type  
−
| Standard SDMX Structural Metadata Artifact
+
| Standard SDMX Structural Metadata Artefact
 
|-
 
|-
 
! scope=row style="text-align: left;"  | Maintainable
 
! scope=row style="text-align: left;"  | Maintainable
−
| [[Maintainable|Yes]]
+
| [[Maintainable_V10|Yes]]
 
|-
 
|-
 
! scope=row style="text-align: left;"  | Identifiable
 
! scope=row style="text-align: left;"  | Identifiable
−
| [[Identifiable|Yes]]
+
| [[Identifiable V10|Yes]]
 
|-
 
|-
 
! scope=row style="text-align: left;"  | Item Scheme
 
! scope=row style="text-align: left;"  | Item Scheme
−
| | [[Item_Scheme|Yes]]
+
| [[Item_Scheme|Yes]]
 
|-
 
|-
 
! scope=row style="text-align: left;"  | SDMX Information Model Versions  
 
! scope=row style="text-align: left;"  | SDMX Information Model Versions  
Line 35: Line 39:
 
==Context within the SDMX 2.1 Information Model==
 
==Context within the SDMX 2.1 Information Model==
  
−
[[File:L_AgencyScheme.png|900px]]
+
[[File:L_AgencyScheme.png|Agency Scheme|600px]]
−
 
 
−
== Identity ==
 
−
The diagram in the SDMX_2_1_Section_6_TechnicalNotes_2020-07 pdf file illustrates this hierarchical structure of the agencyID:
 
−
 
 
−
 
 
−
[[File:SDMX Agency Diagram.PNG|400px]]<br>
 
−
 
 
−
 
 
−
 
 
−
In the Registry, the SDMX Agency Scheme uses the prefix of ''SDMX'' and has The '''Identity''' of ''AGENCIES'' and the '''Name''' ''SDMX Agency Scheme''. This will hold all the Agencies created in the Registry.
 
−
 
 
−
If a Sub Agency is created the prefix becomes the ID of the owning agency, with an '''ID''' of ''AGENCIES'' and the '''Name''' of ''AGENCIES'' as shown in the example below.
 
−
 
 
−
[[File:AgencyScheme_List.PNG|900px]]<br>
 
−
 
 
−
[[URN|You can seem more examples and information on Identities in this article]].
 
−
 
 
−
== Content ==
 
−
The SDMX Agency Scheme contains all Agencies added to the Registry unless they are Sub Agencies in which case a new Agency Scheme is created as explained above.
 

Latest revision as of 08:53, 25 August 2022

Overview

Agency Diagram

An Agency Scheme contains a non-hierarchic list of Agencies and is a type of Organsiation Scheme.

Agencies own and maintain Maintainable structures.

The top-level Agency Scheme is the scheme for which SDMX is the maintenance agency and is termed the "SDMX Agency Scheme". Every Agency in every Agency Scheme must be related directly or indirectly via intervening Agency Schemes, to an Agency registered in the SDMX Agency Scheme. In this way each Agency can be identified uniquely by the combination of Agencies in the path from the SDMX Agency Scheme to the Agency Scheme in which it resides, plus its own identity in that scheme.

In practice, organisations implementing SDMX create an Agency for themselves in a local copy of the SDMX Agency Scheme. Organisations can ask to be added to the master SDMX Agency Scheme which is maintained in the SDMX Global Registry, however for many this is unnecessary unless planning to publish structures for global use.

Organisations can define sub-agencies by setting their own Agency as the owner rather than SDMX. Sub-agencies have IDs of the form [Agency ID].[Sub-agency], for instance XYZ.DEPTA. In theory, Sub-agencies can themselves have Sub-agencies, but this approach is rarely used in practice.

Structure Properties

Structure Type Standard SDMX Structural Metadata Artefact
Maintainable Yes
Identifiable Yes
Item Scheme Yes
SDMX Information Model Versions 1.0, 2.0, 2.1
URN - AgencyScheme namespace urn:sdmx:org.sdmx.infomodel.base.AgencyScheme
Example urn:sdmx:org.sdmx.infomodel.base.AgencyScheme=SDMX:AGENCIES(1.0)

Context within the SDMX 2.1 Information Model

Agency Scheme

Retrieved from "https://fmrwiki.sdmxcloud.org/index.php?title=Agency_Scheme_V10&oldid=6073"