Skip to content

Latest commit

 

History

History
320 lines (158 loc) · 7.77 KB

descriptorOneToOne.schema.md

File metadata and controls

320 lines (158 loc) · 7.77 KB

One to One Relationship Descriptor Schema

https://ns.adobe.com/xdm/common/descriptors/descriptorOneToOne

Describes one to one relationship descriptor.

Abstract Extensible Status Identifiable Custom Properties Additional Properties Defined In
Can be instantiated Yes Stabilizing No Forbidden Permitted common/descriptors/relationship/descriptorOneToOne.schema.json

Schema Hierarchy

  • One to One Relationship Descriptor https://ns.adobe.com/xdm/common/descriptors/descriptorOneToOne

One to One Relationship Descriptor Example

{
  "@id": "https://ns.adobe.com/example/descriptorOneToOne/1",
  "@type": "xdm:descriptorOneToOne",
  "xdm:sourceSchema": "https://ns.adobe.com/experience/aem/user",
  "xdm:sourceVersion": 1,
  "xdm:destinationSchema": "https://ns.adobe.com/xdm/context/profile",
  "xdm:destinationVersion": 1,
  "xdm:label": "UserProfile"
}

One to One Relationship Descriptor Properties

Property Type Required Defined by
@id string Optional Schema Descriptor
@type const Optional One to One Relationship Descriptor (this schema)
xdm:destinationItem complex Optional Relationship Descriptor
xdm:destinationProperty string Optional Relationship Descriptor
xdm:destinationSchema string Optional Relationship Descriptor
xdm:destinationVersion number Optional Relationship Descriptor
xdm:label string Optional Relationship Descriptor
xdm:sourceItem complex Optional Schema Descriptor
xdm:sourceProperty string Optional Schema Descriptor
xdm:sourceSchema string Optional Schema Descriptor
xdm:sourceValue string Optional Relationship Descriptor
xdm:sourceVersion number Optional Schema Descriptor
* any Additional this schema allows additional properties

@id

Identifier

The unique identifier for the schema descriptor. This property is required when the descriptor is defined outside of the applicable schema, but is optional when applied via 'meta:descriptors'.

@id

@id Type

string

  • format: uri-reference – URI Reference (according to RFC3986)

@type

@type

  • is optional
  • type: const
  • defined in this schema

The value of this property must be equal to:

"xdm:descriptorOneToOne"

xdm:destinationItem

Destination Item

When present, the selector used to match a specific item in the array pointed to by destProperty

xdm:destinationItem

xdm:destinationItem Type

One of the following conditions need to be fulfilled.

Condition 1

Condition 2

Condition 3

Condition 4

xdm:destinationProperty

Destination Property

When present, the property of the destination schema to which this descriptor applies. This value is a JSON Pointer, applied to an instance of an object described by 'xdm:destSchema'

xdm:destinationProperty

xdm:destinationProperty Type

string

xdm:destinationSchema

Destination Schema

The destination schema this descriptor applies to

xdm:destinationSchema

xdm:destinationSchema Type

string

  • format: uri – Uniformous Resource Identifier (according to RFC3986)

xdm:destinationVersion

Destination Version

Major version being referenced.

xdm:destinationVersion

xdm:destinationVersion Type

number

xdm:label

Label

xdm:label

xdm:label Type

string

xdm:sourceItem

Source Item

When present, the selector used to match a specific item in the array pointed to by sourceProperty.

xdm:sourceItem

xdm:sourceItem Type

One of the following conditions need to be fulfilled.

Condition 1

Condition 2

Condition 3

Condition 4

xdm:sourceProperty

Source Property

When present, the property of the source schema to which this descriptor applies. This value is a JSON Pointer, applied to an instance of an object described by xdm:sourceSchema.

xdm:sourceProperty

xdm:sourceProperty Type

string

xdm:sourceSchema

Source Schema

The source schema this descriptor applies to. This property is required when the descriptor is defined outside of the applicable schema, but is optional when applied via 'meta:descriptors'

xdm:sourceSchema

xdm:sourceSchema Type

string

  • format: uri – Uniformous Resource Identifier (according to RFC3986)

xdm:sourceValue

Source Value

When present, provides additional information about the values in that field. Descriptor producer and consumer should coordinate on how to use this field, e.g. defining rules on formats, values, and operations.

xdm:sourceValue

xdm:sourceValue Type

string

xdm:sourceVersion

Source Version

Major version being referenced.

xdm:sourceVersion

xdm:sourceVersion Type

number