XMLPATH

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Traitement de données au format Xml avec XPath (Xml Path Language).

Support WebVue - Oui.

Mode

Mnémonique

Syntaxe

1 GET 1
2 GETSTR 2
3 GETDOUBLE 3
4 GETSINGLE 4
5 GETLONG 5
6 GETINT 6
7 GETBOOL 7
8 LOAD 8
9 UNLOAD 9
10 LOADFILE 10
12 COUNT 6

Format de Namespace lors de l'utilisation de XMLPATH avec une fenêtre d'alarmes ou de consignations

Le format de Namespace est le suivant. Notez que la chaîne tient compte des minuscules/majuscules.

Branch/Mimic/ViewerId

Argument

Définition

Branch

Branche avec laquelle le synoptique est ouvert. Si le synoptique n'est pas ouvert avec une branche, une chaîne nulle doit être utilisée.

Mimic

Nom de fichier du synoptique.

ViewerID

Identifiant de la fenêtre d'alarmes ou de consignations qui peut être trouvé ou modifié en utilisant l'Explorateur graphique.

Arguments communs à plus d'un mode

Argument

Définition

Namespace

Identifiant du fragment Xml utilisé comme entrée. Type STR ou LONG.

XmlPath

Chemin hiérarchisé. Type STR ou LONG.

Syntaxe 1

LongVal = XMLPATH(Mode, Namespace, XmlPath);

Type de retour : LONG.

Exécution

Mode

Mnémonique

Action

1

GET

Retourne un handle pour le chemin XmlPath dans Namespace.

LongVal est automatiquement alloué et réalloué si le verbe est appelé cycliquement. Il n'y a pas besoin de faire une allocation via ALLOC_BUFFER. Il n'y a pas de limite sur la taille du buffer, nous recommandons donc au concepteur du projet d'être attentif lorsqu'il manipule de gros fragments Xml car cela peut requérir une grande quantité de mémoire.

Le Handle LongVal est désalloué à la fin lorsque le mode UNLOAD est appelé.

Syntaxe 2

StrVal = XMLPATH(Mode, Namespace, XmlPath);

Type de retour : STR

Exécution

Mode

Mnémonique

Action

2

GETSTR

Retourne la valeur sous forme de chaîne de caractères pour le chemin XmlPath dans Namespace.

Syntaxe 3

DoubleVal = XMLPATH(Mode, Namespace, XmlPath);

Type de retour : DOUBLE

Exécution

Mode

Mnémonique

Action

3

GETDOUBLE

Retourne la valeur sous forme de Double pour le chemin XmlPath dans Namespace.

Syntaxe 4

SingleVal = XMLPATH(Mode,Namespace, XmlPpath);

Type de retour : DOUBLE.

Exécution

Mode

Mnémonique

Action

4

GETSINGLE

Retourne la valeur sous forme de Single pour le chemin XmlPath dans Namespace.

Syntaxe 5

LongVal = XMLPATH(Mode, Namespace, XmlPath);

Type de retour : LONG.

Exécution

Mode

Mnémonique

Action

5

GETLONG

Retourne la valeur sous forme de Long pour le chemin XmlPath dans Namespace.

Syntaxe 6

IntVal = XMLPATH(Mode, Namespace, XmlPath);

Type de retour : INTEGER.

Exécution

Mode

Mnémonique

Action

6

GETINT

Retourne la valeur sous forme d'Integer pour le chemin XmlPath dans Namespace.
12 COUNT Retourne le nombre d'instances de l'élément spécifié par le chemin XmlPath.

Syntaxe 7

IntVal = XMLPATH(Mode, Namespace, XmlPath);

Type de retour : INTEGER.

Exécution

Mode

Mnémonique

Action

7

GETBOOL

Retourne la valeur sous forme de Booléen (type Integer) pour le chemin XmlPath depuis Namespace.

  • 1 pour <true>
  • 0 pour <false>

Syntaxe 8

IntVal = XMLPATH(Mode, Namespace, XmlData);

Type de retour : INTEGER.

Argument

Définition

XmlData

Contenu du fichier Xml. Type STR ou LONG.

Exécution

Mode

Mnémonique

Action

8

LOAD

Charge et mappe un fragment Xml dans le contexte identifié par Namespace.

Retour : 1 si OK, -1 si erreur de parsing Xml.

Syntaxe 9

IntVal = XMLPATH(Mode, Namespace);

Type de retour : INTEGER.

Exécution

Mode

Mnémonique

Action

9

UNLOAD

Décharge et démappe un fragment XML dans le contexte identifié par Namespace.

Retour : 1 si OK, -1 si erreur de parsing XML.

UNLOAD doit être utilisé une fois que les opérations Xml sont terminées pour libérer la mémoire allouée par les modes LOAD ou LOADFILE.

Syntaxe 10

IntVal = XMLPATH(Mode, Namespace, XmlFilename);

Type de retour : INTEGER.

Argument

Définition

XmlFilename Nom du fichier Xml à charger. Type STR ou LONG.

Exécution

Mode

Mnémonique

Action

10

LOADFILE

Charge et mappe un fragment Xml à partir d'un fichier.

Retour : 1 si OK, -1 si erreur de parsing Xml, -2 si fichier introuvable.

Si exécutée dans le contexte d'une session WebVue, cette instruction est traitée par le back end web, en conséquence de quoi le fichier référencé est sur la machine back end web.

Exemple

Pour un exemple, sélectionnez le lien Exemple ci-dessus.