Archv 42 F

WinCC
User Archives
Manuel
C79000-G8263-C141-01
Edition Novembre 1998

WinCC, SIMATIC, SINEC, STEP sont des marques de la société Siemens AG.
Les autres désignations dans ce manuel peuvent être des marques de fabrique dont l'utilisation par un
tiers à ces mêmes fins peuvent léser droits du détenteur.
(Toute reproduction de ce support d’informations, toute (Nous avons vérifié que le contenu de ce manuel correspond
exploitation de son contenu sont interdites, sauf autorisation aux éléments matériels et logiciels qui y sont décrits. Des
expresse. Tout manquement à cette règle est illicite et expose divergences ne sont cependant pas exclues ce qui nous
son auteur au versement de dommages et intérêts. Tous nos empêche de garantir une correspondance totale. Les
droits sont réservés, notamment pour le cas de la délivrance informations fournies dans cet imprimé sont vérifiées
d'un brevet ou celui de l'enregistrement d'un modèle d'utilité.) régulièrement, les corrections nécessaires sont insérées dans
l'édition suivante. Nous vous sommes reconnaissants pour toute
proposition d'amélioration.)
 Siemens AG 1994 - 1998 All rights reserved Sous réserve de modifications techniques
C79000-G8263-C141-01
Printed in the Federal Republic of Germany Siemens Aktiengesellschaft
Sommaire
1 Introduction........................................................................................................ 1-1
1.1 Applications de User Archives ...................................................................................... 1-1
1.2 Les composants de User Archives ............................................................................... 1-1
1.2.1 L'éditeur User Archives Editor....................................................................................... 1-2
1.2.2 Contrôle User Archive ................................................................................................... 1-3
1.2.3 Fonctions de scripts User Archives............................................................................... 1-3
1.3 Configuration et runtime................................................................................................ 1-3
1.4 Fonctionnalités de User Archives.................................................................................. 1-5
1.5 Légende ........................................................................................................................ 1-6
2 Configuration d’archives utilisateur ................................................................ 2-1

2.1 Exemple d'archive utilisateur ........................................................................................ 2-1
2.2 Configuration d'archives utilisateurn ............................................................................. 2-2
2.2.1 Créer une archive utilisateur ......................................................................................... 2-2
2.2.2 Boîte de dialogue "Général".......................................................................................... 2-3
2.2.3 Boîte de dialogue "Communication".............................................................................. 2-4
2.2.4 Boîte de dialogue "Variales de sélection" ..................................................................... 2-5
2.2.5 Boîte de dialogue "Droits et indicateurs"....................................................................... 2-7
2.3 Propriétés d'archives................................................................................................... 2-10
2.3.1 L'onglet "Ordre" ........................................................................................................... 2-10
2.4 Configuration de Champs d'archive ............................................................................ 2-11
2.4.1 La boîte de dialogue "Général" ................................................................................... 2-12
2.4.2 La boîte de dialogue „Valeurs“ .................................................................................... 2-13
2.4.3 Boîte de dialogue "Droits et Indicateurs" .................................................................... 2-14
2.5 Propriétés de champs d'archives ................................................................................ 2-15
2.5.1 Onglet "Ordre" ............................................................................................................. 2-16
2.6 Configuration de vues ................................................................................................. 2-17
2.6.1 Créer une vue.............................................................................................................. 2-17
2.7 Propriétés de vues ...................................................................................................... 2-20
2.7.1 L'onglet "Général" ....................................................................................................... 2-20
2.7.2 L'onglet „Relation“ ....................................................................................................... 2-21
2.7.3 L'onglet "Ordre" ........................................................................................................... 2-22
2.8 Configuration de champs de vue ................................................................................ 2-22
2.8.1 La boîte de dialogue "Général" ................................................................................... 2-23
2.9 Propriétés de champs de vue ..................................................................................... 2-25
2.9.1 L'onglet "Ordre" ........................................................................................................... 2-26
3 La fenêtre de l'éditeur User Archives Editor ................................................... 3-1
4 Menus et barre d'outils de l'éditeur d'archives utilisateur ............................. 4-1

4.1 Les menus de l'éditeur User Archives Editor ................................................................ 4-1
4.2 La barre d'outils de User Archives Editor...................................................................... 4-6
WinCC Manuel i
C79000-G8263-C141-01
Sommaire 11.98
5 Contrôle de table WinCC User Archives.......................................................... 5-1

5.1 Configuration d'un contrôle User Archives.................................................................... 5-2
5.1.1 Etapes de la configuration d'un contrôle User Archives ............................................... 5-2
5.1.2 Placer un contrôle User Archives dans une vue de process ........................................ 5-2
5.1.3 Définition des propriétés du contrôle User Archives ..................................................... 5-3
5.1.4 Configuration d'une vue de formulaire .......................................................................... 5-4
5.1.4.1 Création d'un champ de formulaire "Text" .................................................................... 5-5
5.1.4.2 Création d'un champ de formulaire "Editer" .................................................................. 5-5
5.1.4.3 Création d'un champ de formulaire "Button" ................................................................. 5-6
5.2 Les propriétés des contrôles WinCC User Archives ..................................................... 5-7
5.2.1 Propriétés d'objet des contrôles WinCC User Archives................................................ 5-7
5.2.2 Boîte de dialogue "Propriétés de WinCC User Archives Table Control" ...................... 5-8
5.3 Création de nouveaux champs de formulaire ............................................................. 5-13
5.3.1 Création de nouveaux champs de formulaire ............................................................. 5-13
5.3.2 Création d'un nouveau champ de formulaire "Text" ................................................... 5-14
5.3.3 Création d'un nouveau champ de formulaire "Edit" .................................................... 5-14
5.3.4 Création d'un nouveau champ de formulaire "Button" ................................................ 5-15
5.3.5 Modification de champs de formulaire ........................................................................ 5-16
5.3.6 Suppression de champs de formulaire ....................................................................... 5-16
5.4 Suppression d'un contrôle User Archives ................................................................... 5-16
5.5 Contrôle User Archives au runtime ............................................................................. 5-17
5.5.1 Le tableau du contrôle User Archives ......................................................................... 5-17
5.5.2 Le formulaire du contrôle User Archives..................................................................... 5-18
5.5.3 La barre d'outils du contrôle User Archives ................................................................ 5-18
6 Fonctions de script standard pour archives utilisateur ................................. 6-1

6.1 Généralités sur la création de scripts d'action .............................................................. 6-1
6.2 Fonctions de script User Archives................................................................................. 6-2
6.3 Les handles des fonctions de script.............................................................................. 6-3
6.3.1 Handles pour la configuration de User Archives........................................................... 6-3
6.3.2 Handles pour les fonctions d'archive runtime ............................................................... 6-4
6.4 Exemple pratique avec fonctions de script ................................................................... 6-5
6.5 Récapitulatif des fonctions User Archive .................................................................... 6-11
6.5.1 Récapitulatif des fonctions API User Archive.............................................................. 6-11
6.5.2 Récapitulatif des fonctions de configuration User Archives........................................ 6-11
6.5.3 Récapitulatif des fonctions générales runtime ............................................................ 6-11
6.5.4 Récapitulatif des fonctions runtime spécifiques .......................................................... 6-12
7 Récapitulatif de l'interface de télégramme SIMATIC S5 et S7 ....................... 7-1

7.1 Echange de données avec S5 et S7 par variables de gestionnaire de données ......... 7-1
7.2 Echange de données avec S5 et S7 par variables de données brutes........................ 7-1
7.2.1 Emission de contrats / données à WinCC .................................................................... 7-2
7.2.2 Transmission d'acquittements de traitement / données à SIMATIC S5 et S7 .............. 7-2
7.2.3 Structure des en-têtes de télégramme.......................................................................... 7-2
7.2.4 En-tête de contrat.......................................................................................................... 7-3
7.3 Différences entre les formats de données de WinCC et de S5/S7............................... 7-5
ii WinCC Manuel
C79000-G8263-C141-01
11.98 Sommaire
8 Annexe 8-1
8.1 Le langage SQL ............................................................................................................ 8-1
8.2 Liste alphabétique des mots-clés SQL ......................................................................... 8-2
8.3 Caractéristiques quantitatives ....................................................................................... 8-3
8.3.1 Performances en écriture et en lecture de variables .................................................... 8-3
8.3.2 Temps d'affichage des vues.......................................................................................... 8-5
8.4 Restrictions système à noter......................................................................................... 8-5
WinCC Manuel iii

C79000-G8263-C141-01
Sommaire 11.98
iv WinCC Manuel
C79000-G8263-C141-01
11.98 Avant-propos
Avant-propos
But du manuel
Le présent manuel expose sous forme d'ouvrage de référence les fonctions des différents composants
logiciels et leur utilisation. La table des matières et l'index permettent d'accéder rapidement à
l'information recherchée. Vous pouvez également la trouver via l'aide contextuelle en ligne ou par les
rubriques d'aide.
Présentation générale et exemple de configuration

Vous trouverez dans la documentation « Prise en main » livrée avec WinCC une présentation générale
de WinCC et un exemple de configuration permettant de comprendre par la pratique les principales
fonctions des divers composants.
Support
Pour toutes questions techniques, contactez votre interlocuteur Siemens auprès de votre agence. Les
adresses de nos agences figurent par exemple dans l'annexe Siemens du manuel « Automate
programmable S7-300, installation et configuration d'une S7-300 », dans nos catalogues, et peuvent
être obtenues par Compuserve (go autforum)...
Notre hotline +49 (911) 895-7000 (Fax 7001) est en outre à votre disposition.
Des informations complémentaires sont proposées sur Internet, à l'adresse
www.aut.siemens.de/coros/html_00/coros.htm.
Informations relatives aux produits SIMATIC

Vous trouverez des informations d’actualité sur les produits SIMATIC :
• sur Internet à l’adresse http://www.aut.siemens.de/
• par appel de télécopie au numéro +49 8765–93 02 77 95 00
Le Customer Support SIMATIC vous propose en outre des informations de dernière minute ainsi que
des logiciels à télécharger qui pourront vous être utiles lors de la mise en œuvre des produits
SIMATIC :
• sur Internet à l’adresse http://www.aut.siemens.de/support/html_00/index.shtml
• sur le serveur télématique (BBS) du Customer Support SIMATIC au numéro +49 (911)
895–7100
• Utilisez pour l’appel du serveur télématique un modem V.34 (28,8 kbaud) ou inférieur que
vous paramétrerez comme suit : 8, N, 1, ANSI, ou appelez sur réseau RNIS (x.75, 64 kbit).
Vous pouvez joindre le Customer Support SIMATIC par téléphone au numéro +49 (911) 895–7000 et
par télécopie au numéro +49 (911) 895–7002. Nous répondrons également à vos questions transmises
par messagerie électronique via Internet ou via le serveur télématique mentionné ci-dessus.
WinCC Manuel v
C79000-G8263-C141-01
Avant-propos 11.98
vi WinCC Manuel
C79000-G8263-C141-01
11.98 Introduction
1 Introduction
L’introduction à l'éditeur User Archives Editor contient les informations suivantes:
• Applications de User Archives
• Les composants de User Archives
• Configuration et runtime
• Fonctionnalités de User Archives
• Légende
1.1 Applications de User Archives

WinCC User Archives est un système de base de données que l'utilisateur peut configurer lui-même.
User Archives WinCC permet d'enregistrer en continu les données du process sur un PC serveur. Les
données lues en ligne dans les archives utilisateur peuvent en outre être affichées durant le runtime
grâce à un contrôle OLE que vous aurez configuré sous Graphics Designer.
User Archives sert également à la mise à disposition de données destinées aux API tels que S5, S7 ou
Allen Bradley. Il est également possible de transférer dans les automates des données telles que
recettes ou valeurs de consigne.
1.2 Les composants de User Archives

WinCC User Archives propose deux types de table de base de données:
- Archives: Les archives sont des tables de base de données dans lesquelles l'utilisateur peut définir
ses propres champs de données. Les archives servent à enregistrer les données et permettent,
comme toute base de données, l'accès à ces données.
- Vues: Les vues sont alimentées par des données provenant des archives et servent à regrouper des
données, par exemple pour obtenir des vues d'ensemble de groupes de produits.
Deux outils sont disponibles pour la création d'archives utilisateur:

- L'éditeur User Archive Editor pour une configuration en dialogue conviviale
- les fonctions de scripts de User Archives pour configurer dans le langage de scripts WinCC.
Les fonctions de script User Archive permettent également de réaliser diverses actions pour le
runtime. Il est possible de configurer dans la vue de runtime un OCX directement lié aux mémoires
images de process des API.
WinCC Manuel 1-1

C79000-G8263-C141-01
Introduction 11.98
1.2.1 L'éditeur User Archives Editor

L'éditeur User Archives Editor
L'éditeur User Archives constitue, avec son interface utilisateur Windows, un outil confortable de
création et de maintenance des archives utilisateurs. Le plan de travail du User Archive Editor se
subdivise en trois zones:
• la fenêtre de navigation (en haut à gauche) pour la sélection d'archives et de vues.

• la fenêtre de données (en haut à droite) pour afficher et éditer les champs. La fenêtre de données
affiche les champs des archives et vues sélectionnées dans la fenêtre de navigation.
• la fenêtre de tableau (en bas) pour afficher et éditer en ligne les données des archives et vues
sélectionnées. La fenêtre de tableau de User Archives permet de se connecter en ligne aux
mémoires images de process des API.
Les fenêtre de navigation et de données de User Archives permettent d'accéder rapidement à tous les
éléments des archives utilisateur avec une interface utilisateur analogue à celle de l'Explorateur MS-
Windows. La création et l'édition conviviales des archives utilisateur s'effectuent à l'aide de boîtes de
dialogue et d'assistants.
1-2 WinCC Manuel

C79000-G8263-C141-01
11.98 Introduction
1.2.2 Contrôle User Archive

Vous pouvez configurer dans Graphics Designer un contrôle User Archives. Le contrôle User
Archives sert à afficher et à modifier les données des archives utilisateur au runtime. Le contrôle se
commande par des symboles.
Le contrôle permet de créer, de modifier et de supprimer les contenus des champs. Les fonctions
"Feuilleter" facilitent l'accès aux archives utilisateur volumineuses. Vous pouvez importer et exporter
des archives et définir des critères de filtrage et de tri
Une liaison directe aux API permet l'échange de données online en écriture et lecture.
1.2.3 Fonctions de scripts User Archives

Les fonctions de scripts User Archives se subdivisent en ...
- fonctions de configuration pour la configuration des archives utilisateur
- fonctions de runtime pour la configuration de diverses actions de runtime
Les fonctions User Archives sont activées par des actions exécutées dans la vue de runtime, telles
qu'un clic de souris sur un bouton défini par exemple. Le langage de scripts WinCC présente une
similitude avec le langage évolué C et les fonctions de base de données sont basées sur le standard
SQL.
1.3 Configuration et runtime

Lors de la configuration des archives utilisateur, vous pourrez créer vos propres tables de bases de
données avec User Archives Editor ou avec les fonctions de script User Archives.
L'éditeur d'archives utilisateur permet également de créer de nouveaux enregistrements et d'éditer les
données d'enregistrements existants dès la phase de configuration.
Au runtime, les archives (c.-à-d. des tables de base de données) peuvent être représentées sous forme
de tableau dans des fenêtres de contrôles OLE. Un échange de données continu avec les API est
réalisable à l'aide de variables de données brutes ou de variables du gestionnaire de données WinCC.
Exemple de saisie de données d'une turbine

L'exploitant d'une centrale électrique crée l'archive utilisateur "Turbine HP1". Cette archive
servira à la surveillance de l'état de fonctionnement d'une turbine haute pression. L'archive utilisateur
"Turbine HP1" possède les champs de données suivants:
Turbine HP1
Index
Régime
Pression d'entrée
Pression de sortie
Température vapeur1
Température vapeur2
Fréquence de vibration
Amplitude de vibration
Température palier1
Température palier2
WinCC Manuel 1-3

C79000-G8263-C141-01
Introduction 11.98
Durant le runtime, les caractéristiques de fonctionnement pourront donc être enregistrées selon une
périodicité définie dans les enregistrements des archives utilisateur sur le support de mémoire de
masse du PC (disque dur).
S5 / S7 données fonctions fonctions enregistrement

automates d'exploit de script de script 805
enregistrement
Les données d'exploitation Les fonctions de script User 804
sont enregistrées toutes les Archive sauvegardent
15 minutes dans l'enregistrement "TurbineHP 1" enregistrement
l'enregistrement 803
enregistrement
802
Les fonctions de scripts User Archives permettent d'analyser ultérieurement les données des archives
utilisateur et de les visualiser à l'aide du contrôle OLE "WinCC User Archive Table Control".
Exemples de recettes d’un fabricant de boissons

Les recettes constituent un exemple de flux de données vers l'API. Le fabricant de boissons, qui
produit une boisson gazeuse de type coca et un jus d'orange, utilise les archives utilisateur pour
charger les recettes de ses boissons dans les API (S5, S7, AllenBradley, Applicom etc.).
Archive Champ de
données
Coca Eau
Sucre
Coulorant7
Acide
phosphorique
Caféine
Les archives utilisateur utilisent les interfaces de données proposées par WinCC pour la
communication avec les API, notamment les données brutes du gestionnaire de données WinCC.
WinCC fournit un jeu de scripts d'actions adéquats pour les transferts de données en provenance
des/vers les API.
Applications des vues

Autre fonctionnalité proposée par WinCC : les "vues". Les vues permettent de regrouper des champs
de données extraits de diverses archives utilisateur. Il est ainsi possible de regrouper par exemple des
groupes de produits qui se trouvent dans des enregistrements de différentes archives utilisateur.
Archive Champ Vue Champ

Cola Eau Couleur Couleur7
Sucre Couleur16
Couleur7
Acide phosphor.
Caféine
Archive Champ
Jus Eau
Jus d'orange
Couleur16
1-4 WinCC Manuel

C79000-G8263-C141-01
11.98 Introduction
Dans notre exemple, le fabricant de boissons crée des vues, pour des groupes de produits tels que des
arômes artificiels et colorants, qui sont stockées dans les différentes archives utilisateur.
Nota
Les logiciels qui permettaient jusqu'à présent des accès directs par interface de base de données
ODBC aux archives utilisateur de version antérieure à 4.0 ne permettront plus d'accéder aux archives
utilisateur de la version 4.0.
L'éditeur User Archives propose un logiciel de conversion au format des nouvelles archives pour les
bases de données d'archives utilisateur antérieures à la version 4.0. Les logiciels d'accès direct ODBC
devront être adaptés au nouveau format User Archives version 4.0.
1.4 Fonctionnalités de User Archives

Les caractéristiques fonctionnelles de User Archives sont énumérées ci-après:
Représentation des valeurs
• Configuration sous forme de tableau (affectation simple et directe des champs du tableau aux
champs de l’archive)
• Configuration de vues (affectation des champs de table à différentes archives)
• Représentation en ligne durant le runtime dans des formulaires (vues de process) / champs d'E/S
(affectation des champs d'archive à l'aide de scripts d'action)
Consignation dans un journal
• sous forme de tableau (affectation simple, directe de champs de tableau à des champs d'archive ou
affectation de vues à différentes archives)
Transfert de / vers API (S5, S7 etc.)
• enregistrements entiers d'une archive

• certains champs de données d'un enregistrement
• communication série RK512/3964R, SINEC Industrial Ethernet (H1 layer 4) ou Profibus (L2).
Possibilités d'édition
• dans la représentation en tableau

• dans les formulaires et champs d'E/S (avec scripts d'action)
Entrée de commandes
• dans les tableaux via des boutons standardisés

• dans les formulaires via des boutons avec scripts d'action
Suppression et création d'enregistrements
• création d'enregistrements dans des tableaux à l'aide de boutons

• création et suppression d'enregistrements dans les formulaires à l'aide de boutons avec scripts
d'action
WinCC Manuel 1-5

C79000-G8263-C141-01
Introduction 11.98
Variables de sélection
• Création de variables WinCC comme variables de sélection avec l'assistant

• Possibilités d'accès rapide aux archives utilisateur par scripts et API
• Adressage indirect pour programmes de scripts
1.5 Légende
Le manuel utilise les symboles et polices présentés ci-dessous
désigne un clic du bouton gauche de la souris

D désigne un clic du bouton droit de la souris
Texte Les textes que vous entrez vous-même et que vous sélectionnez par la suite sont écrits avec
la police Courier
Fichier È Nouveau tous les menus affichés par WinCC, les fonctions et boîtes de saisie sélectionnées
sont représentés en italique .
1-6 WinCC Manuel

C79000-G8263-C141-01
11.98 Configuration d’archives utilisateur
2 Configuration d’archives utilisateur

La première étape consiste à configurer une nouvelle archive utilisateur. Des assistants logiciels vous
aideront à vous acquitter confortablement en dialogue de cette tâche. Les opérations de configuration
ci-dessous sont nécessaires:
Configuration d’archives utilisateur
• Création d'une archive utilisateur

• Définition des champs d'archive
Configuration de vues
• Création d'une vue

• Définition des champs de données
Configuration de contrôles User Archives
• Création de contrôles User Archives

• Création de champs de formulaire
2.1 Exemple d’archive utilisateur

Le fabricant de boissons "Sun Drink" produit dans notre exemple une boisson gazeuse "Calif Cola" et
le jus d'orange "Sunny Juice". Il utilise les archives utilisateur WinCC pour l'enregistrement des
ingrédients entrant dans la composition de ses boissons. Lorsqu'un réservoir de l'installation de mise
en boutille est vide, les données de la recette sont transmises aux API via les canaux de
communication de WinCC. Les API peuvent alors, à l'aide des données de recette, commander le
réapprovisionnement du réservoir.
WinCC Manuel 2-1

C79000-G8263-C141-01
Configuration d’archives utilisateur 11.98
Les archives utilisateur s’utilisent comme suit:

- Archives: On trouve dans cet exemple une archive pour la boisson gazeuse et une archive pour le
jus d’orange.
- Vues: Les vues regroupent des champs de données lus dans les deux archives, c.-à-d. dans notre
exemple le groupe de produits colorants.
Chaque archive se compose de champs de données dont les propriétés sont éditables. Le champ de
données de la boisson gazeuse de notre exemple contient les ingrédients. Chaque champ de données
possède des propriétés telles que nom, alias, type, longueur, valeur, etc. Les champs de données et
propriétés sont affichés dans l'éditeur User Archives, dans des lignes et colonnes. C'est la raison pour
laquelle on parle aussi de "lignes" pour désigner les champs de données et de "colonnes" pour
désigner les propriétés. La structure de l'archive Coca se présente par exemple comme suit:
Archive Coca propriétés (colonnes)

Champs de données Nom Alias Type Longue Valeur Valeur Valeur
(lignes) ur min. max. initiale
Eau Eau Source5 Int 2 1000 1500 1000
Sucre Sucre Mélas. Int 2 120 140 130
Colorant7 FS1007 D1007 Int 2 6 8 6
Caféine Caféine Caféine Int 2 2 3 2
Acide phosphorique Phos.A. PhosAc Int 2 170 190 170
2.2 Configuration d’archives utilisateurn

2.2.1 Créer une archive utilisateur
Démarrez l'éditeur 'User Archives' à partir du WinCC Control Center.
D Cliquez pour ce faire sur User Archives et sélectionnez dans le menu contextuel l'option
Ouvrir. L'écran affiche l'interface utilisateur de l'éditeur d'archives utilisateur.
Nota
Lorsque des modifications de configuration sont effectuées dans une archive, cette archive ne doit ni
être affichée simultanément par un contrôle ni être appelée par une requête de fonction de script
UAQueryArchive.
999 champs peuvent être créés par archive.
L'option par défaut "Créer archives en boucle" permet de créer plusieurs archives successivement. Si
vous ne voulez créer qu'une seule archive, vous pouvez désactiver cette option dans le menu "Edition -
Options".
Pour créer une archive utilisateur, procédez comme suit.
Cliquez dans la fenêtre de navigation avec le bouton gauche de la souris sur Archives.
D Cliquez ensuite dans la fenêtre de navigation ou de données avec le bouton droit de la souris.
Le bouton "Nouvelle archive" apparaît.
2-2 WinCC Manuel

C79000-G8263-C141-01
Cliquez sur le bouton "Nouvelle archive".
La boîte de dialogue "Général", qui permet de créer une archive utilisateur, s'affiche.
2.2.2 Boîte de dialogue "Général"
Entrez comme nom d’archive "Coca" par exemple. Dans le champ "Alias", vous pouvez entrer un
second nom tel que "Calif Cola" p. ex. Vous pouvez réaliser avec l'alias une commutation de
langue. L'utilisation du champ alias est sinon facultative. Vous pouvez laisser le champ alias vide ou
l'utiliser pour l'entrée d'un commentaire.
WinCC Manuel 2-3

C79000-G8263-C141-01
Si vous sélectionnez le type d'archive "Limité", vous pourrez spécifier dans le champ "Nombre" le
nombre maximal d'enregistrements. Le type "Illimité" permet la création d'archives comptant un
nombre illimité d'enregistrements.
Nota
Les mots-clés (ou mots réservés) du langage de base de données SQL ne doivent pas être utilisés
comme noms d'archive ou de champs de données. Voir à ce propos le chapitre "Liste alphabétique des
mots-clés SQL".
Lors de la création des enregistrements, le système ne vérifie pas si ces fiches sont complètes ou
correcte. Aucun champ en particulier ne doit rester vide.
2.2.3 Boîte de dialogue "Communication"

La boîte de dialogue "Communication" permet de définir le type de liaison à établir entre l'automate et
l'archive:
L'option "Type" permet de définir le type de communication:

- aucune: aucune communication n'est possible
- via variable de données brutes: accès à l'API via variable de données brutes
- via variable de gestionnaire de données: accès à l'API via variable du gestionnaire de données
Pour établir une liaison à l'aide de variables de données brutes, cliquez sur "via variable de données
brutes". Indiquez alors l’identificateur des API "PLCID". "PLCID" constitué de 8 caractères ASCII au
maximum. Cet identificateur désigne l'archive correspondante et permet à l'API de renvoyer les
données de la mémoire image de process à l'archive voulue.
Après avoir sélectionné "via variable de données brutes", vous pouvez cliquer sur "Sélectionner"
et choisir une variable de données brutes.
2-4 WinCC Manuel

C79000-G8263-C141-01
2.2.4 Boîte de dialogue "Variales de sélection"

La boîte de dialogue "Variables de sélection" permet de créer des variables de sélection sous forme de
variables WinCC pour accéder aux champs d'archive
Dans les champs de saisie de la boîte de dialogue, vous affectez les variables WinCC à un ID
d'archive, un code de contrat, un champ d'archive et une valeur de positionnement et de désactivation
A côté de chaque champ d'édition se trouve un bouton "Sélectionner". Celui-ci sert à l'affectation des
attributs en dialogue aux variables WinCC. Lorsque vous cliquez sur "Sélectionner", le système
affiche la boîte de dialogue "Sélectionner variable", qui propose pour la sélection toutes les variables
WinCC déjà créées dans la gestion des variables.
Le bouton "Créer" permet d'effectuer les affectations d'une manière extrêmement simple. L'activation
de ce bouton déclenche la création automatique de quatre nouvelles variables WinCC comme
variables de sélection User Archives. La boîte de dialogue "Créer variables de sélection":
WinCC Manuel 2-5

C79000-G8263-C141-01
Vous pouvez indiquer ici si vous désirez utiliser des balises internes ou externes. Vous pouvez
également modifier les noms donnés aux groupes et aux variables WinCC.
Un clic sur le bouton "Edition" active la boîte de dialogue "Propriétés variable". Vous pouvez éditer
dans ce dialogue les propriétés des variables de sélection
La description des variables de sélection, avec, pour chacune d'elles, l'identificateur de l'archive, le
code de type de contrat (6, 7 ou 8), le champ d'archive et la valeur de positionnement (en écriture),
permet d'accéder aux archives en écriture et en lecture. A la lecture (contrat = 6), la valeur lue est par
exemple stockée dans la variable de sélection correspondante (dans l'exemple ci-dessus
"@UA_Cola_Wert").
Fonction des variables de sélection

ID L'identificateur (ou le numéro d'enregistrement) de l'archive
Contrat n Trois types de contrat sont possibles: Lecture, écriture et suppression:
Lecture =6
Ecriture =7
Suppression = 8
Champ. Le champ d'archive
Valeur La valeur de positionnement et de désactivation
2-6 WinCC Manuel

C79000-G8263-C141-01
2.2.5 Boîte de dialogue "Droits et indicateurs"

La boîte de dialogue "Droits et indicateurs" sert à définir les droits d'accès aux archives utilisateur et
les colonnes devant être contenues dans l'archive.
L'écran affiche les niveaux d'autorisation d'accès en lecture et en écriture actuellement définis. Pour
modifier ces paramétrages, cliquez sur l'un des boutons "Sélectionner". La boîte de dialogue "Niveaux
d’autorisation" s'ouvre alors et affiche les niveaux d'autorisation définis dans User Administrator:
En activant l'option "Champ - dernier accès" vous créez une colonne indiquant la date et l'heure du
dernier accès. L'option "Champ - dernier nom d’utilisateur" crée une colonne qui indique le nom du
dernier utilisateur ayant accédé à l'archive utilisateur.
Sélectionnez l'un des niveaux d'autorisation.

Cliquez par exemple sur "Champ - Dernier utilisateur".
Achevez la création de l'archive en cliquant sur le bouton "Terminer".
WinCC Manuel 2-7

C79000-G8263-C141-01
Si vous avez activé dans le menu "Edition - Options" l'option "Créer archives en boucle", le système
vous propose "Archive suivante ?". Si vous cliquez sur "Oui", la boîte de dialogue initiale "Général"
réapparaît pour la création de l'archive suivante.
Nous avons à présent créé l'archive utilisateur vide "Coca" qui sera désormais affichée par l'éditeur
d'archives utilisateur User Archives:
Enregistrez finalement la nouvelle archive utilisateur par un clic de souris sur l'icône
d'enregistrement (symbolisant une disquette) ou en sélectionnant l'option de menu "Projet -
Enregistrer".
Nota
Les modifications d'archive utilisateur ne sont prises en compte qu'après activation de la commande
"Enregistrement" dans l'archive utilisateur.
Les propriétés de l'archive Coca de notre exemple sont:
Arch.: Propriétés
Coca Nom Coca
Alias Calif Cola
Type: illimité
Enreg.max.: 1
Type com.: brutes
PLCID: S7112
Nom var.: CalifVarGroup
Droit lect.: 0
Droit écr.: 0
Indicateurs: U
Pos.: 3
Dern. accès: 03/05/98 12:54
2-8 WinCC Manuel

C79000-G8263-C141-01
2.3 Propriétés d'archives

Pour pouvoir éditer les propriétés des archives utilisateur...
D Cliquez dans la fenêtre de navigation avec le bouton droit de la souris sur l'une des archives,
p. ex. "Coca" (développez d'abord Archives).
Cliquez dans le menu contextuel sur "Propriétés".
Dans la boîte de dialogue "Propriétés de l'archive" qui s'ouvre alors, vous pouvez éditer les
propriétés. Les onglets "Général", "Communication", "Indicateurs" et "Sélectionner autorisation" sont
décrits au chapitre "Créer une archive utilisateur". L'onglet additionnel "Chronologie" sert à définir la
chronologie des archives:
2.3.1 L’onglet "Ordre"

L'onglet "Ordre" sert à définir l'ordre des archives:
WinCC Manuel 2-9

C79000-G8263-C141-01
Enregistrez pour finir l'archive utilisateur par un clic de souris sur l'icône d'enregistrement
(symbolisant une disquette) ou en sélectionnant l'option de menu "Projet - Enregistrer".
Nota
Les modifications d'archives utilisateur ne sont prises en compte dans la base de données qu'après
activation de la commande "Enregistrement".
2.4 Configuration de Champs d’archive

Cette section décrit la marche à suivre pour la création des champs de données d'une archive
utilisateur.
L'option par défaut "Créer champs en boucle" permet de créer plusieurs champs successivement. Si
vous ne voulez créer qu'un seul champ de vue, vous pouvez désactiver cette option dans le menu
"Edition - Options".
Développez "Archives" dans la fenêtre de navigation (en cliquant sur le signe "+"). La
nouvelle archive "Coca" apparaît dans la fenêtre de navigation.
D Cliquez dans la fenêtre de navigation avec le bouton droit de la souris sur le nom d'archive
"Coca". Le menu contextuel suivant apparaît:
Cliquez sur l'option de menu Nouveau champ.
La boîte de dialogue "Général" s’affiche.
Nota
Il peut arriver que des données se perdent lors de modifications apportées à des champs d'archives.
Lorsque, pour des données existantes, une nouvelle condition de cohérence n'est plus remplie, par
exemple comme pour Unique, Not Null etc..
Lorsqu'un champ a été renommé.
Lorsqu'un nouveau type de données ne permet plus le transtypage des données de la source.
2-10 WinCC Manuel

C79000-G8263-C141-01
2.4.1 La boîte de dialogue "Général"

Entrez dans la boîte de dialogue "Général" le champ d'archive que vous désirez éditer ainsi que le type
de variable, la longueur de variable et le nombre des chiffres décimaux.
• Entrez à présent dans le champ de saisie Nom de champ le nom du premier champ d'archive, à
savoir, dans notre exemple, le premier ingrédient de la recette, c.-à-d. "Eau".
• Dans le champ "Alias", vous pouvez entrer un second nom, un "alias". Cet "alias" peut être utilisé
comme second nom ou comme commentaire.
Les noms entrés serviront ultérieurement à l'affectation des champs dans la représentation en tableau.
Dans le champ de saisie Type vous pouvez entrer l'un des types de variable suivant:
integer
double
String
Date/Time
WinCC Manuel 2-11

C79000-G8263-C141-01
2.4.2 La boîte de dialogue „Valeurs“

La boîte de dialogue „Valeurs“ permet d'entrer les valeurs minimales, maximales et initiales.
Minimum, maximum et valeur initiale

Vous devez, pour les valeurs décimales, utiliser un point pour entrer les valeurs des minima, des
maxima et les valeurs initiales de type Double.
Variable WinCC
Vous pouvez créer ici une variable WinCC pour enregistrer la valeur du champ d'archive. Vous
pouvez...
1. entrez directement la variable dans le champ de saisie

2. choisir avec le bouton "Sélectionner" une variable ou en créer une nouvelle
3. cliquer sur le bouton "Créer" pour que le système génère automatiquement une nouvelle variable
4. modifier ultérieurement les propriétés de la variable à l'aide du bouton "Editer".
2-12 WinCC Manuel

C79000-G8263-C141-01
2.4.3 Boîte de dialogue "Droits et Indicateurs"

La boîte de dialogue "Droits et indicateurs" sert à définir les droits d'accès et les attributs des champs
d'archive.
Droits
Vous pouvez sélectionner dans cette boîte les droits d'accès en lecture et écriture à l'aide des boutons
"Sélectionner". Ces droits d'accès sont définis dans User Administrator. La définition des droits
d'accès s'effectue comme décrit dans la section "Créer une archive utilisateur".
Indicateurs:
Dans la fenêtre "Indicateurs" vous pourrez affecter au champ de données sélectionné les attributs
suivants:
- "Le champ doit posséder une valeur":
- Le champ possède une valeur différente de zéro.
- "Le champ doit posséder une valeur unique":
- Le champ doit posséder une valeur unique, c.-à-d. que les valeurs de cette colonne doivent
être différentes les unes des autres.
- "Champ à indexer":
- Le champ supporte une valeur d’index lorsque c’est possible. Cet index peut par exemple
améliorer les performances des commandes de recherche.
Validez les entrées de configuration du champ de données en cliquant sur "Terminer".
Vous avez ainsi créé un nouveau champ de données dans l'archive utilisateur "Coca".
Si vous avez activé dans le menu "Edition - Options" l'option "Créer champs en boucle", le système
vous propose "Champ suivant ?". Si vous cliquez sur "Oui", la boîte de dialogue initiale "Général"
réapparaît pour la création du champ suivant.
Enregistrez pour finir la nouvelle archive utilisateur
WinCC Manuel 2-13

C79000-G8263-C141-01
Nota
Les modifications d'archive utilisateur ne sont prises en compte dans la base de données qu'après
2.5 Propriétés de champs d'archives

Pour pouvoir éditer les propriétés des champs de données...
Cliquez dans la fenêtre de navigation sur l'une des archives, p. ex. "Coca" (développez
d'abord Archives).
La fenêtre de données de l'éditeur User Archives affiche à présent les champs de données de l'archive
utilisateur "Coca":
Pour éditer les champs de données d'une archive utilisateur...

D Cliquez sur le nom de champ "Eau" dans la fenêtre de données de l'éditeur d'archives
utilisateur.
Cliquez dans le menu contextuel sur "Propriétés".
Dans la boîte de dialogue "Propriétés du champ", vous pouvez éditer la propriété sélectionnée.
Les onglets "Général", "Valeurs", "Indicateurs" et "Sélectionner autorisation" sont décrits au chapitre
"Définition des champs d'archive". L’onglet additionnel "Ordre" sert à définir l'ordre des archives:
2-14 WinCC Manuel

C79000-G8263-C141-01
2.5.1 Onglet "Ordre"

L’onglet "Ordre" sert à définir l'ordre des champs de données. l'ordre définie ici a une influence sur la
représentation des données: dans la fenêtre de tableau User Archives, sur le contrôle OCX de la vue
runtime et sur l'attribution des index pour l'accès par fonctions de script.
Les propriétés de l'archive Coca de notre exemple sont:
Arch.: champ de données propriétés

Coca Eau Nom Eau
Alias Eau_de_source_4
Type: Entier
Longueur:
Précision:
Valeur min.: 1000
Valeur max.: 1200
Valeur init.: 1100
Variable n...:
Droit lect.: 0
Droit écr.: 0
Indicateurs: NN
P...: 3
Dern. accès: 03/05/98 12:54
Sucre Nom
Alias
....
Coulorant7 Nom
Alias
....
Caféine Nom
Alias
....
Acide phosphorique Nom
Alias
....
WinCC Manuel 2-15

C79000-G8263-C141-01
Pour terminer, enregistrez la nouvelle archive utilisateur.
Nota
Les modifications d'archives utilisateur ne sont prises en compte dans la base de données qu'après
2.6 Configuration de vues

2.6.1 Créer une vue
L'option par défaut "Créer vues en boucle" permet de créer plusieurs vues successivement. Si vous ne
voulez créer qu'une seule vue, vous pouvez désactiver cette option dans le menu "Edition - Options".
Pour créer une vue, procédez comme suit.

Cliquez dans la fenêtre de navigation avec le bouton gauche de la souris sur Vues.
D Cliquez ensuite dans la fenêtre de navigation ou dans la fenêtre des données avec le bouton
droit de la souris. Le bouton "Nouvelle vue" apparaît.
Cliquez sur le bouton "Nouvelle vue".
2-16 WinCC Manuel

C79000-G8263-C141-01
L'assistant de configuration des vues démarre. La boîte de dialogue "Général" qui permet de créer une
vue, s'affiche.
Entrez comme nom d'archive "Colorants" par exemple. Dans le champ "Alias", vous pouvez entrer
un second nom tel que "Colorants dans coca et jus de fruits" p. ex.
Cliquez sur le bouton "Terminer".
Vous venez de créer une nouvelle vue, encore vide pour l'instant:
Si vous avez activé dans le menu "Edition - Options" l'option "Créer vues en boucle", le système vous
propose "Vue suivante ?". Si vous cliquez sur "Oui", la boîte de dialogue initiale "Général" réapparaît
pour la création de la vue suivante.
Pour terminer, enregistrez la vue.
Nota
Les modifications de vues ne sont prises en compte dans la base de données qu'après activation de
"Enregistrement".
WinCC Manuel 2-17

C79000-G8263-C141-01
2.7 Propriétés de vues

La boîte de dialogue "Propriétés de vue" s’appelle avec ...
D un clic du bouton droit de la souris sur l'une des vues de l'éditeur d'archives utilisateur.
Dans le menu contextuel sélectionnez "Propriétés".
La boîte de dialogue "Propriétés vue" est alors affichée.
2.7.1 L'onglet "Général"

L'onglet "Général" permet d'entrer la vue que vous désirez éditer.
Dans le champ „Nom de vue“, vous pouvez modifier le nom de la vue et l'"alias" dans le champ
"Alias". La boîte affiche la date et l'heure de la dernière modification.
2-18 WinCC Manuel

C79000-G8263-C141-01
2.7.2 L'onglet „Relation“

L'onglet „Relation“ permet de définir les conditions d'affichage des vues.
Expression
Dans le champ „Relation“, vous pouvez entrer directement des expressions SQL. Se reporter à
l'annexe pour de plus amples informations sur le langage SQL.
Conditions
La zone "Champ OP. Champ" permet la saisie en dialogue des conditions. Cliquez pour cela sur les
champs de la liste de champs de droite et de gauche et définissez la relation en cliquant sur l'opération
dans la liste "OP". Un clic sur "Ajouter" valide la condition qui est alors affichée dans le champ
"Relation".
WinCC Manuel 2-19

C79000-G8263-C141-01

L'onglet „Ordre“ permet de définir l'ordre des vues.
Marche à suivre: Sélectionnez une vue par un clic de souris. En cliquant sur „Vers le haut“ et „Vers
le bas“ vous décalez la vue respectivement d'une positon vers le haut ou d'une position vers le bas.
2.8 Configuration de champs de vue

L'option par défaut "Créer colonnes d'une vue en boucle" permet de créer plusieurs colonnes
successivement. Si vous ne voulez créer qu'un seul champ de vue, vous pouvez désactiver cette option
dans le menu "Edition - Options".
La création du champ de données d'une vue peut s'effectuer comme suit:

Développez "Vues" dans la fenêtre de navigation. La nouvelle vue, "Colorants" par
exemple, s'affiche dans la fenêtre de navigation.
D Cliquez dans la fenêtre de navigation avec le bouton droit de la souris sur la vue
"Colorants". Le menu contextuel suivant apparaît:
Cliquez sur le bouton Nouvelle Colonne.
La boîte de dialogue "Général" s’affiche.
2-20 WinCC Manuel

C79000-G8263-C141-01
2.8.1 La boîte de dialogue "Général"

La boîte de dialogue "Général" permet de sélectionner des champs d'archive comme champs de vue et
d'attribuer un nom aux champs de vue.
• Sélectionnez dans le champ "Archive" l'une des archives utilisateur configurées. Laissez par
exemple le paramètre "Coca" inchangé.
• Sélectionnez dans le champ "Champ d’archive" l'un des champs de données de l'archive utilisateur
Coca. Laissez par exemple le paramètre "Colorant7" inchangé. Validez l'entrée avec la touche
TAB ou par un clic de souris sur un autre champ.
• Entrez à présent dans le champ de saisie Nom de colonne le nom de la première colonne de la vue,
par exemple "Colorants".
• Dans le champ Alias, vous pouvez entrer un second nom pour décrire ou commenter le champ de
données. Cette entrée est facultative.
Nota
L'éditeur d'archives utilisateur ne propose que les archives et les champs d'archive qui ont été
enregistrés lors de la dernière édition.
WinCC Manuel 2-21

C79000-G8263-C141-01
Après avoir cliqué sur "Terminer", le champ de données défini est créé:
Le fabricant de boissons de notre exemple crée par exemple une vue Colorants dans laquelle il
regroupe les champs de données Colorant7 et Colorant16 des archives utilisateur Coca et
Juice:
Si vous avez activé dans le menu "Edition - Options" l'option "Créer colonnes d'une vue en boucle", le
système vous propose "Colonne suivante ?". Si vous cliquez sur "Oui", la boîte de dialogue initiale
"Général" réapparaît pour la création de la colonne suivante.
Pour terminer, enregistrez le nouveau champ de vue.
Nota
Les modifications de vues ne sont prises en compte dans la base de données qu'après activation de
"Enregistrement".
2-22 WinCC Manuel

C79000-G8263-C141-01
2.9 Propriétés de champs de vue

Pour éditer les propriétés de fenêtres de vues, procédez comme suit:
D Cliquez avec le bouton droit de la souris sur une des colonnes d'une vue dans l'éditeur User
Archives Editor
Dans le menu contextuel, sélectionnez "Propriétés. La boîte de dialogue "Propriétés de
colonne" est alors affichée.
Cet onglet "Général" contient les mêmes champs que pour la création d'une colonne de vue. La boîte
affiche dans le champ „Modifié“ la date et l'heure de la dernière modification.
WinCC Manuel 2-23

C79000-G8263-C141-01

L'onglet „Ordre“ permet de définir l'ordre des colonnes de vue.
Marche à suivre:
Sélectionnez une vue par un clic de souris. En cliquant sur „Vers le haut“ et „Vers le bas“ vous
décalez la vue respectivement d'une positon vers le haut ou d'une position vers le bas.
2-24 WinCC Manuel

C79000-G8263-C141-01
11.98 La fenêtre de l'éditeur User Archives Editor
3 La fenêtre de l'éditeur User Archives Editor
Le menu "Edition - Données runtime" ou un clic sur le bouton correspondant permet d’ouvrir ou
de fermer la fenêtre de lecture et d'édition des tables. Un double clic sur l'un des champs permet
d'entrer des données. Dans ce cas le curseur de texte apparaît dans le champ. Vous pouvez alors vous
déplacer dans la table à l'aide des touches de curseur du clavier. La méthode de travail dans la fenêtre
de visualisation de table de l'éditeur User Archives Editor est analogue à celle de la manipulation de la
table User Archive.
Nota
Si vous modifiez une ou plusieurs valeurs dans la fenêtre de l'éditeur d'archives utilisateur ou dans un
contrôle OCX, cliquez, après avoir effectué l'entrée, sur un autre emplacement de la table afin que la
valeur soit prise en compte dans la base de données et soit mise à jour dans les autres affichages.
WinCC Manuel 3-1

C79000-G8263-C141-01
La fenêtre de l'éditeur User Archives Editor 11.98
3-2 WinCC Manuel

C79000-G8263-C141-01
11.98 Menus et barre d'outils de l'éditeur d'archives
4 Menus et barre d'outils de l'éditeur d'archives

utilisateur
4.1 Les menus de l'éditeur User Archives Editor
Cette section décrit l'utilisation des menus. L'éditeur User Archives Editor propose les menus
suivants:
Menu Commande de menu Raccourci

Projet Restaurer Ctrl + N
Enregistrer Ctrl + S
Convertir
Quitter
Edition Couper Ctrl + X
Copier Ctrl + C
Coller Ctrl + V
Données runtime Ctrl + R
Options Ctrl + O
Affichage Barre d'outils
Barre d'état
Fractionner
Données runtime Importer
Exporter
Aide Rubriques de l'aide
A propos de
Restaurer
La commande "Restaurer" rejette les dernières modifications, et le dernier état mémorisé est restauré
sans fermeture de l'éditeur. Cette fonction vous permet en outre de valider des modifications qui ont
été exécutées et enregistrées par des scripts ou des programmes externes depuis l'ouverture de
l'éditeur. L'éditeur n'a pas automatiquement connaissance de telles modifications.
Convertir
Cette commande de menu permet de convertir des archives utilisateur anciennes de WinCC version
3.x au format des nouvelles archives utilisateur WinCC 4.02
WinCC Manuel 4-1

C79000-G8263-C141-01
Menus et barre d'outils de l'éditeur d'archives 11.98
La conversion des archives utilisateur s'effectue en deux étapes:

1. Conversion de la structure d'archives
2. Conversion des données de runtime
Pour convertir la structure d'archive, procédez comme suit:

1. Sélectionnez l'archive utilisateur à convertir et lancez la conversion avec le bouton "Convertir"
2. La conversion terminée, quittez la fenêtre de dialogue en cliquant sur "Fermer" .
3. Enregistrez la structure d'archive convertie.
Pour convertir les données de runtime, procédez comme suit:

1. Sélectionnez le menu "Projet - Convertir"
2. Dans la boîte de dialogue "Convertir anciennes archives", cliquez sur "Données RT ...". La
fenêtre de dialogue "Convertir données de runtime" s'ouvre.
3. Sélectionnez l'ancienne archive et la nouvelle et lancez la conversion avec le bouton "Convertir"

4. Fermer la fenêtre de dialogue "Convertir données de runtime
5. Fermer la fenêtre de dialogue "Convertir anciennes archives
Données runtime
Cette commande de menu permet d'éditer en ligne des données dans la fenêtre de tableau. Lorsque
cette commande est cochée, l'état "Données runtime" est activé.
4-2 WinCC Manuel

C79000-G8263-C141-01
Options
Cette commande de menu permet de spécifier de quelle manière seront saisies les archives utilisateur
et les vues. La boîte de dialogue suivante apparaît lorsque vous sélectionnez cette commande:
Créer archives en boucle:

Lorsque cette option est activée, la boîte de dialogue de création d'une nouvelle archive apparaît
automatiquement dès que vous avez achevé de créer une première archive utilisateur.
Créer champs en boucle:

Lorsque cette option est activée, la boîte de dialogue de création d'un nouveau champ d'archive
apparaît automatiquement dès que vous avez achevé de créer un premier champ d'archive utilisateur.
Créer vues en boucle:

Lorsque cette option est activée, la boîte de dialogue de création d'une nouvelle vue apparaît
automatiquement dès que vous avez achevé de créer une première archive de vues.
Créer champs d'une vue en boucle:

Lorsque cette option est activée, la boîte de dialogue de création d'un nouveau champ apparaît
automatiquement dès que vous avez achevé de créer un premier champ de vue.
Fractionner
Sert au redimensionnement des trois volets de l'éditeur User Archives Editor.
WinCC Manuel 4-3

C79000-G8263-C141-01
Importer
Cette commande de menu permet d’importer des archives utilisateur.
Entrez dans le champ "Sélection de fichier" le chemin et le nom de fichier de l'archive utilisateur à
importer. Le bouton "..." permet de rechercher le fichier voulu.
Dans le champ "Format de fichier", vous pouvez sélectionner le format de fichier de l'archive à
importer. Le bouton "Options" permet de définir le caractère de séparation voulu. Le caractère de
séparation par défaut est le point-virgule ";".
Dans le champ "Sélection d'archive", vous pouvez sélectionner l'une des archives du projet actuel.
L'importation démarre dès que vous cliquez sur le bouton "Importer". L'archive source et l'archive
cible doivent posséder une structure concordante faute de quoi une importation n'est pas possible.
4-4 WinCC Manuel

C79000-G8263-C141-01
Exporter
Cette commande de menu permet d’exporter des archives utilisateur.
Entrez dans le champ "Sélection de fichier" le chemin et le nom de fichier de l'archive utilisateur à
exporter. Le bouton "..." permet de rechercher le fichier voulu.
Le champ "Format de fichier" permet de sélectionner le format de fichier dans lequel sera écrite
l'archive. Le bouton "Options" permet d'indiquer le caractère de séparation souhaité. Le caractère de
séparation par défaut est le point-virgule ";".
Dans le champ "Sélection d'archive", vous pouvez sélectionner l'une des archives du projet actuel.
La zone "Filtre" permet de spécifier un filtre pour l'exportation de l'archive. Indiquez dans le champ
"Filtre sur champ" le champ auquel doit s'appliquer le filtre. Entrez dans les champs "de... à" la plage
des valeurs qui passeront le filtre.
Après avoir cliqué sur le bouton "Expression SQL" vous pouvez entrer dans le champ de saisie qui se
trouve en dessous une expression filtre en langage SQL. Pour plus de détails sur les expressions SQL,
veuillez vous reporter à l'annexe.
L'exportation démarre dès que vous cliquez sur le bouton "Exporter".
WinCC Manuel 4-5

C79000-G8263-C141-01
4.2 La barre d’outils de User Archives Editor

L'éditeur d'archives utilisateur peut être commandé directement par clic de souris sur la barre d'outils.
Les différentes icônes de la barre d'outils sont décrites ci-après dans l'ordre alphabétique.
Icône Description
Défilement
Propriétés
Exporter
A propos de
Importer
Supprimer
Nouveau
Données runtime
Enregistrer
Restaurer
Défilement
Les icônes de "Défilement" permettent de consulter l’archive utilisateur en mode runtime.
Propriétés
L'icône "Propriétés" permet d'éditer les propriétés des archives ou champs de données. Un clic du
bouton droit de la souris sur une archive utilisateur ou sur un champ de données permet également
d'éditer les propriétés d'une archive ou d'un champ de données.
Supprimer
L'icône "Supprimer" permet de supprimer les archives ou champs de données. Un clic du bouton droit
de la souris sur une archive utilisateur ou un champ de données permet également de supprimer une
archive ou un champ de données. Il est en outre possible de cliquer d'abord sur une archive ou un
champ de données, puis sur l'icône "Supprimer".
Nouveau
L'icône "Nouveau" permet de créer des archives ou champs de données. Un clic du bouton droit de la
souris dans l'une des fenêtres supérieures permet également de créer une archive.
4-6 WinCC Manuel

C79000-G8263-C141-01
11.98 Contrôle de table WinCC User Archives
5 Contrôle de table WinCC User Archives

Le module de traitement de table BD User Archives permet d'accéder aux archives et aux vues des
archives utilisateur. Le module User Archives permet au runtime:
Á de créer ou de supprimer des enregistrements
Á de feuilleter dans l'archive utilisateur
Á de lire et d'écrire des variables avec des liaisons directes
Á d'importer et d'exporter des archives
Á de définir des conditions de filtrage et de tri
Le module User Archives Table propose deux vues: la présentation en tableau et la présentation en
formulaire.
La présentation en tableau
La présentation en tableau affiche sous forme de tableau les archives utilisateur. Chaque
enregistrement occupe une ligne et les champs d'un enregistrement sont présentés en colonnes.
La vue en formulaire
La vue de formulaire propose une interface utilisateur que celui-ci peut agencer lui-même. La vue de
formulaire de User Archives contient trois types de champs: textes statiques, champs de saisie et
boutons.
WinCC Manuel 5-1

C79000-G8263-C141-01
Contrôle de table WinCC User Archives 11.98
5.1 Configuration d'un contrôle User Archives

5.1.1 Etapes de la configuration d'un contrôle User Archives
Procédez de la manière suivante pour configurer un contrôle WinCC User Archives: Configuration
d'un contrôle User Archives
1. Configurez une archive utilisateur avec l'éditeur d'archives utilisateur ou avec les scripts User
Archives. La description de l'éditeur User Archives Editor vous indique comment configurer
l'archive "Coca".
2. Placez un nouveau contrôle User Archives dans une vue de Graphic Designer.
3. Configurez les propriétés du contrôle User Archives.
4. Configurez une vue de formulaire User Archives.
5.1.2 Placer un contrôle User Archives dans une vue de process

Pour créer un contrôle User Archives dans une vue de process, vous devez configurer ce contrôle dans
Graphics Designer. Les étapes de la conception sont les suivantes:
1. Sélectionnez dans la palette d’objets le groupe d'objets "Objets complexes" (Smart Objects).
2. Cliquez sur l'objet Contrôle OLE et agrandissez dans la surface de travail une fenêtre pour lui
donner une taille appropriée, en tirant avec le pointeur de la souris.
3. Choisissez dans le dialogue de sélection alors affiché "Incorporer Contrôle OLE" dans la fenêtre
"WinCC User Archives Table Control" et terminez la sélection avec OK.
5-2 WinCC Manuel

C79000-G8263-C141-01
5.1.3 Définition des propriétés du contrôle User Archives

Le présent guide explique comment configurer un contrôle pour l'archive "Coca" (Graphics Designer)
dans la boîte de dialogue "Propriétés de WinCC User Archives Table Control" .
1. Double-cliquez dans la surface de l'OCX sur "WinCC User Archives Table Control". La boîte de
dialogue "Propriétés de WinCC User Archives Table Control" est alors affichée avec l'onglet
"Général".
2. Dans la zone de saisie Source, définissez l'archive ou la vue devant être affichée dans le contrôle.
Cliquez sur "Archive" puis sélectionnez "Coca".
3. Dans la zone Edit, vous pouvez définir le type d'accès au runtime. Décochez la case "Read only".
Les types d'accès proposés sont alors "Insérer", "Modifier" et "Supprimer". Activez ces types
d'accès.
4. Dans la case à cocher "Border", indiquez si la fenêtre du contrôle OCX doit être affichée avec ou
sans bordure. Activez cette option
Vous pouvez reprendre tels quels les paramétrages dans les autres onglets.
WinCC Manuel 5-3

C79000-G8263-C141-01
5.1.4 Configuration d’une vue de formulaire

La configuration d'une vue de formulaire suppose que les propriétés d'un contrôle User Archives aient
été préalablement configurées.
Le présent guide vous montre comment configurer une nouvelle vue de formulaire dans Graphics
Designer.
1. Appuyez sur la "touche Ctrl" et double-cliquez simultanément sur le contrôle User Archives. La
vue de présentation en tableau du contrôle est alors affichée. Vous pouvez maintenant paramétrer
la taille du contrôle pour le runtime.
2. Cette icône permet de basculer entre la vue de formulaire et la vue de tableau. Cliquez sur
cette icône pour accéder à la vue de formulaire.Vous pouvez maintenant commencer à configurer
un formulaire. Nous allons maintenant créer ce formulaire.
5-4 WinCC Manuel

C79000-G8263-C141-01
5.1.4.1 Création d'un champ de formulaire "Text"

Pour créer un nouveau champ de texte...
D Cliquez avec le bouton droit de la souris dans la surface de travail du contrôle User Archives.
Le champ de sélection ci-dessous apparaît alors à l'écran:
Lorsque vous cliquez sur le champ de sélection "Insérer champ de texte" la boîte de dialogue
"Propriétés champ de texte" est affichée pour la configuration du texte.
Dans le champ "Text", entrez comme titre du formulaire le texte "Formulaire de saisie
Coca"..
5.1.4.2 Création d'un champ de formulaire "Editer"

Pour créer un nouveau champ d'édition...
D Cliquez avec le bouton droit de la souris dans la surface de travail du contrôle OCX. Le
champ de sélection ci-dessous est alors affiché.
Dans le champ de sélection, choisissez "Insérer champ d'édition".
La boîte de dialogue "Propriétés champ d'édition" est alors affichée:
WinCC Manuel 5-5

C79000-G8263-C141-01
Cliquez sur le bouton . La liste propose tous les champs de données configurés dans l'archive
"Coca". Sélectionnez le champ "Eau". Vous pouvez maintenant éditer vous-même d'autres champs
d'édition tels que Sucre, Colorant7, Caféine et Acide phosphorique.
5.1.4.3 Création d'un champ de formulaire "Button"

Pour créer un nouveau bouton...
D Cliquez avec le bouton droit de la souris dans la surface de travail du contrôle. Le champ de
sélection ci-dessous apparaît alors à l'écran:
Dans le champ de sélection, choisissez "Insérer bouton".
La boîte de dialogue "Propriétés bouton" est alors affichée pour la modification du champ de bouton:
Vous pouvez définir dans le champ "Texte" le texte devant être utilisé pour l'étiquette du nouveau
bouton. Entrez le texte "Présentation en tableau".
Le champ "Action" permet de sélectionner un des symboles de la vue de formulaire. Le bouton que
vous venez de configurer exécute alors la même action que l'icône correspondante de la barre d'outils.
Sélectionnez "Form" pour permettre le basculement de vue.
Vous pouvez procéder de la même manière pour créer d'autres champs de bouton. Vous pouvez p. ex.
créer un bouton "Trier".
La configuration du contrôle User Archives est terminée.
5-6 WinCC Manuel

C79000-G8263-C141-01
5.2 Les propriétés des contrôles WinCC User Archives

5.2.1 Propriétés d'objet des contrôles WinCC User Archives
Vous pouvez modifier les attributs d'un contrôle User Archives en cliquant avec le bouton droit de la
souris sur l'objet et en sélectionnant dans le menu contextuel alors ouvert la commande de menu
"Propriétés".
Dans le dialogue "Propriétés d'objet", sélectionnez dans l'onglet "Propriétés" le groupe "Propriétés
contrôle OLE".
Nota
Pour obtenir une description exhaustive de toutes les propriétés du contrôle WinCC Alarm Control,
appelez l'aide en ligne.
WinCC Manuel 5-7

C79000-G8263-C141-01
5.2.2 Boîte de dialogue "Propriétés de WinCC User Archives Table Control"

Une autre possibilité de configurer des contrôles User Archives consiste à double-cliquer sur un des
contrôles User Archives dans Graphics Designer.
Onglet Général
Nom Description
Archive/ Les boutons de sélection Archive/Vue permettent d'indiquer si vous désirez
View configurer une archive ou une vue.
Source Dans le champ de liaison, vous pouvez sélectionner une archive ou une vue
préalablement configurée.
Edit Le champ Edit permet de définir le type d'accès au runtime. Lorsque vous
désactivez la case "Read only", les types d'accès "Insérer", "Modifier" et
"Supprimer" sont encore disponibles.
Border La case à cocher "Border" permet d'indiquer si la fenêtre du contrôle doit être
affichée avec ou sans bordure.
Form La case à cocher "Form" permet d'indiquer si la vue de formulaire doit être la
vue de démarrage dans la fenêtre du contrôle.
5-8 WinCC Manuel

C79000-G8263-C141-01
Onglet Columns
Nom Description
Columns La zone de saisie Columns permet d'indiquer les champs créés dans
l'éditeur User Archives Editor qui doivent être affichés dans la vue de
process.
Properties La zone de saisie Properties permet de définir les propriétés du champ
actuellement sélectionné dans la zone de saisie Columns.
Locked La case à cocher "Locked" permet de protéger en écriture le champ
sélectionné.
Format Le champ "Format" définit le format des valeurs:Fixed (nombre à
virgule fixe), Scientific, Date, Time et TimeStamp. La sélection d'un
format n'a pour le moment pas encore de répercussion sur le format de la
valeur au runtime. L'affichage d'un champ de date utilise toujours le
format de date "JJ.MM.AA hh.mm.ss"
Orientation "Orientation" permet de choisir entre "Left", "Centered" et "Right".
Reset Le bouton "Reset" permet de revenir au paramétrage précédent.
WinCC Manuel 5-9

C79000-G8263-C141-01
Onglet Barre d’outils
Nom Description
Symbols Indiquez dans "Symbols" les symboles devant composer la barre d’outils.
Access Le champ "Access" affiche les droits d'accès au symbole sélectionné.
Select Un clic sur le bouton "Select" fait apparaître la boîte de dialogue
"Niveaux d’autorisation", dans laquelle vous pouvez définir le droit
d'accès souhaité.
Turn Off Le champ "Turn Off" active et désactive la barre d'outils.
La boîte de dialogue "Niveaux d’autorisation" permet de définir le droit d'accès souhaité. Les choix
possibles ont été préalablement définis dans User Administrator.
5-10 WinCC Manuel

C79000-G8263-C141-01
Onglet Barre d'état
Nom Description
Areas Les cases de la zone "Areas" permettent d'indiquer les éléments devant
composer la barre d'état du contrôle.
Turn Off Le commutateur "Turn Off" active et désactive la barre d'état.
Si tous les champs de la barre d'état ont été activés, la barre d'état se présente comme suit:
Onglet Filter/Sort
WinCC Manuel 5-11

C79000-G8263-C141-01
Nom Description
Filter Condition La zone de l’onglet "Filter Condition" permet de définir les
conditions de filtrage. Entrez directement les règles de filtrage. Ces
conditions se formulent dans le langage de base de données SQL
(Structured Query Language). Vous trouverez dans l'annexe une
Description de SQL avec plusieurs exemples pratiques.
Exemple :
FieldC > 100
Tous les enregistrements dont la valeur est supérieure à 100 dans la
colonne "FieldC" sont sélectionnés.
Sort Dans la zone de l'onglet "Sort" vous définissez les conditions de tri.
Entrez les règles de tri directement en langage de programmation
SQL.
Voir Description de SQL
Onglet Polices
L'onglet "Polices" permet de choisir la police à utiliser dans le contrôle.
5-12 WinCC Manuel

C79000-G8263-C141-01
Onglet Couleurs
L'onglet "Couleurs" sert à définir les couleurs à utiliser dans le contrôle.
5.3 Création de nouveaux champs de formulaire

5.3.1 Création de nouveaux champs de formulaire
Pour accéder à la vue de formulaire
1. Appuyez sur la touche Ctrl et double-cliquez simultanément sur le contrôle User Archives. La
vue du contrôle est alors affichée.
2. Cliquez sur ce symbole pour accéder à la vue de formulaire.
Pour créer un nouveau champ de formulaire:
D Dans Graphics Designer, cliquez avec le bouton droit de la souris dans la surface du contrôle
User Archives à l'endroit où vous voulez placer le texte. Le champ de sélection ci-dessous est alors
affiché.
Les types de champs suivants sont disponibles:

Texte: Un champ de texte est un texte statique quelconque
Edition: Un champ d'édition vous permet d'afficher et d'éditer les champs de données de l'archive
actuelle.
Bouton: Un bouton vous propose un commutateur propre remplissant la même fonction que les
symboles du champ de formulaire.
WinCC Manuel 5-13

C79000-G8263-C141-01
5.3.2 Création d'un nouveau champ de formulaire "Text"

Ouvrez la Vue de formulaire si celle-ci n'est pas déjà ouverte.
Pour créer un nouveau champ de formulaire "Text"...

D Dans Graphics Designer, cliquez avec le bouton droit de la souris dans la surface de travail
du contrôle User Archives à l'endroit où vous voulez placer le texte. Le champ de sélection
suivant est affiché:
La sélection de "Insérer un champ de texte" vous permet d'accéder à la boîte de dialogue "Propriétés
champ de texte":
Le champ "Text" vous permet d'entrer le texte souhaité. En agrandissant le champ vous obtenez tous
les noms de champ sous forme de textes statiques.
5.3.3 Création d'un nouveau champ de formulaire "Edit"

Ouvrez la vue de formulaire si celle-ci n'est pas déjà ouverte.
Pour créer un nouveau champ de formulaire "Edit"...

du contrôle User Archives à l'endroit où vous voulez placer le champ d'édition.. Le champ de
sélection ci-dessous apparaît alors à l'écran:
5-14 WinCC Manuel

C79000-G8263-C141-01
La sélection de "Insérer un champ d'édition" vous permet d'accéder à la boîte de dialogue "Propriétés
champ d'édition":
Le champ "Field" permet de sélectionner un des champs affichés.Tous les champs de l'archive
paramétrés dans la configuration sont proposés pour la sélection.
5.3.4 Création d'un nouveau champ de formulaire "Button"

Ouvrez la vue de formulaire si celle-ci n'est pas déjà ouverte.
Pour créer un nouveau bouton...

du contrôle User Archives à l'endroit où vous désirez placer le bouton. Le champ de sélection
ci-dessous apparaît alors à l'écran:
La sélection de "Insérer un bouton" vous permet d'accéder à la boîte de dialogue "Propriétés bouton":
Vous pouvez définir dans le champ "Text" le texte devant être utilisé pour l'étiquette du bouton. Si
vous entrez par exemple "Présentation en tableau", le nouveau bouton fera apparaître le
texte "Présentation en tableau".
Le champ "Action" permet de sélectionner un des symboles de la vue de formulaire. Le bouton que
vous venez de configurer exécute alors la même action que l'icône correspondante de la barre d'outils.
Si vous sélectionnez par exemple l'action "Form", un clic sur ce bouton au runtime vous fera revenir à
la présentation en tableau.
WinCC Manuel 5-15

C79000-G8263-C141-01
5.3.5 Modification de champs de formulaire

Pour modifier un champ de formulaire
D Cliquez avec le bouton droit de la souris sur le champ de formulaire préalablement configuré
puis sur le bouton "Propriétés" ou
GG Double-cliquez sur le champ de formulaire préalablement configuré.
Le système affiche alors la boîte de dialogue correspondante pour la modification du champ de

formulaire, comme aux chapitres Création d'un nouveau champ de formulaire, Création d'un nouveau
champ de formulaire "Edit" et Création d'un nouveau champ de formulaire "Button".
5.3.6 Suppression de champs de formulaire

Pour supprimer un champ de formulaire...
D Cliquez avec le bouton droit de la souris sur le champ de formulaire préalablement configuré.
Cliquez sur le bouton "Delete". Le champ de formulaire est alors supprimé. Ne pas utiliser la
touche de suppression car celle-ci supprime tout le contrôle.
5.4 Suppression d'un contrôle User Archives

La suppression de contrôles User Archives s'effectue dans Graphics Designer en deux étapes:
1. Sélectionnez le contrôle User Archives avec la souris
2. Appuyez sur la touche de suppression ou sélectionnez la commande de menu "Edition -
Supprimer".
La suppression est effectuée sans avertissement préalable. L'annulation de la commande n'est possible
qu'avec la commande de menu "Edition - Annuler" ou avec la combinaision de touches "Ctrl-Z".
Nota
Si le contrôle User Archives se trouve dans la vue de formulaire lors de la suppression, l'arrière-plan
du contrôle User Archives reste affiché après la suppression. Le contrôle User Archives disparaissant
de l'écran complètement après la configuration d'autres objets dans Graphics Designer, vous pouvez
ignorer l'arrière-plan d'archive utilisateur qui reste affiché.
5-16 WinCC Manuel

C79000-G8263-C141-01
5.5 Contrôle User Archives au runtime

5.5.1 Le tableau du contrôle User Archives
Le tableau du contrôle User Archives sert à présenter sous forme de tableau les données d'archive
utilisateur au runtime.
La barre d'outils permet la manipulation de la fenêtre de tableaux et de formulaires du contrôle User

Archives:
Nota
Si vous modifiez une ou plusieurs valeurs dans un tableau de contrôle OCX, vous devez, lorsque vous
avez terminé la saisie des valeurs, cliquer à un autre endroit du tableau pour que la valeur soit stockée
dans la base de données et pour qu'elle soit actualisée dans les autres affichages.
Les scripts User Archives doivent effectuer eux-mêmes la sélection des enregistrements. La sélection
d'enregistrements par des contrôles User Archives n'est pas possible.
WinCC Manuel 5-17

C79000-G8263-C141-01
5.5.2 Le formulaire du contrôle User Archives

L'utilisateur peut configurer lui-même dans Graphics Designer, selon ses préférences, le formulaire de
contrôle User Archives, qui sert à présenter les données d'archive utilisateur au runtime.
Nota
Si vous modifiez une ou plusieurs valeurs dans un formulaire de contrôle User Archives, vous devez,
après avoir terminé la saisie, feuilleter vers un autre enregistrement pour que la valeur soit stockée
dans la base de données et actualisée dans les autres affichages.
5.5.3 La barre d'outils du contrôle User Archives

La barre d’outils permet les manipulations suivantes:
Icône Description
Basculer
Supprimer enregistrement
Création d'un nouvel enregistrement
Modification d'un champ existant
Feuilleter dans la fenêtre de table
Lecture et écriture de variables
Importation et exportation d'archives
Définition de conditions de filtrage
Définition de conditions de tri
Appeler l'aide
5-18 WinCC Manuel

C79000-G8263-C141-01
Basculer
Cette icône permet le basculement entre la vue de formulaire et la présentation en tableau.
Supprimer enregistrement
L'enregistrement marqué est supprimé.
Création d'un nouvel enregistrement

Entrez successivement les valeurs des champs de données et confirmez chaque entrée avec la touche
ENTREE. Lorsque tous les champs de données ont été renseignés, le nouvel enregistrement est créé
avec les valeurs saisies.
Modification d’un champ existant

Après avoir cliqué sur cette icône, cliquez sur le champ dont vous désirez modifier le contenu. Le
marqueur de texte vous indiquant que le champ peut être édité est alors affiché.Tant que l'icône
"Modification d'un champ existant" est active, le contrôle User Archives se trouve en mode
"Modifier". Vous pouvez alors déplacer le curseur dans la table et effectuer immédiatement des
modifications. Lorsque le mode "Modifier" est désactivé, vous ne pouvez effectuer les modifications
qu'après avoir pressé la touche de raccourci F2 ou cliqué deux fois sur le champ à modifier.
Feuilleter dans la fenêtre

Ces boutons permettent de feuilleter vers l'avant et vers l'arrière dans la fenêtre de table et de sauter au
début ou à la fin de l'archive.
Lecture et écriture de variables

Ces options permettent l'écriture et la lecture de variables WinCC.
Lors de la conception de l'archive dans la boîte de dialogue "Propriétés d'archive" vous devez, dans
l'onglet "Communication", avoir activé le mode de communication Communication par variable
WinCC. Vous devez avoir configuré une Variable de sélection dans l'onglet "Variable de sélection".
Importation et exportation des archives

Un clic sur l'un de ces boutons déclenche l'importation ou l'exportation d'archives utilisateur au format
CSV (Coma Seperated Value).
Attention ! Indiquez le type de fichier CSV avant l'exportation dans Excel, sinon le fichier CSV
exporté depuis WinCC ne pourra pas être chargé correctement.
Définir les conditions de filtrage

Cette option permet la saisie de filtres. Les conditions de filtrage se formulent directement dans le
langage de programmation de base de données SQL (Structured Query Language). Vous trouverez
dans l'annexe une Description de SQL avec plusieurs exemples pratiques. Consultez les sources de
référence pour de plus amples informations.
Exemple :
ID < 100
Seuls les champs de données possédant les identificateurs ID 1 à 99 sont sélectionnés; les autres
champs de données ne sont pas affichés.
Définition des conditions de tri

Cette option permet d'entrer des conditions de tri. Les règles de tri se formulent directement dans le
langage de programmation de base de données SQL.
Voir aussi la Description de SQL à l'annexe. Pour de plus amples informations, consultez les ouvrages
spécialisés.
Appeler l’aide
Cliquez sur ce bouton pour appeler l'aide pour le contrôle User Archives.
WinCC Manuel 5-19

C79000-G8263-C141-01
5-20 WinCC Manuel

C79000-G8263-C141-01
11.98 Fonctions de script standard pour archives utilisateur
6 Fonctions de script standard pour archives

utilisateur
Les fonctions de script standard User Archives sont décrites dans les sections suivantes :
• Généralités sur les scripts d'action
• Fonctions de script User Archives
• Les handles des fonctions de script
• Un exemple pratique avec fonctions de scripts
• Récapitulatif des fonctions standard User Archives
• Vous pouvez obtenir une description détaillée des fonctions User Archives en appelant l'aide en
ligne de WinCC User Archives.
WinCC propose à l'utilisateur une série de fonctions de script offrant une grande souplesse
d'utilisation des archives utilisateur.
Les fonctions de script User Archive se reconnaissent à une convention d'écriture du nom de la
fonction bien spécifique. Toutes les fonctions de script User Archives débutent par "ua", par exemple
"uaConnect", "uaArchiveOpen", uaArchiveGetFields" etc. Les fonctions runtime commencent
toujours par "uaArchive"
Les fonctions User Archives se subdivisent en fonctions de configuration et fonctions runtime. Il faut
créer les handles UAHCONFIG, UAHCONNECT et UAHARCHIVE avec des fonctions de script
adéquates avant d'utiliser les fonctions de configuration et de runtime.
Nota
Les scripts User Archives doivent assurer eux-mêmes la sélection des enregistrements. Une sélection
des enregistrements par des contrôles OCX User Archives n'est pas possible.
Lorsqu'un programme a ouvert une archive utilisateur et qu'un enregistrement est inséré ou supprimé
dans cette archive avec un contrôle ou avec l'éditeur User Archives Editor, le programme ne s'aperçoit
pas de cette modification. Les modifications ne sont connues du programme qu'après émission d'une
requête.
6.1 Généralités sur la création de scripts d'action

Pour configurer un script d'action (action), procédez comme suit:
Démarrez l'éditeur graphique et créez une vue de process
D sur l'objet auquel vous voulez affecter une action (sur un bouton p. ex.)
Sélectionnez Propriétés
Dans l’onglet Propriétés ou Evénement sélectionnez l'élément que vous voulez lier à une action
et effectuez un double-clic avec le bouton gauche de la souris (pour configurer p. ex. une action
pour un double-clic de la souris, sélectionnez Evénement / Souris / Appuyer à gauche). Vous
pouvez à présent entrer directement le code C et le compiler.
sur OK valide la configuration de l'action.
WinCC Manuel 6-1

C79000-G8263-C141-01
Fonctions de script standard pour archives utilisateur 11.98
6.2 Fonctions de script User Archives

Configuration avec l'éditeur User Archive Editor
La première étape consiste à configurer les archives utilisateur. Cette configuration est possible aussi
bien avec l'éditeur d'archives utilisateur qu'avec les fonctions de script User Archives.
Configuration à l'aide des fonctions de script User Archives

La fonction uaQueryConfiguration fournit un handle (UAHCONFIG) pour les fonctions de
configuration. Ce handle permet d’appeler les fonctions de configuration uaSetArchive, uaAddArchive,
uaSetField, uaAddField etc. La fonction "uaReleaseConfiguration" clôt la configuration des archives
utilisateur.
Etablir la liaison à User Archives.

Appeler ensuite la fonction standard uaConnect pour établir une liaison avec le composant User
Archives. uaConnect crée le handle UAHCONNECT permettant d'ouvrir et de fermer des archives et
des vues.
Ouverture des fonctions runtime

Le mode runtime suppose qu'une archive utilisateur ait déjà été configurée. Les fonctions
uaQueryArchive et uaQueryArchiveByName créent un handle pour les fonctions runtime. Les fonction
runtime User Archives sont utilisables après ouverture de l'archive avec la fonction uaArchiveOpen.
Fonctions pour le mode runtime

Les fonctions uaArchiveNext, uaArchivePrevious, uaArchiveFirst et uaArchiveLast déplacent le
pointeur de position. Grâce au handle hArchive l'affectation à un enregistrement de l'archive utilisateur
est univoque. Cette affectation permet également l'adressage indirect, tel que requis par exemple pour
les masques d'écran.
La fonction uaArchiveUpdate stocke l'enregistrement temporaire dans l'archive et y écrase

l'enregistrement courant désigné par l'indicateur de position. Cet enregistrement doit au préalable être
lu à l'aide des fonctions uaArchiveNext, uaArchivePrevious, uaArchiveFirst ou uaArchiveLast .
Couper une liaison à User Archives

La fonction uaArchiveClose ferme une archive utilisateur. La fonction uaReleaseArchive coupe la
liaison à l'archive actuelle tandis que la fonction uaDisconnect coupe pour finir la liaison au
composant User Archives.
6-2 WinCC Manuel

C79000-G8263-C141-01
6.3 Les handles des fonctions de script

6.3.1 Handles pour la configuration de User Archives
La fonction de script User Archives uaQueryConfiguration crée le handle UAHCONFIG nécessaire à
la configuration des archives utilisateur. Il faut donc d'abord appeler la fonction
uaQueryConfiguration pour obtenir le handle UAHCONFIG. Ce handle permet alors d'appeler les
fonctions de script de configuration ci-dessous. Pour clore la configuration, il faut finalement appeler
uaReleaseConfiguration.
Handles pour la configuration User Archives

UaQueryConfiguration ---> Handle UAHCONFIG
requis par :
uaAddArchive
uaAddField
uaGetArchive
uaGetField
uaGetNumArchives
uaGetNumFields
uaReleaseConfiguration
uaRemoveAllArchives
uaRemoveAllFields
uaRemoveArchive
uaRemoveField
uaSetArchive
uaSetField
WinCC Manuel 6-3

C79000-G8263-C141-01
6.3.2 Handles pour les fonctions d’archive runtime

La fonction User Archives uaConnect crée le handle UAHCONNECT nécessaire à l'ouverture et à la
fermeture des archives et vues. Il faut donc d'abord appeler la fonction uaConnect pour obtenir le
handle UAHCONNECT. Ce handle permet d'appeler les fonctions de script ci-dessous pour
l'ouverture et la fermeture des archives et vues. Pour clore la configuration, il faut finalement appeler
uaReleaseDisconnect. Les fonctions uaQueryArchive et uaQueryArchiveByName créent le handle
UAHARCHIVE. Ce handle est nécessaire pour la fonction de script User Archives uaArchiveOpen
qui ouvre l'archive pour le mode runtime.
Handles pour les fonctions d’archive runtime

UaConnect -> Handle
UAHCONNECT
requis par...
uaDisconnect
uaQueryArchive --> Handle UAHARCHIVE
uaQueryArchiveByName --> Handle UAHARCHIVE
requis par...
uaArchiveOpen
Condition pour...
uaArchiveClose
uaArchiveDelete
uaArchiveExport
uaArchiveGetFieldLength
uaArchiveGetFields
uaArchiveGetFieldType
uaArchiveGetFieldValueDate
uaArchiveGetFieldValueDouble
uaArchiveGetFieldValueLong
uaArchiveGetFieldValueString
uaArchiveGetFiledName
uaArchiveGetFilter
uaArchiveGetID
uaArchiveGetName
uaArchiveGetSort
uaArchiveImport
uaArchiveInsert
uaArchiveMoveFirst
uaArchiveMoveLast
uaArchiveMoveNext
uaArchiveMovePrevious
uaArchiveReadTagValues
uaArchiveReadTagValuesByName
uaArchiveRequery
uaArchiveSetFieldValueDate
uaArchiveSetFieldValueDouble
uaArchiveSetFieldValueLong
uaArchiveSetFieldValueString
uaArchiveSetFilter
uaArchiveSetSort
uaArchiveUpdate
uaArchiveWriteTagValues
uaArchiveWriteTagValuesByName
uaReleaseArchive
6-4 WinCC Manuel

C79000-G8263-C141-01
6.4 Exemple pratique avec fonctions de script
Vous trouverez ci-après un exemple avec deux fonctions standard permettant la lecture et l'écriture
d'une archive utilisateur en runtime. La fonction "UAReadFromArchive" lit l'archive "Coca" et
affiche les données lues dans la "Fenêtre de diagnostic Global Script". La fonction
"UAWriteToArchive" écrit l'archive et affiche les états et alarmes. La fenêtre de diagnostic est créée à
l'aide de la palette d'objets (objets complexes Smart Objects, contrôle OLE) et par sélection de
"WinCC Global Script - Dianostic Control" dans la fenêtre "Insérer commande OLE".
Créez dans Graphics Designer une nouvelle page pour votre projet. Créez alors dans Graphics
Designer les boutons "Lire archive" et "Ecrire archive" et affectez leur les fonctions de
script décrites ci-après. Procédez comme suit:
Dans la fenêtre de sélection "Palette d’objets", sélectionnez sous "Objets Windows" le bouton
"Button".
Tirez un nouveau bouton sur le plan de travail de Graphics Designer en maintenant le bouton de
souris enfoncé.
D Cliquez avec le bouton droit de la souris sur le nouveau bouton et sélectionnez dans le menu
l'option "Propriétés". Dans l’onglet "Propriétés", définissez le texte et la couleur du bouton. Le
texte pourra être par exemple "Lire archive" et "Ecrire archive".
Dans l'onglet "Evénement" affectez une action à la souris en cliquant sur "Souris" puis en
double-cliquant sur "Clic de souris". L'éditeur de scripts s'ouvre. Entrez la fonction de script
standard UAReadFromArchive ci-dessous.
WinCC Manuel 6-5

C79000-G8263-C141-01
#include "apdefap.h"
void UAReadFromArchive()
{
UAHCONNECT hConnect;
UAHARCHIVE hArchive;
LONG IndexArchive;
LONG FieldLength;
LONG FieldType;
LONG NumberOfFields;
LONG Index;
long IntValue;
double DoubleValue;
char ArchivName[255], StringField[255];
SYSTEMTIME SysDate;
//******* Connect to Component User Archives ***********************************

if ( uaConnect( &hConnect ) == FALSE )
{
printf( "uaConnect error: %d\n", uaGetLastError() );
return;
}
if ( hConnect == NULL )
{
printf( "Handle UAHCONNECT equals NULL\n" );
return;
}
//******* Connect to Archive via Archive Name ***********************************

if ( uaQueryArchiveByName( hConnect, "Chili", &hArchive ) == FALSE )
{
printf( "uaQueryArchive Error: %d\n", uaGetLastError() );
return;
}
//******* Opens Archive *******************************************************

if ( uaArchiveOpen( hArchive ) == FALSE )
{
printf( "uaArchive Open Error\n" );
return;
}
//******* Get Number of Fields *************************************************

NumberOfFields = uaArchiveGetFields( hArchive );
printf( "Number of Fields = %u\n", NumberOfFields );
6-6 WinCC Manuel

C79000-G8263-C141-01
//******* Read and show Data Fields ********************************************

for ( Index = 1; Index < NumberOfFields; Index++ )
{
printf( "Data of Field %u: \n", Index );
FieldType = uaArchiveGetFieldType( hArchive, Index );

switch ( FieldType )
{
case UA_FIELDTYPE_INTEGER :
printf("Field Type = Integer\n");
if ( uaArchiveGetFieldValueLong ( hArchive, Index, &IntValue ) == TRUE )
printf( "Field Value = %u\n", IntValue );
else
printf("Error callinguaArchiveGetFieldValueLong: %d\n", uaGetLastError() );
break;
case UA_FIELDTYPE_DOUBLE :
printf("Field Type = Double\n");
if ( uaArchiveGetFieldValueDouble (hArchive, Index, &DoubleValue) == TRUE )
printf( "Field Value = %g\n", DoubleValue );
else
printf( "Error calling uaArchiveGetFieldValueDouble: %d\n",
uaGetLastError() );
break;
case UA_FIELDTYPE_STRING :
printf("Field Type = String\n");
if ( uaArchiveGetFieldValueString ( hArchive, Index, StringField, 20 ) == TRUE )
printf( "Field Value = %s\n", StringField );
else
printf( "Error callinguaArchiveGetFieldValueString: %d\n", uaGetLastError());
break;
case UA_FIELDTYPE_DATETIME :
printf("Field Type = Date & Time\n");
if ( uaArchiveGetFieldValueDate ( hArchive, Index, &SysDate ) == TRUE )
printf( "%d.%d.%d\n ",SysDate.wDay, SysDate.wMonth, SysDate.wYear );
else
printf( "Error calling uaArchiveGetFieldValueLong: %d\n", uaGetLastError());
break;
case -1 :
default :
printf( "Error executing uaArchiveGetFieldType\n");
}
//******* Read and show Field Length **************************************

FieldLength = uaArchiveGetFieldLength( hArchive, Index );
if ( FieldLength != -1 )
printf( "Field Length = %u\n", FieldLength );
else
printf( "Error executing uaArchiveGetFieldLength\n");
}
WinCC Manuel 6-7

C79000-G8263-C141-01
//******* Close Archive *******************************************************

if ( uaArchiveClose ( hArchive ) == FALSE )
{
printf( "error on closing archive\n" );
return;
}
//****** Release Connection to Archive ****************************************

if ( uaReleaseArchive ( hArchive ) == FALSE )
{
printf( "error on releasing archive\n" );
return;
}
//******* Disconnect to Component User Archives ********************************

if ( uaDisconnect ( hConnect ) == FALSE )
{
printf( "error on disconnection\n" );
return;
}
}
Créez un deuxième bouton pour l'écriture de l'archive. Procédez comme décrit pour le premier bouton.
Nommez à présent la fonction standard UAWriteToArchive puis entrez le code de script suivant:
void UAWriteToArchive()
{
UAHCONNECT hConnect;
UAHARCHIVE hArchive;
LONG IndexArchive;
LONG FieldLength;
LONG FieldType;
LONG NumberOfFields;
LONG Index;
long IntValue;
double DoubleValue;
char StringField[255];
SYSTEMTIME SysDate;
//******* Connect to Componente User Archives *******************************

if ( uaConnect( &hConnect ) == FALSE )
{
printf( "uaConnect error: %d\n", uaGetLastError() );
return;
}
if ( hConnect == NULL )
{
printf( "Handle UAHCONNECT equals NULL\n" );
return;
}
6-8 WinCC Manuel

C79000-G8263-C141-01
//******* Connect to Archive via Name ***************************************

if ( uaQueryArchiveByName( hConnect, "Chili", &hArchive ) == FALSE )
{
printf( "uaQueryArchive Error: %d\n", uaGetLastError() );
return;
}
//******* Opens Archivs ****************************************************

if ( uaArchiveOpen( hArchive ) == FALSE )
{
printf( "uaArchive Open Error\n" );
return;
}
//******* Get Number of Fields **********************************************

NumberOfFields = uaArchiveGetFields( hArchive );
//******* Read Last Data Set ************************************************

if ( uaArchiveMoveLast( hArchive ) == TRUE )
else
{
printf( "uaArchiveMoveLast Error: %d\n", uaGetLastError() );
return;
}
//******* Write into Data Fields *********************************************

IntValue = 32;
DoubleValue = 64;
strcpy( StringField, "Text12" );
GetSystemTime( &SysDate );
for ( Index = 1; Index < NumberOfFields; Index++ )

{
printf( "Data of Field %u: \n", Index );
FieldType = uaArchiveGetFieldType( hArchive, Index );
switch ( FieldType )
{
case UA_FIELDTYPE_INTEGER :
printf("Field Type = Integer\n");
if ( uaArchiveSetFieldValueLong ( hArchive, Index, IntValue ) == TRUE )
printf( "Field Value = %u\n", IntValue );
else
printf( "Error calling uaArchiveSetFieldValueLong: %d\n", uaGetLastError());
break;
case UA_FIELDTYPE_DOUBLE :
printf("Field Type = Double\n");
if ( uaArchiveSetFieldValueDouble ( hArchive, Index, DoubleValue ) == TRUE )
printf( "Field Value = %g\n", DoubleValue );
else
printf( "Error calling uaArchiveSetFieldValueDouble: %d\n",
uaGetLastError() );
break;
WinCC Manuel 6-9

C79000-G8263-C141-01
case UA_FIELDTYPE_STRING :
printf("Field Type = String\n");
if ( uaArchiveSetFieldValueString ( hArchive, Index, StringField ) == TRUE )
printf( "Field Value = %s\n", StringField );
else
printf( "Error calling uaArchiveSetFieldValueString: %d\n",
uaGetLastError() );
break;
case UA_FIELDTYPE_DATETIME :
printf("Field Type = Date & Time\n");
if ( uaArchiveSetFieldValueDate ( hArchive, Index, &SysDate ) == TRUE )
printf( "%d.%d.%d\n ", SysDate.wDay, SysDate.wMonth, SysDate.wYear );
else
printf( "Error calling uaArchiveGetFieldValueLong: %d\n",
uaGetLastError() );
break;
case -1 :
default :
printf( "Error executing uaArchiveGetFieldType\n");
}
FieldLength = uaArchiveGetFieldLength( hArchive, Index );

if ( FieldLength != -1 )
printf( "Field Length = %u\n", FieldLength );
else
printf( "Error executing uaArchiveGetFieldLength\n");
//******* Close Archive ******************************************************

if ( uaArchiveClose ( hArchive ) == FALSE )
{
printf( "error on closing archive\n" );
return;
}
//****** Release Connection to Archive *****************************************

if ( uaReleaseArchive ( hArchive ) == FALSE )
{
printf( "error on releasing archive\n" );
return;
}
//******* Disconnect Component User Archives ***********************************

if ( uaDisconnect ( hConnect ) == FALSE )
{
printf( "error on disconnecting\n" );
return;
}
}
Vous pouvez maintenant refermer Graphics Editor et Script Editor puis démarrer le runtime. Vous
pourrez observer les effets de vos fonctions de script dans la fenêtre de diagnostic Global Script.
6-10 WinCC Manuel

C79000-G8263-C141-01
6.5 Récapitulatif des fonctions User Archive

6.5.1 Récapitulatif des fonctions API User Archive
Ces fonctions lisent la dernière erreur User Archives lue et l'erreur de la dernière fonction COM.
Fonctions User Archives Description

uaGetLastError Lire dernière erreur
uaGetLastHResult Lire dernière erreur COM
6.5.2 Récapitulatif des fonctions de configuration User Archives

Ces fonctions servent à configurer User Archives.

uaAddArchive Ajouter une nouvelle archive
uaAddField Ajouter un nouveau champ
uaGetArchive Lire configuration d'archive
uaGetField Lire configuration de champ
uaGetNumArchives Trouver nombre d'archives configurées
uaGetNumFields Trouver nombre de champs
uaSetArchive Ecrire configuration d'archive
uaRemoveArchive Supprimer archive
uaRemoveAllArchives Supprimer toutes les archives
uaSetField Ecrire configuration de champ
uaQueryConfiguration Etablir une liaison à la configuration User
Archives
uaReleaseConfiguration Couper liaison à la configuration
uaRemoveAllFields Supprimer tous les champs
uaRemoveField Supprimer un champ
6.5.3 Récapitulatif des fonctions générales runtime

Ces fonctions servent à ouvrir et fermer des archives et vues pour le mode runtime.

uaConnect Etablir une liaison à User Archives Cette
liaison est valide pour toutes les archives
pendant l'exécution du runtime.
uaDisconnect S'il existe une liaison à User Archives
(runtime), la couper
uaQueryArchive Etablir une liaison à User Archives
uaQueryArchiveByName Etablir une liaison par le nom d'archive
uaReleaseArchive Couper liaison
WinCC Manuel 6-11

C79000-G8263-C141-01
6.5.4 Récapitulatif des fonctions runtime spécifiques

Ces fonctions servent à l'utilisation d'archives et de vues en mode runtime.

uaArchiveOpen Etablir liaison à l'archive actuelle
uaArchiveClose Couper liaison à l'archive actuelle
uaArchiveDelete Supprimer un enregistrement dans
l'archive actuelle
uaArchiveExport Exporter l'archive actuelle
uaArchiveGetFieldLength Lire longueur du champ actuel
uaArchiveGetFieldName Lire nom du champ actuel
uaArchiveGetFields Lire nombre de champs
uaArchiveGetFieldType Lire type du champ actuel
uaArchiveGetFieldValueDate Lire date et heure du champ de données
actuel
uaArchiveGetFieldValueDouble Lire Double du champ de données actuel
uaArchiveGetFieldValueLong Lire Long Int du champ de données actuel
uaArchiveGetFieldValueString Lire String du champ de données actuel
uaArchiveGetFilter Lire filtre du champ de données actuel
uaArchiveGetID Lire ID du champ de données actuel
uaArchiveGetName Lire nom du champ de données actuel
uaArchiveGetSort Lire critère de tri du champ de données
actuel
uaArchiveImport Importer archive
uaArchiveInsert Insérer nouvel enregistrement dans archive
uaArchiveMoveFirst Atteindre le premier enregistrement
uaArchiveMoveLast Atteindre le dernier enregistrement
uaArchiveMoveNext Atteindre l'enregistrement suivant
uaArchiveMovePrevious Atteindre l'enregistrement précédent
uaArchiveReadTagValues Lire valeurs de variable
uaArchiveReadTagValuesByNam Lire valeurs de variable par nom
e
uaArchiveRequery Nouvelle interrogation
uaArchiveSetFieldValueDate Ecrire dans le champ de données actuel
uaArchiveSetFieldValueDouble Ecrire Double du champ de données actuel
uaArchiveSetFieldValueLong Ecrire Long Int du champ de données
actuel
uaArchiveSetFieldValueString Ecrire String du champ de données actuel
uaArchiveSetFilter Activer filtre
uaArchiveSetSort Activer critère de tri
uaArchiveUpdate Rafraîchir enregistrement
uaArchiveWriteTagValues Ecrire valeurs de l'enregistrement actuel
dans variable
uaArchiveWriteTagValuesByNa Ecrire valeurs de l'enregistrement actuel
me dans variable par nom
6-12 WinCC Manuel

C79000-G8263-C141-01
11.98 L'interface de télégramme SIMATIC S5 et S7
7 Récapitulatif de l'interface de télégramme SIMATIC

S5 et S7
L'échange de données entre archives utilisateur et automates S5 ou S7 peut s'effectuer à l'aide de
variables de données brutes ou de variables de gestionnaire de données. Toutes les interfaces
SIMATIC sont utilisables à l'exception de l'interface de programmation AS511.
Un échange de données avec WinCC est possible avec les automates suivants:
- S7-400
- S5-AG-115U ou supérieur
Les rubriques suivantes sont expliquées:

• Echange de données avec S5 et S7 par variables du gestionnaire de données
• Echange de données avec S5 et S7 par variables de données brutes
• Différences de format entre WinCC et S5/S7
7.1 Echange de données avec S5 et S7 par variables de gestionnaire

de données
L'échange de données avec S5 ou S7 par variables de gestionnaire de données est particulièrement
simple. On notera cependant que seuls des types de données définis dans la gestion de variables sont
utilisables comme types de données des archives utilisateur.
En cas d'utilisation des types de données Integer, Double et String dans l'archive utilisateur, utiliser les
types de données suivants dans la gestion des variables du gestionnaire de données. Il n'existe dans la
gestion des variables aucun type de données correspondant au type de données User Archive
Date/Heure.
Sélection dans User Archive Editor Gestion des variables / Variable de gestionnaire
de données
Nombre (entier) Valeur signée 32 bits
Nombre (double) Nombre à virgule flottante 64 bits IEEE 754
Chaîne de caractères Variable de texte chaîne de caractères 8 bits
Date/Heure Aucun type de données adéquat
7.2 Echange de données avec S5 et S7 par variables de données

brutes
Cette section décrit l'échange de données par variables de données brutes WinCC. Les variables de
données brutes peuvent être émises par l'automate via un émetteur actif. Les télégrammes contiennent
une ou plusieurs requêtes adressées au système d'archives de WinCC. Il peut s'agir aussi bien de
contrats d'écriture que de contrats de lecture. En réponse à ces requêtes, WinCC retourne les données
requises et un acquittement de traitement.
Vous trouverez ci-après des informations sur les sujets suivants:

• Transmission de contrats / données à WinCC
• Transmission d'acquittements de traitement / données à SIMATIC S5 et S7
• Structure des en-têtes de télégramme
WinCC Manuel 7-1

C79000-G8263-C141-01
L'interface de télégramme SIMATIC S5 et S7 11.98
7.2.1 Emission de contrats / données à WinCC

Structure de la variable de données brutes pour transmission de contrats et de données des automates
SIMATIC S5 et S7 à WinCC:
Télégramme à S5 / S7
En-tête de télégramme
En-tête de contrat 1
Données du contrat 1
éventuel. en-tête du contrat 2
éventuel. données du contrat 2
Contrat n
7.2.2 Transmission d'acquittements de traitement / données à SIMATIC S5 et S7

Structure de la variable de données brutes pour transmission d'acquittements de traitement et de
données aux automates SIMATIC S5 et S7:
Variable de données brutes pour transmission à

S5 et S7
Acquittement de traitement
En-tête d'acquittement
Données d'acquittement
7.2.3 Structure des en-têtes de télégramme

Structure détaillée des blocs de télégramme (division en octets):
Fonction du champ Commentaire

Longueur du télégramme en octets LSB *) Longueur du champ 4
octets
. Longueur max. 4091 octets
. .(S5/S7-Transport)
Longueur de télégramme en octets MSB **) .
Type de transfert 1 de WinCC, 2 de
l'automate
Réservé
Nombre de contrats par télégramme LSB *) Longueur du champ 2
octets
Nombre de contrats par télégramme MSB**) .
Nom de l'archive, 1er caractère Le nom est indiqué
. en ASCII
. Longueur du champ 8
. octets.
. .
. .
. .
Nom de l'archive, 8e caractère .
*) LSB = Least Significant Byte (octet de poids le plus faible)

**) MSB = Most Significant Byte (octet de poids le plus fort)
7-2 WinCC Manuel

C79000-G8263-C141-01
7.2.4 En-tête de contrat

Structure détaillée de l'en-tête (division en octets):

Longueur du contrat en octets Longueur du champ 2 octets
LSB
Longueur du contrat en octets .
MSB
Type de contrat cf. description
Réservé
Numéro de champ LSB Longueur du champ 2 octets
Numéro de champ MSB .
Numéro d'enregistrement LSB Longueur du champ 4 octets
. .
. .
Numéro d'enregistrement .
MSB
Critère de sélection LSB Numéro de champ en fonction duquel
s'effectue la sélection
Critère de sélection MSB (pas pour 0) Longueur du champ 2 octets
Données du contrat
Les données du contrat correspondent au contenu d'un enregistrement (ou du champ adressé).
Note importante
• Champs de texte pas terminés par \0.
• Les nombres doivent être transmis au format Intel (d'abord LSB, ensuite MSB).
• Un champ Integer à une longueur de 4 octets, un champ Double une longueur de 8 octets.
• Les données sont décalées d'une longueur égale au champ choisi comme critère de sélection si le
critère de sélection possède une valeur différente de 0.
• Si le critère de sélection est utilisé, le début de la zone de données est pris en compte comme
valeur de sélection avec une taille égale à la taille du champ du critère de sélection.
WinCC Manuel 7-3

C79000-G8263-C141-01
En-tête d'acquittement
Structure détaillée de l'en-tête d'acquittement (division en octets):

Longueur du télégramme en octets Longueur du champ 4 octets
LSB
. .
. .
Longueur de télégramme en octets .
MSB
Type de transfert 1 de WinCC, 2 de l'automate
Réservé
Type de contrat cf. description
Réservé
Réservé
Numéro de champ LSB Longueur du champ 2 octets
Numéro de champ MSB .
Numéro d'enregistrement LSB Longueur du champ 4 octets
. .
. .
Numéro d'enregistrement MSB .
Nom de l'archive, 1er caractère Le nom est indiqué
. en ASCII
. Longueur du champ 8 octets
. .
. .
. .
. .
Nom de l'archive, 8e caractère .
Données d'acquittement:
L'acquittement contient l'enregistrement ou le champ adressé (en cas de requête de lecture) ou bien il
est vide (contrat de lecture, d'archivage).
Description des types de contrat:
Type Description
4 Vérifier existence de l'archive
5 Supprimer tous les enregistrements de
l'archive
6 Lire enregistrement
7 Ecrire enregistrement
8 Supprimer enregistrement
9 Lire champ d'enregistrement
10 Ecrire champ d'enregistrement
7-4 WinCC Manuel

C79000-G8263-C141-01
Description du code d’erreur:
Groupe N° Description
Général 0 La fonction a été exécutée
Archive 1 Données non admissibles
Archive 2 Données inexistantes
Fiche 101 Données non admissibles
Fiche 102 Données inexistantes
Champ. 201 Données non admissibles
Champ. 202 Données inexistantes
Général 254 Fonction inexistante
Général 255 Erreur non définie
7.3 Différences entre les formats de données de WinCC et de S5/S7

Les formats de données WinCC sont d'une manière générale différents des formats de données des
automates SIMATIC S5/S7. Il convient d'en tenir compte pour éviter de commettre des erreurs par
inadvertance.
WinCC respecte les formats de données de Intel et Microsoft dans lesquels les octets de poids faible
précèdent les octets de poids fort. Ce format de données est très largement répandu et généralement
connu sous le nom de "format Intel". Voici un exemple illustrant le "format Intel":
Format Intel
Dans le format Intel, le nombre décimal 300 est enregistré comme suit:
Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
Binaire 0 0 0 0 0 0 0 1 0 0 1 0 1 1 0 0
Hex 0 1 2 C
Le nombre hexadécimal 300 correspond dans le format Intel au nombre hexadécimal 12C (1*256 +
2*16 + 12).
Format SIMATIC
Dans le format SIMATIC, les octets de poids faible sont inscrits aux emplacements de poids fort.
Dans le format SIMATIC, le nombre décimal 300 est enregistré comme suit:
Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
Binaire 0 0 1 0 1 1 0 0 0 0 0 0 0 0 0 1
Hex 2 C 0 1
Le nombre décimal 300 correspond dans le format SIMATIC au nombre hexadécimal 2C01. Si 2C01
a été interprété par erreur comme un nombre au format Intel, le nombre obtenu sera 11265 en notation
décimale, soit une différence importante.
Il existe pour les API SIMATIC des blocs fonctionnels qui effectuent la conversion appropriée. Ceux-
ci doivent toujours être appelés avant et après un transfert de données entre S5/S7 et WinCC. Les
blocs de fonction peuvent être téléchargés sur le site Internet Siemens Customer Support (
http://www.ad.siemens.de/support/html_00/download/s5-ag135.htm#.._download_s5-
ag135_angps5_3.htm ). Le fichier à télécharger est le fichier comprimé ANSI_S5.EXE. Le fichier
ANSI_S5.EXE contient le bloc fonctionnel "IEEE:GP".
L'émission active est décrite dans les manuels de référence des automates ou du PC (processeur de
communication).
WinCC Manuel 7-5

C79000-G8263-C141-01
7-6 WinCC Manuel

C79000-G8263-C141-01
11.98 Annexe
8 Annexe
Vous trouverez dans cette annexe les rubriques suivantes:
• Instructions SQL pour la formulation de conditions de filtrage et de tri d’archives utilisateur
• Liste alphabétique de mots-clé SQL; ces mots-clé ne doivent pas être utilisés comme noms
d'archive ou de champ dans User Archives
• Performances, notamment Performances en écriture et en lecture de variables et Performances des
temps d'affichage des images
• Restrictions système à ne pas perdre de vue
8.1 Le langage SQL

SQL (Structured Query Language) est un langage de base de données puissant, largement répandu.
Dans les fonctions de scripts WinCC, le langage SQL est utilisé pour les tâches spécifiques aux bases
de données. Pour plus de détails, consulter les ouvrages spécialisés.
Pour certaines fonctions de l'éditeur User Archives et fonctions de script, vous serez amené à entrer
des conditions en langage SQL pour spécification des enregistrements à traiter. Voici ci-après
quelques exemples illustrant la syntaxe des instructions SQL:
• FieldA > '1992-12-31 23:45:12.124'
L'instruction sélectionne tous les enregistrements dont la valeur dans la colonne "FieldA" est
supérieure à celle spécifiée. Le type de données de la colonne FieldA est DB_TYP_TIME.
• FieldB like 'Chaudière%'
Cette instruction sélectionne par exemple les enregistrements qui possèdent dans la colonne
"FieldB" la valeur "Chaudière1", "Chaudière4", "Chaudière12". Le type de données de la colonne
FieldB est DB_TYP_CHAR.
• FieldC > 100
Une condition de ce type permet de sélectionner tous les enregistrements qui possèdent dans la
colonne "FieldC" une valeur supérieure à 100. Le type de données de la colonne FieldC est
DB_TYP_INTEGER.
• BETWEEN FieldC = 20 AND Field C = 200
L'instruction sélectionne tous les enregistrements dont la valeur dans la colonne "FieldC" est située
entre 20 et 200. Le type de données de la colonne FieldC est DB_TYP_INTEGER.
• FieldD
Cette instruction effectue un tri en fonction de la colonne "FieldD".
• FieldE desc
Cette instruction effectue un tri en fonction de la colonne "FieldE" dans l'ordre alphabétique
descendant.
WinCC Manuel 8-1

C79000-G8263-C141-01
Annexe 11.98
8.2 Liste alphabétique des mots-clés SQL

Les noms d’archives, de vues et de champs ne doivent contenir que des lettres, des chiffres et des
caractères de soulignement "_", et leur longueur ne doit pas dépasser 25 caractères. Le premier
caractère doit toujours être un caractère.
Les mots suivants ne doivent pas être utilisés comme noms d'archives, de vues et de champs:
• "Archives"
• "View"
• "Field"
• "ViewCol"
• Tous les mots-clés SQL
Les mots-clés (ou mots réservés) du langage de base de données SQL ne doivent pas être utilisés
comme noms d'archive, de vues ou de champs de données dans User Archives. Le tableau ci-après
récapitule les mots-clés SQL:
Mots-clés utilisés dans le langage SQL

add all alter and
any as asc begin
between binary break by
call cascade cast char
char_convert character check checkpoint
close comment commit connect
constraint continue convert create
cross current cursor date
dba dbspace deallocate dec
decimal declare default delete
desc distinct do double
drop else elseif encrypted
end endif escape exception
exec execute exists fetch
first float for foreign
from full goto grant
group having holdlock identified
if in Index inner
inout insert instead Int
integer into is isolation
join key left like
lock long match membership
message mode modify named
natural noholdlock not null
numeric of off on
open option options or
order others out outer
passthrough precision prepare primary
print privileges proc procedure
raiserror readtext real reference
references release remote rename
resource restrict return revoke
right rollback save savepoint
schedule select set share
smallint some sqlcode sqlstate
8-2 WinCC Manuel

C79000-G8263-C141-01
11.98 Annexe
start stop subtrans subtransaction

synchronize syntax_error table temporary
then time tinyint to
tran trigger truncate tsequal
union unique unknown update
user using validate values
varbinary varchar variable varying
view when where while
with work writetext
8.3 Caractéristiques quantitatives

Environnement de test
Les mesures décrites ci-après ont été réalisées dans l'environnement de test suivant:
• Matériel: Pentium II 266 / 64Mo
• Couplage: S5 Ethernet Layer 4 CP1413 sur CP143 dans S5-115U
• Environnement de projet:
- Système d'alarme avec archivage et charge permanente de 1 alarme/s
- Archivage de 8 valeurs de process/s
- Saisie de 8 valeurs de process/s
Variables de gestionnaire de données et variables de données brutes

Les mesures ont été effectuées avec les variables de gestionnaire de données WinCC. Comme le
montrent les mesures, les temps d'accès augmentent pour les archives volumineuses.
Nous recommandons pour cette raison l'emploi pour les archives volumineuses de variables de
données brutes. Les variables de données brutes transfèrent les données par paquets et assurent ainsi
des accès plus rapides aux archives volumineuses.
8.3.1 Performances en écriture et en lecture de variables

L'objet de la mesure de performances décrite ici était d'observer le comportement des archives
utilisateur lors de l'écriture et de la lecture de variables.
Nombre de Nombre Temps d'écriture des Temps de lecture

colonnes d’enregistrements variables en s des variables en s
100 1 1 4
100 10 1 4
100 50 1 4
100 100 2 4
100 1000 4 4
200 1 1 8
200 10 2 9
200 50 2 9
200 100 2 9
200 1000 8 8
500 1 2 20
500 10 4 20
500 50 3 20
500 100 3 20
500 500 8 20
WinCC Manuel 8-3

C79000-G8263-C141-01
Annexe 11.98
8.3.2 Temps d’affichage des vues

Le tableau ci-après récapitule les résultats d'une mesure des temps d'affichage de vues. La fenêtre de
tableau de l'éditeur d'archives utilisateur est supposée inactive.
Nombre de Nombre Temps d’affichage de

colonnes d’enregistrements vues en s
100 1 1
100 10 2
100 100 2
100 500 4
100 1000 4
100 2000 9
100 3000 10
200 1 1
200 10 3
200 100 3
200 500 5
200 1000 11
200 1500 15
500 1 2
500 10 5
500 100 8
500 500 22
8.4 Restrictions système à noter
• La communication entre API et archives utilisateur est limitée à une liaison par archive utilisateur.
• Lors de l'établissement de la communication avec un automate, le PLCID ne doit pas contenir plus
de 8 caractères.
• La fenêtre de tableau de User Archives peut représenter aux maximum 100 lignes.
• Les termes contenant des caractères spéciaux ou composés de mots réservés ne sont pas
admissibles pour la désignation de champs ou de tables. Se référer à ce sujet au chapitre "Liste
alphabétique de mots-clés SQL".
8-4 WinCC Manuel

C79000-G8263-C141-01
11.98 Index
Index
Interface télégramme SIMATIC S5 et S7 7-1
Introduction 1-1
A
Archive 1-1
L
Légende 1-6
B
Barre d’outils 4-6
M
Boîte de dialogue "Communication" 2-4
Boîte de dialogue "Valeurs" 2-12 Mots-clés SQL 8-2
Boîte de dialogue "Variables de sélection" 2-
5
Boîte de dialogue"Droits et indicateurs" 2-7, N
2-13
Niveaux d'autorisation 2-7
C
O
Caractéristiques quantitatives 8-3
Commande par menus 4-1 Onglet "Ordre" 2-9, 2-15, 2-20, 2-24
Configuration 1-3 Onglet "Relation" 2-19
Configuration d'archives utilisateur 2-2 Opérations de configuration 2-1
Configuration de champs d'archives 2-10
Configuration de champs de vue 2-20
Configuration de vues 2-16 P
configuration d'un contrôle User Archives 5-2
configuration d'une vue de formulaire 5-4 Performances 1-5
Contrôle User Archives 1-3 présentation en tableau 5-1
Création de champs de formulaire 5-13 Propriétés contrôle WinCC User Archives 5-8
Propriétés de champs de vues 2-23
Propriétés de vues 2-18
Propriétés des archives utilisateur 2-9
E Propriétés des champs de données 2-14
Exemple avec fonctions de scripts 6-5
Exemple avec recette 2-1
Exemple avec saisie de données d'exploitation R
1-3
Récapitulatif des fonctions User Archives 6-
11
runtime 5-17
F Runtime 1-3
Fenêtre de données 1-2
Fenêtre de navigation 1-2
Fenêtre de tableau 1-2, 3-1 S
Fonctions de scripts 6-1
Fonctions de scripts User Archives 1-3 Script d'action 6-1
suppression de contrôles User Archives 5-16
H
U
Handles des fonctions de scripts 6-3
User Archives Editor 1-2
I
V
Instructions SQL 8-1
vue de formulaire 5-1
WinCC Manuel Index-1

C79000-G8263-C141-01
Index 11.98
Vues 1-1
Index-2 WinCC Manuel

C79000-G8263-C141-01

Archv 42 F

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Archv 42 F

Transféré par

Droits d'auteur :

Formats disponibles

WinCC

Edition Novembre 1998

2 Configuration d’archives utilisateur ................................................................ 2-1

3 La fenêtre de l'éditeur User Archives Editor ................................................... 3-1

4 Menus et barre d'outils de l'éditeur d'archives utilisateur ............................. 4-1

5 Contrôle de table WinCC User Archives.......................................................... 5-1

6 Fonctions de script standard pour archives utilisateur ................................. 6-1

7 Récapitulatif de l'interface de télégramme SIMATIC S5 et S7 ....................... 7-1

WinCC Manuel iii

Présentation générale et exemple de configuration

Informations relatives aux produits SIMATIC

1.1 Applications de User Archives

1.2 Les composants de User Archives

Deux outils sont disponibles pour la création d'archives utilisateur:

WinCC Manuel 1-1

1.2.1 L'éditeur User Archives Editor

• la fenêtre de navigation (en haut à gauche) pour la sélection d'archives et de vues.

1-2 WinCC Manuel

1.2.2 Contrôle User Archive

1.2.3 Fonctions de scripts User Archives

1.3 Configuration et runtime

Exemple de saisie de données d'une turbine

WinCC Manuel 1-3

S5 / S7 données fonctions fonctions enregistrement

Exemples de recettes d’un fabricant de boissons

Applications des vues

Archive Champ Vue Champ

1-4 WinCC Manuel

1.4 Fonctionnalités de User Archives

Représentation des valeurs

Consignation dans un journal

Transfert de / vers API (S5, S7 etc.)

• enregistrements entiers d'une archive

• dans la représentation en tableau

• dans les tableaux via des boutons standardisés

Suppression et création d'enregistrements

• création d'enregistrements dans des tableaux à l'aide de boutons

WinCC Manuel 1-5

• Création de variables WinCC comme variables de sélection avec l'assistant

désigne un clic du bouton gauche de la souris

1-6 WinCC Manuel

2 Configuration d’archives utilisateur

Configuration d’archives utilisateur

• Création d'une archive utilisateur

• Création d'une vue

Configuration de contrôles User Archives

• Création de contrôles User Archives

2.1 Exemple d’archive utilisateur

WinCC Manuel 2-1

Les archives utilisateur s’utilisent comme suit:

Archive Coca propriétés (colonnes)

2.2 Configuration d’archives utilisateurn

Pour créer une archive utilisateur, procédez comme suit.

2-2 WinCC Manuel

Cliquez sur le bouton "Nouvelle archive".

2.2.2 Boîte de dialogue "Général"

WinCC Manuel 2-3

2.2.3 Boîte de dialogue "Communication"

L'option "Type" permet de définir le type de communication:

2-4 WinCC Manuel

2.2.4 Boîte de dialogue "Variales de sélection"

WinCC Manuel 2-5

Fonction des variables de sélection