Xquery/mettre à jour l’exécution
Un document XQuery ou XQuery Update peut être exécuté des manières suivantes :
•Lorsque le document XQuery ou XQuery Update est actif.
•Lorsqu’un document XML est actif.
| Note : | L'extension de fichier d'un document permet de spécifier si le document est un document XQuery ou XQuery Update. XMLSpy reconnaît des associations de type de fichier conformément aux définitions faites dans la section Filetypes du dialogue Options. (Outils | Options | Types de fichier). |
| Note : | pour une mise à jour de XQuery, vous pouvez aussi saisir Mettre à jour les expressions dans la fenêtre de sortie XPath/XQuery et les mises à jour de l’aperçu. Si les mises à jour sont acceptables, vous pouvez les appliquer et enregistrer le fichier mis à jour. Voir XQuery Update Facility et Previewing and Applying Updates pour plus de détails. |
Exécution avec un document actif XQuery ou XQuery Update
Afin d'exécuter un document XQuery ou XQuery Update avec la fonction document XQuery / XQuery Update actif, procédez comme suit
1.Faire du document XQuery ou XQuery Update le document actif.
2.Choisir XSL/XQuery | XQuery/ Update Execution ou cliquer sur l'icône de barre d'outils de la commande. Le dialogue Définir une Entrée XML ou JSON pour le dialogue XQuery (capture d'écran ci-dessous).
3.Parcourir la liste pour trouver un fichier XML/JSON et l'exécuter ou sauter la sélection d'une source XML.
 | Icône de barre d'outils XQuery/ Update Execution |
Typiquement, un document XQuery n’est pas associé au document XML/JSON spécifique. (Toutefois, une association pourrait être réalisée avec la fonction XQuery doc().) Dans XMLSpy, avant d’exécuter des documents XQuery individuels, vous pouvez sélectionner un document source XML/JSON pour l’exécution. Dans ces cas, le nœud du document de la source sélectionnée est l'item de contexte de démarrage du document XQuery. |
| Note : | la commande XQuery/ Update Execution est aussi disponible dans le menu contextuel des items de la fenêtre Projet. |
Résultat de l'exécution / mise à jour
•Exécution XQuery : Le document de résultat est généré comme fichier temporaire qui peut être enregistré à tout emplacement avec le format de fichier désiré et l’extension.
•Mise à jour XQuery : La mise à jour est enregistrée dans le fichier, ou le fichier mis à jour est ouvert, permettant de le consulter, puis soit de l’enregistrer soit de le fermer sans l’enregistrer. Vous pouvez spécifier laquelle de ces deux actions vous souhaitez effectuer. Pour ce faire, utilisez la section XQuery du dialogue Options (Outils | Options | XQuery).
Exécution avec un document XML actif
Afin d'exécuter un document XQuery ou XQuery Update sur un document XML actif, procédez comme suit
1.Faire du document XML le document actif.
2.Choisir XSL/XQuery | XQuery/ Update Execution ou cliquer sur l'icône de barre d'outils de la commande. Cela permet d'ouvrir le dialogue XQuery/Update File (voir la capture d’écran ci-dessous).
3.Parcourez pour trouver le fichier XQuery ou XQuery Update et cliquez sur OK.
| Icône de barre d'outils XQuery/ Update Execution |
Résultat de l'exécution / mise à jour
•Exécution XQuery : Le document de résultat est généré comme fichier temporaire qui peut être enregistré à tout emplacement avec le format de fichier désiré et l’extension.
•Mise à jour XQuery : La mise à jour est enregistrée dans le fichier, ou le fichier mis à jour est ouvert, permettant de le consulter, puis soit de l’enregistrer soit de le fermer sans l’enregistrer. Vous pouvez spécifier laquelle de ces deux actions vous souhaitez effectuer. Pour ce faire, utilisez la section XQuery du dialogue Options (Outils | Options | XQuery).
Back-mapping
En activant la fonction Back-mapping, l’exécution XQuery sera effectuée de manière à ce que le document de résultat puisse être remappé sur les documents XQuery+XML d'origine. Si vous cliquez sur un nœud dans le document de résultat, alors l’instruction XQuery et les données source XML qui généreront ce fragment de résultat particulier seront en surbrillance. De plus, si vous cliquez sur une instruction XQuery ou un nœud de données XML, alors les nœuds correspondants des deux autres documents sont en surbrillance. Voir la commande XSL/XQuery | Enable Back-Mapping pour les détails.
Variables XQuery
Si vous utilisez les moteurs Altova XQuery, les variables peuvent être stockées dans un dialogue GUI pratique. Toutes les variables stockées sont passées dans le document XQuery à chaque fois que vous exécutez un document XQuery via XMLSpy. Pour plus d'informations, voir la description de la commande Paramètres XSLT / Variable XQuery.
Moteurs Altova XQuery
Pour plus de détails concernant la mise en place des moteurs Altova XQuery et du traitement des fichiers XQuery, voir Implémentation Moteurs XQuery.