Publicité
5.3.3
Souscription "tagValues"
Conditions
• L'utilisateur connecté au Runtime pour le client GraphQL possède les droits "GraphQL - Accès
en lecture" ou "GraphQL - Accès en lecture/écriture" au Runtime.
• Le protocole WebSocket a été activé.
Remarque
Le protocole WebSocket n'est pas activé par le setup de WinCC Unified. Activez-le
manuellement le cas échéant : "Activer ou désactiver des fonctionnalités Windows > Internet
Information Services > Services World Wide Web > Fonctionnalités de développement
d'applications > Protocole WebSocket"
Description
tagValues(names: [String]): TagValueNotification
Nom de l'opération
Type d'opération
Fonction
Paramètre de saisie
Jeu de sélection
Réponse du serveur
Messages d'erreur
(code : description)
WinCC Unified GraphQL
Manuel système, 11/2023, Documentation en ligne
tagValues
subscription
Souscrit aux variables spécifiées dans le paramètre de saisie names.
names
•
Paramètre obligatoire
•
Type de données : chaîne de caractères
•
Liste des noms de variables auxquelles vous souhaitez souscrire
Notation : names:["<nom variable1>", "<nom variable2>", "<...>"]
Adressage de variables :
– Adresser un élément d'une variable de structure : <nom de la variable de
structure>.<nom de l'élément>
– Adresser un élément individuel d'un tableau : <nom du tableau>[<index>]
Exemple : FloatArrayTag[0]
– Adresser toutes les variables d'un tableau : <nom du tableau>
Exemple : FloatArrayTag
Les variables sont retournées dans la réponse dans un tableau.
Saisie obligatoire
Indiquez les attributs que retourne le serveur pour les variables souscrites. Vous pouvez de‐
mander les attributs définis dans le type TagValuesNotification. Vous trouverez des
informations sur la notation au chapitre Structure d'une requête de client (Page 24).
Recommandation : demandez name et notifcationReason.
Renvoie pour les variables souscrites une notification initiale avec les valeurs actuelles des
attributs demandés dans le jeu de sélection sous forme de paires de valeurs clés d'un enre‐
gistrement JSON, ainsi que les notifications de suivi en cas de modification d'une variable
souscrite, jusqu'à ce que la souscription soit terminée.
•
0 : Success
•
2 : Cannot resolve provided name
•
202 : Only leaf elements of a Structure Tag can be addressed
Référence de l'API GraphQL
5.3 Opérations pour variables
33
Publicité
