Modification du XSD

Le fichier XSD utilisé par aLTAG3D pour fonctionner est maintenu par les chercheurs du Consortium 3D. Cependant, aLTAG3D étant un logiciel Open-Source, il est possible que vous cherchiez à modifier ce fichier XSD par vous même.

Le fichier XSD actuel est disponible ici.

Parsage du fichier XSD

Le fichier XSD n’est pas utilisable tel quel par aLTAG3D, il faut en effet effectuer une requête xquery particulière sur le fichier XSD afin d’en extraire un fichier XML utilisable par le logiciel.

Cette requête était au départ effectuée directement dans aLTAG3D, un problème de version de XQuery dans Qt nous a forcé à déplacer cette étape hors du logiciel.

Le parseur XQuery utilisé est Saxon-HE-9.

java -classpath saxon9he.jar net.sf.saxon.Query -q:altag.xq inputDocument=mdacst3d.xsd -o:mdacst3d.xml

Le fichier altag.xq est disponible dans les sources.

Modification des fichiers de configuration

En plus du fichier XSD et de son équivalent parsé, aLTAG3D utilise un fichier de configuration appelé altag.json.

Ce fichier permet de rajouter des informations concernant le XSD sans pour autant le surcharger de données nécessaire uniquement à aLTAG3D et non à l’archivage en lui même.

altag.json :
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
{
    "version": "1.0",
    "indicators": {"maillage":"nomMaillage","groupeSource":"description","objetVirtuel":"vignette"},
    "mapToSIP": {"creator":"entiteResponsable","subject":"sujet",
                 "description":"descriptionArcheologique","date":"dateProjet",
                 "coverage":["dateArcheologique","lieuConservation","lieuDecouverte"],
                 "fichier":"cheminFichier","identifiantDocProducteur":"createur",
                 "compression":"compression","encodage":"encodage",
                 "formatFichier":"formatFichier","nomFichier":"cheminFichier",
                 "empreinteOri":"empreinteOri","noteFichier":"note","structureFichier":"structureFichier",
                 "structureDocument":"structureDocument"
                },
    "fichMeta":["fichier3DGeometrie","fichier3DTexture","fichierArchive",
                "fichierDonneesVolumiques","fichierLasergrammetrie",
                "fichierParadonnees","fichierPhotogrammetrie"],
    "autoCompletion":["nombreFichiers","structureDocument"]
}

Utilisations du fichier de configuration par aLTAG3D :

  • version : détermine la version du fichier XSD
  • indicators : indique les noms des données utilisées comme “labels” sur certaines boîtes
  • mapToSIP : permet de fixer en dur certains noms dans le code et de pouvoir simplement les modifier plus tard (utilisé lors de la création du SIP.xml)
  • fichMeta : ensemble des boîtes utilisant des fichiers (utilisé lors de la création du SIP.xml)
  • autoCompletion : ensemble des boîtes pouvant être auto-complétées (hors fichiers)