Version 3 (modified by Oliver Schonefeld, 10 years ago) (diff)


CLARIN Federated Content Search (CLARIN-FCS) - Data Views 1.0


This specification is a supplementary specification to the CLARIN-FCS Core specification and defines additional Data View to be used in CLARIN-FCS. This specification defines the supplementary Data Views. For detailed information about the CLARIN-FCS interface specification, see CLARIN-FCS-Core.


The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in RFC2119.

Normative References

Key words for use in RFCs to Indicate Requirement Levels, IETF RFC 2119, March 1997,
Namespaces in XML 1.0 (Third Edition), W3C, 8 December 2009,
CLARIN Federated Content Search (CLARIN-FCS) - Core, SCCTC FCS Task-Force, March 2014,

Non-Normative References

Media Type Specifications and Registration Procedures, IETF RFC 6838, January 2013,
XML Media Types, IETF RFC 3023, January 2001,
Keyhole Markup Language (KML), Open Geospatial Consortium, 2008,

Typographic and XML Namespace conventions

The following typographic conventions for XML fragments will be used throughout this specification:

  • <prefix:Element>
    An XML element with the Generic Identifier Element that is bound to an XML namespace denoted by the prefix prefix.
  • @attr
    An XML attribute with the name attr
  • string
    The literal string must be used either as element content or attribute value.

Endpoints and Clients MUST adhere to the XML-Namespaces specification. The CLARIN-FCS interface specification generally does not dictate whether XML elements should be serialized in their prefixed or non-prefixed syntax, but Endpoints MUST ensure that the correct XML namespace is used for elements and that XML namespaces are declared correctly. Clients MUST be agnostic regarding syntax for serializing the XML elements, i.e. if the prefixed or un-prefixed variant was used, and SHOULD operate solely on expanded names, i.e. pairs of namespace name and local name.

The following XML namespace names and prefixes are used throughout this specification. The column "Recommended Syntax" indicates which syntax variant SHOULD be used by the Endpoint to serialize the XML response.

Prefix Namespace Name Comment Recommended Syntax
fcs CLARIN-FCS Resources prefixed
cmdi Component Metadata un-prefixed
kml Keyhole Markup Language un-prefixed

Data Views

A Data View serves as a container for representing search results within CLARIN-FCS. Data Views are designed to allow for different representations of results. This specification defines supplementary Data Views beyond the Generic Hits Data View, that is defined as part of the CLARIN-FCS Core specification. For detailed information as to what Data Views are and how they are integrated in CLARIN-FCS, see CLARIN-FCS-Core.

NOTE: The examples in the following sections show only the payload with the enclosing <fcs:DataView> element of a Data View. Of course, the Data View must be embedded either in a <fcs:Resource> or a <fcs:ResourceFragment> element. The @pid and @ref attributes have been omitted for all inline payload types.

Generic Hits (HITS)

The Generic Hits (HITS) Data View is an integral part of the Core specification and serves as the as the most basic agreement in CLARIN-FCS for the serialization of search results. For details about this Data View, see refer to the Core specification CLARIN-FCS-Core, Section "Generic Hits (HITS)".

Component Metadata (CMDI)

Description A CMDI metadata record
MIME type application/x-cmdi+xml
Payload Disposition inline or reference
Payload Delivery send-by-default (RECOMMENDED)
Recommended Short Identifier cmdi (RECOMMENDED)

The Component Metadata Data View allows the embedding of a CMDI metadata record that is applicable to the specific context into the Endpoint response, e.g. metadata about the resource in which the hit was produced. If this CMDI record is applicable for the entire Resource, it SHOULD be put in a <fcs:DataView> element below the <fcs:Resource> element. If it is applicable to the Resource Fragment, i.e. it contains more specialized metadata than the metadata for the encompassing resource, it SHOULD be put in a <fcs:DataView> element below the <fcs:ResourceFragment> element. Endpoints SHOULD provide the payload inline, but Endpoints MAY also use the reference method. If an Endpoint uses the reference method, the CMDI metadata record MUST be downloadable without any restrictions.

  • Example (inline):
    <!-- potential @pid and @ref attributes omitted -->
    <fcs:DataView type="application/x-cmdi+xml">
      <cmdi:CMD xmlns:cmdi="" CMDVersion="1.1">
        <!-- content omitted -->
  • Example (referenced):
    <!-- potential @pid attribute omitted -->
    <fcs:DataView type="application/x-cmdi+xml" ref="" />

Images (IMG)

Description An image related to the hit
MIME type image/png, image/jpeg, image/gif, image/svg+xml
Payload Disposition reference
Payload Delivery need-to-request (RECOMMENDED)
Recommended Short Identifier image (RECOMMENDED)

The Image Data View provides an image that is relevant to the hit, e.g. a facsimile of the source of a transcription. Endpoints MUST provide the payload by the reference method and the image file SHOULD be downloadable without any restrictions.

  • Example:
    <!-- potential @pid attribute omitted -->
    <fcs:DataView type="image/png" ref="" />

Geolocation (GEO)

Description An geographic location related to the hit
MIME type application/
Payload Disposition inline
Payload Delivery need-to-request (RECOMMENDED)
Recommended Short Identifier kml (RECOMMENDED)

The Geolocation Data View allows to geolocalize a hit. If MUST be encoded using the XML representation of the Keyhole Markup Language (KML). The KML fragment MUST comply with the specification as defined by KML.

  • Example:
    <!-- potential @pid and @ref attributes omitted -->
    <fcs:DataView type="application/">
      <kml:kml xmlns:kml="">
          <kml:name>IDS Mannheim</kml:name>
          <kml:description>Institut für Deutsche Sprache, R5 6-13, 68161 Mannheim, Germany</kml:description>