s71500 Webserver Function Manual FR-FR FR-FR PDF

Serveur Web
Avantpropos
Guide de la documentation
Descriptions fonctionnelles 1
Généralités 2
SIMATIC
Pages Web 3
S7-1500, SIMATIC Drive Controller,
ET 200SP, ET 200pro
Serveur Web
Description fonctionnelle
11/2019
A5E03484626-AG
Mentions légales
Signalétique d'avertissement
Ce manuel donne des consignes que vous devez respecter pour votre propre sécurité et pour éviter des
dommages matériels. Les avertissements servant à votre sécurité personnelle sont accompagnés d'un triangle de
danger, les avertissements concernant uniquement des dommages matériels sont dépourvus de ce triangle. Les
avertissements sont représentés ci-après par ordre décroissant de niveau de risque.
DANGER
signifie que la non-application des mesures de sécurité appropriées entraîne la mort ou des blessures graves.
ATTENTION
signifie que la non-application des mesures de sécurité appropriées peut entraîner la mort ou des blessures
graves.
PRUDENCE
signifie que la non-application des mesures de sécurité appropriées peut entraîner des blessures légères.
IMPORTANT
signifie que la non-application des mesures de sécurité appropriées peut entraîner un dommage matériel.
En présence de plusieurs niveaux de risque, c'est toujours l'avertissement correspondant au niveau le plus élevé
qui est reproduit. Si un avertissement avec triangle de danger prévient des risques de dommages corporels, le
même avertissement peut aussi contenir un avis de mise en garde contre des dommages matériels.
Personnes qualifiées
L’appareil/le système décrit dans cette documentation ne doit être manipulé que par du personnel qualifié pour
chaque tâche spécifique. La documentation relative à cette tâche doit être observée, en particulier les consignes
de sécurité et avertissements. Les personnes qualifiées sont, en raison de leur formation et de leur expérience,
en mesure de reconnaître les risques liés au maniement de ce produit / système et de les éviter.
Utilisation des produits Siemens conforme à leur destination
Tenez compte des points suivants:
ATTENTION
Les produits Siemens ne doivent être utilisés que pour les cas d'application prévus dans le catalogue et dans la
documentation technique correspondante. S'ils sont utilisés en liaison avec des produits et composants d'autres
marques, ceux-ci doivent être recommandés ou agréés par Siemens. Le fonctionnement correct et sûr des
produits suppose un transport, un entreposage, une mise en place, un montage, une mise en service, une
utilisation et une maintenance dans les règles de l'art. Il faut respecter les conditions d'environnement
admissibles ainsi que les indications dans les documentations afférentes.
Marques de fabrique
Toutes les désignations repérées par ® sont des marques déposées de Siemens AG. Les autres désignations
dans ce document peuvent être des marques dont l'utilisation par des tiers à leurs propres fins peut enfreindre les
droits de leurs propriétaires respectifs.
Exclusion de responsabilité
Nous avons vérifié la conformité du contenu du présent document avec le matériel et le logiciel qui y sont décrits.
Ne pouvant toutefois exclure toute divergence, nous ne pouvons pas nous porter garants de la conformité
intégrale. Si l'usage de ce manuel devait révéler des erreurs, nous en tiendrons compte et apporterons les
corrections nécessaires dès la prochaine édition.
Siemens AG A5E03484626-AG Copyright © Siemens AG 2012 - 2019.

Digital Industries Ⓟ 11/2019 Sous réserve de modifications Tous droits réservés
Postfach 48 48
90026 NÜRNBERG
ALLEMAGNE
Avantpropos
Objet de cette documentation

Cette documentation vous aide dans l'utilisation du serveur Web.
Le serveur Web vous offre la possibilité d'accéder p. ex. aux données de diagnostic et aux
données de processus de la CPU via Internet.
Connaissances de base requises

Pour bien exploiter les informations contenues dans cette documentation, les connaissances
suivantes sont nécessaires :
● Connaissances générales en technique d'automatisation
● Connaissances du système d'automatisation industriel SIMATIC
● Connaissances sur l'utilisation d'ordinateurs sous Windows
● Connaissances de STEP 7 (TIA Portal)
Domaine de validité de la documentation

Cette documentation est valable pour les CPU à partir de la version de firmware V2.5 et
comprend des illustrations de l'interface du serveur Web. Les figures utilisées s'appliquent à
toutes les CPU suivantes :
● les CPU du système d'automatisation SIMATIC S7-1500
● les CPU du SIMATIC Drive Controller
● les CPU du système de périphérie décentralisée ET 200SP
● les CPU 1516pro-2 PN et CPU 1513pro-2 PN du système de périphérie décentralisée
ET 200pro
En fonction du navigateur utilisé, il est possible que certains détails des illustrations
représentées diffèrent de l'interface du serveur Web.
Serveur Web
Description fonctionnelle, 11/2019, A5E03484626-AG 3
Avantpropos
Quelles sont les nouveautés dans la description fonctionnelle Serveur Web édition 11/2019 par
rapport à l'édition 12/2017 ?
Quelles sont les nouveautés ? Quels sont les avantages pour le client ? Où se trouvent les informa-
tions ?
Nouveaux La CPU possède une API • mécanismes standard établis pour la Chap. API (Application Pro-
contenus (Application Programming création de pages Web : gramming Interface)
Interface) basée Web (Page 155)
comme interface pour : les commandes Automation Web Pro-
gramming (commandes AWP) ne sont
• la lecture et l'écriture de
plus nécessaires pour la sortie de
données de CPU
données CPU
• l'exécution de fonctions
• aucune dépendance entre les pages
(p. ex. sauvegarde et
Web personnalisées et le programme
restauration de la confi-
de CPU :
guration de CPU et mo-
dification de l'état de aucune synchronisation nécessaire
fonctionnement) entre le programme utilisateur et le
La Web API prend en serveur web par l'instruction SFC 99
charge tous les navigateurs • Charge due à la communication ré-
et programmes en ligne de
duite :
commande courants, tels
que cURL et Wget. un plus petit paquet de données
(JSON au lieu de HTML de la page
Web personnalisée créée par la CPU)
est transmis entre le serveur et le
client. Les performances de communi-
cation s'en trouvent améliorées. La
CPU requiert moins de temps d'exécu-
tion pour générer les informations et
les rendre disponibles.
• échange de données sécurisé :
la Web API prend en charge exclusi-

vement le protocole de transmission
"HTTPS"
Contenus Extension du domaine d'ap- Les fonctions serveur web que vous con- • Manuel système SIMATIC
modifiés plication de la description naissez des CPU des SIMATIC S7-1500 Drive Controller
fonctionnelle aux CPU du sont maintenant également utilisables sur (https://support.industry.sie
SIMATIC Drive Controller les CPU du SIMATIC Drive Controller.
mens.com/cs/ww/fr/view/10
9766665)
• Manuel de l'appareil
SIMATIC Drive Controller
(https://support.industry.sie
9766666)
Serveur Web
4 Description fonctionnelle, 11/2019, A5E03484626-AG
Avantpropos
Quelles sont les nouveautés dans la description fonctionnelle Serveur Web édition 12/2017 par
tions ?
Nouveaux Nouvelle page Web "Fi- Vous pouvez télécharger des fichiers Chap. Fichiers utilisateur
contenus chiers utilisateur" ASCII (fichiers au format binaire) de la (Page 114)
carte mémoire SIMATIC (répertoire User-
Files\) sur la page Web et les en effacer.
Affichage de l'heure sous En affichant le temps universel coordonné, Chap. Page d'accueil avec des
forme de temps universel vous pourrez utiliser la même échelle de informations générales sur la
coordonné ou d'heure locale temps dans le monde entier pour les CPU (Page 33)
de l'automate programmable pages Web.
Pour afficher l'heure, vous avez le choix
entre les formats temps universel coor-
donné (UTC) et heure locale de l'AP (va-
leur par défaut).
DataLogs automatise le Au moyen du serveur Web, vous pouvez Chap. Lecture automatisée de
téléchargement, la lecture et lire et archiver DataLogs depuis une ou DataLogs (Page 112)
l'archivage plusieurs CPU, par exemple chaque jour à
une heure précise.
Vous automatisez le téléchargement de
DataLogs soit par l'exécution de scripts,
par ex. Bash, soit au moyen de JavaScript
sur votre page HTML utilisateur.
La case "Autoriser l'accès Les pages Web sont transmises en stan- Chap. Configuration du serveur
uniquement via HTTPS" est dard via une connexion sécurisée et elles Web (Page 19)
cochée dans le réglage de sont protégées contre les attaques de
base d'une CPU configurée. tiers.
Serveur Web
Avantpropos
tions ?
Contenus Page Web "État du mo- Vous pouvez relever l'affectation du numé- Chap. État du module
modifiés dule" : nouvelle colonne ro d'appareil au nom d'appareil. (Page 58)
Numéro d'appareil
Page Web "Topologie" : Vous pouvez choisir l'affichage de la topo- Chap. Topologie (Page 71)
choix des interfaces logie pour les interfaces PROFINET X1,
PROFINET disponibles, par X2 et pour les modules de communication
ex. X1, X2, CM 1542-1 PROFINET raccordés.
Page Web "DataLogs" : Vous pouvez supprimer des fichiers Data- Chap. DataLogs (Page 112)
nouvelle colonne pour sup- Log au moyen du serveur Web.
primer des fichiers DataLog
Page Web "Enregistre- L'affichage étendu des enregistrements Chap. Enregistrement
ment" : modifications de Trace vous en permet une évaluation plus (Page 91)
l'affichage des enregistre- détaillée.
ments Trace
Page Web "Enregistre- Une fois les mesures terminées, vous
ment" : nouvelles fonctions pouvez combiner entre eux les signaux
arithmétiques mesurés selon une fonction mathématique
afin de générer des signaux qui n'ont pas
été enregistrés.
Par exemple, vous pouvez calculer la
différence entre deux signaux pour repré-
senter plus clairement l'écart de la pres-
sion actuelle d'une chaudière par rapport à
la pression de consigne réglée.
Serveur Web
Avantpropos
Quelles sont les nouveautés dans la description fonctionnelle Serveur Web, édition 09/2016, par
tions ?
Nouveaux Modification de la manipula- Grâce à l'accès via le protocole de trans- Chap. Configuration du serveur
contenus tion du certificat mission sécurisé "HTTPS" et au certificat Web (Page 19)
de serveur Web spécifique, vous pouvez
protéger la connexion au serveur Web
contre les interceptions ou les falsifica-
tions.
Quatre autres langues pour Vous pouvez aussi sélectionner les Chap. Page d'accueil avec des
l'interface du serveur Web langues suivantes pour l'interface du ser- informations générales sur la
veur Web : CPU (Page 33)
• Coréen
• Russe
• Turc
• Portugais (Brésil)
Affectation étendue de Vous pouvez affecter aux langues d'inter- Chap. Paramétrages de la
langues de projet différentes face du serveur Web jusqu'à trois langues langue (Page 29)
de projet différentes pour les commen-
taires, les textes de message et les infor-
mations de diagnostic.
Page Web "Page d'accueil" L'affichage du nom du projet TIA vous Chap. Page d'accueil avec des
étendue montre immédiatement si le projet souhai- informations générales sur la
té est sélectionné. CPU (Page 33)
Page Web "Diagnostic" Vous trouverez ici des indications sur : Chap. Diagnostic (Page 40)
complétée par les onglets :
• Protection Know-How ou protection
• "Protection du pro- contre la copie du programme API
gramme" • Charge due au programme/à la com-
• "Informations d'exécu- munication et temps de cycle
tion" • Signatures globales F, temps de cycle
• "De sécurité" (pour une et temps d'exécution du/des groupe(s)
CPU F) d'exécution F
Page Web "Messages" Vous pouvez acquitter des messages de Chap. Messages (Page 65)
étendue la CPU via le serveur Web.
Pages Web "État des va- Vous pouvez modifier la valeur des va- • Chap. Etat des variables
riables" et "Tables de visua- riables et l'écrire dans la CPU, même en (Page 81)
lisation" étendues utilisant l'adresse absolue.
• Chap. Tables de visualisa-
tion (Page 84)
Nouvelle page Web "Sau- Vous pouvez sauvegarder et restaurer la Chap. Sauvegarde en ligne
vegarde en ligne" configuration de la CPU sur la carte mé- (Page 86)
moire SIMATIC via le serveur Web.
Nouvelle page Web "Dia- Vous pouvez surveiller avec le serveur Chap. Diagnostic Motion Con-
gnostic Motion Control" Web, sans STEP 7, l'état, les erreurs, les trol (Page 51)
alarmes technologiques et les valeurs
actuelles d'objets technologiques (TO)
configurés.
Serveur Web
Avantpropos
tions ?
Nouvelle page Web "Enre- Vous pouvez lire, afficher et enregistrer Chap. Enregistrement
gistrement" les enregistrements Trace avec le serveur (Page 91)
Web et obtenir ainsi, sans STEP 7, des
informations sur l'installation et le projet à
des fins de diagnostic et de maintenance.
Contenus Extension du domaine d'ap- Les fonctions que vous connaissez pour • Manuel CPU 1510SP-1 PN
modifiés plication de la description les CPU du SIMATIC S7-1500 sont réali- (https://support.industry.sie
fonctionnelle aux CPU du sées dans les CPU d'une autre version mens.com/cs/ww/fr/view/90
système de périphérie dé- (ET 200SP) et dans la CPU 1516pro-2 PN
157130)
centralisée ET 200SP et la (indice de protection IP65, IP66 et IP67).
CPU 1516pro-2 PN • Manuel CPU 1512SP-1 PN
157013)
• Instructions de service CPU
1516pro-2 PN
9482416)
Page Web "Tables de visualisation" : Chap. Tables de visualisation
complément de la remarque sur le nombre maximum. (Page 84)
Page Web "Pages utilisateur" : Chap. Pages utilisateur
complément de la remarque sur la taille maximale des pages HTML. (Page 119)
Conventions
Dans ce manuel, nous utilisons "STEP 7" comme synonyme de toutes les versions de
"STEP 7 (TIA Portal)" pour désigner le logiciel de configuration et de programmation.
Tenez également compte des remarques identifiées de la façon suivante :
Remarque
Une remarque contient des informations importantes sur le produit décrit dans la
documentation, sur la manipulation du produit ou sur la partie de la documentation qu'il faut
particulièrement mettre en relief.
Serveur Web
Avantpropos
Note relative à la sécurité

Siemens commercialise des produits et solutions comprenant des fonctions de sécurité
industrielle qui contribuent à une exploitation sûre des installations, systèmes, machines et
réseaux.
Pour garantir la sécurité des installations, systèmes, machines et réseaux contre les
cybermenaces, il est nécessaire de mettre en œuvre - et de maintenir en permanence - un
concept de sécurité industrielle global et de pointe. Les produits et solutions de Siemens
constituent une partie de ce concept.
Il incombe aux clients d'empêcher tout accès non autorisé à ses installations, systèmes,
machines et réseaux. Ces systèmes, machines et composants doivent uniquement être
connectés au réseau d'entreprise ou à Internet si et dans la mesure où cela est nécessaire
et seulement si des mesures de protection adéquates (ex : pare-feu et/ou segmentation du
réseau) ont été prises.
Pour plus d'informations sur les mesures de protection pouvant être mises en œuvre dans le
domaine de la sécurité industrielle, rendez-vous sur
(https://www.siemens.com/industrialsecurity).
Les produits et solutions Siemens font l'objet de développements continus pour être encore
plus sûrs. Siemens recommande vivement d'effectuer des mises à jour dès que celles-ci
sont disponibles et d'utiliser la dernière version des produits. L'utilisation de versions qui ne
sont plus prises en charge et la non-application des dernières mises à jour peut augmenter
le risque de cybermenaces pour nos clients.
Pour être informé des mises à jour produit, abonnez-vous au flux RSS Siemens Industrial
Security à l'adresse suivante (https://www.siemens.com/industrialsecurity) :
Siemens Industry Online Support

Vous y trouvez rapidement et facilement des informations actuelles sur les thèmes suivants :
● Support produit
Toutes les informations et un know-how complet sur votre produit, des caractéristiques
techniques, des FAQ, des certificats, des téléchargements et des manuels.
● Exemples d'application
Des outils et des exemples pour vous permettre d'exécuter vos tâches d'automatisation -
également des blocs fonctionnels, des données sur la performance et des vidéos.
● Services
Des informations sur Industry Services, Field Services, l'assistance technique, les pièce
de rechange et l'offre de formations.
● Forums
Pour obtenir des réponses et des solutions aux questions sur la technique
d'automatisation.
● mySupport
Votre espace personnel dans Siemens Industry Online Support, pour avoir accès à des
notifications, poser des questions à l'assistance et obtenir des documents configurables.
Ces informations vous sont fournies par Siemens Industry Online Support sur Internet
(http://www.siemens.com/automation/service&support).
Serveur Web
Avantpropos
Industry Mall
L'Industry Mall est le catalogue et le système de commande de Siemens AG pour les
solutions d'automatisation et d'entraînements sur la base de Totally Integrated Automation
(TIA) et Totally Integrated Power (TIP).
Vous trouverez les catalogues de tous les produits des techniques d'automatisation et
d'entraînement sur Internet (https://mall.industry.siemens.com).
Serveur Web
Sommaire
Avantpropos............................................................................................................................................ 3
1 Guide de la documentation Descriptions fonctionnelles ......................................................................... 13
2 Généralités ........................................................................................................................................... 15
2.1 Propriétés du serveur Web .....................................................................................................15
2.2 Configuration du serveur Web ................................................................................................19
2.3 Paramétrages de la langue .....................................................................................................29
2.4 Mettre à jour et mémoriser les informations ...........................................................................32
3 Pages Web ........................................................................................................................................... 33
3.1 Page d'accueil avec des informations générales sur la CPU .................................................33
3.2 Diagnostic ...............................................................................................................................40
3.3 Mémoire tampon de diagnostic ...............................................................................................50
3.4 Diagnostic Motion Control .......................................................................................................51
3.5 Etat du module ........................................................................................................................58
3.6 Mise à jour du firmware...........................................................................................................62
3.7 Messages ................................................................................................................................65
3.8 Communication .......................................................................................................................66
3.9 Topologie ................................................................................................................................71
3.9.1 Introduction .............................................................................................................................71
3.9.2 Vue graphique .........................................................................................................................72
3.9.3 Vue tabellaire ..........................................................................................................................75
3.9.4 Vue d'ensemble d'état.............................................................................................................77
3.9.5 Exemples de vues graphiques de la topologie .......................................................................77
3.10 Etat des variables ...................................................................................................................81
3.11 Tables de visualisation............................................................................................................84
3.12 Sauvegarde en ligne ...............................................................................................................86
3.13 Enregistrement ........................................................................................................................91
3.14 DataLogs ...............................................................................................................................112
3.14.1 Lecture automatisée de DataLogs ........................................................................................112
3.15 Fichiers utilisateur .................................................................................................................114
3.15.1 Lecture ou chargement automatisé de fichiers utilisateur ....................................................116
Serveur Web
Sommaire
3.16 Pages utilisateur................................................................................................................... 119

3.16.1 Commandes AWP................................................................................................................ 122
3.16.1.1 Variables API ....................................................................................................................... 124
3.16.1.2 Variables spéciales .............................................................................................................. 127
3.16.1.3 Types Enum ......................................................................................................................... 128
3.16.1.4 Fragments ............................................................................................................................ 130
3.16.1.5 Tableaux .............................................................................................................................. 132
3.16.1.6 Structures ............................................................................................................................. 134
3.16.2 Configurer des pages utilisateur .......................................................................................... 135
3.16.3 Programmation de l'instruction WWW ................................................................................. 136
3.16.4 Définir la page utilisateur comme page d'accueil ................................................................ 138
3.16.5 Exemple de page utilisateur................................................................................................. 141
3.16.5.1 Page Web pour le contrôle-commande d'une éolienne ....................................................... 141
3.16.5.2 Lecture et affichage des données de la CPU ...................................................................... 144
3.16.5.3 Utilisation d'un type Enum.................................................................................................... 144
3.16.5.4 Ecriture d'une entrée utilisateur dans l'automate ................................................................. 145
3.16.5.5 Ecrire des variables spéciales ............................................................................................. 146
3.16.5.6 Code HTML de la page utilisateur de "Remote Wind Turbine Monitor" .............................. 146
3.17 Filebrowser........................................................................................................................... 151
3.18 Lecture de données de service ............................................................................................ 152
3.19 Pages Web de base ............................................................................................................. 153
3.20 API (Application Programming Interface) ............................................................................ 155
3.20.1 Web API ............................................................................................................................... 155
3.20.2 Méthodes Web API disponibles ........................................................................................... 157
3.20.2.1 Api.Login .............................................................................................................................. 158
3.20.2.2 Api.GetPermissions ............................................................................................................. 159
3.20.2.3 Api.Browse ........................................................................................................................... 160
3.20.2.4 Api.Version ........................................................................................................................... 161
3.20.2.5 Api.Ping ................................................................................................................................ 161
3.20.2.6 Api.GetCertificateUrl ............................................................................................................ 162
3.20.2.7 Api.Logout ............................................................................................................................ 162
3.20.3 Intégration de Web API ........................................................................................................ 162
3.20.4 Sessions Web API ............................................................................................................... 165
3.20.5 Lecture et écriture des données de processus .................................................................... 166
3.20.5.1 Type de données supportés ................................................................................................ 166
3.20.5.2 Paramétrage des propriétés du bloc .................................................................................... 171
3.20.5.3 PlcProgram.Read ................................................................................................................. 171
3.20.5.4 PlcProgram.Write ................................................................................................................. 173
3.20.5.5 PlcProgram.Browse ............................................................................................................. 175
3.20.6 Page Web pour la conduite et supervision d'une éolienne .................................................. 180
Glossaire .............................................................................................................................................192
Index ...................................................................................................................................................196
Serveur Web
Guide de la documentation Descriptions
fonctionnelles 1
La documentation pour le système d'automatisation SIMATIC S7-1500, la CPU
1516pro-2 PN basée sur SIMATIC S7-1500 et les systèmes de périphérie décentralisée
SIMATIC ET 200MP, ET 200SP et ET 200AL se compose de trois parties.
Cette répartition vous permet d'accéder de manière ciblée aux contenus souhaités.
Informations de base
Les manuels système et le guide de mise en route décrivent en détail la configuration, le
montage, le câblage et la mise en service des systèmes SIMATIC S7-1500, ET 200MP,
ET 200SP et ET 200AL. Pour la CPU 1516pro-2 PN, référez-vous aux instructions de
service correspondantes. L'aide en ligne de STEP 7 vous assiste dans la configuration et la
programmation.
Informations sur les appareils

Les manuels contiennent une description compacte des informations spécifiques aux
modules, telles que les propriétés, les schémas de raccordement, les courbes
caractéristiques, les caractéristiques techniques.
Serveur Web
Guide de la documentation Descriptions fonctionnelles
Informations globales
Vous trouverez dans les descriptions fonctionnelles des descriptions détaillées sur des
sujets transversaux, p. ex. le diagnostic, la communication, Motion Control, le serveur Web,
OPC UA.
Vous pouvez télécharger gratuitement la documentation sur Internet
(https://support.industry.siemens.com/cs/ww/fr/view/109742705).
Les modifications et compléments apportés aux manuels sont documentés dans des
informations produit.
Vous trouverez les informations produit sur Internet.
● S7-1500/ET 200MP (https://support.industry.siemens.com/cs/fr/fr/view/68052815)
● ET 200SP (https://support.industry.siemens.com/cs/fr/fr/view/73021864)
● ET 200AL (https://support.industry.siemens.com/cs/fr/fr/view/99494757)
Collection de manuels (Manual Collections)

Les collection de manuels contiennent dans un fichier la documentation complète relative
aux systèmes correspondant.
Vous trouverez les collections de manuels sur Internet.
● S7-1500/ET 200MP (https://support.industry.siemens.com/cs/ww/fr/view/86140384)
● ET 200SP (https://support.industry.siemens.com/cs/ww/fr/view/84133942)
● ET 200AL (https://support.industry.siemens.com/cs/ww/fr/view/95242965)
"mySupport"
"mySupport", votre espace de travail personnel, vous permet de tirer au mieux profit de votre
Industry Online Support.
Dans "mySupport", vous pouvez créer des filtres, des favoris et des tags, demander des
"données CAx" et compiler votre bibliothèque personnelle dans le volet "Documentation". De
même, les champs sont déjà renseignés avec vos données dans les demandes d'assistance
et vous disposez à tout moment d'une vue d'ensemble de vos requêtes en cours.
Pour utiliser la fonctionnalité complète de "mySupport", il suffit de vous enregistrer une seule
fois.
Vous trouverez "mySupport" sur Internet (https://support.industry.siemens.com/My/ww/fr).
Exemples d'application
Les exemples d'application mettent à votre disposition différents outils et exemples pour la
résolution de vos tâches d'automatisation. Les solutions sont représentées en interaction
avec plusieurs composants dans le système - sans se focaliser sur des produits individuels.
Vous trouverez les exemples d'application sur Internet
(https://support.industry.siemens.com/sc/ww/fr/sc/2054).
Serveur Web
Généralités 2
2.1 Propriétés du serveur Web
Utilisation du serveur Web

Le serveur Web permet la surveillance et la gestion de la CPU par des utilisateurs autorisés
via un réseau. Ceci permet des évaluations, des diagnostics et des modifications à grande
distance. La visualisation et l'évaluation sont possibles sans STEP 7. Vous avez juste besoin
d'un navigateur Web. Notez que vous devez prendre des mesures appropriées (par ex.
limitation d'accès au réseau, utilisation de pare-feu) pour protéger la CPU contre toute
intrusion.
Activer le serveur Web

À la livraison de la CPU, le serveur Web est désactivé. L'accès via le navigateur Internet
n'est possible qu'après avoir chargé un projet dans lequel le serveur Web est activé.
Fonctions de sécurité
Le serveur web offre les fonctions de sécurité suivantes :
● Accès via le protocole de transfert de sécurité "HTTPS" avec utilisation du certificat de
serveur Web signé par une CA.
● Autorisations utilisateur configurables via la liste des utilisateurs
● Activation d'interfaces individuelles
Serveur Web
Généralités
Navigateur Web
Pour accéder aux pages HTML de la CPU, vous avez besoin d'un navigateur Web.
Les navigateurs Internet suivants ont été testés pour la communication avec la CPU. De
plus, d'autres navigateurs Internet peuvent également fonctionner, notamment des versions
plus récentes. Toutefois, si des problèmes que vous ne parvenez pas à résoudre se
présentent sur des navigateurs Internet non mentionnés ici, veuillez utiliser l'un des
navigateurs Web suivants qui ont été testés :
● Microsoft Internet Explorer (version 11.x)
● Microsoft Edge (version 44.x)
● Google Chrome (version 75.x)
● Mozilla Firefox (version 64.x)
● Opera (version 58.x)
● Mobile Safari et Chrome pour iOS (iOS 12)
● Android Browser (Android 7.x)
● Chrome pour Android (Android 7.x à 8 (sous Android 8, les certificats ne fonctionnent que
de manière limitée))
Remarque
Si vous utilisez Internet Explorer, désactivez "l'Affichage de compatibilité" dans ses
paramètres (menu "Outils").
Remarque
Pour l'accès depuis des appareils de visualisation avec une résolution de l'écran inférieure,
nous recommandons l'utilisation des pages Web de base, voir le chapitre Pages Web de
base (Page 153).
Remarque
Les versions antérieures des navigateurs Web mentionnés qui supportaient jusqu'alors
l'accès aux pages HTML de la CPU le permettent toujours. Toutefois, ces versions
antérieures ne prennent pas les nouvelles fonctions et pages HMTL décrites dans ce
numéro de version.
Remarque
Pour le serveur Web, deux liaisons de communication sont réservées pour la communication
avec la CPU.
En fonction du navigateur Internet utilisé, un nombre différent de connexions à la CPU sera
établi. Si d'autres liaisons sont disponibles, d'autres liaisons de communication sont établies.
Si aucune autre liaison n'est disponible, il peut survenir des problèmes fonctionnels ou de
représentation, car le serveur Web rejette toutes les liaisons de communication, au-delà des
deux qui sont réservées.
Il est alors possible que les pages Web ne se chargent pas complètement.
Serveur Web
Généralités
Remarque
Si vous accédez au serveur Web de la CPU avec un processeur de communication (CP),
assurez-vous que le cache (fichiers Internet temporaires) est activé dans votre navigateur.
Sélectionnez l'option "Automatique" dans les paramètres du cache de votre navigateur.
Si le cache est désactivé ou que l'option "Automatique" n'est pas paramétrée dans votre
navigateur, il se peut que les temps d'accès soient longs et que la représentation ne soit pas
complète.
Remarque
Suite à une mise à jour du firmware de la CPU, des pages Web peuvent s'afficher de
manière incorrecte dans certains navigateurs Web. Des problèmes du nouveau firmware de
la CPU avec le cache du navigateur Web en sont la cause.
Solution : Appuyez sur F5 ou videz le cache du navigateur Web.
Lecture de données
Les données suivantes peuvent être lues avec le serveur Web à partir de la CPU et être
partiellement modifiées, puis réimportées :
● Page d'accueil avec des informations générales sur la CPU (Page 33)
● Informations sur Diagnostic (Page 40)
– Identification
– Protection du programme
– Mémoire
– Informations sur l'exécution
– De sécurité (pour une CPU F)
● Contenu de la mémoire tampon de diagnostic (Page 50)
● Etat du module (Page 58)
● Mise à jour du firmware (Page 62)
● Messages (Page 65)
● Informations sur Communication (Page 66)
– Paramètres d'interface importants
– Statistiques du port
– Affichage des ressources en cas de communication
– Affichage des liaisons de communication
● Topologie (Page 71) PROFINET
– Vue graphique (topologie prévue et topologie réelle)
– Vue tabellaire (topologie réelle)
– Visualisation des états
Serveur Web
Généralités
● Etat des variables (Page 81)

● Tables de visualisation (Page 84)
● Pages utilisateur (Page 119)
● Filebrowser (Page 151)
● DataLogs (Page 112)
● Fichiers utilisateur (Page 114)
● Sauvegarde en ligne et restauration de la configuration (Page 86)
● Informations de diagnostic pour les objets technologiques (Page 51)
● Analyse d'enregistrements Trace (Page 91)
● Lecture des données de maintenance (Page 152)
● Pages Web de base (Page 153)
Les pages HTML sont décrites en détail dans les pages suivantes.
Remarque
Nombre max. de caractères pour le type de données WSTRING
Notez que le type de données WSTRING est limité à 254 caractères pour l'affichage dans le
serveur Web. Si vous excédez ces 254 caractères, le serveur Web n'affichera pas les
caractères excédentaires.
Accès Web à la CPU via PG/PC, appareils IHM et terminaux mobiles

Procédez de la manière suivante pour accéder au serveur Web :
1. Chargez dans la CPU avec STEP 7 un projet dans lequel le serveur Web est activé.
2. Connectez l'appareil de visualisation (PG/PC, IHM, terminal mobile) via une interface
PROFINET avec la CPU ou un module de communication.
Si vous utilisez un WLAN, activez le WLAN sur l'appareil de visualisation et établissez
une connexion au point d'accès (p. ex. SCALANCE W788-1RR ou SCALANCE W784-1)
qui est connecté à la CPU.
3. Ouvrez le navigateur Web sur l'appareil de visualisation.
4. Dans le champ "Adresse" du navigateur Web, saisissez l'adresse IP de l'interface de la
CPU qui est connectée au client de la manière suivante : http://a.b.c.d ou https://a.b.c.d
(exemple de saisie : http://192.168.3.141).
La page intro de la CPU s'ouvre. À partir de cette page, vous pouvez naviguer vers les
autres informations.
Pour plus d'informations sur l'accès via le protocole de transmission sécurisé "HTTPS", voir
chapitre Configuration du serveur Web (Page 19).
Serveur Web
Généralités
2.2 Configuration du serveur Web
Plus d'informations...
Vous pouvez accéder avec le smartphone soit au serveur Web de la CPU via le WLAN, soit
à la CPU via l'application SIMATIC S7 (grâce à la fonctionnalité serveur Web). Pour plus
d'informations sur la marche à suivre, voir la FAQ, ID de contribution 103473392, sur la page
Internet du Service&Support
Notez bien ceci : Le serveur Web doit être activé aussi pour l'accès à la CPU via l'application
SIMATIC S7.
L'application SIMATIC S7 vous offre d'autres fonctions. Vous trouverez un exemple
d'application complet avec des documentations complémentaires et des exemples de projet
sur la page Internet Service & Support

Pour tirer parti de toutes les fonctions du serveur Web, les réglages suivants sont
nécessaires dans STEP 7.
Marche à suivre
Vous avez ouvert la boîte de dialogue des propriétés de la CPU dans la vue du projet dans
STEP 7.
Figure 2-1 Configuration du serveur web dans STEP 7
Serveur Web
Généralités
Activer le serveur Web sur le module

Dans les paramètres par défaut d'une CPU configurée, le serveur Web est désactivé. Pour
activer le serveur Web, procédez comme suit :
1. Dans la fenêtre de navigation du projet STEP 7, ouvrez la vue "Appareils & réseaux" en
double-cliquant dessus.
2. Sélectionnez la CPU souhaitée dans la vue des appareils, de réseau ou dans la vue
topologique.
3. Dans la fenêtre d'inspection des Propriétés, naviguez de l'onglet "Général" vers la zone
"Serveur Web".
4. Cochez la case "Activer le serveur Web sur ce module".
Le message suivant s'affiche alors :
Figure 2-2 Consigne de sécurité lors de l'activation du serveur Web dans STEP 7
Remarque
Cette consigne de sécurité ne s'affiche pas lors de la reprise de projets fournis dans
lesquels le serveur Web est déjà activé et configuré.
Serveur Web
Généralités
Création et affectation du certificat du serveur Web

Il est nécessaire de posséder un certificat de serveur Web valide pour activer le serveur
Web avec utilisation du protocole de transmission sécurisé "HTTPS".
Pour des CPU SIMATIC S7-1500 à partir de la version V2.0 du firmware, vous devez créer
vous-même le certificat pour le serveur Web de la CPU avec STEP 7 et l'affecter au serveur
Web dans les propriétés de la CPU. Ce certificat sera automatiquement chargé lors du
chargement de la configuration matérielle dans la CPU. STEP 7 possède également un
certificat des autorités certifiantes (Certification Authority, CA) avec lequel le certificat
d'appareil (certificat End-Entity, d'entité finale) du serveur Web est signé.
Remarque
Lorsque vous actualisez le firmware d'une CPU SIMATIC S7-1500 ou ET 200SP avec
version de firmware < V2.0 vers une version de firmware ≥ V2.0, un certificat de serveur
valide est automatiquement généré et utilisé. Cela vaut également pour le cas d'un
remplacement pour lequel une CPU dont la version de firmware < V2.0 est remplacée par
une CPU plus récente.
Vous pouvez créer différents certificats de serveur Web :

● Si vous utilisez le gestionnaire de certificats avec les paramètres de sécurité globaux,
l'autorité de certification du projet (certificat CA) signe le certificat d'appareil du serveur
Web. Le certificat CA du projet est chargé automatiquement lors du chargement.
● Si vous n'utilisez pas le gestionnaire de certificats avec les paramètres de sécurité
globaux, STEP 7 génère le certificat d'appareil sous forme de certificat autosigné.
IMPORTANT
Utiliser toutes les fonctionnalités du serveur Web
Un certificat de serveur Web signé par une CA dans la CPU est une condition à :
• la gestion des utilisateurs avec des utilisateurs protégés par mot de passe
• l'enregistrement et le téléchargement des informations de diagnostic dans des fichiers
CSV
• l'utilisation des fonctions de sécurité suivantes :
– Sauvegarde et restauration de la configuration de la CPU
Pour exploiter toutes les fonctionnalités du serveur Web, nous recommandons de créer un
certificat de serveur Web signé par une CA et de l'affecter à la CPU en utilisant le
gestionnaire de certificats avec les paramètres de sécurité globaux.
Serveur Web
Généralités
Créer un certificat de serveur Web auto-signé

Pour créer un certificat de serveur Web auto-signé, veuillez procéder comme suit :
1. Dans la fenêtre d'inspection des Propriétés de la CPU, naviguez de l'onglet "Général"
vers la zone "Serveur Web > Security".
2. Cliquez sur le bouton "Ajouter" dans la liste déroulante de sélection d'un certificat.
La boîte de dialogue "Générer un nouveau certificat" s'ouvre.
3. Cochez la case "Auto-signé" dans la boîte de dialogue suivante.
4. Saisissez les paramètres du nouveau certificat ou confirmez les paramètres par défaut.
– Sélectionnez l'entrée "Serveur Web" dans le champ "Utilisation".
– Saisissez la/les adresse(s) IP de la/des interface(s) ou le nom de domaine de la CPU
configurée dans le champ "Nom alternatif du titulaire du certificat" (Subject Alternative
Name).
5. Confirmez par "OK".
6. Compilez et chargez la configuration dans la CPU.
Le certificat d'appareil du serveur Web fait partie de la configuration.
Création et affectation du certificat de serveur Web signé par une CA

Pour créer un certificat de serveur Web signé par une CA, veuillez procéder comme suit :
vers la zone "Protection & Sécurité > Gestionnaire de certificats" et activez l'option
"Utiliser les paramètres globaux de sécurité pour le gestionnaire de certificats".
Dans le navigateur de projet apparaissent les "Paramètres de sécurité généraux".
Remarque
Vous devez posséder le droit "Configuration de la sécurité" afin d'éditer le gestionnaire de
certificats dans les Paramètres de sécurité généraux .
2. Connectez-vous en tant qu'utilisateur dans la zone "Paramètres de sécurité généraux >

Connexion utilisateur" du navigateur du projet. S'il s'agit d'un nouveau projet, le rôle
"Administrateur" est prévu lors de la première connexion.
vers la zone "Serveur Web > Security".
4. Cliquez sur le bouton "Ajouter" dans la liste déroulante de sélection d'un certificat.
La boîte de dialogue "Générer un nouveau certificat" s'ouvre.
5. Dans la boîte de dialogue suivante, activez la case à cocher "Signé par l'autorité de
certification" et sélectionnez l'autorité de certification dans la liste déroulante.
6. Saisissez les paramètres du nouveau certificat ou confirmez les paramètres par défaut.
– Sélectionnez l'entrée "Serveur Web" dans le champ "Utilisation".
– Saisissez la/les adresse(s) IP de la/des interface(s) ou le nom de domaine de la CPU
configurée dans le champ "Nom alternatif du titulaire du certificat" (Subject Alternative
Name).
Serveur Web
Généralités
7. Confirmez par "OK".

8. Compilez et chargez la configuration dans la CPU.
Le certificat d'appareil du serveur Web et le certificat signé par une CA font partie de la
configuration.
IMPORTANT
Adresser le serveur Web de la CPU avec le nom de domaine
Si vous indiquez la/les adresse(s) IP de la/des interface(s) de la CPU configurée dans le
champ "Autre nom du demandeur de certificat" (Subject Alternative Name), il se peut dans
certaines circonstances que le certificat généré ne soit pas accepté par tous les
navigateurs Internet. De plus, à chaque modification de l'adresse IP d'une interface
Ethernet de la CPU, vous devez générer et charger un nouveau certificat de serveur
(certificat d'entité finale) car l'identité de la CPU change avec l'adresse IP.
Vous pouvez éviter ce problème en adressant le serveur Web de la CPU avec le nom de
domaine plutôt qu'avec la/les adresse(s) IP, p. ex. "myconveyer-
cpu.room13.myfactory.com". Pour cela, vous devez administrer les noms de domaine de
vos CPU avec un serveur DNS.
Vous trouverez des informations détaillées sur les certificats locaux auto-signés et les
certificats globaux signés par une CA, sur la "Public Key Infrastructure" (PKI) et sur la
gestion des certificats dans la Description fonctionnelle Communication
(https://support.industry.siemens.com/cs/ww/fr/view/59192925) et dans l'aide en ligne de
STEP 7, mot-clé "Secure Communication".
Autoriser l'accès uniquement via HTTPS

Notez bien ceci : Il est nécessaire de posséder un certificat de serveur Web valide dans la
CPU pour activer le serveur Web avec utilisation du protocole de transmission sécurisé
"HTTPS". Voir à ce sujet le paragraphe "Création et affectation du certificat du serveur Web"
plus haut dans ce chapitre.
L'accès sécurisé au serveur Web est assuré dans le réglage de base d'une CPU configurée
par une coche dans la case "Autoriser l'accès uniquement via HTTPS".
Les pages Web sont transmises en standard via une connexion sécurisée et elles sont
protégées contre les attaques de tiers. Assurez-vous que l'URL de la CPU commence dans
ce cas par "https://" .
Serveur Web
Généralités
Les conditions suivantes sont nécessaires pour un accès HTTPS à la CPU sans erreurs :
● La date et l'heure actuelles doivent être réglées dans la CPU.
Remarque
Vous devez veiller, lorsque vous utilisez la communication sécurisée (par ex. HTTPS), à
ce que les modules concernés disposent bien de la date et de l'heure actuelles. Si ce
n'est pas le cas, les modules considèreront les certificats utilisés comme non valides et la
communication sécurisée ne fonctionnera pas.
● L'adresse IP de la CPU doit être attribuée.

● Un certificat de serveur Web valide proposé par la CPU est installé dans le navigateur
Web.
IMPORTANT
Fonctions de sécurité possibles avec certificat de serveur Web signé par une CA
uniquement
Les fonctions de sécurité Sauvegarde et restauration de la configuration de la CPU, voir
chapitre Sauvegarde en ligne (Page 86), sont possibles uniquement avec un certificat
de serveur Web signé par une CA.
Un certificat de serveur Web signé par une CA dans la CPU est en outre requis pour :
• la gestion des utilisateurs avec des utilisateurs protégés par mot de passe
• l'enregistrement et le téléchargement des informations de diagnostic dans des
fichiers CSV
Pour exploiter toutes les fonctionnalités du serveur Web, nous recommandons de créer
un certificat de serveur Web signé par une CA et de l'affecter à la CPU en utilisant le
gestionnaire de certificats avec les paramètres de sécurité globaux.
Lorsqu'aucun certificat de serveur Web signé par une CA n'est installé, un avertissement
recommandant de ne pas utiliser la page s'affiche. Pour visualiser la page, vous devez
éventuellement "Ajouter une exception", selon le navigateur Web utilisé.
Vous pouvez vous procurer un certificat CA valide en le téléchargeant sur la page web
"Intro" sous "Télécharger un certificat".
Vous trouverez des informations sur l'installation du certificat dans le navigateur Web
dans l'aide de votre navigateur Web ainsi que dans la FAQ avec l'ID de contribution
103528224, sur la page Internet du Service&Support
Remarque
Pour vous protéger contre des manipulations venant de l'extérieur, veillez à ne télécharger
que des certificats provenant d'un environnement fiable. Pour chaque appareil de
visualisation que vous voulez utiliser, il faut procéder une fois à l'installation du certificat CA.
Serveur Web
Généralités
Protection d'accès
Si la connexion codée établie à l'aide du certificat empêche l'écoute ou le piratage de la
communication, cela ne représente pas une protection contre les accès. Protégez donc votre
CPU contre des accès non autorisés par une configuration correspondante dans la gestion
des utilisateurs.
Pour plus d'informations sur la protection d'accès, voir l'aide en ligne de STEP 7, mot-clé :
"Protection".
Activer la mise à jour automatique

Dans le paramétrage de base d'une CPU configurée, la mise à jour automatique est activée.
Les pages Web suivantes sont mises à jour automatiquement :
● Page d'accueil
● Diagnostic (mémoire, informations sur le temps d'exécution, de sécurité)
● Mémoire tampon de diagnostic
● Diagnostic Motion Control
● État du module
● Messages
● Communication
● Topologie
● État des variables
● Tables de visualisation
● Enregistrement
● DataLogs
● Fichiers utilisateur
● Pages utilisateur
● Filebrowser
Remarque
L'intervalle d'actualisation paramétré par défaut est de 10 secondes.
Des quantités de données volumineuses ou plusieurs liaisons HTTP/HTTPS allongent la
période d'actualisation.
Serveur Web
Généralités
Choix de la langue du Web

Au total, vous pouvez affecter jusqu'à trois langues de projet différentes aux langues de
l'interface utilisateur du serveur Web.
Activez les langues de projet que vous souhaitez utiliser dans STEP 7, puis attribuez une
des langues de projet activées aux langues de l'interface utilisateur du serveur Web.
Plus d'informations sur les paramètres de langue et la description de l'attribution d'une
langue de projet aux langues de l'interface utilisateur, voir chapitre Paramétrages de la
langue (Page 29).
Compléter la gestion des utilisateurs

Notez bien ceci : Un certificat de serveur Web valide signé par une CA dans la CPU et une
connexion HTTPS protégée sont une condition à la gestion des utilisateurs avec des
utilisateurs protégés par mot de passe. Pour cela, référez-vous aux paragraphes "Création
et affectation du certificat du serveur Web" et "Autoriser l'accès uniquement via HTTPS"
dans ce chapitre.
Figure 2-3 Gestion des utilisateurs dans STEP 7
Dans STEP 7, vous pouvez gérer la liste des utilisateurs dans la zone "Serveur Web >
Gestion des utilisateurs".
La liste des utilisateurs vous offre les possibilités suivantes :
● Créer un utilisateur
● Définir les droits d'accès
● Attribuer des mots de passe
Serveur Web
Généralités
Les utilisateurs disposent exclusivement des options affectées aux droits d'accès.
Selon la CPU et le firmware utilisés, vous pouvez attribuer des droits d'utilisateur différents.
Les droits utilisateur suivants peuvent être disponibles comme suit dans STEP 7 :
Figure 2-4 Attribution des droits d'utilisateurs dans STEP 7
Lorsque vous n'êtes pas connecté, vous accédez toujours par défaut sous le nom
d'utilisateur "Tout le monde" au serveur Web,
que vous ayez configuré ou non d'autres utilisateurs.
Serveur Web
Généralités
Utilisateur "Tout le monde"

Dans la liste des utilisateurs, un utilisateur par défaut possédant des autorisations d'accès
limitées est créé sous le nom d'utilisateur "Tout le monde". Il s'agit de l'accès en lecture
seule à la page Intro et à la page d'accueil. Pour la configuration de l'utilisateur "Tout le
monde", aucune attribution de mot de passe n'est nécessaire. Vous pouvez lui affecter tous
les droits d'accès disponibles dans STEP 7.
Il est possible de créer un maximum de 20 utilisateurs et un utilisateur avec le droit d'accès
"Tout le monde".
Comme l'utilisateur "Tout le monde" est configuré dans STEP 7 sans l'attribution d'un mot de
passe, soyez vigilants lors de l'attribution de droits d'accès à cet utilisateur.
L'attribution de certains droits comme la modification de l'état de fonctionnement peut
représenter un risque pour la sécurité.
Nous recommandons pour l'attribution de droits relevant de la sécurité de créer dans
STEP 7 un utilisateur avec une protection du mot de passe.
ATTENTION
Pour une CPU F, n'attribuez pas le droit d'accès "Modifier en tant qu'Admin F" à un
utilisateur "Tout le monde".
Tenez impérativement compte des avertissements à ce sujet figurant dans le chapitre
"Restauration sécurisée du programme de sécurité d'une CPU F S7-300/1500" dans le
manuel SIMATIC Safety - Configuring and Programming
(http://support.automation.siemens.com/WW/view/fr/54110126).
Les mots de passe doivent toujours contenir plus de 8 caractères et contenir des
majuscules/minuscules ainsi que des caractères spéciaux et des chiffres (?!+%$1234...).
Les chaînes de caractères du clavier ou des mots du dictionnaire ne sont pas appropriés.
Modifiez le mot de passe à intervalles réguliers.
Remarque
Lors de l'attribution des droits, notez que l'accès en lecture et en écriture aux tables de
visualisation et à l'état des variables est conservé même si vous avez désactivé l'attribut "
Accessible depuis IHM/OPC UA" dans la table des variables API lors de la configuration du
bloc de données dans STEP 7.
Pages utilisateur
La zone "Pages utilisateur" vous permet de charger vos propres pages Web dans la CPU et
donc de mettre à disposition vos propres applications Web par l'intermédiaire du navigateur
Web.
Pour plus d'informations, voir chapitre Pages utilisateur (Page 119).
Serveur Web
Généralités
2.3 Paramétrages de la langue
Activation du serveur Web pour chaque interface

Dans la "Vue d'ensemble des interfaces", vous avez la possibilité d'autoriser l'accès au
serveur Web.
Figure 2-5 Activation de l'accès au serveur Web via les interfaces
Introduction
Le serveur Web propose les langues suivantes pour l'interface utilisateur :
● allemand (Allemagne)
● anglais (Etats-Unis)
● français (France)
● italien (Italie)
● espagnol (tri traditionnel)
● japonais
● chinois (simplifié)
● Coréen
● Russe
● Turc
● Portugais (Brésil)
Serveur Web
Généralités
Conditions pour que les langues d'Asie orientale soient disponibles

Les conditions suivantes doivent être remplies pour les langues d'Asie orientale :
● Le pack de prise en charge des langues d'Asie orientale approprié est installé sur
l'appareil de visualisation (p. ex. PC).
Pour plus d'informations sur l'installation des fichiers pour les langues d'Asie orientale,
voir la documentation Windows.
● STEP 7 pour les langues d'Asie orientale doit être installé sur la PG pour la configuration
de la CPU.
Remarque
Les appareils IHM SIMATIC avec le système d'exploitation Windows CE ne prennent pas
en charge les langues d'Asie orientale.
Condition pour l'affichage de textes dans différentes langues

Afin que le serveur Web affiche correctement les messages, les commentaires et les
informations de diagnostic dans les différentes langues de projet, vous devez affecter une
langue de projet aux langues de l'interface souhaitées du serveur Web dans STEP 7.
Remarque
Les langues du projet STEP 7 à affecter doivent être activées et les textes correspondants
(traductions) doivent se trouver dans le projet. La sélection de langues de projet se trouve
dans la fenêtre de navigation du projet sous "Langues & ressources".
Serveur Web
Généralités
Choix de la langue du Web

Après avoir activé le serveur Web sur votre module, affectez une langue du projet STEP 7
aux langues d'interface utilisateur du serveur Web.
vers la zone "Multilinguisme".
2. Affectez une langue de projet de la liste déroulante aux langues d'interface utilisateur du
serveur Web.
Figure 2-6 Sélection de la langue pour le serveur web dans STEP 7
Vous pouvez aussi attribuer la même langue de projet à toutes les langues d'interface,
par ex. :
● ① Langue de projet Allemand pour la langue d'interface Allemand, Anglais (Etats-Unis)
pour Anglais, Français pour Français.
● ② Langue de projet Anglais (Etats-Unis) pour toutes les autres langues d'interface du
serveur Web disponibles.
Au total, vous pouvez affecter jusqu'à trois langues de projet STEP 7 différentes aux langues
de l'interface utilisateur du serveur Web.
Voir aussi
Pour plus d'informations sur le mode de sélection de la langue du projet dans STEP 7,
référez-vous à l'aide en ligne de STEP 7, mot-clé : "Sélection de langues de projet".
Serveur Web
Généralités
2.4 Mettre à jour et mémoriser les informations
2.4 Mettre à jour et mémoriser les informations
Actualité du contenu de l'écran

Dans le paramétrage de base, la mise à jour automatique est activée. Le temps de
rafraîchissement paramétré est de 10 s.
La touche de fonction <F5> vous permet de mettre à jour les pages Web manuellement.
Désactiver la mise à jour automatique pour une page web particulière

Pour désactiver brièvement la mise à jour automatique pour une page Web donnée, utilisez
l'icône suivante .
Notez que la désactivation s'applique uniquement à la page Web en cours. Lors du passage
à une autre page Web, l'actualisation automatique est réactivée.
Vous réactivez la mise à jour automatique avec l'icône .
Remarque
Quand la CPU est soumise à une forte charge en cours de fonctionnement, par un grand
nombre d'alarmes PROFINET, par exemple, ou par de nombreuses tâches de
communication volumineuses, la mise à jour des pages Web peut être nettement retardée
pendant la durée de cette forte charge.
Impression de pages Web

Sur la plupart des pages Web, le serveur Web vous offre un aperçu avant impression. Pour
y accéder, utilisez l'icône .
Les imprimés réalisés montrent toujours les informations actuelles de la CPU. Il est donc
possible que les informations affichées dans l'aperçu avant impression soient plus actuelles
que les informations dans la vue standard.
Serveur Web
Pages Web 3
3.1 Page d'accueil avec des informations générales sur la CPU
Établissement de la liaison au serveur Web

Vous établissez une liaison au serveur Web en saisissant l'adresse IP de l'interface de la
CPU configurée connectée au client dans la barre d'adresse du navigateur Internet, p. ex.
http://192.168.3.141 ou https://192.168.3.141. La liaison s'établit et la page "Intro" s'ouvre.
À titre d'exemple, vous trouverez ici quelques informations sur les différentes pages Web.
Intro
La figure suivante présente la première page (Intro) appelée dans le navigateur Web.
Figure 3-1 Page Intro du serveur Web de la CPU 1516-3 PN/DP
Pour accéder aux pages du serveur Web, cliquez sur le lien SUIVANT.
Remarque
Activez la case d'option "Passer Intro" pour sauter l'Intro. Vous parvenez alors directement à
la page d'accueil du serveur web. Ce paramètre est enregistré dans le profil utilisateur de
l'utilisateur actuel du PC.
Vous pouvez annuler le réglage "Passer l'intro", en cliquant sur le lien "Intro" dans la barre
de navigation gauche d'une page Web.
Serveur Web
Pages Web
Paramétrer la langue de l'interface utilisateur

Vous pouvez changer de langue de l'interface utilisateur du serveur Web, p. ex. passer du
français à l'anglais, dans le coin supérieur droit. Cette possibilité de sélection vous sera
proposée sur toutes les pages Web du serveur Web.
Commuter l'affichage de l'heure

À gauche du choix de la langue, vous pouvez choisir le format pour afficher l'heure, soit
comme temps universel coordonné (UTC), soit comme heure locale de l'AP (valeur par
défaut).
Figure 3-2 Commuter l'affichage de l'heure
Vous pouvez commuter l'affichage de l'heure sur toutes les pages Web qui présentent cette
liste déroulante.
Serveur Web
Pages Web
L'heure locale qui s'affiche pour l'AP résulte de la zone horaire choisie dans les propriétés de
la CPU et du réglage Heure d'été/Heure d'hiver.
Figure 3-3 Réglage de l'heure dans les propriétés de la CPU
Cette commutation a un effet sur les pages Web suivantes :
Tableau 3- 1 Commuter l'affichage de l'heure : affichage sur les pages Web
Page Web Affichage comme temps universel coordonné ou heure

locale de l'AP
Page d'accueil Dernière modification F
Tampon de diagnostic Horodatage des entrées dans le tampon de diagnostic
Alarmes Horodatage des alarmes
Sauvegarde en ligne Fichier de sauvegarde avec horodatage de la sauve-
garde
DataLogs Date et heure de modification
Filebrowser Date et heure de modification
Fichiers utilisateur Date et heure de modification
Enregistrer les données de maintenance Fichier avec horodatage de l'enregistrement
Serveur Web
Pages Web
Page d'accueil
La page d'accueil vous fournit, avant la connexion, les informations représentées dans la
figure suivante. La représentation de la CPU avec les DEL vous fournit l'état actuel à l'instant
de votre requête de données.
Figure 3-4 Page d'accueil avant la connexion
Serveur Web
Pages Web
Connexion
Vous devrez être connecté pour utiliser la fonctionnalité complète des pages Web.
Connectez-vous avec le nom utilisateur et le mot de passe définis dans STEP 7 dans la
configuration Web. Après cela, vous pouvez accéder aux pages Web validées pour cet
utilisateur avec les droits d'accès correspondants. Si vous n'avez pas configuré d'utilisateur,
le paramétrage par défaut ne vous accordera que l'accès en lecture aux pages d'introduction
et d'accueil.
Remarque
Après avoir exécuté les actions prévues, déconnectez-vous activement du serveur Web en
cliquant sur "Déconnexion" afin de réduire le risque d'un accès non autorisé de l'extérieur.
Remarque
Délai d'expiration de session
Le délai d'expiration de chaque session commencée est de 30 minutes. À chaque mise à
jour/mise à jour automatique, la session est automatiquement prolongée de 30 minutes.
Serveur Web
Pages Web
Figure 3-5 Page d'accueil après la connexion
① "Général"
"Général" contient des informations sur la CPU du serveur Web auquel vous êtes
actuellement connecté ainsi que le nom du projet et la version de TIA Portal avec laquelle la
CPU a été configurée. La version TIA Portal affichée est au minimum requise pour charger
ou éditer le projet complet.
② "État"
"État" contient des informations sur l'état de la CPU au moment de l'interrogation.
③ "Panneau de commande CPU"

Dans la zone "Panneau de commande de la CPU", vous avez la possibilité de modifier l'état
de fonctionnement de la CPU (boutons "RUN"/"STOP") ou de faire clignoter les LED (bouton
"Clignotement LED") si vous disposez des droits d'accès nécessaires.
Serveur Web
Pages Web
Informations supplémentaires pour les CPU F
Figure 3-6 Page d'accueil après la connexion à une CPU F
④ "De sécurité"
"De sécurité" contient des informations supplémentaires sur la CPU F. Plus d'informations
sur ces indications, voir le manuel de programmation et d'utilisation SIMATIC Safety -
Configuration et programmation
(https://support.industry.siemens.com/cs/de/de/view/54110126/en?dl=en) (en anglais).
Voir aussi
Pour plus d'informations, voir chapitre Configuration du serveur Web (Page 19).
Serveur Web
Pages Web
3.2 Diagnostic
3.2 Diagnostic
Vue d'ensemble
La page Web "Diagnostic" donne des informations détaillées sur les onglets :
● Identification
● Protection du programme
● Mémoire
● Informations sur l'exécution
● De sécurité (pour une CPU F)
Onglet "Identification"
Les caractéristiques de la CPU se trouvent sous l'onglet "Identification".
Figure 3-7 Onglet "Identification"
① "Identification"
Le repère essentiel, le repère d'emplacement et le numéro de série se trouvent dans le
champ d'info "Identification". Vous pouvez configurer le repère d'installation et le repère
d'emplacement dans STEP 7, dans la boîte de dialogue des propriétés de la CPU, onglet
"Général".
②"Numéro de référence"
Le champ d'info "Nº de référence" fournit un numéro de référence pour le matériel.
③"Version"
Les versions du matériel, du firmware et du chargeur de démarrage (bootloader) figurent
dans le champ d'info "Version".
Serveur Web
Pages Web
3.2 Diagnostic
Onglet "Protection du programme"

L'onglet "Protection du programme" indique si le programme API comporte une protection
Know-How ou une protection contre la copie.
Figure 3-8 Onglet "Protection du programme"
①"Protection Know-How"
Le champ d'information "Protection Know-How" indique si le programme API comporte au
moins un bloc avec protection Know-How ou non.
②"Lien"
Le champ d'information "Lien" indique si la protection contre la copie est activée par un lien
au numéro de série de la CPU ou de la carte mémoire pour au moins un bloc du programme
API.
● "Un lien existe"
● "Pas de lien"
● "Pas de correspondance du lien" : Au moins un bloc est lié à un autre numéro de série (le
processus de chargement est rejeté)
Serveur Web
Pages Web
3.2 Diagnostic
Onglet "Mémoire"
Vous trouvez les valeurs actuelles concernant l'espace mémoire actuellement utilisé dans
l'onglet "Mémoire"
Figure 3-9 Onglet "Mémoire"
Serveur Web
Pages Web
3.2 Diagnostic
Onglet "Informations d'exécution"

L'onglet "Informations sur l'exécution" donne des informations actuelles sur la charge due au
programme/à la communication et le temps de cycle. Ainsi, vous pouvez constater la
présence d'éventuels problèmes d'exécution durant l'exécution de votre programme
utilisateur.
Figure 3-10 Onglet "Informations sur l'exécution"
Serveur Web
Pages Web
3.2 Diagnostic
Charge due au programme/à la communication

La fonction "Value refresh" vous permet d'actualiser les données affichées dans les
bargraphes :
● dans un intervalle d'1 seconde
● automatiquement (comme configuré dans STEP 7)
La fonction "Measurement" vous permet de décider quelle mesure les bargraphes affichent.
Vous pouvez choisir entre :
● la mesure actuelle
● la mesure du temps de cycle le plus long
Figure 3-11 Charge due au programme/à la communication
La légende de la charge due au programme/à la communication affiche des informations en

couleur pour les valeurs suivantes :
● "Program load cyclic program OBs"
temps de calcul requis en pourcentage au cours d'un cycle pour les OB programme
cycliques
● "Program load high-priority OBs"
temps de calcul requis en pourcentage au cours d'un cycle pour des OB de priorité
supérieure
● "Current communication load"
temps de calcul requis en pourcentage pour les tâches de communication actuelles au
cours d'un cycle
● "Maximum permissible communication load"
la charge de communication maximale en pourcentage
● "No-load operation"
pas de charge due au programme/à la communication
Remarque
Si vous avez paramétré un temps de cycle minimal, il est possible que la marche à vide
affiche une valeur en pourcentage élevée, bien que la valeur du temps de cycle soit
également élevée.
Ceci s'explique par le fait que les charges sont détectées comme moyenne arithmétique
de la dernière seconde mais que le temps de cycle se rapporte, lui, au dernier cycle.
Serveur Web
Pages Web
3.2 Diagnostic
Figure 3-12 Légende en couleur
Si vous cliquez sur une couleur donnée, la couleur sélectionnée est mise en surbrillance
dans le diagramme. Si vous cliquez sur une couleur déjà mise en surbrillance, vous annulez
la mise en surbrillance.
Measurement of load distribution and cycle time

Le bargraphe "Measurement of load distribution and cycle time" indique pour les valeurs
suivantes la part en pourcentage du temps de calcul au cours d'un cycle :
● "No-load operation"
Prognosis of load distribution and cycle time

Le diagramme "Prognosis of load distribution and cycle time" prévoit si la CPU peut traiter le
programme utilisateur avec une charge de communication maximale pendant le temps de
cycle maximal.
Serveur Web
Pages Web
3.2 Diagnostic
Exemple 1 :
Figure 3-13 Temps de cycle < 70 % du temps de cycle maximal
L'exemple 1 montre que la CPU peut traiter le programme utilisateur au cours du temps de
cycle maximal de 150 ms lorsque la charge de communication maximale de 38 % est
atteinte. Le temps de cycle prévu est < 70 % du temps de cycle maximal configuré.
Exemple 2 :
Figure 3-14 Temps de cycle ≥ 70 % du temps de cycle maximal
Dans l'exemple 2, la CPU peut également traiter le programme utilisateur avec une charge
de communication maximale pendant le temps de cycle maximal. Le temps de cycle prévu
est toutefois déjà de 129 ms. Dès que le temps de cycle prévu ≥ 70 % du temps de cycle
maximal, le diagramme affiche un avertissement.
Serveur Web
Pages Web
3.2 Diagnostic
Exemple 3 :
Figure 3-15 Temps de cycle plus long que le temps de cycle maximal
L'exemple 3 montre que la CPU ne peut plus traiter le programme utilisateur au cours du
temps de cycle maximal lorsque la charge de communication maximale est atteinte. Si le
temps de cycle prévu est plus long que le temps de cycle maximal, le diagramme affiche un
message d'erreur.
En cas de dépassement prévu du temps de cycle maximal, utilisez le curseur suivant pour
réduire la charge de communication maximale.
Figure 3-16 Curseur permettant de régler la charge maximale due à la communication
Serveur Web
Pages Web
3.2 Diagnostic
Remarque
Paramétrer la charge de communication
Le régulateur prévoit les répercussions de la modification de la charge de communication
sur le temps de cycle. Vous effectuez la configuration réelle de la charge maximale due à la
communication dans STEP 7.
Remarque
Planifiez pour les variations non mesurables dans le programme utilisateur, par ex. pour les
modifications ultérieures dans le programme utilisateur, une valeur suffisamment basse pour
la charge maximale due à la communication.
Remarque
En raison de la base d'acquisition différente du temps de cycle et de la charge, un état
stabilisé du système est nécessaire pour l'affichage de valeurs de mesure fiables.
Pour plus d'informations sur l'influence de la charge de communication sur le temps de

cycle, voir la description fonctionnelle Temps de cycle et de réaction
(https://support.industry.siemens.com/cs/fr/fr/view/59193558).
Trend for program/communication load

Si votre navigateur prend en charge l'affichage de SVG (Scalable Vector Graphics), la
courbe pour la charge due au programme/à la communication est ajoutée à l'affichage dans
l'onglet "Runtime information".
Les diagrammes linéaires dans la zone "Trend for program/communication load" vous
permettent de suivre l'historique des valeurs suivantes :
L'option "Number of recorded measuring points" vous permet de choisir pour l'affichage des
valeurs parmi les 20 à 1 000 dernières valeurs mesurées.
Serveur Web
Pages Web
3.2 Diagnostic
Pour la courbe sur l'axe x, vous pouvez choisir entre "Time" (heure de la CPU) et
"Measuring points" en cliquant sur l'unité souhaitée.
Remarque
Si vous avez choisi l'unité "Time" sur l'axe x, toutes les valeurs de mesure datant de plus
de 24 heures sont automatiquement supprimées.
Figure 3-17 Diagramme linéaire
Onglet "De sécurité" (pour une CPU F)

Le programme de sécurité d'une CPU F comprend un ou deux groupes d'exécution F dont la
signature de groupe d'exécution F, les temps de cycle (temps de surveillance F) et les temps
d'exécution sont indiqués dans l'onglet "De sécurité".
Figure 3-18 Onglet "De sécurité"
Serveur Web
Pages Web
3.3 Mémoire tampon de diagnostic
3.3 Mémoire tampon de diagnostic
Condition requise
Vous avez activé le serveur Web, choisi la langue, chargé les bibliothèques de textes et
effectué la compilation et le chargement du projet avec STEP 7.
Mémoire tampon de diagnostic

Le navigateur affiche le contenu du tampon de diagnostic sur la page Web "Tampon de
diagnostic".
Figure 3-19 Mémoire tampon de diagnostic
① "Tampon de diagnostic Entrées 1-50"

En fonction de la CPU utilisée, le tampon de diagnostic peut accepter un nombre différent de
messages.
Le nombre max. d'entrées dans le tampon de diagnostic est indiqué dans les
caractéristiques techniques de la CPU utilisée.
Dans la liste de sélection, sélectionnez un intervalle pour les entrées. Chaque intervalle
comporte 50 entrées.
② "Evénement"
Le champ d'info "Evénement" contient les événements de diagnostic avec la date et l'heure.
Veillez à ce que les événements de diagnostic s'affichent dans la langue de projet de
STEP 7 qui est actuellement attribuée à la langue de l'interface utilisateur du serveur Web.
Pour l'affectation de langues de projet aux langes d'interface utilisateur, voir le chapitre
Paramétrages de la langue (Page 29).
Serveur Web
Pages Web
3.4 Diagnostic Motion Control
③ "Détails"
Ce champ précise les informations détaillées sur l'événement sélectionné. Pour cela,
sélectionnez l'événement qui vous occupe dans le champ d'info ② "Evénement".
Sauvegarder les entrées du tampon de diagnostic

Vous pouvez mémoriser des entrées du tampon de diagnostic dans un fichier csv pour
traitement ultérieur dans un tableur ou un logiciel de base de données.
Vous mémorisez les données en cliquant sur l'icône .
Une boîte de dialogue s'affiche vous permettant d'y indiquer le nom du fichier et un
répertoire cible.
Vue d'ensemble
Le serveur Web vous indique les états, les défauts, les alarmes technologiques et les
valeurs actuelles des objets technologiques (TO) suivants :
● Axe de vitesse (TO_SpeedAxis)
● Axe de positionnement (TO_PositioningAxis)
● Axe de synchronisme (TO_SynchronousAxis)
● Codeur externe (TO_ExternalEncoder)
● Palpeur de mesure (TO_MeasuringInput)
● Came (TO_OutputCam)
● Piste de came (TO_CamTrack)
La page Web "Diagnostic Motion Control" donne, dans les vues suivantes, des informations
détaillées sur les objets technologiques configurés :
● Diagnostic
● Vue d'ensemble de service
Diagnostic
La vue "Diagnostic" vous propose :
● ① une liste d'ensemble des objets technologiques configurés
● ② les messages d'état et d'erreur d'un objet technologique sélectionné
● ③ les valeurs et valeurs limites de l'état d'un axe/d'une came sélectionnée
Serveur Web
Pages Web
① Vue "Diagnostic"
Sous l'onglet "Diagnostic" se trouve une liste de vue d'ensemble des objets technologiques
configurés avec désignation et type, elle indique si l'objet respectif est "validé" et "référencé".
L'objet technologique est validé : l'axe peut être déplacé par des commandes de
déplacement.
L'objet technologique est référencé : le rapport entre la position sur l'objet technologique et
la position mécanique a été établi correctement. Une marque de référence est affectée à la
valeur réelle de position sur l'objet technologique.
Figure 3-20 Diagnostic Motion Control : bits d'état et d'erreur
Signification des symboles dans la colonne "État"

Tableau 3- 2 Signification des symboles
Symbole Couleur du symbole Signification

vert Composant OK
jaune Avertissement présent
rouge Défaut - composant perturbé ou non disponible
Sélectionnez l'objet technologique souhaité. Les informations de diagnostic correspondantes

sont représentées dans les onglets inférieurs.
Serveur Web
Pages Web
② Onglet "Bits d'état et d'erreur"

Avec l'onglet "Bits d'état et d'erreur", vous surveillez les messages d'état et d'erreur de l'objet
technologique comme dans STEP 7.
③ Onglet "État de mouvement"/"État de la piste de came"

Avec l'onglet "État de mouvement", vous surveillez l'état de mouvement de l'axe comme
dans STEP 7.
Figure 3-21 Diagnostic Motion Control : état de mouvement
Serveur Web
Pages Web
Avec l'onglet "État de la piste de came", vous surveillez l'état de la piste de came comme
dans STEP 7.
Figure 3-22 Diagnostic Motion Control : état de la piste de came
Serveur Web
Pages Web
Vue d'ensemble de service

La "Vue d'ensemble de service" vous propose :
● ① les informations d'état et de diagnostic pour plusieurs objets technologiques
● ② une possibilité de filtre pour sélectionner certains des objets technologiques affichés
① Vue "Vue d'ensemble de service"

La "Vue d'ensemble de service" affiche les informations de diagnostic pour plusieurs objets
technologiques sous forme de tableau.
Figure 3-23 Diagnostic Motion Control, vue d'ensemble de service : informations d'état et d'erreur
Serveur Web
Pages Web
Pour sélectionner les informations à afficher, cliquez sur le symbole de liste dans la
première colonne du tableau. Faites votre choix dans la fenêtre qui s'ouvre. Cliquez de
nouveau sur le symbole de liste pour quitter la fenêtre de sélection.
Figure 3-24 Diagnostic Motion Control, vue d'ensemble de service : configurer les informations d'état
et d'erreur
Serveur Web
Pages Web
② Sélection "Sélectionner des objets technologiques"

Avec la fonction "Sélectionner des objets technologiques", vous pouvez sélectionner certains
objets technologiques affichés.
Figure 3-25 Diagnostic Motion Control, vue d'ensemble de service : informations d'état et d'erreur -
sélectionner des objets technologiques
Pour plus d'informations, voir les descriptions fonctionnelles S7-1500(T) Motion Control sur
Internet (https://support.industry.siemens.com/cs/ww/fr/view/109751049).
Pour avoir des explications sur les fonctions de diagnostic "Bits d'état et d'erreur" et "État de
mouvement"/"État de la piste de came" des différents objets technologiques, voir l'aide en
ligne de STEP 7.
Serveur Web
Pages Web
3.5 Etat du module
3.5 Etat du module

Etat du module
L'état d'une station est indiqué sur la page Web "Etat du module" au moyen d'icônes et de
commentaires.
Figure 3-26 Etat du module
Signification des icônes dans la colonne "Etat"

Tableau 3- 3 Signification des icônes
Icône Couleur Signification

de l'icône
vert Composant OK
gris Esclaves PROFIBUS ou périphériques PROFINET désactivés
gris Etat impossible à déterminer

• L'"état impossible à déterminer" est toujours indiqué, par exemple, pendant
le diagnostic système pour tous les modules et systèmes de périphérie
configurés après le redémarrage de la CPU.
• Mais il peut aussi s'afficher temporairement en cours de fonctionnement,
pour tous les modules, en cas d'avalanche d'alarmes de diagnostic.
• Pour les modules d'un sous-système raccordé à un CP, aucun état ne peut
être déterminé.
rouge Composants "non accessibles"
S'affiche en cas de module débroché ou de module configuré mais manquant.
noire Aucune donnée d'entrée ou de sortie disponible.
Les voies d'entrée ou de sortie du (sous-) module sont verrouillées.
vert Maintenance nécessaire (Maintenance Required)
jaune Maintenance requise (Maintenance Demanded)
rouge Défaut - Composant perturbé ou non disponible en raison du type incorrect
rouge L'état d'un module d'un niveau de module inférieur ne correspond pas à l'état
"Composant OK"
Serveur Web
Pages Web
3.5 Etat du module
Navigation vers d'autres niveaux de modules

L'état des différents modules/sous-modules/cartouches s'affiche quand vous naviguez vers
les autres niveaux de modules.
● Vers les niveaux de modules supérieurs via les liens dans l'affichage des niveaux de
modules
● Vers les niveaux de modules inférieurs via les liens dans la colonne "Nom"
Figure 3-27 Navigation vers d'autres niveaux de modules
① "Etat du module"
Suivant le niveau sélectionné, le tableau contient des informations sur le châssis (rack), le
réseau maître DP, le réseau maître PROFINET IO, sur les abonnés, les différents modules
ou encore sur les modules ou sous-modules de la station.
② "Affichage des niveaux de modules"

Les liens vous permettent d'accéder à l'"Etat du module" des niveaux supérieurs de
modules.
③ "Topologie"
Les deux pages Web "Etat du module" et "Topologie" sont reliées entre elles. Si vous
cliquez sur "Topologie" du module sélectionné, vous passez automatiquement à ce module
dans la vue graphique de la topologie prévue sur la page Web "Topologie". Le module
s'affiche dans la zone visible de la page Web "Topologie". L'en-tête du module sélectionné
clignote quelques secondes.
Serveur Web
Pages Web
3.5 Etat du module
④ "Adresse IP"
Si un lien figure ici, celui-ci permet de naviguer jusqu'au serveur Web du périphérique
configuré sélectionné.
⑤ "Détails"
Le lien "Détails" vous permet d'obtenir d'autres informations sur le module sélectionné, dans
les onglets "Etat" et "Identification".
⑥ Onglet "Etat"
En cas de défaut ou d'alarme, cet onglet contient des informations sur l'état du module
sélectionné.
⑦ Onglet "Identification"
Cet onglet contient des données permettant d'identifier le module sélectionné.
Remarque
Il n'affiche que les données configurées hors ligne des modules.
⑧ Onglet "Statistiques"
Cet onglet n'est affiché que pour les périphériques PROFINET IO et il comprend les
informations suivantes relatives à la statistique de communication du périphérique IO
sélectionné :
● "Statistiques globales - Paquets de données émis"
Vous pouvez évaluer la transmission de données sur la ligne d'émission à l'aide des
chiffres indiqués dans ce champ d'info.
● "Statistiques globales - Paquets de données reçus"
Vous pouvez évaluer la transmission de données sur la ligne de réception à l'aide des
● "Statistiques port x - Paquets de données émis"
Vous pouvez évaluer la transmission de données sur la ligne d'émission pour chaque
port à l'aide des chiffres indiqués dans ce champ d'info.
● "Statistiques port x - Paquets de données reçus"
Serveur Web
Pages Web
3.5 Etat du module
Vous pouvez évaluer la transmission de données sur la ligne de réception pour chaque
port à l'aide des chiffres indiqués dans ce champ d'info.
Figure 3-28 Onglet "Statistiques"
Voir aussi
Pour de plus amples informations, reportez-vous à l'onglet "Statistiques" au chapitre
Communication (Page 66).
Exemple : Etat du module - Module
Figure 3-29 Exemple : Etat du module - Module
Serveur Web
Pages Web
3.6 Mise à jour du firmware
Remarque
Si dans la configuration centrale de votre installation vous utilisez la fonction Contrôle de
configuration (traitement des options), un texte d'information situé dans la zone d'en-tête de
la page Web vous informe, le cas échéant, que l'état du module de périphérie affiché est
incohérent. Aucun texte correspondant n'est affiché pour la périphérie décentralisée.
Exemple : Etat du module - sous-module
Figure 3-30 Exemple : Etat du module - sous-module
Voir aussi
Pour plus d'informations sur l'"état du module", voir l'aide en ligne de STEP 7, mot-clé : "Etat
du module".
Introduction
Sur la page Web "État du module" dans le niveau module, vous mettez à jour le firmware, en
tant qu'utilisateur disposant des droits d'accès correspondants. Pour plus d'informations sur
la gestion des utilisateurs, voir chapitre Configuration du serveur Web (Page 19),
paragraphe "Compléter la gestion des utilisateurs".
À l'aide d'un fichier de mise à jour, vous actualisez le firmware de la CPU, de l'écran de la
CPU ou des différents modules centraux ou décentralisés. Notez que tous les modules que
vous souhaitez mettre à jour doivent être compatibles avec les versions V12.0 et ultérieures
de TIA Portal.
Remarque
Lors de l'accès via des terminaux mobiles avec le système d'exploitation "iOS", il n'est pas
possible de réaliser de mise à jour du firmware.
Serveur Web
Pages Web
Marche à suivre
Les étapes suivantes sont requises pour la mise à jour du firmware :
● Cliquez dans la zone "Chargement du firmware" sur "Rechercher".
● Sélectionnez le fichier que vous souhaitez utiliser pour la mise à jour du firmware. Vous
trouverez les mises à jour de firmware disponibles sur la page Service&Support d'Internet
(http://support.automation.siemens.com).
① État du fichier de firmware sélectionné

② Bouton pour l'exécution de la mise à jour
Figure 3-31 État du module, onglet "Firmware", état "Prêt pour la mise à jour"
● Si l'état "Prêt pour la mise à jour" s'affiche, cliquez sur le bouton "Exécuter la mise à jour".
Si la CPU se trouve à l'état MARCHE à cet instant, le message suivant s'affiche :
Figure 3-32 Message après avoir cliqué sur "Exécuter la mise à jour"
Serveur Web
Pages Web
Confirmez le message en cliquant sur "OK". La CPU est mise à l'état STOP et la mise à
jour du firmware s'effectue.
Si vous cliquez sur "Annuler", la CPU reste à l'état de fonctionnement dans lequel elle se
trouve et la mise à jour du firmware est annulée.
● Une fois l'actualisation effectuée, un message vous indique les numéros de référence et
de version du firmware mis à jour.
Si le sélecteur de mode de fonctionnement de la CPU se trouve en position MARCHE et
si vous confirmez le message en cliquant sur "OK", la CPU se met automatiquement à
l'état de fonctionnement MARCHE. Cela peut durer quelques minutes ; une barre de
progression n'est pas affichée.
Si vous cliquez sur "Annuler", la CPU reste à l'état ARRET et vous pouvez effectuer
d'autres mises à jour.
Figure 3-33 Message du transfert réussi du firmware
Référence
Pour plus d'informations sur la mise à jour du firmware, consultez l'aide en ligne de STEP 7
et la FAQ suivante sur Internet
Serveur Web
Pages Web
3.7 Messages
3.7 Messages
Condition requise
Vous avez configuré les textes de message dans les langues souhaitées. Pour plus
d'informations sur la configuration des textes de messages, référez-vous à STEP 7 et aux
pages Service&Support (http://www.siemens.com/automation/service&support).
Messages
Pour obtenir des informations compactes en vue de l'analyse d'erreurs, nous vous
conseillons de toujours lire le contenu du tampon de messages en premier. C'est la méthode
la plus efficace pour obtenir une vue d'ensemble des défauts présents.
Le navigateur affiche le contenu du tampon de messages sur la page Web "Messages".
Figure 3-34 Messages
① "Messages"
Les messages de la CPU s'affichent par défaut dans l'ordre antéchronologique avec la date
et l'heure dans le champ d'info ①.
Le paramètre Texte de message affiche le texte de message configuré de la définition
d'erreur correspondante.
Veillez à ce que les textes de message s'affichent dans la langue de projet de STEP 7 qui
est actuellement attribuée à la langue de l'interface utilisateur du serveur Web. Pour
l'affectation de langues de projet aux langes d'interface utilisateur, voir le chapitre
Paramétrages de la langue (Page 29).
Trier
Vous avez en outre la possibilité de trier les différents paramètres de la page Web actuelle
(50 entrées maxi.) par ordre croissant ou décroissant. Cliquez à cet effet sur un paramètre
dans l'en-tête de colonne.
● Numéro de message
● Date
● Heure (de la CPU)
● Texte de message
● Etat
● Acquittement
Serveur Web
Pages Web
3.8 Communication
Lorsque vous cliquez sur "Date", les messages s'affichent dans l'ordre chronologique. Les
événements apparaissant et disparaissant sont indiqués dans le paramètre Etat.
Dès lors que vous disposez du droit d'utilisateur correspondant (voir chapitre Configuration
du serveur Web (Page 19)), vous disposez dans la colonne "Acquittement" d'un bouton, pour
les messages devant être acquittés, permettant d'acquitter le message.
② "Détails sur le numéro de message"

Ce champ d'info affiche des informations détaillées sur un message. Sélectionnez à cet effet
un message dont vous souhaitez obtenir des détails dans le champ d'info ②.
Sauvegarder les alarmes

Vous pouvez mémoriser des messages dans un fichier csv pour traitement ultérieur dans un
tableur ou un logiciel de base de données.
Vous enregistrez les données en cliquant sur l'icône .
Une boîte de dialogue s'affiche vous permettant d'y indiquer le nom du fichier et un
répertoire cible.
3.8 Communication
Vue d'ensemble
Vous trouverez des informations détaillées sur les onglets suivants de la page Web
"Communication" :
● Paramètres
● Statistiques
● Ressources
● Liaisons
Serveur Web
Pages Web
3.8 Communication
① Onglet "Paramètres"
Vous trouverez des informations regroupées relatives aux interfaces PROFINET et Ethernet
de la CPU sélectionnée dans l'onglet "Paramètres".
Figure 3-35 Paramètres des interfaces PROFINET et Ethernet intégrées
②"Connexion réseau"
"Connexion réseau" fournit des informations sur l'identification des interfaces PROFINET et
Ethernet intégrées de la CPU correspondante. Vous trouverez l'adresse MAC au-dessus de
l'interface PROFINET ou Ethernet respective sur la CPU.
③ "Paramètre IP"
Ce paramètre contient des informations sur l'adresse IP configurée et le numéro du sous-
réseau dans lequel se trouve la CPU correspondante.
④ "Propriétés physiques"
Vous trouverez les informations suivantes sur les propriétés physiques de l'interface dans le
champ "Propriétés physiques" :
● Numéro de port
● Etat du lien
● Paramètres
● Mode
● Support de connexion
Serveur Web
Pages Web
3.8 Communication
① Onglet "Statistiques"
Vous trouverez des informations sur la transmission de données dans l'onglet "Statistiques".
Figure 3-36 Onglet "Statistiques" avec les chiffres concernant la transmission de données
② "Statistiques globales - Paquets de données émis"

Vous pouvez évaluer la transmission de données sur la ligne d'émission à l'aide des chiffres
indiqués dans ce champ d'info.
Serveur Web
Pages Web
3.8 Communication
③ "Statistiques globales - Paquets de données reçus"

Vous pouvez évaluer la transmission de données sur la ligne de réception à l'aide des
④ "Statistiques port x - Paquets de données émis"

Vous pouvez évaluer la transmission de données sur la ligne d'émission pour chaque port à
l'aide des chiffres indiqués dans ce champ d'info.
⑤ "Statistiques port x - Paquets de données reçus"

Vous pouvez évaluer la transmission de données sur la ligne de réception pour chaque port
à l'aide des chiffres indiqués dans ce champ d'info.
① Onglet "Ressources"
Vous trouverez des informations sur l'utilisation des ressources des liaisons dans l'onglet
"Ressources".
Figure 3-37 Onglet "Ressources"
② Nombre de liaisons
Sous "Nombre de liaisons", vous trouverez des informations sur le nombre maximal de
liaisons et sur le nombre de liaisons non occupées.
③ Liaisons
Sous "Liaisons", vous trouverez des informations sur le nombre de liaisons occupées ou
réservées à la communication via ES, IHM, S7, OpenUser, Web ainsi que des informations
sur d'autres types de communication.
Serveur Web
Pages Web
3.8 Communication
① Onglet "Liaisons"
Vous trouverez des informations sur l'état des liaisons de communication dans l'onglet
"Liaisons".
Figure 3-38 Onglet "Liaisons"
② Etat
Sous "Etat", vous trouverez une vue d'ensemble des liaisons de communication en cours
d'établissement ou déjà établies.
Pour chacune de ces liaisons, le tableau comporte des informations relatives à l'état de
connexion, l'ID local, l'emplacement d'enfichage de la passerelle, l'adresse distante (adresse
IP), le type d'adresse distante correspondant, le genre de liaison et le type de liaison.
③ Détails
Sous "Détails", vous trouverez des informations détaillées concernant la liaison
sélectionnée.
Voir aussi
Vous trouverez l'explication relative au message d'erreur affiché lors d'une coupure de
liaison ou d'un échec de tentative d'établissement de liaison dans l'aide en ligne de STEP 7.
Serveur Web
Pages Web
3.9 Topologie
3.9 Topologie
3.9.1 Introduction
Topologie des abonnés au PROFINET

Le site Web "Topologie" vous informe sur la topologie et l'état des périphériques PROFINET
de votre réseau PROFINET IO.
Il existe trois onglets pour les vues suivantes :
● Vue graphique (topologie prévue et topologie réelle)
● Vue tabellaire (uniquement la topologie réelle)
● Vue d'ensemble de l'état des modules (sans représentation des relations topologiques)
Vous pouvez imprimer la vue tabellaire et la vue d'ensemble de l'état des modules.
Servez-vous de l'aperçu avant impression fourni par votre navigateur et corrigez au besoin le
format.
Topologie prévue
La topologie prévue s'affiche si vous avez interconnecté les liaisons d'un point de vue
topologique lors de la configuration avec STEP 7.
La vue actuelle permet de lire l'affectation topologique des périphériques PROFINET
défaillants ainsi que de détecter les différences entre la topologie prévue et la topologie
réelle et les ports permutés.
Remarque
La topologie prévue configurée est toujours affichée par défaut dans les scénarios suivants :
• en cas d'appel de la page Web "Topologie" via la barre de navigation
• si vous avez cliqué sur le lien "Topologie" dans la vue d'ensemble des périphériques
PROFINET IO de la page web "État du module" pour afficher la page Web "Topologie".
Quand aucune topologie prévue n'est configurée, c'est la topologie réelle qui s'affiche.
Topologie réelle
Affichage de la topologie actuelle des périphériques PROFINET "configurés" d'un réseau
PROFINET IO et des périphériques PROFINET non configurés détectés comme voisins
directs (affichage des relations de voisinage dans la mesure où celles-ci peuvent être
déterminées ; aucune information d'état n'est cependant affichée pour ces périphériques
PROFINET voisins).
Serveur Web
Pages Web
3.9 Topologie
3.9.2 Vue graphique
Conditions requises
Afin de pouvoir utiliser la topologie de manière correcte, voici les conditions indispensables :
● Les Paramétrages de la langue (Page 29) ont été effectués.
● Les connexions topologiques des ports ont été configurées dans l'éditeur de la topologie
de STEP 7 (condition pour l'affichage de la topologie prévue et des liaisons topologiques
prévues correspondantes).
● Le projet a été compilé dans STEP 7.
● Le projet est complètement chargé.
Vue graphique de la topologie prévue et de la topologie réelle

Sur la page Web "Topologie", vous pouvez sélectionner en haut à gauche l'interface dont la
topologie doit s'afficher (X1, X2, X3 ou modules de communication PROFINET, comme le
CM 1542-1).
Figure 3-39 Vue graphique de la topologie prévue et de la topologie réelle
Serveur Web
Pages Web
3.9 Topologie
Signification des couleurs de liaison dans la topologie prévue/réelle :
Tableau 3- 4 Signification des couleurs de liaison dans la topologie prévue/réelle
Liaison Signification
Topologie prévue Topologie réelle
vert La liaison actuelle correspond à la liaison prévue. Liaisons détectées
rouge La liaison réelle actuelle ne correspond pas à la liaison prévue -
configurée (par ex. port permuté).
jaune La liaison ne peut pas être diagnostiquée. Causes : -
• La communication avec un périphérique est défectueuse
(câble débranché, p. ex.).
• Liaison à un composant passif (switches ou câbles, p. ex.).
• Liaison à des appareils/périphériques PROFINET d'un autre
contrôleur IO ou sous-réseau IO
① Abonnés PROFINET configurés et accessibles

Les abonnés PROFINET configurés et accessibles sont indiqués en gris foncé. Les liaisons
montrent via quels ports sont connectés les abonnés PROFINET d'une station.
② Abonnés PROFINET configurés mais non accessibles

Les abonnés PROFINET configurés mais non accessibles sont représentés en rose et
encadrés de rouge (par ex. appareil défaillant, câble débranché).
③ Abonnés désactivés
Tous les abonnés PROFINET configurés désactivés sont indiqués en gris clair.
④ Ports permutés
Les ports permutés sont marqués en rouge dans la vue de la topologie prévue. La topologie
réelle affiche les ports réellement connectés alors que la vue de la topologie prévue affiche
les liaisons prévues configurées.
Serveur Web
Pages Web
3.9 Topologie
⑤ Appareils PROFINET d'un autre sous-réseau PROFINET IO

● Dans la topologie prévue :
L'appareil PROFINET d'un autre sous-réseau PROFINET IO est représenté, lorsqu'il est
posé directement à côté d'un appareil PROFINET configuré et accessible ①, par une
liaison verte (ou rouge si les ports sont permutés). Dans pareil cas, il doit être accessible
lui aussi. Si l'appareil PROFINET d'un autre sous-réseau PROFINET IO n'est pas
accessible, la liaison est représentée par une ligne jaune.
La liaison entre deux appareils PROFINET appartenant chacun à un sous-réseau
PROFINET IO différent ne peut pas être détectée et est donc toujours représentée en
jaune.
● Dans la topologie réelle :
Un appareil PROFINET d'un autre sous-réseau PROFINET IO n'est affiché que si
l'appareil PROFINET se trouve dans le voisinage immédiat d'un appareil PROFINET
configuré. L'appareil PROFINET est représenté en gris clair avec une ligne pointillée
circonscrivant l'en-tête d'appareil.
Les appareils PROFINET d'un autre sous-réseau PROFINET IO sont dépourvus
d'informations d'état sur l'en-tête de l'appareil.
⑥ Représentation des relations de voisinage erronées

Les abonnés dont les relations de voisinage n'ont pu être lues en entier ou seulement de
manière erronée sont représentés en gris clair et encadrés de rouge.
Remarque
Représentation des relations de voisinage erronées
Lorsqu'un abonné n'a pas le firmware approprié, les relations de voisinage ne peuvent pas
être représentées correctement. En cas d'affichage de relation de voisinage erronée, une
mise à jour de l'abonné concerné est requise.
Affichage de modifications de la configuration

● Si un appareil tombe en panne, il reste affiché au même endroit dans la vue "Topologie
prévue", mais son en-tête est encadré de rouge et accompagné du symbole .
● Si un appareil tombe en panne, il change de place dans la vue "Topologie réelle" et
s'affiche dans la partie inférieure avec un en-tête encadré de rouge et accompagné du
symbole .
Lien entre les pages Web "Topologie" et "État du module"

Les deux pages Web "Topologie" et "État du module" sont liées entre elles. Si vous cliquez
dans la vue topologique sur l'en-tête du module configuré, vous passez automatiquement à
ce module sur la page Web "État du module".
Pour plus d'informations, voir chapitre Etat du module (Page 58).
Voir aussi
Vous trouverez d'autres exemples de vue graphique de la topologie au chapitre Exemples
de vues graphiques de la topologie (Page 77).
Serveur Web
Pages Web
3.9 Topologie
3.9.3 Vue tabellaire
Topologie - Vue tabellaire

La "Vue tabellaire" affiche toujours la "Topologie réelle".
Figure 3-40 Topologie - Vue tabellaire
① Signification des icônes sur l'état des abonnés PROFINET
Tableau 3- 5 Signification des icônes sur l'état des abonnés PROFINET
Icône Signification
Abonnés PROFINET configurés et accessibles
Abonnés PROFINET non configurés et accessibles
Abonnés PROFINET configurés, mais non accessibles
Abonné pour lequel il n'est pas possible de déterminer une relation de voisinage ou dont
la relation de voisinage n'a pu être lue en entier ou seulement de manière erronée
Serveur Web
Pages Web
3.9 Topologie
② Signification des icônes sur l'état du module des abonnés PROFINET
Tableau 3- 6 Signification des icônes sur l'état du module des abonnés PROFINET
Icône Couleur Signification

vert Composant ok.
gris Esclaves PROFIBUS ou périphériques PROFINET désactivés
noir Etat impossible à déterminer

• L'"état impossible à déterminer" est toujours indiqué en cas d'arrêt de la
CPU, par exemple, ou par "Report System Error" après le démarrage de la
CPU, durant l'évaluation au démarrage, pour tous les modules et systèmes
de périphérie configurés.
• Mais il peut aussi s'afficher temporairement en cours de fonctionnement,
pour tous les modules, en cas d'avalanche d'alarmes de diagnostic.
• Pour les modules d'un système subordonné raccordé à un CP, aucun état
ne peut être relevé.
rouge Composant défaillant ou non accessible
• "Non accessible" s'affiche par ex. en cas de module débroché ou de mo-
dule configuré mais manquant.
vert Maintenance nécessaire (Maintenance Required)
jaune Maintenance requise (Maintenance Demanded)
rouge Erreur - Composant perturbé ou non disponible en raison du type incorrect
- L'état d'un module à un niveau de module plus bas ne correspond pas à l'état
"Composant ok".
Voir aussi
Pour plus d'informations sur "Report System Error", référez-vous à l'aide en ligne de
STEP 7, mot-clé : "Diagnostic système".
Serveur Web
Pages Web
3.9 Topologie
3.9.4 Vue d'ensemble d'état
Topologie - Vue d'ensemble d'état

La "Vue d'ensemble d'état" affiche une représentation d'ensemble de tous les périphériques
PROFINET IO/PROFINET (sans relation de connexion) sur une page. Un diagnostic d'erreur
rapide est possible à l'aide des symboles indiquant les états des modules.
Ici aussi, il y a un lien entre les modules et la page Web Etat du module (Page 58).
Figure 3-41 Topologie - Vue d'ensemble d'état
3.9.5 Exemples de vues graphiques de la topologie

À titre d'exemple, vous trouverez ici quelques affichages pour un projet simple sur
différentes vues de la topologie.
Serveur Web
Pages Web
3.9 Topologie
"Topologie prévue" correcte

Ici s'affichent les connexions telles qu'elles sont configurées dans l'éditeur de topologie de
STEP 7. La configuration et le câblage correspondent.
Figure 3-42 "Topologie prévue" correcte
"Topologie réelle" correcte

Affichage de la structure actuelle de tous les périphériques configurés, accessibles de
manière topologique.
Figure 3-43 "Topologie réelle" correcte
Serveur Web
Pages Web
3.9 Topologie
"Topologie prévue" avec appareil défaillant

Quand un appareil est tombé en panne entre-temps, il reste affiché au même endroit dans la
vue "Topologie prévue". L'appareil défaillant est représenté avec un en-tête encadré de
rouge et accompagné du symbole .
Figure 3-44 "Topologie prévue" avec appareil défaillant
"Topologie réelle" avec appareil défaillant

Dans la vue "Topologie réelle", l'appareil tombé en panne entre-temps est représenté dans
la partie inférieure de la vue. L'appareil défaillant est représenté avec un en-tête encadré de
rouge et accompagné du symbole .
Figure 3-45 "Topologie réelle" avec appareil défaillant
Serveur Web
Pages Web
3.9 Topologie
"Topologie prévue" avec ports permutés

Quand les ports ont été permutés sur un appareil PROFINET configuré et en voisinage
direct, il reste au même endroit dans la vue "Topologie prévue". La liaison est représentée
par une ligne rouge si les ports sont permutés.
Figure 3-46 "Topologie prévue" avec ports permutés
Serveur Web
Pages Web
3.10 Etat des variables
État des variables

L'état des variables est affiché par le navigateur au moyen de la page Web de même nom.
Remarque
Enregistrer l'état des variables comme signet
Lorsque vous quittez la page, les saisies effectuées ne sont pas enregistrées. Si vous
souhaitez ultérieurement à nouveau visualiser les mêmes variables saisies, créez un signet
à la page "État des variables" dans votre navigateur Web. Dans le cas contraire, vous
devrez saisir à nouveau les variables lors de l'ouverture de la page.
Si vous avez défini votre page personnalisée comme page d'accueil du serveur Web, vous
ne pouvez pas accéder à l'état des variables avec les signets enregistrés. Pour plus
d'informations, voir chapitre Définir la page utilisateur comme page d'accueil (Page 138).
Remarque
Les adresses de variables sélectionnées sont reprises dans l'adresse URL
Le nombre maximum de caractères pour l'adresse URL de la page d'état des variables
s'élève à 2 083. La barre d'adresse de votre navigateur Internet indique l'adresse URL qui
correspond à votre page actuelle d'état des variables.
Pour visualiser plusieurs variables, nous vous recommandons d'utiliser les Tables de
visualisation (Page 84).
Figure 3-47 État des variables
Serveur Web
Pages Web
① "Nom"
Dans la zone de texte "Nom", vous indiquez l'adresse de la variable dont vous souhaitez
surveiller le comportement. Il peut s'agir d'une adresse symbolique ou d'une adresse
absolue.
● Les variables API (entrées et sorties, mémentos, temporisations et compteurs) et les
variables DB dans des blocs avec accès standard ont une adresse absolue et une
adresse symbolique.
● Les variables DB dans les blocs avec accès optimisé ont une adresse symbolique et
n'ont pas d'adresse absolue.
Exemple d'accès à l'adresse absolue d'un bloc de données avec accès standard :
L'adresse absolue est constituée en premier de l'identificateur d'adresse %, suivi du numéro
du bloc de données et de l'adresse absolue de la variable dans le bloc de données, séparés
par un point : %DB1.DBX1.0 = adressage absolu de la variable "DBX1.0" dans le bloc de
données global "DB1".
Les saisies non autorisées s'affichent en rouge.
② "Format d'affichage"
Dans la liste déroulante, vous sélectionnez le format d'affichage de la variable
correspondante. Si la variable ne peut pas être représentée dans le format d'affichage
souhaité, elle est affichée en code hexadécimal.
③ "Valeur"
Sous "Valeur", la valeur de l'opérande correspondant est affichée dans le format sélectionné.
④ "Modifier la valeur"
Dans cette colonne, vous pouvez modifier la valeur des variables et les écrire dans la CPU.
Pour appliquer en une fois plusieurs valeurs modifiées, cliquez sur le bouton "Appliquer" en
dessous de la table.
Pour pouvoir lire des valeurs et écrire des valeurs dans la CPU, vous devez avoir configuré
dans STEP 7 un utilisateur avec les droits d'accès correspondants.
Si la valeur que vous avez saisie n'est pas valide (p.ex. valeur binaire dans un champ
BOOL), la saisie n'est pas validée et le champ de saisie correspondant reste vide. Une
signalisation en retour spécifique ne sera pas émise pour cela.
Vous pouvez modifier les valeurs des types de données suivants :
● Bool, Byte
● DWord, LWord, Word
● Int, DInt, LInt, SInt, UDInt, UInt, ULInt, USInt
● Real, LReal
● LDT
● Counter, Date
● Time, LTime, Time_Of_Day, LTime_Of_Day, Timer
● S5Time
● Char, WChar, String
Serveur Web
Pages Web
Remarque
De manière générale, le principe suivant s'applique : Afin de pouvoir écrire des données, la
transmission "Referrer" doit être activée dans votre navigateur Internet (cela est paramétré
par défaut dans tous les navigateurs courants).
Particularité lors du changement de langue

Vous pouvez changer de langue, p. ex. passer du français à l'anglais, dans le coin supérieur
droit. Tenez compte du fait que les abréviations allemandes diffèrent des abréviations
internationales.
Pour la visualisation des types de données disponibles

En principe, vous pouvez visualiser via le serveur Web tous les types de données de
variables API que vous pouvez également visualiser dans STEP 7.
Notez qu'en raison de leur volume de données, les types de données structurés ARRAY,
STRUCT et DTL ne sont pas disponibles pour les variables API.
Voir aussi
Pour informations sur les types de données disponibles, voir l'aide en ligne de STEP 7, mot-
clé : "Présentation des types de données valides".
Serveur Web
Pages Web
3.11 Tables de visualisation
Tables de visualisation
Le contenu des tables de visualisation configurées et pouvant être utilisées sur le Web est
affiché par le navigateur sur la page Web de même nom.
Remarque
Notez que vous pouvez visualiser dans le serveur Web au maximum 50 tables de
visualisation configurées dans STEP 7.
Chacune de ces tables est représentée avec un maximum de 200 entrées dans le serveur
Web.
Si vous visualisez un grand nombre de tables de visualisation de grande taille sur le serveur
Web, le temps d'actualisation est susceptible de s'élever en raison des grandes quantités de
données.
Le nombre de tables de visualisation que vous pouvez charger dans la CPU dépend aussi
de la taille de la carte mémoire SIMATIC utilisée.
Figure 3-48 Tables de visualisation
① Sélection
Dans la liste déroulante, vous sélectionnez l'une des tables de visualisation configurées.
② "Nom"
Ce champ d'info affiche le nom symbolique de la variable.
Serveur Web
Pages Web
③ "Adresse"
L'adresse absolue des variables est représentée à l'intérieur de ce champ d'information (si
disponible, p.ex. pour les entrées ou sorties ; les variables DB dans des blocs avec accès
optimisé n'ont pas d'adresse absolue).
④ "Format"
Dans la liste déroulante, vous sélectionnez le format d'affichage de la variable
correspondante.
⑤ "Valeur"
Cette colonne affiche les valeurs dans le format d'affichage correspondant.
⑥ "Modifier la valeur"
Dans cette colonne, vous pouvez modifier la valeur des variables et les écrire dans la CPU.
Pour pouvoir lire des valeurs et écrire des valeurs dans la CPU, vous devez avoir configuré
dans STEP 7 un utilisateur avec les droits d'accès correspondants.
Si la valeur que vous avez saisie n'est pas valide (p.ex. valeur binaire dans un champ
BOOL), la saisie n'est pas validée et le champ de saisie correspondant reste vide. Une
signalisation en retour spécifique ne sera pas émise pour cela.
Remarque
De manière générale, le principe suivant s'applique : Afin de pouvoir écrire des données, la
transmission "Referrer" doit être activée dans votre navigateur Internet (cela est paramétré
par défaut dans tous les navigateurs courants).
Veillez à ce que les commentaires s'affichent dans la langue de projet de STEP 7 qui est
actuellement attribuée à la langue de l'interface utilisateur du serveur Web. Pour l'affectation
de langues de projet aux langes d'interface utilisateur, voir le chapitre Paramétrages de la
langue (Page 29).
Voir aussi
Pour informations sur les types de données disponibles, voir l'aide en ligne de STEP 7,
mot-clé : "Présentation des types de données valides".
Serveur Web
Pages Web
3.12 Sauvegarde en ligne
Sauvegarde et restauration de la configuration de la CPU

Avec les droits d'accès appropriés, vous pouvez sauvegarder la configuration d'une CPU
avec le serveur Web. Vous pourrez si nécessaire restaurer cette configuration
ultérieurement, également avec le serveur Web.
Vous pouvez créer autant de sauvegardes que vous le souhaitez et disposer ainsi de
différentes configurations pour une CPU.
IMPORTANT
Avant toute restauration de la configuration de la CPU, effectuez toujours une sauvegarde

en ligne de la configuration actuelle de la CPU et enregistrez ce fichier de sauvegarde
(fichier Backup) dans un dossier local de votre PC.
Ainsi, vous vous assurez de pouvoir annuler une restauration qui aurait échoué (p.ex. en
raison d'un fichier de sauvegarde corrompu) ou qui ne présenterait pas le résultat
escompté.
Remarque
Vous pouvez également effectuer la sauvegarde en ligne et la restauration de la
configuration de la CPU dans STEP 7 (voir l'aide en ligne de STEP 7, mot-clé : "Créer une
sauvegarde d'une CPU S7").
Lors d'une sauvegarde avec STEP 7, le fichier de sauvegarde est enregistré dans le projet
STEP 7. Lors d'une sauvegarde avec le serveur Web, le fichier de sauvegarde est enregistré
dans un dossier local de votre PG/PC (p. ex. dossier "Téléchargements"). Les fichiers de
sauvegarde du serveur Web ne peuvent être restaurés avec STEP 7 et les fichiers de
sauvegarde STEP 7 ne peuvent être restaurés directement avec le serveur Web.
Afin de restaurer un fichier de sauvegarde STEP 7 avec le serveur Web, enregistrez d'abord
le fichier de sauvegarde STEP 7 dans un dossier local de votre PG/PC (p. ex. dossier
"Téléchargements"). Là, vous pouvez restaurer la sauvegarde avec le serveur Web.
Remarque
La fonction "Sauvegarde en ligne" n'est pas disponible si vous accédez au serveur web via :
• une adresse IP virtuelle
• un module de communication (CM)
• un processeur de communication (CP)
Conditions requises
● Vous accédez à la CPU via le protocole sécurisé de transmission "HTTPS".
● Un certificat valide signé par une CA est installé dans le navigateur Web, voir le chapitre
Configuration du serveur Web (Page 19).
Serveur Web
Pages Web
Sauvegarde en ligne
Figure 3-49 Sauvegarde en ligne
Effectuer une sauvegarde en ligne de la configuration

Procédez comme suit pour effectuer une sauvegarde en ligne de la configuration de la
CPU :
1. Dans la zone "Sauvegarde API", cliquez sur le bouton "Créer une sauvegarde en ligne".
2. Si la CPU se trouve alors à l'état MARCHE, le message suivant s'affiche :
"La création d'une sauvegarde en ligne requiert l'arrêt de la CPU. Voulez-vous faire
commuter la CPU sur ARRET ? "
Confirmez le message en cliquant sur "OK". La CPU passe à l'état de fonctionnement
ARRET et la sauvegarde en ligne est effectuée. (Si vous cliquez sur "Annuler", la CPU
reste à l'état de fonctionnement dans lequel elle se trouve et la sauvegarde en ligne est
annulée.)
3. Sauvegardez le fichier de sauvegarde (fichier Backup) dans un répertoire local de votre
PC.
4. Placez de nouveau la CPU à l'état de fonctionnement MARCHE (bouton "RUN" dans la
zone "Panneau de commande de la CPU" de la page d'accueil).
Remarque
Pendant l'exécution de la sauvegarde en ligne, certaines données ne sont pas disponibles
dans la vue des pages Web du serveur web.
Serveur Web
Pages Web
Étendue de la sauvegarde
La sauvegarde comprend toutes les données qui sont nécessaires pour rétablir un état défini
de la CPU, c'est-à-dire la combinaison spécifique de la configuration paramétrée de la CPU
avec les valeurs actuelles des données rémanentes concernant l'utilisateur.
Les données suivantes de la configuration paramétrée de la CPU sont sauvegardées :
● Les contenus de la SIMATIC Memory Card, p. ex. configuration, code de programme,
recettes et archives, DataLogs
Les données rémanentes suivantes concernant l'utilisateur sont sauvegardées :
● Zone de mémoire rémanente des blocs de données, mémentos, compteurs et
temporisations
● Paramètres de l'unité de commande, données dynamiques de configuration IP, compteur
d'heures de fonctionnement, données capteurs Motion Control rémanentes
Notez bien ceci :
● Les entrées du tampon de diagnostic ne font pas partie de la sauvegarde.
● L'heure actuelle n'est pas sauvegardée sur une CPU SIMATIC S7-1500.
● Le contenu intégral de la SIMATIC Memory Card est sauvegardé, c'est-à-dire toutes les
données enregistrées sur la carte (p. ex. fichiers PDF, fichiers GSD).
● Le fichier de sauvegarde reçoit le nom de la CPU et du projet avec l'heure et la date de la
sauvegarde, p. ex. "2015-09-10_11-01_03_online
backup_PLC69_machineControl.s7pbkp".
● Le fichier de sauvegarde d'une CPU F contient en outre la signature globale du
programme de sécurité dans le nom du fichier. Vérifiez s'il s'agit de la signature globale F
attendue.
● Il est possible de renommer la sauvegarde, mais toutefois impossible d'en modifier les
contenus.
Serveur Web
Pages Web
Restaurer une configuration

Procédez comme suit pour effectuer une restauration de la configuration de la CPU :
1. Saisissez le cas échéant le mot de passe de l'utilisateur actuellement connecté dans la
zone "Restauration de l'API".
2. Cliquez sur le bouton "Sélectionner le fichier" et sélectionnez le fichier de sauvegarde de
la configuration que vous voulez restaurer.
3. Cliquez sur le bouton "Charger la sauvegarde en ligne".
4. Si la CPU se trouve à l'état de fonctionnement RUN, le message suivant s'affiche :
"Charger la sauvegarde en ligne dans l'appareil. La CPU passe à l'état de
fonctionnement STOP et le contenu de la CPU est écrasé. Voulez-vous vraiment lancer
l'opération ?"
Si la CPU se trouve déjà à l'état de fonctionnement STOP, le message suivant s'affiche :
"Charger la sauvegarde en ligne dans l'appareil. Le contenu de la CPU est écrasé.
Voulez-vous vraiment lancer l'opération ?"
Confirmez le message en cliquant sur "OK". La CPU passe le cas échéant à l'état de
fonctionnement STOP et la sauvegarde en ligne est chargée. (Si vous cliquez sur
"Annuler", la CPU reste à l'état de fonctionnement dans lequel elle se trouve et le
chargement est annulé.)
5. Un message vous informe que la page Web ne doit pas être quittée pendant l'opération
de restauration. Confirmez le message en cliquant sur "OK".
La restauration de la configuration de la CPU commence et vous êtes informé de l'état
actuel :
– "Le chargement de la sauvegarde en ligne a été lancé."
– "Le fichier de sauvegarde est vérifié."
– "La carte mémoire est formatée et la CPU réinitialisée."
Serveur Web
Pages Web
6. Si vous avez lancé l'opération de restauration avec l'un des noms d'utilisateur et mot de
passe définis dans la configuration du serveur Web, il vous sera demandé de les saisir
de nouveau après une réinitialisation réussie de la CPU. Saisissez les informations
souhaitées et cliquez sur "Login".
Si vous avez lancé l'opération de restauration comme utilisateur "Everybody" sans mot
de passe (mais avec le droit d'accès approprié), cette demande de saisie n'apparaît pas.
Remarque
Pour la restauration de la configuration d'une CPU F dont le programme de sécurité et/ou
mot de passe pour la CPU F ont été entre-temps modifiés, vous avez également besoin
du droit d'accès "Modifier en tant qu'Admin F", voir le paragraphe "Compléter la gestion
des utilisateurs" au chapitre Configuration du serveur Web (Page 19).
ATTENTION
Sur un serveur Web non protégé par un mot de passe (utilisateur "Everybody" ou "Tout
le monde"), l'autorisation "Modifier en tant qu'Admin F " est prévue uniquement à des
fins de test, de mise en service, etc. Cela signifie que ce n'est le cas que lorsque
l'installation n'est pas en mode productif. Dans ce cas, vous devez vous assurer de la
sécurité de l'installation en prenant d'autres mesures organisationnelles, p. ex. par des
protections d'accès physiques.
Avant le passage en mode productif, vous devez retirer le droit "Modifier en tant
qu'Admin F" pour la catégorie d'utilisateur "Everybody" ou "Tout le monde".
Le mot de passe de l'utilisateur du serveur Web possédant le droit "Modifier en tant
qu'Admin F" ne doit être accessible qu'aux personnes autorisées.
La restauration de la configuration de la CPU se poursuit et vous recevrez les messages

d'état au cours de la procédure :
– "La configuration est chargée."
– "La CPU est réinitialisée."
Cela peut prendre quelques minutes.
7. Lorsque la procédure est achevée, vous êtes déconnecté et le bouton "Charger de
nouveau la page..." apparaît.
Si vous ne recevez aucun message d'erreur au cours de la procédure de restauration,
cela signifie que la restauration de la configuration de la CPU s'est déroulée correctement
et vous recevrez un message correspondant.
Cliquez sur le bouton "Charger de nouveau la page..." et connectez-vous avec le nom
d'utilisateur et le mot de passe de la configuration de la CPU récemment chargée.
Serveur Web
Pages Web
3.13 Enregistrement
Vous recevrez le message d'erreur suivant si :

– la configuration de la CPU récemment chargée ne comporte pas la même adresse IP
de la CPU que la précédente
– le serveur Web de la configuration de la CPU récemment chargée est désactivé
– le navigateur ne reçoit aucune réponse de la CPU après 3 minutes
Message d'erreur : "La CPU n'est plus accessible. Veuillez vérifier l'adresse IP et la
configuration du serveur Web. Le résultat de la restauration peut être vérifié dans
ASLog."
3.13 Enregistrement
Fonction Trace et analyseur logique

Avec la fonction Trace et analyseur logique, vous enregistrez des variables d'un appareil et
vous exploitez les enregistrements. Les variables sont par ex. les paramètres d'entraînement
ou les variables système et utilisateur d'une CPU.
Les enregistrements sont stockés sur l'appareil et les utilisateurs disposant du droit d'accès
correspondant peuvent les lire et les stocker avec le serveur Web. Cette fonction Trace et
analyseur logique permet donc de superviser des processus extrêmement dynamiques dans
le serveur Web.
Conditions requises
● Une configuration Trace est créée, c.-à-d. que vous avez défini les conditions
d'enregistrement et de déclenchement et sélectionné les signaux à enregistrer.
– Notez bien ceci : La page Web "*Enregistrement" ne vous permet d'afficher que les
mesures qui sont stockées sur la SIMATIC Memory Card.
Pour que la CPU stocke les mesures sur la SIMATIC Memory Card, il faut définir les
paramètres suivants dans la configuration Trace dans STEP 7 :
1. Réglez le "Mode de déclenchement" sur "Déclenchement sur variable".
2. Activez la case d'option "Enregistrement des mesures dans l'appareil (carte
mémoire)".
● Vous avez transféré la configuration Trace dans l'appareil et l'avez activée à cet endroit.
● Vous avez affecté le droit d'accès "L'utilisateur est autorisé à..." > "...consulter le
diagnostic" dans la gestion des utilisateurs du serveur Web ; voir chapitre Configuration
du serveur Web (Page 19).
Mémoire requise pour le stockage d'enregistrements Trace

La fonction "Enregistrement des mesures dans l'appareil (carte mémoire)" dans STEP 7
stocke les enregistrements Trace sur votre SIMATIC Memory Card.
Serveur Web
Pages Web
3.13 Enregistrement
Comportement quand le nombre est atteint

Le paramètre "Désactiver enregistrement" répète les mesures jusqu'à ce que le "Nombre de
mesures" paramétré soit atteint.
Le paramètre "Écraser l'enregistrement le plus ancien" remplace la plus ancienne mesure
par la mesure la plus récente lorsque le "Nombre de mesures" paramétré est atteint. Notez
toutefois que l'écriture continue de données sur la SIMATIC Memory Card en réduit la durée
de vie.
Figure 3-50 Boîte de dialogue des paramètres pour le stockage de mesures sur la carte mémoire dans STEP 7
Nombre de mesures
La CPU prend en charge un nombre maximal de 999 mesures. Pendant qu'elle écrit les
enregistrements Trace dans la mémoire de chargement de la carte mémoire, la CPU
interrompt la vérification des conditions de déclenchement pour la tâche Trace. Une fois le
stockage des enregistrements Trace terminé, la CPU reprend la vérification des conditions
de déclenchement.
IMPORTANT
Espace mémoire requis sur la SIMATIC Memory Card
Si la fonction Trace "Mesures dans l'appareil (carte mémoire)" requiert plus d'espace libre
qu'il n'y en a sur la SIMATIC Memory Card, cela peut avoir des effets indésirables.
Assurez-vous d'avoir toujours assez d'espace mémoire libre lorsque vous utilisez la
fonction "Mesures dans l'appareil (carte mémoire)".
Outre la fonction Trace "Mesures dans l'appareil (carte mémoire)", d'autres fonctions,
comme par exemple l'archivage de DataLogs, occupent de l'espace mémoire sur la
SIMATIC Memory Card. Dans tous les cas, assurez-vous d'avoir assez d'espace mémoire
libre pour toutes les fonctions gourmandes de mémoire.
La page Web "Diagnostic" indique, dans l'onglet "Mémoire", les valeurs actuelles concernant
la place mémoire utilisée dans la mémoire de chargement.
L'interface de la page Web "Trace" s'utilise en majeure partie comme la fonction Trace dans
STEP 7. À ce sujet, voir la description fonctionnelle Utilisation de la fonction Trace et
analyseur logique (https://support.industry.siemens.com/cs/ww/fr/view/64897128) et l'aide en
ligne de STEP 7.
Serveur Web
Pages Web
3.13 Enregistrement
Affichage des enregistrements Trace

La page Web de la fonction Trace et analyseur logique comporte plusieurs zones. La figure
suivante montre à titre d'exemple le partage de l'interface dans le serveur Web après le
premier appel de la page Web "Trace".
① Enregistrements Trace
② Barre d'outils du diagramme de courbes
③ Diagramme de courbes et pistes de bit
④ Tables de signaux
Figure 3-51 Page d'accueil Trace sans mesure
Serveur Web
Pages Web
3.13 Enregistrement
Ouvrir les mesures

Pour ouvrir une mesure, sélectionnez-la par un clic droit dans la zone "Enregistrements
Trace". Sélectionnez ensuite la commande "Afficher dans diagramme" dans le menu
contextuel.
La mesure s'affiche dans la zone "Diagramme de courbes et pistes de bit".
Figure 3-52 Afficher une mesure individuelle
Pour afficher simultanément plusieurs mesures, sélectionnez une mesure par un clic droit
dans la zone "Enregistrements Trace". Sélectionnez ensuite la commande "Ajouter à la
table" dans le menu contextuel.
Les mesures s'affichent dans la zone "Diagramme de courbes et pistes de bit".
Figure 3-53 Afficher plusieurs mesures
Serveur Web
Pages Web
3.13 Enregistrement
Enregistrements Trace
La zone "Enregistrements Trace" affiche la liste de toutes les mesures disponibles, triées par
date et heure. Une mesure se compose toujours d'une configuration Trace et d'un
enregistrement correspondant.
Le tableau suivant présente les commandes de menu contextuel spécifiques au serveur
Web dans la zone des enregistrements Trace :
Tableau 3- 7 Commandes de menu contextuel du serveur Web dans la zone des enregistrements Trace
Commande du menu contextuel Description

"Supprimer" Supprime la mesure sélectionnée de la carte mémoire de la CPU. Une boîte de dia-
logue de confirmation s'ouvre.
Après la suppression, l'affichage dans le diagramme de courbes n'est pas écrasé
automatiquement.
"Enregistrer sous" Enregistre la mesure sélectionnée.
"Afficher dans le diagramme" Charge la mesure sélectionnée dans la zone d'affichage du serveur Web.
"Ajouter au tableau" Ajoute la mesure sélectionnée dans la table sous l'onglet "Mesures".
Quelques types de données permettent l'affichage des différentes pistes de bit. Activez les
différentes pistes de bit avec le symbole du signal ouvert dans la table de signaux.
Vous pouvez modifier la représentation des signaux dans la table de signaux et à l'aide de la
barre d'outils du diagramme de courbes.
Figure 3-54 Mesure Trace - toutes les zones sont visibles
Serveur Web
Pages Web
3.13 Enregistrement
Barre d'outils du diagramme de courbes

Les boutons de la barre d'outils du diagramme de courbes mettent à votre disposition,
comme dans STEP 7, des outils pour modifier la représentation.
Le tableau ci-dessous énumère les boutons du serveur Web dans la barre d'outils du
diagramme de courbes :
Tableau 3- 8 Boutons de la barre d'outils du diagramme de courbes
Icône Fonction Description

Ouvrir/ajouter une mesure Ouvre des mesures ou ajoute une mesure à une mesure exis-
tante.
Enregistrer sous Stocke une mesure/des mesures sous forme de fichier avec l'ex-
tension .csv, .wtrc (format SIMOTION pour le stockage de don-
nées Trace) ou .ttrecx (format TIA Portal pour le stockage de
données Trace).
Cette commande stocke non seulement les données de la me-
sure, mais aussi le diagramme, les instantanés, le marquage et les
signaux calculés.
Annuler déplacement/zoom Annule la dernière fonction de déplacement/zoom exécutée. Si
vous avez exécuté plusieurs fonctions de déplacement/zoom,
vous pouvez les annuler l'une après l'autre.
Répéter déplacement/zoom Répète la dernière fonction de déplacement/zoom annulée. Si
vous avez annulé plusieurs fonctions de déplacement/zoom, vous
pouvez les répéter l'une après l'autre.
Instantané Enregistre la vue actuelle sous forme d'instantané (voir para-
graphe "Paramètres et affichages de l'icône Instantané").
Décaler l'affichage Décale l'affichage avec bouton de la souris enfoncé - équivaut au
bouton dans STEP 7.
Sélection du zoom Sélectionne une zone quelconque avec bouton de la souris enfon-
cé. Ce bouton met l'affichage à l'échelle de la zone sélectionnée.
Sélection de la zone à agrandir verti- Sélection d'une zone verticale avec bouton de la souris enfoncé.
calement Ce bouton met l'affichage à l'échelle de la zone sélectionnée.
Sélection de la zone à agrandir hori- Sélectionne une zone horizontale avec bouton de la souris enfon-
zontalement cé. Ce bouton met l'affichage à l'échelle de la zone sélectionnée.
Agrandir Agrandit l'affichage. Chaque clic sur ce bouton réduit les plages
des axes X et Y. Les courbes sont représentées agrandies.
Réduire Réduit l'affichage. Chaque clic sur ce bouton agrandit les plages
des axes X et Y. Les courbes sont représentées réduites.
Mise à l'échelle Met à l'échelle verticalement et horizontalement tous les signaux
ou bien seulement un signal/groupe de signaux.
Restaurer la vue standard Ce bouton annule les mises à l'échelle et les déplacements. La
vue change d'état au moment du chargement de la mesure. Les
signaux non affichés sont également réinitialisés, mais restent
désactivés.
Afficher tout Ce bouton transfère l'intégralité des signaux dans la zone d'affi-
chage sans modifier la position relative des signaux entre eux.
Mise à l'échelle automatique X Mise à l'échelle automatique de tous les signaux visibles dans la
plage horizontale X.
Serveur Web
Pages Web
3.13 Enregistrement

Mise à l'échelle automatique Y Mise à l'échelle automatique de tous les signaux visibles dans la
plage verticale Y.
Disposer en pistes Activer ou désactiver la disposition en pistes.
Avec la disposition en pistes activée, les signaux sont disposés les
uns sous les autres avec les axes de valeurs respectifs.
Les groupes de signaux s'affichent dans la même piste.
Ce réglage n'a pas d'effet sur l'affichage des pistes de bit.
/ Changement d'unité de l'axe du Commute l'unité de l'axe du temps (axe X).
temps Vous pouvez régler les unités suivantes :
• Points de mesure
• Durée (durée relative par rapport à l'instant de déclenchement)
• Horodatage des points de mesure
Afficher les points de mesure Ce bouton affiche les points de mesure sous forme de petits
cercles sur les courbes.
/ Activer/désactiver l'interpolation Ces boutons permettent d'activer et de désactiver l'interpolation
des données du diagramme de courbes.
Grille Ce bouton active ou désactive la grille du diagramme de courbes
et règle sa luminosité entre les niveaux 1 à 9.
Curseur de mesure vertical Affiche les curseurs de mesure verticaux.
Avec la souris, vous pouvez déplacer la position verticale des
deux curseurs de mesure.
Les valeurs des signaux et la différence entre deux points de me-
sure s'affichent dans la table des signaux pour tous les signaux
visibles et en plus dans le diagramme de courbes pour le signal
sélectionné.
Le point de mesure ou l'instant relatif/absolu des curseurs de me-
sure s'affiche dans la fenêtre jaillissante déplaçable "Points de
mesure/Valeurs de temps" selon l'unité réglée pou l'axe de temps
(axe X).
Curseur de mesure horizontal Affiche les curseurs de mesure horizontaux.
Avec la souris, vous pouvez déplacer la position horizontale des
deux curseurs de mesure.
Les valeurs Y des curseurs de mesure pour le signal sélectionné
s'affichent dans la fenêtre jaillissante déplaçable "Valeurs Y".
Différence des curseurs de mesure Affiche la différence des curseurs de mesure horizontaux et verti-
caux et des valeurs Y aux intersections avec les curseurs de me-
sure verticaux.
Afficher la légende Affiche ou masque la légende dans le diagramme de courbes et
dans les désignations de pistes de bit.
Justifier la légende à gauche Affiche la légende et les désignations de pistes de bit sur le côté
gauche du diagramme de courbes.
Justifier la légende à droite Affiche la légende et les désignations de pistes de bit sur le côté
droit du diagramme de courbes.
Serveur Web
Pages Web
3.13 Enregistrement

Changer la couleur d'arrière-plan Commute entre différentes couleurs d'arrière-plan.
Sélection Place une marque graphique et donne une vue d'ensemble des
zones de signaux marquées.
Notez que seuls les signaux analogiques et réels peuvent être
marqués (pas les signaux calculés).
Toutes les icônes de la barre d'outils sont dotées d'info-bulles.
Diagramme de courbes
Le diagramme de courbes affiche les signaux sélectionnés d'un enregistrement. Les bits
sont représentés dans la partie inférieure du diagramme sous forme de pistes de bit.
① Enregistrements Trace (réduits)

② Barre d'outils du diagramme de courbes
③ Diagramme de courbes et pistes de bit
④ Table des signaux (réduite)
Figure 3-55 Mesure Trace - seul le diagramme de courbes est visible
Serveur Web
Pages Web
3.13 Enregistrement
Le tableau suivant présente les commandes de menu contextuel spécifiques au serveur

Web pour un signal sélectionné dans le diagramme de courbes :
Tableau 3- 9 Commandes de menu contextuel du serveur Web dans la zone du diagramme de courbes

"Mise à l'échelle automatique Y " Met à l'échelle automatiquement le signal sélectionné dans le sens Y.
"Masquer signal" Masque le signal sélectionné dans le diagramme de courbes.
Utilisation du diagramme de courbes

Vous pouvez zoomer à volonté dans la zone de représentation. À l'aide de curseurs de
mesure (voir "② Barre d'outils du diagramme de courbes"), vous sélectionnez différentes
valeurs pour les afficher dans la table de signaux.
La figure ci-dessous vous montre comment utiliser les règles et les barres de défilement
pour modifier au besoin la zone de représentation du diagramme de courbes.
① Règle verticale
② Barre de défilement verticale
③ Règle horizontale
④ Barre de défilement horizontale
Figure 3-56 Mesure Trace - règles et barres de défilement
Serveur Web
Pages Web
3.13 Enregistrement
Utilisation de la règle verticale

● Lorsque vous cliquez en haut ou en bas sur la règle verticale, vous agrandissez
l'affichage en haut ou en bas.
● Un clic en haut ou en bas sur la règle verticale avec la touche Majuscule enfoncée
permet de mettre à l'échelle les deux côtés.
● Un clic en haut ou en bas sur la règle verticale avec la touche Ctrl enfoncée permet de
décaler l'affichage vers le haut ou vers le bas.
Utilisation de la règle horizontale

● Lorsque vous cliquez à gauche ou à droite sur la règle horizontale, vous agrandissez
l'affichage à gauche ou à droite.
● Un clic en haut ou en bas sur la règle horizontale avec la touche Majuscule enfoncée
permet de mettre à l'échelle les deux côtés.
● Un clic à gauche ou à droite sur la règle horizontale avec la touche Ctrl enfoncée permet
de décaler l'affichage vers la gauche ou vers la droite.
Utilisation de la molette de la souris

● Lorsque vous actionnez la molette de la souris dans l'affichage, vous décalez l'affichage
vers le haut ou vers le bas.
● Lorsque vous actionnez la molette de la souris dans l'affichage avec la touche Majuscule
enfoncée, vous décalez l'affichage vers la gauche ou vers la droite.
● Lorsque vous actionnez la molette de la souris dans l'affichage avec la touche Ctrl
enfoncée, vous agrandissez/réduisez l'affichage à la position du pointeur de la souris.
Tables de signaux
Les tables de signaux énumèrent les signaux de la mesure sélectionnée et permettent de
régler quelques propriétés. La zone des tables de signaux se divise en trois onglets
"Mesures", "Signaux" et "Signal calculé".
Réglages et affichages dans l'onglet "Signaux"

La figure ci-dessous montre la table des signaux de l'onglet "Signaux".
Figure 3-57 Affichage dans l'onglet "Signaux"
Serveur Web
Pages Web
3.13 Enregistrement
Le tableau ci-dessous montre les réglages et les affichages des signaux enregistrés de
l'onglet "Signaux" :
Colonne Description
Symbole de signal
ou d'erreur
Symbole de signal
Symbole pour signaux calculés (formules)
Sélection pour affichage dans le diagramme de courbes
Ce point indique que, pour ce signal, un bit au moins est sélectionné pour affichage comme piste de
bit.
Numéro de signal Numéro du signal généré automatiquement
Le numéro de signal vous permet d'accéder au signal dans les formules.
Nom Affichage du nom de signal
Un clic sur le nom d'un signal affiché actualise l'échelle dans le diagramme de courbes.
Ouvrir la sélection de bits
Pour les types de données suivants, vous pouvez aussi sélectionner des bits individuels pour les
afficher comme pistes de bit dans le bas du diagramme de courbes :
• Byte, Word, DWord, LWord
• SInt, USInt, Int, UInt, DInt, UDInt, LInt, ULInt
Exemple de sélection de bits ouverte pour le type de données DWord :
Cliquez sur le symbole pour sélectionner ou désélectionner le bit respectif pour l'affichage.
Type de données Affichage du type de données
Adresse Affichage de l'adresse du signal
Ce champ reste vide pour les variables optimisées/typiques.
Couleur Affichage et possibilité de réglage de la couleur du signal
Groupe de signaux Affichage ou saisie du nom d'un groupe de signaux
Tous les signaux d'un groupe ont la même échelle Y.
Saisissez le même nom de groupe pour tous les signaux que vous souhaitez mettre à la même
échelle.
Pour retirer des signaux d'un groupe de signaux :
• Supprimez le nom du groupe.
• Cliquez sur l'entrée vide dans le menu contextuel du groupe.
Notez qu'il n'est pas possible de regrouper des signaux binaires.
Serveur Web
Pages Web
3.13 Enregistrement
Colonne Description
Champ gris pour le Placez le pointeur de la souris sur le champ gris ou le symbole de chaîne ( ou ) pour ajouter
symbole de chaîne le signal à un groupe de signaux ou pour le supprimer du groupe de signaux.
du groupe de si- Un clic sur le symbole de chaîne ajoute le signal à un groupe de signaux ou crée un nouveau
gnaux groupe de signaux.
Un clic sur le symbole de chaîne supprime le signal du groupe de signaux.
Pour un signal sélectionné avec groupe de signaux, le symbole de chaîne affiche tous les si-
gnaux du même groupe.
Champ de saisie du Le champ de saisie affiche le nom du groupe de signaux. Au lieu d'utiliser le symbole de chaîne,
groupe de signaux vous pouvez saisir du texte dans ce champ pour affecter ou supprimer un nom de groupe.
Échelle Y min. Affichage ou saisie de la valeur minimale pour la mise à l'échelle du signal
Échelle Y max. Affichage ou saisie de la valeur maximale pour la mise à l'échelle du signal
Commentaire Affichage et possibilité de saisie d'un commentaire relatif au signal
Y(t1) Affichage de la valeur à la position du premier curseur de mesure
Y(t2) Affichage de la valeur à la position du deuxième curseur de mesure
ΔY Affichage de la différence de valeur entre le premier et le deuxième curseur de mesure
Le tableau ci-dessous présente les éventuelles commandes de menu contextuel du serveur

Web dans l'onglet "Signaux" :
Tableau 3- 10 Commandes de menu contextuel du serveur Web dans l'onglet "Signaux"

"Mise à l'échelle automatique Y " Mise à l'échelle automatique du signal sélectionné dans le sens Y
"Afficher signal" Affiche le signal dans le diagramme de courbes
"Masquer signal" Masque le signal dans le diagramme de courbes
"Afficher tous les bits" Affiche tous les bits d'un signal
"Masquer tous les bits" Masque tous les bits d'un signal
"Utiliser pour le signal détecté" Calcule un nouveau signal sur la base du signal réel choisi
"Éditer le signal calculé" Active le signal calculé sélectionné dans le mode édition
"Supprimer le signal calculé" Supprime le signal calculé sélectionné.
Serveur Web
Pages Web
3.13 Enregistrement
Réglages et affichages dans l'onglet "Mesures"

La figure ci-dessus représente l'onglet "Mesures" et le menu contextuel de la colonne
"Alignement" d'une mesure sélectionnée :
Figure 3-58 Onglet "Mesures" avec menu contextuel
Serveur Web
Pages Web
3.13 Enregistrement
Le tableau suivant présente les réglages et affichages pour les mesures :
Colonne Description
Alignement des mesures
Déclenchement/échantillon Alignement des mesures sur le déclenchement ou le point de mesure.
L'origine individuelle de la mesure est déterminée dans la colonne "Alignement" du ta-
bleau.
Horodatage (temps absolu) Alignement des mesures sur leur horodatage.
Les signaux sont alignés sur l'heure de l'horodatage absolu.
Colonnes de la table
Affichage statique du symbole de mesure
Nom Affichage et possibilité de modification du nom.

Notez que ce nom doit être univoque.
Alignement Alignement de la mesure (réglable seulement quand la case "Déclenchement/échantillon"
est cochée).
Détermine l'origine individuelle d'une mesure. Tous les signaux de la mesure s'affichent
par rapport à cette origine.
Les réglages suivants sont possibles :
• Déclenchement
• Premier échantillon après l'événement de déclenchement
• Premier échantillon
• Dernier échantillon
Décalage Décalage par rapport à l'axe du temps
Décale la mesure de la valeur indiquée sur l'axe du temps, vers la gauche ou vers la
droite.
Si vous n'écrivez qu'une valeur numérique sans unité de mesure. le système attribuera
automatiquement l'unité "ms" (par ex. 0=0ms, 100=100ms, 1000=1s, -1001=-1s 1ms,
LT#2000ms=2s, LT#-3605000ms=-1h 5s, LT#-1h5s=-1h 5s)
Horodatage Affichage de l'instant de déclenchement
Commentaire Affichage et possibilité de saisie d'un commentaire relatif au signal
Commandes du menu contextuel
"Enregistrer comme fichier Stocke la mesure/les mesures sous forme de fichier avec l'extension .wtrc (format
WTRC" SIMOTION pour le stockage de données Trace) ou .ttrecx (format TIA Portal pour le stock-
age de données Trace)
"Enregistrer comme fichier Stocke la mesure sélectionnée sous forme de fichier avec l'extension .csv.
CSV" Notez que cette commande n'enregistre que les données de la mesure, mais pas le dia-
gramme, les instantanés, la sélection et les signaux calculés.
"Éditer le nom" Fait passer le nom en mode édition
"Éditer le décalage" Fait passer le décalage en mode édition
"Éditer le commentaire" Fait passer le commentaire en mode édition
"Effacer la mesure" Supprime la mesure
Serveur Web
Pages Web
3.13 Enregistrement
Réglages et affichages dans l'onglet "Signal calculé"

Cette fonction vous permet de calculer de nouveaux signaux sur la base de signaux réels.
Pour cela, le système calcule les valeurs Y des points de signal.
Si vous voulez paramétrer les signaux à calculer, ouvrez l'onglet "Signal calculé".
Dans la zone "Général", vous pouvez préciser le nom, le type de données et la couleur d'un
signal à calculer. Notez bien que le nom du signal à calculer doit différer du nom d'un signal
réel.
Figure 3-59 Zone "Général" de l'onglet "Signal calculé"
Dans la zone "Signaux de base", vous ajoutez les signaux sur la base desquels le nouveau
signal sera calculé. Vous pouvez modifier le nom par défaut de la variable dans la colonne
"Nom". Vous sélectionnez des signaux réels dans la colonne "Signal" pour déterminer le
nombre de points de signal virtuels à calculer.
Figure 3-60 Zone "Signaux de base" de l'onglet "Signal calculé"
Dans la zone "Valeur de signal calculée", vous saisissez le code pour le calcul des valeurs Y
des points de signaux. Cette zone est divisée en deux parties :
● Mode de base (expression)
● Mode avancé (JavaScript)
Dans les deux modes, c'est la syntaxe JavaScript que vous utilisez pour saisir le code.
Notez cependant que toutes les fonctions de JavaScript ne sont pas prises en charge.
Serveur Web
Pages Web
3.13 Enregistrement
Mode de base (expression)

Dans ce mode, vous créez votre code en utilisant :
● des expressions JavaScript et des opérateurs stadardisés (par ex. +, -, /, *, %, ~, &, |, ?,
!)
● des bibliothèques mathématiques standardisées
● les noms de variable déterminés sous "Signaux de base"
(le système écrit la valeur Y directement à côté du nom de variable)
Figure 3-61 Mode de base (expression)
Serveur Web
Pages Web
3.13 Enregistrement
Mode avancé (JavaScript)

Ce mode vous offre un éventail de fonctions étendu pour calculer les valeurs Y à l'aide d'un
code JavaScript complexe. Par exemple, vous pouvez déterminer vos propres variables
statiques pour l'itération de sections de code :
Figure 3-62 Mode avancé (JavaScript)
Le tableau ci-dessous présente tous les éléments que vous pouvez utiliser pour votre code :
Mots réservés (respecter la distinction maj/min)

if var Math Array catch typeof unescape
encodeURI in for else break escape delete
Infinity decodeURI do Date case false String
Object continue parseFloat new case true while
return Number parseInt try null isNaN throw
switch default undefined
Opérateurs
% - *= != <= |= &&
!== + -- / > = ||
^ === ++ -= /= >= ==
& ~ += * ! < |
&= ?
Délimiteurs
( ) { } [ ] .
, : ;
Commentaires
/* */
Serveur Web
Pages Web
3.13 Enregistrement
Chaque point de signal se compose des attributs suivants :

1. x (point de mesure)
2. t (temps relatif en millisecondes)
3. y (valeur Y)
4. points (nombre de points de signal disponibles pour le calcul d'un nouveau signal)
En "mode avancé (JavaScript)", vous pouvez accéder aux quatre attributs (par ex. "$1.y",
"$1.t", "$1.x", $1.points[i].y, …).
Les tables de fonctions suivantes vous aideront à écrire des expressions ou du code
complexe en JavaScript. Ces tables de fonctions contiennent les fonctions le plus
fréquemment utilisées :
Figure 3-63 Onglet "Signal calculé" avec table de fonctions
Serveur Web
Pages Web
3.13 Enregistrement
Vous avez en outre la possibilité de générer le code JavaScript d'un signal réel depuis
l'onglet "Signaux". Une autre solution consiste à sélectionner l'un des modèles prédéfinis de
la table de fonctions, à modifier le code et à générer un signal calculé.
Figure 3-64 Signaux réels de l'onglet "Signaux"
La table de fonctions vous propose les modèles suivants :

● Différentiation numérique
● Intégration numérique
● Moyenne arithmétique
Figure 3-65 Modèles
Pour vérifier la syntaxe, cliquez sur l'icône "Vérifier la syntaxe" ou générez le signal en
cliquant sur l'icône dans la barre d'outils. Si le code contient des erreurs, elles s'affichent
en rouge à droite de l'icône "Vérifier la syntaxe". Quand le code est exempt d'erreurs, vous
voyez s'afficher le message "Contrôle de la syntaxe effectué avec succès".
Serveur Web
Pages Web
3.13 Enregistrement
Comment le système procède-t-il au calcul d'un nouveau signal ?

Le système vérifie :
● si vous avez sélectionné au moins un signal de base pour calculer un nouveau signal
● le nom du signal à calculer
● la syntaxe de votre code JavaScript
Ensuite, le système définit le comptage des points de mesure et il exécute le code pour
chaque point de mesure à compter. Dans chaque itération, le système mémorise les points
de mesure du nouveau signal sur la base des quatre attributs suivants :
● Point de mesure
● Temps relatif
● Valeur Y calculée
● Points de signal avec valeurs x, t, y
Une fois le calcul terminé, l'évolution du signal s'affiche.
Exemple de calcul fondé sur un signal de base

Vous utilisez une signal de base unique pour calculer le nouveau signal. Ce signal de base
comprend 1 000 points de mesure.
Dans ce cas, le système exécute mille fois votre code écrit. Le signal calculé se compose
alors de 1 000 points de signal calculés avec les mêmes valeurs x et t, mais avec leurs
propres valeurs Y.
Importer/exporter des paramètres

Vous pouvez importer/exporter certains paramètres (formules, type de calcul, type de signal
et nom de signal). Pour importer des paramètres, cliquez sur l'icône dans la barre d'outils
de l'onglet "Signal calculé". Pour exporter des paramètres, cliquez sur l'icône dans la
barre d'outils de l'onglet "Signal calculé".
Serveur Web
Pages Web
3.13 Enregistrement
Réglages et affichages de l'icône Instantané

Avec l'icône "Instantané" dans la barre d'outils du diagramme de courbes, vous mémorisez
l'évolution momentanée du signal sous forme d'instantané.
Cliquez sur l'icône pour créer un instantané de l'évolution du signal. Pour gérer les
instantanés créés, cliquez sur la flèche à gauche de l'icône "Instantané" et choisissez
l'entrée "Gérer les instantanés".
Figure 3-66 Gestion des instantanés
Le tableau ci-dessous présente les réglages et les affichages de la fenêtre "Gestion des
instantanés".
Colonne Description
Affichage statique du symbole de l'instantané
Nom Affichage et possibilite de modification du nom

Horodatage Affichage de la date/heure de création de l'instantané
Commentaire Affichage et possibilté de saisie d'un commentaire
Le tableau ci-dessous présente les commandes de menu contextuel disponibles :

"Restaurer un instantané" Affiche la mesure dans l'onglet "Diagramme" avec la vue mémorisée.
"Supprimer un instantané" Supprime l'instantané.
"Éditer le nom" Fait passer le nom en mode édition.
"Éditer le commentaire" Fait passer le commentaire en mode édition.
Remarque
Effacer mesure
Lorsque vous supprimez une mesure ou un signal calculé, tous les instantanés
correspondants sont également supprimés.
Serveur Web
Pages Web
3.14 DataLogs
3.14 DataLogs
DataLogs
Sur la page Web DataLogs, vous pouvez afficher tous les DataLogs que vous avez créés.
Vous pouvez trier les DataLogs par ordre croissant ou décroissant selon différents
paramètres.
Cliquez pour cela sur l'un des paramètres dans l'en-tête de colonne :
● Nom
● Taille
● Modifié le
En cliquant sur le nom de fichier, vous pouvez télécharger le fichier DataLog correspondant.
La colonne "Actif" indique si le fichier DataLog respectif est utilisé (est actif) ou pas dans le
programme utilisateur.
Quand le fichier DataLog est actif, vous pouvez l'appeler (le télécharger) et le vider en
cliquant sur . Pour cela, le fichier doit être fermé. Le fichier DataLog vide continue à figurer
dans la liste des DataLogs.
En cliquant sur l'icône dans la colonne "Supprimer", vous supprimez le fichier DataLog.
Pour cela, le fichier doit être fermé.
L'instruction "DataLogClose" vous permet de fermer dans STEP 7 un fichier DataLog ouvert.
Figure 3-67 DataLogs
3.14.1 Lecture automatisée de DataLogs

Outre le téléchargement de différents DataLogs au moyen de l'interface utilisateur du
serveur Web, vous pouvez aussi télécharger, lire et archiver des DataLogs de manière
automatisée. Vous automatisez le téléchargement de DataLogs soit via l'exécution de
scripts, par ex. Bash, soit au moyen de JavaScript sur votre page Web utilisateur.
Un cas d'utilisation typique de cette fonction est la lecture et l'archivage journaliers de
DataLogs à une heure précise depuis une ou plusieurs CPU.
Serveur Web
Pages Web
3.14 DataLogs
Appel des DataLogs de la carte mémoire SIMATIC

Pour que vous puissiez télécharger des DataLogs de manière automatisée de la carte
mémoire SIMATIC de votre CPU, la CPU met à votre disposition une adresse URL au format
suivant :
http[s]://[ip]/DataLogs?Action=List
Affectez à cette adresse URL l'adresse IP correcte de l'interface de votre CPU et utilisez le
protocole de transmission approprié (HTTP ou HTTPS), par ex.
https://192.168.2.132/DataLogs?Action=LIST. Après cela, appelez l'adresse URL dans votre
navigateur ou dans votre interprète de ligne de commande.
L'adresse URL retourne une liste des DataLogs présents sur la carte mémoire SIMATIC.
Chaque entrée énumère l'adresse URL par laquelle vous téléchargez le DataLog
correspondant.
Les différentes adresses URL sont séparées par un saut de ligne <CR><LF> pour faciliter
l'analyse syntaxique de la liste par un interprète de ligne de commande (par ex. Bash) ou par
des langages de programmation basés sur le Web (par ex. JavaScript). Vous trouvez ci-
dessous, à titre d'exemple, la syntaxe de deux adresses URL qui donnent accès aux fichiers
DataLog Test.txt et Test2.txt :
/DataLogs?Path=/DataLogs/Test.txt&Action=DOWNLOAD&E=1<CR><LF>
/DataLogs?Path=/DataLogs/Test2.txt&Action=DOWNLOAD&E=1<CR><LF>
<CR><LF>
Quand l'appel des adresses URL réussit, la CPU retourne le code d'état 200 OK. La CPU
retourne également ce code d'état quand il n'y a pas de DataLogs sur la carte mémoire
SIMATIC.
Remarque
Autorisation d'accès à la CPU pour la lecture de données
Pour pouvoir télécharger des DataLogs de la CPU, l'utilisateur doit disposer de droits en
lecture sur la CPU. Quand il ne dispose pas des droits nécessaires, la CPU retourne le code
d'état 403 FORBIDDEN dans HTTP Response.
Téléchargement des DataLogs au moyen de scripts Bash

L'exemple suivant vous montre comment télécharger des DataLogs de la CPU de manière
automatisée à l'aide d'un script Bash. Remplacez l'adresse URL de l'exemple par l'adresse
IP correcte de l'interface de votre CPU et utilisez le protocole de transmission approprié
(HTTP ou HTTPS).
wget --content-disposition -i
"http://192.168.2.132/DataLogs?Action=LIST"
Serveur Web
Pages Web
3.15 Fichiers utilisateur
Téléchargement des DataLogs au moyen de JavaScript

L'exemple suivant vous montre comment télécharger des DataLogs de manière automatisée
à l'aide de JavaScrip. Remplacez l'adresse URL de l'exemple par l'adresse IP correcte de
l'interface de votre CPU et utilisez le protocole de transmission approprié (HTTP ou HTTPS).
<html>
<head>
<title>DataLog JavaScript Test</title>
<script type="text/javascript" src="jquery-
1.12.4.min.js"></script>
</head>
<body>
<h1>DataLog JavaScript Test</h1>
<div><button id="load">Load DataLogs</button></div>
<div><ul id="list"></ul></div>
<script type="text/javascript">
$('#load').click(function(){
$.get('http://192.168.2.132/DataLogs', {'Action': 'LIST'},
function(data){
$('#list').empty();
$.each(data.split(/\r\n/), function(){
if (this.length == 0) continue;
$('#list').append('<li><a href="http://192.168.2.132' +
this + '">' + this + '</a></li>');
});
});
});
</script>
</body>
</html>
Introduction
Vous lisez et écrivez avec les instructions "FileReadC" (Compact Read Data of a File) et
"FileWriteC" (Compact Write Data to a File) dans les fichiers ASCII de STEP 7 (fichiers au
format binaire).
Serveur Web
Pages Web
Conditions requises
Il faut que vous ayez stocké les UserFiles (fichiers utilisateur) dans le répertoire "UserFiles"
sur la carte mémoire SIMATIC. Vous indiquez le lieu de stockage dans le chemin des
instructions "FileReadC" ou "FileWriteC".
Le chemin et le nom des UserFiles (fichiers utilisateur) doivent être conformes aux règles
suivantes :
● Le nom de fichier ne doit pas excéder 55 caractères
● Les caractères suivants sont autorisés dans les noms de répertoire et de fichier : 0 à 9, a
à z en majuscules et en minuscules, "-" et "_"
● Le nom de chemin ne doit pas commencer par "/", "\" ni "."
● Le nom de chemin ne doit pas contenir ".."
Exemples :
● UserFiles\Lift16_DataBase.txt
● UserFiles\2017-04-13_ErrorLog.bin
Page Web "Fichiers utilisateur"

Le navigateur affiche le contenu du répertoire UserFiles\ de la carte mémoire SIMATIC sur la
page Web "Fichiers utilisateur".
Vous pouvez trier les UserFiles par ordre croissant ou décroissant selon les différents
paramètres.
Pour cela, cliquez sur l'un des paramètres dans l'en-tête de colonne :
● Nom
● Taille
● Modifié le
Vous pouvez télécharger, supprimer, renommer et téléverser les fichiers.
Cliquez sur le nom de fichier pour télécharger le UserFile.
Cliquez sur l'icône pour supprimer le UserFile. Pour cela, le fichier doit être fermé.
Figure 3-68 Vue Fichiers utilisateur
IMPORTANT
UserFiles volumineux
Si vous ouvrez un UserFile volumineux au moyen de cette page Web, il est possible que
les temps d'exécution des instructions qui traitent ce fichier augmentent fortement.
Serveur Web
Pages Web
3.15.1 Lecture ou chargement automatisé de fichiers utilisateur

L'interface utilisateur du serveur Web vous permet d'énumérer, de supprimer, de télécharger
et de charger des UserFiles de manière automatisée. Pour cela, utilisez par exemple
JavaScript ou Bash.
Récupération des fichiers utilisateur de la carte mémoire SIMATIC

Pour obtenir une liste des UserFiles de manière automatisée de la carte mémoire SIMATIC
de votre CPU, la CPU met à votre disposition une adresse URL au format suivant :
http[s]://[ip]/UserFiles?Action=List
Affectez à cette adresse URL l'adresse IP correcte de l'interface de votre CPU et utilisez le
protocole de transmission approprié (HTTP ou HTTPS), par ex.
https://192.168.2.132/UserFiles?Action=LIST. Après cela, appelez l'adresse URL dans
votre navigateur ou dans votre interprète de ligne de commande.
L'adresse URL retourne une liste des UserFiles présents sur la carte mémoire SIMATIC.
Chaque entrée énumère l'adresse URL par laquelle vous pouvez télécharger ou supprimer
le UserFile correspondant depuis la CPU. Les actions à exécuter sont séparées par un tiret
vertical "|".
Les différentes adresses URL sont séparées par un saut de ligne <CR><LF> pour faciliter
l'analyse syntaxique de la liste par des langages de programmation basés sur le Web (par
ex. JavaScript). Vous trouvez ci-dessous, à titre d'exemple, la syntaxe de deux adresses
URL qui donnent accès aux fichiers utilisateur File1.csv et File2.csv :
File1.csv|/UserFiles?Name=File1.csv&Action=DOWNLOAD&E=1|/UserFiles?Name=File1.csv&Acti
on=DELETE&E=1<CR><LF>
File2.csv|/UserFiles?Name=File2.csv&Action=DOWNLOAD&E=1|/UserFiles?Name=File2.csv&Acti
on=DELETE&E=1<CR><LF>
<CR><LF>
Quand l'appel des adresses URL réussit, la CPU retourne le code d'état 200 OK. La CPU
retourne également ce code d'état quand il n'y a pas de fichiers utilisateur sur la carte
mémoire SIMATIC.
Remarque
Autorisation d'accès à la CPU pour la lecture de données
Pour pouvoir télécharger des UserFiles de la CPU, l'utilisateur doit disposer de droits en
lecture sur la CPU. Quand il ne dispose pas des droits nécessaires, la CPU retourne le code
d'état 403 FORBIDDEN dans HTTP Response.
Serveur Web
Pages Web
Chargement de UserFiles sur la carte mémoire SIMATIC

Pour pouvoir charger de manière automatisée des UserFiles sur la carte mémoire SIMATIC,
votre CPU met à votre disposition une adresse URL au format suivant :
http[s]://[ip]/UserFiles?Action=UPLOAD
L'exemple suivant vous montre comment charger un UserFile sur votre page utilisateur
HTML à l'aide de JavaScript.
Remplacez l'adresse URL de l'exemple par l'adresse IP correcte de l'interface de votre CPU
et utilisez le protocole de transmission approprié (HTTP ou HTTPS).
<html>
<head>
<title>UserFiles Upload</title>
</head>
<body>
<form method="POST"
action="https://192.168.2.132/UserFiles?Action=UPLOAD&E=1"
enctype="multipart/form-data">
<input type="file" name="File" />
<input type="submit" />
</form>
</body>
</html>
Si le chargement du UserFiles réussit, la CPU retourne le code d'état 201 CREATED. Si le
UserFile existe déjà sur la carte mémoire SIMATIC, la CPU retourne le code d'état 409
CONFLICT.
Remarque
Autorisation d'accès à la CPU pour le chargement de données
Afin de pouvoir charger les UserFiles dans la CPU, l'utilisateur doit disposer des droits
d'écriture sur la CPU. Quand il ne dispose pas des droits nécessaires, la CPU retourne le
code d'état 403 FORBIDDEN dans HTTP Response.
Téléchargement des UserFiles au moyen de scripts Bash

L'exemple suivant vous montre comment télécharger des UserFiles de la CPU de manière
automatisée à l'aide d'un script Bash. Remplacez l'adresse URL de l'exemple par l'adresse
IP correcte de l'interface de votre CPU et utilisez le protocole de transmission approprié
(HTTP ou HTTPS).
wget --content-disposition -i
"http://192.168.2.132/UserFiles?Action=LIST"
Serveur Web
Pages Web
Téléchargement des UserFiles via JavaScript

L'exemple suivant vous montre comment télécharger des UserFiles de manière automatisée
à l'aide de JavaScript. Remplacez l'adresse URL de l'exemple par l'adresse IP correcte de
l'interface de votre CPU et utilisez le protocole de transmission approprié (HTTP ou HTTPS).
<html>
<head>
<title>UserFiles JavaScript Test</title>
<script type="text/javascript" src="jquery-
1.11.2.min.js"></script>
</head>
<body>
<h1>UserFiles JavaScript Test</h1>
<div><button id="load">Load UserFiles</button></div>
<table
border="1"><thead><th>Name</th><th>Operation</th></thead><tbody
id="list"></tbody></div>
<div><form method="POST"
action="http://192.168.2.132/UserFiles?Action=UPLOAD&E=1"
enctype="multipart/form-data"><input type="file" name="File"
/><input type="submit" /></form></div><br>
<script type="text/javascript">
function Delete(url) {
$.post('http://192.168.2.132/UserFiles' + url, {}, function(){
$('#load').click();
});
}
$('#load').click(function(){
$('#list').empty();
$.get('http://192.168.2.132/UserFiles', {'Action': 'LIST'},
function(data){
$.each(data.split(/\r\n/), function(){
var data = this.split("|");
if (data.length == 3)
$('#list').append('<tr><td>'+decodeURIComponent(data[0])+'</td><td><
a href="http://192.168.2.132'+data[1]+'">Download</a><br><button
type="button"
onclick="Delete(\''+data[2]+'\')">Delete</button></td></tr>');
});
});
});
</script>
</body>
</html>
Serveur Web
Pages Web
3.16 Pages utilisateur
Pages utilisateur
La zone "Pages utilisateur" du serveur Web vous permet de charger vos propres pages
HTML pour la lecture de données du système cible.
Figure 3-69 Pages utilisateur
Vous éditez les pages dans un éditeur HTML de votre choix, générez des blocs de données
(Web-Control-DB et DB de fragment) dans STEP 7 et vous les chargez dans la CPU.
L'instruction "WWW" synchronise le programme utilisateur avec le serveur Web sur la CPU
et initialise le serveur Web. Avec le premier appel de l'instruction "WWW", le lien vers la
page utilisateur s'affiche sur la page Web de la CPU. En cliquant sur le lien, la page
utilisateur démarre dans une nouvelle fenêtre.
Remarque
Il est possible d'influencer les paramètres de processus et donc le fonctionnement de la
CPU par des accès en écriture aux pages utilisateur.
Attribuez toujours, dans la gestion des utilisateurs, un mot de passe aux utilisateurs ayant
accès en écriture aux pages utilisateurs, afin de vous protéger des manipulations
extérieures. Pour plus d'informations sur la gestion des utilisateurs, voir chapitre
Configuration du serveur Web (Page 19), paragraphe "Compléter la gestion des utilisateurs".
Serveur Web
Pages Web
Conditions
● Vous avez affecté des noms symboliques dans STEP 7 aux variables que vous souhaitez
utiliser sur votre page Web.
● Dans la fenêtre d'inspection sous "Propriétés > Général > Serveur Web", vous avez au
moins
– activé le serveur Web,
– attribué aux utilisateurs des droits de lecture ou des droits de lecture et d'écriture pour
des pages définies par l'utilisateur (voir chapitre Configuration du serveur Web
(Page 19)).
● Vous avez effectué les réglages requis pour la communication (paramètres d'adresse IP,
masque de sous-réseau, ...).
● Vous avez chargé la configuration.
● Vous avez édité votre page utilisateur dans un éditeur HTML de votre choix :
– pages HTML automatiques, si la commande de l'ouverture de la page par le
programme utilisateur n'est pas souhaitée (appel unique du SFC 99 requis).
Les passages de l'état de fonctionnement de MARCHE à ARRET n'influencent pas
l'appel des pages utilisateur.
– pages HTML manuelles si la commande de l'ouverture de la page par le programme
utilisateur est souhaitée (appel cyclique du SFC 99 requis).
Création de pages utilisateur

Pour la création de vos pages Web personnalisées, vous pouvez utiliser un éditeur HTML de
votre choix. Assurez-vous que votre code HTML est conforme aux normes du World Wide
Web Consortium (W3C), car aucune vérification syntaxique HTML n'a lieu dans STEP 7.
Outre le code HTML simple, vous pouvez utiliser des commandes JavaScript dans vos
pages personnalisées.
Procédez comme suit :
1. Créez le fichier HTML pour votre page utilisateur dans un éditeur HTML.
Pour pouvoir lire des données de la CPU sur votre page Web, intégrez des commandes
AWP sous forme de commentaires HTML (voir le chapitre Commandes AWP
(Page 122)).
2. Enregistrez le fichier HTML et tous les fichiers sources correspondants (par ex. *.gif,
*.jpg, *.js, etc.) dans un répertoire sur votre PG/PC et notez le chemin d'enregistrement.
3. Appelez l'instruction "WWW" dans STEP 7 et programmez-la (voir chapitre
Programmation de l'instruction WWW (Page 136)).
4. Configurez la page utilisateur dans STEP 7 (voir chapitre Configurer des pages utilisateur
(Page 135)). Vous compilez ainsi, entre autres, les contenus de vos fichiers HTML dans
des blocs de données.
Serveur Web
Pages Web
5. Chargez la configuration et le programme utilisateur dans la CPU.

6. À l'aide de votre appareil de visualisation, ouvrez votre page personnalisée via un
navigateur dans le serveur Web de la CPU.
Remarque
Les pages HTML trop complexes, notamment celles qui sont surchargées d'images,
prennent beaucoup de place dans la mémoire de chargement. Pour avoir suffisamment
de mémoire de chargement, veillez à choisir une carte mémoire SIMATIC de capacité
suffisante.
Lorsque le total des pages HTML est > 1 Mo, des pertes de performance peuvent se
produire car seul 1 Mo de données sont provisoirement sauvegardées dans le cache.
Nous recommandons que chaque fichier d'une page Web soit de taille inférieure à
512 Ko, car autrement des problèmes peuvent survenir lors de l'envoi des fichiers du
serveur Web au navigateur. Vous pouvez consulter la taille de chaque fichier dans
l'explorateur de fichiers du dossier.
Mise à jour des pages utilisateur

Les pages utilisateur ne sont pas mises à jour automatiquement dans le navigateur. Vous
pouvez programmer le code HTML de manière à obtenir une mise à jour automatique des
pages.
Comme elles sont régulièrement actualisées, les pages qui lisent des données de l'automate
sont généralement à jour.
Remarque
Lorsque la page HTML contient des champs de formulaire pour la saisie de données, la
mise à jour automatique peut empêcher la saisie correcte des données par l'utilisateur.
Pour une actualisation automatique de la page complète, vous pouvez insérer l'instruction
suivante dans l'en-tête <head> de votre fichier HTML, "10" correspondant à l'intervalle
d'actualisation en secondes :
<meta http-equiv="refresh" content="10">
Serveur Web
Pages Web
Voir aussi
Pour obtenir la description d'une page utilisateur, reportez-vous au chapitre Exemple de
page utilisateur (Page 141).
Vous trouverez une aide supplémentaire sur la visualisation à l'aide de pages Web
personnalisées dans les exemples d'application correspondants sur Internet :
● Créer et mettre en place ses propres pages Web pour S7-1200
(http://support.automation.siemens.com/WW/view/fr/58862931)
● Créer et mettre en place ses propres pages Web pour S7-1200 et S7-1500
(https://support.industry.siemens.com/cs/de/fr/view/68011496)
● Visualisation de pages Web utilisateur sur des CPU SIMATIC équipées d'interface
PROFINET (http://support.automation.siemens.com/WW/view/fr/44212999)
● Comment intègre-t-on le contenu d'une chaîne de caractères dans une page Web
utilisateur sur une CPU S7-1500 équipée du firmware V1.6 ?
(https://support.industry.siemens.com/cs/ww/fr/view/98754370)
Pour plus d'informations sur les commandes JavaScript, voir la spécification ECMAScript sur
Internet (http://www.ecma-international.org/ecma-262/5.1/).
Pour plus d'informations sur l'actualisation automatique des page Web et sur l'intégration de
pages personnalisées avec des noms de chemins relatifs, voir la FAQ, ID de contribution
62543256 sur la page Internet du Service&Support
3.16.1 Commandes AWP
Vue d'ensemble
Les commandes AWP (Automation Web Programming) désignent une syntaxe de
commandes spéciales permettant d'échanger des données entre la CPU et la page
utilisateur (fichier HTML).
Les commandes AWP sont insérées en tant que commentaires HTML et vous offrent les
possibilités suivantes pour vos pages personnalisées :
● Lire des variables API
● Écrire des variables API
● Lire des variables spéciales
● Écrire des variables spéciales
● Définir les types Enum
● Affecter des variables à des types Enum
● Définir des fragments de bloc de données
● Importer des fragments de bloc de données
● Accéder aux valeurs d'un tableau
● accéder aux valeurs d'une variable API de type STRUCT
Serveur Web
Pages Web
Syntaxe générale
À l'exception de la commande de lecture d'une variable API, toutes les commandes AWP
ont la syntaxe suivante :

Les fichiers contenant des commandes AWP

● doivent être codés en UTF-8.
Pour définir UTF-8 comme jeu de caractères dans la page, insérez la ligne suivante dans
votre code HTML :
<meta http-equiv="content-type" content="text/html; charset utf-8">
Remarque
Enregistrement de la page HTML
Veillez à enregistrer le fichier dans l'éditeur également en code UTF-8.
● ne doivent pas contenir la séquence suivante : ]]>

● ne doivent pas contenir la séquence suivante en dehors des "zones de lecture variable"
(:="<Varname>":) : :=
● les caractères spéciaux dans les noms de variables ou de blocs de données doivent être,
selon l'utilisation, repérés par des séquences Escape ou mis entre guillemets.
● font la distinction entre majuscules et minuscules (Case Sensitivity)
● doivent être mis en plus entre des commentaires JavaScript ("/*...*/") dans les fichiers
JavaScript
Vue d'ensemble des commandes AWP
Tableau 3- 11 Commandes AWP
Fonction Représentation
Lire des variables API :=<Varname>:
Écrire des variables API 
Lire des variables spéciales 
Écrire des variables spéciales 
Définir les types Enum 
Affecter des variables à des types 
Enum
Définir des fragments de bloc de 
données
Accéder aux valeurs d'un tableau  ...

Accéder aux valeurs d'une variable  ...
API du type de données STRUCT 
Serveur Web
Pages Web
3.16.1.1 Variables API
Introduction aux variables API

Des pages utilisateur peuvent lire des variables API de la CPU et écrire des données dans la
CPU.
Pour cela, les variables API :
● doivent être entourées de guillemets ("..."),
● doivent être en outre écrites entre guillemets simples ('" ... "') ou entourées de guillemets
masqués par une barre oblique inversée (Backslash) ("\" ... \""),
● doivent être spécifiées par un nom de variable API,
● si le nom de la variable API contient une barre oblique inversée (\) ou ', ces caractères
doivent être marqués comme caractère normal du nom de la variable API au moyen de la
séquence Escape \\ ou \'
● doivent être entourées de guillemets simples ('...') si une adresse absolue (entrée, sortie,
mémento) est utilisée dans la commande AWP.
Lire des variables API

Ces variables OUT (sens de sortie considéré à partir de l'automate) sont insérées avec la
syntaxe décrite ci-après à un endroit quelconque du texte HTML.
Syntaxe
:=<Varname>:
<Varname> correspond à la variable à lire de votre projet STEP 7 et peut être une variable
globale simple mais également tout un chemin de variable vers un élément de structure.
Dans le cas d'un bloc de données, veillez à utiliser le nom du bloc de données, pas le
numéro de celui-ci.
Exemples
:="Vitesse de transport":
:="Mon_Bloc de données".Mémento1:
:=%MW100:
Lecture de variables de type String et Character

Dans ce qui suit, les deux caractères suivants sont employés dans les explications :
guillemet simple ('), guillemets (").
A partir de la version V1.6 du firmware, la CPU transmet pour la fonction "Lire une variable
API" les variables de type String ou Character entre guillemets simples au navigateur .
Par exemple :
● Variable String "Varname".MyString = ABC
● Vous lisez la variable dans HTML au moyen de la fonction :="Varname".MyString:
● Le serveur Web transmet la chaîne de caractères 'ABC' au navigateur
Serveur Web
Pages Web
Utilisation de variables String ou Character dans des expressions

Vous utilisez sur votre page HTML une expression dans laquelle la chaîne de caractères
pour la lecture d'une variable est écrite entre guillemets, par ex. dans des formulaires.
Code HTML possible utilisé :
<input type="text" name="appfield" value="myvalue">
Quand vous lisez dans une variable API la valeur affichée pour l'attribut "value" dans cette
expression, le code HTML se présente comme suit :
<input type="text" name="appfield" value=":="Varname".MyString:">
Suite à la lecture de la variable API, le serveur Web fournit la valeur 'ABC'. Le code est alors
représenté comme suit dans HTML :
<input type="text" name="appfield" value=" 'ABC' ">
Si vous avez utilisé des guillemets simples au lieu de guillemets pour encadrer les attributs
dans votre code HTML, le serveur Web transmettra le contenu de la variable entre
guillemets simples au navigateur. Ainsi, le navigateur ne sortira pas le contenu de la variable
String ou Character, puisque deux guillemets simples consécutifs forment une séquence
complète. Les valeurs à lire se trouvent entre ces séquences et ne sont pas affichées par le
navigateur.
Notez en particulier à ce propos que le caractère guillemets n'est pas identique à deux
guillemets simples, même si l'image obtenue pourrait le faire croire.
Remarque
Le code n'est pas adapté automatiquement lors d'une mise à jour à un firmware à partir de
V1.6.
Adaptez votre code HTML si vous avez utilisé des guillemets simples pour encadrer des
attributs avec la fonction "Lire une variable API".
Figure 3-70 Exemple de code HTML avec l'attribut dans des guillemets simples
Serveur Web
Pages Web
Ecrire des variables API

Ces variables IN (sens de saisie considéré à partir de l'automate) sont activées sur la page
du navigateur. Cela peut p. ex. s'effectuer dans un formulaire sur votre page HTML par des
champs de saisie de texte ou de listes de sélection correspondant aux variables à écrire.
Les variables sont soit définies dans l'en-tête HTTP (par un cookie ou par la méthode
POST), soit dans l'URL (méthode GET) par le navigateur dans la requête HTTP et ensuite
écrites par le serveur Web dans la variable API respective.
Remarque
Protection en écriture pendant le fonctionnement
Pour pouvoir accéder en écriture à des données de la CPU à partir d'une page
personnalisée, un utilisateur doit être créé avec les autorisations correspondantes et
l'opérateur doit être connecté comme cet utilisateur. Cette règle s'applique en principe à tous
les accès en écriture de pages Web à la CPU.
Syntaxe

Si le nom de la variable que vous utilisez pour l'application Web n'est pas identique au nom
de la variable API, l'affectation à une variable API peut s'effectuer avec le paramètre "Use".

Exemples avec des champs de saisie HTML


<form method="post">
<p>Input Target Level: <input name='"Target_Level"'
type="text"><input type="submit" value="Write to PLC"> </p>
</form>


<p>Braking: <input name='"Data_block_1".Braking' type="text"> <input
type="submit" value="Write to PLC"></p>
</form>
Exemple avec une liste de sélection HTML


<select name='"Data_block_1".ManualOverrideEnable'>
<option value=1>Yes</option>
<option value=0>No</option>
</select><input type="submit" value="submit setting"> </form>
Serveur Web
Pages Web
3.16.1.2 Variables spéciales
Variables spéciales
Les variables spéciales sont principalement des variables appelées variables HTTP qui sont
définies dans les définitions du World Wide Web Consortium (W3C). Les variables spéciales
sont également utilisées pour les cookies et les variables de serveur.
Lire des variables spéciales

Le serveur Web peut lire des variables API et les transmettre à des variables spéciales du
HTTP Response Header. Vous pouvez p. ex. lire un chemin d'accès à partir d'une variable
API pour une redirection de l'URL vers un autre lieu d'enregistrement à l'aide de la variable
spéciale "HEADER:lieu d'enregistrement".
Syntaxe

<Type> correspond au type de la variable spéciale.
Sont possibles :
● HEADER
● COOKIE_VALUE
● COOKIE_EXPIRES
<Name> correspond au nom de la variable HEADER ou du cookie :
● variable HEADER :
– Status: code d'état HTTP (le code d'état 302 est retourné si aucune autre valeur n'a
été définie).
– Location: chemin pour le renvoi sur une autre page. Le code d'état 302 doit être défini.
– Retry-After: durée probable d'indisponibilité du service. Le code d'état 503 doit être
défini.
● COOKIE_VALUE:name: valeur du cookie avec le nom.
● COOKIE_EXPIRES:name: temps d'expiration du cookie avec le nom, en secondes.
Exemples
La variable HTTP-HEADER est écrite dans la variable API de même nom :

Si le nom de la variable spéciale n'est pas identique au nom de la variable API, l'affectation à
une variable API peut s'effectuer avec le paramètre "Use" :

Serveur Web
Pages Web
Ecrire des variables spéciales

Le serveur Web offre la possibilité d'écrire des valeurs des variables spéciales écrites dans
HTTP-Header dans la CPU. Dans STEP 7 vous pouvez p. ex. enregistrer des informations
relatives au cookie d'une page utilisateur ou à l'utilisateur qui accède à une page.
Syntaxe

<Type> correspond au type de la variable spéciale.
Sont possibles :
● HEADER
● SERVER
● COOKIE_VALUE
<Name> correspond au nom de la variable HEADER ou du cookie :
● variable HEADER :
– Accept-Language: Langue acceptée ou privilégiée
– User-Agent: Informations sur le navigateur
– Authorization: Justificatif d'autorisation pour une ressource requise
● variable SERVER :
– current_user_id: Indique si un utilisateur est connecté :
current_user_id=0: aucun utilisateur n'est connecté / l'utilisateur "Tout le monde"
dispose de droits d'accès.
current_user_id=1: un utilisateur au moins est connecté.
– current_user_name: Nom de l'utilisateur connecté
● COOKIE_VALUE:name: valeur du cookie avec le nom.
Exemples
La variable HTTP-SERVER est écrite dans la variable API de même nom :

La variable HTTP-SERVER est écrite dans la variable API "mon_IDutilisateur" :

3.16.1.3 Types Enum
Types d'énumérations (Enum)

Les Enum vous permettent de convertir des valeurs numériques du programme API en texte
et inversement. L'affectation des valeurs numériques peut également être effectuée pour
plusieurs langues.
Serveur Web
Pages Web
Définir les types Enum

Vous pouvez définir des types Enum dans vos pages personnalisées et affecter les valeurs
dans une commande AWP.
Syntaxe

Exemples
Pour sauvegarder des valeurs françaises sous forme de fichier HTML dans le dossier "fr" du
répertoire HTML :

Pour sauvegarder des valeurs anglaises sous forme de fichier HTML dans le dossier "en" du
répertoire HTML :

<Varname> est le nom de variable symbolique du programme utilisateur, <Enum-Type> le
nom défini auparavant du type Enum.
Exemples de déclaration

Exemple d'utilisation lors de la lecture d'une variable


...
La valeur actuelle de "Alarm" est :="Alarm": </p>
Si la valeur de "Alarm" dans la CPU est égale à 2, la page HTML affiche 'La valeur actuelle
de "Alarm" est Réservoir vide', car la définition du type Enum affecte à la valeur numérique 2
la chaîne de caractères "Réservoir vide".
Serveur Web
Pages Web
Exemple d'utilisation lors de l'écriture d'une variable



...
<p><input type="hidden" name ='"Alarm"' value='Réservoir plein'
/></p>
<p><input type="submit" value='Mise à 1 Réservoir plein' /></p>
</form>
La valeur 1 est écrite dans la variable API "Alarme", car la définition du type Enum affecte le
texte "Récipient est plein" à la valeur numérique 1.
Attention, le nom indiqué dans "AWP_In_Variable" doit correspondre exactement à celui
dans "AWP_Enum_Ref".
3.16.1.4 Fragments
Fragments
Il s'agit des différents "fragments de sens" d'une page Web à traiter par la CPU.
Les fragments sont souvent des pages entières mais il peut également s'agir d'éléments
individuels tels que les fichiers (p. ex. les vues) ou les documents entiers.
Remarque
Dans chaque fragment dans lequel une variable API fait référence aux textes Enum, cette
variable API doit être affectée avec la commande AWP correspondante au nom du type
Enum.
Serveur Web
Pages Web
Définir des fragments

Un fragment s'étend jusqu'au début du prochain fragment ou jusqu'à la fin du fichier.
Syntaxe

Le début d'un fragment est défini avec cette commande.
● <Name> Indique le nom du fragment. Le nom doit commencer par une lettre [a-zA-Z] ou
par un tiret bas ( _ ). Ce premier caractère peut être suivi de lettres, de tirets bas ou de
chiffres [0-9].
● <Type> Indique le type de fragment.
– "manual": le programme utilisateur est informé par la requête pour un fragment et il
peut réagir en conséquence. Le fonctionnement du fragment doit être commandé
avec STEP 7 et les variables du DB de contrôle.
– "automatic": la page est automatiquement éditée (par défaut)
● <Id> Une ID numérique peut être spécifiée pour le fragment. Si aucune ID n'est attribuée,
une ID est alors automatiquement affectée au fragment. Pour les pages manuelles
(<Type>=manual), l'accès au fragment peut être effectué dans le programme utilisateur
de la CPU avec cette ID.
Remarque
Indication d'une ID
Indiquez une ID basse car l'ID la plus élevée influence la taille du DB de contrôle Web.
● <Modus>
– "visible": les contenus du fragment sont affichés sur la page utilisateur (par défaut).
– "hidden": les contenus du fragment ne sont pas affichés sur la page utilisateur.
Importation de fragments
Vous avez la possibilité de déclarer un fragment dans une page HTML et d'importer ce
fragment dans d'autres pages Web.
Remarque
Notez qu'il n'existe pas de commande AWP pour l'importation de fragments entre une
affectation Enum et une utilisation Enum car l'affectation Enum se trouve dans un autre
fragment que l'utilisation Enum du fait de cette importation.
Serveur Web
Pages Web
Exemple
Un logo d'entreprise doit être affiché sur toutes les pages Web d'une application Web.
Le code HTML pour le fragment affichant le logo de l'entreprise n'existe qu'une fois. Vous
pouvez importer le fragment autant de fois et dans autant de fichiers HTML que nécessaire.
Syntaxe

<Name> est le nom du fragment à importer.
Exemple
Code HTML dans une page Web qui déclare un fragment pour l'affichage d'une image :

<p><img src="Firmenlogo.jpg"></p>
Code HTML qui importe le fragment déclaré dans une autre page Web :

3.16.1.5 Tableaux
Tableaux
Le serveur Web met à disposition les commandes AWP AWP_Start_Array et
AWP_End_Array pour l'accès à toutes les valeurs d'un tableau (Array).
Seuls les tableaux à une dimension sont pris en charge.
Les tableaux multidimensionnels au format array[x][y] ne sont pas pris en charge.
Syntaxe

... Contenu du tableau, mots-clés utilisés : ArrayIndex et value
Paramètres
● <Name> définit le nom du tableau contenant les éléments auxquels vous souhaitez
accéder.
– Vous avez besoin d'un nom de DB et d'un nom de tableau conformes à la structure de
bloc de données définie dans STEP 7.
– Le nom doit être écrit entre guillemets simples ou doubles.
– Le nom de DB est entre guillemets doubles.
● <ArrayIndex> indice d'un élément du tableau
● <value> valeur d'un élément du tableau
Serveur Web
Pages Web
Exemple
L'exemple ci-dessous lit tous les éléments de la structure "MyArray" dans le bloc de données
"DB_Name" de la CPU et affiche l'indice et les valeurs des variables sur la page Web
personnalisée.


Indice : :=ArrayIndex: valeur : :=value:
Le code affiché ci-dessus crée l'affichage suivant :
Indice : 1 Valeur : 42
Représentation de tableaux de type de données Bool

La sortie de tableaux de type Bool occupe toujours l'intégralité des 8 bits suivants. Cette
particularité ne concerne que les tableaux booléens.
Exemple :
"DB_1".bitArray est un tableau booléen de 5 éléments.

:=ArrayIndex: -> :=value:
Sortie :
0 -> Valeur dans "DB_1".bitArray[0]
5 -> 0
6 -> 0
7 -> 0
Serveur Web
Pages Web
3.16.1.6 Structures
Structures
Le serveur Web met à disposition des commandes AWP pour l'accès aux structures qui
permettent d'accéder aux valeurs d'une variable API du type de données STRUCT.
Syntaxe

... Contenu de la structure...

Paramètres
● <Name> définit le nom de la structure contenant les éléments auxquels vous souhaitez
accéder.
– Vous avez besoin d'un nom de DB et d'un nom de structure conformes à la structure
de bloc de données définie dans STEP 7.
– Le nom doit être écrit entre guillemets simples ou doubles.
– Le nom de DB est entre guillemets doubles.
Exemple
L'exemple ci-dessous lit des éléments de la structure "MyStruct" dans les blocs de données
"DB_Name" de la CPU et affiche la valeur de la variable sur la page Web personnalisée.


:=A:
:=B:
:=C:

Le code affiché ci-dessus correspond aux commandes suivantes :
:="DB_Name".MyStruct.A:
:="DB_Name".MyStruct.B:
:="DB_Name".MyStruct.C:
Serveur Web
Pages Web
3.16.2 Configurer des pages utilisateur
Configurer des pages utilisateur
Figure 3-71 Configurer des pages utilisateur dans STEP 7
Pour configurer les pages utilisateur dans STEP 7, procédez de la manière suivante :
1. Sélectionnez la CPU dans la configuration des appareils.
2. Sélectionnez les propriétés pour la CPU dans la fenêtre d'inspection sous
"Propriétés > Général > Serveur Web".
3. Sélectionnez dans la zone "Pages utilisateurs" sous ① "Répertoire HTML" le dossier de
votre appareil de visualisation dans lequel vous avez enregistré votre page HTML.
4. Sous ② "Page d'accueil HTML", saisissez le nom de la page HTML qui doit être ouverte
au démarrage de l'application.
5. Vous pouvez également attribuer un nom pour votre application sous ③ "Nom
d'application". Ce nom sert à subdiviser ou regrouper davantage les pages Web.
Lorsqu'un nom d'application est existant, l'URL s'affiche dans le format suivant :
http://a.b.c.d/awp/<Applikationsname>/<Seitenname>.html
6. Dans la zone "Avancé" indiquez dans le champ ⑥ "Fichiers à contenus dynamiques"
dans quelles extensions de noms de fichiers il faut vérifier des commandes AWP. Par
défaut, STEP 7 analyse les fichiers avec les extensions "htm" et "html". Si vous avez
utilisé d'autres extensions de noms de fichiers lors de la création de votre page
utilisateur, complétez-les ici.
7. Vous pouvez conserver les numéros pour le DB Web ⑦ et pour le numéro de début de
DB de fragment ⑦ s'ils ne sont pas déjà affectés ou attribuer un autre numéro de votre
choix.
Serveur Web
Pages Web
8. Cliquez sur le bouton ④ "Générer des blocs" pour générer des DB à partir des fichiers
sources. Les blocs de données générés sont stockés dans le dossier "Blocs système >
Serveur Web" de la navigation de projet STEP 7. Ces blocs de données se composent
d'un DB de contrôle Web (Web-Control-DB), qui gère l'affichage des pages Web, et d'un
ou de plusieurs DB de fragment avec les pages Web compilées.
9. Sélectionnez dans la vue du réseau la CPU qui doit être chargée et sélectionnez la
commande "Charger dans l'appareil" dans le menu "En ligne" afin de charger les blocs.
La compilation des blocs est lancée de manière implicite avant le chargement. Si des
erreurs sont signalées au cours de ce processus, vous devez réparer ces erreurs avant
de pouvoir charger la configuration.
Effacer des blocs de données

Pour effacer des blocs de données générés préalablement, cliquez sur le bouton ⑤ "Effacer
les blocs". STEP 7 supprime ainsi le DB de contrôle Web et tous les DB de fragment du
projet dans lequel se trouvent vos pages utilisateur.
3.16.3 Programmation de l'instruction WWW
L'instruction WWW
L'instruction WWW initialise le serveur Web de la CPU ou synchronise les pages web
personnalisées avec le programme utilisateur dans la CPU. Pour cela, le DB de contrôle
Web est le paramètre d'entrée pour l'instruction WWW et il indique le contenu des pages
telles qu'elles sont représentées dans les DB de fragment, ainsi que les informations d'état
et de commande. STEP 7 crée le DB de contrôle Web lorsque vous cliquez sur le bouton
"Générer des blocs".
Remarque
Numéro du DB de contrôle Web
Lorsque vous modifiez le numéro du DB 333, les pages utilisateur ne sont plus accessibles
dans le serveur Web lors d'un nouveau téléchargement dans la CPU. Le code d'erreur
W#16#007F est émis au paramètre RET_VAL. Pour cette raison, conservez la valeur par
défaut DB 333 pour le DB de contrôle Web.
Si vous voulez cependant modifier ce numéro de DB, il faudra couper la tension, puis la
remettre sur la CPU pour que les pages utilisateur soient accessibles dans le serveur Web.
Serveur Web
Pages Web
Programmation de l'instruction WWW

Le programme utilisateur doit exécuter l'instruction WWW pour que les pages utilisateur
puissent être appelées sur le serveur Web.
Tableau 3- 12 Instruction WWW
CONT/LOG SCL Description

ret_val Accès aux pages utilisateur via
:=WWW(ctrl_db:=uint_in_) le serveur Web
;
Paramètres
Le tableau suivant montre les paramètres de l'instruction WWW :
Tableau 3- 13 Paramètres
Paramètres Déclaration Type de données Description

CTRL_DB Input DB_WWW Bloc de données qui décrit les pages person-
nalisées (DB de contrôle Web)
RET_VAL Output INT Informations d'erreur
Paramètre RET_VAL
Tableau 3- 14 RET_VAL
Code d'erreur Explication

(W#16#...)
0000 Aucune erreur ne s'est produite. Aucune requête de page Web devant être validée
par le programme utilisateur n'existe.
00xy x : indique si une erreur s'est produite à l'initialisation du DB de contrôle Web
(CTRL_DB) :
x=0 : aucune erreur ne s'est produite.
x=1 : une erreur s'est produite, Elle est codée dans l'octet "CTRL_DB.last_error" du
DB de contrôle Web.
y : numéro de la requête présente. Plusieurs requêtes sont possibles (p. ex. les re-
quêtes "0" et "1" sont présentes : y="3").
y="1" : requête "0"
803A Le DB de gestion Web indiqué ne se trouve pas dans la CPU.
8081 Version ou format erroné du DB de contrôle Web.
80C1 Aucune ressource disponible pour initialiser l'application Web.
Serveur Web
Pages Web
3.16.4 Définir la page utilisateur comme page d'accueil
Définir la page utilisateur comme page d'accueil

En plus de la page Intro prédéfinie , vous pouvez également définir la page d'accueil de vos
pages utilisateur comme page d'accueil du serveur Web.
Figure 3-72 Exemple de page utilisateur comme page d'accueil du serveur Web
Conditions requises
Les conditions suivantes doivent être remplies pour que la page utilisateur s'affiche au
démarrage du serveur Web :
● Vous avez configuré la page utilisateur comme page d'accueil.
● Vous avez configuré un utilisateur dans STEP 7 auquel vous avez au moins attribué le
droit "... Appeler des pages définies par l'utilisateur".
● La CPU est à l'état de fonctionnement MARCHE.
Serveur Web
Pages Web
Marche à suivre
Pour définir les pages utilisateur comme page d'accueil du serveur Web dans STEP 7,
procédez de la manière suivante :
1. Sélectionnez la CPU dans la configuration matérielle.
2. Sélectionnez les propriétés pour la CPU dans la fenêtre d'inspection sous
"Propriétés > Général > Serveur Web".
3. Sélectionnez dans la zone "Page d'accueil" sous "Sélectionner la page d'accueil" l'entrée
"AWP1".
Figure 3-73 Définir la page utilisateur dans STEP 7 comme page d'accueil
4. Chargez la configuration dans la CPU.

Si vous entrez maintenant l'adresse IP de la CPU dans le navigateur, une liaison est
automatiquement établie avec vos pages utilisateur.
Si vous voulez à nouveau accéder aux pages Web de la CPU, désactivez la liaison des
pages Web avec vos pages utilisateur, p. ex. via l'URL
"http://a.b.c.d./Portal/Portal.mwsl?PriNav=Start" ou
"https://a.b.c.d/Portal/Portal.mwsl?PriNav=Start" Les lettres "a.b.c.d" désignent à titre
d'exemple l'adresse IP de la CPU configurée.
Exemple de lien en HTML :
<a href="/Portal/Portal.mwsl?PriNav=Start">Pages Web SIMATIC</a>
Remarque
Si vous définissez votre page utilisateur comme page d'accueil du serveur Web, tous les
accès directs aux pages Web de la CPU sont bloqués. Cela s'applique également aux
signets que vous avez enregistrés pour les pages Web de la CPU ou la page de lecture des
données de maintenance.
Serveur Web
Pages Web
Lecture des données de maintenance

Si vous définissez votre page utilisateur comme page d'accueil du serveur Web, l'accès
direct à la page de lecture des données de maintenance est également bloqué.
Si vous souhaitez pouvoir continuer à lire les données de maintenance en cas de
maintenance via le serveur Web, créez un lien direct de votre page utilisateur à la page des
données de maintenance.
Comme pour les pages Web de la CPU, vous créez un lien à la page des données de
maintenance via l'URL "http://a.b.c.d/save_service_data" ou
"https://a.b.c.d/save_service_data", les lettres "a.b.c.d" désignant à titre d'exemple l'adresse
IP de la CPU configurée.
Exemple de lien en HTML :
<a href="/save_service_data">Servicedaten</a>
Voir aussi
Pour plus d'informations sur l'utilisation d'une page utilisateur comme page d'accueil,
référez-vous à la FAQ, numéro de contribution ID 67184104 sur la page Internet
Service&Support (https://support.industry.siemens.com/cs/ww/fr/view/67184104).
Serveur Web
Pages Web
3.16.5 Exemple de page utilisateur
3.16.5.1 Page Web pour le contrôle-commande d'une éolienne
Exemple de page utilisateur

Voici une page utilisateur pour le contrôle-commande d'une éolienne :
Figure 3-74 Vue d'ensemble d'une page utilisateur pour une éolienne
Cet exemple de page est en anglais, mais vous pouvez bien sûr utiliser n'importe quelle
langue lorsque vous concevez vos propres pages utilisateur.
Dans cette application, chaque éolienne d'une ferme d'éoliennes dispose dans STEP 7 d'un
bloc de données avec des données spécifiques concernant cette éolienne et sa position.
La page utilisateur fournit un accès à distance à l'éolienne à partir d'un appareil de
visualisation. Un utilisateur peut se connecter aux pages Web standard de la CPU d'une
éolienne donnée et accéder à la page utilisateur de "Remote Wind Turbine Monitor" pour
visualiser les données de cette éolienne. Avec les droits d'accès correspondants, un
utilisateur peut également faire passer l'éolienne en mode manuel et piloter les variables
pour la vitesse, le lacet et le pas à partir de la page Web. Il peut en outre définir une valeur
de freinage, que l'éolienne soit en mode manuel ou automatique.
STEP 7 surveille les valeurs booléennes de substitution du mode automatique et utilise, si
elles existent, les valeurs de vitesse d'éolienne, de lacet et de pas d'entrée définies par
l'utilisateur.
Serveur Web
Pages Web
Fichiers utilisés
Cet exemple d'application utilise trois fichiers :
● Wind_turbine.html: page utilisateur dans la représentation ci-dessus. Les commandes
AWP permettent d'accéder aux données de l'automate.
● Wind_turbine.css: feuille de style en cascade qui contient les règles de formatage de la
page utilisateur. L'utilisation d'une feuille de style en cascade est facultative, mais elle
peut simplifier la conception de la page utilisateur.
● Wind_turbine.jpg: image d'arrière-plan affichée sur la page utilisateur. L'utilisation
d'images dans des pages personnalisées est optionnelle et requiert, en outre, beaucoup
d'espace dans la mémoire de chargement.
Ces fichiers ne sont pas fournis avec votre installation, mais sont décrits à titre d'exemple.
Serveur Web
Pages Web
Mise en œuvre
La page personnalisée utilise des commandes AWP pour lire des valeurs de la CPU ainsi
que pour écrire des valeurs dans celle-ci. En outre, la page personnalisée utilise également
des commandes AWP pour la définition de types Enum et l'affectation des variables aux
types Enum pour la gestion des réglages ON/OFF.
La page utilisateur est construite comme suit :
① Ligne d'en-tête de la page Web avec numéro de l'éolienne et sa position.

② Conditions atmosphériques au niveau de l'éolienne : vitesse et direction du vent ainsi que
température en cours.
③ Puissance utile de l'éolienne telle qu'elle est lue.
④ Manuel prioritaire : active le mode manuel de la turbine. Pour pouvoir régler manuellement la
vitesse, le lacet ou le pas d'entrée, le programme utilisateur STEP 7 requiert que la priorité
manuelle soit activée.
⑤ Lacet manuel prioritaire : active la priorité manuelle du réglage du lacet et un réglage manuel
pour le lacet.
⑥ Pas manuel prioritaire : active la priorité manuelle pour le pas des pales.
⑦ Un clic sur ce bouton transmet les réglages de priorité à la CPU.
⑧ Valeur manuelle pour un pourcentage de freinage. La "priorité manuelle" n'est pas nécessaire
pour l'entrée d'une valeur de freinage.
En outre, la page utilisateur utilise une commande AWP pour écrire la variable spéciale dans
la table des variables. La table des variables contient l'ID de l'utilisateur qui accède à la page
en cours.
Serveur Web
Pages Web
3.16.5.2 Lecture et affichage des données de la CPU
Exemple de code HTML pour la lecture et l'affichage des données de la CPU

Cette partie du code HTML est utilisée pour l'affichage de la puissance utile sur la page
utilisateur.
Le texte "Power Output:" s'affiche à gauche, à droite s'affiche la valeur de la variable pour la
puissance utile avec mention de l'unité ("KW").
La commande AWP :="Data_block_1".PowerOutput exécute l'opération de lecture. Les blocs
de données sont référencés par leur nom et pas par leur numéro ("Data_block_1" au lieu de
"DB1").
Le code utilisé dans l'exemple est le suivant :
<tr style="height:2%;">
<td>
<p>Power output:</p>
</td>
<td>
<p style="margin-bottom:5px;"> :="Data_block_1".PowerOutput: KW</p>
</td>
</tr>
3.16.5.3 Utilisation d'un type Enum
Définition de types Enum

La page utilisateur décrite utilise des types Enum pour trois instances dans lesquelles la
page affiche "On" ou "Off" pour une valeur booléenne.
Le type Enum pour "On" correspond à la valeur 1, le type Enum pour "Off" correspond à la
valeur 0. Les extraits suivants du code HTML de la page utilisateur montrent comment
déclarer un type Enum appelé "OverrideStatus" et ayant les valeurs "0" et "1" pour "Off" et
"On" et comment définir une référence de type Enum "OverrideStatus" pour la variable
"ManualOverrideEnable" dans le bloc de données "Data_block_1".
Remarque
Affectation de types Enum
Notez qu'il doit y avoir pour chaque déclaration "AWP_Enum_Ref" une déclaration
"AWP_In_Variable" correspondante si la page écrit dans la variable par le biais d'un type
Enum.
Serveur Web
Pages Web




Le code suivant décrit un champ d'affichage pour l'état en cours de
"ManualOverrideEnable". Il n'utilise qu'une commande normale de lecture de variable mais
grâce à l'utilisation du type Enum préalablement déclaré et référencé, la page affiche "On" et
"Off" au lieu de "0" ou "1".
<td style="width:24%; border-top-style: Solid; border-top-width:
2px; border-top-color: #ffffff;">
<p>Manual override: :="Data_block_1".ManualOverrideEnable:</p>
</td>
Le code suivant inclut une liste de sélection déroulante pour que l'utilisateur puisse changer
la valeur de "ManualOverrideEnable". La liste de sélection inclut les possibilités "Yes" et
"No" affectées via la référence au type Enum aux valeurs "On" ou "Off". La sélection vide
laisse la valeur de l'état telle quelle.
<option value=':"Data_block_1".ManualOverrideEnable:'> </option>
<option value="On">Yes</option>
<option selected value="Off">No</option>
</select>
La liste de sélection est incluse dans un formulaire sur la page Web. Lorsque l'utilisateur
clique sur le bouton "Submit override settings and values", le formulaire est téléchargé. Si
l'utilisateur a sélectionné "Yes" la valeur "1" est inscrite dans la variable
"ManualOverrideEnable" du bloc "Data_block_1", si l'utilisateur a sélectionné "No", c'est la
valeur "0" qui est inscrite.
3.16.5.4 Ecriture d'une entrée utilisateur dans l'automate
Possibilités de paramétrage
La page utilisateur de "Remote Wind Turbine Monitor" comprend plusieurs commandes
AWP pour l'écriture de données dans l'automate. Grâce à la déclaration de différentes
commandes d'écriture "AWP_In_Variable" pour les variables, un utilisateur possédant les
droits d'accès correspondants peut placer l'éolienne en mode manuel et activer la
substitution de valeurs manuelles pour la vitesse de l'éolienne, le lacet et/ou le pas des
pales. L'utilisateur peut également régler des valeurs à virgule flottante pour la vitesse, le
lacet et le pas de l'éolienne et pour le pourcentage de freinage. La page personnalisée
utilise une commande HTTP de format "POST" pour écrire les variables dans l'automate.
Serveur Web
Pages Web
Dans l'exemple, le code utilisé pour le réglage manuel de la valeur de freinage est le
suivant :

...
<tr sytle="vertical-align: top; height: 2%;">
<td style="width: 22%;"><p>Braking:</p></td>
<td>
<form method="POST">
<p><input name='"Data_block_1".Braking' size="10" type ="text">
%</p>
</form>
</td>
</tr>
L'extrait suivant du code HTML déclare d'abord pour le bloc de données "Data_block_1" une
variable "AWP_In_Variable" qui permet à la page utilisateur d'écrire dans n'importe quelle
variable du bloc de données. A gauche, le texte "Braking:" est affiché, à droite se situe un
champ permettant les entrées utilisateur pour la variable "Braking" dans le bloc de données.
La page lit alors la valeur de freinage en cours dans l'automate et l'affiche dans le champ
d'entrée de données. Un utilisateur possédant les droits d'accès correspondants peut alors
écrire une valeur de freinage dans le bloc de données de la CPU qui commande le freinage.
Remarque
Déclaration de blocs de données
Si vous déclarez l'ensemble d'un bloc de données dans une déclaration "AWP_In_Variable",
il est possible d'écrire chaque variable dans ce bloc de données à partir de la page
personnalisée. Si vous voulez qu'il ne soit possible d'écrire que certaines variables dans le
bloc de données, déclarez-le spécifiquement à l'aide par exemple de .
3.16.5.5 Ecrire des variables spéciales
Utilisation de variables spéciales

La page utilisateur de "Remote Wind Turbine Monitor" écrit la variable spéciale
"Server:current_user_id" dans une variable de la CPU. La valeur de variable contient la
valeur "1" si un utilisateur s'est connecté, sinon la valeur "0". Dans l'exemple, un utilisateur
s'est connecté. C'est pourquoi la valeur de variable est à "1" La variable spéciale est écrite
par la page utilisateur dans laCPU par la page et ne nécessite pas d'interface utilisateur.

3.16.5.6 Code HTML de la page utilisateur de "Remote Wind Turbine Monitor"

Ci-après le code HTML complet de la page d'exemple de "Remote Wind Turbine Monitor"
ainsi que la feuille de style en cascade (CSS) utilisée.
Serveur Web
Pages Web
Wind_turbine.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
-->



<html>
<head>
<meta http-equiv="content-type" content="text/html;
charset=utf-8"><link rel="stylesheet" href="Wind_turbine.css">
<title>Contrôle d'éolienne à distance
</title>
<body>
<table cellpadding="0" cellspacing="2">
<tr style="height: 2%;">
<td colspan="2">
<h2>Remote Wind Turbine Monitor: Turbine
#:="Data_block_1".TurbineNumber:</h2>
</td>
<tr style="height: 2%;"><td style="width: 25%;"><p>Wind speed:</p></
td>
<td><p> :="Data_block_1".WindSpeed: km/h</p></td>
</tr>
<td style="width: 25%;"><p>Wind direction:</p></td>
<td><p> :="Data_block_1".WindDirection: deg.</p></td>
</tr>
<tr style="height: 2%;"><td style="width:
25%;"><p>Temperature:</p></
td>
<td><p> :="Data_block_1".Temperature: deg. C</p></td>
</tr>
<td style="width: 25%;"><p>Power output:</p></td>
<td><p style="margin-bottom:5px;"> :="Data_block_1".PowerOutput:
kW</p>
</td>
</tr>
<form method="POST" action="">
<tr style="height: 2%;" >
<td style="width=25%; border-top-style: Solid; border-top-width:
2px; border-top-color: #ffffff;">
<p>Manual override: :="Data_block_1".ManualOverrideEnable:</p>
</td>
Serveur Web
Pages Web
<td class="Text">Set:
<option value=':="Data_block_1".ManualOverrideEnable:'> </option>
<option value="Off">No</option>
</select>
</td>
</tr>
<tr style="vertical-align: top; height: 2%;"><td style="width:
25%;"><p>Turbine speed:</p></td>
<td>
<p style="margin-bottom:5px;"><input
name='"Data_block_1".TurbineSpeed' size="10"
value=':="Data_block_1".TurbineSpeed:' type="text"> RPM</p>
</td>
</tr>
<tr style="vertical-align: top; height: 2%;">
<td style="width: 25%;">
<p>Yaw override: :="Data_block_1".YawOverride: </p>
</td>
<select name='"Data_block_1".YawOverride'>
<option value=':="Data_block_1".YawOverride:'> </option>
</select>
</td>
</tr>
<p>Turbine yaw:</p>
</td>
<td>
<p style="margin-bottom:5px;"><input name='"Data_block_1".Yaw'
size="10" value=':="Data_block_1".Yaw:' type="text"> deg.</p>
</td>
</tr>
<p>Pitch override: :="Data_block_1".PitchOverride: </p>
</td>
<select name='"Data_block_1".PitchOverride'>
<option value=':="Data_block_1".PitchOverride:'> </option>
</select>
</td>
</tr>
<td style="width=25%; border-bottom-style: Solid; border-
bottomwidth:
2px; border-bottom-color: #ffffff;">
<p>Blade pitch:</p>
</td>
Serveur Web
Pages Web
<td>
<p style="margin-bottom:5px;"><input name='"Data_block_1".Pitch'
size="10" value=':="Data_block_1".Pitch:' type="text"> deg.</p>
</td>
</tr>
<td colspan="2">
<input type="submit" value="Submit override settings and values">
</td>
</tr>
</form>
<td style="width: 25%;"><p>Braking:</p></td>
<td>
<form method="POST" action="">
<p> <input name='"Data_block_1".Braking' size="10"
value=':="Data_block_1".Braking:' type="text"> %</p>
</form>
</td>
</tr>
</table>
</body>
</html>
Wind_turbine.css
BODY {
background-image: url('./Wind_turbine.jpg')
background-position: 0% 0%;
background-repeat: no-repeat;
background-size: cover;
H2 {
font-family: Arial;
font-weight: bold;
font-size: 14.0pt;
color: #FFFFFF;
margin-top:0px;
margin-bottom:10px;
}
P {
font-family: Arial;
font-weight: bold;
color: #FFFFFF;
font-size: 12.0pt;
margin-top:0px;
margin-bottom:0px;
}
TD.Text {
font-family: Arial;
font-weight: bold;
color: #FFFFFF;
font-size: 12.0pt;
margin-top:0px;
margin-bottom:0px;
}
Serveur Web
Pages Web
3.17 Filebrowser
3.17 Filebrowser
Condition
Des droits d'accès doivent être attribués à l'utilisateur dans la gestion des utilisateurs.
Filebrowser
Le navigateur affiche le contenu de la SIMATIC Memory Card sur la page Web
"Filebrowser". Ainsi, vous pouvez par ex. lire et éditer les fichiers journaux écrits dans la
CPU sans utiliser STEP 7.
Figure 3-76 Vue Filebrowser
Le navigateur de fichiers (Filebrowser) affiche la liste de tous les fichiers et répertoires qui se
trouvent sur la SIMATIC Memory Card. Vous pouvez télécharger, supprimer, renommer et
charger les fichiers ; vous pouvez créer, supprimer et renommer les répertoires.
Remarque
Le Filebrowser ne donne qu'un accès en lecture aux répertoires "DataLogs", "Backups" et
"UserFiles".
Exception fichiers système

Les fichiers système sont le fichier de tâche et tous les répertoires, y compris leurs
contenus, auxquels le fichier de tâche fait référence. Les fichiers système ne sont pas
affichés et ne peuvent être ni modifiés, ni supprimés.
Serveur Web
Pages Web
3.18 Lecture de données de service
3.18 Lecture de données de service

Le serveur Web vous permet d'enregistrer les données de maintenance. En plus du contenu
du tampon de diagnostic, celles-ci contiennent également de nombreuses informations
supplémentaires sur l'état interne de la CPU. Si un problème que vous ne pouvez pas
résoudre autrement se produit avec la CPU, vous avez ainsi la possibilité de faire parvenir
ces données de maintenance au Service&Support Team.
Marche à suivre
1. Saisissez l'adresse suivante dans la barre d'adresse de votre navigateur Web :
"http://<CPU IP address>/save_service_data", p. ex.
"http://192.168.3.141/save_service_data"
2. La vue de la page des données de maintenance s'affiche sur votre écran avec un bouton
pour l'enregistrement des données de maintenance.
3. Cliquez sur "Save ServiceData" pour enregistrer les données de service localement sur
votre appareil de visualisation.
Résultat
Les données sont enregistrées dans un fichier .dmp avec la convention de nom suivante :
"<n° de référence><numéro de série><horodatage>.dmp". L'utilisateur peut modifier le nom
du fichier ultérieurement.
Remarque
Si vous avez défini votre page utilisateur comme page d'accueil de la CPU, tenez compte de
la remarque sur la lecture des données de maintenance au chapitre Définir la page
utilisateur comme page d'accueil (Page 138).
Serveur Web
Pages Web
3.19 Pages Web de base
Pages Web avec moins de contenus

Le serveur Web vous propose des pages Web de base pour les afficheurs avec un écran
plus petit, p. ex. IHM.
Les pages Web "Basic" sont des page Web avec des contenus réduits adaptés aux
exigences d'écrans de petite taille avec une faible résolution.
Ces pages renoncent à JavaScript au profit d'un accès plus rapide. Cela signifie aussi que
certaines pages Web standard ne sont pas disponibles comme pages Web de base. En
outre, il se peut que la page Web de base dispose de moins de fonctions comparativement à
la page Web standard.
Sur les pupitres IHM, la commutation sur les pages Web de base s'effectue
automatiquement.
Sur d'autres terminaux mobiles, vous accédez aux pages Web de base en saisissant
l'adresse IP de la CPU configurée suivie de "/basic" dans la barre d'adresse du navigateur
Web, p. ex. http://192.168.3.141/basic ou https://192.168.3.141/basic.
Les pages Web standard suivantes sont également disponibles comme pages Web de
base :
● Page d'accueil (de base : "Etat")
● Diagnostic (sans les onglets "Protection du programme", "Information d'exécution" et "De
sécurité")
● Mémoire tampon de diagnostic
● Ressources
● Etat du module
● Messages (sans possibilité d'acquittement)
● Communication
● Etat des variables
● Tables de visualisation
● Pages utilisateur
● Filebrowser (accès en lecture seule)
● DataLogs
● Intro
Serveur Web
Pages Web
Les pages Web de base se présentent comme suit :
Figure 3-77 Exemple de pages Web de base - page Web "Etat"
Serveur Web
Pages Web
3.20 API (Application Programming Interface)
3.20.1 Web API

La CPU offre une API basée sur le Web (Web API) comme interface pour la lecture et
l'écriture des données de la CPU.
Établissement de la connexion entre la CPU, la Web API et les équipements terminaux

La figure suivante montre à titre d'exemple le rôle de la Web API entre la CPU et
l'équipement terminal.
① CPU
② Équipements terminaux
Figure 3-78 Web API
La communication entre la CPU et l'équipement terminal est réalisée via PROFINET ou via
une intégration WLAN.
Remarque
Notes relatives à la sécurité
Notez que la figure décrit uniquement le rôle de la Web API entre la CPU et l'équipement
terminal.
Pour un établissement correct d'une connexion WLAN sécurisée, respectez les
AUTOHOTSPOT dans l'avant-propos de ce manuel.
Serveur Web
Pages Web
Disponibilité
La Web API est uniquement disponible pour des CPU à partir de la version de firmware V2.8
pour les systèmes suivants :
● les CPU du système d'automatisation S7-1500
(les CPU du système redondant S7-1500R/H ne sont pas prises en charge)
● les CPU 1504D TF et 1507D TF du SIMATIC Drive Controller
● les CPU 1513pro(F)-2 PN et 1516pro(F)-2 PN du système de périphérie décentralisée
ET 200pro
● les CPU 1510SP(F)-1 PN et 1512SP(F)-1 PN du système de périphérie décentralisée
ET 200SP
Avant de pouvoir utiliser la Web API, les conditions suivantes doivent être remplies :
● Vous avez affecté la version de firmware correcte (≥ V2.8) à la CPU utilisée dans le
catalogue du matériel de STEP 7
● Vous avez créé, configuré et chargé un projet dans la CPU.
● Vous avez activé la case à cocher suivante dans STEP 7 :
– Activer le serveur Web sur ce module
Point final API

Le protocole RPC JSON-RPC V2.0 se base sur HTTP. La Web API est accessible via des
requêtes POST à l'URL suivante :
https://[ip_address]/api/jsonrpc
Vous trouverez un exemple de la structure requise d'une requête HTTP et d'une réponse
HTTP permettant une exécution correcte d'une requête Web API au chapitre Intégration de
Web API (Page 162).
Serveur Web
Pages Web
Clients pris en charge

Les produits et versions énumérés dans le tableau ci-dessous ont été testés pour la
Web API. La colonne "Version" liste la version testée actuelle à la clôture de rédaction. De
plus, d'autres versions peuvent également fonctionner, notamment des versions plus
récentes. Toutefois, si des problèmes que vous ne parvenez pas à résoudre se présentent
sur des versions non mentionnées ici, veuillez utiliser l'une des versions testées suivantes :
Produit * Version Fonctions prises en charge

Navigateur Web pour ordinateur de bureau sur la 75.x Accès Web API avec JavaScript pour
base de Chromium (par ex. Google Chrome) (Windows et Android) requêtes asynchrones
(https://chromium.woolyss.com/)
Mozilla Firefox (https://www.mozilla.org/en- 64.x (support à long terme)
US/firefox/)
Microsoft Internet Explorer 11.x
(Windows 7, Windows 10)
Microsoft Edge 44.x
Windows 10
Apple Safari 12.x
iOS
Opera 58.x
SIMATIC HMI Panels 2
Microsoft C# (https://docs.microsoft.com/en- .Net Framework 4.7 Accès Web API pour des requêtes
us/dotnet/api/system.net.webrequest?view=netfr uniquement HTTP et Json.Net pour la
amework-4.7.2) avec classe WebRequest et génération et l'analyse de contenus
Json.Net library
(https://www.newtonsoft.com/json)
GNU Wget (https://www.gnu.org/software/wget/) 1.20 Accès Web API pour des requêtes
Windows uniquement HTTP, par ex. l'archivage
automatique de DataLogs
cURL (https://curl.haxx.se/) 7.63.x
Windows
Microsoft PowerShell 5.0 Accès Web API pour des requêtes
uniquement HTTP avec Invoke-
WebRequest et ConvertTo-
Json/ConvertFrom-Json pour la géné-
ration et l'analyse de contenus
* non fourni avec le produit décrit ici
3.20.2 Méthodes Web API disponibles

Le chapitre suivant donne un aperçu de toutes les méthodes Web API disponibles avec des
extraits de code HTML correspondants.
Remarque
Les fichiers contenant les méthodes Web API doivent être codés en UTF-8 et enregistrés.
Vous trouverez des exemples complets pour une intégration de la Web API dans votre
application web au chapitre Intégration de Web API (Page 162).
Serveur Web
Pages Web
3.20.2.1 Api.Login
La méthode Api.Login vérifie les données de connexion de l'utilisateur et ouvre une nouvelle
session de Web API après une vérification réussie. La méthode demande le nom et le mot
de passe de l'utilisateur en texte clair comme justificatif. Le nom d'utilisateur et le mot de
passe sont ensuite transmis cryptés au serveur.
Exemple
L'exemple suivant montre les paramètres requis pour l'appel de la méthode Api.Login.
{
"user": "User1",
"password": "SecurePassword"
}
Une fois l'authentification réussie, l'utilisateur reçoit un jeton. Le jeton identifie l'utilisateur
comme utilisateur authentifié à l'API.
{
"token": "eG9mcHdhaGR0dWVsdm5teGFxcGw="
}
Jeton
Le jeton est composé d'une chaîne de 28 octets. Le jeton est transmis crypté.
Pour chaque requête supplémentaire demandant une authentification, vous devez indiquer
le jeton affecté. Si aucune communication n'a eu lieu entre-temps, le jeton devient invalide
après 2,5 minutes au plus. Chaque nouvelle requête dans une session augmente la validité
du jeton de 2 à 2,5 minutes (calculées à partir du début du traitement de la requête par le
serveur).
Le jeton n'est pas nécessaire pour les méthodes qui n'ont pas besoin d'authentification.
Vous pouvez cependant indiquer le jeton.
Par exemple, si vous appelez la méthode Api.Ping sans jeton, la session n'est pas prolongée
car la CPU n'est pas en mesure d'affecter un jeton à l'utilisateur.
Les méthodes suivantes fonctionnent avec un ou plusieurs jetons :
● Api.Browse
● Api.Ping
● Api.GetPermissions
Utilisateur "Tout le monde"

L'utilisateur "Tout le monde" est défini sans attribution d'un mot de passe.
Si vous souhaitez vous authentifier comme utilisateur "Tout le monde", envoyez un
utilisateur "Everybody" et un mot de passe vide ("").
Vous trouverez une description détaillée de l'utilisateur "Tout le monde" au chapitre
Configuration du serveur Web (Page 19).
Serveur Web
Pages Web
Messages d'erreur possibles

Le tableau suivant montre les messages d'erreur possibles de la méthode Api.Login.
Code d'er- Message d'erreur Signification

reur
100 Login failed Le nom d'utilisateur et/ou le mot de passe est incorrect. Affectez un nom d'utilisa-
teur et un mot de passe autorisés.
101 Already authenticated Le jeton X-Auth actuel est déjà authentifié. Utilisez Api.Logout avant de vous au-
thentifier de nouveau.
4 No resources Le système ne dispose pas des ressources nécessaires pour exécuter cette re-
quête.
Exécutez de nouveau la requête dès que les ressources disponibles sont suffi-
santes.
3.20.2.2 Api.GetPermissions
Une fois la connexion réalisée avec succès, la méthode Api.GetPermissions fournit une liste
d'actions que l'utilisateur est autorisé à exécuter.
Exemple
L'exemple suivant montre les actions que l'utilisateur est autorisé à exécuter.
[
{ "name": "read_value" },
{ "name": "change_operating_mode" }
]
Autorisations vérifiables
Avec la Web API, vous pouvez vérifier les autorisations pour les actions suivantes.
Action Autorisation utilisateur

read_diagnostics Interroger les données de diagnostic de la CPU sans pouvoir modifier les don-
nées
read_value Lire les données de process de la CPU
write_value Ecrire les données de processus sur la CPU
acknowledge_alarms Acquitter les alarmes
firmware_update Installer les mises à jour du firmware sur la CPU des modules de périphérie
centralisés et décentralisés
open_user_pages Appeler les pages utilisateur sur la CPU
read_file Lire le contenu des fichiers sur la CPU
write_file Modifier le contenu des fichiers et des dossiers sur la CPU
change_operating_mode Modification de l'état de fonctionnement
flash_leds Demander les données d'identification de l'appareil
backup_plc Sauvegarder la configuration de la CPU
restore_plc Restaurer la configuration de la CPU
failsafe_admin Procéder à des modifications de sécurité sur la CPU
Serveur Web
Pages Web
La Web API vérifie l'autorisation sur la base des droits et mots de passe affectés dans
STEP 7 sous "Serveur Web > Gestion des utilisateurs".
La gestion des utilisateurs est décrite au chapitre "Configuration du serveur Web (Page 19)".
3.20.2.3 Api.Browse
Avec la méthode Api.Browse, vous créez une liste de toutes les méthodes que vous pouvez
appeler via la Web API. Vous obtenez ainsi une vue d'ensemble de toutes les méthodes
prises en charge par la CPU.
Aucune autorisation n'est requise pour l'appel de la méthode Api.Browse.
Exemple
L'exemple suivant montre la requête HTTP et un résultat possible de la requête pour la
méthode Api.Browse.
POST /api/jsonrpc HTTP/1.1

Host: 192.168.3.14
Content-Type: application/json
Content-Length: 48
[{"jsonrpc":"2.0","method":"Api.Browse","id":1}]
Réponse du serveur :
[
{ "name": "Api.Browse" },
{ "name": "Api.GetCertificateUrl" },
{ "name": "Api.GetPermissions" },
{ "name": "Api.Login" },
{ "name": "Api.Logout" },
{ "name": "Api.Ping" },
{ "name": "Api.Version" },
{ "name": "PlcProgram.Browse" },
{ "name": "PlcProgram.Read" },
{ "name": "PlcProgram.Write" },
]
Remarque
Vérification des autorisations
La méthode Api.Browse ne filtre pas la liste des méthodes disponibles selon les
autorisations individuelles des utilisateurs.
La liste des méthodes disponibles peut donc contenir des méthodes que l'utilisateur ne peut
pas exécuter en raison d'autorisations insuffisantes.
Serveur Web
Pages Web

Le tableau suivant montre les messages d'erreur possibles de la méthode Api.Browse.

reur
4 No resources Le système ne dispose pas des ressources nécessaires pour exécuter la requête
Web API.
Exécutez de nouveau la requête dès que les ressources disponibles sont suffisantes.
3.20.2.4 Api.Version
Avec la méthode Api.Version, vous interrogez le numéro de version actuel de la Web API.
Le numéro de version donne des informations sur :
● des fonctions prises en charge par la version correspondante
● la version du matériel de la CPU
Ces informations vous permettent de mettre en oeuvre des applications dont l'éventail de
fonctions correspond à la CPU connectée.
Aucune autorisation n'est requise pour l'appel de la méthode Api.Version.
Exemple
L'exemple suivant montre un résultat possible de l'appel de la méthode Api.Version.
1.28
Le numéro de version est affiché sous forme de nombre à virgule flottante et est incrémenté
à chaque version et chaque modification de l'implémentation de la Web API.
3.20.2.5 Api.Ping
La méthode Api.Ping fournit une identification univoque pour la CPU utilisée. Il est ainsi
possible de déterminer si la CPU est accessible. L'identification de CPU est composée d'une
chaîne de 28 octets. Le système assigne à la CPU une nouvelle identification univoque
après chaque redémarrage (mise hors tension – mise sous tension) ou redémarrage à
chaud. En effectuant une comparaison avec l'ancienne identification affichée, vous pouvez
également déterminer si la CPU a été redémarrée entre-temps.
Aucune autorisation n'est requise pour l'appel de la méthode Api.Ping.
Exemple
L'exemple suivant montre l'indication d'une identification de CPU.
"ZWlmbnJwZmplb3Nwd2l1Y3N3dWE="
Serveur Web
Pages Web
3.20.2.6 Api.GetCertificateUrl
La méthode Api.GetCertificateUrl indique une URL (https://<IP>) relative avec laquelle vous
pouvez appeler le certificat SSL du serveur Web.
Exemple
L'exemple suivant montre le résultat de l'appel de la méthode Api.GetCertificateUrl.
"/MiniWebCA_Cer.crt"
La méthode fournit une chaîne de caractères avec une URL pour la CPU.
Si aucun certificat n'est disponible, la méthode résulte en une chaîne de caractères vide.
3.20.2.7 Api.Logout
La méthode Api.Logout supprime le jeton de la liste des sessions Web API actives et ferme
la session.
3.20.3 Intégration de Web API

Le chapitre suivant montre des exemples d'intégration de la Web-API dans votre application.
Structure d'une requête HTTP et d'une réponse HTTP

Le paragraphe suivant montre la structure requise d'une requête HTTP et d'une réponse
HTTP permettant une exécution correcte d'une requête Web API.
POST /api/jsonrpc HTTP/1.1

Host: 192.168.3.14
Content-Length: 92
[{"jsonrpc":"2.0","method":"Api.Login","params":{"user":"User1","pas
sword":"SecurePassword"},"id":999}]
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Expires: 0
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: Content-Type,X-Auth-Token
Access-Control-Allow-Methods: POST,OPTIONS
transfer-encoding: chunked
date: Tue, 23 Apr 2019 17:50:31 GMT
[{"jsonrpc":"2.0","id":999,"result":{"token":"Sy8pe3VNv86rTMldzFBsYz
mw12Lg"}}]
Serveur Web
Pages Web
Exemples de Web API

Le paragraphe suivant montre des exemples d'utilisation des méthodes décrites dans la
Web API.
Les exemples utilisent HTML, Json et JQuery library pour les requêtes asynchrones.
Remarque
Indications utilisées dans les exemples
Tenez compte du fait que l'indication des noms des méthodes, des paramètres et des codes
JavaScript est donnée sans garantie et peut être différente de la spécification actuelle.
Exemple 1
L'exemple 1 montre un client souhaitant maintenir une session avec JavaScript. Pour cela, il
envoie à l'aide de la méthode Api.Ping une unique requête Heartbeat. Si la fréquence
d'envoi de la requête Heartbeat est inférieure à à la durée du délai d'attente fixée à 2
minutes, l'utilisateur reste connecté en permanence.
La connexion permanente est à privilégier pour l'exécution des tâches de conduite et
supervision.
$.post({
url:"https://192.168.2.132/api/jsonrpc",
headers:{
'X-Auth-Token':"Sy8pe3VNv86rTMldzFBsYzmw12Lg"
},
data:JSON.stringify({jsonrpc:"2.0", method:"Api.Ping", id:1}),
success:function(data){ console.log(data); }
dataType:"text",
contentType:"application/json"
});
Remarque
X-Auth-Token
Pour prolonger la session, vous devez envoyer également le jeton (X-Auth Token) comme
HTTP-Header à la CPU.
Si vous appelez la méthode Api.Ping sans jeton, la session n'est pas prolongée car la CPU
n'est pas en mesure d'affecter un jeton à l'utilisateur.
L'exemple 3 montre un jeton dans la requête HTTP.
Dans l'exemple, l'utilisateur sélectionné dispose des autorisations nécessaires. Les

méthodes ont été exécutées avec succès après la requête de connexion, comme le montre
le résultat suivant.
{jsonrpc:"2.0",id:1,result:"ZWlmbnJwZmplb3Nwd2l1Y3N3dWE="}
Serveur Web
Pages Web
Exemple 2
L'exemple 2 montre un Client souhaitant se connecter à la CPU avec JavaScript et exécuter
plusieurs méthodes à l'aide d'une requête groupée.
$.post({
data:JSON.stringify([
{jsonrpc:"2.0", id:1, method:"Api.Login",
params:{user:"Admin",password:"12345"} },
{jsonrpc:"2.0", id:2, method:"Api.GetPermissions" },
{jsonrpc:"2.0", id:3, method:"Api.GetMethods" }]),
success: function(data){ console.log(data); },
dataType: "text",
contentType: "application/json"});
Le paragraphe suivant donne un exemple de réponse de la requête groupée. L'utilisateur

sélectionné dispose des autorisations nécessaires. Les méthodes ont été exécutées avec
succès avec les autorisations de l'utilisateur authentifié après la requête de connexion.
[
{jsonrpc:"2.0",id:1, result:{
token:"d29kamV3cGxtdm5keHNhcXd1aXJ0empkZXN3cQ=="}},
{jsonrpc:"2.0",id:2,result:[
"read_value",
"write_value",
"diagnostics"]},
{jsonrpc:"2.0",id:3,result:[
"Api.Login",
"Api.GetPermissions",
"Api.GetMethods",
"PlcProgram.Read",
"PlcProgram.Write",
"PlcProgram.Browse",
"Api.Logout",
"Api.Ping"]},
]
Serveur Web
Pages Web
Exemple 3
L'exemple 3 montre une requête groupée pour un accès en lecture et écriture à une pile de
variables dans une requête HTTP unique. Cette procédure est recommandée pour les
requêtes groupées car elle est plus performante qu'une série d'accès individuels et la CPU
est de ce fait moins sollicitée.
$.post({
data:JSON.stringify([
{jsonrpc:"2.0", id:1, method:"PlcProgram.Read",
params:{var:"\"MyDB\".InvalidField"},
params:{tag:"MyDB.MyDate"} },
{jsonrpc:"2.0", id:4, method:"PlcProgram.Write",
params:{tag:"\"BoilerControl\".TempSetPoint", value:9001} }]),
success: function(data){ console.log(data); },
dataType: "text",
contentType: "application/json",
headers: {
"X-Auth-Token":"d29kamV3cGxtdm5keHNhcXd1aXJ0empkZXN3cQ=="}});
La requête groupée contient une variable non valide, comme indiqué par un message
d'erreur. Toutes les autres méthodes ont été exécutées avec succès, comme le montre le
résultat suivant.
[
{jsonrpc:"2.0",id:1,result:{"value":42}},
{jsonrpc:"2.0",id:2,error:{code:-1,message:"Invalid tag name"}},
{jsonrpc:"2.0",id:3,result:{"value":"1990-01-01"}},
{jsonrpc:"2.0",id:4,result:true},
]
3.20.4 Sessions Web API
Délai d'attente pour sessions Web API
Remarque
Si aucun appel de Web API n'est effectué au sein d'une session pendant 120 secondes, la
CPU termine la session avec un événement de déconnexion. Chaque action réussie de
l'utilisateur au cours de laquelle un jeton a été envoyé réinitialise le délai d'attente.
Appelez la méthode Api.GetPermission ou Api.Ping de manière cyclique dans l'intervalle du
délai d'attente pour garantir :
• que votre session reste active ;
• que vos autorisations restent actives pour l'appel de méthodes supplémentaires.
Serveur Web
Pages Web
Limitations pour les sessions Web API

La CPU limite le nombre de sessions actives. Le tableau ci-après indique les limitations en
fonction de la plateforme utilisée.
CPU Limitation
S7-1510 à S7-1513 50
S7-1515 et S7-1516 100
S7-1517 et S7-1518 200
Limitation du nombre de sessions Web API actives
Si vous demandez un jeton d'authentification supplémentaire et que plus aucun jeton n'est
disponible, la requête est rejetée.
Modifications dans la gestion des utilisateurs de la CPU

Si la configuration de la gestion des utilisateurs de la CPU est modifiée (téléchargement de
la configuration matérielle dans TIA Portal), par exemple si le mot de passe est modifié ou si
des utilisateurs sont supprimés, la CPU termine toutes les sessions avec un événement de
déconnexion.
Événements de sécurité
La CPU génère un événement de sécurité pour des connexions et déconnexions exécutées
avec succès ou ayant échoué. La CPU inscrit l'événement de sécurité dans le tampon de
diagnostic.
3.20.5 Lecture et écriture des données de processus
3.20.5.1 Type de données supportés
Représentation binaire
La Web API représente les valeurs des types de données primitifs sous forme de données
binaires brutes ("raw"). Les données binaires sont au format JSON-Array (tableau JSON).
Chaque élément d'un tableau est une valeur numérique comprise entre 0 et 255 et
représente un octet de données.
Représentation simple ("simple")

La Web API fomate les types de données primitifs pour les rendre lisible tout en conservant
la possibilité de programmer les données. Le chapitre suivant décrit comment les types de
données primitifs sont représentés sous forme de types de données JSON.
Serveur Web
Pages Web
Type de données supportés

Le tableau suivant montre :
● les types de données pris en charge par la Web API pour la lecture et l'écriture des
valeurs du processus
● la représentation dans la Web API
● le type de données correspondant dans TIA Portal
Nom du type de don- Nom du type de don- Représentation dans Web API
nées dans TIA Portal nées dans Web API
Bool bool Valeur JSON booléenne : true ou false
Octet octet JSON Unsigned Integer dans un intervall de 0 à 255
USInt usint
Word word JSON Unsigned Integer dans un intervall de 0 à 65 535
UInt uint
HW_ANY hw_any
HW_IOSYSTEM hw_iosystem
HW_DPMASTER hw_dpmaster
HW_DEVICE hw_device
HW_DPSLAVE hw_dpslave
HW_IO hw_io
HW_MODULE hw_module
HW_SUBMODULE hw_submodule
HW_HSC hw_hsc
HW_PWM hw_pwm
HW_PTO hw_pto
HW_INTERFACE hw_interface
HW_IEPORT hw_ieport
CONN_ANY conn_any
CONN_PRG conn_prg
CONN_OUC conn_ouc
PORT port
RTM rtm_id
PIP pip
DB_ANY db_any
DB_WWW db_www
DB_DYN db_dyn
DWord dword JSON Unsigned Integer dans la plage de 0 à 4 294 967 295
UDInt udint
AOM_IDENT aom_ident
EVENT_ANY event_any
EVENT_ATT event_att
EVENT_HWINT event_hwint
Serveur Web
Pages Web
CONN_R_ID conn_r_id
LWord lword String JSON avec une représentation numérique d'un Unsigned Integer
ULInt ulint base 10 dans la plage valide de 0 à 18 446 744 073 709 551 615
SInt sint JSON Signed Integer dans la plage de -128 à 127

Int int JSON Signed Integer dans la plage de -32768 à 32 767
OB_ANY ob_any
OB_DELAY ob_delay
OB_TOD ob_tod
OB_CYCLIC ob_cyclic
OB_ATT ob_att
OB_PCYCLE ob_pcycle
OB_HWINT ob_hwint
OB_DIAG ob_diag
OB_TIMEERROR ob_timeerror
OB_STARTUP ob_startup
DInt dint JSON Signed Integer dans la plage de -2147483648 à 2 147 483 647.
LInt lint String JSON avec une représentation numérique d'un Unsigned Integer
base 10 dans la plage de -9 223 372 036 854 775, 808 à
9 223 372 036 854 775 807
Real real Nombre à virgule flottante JSON
LReal lreal Si le nombre réel est infini ou NaN (not-a-number), la Web API renvoie la
valeur nulle lors de la lecture d'une variable de ce type.
Character char String JSON avec un caractère ASCII unique dans la plage valide de 0 à
127
Si une variable de ce type est lue avec une valeur située en dehors de la
plage valide, la Web API renvoie la valeur nulle.
WChar wchar String JSON avec une chaîne de caractères UTF-8 qui représente un
seul caractère UCS-2 dans une plage valide de 0 à 55 295
Si une variable de ce type avec une valeur située en dehors de la plage
valide est lue, la Web API renvoie la valeur nulle.
String string String JSON avec une suite de caractères UTF-8
Si une variable de ce type est lue avec une valeur située en dehors de la
suite de caractères UTF-8 valide (longueur max. 254 caractères), la
Web API renvoie la valeur nulle.
WString wstring String JSON avec une chaîne de caractères UTF-8 qui représente une
suite de caractères UCS-2 dans la plage valide de 0 à 55 295
Si une variable de ce type est lue avec une valeur située en dehors de
l'intervalle valide (longueur max. 254 caractères), la Web API renvoie la
valeur nulle.
Date date JSON Unsigned Integer dans un intervall de 0 à 65 535
Cette valeur représente le nombre de jours depuis le 01.01.1990.
Time_Of_Day time_of_day JSON Unsigned Integer dans la plage de 0 à 4 294 967 295
Cette valeur représente le nombre de milisecondes depuis le début de la
journée.
Serveur Web
Pages Web
LTime_Of_Day ltime_of_day String JSON avec une représentation numérique d'un Unsigned Integer
base 10 dans la plage valide de 0 à 18 446 744 073 709 551 615
Cette valeur représente le nombre de nanosecondes depuis le début de
la journée.
Time time JSON Signed Integer dans la plage de -2147483648 à 2 147 483 647)
Cette valeur représente le nombre de milisecondes depuis un instant
défini par un utilisateur.
LTime ltime String JSON avec une représentation numérique d'un Unsigned Integer
base 10 dans la plage de -9 223 372 036 854 775 808 à
9 223 372 036 854 775 807
Cette valeur représente le nombre de nanosecondes depuis un instant
défini par un utilisateur.
S5Time s5time Objet JSON avec les clés basis et value:
• La valeur basis est un Unsigned Integer JSON avec une valeur égale
à 10, 100, 1000 ou 10 000.
La valeur basis représente le multiplicateur milisecondes de la valeur
value.
• La valeur value est un Unsigned Integer JSON dans la plage de 0 à
999.
La valeur basis multipliée par la valeur value donne l'intervalle de
temporisation (Timer) en milisecondes.
Date_And_Time date_and_time Objet JSON avec les keys year, month, date, hour, minute, second et
day_of_week :
• year est un Unsigned Integer JSON avec une valeur comprise entre
1990 à 2089
• month est un Unsigned Integer JSON avec une valeur comprise entre
1 à 12
• day est un Unsigned Integer JSON avec une valeur comprise entre 1
à 31
• hour est un Unsigned Integer JSON avec une valeur comprise entre 0
à 23
• minute est un Unsigned Integer JSON avec une valeur comprise entre
0 à 59
• second est un nombre à virgule flottante JSON avec une valeur com-
prise entre 0 à 60
• day_of_week est un JSON-String avec une valeur pouvant être sun,
mon, tue, wed, thu, fri ou sat
Serveur Web
Pages Web
LDT ldt String JSON avec une représentation numérique d'un Unsigned Integer
base 10 dans la plage valide de 0 à 18 446 744 073 709 551 615
Cette valeur représente le nombre de nanosecondes depuis le
01.01.1970 minuit (12:00:00.0 am).
Struct struct Type de données structuré dont la structure de données peut être déter-
IEC_COUNTER iec_counter minée par la méthode PlcProgram.Browse.
IEC_TIMER iec_timer
DTL dtl
IEC_LTIMER iec_ltimer
IEC_SCOUNTER iec_scounter
IEC_DCOUNTER iec_dcounter
IEC_LCOUNTER iec_lcounter
IEC_UCOUNTER iec_ucounter
IEC_USCOUNTER iec_uscounter
IEC_UDCOUNTER iec_udcounter
IEC_ULCOUNTER iec_ulcounter
ERROR_STRUCT error_struct
NREF nref
CREF cref
Arrays (tableaux)
Les tableaux sont représentés sous forme d'objets JSON. La clé (key) est une chaîne de
caractères (string) avec une représentation numérique de l'indice (index).
L'exemple suivant montre la représentation dans TIA Portal :
Figure 3-79 Représentation dans TIA Portal
Adressage des données utilisateur

La Web API prend en charge les formats d'adressage suivants :
● Adressage symbolique d'une variable dans la table des variables, p. ex. Tag_1
● Adressage symbolique d'une variable dans un bloc de données, p. ex. "MyDB".Static_1
Serveur Web
Pages Web
3.20.5.2 Paramétrage des propriétés du bloc
Paramétrer l'accès à la Web API dans TIA Portal

Afin de limiter l'accès en lecture et écriture aux blocs de données du projet, vous pouvez
définir les paramètres voulus dans les attributs du bloc.
Pour autoriser la Web API à accéder au bloc de données, activez la case d'option "DB
accessible from Webserver".
Remarque
Blocs F
Veuillez noter que les blocs F n'autorisent qu'un accès en lecture seule. L'écriture de
variables dans les blocs F n'est pas possible.
Paramétrer l'accès à la Web API dans les tables des variables

Pour permettre un accès de la Web API aux variables en lecture et écriture, les options
"Accessible from HMI/OPC UA/Web API" et "Writable from HMI/OPC UA/Web API" doivent
être activées :
Figure 3-80 Table des variables dans TIA Portal
3.20.5.3 PlcProgram.Read
La méthode PlcProgram.Read permet de lire les données de processus de la CPU.
Pour appeler la méthode PlcProgram.Read, vous devez disposer de l'autorisation
"read_value".
Serveur Web
Pages Web
Structure de la requête
Le tableau suivant fournit les propriétés de la variable à lire.
Nom requise Type de données Description

"var" oui String Nom de la variable à lire
"mode" en option, la valeur String Énumération qui définit le format de réponse pour cette méthode :
par défaut est
• "simple": renvoie les valeurs de variables selon la représenta-
"simple"
tion "simple" au chapitre "Type de données supportés
(Page 166)"
• "raw": renvoie les valeurs de variables selon la représentation
"raw" au chapitre "Types de données pris en charge"
Exemples
Dans l'exemple suivant, l'utilisateur demande une variable globale dans la représentation
"simple".
{
"var": "\"MotorSpeed\""
}
Dans l'exemple suivant, l'utilisateur demande une variable d'un bloc de données dans la
représentation "raw".
{
"var": "\"MyDB\".MyVariable",
"mode": "raw"
}
Structure de la réponse
Si la demande a réussi, le serveur renvoie des valeurs de données JSON.
Exemples
L'exemple suivant montre le résultat de la lecture d'une variable de type "int" dans la
représentation "simple".
-42
L'exemple suivant montre le résultat de la lecture d'une variable de type "dword" dans la
représentation "raw".
[ 1, 47, 233, 0 ]
Serveur Web
Pages Web

Le tableau suivant montre les messages d'erreur possibles de la méthode PlcProgram.Read.

reur
1 Internal error Une erreur interne est survenue lors de la tentative d'exécution de l'opération deman-
dée.
2 Permission denied Le jeton d'authentification actuel n'est pas autorisé à appeler cette méthode.
Connectez-vous avec un compte utilisateur qui dispose des autorisations suffisantes
pour appeler cette méthode.
4 No resources Le système ne dispose pas des ressources nécessaires pour lire l'adresse requise.
200 Address does not L'adresse demandée n'existe pas ou le serveur web ne peut pas y accéder.
exist
201 Invalid address La composition du nom de l'adresse symbolique est incorrecte.
203 Invalid array index Les dimensions et les limites des indices du tableau ne correspondent pas aux informa-
tions de type de la CPU.
204 Unsupported ad- Le type de données de l'adresse ne peut pas être lu.
dress
3.20.5.4 PlcProgram.Write
La méthode PlcProgram.Write permet d'écrire les données de processus sur la CPU.
Pour appeler la méthode PlcProgram.Write, vous devez disposer de l'autorisation
"write_value".
Le tableau suivant fournit les propriétés de la variable à écrire.

"var" oui String Nom de la variable à écrire
"value" oui Variant Valeur à écrire ; la valeur dépend du mode de fonctionne-
ment
"mode" en option, la va- Bool Énumération qui définit le format de "value" :
leur par défaut est
• "simple": l'utilisateur doit spécifier les valeurs conformé-
"simple"
ment à la représentation "simple" (voir chapitre "Types
de données pris en charge")
• "raw": l'utilisateur doit spécifier les valeurs conformé-
ment à la représentation "raw" (voir chapitre "Types de
données pris en charge")
Serveur Web
Pages Web
Exemples
Dans l'exemple suivant, l'utilisateur écrit une variable globale dans la représentation
"simple".
{
"var": "\"MotorSpeed\"",
"value": 9001
}
Dans l'exemple suivant, l'utilisateur écrit une variable globale dans la représentation "raw".
{
"var": "\"MyDB\".MyVariable",
"value": [ 255, 77, 1, 99 ],
"mode": "raw"
}
Dans l'exemple suivant, l'utilisateur écrit une variable String de 10 caractères dans la
{
"var": "\"MyDB\".MyString",
"value": "Short Str",
"mode": "simple"
}
Dans l'exemple suivant, l'utilisateur écrit une variable String de 10 caractères avec le texte
"Short Str" dans la représentation "raw".
{
"var": "\"MyDB\".MyString",
"value": [ 10, 9, 83, 104, 111, 114, 116, 32, 83, 116, 114, 0 ],
"mode": "raw"
}
Dans l'exemple suivant, l'utilisateur écrit une variable Wstring de 6 caractères dans la
{
"var": "\"MyDB\".MyWString",
"value": "Bonjour",
"mode": "simple"
}
Serveur Web
Pages Web
Dans l'exemple suivant, l'utilisateur écrit une variable String de 6 caractères avec le texte
"Hello" dans la représentation "raw" :
{
"var": "\"MyDB\".MyWString",
"value": [ 0, 6, 0, 5, 0, 72, 0, 101, 0, 108, 0, 108, 0, 111, 0, 0
],
"mode": "raw"
}
Si l'opération d'écriture est un succès, le serveur renvoie la valeur booléenne "true".

Le tableau suivant montre les messages d'erreur possibles de la méthode PlcProgram.Read.

reur
1 Internal error Une erreur interne est survenue lors de la tentative d'exécution de l'opération deman-
dée.
4 No resources Le système ne dispose pas des ressources nécessaires pour lire l'adresse requise.
exist
204 Unsupported ad- Le type de données de l'adresse ne peut pas être écrit.
dress
3.20.5.5 PlcProgram.Browse
La méthode PlcProgram.Browse permet de rechercher des variables et les métadonnées
correspondantes en fonction de vos propres critères.
Pour appeler la méthode PlcProgram.Browse, vous devez disposer de l'autorisation
"read_value".
Serveur Web
Pages Web
Le tableau suivant fournit les propriétés de la variable à rechercher.
Nom requise Type de Description

données
"var" voir colonne String Nom de la variable à rechercher
"Description "
• Si "mode" ="var", cet attribut est requis. La méthode de navigation
recherche la variable pour trouver ses métadonnées.
• Si "mode" ="children", cet attribut est facultatif. La méthode de navi-
gation recherche la variable et renvoie une liste de variables enfant
et de métadonnées.
"mode" oui String Énumération qui définit le comportement de cette méthode :
• "var": fournit des informations sur la variable spécifiée.
• "children": fournit des informations sur les héritiers (children) directs
de la variable spécifiée.
Exemple 1
Dans l'exemple suivante, l'utilisateur effectue une recherche dans le noeud racine de la
CPU.
{
"mode": "children"
}
L'exemple suivant montre une réponse possible du serveur.
[
{
"name": "TestDB",
"has_children": true,
"db_number": 2,
"datatype": "datablock"
},
{
"name": "GenUsrMsg_Ret",
"address": "%MW43",
"area": "M",
"datatype": "int"
}
]
Serveur Web
Pages Web
Exemple 2
Dans l'exemple suivant, l'utilisateur recherche les héritiers (children) d'un bloc de données.
{
"var": "\"MyDB\"",
"mode": "children"
}
[
{
"name": "Static_1",
"db_number": 1,
"datatype": "int"
},
{
"name": "Static_2",
"db_number": 1,
"datatype": "int"
}
]
Exemple 3
Dans l'exemple suivant, l'utilisateur recherche des informations sur une variable spécifique.
{
"var": "\"MyDB\".MyStruct.MyField",
"mode": "var"
}
[
{
"name": "MyDateTimeValue",
"db_number": 2,
"datatype": "date_and_time",
"array_dimensions": [
{
"start_index": 0,
"count": 3
}
]
}
]
Serveur Web
Pages Web
Les tables suivantes montrent la structure des réponses du serveur aux requêtes qui ont
abouti.
PlcProgram_Browse_Response (Objekt-Array)
name oui string Nom de variable ; utilisable comme identificateur de chaîne
pour le champ
address non string Adresse de la variable dans STEP 7 ; uniquement pour les
variables dans les plages M, I, Q, temporisations et compteurs
et les variables dans les blocs de données non optimisés
La représentation correspond aux adresses des tables de vi-
sualisation dans TIA Portal.
read_only non bool Requête visant à vérifier s'il s'agit d'une variable en lecture
seule
La seule valeur valide est "true".
Si la variable est accessible en écriture, cet attribut ne s'affiche
pas.
has_children non bool Requête visant à vérifier qu'il s'agit d'une variable structurée
avec des variables enfant
La seule valeur valide est "true".
Si la variable est d'un type de données non structuré, cet attri-
but ne s'affiche pas.
db_number non integer Identificateur de bloc de données numérique ;
s'affiche si "datatype" = "datablock" et pour chaque élément
enfant d'un bloc de données (avec le numéro de bloc corres-
pondant)
area non string lettre définisant la plage de la variable (M/I/Q/Timer/Counter)
Si la variable ne se trouve pas dans une de ces zones, l'attribut
ne s'affiche pas.
datatype oui string Type de données de la variable
Pour les blocs de données, il s'agit du type de données "data-
block" ; pour les variables, voir la table au chapitre "Types de
données pris en charge".
Si le type de données n'est pas pris en charge, le type de don-
nées est "unsupported".
max_length non integer Si le type de données est "string" ou "wstring", cette valeur
représente le nombre maximal de caractères autorisé dans la
variable.
ar- non PlcPro- Tableaux objet, classés par dimension de tableau, de la plus
ray_dimensions gram_Browse_ élevée à la plus basse.
Res- L'attribut s'affiche uniquement si la variable est de type tableau
ponse_ArrayData (array).
Serveur Web
Pages Web
PlcProgram_Browse_Response_ArrayData (Array objet)

start_index oui integer Startindex pour cette dimension de tableau comme spécifié
dans le projet TIA Portal
count oui integer Nombre d'éléments dans cette dimension de tableau

Le tableau suivant montre les messages d'erreur possibles de la méthode
PlcProgram.Browse.

reur
3 System is busy Impossible d'exécuter l'opération voulue car le système exécute actuellement une autre
requête.
Relancez la demande une fois que l'opération en cours est terminée.
4 No resources Le système ne dispose pas des ressources nécessaires pour appeler l'information de
type.
exist
202 Variable is not a La recherche de l'adresse spécifiée n'est pas possible car la variable n'est pas un type
structure de données structuré.
Serveur Web
Pages Web
3.20.6 Page Web pour la conduite et supervision d'une éolienne
Exemple de page utilisateur

Voici une page utilisateur pour la conduite et supervision d'une éolienne :
Cet exemple de page est en anglais, mais vous pouvez bien sûr utiliser n'importe quelle
langue lorsque vous concevez vos propres pages utilisateur.
Serveur Web
Pages Web
Avec les autorisations appropriées, vous pouvez accéder en lecture et écriture aux
paramètres de l'éolienne via la Web API.
Figure 3-82 Vue d'ensemble d'une page utilisateur pour une éolienne après connexion
Fichiers utilisés
Dans cet exemple, les données suivantes ont été utilisées :
● api.css: feuille de style en cascade qui contient les règles de formatage de la page
utilisateur. L'utilisation d'une feuille de style en cascade est facultative, mais elle peut
simplifier la conception de la page utilisateur.
● index.html: page utilisateur dans la représentation ci-dessus.
● api.js: exemple d'utilisation de Web API dans JavaScript
● Wind_turbine.jpg: image d'arrière-plan affichée sur la page utilisateur. L'utilisation
d'images est facultative. Les pages personnalisées contenant de nombreuses images
occupent un volume important dans la mémoire de chargement.
Les paragraphes suivants regroupent les exemples de code dans les fichiers mentionnés qui
sont requis pour la réalisation de la page utilisateur.
Serveur Web
Pages Web
api.css
.modal {
display: block;
position: absolute;
background-color: #f1f1f1;
min-width: 160px;
max-height: 600px;
border-radius: 0.8rem;
overflow-y: auto;
padding: 20px;
box-shadow: 0px 8px 16px 0px rgba(0, 0, 0, 0.2);
top: 30%;
left: 50%;
z-index: 10;
transform: translate(-50%, -50%);
}
.login {
display: flex;
flex-direction: column;
}
body {
background-image: url("S_Kent_0005.jpeg");
background-position: 0% 0%;
background-repeat: no-repeat;
background-size: cover;
}
#browserarea {
resize: none;
}
.tag-table {
border-style: dashed;
border-radius: 15px;
background:rgba(255, 255, 255, 0.7);

padding: 10px;
width: 80vw;
}
body {
font-family: 'Courier New', Courier, monospace
/* text-shadow: -1px 0 white, 0 1px white, 1px 0 white, 0 -1px
white; */
}
Serveur Web
Pages Web
index.html
<html>
<head>
<meta charset="UTF-8">
<title>[example] Turbine controls</title>
<link rel="stylesheet" href="example_api.css" />
<script src="api.js"></script>
</head>
<body>
<span id="notice" style="display: inline-block">Please log in

first</span><br>
<button id="btn-login" onclick="openModal()"> Login </button>
<button id="btn-logout" onclick="apiLogout()" hidden> Log out
</button>
<h1> Example controls for the turbine <span id="turbine-

number">#</span> </h1>
Turbine speed: <input id="turb-speed" readonly > <button

onclick="updateTurbineSpeed()">Get current value</button><br>
Turbine speed (SP): <input id="turb-speed-sp" value="Not set"
onchange="turbSpeed(this)" autocomplete="off"><br>
Turbine manual control:
<select onchange="turbineSpeedOverride(this)"
autocomplete="off">
<option value=""></option>
<option value="false">NO</option>
<option value="true">YES</option>
</select>
<br>
<h2>Read/Write multiple values</h2>

<table id="tag-table-read" class="tag-table">
<tr>
<th align="left">Turbine safe operating values</th>
<th align="left">Safe Values</th>
<th align="left">Update with values</th>
</tr>
<tr>
<td>Turbine speed</td>
<td id="turb-speed-val"></td>
<td><input id="turb-speed-max-sp"></td>
</tr>
<tr>
<td>Turbine acceleration</td>
<td id="turb-accel-val"></td>
<td ><input id="turb-accel-max-sp"></td>
</tr>
<tr>
<td>Turbine jerk</td>
<td id="turb-jerk-val"></td>
<td><input id="turb-jerk-max-sp"></td>
</tr>
</table><br>
Serveur Web
Pages Web
<button onclick="bulkReadValues()">Get current values</button>

<button onclick="bulkWriteValues()">Update with desired
values</button>
<br>
You are using Api version: <span id="version-label"></span>
<div id="example-modal" class="modal">

<div class="login">
<h2>Login</h2>
<p> You have to login as user to interact with the API</p>
Username: <input id="username" type="text"></input>
Pasword: <input id="userpassword" type="password"></input>
<button onClick="apiLogin()">Submit</button>
<button type="cancel" onClick='closeModal()'>Cancel</button>
The IP address of the PLC:
<input id="target-ip" value="https://<ip-address>"
type="text" autocomplete=off onchange="changeIp(this)"></input>
</div>
</div>
</body>
</html>
api.js
"use-strict"
let messageId = 1
let TARGET_IP = "https://192.168.2.132/api/jsonrpc"
let AUTH_TOKEN = null
function ping() {
if (AUTH_TOKEN !== null) {
fetch(TARGET_IP, {
method: "POST",
headers: {
"Content-type": "application/json",
"X-Auth-Token": AUTH_TOKEN
},
body: JSON.stringify({
"id": messageId++,
"jsonrpc": "2.0",
"method": "Api.Ping"
})
})
}
}
setInterval(ping, 50000)
function updateTurbineSpeed() {
fetch(TARGET_IP, {
Serveur Web
Pages Web
method: "POST",
headers: {
},
"id": messageId++,
"jsonrpc": "2.0",
"method": "PlcProgram.Read",
"params": {
"var": "\"turbine_speed\""
}
})
})
.then(response => response.json())
.then((data) => {
let turbNum = document.getElementById("turb-speed")
turbNum.value = data.result
})
.catch(e => console.error(e))
}
}
function turbSpeed() {
let turbSp = document.getElementById("turb-speed-sp")
fetch(TARGET_IP, {
method: "POST",
headers: {
},
"id": messageId++,
"jsonrpc": "2.0",
"method": "PlcProgram.Write",
"params": {
"var": "\"turbine_speed_sp\"",
"value": parseFloat(turbSp.value)
}
})
})
.then((data) => {
if (data.result) {
console.log("Api responds with " + data.result)
}
else
{throw "Something happened while writing value"
}
})
}
}
Serveur Web
Pages Web
function getTurbineNumber() {
let label = document.getElementById("turbine-number")
fetch(TARGET_IP, {
method: "POST",
headers: {
},
"id": messageId++,
"jsonrpc": "2.0",
"params": {
"var": "\"turbineNumber\""
}
})
})
.then((data) => {
label.innerHTML = data.result
})
}
function turbineSpeedOverride(element) {
fetch(TARGET_IP, {
method: "POST",
headers: {
},
"id": messageId++, // id can be omitted, in that case it is
a notification request
"jsonrpc": "2.0",
"params": {
"var": "\"turbine_speed_override\"",
"value": (element.value === "true")
}
})
})
.then((data) => {
if (data.result) {
console.log("Api responds with " + data.result)
}
else {
throw "Something happened while writing value"
}
})
}
Serveur Web
Pages Web
}
function apiLogin() {
let input_user = document.getElementById("username").value

let input_password = document.getElementById("userpassword").value
fetch(TARGET_IP, {
method: "POST",
headers: {
},
"id": messageId++,
"jsonrpc": "2.0",
"method": "Api.Login",
"params": {
user: input_user,
password: input_password
}
})
})
.then((data) => {
AUTH_TOKEN = data.result.token
document.getElementById("notice").innerHTML = "You are logged
in"
getApiVersion()
getTurbineNumber()
bulkReadValues()
showBtn("btn-logout")
hideBtn("btn-login")
closeModal()
})
}
function bulkReadValues() {

let turbSpeedMax = document.getElementById("turb-speed-val")
let turbAccelMax = document.getElementById("turb-accel-val")
let turbJerkMax = document.getElementById("turb-jerk-val")
fetch(TARGET_IP, {
method: "POST",
headers: {
},
body: JSON.stringify([
{
"id": messageId++,
Serveur Web
Pages Web
"jsonrpc": "2.0",
"params": {
"var": "\"turbine_max_speed\""
}
},
{
"id": messageId++,
"jsonrpc": "2.0",
"params": {
"var": "\"turbine_max_acceleration\""
}
},
{
"id": messageId++,
"jsonrpc": "2.0",
"params": {
"var": "\"turbine_max_jerk\""
}
}])
})
.then((data) => {
turbSpeedMax.innerHTML = data[0].result
turbAccelMax.innerHTML = data[1].result
turbJerkMax.innerHTML = data[2].result
})
}
}
function bulkWriteValues() {

let turbSpeedMaxSp = document.getElementById("turb-speed-max-
sp")
let turbAccelMaxSp = document.getElementById("turb-accel-max-
sp")
let turbJerkMaxSp = document.getElementById("turb-jerk-max-sp")
fetch(TARGET_IP, {
method: "POST",
headers: {
},
body: JSON.stringify([
{
"id": messageId++,
"jsonrpc": "2.0",
"params": {
"var": "\"turbine_max_speed\"",
Serveur Web
Pages Web
"value": parseFloat(turbSpeedMaxSp.value)
}
},
{
"id": messageId++,
"jsonrpc": "2.0",
"params": {
"var": "\"turbine_max_acceleration\"",
"value": parseFloat(turbAccelMaxSp.value)
}
},
{
"id": messageId++,
"jsonrpc": "2.0",
"params": {
"var": "\"turbine_max_jerk\"",
"value": parseFloat(turbJerkMaxSp.value)
}
}])
})
.then((data) => {
bulkReadValues()
})
}
}
function getApiVersion() {
let label = document.getElementById("version-label")
fetch(TARGET_IP, {
method: "POST",
headers: {
},
"id": messageId++,
"jsonrpc": "2.0",
"method": "Api.Version"
})
})
.then((data) => {
label.innerHTML = data.result
})
}
function browseRoot() {
let textarea = document.getElementById("browserarea")
fetch(TARGET_IP, {
Serveur Web
Pages Web
method: "POST",
headers: {
},
"id": messageId++,
"jsonrpc": "2.0",
"method": "PlcProgram.Browse",
"params": {
"mode": "children"
}
})
})
.then((data) => {
textarea.value = JSON.stringify(data.result, null, 4)
})
}
function apiLogout() {
fetch(TARGET_IP, {
method: "POST",
headers: {
},
"id": messageId++,
"jsonrpc": "2.0",
"method": "Api.Logout",
})
})
.then((data) => {
AUTH_TOKEN = null
openModal()
hideBtn("btn-logout")
showBtn("btn-login")
document.getElementById("notice").innerHTML = "Please log in
first"
})
}
function changeIp(element) {
TARGET_IP = `${element.value}/api/jsonrpc
.replace("//api", "/api")
}
function closeModal() {
let modal = document.getElementById("example-modal")
modal.style.display = "none"
Serveur Web
Pages Web
function openModal() {
modal.style.display = "block"
}
function closeModal() {
modal.style.display = "none"
}
function hideBtn(btnId) {
let btn = document.getElementById(btnId)
btn.style.display = "none"
}
function showBtn(btnId) {
let btn = document.getElementById(btnId)
btn.style.display = "block"
}
function openModal() {
alert("Already logged in.")
}
else {
modal.style.display = "block"
}
}
Serveur Web
Glossaire
Abonné
Appareil capable d'émettre, recevoir ou amplifier des données via le bus, p. ex. un contrôleur
IO.
AWP
Automation Web Programming
Commande AWP
Syntaxe des commandes spéciale permettant d'échanger des données entre la CPU et le
fichier HTML.
Composant PROFINET
Un composant PROFINET englobe toutes les données de la configuration matérielle, les
paramètres des modules ainsi que le programme utilisateur associé. Le composant
PROFINET se compose de :
● Fonction technologique
La fonction technologique (fonction logicielle en option) comprend les interfaces vers les
autres composants PROFINET sous forme d'entrées et de sorties connectables.
● Appareil
L'appareil est la représentation de l'automate physique ou de l'appareil de terrain y
compris la périphérie, les capteurs et actionneurs, la mécanique et le firmware des
appareils.
Configuration
Positionnement systématique des divers modules (structure).
CSS
Un CSS (Cascading Style Sheets) définit comment une sélection ou un contenu dans HTML
est représenté.
Serveur Web
Glossaire
Diagnostic
Le diagnostic réalise la détection, la localisation, la classification, l'affichage ainsi que
l'exploitation d'erreurs, de défaillances et de messages.
Le diagnostic dispose de fonctions de surveillance qui s'exécutent automatiquement durant
le fonctionnement de l'installation. Ainsi, la disponibilité des installations s'accroît grâce à la
diminution des temps de mise en service et des temps d'arrêt.
Données d'identification
Les données d'identification sont des informations enregistrées dans un module qui aident
l'utilisateur
● à vérifier la configuration de l'installation,
● à rechercher des modifications matérielles d'une installation,
● à corriger des erreurs dans une installation.
Les données d'identification permettent d'identifier de manière univoque des modules en
ligne.
HTTP
Hypertext Transfer Protocol (HTTP). Journal de transfert de données sur un réseau.
HTTPS
Hypertext Transfer Protocol Secure (HTTPS). Protocole garantissant le transfert sécurisé de
données sensibles via un réseau.
Maître
Lorsqu'il est en possession du jeton, le maître est un abonné actif. Le maître peut envoyer
des données à d'autres abonnés et en recevoir de ces derniers.
Navigateur Web
Les navigateurs Web sont des programmes de visualisation de pages Web capables de
communiquer avec des serveurs Internet.
Les navigateurs Web typiques sont :
● Microsoft Internet Explorer
● Mozilla Firefox
Serveur Web
Glossaire
Pare-feu
Le pare-feu sert à limiter l'accès au réseau et aux services utilisés sur la base d'une adresse
source et cible définies. Lors de l'échange de données, le pare-feu décide de bloquer ou
d'autoriser des paquets de données qui transitent par le pare-feu en fonction de règles
définies. Le pare-feu permet ainsi de protéger le réseau de toute tentative d'accès au réseau
non autorisée.
La fonction d'un pare-feu ne consiste pas à détecter des attaques. Il sert exclusivement à
mettre en œuvre les règles définies pour la communication sur le réseau.
PROFIBUS
PROcess FIeld BUS, norme de processus et de bus de terrain, définie dans la norme
CEI 61784-1:2002 Ed1 CP 3/1. Cette norme spécifie des propriétés fonctionnelles,
électriques et mécaniques pour un système de bus de terrain sériel.
PROFIBUS existe avec les protocoles DP (= périphérie décentralisée), FMS (= Fieldbus
Message Specification), PA (automatisation de process) ou TF (= fonctions technologiques).
PROFINET
Dans le cadre de la Totally Integrated Automation (TIA), PROFINET est le prolongement
logique de :
● PROFIBUS DP, le bus de terrain établi
● et Industrial Ethernet, le bus de communication pour le niveau de la cellule.
Les acquis des deux systèmes ont été et continueront à être intégrés dans PROFINET.
En tant que standard d'automatisation conçu sur la base d'Ethernet par PROFIBUS
International (anciennement PROFIBUS Nutzerorganisation e.V.), PROFINET est un modèle
non propriétaire de communication, d'automatisation et d'ingénierie.
PROFINET IO
Dans le cadre de PROFINET, PROFINET IO est un concept de communication permettant
de réaliser des applications décentralisées modulaires.
PROFINET IO vous permet de réaliser des projets d'automatisation comme vous le faisiez
sous PROFIBUS.
La mise en œuvre de PROFINET IO s'effectue d'une part via la norme PROFINET pour
automates et d'autre part via l'outil d'ingénierie STEP 7.
Cela signifie que la vue d'application dans STEP 7 reste la même, que vous configuriez des
appareils PROFINET ou PROFIBUS. La programmation du programme utilisateur est
identique pour PROFINET IO et pour PROFIBUS DP si vous utilisez les blocs et les listes
d'état système élargis pour PROFINET IO.
Serveur Web
Glossaire
PROFINET IO-Controller
Appareil servant à accéder aux périphériques IO raccordés. Autrement dit, le contrôleur IO
échange des signaux d'entrée et de sortie avec des appareils de terrain affectés. Le
contrôleur IO est souvent l'automate dans lequel s'exécute le programme d'automatisation.
PROFINET IO-Device
Appareil de terrain décentralisé affecté à un contrôleur IO (p. ex. Remote IO, îlot de vannes,
inverseurs de fréquence, switches).
Système d'automatisation
Un système d’automatisation est un automate programmable qui se compose d'au moins
une CPU, de différents modules d'entrée et de sortie ainsi que de stations de
contrôle/commande.
URL
Uniform Resource Locator (URL). Identifie et localise une source, comme p. ex. une page
Web de manière unique via la méthode d'accès à utiliser ainsi que l'emplacement de la
source dans des réseaux d'ordinateurs.
UTF-8
Abréviation pour le format de transformation UCS (jeu universel de caractères JUC) de
codage de caractères sur 8 bits. Standard de codage de caractères unicodes le plus utilisé.
A chaque caractère unicode est assignée une chaîne d'octets codée spécifique de longueur
variable. UTF-8 autorise jusqu'à quatre octets permettant de représenter tous les caractères
unicodes.
Serveur Web
Index
A D
Accès Web De sécurité, 49
via appareils IHM et terminaux portables, 18 Diagnostic (Motion Control), 51
via PG/PC, 18 Diagramme de courbes (Trace), 96
activer le serveur Web, 20
Actualisation automatique, 25
Actualiser et enregistrer E
Sauvegarder les alarmes, 66
Enregistrements Trace, 93
Sauvegarder les entrées du tampon de
État de mouvement, 53
diagnostic, 51
Affichage de textes dans différentes langues, 30
F
B FAQ
Accès au serveur Web via un Smartphone, 19
Bits d'état et d'erreur, 53
Actualiser automatiquement les pages Web, 122
Intégrer des pages Web avec des noms de chemins
relatifs, 122
C
Page utilisateur comme page d'accueil, 140
Certificat Télécharger un certificat, 24
Certificat de serveur Web, 21 Filebrowser, 151
Certificat auto-signé, 21 Fichiers système, 151
Certificat CA, 21 Fonctions de sécurité, 15
Certificat de serveur Web
Créer et affecter, 21
Certificat spécifique à la CPU, 21 G
Commandes AWP, 122
Gestion des utilisateurs, 26
Fragments, 130
Gestionnaire de certificats
Structures, 134
Certificat global signé par une CA, 22
Tableaux, 132
Certificat local spécifique à la CPU, 22
Types d'énumérations, 128
Paramètres de sécurité généraux, 22
Variables API, 124, 126
Groupes d'exécution F, 49
Variables spéciales, 127
communication, 66
Communication
H
Liaisons, 70
Paramètres, 67 HTTPS, 23
Ressources, 69
Statistiques, 68
Configuration I
restaurer, 86
Identification, 40
sauvegarder, 86
Diagnostic, 40
État du module, 60
Informations sur l'exécution, 43
Serveur Web
Index
L Paramétrages de la langue, 29
Paramètres de sécurité généraux, 22
Langue de l'interface
Protection contre la copie, 41
à affecter à une langue de projet, 31
Protection du programme, 41
paramétrer, 34
Protection Know-How, 41
Langue du serveur Web, 26
Langues d'Asie orientale, 30
Lecture des données de maintenance, 152
R
Lien, 41
Limitation d'accès, 29 Restauration de la configuration, 89
Lire des variables API
Variables de type String et Character, 124
Variables String ou Character dans des S
expressions, 125
Sauvegarde de la configuration, 87
Vue d'ensemble, 124
Sélectionner des objets technologiques, 57
Serveur Web
Certificat, 21
M
Propriétés, 15
Mémoire, 42 Serveur Web - pages Web
Mémoire tampon de diagnostic, 50 État des variables, 81
Messages, 65 Table de visualisation, 84
Mesures (Trace), 95 Statistiques
Mettre à jour et enregistrer, 32 Communication, 68
Désactivation de l'actualisation automatique, 32 État du module, 60
Impression de pages Web, 32
Mise à jour des pages utilisateur, 121
Mise à jour du firmware, 62 T
Motion Control
Table de signaux (Trace), 100, 100
Diagnostic, 51
Topologie, 71
Vue d'ensemble de service, 51
Exemples, 78
Topologie prévue, 71
Topologie réelle, 71
N
Vue d'ensemble d'état, 77
Navigateur Web, 16 Vue graphique, 72
Vue tabellaire, 75
O
V
Objets technologiques
États, défauts, alarmes technologiques, 51 Variables
écrire, 82, 85
Vue d'ensemble de service, 55
P
Page d'accueil, 33
Connexion, 37
Déconnexion, 37
Intro, 33
Pages utilisateur, 28, 119
Configurer des pages utilisateur, 135
Instruction WWW, 136
Page utilisateur comme page d'accueil, 138
Page utilisateur exemple, 141
Serveur Web

s71500 Webserver Function Manual FR-FR FR-FR PDF

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

s71500 Webserver Function Manual FR-FR FR-FR PDF

Загружено:

Авторское право:

Доступные форматы

Serveur Web

Siemens AG A5E03484626-AG Copyright © Siemens AG 2012 - 2019.

Objet de cette documentation

Connaissances de base requises

Domaine de validité de la documentation

la Web API prend en charge exclusi-

Note relative à la sécurité

Siemens Industry Online Support

3.16 Pages utilisateur................................................................................................................... 119

Informations sur les appareils

Collection de manuels (Manual Collections)

Utilisation du serveur Web

Activer le serveur Web

● Etat des variables (Page 81)

Accès Web à la CPU via PG/PC, appareils IHM et terminaux mobiles

2.2 Configuration du serveur Web

Figure 2-1 Configuration du serveur web dans STEP 7

Activer le serveur Web sur le module

Création et affectation du certificat du serveur Web

Vous pouvez créer différents certificats de serveur Web :

Créer un certificat de serveur Web auto-signé

Création et affectation du certificat de serveur Web signé par une CA

2. Connectez-vous en tant qu'utilisateur dans la zone "Paramètres de sécurité généraux >

7. Confirmez par "OK".

Autoriser l'accès uniquement via HTTPS

● L'adresse IP de la CPU doit être attribuée.

Activer la mise à jour automatique

Choix de la langue du Web

Compléter la gestion des utilisateurs

Figure 2-3 Gestion des utilisateurs dans STEP 7

Figure 2-4 Attribution des droits d'utilisateurs dans STEP 7

Utilisateur "Tout le monde"

Activation du serveur Web pour chaque interface

Figure 2-5 Activation de l'accès au serveur Web via les interfaces

2.3 Paramétrages de la langue

Conditions pour que les langues d'Asie orientale soient disponibles

Condition pour l'affichage de textes dans différentes langues

Choix de la langue du Web

Figure 2-6 Sélection de la langue pour le serveur web dans STEP 7

2.4 Mettre à jour et mémoriser les informations

Actualité du contenu de l'écran

Désactiver la mise à jour automatique pour une page web particulière

Impression de pages Web

Établissement de la liaison au serveur Web

Figure 3-1 Page Intro du serveur Web de la CPU 1516-3 PN/DP

Paramétrer la langue de l'interface utilisateur

Commuter l'affichage de l'heure

Figure 3-2 Commuter l'affichage de l'heure

Figure 3-3 Réglage de l'heure dans les propriétés de la CPU

Cette commutation a un effet sur les pages Web suivantes :

Tableau 3- 1 Commuter l'affichage de l'heure : affichage sur les pages Web

Page Web Affichage comme temps universel coordonné ou heure

Figure 3-4 Page d'accueil avant la connexion

Figure 3-5 Page d'accueil après la connexion

③ "Panneau de commande CPU"

Informations supplémentaires pour les CPU F

Figure 3-6 Page d'accueil après la connexion à une CPU F

Figure 3-7 Onglet "Identification"

Onglet "Protection du programme"

Figure 3-8 Onglet "Protection du programme"

Figure 3-9 Onglet "Mémoire"

Onglet "Informations d'exécution"

Figure 3-10 Onglet "Informations sur l'exécution"