WinCC User Archives - Siemens

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 untiers à ces mêmes fins peuvent léser droits du détenteur.

(Toute reproduction de ce support d’informations, touteexploitation de son contenu sont interdites, sauf autorisationexpresse. Tout manquement à cette règle est illicite et exposeson auteur au versement de dommages et intérêts. Tous nosdroits sont réservés, notamment pour le cas de la délivranced'un brevet ou celui de l'enregistrement d'un modèle d'utilité.)

(Nous avons vérifié que le contenu de ce manuel correspondaux éléments matériels et logiciels qui y sont décrits. Desdivergences ne sont cependant pas exclues ce qui nousempêche de garantir une correspondance totale. Lesinformations fournies dans cet imprimé sont vérifiéesrégulièrement, les corrections nécessaires sont insérées dansl'édition suivante. Nous vous sommes reconnaissants pour touteproposition d'amélioration.)

Siemens AG 1994 - 1998 All rights reserved Sous réserve de modifications techniques

C79000-G8263-C141-01Printed in the Federal Republic of Germany Siemens Aktiengesellschaft

WinCC Manuel iC79000-G8263-C141-01

Sommaire

1 Introduction........................................................................................................ 1-11.1 Applications de User Archives ......................................................................................1-11.2 Les composants de User Archives ...............................................................................1-11.2.1 L'éditeur User Archives Editor.......................................................................................1-21.2.2 Contrôle User Archive ...................................................................................................1-31.2.3 Fonctions de scripts User Archives...............................................................................1-31.3 Configuration et runtime................................................................................................1-31.4 Fonctionnalités de User Archives..................................................................................1-51.5 Légende ........................................................................................................................1-6

2 Configuration d’archives utilisateur ................................................................ 2-12.1 Exemple d'archive utilisateur ........................................................................................2-12.2 Configuration d'archives utilisateurn .............................................................................2-22.2.1 Créer une archive utilisateur .........................................................................................2-22.2.2 Boîte de dialogue "Général"..........................................................................................2-32.2.3 Boîte de dialogue "Communication"..............................................................................2-42.2.4 Boîte de dialogue "Variales de sélection" .....................................................................2-52.2.5 Boîte de dialogue "Droits et indicateurs".......................................................................2-72.3 Propriétés d'archives...................................................................................................2-102.3.1 L'onglet "Ordre" ...........................................................................................................2-102.4 Configuration de Champs d'archive ............................................................................2-112.4.1 La boîte de dialogue "Général" ...................................................................................2-122.4.2 La boîte de dialogue „Valeurs“ ....................................................................................2-132.4.3 Boîte de dialogue "Droits et Indicateurs" ....................................................................2-142.5 Propriétés de champs d'archives ................................................................................2-152.5.1 Onglet "Ordre" .............................................................................................................2-162.6 Configuration de vues .................................................................................................2-172.6.1 Créer une vue..............................................................................................................2-172.7 Propriétés de vues ......................................................................................................2-202.7.1 L'onglet "Général" .......................................................................................................2-202.7.2 L'onglet „Relation“ ....................................................................................................... 2-212.7.3 L'onglet "Ordre" ...........................................................................................................2-222.8 Configuration de champs de vue ................................................................................2-222.8.1 La boîte de dialogue "Général" ...................................................................................2-232.9 Propriétés de champs de vue .....................................................................................2-252.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-14.1 Les menus de l'éditeur User Archives Editor ................................................................4-14.2 La barre d'outils de User Archives Editor......................................................................4-6

Sommaire 11.98

ii WinCC ManuelC79000-G8263-C141-01

5 Contrôle de table WinCC User Archives.......................................................... 5-15.1 Configuration d'un contrôle User Archives....................................................................5-25.1.1 Etapes de la configuration d'un contrôle User Archives ...............................................5-25.1.2 Placer un contrôle User Archives dans une vue de process ........................................5-25.1.3 Définition des propriétés du contrôle User Archives.....................................................5-35.1.4 Configuration d'une vue de formulaire ..........................................................................5-45.1.4.1 Création d'un champ de formulaire "Text" ....................................................................5-55.1.4.2 Création d'un champ de formulaire "Editer" ..................................................................5-55.1.4.3 Création d'un champ de formulaire "Button" .................................................................5-65.2 Les propriétés des contrôles WinCC User Archives.....................................................5-75.2.1 Propriétés d'objet des contrôles WinCC User Archives................................................5-75.2.2 Boîte de dialogue "Propriétés de WinCC User Archives Table Control" ......................5-85.3 Création de nouveaux champs de formulaire .............................................................5-135.3.1 Création de nouveaux champs de formulaire .............................................................5-135.3.2 Création d'un nouveau champ de formulaire "Text" ...................................................5-145.3.3 Création d'un nouveau champ de formulaire "Edit" ....................................................5-145.3.4 Création d'un nouveau champ de formulaire "Button" ................................................5-155.3.5 Modification de champs de formulaire ........................................................................5-165.3.6 Suppression de champs de formulaire .......................................................................5-165.4 Suppression d'un contrôle User Archives ...................................................................5-165.5 Contrôle User Archives au runtime .............................................................................5-175.5.1 Le tableau du contrôle User Archives .........................................................................5-175.5.2 Le formulaire du contrôle User Archives.....................................................................5-185.5.3 La barre d'outils du contrôle User Archives ................................................................5-18

6 Fonctions de script standard pour archives utilisateur ................................. 6-16.1 Généralités sur la création de scripts d'action ..............................................................6-16.2 Fonctions de script User Archives.................................................................................6-26.3 Les handles des fonctions de script ..............................................................................6-36.3.1 Handles pour la configuration de User Archives...........................................................6-36.3.2 Handles pour les fonctions d'archive runtime ...............................................................6-46.4 Exemple pratique avec fonctions de script ...................................................................6-56.5 Récapitulatif des fonctions User Archive ....................................................................6-116.5.1 Récapitulatif des fonctions API User Archive..............................................................6-116.5.2 Récapitulatif des fonctions de configuration User Archives........................................6-116.5.3 Récapitulatif des fonctions générales runtime ............................................................6-116.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-17.1 Echange de données avec S5 et S7 par variables de gestionnaire de données .........7-17.2 Echange de données avec S5 et S7 par variables de données brutes........................7-17.2.1 Emission de contrats / données à WinCC ....................................................................7-27.2.2 Transmission d'acquittements de traitement / données à SIMATIC S5 et S7..............7-27.2.3 Structure des en-têtes de télégramme..........................................................................7-27.2.4 En-tête de contrat..........................................................................................................7-37.3 Différences entre les formats de données de WinCC et de S5/S7...............................7-5

11.98 Sommaire

WinCC Manuel iiiC79000-G8263-C141-01

8 Annexe 8-18.1 Le langage SQL ............................................................................................................8-18.2 Liste alphabétique des mots-clés SQL .........................................................................8-28.3 Caractéristiques quantitatives.......................................................................................8-38.3.1 Performances en écriture et en lecture de variables ....................................................8-38.3.2 Temps d'affichage des vues..........................................................................................8-58.4 Restrictions système à noter.........................................................................................8-5

Sommaire 11.98

iv WinCC ManuelC79000-G8263-C141-01

11.98 Avant-propos

WinCC Manuel vC79000-G8263-C141-01

Avant-propos

But du manuelLe présent manuel expose sous forme d'ouvrage de référence les fonctions des différents composantslogiciels 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 lesrubriques d'aide.

Présentation générale et exemple de configurationVous trouverez dans la documentation « Prise en main » livrée avec WinCC une présentation généralede WinCC et un exemple de configuration permettant de comprendre par la pratique les principalesfonctions des divers composants.

SupportPour toutes questions techniques, contactez votre interlocuteur Siemens auprès de votre agence. Lesadresses de nos agences figurent par exemple dans l'annexe Siemens du manuel « Automateprogrammable 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'adressewww.aut.siemens.de/coros/html_00/coros.htm.

Informations relatives aux produits SIMATICVous 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 quedes logiciels à télécharger qui pourront vous être utiles lors de la mise en œuvre des produitsSIMATIC :

• 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 quevous 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 etpar télécopie au numéro +49 (911) 895–7002. Nous répondrons également à vos questions transmisespar messagerie électronique via Internet ou via le serveur télématique mentionné ci-dessus.

Avant-propos 11.98

vi WinCC ManuelC79000-G8263-C141-01

11.98 Introduction

WinCC Manuel 1-1C79000-G8263-C141-01

1 IntroductionL’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. Lesdonnées lues en ligne dans les archives utilisateur peuvent en outre être affichées durant le runtimegrâ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 ouAllen Bradley. Il est également possible de transférer dans les automates des données telles querecettes 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éfinirses 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 desdonné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 leruntime. Il est possible de configurer dans la vue de runtime un OCX directement lié aux mémoiresimages de process des API.

Introduction 11.98

1-2 WinCC ManuelC79000-G8263-C141-01

1.2.1 L'éditeur User Archives Editor

L'éditeur User Archives EditorL'éditeur User Archives constitue, avec son interface utilisateur Windows, un outil confortable decréation et de maintenance des archives utilisateurs. Le plan de travail du User Archive Editor sesubdivise 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éesaffiche 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 vuessélectionnées. La fenêtre de tableau de User Archives permet de se connecter en ligne auxmé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 dedialogue et d'assistants.

11.98 Introduction

WinCC Manuel 1-3C79000-G8263-C141-01

1.2.2 Contrôle User Archive

Vous pouvez configurer dans Graphics Designer un contrôle User Archives. Le contrôle UserArchives sert à afficher et à modifier les données des archives utilisateur au runtime. Le contrôle secommande 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 exporterdes 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, tellesqu'un clic de souris sur un bouton défini par exemple. Le langage de scripts WinCC présente unesimilitude avec le langage évolué C et les fonctions de base de données sont basées sur le standardSQL.

1.3 Configuration et runtime

Lors de la configuration des archives utilisateur, vous pourrez créer vos propres tables de bases dedonné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 lesdonné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 formede tableau dans des fenêtres de contrôles OLE. Un échange de données continu avec les API estré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 archiveservira à 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 HP1IndexRégimePression d'entréePression de sortieTempérature vapeur1Température vapeur2Fréquence de vibrationAmplitude de vibrationTempérature palier1Température palier2

Introduction 11.98

1-4 WinCC ManuelC79000-G8263-C141-01

Durant le runtime, les caractéristiques de fonctionnement pourront donc être enregistrées selon unepériodicité définie dans les enregistrements des archives utilisateur sur le support de mémoire demasse du PC (disque dur).

fonctions de script

S5 / S7 automates

fonctions de script

enregistrement

enregistrement

enregistrement

enregistrement

805

804

803

802

données d'exploit

Les données d'exploitation sont enregistrées toutes les 15 minutes dans l'enregistrement

Les fonctions de script User Archive sauvegardent l'enregistrement "TurbineHP 1"

Les fonctions de scripts User Archives permettent d'analyser ultérieurement les données des archivesutilisateur et de les visualiser à l'aide du contrôle OLE "WinCC User Archive Table Control".

Exemples de recettes d’un fabricant de boissonsLes recettes constituent un exemple de flux de données vers l'API. Le fabricant de boissons, quiproduit une boisson gazeuse de type coca et un jus d'orange, utilise les archives utilisateur pourcharger les recettes de ses boissons dans les API (S5, S7, AllenBradley, Applicom etc.).

Archive Champ dedonnées

Coca EauSucreCoulorant7AcidephosphoriqueCaféine

Les archives utilisateur utilisent les interfaces de données proposées par WinCC pour lacommunication 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 provenancedes/vers les API.

Applications des vuesAutre fonctionnalité proposée par WinCC : les "vues". Les vues permettent de regrouper des champsde données extraits de diverses archives utilisateur. Il est ainsi possible de regrouper par exemple desgroupes de produits qui se trouvent dans des enregistrements de différentes archives utilisateur.

Archive Champ Vue ChampCola Eau Couleur Couleur7

Sucre Couleur16Couleur7Acide phosphor.Caféine

Archive ChampJus Eau

Jus d'orangeCouleur16

11.98 Introduction

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

Dans notre exemple, le fabricant de boissons crée des vues, pour des groupes de produits tels que desarô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éesODBC aux archives utilisateur de version antérieure à 4.0 ne permettront plus d'accéder aux archivesutilisateur de la version 4.0.

L'éditeur User Archives propose un logiciel de conversion au format des nouvelles archives pour lesbases de données d'archives utilisateur antérieures à la version 4.0. Les logiciels d'accès direct ODBCdevront ê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 auxchamps 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 ouaffectation 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 scriptsd'action

Introduction 11.98

1-6 WinCC ManuelC79000-G8263-C141-01

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 avecla police Courier

Fichier È Nouveau tous les menus affichés par WinCC, les fonctions et boîtes de saisie sélectionnéessont représentés en italique .

11.98 Configuration d’archives utilisateur

WinCC Manuel 2-1C79000-G8263-C141-01

2 Configuration d’archives utilisateurLa première étape consiste à configurer une nouvelle archive utilisateur. Des assistants logiciels vousaideront à vous acquitter confortablement en dialogue de cette tâche. Les opérations de configurationci-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" etle jus d'orange "Sunny Juice". Il utilise les archives utilisateur WinCC pour l'enregistrement desingrédients entrant dans la composition de ses boissons. Lorsqu'un réservoir de l'installation de miseen boutille est vide, les données de la recette sont transmises aux API via les canaux decommunication de WinCC. Les API peuvent alors, à l'aide des données de recette, commander leréapprovisionnement du réservoir.

Configuration d’archives utilisateur 11.98

2-2 WinCC ManuelC79000-G8263-C141-01

Les archives utilisateur s’utilisent comme suit:

- Archives: On trouve dans cet exemple une archive pour la boisson gazeuse et une archive pour lejus d’orange.

- Vues: Les vues regroupent des champs de données lus dans les deux archives, c.-à-d. dans notreexemple le groupe de produits colorants.

Chaque archive se compose de champs de données dont les propriétés sont éditables. Le champ dedonnées de la boisson gazeuse de notre exemple contient les ingrédients. Chaque champ de donnéespossède des propriétés telles que nom, alias, type, longueur, valeur, etc. Les champs de données etpropriétés sont affichés dans l'éditeur User Archives, dans des lignes et colonnes. C'est la raison pourlaquelle on parle aussi de "lignes" pour désigner les champs de données et de "colonnes" pourdé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(lignes)

Nom Alias Type Longueur

Valeurmin.

Valeurmax.

Valeurinitiale

Eau Eau Source5 Int 2 1000 1500 1000Sucre Sucre Mélas. Int 2 120 140 130Colorant7 FS1007 D1007 Int 2 6 8 6Caféine Caféine Caféine Int 2 2 3 2Acide 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'optionOuvrir. 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 scriptUAQueryArchive.

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


WinCC Manuel 2-3C79000-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 unsecond nom tel que "Calif Cola" p. ex. Vous pouvez réaliser avec l'alias une commutation delangue. L'utilisation du champ alias est sinon facultative. Vous pouvez laisser le champ alias vide oul'utiliser pour l'entrée d'un commentaire.


2-4 WinCC ManuelC79000-G8263-C141-01

Si vous sélectionnez le type d'archive "Limité", vous pourrez spécifier dans le champ "Nombre" lenombre maximal d'enregistrements. Le type "Illimité" permet la création d'archives comptant unnombre 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éscomme noms d'archive ou de champs de données. Voir à ce propos le chapitre "Liste alphabétique desmots-clés SQL".Lors de la création des enregistrements, le système ne vérifie pas si ces fiches sont complètes oucorrecte. 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 etl'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éesbrutes". Indiquez alors l’identificateur des API "PLCID". "PLCID" constitué de 8 caractères ASCII aumaximum. Cet identificateur désigne l'archive correspondante et permet à l'API de renvoyer lesdonné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.


WinCC Manuel 2-5C79000-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 devariables 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 IDd'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 desattributs en dialogue aux variables WinCC. Lorsque vous cliquez sur "Sélectionner", le systèmeaffiche la boîte de dialogue "Sélectionner variable", qui propose pour la sélection toutes les variablesWinCC 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'activationde ce bouton déclenche la création automatique de quatre nouvelles variables WinCC commevariables de sélection User Archives. La boîte de dialogue "Créer variables de sélection":


2-6 WinCC ManuelC79000-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 éditerdans 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, lecode 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 parexemple stockée dans la variable de sélection correspondante (dans l'exemple ci-dessus"@UA_Cola_Wert").

Fonction des variables de sélectionID L'identificateur (ou le numéro d'enregistrement) de l'archiveContrat n Trois types de contrat sont possibles: Lecture, écriture et suppression:

Lecture = 6Ecriture = 7Suppression = 8

Champ. Le champ d'archiveValeur La valeur de positionnement et de désactivation


WinCC Manuel 2-7C79000-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 etles 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. Pourmodifier ces paramétrages, cliquez sur l'un des boutons "Sélectionner". La boîte de dialogue "Niveauxd’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 dudernier accès. L'option "Champ - dernier nom d’utilisateur" crée une colonne qui indique le nom dudernier 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".


2-8 WinCC ManuelC79000-G8263-C141-01

Si vous avez activé dans le menu "Edition - Options" l'option "Créer archives en boucle", le systèmevous 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'éditeurd'archives utilisateur User Archives:

Enregistrez finalement la nouvelle archive utilisateur par un clic de souris sur l'icôned'enregistrement (symbolisant une disquette) ou en sélectionnant l'option de menu "Projet -Enregistrer".

NotaLes 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ésCoca Nom Coca

Alias Calif ColaType: illimitéEnreg.max.: 1Type com.: brutesPLCID: S7112Nom var.: CalifVarGroupDroit lect.: 0Droit écr.: 0Indicateurs: UPos.: 3Dern. accès: 03/05/98 12:54


WinCC Manuel 2-9C79000-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 lespropriétés. Les onglets "Général", "Communication", "Indicateurs" et "Sélectionner autorisation" sontdécrits au chapitre "Créer une archive utilisateur". L'onglet additionnel "Chronologie" sert à définir lachronologie des archives:

2.3.1 L’onglet "Ordre"

L'onglet "Ordre" sert à définir l'ordre des archives:


2-10 WinCC ManuelC79000-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èsactivation 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 archiveutilisateur.

L'option par défaut "Créer champs en boucle" permet de créer plusieurs champs successivement. Sivous 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 "+"). Lanouvelle 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, parexemple 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.


WinCC Manuel 2-11C79000-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 typede 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:integerdoubleStringDate/Time


2-12 WinCC ManuelC79000-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 initialeVous devez, pour les valeurs décimales, utiliser un point pour entrer les valeurs des minima, desmaxima et les valeurs initiales de type Double.

Variable WinCCVous pouvez créer ici une variable WinCC pour enregistrer la valeur du champ d'archive. Vouspouvez...

1. entrez directement la variable dans le champ de saisie2. choisir avec le bouton "Sélectionner" une variable ou en créer une nouvelle3. cliquer sur le bouton "Créer" pour que le système génère automatiquement une nouvelle variable4. modifier ultérieurement les propriétés de la variable à l'aide du bouton "Editer".


WinCC Manuel 2-13C79000-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 champsd'archive.

DroitsVous 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 droitsd'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 attributssuivants:

- "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 exempleamé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èmevous 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


2-14 WinCC ManuelC79000-G8263-C141-01

Nota

Les modifications d'archive utilisateur ne sont prises en compte dans la base de données qu'aprèsactivation de la commande "Enregistrement".

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éveloppezd'abord Archives).

La fenêtre de données de l'éditeur User Archives affiche à présent les champs de données de l'archiveutilisateur "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'archivesutilisateur.

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:


WinCC Manuel 2-15C79000-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 lareprésentation des données: dans la fenêtre de tableau User Archives, sur le contrôle OCX de la vueruntime 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ésCoca Eau Nom Eau

Alias Eau_de_source_4Type: EntierLongueur:Précision:Valeur min.: 1000Valeur max.: 1200Valeur init.: 1100Variable n...:Droit lect.: 0Droit écr.: 0Indicateurs: NNP...: 3Dern. accès: 03/05/98 12:54

Sucre NomAlias....

Coulorant7 NomAlias....

Caféine NomAlias....

Acide phosphorique NomAlias....


2-16 WinCC ManuelC79000-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èsactivation de la commande "Enregistrement".

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 nevoulez 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 boutondroit de la souris. Le bouton "Nouvelle vue" apparaît.

Cliquez sur le bouton "Nouvelle vue".


WinCC Manuel 2-17C79000-G8263-C141-01

L'assistant de configuration des vues démarre. La boîte de dialogue "Général" qui permet de créer unevue, s'affiche.

Entrez comme nom d'archive "Colorants" par exemple. Dans le champ "Alias", vous pouvez entrerun 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 vouspropose "Vue suivante ?". Si vous cliquez sur "Oui", la boîte de dialogue initiale "Général" réapparaîtpour 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".


2-18 WinCC ManuelC79000-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.


WinCC Manuel 2-19C79000-G8263-C141-01

2.7.2 L'onglet „Relation“

L'onglet „Relation“ permet de définir les conditions d'affichage des vues.

ExpressionDans le champ „Relation“, vous pouvez entrer directement des expressions SQL. Se reporter àl'annexe pour de plus amples informations sur le langage SQL.

ConditionsLa zone "Champ OP. Champ" permet la saisie en dialogue des conditions. Cliquez pour cela sur leschamps de la liste de champs de droite et de gauche et définissez la relation en cliquant sur l'opérationdans la liste "OP". Un clic sur "Ajouter" valide la condition qui est alors affichée dans le champ"Relation".


2-20 WinCC ManuelC79000-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 „Versle 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 colonnessuccessivement. Si vous ne voulez créer qu'un seul champ de vue, vous pouvez désactiver cette optiondans 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" parexemple, 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.


WinCC Manuel 2-21C79000-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 etd'attribuer un nom aux champs de vue.

• Sélectionnez dans le champ "Archive" l'une des archives utilisateur configurées. Laissez parexemple le paramètre "Coca" inchangé.

• Sélectionnez dans le champ "Champ d’archive" l'un des champs de données de l'archive utilisateurCoca. Laissez par exemple le paramètre "Colorant7" inchangé. Validez l'entrée avec la toucheTAB 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 dedonné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.


2-22 WinCC ManuelC79000-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 ilregroupe les champs de données Colorant7 et Colorant16 des archives utilisateur Coca etJuice:

Si vous avez activé dans le menu "Edition - Options" l'option "Créer colonnes d'une vue en boucle", lesystè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".


WinCC Manuel 2-23C79000-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 UserArchives Editor

Dans le menu contextuel, sélectionnez "Propriétés. La boîte de dialogue "Propriétés decolonne" 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îteaffiche dans le champ „Modifié“ la date et l'heure de la dernière modification.


2-24 WinCC ManuelC79000-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“ vousdécalez la vue respectivement d'une positon vers le haut ou d'une position vers le bas.

11.98 La fenêtre de l'éditeur User Archives Editor

WinCC Manuel 3-1C79000-G8263-C141-01

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 oude fermer la fenêtre de lecture et d'édition des tables. Un double clic sur l'un des champs permetd'entrer des données. Dans ce cas le curseur de texte apparaît dans le champ. Vous pouvez alors vousdéplacer dans la table à l'aide des touches de curseur du clavier. La méthode de travail dans la fenêtrede visualisation de table de l'éditeur User Archives Editor est analogue à celle de la manipulation de latable User Archive.

Nota

Si vous modifiez une ou plusieurs valeurs dans la fenêtre de l'éditeur d'archives utilisateur ou dans uncontrôle OCX, cliquez, après avoir effectué l'entrée, sur un autre emplacement de la table afin que lavaleur soit prise en compte dans la base de données et soit mise à jour dans les autres affichages.

La fenêtre de l'éditeur User Archives Editor 11.98

3-2 WinCC ManuelC79000-G8263-C141-01

11.98 Menus et barre d'outils de l'éditeur d'archives

WinCC Manuel 4-1C79000-G8263-C141-01

4 Menus et barre d'outils de l'éditeur d'archivesutilisateur

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 menussuivants:

Menu Commande de menu RaccourciProjet Restaurer Ctrl + N

Enregistrer Ctrl + SConvertirQuitter

Edition Couper Ctrl + XCopier Ctrl + CColler Ctrl + VDonnées runtime Ctrl + ROptions Ctrl + O

Affichage Barre d'outilsBarre d'étatFractionner

Données runtime ImporterExporter

Aide Rubriques de l'aideA propos de

RestaurerLa 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 del'éditeur. L'éditeur n'a pas automatiquement connaissance de telles modifications.

ConvertirCette commande de menu permet de convertir des archives utilisateur anciennes de WinCC version3.x au format des nouvelles archives utilisateur WinCC 4.02

Menus et barre d'outils de l'éditeur d'archives 11.98

4-2 WinCC ManuelC79000-G8263-C141-01

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 ...". Lafenê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 runtimeCette commande de menu permet d'éditer en ligne des données dans la fenêtre de tableau. Lorsquecette commande est cochée, l'état "Données runtime" est activé.


WinCC Manuel 4-3C79000-G8263-C141-01

OptionsCette commande de menu permet de spécifier de quelle manière seront saisies les archives utilisateuret 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.

FractionnerSert au redimensionnement des trois volets de l'éditeur User Archives Editor.


4-4 WinCC ManuelC79000-G8263-C141-01

ImporterCette 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 desé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'archivecible doivent posséder une structure concordante faute de quoi une importation n'est pas possible.


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

ExporterCette 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 écritel'archive. Le bouton "Options" permet d'indiquer le caractère de séparation souhaité. Le caractère desé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 plagedes valeurs qui passeront le filtre.

Après avoir cliqué sur le bouton "Expression SQL" vous pouvez entrer dans le champ de saisie qui setrouve 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".


4-6 WinCC ManuelC79000-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 DescriptionDéfilement

Propriétés

Exporter

A propos de

Importer

Supprimer

Nouveau

Données runtime

EnregistrerRestaurer

DéfilementLes icônes de "Défilement" permettent de consulter l’archive utilisateur en mode runtime.

PropriétésL'icône "Propriétés" permet d'éditer les propriétés des archives ou champs de données. Un clic dubouton droit de la souris sur une archive utilisateur ou sur un champ de données permet égalementd'éditer les propriétés d'une archive ou d'un champ de données.

SupprimerL'icône "Supprimer" permet de supprimer les archives ou champs de données. Un clic du bouton droitde la souris sur une archive utilisateur ou un champ de données permet également de supprimer unearchive ou un champ de données. Il est en outre possible de cliquer d'abord sur une archive ou unchamp de données, puis sur l'icône "Supprimer".

NouveauL'icône "Nouveau" permet de créer des archives ou champs de données. Un clic du bouton droit de lasouris dans l'une des fenêtres supérieures permet également de créer une archive.

11.98 Contrôle de table WinCC User Archives

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

5 Contrôle de table WinCC User ArchivesLe module de traitement de table BD User Archives permet d'accéder aux archives et aux vues desarchives 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 enformulaire.

La présentation en tableauLa présentation en tableau affiche sous forme de tableau les archives utilisateur. Chaqueenregistrement occupe une ligne et les champs d'un enregistrement sont présentés en colonnes.

La vue en formulaireLa vue de formulaire propose une interface utilisateur que celui-ci peut agencer lui-même. La vue deformulaire de User Archives contient trois types de champs: textes statiques, champs de saisie etboutons.

Contrôle de table WinCC User Archives 11.98

5-2 WinCC ManuelC79000-G8263-C141-01

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: Configurationd'un contrôle User Archives

1. Configurez une archive utilisateur avec l'éditeur d'archives utilisateur ou avec les scripts UserArchives. La description de l'éditeur User Archives Editor vous indique comment configurerl'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 dansGraphics 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 luidonner 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.


WinCC Manuel 5-3C79000-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 dedialogue "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 typesd'accès.

4. Dans la case à cocher "Border", indiquez si la fenêtre du contrôle OCX doit être affichée avec ousans bordure. Activez cette option

Vous pouvez reprendre tels quels les paramétrages dans les autres onglets.


5-4 WinCC ManuelC79000-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 GraphicsDesigner.

1. Appuyez sur la "touche Ctrl" et double-cliquez simultanément sur le contrôle User Archives. Lavue de présentation en tableau du contrôle est alors affichée. Vous pouvez maintenant paramétrerla 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 surcette icône pour accéder à la vue de formulaire.Vous pouvez maintenant commencer à configurerun formulaire. Nous allons maintenant créer ce formulaire.


WinCC Manuel 5-5C79000-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 saisieCoca"..

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. Lechamp 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:


5-6 WinCC ManuelC79000-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 champsd'é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 desé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 nouveaubouton. Entrez le texte "Présentation en tableau ".

Le champ "Action" permet de sélectionner un des symboles de la vue de formulaire. Le bouton quevous 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.


WinCC Manuel 5-7C79000-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 lasouris 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éscontrô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.


5-8 WinCC ManuelC79000-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 descontrôles User Archives dans Graphics Designer.

Onglet Général

Nom DescriptionArchive/View

Les boutons de sélection Archive/Vue permettent d'indiquer si vous désirezconfigurer une archive ou une vue.

Source Dans le champ de liaison, vous pouvez sélectionner une archive ou une vuepréalablement configurée.

Edit Le champ Edit permet de définir le type d'accès au runtime. Lorsque vousdé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 êtreaffichée avec ou sans bordure.

Form La case à cocher "Form" permet d'indiquer si la vue de formulaire doit être lavue de démarrage dans la fenêtre du contrôle.


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

Onglet Columns

Nom DescriptionColumns 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 deprocess.

Properties La zone de saisie Properties permet de définir les propriétés du champactuellement sélectionné dans la zone de saisie Columns.

Locked La case à cocher "Locked" permet de protéger en écriture le champsélectionné.

Format Le champ "Format" définit le format des valeurs:Fixed (nombre àvirgule fixe), Scientific, Date, Time et TimeStamp. La sélection d'unformat n'a pour le moment pas encore de répercussion sur le format de lavaleur au runtime. L'affichage d'un champ de date utilise toujours leformat 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.


5-10 WinCC ManuelC79000-G8263-C141-01

Onglet Barre d’outils

Nom DescriptionSymbols 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 droitd'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 choixpossibles ont été préalablement définis dans User Administrator.


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

Onglet Barre d'état

Nom DescriptionAreas 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


5-12 WinCC ManuelC79000-G8263-C141-01

Nom DescriptionFilter Condition La zone de l’onglet "Filter Condition" permet de définir les

conditions de filtrage. Entrez directement les règles de filtrage. Cesconditions se formulent dans le langage de base de données SQL(Structured Query Language). Vous trouverez dans l'annexe uneDescription de SQL avec plusieurs exemples pratiques. Exemple : FieldC > 100Tous les enregistrements dont la valeur est supérieure à 100 dans lacolonne "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 programmationSQL.Voir Description de SQL

Onglet Polices

L'onglet "Polices" permet de choisir la police à utiliser dans le contrôle.


WinCC Manuel 5-13C79000-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. Lavue 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ôleUser Archives à l'endroit où vous voulez placer le texte. Le champ de sélection ci-dessous est alorsaffiché.

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'archiveactuelle.

Bouton: Un bouton vous propose un commutateur propre remplissant la même fonction que lessymboles du champ de formulaire.


5-14 WinCC ManuelC79000-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 travaildu contrôle User Archives à l'endroit où vous voulez placer le texte. Le champ de sélectionsuivant est affiché:

La sélection de "Insérer un champ de texte" vous permet d'accéder à la boîte de dialogue "Propriétéschamp de texte":

Le champ "Text" vous permet d'entrer le texte souhaité. En agrandissant le champ vous obtenez tousles 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"...

D Dans Graphics Designer, cliquez avec le bouton droit de la souris dans la surface de travaildu contrôle User Archives à l'endroit où vous voulez placer le champ d'édition.. Le champ desélection ci-dessous apparaît alors à l'écran:


WinCC Manuel 5-15C79000-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éschamp d'édition":

Le champ "Field" permet de sélectionner un des champs affichés.Tous les champs de l'archiveparamé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...

D Dans Graphics Designer, cliquez avec le bouton droit de la souris dans la surface de travaildu contrôle User Archives à l'endroit où vous désirez placer le bouton. Le champ de sélectionci-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. Sivous entrez par exemple "Présentation en tableau ", le nouveau bouton fera apparaître letexte "Présentation en tableau ".

Le champ "Action" permet de sélectionner un des symboles de la vue de formulaire. Le bouton quevous 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.


5-16 WinCC ManuelC79000-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 deformulaire, comme aux chapitres Création d'un nouveau champ de formulaire, Création d'un nouveauchamp 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 latouche 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 possiblequ'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-plandu contrôle User Archives reste affiché après la suppression. Le contrôle User Archives disparaissantde l'écran complètement après la configuration d'autres objets dans Graphics Designer, vous pouvezignorer l'arrière-plan d'archive utilisateur qui reste affiché.


WinCC Manuel 5-17C79000-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'archiveutilisateur au runtime.

La barre d'outils permet la manipulation de la fenêtre de tableaux et de formulaires du contrôle UserArchives:

Nota

Si vous modifiez une ou plusieurs valeurs dans un tableau de contrôle OCX, vous devez, lorsque vousavez terminé la saisie des valeurs, cliquer à un autre endroit du tableau pour que la valeur soit stockéedans 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électiond'enregistrements par des contrôles User Archives n'est pas possible.


5-18 WinCC ManuelC79000-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 decontrô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éedans 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 DescriptionBasculer

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


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

BasculerCette icône permet le basculement entre la vue de formulaire et la présentation en tableau.

Supprimer enregistrementL'enregistrement marqué est supprimé.

Création d'un nouvel enregistrementEntrez successivement les valeurs des champs de données et confirmez chaque entrée avec la toucheENTREE. Lorsque tous les champs de données ont été renseignés, le nouvel enregistrement est crééavec les valeurs saisies.

Modification d’un champ existantAprès avoir cliqué sur cette icône, cliquez sur le champ dont vous désirez modifier le contenu. Lemarqueur 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 desmodifications. Lorsque le mode "Modifier" est désactivé, vous ne pouvez effectuer les modificationsqu'après avoir pressé la touche de raccourci F2 ou cliqué deux fois sur le champ à modifier.

Feuilleter dans la fenêtreCes boutons permettent de feuilleter vers l'avant et vers l'arrière dans la fenêtre de table et de sauter audébut ou à la fin de l'archive.

Lecture et écriture de variablesCes 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, dansl'onglet "Communication", avoir activé le mode de communication Communication par variableWinCC. Vous devez avoir configuré une Variable de sélection dans l'onglet "Variable de sélection".

Importation et exportation des archivesUn clic sur l'un de ces boutons déclenche l'importation ou l'exportation d'archives utilisateur au formatCSV (Coma Seperated Value).Attention ! Indiquez le type de fichier CSV avant l'exportation dans Excel, sinon le fichier CSVexporté depuis WinCC ne pourra pas être chargé correctement.

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

Définition des conditions de triCette option permet d'entrer des conditions de tri. Les règles de tri se formulent directement dans lelangage de programmation de base de données SQL.Voir aussi la Description de SQL à l'annexe. Pour de plus amples informations, consultez les ouvragesspécialisés.

Appeler l’aideCliquez sur ce bouton pour appeler l'aide pour le contrôle User Archives.


5-20 WinCC ManuelC79000-G8263-C141-01

11.98 Fonctions de script standard pour archives utilisateur

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

6 Fonctions de script standard pour archivesutilisateur

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 enligne de WinCC User Archives.

WinCC propose à l'utilisateur une série de fonctions de script offrant une grande souplessed'utilisation des archives utilisateur.

Les fonctions de script User Archive se reconnaissent à une convention d'écriture du nom de lafonction bien spécifique. Toutes les fonctions de script User Archives débutent par "ua", par exemple"uaConnect", "uaArchiveOpen", uaArchiveGetFields" etc. Les fonctions runtime commencenttoujours par "uaArchive"

Les fonctions User Archives se subdivisent en fonctions de configuration et fonctions runtime. Il fautcréer les handles UAHCONFIG, UAHCONNECT et UAHARCHIVE avec des fonctions de scriptadé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électiondes 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çoitpas de cette modification. Les modifications ne sont connues du programme qu'après émission d'unerequê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 actionet effectuez un double-clic avec le bouton gauche de la souris (pour configurer p. ex. une actionpour un double-clic de la souris, sélectionnez Evénement / Souris / Appuyer à gauche). Vouspouvez à présent entrer directement le code C et le compiler.

sur OK valide la configuration de l'action.

Fonctions de script standard pour archives utilisateur 11.98

6-2 WinCC ManuelC79000-G8263-C141-01

6.2 Fonctions de script User Archives

Configuration avec l'éditeur User Archive EditorLa première étape consiste à configurer les archives utilisateur. Cette configuration est possible aussibien avec l'éditeur d'archives utilisateur qu'avec les fonctions de script User Archives.

Configuration à l'aide des fonctions de script User ArchivesLa fonction uaQueryConfiguration fournit un handle (UAHCONFIG) pour les fonctions deconfiguration. Ce handle permet d’appeler les fonctions de configuration uaSetArchive, uaAddArchive,uaSetField, uaAddField etc. La fonction "uaReleaseConfiguration" clôt la configuration des archivesutilisateur.

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

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

Fonctions pour le mode runtimeLes fonctions uaArchiveNext, uaArchivePrevious, uaArchiveFirst et uaArchiveLast déplacent lepointeur de position. Grâce au handle hArchive l'affectation à un enregistrement de l'archive utilisateurest univoque. Cette affectation permet également l'adressage indirect, tel que requis par exemple pourles masques d'écran.

La fonction uaArchiveUpdate stocke l'enregistrement temporaire dans l'archive et y écrasel'enregistrement courant désigné par l'indicateur de position. Cet enregistrement doit au préalable êtrelu à l'aide des fonctions uaArchiveNext, uaArchivePrevious, uaArchiveFirst ou uaArchiveLast .

Couper une liaison à User ArchivesLa fonction uaArchiveClose ferme une archive utilisateur. La fonction uaReleaseArchive coupe laliaison à l'archive actuelle tandis que la fonction uaDisconnect coupe pour finir la liaison aucomposant User Archives.


WinCC Manuel 6-3C79000-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 fonctionuaQueryConfiguration pour obtenir le handle UAHCONFIG. Ce handle permet alors d'appeler lesfonctions de script de configuration ci-dessous. Pour clore la configuration, il faut finalement appeleruaReleaseConfiguration.

Handles pour la configuration User ArchivesUaQueryConfiguration ---> Handle UAHCONFIG

requis par :uaAddArchiveuaAddFielduaGetArchiveuaGetFielduaGetNumArchivesuaGetNumFieldsuaReleaseConfigurationuaRemoveAllArchivesuaRemoveAllFieldsuaRemoveArchiveuaRemoveFielduaSetArchiveuaSetField


6-4 WinCC ManuelC79000-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 à lafermeture des archives et vues. Il faut donc d'abord appeler la fonction uaConnect pour obtenir lehandle UAHCONNECT. Ce handle permet d'appeler les fonctions de script ci-dessous pourl'ouverture et la fermeture des archives et vues. Pour clore la configuration, il faut finalement appeleruaReleaseDisconnect. Les fonctions uaQueryArchive et uaQueryArchiveByName créent le handleUAHARCHIVE. Ce handle est nécessaire pour la fonction de script User Archives uaArchiveOpenqui ouvre l'archive pour le mode runtime.

Handles pour les fonctions d’archive runtimeUaConnect -> Handle

UAHCONNECT requis par...uaDisconnectuaQueryArchive --> Handle UAHARCHIVEuaQueryArchiveByName --> Handle UAHARCHIVE

requis par...uaArchiveOpen

Condition pour...uaArchiveCloseuaArchiveDeleteuaArchiveExportuaArchiveGetFieldLengthuaArchiveGetFieldsuaArchiveGetFieldTypeuaArchiveGetFieldValueDateuaArchiveGetFieldValueDoubleuaArchiveGetFieldValueLonguaArchiveGetFieldValueStringuaArchiveGetFiledNameuaArchiveGetFilteruaArchiveGetIDuaArchiveGetNameuaArchiveGetSortuaArchiveImportuaArchiveInsertuaArchiveMoveFirstuaArchiveMoveLastuaArchiveMoveNextuaArchiveMovePreviousuaArchiveReadTagValuesuaArchiveReadTagValuesByNameuaArchiveRequeryuaArchiveSetFieldValueDateuaArchiveSetFieldValueDoubleuaArchiveSetFieldValueLonguaArchiveSetFieldValueStringuaArchiveSetFilteruaArchiveSetSortuaArchiveUpdateuaArchiveWriteTagValuesuaArchiveWriteTagValuesByNameuaReleaseArchive


WinCC Manuel 6-5C79000-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'écritured'une archive utilisateur en runtime. La fonction "UAReadFromArchive" lit l'archive "Coca" etaffiche 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 GraphicsDesigner les boutons "Lire archive" et "Ecrire archive" et affectez leur les fonctions descript 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 desouris enfoncé.

D Cliquez avec le bouton droit de la souris sur le nouveau bouton et sélectionnez dans le menul'option "Propriétés". Dans l’onglet "Propriétés", définissez le texte et la couleur du bouton. Letexte pourra être par exemple "Lire archive" et "Ecrire archive".

Dans l'onglet "Evénement" affectez une action à la souris en cliquant sur "Souris" puis endouble-cliquant sur "Clic de souris". L'éditeur de scripts s'ouvre. Entrez la fonction de scriptstandard UAReadFromArchive ci-dessous.


6-6 WinCC ManuelC79000-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 );


WinCC Manuel 6-7C79000-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");}


6-8 WinCC ManuelC79000-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;

}


WinCC Manuel 6-9C79000-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 );printf( "Number of Fields = %u\n", NumberOfFields );

//******* Read Last Data Set ************************************************if ( uaArchiveMoveLast( hArchive ) == TRUE )

printf( "Number of Fields = %u\n", NumberOfFields );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 );

elseprintf( "Error calling uaArchiveSetFieldValueDouble: %d\n",

uaGetLastError() );break;


6-10 WinCC ManuelC79000-G8263-C141-01

case UA_FIELDTYPE_STRING :printf("Field Type = String\n");

if ( uaArchiveSetFieldValueString ( hArchive, Index, StringField ) == TRUE )printf( "Field Value = %s\n", StringField );

elseprintf( "Error calling uaArchiveSetFieldValueString: %d\n",


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 );

elseprintf( "Error calling uaArchiveGetFieldValueLong: %d\n",


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. Vouspourrez observer les effets de vos fonctions de script dans la fenêtre de diagnostic Global Script.


WinCC Manuel 6-11C79000-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 DescriptionuaGetLastError Lire dernière erreuruaGetLastHResult Lire dernière erreur COM

6.5.2 Récapitulatif des fonctions de configuration User Archives

Ces fonctions servent à configurer User Archives.

Fonctions User Archives DescriptionuaAddArchive Ajouter une nouvelle archiveuaAddField Ajouter un nouveau champuaGetArchive Lire configuration d'archiveuaGetField Lire configuration de champuaGetNumArchives Trouver nombre d'archives configuréesuaGetNumFields Trouver nombre de champsuaSetArchive Ecrire configuration d'archiveuaRemoveArchive Supprimer archiveuaRemoveAllArchives Supprimer toutes les archivesuaSetField Ecrire configuration de champuaQueryConfiguration Etablir une liaison à la configuration User

ArchivesuaReleaseConfiguration Couper liaison à la configurationuaRemoveAllFields Supprimer tous les champsuaRemoveField 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.

Fonctions User Archives DescriptionuaConnect Etablir une liaison à User Archives Cette

liaison est valide pour toutes les archivespendant l'exécution du runtime.

uaDisconnect S'il existe une liaison à User Archives(runtime), la couper

uaQueryArchive Etablir une liaison à User ArchivesuaQueryArchiveByName Etablir une liaison par le nom d'archiveuaReleaseArchive Couper liaison


6-12 WinCC ManuelC79000-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.

Fonctions User Archives DescriptionuaArchiveOpen Etablir liaison à l'archive actuelleuaArchiveClose Couper liaison à l'archive actuelleuaArchiveDelete Supprimer un enregistrement dans

l'archive actuelleuaArchiveExport Exporter l'archive actuelleuaArchiveGetFieldLength Lire longueur du champ actueluaArchiveGetFieldName Lire nom du champ actueluaArchiveGetFields Lire nombre de champsuaArchiveGetFieldType Lire type du champ actueluaArchiveGetFieldValueDate Lire date et heure du champ de données

actueluaArchiveGetFieldValueDouble Lire Double du champ de données actueluaArchiveGetFieldValueLong Lire Long Int du champ de données actueluaArchiveGetFieldValueString Lire String du champ de données actueluaArchiveGetFilter Lire filtre du champ de données actueluaArchiveGetID Lire ID du champ de données actueluaArchiveGetName Lire nom du champ de données actueluaArchiveGetSort Lire critère de tri du champ de données

actueluaArchiveImport Importer archiveuaArchiveInsert Insérer nouvel enregistrement dans archiveuaArchiveMoveFirst Atteindre le premier enregistrementuaArchiveMoveLast Atteindre le dernier enregistrementuaArchiveMoveNext Atteindre l'enregistrement suivantuaArchiveMovePrevious Atteindre l'enregistrement précédentuaArchiveReadTagValues Lire valeurs de variableuaArchiveReadTagValuesByName

Lire valeurs de variable par nom

uaArchiveRequery Nouvelle interrogationuaArchiveSetFieldValueDate Ecrire dans le champ de données actueluaArchiveSetFieldValueDouble Ecrire Double du champ de données actueluaArchiveSetFieldValueLong Ecrire Long Int du champ de données

actueluaArchiveSetFieldValueString Ecrire String du champ de données actueluaArchiveSetFilter Activer filtreuaArchiveSetSort Activer critère de triuaArchiveUpdate Rafraîchir enregistrementuaArchiveWriteTagValues Ecrire valeurs de l'enregistrement actuel

dans variableuaArchiveWriteTagValuesByName

Ecrire valeurs de l'enregistrement actueldans variable par nom

11.98 L'interface de télégramme SIMATIC S5 et S7

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

7 Récapitulatif de l'interface de télégramme SIMATICS5 et S7

L'échange de données entre archives utilisateur et automates S5 ou S7 peut s'effectuer à l'aide devariables de données brutes ou de variables de gestionnaire de données. Toutes les interfacesSIMATIC 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 gestionnairede données

L'échange de données avec S5 ou S7 par variables de gestionnaire de données est particulièrementsimple. On notera cependant que seuls des types de données définis dans la gestion de variables sontutilisables 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 lestypes de données suivants dans la gestion des variables du gestionnaire de données. Il n'existe dans lagestion des variables aucun type de données correspondant au type de données User ArchiveDate/Heure.

Sélection dans User Archive Editor Gestion des variables / Variable de gestionnairede données

Nombre (entier) Valeur signée 32 bitsNombre (double) Nombre à virgule flottante 64 bits IEEE 754Chaîne de caractères Variable de texte chaîne de caractères 8 bitsDate/Heure Aucun type de données adéquat

7.2 Echange de données avec S5 et S7 par variables de donnéesbrutes

Cette section décrit l'échange de données par variables de données brutes WinCC. Les variables dedonnées brutes peuvent être émises par l'automate via un émetteur actif. Les télégrammes contiennentune ou plusieurs requêtes adressées au système d'archives de WinCC. Il peut s'agir aussi bien decontrats d'écriture que de contrats de lecture. En réponse à ces requêtes, WinCC retourne les donnéesrequises 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

L'interface de télégramme SIMATIC S5 et S7 11.98

7-2 WinCC ManuelC79000-G8263-C141-01

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 automatesSIMATIC S5 et S7 à WinCC:

Télégramme à S5 / S7En-tête de télégrammeEn-tête de contrat 1Données du contrat 1éventuel. en-tête du contrat 2éventuel. données du contrat 2Contrat 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 dedonnées aux automates SIMATIC S5 et S7:

Variable de données brutes pour transmission àS5 et S7Acquittement de traitementEn-tête d'acquittementDonné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 CommentaireLongueur 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'automateRéservéNombre de contrats par télégramme LSB *) Longueur du champ 2

octetsNombre 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)


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

7.2.4 En-tête de contrat

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

Fonction du champ CommentaireLongueur du contrat en octetsLSB

Longueur du champ 2 octets

Longueur du contrat en octetsMSB

.

Type de contrat cf. descriptionRéservéNuméro de champ LSB Longueur du champ 2 octetsNuméro de champ MSB .Numéro d'enregistrement LSB Longueur du champ 4 octets. .. .Numéro d'enregistrementMSB

.

Critère de sélection LSB Numéro de champ en fonction duquels'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 lecritè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 commevaleur de sélection avec une taille égale à la taille du champ du critère de sélection.


7-4 WinCC ManuelC79000-G8263-C141-01

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

Fonction du champ CommentaireLongueur du télégramme en octetsLSB

Longueur du champ 4 octets

. .

. .Longueur de télégramme en octetsMSB

.

Type de transfert 1 de WinCC, 2 de l'automateRéservéType de contrat cf. descriptionRéservéRéservéNuméro de champ LSB Longueur du champ 2 octetsNumé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 ilest vide (contrat de lecture, d'archivage).

Description des types de contrat:

Type Description4 Vérifier existence de l'archive5 Supprimer tous les enregistrements de

l'archive6 Lire enregistrement7 Ecrire enregistrement8 Supprimer enregistrement9 Lire champ d'enregistrement10 Ecrire champ d'enregistrement


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

Description du code d’erreur:

Groupe N° DescriptionGénéral 0 La fonction a été exécutéeArchive 1 Données non admissiblesArchive 2 Données inexistantesFiche 101 Données non admissiblesFiche 102 Données inexistantesChamp. 201 Données non admissiblesChamp. 202 Données inexistantesGénéral 254 Fonction inexistanteGé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 desautomates SIMATIC S5/S7. Il convient d'en tenir compte pour éviter de commettre des erreurs parinadvertance.

WinCC respecte les formats de données de Intel et Microsoft dans lesquels les octets de poids faibleprécèdent les octets de poids fort. Ce format de données est très largement répandu et généralementconnu sous le nom de "format Intel". Voici un exemple illustrant le "format Intel":

Format IntelDans 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 0Binaire 0 0 0 0 0 0 0 1 0 0 1 0 1 1 0 0Hex 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 SIMATICDans 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 0Binaire 0 0 1 0 1 1 0 0 0 0 0 0 0 0 0 1Hex 2 C 0 1

Le nombre décimal 300 correspond dans le format SIMATIC au nombre hexadécimal 2C01. Si 2C01a été interprété par erreur comme un nombre au format Intel, le nombre obtenu sera 11265 en notationdé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. Lesblocs 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 fichierANSI_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 decommunication).


7-6 WinCC ManuelC79000-G8263-C141-01

11.98 Annexe

WinCC Manuel 8-1C79000-G8263-C141-01

8 AnnexeVous 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 nomsd'archive ou de champ dans User Archives

• Performances, notamment Performances en écriture et en lecture de variables et Performances destemps 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 basesde 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é à entrerdes conditions en langage SQL pour spécification des enregistrements à traiter. Voici ci-aprèsquelques 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" estsupé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 colonneFieldB est DB_TYP_CHAR.

• FieldC > 100Une condition de ce type permet de sélectionner tous les enregistrements qui possèdent dans lacolonne "FieldC" une valeur supérieure à 100. Le type de données de la colonne FieldC estDB_TYP_INTEGER.

• BETWEEN FieldC = 20 AND Field C = 200L'instruction sélectionne tous les enregistrements dont la valeur dans la colonne "FieldC" est situéeentre 20 et 200. Le type de données de la colonne FieldC est DB_TYP_INTEGER.

• FieldDCette instruction effectue un tri en fonction de la colonne "FieldD".

• FieldE descCette instruction effectue un tri en fonction de la colonne "FieldE" dans l'ordre alphabétiquedescendant.

Annexe 11.98

8-2 WinCC ManuelC79000-G8263-C141-01

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 descaractères de soulignement "_", et leur longueur ne doit pas dépasser 25 caractères. Le premiercaractè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éscomme noms d'archive, de vues ou de champs de données dans User Archives. Le tableau ci-aprèsrécapitule les mots-clés SQL:

Mots-clés utilisés dans le langage SQLadd all alter andany as asc beginbetween binary break bycall cascade cast charchar_convert character check checkpointclose comment commit connectconstraint continue convert createcross current cursor datedba dbspace deallocate decdecimal declare default deletedesc distinct do doubledrop else elseif encryptedend endif escape exceptionexec execute exists fetchfirst float for foreignfrom full goto grantgroup having holdlock identifiedif in Index innerinout insert instead Intinteger into is isolationjoin key left likelock long match membershipmessage mode modify namednatural noholdlock not nullnumeric of off onopen option options ororder others out outerpassthrough precision prepare primaryprint privileges proc procedureraiserror readtext real referencereferences release remote renameresource restrict return revokeright rollback save savepointschedule select set sharesmallint some sqlcode sqlstate

11.98 Annexe

WinCC Manuel 8-3C79000-G8263-C141-01

start stop subtrans subtransactionsynchronize syntax_error table temporarythen time tinyint totran trigger truncate tsequalunion unique unknown updateuser using validate valuesvarbinary varchar variable varyingview when where whilewith work writetext

8.3 Caractéristiques quantitatives

Environnement de testLes 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 brutesLes mesures ont été effectuées avec les variables de gestionnaire de données WinCC. Comme lemontrent 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 dedonnées brutes. Les variables de données brutes transfèrent les données par paquets et assurent ainsides 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 archivesutilisateur lors de l'écriture et de la lecture de variables.

Nombre decolonnes

Nombred’enregistrements

Temps d'écriture desvariables en s

Temps de lecturedes variables en s

100 1 1 4100 10 1 4100 50 1 4100 100 2 4100 1000 4 4200 1 1 8200 10 2 9200 50 2 9200 100 2 9200 1000 8 8500 1 2 20500 10 4 20500 50 3 20500 100 3 20500 500 8 20

Annexe 11.98

8-4 WinCC ManuelC79000-G8263-C141-01

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 detableau de l'éditeur d'archives utilisateur est supposée inactive.

Nombre decolonnes

Nombred’enregistrements

Temps d’affichage devues en s

100 1 1100 10 2100 100 2100 500 4100 1000 4100 2000 9100 3000 10200 1 1200 10 3200 100 3200 500 5200 1000 11200 1500 15500 1 2500 10 5500 100 8500 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 plusde 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 pasadmissibles pour la désignation de champs ou de tables. Se référer à ce sujet au chapitre "Listealphabétique de mots-clés SQL".

11.98 Index

WinCC Manuel Index-1C79000-G8263-C141-01

Index

AArchive 1-1

BBarre d’outils 4-6Boîte de dialogue "Communication" 2-4Boîte de dialogue "Valeurs" 2-12Boîte de dialogue "Variables de sélection" 2-5Boîte de dialogue"Droits et indicateurs" 2-7,2-13

CCaractéristiques quantitatives 8-3Commande par menus 4-1Configuration 1-3Configuration d'archives utilisateur 2-2Configuration de champs d'archives 2-10Configuration de champs de vue 2-20Configuration de vues 2-16configuration d'un contrôle User Archives 5-2configuration d'une vue de formulaire 5-4Contrôle User Archives 1-3Création de champs de formulaire 5-13

EExemple avec fonctions de scripts 6-5Exemple avec recette 2-1Exemple avec saisie de données d'exploitation1-3

FFenêtre de données 1-2Fenêtre de navigation 1-2Fenêtre de tableau 1-2, 3-1Fonctions de scripts 6-1Fonctions de scripts User Archives 1-3

HHandles des fonctions de scripts 6-3

IInstructions SQL 8-1

Interface télégramme SIMATIC S5 et S7 7-1Introduction 1-1

LLégende 1-6

MMots-clés SQL 8-2

NNiveaux d'autorisation 2-7

OOnglet "Ordre" 2-9, 2-15, 2-20, 2-24Onglet "Relation" 2-19Opérations de configuration 2-1

PPerformances 1-5présentation en tableau 5-1Propriétés contrôle WinCC User Archives 5-8Propriétés de champs de vues 2-23Propriétés de vues 2-18Propriétés des archives utilisateur 2-9Propriétés des champs de données 2-14

RRécapitulatif des fonctions User Archives 6-11runtime 5-17Runtime 1-3

SScript d'action 6-1suppression de contrôles User Archives 5-16

UUser Archives Editor 1-2

Vvue de formulaire 5-1

Index 11.98

Index-2 WinCC ManuelC79000-G8263-C141-01

Vues 1-1

Documents

WinCC User Archives - Siemens