Sommaire
1
Introduction ........................................................................................................................................... 5
2
Notions de base ..................................................................................................................................... 7
2.1
Restrictions.......................................................................................................................... 7
2.2
Sécurité ............................................................................................................................... 7
2.3
Escaping .............................................................................................................................. 8
2.4
Informations complémentaires............................................................................................. 9
3
Démarrage rapide................................................................................................................................ 11
3.1
Objectif de ce démarrage rapide......................................................................................... 11
3.2
Conditions ......................................................................................................................... 11
3.3
Configurer un GraphQL Client............................................................................................. 12
3.4
Connexion au serveur GraphQL.......................................................................................... 14
3.5
Exécuter une opération GraphQL........................................................................................ 15
3.6
Autoriser un appel d'opération ........................................................................................... 20
3.7
Utilisation de la mise en valeur de la syntaxe et du complètement automatique d'Apollo..... 21
4
Schéma ................................................................................................................................................ 23
4.1
Principes de base du schéma .............................................................................................. 23
4.2
Structure d'une requête de client........................................................................................ 24
5
Référence de l'API GraphQL ................................................................................................................. 27
5.1
Généralités sur l'API GraphQL ............................................................................................. 27
5.2
Types d'opération GraphQL ................................................................................................ 27
5.3
Opérations pour variables .................................................................................................. 28
5.3.1
Requête "tagValues" ........................................................................................................... 28
5.3.2
Mutation "writeTags".......................................................................................................... 30
5.3.3
Souscription "tagValues"..................................................................................................... 33
5.4
Opérations pour alarmes.................................................................................................... 35
5.4.1
Requête "activeAlarms" ...................................................................................................... 35
5.4.2
Requête "loggedAlarms"..................................................................................................... 37
5.4.3
Mutations "acknowledgeAlarms" et "resetAlarms" ............................................................... 39
5.4.4
Mutations "enableAlarms" et "disableAlarms"...................................................................... 40
5.4.5
Mutations "shelveAlarms" et "unshelveAlarms" ................................................................... 41
5.4.6
Souscription "activeAlarms" ................................................................................................ 43
5.4.7
Filtrer les alarmes............................................................................................................... 45
5.5
Autres opérations .............................................................................................................. 48
5.5.1
Mutation "login"................................................................................................................. 48
5.5.2
Mutation "loginSWAC"........................................................................................................ 49
WinCC Unified GraphQL
Manuel système, 11/2023, Documentation en ligne
3