simatic hmi wincc v7.2 - wincc : scripting (vbs, … hmi wincc v7.2 wincc : scripting (vbs, ansi-c,...

2594
SIMATIC HMI WinCC V7.2 WinCC : Scripting (VBS, ANSI-C, VBA) Manuel système Impression de l'aide en ligne 02/2013 A5E32315922-AA VBS pour la création de procédures et d'actions 1 ANSI-C pour la création de fonctions et actions 2 VBA pour la configuration automatisée 3

Upload: vuhanh

Post on 22-Apr-2018

434 views

Category:

Documents


20 download

TRANSCRIPT

  • SIMATIC HMI

    WinCC V7.2WinCC : Scripting (VBS, ANSI-C, VBA)

    Manuel systme

    Impression de l'aide en ligne

    02/2013A5E32315922-AA

    VBS pour la cration de procdures et d'actions

    1

    ANSI-C pour la cration de fonctions et actions

    2

    VBA pour la configuration automatise

    3

  • Mentions lgalesSignaltique d'avertissement

    Ce manuel donne des consignes que vous devez respecter pour votre propre scurit et pour viter des dommages matriels. Les avertissements servant votre scurit personnelle sont accompagns d'un triangle de danger, les avertissements concernant uniquement des dommages matriels sont dpourvus de ce triangle. Les avertissements sont reprsents ci-aprs par ordre dcroissant de niveau de risque.

    DANGER

    signifie que la non-application des mesures de scurit appropries entrane la mort ou des blessures graves.

    ATTENTION

    signifie que la non-application des mesures de scurit appropries peut entraner la mort ou des blessures graves.

    PRUDENCE

    signifie que la non-application des mesures de scurit appropries peut entraner des blessures lgres.

    IMPORTANTsignifie que la non-application des mesures de scurit appropries peut entraner un dommage matriel.En prsence de plusieurs niveaux de risque, c'est toujours l'avertissement correspondant au niveau le plus lev qui est reproduit. Si un avertissement avec triangle de danger prvient des risques de dommages corporels, le mme avertissement peut aussi contenir un avis de mise en garde contre des dommages matriels.

    Personnes qualifiesLappareil/le systme dcrit dans cette documentation ne doit tre manipul que par du personnel qualifi pour chaque tche spcifique. La documentation relative cette tche doit tre observe, en particulier les consignes de scurit et avertissements. Les personnes qualifies sont, en raison de leur formation et de leur exprience, en mesure de reconnatre les risques lis au maniement de ce produit / systme et de les viter.

    Utilisation des produits Siemens conforme leur destinationTenez compte des points suivants:

    ATTENTION

    Les produits Siemens ne doivent tre utiliss que pour les cas d'application prvus dans le catalogue et dans la documentation technique correspondante. S'ils sont utiliss en liaison avec des produits et composants d'autres marques, ceux-ci doivent tre recommands ou agrs par Siemens. Le fonctionnement correct et sr des produits suppose un transport, un entreposage, une mise en place, un montage, une mise en service, une utilisation et une maintenance dans les rgles de l'art. Il faut respecter les conditions d'environnement admissibles ainsi que les indications dans les documentations affrentes.

    Marques de fabriqueToutes les dsignations repres par sont des marques dposes de Siemens AG. Les autres dsignations dans ce document peuvent tre des marques dont l'utilisation par des tiers leurs propres fins peut enfreindre les droits de leurs propritaires respectifs.

    Exclusion de responsabilitNous avons vrifi la conformit du contenu du prsent document avec le matriel et le logiciel qui y sont dcrits. Ne pouvant toutefois exclure toute divergence, nous ne pouvons pas nous porter garants de la conformit intgrale. Si l'usage de ce manuel devait rvler des erreurs, nous en tiendrons compte et apporterons les corrections ncessaires ds la prochaine dition.

    Siemens AGIndustry SectorPostfach 48 4890026 NRNBERGALLEMAGNE

    A5E32315922-AA 02/2013 Sous rserve de modifications techniques

    Copyright Siemens AG 2013.Tous droits rservs

  • Sommaire

    1 VBS pour la cration de procdures et d'actions........................................................................................11 1.1 VBS pour la cration de procdures et d'actions........................................................................11 1.2 Utilisation de Visual Basic Script dans WinCC............................................................................12 1.3 Modules et procdures................................................................................................................16 1.4 Actions.........................................................................................................................................19 1.5 Procdez comme suit pour utiliser plusieurs fois des procdures et des actions.......................22 1.6 Interactions avec CrossReference..............................................................................................24 1.7 Utilisation de variables globales dans VBS.................................................................................26 1.8 Les diteurs VBScript..................................................................................................................28 1.8.1 Les diteurs VBScript..................................................................................................................28 1.8.2 L'diteur Global Script.................................................................................................................29 1.8.3 Travailler dans la fentre d'dition...............................................................................................32 1.8.4 Utiliser les barres d'outils.............................................................................................................35 1.8.5 Procdez comme suit pour supprimer des actions ou des procdures.......................................38 1.9 Cration et dition de procdures...............................................................................................40 1.9.1 Cration et dition de procdures...............................................................................................40 1.9.2 Pour crer une nouvelle procdure.............................................................................................44 1.9.3 Pour crire le code d'une procdure...........................................................................................45 1.9.4 Pour utiliser des procdures de projet et standard......................................................................48 1.9.5 Pour ajouter des informations de module supplmentaires........................................................49 1.9.6 Pour protger un module par un mot de passe...........................................................................51 1.9.7 Pour enregistrer une procdure...................................................................................................53 1.9.8 Pour renommer une procdure ou un module.............................................................................55 1.10 Cration et dition d'actions........................................................................................................57 1.10.1 Cration et dition d'actions........................................................................................................57 1.10.2 Pour crer une nouvelle action....................................................................................................62 1.10.3 Pour diter une action.................................................................................................................63 1.10.4 Pour ajouter des informations supplmentaires l'action...........................................................66 1.10.5 Pour protger une action par un mot de passe...........................................................................68 1.10.6 Pour enregistrer une action.........................................................................................................69 1.10.7 Dclenchement............................................................................................................................71 1.10.7.1 Dclenchement............................................................................................................................71 1.10.7.2 Dclenchement d'animation........................................................................................................75 1.10.7.3 Pour ajouter un Trigger du type "Temporisateur"........................................................................76 1.10.7.4 Pour ajouter un Trigger du type "Variable"..................................................................................77 1.10.7.5 Pour modifier un dclenchement.................................................................................................78 1.10.7.6 Pour supprimer un dclenchement..............................................................................................79 1.10.8 Pour renommer une action..........................................................................................................80 1.11 Pour activer des actions globales dans Runtime.........................................................................82 1.12 Diagnostic....................................................................................................................................83

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 3

  • 1.12.1 Diagnostic....................................................................................................................................83 1.12.2 Diagnostic GSC...........................................................................................................................84 1.12.2.1 Diagnostic GSC...........................................................................................................................84 1.12.2.2 Pour insrer dans une vue la fentre de diagnostic GSC...........................................................85 1.12.2.3 Les attributs de Diagnostic GSC.................................................................................................85 1.12.2.4 La barre d'outils de Diagnostic GSC...........................................................................................86 1.12.3 GSC Runtime..............................................................................................................................87 1.12.3.1 GSC Runtime..............................................................................................................................87 1.12.3.2 Pour insrer dans une image la fentre GSC Runtime...............................................................88 1.12.3.3 Les attributs de GSC Runtime.....................................................................................................89 1.12.4 Tester avec Debugger.................................................................................................................90 1.12.4.1 Tester avec Debugger.................................................................................................................90 1.12.4.2 Pour activer le dbogueur...........................................................................................................91 1.12.4.3 Principes de base du dbogage..................................................................................................93 1.12.4.4 Composants du Microsoft Script Debugger.................................................................................95 1.12.4.5 Structure des fichiers VBScript....................................................................................................97 1.12.4.6 Nom de l'action et de la procdure dans Debugger....................................................................99 1.12.4.7 Pour slectionner un Script en vue de l'diter...........................................................................101 1.12.4.8 Pour traiter les Scripts tape par tape.....................................................................................102 1.12.4.9 Pour dfinir des points d'arrt....................................................................................................103 1.12.4.10 Pour supprimer des points d'arrt........................................................................................105 1.12.4.11 Pour activer des signets dans le Script................................................................................105 1.12.4.12 Pour dterminer et modifier des valeurs de variable ou de proprit...................................106 1.12.4.13 Pour excuter des instructions Script...................................................................................107 1.13 Pour imprimer des VB-Scripts...................................................................................................109 1.14 Rfrence VBS..........................................................................................................................110 1.14.1 Rfrence VBS..........................................................................................................................110 1.14.2 Objets et listes...........................................................................................................................114 1.14.2.1 Objets et listes...........................................................................................................................114 1.14.2.2 Objet d'alarme...........................................................................................................................117 1.14.2.3 Objet d'alarmes (liste)................................................................................................................118 1.14.2.4 Objet AlarmLogs........................................................................................................................119 1.14.2.5 Objet DataItem..........................................................................................................................120 1.14.2.6 Objet DataLogs..........................................................................................................................122 1.14.2.7 Objet DataSet (Liste).................................................................................................................123 1.14.2.8 Objet HMIRuntime.....................................................................................................................125 1.14.2.9 Objet Item..................................................................................................................................126 1.14.2.10 Objet Layer...........................................................................................................................127 1.14.2.11 Objet Layers (Liste)..............................................................................................................128 1.14.2.12 Objet Logging.......................................................................................................................129 1.14.2.13 Objet ProcessValue..............................................................................................................130 1.14.2.14 Objet ProcessValues (liste)..................................................................................................131 1.14.2.15 Objet Project.........................................................................................................................131 1.14.2.16 Objet ScreenItem.................................................................................................................132 1.14.2.17 Objet ScreenItems (Liste).....................................................................................................136 1.14.2.18 Objet Screen........................................................................................................................138 1.14.2.19 Objet Screens (Liste)............................................................................................................141 1.14.2.20 Objet SmartTags..................................................................................................................143 1.14.2.21 Objet Tag..............................................................................................................................144 1.14.2.22 Objet Tags (Liste).................................................................................................................147 1.14.2.23 Objet TagSet (Liste).............................................................................................................149

    Sommaire

    WinCC : Scripting (VBS, ANSI-C, VBA)4 Manuel systme, 02/2013, A5E32315922-AA

  • 1.14.3 Type d'objet de l'objet ScreenItem............................................................................................150 1.14.3.1 Type d'objet de l'objet ScreenItem............................................................................................150 1.14.3.2 Objets standard.........................................................................................................................151 1.14.3.3 Objets complexes......................................................................................................................179 1.14.3.4 Objets Windows.........................................................................................................................210 1.14.3.5 Objets tuyaux.............................................................................................................................222 1.14.3.6 Contrles...................................................................................................................................224 1.14.3.7 Objet utilisateur..........................................................................................................................290 1.14.3.8 Groupe.......................................................................................................................................291 1.14.4 Proprits..................................................................................................................................292 1.14.4.1 Proprits..................................................................................................................................292 1.14.4.2 A................................................................................................................................................293 1.14.4.3 B................................................................................................................................................312 1.14.4.4 C................................................................................................................................................339 1.14.4.5 D................................................................................................................................................372 1.14.4.6 e.................................................................................................................................................381 1.14.4.7 f..................................................................................................................................................391 1.14.4.8 G................................................................................................................................................412 1.14.4.9 h.................................................................................................................................................416 1.14.4.10 I............................................................................................................................................424 1.14.4.11 L...........................................................................................................................................430 1.14.4.12 M..........................................................................................................................................461 1.14.4.13 N...........................................................................................................................................482 1.14.4.14 O...........................................................................................................................................484 1.14.4.15 P...........................................................................................................................................501 1.14.4.16 Q...........................................................................................................................................518 1.14.4.17 R...........................................................................................................................................519 1.14.4.18 S...........................................................................................................................................530 1.14.4.19 T...........................................................................................................................................567 1.14.4.20 U...........................................................................................................................................643 1.14.4.21 V...........................................................................................................................................652 1.14.4.22 W..........................................................................................................................................668 1.14.4.23 X - Z......................................................................................................................................672 1.14.5 Mthodes...................................................................................................................................680 1.14.5.1 Mthodes...................................................................................................................................680 1.14.5.2 Mthodes A E.........................................................................................................................682 1.14.5.3 Mthodes Get............................................................................................................................690 1.14.5.4 Mthodes H M........................................................................................................................738 1.14.5.5 Mthodes N R.........................................................................................................................749 1.14.5.6 Mthodes S T.........................................................................................................................767 1.14.5.7 Mthodes U Z.........................................................................................................................781 1.14.6 Annexe......................................................................................................................................790 1.14.6.1 Messages d'erreur dans la zone Bases de donnes.................................................................790 1.15 Exemples pour VBScript............................................................................................................792 1.15.1 Exemples pour VBScript............................................................................................................792 1.15.2 Exemples dans WinCC..............................................................................................................792 1.15.2.1 Exemples dans WinCC..............................................................................................................792 1.15.2.2 Exemple : Pour accder des objets dans Graphics Designer................................................793 1.15.2.3 Exemple : Comment dterminer la couleur des objets..............................................................794 1.15.2.4 Exemple : Pour configurer un changement de langue..............................................................794 1.15.2.5 Exemple : Comment dsactiver Runtime..................................................................................795 1.15.2.6 Exemple : Comment configurer globalement un changement de vue.......................................795

    Sommaire

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 5

  • 1.15.2.7 Exemple : Comment configurer un changement de vue via Property.......................................796 1.15.2.8 Exemple : Comment configurer l'affichage d'un diagnostic via Trace.......................................796 1.15.2.9 Exemple : Pour crire les valeurs variable................................................................................797 1.15.2.10 Exemple : Pour lire les valeurs variable...............................................................................799 1.15.2.11 Exemple : Comment crire les proprits de l'objet.............................................................802 1.15.2.12 Exemple : Pour dmarrer une action sur le serveur (objet Logging)....................................805 1.15.2.13 Dynamisation des contrles.................................................................................................807 1.15.3 Exemples, gnralits...............................................................................................................819 1.15.3.1 Exemples d'ordre gnral pour VBScript..................................................................................819 1.15.3.2 Exemple : Comment configurer une intgration de la base de donnes avec VBS..................820 1.15.3.3 Exemple : Comment utiliser l'interface MS Automation.............................................................822 1.15.3.4 Exemple : Pour dmarrer une application tierce.......................................................................824 1.16 Principes de base de VBScript..................................................................................................825 1.16.1 Principes de base de VBScript..................................................................................................825 1.16.2 VBScript Principes de base.......................................................................................................825

    2 ANSI-C pour la cration de fonctions et actions.......................................................................................827 2.1 Cration de fonctions et actions avec ANSI-C..........................................................................827 2.2 Cration de fonctions et d'actions.............................................................................................828 2.3 Caractristiques de fonctions de projet.....................................................................................831 2.4 Caractristiques de fonctions standard.....................................................................................832 2.5 Caractristiques de fonctions internes......................................................................................834 2.6 Caractristiques d'actions locales.............................................................................................835 2.7 Caractristiques d'actions globales...........................................................................................836 2.8 Pour ajouter Global Script Runtime la liste de dmarrage du projet......................................837 2.9 Utilisation de variables C globales.............................................................................................838 2.10 Utilisation de DLL dans des fonctions et actions.......................................................................840 2.11 L'diteur Global Script...............................................................................................................842 2.11.1 L'diteur Global Script...............................................................................................................842 2.11.2 Utiliser la fentre d'dition.........................................................................................................844 2.11.2.1 Utiliser la fentre d'dition.........................................................................................................844 2.11.2.2 Fonctions d'dition avec le clavier.............................................................................................845 2.11.2.3 Fonctions d'dition avec la souris..............................................................................................846 2.11.3 Utiliser les barres d'outils...........................................................................................................847 2.11.4 Pour paramtrer plusieurs vues................................................................................................849 2.11.5 Pour paramtrer la police..........................................................................................................850 2.11.6 Pour utiliser "Enregistrer sous..."...............................................................................................850 2.11.7 Pour supprimer des actions ou des fonctions de projet ou standard........................................851 2.11.8 Pour gnrer l'en-tte................................................................................................................852 2.11.9 Pour compiler toutes les fonctions.............................................................................................853 2.11.10 Pour rechercher un texte dans des fichiers...............................................................................854 2.11.11 Imprimer des fonctions et actions..............................................................................................855 2.11.11.1 Imprimer des fonctions et actions.........................................................................................855 2.11.11.2 Pour dfinir les paramtres d'impression.............................................................................855 2.11.11.3 Pour ouvrir l'aperu avant impression..................................................................................856 2.11.11.4 Pour imprimer une documentation de projet........................................................................856

    Sommaire

    WinCC : Scripting (VBS, ANSI-C, VBA)6 Manuel systme, 02/2013, A5E32315922-AA

  • 2.12 Crer et diter fonctions............................................................................................................857 2.12.1 Crer et diter fonctions............................................................................................................857 2.12.2 Pour crer une nouvelle fonction...............................................................................................860 2.12.3 Pour crire le code d'une fonction.............................................................................................861 2.12.4 Pour utiliser des fonctions internes............................................................................................862 2.12.5 Pour utiliser des fonctions standard et des fonctions de projet.................................................863 2.12.6 Pour ajouter des informations supplmentaires la fonction....................................................864 2.12.7 Pour protger une fonction contre les modifications et l'affichage............................................864 2.12.8 Pour compiler et enregistrer une fonction..................................................................................865 2.12.9 Pour renommer une fonction.....................................................................................................867 2.12.10 Pour utiliser des fonctions empruntes d'autres sources.......................................................868 2.13 Cration et dition d'actions......................................................................................................870 2.13.1 Cration et dition d'actions......................................................................................................870 2.13.2 Rgle d'criture du code de WinCC..........................................................................................873 2.13.3 Pour crer une nouvelle action..................................................................................................874 2.13.4 Pour diter une action...............................................................................................................875 2.13.5 Pour ajouter des informations supplmentaires l'action.........................................................876 2.13.6 Pour protger une action contre les modifications et l'affichage...............................................876 2.13.7 Pour compiler et enregistrer une action.....................................................................................877 2.13.8 Dclenchement..........................................................................................................................879 2.13.8.1 Dclenchement..........................................................................................................................879 2.13.8.2 Pour ajouter un nouveau dclenchement du type "Temporisateur"..........................................882 2.13.8.3 Pour ajouter un nouveau dclenchement du type "Variable"....................................................883 2.13.8.4 Pour modifier un dclenchement...............................................................................................884 2.13.8.5 Pour supprimer un dclenchement............................................................................................884 2.13.9 Pour attribuer une autorisation..................................................................................................885 2.13.10 Pour exporter une action...........................................................................................................886 2.13.11 Pour importer une action...........................................................................................................887 2.13.12 Pour renommer une action........................................................................................................887 2.13.13 Pour utiliser des actions trangres au projet...........................................................................888 2.14 Comportement des actions au Runtime....................................................................................890 2.14.1 Comportement des actions au Runtime....................................................................................890 2.14.2 GSC-Runtime............................................................................................................................891 2.14.2.1 GSC-Runtime............................................................................................................................891 2.14.2.2 Pour placer GSC-Runtime dans une vue de process................................................................894 2.14.2.3 Les attributs de GSC-Runtime...................................................................................................895 2.14.2.4 Pour diter une action...............................................................................................................895 2.14.3 Diagnostic GSC.........................................................................................................................896 2.14.3.1 Diagnostic GSC.........................................................................................................................896 2.14.3.2 Pour placer Diagnostic GSC dans une vue de process............................................................897 2.14.3.3 Les attributs de Diagnostic GSC...............................................................................................898 2.14.3.4 La barre d'outils du diagnostic GSC..........................................................................................898 2.15 ANSI-C Descriptions de fonctions.............................................................................................899 2.15.1 lpszPictureName.......................................................................................................................899 2.15.2 Fonctions standard....................................................................................................................899 2.15.2.1 Fonctions standard - Description sommaire..............................................................................899 2.15.2.2 Alarm.........................................................................................................................................900 2.15.2.3 Graphics....................................................................................................................................905 2.15.2.4 Obsolete functions.....................................................................................................................910 2.15.2.5 Rapport......................................................................................................................................968

    Sommaire

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 7

  • 2.15.2.6 WinCC.......................................................................................................................................970 2.15.2.7 Windows....................................................................................................................................977 2.15.3 Fonctions internes.....................................................................................................................978 2.15.3.1 Fonctions internes - Brve description......................................................................................978 2.15.3.2 allocate......................................................................................................................................979 2.15.3.3 c_bib..........................................................................................................................................980 2.15.3.4 graphics...................................................................................................................................1064 2.15.3.5 tag............................................................................................................................................1393 2.15.3.6 WinCC.....................................................................................................................................1505 2.15.4 Exemples.................................................................................................................................1513 2.15.4.1 Exemples - A G....................................................................................................................1513 2.15.4.2 Exemples - GetAlarmHigh GetPropChar..............................................................................1516 2.15.4.3 Exemples - GetRangeMax GetWidth...................................................................................1532 2.15.4.4 Exemples - H S.....................................................................................................................1552 2.15.4.5 Exemples - SetAlarmHigh SetPropChar...............................................................................1555 2.15.4.6 Exemples - SetRangeMax SetWidth....................................................................................1565 2.15.4.7 Exemples - T Z.....................................................................................................................1575 2.15.4.8 Exemples de contrles WinCC................................................................................................1580 2.15.5 Listes.......................................................................................................................................1582 2.15.5.1 Orientation du bargraphe.........................................................................................................1582 2.15.5.2 Mise l'chelle du bargraphe..................................................................................................1583 2.15.5.3 Frquences de clignotement...................................................................................................1583 2.15.5.4 Champ d'E/S, Format de sortie...............................................................................................1583 2.15.5.5 Champ E/S, Type de donnes du contenu du champ.............................................................1585 2.15.5.6 Champ E/S, Type de champ...................................................................................................1585 2.15.5.7 Alignement d'lment dans des cases cocher et des cases d'option...................................1585 2.15.5.8 Tableau de couleurs................................................................................................................1585 2.15.5.9 Descripteur de format..............................................................................................................1586 2.15.5.10 Motif de remplissage..........................................................................................................1587 2.15.5.11 Types de trait......................................................................................................................1588 2.15.5.12 Fins de trait.........................................................................................................................1589 2.15.5.13 Types de liste.....................................................................................................................1589 2.15.5.14 Identificateurs de langue....................................................................................................1589 2.15.5.15 Sens du texte.....................................................................................................................1591 2.15.5.16 Etats de variable.................................................................................................................1591 2.15.6 Dfinitions de structure............................................................................................................1592 2.15.6.1 Dfinition de structure CCAPErrorExecute..............................................................................1592 2.15.6.2 Dfinition de structure CCAPTime...........................................................................................1593 2.15.6.3 Dfinition de structure CMN_ERROR......................................................................................1594 2.15.6.4 Dfinition de structure DM_TYPEREF.....................................................................................1595 2.15.6.5 Dfinition de structure DM_VAR_UPDATE_STRUCT.............................................................1596 2.15.6.6 Dfinition de structure DM_VAR_UPDATE_STRUCTEX........................................................1597 2.15.6.7 Dfinition de structure DM_VARKEY.......................................................................................1598 2.15.6.8 Dfinition de structure LINKINFO............................................................................................1598 2.15.6.9 Dfinition de structure MSG_FILTER_STRUCT......................................................................1600 2.15.6.10 Dfinition de structure MSG_RTDATA_STRUCT...............................................................1603

    3 VBA pour la configuration automatise..................................................................................................1605 3.1 Automatisation de la configuration..........................................................................................1605 3.2 Introduction : Utilisation de VBA dans WinCC.........................................................................1606 3.2.1 Introduction : Utilisation de VBA dans WinCC.........................................................................1606 3.2.2 Diffrenciation : Utilisation de VBA..........................................................................................1606

    Sommaire

    WinCC : Scripting (VBS, ANSI-C, VBA)8 Manuel systme, 02/2013, A5E32315922-AA

  • 3.2.3 Organisation du code VBA dans un projet WinCC..................................................................1607 3.2.4 Pour exporter ou importer un code VBA..................................................................................1611 3.2.5 Excution de macros VBA dans le Graphics Designer...........................................................1612 3.3 VBA dans le Graphics Designer..............................................................................................1614 3.3.1 VBA dans le Graphics Designer..............................................................................................1614 3.3.2 Adaptation du Graphics Designer avec VBA...........................................................................1616 3.3.2.1 Adaptation du Graphics Designer avec VBA...........................................................................1616 3.3.2.2 Configuration multilingue avec VBA........................................................................................1617 3.3.2.3 Cration de menus et de barres d'outils personnaliss...........................................................1619 3.3.2.4 Accs la bibliothque des modules avec VBA.....................................................................1640 3.3.3 Edition de vues avec VBA.......................................................................................................1647 3.3.3.1 Edition de vues avec VBA.......................................................................................................1647 3.3.3.2 Pour crer des menus et des barres d'outils spcifiques une vue.......................................1648 3.3.3.3 Edition de niveaux avec VBA..................................................................................................1650 3.3.3.4 Edition d'une copie de vue avec VBA......................................................................................1651 3.3.4 Edition d'objets avec VBA.......................................................................................................1653 3.3.4.1 Edition d'objets avec VBA.......................................................................................................1653 3.3.4.2 Objets standard, complexes, Windows et tuyaux....................................................................1655 3.3.4.3 Objets Groupe.........................................................................................................................1668 3.3.4.4 Objets utilisateur......................................................................................................................1676 3.3.5 Cration de dynamisations avec VBA.....................................................................................1680 3.3.5.1 Cration de dynamisations avec VBA.....................................................................................1680 3.3.5.2 Dynamisation des proprits d'une vue ou d'un objet.............................................................1682 3.3.5.3 Configuration d'actions commandes par vnement avec VBA............................................1693 3.3.5.4 Edition de dclencheurs..........................................................................................................1701 3.3.6 Gestion des vnements.........................................................................................................1704 3.3.7 Accs aux applications externes avec VBA............................................................................1707 3.3.7.1 Accs aux applications externes avec VBA............................................................................1707 3.3.7.2 Exemple : Accs MS Excel avec VBA..................................................................................1708 3.4 AddIns.....................................................................................................................................1714 3.4.1 AddIns.....................................................................................................................................1714 3.4.2 Ajouts d'addIns........................................................................................................................1714 3.4.3 Pour charger un AddIn dans Graphics Designer.....................................................................1716 3.4.4 Exemple : Cration d'addins....................................................................................................1718 3.4.4.1 Exemple : Cration d'addins....................................................................................................1718 3.4.4.2 Exemple : Crer un addin avec Visual Basic 6.0.....................................................................1718 3.5 Rfrence VBA........................................................................................................................1724 3.5.1 Le modle d'objet du Graphics Designer................................................................................1724 3.5.1.1 Rfrence VBA........................................................................................................................1724 3.5.1.2 Rfrence VBA : ActionDynamic.............................................................................................1726 3.5.1.3 Rfrence VBA : HMIObjects..................................................................................................1728 3.5.1.4 Rfrence VBA : Languages...................................................................................................1730 3.5.1.5 Evnements.............................................................................................................................1730 3.5.1.6 Mthodes.................................................................................................................................1765 3.5.1.7 Objets et listes.........................................................................................................................1867 3.5.1.8 Proprits................................................................................................................................2054 3.5.2 VBA dans d'autres diteurs WinCC.........................................................................................2479 3.5.2.1 VBA dans d'autres diteurs WinCC.........................................................................................2479 3.5.2.2 VBA dans la gestion des variables..........................................................................................2481 3.5.2.3 VBA dans Tag Logging............................................................................................................2492 3.5.2.4 VBA dans Text Library.............................................................................................................2519

    Sommaire

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 9

  • 3.5.2.5 VBA dans Alarm Logging........................................................................................................2532

    Index.......................................................................................................................................................2547

    Sommaire

    WinCC : Scripting (VBS, ANSI-C, VBA)10 Manuel systme, 02/2013, A5E32315922-AA

  • VBS pour la cration de procdures et d'actions 11.1 VBS pour la cration de procdures et d'actions

    ContenuWIN CC vous permet de dynamiser votre environnement Runtime avec Visual Basic Script. VBS vous permet non seulement de programmer des actions et des procdures globales, mais galement de dynamiser des objets graphiques en Runtime et de dclencher des actions.

    Ce chapitre vous explique,

    Comment travailler avec les diteurs VBScript

    Comment crer et diter des procdures

    Crer et diter des actions

    Comment activer des VBScript en Runtime

    Comment effectuer le diagnostic de vos scripts en Runtime

    Le modle objet du systme graphique Runtime

    Exemples dtailles concernant l'utilisation de VBScript

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 11

  • 1.2 Utilisation de Visual Basic Script dans WinCC

    IntroductionDans WinCC, la langue de programmation VBScript est galement disponible - en plus de C-Script - comme interface de programmation pour dynamiser l'environnement WinCC Runtime.

    Groupe cible de la documentationCette documentation s'adresse aux configurateurs ayant des connaissances en Visual Basic ou WinCC Scriptings (C).

    Possibilits d'emploiVBScript (VBS) vous permet d'accder en Runtime aux variables et aux objets du systme graphique Runtime, mais aussi d'excuter des actions ne dpendant pas des vues :

    Variables : Vous pouvez lire et crire des valeurs variable pour par exemple proposer des valeurs variable pour l'automate, et ce par simple clic de souris sur un bouton.

    Objets : Vous pouvez dynamiser les proprits de l'objet avec des actions et dclencher des actions via les vnements pour objets.

    Actions ne dpendant pas de la vue : Vous pouvez dclencher des actions indpendamment des vues, de faon cyclique ou par le biais de valeurs variable, par exemple la transmission quotidienne de valeurs dans un tableau Excel.

    Vous pouvez utiliser VBS aux endroits suivants dans WinCC :

    Dans le Global Script Editor : Vous configurez ici des actions et des actions ne dpendant pas des vues. Les procdures peuvent tre utilises dans des actions dpendant ou non des vues. Plusieurs procdures sont regroupes par thme dans un module.

    Dans Graphics Designer : Vous configurez ici les actions dpendant des vues, avec lesquelles vous dynamiser les proprits des objets graphiques ou vous permettant de ragir aux vnements en mode Runtime.

    Dans les barres d'outils et menus personnaliss : Vous configurez ici les procdures que vous appelez dans Runtime l'aide des menus et des barres d'outils.

    RemarqueActualiser la configuration modifie dans Runtime

    Un script VB modifi et li avec "menus et barres d'outils" est mis jour seulement aprs un redmarrage de Runtime.

    Si vous modifiez les proprits de "Menus et barres d'outils" dans Runtime, les modifications ne sont acceptes que dans les cas suivants : Aprs un changement de vue, lorsque la modification de la configuration ne concerne

    pas la vue de base. Par le chargement d'un autre fichier de configuration et le nouveau chargement du

    fichier de configuration modifi.

    VBS pour la cration de procdures et d'actions1.2 Utilisation de Visual Basic Script dans WinCC

    WinCC : Scripting (VBS, ANSI-C, VBA)12 Manuel systme, 02/2013, A5E32315922-AA

  • Variables connectes dans les menus et les barres d'outilsLes variables connectes dans les scripts de "Menus et barres d'outils" restent connectes lors de la dslection de vue. Pour la lecture indirecte de la mmoire image de process, les variables sont connectes et aprs la dslection de vue de nouveau dconnectes. Dans les scripts de "Menus et barres d'outils", les variables restent toutefois connectes lors de la dslection de vue.

    Scnarios d'applicationVBS vous permet par exemple d'effectuer en Runtime les oprations suivantes :

    configurer des consignes alloues aux variables pour la commande d'un objet graphique, pour par exemple allouer une valeur l'automate par simple clic de souris.

    configurer la permutation de la langue Runtime pour la commande d'un objet graphique.

    configurer le changement de couleur, de faon cyclique par exemple (clignotement) ou pour reprsenter des tats (Moteur en marche).

    Vous pouvez galement utiliser, outre les applications spcifiques WinCC, les fonctions VBS gnrales pour adapter votre Windows, par exemple :

    transfrer des donnes dans d'autres applications (Excel p. ex.)

    lancer des applications externes depuis WinCC

    crer des fichiers et des dossiers.

    Pour adapter votre environnement Windows, vous disposez des objets d'automation de votre environnement.

    Remarque

    Vous pouvez intgrer dans votre environnement tous les objets qui sont fournis avec Windows Script Host (WSH) de Microsoft, et ce par la mthode standard VBS CreateObject. De WinCC, VBS ne vous permet toutefois pas d'accder directement l'objet WSH.

    Aucune garantie, ni WinCC-Support ne peuvent tre apports pour les fonctions VBS permettant d'adapter l'environnement Windows.

    Distinction par rapport aux autres langages de programmation dans WinCC

    VBS et CVous pouvez utiliser VBScript dans WinCC paralllement C-Script, sans toutefois pouvoir mlanger les types de script :

    Au sein d'un projet et d'une vue, vous pouvez configurer des scripts VB et des scripts C.

    Il n'est pas possible d'appeler des scripts C dans des scripts VB et vice-versa.

    Dans VBS, vous disposez d'interfaces internes pour les variables et les objets de vue, tandis que vous pouvez galement accder d'autres sous-systmes de WinCC (le systme de journaux p. ex.) lorsque vous travaillez dans l'environnement C.

    VBS pour la cration de procdures et d'actions1.2 Utilisation de Visual Basic Script dans WinCC

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 13

  • VBS et VBAUtilisez VBA dans WinCC Configuration lors de configuration, pour adapter Graphics Designer vos besoins personnels ainsi que pour simplifier et automatiser la configuration. Les programmes VBA ne fonctionnent que dans l'environnement de la configuration de WinCC.

    Contrairement VBA, les scripts VB ne fonctionnent qu'en WinCC Runtime en vous permettant d'accder, l, aux objets graphiques et aux variables. VBS ne vous permet pas de crer ni de modifier de faon durable des objets ou des vues, alors que VBA vous le permet.

    Les diffrences essentielles dans le language qui existent entre VBA et VBS sont par exemple :

    VBS a t conu pour l'utilisation dans Internet, VBA pour l'automatisation d'applications logicielles.

    Le type de donnes VBS-Variable est toujours VARIANT. VBA fait par contre une diffrence entre les types de donnes, savoir INT, DOUBLE, STRING, etc.

    Certains lments du language dans VBA ont t enlevs ou complts dans VBS.

    La manipulation des erreurs dans VBS n'est pas rsolue de la mme manire que dans VBA.

    Vous trouverez en annexe sous "Principes de base de VBScript" une liste des diffrences entre VBA et VBS.

    Procdures, modules et actionsVBS dans WinCC vous permet d'utiliser des procdures, des modules et des actions permettant de dynamiser votre environnement Runtime :

    Procdures : Une procdure correspond une fonction en C. Inscrivez dans les procdures le code que vous voulez utiliser en plusieurs endroits de votre configuration. Vous appelez le code dans une action ou une autre procdure en affichant le nom de la procdure. Vous pouvez crer dans WinCC des procdures avec ou sans valeur de retour. Les procdures n'ont pas leur propre Trigger mais sont toujours appeles par une action.

    Modules : Les modules vous permettent de regrouper les procdures en units significatives. Vous crez par exemple des modules pour des procdures qui sont utilises dans une vue dtermine ou qui font partie d'une rubrique particulire, par exemple les fonctions auxiliaires mathmatiques ou les fonctions d'accs la banque de donnes.

    Actions : Les actions sont toujours dclenches par un Trigger. Configurez les actions pour des proprits d'objets graphiques, pour des vnements qui interviennent pour un objet graphique ou bien globalement dans le projet. Dans les actions, vous pouvez appeler sous forme de procdures un code utilis plusieurs fois.

    VBS pour la cration de procdures et d'actions1.2 Utilisation de Visual Basic Script dans WinCC

    WinCC : Scripting (VBS, ANSI-C, VBA)14 Manuel systme, 02/2013, A5E32315922-AA

  • VBS pour la cration de procdures et d'actions1.2 Utilisation de Visual Basic Script dans WinCC

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 15

  • 1.3 Modules et procdures

    IntroductionUtilisez les procdures pour rendre un code disponible plusieurs endroits de votre projet, mais en ne le crant qu'une seule fois. Appelez tout simplement la procdure en question au lieu de taper le code plusieurs fois. Votre code est plus simple et plus facile grer.

    Vous enregistrez toujours dans des modules les procdures allant ensemble. Si vous appelez dans Runtime une procdure dtermine par le biais d'une action, le module charg sera toujours celui dans lequel se trouve la procdure. Lors de la structuration de vos modules et procdures, il est donc ncessaire de prendre en considration les points suivants :

    Plus il y a de modules charger lors de l'appel d'une vue, moins bonnes seront les performances en Runtime.

    Plus un module est grand, et donc plus il contient de procdures, plus le temps de chargement est long pour le module.

    C'est pourquoi vous devez rpartir vos modules de faon judicieuse, par exemple un module contenant les procdures pour une partie de l'installation ou une vue dtermine.

    Une autre faon de structurer les procdures dans les modules est la structuration fonctionnelle, par exemple un module avec des fonctions mathmatiques. Utilisez cette structuration par exemple pour les modules que vous voulez utiliser entre projets. L'exemple

    VBS pour la cration de procdures et d'actions1.3 Modules et procdures

    WinCC : Scripting (VBS, ANSI-C, VBA)16 Manuel systme, 02/2013, A5E32315922-AA

  • suivant prsente un module dans lequel sont inscrites des fonctions mathmatiques drives des fonctions standard :

    Caractristiques des procduresLes procdures sous WinCC ont les proprits suivantes :

    Il vous revient de les crer et de les modifier.

    Vous pouvez les protger contre toute consultation et modification grce un mot de passe.

    Elles n'ont pas de Trigger.

    Elles sont enregistres dans un module.

    WinCC ne met disposition aucune procdure prdfinie, mais vous propose par exemple des modles de code et Intellisense pour simplifier la programmation. Selon le module auquel elles appartiennent, les procdures se classent en :

    procdures standard qui sont reconnues dans tous les projets sur l'ordinateur sur lequel elles ont t crs.

    Les procdures de projet ne peuvent tre utilises qu'au sein du projet dans lequel elles ont t cres.

    VBS pour la cration de procdures et d'actions1.3 Modules et procdures

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 17

  • Caractristiques des modulesUn module est un fichier dans lequel une ou plusieurs procdures sont enregistres. Les procdures sous WinCC ont les proprits suivantes :

    Vous pouvez les protger contre toute consultation et modification grce un mot de passe.

    le nom de fichier se termine par *.bmo.

    Selon la validit de leurs procdures, les modules forment deux catgories :

    Les modules standard : ils contiennent des procdures disponibles dans tous les projets. Les modules standard sont inscrits dans le systme de fichiers WinCC sous :

  • 1.4 Actions

    IntroductionUne action est toujours dclenche par un Trigger. Dans le mode Runtime, une action est p. ex. excute lorsqu'un objet est manipul par un clic sur la souris, lorsqu'une date/heure dtermine est arrive ou qu'une valeur de variable a chang.

    Caractristique des actionsLes actions dans Global Script sont dfinies une seule fois pour ensuite tre disponibles indpendamment des vues. Les actions Global Script ne sont valables que dans le projet dans lequel elles ont t dfinies. Les actions qui sont lies des objets graphiques ne sont valables que dans la vue dans laquelle elles ont t dfinies.

    Remarque

    Dans VBS, il n'est actuellement pas possible de crer des actions spcifiques aux ordinateurs.

    Valable pour les clients fonctionnant dans un systme multiposte : Toutes les actions globales configures sur un serveur sont galement excutes sur un client lors de l'ouverture d'un projet. Valable pour les clients fonctionnant dans un systme rparti : Si vous voulez utiliser des actions sur un ordinateur client, copiez sur le client les fichiers des actions dans le rpertoire de projet correspondant.

    Les actions ont les proprits suivantes :

    Il vous revient de crer et de modifier les actions.

    Les actions dans Global Script peuvent tre protges par un mot de passe contre toute modification ou consultation.

    Les actions possdent au moins un Trigger.

    Les actions dans Global Script ont un nom de fichier se terminant par *.bac.

    Les actions de Global Script sont inscrites dans le systme de fichiers WinCC sous : \ScriptAct\Nom de l'action.bac

    Trigger pour actionsLes Triggers sont ncessaires pour excuter des actions en runtime. On lie un Trigger une action pour crer l'vnement dclencheur de l'appel de l'action. Les actions sans dclenchement ne sont pas excutes.

    Dans WinCC, les types de Trigger suivants sont disponibles :

    VBS pour la cration de procdures et d'actions1.4 Actions

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 19

  • Temporisateur : Trigger acyclique ou cyclique, p. ex. lors de l'affichage d'une vue ou toutes les heures.

    Variables : Modification de la valeur

    Evnements : Modification des proprits de l'objet (changement de couleur p. ex.) ou vnements pour un objet (clic sur la souris p. ex.).

    Traitement d'actions en Runtime

    Dans le Graphics DesignerEn Runtime, il n'est pas possible d'excuter simultanment deux actions de mme type. Pour que les actions cycliques ne soient par exemple pas entraves par une action excute par un clic sur la souris, les actions dclenches par un vnement et les actions cycliques/dclenches par des variables sont excutes indpendamment les unes des autres dans Graphics Designer.

    Remarque

    Notez que la synchronisation entre les deux types d'action dans WinCC ne peut se faire que par l'objet DataSet ou des variables internes WinCC. Le traitement s'effectuant sparment, il n'existe plus de zone de donnes commune entre les actions dclenches par des vnements et les actions cycliques/dclenches par des variables.

    Lorsque le traitement des actions cyclique dans des vues est entrav, par exemple par une surcharge du systme ou d'autres actions, l'action sera nouveau excute une fois ds que possible. Les cycles non raliss ne sont pas placs dans une boucle d'attente, mais rejets.

    Aprs un changement d'image, les scripts en cours se terminent automatiquement au bout d'une minute.

    Les scripts qui fonctionnent encore lorsque vous quittez Runtime se terminent au bout de cinq minutes.

    Dans Global ScriptLes actions de Global Script ne dpendant pas des vues sont excutes les unes la suite des autres dans Runtime lors du dclenchement. Lorsqu'une action est dclenche, alors qu'une autre est justement en cours, la deuxime action est place en boucle d'attente jusqu' ce que son excution soit possible.

    Remarque

    Notez qu'une synchronisation entre des actions dans Global Script et dans Graphics Designer ne peut avoir lieu que par l'objet DataSet ou des variables internes WinCC. Il n'existe aucune zone de donnes commune entre les actions dans Graphics Designer celles dans Global Script.

    VBS pour la cration de procdures et d'actions1.4 Actions

    WinCC : Scripting (VBS, ANSI-C, VBA)20 Manuel systme, 02/2013, A5E32315922-AA

  • Utilisation des actionsLes actions peuvent tre utilises comme suit :

    Dans Global Script Les actions globales dfinies ici se droulent en Runtime indpendamment des vues.

    Dans Graphics Designer : Les actions dfinies ici se droulent uniquement dans la vue configure. Il vous faut toujours configurer une action dans Graphics Designer pour les proprits d'un objet ou un vnement pour un objet graphique.

    Voir aussiCration et dition d'actions (Page 57)

    Principes de base de VBScript (Page 825)

    Modules et procdures (Page 16)

    Utilisation de Visual Basic Script dans WinCC (Page 12)

    VBS pour la cration de procdures et d'actions1.4 Actions

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 21

  • 1.5 Procdez comme suit pour utiliser plusieurs fois des procdures et des actions

    IntroductionUne action configure avec VBS dans WinCC est toujours valable pour le projet dans lequel elle a t dfinie.

    Les domaines de validit des procdures sont les suivants:

    procdures standard qui sont reconnues dans tous les projets sur l'ordinateur sur lequel elles ont t cres

    procdures de projet qui ne peuvent tre utilises qu'au sein du projet dans lequel elles ont t cres. Lorsque vous copiez un projet, les procdures (modules) de projet sont copies en mme temps.

    Utiliser plusieurs fois des procdures et des actionsLorsque vous voulez utiliser des actions ou des procdures/modules dans d'autres projets ou sur d'autres ordinateurs, vous pouvez:

    soit utiliser la fonction "Enregistrer sous", pour enregistrer le module dans un autre rpertoire de projet ou sur une disquette par exemple

    soit copier le fichier de l'action ou du module dans Windows-Explorer pour le copier sur l'ordinateur cible, dans le rpertoire projet ou standard correspondant.

    Les Trigger et proprits configurs gardent leur validit lors du copiage. Les modules copis sont directement disponibles en Runtime. Les actions copies sont excutes en Runtime aprs avoir t ouvertes et enregistres.

    Remarque

    Les variables que vous utilisez dans une action ou une procdure doivent galement exister sur l'ordinateur cible. L'action ou la procdure ne sont pas excutes si la variable n'existe pas.

    Les procdures que vous dmarrez dans une action doivent exister sur l'ordinateur cible. Il y aura une erreur d'excution dans Runtime si la procdure n'existe pas.

    Inscription des procduresSi vous voulez copier des procdures dans d'autres rpertoires de projet pour les utiliser dans d'autres projets ou sur d'autres ordinateurs, prenez en considration le chemin des procdures au sein du systme de fichiers WinCC:

    Procdures standard:

  • Remarque

    Etant donn que les procdures sont toujours mmorises dans des modules, copiez toujours le module (*.bmo) dans lequel se trouve la procdure.

    Les procdures/modules copis sont visibles aprs actualisation de la fentre de navigation de Global Script (commande "Mise jour" dans menu contextuel) ou aprs redmarrage de l'diteur.

    Inscription d'actionsSi vous voulez copier des actions dans d'autres rpertoires de projet pour les utiliser dans d'autres projets ou sur d'autres ordinateurs, prenez en considration le chemin des actions au sein du systme de fichiers WinCC:

    \ScriptAct\Nom de l'action.bac

    Chaque action est enregistre dans son propre fichier. Lors du copiage des actions, tous les Trigger en faisant partie sont galement copis.

    Remarque

    Seules les actions cres dans Global Script sont inscrites dans le systme de fichiers WinCC. Les actions que vous voulez programmer dans Graphics Designer sont toujours enregistres avec la vue actuelle et ne peuvent tre transfres individuellement. Lorsque vous copiez une vue de Graphics Designer dans un autre rpertoire de projet, les actions enregistres avec la vue sont cependant galement transfres.

    Les actions copies sont visibles aprs actualisation de la fentre de navigation de Global Script (commande "Mise jour" dans menu contextuel) ou aprs redmarrage de l'diteur.

    Voir aussiModules et procdures (Page 16)

    Pour renommer une procdure ou un module (Page 55)

    Pour enregistrer une procdure (Page 53)

    Pour protger un module par un mot de passe (Page 51)

    Pour ajouter des informations de module supplmentaires (Page 49)

    Pour utiliser des procdures de projet et standard (Page 48)

    Pour crire le code d'une procdure (Page 45)

    Pour crer une nouvelle procdure (Page 44)

    Cration et dition de procdures (Page 40)

    VBS pour la cration de procdures et d'actions1.5 Procdez comme suit pour utiliser plusieurs fois des procdures et des actions

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 23

  • 1.6 Interactions avec CrossReference

    CrossReference et les Trigger de variable CrossReference de WinCC vous permet de retrouver rapidement tous les occurrences de variables, mme dans des actions VBS. Vous pouvez raffecter avec CrossReference les Trigger de variable provenant des actions dans Graphics Designer, c'est- dire les remplacer par d'autres variables tous les emplacements ou seulement sur des emplacements choisis.

    Remarque

    Vous pouvez galement raffecter des variables directement dans Graphics Designer en slectionnant l'objet graphique, puis la commande "Raffecter..." dans le menu contextuel.

    Vous trouverez de plus amples renseignements dans la documentation WinCC concernant CrossReference.

    Actions et CrossReferenceVous pouvez afficher toutes les actions utilises dans une vue via les proprits de la vue. Slectionnez cet effet la vue dans l'explorateur WinCC, puis la commande "Proprits" dans le menu contextuel. Vous obtiendrez des informations plus dtailles concernant le type de dynamisation en cliquant deux fois sur une inscription.

    Vous pouvez en outre afficher toutes les variables et vues utilises dans les actions via WinCC CrossReference. CrossReference vous permet galement de raffecter aisment des liaisons de variable des actions de Graphics Designer.

    Variables et CrossReferenceToutes les variables qui sont adresses avec la formulation standard suivante sont saisies automatiquement par la CrossReference de WinCC et mentionnes dans les attributs des vues.

    ' VBS1HMIRuntime.Tags("Tagname")

    Si vous appelez des variables avec d'autres formules dans votre code, vous pouvez les communiquer la CrossReference avec la section suivante :

    ' ' WINCC:TAGNAME_SECTION_STARTConst TagNameInAction = "TagName"' WINCC:TAGNAME_SECTION_END

    VBS pour la cration de procdures et d'actions1.6 Interactions avec CrossReference

    WinCC : Scripting (VBS, ANSI-C, VBA)24 Manuel systme, 02/2013, A5E32315922-AA

  • Vous pouvez insrer cette section dans des actions VBS autant de fois que vous le voulez.

    Remarque

    Il n'y a aucune garantie que CrossReference saisisse des noms de variable composs.

    Vues et CrossReferenceToutes les vues qui sont adresses avec la formulation standard suivante sont saisies automatiquement par la CrossReference de WinCC et mentionnes dans les attributs des vues.

    'VBS2HMIRuntime.BaseScreenName = "Screenname"

    Si vous appelez des vues avec d'autres formules dans votre code, vous pouvez les communiquer la CrossReference avec la section suivante :

    ' ' WINCC:SCREENNAME_SECTION_STARTConst ScreenNameInAction = "ScreenName"' WINCC:SCREENNAME_SECTION_END

    Vous pouvez insrer cette section dans des actions VBS autant de fois que vous le voulez.

    Remarque

    Pour des raisons de compatibilit avec les versions ultrieures, il est toujours prfrable d'crire les noms de vue sans l'extension de fichier ".PDL" .

    Voir aussiRfrence VBS (Page 110)

    Les diteurs VBScript (Page 28)

    Principes de base de VBScript (Page 825)

    Actions (Page 19)

    Modules et procdures (Page 16)

    Utilisation de Visual Basic Script dans WinCC (Page 12)

    VBS pour la cration de procdures et d'actions1.6 Interactions avec CrossReference

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 25

  • 1.7 Utilisation de variables globales dans VBS

    Introduction Vous pouvez dfinir dans Global Script Editor les variables globales qui peuvent alors tre utilises dans toutes les actions et procdures.

    Utilisation de variables globales dans Graphics Designer et Global ScriptLors de l'utilisation des variables dans Graphics Designer et Global Script, prenez en considration les conditions suivantes :

    Pour utiliser une variable globale dans une action dans Graphics Designer, appelez la procdure dans laquelle est dfinie la variable pour que le module correspondant soit charg dans Runtime.

    Pour utiliser une variable globale dans une action dans Global Script, il vous faut appeler au moins une procdure dans une action globale au moins, et ce depuis le module dans lequel est dfinie la variable pour que ce dernier soit charg dans Global Script Runtime. Il ne doit pas forcment s'agir de la procdure dans laquelle a t dfinie la variable.

    Cette procdure est ncessaire tant donn que les actions de Global Script et de Graphics Designer en Runtime sont traites indpendamment les unes des autres. Il n'existe pas de zone de donnes commune entre les deux systmes Runtime.

    Si vous devez synchroniser les actions de Global Script et de Graphics Designer, utilisez l'objet DataSet ou des variables internes WinCC.

    Utilisation des variables globales au sein du Graphics DesignerSi vous utilisez des variables globales dans Graphics Designer, prenez en considration les conditions suivantes :

    Pour utiliser une variable globale dans une action cyclique ou dclenche par une variable dans Graphics Designer, appelez la procdure dans laquelle est dfinie la variable. Cela est galement valable lorsque la variable a dj t appele dans une action dclenche par un vnement.

    Pour utiliser une variable globale dans une action dclenche par un vnement dans Graphics Designer, appelez la procdure dans laquelle est dfinie la variable. Cela est galement valable lorsque la variable a dj t appele dans une action cyclique ou dclenche par une variable.

    Cette procdure est ncessaire tant donn que les actions cycliques/dclenches par une variable ainsi que les actions dclenches par un vnement dans Graphics Designer en Runtime sont traites indpendamment les unes des autres. Il n'existe pas de zone de donnes commune entre les deux types d'action.

    Utilisez l'objet DataSet ou des variables internes WinCC si vous devez synchroniser des actions cycliques/dclenches par une variable et des actions dclenches par un vnement.

    Vous avez en outre la possibilit de dfinir des variables globales dans une zone de dclaration spare se trouvant dans Graphics Designer. Etant donn qu'en Runtime les actions dclenches par un vnement et les actions cycliques/dclenches par une variable sont

    VBS pour la cration de procdures et d'actions1.7 Utilisation de variables globales dans VBS

    WinCC : Scripting (VBS, ANSI-C, VBA)26 Manuel systme, 02/2013, A5E32315922-AA

  • traites sparment, les variables globales ne sont ici accessibles en commun qu'au sein des actions dclenches par un vnement ou des actions cycliques/dclenches par une variable.

    Voir aussiPrincipes de base de VBScript (Page 825)

    Structure des fichiers VBScript (Page 97)

    Cration et dition d'actions (Page 57)

    Cration et dition de procdures (Page 40)

    Les diteurs VBScript (Page 28)

    Interactions avec CrossReference (Page 24)

    Actions (Page 19)

    Modules et procdures (Page 16)

    VBS pour la cration de procdures et d'actions1.7 Utilisation de variables globales dans VBS

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 27

  • 1.8 Les diteurs VBScript

    1.8.1 Les diteurs VBScript

    IntroductionDans WinCC, il vous est possible de programmer des scripts VB en deux emplacements:

    Dans Global Script Global Script est l'diteur central pour la programmation VBS. Vous pouvez l'appeler via l'explorateur WinCC.

    Dans Graphics Designer : Dans Graphics Designer, vous programmez des actions pour les proprits de l'objet ou bien des vnements pour des objets graphiques. Appelez l'diteur d'actions dans Graphics Designer par le biais du menu contextuel dans le dialogue des proprits d'un objet graphique.

    VBS pour la cration de procdures et d'actions1.8 Les diteurs VBScript

    WinCC : Scripting (VBS, ANSI-C, VBA)28 Manuel systme, 02/2013, A5E32315922-AA

  • Restrictions pour Global Script - Graphics DesignerDans Graphics Designer, vous pouvez programmer des actions et des procdures spcifiques la vue mais pas de procdures globales valables dans l'ensemble du projet. Vous pouvez cependant appeler des procdures globales qui ont t programmes dans Global Script.

    Remarque

    On dcrira essentiellement Global Script dans cette documentation et les divergences par rapport aux fonctions de Graphics Designer seront au besoin mentionnes. Vous trouverez sous la rubrique d'aide de WinCC "Dynamisation" une description dtaille de l'diteur d'actions dans Graphics Designer.

    Informations complmentairesVous trouverez de plus amples renseignements dans la documentation "Dynamisation" de WinCC.

    Voir aussiL'diteur Global Script (Page 29)

    1.8.2 L'diteur Global Script

    IntroductionVous pouvez crer et diter des procdures globales et des actions dans Global Script Editor.

    L'tendue des fonctions mises votre disposition par Global Script est similaire celle de C Script Editor dans WinCC.

    Remarque

    Vous trouverez dans la rubrique d'aide de WinCC "Dynamisation" une description dtaille de l'diteur d'actions pour crer des procdures et des actions en fonction des vues dans Graphics Designer.

    VBS pour la cration de procdures et d'actions1.8 Les diteurs VBScript

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 29

  • Appeler Global ScriptDmarrez Global Script via le menu contextuel "Ouvrir" dans la fentre de projet de l'explorateur WinCC.

    Global Script est galement automatiquement appel lorsque vous ouvrez par un double clic un module ou une action dans l'explorateur WinCC.

    Structure de Global ScriptGlobal Script est conu selon les standards Windows.

    L'diteur d'actions dans Graphics Designer met votre dispositions des fonctions similaires celles de Global Script. Vous trouverez sous la rubrique d'aide de WinCC "Dynamisation" une description de l'diteur d'actions dans le Graphics Designer.

    VBS pour la cration de procdures et d'actions1.8 Les diteurs VBScript

    WinCC : Scripting (VBS, ANSI-C, VBA)30 Manuel systme, 02/2013, A5E32315922-AA

  • Barre de menus (1) et barres d'outils (2)Vous trouverez dans la barre de menus et dans les barres d'outils toutes les commandes dont vous avez besoin pour crer des procdures et des actions.

    Les barres d'outils peuvent tre actives et dsactives via la commande de menu "Affichage" > "Barres d'outils" et tre dplaces dans l'diteur l'endroit voulu.

    Fentre de navigation (3)La fentre de navigation vous permet de grer vos procdures, modules et actions. En outre, elle contient des modles de code que vous pouvez ajouter par glisser&dplacer dans votre action ou procdure.

    Vous pouvez appeler une procdure soit dans une autre procdure, soit dans une autre action, en la tirant par drag&drop de la fentre de navigation pour la placer l'endroit respectif dans le code.

    L'affichage de la fentre de navigation est mis jour uniquement lors de l'enregistrement du document trait. Si vous modifiez un fichier, cela est indiqu par un * aprs le nom du fichier.

    Dans la fentre de navigation, les procdures contenues dans un module s'affichent sous les fichiers. Les Triggers configurs pour les actions et les procdures au besoin directement dfinies dans un module d'action s'affichent en outre sur l'onglet "Actions".

    La fentre de navigation vous permet en outre de :

    crer des sous-rpertoires pour la structuration de vos scripts

    copier, coller, effacer, renommer directement des modules et des rpertoires.

    Vous pouvez configurer individuellement les affichages dans la fentre de navigation avec la commande de menu "Affichage" > "Poste de travail". Vous pouvez choisir ici si tous les types de fichiers, seulement les fichiers Script ou seulement les fichiers Script syntaxe correcte doivent tre affichs. La commande de menu "Affichage" > "Poste de travail" > "Afficher" vous permet d'afficher ou de masquer la fentre de navigation.

    Fentre d'dition (4)Dans la fentre d'dition, vous pouvez crire et diter vos procdures et vos actions. Chaque fonction ou action est ouverte dans une fentre d'dition qui lui est propre. Il est possible d'ouvrir simultanment plusieurs fentres d'dition.

    Dans la fentre d'dition, l'utilisateur est assist par la mise en relief de la syntaxe et Intellisense. Toutes les fonctions d'dition courantes (p. ex. Undo/Redo, Rechercher/Remplacer, Copier, Coller, Couper, Rglage de la police de caractres, Assistance imprimante) restent disponibles.

    Fentre de sortie (5)Les messages d'erreur s'affichent dans la fentre de sortie aprs un contrle de syntaxe. Cliquez deux fois sur la ligne d'erreur correspondante pour parvenir l'endroit respectif dans le code.

    VBS pour la cration de procdures et d'actions1.8 Les diteurs VBScript

    WinCC : Scripting (VBS, ANSI-C, VBA)Manuel systme, 02/2013, A5E32315922-AA 31

  • Ligne d'tat (6)La ligne d'tat contient des informations concernant les fonctions actuellement choisies ou des conseils concernant la programmation.

    Remarque

    Si vous avez besoin d'informations concernant une commande ou un icne de l'diteur, slectionnez la commande de menu "?" > "Aide directe". Cliquez avec la souris sur l'icne/la commande correspondant(e). Vous disposez ainsi d'une aide directe rapide pour tous les organes de commande de l'diteur. Appuyez "ESC" lorsque vous voulez quitter le mode d'aide directe.

    Ancrage des fentresL'ancrage des fentres permet de disposer les diffrentes fentres de manire flexible. Vous avez la possibilit de dplacer les fentres, de les positionner librement en tant que fentres autonomes ou de les regrouper dans des groupes d'onglets. Vous pouvez, par exemple, positionner vos actions les unes ct des autres, les unes sous les autres ou sous forme d'onglets. Vous pouvez masquer automatiquement des fentres et les rafficher en cas de besoin. Pour plus d'informations, reportez-vous au chapitre "Crer des vues de process".

    Voir aussiProcdez comme suit pour supprimer des actions ou des procdures (Page 38)

    Utiliser les barres d'outils (Page 35)

    Travailler dans la fentre d'dition (Page 32)

    1.8.3 Travailler dans la fentre d'dition

    Introduction La fentre d'dition vous permet d'diter des procdures et des actions.

    Zone de dclaration dans des actions (Graphics Designer uniquement)Quand vous crez des actions dans le Graphics Designer, vous pouvez afficher dans la fentre d'dition la zone de dclaration de l'action avec le bouton .

    La zone de dclaration vous permet en outre de choisir les dfinitions gnrales que vous ne voulez utiliser que pour la vue actuelle, par exemple :

    VBS pour la cration de procdures et d'actions1.8 Les diteurs VBScript

    WinCC : Scripting (VBS, ANSI-C, VBA)32 Manuel systme, 02/2013, A5E32315922-AA

  • dfinitions de variables

    procdures que vous ne dsirez utiliser que dans cette vue

    Remarque

    Dans la zone "Dclaration" vous ne devez pas crer de code directement excutable!

    Notez que lors de la cration d'une variable, cette dernire ne contient aucune valeur (Value = VT_EMPTY). Initialisez les variables aprs la dclaration avec une valeur correspondante.

    Lors des procdures de dfinition dans la zone "Dclaration", prenez en considration la structure des fichiers Script comme dcrit sous "Structure des fichiers VBScript".

    "Option explicit" dans des actionsLors de la cration d'une nouvelle action, la commande "Option explicit" non supprimable s'inscrit automatiquement dans la zone de dclaration (Graphics Designer) ou sur la premire ligne d'une action (Global Script). La commande est ncessaire pour viter des erreurs par faute d'orthographe dans les variables sans dclaration. L'instruction vous invite toujours dfinir les variables avec l'instruction "Dim" dans votre code.

    Remarque

    N'utilisez pas la commande "Option explicit" dans votre code, sinon il pourrait y avoir des erreurs d'excution.

    Assistance de l'utilisateur dans la fentre d'ditionLorsque vous travaillez dans la fentre d'dition, vous tes assist par les fonctions suivantes.

    Codage des couleurs et enfilades dans la fentre d'ditionCertaines parties du code sont en standard identifies par des couleurs :

    Couleur Signification Exemplebleu Mots-cls

    FonctionsSub, End Sub, Next

    vert Commentaires ' c'est un commentairerouge Chanes de caractres (chane

    de caractres et nombres)"Object1"

    bleu fonc Instructions prprocesseur --gras, noir Constantes vbTrue, vbFalsenoir Autre lment de code --

    Vous pouvez dterminer individuellement le codage des couleurs dans la fentre d'dition par le biais des rglages de l'diteur. Appelez c