fdc3.context type defines the basic contract or "shape" for all data exchanged by FDC3 operations. As such, it is not
really meant to be used on its own, but is imported by more specific type definitions (standardised or custom) to provide
the structure and properties shared by all FDC3 context data types.
The key element of FDC3 context types is their mandatory
type property, which is used to identify what type of data the
object represents, and what shape it has.
- The FDC3 context type, and all derived types, define the minimum set of fields a context data object of a particular type can be expected to have, but this can always be extended with custom fields as appropriate.
The type property is the only required part of the FDC3 context data schema.
The FDC3 API relies on the
type property being present to route shared context data appropriately.
FDC3 Intents also register the context data types they support in an FDC3 App Directory, used for intent discovery and routing.
Standardized FDC3 context types have well-known
type properties prefixed with the
fdc3 namespace, e.g.
For non-standard types, e.g. those defined and used by a particular organization, the convention is to prefix them with an
organization-specific namespace, e.g.
See the Context Data Specification for more information about context data types.
Context data objects may include a name property that can be used for more information, or display purposes. Some derived types may require the name object as mandatory, depending on use case.
Context data objects may include a set of equivalent key-value pairs that can be used to help applications identify and look up the context type they receive in their own domain. The idea behind this design is that applications can provide as many equivalent identifiers to a target application as possible, e.g. an instrument may be represented by an ISIN, CUSIP or Bloomberg identifier.
Identifiers do not make sense for all types of data, so the
id property is therefore optional, but some derived types may choose to require at least one identifier.
FDC3 Context Types