Chief Information Officer

This IC/DoD enterprise encoding specification defines requirements and provides guidelines for the realization of the Content Discovery and Retrieval (CDR) Retrieve Component as a web service using both the REST style and SOAP bindings, hereafter termed a Retrieve service. This component provides a common interface and behavioral model for IC and DoD content collections, enabling content consumers to retrieve relevant content resources from disparate collections across the IC/DoD Enterprise. The content of this specification describes a Retrieve service’s interface and other aspects in detail, providing enough information for Retrieve service providers and implementers to create CDR-compliant Retrieve services.

The Retrieve Component, as defined by the Intelligence Community/Department of Defense (IC/DoD) CDR Specification Framework, serves as a “pull” mechanism to access the information resource.

The REST Retrieve Component relies on mechanisms that are already well established in the internet infrastructure:

• HTTP GET method - HTTP/HTTPS – http://www.w3.org/Protocols/
• HTTP Result Codes (maintained by Internet Assigned Numbers Authority – IANA) Hypertext Transfer Protocol (HTTP) Status Code Registry – http://www.iana.org/assignments/http-status-codes
• MIME Types (maintained by IANA): MIME types http://www.ietf.org/rfc/rfc2045.txt

The SOAP Retrieve specification covers the following aspects of a SOAP-based Retrieve Component:

• Service Interface defines the base SOAP constructs to expressing inputs, outputs, and faults
• Implementation provides additional implementation guidance beyond the behavior and interface guidance
• Reference Documentation provides references to other CDR and community artifacts (i.e., CDR Reference Architecture)

The Retrieve Component supports the retrieval for a specified resource from a Content Collection. The Retrieve Component, as defined, can only support returning a resource directly to the requestor. It cannot redirect output to a component other than the requestor. In addition, no special handling instructions (e.g., routing) may be specified.

This specification supports Intelligence Community Directive 501(ICD 501), Discovery, Dissemination or Retrieval of Information within the Intelligence Community, which establishes policies for (1) discovery, and (2) dissemination or retrieval of intelligence and intelligence-related information collected, or analysis produced by the Intelligence Community.

Compliance with this specification is measured against all aspects of the technical and documentary artifacts contained within the specification release package. This specification is maintained by the IC Chief Information Officer via the Services Coordination Activity (SCA) and Content Discovery and Retrieval Integrated Product Team (CDR IPT).


Value Proposition

This specification is designed to fulfill a number of requirements in support of the transformational efforts of the Intelligence Community and Department of Defense Enterprise(IC/DoD). Features of this specification are to:

• Enable retrieval of an identified content resource from the Content Collection in which it is stored.
• Initiate delivery of the retrieved resource to the requestor or to a designated alternate location using the Deliver Component.