XMLPATH
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.
|
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. |
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.