Standard Element Usage

When the Content Engine's web service returns an Atom feed containing a content item, it maps various content item properties and fields to standard Atom elements. In addition, some elements from other well-known standards are used where suitable standard Atom elements are not available.

This section contains descriptions of the mappings and RDF extensions used by the web service.

When the web service returns content items in an Atom feed (for example, in a change log feed), the following Atom elements are used to hold specific content item properties or field values:

title

This Atom element holds the content item's title field (that is, the field that is nominated as the title field in the content-type resource - see title-field). Since the content item title is included in the Atom entry in this way, the title field is omitted from the entry's VDF payload.

updated

This Atom element holds the content item's Published property.

published

This Atom element holds the content item's First Published property.

category

This Atom element holds the content item's tags property. A content item can contain an unlimited number of tags.

The following elements from the Atom Publishing Protocol (namespace URI http://www.w3.org/2007/app) and RDF Dublin Core (namespace URI http://purl.org/dc/terms/) are also used:

app:edited

This Atom Publishing Protocol element holds the content item's Last Modified property.

dcterms:created

This RDF Dublin Core element holds the content item's Created property.

dcterms:identifier

This RDF Dublin Core element holds the content item's Id property.

app:control

This Atom Publishing Protocol element holds the state of the content item.

app:draft

This Atom Publishing Protocol element define whether current content item is draft or not.

Metadata items for which no suitable standard elements could be found are included in the entries in a proprietary namespace identified by the URI http://xmlns.escenic.com/2010/atom-metadata. These include:

metadata:creator

The content item's Creator property. The content model of this element is an Atom person construct.

metadata:reference

The content item's Reference property.

metadata:publication

The content item's Publication property.

metadata:deleted

This identifies whether a content item is deleted or not.

metadata:group

The name of a content item relation type group. It is used to classify rel="relation" links in entry resources. For an example of how this element is used, see Follow Content Item Relations.

Atom Publishing Protocol for which no suitable standard elements could be found are included in the entries in a proprietary namespace identified by the URI http://www.vizrt.com/atom-ext. These include:

vaext:state

This Atom Protocol Extension elements represent any app:control identifies to represent the state of a resource. This will be present only when content item is not in published state and it's in either approved or submitted state. For example if a content item is in approved state he corresponding atom entry will contain the following XML fragment.

This element is used to represent additional content item states that cannot be represented by standard Atom or Atom publishing states. It appears as a child of the app:control element. For examples of how this element is used together with other state-related elements, see Content Item State Representations.