23.1. Guide d'utilisation de xNAL

Informations supplémentaires et exemples d'utilisation pour les éléments de métadonnée de carte bookmap DITA associés au standard xNAL (extensible Name and Address Language) OASIS.

Les cartes bookmap DTA utilisent un ensemble d'éléments associés à un sous-ensemble de la spécification OASIS extensible Name and Address Language (xNAL) (version 2) pour dénoter les noms et adresses liées aux personnes et aux organisations.

Bien que les éléments partagent les mêmes noms et que le contenu produit en utilisant ce type de métadonnée devrait être facile à transformer, les couples de noms d'élément n'ont pas les mêmes modèles de contenu. La différence entre les modèles de contenu reflète les buts différents des deux standards. Le but des éléments <name> et <address> dans DITA est d'identifier les personnes ou les organisations associées à la création d'un document ; le but des éléments <name> et <address> dans xNAL est d'appuyer la gestion de la clientèle (customer resource management).

Les exemples donnés après le tableau fournissent des méthodes de balisage pour des coordonnées (name and address information), en utilisant les éléments DITA associés à xNAL.

Éléments DITA associés à des éléments xNAL

L'ensemble des éléments de carte bookmap associés à des éléments du standard OASIS extensible Name and Address Language (xNAL) est listé dans le tableau ci-dessous.

Tableau 1. Éléments DITA associés à des éléments xNAL
addressdetails honorific otherinfo
administrativearea lastname person
authorinformation locality personinfo
contactnumber localityname personname
contactnumbers middlename postalcode
country namedetails thoroughfare
emailaddress organization url
emailaddresses organizationinfo urls
firstname organizationname
generationidentifier organizationnamedetails  

Exemple 1 — Marquage des coordonnées personnelles en DITA

Cet exemple montre une façon de marquer les noms et descriptions suivants :

Mr. Ram V. Kumar Jr.
Chief Technologist
MSI Business Solutions

<authorinformation>
  <personinfo>
    <namedetails>
      <personname>
        <honorific>Mr.</honorific>
        <firstname>Ram</firstname>
        <middlename>V.</middlename>
        <lastname>Kumar</lastname>
        <generationidentifier>Jr.</generationidentifier>
        <otherinfo>Chief Technologist</otherinfo>
      </personname>
    </namedetails>
  </personinfo>
  <organizationinfo>
    <namedetails>
      <organizationnamedetails>
        <organizationname>MSI Business Solutions</organizationname>
      </organizationnamedetails>
    </namedetails>
  </organizationinfo>
</authorinformation>

Exemple 2 — Marquage de l'adresse en DITA

Cet exemple montre une façon de marquer l'adresse suivante :

23 Archer St.
Chatsworth
NSW 2067
Australia

<addressdetails>
  <thoroughfare>123 Archer St.</thoroughfare>
  <locality>
    <localityname>Chatsworth</localityname>
    <postalcode>2067</ppostalcode>
  </locality>
  <administrativearea>NSW</administrativearea>
  <country>Australia</country>
</addressdetails>

Exemple 3 — Marquage de coordonnées complexes en DITA

Cet exemple montre deux façons de marquer une collection assez complexe de coordonnées personnelles, professionnelles et géographiques :

Mr. Samuel L. Johnson Jr.
Chief Technologist
c/o XYZ Corporation
52 New Main St.
Carrboro,  NC  27510  USA
email: johnson@example.com
phone: 919-555-7987

Cette méthode marque toutes les coordonnées professionnelles associées à la personne identifiée :

<personinfo>
   <namedetails>
      <personname>
          <firstname>Samuel</firstname>
          <middlename>L.</middlename>
          <lastname>Johnson</lastname>
          <generationidentifier>Jr.</generationidentifier>
          <otherinfo>Chief Technologist</otherinfo>
          <otherinfo>c/o XYZ Corporation </otherinfo>
      </personname>
   </namedetails>
   <addressdetails>
      <thoroughfare>52 New Main St.</thoroughfare>
      <locality>
         <localityname>Carrboro</localityname>
         <postalcode>27510</postalcode>
      </locality>
      <administrativearea>NC</administrativearea>
      <country>USA</country>
   </addressdetails>
   <contactnumbers>
      <contactnumber>919-555-7987</contactnumber>
   </contactnumbers>
   <emailaddresses>
      <emailaddress>johnson@example.com</emailaddress>
   </emailaddresses>
</personinfo>  

La méthode suivante sépare les coordonnées personnelles et professionnelles. On pourrait l'employer s'il fallait associer des adresses à des organisations plutôt qu'à des personnes :

<authorinformation>
  <personinfo>
    <namedetails>
      <personname>
        <firstname>Samuel</firstname>
        <middlename>L.</middlename>
        <lastname>Johnson</lastname>
        <generationidentifier>Jr.</generationidentifier>
        <otherinfo>Chief Technologist</otherinfo>
      </personname>
    </namedetails>
    <contactnumbers>
      <contactnumber>919-555-7987</contactnumber>
    </contactnumbers>
    <emailaddresses>
      <emailaddress>johnson@example.com</emailaddress>
    </emailaddresses>
  </personinfo>  
  <organizationinfo>
    <namedetails>
      <organizationnamedetails>
        <organizationname>XYZ Corporation</organizationname>
        <otherinfo>c/o </otherinfo>
      </organizationnamedetails>
    </namedetails>
    <addressdetails>
      <thoroughfare>52 New Main St.</thoroughfare>
      <locality>
         <localityname>Carrboro</localityname>
         <postalcode>27510</postalcode>
      </locality>
      <administrativearea>NC</administrativearea>
      <country>USA</country>
    </addressdetails>
  </organizationinfo>
</authorinformation>