R6 Ballot (2nd Draft)

Publish-box (todo)

Example OperationDefinition/NamingSystem-translate-id (Narrative)

Terminology Infrastructure Work GroupMaturity Level: N/AStandards Status: InformativeCompartments: No defined compartments

This is the narrative for the resource. See also the XML, JSON or Turtle format.

Note that this is the formal definition for the translate-id operation as an OperationDefinition on NamingSystem. See the Operation documentation

Generated Narrative: OperationDefinition NamingSystem-translate-id

URL: [base]/NamingSystem/$translate-id

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
IN id 1..1 string

The server parses the provided identifier to see what type it is (e.g. a URI, an OID as a URI, a plain OID, or a v2 table 0396 code). If the server can't tell what type of identifier it is, it can try it as multiple types. It is an error if more than one system matches the provided identifier

IN sourceType 1..1 code Naming System Identifier Type (Required)
IN targetType 1..1 code Naming System Identifier Type (Required)
IN preferredOnly 0..1 boolean

If preferredOnly = true then return only the preferred identifier, or if preferredOnly = false then return all available ids.

IN date 0..1 dateTime

If 'date' is supplied return only ids that have a validity period that includes that date.

OUT result 1..1 boolean

True if the identifier could be translated successfully.

OUT targetIdentifier 0..* string

The target identifer(s) of the requested type

OUT targetIdentifer.preferred 0..1 boolean

Whether the target identifier is preferred.

OUT targetIdentifier.period 0..1 Period

The perioid when the target identifier is valid.

Servers handle this request by finding the provided identifier in their known naming systems, and returning the requested identifier type (NamingSystem.uniqueId.type).

If the server wishes, it can also look through all code systems and value sets it knows about when attempting to find the requested identifier

 

 

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.