Organisations
Model for SDMX Organisations (data providers, agencies, etc).
Organisations in SDMX can play different roles, such as:
Maintenance agencies, i.e. organisations that maintain metadata.
Data (or metadata) providers, i.e. organisations that provide data or metadata.
Data (or metadata) consumers, i.e. organisations that collect data or metadata.
Contact details may be included with the information about an organisation.
Currently, only agencies and providers are supported in pysdmx (as consumers seem to be underused in SDMX currently).
Furthermore, in pysdmx, an organisation may reference a list of dataflows it maintains (if the organisation is an agency) or for which it provides data (if the organisation is a data provider).
- class pysdmx.model.organisation.Contact(id: str | None = None, name: str | None = None, department: str | None = None, role: str | None = None, telephones: Sequence[str] | None = None, faxes: Sequence[str] | None = None, uris: Sequence[str] | None = None, emails: Sequence[str] | None = None)
Contact details such as the name of a contact and his email address.
- id
An identifier for a contact. If the contact represents a person, this could be the person’s username in the organisation.
- name
The contact name, which could be the name of a person, the name of a service (“e.g. Support”), etc.
- department
The department in which the contact is located (e.g. “Statistics”).
- role
The contact’s role, which could be his job title, or a role such as data owner, data steward, subject matter expert, etc.
- telephones
A list of telephone numbers.
- faxes
A list of fax numbers.
- uris
A list of URLs relevant for the contact (e.g. a link to an online form that can be used to send questions, a link to a support forum, etc.).
- emails
a list of email addresses.
- class pysdmx.model.organisation.DataflowRef(id: str, agency: str, name: str | None = None, description: str | None = None, version: str = '1.0')
Provide core information about a dataflow.
- id
The dataflow identifier (e.g. BIS_MACRO).
- agency
The organisation (or unit) responsible for the dataflow.
- name
The dataflow name (e.g. MACRO dataflow).
- description
Additional descriptive information about the dataflow.
- version
The version of the dataflow (e.g. 1.0).
- class pysdmx.model.organisation.Organisation(id: str, name: str | None = None, description: str | None = None, contacts: Sequence[Contact] = (), dataflows: Sequence[DataflowRef] = ())
An organisation such as a provider of data or a metadata maintainer.
Central Banks, International Organisations, statistical offices, market data vendors are typical examples of organisations participating in statistical data exchanges.
Organisations may have one or more contact details.
- id
The identifier of the organisation (e.g. BIS).
- name
The name of the organisation (e.g. Bank for International Settlements).
- description
Additional descriptive information about the organisation.
- contacts
Contact details (email address, support forum, etc).
- dataflows
The dataflows maintained by the organisation if it is a maintenance agency or for which the organisation provides data if it is a data provider.