Ce document présente une bibliothèque de types, d'éléments et d'attributs XML permettant de représenter les codes ISO pays et nationalités dans l'espace de noms de l'INSEE.
La définition formelle de cette bibliothèque est réalisée sous la forme d'un schéma W3C XML Schema.
Les types, éléments et attributs décrits décrit dans ce module font partie de l'espace de noms INSEE : http://xml.insee.fr/schema/2004
Cette documentation et les ressources qui en dépendent (schémas, exemples, transformations XSLT) sont soumises aux conditions d'utilisation des informations publiées sur le site de l'INSEE.
La définition d'un code pays ISO (ISO 3166-1 A2) sous forme d'un type simple est la suivante:
§1.
<xs:simpleType name="Code_Pays_ISO_stype"> <xs:restriction base="xs:token"> <xs:length value="2"/> <xs:pattern value="[A-Z]{2}"/> </xs:restriction> </xs:simpleType>
Ce type peut être affecté dans un schéma pour définir des éléments ou attributs contenant des codes pays, par exemple :
§2.
<xs:element name="mon-element-Code_Pays_ISO" type="ie:Code_Pays_ISO_stype"/>
Les éléments ou attributs ainsi définis peuvent ensuite être utilisés dans des documents XML, par exemple
§3.
<ex:mon-element-Code_Pays_ISO>FR</ex:mon-element-Code_Pays_ISO>
La définition de l'élément Code_Pays_ISO est la suivante :
§4.
<xs:element name="Code_Pays_ISO" type="ie:Code_Pays_ISO_stype"/>
Les éléments Code_Pays_ISO peuvent être utilisés directement dans des documents XML, par exemple
§5.
<ex:pays> <ie:Code_Pays_ISO>FR</ie:Code_Pays_ISO> <ex:nom>France</ex:nom> </ex:pays>
La définition de l'attribut Code_Pays_ISO est la suivante :
§6.
<xs:attribute name="Code_Pays_ISO" type="ie:Code_Pays_ISO_stype"/>
Les attributs Code_Pays_ISO peuvent être utilisés directement dans des documents XML, par exemple
§7.
<ex:pays ie:Code_Pays_ISO="FR"> <ex:nom>France</ex:nom> </ex:pays>
La définition d'un code pays ISO (ISO 3166-1 A3) sous forme d'un type simple est la suivante:
§8.
<xs:simpleType name="Code_Pays_ISO_A3_stype"> <xs:restriction base="xs:token"> <xs:length value="3"/> <xs:pattern value="[A-Z]{3}"/> </xs:restriction> </xs:simpleType>
Ce type peut être affecté dans un schéma pour définir des éléments ou attributs contenant des codes pays A3, par exemple :
§9.
<xs:element name="mon-element-Code_Pays_ISO_A3" type="ie:Code_Pays_ISO_A3_stype"/>
Les éléments ou attributs ainsi définis peuvent ensuite être utilisés dans des documents XML, par exemple
§10.
<ex:mon-element-Code_Pays_ISO_A3>FRA</ex:mon-element-Code_Pays_ISO_A3>
La définition de l'élément Code_Pays_ISO_A3 est la suivante :
§11.
<xs:element name="Code_Pays_ISO_A3" type="ie:Code_Pays_ISO_A3_stype"/>
Les éléments Code_Pays_ISO_A3 peuvent être utilisés directement dans des documents XML, par exemple
§12.
<ex:pays> <ie:Code_Pays_ISO>FRA</ie:Code_Pays_ISO> <ex:nom>France</ex:nom> </ex:pays>
La définition de l'attribut Code_Pays_ISO_A3 est la suivante :
§13.
<xs:attribute name="Code_Pays_ISO_A3" type="ie:Code_Pays_ISO_A3_stype"/>
Les attributs Code_Pays_ISO peuvent être utilisés directement dans des documents XML, par exemple
§14.
<ex:pays ie:Code_Pays_ISO="FRA"> <ex:nom>France</ex:nom> </ex:pays>
L'utilisation des éléments et attributs définis dans ce schéma permet de se baser directement sur leur nom (et espace de noms) pour les identifier et les valider.
L'utilisation des types simples définis dans ce schéma permet au contraire d'utiliser des noms d'attributs et d'éléments quelconques (et appartenant à des espaces de noms quelconques).
L'attribution de types à ces éléments et attributs permet de les valider en suivant les définitions de ce schéma.
Ces attributions sont également transmises aux applications supportant W3C XML Schema et son "Post Schema Validation Infoset" (PSVI) qui peuvent reconnaître qu'il s'agit des données d'identification définies par ce schéma.
Les documents suivants sont disponibles pour téléchargement.
[Document]
§15.
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ie="http://xml.insee.fr/schema/2004" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://xml.insee.fr/schema/2004" version="1.0"> <xs:include schemaLocation="insee-commun.xsd"/> §1.Type Code_Pays_ISO_stype §4.Élément Code_Pays_ISO §6.Attribut Code_Pays_ISO §8.Type Code_Pays_ISO_A3_stype §11.Élément Code_Pays_ISO_A3 §13.Attribut Code_Pays_ISO_A3 </xs:schema>
Schéma validant les exemples utilisant les définitions de types :
[Document]
§16.
<xs:schema xmlns:ex="http://dyomedea.com/ns/example" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ie="http://xml.insee.fr/schema/2004" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://dyomedea.com/ns/example" version="1.0"> <xs:import namespace="http://xml.insee.fr/schema/2004" schemaLocation="iso.xsd"/> §2.Type Code_Pays_ISO_stype §9.Type Code_Pays_ISO_A3_stype <xs:element name="exemples"> <xs:complexType> <xs:sequence> <xs:any maxOccurs="unbounded" minOccurs="0" namespace="##targetNamespace" processContents="strict"/> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>
Document XML regroupant les exemples utilisant les définitions de types simples et complexes :
[Document]
§17.
<ex:exemples xmlns:ex="http://dyomedea.com/ns/example" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://dyomedea.com/ns/example exemples-iso-types.xsd"> §3.Type Code_Pays_ISO_stype §10.Type Code_Pays_ISO_A3_stype </ex:exemples>
Document XML regroupant les exemples utilisant les éléments et attributs :
[Document]
§18.
<ex:exemples xmlns:ex="http://dyomedea.com/ns/example" xmlns:ie="http://xml.insee.fr/schema/2004"> §5.Élément Code_Pays_ISO §7.Attribut Code_Pays_ISO §12.Élément Code_Pays_ISO_A3 §14.Attribut Code_Pays_ISO_A3 </ex:exemples>
Les documents et sites de référence suivants ont été utilisés pour la constitution de ce vocabulaire XML.
La section "Autorité de mise à jour de l'ISO 3166 (ISO 3166/MA) - point focal de l'ISO pour les codes de pays" du site de l'ISO regroupe diverses informations concernant les standards ISO 3166 et notamment ISO 3166-1 utilisé pour la définition de ce vocabulaire XML.
La liste des codes ISO 3166-1 A2 est publié sous différents formats sur le site de l'ISO.
Les ressources suivantes sont définies ou référencées dans ce document :