Normandie WebLog: Description du fichier data.xml

décembre 21, 2002

Description du fichier data.xml

Chaque commune possède un fichier data.xml, donc dans les répertoires 14, 27, 50, 61 et 76.

Les autres répertoires thématiques comme la culture et par exemple un écrivain ne possède pas de tels fichiers.

Le fichier data.xml sert à collecter les données au fur et à mesure sur les communes. Quand le champs est rempli, il possède une valeur dépendante de la sémantique, quand il n'est pas rempli il prend la valeur void ou l'élément est vide <surface>.

Exemple de fichier data.xml

Commune de La Saussaye

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE citydata
  PUBLIC "-//NW//DTD City Data//EN" "http://www.normandieweb.org/web/citydata.dtd">
<citydata>
   <region>Haute-Normandie</region>
   <dpt>Eure</dpt>
   <prefecture>void</prefecture>
   <sousprefecture>void</sousprefecture>
   <canton>Amfreville-la-Campagne</canton>
   <nomville>La Saussaye</nomville>
   <nomhab>void</nomhab>
   <habnbr>1844</habnbr>
   <cp>void</cp>
   <geo>
      <lat>void</lat>
      <long>void</long>
      <altitude>void</altitude>
      <surface/>
   </geo>
   <voir>"André Maurois", Eglise</voir>
   <people>void</people>
</citydata>

Sémantique

xml declaration: Le document est encodé en UTF-8 et en XML version 1.0
DOCTYPE: La DTD n'est pas encore créée mais il faut le faire. L'identificant unique est DTD City Data, et l'URL est donnée dans le document précédent
citydata: Elément racine du document, il contient tous les éléments. Il ne doit pas contenir de texte particuliers
region: Nom de la région où se situe la commune : 2 valeurs possibles uniquement, "Basse-Normandie" et "Haute-Normandie". (non modifiable)
dpt: Nom du département où se situe la commune : 5 valeurs possibles uniquement, "Calvados", "Eure", "Manche", "Orne", "Seine-Maritime". (Ces départements ont un équivalent numérique mais qui ne figure pas dans ce fichier (dans le même ordre : 14, 27, 50, 61, 76) (non modifiable)
prefecture: Nom de la préfecture. Pour l'instant c'est de type void. Les données seront des données fixes à compléter. Par exemple, Evreux ou Rouen (non modifiable)
sousprefecture: Nom de la sous-préfecture. Pour l'instant c'est de type void. Les données seront des données fixes à compléter. Par exemple, Le Havre (non modifiable)
canton: nom du canton où sont regroupés les villes d'une canton, la plupart du temps, c'est le nom du chef-lieu de canton. Ex : Amfreville-la-Campagne, (non modifiable)
nomville: Nom de la Commune. Ex : La Saussaye (non modifiable)
nomhab: Nom des habitants. Pour l'instant c'est de type void. Par exemple, Saulcéens. Parfois, il est possible d'avoir deux noms reconnus pour une même commune
habnbr: Nombre des habitants. format numérique. Ex: 1844
cp: Code postal. un nombre à 5 chiffres. Ex: 27310 (non modifiable, une fois donné)
geo: Cet élément contient les éléments concernant les données géographiques spécifiques à une commune : lat, long, altitude, surface
lat: Latitude : la latitude de la commune. Les latitudes de Normandie sont comprises entre 48° Nord et 51°N. Ex pour Dieppe : 49°55 N
long: Longitude : la longitude de la commune. Les longitudes de Normandie sont comprises entre 2° Ouest et 2° Est. Ex pour Dieppe : 1°05 E
altitude: Altitude de la commune en mètres. Ex : 134 m.
surface: Surface de la commune en hectares (ha) (100m x 100m)
voir: Liste séparée par des virgules des sites et édifices à voir dans la commune.
people: Liste séparée par des virgules des personnes célèbres de la commune.

Each city has a file data.xml, in the directories: 14, 27, 50, 61 et 76.

The others thematical directories like culture and into it for a writer does not have this kind of file.

The file data.xml is used to collect data about cities step by step. When the field is filled, it takes a value depending on the semantics. When it is empty, it has a value void or the element is empty <surface>.

Sample of a file data.xml

City of La Saussaye

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE citydata
  PUBLIC "-//NW//DTD City Data//EN" "http://www.normandieweb.org/web/citydata.dtd">
<citydata>
   <region>Haute-Normandie</region>
   <dpt>Eure</dpt>
   <prefecture>void</prefecture>
   <sousprefecture>void</sousprefecture>
   <canton>Amfreville-la-Campagne</canton>
   <nomville>La Saussaye</nomville>
   <nomhab>void</nomhab>
   <habnbr>1844</habnbr>
   <cp>void</cp>
   <geo>
      <lat>void</lat>
      <long>void</long>
      <altitude>void</altitude>
      <surface/>
   </geo>
   <voir>"André Maurois", Eglise</voir>
   <people>void</people>
</citydata>

Sémantique

xml declaration: The document is encoded in UTF-8 and it's in XML version 1.0
DOCTYPE: the DTD is not yet created but I have to do it. The unique identifier is DTD City Data and the URI is given in the previous document.
citydata: Document root element, it contains every elements. It must not contain particular text.
region: Name of the région where the city is : 2 values only, "Basse-Normandie" and "Haute-Normandie". (not modifiable)
dpt: Name of département where the city is : 5 values only, "Calvados", "Eure", "Manche", "Orne", "Seine-Maritime". (These départements have a numeric equivalent which is not contained in the file (in the same order : 14, 27, 50, 61, 76) (not modifiable)
prefecture: Name of préfecture. void for now. The data will be stable, but still to fill. For example, Evreux or Rouen (not modifiable)
sousprefecture: Name of sous-préfecture. void for now. The data will be stable, but still to fill. For example, Le Havre (not modifiable)
canton: name of canton which belongs to a group of cities, most of the time, it's the name of chef-lieu de canton. Ex : Amfreville-la-Campagne, (not modifiable)
nomville: Name of the city. Ex : La Saussaye (not modifiable)
nomhab: Name of inhabitants. void for now. For example, Saulcéens. It could happen that we have two different names for the same city
habnbr: Number of inhabitants. digital format. Ex: 1844
cp: Code postal. a number with 5 digits. Ex: 27310 (not modifiable, when given)
geo: This element contains geographical elements about the city : lat, long, altitude, surface
lat: Latitude : city latitude. Normandie's latitudes are between 48° North and 51° North. Ex for Dieppe : 49°55 N
long: Longitude : city longitude. Normandie's longitudes are between 2° West et 2° East. Ex for Dieppe : 1°05 E
altitude: City altitude in meters. Ex : 134 m.
surface: Surface of the city in hectares (ha) (100m x 100m)
voir: Comma separated list of things to see in the city.
people: Comma separated list of known people in the city.

Posted by karl at décembre 21, 2002 06:55 PM