RetrieveTransaction
Contents
The Retrieve Transaction Service
Retrieve Transaction is conceived as a single view on the data in datasets, transactions, valuesets and (a little) templates, gathered together with the transaction as a starting point. This enables developers to have a single view on all - or most of - the data necessary to implement a transaction. Retrieve Transaction comes with both an HTML and a XML view. Here we'll focus on the XML view (the HTML view is nothing more than the data in the XML view, rendered as HTML).
Since Retrieve Transaction XML collects all the data from the various DECOR views, it can be a good starting point for code generation.
The query parameters
Retrieve Transaction will accept the following query parameters:
- id (of either a transaction or a dataset)
- language (optional, default is the project's default language
- format ('xml' or 'html')
- version (to retrieve a frozen release)
- hidecolumns (to influence the HTML display)
- unfiltered (to influence the HTML display)
The dataset element
This element contains the following attributes:
Attribute | Example | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@id | 2.16.840.1.113883.3.1937.99.62.3.1.1 | The id of the dataset which was filtered. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@effectiveDate | 2012-05-30T11:32:36 | The effectiveDate of the dataset which was filtered. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@statusCode | draft | The statusCode of the dataset which was filtered. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@versionLabel | v2014.07 | The versionLabel of the dataset which was filtered. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@transactionId | 2.16.840.1.113883.3.1937.99.62.3.4.2 | The id of the transaction which was used to filter the dataset. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@transactionEffectiveDate | 2012-09-05T16:59:35 | The effectiveDate of the transaction which was used to filter the dataset. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@shortName | measurement_message | }
If an dataset id is provided as query parameter, the dataset will not be filtered for a particular transaction. If a transaction id is provided, only those concepts will occur in the original dataset which are in this transaction as well. The dataset element will contain name and desc elements from the original transaction or dataset. Below this will come concept children. The concept elementThis element contains the following attributes and elements. They are all taken from the concept as it occurs in the dataset, from the attributes which are added in the transaction or from elsewhere where indicated below. If a concept is inherited, all the attributes are completed from the inherited-from concept. History of concepts is omitted. Multi-lingual artefacts (name, desc) are filtered for one language (so there will be only one name child element).
The implementation elementThis element contains the following attributes and elements.
The valueSet elementConcepts of valueDomain type 'code' will have a valueSet element if a valueSet is associated. The valueSet element will contain all the attributes of the valueSet, and as children the terminologyAssociation used to find the valueSet, and the conceptList. The conceptList will contain the child concepts from the valueSet, with the following additional information:
|