Mise à jour d'un schéma XML modifié

Si vous avez créé un projet qui utilise un schéma XML et que celui-ci est modifié, vous pouvez tenter de mettre à jour le schéma existant avec le nouveau schéma XML.

Pourquoi et quand exécuter cette tâche

La mise à jour d'un nouveau schéma XML signifie que les entités de projet qui interagissent avec le schéma XML peuvent être affectées par la modification. Les entités de projet suivantes peuvent être impactées par la modification d'un schéma XML :
  • Les mappes qui font référence au schéma XML, les mappes autonomes et les mappes en ligne dans des activités.
  • Les variables qui font référence au schéma XML.
  • Les expressions XPath dans des orchestrations.
  • Les expressions XPath utilisées dans des clés de travail.
  • Certaines configurations de noeud final.
  • Les conditions définies dans des orchestrations.
Lors du processus de mise à jour, Studio signale les entités du projet qui sont affectées par la modification avant que cette dernière soit validée.

Par exemple, un schéma XML définit un paramètre d'entrée sur l'activité de mappage de variables. Dans le panneau Depuis l'orchestration de l'activité de mappage de variables, il existe des liens depuis les noeuds du paramètre d'entrée vers ceux des paramètres de sortie. Lorsque le schéma XML qui définit le paramètre d'entrée a été mis à jour vers le nouveau schéma XML, ces liens risquent de ne plus être valides si des noeuds d'entrée ont été renommés ou supprimés dans le nouveau schéma XML. Vous devez recréer les liens pour que l'orchestration soit à nouveau valide.

Dans certains cas, Studio empêche complètement le téléchargement d'un nouveau schéma XML pour les raisons suivantes :
  • Le nouveau schéma XML n'est pas valide.
  • Le téléchargement du nouveau schéma XML pour remplacer le schéma existant se traduirait par un projet non valide.
Remarque : La mise à jour d'un schéma XML existant (comme décrit dans la procédure ci-dessous) est différente du chargement de plusieurs schémas XML dans un projet en faisant glisser un fichier vers l'onglet Projet ou en cliquant avec le bouton droit de la souris sur le dossier Schémas XML de l'onglet Projet et en sélectionnant Ajouter un document. La mise à jour d'un schéma XML existant remplace celui-ci dans le projet alors que le téléchargement du même fichier dans l'onglet Projet crée deux instances du schéma XML dans le projet.

Procédure

  1. Ouvrez le schéma XML déjà utilisé dans le projet qui doit être remplacé par le nouveau schéma XML. Ouvrez la représentation graphique ou la vue de source du schéma XML.
    • Représentation graphique : Ouvrez l'onglet Projet et cliquez deux fois sur le schéma XML dans le répertoire Schémas XML. Les noeuds du schéma XML s'affichent dans l'onglet Schéma XML. Dans l'onglet Schéma XML, cliquez sur un noeud du schéma XML.
    • Vue de source : Ouvrez l'onglet Projet et cliquez deux fois sur le schéma XML dans le répertoire Schémas XML. Les noeuds du schéma XML s'affichent dans l'onglet Schéma XML. Cliquez avec le bouton droit de la souris sur l'onglet et sélectionnez l'option Afficher la source dans le menu. Dans l'onglet Schéma XML, cliquez sur une ligne du schéma XML.
  2. Sélectionnez un nouveau schéma XML pour remplacer le schéma XML existant à l'aide de l'une des méthodes suivantes :
    • Si la représentation graphique du schéma XML est ouverte, vous pouvez faire glisser un fichier de schéma XML du système de fichiers local vers le schéma XML ouvert dans l'onglet Schéma XML.
    • Sélectionnez l'option Fichier > Mettre à jour dans le menu de la barre d'outils Studio. La boîte de dialogue Mise à jour du document de schéma en cours s'affiche. Dans la zone Emplacement, indiquez l'emplacement du nouveau schéma XML (emplacement Web externe ou système de fichiers).
  3. Cliquez sur OK. La boîte de dialogue La mise à jour du schéma XML affecte les entités de projet dépendantes répertoriées s'affiche et la liste des entités du projet risquant d'être affectées par le remplacement du schéma XML d'origine par le nouveau schéma XML apparaît.
  4. Facultatif : Dans la boîte de dialogue, cliquez sur l'une des entités dépendantes répertoriées pour l'afficher dans Studio.
  5. Cliquez sur Mettre à jour. Studio tente de mettre à jour le projet avec le nouveau schéma XML et le résultat de cette tentative dépend des conditions suivantes :
    • Si des modifications du schéma XML se traduisent par un projet endommagé après la mise à jour ou si le nouveau schéma XML est non valide, une boîte de dialogue d'erreur décrivant le problème lié au schéma XML s'affiche. Cliquez sur OK. La mise à jour est annulée, le schéma XML d'origine est rétabli et le projet n'est pas modifié.
    • Si les modifications du schéma XML ne se traduisent pas par un projet endommagé et si le nouveau schéma XML est valide, la mise à jour a lieu et le schéma XML d'origine est remplacé par le nouveau schéma XML. Certaines entités du projet risquent d'être non valides après la mise à jour et peuvent nécessiter un nettoyage. Par exemple, il peut être nécessaire de recréer des liens des panneaux Mapper les entrées et Mapper les sorties après la mise à jour. Pour rechercher les erreurs de validation, ouvrez une orchestration et sélectionnez Orchestration > Valider dans le menu Studio.
  6. Cliquez sur Fermer.