Transformation XSLT (Conversion)
Récapitulatif
Utilise le logiciel XML .NET, version 3.5 pour transformer les métadonnées d'un élément ArcGIS ou tout fichier XML à l'aide d'une feuille de style XSLT 1.0 et enregistrer le résultat dans un fichier XML.
Les feuilles de style XSLT permettent d'apporter des modifications différentes aux métadonnées ArcGIS ou à un fichier XML. Plusieurs feuilles de style XSLT sont fournies avec ArcGIS. Certaines feuilles de styles transforment des métadonnées en pages HTML pour l'affichage. D'autres sont utilisées par les outils de géotraitement du modèle de métadonnées pour effectuer une partie des processus d'importation, d'exportation et de mise à niveau des métadonnées. Ces feuilles de style permettent également d'effectuer des tâches de métadonnées connues. Ces feuilles de style se trouvent dans le dossier <ArcGIS Install Location>\Metadata\Stylesheets.
Vous pouvez créer vos propres feuilles de style XSLT pour effectuer des tâches en vous inspirant des feuilles de style fournies à titre d'exemple. Vous pourriez ainsi écrire une feuille de style pour :
- mettre à jour les adresses et numéros de téléphone. Créez un modèle qui exécute ce processus et qui utilise ensuite l'outil Copier les métadonnées pour enregistrer les métadonnées mises à jour dans l'élément ArcGIS d'origine.
- supprimer les informations que vous ne voulez pas rendre publiques avant d'exporter ou de publier les métadonnées. Créez un modèle qui exécute ce processus avant d'exécuter les outils Exporter des métadonnées ou Publier les métadonnées.
- créer une page HTML pour afficher des informations sur un élément ArcGIS dans un site Web. Utilisez la feuille de style ArcGIS.xsl pour afficher des métadonnées dans ArcGIS ou écrivez votre propre feuille de style.
Les feuilles de style XSLT qui modifient les métadonnées ArcGIS ne doivent pas supprimer les informations contenues dans les éléments de métadonnées de type Esri et Binaire, sauf si le XML en sortie est utilisé en dehors d'ArcGIS.
Utilisation
-
Le fichier en sortie généré par une feuille de style XSLT peut être au format XML, HTML ou texte, par exemple. Le nom de fichier en sortie par défaut qui est fourni par cet outil a l'extension .xml. Si la feuille de style XSLT que vous utilisez ne produit pas de fichier XML vous devez fournir un nom de fichier avec une extension de fichier plus adaptée.
Cet outil ne peut pas traiter les métadonnées d'un élément ArcGIS ou un fichier XML de métadonnées autonomes à l'aide des feuilles de style XSL fournies avec ArcGIS Desktop 9.3.1 et les versions antérieures car ces versions n'utilisent pas la technologie XSLT 1.0. Elles utilisent une technologie plus ancienne qui n'est pas prise en charge par .NET Framework, version 3.5. Vous ne pouvez pas plus utiliser les feuilles de style XSL avec l'éditeur de métadonnées ArcGIS.
-
Vous pouvez utiliser le paramètre XSLT pour transmettre une chaîne ou un nom de fichier XML à une feuille de style XSLT qui peut alors l'utiliser pour modifier les métadonnées d'un élément. Par exemple, une feuille de style XSLT peut exploiter un numéro de téléphone transmis sous la forme d'une chaîne et mettre à jour tous les numéros de téléphone dans les métadonnées. Si un fichier XML est transmis avec ce paramètre, une feuille de style XSLT peut fusionner son contenu avec les métadonnées source.
Reportez-vous au fichier add unique identifier.xslt fourni avec ArcGIS pour savoir comment transmettre une valeur et au fichier merge upgraded FGDC with existing.xslt pour savoir comment fusionner les informations d'un fichier XML séparé avec les métadonnées d'un élément ArcGIS.
Si vous voulez créer une feuille de style XSLT personnalisée pour afficher ou exporter des métadonnées ou des fichiers XML dans ArcGIS, reportez-vous à la documentation Microsoft sur le .NET Framework version 3.5 pour obtenir la liste exhaustive des fonctions et des éléments XSLT et XPath et de leur syntaxe pris en charge par ce framework. Les fonctions répertoriées dans cette liste sont les seules fonctions que vous pouvez utiliser avec cet outil et dans l'éditeur de métadonnées ArcGIS.
Si vous voulez utiliser votre feuille de style personnalisée dans ArcGIS et en dehors d'ArcGIS tout à la fois, utilisez exclusivement les éléments, les fonctions et la syntaxe de XSLT 1.0 et de Xpath 1.0. Si les applications utilisées ne sont pas des applications Microsoft, il est peu probable qu'elles prennent en charge les fonctions XSLT et Xpath ainsi que les fonctions spécifiques de Microsoft.
Les feuilles de style XSLT utilisées exclusivement avec cet outil de géotraitement et l'éditeur de métadonnées ArcGIS peuvent utiliser des fonctions XSLT personnalisées fournies avec ArcGIS pour améliorer la gestion et l'affichage des métadonnées. Pour utiliser ces fonctions, la feuille de style XSLT doit référencer l'URI de l'espace de noms de la fonction XSLT d'ESRI http://www.esri.com/metadata/. Par exemple, <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:esri="http://www.esri.com/metadata/">.
Les fonctions XSLT ArcGIS doivent être préfacées par le préfixe affecté à l'espace de noms de la fonction XSLT d'ESRI. Si vous avez attribué le préfixe esri à l'espace de noms de la fonction XSLT d'ESRI comme dans l'exemple cité plus haut, la fonction GuidGen () s'utilise de la manière suivante : <xsl:value-of select="esri:GuidGen()" />.
- GuidGen() : renvoie une nouvelle valeur pour l'identifiant GUID (Global unique identifiant) n'incluant ni parenthèses, ni accolades, ({ et }). Par exemple, un GUID peut être inclus dans les métadonnées afin d'identifier uniquement le document de métadonnées ou la ressource qu'il décrit. Reportez-vous au fichier add unique identifier.xslt fourni avec ArcGIS à titre d'exemple.
- strtoupper () : modifie la chaîne de texte en entrée afin de n'utiliser que des majuscules. Reportez-vous au fichier add unique identifier.xslt fourni avec ArcGIS à titre d'exemple.
- strtolower () : modifie la chaîne de texte en entrée afin de n'utiliser que des minuscules.
- striphtml () : si un élément XML contient des séquences d'échappement HTML, cette fonction permet de renvoyer le texte sans les balises HTML. Reportez-vous au fichier ESRIISO2.xslt fourni avec ArcGIS à titre d'exemple.
- decodenodeset () : si un élément XML contient des séquences d'échappement XHTML ou XML, cette fonction renvoie un ensemble de nœuds qui peut être utilisé avec la fonction msxsl:node-set pour traiter les éléments individuels ayant fait l'objet d'un échappement. Reportez-vous au fichier ESRIISO2.xslt fourni avec ArcGIS à titre d'exemple.
-
Le paramètre Métadonnées source est associé à un type de données complexe. Si vous utilisez cet outil dans un modèle, créez une variable pour le paramètre Métadonnées source dans ModelBuilder. Pour ce faire, cliquez avec le bouton droit sur l'outil et sélectionnez Générer une variable > Paramètre de départ > Métadonnées de source.
-
Si un élément ArcGIS contient des métadonnées créées dans ArcGIS Desktop 9.3.1 ou version antérieure à l'aide de l'éditeur de métadonnées FGDC ou dans la version actuelle d'ArcGIS Desktop à l'aide du complément Editeur de métadonnées FGDC et que les métadonnées de l'élément ont été mises à niveau au format ArcGIS, les métadonnées ArcGIS incluent toujours les éléments XML des métadonnées FGDC d'origine. Les métadonnées incluent également d'autres éléments des métadonnées ArcGIS.
Vous pouvez exporter les éléments des métadonnées FGDC d'origine à l'aide de cet outil avec le fichier _MPXML2.xsl fourni avec ArcGIS. Dans l'exemple cité plus haut, ce fichier permet uniquement d'exporter les métadonnées FGDC d'origine de l'élément, à savoir les informations qui s'affichent dans la section des métadonnées FGDC dans l'onglet Description. Les éléments FGDC sont classés correctement dans le fichier XML en sortie.
Le fichier exporté peut être publié dans un catalogue de métadonnées imposant de fournir les informations au format XML de métadonnées FGDC CSDGM. Le fichier exporté peut être validé avec la structure XML FGDC ou le fichier DTD, ou à l'aide de l'utilitaire des métadonnées USGS appelé mp. L'outil Convertisseur de métadonnées USGS MP effectue cette opération en interne avant de traiter les métadonnées.
-
Les métadonnées publiées sur un site Web externe au format HTML sont indexées par les moteurs de recherche Internet tels que Google dans la mesure où le contenu du site Web est correctement affiché.
Syntaxe
| Paramètre | Explication | Type de données |
source |
Elément dont les métadonnées seront converties ou fichier XML autonome à convertir. | Data Element; Layer |
xslt |
Fichier de feuille de style XSLT 1.0 conforme à la norme W3C qui définit la transformation à effectuer. | File |
output |
Fichier à créer, contenant les métadonnées converties. Le type de fichier créé dépend de la méthode en sortie spécifiée dans la feuille de style XSLT. | File |
xsltparam (Facultatif) |
Fichier XML ou chaîne à transmettre à la feuille de style XSLT. Pour capturer ce paramètre dans la feuille de style XSLT, ajoutez <xsl:param name="gpparam" /> en haut de la feuille de style XSLT après l'élément xsl:output et avant le premier élément xsl:template. Reportez-vous au fichier merge upgraded FGDC with existing..xslt pour obtenir un exemple. | File; String |
Exemple de code
Utilise la feuille de style XSLT ArcGIS.xsl fournie avec ArcGIS pour exporter des métadonnées vers un fichier HTML pour une utilisation sur un site Web.
import arcpy
from arcpy import env
env.workspace = "C:/data"
#set local variables
dir = arcpy.GetInstallInfo("desktop")["InstallDir"]
xslt = dir + "Metadata/Stylesheets/ArcGIS.xsl"
arcpy.XSLTransform_conversion("vegetation", xslt, "vegetation.html", "#")