5. Implementation: Overview

You are viewing an ARCHIVED version of this document. Please see the latest version here.

5.1 Usage scenarios

This Data Formats for Identity Records Standard SHOULD be used by agencies when they prepare agreements for inter-agency data exchange. Agencies are most likely to use this Standard’s data elements and their formats when undertaking authorised information matching and data sharing programmes. As indicated in 4.2, the Standard will be used by the IVS to store and exchange identity-related data.

This Standard SHOULD be used by agencies as guidance when they re-design hard copy and electronic forms and systems, and prepare request for proposal (RFP) documentation. If agencies use any of the data elements specified in this Standard they MUST be formatted for electronic exchange as specified in this Standard. For example, agencies may continue to capture a person’s name elements as one element (a single string) as long as they exchange it in the atomised format shown in this Standard.

Agencies collecting and exchanging customer information-related elements that can be used to determine entitlement to services other than those specified in this Standard are encouraged to refer to the OASIS CIQ v3.0 Specifications for formatting guidance.

5.2 Relationship to other standards and resources

5.2.1 Customer information

For issues relating to customer information, refer to the relevant section of the NZ e-GIF (Business Services Layer).

5.2.2 Data sharing

For issues relating to inter-agency data exchange, refer to the relevant section of the NZ e-GIF (Information sharing and matching agreements).

5.2.3 Mapping to/from a database

Where target databases do not use the data elements specified in this Standard, either a mapping tool or the XSL Transformations (XSLT) should be used for importing to or exporting from target databases. More information on XML mapping tools is available from: www.w3c.com.

5.2.4 Namespaces

For issues relating to namespaces, refer to the relevant section of the NZ e-GIF (Business Services Layer).

5.3 Key concepts in the design of the CIQ v3.0 Specifications

5.3.1 XLink

The CIQ v3.0 Specifications make extensive use of the XML Linking Language (XLink). XLink allows “…elements to be inserted into XML files in order to create and describe links between resources. It uses XML syntax to create structures that can describe the simple unidirectional hyperlinks of…HTML, as well as more sophisticated links” (IDEAlliance 2005). For example, XLink helps programmers to link one customer with another (Joe is the brother of Bill) and names with organisations (Samantha is the Director of Doe Limited).

5.3.2 Enumeration lists

The CIQ v3.0 Specifications make extensive use of enumeration lists. An enumeration list is an XML strategy to include controlled vocabulary or code lists to constrain values. Enumeration lists can be broadened to include agency-specific code lists and/or to change the items in existing code lists. For example, to represent a person’s name in atomic or granular fashion, it is possible to prepare an enumeration list that is reused to support the <NameElement> element from CIQ v3.0.

An example of an enumeration list is given in the following extract from the sample validated exchange file:

<NameElement ElementType=LastName />
<NameElement ElementType=FirstName />
<NameElement ElementType=MiddleName />
<NameElement ElementType=MiddleInitial />
<NameElement ElementType=FirstInitial />
<NameElement ElementType=Title />

5.3.3 Extensibility

CIQ v3.0 is extensible. This allows agencies to add attributes under the prescribed element set of the schema to capture additional identity-related data elements. Caution is advised in introducing additional elements in the XML-based file used to exchange data (validated exchange file), as the recipient may not be expecting them.

While the data elements specified in this Standard are useful in most identity management systems, CIQ v3.0 contains other data elements that agencies may wish to use. CIQ v3.0 is also fully extensible so that other, optional data elements, not included in the CIQ v3.0 Specifications, can be added. More information on CIQ v3.0 is available from: www.oasis-open.org. It is intended that the NZ e-GIF will ultimately adopt the full CIQ v3.0 Specifications.

5.3.4 Namespaces

CIQ v3.0 uses namespaces to separate elements that pertain to Name (n), Address (a) and Party (n1). The schema specifies the rules of use of the namespaces, and the parser enforces the namespaces in the sense that elements from these three specific namespaces are ‘allowed’ in the resulting XML file. It is also possible to add other elements by defining additional namespaces, using the notation ‘x:’, as this is a valid namespace from the generic XML schema control file.