French Smart Tools

Objets complexes
1 ___________________ Vue d'ensemble

Exportation/Importation de 2 ___________________ variables
SIMATIC HMI WinCC V7.0 SP3 Objets complexes

Impression de l'aide en ligne
3 ___________________ Simulateur de variables 4 ___________________ Dynamic Wizard Editor 5 ___________________ Documentation Viewer
WinCC 6 ___________________ CrossReferenceAssistant WinCC Communication 7 ___________________ Configurator
12/2011
Mentions lgales Mentions lgales Signaltique 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 accompagn dun triangle de danger, signifie que la non-application des mesures de scurit appropries peut entraner des blessures lgres. PRUDENCE non accompagn dun triangle de danger, signifie que la non-application des mesures de scurit appropries peut entraner un dommage matriel. IMPORTANT signifie que le non-respect de l'avertissement correspondant peut entraner l'apparition d'un vnement ou d'un tat indsirable. 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 qualifies
Lappareil/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 destination

Tenez 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 fabrique
Toutes 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 responsabilit
Nous 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 AG Industry Sector Postfach 48 48 90026 NRNBERG ALLEMAGNE
Impression de l'aide en ligne 12/2011
Copyright Siemens AG 2011. Sous rserve de modifications techniques
Sommaire
1 2 Vue d'ensemble ......................................................................................................................................... 7 Exportation/Importation de variables.......................................................................................................... 9 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 3 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10 4 4.1 4.2 4.3 4.4 4.4.1 4.4.2 4.4.3 4.4.4 4.4.5 Exportation/Importation de variables .............................................................................................9 Installation de variables Exportation/importation .........................................................................10 Procdure.....................................................................................................................................11 L'utilitaire Exportation/Importation de variables ...........................................................................13 Liaisons ........................................................................................................................................14 Structures de fichiers ...................................................................................................................15 Variable ........................................................................................................................................16 Annexe .........................................................................................................................................18 Le simulateur de variables ...........................................................................................................21 Utilisation du simulateur de variables ..........................................................................................22 Fonctions du simulateur...............................................................................................................23 Installation du simulateur .............................................................................................................24 Ajouter/supprimer des variables ..................................................................................................25 Paramtrabilit des fonctions.......................................................................................................26 Activer/dsactiver les variables....................................................................................................27 Reprsentation des variables ......................................................................................................27 Charger/enregistrer les donnes de simulation ...........................................................................27 FAQ..............................................................................................................................................27 Dynamic Wizard Editor ................................................................................................................29 Prsentation .................................................................................................................................29 Installation de Dynamic Wizard Editor .........................................................................................31 Structure.......................................................................................................................................32 Structure.......................................................................................................................................32 Barre d'outils ................................................................................................................................33 Fentre d'dition ..........................................................................................................................35 Editeur d'aide ...............................................................................................................................36 Fentre de sortie..........................................................................................................................37
Simulateur de variables ........................................................................................................................... 21
Dynamic Wizard Editor ............................................................................................................................ 29
Objets complexes Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne
Sommaire
4.5 Structure d'une fonction Dynamic Wizard ................................................................................... 38 4.5.1 Structure d'une fonction Dynamic Wizard ................................................................................... 38 4.5.2 Dialogue Dynamic Wizard........................................................................................................... 38 4.5.3 Insertion de fichiers d'en-ttes et de DLL ................................................................................... 39 4.5.4 Dfinitions en fonction de la langue ............................................................................................ 40 4.5.5 Indicateurs Wizard ...................................................................................................................... 41 4.5.6 Liste des proprits..................................................................................................................... 42 4.5.7 Interface systme........................................................................................................................ 43 4.5.8 Variables globales....................................................................................................................... 44 4.5.9 Liste des options ......................................................................................................................... 45 4.5.10 Liste de dclenchements ............................................................................................................ 47 4.5.11 Affichage du paramtrage........................................................................................................... 50 4.5.12 Fonctions Wizard pour la saisie des paramtres ........................................................................ 51 4.5.12.1 CreateStatic ................................................................................................................................ 51 4.5.12.2 CreateEdit ................................................................................................................................... 53 4.5.12.3 CreateSpinEdit ............................................................................................................................ 56 4.5.12.4 CreateListBox.............................................................................................................................. 59 4.5.12.5 CreateCheckBox ......................................................................................................................... 62 4.5.12.6 CreateFrame ............................................................................................................................... 65 4.5.12.7 CreateRadioButton...................................................................................................................... 67 4.5.12.8 CreateFileBrowser ...................................................................................................................... 69 4.5.12.9 CreateVarBrowser / CreateVarBrowserEx.................................................................................. 73 4.5.12.10 CreatePackageBrowser/CreatePackageBrowserEx.............................................................. 76 4.5.12.11 CreateObjectBrowser............................................................................................................. 79 4.5.13 Fonctions Wizard pour la gnration de dynamiques................................................................. 82 4.5.13.1 GenerateBLOB............................................................................................................................ 82 4.5.13.2 DeleteBLOB ................................................................................................................................ 85 4.5.13.3 SetAction ..................................................................................................................................... 86 4.5.13.4 AddTimeTrigger .......................................................................................................................... 87 4.5.13.5 AddVarTrigger /AddVarTriggerEx ............................................................................................... 89 4.5.13.6 SetValidateFct............................................................................................................................. 91 4.5.13.7 EnumProperty/EnumPropertyEx................................................................................................. 93 4.5.14 Fonctions WinCC Wizard ............................................................................................................ 95 4.5.14.1 GetProjectName.......................................................................................................................... 95 4.5.14.2 GetPictureName.......................................................................................................................... 96 4.5.14.3 GetDefaultWNFPath ................................................................................................................... 96 4.5.14.4 GetObjectName .......................................................................................................................... 97 4.5.14.5 InsertXRefSection ....................................................................................................................... 97 4.5.15 Fonction de progression Wizard ................................................................................................. 99 4.5.15.1 Fonction de progression Wizard ................................................................................................. 99 4.5.15.2 CreateProgressDlg.................................................................................................................... 100 4.5.15.3 Progress_SetStatus .................................................................................................................. 100 4.5.15.4 Progress_Steplt......................................................................................................................... 101 4.5.15.5 Progress_SetPos ...................................................................................................................... 101 4.5.15.6 DestroyProgressDlg .................................................................................................................. 102 4.5.16 Fonctions Windows Wizard....................................................................................................... 102 4.5.16.1 Fonctions Windows Wizard....................................................................................................... 102 4.5.16.2 GetParent .................................................................................................................................. 103 4.5.16.3 GetWindowRect ........................................................................................................................ 104 4.5.16.4 MoveWindow............................................................................................................................. 105 4.5.16.5 SendMessage ........................................................................................................................... 106 4.5.16.6 GetWindow................................................................................................................................ 107
Objets complexes
Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne
Sommaire
4.5.16.7 ShowWindow .............................................................................................................................108 4.5.16.8 MessageBox ..............................................................................................................................109 4.6 4.6.1 4.6.2 4.6.2.1 4.6.2.2 4.6.2.3 4.6.2.4 4.6.3 4.6.3.1 4.6.3.2 4.6.3.3 4.6.3.4 4.6.3.5 5 5.1 5.2 5.3 5.4 6 6.1 6.2 6.3 6.4 6.5 6.6 6.7 6.8 7 Exemples ...................................................................................................................................111 Exemples ...................................................................................................................................111 Dmo Wizard .............................................................................................................................111 Dmo Wizard .............................................................................................................................111 Pour crer la fonction d'assistant dynamique pour l'assistant de dmonstration ......................111 Pour crer le texte d'aide ...........................................................................................................112 Pour enregistrer le script "Demo.wnf" dans la base de donnes ..............................................113 Dynamiser le moteur..................................................................................................................114 Dynamiser le moteur..................................................................................................................114 Pour crer la fonction d'assistant dynamique pour le moteur....................................................114 Pour enregistrer le script "Motor.wnf" dans la base de donnes...............................................115 Pour dynamiser l'objet utilisateur "Moteur" ................................................................................116 Pour crer la structure et la variable structure.........................................................................117 WinCC Documentation Viewer ..................................................................................................119 Installation de l'application WinCC Documentation Viewer .......................................................119 Description .................................................................................................................................120 Gnration des fichiers .emf ......................................................................................................121 WinCC CrossReferenceAssistant ..............................................................................................123 Installant de CrossReferenceAssistant......................................................................................123 Gnral ......................................................................................................................................124 Fonctions connues (gestion des scripts) ...................................................................................125 Slection de projet .....................................................................................................................129 Slection de fichier.....................................................................................................................130 Conversion .................................................................................................................................131 Paramtres avancs ..................................................................................................................132
Documentation Viewer........................................................................................................................... 119
WinCC CrossReferenceAssistant .......................................................................................................... 123
WinCC Communication Configurator ..................................................................................................... 133 Index...................................................................................................................................................... 135
Objets complexes Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne
Sommaire
Objets complexes
Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne
Vue d'ensemble
Contenu
Smart Tools est une collection de programmes qui facilitent le travail avec WinCC. Il contient les programmes et fichiers suivants : Simulateur de variables Exportation/Importation de variables Dynamic Wizard Editor Documentation Viewer WinCC CrossReferenceAssistant Configurateur de communication WinCC ConfigurationTool WinCC Archive ConfigurationTool Remarque
Les "Smart Tools" sont des outils supplmentaires. Veuillez noter qu'ils peuvent ventuellement influencer le fonctionnement de WinCC, par ex. en ce qui concerne les temps d'excution ou la mmoire ncessaire. En ce qui concerne la convivialit et les fonctionnalits des Smart Tools, les mmes critres que pour le logiciel de base de WinCC ne sont pas forcment valables.
Objets complexes 12/2011, Impression de l'aide en ligne
Vue d'ensemble
Objets complexes
12/2011, Impression de l'aide en ligne
Exportation/Importation de variables
2.1 Exportation/Importation de variables
Abrg descriptif
Le programme exporte depuis un projet ouvert toutes les liaisons, toutes les structures et toutes les variables dans des fichiers ASCII. Ces entits peuvent tre ensuite importes dans un second projet. Le format ASCII permet de traiter les fichiers avec un tableur avant de les rimporter.
Exportation/Importation de variables 2.2 Installation de variables Exportation/importation
2.2
Introduction
Installation de variables Exportation/importation
L'exportation/importation des variables peut tre installe de deux faons diffrentes. Le programme ne peut tre utilis que si WinCC est galement installe.
Condition
Avec les projets WinCC multipostes, vous ne pouvez pas utiliser l'outil complexe "Exportation/Importation des variables" chez un client n'ayant pas son propre projet.
Marche suivre
1. Slectionnez lors du Setup de WinCC dans le dialogue "Programmes" l'entre "WinCC V7 complet". WinCC est alors install avec les SmartTools ainsi que le WinCC ConfigurationTool et le WinCC Archive ConfigurationTool. Pour dmarrer l'application Exportation/Importation des variables, slectionnez "SIMATIC > WinCC > Tools > Tag Export Import".
Procdure alternative
Vous pouvez aussi installer l'application Exportation/Importation des variables partir du DVD de WinCC. 1. Passez sur le DVD WinCC au dossier "WinCC\InstData\Smarttools\Setup". 2. Cliquez deux fois sur le programme setup.exe. 3. Slectionnez l'entre "VarExplmp" dans le dialogue "Composants". 4. Cliquez sur le bouton "Suivant". Suivez ensuite les instructions apparaissant l'cran.
Objets complexes
10
Exportation/Importation de variables 2.3 Procdure
2.3
Procdure
EXPORTATION
1. Dmarrez WinCC, puis ouvrez le projet dont vous voulez exporter des variables. Dmarrez "VAR_EXIM.EXE" 2. Slectionnez le chemin et le nom du fichier dans lequel doit se faire l'exportation. Il suffit ce stade d'indiquer le nom du fichier sans l'extension 3. Paramtrez le mode d'utilisation "Export" 4. Cliquez sur "Execute". Confirmez le contenu de la bote de message 5. Attendez l'affichage de "End Export/Import" dans le champ d'tat 6. Vous pouvez afficher les fichiers crs avec les boutons "tag" (variables), "con" (connexions), "dex" (structures) et "diag" (fichier log)
Les groupes vides ne sont pas exports. Le trait de soulignement ( _ ) est rserv aux noms. Les noms de fichiers ne doivent donc pas contenir de trait de soulignement.
IMPORTATION
1. Dmarrez WinCC, puis ouvrez le projet dans lequel vous voulez importer des variables. 2. Tous les pilotes de canal dans lesquels vous voulez importer des liaisons doivent tre disponibles dans le projet. Ajoutez si ncessaire les pilotes manquants au projet 3. Dmarrez "VAR_EXIM.EXE" 4. Slectionnez le chemin et le nom du fichier d'o l'importation doit se faire. Il suffit ce stade d'indiquer le nom du fichier sans l'extension Si vous utilisez le dialogue de slection, cliquez sur un des trois fichiers exports 5. Paramtrez comme mode d'utilisation "Import" ou "ImportOverwrite". En mode "ImportOverwrite", une variable existant dj dans le projet cible est crase par la variable importe de mme nom. En mode "Import", un message est crit dans le fichier log et la variable existant dj dans le projet cible reste inchange. 6. Cliquez sur "Execute". Confirmez le contenu de la bote de message 7. Attendez l'affichage de "End Export/Import" dans le champ d'tat 8. Observez les donnes cres dans la gestion de variables WinCC.
Dans les deux modes, l'importation n'est pas possible lorsque WinCC Runtime est activ.
11
Exportation/Importation de variables 2.3 Procdure

Les dtails techniques de l'exportation/l'importation de variables seront dcrits dans les sections qui suivent. La lecture de ces chapitres n'est cependant pas absolument ncessaire pour les cas d'utilisation standard, dans lesquels l'ordinateur cible a la mme configuration que la machine WinCC sur laquelle l'exportation a t faite. Des connaissances sur la structure des variables WinCC ne sont ncessaires que si vous voulez vous-mme crer de nouvelles variables ou modifier des variables existantes par les fichiers ASCII.
Objets complexes
12
Exportation/Importation de variables 2.4 L'utilitaire Exportation/Importation de variables
2.4
L'utilitaire Exportation/Importation de variables

L'utilitaire "Exportation/Importation de variables" est une application autonome base sur l'API de WinCC. Cet outil peut tre utilis pour exporter toutes les variables WinCC d'un projet dans des fichiers ASCII et pour importer des variables, p. ex. dans un second projet. Trois fichiers sont gnrs [name]_cex.csv pour les liaisons logiques [name]_cex.csv pour les descriptions de structures [name]_cex.csv pour les descriptions de variables Dans ces fichiers, une ligne d'en-tte renseignant sur les donnes cres est gnre. A l'importation, les trois fichiers sont imports automatiquement. Le fichier [name]_cex.csv est d'abord import, car les variables ne peuvent tre gnres que si la liaison correspondante existe dj. Viennent ensuite les structures de donnes dfinies dans le fichier [name]_dex.csv. Il s'agit de types de donnes personnaliss qui doivent videmment tre connus avant la cration d'une variable de ce type. Les dfinitions des variables sont ensuite lues dans le fichier [name]_vex.csv. Il n'est pas possible de crer des groupes de variables indpendamment d'une variable. Si un groupe n'existe pas, il est automatiquement cr avec la variable. C'est pourquoi il n'est pas gnr de fichier de groupes lors de l'exportation. Si, dans votre projet, des groupes ne contenant aucune variable sont dfinis, ces groupes ne sont pas exports non plus. Lors de la cration d'un variable vous programmez entre entres son adresse, qui indique quel emplacement physique la variable est localise dans l'automate. Cette adresse est fonction du canal de la liaison et de l'automate connect. Lors de la configuration par l'explorateur WinCC un masque de saisie spcifique au canal utilis est affich. En ditant un fichier d'importation de "Exportation/Importation de variables", prendre en considration ces particularits. Il ne faut donc importer sur un deuxime projet WinCC des variables exportes que si cette installation a la mme configuration que l'installation d'o les donnes ont t exportes. Lorsque des donnes sont importes dans un projet, ceci doit se faire en connaissance des variables y existant dj. Corriger au besoin manuellement les adresses. D'un autre ct, il n'est toutefois pas exclu que l'importation de variables soit possible partir d'installations ayant un canal diffremment configur. La russite d'une telle tentative dpend du canal et de l'automate programmable ! Les types de structures exports dpendent par contre du matriel. Tous les paramtres de canal et de liaison, tels que Connection, GroupName, Adress information, ne sont pas pris en compte. Ces paramtres ne sont dfinis qu' la cration d'une variable structure.
Particularits lors de l'exportation de la chane d'adresses dans szSpecific. La chane de caractres d'adresse est vrifie par le logiciel spcifique au canal lors de la cration de la variable. Ces DLL de canal attendent une syntaxe dfinie, qui ne doit pas tre modifie en fonction du pays. Pour cette raison, les chanes de caractres d'adresse sont places l'exportation dans une parenthse " " supplmentaire, ensuite enleve l'importation. Ceci garantit que des outils tels qu'Excel ne modifieront pas l'information d'adresse (problme du sparateur de listes).
13
Exportation/Importation de variables 2.5 Liaisons
2.5
Liaisons
Une liaison ne peut tre importe que si un pilote de canal correspondant a t configur. En outre les paramtres contenus dans le fichier [name]_cex.csv doivent correspondre au pilote de canal configur.. Si l'ordinateur cible utilise un autre canal que celui de l'ordinateur dont proviennent les donnes exportes, ceci est la premire modification faire sur les donnes exportes. Une procdure simple pour dterminer les donnes de liaison requises : configurez toutes les liaisons sur l'ordinateur cible et lancez l'exportation. Vous pouvez alors reprendre les paramtres de votre ordinateur cible dans le fichier [name]_cex.csv.
Exemple pour une liaison logique:

#Conname VerbAS1 VerbAS2 Unit Industrial Ethernet Profibus-FMS Common Gnral Gnral Specific "" "" FLAG 0 0
La deuxime ligne indique la liaison logique d'un pilote Industrial Ethernet de Simatic S7 Protocol Suite. La troisime ligne contient la liaison logique d'un pilote Profibus FMS. #Conname contient le nom de la liaison logique. Vous retrouvez ce nom de liaison logique dans les donnes de la variable dans le fichier export. C'est par cette liaison logique que se fera la communication avec l'automate programmable pour l'accs aux variables externes du process.
Objets complexes
14
Exportation/Importation de variables 2.6 Structures de fichiers
2.6
Structures de fichiers
Structure du fichier [name]_dex.csv:
#Structure Name Rgle_1 #Varname TypeID 1001 C.Vartype CreatorID 2500 C.CreatorID ... ... ... ... Project Path C:\DonnesTest\Proj.m cp C.VarLength ... ... ... ... etc. ... ... ... ...
Nouvelle_Variable ... 1 Nouvelle_Variable ... 2 Nouvelle_Variable ... 3 etc. ...
#:
Caractre de commentaire
#Structure Name: La ligne suivante contient le nom d'une structure de fichier avec des paramtres spcifiques la structure. L'indication du chemin de projet sert uniquement documenter le projet depuis lequel les donnes ont t exportes. Les donnes sont importes automatiquement dans le projet ouvert. #Varname: Les lignes suivantes contiennent les lments (champs) de la structure de fichier, valides jusqu' ce que le programme reconnaisse une nouvelle ligne "#Structure Name" ou qu'aucune ligne ne soit plus dfinie. Une ligne contient tous les paramtres ncessaires la dfinition d'une variable.
Remarque l'intention des utilisateurs de l'API WinCC: La premire ligne contient comme tiquette de colonne les noms des paramtres dans les structures de fichiers des appels API. Dans un tableau Excel, les donnes peuvent alors tre clairement interprtes. Si un nom est form d'une lettre suivie d'un point, c'est que l'affectation des appels API est ainsi plus facile.
Exemple : C.nnnnnn P.nnnnnn L.nnnnnn S.nnnnnn est contenu dans la sous-structure Common est contenu dans la sous-structure Protocol est contenu dans la sous-structure Limits est contenu dans la sous-structure Scaling
15
Exportation/Importation de variables 2.7 Variable
2.7
Variable
Variables et liaisons se composent d'une partie gnrale et d'une partie spcifique. La partie spcifique est toujours mise disposition par la DLL de canal respective. Bien que cette partie puisse manquer lors de la configuration (elle doit tre dfinie avant l'activation), tous les objets dont la partie spcifique fait dfaut sont ignors lors de l'importation. Ces parties manquantes sont remplaces par '*' lors de l'exportation.
Importation de variables d'un type dfini par l'utilisateur.

Une variable WinCC prdfinie est identifie par un type de donnes dont la valeur est comprise entre 1 et 18. Un type de structure personnalis reoit comme type de donnes le TypeID attribu par l'administrateur des donnes au moment de la cration de la structure des donnes. Ce TypeID est suprieur 1000. Un type de structure est dfini par son nom et son type de donnes. Le nom de la structure de donnes est, sur la machine sur laquelle s'est faite l'exportation, le mme nom que sur la machine sur laquelle on importe. Le TypeID doit tre mais ne sera pas identique. Pour pouvoir crer une variable du type Type de structure, il vous faut affecter TypeID au nom de structure.
Exemple : Les types de structure sont exports dans le fichier [name]_dex.csv.

#Structur Name ExternStr1 #Varname Variable1 Variable2 Variable3 Variable4 TypeID 1046 C.Vartype 1 2 3 4 CreatorID 0 C.CreatorID 0 0 0 0 Project Path G:\DonnesTest \... C.VarLength 2 1 1 2 C.VarProperty ... ... ... ... ... ... ... ... ...
Les variables sont exportes dans le fichier [name]_vex.csv.

#Varname InstExStr1 InstExStr1.Variable1 InstExStr1.Variable2 InstExStr1.Variable3 InstExStr1.Variable4 Conn VerbLp VerbLp VerbLp VerbLp VerbLp Group GruLp GruLp GruLp GruLp GruLp Spec DB200,DBB10 DB200,D10.0 DB200,DBB10 DB200,DBB10 DB200,DBB10 FLAG 0 0 0 0 0 CTyp 1046 1 2 3 4
Dans le fichier [name]_dex.csv, vous dfinissez un type de structure ayant le nom ExternStr1 et le TypeID 1046.
Objets complexes
16
Exportation/Importation de variables 2.7 Variable

Dans le fichier [name]_vex.csv, vous dfinissez une variable Structure ayant le type ExternStr1 et le nom InstExStr1. L'affectation signalant qu'il s'agit d'un type de structure ExternStr1, s'effectue via la valeur de la colonne CTyp qui contient le TypeID 1046 de ce type de structure. Pour importer une variable Structure, le type de structure doit donc se trouver dans le fichier [name]_dex.csv et la variable de ce type dans le fichier [name]_vex.csv. L'importation/l'exportation de variables mmorise la correspondance entre nom et TypeID et peut ainsi mettre en instance les variables Structure, mme si le TypeID de la machine cible est diffrent Si vous voulez importer des variables de type "dfinies par l'utilisateur" sans que la structure de donnes soit lue lors de l'importation (p. ex. aucun fichier [name]_dex.csv), le TypeID de la machine cible de cette structure de donnes doit tre rdit manuellement dans le fichier csv. Le TypeID est dans ce cas dfini comme dcrit plus haut, l'aide du fichier export [name]_dex.csv de la machine cible. La proprit d'une variable s'affiche dans la colonne CPro sous forme de valeur dcimale dans le fichier export [name]_vex.csv . On distingue les proprits de variable suivantes :
Proprit de variable Variable interne avec rafrachissement projet Variable interne avec rafrachissement ordinateur local Variable externe Valeur dcimale 2 8194 4 Valeur hexadcimale 2 2002 4
Si des variables internes sont p. ex. exportes de WinCC avec rafrachissement ordinateur local, il faut toutefois que les variables internes avec rafrachissement projet soient rimportes dans WinCC, la valeur de la proprit de variable dans la colonne CPro peut tre modifie pour les variables correspondantes de 8194 en 2 dans le fichier export. Le fichier export modifi est ensuite enregistr et import dans WinCC.
17
Exportation/Importation de variables 2.8 Annexe
2.8
Annexe
Champs de variable ---------------Varname: char szVarName[MAX_DM_VAR_NAME +1]; Conn: char szConnection[MAX_DM_CONNECTION_NAME +3]; Group: char szGroupName[MAX_DM_GROUP_NAME +1]; Spec: char szSpecific[MAX_DM_VAR_SPECIFIC +1]; Flag: DWORD dwFlags;
Common Ctyp: DWORD dwVarType; // Variable type CLen: DWORD dwVarLength; // Variable length CPro: DWORD dwVarProperty; // Variable property internal/external CFor: DWORD dwFormat; // Format convertion
Protocol: P1 : BOOL bTopLimitErr; // error in top limit P2 : BOOL bBottomLimitErr; // error in bottom limit P3 : BOOL bTransformationErr; // transformation error P4 : BOOL bWriteErr; // write error P5 : BOOL bWriteErrApplication; P6 : BOOL bWriteErrProzess;
Limits values LF1: double dTopLimit; LF2: double dBottomLimit; LF3: double dStartValue; LF4: double dSubstituteValue;
Limits flags L1 : BOOL bTopLimit; // use substitute value on top limit L2 : BOOL bBottomLimit; // use substitute value on bottom limit L3 : BOOL bStartValue; // use substitute value on start L4 : BOOL bConnectionErr; // use substitute value on error connection L5 : BOOL bTopLimitValid; // value top limit is valid
Objets complexes
18
L6 : BOOL bBottomLimitValid; // value bottom limit is valid L7 : BOOL bStartValueValid; // value start is valid L8 : BOOL bSubstValueValid; // value substitute is valid
Values for the field Ctyp ------------------------BIT 1 SBYTE 2 BYTE 3 SWORD 4 WORD 5 SDWORD 6 DWORD 7 FLOAT 8 DOUBLE 9 TEXT_8 10 TEXT_16 11 RAW 12 ARRAY 13 STRUCT 14 BITFIELD_8 15 BITFIELD_16 16 BITFIELD_32 17 TEXTREF 18
Description of connection fields -------------------------------Conname: char szConnection[MAX_DM_CONNECTION_NAME +3]; Unit: char szUnitName [MAX_DM_UNIT_NAME+1]; Common: char szCommon [MAX_DM_CON_COMMON +1] Specific: char szSpecific [MAX_DM_CON_SPECIFIC +1] ;
19
Objets complexes
20
Simulateur de variables
3.1 Le simulateur de variables
Abrg descriptif
Le simulateur de variables est utilis pour simuler des variables internes et des variables de process. Le test d'une configuration sans priphrie process connecte ou avec priphrie process connecte mais process arrt est par exemple une utilisation typique du simulateur de variables. Sans priphrie process connecte, vous ne pouvez simuler que des variables internes. Lorsque la priphrie de process est connecte, les variables de process peuvent tre alimentes directement par le simulateur de variables. Ceci permet d'effectuer un test fonctionnel du systme de contrle-commande avec le matriel d'origine. Le temps de mise jour pour les valeurs de variable est d'une seconde. La modification ne prend effet qu'aprs activation des fonctions ou aprs changement de document projet. Vous pouvez au maximum configurer 300 variables. Il est galement possible d'utiliser le simulateur de variables pour raliser un projet en vue d'une dmonstration. Pour la prsentation du systme de contrle-commande, il arrive souvent qu'il n'y ait pas de liaison l'installation. Dans ce cas, la simulation se charge d'alimenter les variables internes. Vous trouverez dans l'aide en ligne correspondante une description dtaille du simulateur de variables. ATTENTION Le simulateur de variables crit les valeurs du process dans l'automate programmable connect. Cela signifie qu'il faut prendre en considration la raction d'une priphrie process ventuellement raccorde.
21
Simulateur de variables 3.2 Utilisation du simulateur de variables
3.2
Utilisation du simulateur de variables

Le test d'une configuration sans priphrie process connecte ou avec priphrie process connecte mais process arrt est une utilisation typique du simulateur de variables.
Simulation de la variable de process sans priphrie process

Sans priphrie process connecte, vous ne pouvez simuler que des variables internes. Nous recommandons la procdure suivante pour simuler pralablement le process hors connexion : 1. Crez une copie de sauvegarde de votre projet en copiant votre dossier de projet et en le renommant par exemple xxx_sim. Tester la configuration avec cette copie de sauvegarde. Ouvrez WinCC avec cette copie du projet. 2. Ajoutez les variables de process simuler aux variables internes avec Couper et Coller. N'utilisez pas Copier et Coller car l'explorateur WinCC gnre automatiquement une extension pour que le nom de la variable soit unique dans le projet. L'information d'adresse de la variable de process ainsi dclare comme variable interne est alors perdue. 3. Les variables peuvent maintenant tre alimentes par le simulateur. 4. Lorsque la phase de test est termine, vous pouvez nouveau utiliser le projet d'origine.
Simulation de la variable de process avec priphrie process connecte

Lorsque la priphrie de process est connecte, les variables de process peuvent tre alimentes directement par le simulateur. Ceci permet d'effectuer un test fonctionnel du systme de contrle-commande avec le matriel d'origine, p. ex. : Test des niveaux de gris, des alarmes mises. Test de l'homognit des alarmes, avertissements, messages d'erreur et contrle des affichages d'tat. Affectation de valeurs par dfaut aux entres/sorties TOR et analogiques; affichage et dition des entres/sorties. Simulation d'alarmes.
Objets complexes
22
Simulateur de variables 3.3 Fonctions du simulateur
3.3
Introduction
Fonctions du simulateur
La simulation met 6 fonctions la disposition du technicien de configuration. Ces fonctions permettent d'affecter aux objets configurs des valeurs proches des conditions relles. La simulation met 6 fonctions la disposition du technicien de configuration pour tester divers cas de figure. Une de ces 6 fonctions peut tre affecte chaque variable.
sinus
Fonction non linaire, priodique.
Oscillation
Pour la simulation d'chelons d'une grandeur rglante.
Nombres alatoires
La fonction "Nombres alatoires" met des valeurs gnration alatoire la disposition de l'utilisateur.
Incrment
Compteur qui revient au minimum aprs avoir atteint le maximum.
Dcrment
Dcompteur qui revient au maximum aprs avoir atteint le minimum.
Dfileur
Rglette de paramtrage d'une valeur fixe.
23
Simulateur de variables 3.4 Installation du simulateur
3.4
Installation du simulateur
Le simulateur de variables peut tre install de deux manires :
Marche suivre
1. Slectionnez lors du Setup de WinCC dans le dialogue "Programmes" l'entre "WinCC V7 complet". WinCC est alors install avec les SmartTools ainsi que le WinCC ConfigurationTool et le WinCC Archive ConfigurationTool. Dmarrez le simulateur de variables par "SIMATIC > WinCC > Tools > WinCC Tag Simulator".
Alternative
Vous pouvez galement installer l'application Simulateur de variables partir du DVD WinCC. 1. Passez sur le DVD WinCC au dossier "WinCC\InstData\Smarttools\Setup". 2. Cliquez deux fois sur le programme setup.exe. 3. Dans le dialogue "Composants", slectionnez l'entre "Simulateur de Variables WinCC". 4. Cliquez sur le bouton "Suivant". Suivez ensuite les instructions apparaissant l'cran.
Dmarrage du simulateur
Le simulateur Simulation.exe peut tre lanc soit par l'intermdiaire de l'Explorateur Windows, soit en tant inscrit dans la liste de dmarrage du WinCC Explorer, aprs quoi il est automatiquement dmarr l'activation d'un projet. La condition pralable au bon fonctionnement du simulateur est l'activation d'un projet dans WinCC Explorer. Si le simulateur est plac dans la liste de dmarrage du projet, cette condition pralable est remplie.
Objets complexes
24
Simulateur de variables 3.5 Ajouter/supprimer des variables
3.5
Ajouter/supprimer des variables
Ajouter une nouvelle variable

Vous pouvez ajouter des nouvelles variables pour la simulation en utilisant les commandes de menu "Edition/Nouvelle variable". Le dialogue de slection de variables de l'explorateur WinCC alors appel permet de slectionner la variable souhaite dans le projet actif. Si une variable doit tre entirement cre, cela peut aussi se faire dans le dialogue de slection de variable. La variable pralablement slectionne est inscrite dans l'onglet "Proprits" du simulateur ds que vous validez votre choix l'aide du bouton "OK". Vous pouvez y slectionner la forme selon laquelle la valeur de la variable doit tre modifie. Pour valider dfinitivement l'ajout au simulateur, cliquez sur l'onglet Variables avant d'ajouter la variable suivante. La simulation de variable configure peut tre enregistre dans un fichier de configuration possdant l'extension "sim".
Supprimer variable
Lorsqu'une variable doit tre supprime de la liste du simulateur, vous la slectionnez puis activez la commande de menu "Edition/Supprimer variable". La variable slectionne est alors supprime sans avertissement de la liste des variables simuler.
25
Simulateur de variables 3.6 Paramtrabilit des fonctions
3.6
Paramtrabilit des fonctions

Les paramtres des fonctions peuvent tre dfinis individuellement pour chaque variable.
Fonction sinus
La plage de valeurs de cette fonction se dfinit par le paramtre Amplitude. Le zro de la plage de valeurs peut tre paramtr dans Offset. La priode est paramtre par Priode (valeur paramtre * Cycle Time).
Oscillation
Le paramtre Valeur de consigne permet de paramtrer la valeur atteindre en fin de rgime transitoire. Le paramtre Dpassements indique jusqu'o les valeurs peuvent s'carter de la valeur de consigne lorsque la valeur "Null" est paramtre pour l'amortissement. Le paramtre Priode dfinit l'intervalle de temps. Lorsque l'intervalle de temps paramtr est coul, l'oscillation recommence.
Nombres alatoires
Les paramtres Seuil mini et Seuil maxi dfinissent la plage des nombres alatoires.
Incrment
Les paramtres Valeur initiale et Valeur finale dfinissent la plage de valeurs du compteur.
Dcrment
Les paramtres Valeur initiale et Valeur finale dfinissent la plage de valeurs du dcompteur.
Dfileur
Les paramtres Valeur initiale et Valeur finale dfinissent la plage de valeurs de la rglette.
Objets complexes
26
Simulateur de variables 3.7 Activer/dsactiver les variables
3.7
Activer/dsactiver les variables

Pour assurer un passage sans problmes de la configuration hors ligne la configuration en ligne, les variables peuvent tre actives et dsactives par des cases cocher. Si la variable est active, les valeurs sont calcules par la simulation et transmises l'explorateur WinCC. Si la case n'est pas coche, la simulation ne transmet pas de valeurs l'explorateur WinCC.
3.8
Reprsentation des variables

Pendant la phase de configuration le contrle des variables est facilit au technicien de configuration par l'affichage des informations suivantes dans l'onglet "Variables": le projet WinCC actuel Nom des variables la fonction associe l'tat (actif / inactif) la valeur actuelle Lorsque vous slectionnez le nom d'une variable, les autres paramtres sont affichs dans l'onglet "Proprits".
3.9
Charger/enregistrer les donnes de simulation

Vous pouvez sauvegarder des donnes de simulation pour qu'elles soient disponibles au prochain dmarrage du simulateur. Ceci se fait par la commande de menu "Fichier/Enregistrer" ou "Fichier/Enregistrer sous...". Utilisez la commande "Fichier/Ouvrir" pour charger une configuration de simulation sauvegarde. Lorsque vous dmarrez le simulateur, la dernire configuration utilise pour un projet WinCC est charge.
3.10
FAQ
Erreur pas trouve avec DM-API, DLL Si une erreur en corrlation avec des DLL se produit en appelant le simulateur, c'est que l'attribution du chemin a t omise dans le fichier AUTOEXE.BAT. Contrlez si l'inscription suivante se trouve dans ce fichier, dans l'attribution du chemin : SET PATH = .....;<Lecteur WinCC>:\<WinCC-Directory>\bin
27
Simulateur de variables 3.10 FAQ

p. ex: SET PATH=C:\SIEMENS\WINCC\BIN;
Objets complexes
28
Dynamic Wizard Editor

4.1 Dynamic Wizard Editor
Abrg descriptif
Dynamic Wizard Editor est un utilitaire servant crer vos propres assistants dynamiques. Les assistants dynamiques permettent d'automatiser les squences de configuration rptes frquemment.
4.2
Introduction
Prsentation
L'assistant dynamique est une fonctionnalit supplmentaire disponible dans Graphics Designer. Il peut assister l'utilisateur dans les procdures de configuration frquemment rptes. Il rduit le travail et les erreurs de configuration. L'assistant dynamique est constitu de diverses fonction d'assistant dynamique. Un grand nombre de fonctions d'assistant dynamique sont fournies. Elles peuvent tre compltes par des fonctions cres par l'utilisateur. Un diteur spcifique est disponible pour la cration de fonctions d'assistant dynamique. Il s'agit du programme dynwizedit.exe.
29
Dynamic Wizard Editor 4.2 Prsentation
Objets complexes
30
Dynamic Wizard Editor 4.3 Installation de Dynamic Wizard Editor

Toutes les fonctions de l'assistant Dynamic Wizard sont enregistres sur le disque dur, dans une base de donnes (...\WinCC\wscript\Dynwiz.cwd). L'assistant dynamique possde un cran d'affichage standard et une interface utilisateur pour la slection et le paramtrage des fonctions de l'assistant dynamique. Aprs slection d'une fonction d'assistant dynamique, celle-ci est charge par l'assistant dynamique et son excution est dclenche.
Interface entre assistant dynamique et fonction d'assistant dynamique

L'articulation entre assistant dynamique et fonction d'assistant dynamique se fait par une interface systme intgre la fonction d'assistant dynamique dont la structure est prescrite. Cette interface contient des informations qui sont exploites par l'assistant dynamique. L'interface contient essentiellement : Rfrence au coeur de la fonction Le coeur de fonction est la principale fonctionnalit de la fonction d'assistant dynamique. Elle contient la "puissance" qu'une fonction d'assistant dynamique offre l'utilisateur, comme p. ex. la gnration d'une action sur un objet graphique. La liste d'options dfinit les paramtres ncessaires pour la fonction excuter. Elle dfinit galement leur affichage dans l'interface de dialogue. La liste de triggers dfinit les triggers auxquels un objet cr doit tre li. Elle dfinit galement leur affichage dans l'interface de dialogue.
4.3
Installation de Dynamic Wizard Editor

L'diteur Dynamik Wizard peut tre install de deux manires :
Marche suivre
1. Slectionnez lors du Setup de WinCC dans le dialogue "Programmes" l'entre "WinCC V7 complet". WinCC est alors install avec les SmartTools ainsi que le WinCC ConfigurationTool et le WinCC Archive ConfigurationTool. Dmarrez l'diteur Dynamik Wizard par "SIMATIC > WinCC > Tools".
Autre dmarche possible

Vous pouvez galement installer l'diteur Dynamik Wizard partir du DVD WinCC. 1. Passez sur le DVD WinCC au dossier "WinCC\InstData\Smarttools\Setup". 2. Cliquez deux fois sur le programme setup.exe. 3. Dans le dialogue "Composants", slectionnez l'entre "Dynamik Wizard Editor". 4. Cliquez sur le bouton "Suivant". Suivez ensuite les instructions apparaissant l'cran.
31
Dynamic Wizard Editor 4.4 Structure
4.4
Structure
4.4.1
Structure
L'diteur "Dynamic Wizard Editor" est constitu des lments suivants : Barre des menus La barre de menu contient les fonctions de Dynamic Wizard Editor. La barre de menu est toujours visible. Barre d'outils La barre d'outils peut tre affiche en fonction des besoins et place en n'importe quel endroit de l'cran avec la souris. Fentre d'dition La fentre d'dition n'est affiche que lorsqu'une fonction d'assistant dynamique est ouverte pour l'diter ou pour crer une nouvelle fonction. Chaque fonction est ouverte dans sa propre fentre d'dition. Il est possible d'ouvrir simultanment plusieurs fentres d'dition. Fentre de sortie La fentre d'affichage peut tre affiche en fonction des besoins. Elle contient le rsultat des fonctions "Crer s DWD", "Lire script d'assistant" et "Compiler fichier wnf". Barre d'tat La barre d'tat peut tre affiche en fonction des besoins. Elle renseigne sur les tats du clavier et affiche la position du curseur dans la fentre d'dition Assistant dynamique L'assistant dynamique permet de dynamiser un objet par des actions C. Durant l'excution des assistants, des actions C prprogrammes et des triggers sont dfinis et enregistrs dans les proprits de l'objet
Objets complexes
32
4.4.2
Introduction
Barre d'outils
La barre d'outils vous permet d'excuter plus rapidement des actions. Vous ne devez plus slectionner plusieurs commandes de menu pour atteindre la fonction souhaite.
Icnes
Icone Description Cre une nouvelle fonction d'assistant dynamique. Ouvre une fonction d'assistant dynamique (*.wnf) existante. Enregistre la fonction d'assistant dynamique. Coupe le texte marqu et le copie dans le presse-papiers. Copie dans le presse-papiers le texte marqu. Insre le contenu du presse-papiers la position du curseur Imprime le contenu de la fentre d'dition active. Affiche des informations plus prcises sur l'diteur d'assistant dynamique. Cre les donnes d'assistant dynamique (DWD). Cette fonction charge tous les scripts d'assistant disponibles pour la langue actuellement paramtre et les prpare pour l'excution dans l'assistant dynamique. Le fichier cr se trouve dans le chemin d'installation de WinCC (Installationspfad\wscripts\dynwiz.cwd).. Charge les scripts d'assistant et les met ainsi la disposition de l'assistant dynamique. Paramtre la langue pour laquelle vous configurez le script d'assistant. Les langues connues de WinCC sont mises ici disposition, indpendamment des langues installes. La permutation de la langue de l'assistant n'a aucune rpercussion sur l'ensemble du systme ou sur l'interface de configuration.
33
Icone
Description Change l'objet. L'assistant dynamique, galement disponible dans l'diteur pour des tests, dpend des diffrentes proprits d'un objet dans Graphics Designer. Pour qu'un script d'assistant nouveau ou existant puisse tre test dans l'diteur, cette fonction permet de permuter sur un objet existant, sur une vue existante. Etant donn le nouvel objet rgl, l'assistant dynamique est adapt de faon telle que seuls les scripts d'assistant appropris pour cet objet s'affichent. Affiche tous les scripts d'assistant dynamique pour la langue paramtre. Vous pouvez en outre supprimer dans le dialogue les scripts d'assistant existants. Ouvre l'diteur de textes d'aide Compile le script.
Objets complexes
34
4.4.3
Introduction
Fentre d'dition
Les fonctions d'assistant dynamique sont cres et dites dans la fentre d'dition.
Code couleurs
Le code couleurs pour l'affichage du code C est le suivant:
Couleur bleu vert rouge noir Signification Mots cls Commentaires Chanes de caractres Autre lment de code C Exemple #define, void // Ceci est un commentaire "First Element" OnOption1
35
4.4.4
Introduction
Editeur d'aide
Vous pouvez, dans ce dialogue, enregistrer un texte d'aide pour chaque page cre par le script d'assistant dynamique. Vous ne pouvez enregistrer des textes d'aide que pour des assistants dynamiques dj crs.
Elments de l'diteur d'aide

Elment Groupe d'assistants Nom de l'assistant Page Texte d'aide Description Ce champ sert slectionner le groupe (=onglet) dans lequel se trouve l'assistant dynamique. Champ contenant le nom de l'assistant dynamique pour lequel vous voulez crer un texte d'aide. Champ contenant la page de dialogue pour laquelle vous voulez crer un texte d'aide. Champ de saisie du texte d'aide.
Objets complexes
36
4.4.5
Introduction
Fentre de sortie
Elle contient le rsultat des fonctions "Crer DWD", "Lire script d'assistant" et "Compiler fichier wnf".
La fentre d'affichage vous aide rechercher les erreurs dans les scripts. La prsence d'une erreur dans le script dclenche un message ayant la structure suivante: ...\WinCC\wscripts\wscripts.deu\DemoWiz1.wnf(6):error(003a): 'include': invalid function definition
Description ...\WinCC\wscripts\wscripts.deu\ DemoWiz1.wnf(6) error(003a): 'include': invalid function definition Rpertoire dans lequel est enregistr le fichier wnf. Nom du fichier et numro de la ligne contenant l'erreur Numro d'erreur et description de l'erreur.
37
Dynamic Wizard Editor 4.5 Structure d'une fonction Dynamic Wizard
4.5
Structure d'une fonction Dynamic Wizard
4.5.1
Introduction
Structure d'une fonction Dynamic Wizard
Une fonction d'assistant dynamique doit avoir la syntaxe prescrite. Elle est structure d'aprs les lments qui lui sont ncessaires. 1. Imbrication de fichiers d'en-ttes et de DLL 2. Dfinition spcifique aux langues 3. Flags d'assistant 4. Liste des proprits 5. Interface systme 6. Variables globales 7. Liste des options 8. Liste de dclenchements 9. Affichage du paramtrage
4.5.2
Introduction
Dialogue Dynamic Wizard
Chaque fonction d'assistant dynamique a sa fonctionnalit propre. Du fait de la structure fixe prescrite pour les fonctions, elles ont toutes le mme schma d'excution et la mme interface de dialogue. Le dialogue d'assistant dynamique est constitu de plusieurs pages de dialogue. Dialogue "Bienvenue dans Dynamic Wizard" Dialogue "Slectionner un dclencheur" Dialogue "Dfinir les options" Dialogue "Termin !"
Objets complexes
38
4.5.3
Introduction
Insertion de fichiers d'en-ttes et de DLL
Un fichier d'en-tte contient les dclarations de constantes, de types de donnes, de variables et de fonctions. Les fichiers d'en-tte sont insrs dans la fonction par une instruction #include. Le fichier le plus important insrer est ici le fichier dynamic.h. Les fonctions permettant de dfinir l'interface de l'assistant dynamique sont entre autres dclares dans ce fichier.
Les fichiers DLL (Dynamic Link Library) sont des routines excutables pouvant tre charges par un programme lorsqu'il en a besoin. Pour pouvoir tre utiliss, ces fichiers DLL sont insrs dans la fonction par une instruction #pragma.
Les chemins suivants sont dfinis dans l'diteur d'assistant dynamique: Fichiers d'en-tte de WinCC: ...\WinCC\aplib\ DLL de WinCC: ...\WinCC\bin\ Si les fichiers se trouvent dans un autre rpertoire, vous devez indiquer leur chemin complet dans les instructions #include et #pragma.
39
4.5.4
Introduction
Dfinitions en fonction de la langue
Les fonctions standard d'assistant dynamique existent en allemand, anglais et franais. Un changement de langue dans l'explorateur WinCC entrane la slection de la version de langue correspondante pour les fonctions d'assistant dynamique. Les chemins ..\WinCC\wscripts\wscripts.deu ..\WinCC\wscripts\wscripts.enu ..WinCC\wscripts\wscripts.fra doivent contenir un fichier WNF pour chaque fonction d'assistant dynamique. Toutes les dfinitions spcifiques aux langues d'utilisation doivent tre places dans cette section lors de la cration. Ceci facilite la gnration des autres versions de langue.
Objets complexes
40
4.5.5
Introduction
Indicateurs Wizard
Ces flags dfinissent pour quel type de configuration la fonction d'assistant dynamique est valable.
Indicateurs
FLAG WIZARD_FLAG_OCX WIZARD_FLAG_ALL_PROJECT_TYPES Pour tous les fichiers OCX Pour tous les projets
WIZARD_FLAG_SINGLEUSER_PROJECT Uniquement pour projets monoposte WIZARD_FLAG_MULTICLIENT_PROJECT Uniquement pour projets clients WIZARD_FLAG_MULTIUSER_PROJECT Uniquement pour les clients sans donnes sur le projet
41
4.5.6
Introduction
Liste des proprits
La liste des proprits sert dfinir les types d'objets pour lesquels une fonction d'assistant dynamique est cre. Ceci se fait en indiquant une liste de proprits d'objet. Si un objet possde au moins une des proprits numres, la fonction d'assistant dynamique peut tre applique cet objet.
Chaque entre de la liste des proprits est constitue de deux paramtres: Nom anglais de la proprit, p. ex. "Backcolor" pour la couleur d'arrire-plan Type de donnes WinCC Si vous utilisez une liste de proprits vide, la fonction d'assistant dynamique peut tre applique tous les types d'objet. La liste des proprits doit toujours exister mme si elle est vide.
Objets complexes
42
4.5.7
Introduction
Interface systme
L'interface systme sert dfinir les proprits de la nouvelle fonction d'assistant dynamique.
Description des paramtres

1. Le premier paramtre dfinit l'onglet dans lequel la fonction d'assistant dynamique doit apparatre. 2. Le deuxime paramtre dfinit le nom sous lequel la fonction d'assistant dynamique doit apparatre. 3. Le troisime paramtre a toujours la valeur NULL. 4. Le quatrime paramtre dsigne le nom du symbole (icne) utilis pour la fonction d'assistant dynamique. 5. Le cinquime paramtre est un texte d'aide dcrivant plus prcisment la fonctionnalit de la fonction d'assistant dynamique. 6. Le sixime paramtre est une liste des noms des fonctions cres pour les diverses pages d'options. Cette liste doit se terminer par une entre NULL. Le nombre maximal de pages d'options qu'il est possible de crer est cinq. Pour de plus amples informations, consultez "Liste d'options".
43

7. Le septime paramtre est le nom du coeur de fonction appel lorsque vous cliquez sur "Termin !". Le coeur de fonction est la principale fonctionnalit de la fonction d'assistant dynamique. Elle contient la "puissance" qu'une fonction d'assistant dynamique offre l'utilisateur, comme p. ex. la gnration d'une action sur un objet graphique. 8. Le huitime paramtre est le nom de la fonction qui reprend les paramtrages effectus dans les pages d'options et les affiche l'utilisateur avant que celui clique sur le bouton "Termin !". Pour de plus amples informations, consultez "Affichage du paramtrage". 9. Le neuvime paramtre est une liste des dclenchements afficher dans la page de dclenchements. Il existe pour les situations d'application les plus frquentes des macros qui remplissent cette liste de dclenchements. Pour de plus amples informations, consultez "Liste de dclenchements".
4.5.8
Introduction
Variables globales
Vous devez dfinir une variable globale pour chacun des paramtres dfinir dans les pages d'options. Ceci fait que les paramtres dfinis sont connus de toutes les fonctions cres. Le passage de donnes entre des fonctions systme n'est possible que par des variables globales. Ceci est ncessaire chaque fois que des paramtres de dclenchement et/ou d'option sont transmis la fonction de traitement.
Objets complexes
44
4.5.9
Introduction
Liste des options
Options et paramtres ncessaires la fonctionnalit du coeur de fonction de l'assistant dynamique. Les options ne ncessitent pas de dclenchements. Les options se dfinissent dans la liste d'options de l'interface systme. La liste d'options contient pour chaque option le nom de la fonction d'option associe, p. ex. "OnOption1".
La liste d'options doit tre termine par un pointeur NULL. Vous pouvez dfinir au maximum cinq options dans la liste.
Fonction d'options
L'assistant dynamique appelle successivement les fonctions d'option dans l'ordre de leur prsentation dans la liste d'options. Pour chaque fonction d'option le dialogue "Dfinir les options" est affich pour la programmation de la saisie par la fonction. Il existe des fonctions d'assistant dynamique pour la programmation de la saisie. Pour de plus amples informations, consultez "Fonctions systme d'assistant dynamique". Le dialogue "Dfinir les options" contient une partie permettant de placer des textes statiques, des champs de saisie et autre botes de saisie.
45
La partie du dialogues "Activer options" affichant les lignes 1 15 est compltement remplie. La fonction d'option correspondante se prsente comme suit:
Objets complexes
46
4.5.10
Introduction
Liste de dclenchements
Les dclenchements ne sont ncessaires que pour les actions sur un objet graphique. Les dclenchements se dfinissent dans la liste de dclenchements de l'interface systme. La liste de dclenchements contient une entre pour chaque dclenchement
L'entre est constitue de deux paramtres. Le premier paramtre est la dsignation du dclenchement affiche lorsque vous appuyez p. ex. sur le bouton gauche de la souris. Le deuxime paramtre contient le nom de la fonction associe dclenche par le trigger. La liste de dclenchements doit tre termine par une paire de pointeurs NULL. Vous pouvez dfinir au maximum 50 dclenchements dans la liste. Il existe des macros pour les dclenchements les plus utiliss.
47
Macro JCR_TRIGGERS Evnements dclencheurs DECLARE_JCR_TRIGGERS Clic, Touche gauche, Touche droite Dclenchement cyclique DECLARE_JCR_ZYKL_TRIGGERS Cycle vues, Cycle fentres, Sur vnement, 250 ms, 500 ms, 1 seconde, 2 secondes, 5 secondes, 10 secondes, 1 minute, 5 minutes, cycle utilisateur1, cycle utilisateur2, cycle utilisateur3, cycle utilisateur4, cycle utilisateur5 Dclenchement d'action DECLARE_JCR_ACTION_TRIGGERS
JCR_ZYCL_TRIGGERS
JCR_ACTION_TRIGGERS
Le dialogue "Slectionner un dclencheur" est cr partir de la liste de dclenchements. Tous les noms de dclenchements sont affichs dans un champ de liste de slection.
Objets complexes
48
Aprs la slection d'un dclenchement, l'assistant dynamique appelle la fonction dclenche par le dclenchement.
49
4.5.11
Introduction
Affichage du paramtrage
Les paramtres de dclenchement et d'option peuvent tre affichs dans le dialogue "Termin !" L'utilisateur a ainsi la possibilit de vrifier encore une fois le paramtrage et de le modifier le cas chant. Le champ d'affichage de la page "Termin !" peut afficher un texte avec la fonction Windows SetWindowText. Le champ d'affichage a une hauteur de 12 lignes.
Objets complexes
50
4.5.12
4.5.12.1 Introduction
Fonctions Wizard pour la saisie des paramtres

CreateStatic
Dans le dialogue "Dfinir les options" un texte statique est affich prs des coordonnes x,y.
Syntaxe
HWND CreateStatic (int x, int y, char* "Text")
Paramtres
Paramtres int x int y char* Text Description Valeur de x. Valeur de y. Texte qui va tre affich.
Valeur en retour
Valeur en retour HWND Retourne la poigne de l'objet
51
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction.
char* DynWizEditStatic = "Saisissez un texte"; ... .. void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; }
//Texte statique
CreateStatic(0,5,DynWizEditStatic); ..... ...... }
Objets complexes
52
CreateEdit
Dans le dialogue "Dfinir les options" un champ de saisie est affich prs des coordonnes x,y. Un texte peut tre entr dans le champ de saisie.
Syntaxe
HWND CreateEdit ( int x, int y, char* pText )
Paramtres
Paramtres int x int y char* pText Description Valeur de x. Valeur de y. Pointeur vers un tampon de saisie. Une valeur par dfaut peut tre affecte au tampon de saisie. Celle-ci est affiche dans le champ de saisie.
Valeur en retour
Valeur en retour HWND pText Retourne la poigne de l'objet Le tampon de saisie contient le texte saisi.
53
Exemple
L'extrait du fichier "Demo.wnf" suivant prsente l'utilisation cette fonction. Un champ d'affichage apparat dans le dialogue "Dfinir les options" de l'assistant "Demo Wizard".
char* DynWizEditStatic = "Saisissez un texte"; char* DynWizEdit = "Texte d'exemple"; ... .. char g_szEdit[256]; void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; }
Objets complexes
54

//Texte statique pour le champ de saisie
CreateStatic(0,5,DynWizEditStatic);
//Champ de saisie
hWnd = CreateEdit(0,20,g_szEdit) GetWindowRect(GetParent(hWnd), &rect); MoveWindow(hWnd,0,20,(rect.right-rect.left),21,TRUE); ..... ...... }
55
CreateSpinEdit
Dans le dialogue "Dfinir les options" un champ de saisie cyclique est affich prs des coordonnes x,y. une valeur de type Entier" est entre dans une variable de saisie par le champ de saisie.
Syntaxe
HWND CreateSpinEdit (int x, int y, int* pValue, int Min, int Max, int Base )
Paramtres
Paramtres int x int y int* pValue int Min int Max int Base Description Valeur de x. Valeur de y. Pointeur vers une variable de saisie de type Entier. Une valeur par dfaut peut tre affecte la variable de saisie. Valeur mini de la valeur de saisie Valeur maxi de la valeur de saisie Format numrique de la saisie : 10 = saisie dcimale 16 = saisie hexadcimale
Valeur en retour
Valeur en retour HWND pValue Retourne la poigne de l'objet. La variable de saisie contient la valeur saisie.
Objets complexes
56
Exemple
L'extrait du fichier "Demo.wnf" suivant prsente l'utilisation cette fonction. Un champ d'affichage avec rgulateur rotatif apparat dans le dialogue "Dfinir les options" de l'assistant "Demo Wizard". Vous pouvez y paramtrer une valeur entre 0 et 1000.
char* DynWizSpinStatic= "Saisissez un texte (0 - 1000):"; char* DynWizEdit = "Texte d'exemple"; ... ... char g_szEdit[256]; void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; }
57
... ...
//Texte statique pour le champ de saisie cyclique

CreateStatic(0,50,DynWizSpinStatic);
... //Champ de saisie

hWnd = CreateSpinEdit(0,65,&g_iSpinEdit,0,1000,10);
MoveWindow(hWnd,0,65,(rect.right-rect.left)/4,21,TRUE);
... ... }
Objets complexes
58
CreateListBox
Dans le dialogue "Activer options" un champ de slection est affich prs des coordonnes x,y. Ce champ de slection peut contenir plusieurs entres. Une entre se slectionne par un clic de la souris.
Syntaxe
HWND CreateListbox (int X, int Y, char* Headline, int NumLines, int* pSelect )
Paramtres
Paramtres int x int y char* Headline int NumLines int* pSelect Description Valeur de x. Valeur de y. Etiquette du champ de slection Nombre de lignes dans le champ de slection. A paramtrer par dfaut : NumLines = nombre lignes + 1 (1 =< NumLines = <16) Pointeur sur la variable de rsultat
Valeur en retour
Valeur en retour HWND pSelect Retourne la poigne de l'objet. Numro de l'entre slectionne. Le numro est l'indice dans la liste (commenant par 0).
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Un champ de slection est affich dans le dialogue "Activer options" de l'assistant "Demo Wizard". Le champ de slection a une taille maximale de trois lignes. Le nombre des entres tant suprieur trois, un dfileur est affich. Remarque La fonction "CreateListbox" ne cre que le champ de slection. Vous devez y placer vousmme le contenu des lignes avec la fonction "SendMessage".
59
char* DynWizListStatic= "Slectionnez une entre dans"; ... int g_iListBox = 0;
//Dfinition du type des lments du champ de slection

typedef struct listboxItem { int iIndex; char szItemText[256]; }LB_ITEM, *PLB_ITEM;
#define LB_NUM_LINES 5
LB_ITEM g_itemListBox[LB_NUM_LINES] = { { 0, "First Element"}, { 1, "Second Element"}, { 2, "Third Element"}, { 3, "Fourth Element"},
Objets complexes
60
{ 4, "Fifth Element"} };
void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; } ... ...
//Texte statique pour le champ de slection

CreateStatic(0,162,DynWizListStatic); ...
//Champ de slection
hWnd = CreateListbox(0,177,"Headline",LB_NUM_LINES,&g_iListBox);
MoveWindow(hWnd,0,177,(rect.right-rect.left),50,TRUE); La fonction "CreateListbox" ne cre que le champ de slection. Vous devez y placer vousmme le contenu des lignes avec la fonction "SendMessage".
for (i=0; i<LB_NUM_LINES; i++) { SendMessage(hWnd,LB_INSERTSTRING,(WPARAM)-1,(LPARAM)g_itemListBox[i].szItemText); } }
61
CreateCheckBox
Dans le dialogue "Dfinir les options" une case cocher est affiche prs des coordonnes x,y. Une option peut tre active en cochant la case. Plusieurs cases peuvent tre utilises dans un dialogue.
Syntaxe
HWND CreateCheckBox (int x, int y, char* Text, BOOL* pSelect )
Paramtres
Paramtres int x int y char* Text BOOL* pSelect Description Valeur de x. Valeur de y. Texte affich droite de la case. Pointeur sur la variable de rsultat. Une valeur par dfaut (True/False) doit tre affecte la variable de rsultat.
Valeur en retour
Valeur en retour HWND pSelect Retourne la poigne de l'objet. Etat d'activation FALSE = pas active TRUE = active
Objets complexes
62
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Dans le dialogue "Dfinir les options" de l'assistant de dmonstration "Demo Wizard", trois cases cocher reprsentant chacune une option sont affiches. Chaque option peut tre active individuellement.
BOOL g_bCheck1 = TRUE; BOOL g_bCheck2 = TRUE; BOOL g_bCheck3 = TRUE;
void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { ... } ...
63
...
//Cases cocher
iMid = (rect.right-rect.left)/2 ;
CreateCheckBox(iMid,100,"CheckBox 1",&g_bCheck1); CreateCheckBox(iMid,116,"CheckBox 2",&g_bCheck2); CreateCheckBox(iMid,132,"CheckBox 3",&g_bCheck3 }
Objets complexes
64
CreateFrame
Un cadre rectangulaire est affich dans le dialogue "Dfinir les options". Le coin suprieur gauche du cadre est dtermin par les coordonnes x,y. Le coin infrieur droit concide avec le coin infrieur droit de la fentre de slection d'options.
Syntaxe
HWND CreateFrame (int x, int y, char* Title )
Paramtres
Paramtres int x int y char* Title Description Valeur de x. Valeur de y. Etiquetage sur le bord suprieur du rectangle
Valeur en retour
Valeur en retour HWND Retourne la poigne de l'objet.
65
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Dans le dialogue "Dfinir les options" de l'assistant de dmonstration un cadre est affich avec le titre "Frame".
void OnOption2(void) { //Cadre CreateFrame(0,150,"Frame"); } ... ...
Objets complexes
66
CreateRadioButton
Dans le dialogue "Dfinir les options" un bouton d'option est affich prs des coordonnes x,y. Une option peut tre active par ce bouton. L'utilisation de boutons d'options n'a de sens que si plusieurs boutons d'option sont utiliss dans le dialogue. Un seul bouton est actif la fois.
Syntaxe
HWND CreateRadioButton (int x, int y, char* Text, BOOL* pSelect )
Paramtres
Paramtres int x int y char* Text BOOL* pSelect Description Valeur de x. Valeur de y. Dsignation de l'option active par le bouton d'option. Le texte est plac la droite du bouton. Pointeur sur la variable de rsultat. Une valeur par dfaut (True/False) doit tre affecte la variable de rsultat.
Valeur en retour
Valeur en retour HWND pSelect Retourne la poigne de l'objet. Etat d'activation : FALSE = pas active TRUE = active
67
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Dans le dialogue "Activer options" de l'assistant de dmonstration "Demo Wizard", trois boutons reprsentant chacun une option sont affichs. Une seule option peut tre active la fois.
BOOL g_bOption1 = TRUE; BOOL g_bOption2 = FALSE; BOOL g_bOption3 = FALSE;
void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { ... } ... ...
//Boutons d'option
CreateRadioButton(0,100,"RadioButton 1",&g_bOption1); CreateRadioButton(0,116,"RadioButton 2",&g_bOption2); CreateRadioButton(0,132,"RadioButton 3",&g_bOption3); }
Objets complexes
68
CreateFileBrowser
Le dialogue "Dfinir les options" affiche prs des coordonnes x,y un champ de saisie avec bouton de recherche. Vous pouvez y saisir un nom de fichier.
L'activation du bouton de recherche ouvre un dialogue de slection de fichier.
Syntaxe
HWND CreateFileBrowser (int x, int y, DWORD Flags, char* Filter, char* Nom du fichier )
69
Paramtres
Paramtres int x int y DWORD Flags Description Valeur de x. Valeur de y. Flags de commande de la fentre de slection : FB_WITHPATH = nom de fichier avec chemin FB_SAVE_AS = le dialogue "Enregistrer sous" apparat la place du dialogue "Ouvrir". Filtre pour l'affichage de types de donnes dans le champ de slection du dialogue de slection de fichiers. Le paramtrage par dfaut de l'extension dtermine quels types de donnes s'afficheront dans le champ de slection. Un filtre se compose d'un couple de chanes. La premire chane de caractres est le nom du filtre. La deuxime chane est la fonction du filtre au format *.typ, 'typ' tant une extension de fichier. Seuls les fichiers ayant cette extension seront affichs dans le champ de slection. 1. Les deux chanes sont spares par une barre verticale "|". Plusieurs filtres peuvent tre concatns avec "|". La limite du dernier filtre est ||. Exemples : char* Filter1 = "Vues graphiques (*.PDL) | *.PDL||"; char* Filter2 = "Documents (*.doc) | *.doc|" "Fichiers texte *.txt | *.txt|" "Fichiers WNF | *.wnf|" "Tous les fichiers (*.*) | *.*||";
char* Filter
Aucun espace n'est autoris la fin de la fonction du filtre. char* Nom du fichier Tampon de slection pour le nom de fichier. Un nom de chemin peut tre paramtr par dfaut. Cette valeur par dfaut a les effets suivants : Le nom du fichier s'affiche par dfaut dans la fentre de saisie. Si vous cliquez sur le bouton Parcourir, le chemin est paramtr dans le dialogue de slection de fichier. Lorsque le nom de fichier a l'extension '*.typ', tous les fichiers de ce type sont affichs dans le champ de slection du dialogue de slection.
Valeur en retour
Valeur en retour HWND Nom de fichier Retourne la poigne de l'objet. Le tampon de saisie contient le nom de fichier
Objets complexes
70
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Le dialogue "Dfinir les options" de l'assistant de dmonstration affiche un champ de saisie avec bouton de recherche. Un clic sur le bouton de recherche ouvre un dialogue de slection de fichier.
char* DynWizFileBrowserStatic = "Slectionnez un fichier"; char* DynWizFileBrowser = "C:\\Fichier d'exemple"; char* DynWizFilter = "Fichiers texte (*.txt) | *.txt|" "Tous les fichiers (*.*) | *.*||"; ... char g_szFileBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE) {
71
... strcpy(g_szFileBrowser,DynWizFileBrowser); First = FALSE; } ... ...
// Texte statique pour la saisie avec bouton de recherche

CreateStatic(0,95,DynWizFileBrowserStatic);
//Dialogue de slection de fichiers

hWnd = CreateFileBrowser(0,110,FB_WITHPATH,DynWizFilter,g_szFileBrowser); MoveWindow(hWnd,0,110,(rect.right-rect.left),21,TRUE); }
Objets complexes
72
CreateVarBrowser / CreateVarBrowserEx
Le dialogue "Dfinir les options" affiche prs des coordonnes x,y un champ de saisie avec bouton de recherche. Vous pouvez y saisir un nom de variable. Un clic sur le bouton de recherche ouvre le dialogue de slection de variables. Vous pouvez en plus paramtrer pour la fonction "CreateVarBrowserEx" un filtre de variables limitant les variables affiches dans le dialogue de slection de variables. Le filtrage peut se faire d'aprs le type de donnes, le groupe de variables, le nom de variable et la liaison.
Syntaxe
HWND CreateVarBrowser (int x, int y, char* VarName ) HWND CreateVarBrowserEx (int x, int y, LPDM_VARFILTER VarFilter, char* VarName )
Paramtres
Paramtres int x int y LPDM_VARFILTER VarFilter Description Valeur de x. Valeur de y. Indication optionnelle d'un pointeur vers un filtre de variables. Aucun filtre n'est actif si un pointeur NULL est spcifi. Le filtre de variables doit tre dfini l'aide de la structure DM_VARFILTER. Pour de plus amples informations, consultez la documentation de WinCC ODK. Contient le nom de variable. Une valeur par dfaut peut tre affecte au nom de variable. Le contenu de ce champ est toujours affich.
char* VarName
Valeur en retour
Valeur en retour HWND VarName Retourne la poigne de l'objet. Le tampon de saisie contient le nom de variable
73
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Le dialogue "Dfinir les options" de l'assistant de dmonstration affiche un champ de saisie avec bouton de recherche. Un clic sur le bouton de recherche ouvre le dialogue de slection de variables.
char* DynWizVarBrowser = "Variable d'exemple"; char* DynWizPicBrowserStatic = "Slectionnez une vue:"; ... char g_szVarBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE) { ... strcpy(g_szVarBrowser,DynWizVarBrowser);
Objets complexes
74
First = FALSE; } ... ...

CreateStatic(0,95,DynWizFileBrowserStatic);
//Dialogue de slection de variables

hWnd = CreateFileBrowser(0,110,FB_WITHPATH,DynWizFilter,g_szFileBrowser); GetWindowRect(GetParent(hWnd), &rect); MoveWindow(hWnd,0,110,(rect.right-rect.left),21,TRUE); }
75
CreatePackageBrowser/CreatePackageBrowserEx
Le dialogue "Dfinir les options" affiche prs des coordonnes x,y un champ de saisie avec bouton de recherche. Vous pouvez y saisir un nom. Packagebrowser s'active par le bouton de recherche plac contre le bord droit du champ de saisie. Le Flag ou le ProgID dtermine le type des donnes du package qu'il faut afficher. La fonction "CreatePackageBrowserEx" permet le passage d'un ProgID la place d'un flag.
Syntaxe
HWND CreatePackageBrowser (int x, int y, DWORD flags, char* Name ) HWND CreatePackageBrowserEx (int x, int y, char* ProgID, char* Name )
Paramtres
Paramtres int x int y DWORD flags char* ProgID Description Valeur de x. Valeur de y. Actuellement seul PB_PICTURE est utilisable. Active la slection de vue. ID programm pour le composant par lequel la slection est construite. La slection de vue est active par le passage de "WinCC.CCFileASOStub.1". Contient le nom. Ce nom peut avoir une valeur par dfaut. Le contenu de ce champ est toujours affich.
char* Name
Valeur en retour
Valeur en retour HWND Nom Retourne la poigne de l'objet. Le tampon de saisie contient le nom
Objets complexes
76
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Le dialogue "Dfinir les options" de l'assistant de dmonstration affiche un champ de saisie avec bouton de recherche. Un clic sur le bouton de recherche ouvre le dialogue de slection de vue.
char* DynWizPicBrowserStatic = "Slectionnez une vue:"; char* DynWizPicBrowser = "Vue d'exemple";
... char g_szPicBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE) { ...
77
strcpy(g_szPicBrowser,DynWizPicBrowser);
First = FALSE; } ... ...

CreateStatic(0,50,DynWizPicBrowserStatic);
//Dialogue de slection de vue

hWnd = CreatePackageBrowser(0,65,PB_PICTURE,g_szPicBrowser); MoveWindow(hWnd,0,65,(rect.right-rect.left),21,TRUE); }
Objets complexes
78
CreateObjectBrowser
Le dialogue "Dfinir les options" affiche prs des coordonnes x,y un champ de saisie avec bouton de recherche. Vous pouvez y saisir un nom d'objet ou de proprit. Un clic sur le bouton de recherche ouvre le dialogue de slection. Vous pouvez chercher et slectionner dans le dialogue de slection un nom d'objet ou de proprit.
Syntaxe
HWND CreateObjectBrowser (int x, int y, char* Title, DWORD flags, char* ObjectName )
Paramtres
Paramtres int x int y char* title DWORD flags Description Valeur de x. Valeur de y. Etiquette du dialogue de slection. Deux flags diffrents peuvent tre transmis : OB_OBJECTS Affichage de tous les objets OB_PROPERTIES La slection des proprits est en outre propose. Tampon de saisie pour le nom de l'objet ou de la proprit. Le tampon de saisie peut tre paramtr avec une valeur par dfaut.
char* ObjectName
Valeur en retour
Valeur en retour HWND ObjectName Retourne la poigne de l'objet. Le tampon de saisie contient le nom d'objet ou de proprit.
79
Exemple
L'extrait ci-dessous du fichier "Demo.wnf" explique l'utilisation de cette fonction. Le dialogue "Dfinir les options" de l'assistant de dmonstration affiche un champ de saisie avec bouton de recherche. Un clic sur le bouton de recherche ouvre le dialogue de slection d'objet de fentre.
char* DynWizObjectBrowserStatic = "Slectionnez un objet:"; char* DynWizObjectBrowser = "Objet"; char* DynWizObject = "Slection d'objet de fentre"; ; ... char g_szObjectBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE)
Objets complexes
80
{ ... strcpy(g_szObjectBrowser,DynWizObjectBrowser); First = FALSE; } ... ...

CreateStatic(0,50, CreateStatic(0,140,DynWizObjectBrowserStatic););
//Dialogue de slection de fentre

hWnd = CreateObjectBrowser(0,155,DynWizObject,OB_OBJECTS,g_szObjectBrowser);
MoveWindow(hWnd,0,155,(rect.right-rect.left),21,TRUE); }
81
4.5.13
Fonctions Wizard pour la gnration de dynamiques

GenerateBLOB
La fonction GenerateBLOB (BLOB = Binary Large OBject) cre une action pouvant tre rattache une proprit d'un objet graphique. Une action comporte 3 parties. Prologue: C'est l'en-tte de la fonction C. Exemple: #include "apdefap.h" void OnLButtonDown(char* lpszPictureName,char* lpszObjectName,char* lpszPropertyName, UINT nFlags, int x, int y) { Le prologue dpend du trigger dclenchant l'action (dans l'exemple ci-dessus : clic gauche) Epilogue: est la fin de la fonction C; son seul constituant est '}' Corps: Cette partie contient la fonctionnalit de la fonction C. Exemple : ProgramExecute("notepad.exe"); La fonction gnre le code C de l'action et le compile. Le rsultat de la compilation est un code P. Ce code est interprt et excut par le Runtime WinCC. Aucun code P n'est gnr lorsque le code C est erron. La fonction gnre un BLOB o sont enregistres les parties de l'action (Code C, Code P et Dclenchement entre autres ...). Le BLOB doit tre supprim avant la fin de la fonction d'assistant dynamique. Pour de plus amples informations sur la suppression de la fonction BLOB, consultez "DeleteBLOB".
Syntaxe
AP_BLOB GenerateBLOB (char* Prolog, char* Epilog, char* Format, ... )
Objets complexes
82
Paramtres
Paramtres char* Prolog char* Epilog char* Format Description Prologue de l'action sous forme de chane de caractres ASCII. Epilogue de l'action sous forme de chane de caractres ASCII. Corps de l'action sous forme de chane de caractres ASCII ou chane de caractres de formatage selon la fonction standard "printf".
Remarque Le code C est gnr par la fonction C sprintf. Le paramtre est trait comme chane de caractres de formatage: des caractres de commande de formatage (p. ex.\ % ") sont exploits. S'ils doivent tre repris dans le code C (p. ex. comme chane de caractres de formatage pour un appel printf dans une action), un \ doit leur tre ajout. Exemple : \\ \ \% % " \"
Valeur en retour
Cette fonction retourne une variable structure du type AP_BLOB avec les champs de structure suivants
Champs de structure DWORD dwPCodeSize LPVOID lpPCode int nErrors int nWarnings Valeur en retour Longueur du code P cr en octets Pointeur vers le code P gnr Nombre d'erreurs du compilateur Nombre d'avertissements du compilateur
Exemple
L'extrait ci-dessous du fichier " Execute Programm.wnf" explique l'utilisation de cette fonction. La fonction d'assistant dynamique gnre un script C dmarrant une autre application (dans cet exemple: notepad.exe).
... ... void OnGenerate(void) { PCMN_ERROR pError; AP_BLOB *blob; char code[500];
83
char sError[500]; .. Slash2DblSlash(g_Bild, strlen(g_Bild)); .. sprintf(code,"%sProgramExecute(\"%s\");",ifcode,g_Bild); ..
//Prologue
blob = GenerateBLOB("#include \"apdefap.h\"\r\n" "void OnClick(char* lpszPictureName," "char*lpszObjectName,char* lpszPropertyName," "UINT nFlags,int x, int y) {",
//Epilogue
"}",
//Corps
code);
BEGIN_JCR_BLOBERRORS
SetAction(NULL, blob, g_Trigger);
END_JCR_BLOBERRORS
DeleteBLOB(blob); }
Script C gnr:
#include "apdefap.h" void OnLButtonDown(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName, UINT nFlags, int x, int y) { ProgramExecute("notepad.exe"); }
Objets complexes
84
DeleteBLOB
La fonction GenerateBLOB gnre un BLOB. Le BLOB doit tre supprim avant la fin de la fonction d'assistant dynamique. La fonction DeleteBLOB supprime le BLOB.
Syntaxe
void DeleteBLOB (AP_BLOB* blob)
Paramtres
Paramtres AP_BLOB* blob Description Pointeur vers la variable de rsultat de la fonction "GenerateBLOB".
Exemple
DeleteBLOB(blob);
85
SetAction
Une action est rattache l'objet graphique slectionn pour le dclenchement paramtr. Si le trigger est un vnement, il est fourni directement comme paramtre d'appel de fonction. Si le trigger est la dynamisation d'une proprit, vous devez saisir d'abord le dclenchement dans le BLOB avec la fonction AddVarTrigger ou avec AddTimeTrigger. Remarque Si l'action ne doit pas tre rattache l'objet slectionn mais un autre objet, vous devez utiliser la fonction API PDLCSSetAction. Pour de plus amples informations sur la fonction PDLCSSetAction, consultez le manuel WinCC ODK.
Syntaxe
BOOL SetAction (char* Property, AP_BLOB* Blob, DWORD Trigger )
Paramtres
Paramtres char* Property Description Nom de la proprit. Toujours utiliser le nom anglais de la proprit. Pour un trigger li un vnement, vous devez passer un pointeur NULL. Pointeur vers la variable de rsultat de la fonction "GenerateBLOB". ID du dclenchement: NOTDEFINED = le trigger est enregistr dans le BLOB MOUSECLICK = clic MOUSELBUTTONDOWN = appui bouton g. MOUSELBUTTONUP = relcher bouton g. MOUSERBUTTONDOWN = appui bouton dr. MOUSERBUTTONUP = relcher bouton dr. KEYBOARDDOWN = appuyer touche clavier KEYBOARDUP = relcher touche clavier OBJECTCHANGE = changement objet PROPERTYCHANGE = changement de la proprit PICTUREOPEN = slection de vue PICTURECLOSE = Annulation vue
AP_BLOB* Blob DWORD TriggerID
Valeur en retour
Valeur en retour BOOL Returnwert TRUE = Fonction correctement excute. FALSE = Fonction ayant chou.
Objets complexes
86
AddTimeTrigger
Cette fonction ajoute l'action un trigger du type "Trigger cyclique".
Syntaxe
BOOL AddVarTriggerEx (AP_BLOB* Blob, char* EventName, charVarName, DWORD CycleID )
Paramtres
Paramtres AP_BLOB* Blob char* Name Description Pointeur vers la variable de rsultat de la fonction "GenerateBLOB". Nom de l'vnement. Chane de caractres ASCII quelconque. Le nom est affich comme nom d'vnement dans la fentre de l'action. Type du dclenchement cyclique : 2 = Cycle (standard) 4 = Cycle objet graphique Type du cycle de l'objet graphique : 0= Cycle de fentre 1 = Cycle de vue Cycle de dclenchement : 0 = Sur modification 1 = 250 ms 2 = 500 ms 3=1s 4=2s 5=5s 6 = 10 s 7 = 1 min 8 = 5 min 9 = 10 min 10 = 1 h 11 = Cycle utilisateur 1 12 = Cycle utilisateur 2 13 = Cycle utilisateur 3 14 = Cycle utilisateur 4 15 = Cycle utilisateur 5
DWORD TriggerType
DWORD GraphCycleType
DWORD CycleID
Valeur en retour
Valeur en retour BOOL TRUE = Fonction correctement excute. FALSE = Fonction ayant chou.
87
Exemple
Le temps qui s'coule entre deux dclenchements d'une action est 1s.
BOOL FctRet; .. FctRet = AddTimeTrigger(blob, "1 sec", 2, 0, 3);
Objets complexes
88
AddVarTrigger /AddVarTriggerEx
Cette fonction ajoute l'action un trigger du type "Trigger variable(s)".
Syntaxe
BOOL AddVarTrigger (AP_BLOB* Blob, char* EventName, char* VarName ) BOOL AddVarTriggerEx (AP_BLOB* Blob, char* EventName, char* VarName, DWORD CycleID )
Paramtres
Paramtres AP_BLOB* Blob char* EventName Description Pointeur vers la variable de rsultat de la fonction "GenerateBLOB". Nom de l'vnement. Chane de caractres ASCII quelconque. Le nom est affich comme nom d'vnement dans la fentre de l'action. Nom de la variable WinCC qui dclenche l'action ou qui participe son dclenchement. Cycle de dclenchement : 0 = Sur modification 1 = 250 ms 2 = 500 ms 3=1s 4=2s 5=5s 6 = 10 s 7 = 1 min 8 = 5 min 9 = 10 min 10 = 1 h 11 = Cycle utilisateur 1 12 = Cycle utilisateur 2 13 = Cycle utilisateur 3 14 = Cycle utilisateur 4 15 = Cycle utilisateur 5 Avec la fonction AddVarTrigger, la valeur CycleID = 4 est paramtre par dfaut.
char* VarName DWORD CycleID
Valeur en retour
89
Exemple
Vous avez saisi pour le type de dclenchement "Variable" la variable 'StartTurbine1'. L'action est dclenche ds que la valeur d'une de ces variables est modifie.
BOOL FctRet
FctRet = AddVarTriggerEx(blob,"Turbine Start","StartTurbine1",0);
Objets complexes
90
SetValidateFct
Cette fonction communique le nom d'une fonction de contrle l'assistant dynamique. La fonction de contrle permet de vrifier les paramtres d'options et de triggers . Si le rsultat du contrle est ngatif, une nouvelle saisie peut tre initie. La fonction de contrle est appele lorsque vous cliquez sur le bouton "Suivant" dans les dialogues "Dfinir les options" ou "Slectionner un dclencheur". Si le rsultat du contrle est positif, vous quittez le dialogue et la page suivante est affiche. Le dialogue reste affich lorsque le rsultat du contrle est ngatif. Vous ne pouvez poursuivre qu'aprs avoir saisi les bons paramtres. La fonction de contrle est active partir du moment o elle est active dans l'assistant dynamique. Elle reste alors active pour les pages de slection d'options suivantes. Si aucune action de contrle ou une autre action de contrle doit tre active, il faut qu'une fonction fantme (dummy) rsultat de contrle positif ou une autre fonction de contrle soit active.
Syntaxe
BOOL SetValidateFct (LPCSTR FctName)
Paramtres
Paramtres LPCSTR FctName Description Nom de la fonction de contrle sous forme de chane de caractres ASCII.
Valeur en retour
Valeur en retour BOOL Rsultat du contrle TRUE = Rsultat de test positif. FALSE = Rsultat de test ngatif.
Exemple
L'extrait suivant du fichier " Instanzobjekt.wnf" montre l'utilisation de cette fonction. Une fonction de contrle a t ajoute la fonction d'assistant dynamique.
... ...
// Validation option 1
91
BOOL ValidateOpt1(void) {
// Proprit slectionne
return (strcmp(g_NewInst, "")); }
void OnOption1(void) { HWND hWnd; RECT rect; DM_VARFILTERdmFilter = {DM_VARFILTER_TYPE, 1, NULL, NULL, NULL, NULL };
SetValidateFct("ValidateOpt1"); sprintf(g_NewInst, ""); .. }
Objets complexes
92
EnumProperty/EnumPropertyEx
La fonction EnumProperty numre les proprits d'un objet. La fonction EnumPorpertyEx permet de spcifier les proprits d'objet lister.
Syntaxe
BOOL EnumProperty (char* FName, LPVOID pItem, DWORD dwFlags ); BOOL EnumPropertyEx (LPCTSTR Projectname, LPCTSTR Picturename, LPCTSTR Objectname, char* FName, LPVOID pItem, DWORd dwFlags );
Paramtres
Paramtres LPCTSTR Projectname LPCTSTR Picturename LPCTSTR Objectname char* FName LPVOID pItem Description Pointeur vers le nom du projet, avec nom du rpertoire et extension de fichier. Pointeur vers le nom de la vue dont les objets doivent tre lists. La discrimination entre majuscules et minuscules est faite. Pointeur vers le nom de l'objet Nom de votre fonction Callback appele une fois pour chaque proprit d'objet. Pointeur vers donnes spcifiques l'application qui sera pass la fonction Callback. Ce pointeur n'est pas interprt par la fonction, mais remis disposition dans la fonction Callback. dwFlags spcifie les types de proprits lister. Les types actuellement possibles sont : PropertyHasDynamic (Valeur : 0x0001) Seules sont numres les proprits d'objet qui possdent une dynamisation. PropertyHasEvents (Valeur: 0x0002) Seules sont numres les proprits d'objet qui possdent un vnement. PropertyIsDynamicable (Valeur : 0x0003) seules sont numres les proprits d'objet qui sont dynamisables.
DWORD dwFlags
Valeur en retour
Valeur en retour BOOL TRUE = proprits d'objet d'un type d'objets, listes FALSE = Erreur
93
Exemple
L'extrait suivant du fichier "Dynamic Property.wnf" montre l'utilisation de cette fonction.
... ... // Fonction Callback BOOL EnumFct(char *property, VARTYPE vt, LPVOID pItem) { sprintf(g_prop[SendMessage((HWND)pItem,LB_INSERTSTRING,(WPARAM)1,(LPARAM)property)],property); return TRUE; }
void OnOption1(void) { HWND hWnd,LBHwnd; RECT rect; static BOOL bFirst = TRUE;
if(bFirst) { ... } ...
CreateStatic(0, 10,"Proprits de l'objet actuel:"); LBHwnd=CreateListbox(0, 30, g_Headline, 8, &g_indexProperty); EnumProperty("EnumFct", LBHwnd, 3); GetWindowRect(GetParent(LBHwnd), &rect); ...
Objets complexes
94
4.5.14
Fonctions WinCC Wizard

GetProjectName
Dtermination du chemin du projet WinCC actuel.
Syntaxe
LPCSTR GetProjectName ( void )
Valeur en retour
Valeur en retour LPCSTR Pointeur vers la chane de caractres ASCII du fichier MCP
Exemple
LPCSTR Name; Name = GetProjectName(); La fonction retourne p. e.x le rsultat suivant: C:\Siemens\WinCC\WinCCProjects\Example.mcp
95
4.5.14.2 Description
GetPictureName
Dtermination du nom de la vue actuelle (*.pdl).
Syntaxe
LPCSTR GetPictureName ( void )
Valeur en retour
Valeur en retour LPCSTR Pointeur vers la chane de caractres ASCII du fichier PDL
Exemple
LPCSTR Name; Name = GetPictureName(); La fonction retourne p. e.x le rsultat suivant: TurbineControl.PDL
GetDefaultWNFPath
Dtermination du chemin du rpertoire WNF actuel.
Syntaxe
LPCSTR GetDefaultWNFPath ( void )
Valeur en retour
Valeur en retour LPCSTR Pointeur vers la chane de caractres ASCII du nom du chemin
Exemple
LPCSTR Name; Name = GetDefaultWNFPath(); La fonction retourne p. e.x le rsultat suivant: C:\Siemens\WinCC\wscripts\wscripts.deu\
Objets complexes
96
GetObjectName
Dtermination du nom de l'objet graphique slectionn dans la vue courante.
Syntaxe
LPCSTR GetObjectName ( void )
Valeur en retour
Valeur en retour LPCSTR Pointeur vers la chane de caractres ASCII du nom d'objet
Exemple
LPCSTR Name; Name = GetObjectName(); La fonction retourne p. e.x le rsultat suivant: Button1
InsertXRefSection
Cette fonction insre une section dans le code source transmis, conformment la notation Xref, de sorte que les variables et noms de vue transmis sont programms comme Define.
Syntaxe
BOOL InsertXRefSection (char * SourceCode, char* TagName[], int TagCount, char* PictName[], int PictCount)
Paramtres
Paramtres char *SourceCode char *TagName[] int TagCount char *PictName[] int PictCount Description Tampon de code dans lequel la section Xref est insre NULL ou tableau de noms de variable insr dans la section Xref. Nombre de noms de variables dans le tableau TagName[] NULL ou tableau de noms de vue insr dans la section Xref Nombre de noms de vues dans le tableau PictName[]
97
Valeur en retour
Valeur en retour BOOL char *TagName[] char *PictName[] La valeur du rsultat indique si la fonction a t excute avec succs. Tableau des Defines pour les variables transmises au mme endroit du programme Tableau des Defines pour les vues transmises au mme endroit du programme
Exemple
char* szPictureArray[1]; char szPictName[255]; char szSourceCode[1100]; strcpy(szPictName, "Newpdl.pdl"); szPictureArray[0] = szPictName; strcpy(szSourceCode, ""); InsertXrefSection(szSourceCode,NULL,0,szPictureArray,1); Le rsultat ci-dessous est retourn par la fonction: szSourceCode: // WINCC:TAGNAME_SECTION_START // syntax: #define TagNameInAction "DMTagName" // next TagID : 1 // WINCC:TAGNAME_SECTION_END // WINCC:PICNAME_SECTION_START // syntax: #define PicNameInAction "PictureName" // next PicID : 1 #define PIC_0 " Newpdl.Pdl" // WINCC:PICNAME_SECTION_END szPictureArray[0]: "PIC_0"
Objets complexes
98
4.5.15
Fonction de progression Wizard

Fonction de progression Wizard
Ces fonctions affichent en % la progression d'une action dans une "bote de progression".
Lors de la cration de la bote de progression (CreateProgressDlg) une valeur de dbut, une valeur de fin d'action et un incrment sont donns. La valeur de dbut d'action est 0%, la valeur de fin d'action est 100%. L'incrment dfinit le pas de la progression affiche. La valeur de dbut est en gnral = 0 et l'incrment = 1. La valeur de fin est le nombre d'tapes que compte l'opration. Au cours de la procdure la progression est augmente d'un incrment (Progress_StepIt) ou prend une valeur dfinie (Progress_SetPos). A la fin de l'excution de l'action l'affichage de progression doit tre supprim (DestroyProgressDlg). La bote de progression peut afficher un texte (Progress_SetStatus), p. ex. "Cration des objets graphiques". Ce texte peut aussi tre modifi pendant l'excution de l'action pour permettre de suivre la progression de parties de l'action. En gnral il n'est pas possible de diviser l'action de manire obtenir un affichage linaire de la progression. Ceci n'est pas ncessaire non plus. L'affichage que l'excution de l'action progresse est suffisant.
99
CreateProgressDlg
Un affichage de progression affiche la progression d'une action entre 0 et 100%.
Syntaxe
PROGRESS_DLG CreateProgessDlg (int nLower, int nUpper, int nStepInc )
Paramtres
Paramtres int nLower int nUpper int nStepInc Description Valeur de dbut de l'affichage de progression (correspond 0 %) Valeur de fin de l'affichage de progression (correspond 100 %) Incrment de progression
Valeur en retour
Valeur en retour PROGRESS_DLG poigne de l'objet
Progress_SetStatus
Un texte est affich comme tiquette dans l'affichage de progression.
Syntaxe
void Progress_SetStatus (PROGRESS_DLG hDlg, char* ActionName )
Paramtres
Paramtres PROGRESS_DLG hDlg char* ActionName Description poigne de l'objet Texte de l'tiquette
Objets complexes
100
Progress_Steplt
La progression de l'action excute est augmente d'un incrment.
Syntaxe
void Progress_Steplt (PROGRESS_DLG hDlg )
Paramtres
Paramtres PROGRESS_DLG hDlg Description poigne de l'objet
Progress_SetPos
Une valeur dfinie est affecte la progression dans l'affichage de progression. Cette valeur doit tre comprise entre la valeur de dbut et la valeur de fin de l'action.
Syntaxe
void Progress_SetPos (PROGRESS_DLG hDlg, int nPos )
Paramtres
Paramtres PROGRESS_DLG hDlg int nPos Description poigne de l'objet Valeur de la progression
101
DestroyProgressDlg
Fermeture de l'affichage de progression.
Syntaxe
void DestroyProgressDlg (PROGRESS_DLG hDlg )
Paramtres
Paramtres PROGRESS_DLG hDlg Description poigne de l'objet
4.5.16
Fonctions Windows Wizard

Fonctions Windows Wizard
Ci-aprs une description sommaire de fonctions Windows devant ou pouvant tre utilises en liaison avec les fonctions systme d'assistant dynamique (notamment avec les fonctions de fentres pour la saisie de paramtres). Pour de plus amples informations, consultez Microsoft Developers Studio /Win32 SDK Programmers Reference.
Objets complexes
102
GetParent
La poigne de la fentre parente d'une fentre donne est dtermine, p. ex. de la fentre d'options.
Syntaxe
HWND GetParent (HWND hWnd )
Paramtres
Paramtres HWND hWnd Description poigne de la fentre pour laquelle la fentre parente doit tre dtermine.
Valeur en retour
Valeur en retour HWND poigne de la fentre parente NULL = il n'existe pas de fentre parente.
103
GetWindowRect
Le programme dtermine la taille et les coordonnes d'une fentre, p. ex. de la fentre d'options.
Syntaxe
BOOL GetWindowRect (HWND hWnd, LPRECT lpRect )
Paramtres
Paramtres HWND hWnd LPRECT lpRect Description poigne de la fentre Pointeur vers une variable structure de rsultat
Valeur en retour
Valeur en retour BOOL LPRECT lpRect TRUE = Fonction correctement excute. FALSE = Fonction ayant chou. Variable structure de rsultat LPRECT avec les champs de structure: LONG left: Abscisse du coin suprieur gauche LONG top: Ordonne du coin suprieur gauche LONG right: Abscisse du coin infrieur droit LONG bottom: Ordonne du coin infrieur droit
Objets complexes
104
MoveWindow
Cette fonction sert modifier des positions et des dimensions dans une fentre, p. ex. des champs de saisie dans la fentre d'options.
Syntaxe
BOOL MoveWindow (HWND hWnd, int x, int y, int nWidth, int nHeight, BOOL bRepaint )
Paramtres
Paramtres HWND hWnd int x int y, int nWidth int nHeight BOOL bRepaint Description poigne de la fentre Abscisse du coin suprieur gauche Ordonne du coin suprieur gauche Largeur Hauteur TRUE = la fentre est redessine.
Valeur en retour
105
SendMessage
Cette fonction envoie un message une fentre. Cette fonction est p. ex. utilise pour remplir un champ de slection.
Syntaxe
LRESULT SendMessage (HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam )
Paramtres
Paramtres HWND hWnd UINT Msg, WPARAM wParam LPARAM lParam Description poigne de la fentre Type de message : LB_INSERTSTRING = Insrer un texte dans un champ de liste 1. Paramtres du message : -1 = Le texte est ajout la fin. 2. Paramtres du message : Pointeur sur le texte
Valeur en retour
Valeur en retour LRESULT poigne de l'objet
Objets complexes
106
GetWindow
La fonction dtermine la poigne de la fentre qui est lie par une relation dfinie une fentre (d'origine).
Syntaxe
GetWindow (HWND hWnd, UINT uCmd )
Paramtres
Paramtres HWND hWnd UINT uCmd Description Poigne de la fentre d'origine Relation GW_HWNDFIRST = fentre la plus en haut
Valeur en retour
Valeur en retour HWND Poigne de la fentre trouve ou NULL
107
ShowWindow
Cette fonction dtermine l'tat d'affichage d'une fentre.
Syntaxe
ShowWindow (HWND hWnd, int nCmdShow )
Paramtres
Paramtres HWND hWnd int nCmdShow Description poigne de la fentre Etat d'affichage de la fentre SW_HIDE = cach
Valeur en retour
Valeur en retour BOOL TRUE = la fentre tait visible FALSE = la fentre n'tait pas visible
Objets complexes
108
MessageBox
Cette fonction sert afficher un message envoy l'utilisateur lorsqu'une erreur est apparue ou qu'une intervention de l'utilisateur est ncessaire. L'alerte est affiche avec un message spcifique l'utilisateur, un titre et un bouton. IMPORTANT Le systme peut ne plus tre pilot lorsque la MessageBox se trouve en arrire-plan et ne peut tre ferme. Pour cette raison, mettez l'indicateur "MB_SYSTEMMODAL" un l'ouverture de la MessageBox.
Syntaxe
int MessageBox (HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption, UINT uType )
Paramtres
Paramtres HWND hWnd LPCTSTR lpText LPCTSTR lpCaption UINT uType Description Poigne de la fentre parente NULL = il n'existe pas de fentre parente. Texte du message Texte du titre MB_SYSTEMMODAL = empche un blocage du systme tant que la MessageBox est ouverte. Type de Box : MB_OK = Message avec bouton 'OK' MB_OKCANCEL = Message avec les boutons 'OK' et 'Annuler'
Valeur en retour
Valeur en retour int ID du bouton actionn : IDOK = Bouton 'OK' actionn IDCANCEL = Bouton 'Annuler' actionn
109
Exemple
int RetMsg; RetMsg = MessageBox (NULL, "Erreur l'appel des fonctions API", "Erreur systme", MB_SYSTEMMODAL | MB_OK) ;
Objets complexes
110
Dynamic Wizard Editor 4.6 Exemples
4.6
Exemples
4.6.1
Introduction
Exemples
Nous avons cr deux exemples de fonctions d'assistant dynamique : Dmo Wizard Dynamiser le moteur
4.6.2
Dmo Wizard
Dmo Wizard
Un assistant de dmonstration nomm "Demo Wizard" va tre cr dans le fichier "Demo.wnf" . Cet assistant dynamique prsente les fonctions de base mises la disposition de l'utilisateur pour une saisie confortable des donnes. L'assistant de dmonstration n'excute cependant aucune action.
4.6.2.2 Condition
Pour crer la fonction d'assistant dynamique pour l'assistant de dmonstration
Un projet WinCC doit tre ouvert.
Marche suivre
1. Dans l'Explorateur Windows, copiez le fichier "Demo.wnf", du rpertoire "Siemens\ WinCC\ documents\ german" vers le rpertoire "Siemens\ WinCC\ wscript\ wscript.deu". 2. Dmarrez Dynamic Wizard Editor. 3. Slectionnez dans le menu "Fichier" de Dynamic Wizard Editor la commande "Ouvrir" . Le dialogue de slection de fichier s'ouvre. 4. Marquez le fichier "Demo.wnf". Cliquez sur le bouton "Ouvrir". Le fichier "Demo.wnf" est affich dans une fentre d'dition. 5. Cliquez sur l'icne de la barre d'outils pour compiler le script. Le rsultat est affich dans la fentre d'affichage.
111
Pour crer le texte d'aide
Cette section cre un texte d'aide pour le dialogue " Slectionner un dclencheur".
Marche suivre
1. Cliquez sur l''icne de la barre d'outils. L'diteur de texte d'aide s'ouvre. 2. Slectionnez dans le champ "Groupe d'assistants" l'entre "Exemple". 3. Slectionnez dans le champ "Nom d'assistant" la commande "Demo Wizard". 4. Slectionnez dans le champ "Page" la commande "TriggerPage" 5. Saisissez dans le champ "Texte - Aide :" le texte suivant : "Slectionner un dclencheur Ce dialogue sert dfinir l'vnement qui dclenchera une action." 6. Fermez l'diteur de texte d'aide par "OK". Excutez l'assistant de dmonstration "Demo". Cliquez dans le dialogue "Slectionner un dclencheur" sur le bouton "Aide".
Objets complexes
112
Pour enregistrer le script "Demo.wnf" dans la base de donnes
Pour pouvoir utiliser la fonction d'assistant dynamique "Demo.wnf" dans Graphics Designer, vous devez l'avoir lie la base de donnes de l'assistant dynamique. Les tapes suivantes sont pour cela ncessaires: 1. Chargement du script d'assistant dynamique 2. Cration du fichier dwd
Marche suivre
1. Cliquez sur l''icne 3. Cliquez sur l'icne de la barre d'outils. Le dialogue de slection de fichier s'ouvre. de la barre d'outils pour recrer la base de donnes. 2. Slectionnez le fichier "Demo.wnf". Cliquez sur le bouton "Ouvrir".
Slectionnez dans le menu "Affichage" de Dynamic Wizard Editor la commande "Dynamic Wizard".
4. Cliquez sur l'onglet "Exemple". Double-cliquez sur "Demo Wizard".
113
4.6.3
Dynamiser le moteur
Dynamiser le moteur
Un assistant de dmonstration "Dynamisation de moteur" est cr dans le fichier "Motor.wnf" . Remarque Cet assistant a t cr spcialement pour dynamiser un objet utilisateur nomm "Motor" et ne peut tre appliqu aucun autre type d'objets.
4.6.3.2 Condition
Pour crer la fonction d'assistant dynamique pour le moteur
Un projet WinCC doit tre ouvert.
Marche suivre
1. Dans l'Explorateur Windows, ouvrez l'archive Winzip "Motor.zip" dans le rpertoire "Siemens\ WinCC\ documents\ german". 2. Extrayez le fichier "Motor.wnf" dans le rpertoire "..\WinCC\wscripts\wscripts.deu". 3. Extrayez le fichier "Motor_dyn.pdl" dans le rpertoire "..\WinCC\WinCCProjects\Name desWinCCProjekts\GraCs". 4. Dmarrez Dynamic Wizard Editor. 5. Slectionnez dans le menu "Fichier" de Dynamic Wizard Editor la commande "Ouvrir" . Le dialogue de slection de fichier s'ouvre. 6. Marquez le fichier "Motor.wnf". Cliquez sur le bouton "Ouvrir". Le fichier "Motor.wnf" est affich dans une fentre d'dition. 7. Cliquez sur l'icne de la barre d'outils pour compiler le script. Le rsultat est affich dans la fentre d'affichage.
Objets complexes
114
Pour enregistrer le script "Motor.wnf" dans la base de donnes
Pour pouvoir utiliser la fonction d'assistant dynamique "Motor.wnf" dans Graphics Designer, vous devez l'avoir lie la base de donnes de l'assistant dynamique. Les tapes suivantes sont pour cela ncessaires: 1. Chargement du script d'assistant dynamique 2. Cration du fichier dwd
Marche suivre
1. Cliquez sur l''icne 3. Cliquez sur l'icne de la barre d'outils. Le dialogue de slection de fichier s'ouvre. de la barre d'outils pour recrer la base de donnes. 2. Slectionnez le fichier "Motor.wnf". Cliquez sur le bouton "Ouvrir".
115
Pour dynamiser l'objet utilisateur "Moteur"
L'objet utilisateur "Moteur" est li par l'assistant dynamique "Dynamisation de moteur" une variable structure WinCC du type "MotorStruct". Diverses actions C et liaisons de variable sont alors cres pour cet objet. Cet assistant dynamique ne peut tre appliqu aucun autre type d'objets.
Condition
Crez une variable interne "T08i_course_wiz_selected" du type "Variable texte jeu de caractres 8 bits". Crez une structure nomme "MotorStruct" et les trois champs "Activ", "Hand" et "Error" du type de donnes BIT. Crez une variable "STR_Course_wiz1" du type de donnes "MotorStruct".
Marche suivre
1. Ouvrez Graphics Designer. Slectionnez dans le champ "Fichier" la commande "Ouvrir" Slectionnez dans le dialogue de slection de fichier la vue "Motor_dyn.pdl". Marquez l'objet utilisateur "Moteur". L'onglet "Exemple" propose l'assistant "Dynamisation de moteur".
2. Dmarrez l'assistant dynamique. Cliquez dans le dialogue "Bienvenue dans Dynamic Wizard" sur le bouton "Suivant". Le dialogue "Dfinir les options" 3. Dans le dialogue "Dfinir les options", cliquez sur le bouton de recherche. Le dialogue de slection de variable s'ouvre. Slection comme variable structure "STR_Course_wiz1". Fermez la bote de dialogue en cliquant sur le bouton "OK". 4. Dans le dialogue "Dfinir les options", cliquez sur le bouton "Suivant". Le dialogue "Termin !" s'ouvre. Fermez le dialogue par "Terminer". 5. Enregistrez la vue. Activez Graphics Designer Runtime. 6. Vous pouvez simuler avec les boutons les valeurs de variable du moteur slectionn.
Objets complexes
116
Pour crer la structure et la variable structure
Cette section explique comment configurer la structure "MotorStruc" et la variable structure "STR_Course_wiz1". Cette structure et la variable structure seront utilises dans l'exemple "Dynamisation de moteur".
Marche suivre
1. Slectionnez dans le menu contextuel "Types de structures" la commande "Nouveau". Le dialogue "Proprits de la structure" s'ouvre. 2. Renommez la structure en "MotorStruc". Cliquez sur le bouton "Nouvel lment" et crez une variable interne "Active" du type de donnes BIT. 3. Cliquez sur le bouton "Nouvel lment" et crez une variable interne "Hand" du type de donnes BIT. 4. Cliquez sur le bouton "Nouvel lment" et crez une variable interne "Error" du type de donnes BIT. Fermez la bote de dialogue en cliquant sur le bouton "OK". 5. Dans la fentre du navigateur, cliquez sur le "signe Plus" plac devant le symbole "Gestion des variables". Slectionnez dans le menu contextuel "Variables internes" la commande "Nouvelle variable". Crez une variable WinCC "STR_Course_wiz1" du type "MotorStruc".
117
Objets complexes
118
Documentation Viewer
5.1 WinCC Documentation Viewer
Abrg descriptif
Vous pouvez imprimer dans un fichier les travaux d'impression du systme de journal WinCC. Pour les gros volumes de donnes, un fichier est cr pour chaque page de journal. Ces fichiers peuvent tre affichs et imprims avec WinCC Documentation Viewer.
5.2
Installation de l'application WinCC Documentation Viewer

Le WinCC Documentation Viewer peut tre install de deux manires :
Marche suivre
1. Slectionnez lors du Setup de WinCC dans le dialogue "Programmes" l'entre "WinCC V7 complet". WinCC est alors install avec les SmartTools ainsi que le WinCC ConfigurationTool et le WinCC Archive ConfigurationTool. Dmarrez le WinCC Documentation Viewer par "SIMATIC > WinCC > Tools".

Vous pouvez galement installer l'application WinCC Documentation Viewer partir du DVD WinCC. 1. Passez sur le DVD WinCC au dossier "WinCC\InstData\Smarttools\Setup". 2. Cliquez deux fois sur le programme setup.exe. 3. Dans le dialogue "Composants", slectionnez l'entre "WinCC Documentation Viewer". 4. Cliquez sur le bouton "Suivant". Suivez ensuite les instructions apparaissant l'cran.
Remarque Si un projet WinCC est activ, vous pouvez visualiser et imprimer uniquement les fichiers emf. Si WinCC n'est pas active, l'application WinCC Documentation Viewer vous permet d'ouvrir et d'imprimer tous les fichiers emf.
119
Documentation Viewer 5.3 Description
5.3
Introduction
Description
Les travaux d'impression peuvent tre imprims dans un fichier. Pour les gros volumes de donnes, un fichier est cr pour chaque page de journal. Ces fichiers peuvent tre affichs et imprims avec WinCC Documentation Viewer. Remarque Lorsqu'un projet WinCC est dj activ lors du dmarrage de l'application WinCC Documentation Viewer, vous ne pouvez afficher et imprimer que les fichiers emf de ce projet WinCC. Si le projet WinCC est ouvert mais non activ au dmarrage du Viewer, ce dernier vous permet d'ouvrir et d'imprimer tous les fichiers emf. Le Viewer est dans tous les cas ferm si Runtime est dsactiv.
WinCC Documentation Viewer affiche trois zones. La barre de menu est affiche en haut de l'cran. Les commandes de menu sont expliques par l'aide en ligne. La barre d'outils se trouve sous la barre de menu. Les fonctions frquemment utilises, telles que "Prcdent" et "Suivant", sont enregistres sous forme d'icnes. La fonction des diverses icnes est explique par l'aide en ligne. Le document actuel est affich dans la fentre. La fentre d'affichage a deux valeurs de zoom slectionnables par clic de souris. L'cran est limit en bas par la barre d'tat, dans laquelle sont affiches des informations sur la manipulation actuelle.
Objets complexes
120
Documentation Viewer 5.4 Gnration des fichiers .emf
5.4
Introduction
Gnration des fichiers .emf
Les travaux d'impression peuvent tre imprims dans un fichier. Pour les gros volumes de donnes, un fichier est cr pour chaque page de journal. L'impression se fait dans un ou plusieurs fichiers .emf. Les fichiers sont enregistrs sous le nom Page<nnnnnn>.emf dans le chemin, <nnnnn> reprsentant un numro de srie de cinq chiffres. Le nom du chemin se compose des lments suivants: le chemin de projet (p. ex. "C:\VFSWinCC\PRT\") et <Chemin d'enregistrement> + <JJJJMMTTHHMM> (JJJJ = anne, MM = Mois, TT = jour, HH = heure, MM = minute). Si vous entrez "DonnesPD" dans le champ "Chemin d'enregistrement", la structure de chemin suivante est cre pour le travail d'impression dans le rpertoire de projets.
Marche suivre
1. Dans les diteurs WinCC, slectionnez dans le menu "Fichier", la commande "Paramtrer documentation projet". 2. Cliquez dans le dialogue "Proprits travail d'impression" sur l'onglet "Slectionner imprimante". 3. Activez, dans l'onglet "Slectionner imprimante", la case "Fichier (*.emf)". Si vous ne souhaitez pas l'impression immdiate sur l'imprimante, dsactivez la case "Imprimante". 4. Saisissez, dans le champ "Chemin d'enregistrement", le nom du chemin dans lequel le fichier doit tre enregistr. Fermez la bote de dialogue en cliquant sur le bouton "OK". 5. Slectionnez, dans le menu "Fichier", la commande de menu "Imprimer documentation de projet". L'impression se fait dans un ou plusieurs fichiers .emf. Les fichiers sont enregistrs sous le nom Page<nnnnnn>.emf dans le chemin, <nnnnn> reprsentant un numro de srie de cinq chiffres.
121
Documentation Viewer 5.4 Gnration des fichiers .emf
Objets complexes
122
WinCC CrossReferenceAssistant
6.1 WinCC CrossReferenceAssistant
Abrg descriptif
WinCC CrossReferenzAssistant est un outil recherchant dans les scripts les noms de vues et de variables pour complter les scripts en question, de faon ce que le composant WinCC Cross Reference trouve les noms de vue et de variable et les consigne dans la liste des rfrences croises.
6.2
Installant de CrossReferenceAssistant
L'assistant WinCC CrossReferenceAssistant existe avec interface utilisateur en allemand, anglais et franais.
Marche suivre
1. Slectionnez lors du Setup de WinCC dans le dialogue "Programmes" l'entre "WinCC V7 complet". WinCC est alors install avec les SmartTools ainsi que le WinCC ConfigurationTool et le WinCC Archive ConfigurationTool. Dmarrez l'assistant WinCC CrossReferenceAssistant par "SIMATIC > WinCC > Tools".

Vous pouvez galement installer l'assistant WinCC CrossReferenceAssistant partir du DVD WinCC. 1. Passez sur le DVD WinCC au dossier "WinCC\InstData\Smarttools\Setup". 2. Cliquez deux fois sur le programme setup.exe. 3. Dans le dialogue "Composants", slectionnez l'inscription "CrossReferenceAssistant". 4. Cliquez sur le bouton "Suivant". Suivez ensuite les instructions apparaissant l'cran.
123
WinCC CrossReferenceAssistant 6.3 Gnral
6.3
Gnral
WinCC permet de crer des listes de rfrences croises (CrossReference). Pour que les variables soient reconnues correctement dans les appels de fonction lors de la cration de ces listes, la consigne de configuration suivante a t ajoute WinCC : Pour pouvoir utiliser, rechercher et remplacer les noms de variables ou de vues utilises dans des actions C, il faut crire le script de la manire suivante : Tous les noms de variable et de vue utiliss doivent tre dclars dans deux sections au dbut du script. Vous ne devez inscrire aucune autre instruction dans les sections. Ces sections ont la structure suivante: // WINCC:TAGNAME_SECTION_START // syntax: #define TagNameInAction DMTagName // next TagID : 1 #define ApcVarName1 "VarName1" // WINCC:TAGNAME_SECTION_END // WINCC:PICNAME_SECTION_START // syntax: #define PicNameInAction PictureName // next PicID : 1 #define ApcBildname1 "Bildname1" #define ApcBildname2 "Bildname2" #define ApcBildname3 "Bildname3" // WINCC:PICNAME_SECTION_END Dans ce cas, les fonctions standard de lecture et d'criture des variables doivent toutefois tre appeles via les variables et vues dfinies. GetTagDWord (ApcVarName1); OpenPicture(ApcBildname1); SetPictureName( ApcBildname2, "Bildfenster1",ApcBildname3); Si vous ne la suivez pas, aucune liste de rfrence croise ne pourra tre cre, les rfrences des variables et des vues ne pouvant alors tre interprtes dans les scripts. A l'aide du WinCC CrossReferenceAssistant, tous les appels de fonctions dj connus de la gestion de scripts sont remplacs par la forme dcrite ci-dessus. Seules sont converties les fonctions de projet, les vues et les actions. Pour le WinCC CrossReferenceAssistant, WinCC reprsente l'environnement pour ce qui concerne le temps d'excution. Si WinCC n'est pas dmarr ou si le projet convertir n'est pas charg, WinCC CrossReferenceAssistant charge WinCC et (ou) provoque le chargement du projet.
Objets complexes
124
WinCC CrossReferenceAssistant 6.4 Fonctions connues (gestion des scripts)
6.4
Fonctions connues (gestion des scripts)

Les fonctions suivantes sont connues par dfaut de l'assistant dynamique et sont adaptes par la conversion:
Fonctions utilisant des variables comme paramtres:

GetTagBit() GetTagByte() GetTagChar() GetTagDouble() GetTagDWord() GetTagFloat() GetTagRaw() GetTagSByte() GetTagSDWord() GetTagSWord() GetTagWord() SetTagBit() SetTagByte() SetTagChar() SetTagDouble() SetTagDWord() SetTagFloat() SetTagRaw() SetTagSByte() SetTagSDWord() SetTagSWord() SetTagWord() GetTagBitWait() GetTagByteWait() GetTagCharWait() GetTagDoubleWait() GetTagDWordWait() GetTagFloatWait()
125

GetTagRawWait() GetTagSByteWait() GetTagSDWordWait() GetTagSWordWait() GetTagWordWait() SetTagBitWait() SetTagByteWait() SetTagCharWait() SetTagDoubleWait() SetTagDWordWait() SetTagFloatWait() SetTagRawWait() SetTagSByteWait() SetTagSDWordWait() SetTagSWordWait() SetTagWordWait() GetTagBitState() GetTagByteState() GetTagCharState() GetTagDoubleState() GetTagDWordState() GetTagFloatState() GetTagRawState() GetTagSByteState() GetTagSDWordState() GetTagSWordState() GetTagWordState() SetTagBitState() SetTagByteState() SetTagCharState() SetTagDoubleState() SetTagDWordState()
Objets complexes
126

SetTagFloatState() SetTagRawState() SetTagSByteState() SetTagSDWordState() SetTagSWordState() SetTagWordState() GetTagBitStateWait() GetTagByteStateWait() GetTagCharStateWait() GetTagDoubleStateWait() GetTagDWordStateWait() GetTagFloatStateWait() GetTagRawStateWait() GetTagSByteStateWait() GetTagSDWordStateWait() GetTagSWordStateWait() GetTagWordStateWait() SetTagBitStateWait() SetTagByteStateWait() SetTagCharStateWait() SetTagDoubleStateWait() SetTagDWordStateWait() SetTagFloatStateWait() SetTagRawStateWait() SetTagSByteStateWait() SetTagSDWordStateWait() SetTagSWordStateWait() SetTagWordStateWait()
127
Fonctions utilisant des noms de vue comme paramtres:

SetPictureName() GetPictureName GetVisible() SetVisible() GetLink() SetLink() Set_Focus() OpenPicture() GetLinkedVariable()
Objets complexes
128
WinCC CrossReferenceAssistant 6.5 Slection de projet
6.5
Slection de projet
Un clic sur le bouton "..." provoque l'ouverture d'un dialogue OpenFile qui permet de slectionner un projet quelconque. Aprs un clic sur Projet actuel", WinCC CrossReferenceAssistant essaie de lire et d'afficher le projet actuellement charg dans WinCC. Si WinCC n'est pas dmarr ou si aucun projet n'est charg, WinCC est dmarr ou le projet est charg. Si un autre projet a dj t charg sans avoir t activ, il est ferm et le projet souhait est ouvert. Ceci peut parfois prendre un certain temps. Ds qu'un texte a t saisi sur la ligne d'entre suite l'instruction "Slectionnez un projet WinCC :" il est possible de cliquer sur le bouton "Suivant >". Le systme vrifie si le projet indiqu est bien un projet WinCC valide. Si ce n'est pas le cas, le focus se place sur la ligne de saisie et une bote de message signalant l'erreur est affiche. "La commande Annuler" permet de quitter WinCC CrossReferenceAssistant
129
WinCC CrossReferenceAssistant 6.6 Slection de fichier
6.6
Slection de fichier
Toutes les vues, fonctions de projet et actions C appartenant au projet sont affiches dans la liste de droite du dialogue. Avec le paramtrage par dfaut tous les fichiers du projet sont convertis.
L'utilisateur peut choisir d'exclure certains fichiers de la conversion pour les convertir ou non plus tard. Pour supprimer des fichiers de la liste de conversion, slectionnez (en plusieurs fois) les fichiers correspondants dans la liste "Fichiers convertir" puis cliquez sur le bouton "<--Supprimer". Les fichiers supprims sont affichs dans la liste de gauche et peuvent tre rintgrs dans la liste des fichiers convertir. Vous devez pour cela slectionner ces fichiers dans la liste "Slectionner les fichiers". Cliquez ensuite sur le bouton "Ajouter-->" pour les rintgrer dans la liste de droite des "Fichiers convertir". La slection des fichiers termine, cliquez sur "Suivant >". Tous les fichiers slectionns sont alors lus et analyss. < Prcdent ramne la slection de projet, "Annuler" permet de quitter WinCC CrossReferenceAssistant.
Objets complexes
130
WinCC CrossReferenceAssistant 6.7 Conversion
6.7
Introduction
Conversion
La dernire page affiche par l'assistant permet d'une part de dfinir des "Paramtrages avancs" (voir Paramtrages avancs) et d'autre part de suivre la progression et le fichier aprs le lancement de la conversion.
Description
"< Prcdent" ramne la slection de fichier, "Annuler" permet de quitter WinCC CrossReferenceAssistant. Cliquez sur "Terminer" pour lancer la conversion de script. Une fois que la conversion est lance, vous ne pouvez ni revenir en arrire avec ("< Prcdent") ni cliquer sur "Paramtres avancs". Pendant la conversion, une barre de progression affiche le pourcentage de la conversion effectu. Vous pouvez en outre voir quel fichier est en cours de conversion. Prcdez comme suit pour la conversion : Les appels de fonction requrant des paramtres de vue ou de variable sont recherchs dans les scripts. Lorsqu'une telle fonction est trouve dans le script, la chane de caractres transmise comme paramtre est remplace par un Define (voir Guide de configuration). Un fichier de gestion de scripts contrle quelles fonctions attendent des paramtres de vue ou de variable. C'est pourquoi toutes ces fonctions doivent tre crites dans ce fichier pour tre connues du systme. La liste de ces fonctions peut tre tendue, via la conversion de scripts, pour inclure des fonctions de projet et des fonctions standard attendant galement des paramtres de vue ou de variable ( Paramtrages avancs). Lorsque la conversion est termine, un rsum indique le nombre de fonctions, de vues et de scripts trouvs dans des vues et le nombre de variables qui ont t converties. Si une erreur est apparue, vous pouvez obtenir des informations plus prcises sur sa cause en consultant le fichier log cr pendant la conversion. Ce fichier se trouve dans le rpertoire de projet et s'appelle CCCrossReferenceAssistant.log.
131
WinCC CrossReferenceAssistant 6.8 Paramtres avancs
6.8
Paramtres avancs
Vous pouvez dclarer ici le cas chant les fonctions que vous avez cres vous-mme. Dans la liste "Slectionnez une fonction avec paramtres de variable ou de vue :" toutes les fonctions de projet s'affichent. Si vous cochez la case "Afficher fonctions standard", les fonctions standard contenues dans WinCC sont galement affiches.
L'utilisateur peut slectionner dans la liste des fonctions celles qui attendent en un endroit prcis du programme une variable ou une vue comme paramtre. Toutes les fonctions slectionnes ici sont crites dans un fichier de gestion de scripts spcifique au projet. CrossReferenceAssistant ne reconnat comme fonctions utilisant des paramtres de vue ou de variable que celles qui ont t dclares comme telles au systme. Afin de pouvoir adapter aussi les appels des fonctions dfinies par l'utilisateur qui attendent des paramtres de variable conformment aux consignes de configuration, vous devez les ajouter la gestion des scripts au cours de la conversion. Le champ de dialogue "Fonctions de la gestion des scripts" affiche toutes les fonctions qui ont dj t ajoutes la gestion des scripts. Lorsque vous affichez ce dialogue, le fichier de configuration standard et le fichier de configuration de projet sont lus et le contenu commun de ces deux fichiers est affich. Pour pouvoir maintenant reprer une fonction attendant un paramtre de variable ou de vue, il faut d'abord la slectionnez dans la zone de combinaison "Slectionnez une fonction avec paramtres de variable ou de vue:" . Vous pouvez ensuite dterminer l'aide d'une liste de paramtres si le paramtre particulier reprsente une variable ou une vue. Cliquer sur "..." pour ouvrir un menu contextuel permettant l'utilisateur de dterminer si le paramtre slectionn est une variable ou une vue. Cette procdure doit tre rpte pour tous les paramtres pour lesquels un des deux critres est satisfait. "Ajouter fonction -->" confirme la saisie et ajoute la fonction slectionne la liste affiche dans la partie droite du dialogue. Les saisies errones peuvent tre annules en slectionnant les fonctions supprimer dans la liste "Fonctions de la gestion de scripts" et en les effaant ensuite de la liste avec la commande "<-- Supprimer fonctions slectionnes". Un clic sur "Fermer" dclenche l'criture des informations runies dans les fichiers de configuration et la prise en compte des informations modifies lors de la conversion et de la fermeture du dialogue.
Objets complexes
132
WinCC Communication Configurator
Le WinCC Communication Configurator (CCComunicationConfigurator.exe) est un outil qui permet de faciliter le paramtrage de la communication de WinCC selon le voisinage rseau disponible. L'utilisation du WinCC Communication Configurator s'avre toujours adquat quand aucun Ethernet LAN avec une vitesse de transmission de 100 Mbit/s n'est disponible. L'utilisation du Configurator est galement conseille lors d'instabilits sporadiques des liaisons dues des charges abondantes (comme par ex. lors d'un dfaut de liaison avec les serveurs de donnes, champs E/S sans valeur d'affichage). Le paramtrage par dfaut de la communication de WinCC est tel que celle-ci est trs ractive aux dfauts de communication, p. ex. pour signaler trs rapidement les dfauts apparus l'utilisateur ou pour garantir, dans le cas de postes client, un temps d'absence auprs du serveur redondant. Dans un rseau ayant des vitesses de transmission basses ou lors de charges abondantes du rseau ou de la CPU, cette ractivit influence la stabilit des liaisons logiques du rseau de WinCC, comme les temps de raction des mcanismes subordonns la surveillance de signe de vie ne peuvent plus rpondre aux dlais attendus. Le Communication Configurator adapte les paramtres de la communication aux diffrentes situations de faon trouver le meilleur compromis possible entre la ractivit aux dfauts et la stabilit des liaisons. Remarque Si le Communication Configurator est utilis, cette fonctionnalit doit tre applique aussi bien sur le client WinCC que sur le serveur WinCC. Le Communication Configurator modifie seulement le paramtrage de la communication WinCC, et non, par contre, le paramtrage des liaisons de communication du systme d'exploitation.
133
WinCC Communication Configurator
Champ / option 100 Mbit/s 10 Mbit/s 1 Mbit/s 0,1 Mbit/s
Description Applicable dans le cas d'un Ethernet LAN avec une vitesse de transmission de 100 Mbit/s (paramtrage par dfaut). Pour les Ethernet LAN avec une vitesse de transmission de 10 Mbit/s. Pour les rseaux avec une vitesse de transmission de 1 Mbit/s. Pour les rseaux ou liaisons de communication avec une vitesse de transmission de 0,1 Mbit/s. Ce paramtrage s'approprie aux liaisons via RNIS (MultiLink), RNIS et modem.
Case cocher Vrifie la liaison au client par le serveur. "Server Pings Client" Bouton de commande "Par dfaut" Rtablit le paramtre par dfaut "Ethernet LAN (100 Mbit/s)"
Remarque Nous recommandons d'utiliser les clients avec une vitesse de transmission d'au moins 128 Kbit/s.
Objets complexes
134
Index
I
Importation, 11, 13, 16 importer, 11, 13, 16 Incrment, 23, 26
.
.emf, 121
A
Amplitude, 26
N
Nom du fichier, 11 Nombres alatoires, 23, 26
C
Configurateur de communication, 133 Cross Reference, 123, 124
O
Offset, 26 Ordinateur cible, 14, 16 Oscillation, 23, 26
D
Dcrment, 23, 26 Dfileur, 23, 26 Dpassement, 26 Dynamic Wizard Editor, 29 Barre d'outils, 33 Editeur d'aide, 36 Fentre de sortie, 37 Fentre d'dition, 35 Installation, 31 Structure, 32
P
Page de journal, 120 Priode, 26 Priphrie process, 22 Proprits du travail d'impression, 121
S
Script, 124 Slection de fichier, 130 Slection de projet, 129 Seuil infrieur, 26 Seuil suprieur, 26 Simulateur, 21 Simulateur de variables, 21 Simulation, 21 sinus, 23 Structure, 38 Structure de donne, 16 Structure du fichier, 15 Systme de journalisation WinCC, 120
E
Exportation, 11, 13, 14, 16 exporter, 11
F
Fichier .emf, 121 Fichier ASCII, 13 Fonction Dynamic Wizard, 38 Fonction sinus, 26 Fonctions, 125
G
Gestion des scripts, 132
T
Test fonctionnel, 21 Travaux d'impression, 120
135
Index
Types de structures, 16
V
Valeur de consigne, 26 Valeur finale, 26 Valeur initiale, 26 Variables, 16 Variables de process, 22
W
WinCC CrossReferenceAssistant, 123, 124
Objets complexes
136

French Smart Tools

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

French Smart Tools

Uploaded by

Copyright:

Available Formats

 Objets complexes

1 ___________________ Vue d'ensemble

SIMATIC HMI WinCC V7.0 SP3 Objets complexes

Mentions lgales Mentions lgales Signaltique d'avertissement

Utilisation des produits Siemens conforme leur destination

Siemens AG Industry Sector Postfach 48 48 90026 NRNBERG ALLEMAGNE

Impression de l'aide en ligne 12/2011

Copyright Siemens AG 2011. Sous rserve de modifications techniques

Simulateur de variables ........................................................................................................................... 21

Dynamic Wizard Editor ............................................................................................................................ 29

Objets complexes Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne

Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne

Documentation Viewer........................................................................................................................... 119

WinCC CrossReferenceAssistant .......................................................................................................... 123

WinCC Communication Configurator ..................................................................................................... 133 Index...................................................................................................................................................... 135

Objets complexes Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne

Impression de l'aide en ligne, 12/2011, Impression de l'aide en ligne

Objets complexes 12/2011, Impression de l'aide en ligne

12/2011, Impression de l'aide en ligne

Objets complexes 12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.2 Installation de variables Exportation/importation

Installation de variables Exportation/importation

12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.3 Procdure

Objets complexes 12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.3 Procdure

12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.4 L'utilitaire Exportation/Importation de variables

L'utilitaire Exportation/Importation de variables

Objets complexes 12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.5 Liaisons

Exemple pour une liaison logique:

12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.6 Structures de fichiers

Nouvelle_Variable ... 1 Nouvelle_Variable ... 2 Nouvelle_Variable ... 3 etc. ...

Objets complexes 12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.7 Variable

Importation de variables d'un type dfini par l'utilisateur.

Exemple : Les types de structure sont exports dans le fichier [name]_dex.csv.

Les variables sont exportes dans le fichier [name]_vex.csv.

12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.7 Variable

Objets complexes 12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.8 Annexe

12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.8 Annexe

Objets complexes 12/2011, Impression de l'aide en ligne

Exportation/Importation de variables 2.8 Annexe

12/2011, Impression de l'aide en ligne

Objets complexes 12/2011, Impression de l'aide en ligne

Simulateur de variables 3.2 Utilisation du simulateur de variables

Utilisation du simulateur de variables

Simulation de la variable de process sans priphrie process

Simulation de la variable de process avec priphrie process connecte

12/2011, Impression de l'aide en ligne

Simulateur de variables 3.3 Fonctions du simulateur

Objets complexes 12/2011, Impression de l'aide en ligne

Simulateur de variables 3.4 Installation du simulateur

12/2011, Impression de l'aide en ligne

Simulateur de variables 3.5 Ajouter/supprimer des variables

Ajouter/supprimer des variables

Ajouter une nouvelle variable

Objets complexes 12/2011, Impression de l'aide en ligne

Objets complexes