ArcMap

Transformation XSLT

Résumé

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 Desktop. Elles peuvent servir à enregistrer une copie des métadonnées d'un élément dans un fichier XML, à enregistrer une copie de l'affichage des métadonnées dans un fichier HTML et à modifier le contenu des métadonnées d'un élément. Ces feuilles de style XSLT se trouvent dans le dossier <ArcGIS Installation Location>\Metadata\Stylesheets.

Pour en savoir plus sur les feuilles de style XSLT fournies avec ArcGIS Desktop

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 réaliser les opérations suivantes :

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 lorsque le fichier 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 porte 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, de la syntaxe et des éléments XSLT et XPath pris en charge. Outre certaines fonctions XSLT standard, certaines fonctions .NET sont également disponibles.

    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. Il est probable que les applications non Microsoft ne prennent pas en charge les fonctions XSLT et XPath .NET.

  • 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'ArcGIS 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'ArcGIS. Si vous avez attribué le préfixe esri à l'espace de noms de la fonction XSLT d'ArcGIS 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 unique global (GUID) ne comprenant pas d'accolades, ({ and }). 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.
    • decodenodeset() : si un élément XML contient des séquences d'échappement XHTML ou XML, cette fonction renvoie un ensemble de nœud qui peut être utilisé en combinaison avec la fonction msxsl:node-set pour traiter les éléments individuels ayant fait l'objet d'un échappement. Reportez-vous aux fichiers ESRIISO2.xslt et ItemDescription.xslt fournis avec ArcGIS à titre d'exemples. Par exemple, les propriétés de référence spatiale d'un élément sont automatiquement stockées dans les métadonnées d'un élément sous la forme de données XML désactivées. Le contenu abstait et de limites d'utilisation pouvant être marqué dans l'éditeur de métadonnées en vue d'une publication sur ArcGIS Online est stocké en tant que contenu XHTML désactivé.
    • splitcoords() : accepte deux coordonnées x,y séparées par des virgules et les convertit en une liste d'éléments séparés par des espaces. Reportez-vous au fichier upgrade ESRI-ISO to ArcGIS94.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.
    • striphtml() : si un élément XML contient des séquences d'échappement XHTML ou XML, cette fonction permet de renvoyer le texte sans les balises HTML. Cela signifie que tout élément compris entre deux symboles inférieur à (<) ou supérieur à (>) est considéré comme une balise et supprimé. Reportez-vous aux fichiers ESRIISO2.xslt, ItemDescription.xslt et prep metadata for export.xslt fournis avec ArcGIS à titre d'exemples. Par exemple, lorsque vous préparez l'exportation du contenu d'éléments abstraits et de limites d'utilisation vers un format de métadonnées standard, toute balise XHTML existante est supprimée du contenu de métadonnées.
    • strtolower() : modifie la chaîne de texte en entrée afin de n'utiliser que des minuscules. Reportez-vous aux fichiers auxCountries.xslt, auxLanguages.xslt et auxUCUM.xslt fournis avec ArcGIS à titre d'exemples.

  • 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, pointez sur Générer une variable, sur A partir du paramètre, puis cliquez sur Source des métadonnées.

  • Si un élément ArcGIS contient des métadonnées créées dans ArcGIS Desktop 9.3.1 ou une version antérieure à l'aide de l'éditeur de métadonnées FGDC, et que les métadonnées de l'élément ont été mises à niveau par rapport aux métadonnées 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 le contenu de métadonnées au format FGDC d'origine de l'élément, à savoir les informations qui s'affichent sous l'en-tête Métadonnées FGDC (en lecture seule) de l'l'onglet Description. Les éléments FGDC sont classés correctement dans le fichier XML en sortie.

    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 USGS MP Metadata Translator effectue cette opération en interne avant de traiter le contenu de métadonnées au format FGDC de l'élément.

  • 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 site Web peut en afficher correctement le contenu.

Syntaxe

XSLTransform_conversion (source, xslt, output, {xsltparam})
ParamètreExplicationType 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.

Plusieurs feuilles de style sont fournies avec ArcGIS et disponibles dans le dossier <ArcGIS Installation Location>\Metadata\Stylesheets.

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. Consultez le fichier d'exemple add unique identifier.xslt.

File; String

Exemple de code

Exportation des métadonnées vers un fichier HTML

Utilise la feuille de style XSLT ArcGIS.xsl fournie avec ArcGIS pour exporter des métadonnées vers un fichier HTML en vue d'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", "#")

Environnements

Informations de licence

  • ArcGIS Desktop Basic: Oui
  • ArcGIS Desktop Standard: Oui
  • ArcGIS Desktop Advanced: Oui

Rubriques connexes