Manuel des Scripts Automation Engine > Organisation fonctionnelle > Lecture ou modification d'objets > XML_OPEN

XML_OPEN

Fonction de script : Ouvre un document XML en vue du traitement.

Syntaxe

XML_OPEN (DOCU, [Object Name], @Documentation)

XML_OPEN (REPORT, [RunID], Report)

XML_OPEN (STRING, String)

Syntaxe	Description / format
Source	Origine du document XML Format : Nom AE, littéral de script ou variable de script Valeurs autorisées : "DOCU" et "REPORT" "DOCU" - Documentation structurée "REPORT" - Rapport d'un Job SAP "STRING" - XML dans le format d'une chaîne.
Pour les documentations structurées
Nom d'objet	Nom de l'objet. Format : littéral de script ou variable de script S'il s'agit de l'onglet de l'objet considéré, ce paramètre est facultatif.
Documentation	Nom de l'onglet de documentation commençant par "@" Format : littéral de script ou variable de script
Pour les rapports
RunID	Numéro d'exécution (RunID) de la tâche dont le rapport doit être ouvert. Format : littéral de script ou variable de script S'il s'agit du rapport de l'objet considéré, ce paramètre est facultatif.
Rapport	Type du rapport XML
Pour les chaînes de caractères :
Chaîne de caractères	Chaîne de caractères contenant le XML. Format : variable de script ou littéral de script

Code retour
Référence du document XML

Commentaires

La fonction de script ouvre un document XML en vue du traitement. Il peut s'agir d'une documentation structurée ou du rapport d'unJob SAP.

Pour ajouter des descriptions et des explications, vous pouvez utiliser les onglets de documentation. Ces derniers sont définis dans les variables UC_OBJECT_DOCU de chaque type d'objet. Caractérisée par un "@" placé en tête, la documentation structurée constitue une forme spéciale d'affichage. La documentation structurée peut être traitée avec des éléments de scripts spécifiques.

Les rapports des Jobs SAP sont enregistrés sous forme de documents XML. Ils contiennent, par exemple pour XI_GET_CHANNEL, la liste des canaux de communication sélectionnés.

Le code retour de cette fonction de script est un descripteur qui réfère au document XML. Certains éléments de script utilisés pour modifier le document XML utilisent ce descripteur comme paramètre.

:XML_CLOSE ferme le document XML.

Vous ne pouvez ouvrir qu'un seul document XML à la fois.

Dans des version précédentes de Automation Engine, la fonction de script XML_OPEN_DOCU a été renommée XML_OPEN. L'ancien style d'écriture est toujours pris en charge.

Exemple

L'onglet Détails de l'objet "GS.JOUR" est ouvert pour traitement.

:SET &XMLDOCU# = XML_OPEN(DOCU,"MM.DAY", "@Details")

Rubriques connexes :

Elément de script	Description
:XML_CLOSE	Fermeture d'un document XML.

Eléments de script - Lecture ou modification d'objets

Documentation structurée

www.w3c.org/TR/xmlbase

Exemples :
Détermination du message et du numéro de l'erreur

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle