Document obsolète

1.Introduction

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.

1.1.Espace de noms INSEE

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

1.2.Conditions d'utilisation

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.

2.Table des matières

3.Description

Code pays
Les "codes pays" publiés par l'ISO sous la référence ISO 3166-1 sont élaborés à partir d'une liste de pays établie par les Nations Unies sous trois formes strictement équivalentes (numérique à 3 chiffres et alphabétiques à 2 et 3 caractères). Dans les trois cas, les codes identifient la même liste d'entités. Bien que ces entités regroupent en octobre 2003 192 pays mais également 47 territoires, il est d'usage d'appeler "codes pays ISO" les codes ISO 3166-1.
Code pays numérique
Le code ISO 3166-1 "numérique 3" associe un numéro à trois chiffres à chaque entité. Étant purement numérique, il est utilisable quel que soit l'alphabet utilisé et est, pour cette raison, utilisé dans des contextes où des caractères non latins sont utilisés. Étant peu utilisé en France, il n'a pas été intégré aux types de données définis dans l'espace de noms de l'INSEE.
Code pays alpha-2 (A2)
Le code ISO 3166-1 "alpha-2" (ou A2) associe un code à deux caractères à chaque entité. Ces deux caractères sont choisis de manière à être facilement associables au pays qu'ils désignent (par exemple "FR" pour la France). Très utilisé, ce code est recommandé par de nombreux autres organismes de normalisation et notamment par le W3C pour l'identification des pays et des langues sur le Web.
Code pays alpha-3 (A3)
Le code ISO 3166-1 "alpha-3" (ou A3) associe un code à trois caractères à chaque entité. Conçu par l'ISO pour permettre une meilleure "association visuelle entre le nom de pays et le codet que ne le permet le code alpha-2", il est utilisé par la norme ISO 7501-1 portant sur les passeports pour identifier la nationalité et est parfois appelé à tort "code nationalité" pour cette raison.

4.Codes pays ISO 3166-1 A2

4.1.Type Code_Pays_ISO_stype

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>
        

4.2.Élément 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>
        

4.3.Attribut Code_Pays_ISO

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>
        

5.Codes pays ISO 3166-1 A3

5.1.Type Code_Pays_ISO_A3_stype

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>
        

5.2.Élément 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>
        

5.3.Attribut Code_Pays_ISO_A3

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>
        

6.Conseils d'utilisation

6.1.Quand utiliser les types?

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.

7.Téléchargement

Les documents suivants sont disponibles pour téléchargement.

7.1.Schéma

[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>
        

7.2.Exemples utilisant les types - schéma

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>
        

7.3.Exemples utilisant les types - document

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>
        

7.4.Exemples utilisant les éléments et attributs

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>
        

8.Références

Les documents et sites de référence suivants ont été utilisés pour la constitution de ce vocabulaire XML.

8.1.Autorité de mise à jour de l'ISO 3166

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.

8.2.Les listes de codes de l'ISO 3166

La liste des codes ISO 3166-1 A2 est publié sous différents formats sur le site de l'ISO.

9.Ressources

Les ressources suivantes sont définies ou référencées dans ce document :

9.1.Liste alphabétique

Attribut Code_Pays_ISO
Fonction : référence normative
Nature : XHTML
Attribut Code_Pays_ISO_A3
Fonction : référence normative
Nature : XHTML
Autorité de mise à jour de l'ISO 3166
Fonction : référence non normative
Nature : HTML
[Lien externe]
Conditions d'utilisation
Fonction : référence normative
Nature : HTML
[Lien externe]
Espace de noms INSEE
Fonction : espace de noms
Nature : XHTML
[Lien externe]
Exemples utilisant les types - document
Fonction : référence non normative
Nature : XML
Exemples utilisant les types - schéma
Fonction : référence non normative
Nature : W3C XML Schema
Exemples utilisant les éléments et attributs
Fonction : référence non normative
Nature : XML
Les listes de codes de l'ISO 3166
Fonction : référence normative
Nature : HTML
[Lien externe]
Schéma
Fonction : validation par schéma
Nature : W3C XML Schema
Type Code_Pays_ISO_A3_stype
Fonction : référence normative
Nature : XHTML
Type Code_Pays_ISO_stype
Fonction : référence normative
Nature : XHTML
Élément Code_Pays_ISO
Fonction : référence normative
Nature : XHTML
Élément Code_Pays_ISO_A3
Fonction : référence normative
Nature : XHTML

9.2.Par catégories

Ressources internes

  • référence normative
  • Ressources externes

  • espace de noms
  • référence normative
  • référence non normative
  • validation par schéma