Collection field

Defines a collection field, which can be used to hold a reference to an Atom feed entry.

Collection field values are represented in CUE by graphic components called tokens.

Syntax

<field
    name="NCName"
    id="NCName"?
    type="collection"
    src="text"
    mime-type="text"
    ( select="(content|title|locator)" | select="link" linkrel="text" )
  >
  <array/>?
  <constraints>...</constraints>?
  ANY-FOREIGN-ELEMENT*
  <parameter/>*
  <options>...</options>?
</field>

Only one form of the constraints element may be used: Boolean constraints.

Attributes

name="NCName"

The name of the field element. Note that no two fields belonging to the same panel may have the same name.

id="NCName" (optional)

The id of the field element. Set this attribute if you want to be able to reference this element using XInclude. Otherwise it is not required.

type="collection"

Specifies that this field is a collection field.

src="text"

Contains a URI that references a resource with an application/atom+xml;type=feed representation. The entries in the referenced feed are presented as a set of alternatives (a drop-down field in CUE) from which the user can choose one value. You can include the name of the current publication in the resource URI using the placeholder {publication}. If the current publication is called mypub, for example, then Content Store will convert the URL http://mycompany.com/myfeed?publication={publication} to http://mycompany.com/myfeed?publication=mypub. This makes it possible for the addressed service to send different feed content for different publications.

mime-type="text"

Defines the MIME type of the field.

select="(content|title|locator)"

Specifies which part of the selected Atom entry's content is to be stored as the field value.

Allowed values are:

content

The content of the selected Atom entry's atom:content element is to be stored as the field value.

title

The content of the selected Atom entry's atom:title element is to be stored as the field value.

locator

The href attribute of one of the selected Atom entry's viz:locator elements is to be stored as the field value. There are two points to note in this case:

1. viz:locator is a proprietary Vizrt Atom extension element belonging to the http://www.vizrt.com/types namespace.

2. An Atom entry may contain several viz:locator elements. The field value is taken from the one with the correct MIME type: that is, the one with a type attribute that matches this element's mime-type attribute.

select="link"

Specifies that the href of one the selected Atom entry's atom:link elements is to be stored as the field value. The specific atom:link to be used is determined by the linkrel attribute.

linkrel="text"

Specifies an Atom link relation name that determines which atom:link element the field value will be taken from. This attribute is only used when the select attribute is set to link.