Skip to content

Latest commit

 

History

History
414 lines (211 loc) · 10.3 KB

content.schema.md

File metadata and controls

414 lines (211 loc) · 10.3 KB

Content Schema

https://ns.adobe.com/xdm/content/content

Content is information that is directed towards an audience for consumption in a (digital) experience. Content is delivered through channels (or a particular medium), but the essence of content remains independent from the devliery medium.

In Web Content Management by Deane Barker two key differences between content and other digital information are pointed out:

  1. Content is created differently
  2. Content is used differently

These differences boil down to a number of key characteristics of content.

Content is created by human editors in an editorial process that involves creation, revision, and publishing.

Content is created for human audiences, which gives the content the ultimate value.

Abstract Extensible Status Identifiable Custom Properties Additional Properties Defined In
Can be instantiated Yes Experimental Yes Forbidden Permitted content/content.schema.json

Schema Hierarchy

  • Content https://ns.adobe.com/xdm/content/content
    • Asset http://ns.adobe.com/adobecloud/core/1.0/asset
    • Common Properties http://ns.adobe.com/adobecloud/core/1.0
    • HAL Resource https://ns.adobe.com/xdm/external/hal/resource

Content Example

{
  "@id": "urn:aaid:a:b:01234578-0123-ABCD-abcd-0123456789ab",
  "repo:createdDate": "2017-11-23T13:11:05+00:00",
  "xdm:repositoryCreatedBy": "lars",
  "repo:lastModifiedDate": "2017-11-23T13:11:05+00:00",
  "xdm:repositoryLastModifiedBy": "lars",
  "repo:version": "1"
}

Content Properties

Property Type Required Defined by
@id string Optional Content (this schema)
_embedded object Optional HAL Resource
_links object Optional HAL Resource
dc:format string Optional Common Properties
repo:createDate string Optional Common Properties
repo:etag string Optional Asset
repo:id string Optional Asset
repo:lastModifiedDate string Optional Common Properties
repo:name string Optional Common Properties
repo:path string Optional Common Properties
repo:size integer Optional Asset
repo:version string Optional Asset
tiff:imageLength integer Optional Asset
tiff:imageWidth integer Optional Asset
xdm:repositoryCreatedBy string Optional Content (this schema)
xdm:repositoryLastModifiedBy string Optional Content (this schema)
* any Additional this schema allows additional properties

@id

A unique identifier given to every addressable piece of content in a given repository.

@id

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

@id Type

string

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

_embedded

It is an object whose property names are link relation types (as defined by RFC5988) and values are either a Resource Object or an array of Resource Objects.\n\nEmbedded Resources MAY be a full, partial, or inconsistent version of the representation served from the target URI.

_embedded

_embedded Type

object with following properties:

Property Type Required

_links

It is an object whose property names are link relation types (as defined by RFC5988 and values are either a Link Object or an array of Link Objects. The subject resource of these links is the Resource Object of which the containing _links object is a property.

_links

_links Type

object with following properties:

Property Type Required

dc:format

Format

The physical or digital manifestation of the resource. Typically, Format should include the media-type of the resource. Format may be used to determine the software, hardware or other equipment needed to display or operate the resource. Recommended best practice is to select a value from a controlled vocabulary (for example, the list of [Internet Media Types](http://www.iana.org/ assignments/media-types/) defining computer media formats).

dc:format

dc:format Type

string

All instances must conform to this regular expression

\w+\/[-.\w]+(?:\+[-.\w]+)?

dc:format Example

"application/vnd.adobe.photoshop"

repo:createDate

The server date and time when the resource was created in the repository, such as when an asset file is first uploaded or a directory is created by the server as the parent of a new asset. The Date Time property should conform to ISO 8601 standard. An example form is "2004-10-23T12:00:00-06:00".

repo:createDate

repo:createDate Type

string

repo:createDate Example

"2004-10-23T12:00:00-06:00"

repo:etag

ETag

An ETag is an HTTP response header returned by an HTTP/1.1 compliant web server used to determine change in content of a resource at a given URL.

repo:etag

  • is optional
  • type: string
  • defined in Asset

repo:etag Type

string

repo:id

A unique identifier given to every addressable asset in a given repository.

repo:id

  • is optional
  • type: string
  • defined in Asset

repo:id Type

string

repo:id Example

"urn:aaid:sc:US:6dc33479-13ca-4b19-b25d-c805eff8a69e"

repo:lastModifiedDate

The server date and time when the resource was most recently modified in the repository, such as when a new version of an asset is uploaded or a directory's child resource is added or removed. The Date Time property should conform to ISO 8601 standard. An example form is "2004-10-23T12:00:00-06:00".

repo:lastModifiedDate

repo:lastModifiedDate Type

string

repo:lastModifiedDate Example

"2004-10-23T12:00:00-06:00"

repo:name

repo:name

repo:name Type

string

repo:path

repo:path

repo:path Type

string

repo:size

Size

Size of the asset in bytes.

repo:size

  • is optional
  • type: integer
  • defined in Asset

repo:size Type

integer

repo:version

The version ID of the piece of content. It will be generated both on explicit and implicit save or upload.

repo:version

  • is optional
  • type: string
  • defined in Asset

repo:version Type

string

tiff:imageLength

Length

Height in pixels. To maintain continuity with the XMP and TIFF standards, the height of an image or video is specified in the property imageLength. The duration of the video (also commonly called length) is specified in the property extent

tiff:imageLength

  • is optional
  • type: integer
  • defined in Asset

tiff:imageLength Type

integer

  • minimum value: 0

tiff:imageWidth

Width

Width in pixels

tiff:imageWidth

  • is optional
  • type: integer
  • defined in Asset

tiff:imageWidth Type

integer

  • minimum value: 0

xdm:repositoryCreatedBy

ID of the user who initiated the action that caused the resource to be created in the repository.

xdm:repositoryCreatedBy

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

xdm:repositoryCreatedBy Type

string

xdm:repositoryLastModifiedBy

ID of the user who initiated the action that most recently caused the resource to be modified in the repository.

xdm:repositoryLastModifiedBy

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

xdm:repositoryLastModifiedBy Type

string