Reference

A reference to another resource, internal or external to the system.

Definition

The reference type contains at least one of a reference (literal reference), an identifier (logical reference), and a display (text description of target). In addition, it may contain a target type.

Literal Reference

Use literal references when the system is able to identify and resolve a resource using an absolute URL.

Logical Reference

Use logical references when you know the identifier for the target reference, without being able to provide a literal reference to the resource.

Type

reference

Attributes

Key	Type	Cardinality	Description
reference	symbol	0..1	Literal reference, Relative, internal or absolute URL.
type	uri	0..1	Type the reference refers to - usually a resource type.
identifier	identifier	0..1	Logical reference, when literal reference is not known.
display	symbol	0..1	Text alternative for the resource.

JSON

{
  "reference": "<symbol>",
  "type": "<uri>",
  "identifier": { Identifier },
  "display": "<symbol>"
}