Emergency Data Exchange Language (EDXL) Customer Information Quality (CIQ) Profile Version 1.0
Committee Specification Draft 03
19 December 2011
Specification URIs
This version:
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/csd03/edxl-ciq-v1.0-csd03.odt (Authoritative)
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/csd03/edxl-ciq-v1.0-csd03.html
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/csd03/edxl-ciq-v1.0-csd03.pdf
Previous version:
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/csd02/edxl-ciq-v1.0-csd02.odt (Authoritative)
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/csd02/edxl-ciq-v1.0-csd02.html
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/csd02/edxl-ciq-v1.0-csd02.pdf
Latest version:
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/edxl-ciq-v1.0.odt (Authoritative)
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/edxl-ciq-v1.0.html
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/edxl-ciq-v1.0.pdf
Technical Committee:
Chair:
Elysa Jones (elysajones@yahoo.com), Individual
Editors:
Werner Joerg (Werner.Joerg@iem.com), IEM, Inc.
Jeff Waters (jeff.waters@navy.mil), US Department of Defense (DoD)
Additional artifacts:
This prose specification is one component of a Work Product which also includes:
Declared XML namespaces:
Abstract:
This CIQ Profile describes a subset of components and component types from the Customer Information Quality (CIQ) standard, useful for describing persons and organizations, chosen for reuse across the suite of Emergency Data Exchange Language (EDXL) standards. This subset is intended for internal use by the Emergency Management Technical Committee and its subcommittees as they develop specific standards utilizing these types.
Status:
This document was last revised or approved by the OASIS Emergency Management TC on the above date. The level of approval is also listed above. Check the “Latest version” location noted above for possible later revisions of this document.
Technical Committee members should send comments on this Work Product to the Technical Committee’s email list. Others should send comments to the Technical Committee by using the “Send A Comment” button on the Technical Committee’s web page at http://www.oasis-open.org/committees/emergency/.
For information on whether any patents have been disclosed that may be essential to implementing this Work Product, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the Technical Committee web page (http://www.oasis-open.org/committees/emergency/ipr.php).
Citation format:
When referencing this Work Product the following citation format should be used:
[EDXL-CIQ]
Emergency Data
Exchange Language (EDXL) Customer Information Quality (CIQ) Profile Version
1.0. 19 December 2011. OASIS Committee
Specification Draft 03.
http://docs.oasis-open.org/emergency/edxl-ciq/v1.0/csd03/edxl-ciq-v1.0-csd03.html.
Notices
Copyright © OASIS Open 2012. All Rights Reserved.
All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the OASIS website.
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to OASIS, except as needed for the purpose of developing any document or deliverable produced by an OASIS Technical Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate it into languages other than English.
The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.
This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
OASIS requests that any OASIS Party or any other party that believes it has patent claims that would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification.
OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this specification by a patent holder that is not willing to provide a license to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS may include such claims on its website, but disclaims any obligation to do so.
OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS' procedures with respect to rights in any document or deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.
The name "OASIS" is a trademark of OASIS, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs. OASIS welcomes reference to, and implementation and use of, specifications, while reserving the right to enforce its marks against misleading uses. Please see http://www.oasis-open.org/who/trademark.php for above guidance.
Table of Contents
1 Introduction................................................................................................................................ 5
1.1 Terminology......................................................................................................................... 5
1.2 Normative References.......................................................................................................... 5
1.3 Non-Normative References................................................................................................... 6
2 Design Principles & Concepts (non-normative)............................................................................. 7
2.1 Design Philosophy............................................................................................................... 7
2.2 Structural Summary.............................................................................................................. 7
2.2.1 CIQ Top Level Elements................................................................................................ 7
2.2.2 CIQ Elements................................................................................................................ 8
3 CIQ Profile Structure (normative).................................................................................................. 9
3.1 Data Dictionary.................................................................................................................... 9
3.1.1 CIQ Elements................................................................................................................ 9
3.1.2 Enumerated Types....................................................................................................... 21
4 Conformance............................................................................................................................ 24
Appendix A Acknowledgements..................................................................................................... 25
Appendix B Non-Normative Text..................................................................................................... 26
Appendix C Revision History.......................................................................................................... 27
[All text is normative unless otherwise labeled]
This document describes common components and component types for describing persons and organizations that can be reused across the suite of Emergency Data Exchange Language (EDXL) standards. These particular components are derived from the Customer Information Quality (CIQ) standard. See http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=ciq#overview for more information about CIQ, including the quick summary provided here:
The objective of the OASIS CIQ Technical Committee (formed in 2000) is to deliver a set of XML Specifications for defining, representing, interoperating and managing "PARTY (Person or Organisation) CENTRIC INFORMATION" that are truly open, vendor neutral, industry and application independent, and importantly "Global" (ability to represent international data formats such as different types of party names and addresses used in 241+ countries).
The CIQ family of specifications are designed to represent party data (e.g. name and address) independent of any culture, geographical location, application or industry at an abstract (simple representation of data - free text format) or detailed (complex representation, i.e. breaking the data into its atomic elements - structured format) level from a data integrity and quality perspective and therefore, is truly a "global" (International) specification for representing party information.
The Emergency Management Technical Committee has the need to represent basic person and organization information across its standards and has chosen to reuse the important work performed by the OASIS CIQ Technical Committee; however, to make this reuse easy and understandable, the EM TC has authorized the development of this “profile” which is a set of schema which utilize only a portion of the entire CIQ schema and which create XML fragments which validate against those schema.
This document is intended for internal use by the Emergency Management Technical Committee and its subcommittees as they develop specific standards utilizing these types.The goal is to enable reuse of components which are commonly used in specifications and which have been designed based on lessons learned from the development of the Common Alert Protocol 1.1, the Distribution Element 1.0, Hospital Availability and Resource Messaging. The first use of this CIQ profile is intended to be in Situation Reports 1.0 and the Distribution Element 2.0. The components will be used and expanded as needed for future EDXL specifications.
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].
[RFC2119] S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, http://www.ietf.org/rfc/rfc2119.txt, IETF RFC 2119, March 1997.
[RFC2046] N. Freed, Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types, http://www.ietf.org/rfc/rfc2046.txt, IETF RFC 2046, November 1996.
[RFC3066] H. Alvestrand, Tags for the Identification of Languages, http://www.ietf.org/rfc/rfc3066.txt, IETF RFC 3066, January 2001.
[WGS 84] National Geospatial Intelligence Agency, Department of Defense World Geodetic System 1984, http://earth-info.nga.mil/GandG/tr8350_2.html, NGA Technical Report TR8350.2, January 2000.
[XML 1.0] T. Bray, Extensible Markup Language (XML) 1.0 (Third Edition), http://www.w3.org/TR/REC-xml/, W3C REC-XML-20040204, February 2004.
[namespaces] T. Bray, Namespaces in XML, http://www.w3.org/TR/REC-xml-names/, W3C REC-xml-names-19990114, January 1999.
[dateTime] N. Freed, XML Schema Part 2: Datatypes Second Edition, http://www.w3.org/TR/xmlschema-2/#dateTime, W3C REC-xmlschema-2, October 2004.
[OASIS CIQ] OASIS Committee Specification 01, Customer Information Quality (CIQ) Specifications Version 3.0, Name (xNL), Address (xAL), and Party (xPIL), October 2008 http://docs.oasis-open.org/ciq/v3.0/specs/ciq-specs-v3.html
[EDXL GFR] EDXL General Functional Requirements, http://www.oasis-open.org/committees/document.php?document_id=10031&wg_abbrev=emergency, November 2004.
[EDXL-DE IG] EDXL Distribution Element Implementer's Guide, http://www.oasis-open.org/committees/document.php?document_id=14120&wg_abbrev=emergency, August 2005.
Below are some of the guiding principles of the EDXL CIQ Profile:
1. Provide a method to capture and reuse xml types and elements for representing persons and organizations which are commonly needed across multiple EDXL standards.
2. Provide flexible mechanisms to update the EDXL CIQ Profile efficiently, without slowing down the EDXL standards development process.
3. Allow for easy updates to capture fixes or improvements.
4. Ease the reuse and understanding of the basic CIQ person and organization elements and types important for emergency management.
5. Speed the development of EDXL Standards through reuse of common components and thereby improve information sharing and data exchange across the local, state, tribal, national and non-governmental organizations of different professions that provide emergency response and management services.
6. Support the integration of data elements from profiles which enables efficient and effective reuse of other important open standards.
About multiplicity notation: “[l..h]” designates range from lower bound l to higher bound h, with both l and h Natural numbers, 0 ≤ l ≤ h, plus option “*” (unbounded) for h.
About notation: “(.., ..)” lists attributes.
Element/Type Schema
Party: PartyType edxl-xPIL.xsd
PartyName [0..1]: PartyNameType edxl-xNL.xsd
Addresses [0..1]: Address edxl-xPIL.xsd
ContactNumbers [0..1]: ContactNumber “
ElectronicAddressIdentifiers [0..1]: ElectronicAddressIdentifier “
Identifiers [0..1]: Identifier “
OrganisationInfo [0..1] “
PersonDetails: PersonDetailsType edxl-xPIL.xsd
xnl:PersonName [1..*]: PersonNameType edxl-xNL.xsd
Addresses [0..1]: Address edxl-xPIL.xsd
ContactNumbers [0..1]: ContactNumber “
ElectronicAddressIdentifiers [0..1]: ElectronicAddressIdentifier “
Identifiers [0..1]: Identifier “
OrganisationDetails: OrganisationDetailsType edxl-xPIL.xsd
xnl:OrganisationName [1..*]: OrgansationNameType edxl-xNL.xsd
Addresses [0..1]: Address edxl-xPIL.xsd
ContactNumbers [0..1]: ContactNumber “
ElectronicAddressIdentifiers [0..1]: ElectronicAddressIdentifier “
OrganisationInfo [0..1] “
Element/Type Schema
Address [0..*]: AddressType edxl-xAL.xsd
FreeTextAddress [0..1] “
AddressLine [1..*] “
Country [0..1]: CountryType “
NameElement [1..1] “
AdministrativeArea [0..1] “
NameElement [1..*] “
SubAdministrativeArea [0..1] “
NameElement [1..*] “
Locality [0..1] “
NameElement [1..*] “
SubLocality [0..1] “
NameElement [1..*] “
Thoroughfare [0..1]: ThoroughfareType “
NameElement [1..1] + attributes “
or
Number [1..1]: IdentifierType “
PostCode [0..1] “
Identifier [1..*]: IdentifierType “
ContactNumber [1..*] edxl-xPIL.xsd
ContactNumberElement [0..*] + attributes “
ElectronicAddressIdentifier [1..*] + attributes “
Identifier [1..*] “
IdentifierElement [0..*] + attributes “
IssuerName [0..1]: xnl:OrganisationNameType + attributes “
NameElement [0..*] edxl-xNL.xsd
SubDivisionName [0..*] “
OrganisationInfo + attributes edxl-xPIL.xsd
Namespaces and prefixes used below include:
xs="http://www.w3.org/2001/XMLSchema"
ct="urn:oasis:names:tc:emergency:edxl:ciq:1.0:ct"
xpil="urn:oasis:names:tc:emergency:edxl:ciq:1.0:edxl-xpil"
<no prefix>=”urn:oasis:names:tc:emergency:edxl:ciq:1.0:edxl-xpil”
xal="urn:oasis:names:tc:emergency:edxl:ciq:1.0:xal"
xnl="urn:oasis:names:tc:emergency:edxl:ciq:1.0:xnl"
Element |
Party |
BaseType |
xnl:PartyType |
Usage |
OPTIONAL [0..1] |
Schema |
edxl-xPIL.xsd |
Definition |
A container for defining the unique characteristics of a party, which can be a person or an organization. |
Comments |
|
Sub-elements |
• PartyName [0..1] • Addresses [0..1] • ContactNumbers [0..1] • ElectronicAddressIdentifiers [0..1] • Identifiers [0..1] • OrganisationInfo [0..1] |
Used In |
Top level element |
Example |
|
Element |
PersonDetails |
BaseType |
PersonDetailsType |
Usage |
OPTIONAL [0..1] |
Schema |
edxl-xPIL.xsd |
Definition |
A container for defining the unique characteristics of a person only. |
Comments |
|
Sub-elements |
• xnl:PersonName [1..*] • Addresses [0..1] • ContactNumbers [0..1] • ElectronicAddressIdentifiers [0..1] • Identifiers [0..1] |
Used In |
Top level element |
Example |
<PersonDetails> <xnl:PersonName> <xnl:NameElement>Mary Smith</xnl:NameElement> </xnl:PersonName> </PersonDetails> |
Element |
OrganisationDetails |
BaseType |
OrganisationDetailsType |
Usage |
OPTIONAL [0..1] |
Schema |
edxl-xPIL.xsd |
Definition |
A container for defining the unique characteristics of an organisation only. |
Comments |
Note the English spelling of “Organisation” |
Sub-elements |
• xnl:OrganisationName [1..*] • Addresses [0..1] • ContactNumbers [0..1] • ElectronicAddressIdentifiers [0..1] • OrganisationInfo [0..1] |
Used In |
Top level element |
Example |
<OrganisationDetails> <xnl:OrganisationName> <xnl:NameElement>Mary Smith</xnl:NameElement> </xnl:OrganisationName> </OrganisationDetails> |
Element |
Addresses |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Schema |
edxl-xPIL.xsd |
Definition |
A container for one or more Address elements |
Comments |
|
Sub-elements |
Address [0..*] |
Used In |
• OrganisationDetails • Party • PersonDetails |
Examples |
|
Element |
Address |
BaseType |
xal:AddressType |
Usage |
OPTIONAL [0..*] |
Definition |
A container for an address. |
Comments |
|
Sub-elements |
• FreeTextAddress [0..1] • Country [0..1] • AdministrativeArea [0..1] • Locality [0..1] • Thoroughfare [0..1] • PostCode [0..1] |
Used In |
Addresses |
Examples |
<ct:ValueListURI>http://example.com/mylist</ct:ValueListURI>
<ct:ValueListURI> urn:oasis:names:tc:emergency:EDXL:DE:2.0:Defaults:DistributionType </ct:ValueListURI> |
Element |
[Address.]FreeTextAddress |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Definition |
A container for free text address elements where address elements are not parsed. |
Comments |
|
Sub-elements |
AddressLine [1..*] of type ct:String |
Used In |
Address |
Examples |
|
Element |
[Address.]Country |
BaseType |
CountryType |
Usage |
OPTIONAL [0..1] |
Definition |
Country details. |
Comments |
|
Sub-elements |
NameElement [1..1] of type ct:String |
Used In |
Address |
Examples |
|
Element |
[Address.Country.]NameElement |
BaseType |
ct:String |
Usage |
REQUIRED [1..1] |
Definition |
Data associated with the name of the country in whatever form available, e.g. full, abbreviation, common use, code of the country, etc. |
Comments |
|
Sub-elements |
None |
Used In |
Address.Country |
Examples |
|
Element |
[Address.]AdministrativeArea |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Definition |
Details of the top-level area division in the country, such as state, district, province, island, region, etc. Note that some countries do not have this. |
Comments |
|
Sub-elements |
• NameElement [1..*] • SubAdministrativeArea [0..1] |
Used In |
Address |
Examples |
|
Element |
[Address.AdministrativeArea.]NameElement |
BaseType |
ct:String |
Usage |
REQUIRED [1..1] |
Definition |
Data associated with the Administrative Area. e.g. Full name of administrative area or part of it. eg. MI in USA, NSW in Australia, reference location to the administrative area. |
Comments |
|
Sub-elements |
None |
Used In |
Address.AdministrativeArea |
Examples |
|
Element |
[Address.AdministrativeArea.]SubAdministrativeArea |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Definition |
The next level down division of the area. E.g. state / county, province / reservation. Note that not all countries have a sub-administrative area |
Comments |
|
Sub-elements |
NameElement [1..*] |
Used In |
Address.AdministrativeArea |
Examples |
|
Element |
[Address.AdministrativeArea.SubAdministrativeArea.]NameElement |
BaseType |
ct:String |
Usage |
REQUIRED [1..*] |
Definition |
Data associated with the SubAdministrativeArea. e.g. Full name of sub-administrative area or part of it. |
Comments |
|
Sub-elements |
None |
Used In |
Address.AdministrativeArea.SubAdministrativeArea |
Examples |
|
Element |
[Address.]Locality |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Definition |
Details of Locality which is a named densely populated area (a place) such as town, village, suburb, etc. A locality composes of many individual addresses. Many localities exist in an administrative area or a sub administrative area. A locality can also have sub localities. For example, a municipality locality can have many villages associated with it which are sub localities. Example: Tamil Nadu State, Erode District, Bhavani Taluk, Paruvachi Village is a valid address in India. Tamil Nadu is the Administrative Area, Erode is the sub admin area, Bhavani is the locality, and Paruvachi is the sub locality |
Comments |
|
Sub-elements |
• NameElement [1..*] of type ct:String • SubLocality [0..1] |
Used In |
Address |
Examples |
|
Element |
[Address.Locality.]NameElement |
BaseType |
ct:String |
Usage |
REQUIRED [1..*] |
Definition |
Data associated with the locality. e.g. full name of the locality or part of it, reference location to the locality |
Comments |
|
Sub-elements |
None |
Used In |
Address.Locality |
Examples |
|
Element |
[Adress.Locality.]SubLocality |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Definition |
A locality that is smaller and is contained within the boundaries of its parent locality. Note that not all localities have sub-locality. For example, many areas within a locality where each area is a sub-locality |
Comments |
|
Sub-elements |
NameElement [1..*] |
Used In |
Address.Locality |
Examples |
|
Element |
[Address.Locality.SubLocality.]NameElement |
BaseType |
ct:String |
Usage |
REQUIRED [1..*] |
Definition |
Data associated with the sub-locality. e.g. Full name of the locality or part of it, reference location to the locality. |
Comments |
|
Sub-elements |
None |
Used In |
Address.Locality.SubLocality |
Examples |
|
Element |
[Address.]Thoroughfare |
BaseType |
ThoroughfareType |
Usage |
OPTIONAL [0..1] |
Definition |
Details of the Access route along which buildings/lot/land are located, such as street, road, channel, crescent, avenue, etc. This also includes canals/banks on which houses/boat houses are located where people live |
Comments |
The Type attribute represents the type of thoroughfare. e.g. primary road, secondary road, road branch (e.g. Lane 14), road sub branch (e.g. Alley 21), adjourning street, cross street, closest street, etc |
Attributes |
Type: ThoroughfareTypeList (see xAL-types.xsd) |
Sub-elements |
Choice [1..*] between • NameElement [1..1] OR • Number [1..1] |
Used In |
Address |
Examples |
|
Element |
[Address.Thoroughfare.]NameElement |
BaseType |
ct:String |
Usage |
REQUIRED [1..1] |
Definition |
Data associated with the thoroughfare details. e.g. Full thoroughfare name or part of it, type of thoroughfare, old name, new name, reference data in support of the thoroughfare |
Comments |
|
Attributes |
• ct:grAbbreviation – xs:boolean (see CommonTypes.xsd) • NameType: ThoroughfareNameTypeList (see xAL-types.xsd) |
Sub-elements |
None |
Used In |
Address.Thoroughfare |
Examples |
|
Element |
[Address.Thoroughfare.]Number |
BaseType |
IdentifierType extends ct:String |
Usage |
REQUIRED [1..1] |
Definition |
Data associated with the number of the thoroughfare. E.g. 39 in 39 Baker Street, street range, street suffix |
Comments |
The Type attribute indicates which part of number or identifier this element contains. Some "numbers" are as simple as 42 and some "numbers" are more like complex aplhanumeric identifiers as Postcodes in UK or Canada, e.g. M2H 2S5. It may be necessary to separate the "number" into sub-elements and indicate what type of information each of them contains. |
Attributes |
• Type: IdentifierElementTypeList (see xAL-types.xsd) • ct:grAbbreviation – xs: boolean (see CommonTypes.xsd) |
Sub-elements |
None |
Used In |
Address.Thoroughfare |
Examples |
|
Element |
[Address.]PostCode |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Definition |
A container for a single free text or structured postcode. Note that not all countries have post codes |
Comments |
The postcode is formatted according to country-specific rules. Example: SW3 0A8-1A, 600074, 2067. This element can also be used to define the semantics of what each code in the post code means |
Sub-elements |
Identifier [1..*] |
|
|
Used In |
Address |
Examples |
|
Element |
[Address.PostCode.]Identifier |
BaseType |
IdentifierType extends ct:String |
Usage |
REQUIRED [1..*] |
Definition |
The postcode is formatted according to country-specific rules. Example: SW3 0A8-1A, 600074, 2067. This element can also be used to define the semantics of what each code in the post code means |
Comments |
The Type attribute indicates which part of number or identifier this element contains. Some "numbers" are as simple as 42 and some "numbers" are more like complex aplhanumberic identifiers as Postcodes in UK or Canada, e.g. M2H 2S5. It may be necessary to separate the "number" into sub-elements and indicate what type of information each of them contains. |
Attributes |
• Type: IdentifierElementTypeList (see xAL-types.xsd) • ct:grAbbreviation – xs: boolean (see CommonTypes.xsd) |
Sub-elements |
None |
Used In |
Address.PostCode |
Examples |
|
Element |
ContactNumbers |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Schema |
edxl-xPIL.xsd |
Definition |
A container for all kinds of telecommunication lines of party used for contact purposes. e.g. phone, fax, mobile, pager, etc. |
Comments |
|
Sub-elements |
ContactNumber [1..*] |
Used In |
• Party • PersonDetails • OrganisationDetails |
Examples |
|
Element |
ContactNumber |
BaseType |
complexType |
Usage |
REQUIRED [1..*] |
Definition |
Universal telecommunication number structure |
Comments |
|
Attributes |
• CommunicationMediaType: CommunicationMediaTypeList (xPIl-types.xsd) • Usage: ContactNumberUsageList (see xPIl-types.xsd) • ContactHours: ct:String |
Sub-elements |
ContactNumberElement [0..*]
|
Used In |
ContactNumbers |
Examples |
|
Element |
[ContactNumber.]ContactNumberElement |
BaseType |
ct:String |
Usage |
OPTIONAL [0..*] |
Definition |
Full contact number or part of it |
Comments |
|
Attributes |
Type: ContactNumberElementList (see xPIL-types.xsd) |
Sub-elements |
None |
Used In |
ContactNumber |
Examples |
|
Element |
ElectronicAddressIdentifiers |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Schema |
edxl-xPIL.xsd |
Definition |
A container of different types of electronic addresses of party (e.g. email, chat, skype, etc) |
Comments |
|
Sub-elements |
ElectronicAddressIdentifier [1..*]
|
Used In |
• Party • PersonDetails • OrganisationDetails |
Examples |
|
Element |
ElectronicAddressIdentifier |
BaseType |
ct:String |
Usage |
REQUIRED [1..*] |
Definition |
Universal telecommunication number structure |
Comments |
|
Attributes |
• Type: ElectronicAddressIdentiferTypeList (see xPIL-types.xsd) • Usage: ElectronicAddressIdentifierUsageList (see xPIL-types.xsd) |
Sub-elements |
None |
Used In |
ElectronicAddressIdentifiers |
Examples |
|
Element |
Identifiers |
BaseType |
complexType |
Usage |
OPTIONAL [0..1] |
Schema |
edxl-xPIL.xsd |
Definition |
A container for a list of Identifiers to recognise the party such as customer identifer, social security number, tax number, etc |
Comments |
|
Sub-elements |
Identifier [1..*]
|
Used In |
• Party • PersonDetails |
Examples |
|
Element |
Identifier |
BaseType |
complexType |
Usage |
REQUIRED [1..*] |
Definition |
Identifier to recognise the party such as customer identifer, social security number, National ID Card, tax number, buiness number, company number, company registration, etc |
Comments |
|
Attributes |
Type: PartyIdentifierTypeList (see xPIL-types.xsd) |
Sub-elements |
• IdentifierElement [0..*] • IssuerName [0..1] |
Used In |
Identifiers |
Examples |
|
Element |
[Identifier.]IdentifierElement |
BaseType |
ct:String |
Usage |
OPTIONAL [0..*] |
Definition |
Information about the identifier |
Comments |
|
Attributes |
Type: PartyIdentifierElementList (see xPIL-types.xsd) |
Sub-elements |
|
Used In |
Identifier |
Examples |
|
Element |
[Identifier.]IssuerName |
BaseType |
xnl:OrganisationNameType |
Usage |
OPTIONAL [0..1] |
Definition |
Reference to a Party element that describes the issuing organisation |
Comments |
|
Attributes |
• OrganisationID: ct:String • OrganisationIDType: OrganisationIDTypeList (see xNL-types.xsd) |
Sub-elements |
• NameElement [0..*]: ct:String • SubDivisionName [0..*]: ct:String |
Used In |
Identifier |
Examples |
|
Element |
OrganisationInfo |
BaseType |
complexType |
Usage |
|
Definition |
Container for organisation specific details that are not covered in this schema that is common to a party |
Comments |
|
Attributes |
• Type: OrganisationInfoTypeList (see xPIL-types.xsd) • CategoryType: OrganisationCategoryTypeList (see xPIL-types.xsd) • Status: ct:StatusList (see CommonTypes.xsd) • Nature: OrganisationInfoNatureList (see xPIL-types.xsd) • IndustryType: IndustryTypeList (see xPIL-types.xsd) • IndustryCode: IndustryCodeList (see xPIL-types.xsd) • IndustryCodeType: ct:String • NumberOfEmployees: ct:String • OperatingHourStartTime: xs:time • OperatingHourEndTime: xs:time • anyAttribute from namespace=”##other” • AttributeGroups: ct:grDataQuality (see CommonTypes.xsd) ◦ DataQualityType: DataQualityTypeList (see CommonTypes.xsd) ◦ ValidFrom: xs:dateTime ◦ ValidTo: xs:dateTime |
Sub-elements |
None |
Used In |
• Party • OrganisationDetails |
Examples |
|
Attribute |
CategoryType |
BaseType |
OrganisationCategoryTypeList |
Usage |
|
Definition |
List of category the organisation belongs to |
Comments |
The OrganisationCategoryTypeList is found in xPIL-types.xsd. |
Values |
Vendor, GovernmentAgency, University, College, School, Club, Association, Consortium, Company |
Used In |
OrganisationInfo |
Examples |
|
Attribute |
DataQualityType |
BaseType |
ct:DataQualityTypeList |
Usage |
|
Definition |
A list of values to indicate the level of reliability of the data |
Comments |
The DataQualityTypeList is found in CommonTypes.xsd. |
Values |
Valid, Invalid |
Used In |
OrganisationInfo |
Examples |
|
Attribute |
[IdentifierElement.]Type |
BaseType |
PartyIdentifierElementList |
Usage |
|
Definition |
List of information types used for describing party identifiers |
Comments |
The PartyIdentiferElementList is found in xPIL-types.xsd. |
Values |
Identifier, IssuingCountryName |
Used In |
IdentifierElement |
Examples |
|
Attribute |
[Identifier.]Type |
BaseType |
PartyIdentifierTypeList |
Usage |
|
Definition |
List of identifier types |
Comments |
The PartyIdentiferTypeList is found in xPIL-types.xsd. |
Values |
TaxID, CompanyID, NationalID, RegistrationID |
Used In |
Identifier |
Examples |
|
Attribute |
[ElectronicAddressIdentifier.]Type |
BaseType |
ElectronicAddressIdentifierTypeList |
Usage |
|
Definition |
List of electronic address identifiers |
Comments |
The ElectronicAddressIdentifierTypeList is found in xPIL-types.xsd. |
Values |
AIM, EMAIL, GOOGLE, GIZMO, ICQ, JABBER, MSN, SIP, SKYPE, URL, XRI, YAHOO
|
Used In |
ElectronicAddressIdentifier |
Examples |
|
Attribute |
[ContactNumberElement.]Type |
BaseType |
ContactNumberElementList |
Usage |
|
Definition |
List of information types used for phone number details |
Comments |
The ContactNumberElementList is found in xPIL-types.xsd. |
Values |
CountryCode, AreaCode, LocalNumber, Extension, Pin, Separator, NationalNumber, InternationalNumber |
Used In |
ContactNumberElement |
Examples |
|
Attribute |
CommunicationMediaType |
BaseType |
CommunicationMediaTypeList |
Usage |
|
Definition |
List of communication media types used for contact purposes |
Comments |
The CommunicationMediaTypeList is found in xPIL-types.xsd. |
Values |
Cellphone, Fax, Pager, Telephone, VOIP |
Used In |
ContactNumber |
Examples |
|
The last numbered section in the specification must be the Conformance section. Conformance Statements/Clauses go here.
TBD
The following individuals have participated in the creation of this specification and are gratefully acknowledged:
Participants
Don McGarry, MITRE Corp., Member
Jeff Waters, DoD, Member
Werner Joerg, IEM Inc., Member
Revision |
Date |
Editor |
Changes Made |
WD01 |
03/02/2011 |
Jeff Waters |
Initial setup |
WD02 |
04/21/2011 |
Werner Joerg |
Completion, clean up, ready for TC review |
|
05/10/2011 |
Werner Joerg |
Fixed link for [WGS 84] reference |
WD03 |
07/28/2011 |
Werner Joerg |
Fixed xPIL namespace |
WD04 |
12/19/2011 |
Werner Joerg |
Adapted to naming convention: replaced underscores “_” (in edxl_xAL, edxl_xNL and edxl_xPIL) with “-” |