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.escenic.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 inpublished
state and it's in eitherapproved
orsubmitted
state. For example if a content item is in approved state he corresponding atom entry will contain the following XML fragment.<app:control> <app:draft>yes</app:draft> <vaext:state>approved</vaext:state> </app:control>