@@smart Tools

Smart Tools
1 ___________________ Resumen
Exportacin/importacin de 2 ___________________ variables
SIMATIC HMI WinCC V7.0 SP3 Smart Tools

Impresin de la Ayuda online
3 ___________________ Simulador de variables 4 ___________________ Dynamic Wizard Editor
___________________ 5 Documentation Viewer

WinCC ___________________ 6 CrossReferenceAssistant WinCC Communication ___________________ 7 Configurator
12/2011
Notas jurdicas Notas jurdicas Filosofa en la sealizacin de advertencias y peligros

Este manual contiene las informaciones necesarias para la seguridad personal as como para la prevencin de daos materiales. Las informaciones para su seguridad personal estn resaltadas con un tringulo de advertencia; las informaciones para evitar nicamente daos materiales no llevan dicho tringulo. De acuerdo al grado de peligro las consignas se representan, de mayor a menor peligro, como sigue. PELIGRO Significa que, si no se adoptan las medidas preventivas adecuadas se producir la muerte, o bien lesiones corporales graves. ADVERTENCIA Significa que, si no se adoptan las medidas preventivas adecuadas puede producirse la muerte o bien lesiones corporales graves. PRECAUCIN con tringulo de advertencia significa que si no se adoptan las medidas preventivas adecuadas, pueden producirse lesiones corporales. PRECAUCIN sin tringulo de advertencia significa que si no se adoptan las medidas preventivas adecuadas, pueden producirse daos materiales. ATENCIN significa que puede producirse un resultado o estado no deseado si no se respeta la consigna de seguridad correspondiente. Si se dan varios niveles de peligro se usa siempre la consigna de seguridad ms estricta en cada caso. Si en una consigna de seguridad con tringulo de advertencia se alarma de posibles daos personales, la misma consigna puede contener tambin una advertencia sobre posibles daos materiales.
Personal cualificado
El producto/sistema tratado en esta documentacin slo deber ser manejado o manipulado por personal cualificado para la tarea encomendada y observando lo indicado en la documentacin correspondiente a la misma, particularmente las consignas de seguridad y advertencias en ella incluidas. Debido a su formacin y experiencia, el personal cualificado est en condiciones de reconocer riesgos resultantes del manejo o manipulacin de dichos productos/sistemas y de evitar posibles peligros.
Uso previsto o de los productos de Siemens

Considere lo siguiente: ADVERTENCIA Los productos de Siemens slo debern usarse para los casos de aplicacin previstos en el catlogo y la documentacin tcnica asociada. De usarse productos y componentes de terceros, stos debern haber sido recomendados u homologados por Siemens. El funcionamiento correcto y seguro de los productos exige que su transporte, almacenamiento, instalacin, montaje, manejo y mantenimiento hayan sido realizados de forma correcta. Es preciso respetar las condiciones ambientales permitidas. Tambin debern seguirse las indicaciones y advertencias que figuran en la documentacin asociada.
Marcas registradas
Todos los nombres marcados con son marcas registradas de Siemens AG. Los restantes nombres y designaciones contenidos en el presente documento pueden ser marcas registradas cuya utilizacin por terceros para sus propios fines puede violar los derechos de sus titulares.
Exencin de responsabilidad
Hemos comprobado la concordancia del contenido de esta publicacin con el hardware y el software descritos. Sin embargo, como es imposible excluir desviaciones, no podemos hacernos responsable de la plena concordancia. El contenido de esta publicacin se revisa peridicamente; si es necesario, las posibles las correcciones se incluyen en la siguiente edicin.
Siemens AG Industry Sector Postfach 48 48 90026 NRNBERG ALEMANIA
Impresin de la Ayuda online 12/2011
Copyright Siemens AG 2011. Sujeto a cambios sin previo aviso
ndice
1 2 Resumen ................................................................................................................................................... 7 Exportacin/importacin 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 Exportacin/importacin de variables............................................................................................9 Instalacin de Exportacin/Importacin de variables ....................................................................9 Manejo .........................................................................................................................................10 La herramienta "Exportacin/importacin de variables" ..............................................................12 Conexiones ..................................................................................................................................13 Estructuras de archivo .................................................................................................................14 Variable ........................................................................................................................................15 Anexo ...........................................................................................................................................17 El simulador de variables.............................................................................................................19 Aplicacin del simulador de variables..........................................................................................20 Funciones del simulador ..............................................................................................................21 Instalacin del simulador .............................................................................................................22 Agregar/borrar variables ..............................................................................................................23 Posibilidad de parametrizar funciones.........................................................................................24 Activar/desactivar variables .........................................................................................................25 Representacin de las variables..................................................................................................25 Cargar/guardar datos de simulacin............................................................................................25 FAQ..............................................................................................................................................26 Dynamic Wizard Editor ................................................................................................................27 Resumen......................................................................................................................................27 Instalacin del Dynamic Wizard Editor ........................................................................................29 Estructura.....................................................................................................................................30 Estructura.....................................................................................................................................30 Barra de herramientas .................................................................................................................31 Ventana de edicin ......................................................................................................................33 Editor de Ayuda ...........................................................................................................................34 Ventana de resultados .................................................................................................................35
Simulador de variables ............................................................................................................................ 19
Dynamic Wizard Editor ............................................................................................................................ 27
Smart Tools 12/2011, Impresin de la Ayuda en pantalla
ndice
4.5 Estructura de una funcin del Dynamic Wizard .......................................................................... 36 4.5.1 Estructura de una funcin del Dynamic Wizard .......................................................................... 36 4.5.2 Cuadro de dilogo del Dynamic Wizard...................................................................................... 36 4.5.3 Integracin de archivos de cabecera y DLLs.............................................................................. 37 4.5.4 Definiciones multilinges............................................................................................................. 38 4.5.5 Flags del Wizard ......................................................................................................................... 39 4.5.6 Lista de propiedades................................................................................................................... 40 4.5.7 Interfaz de sistema...................................................................................................................... 41 4.5.8 Variables globales....................................................................................................................... 42 4.5.9 Lista de opciones ........................................................................................................................ 43 4.5.10 Lista de triggers........................................................................................................................... 45 4.5.11 Visualizacin de la parametrizacin............................................................................................ 48 4.5.12 Funciones del Wizard para la entrada de parmetros................................................................ 49 4.5.12.1 CreateStatic ................................................................................................................................ 49 4.5.12.2 CreateEdit ................................................................................................................................... 51 4.5.12.3 CreateSpinEdit ............................................................................................................................ 54 4.5.12.4 CreateListBox.............................................................................................................................. 57 4.5.12.5 CreateCheckBox ......................................................................................................................... 60 4.5.12.6 CreateFrame ............................................................................................................................... 63 4.5.12.7 CreateRadioButton...................................................................................................................... 65 4.5.12.8 CreateFileBrowser ...................................................................................................................... 68 4.5.12.9 CreateVarBrowser / CreateVarBrowserEx.................................................................................. 72 4.5.12.10 CreatePackageBrowser/CreatePackageBrowserEx.............................................................. 75 4.5.12.11 CreateObjectBrowser............................................................................................................. 78 4.5.13 Funciones del Wizard para generar dinmicas........................................................................... 81 4.5.13.1 GenerateBLOB............................................................................................................................ 81 4.5.13.2 DeleteBLOB ................................................................................................................................ 84 4.5.13.3 SetAction ..................................................................................................................................... 84 4.5.13.4 AddTimeTrigger .......................................................................................................................... 86 4.5.13.5 AddVarTrigger/AddVarTriggerEx ................................................................................................ 88 4.5.13.6 SetValidateFct............................................................................................................................. 90 4.5.13.7 EnumProperty/EnumPropertyEx................................................................................................. 92 4.5.14 Funciones de WinCC del Wizard ................................................................................................ 94 4.5.14.1 GetProjectName.......................................................................................................................... 94 4.5.14.2 GetPictureName.......................................................................................................................... 95 4.5.14.3 GetDefaultWNFPath ................................................................................................................... 96 4.5.14.4 GetObjectName .......................................................................................................................... 97 4.5.14.5 InsertXRefSection ....................................................................................................................... 98 4.5.15 Funciones Progress del Wizard ................................................................................................ 100 4.5.15.1 Funciones Progress del Wizard ................................................................................................ 100 4.5.15.2 CreateProgressDlg.................................................................................................................... 101 4.5.15.3 Progress_SetStatus .................................................................................................................. 101 4.5.15.4 Progress_Steplt......................................................................................................................... 102 4.5.15.5 Progress_SetPos ...................................................................................................................... 102 4.5.15.6 DestroyProgressDlg .................................................................................................................. 103 4.5.16 Funciones de Windows del Wizard........................................................................................... 104 4.5.16.1 Funciones de Windows del Wizard........................................................................................... 104 4.5.16.2 GetParent .................................................................................................................................. 104 4.5.16.3 GetWindowRect ........................................................................................................................ 105 4.5.16.4 MoveWindow............................................................................................................................. 106 4.5.16.5 SendMessage ........................................................................................................................... 107 4.5.16.6 GetWindow................................................................................................................................ 108
Smart Tools
12/2011, Impresin de la Ayuda en pantalla
ndice
4.5.16.7 ShowWindow .............................................................................................................................109 4.5.16.8 MessageBox ..............................................................................................................................110 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 Ejemplos ....................................................................................................................................112 Ejemplos ....................................................................................................................................112 Demo Wizard .............................................................................................................................112 Demo Wizard .............................................................................................................................112 Cmo crear una funcin del Dynamic Wizard para el Demo Wizard ........................................112 Cmo crear el texto de ayuda....................................................................................................113 Cmo insertar el script "Demo.wnf" en la base de datos...........................................................114 Dinamizar el motor.....................................................................................................................115 Dinamizar el motor.....................................................................................................................115 Cmo crear una funcin del Dynamic Wizard para el motor .....................................................115 Cmo insertar el script "Motor.wnf" en la base de datos. ..........................................................116 Cmo dinamizar el objeto de usuario "Motor" ...........................................................................117 Cmo crear la estructura y la variable de estructura .................................................................118 WinCC Documentation Viewer ..................................................................................................119 Instalacin del WinCC Documentation Viewer ..........................................................................119 Descripcin ................................................................................................................................120 Creacin de archivo(s) .emf.......................................................................................................121 WinCC CrossReferenceAssistant ..............................................................................................123 Instalacin del CrossReferenceAssistant ..................................................................................123 General ......................................................................................................................................124 Funciones conocidas (gestin de scripts)..................................................................................125 Seleccin de proyectos..............................................................................................................129 Seleccin de archivos ................................................................................................................130 Conversin .................................................................................................................................131 Configuracin adicional..............................................................................................................133
Documentation Viewer........................................................................................................................... 119
WinCC CrossReferenceAssistant .......................................................................................................... 123
WinCC Communication Configurator ..................................................................................................... 135 ndice alfabtico..................................................................................................................................... 137
ndice
Smart Tools
Resumen
Contenido
Smart Tools es una coleccin de programas tiles que apoyan el trabajo con WinCC. Contiene los siguientes programas y archivos: Simulador de variables Exportacin/importacin de variables Dynamic Wizard Editor Documentation Viewer WinCC CrossReferenceAssistant Communication Configurator WinCC Configuration Tool WinCC Archive ConfigurationTool Nota
Los Smart Tools son herramientas adicionales. Tenga en cuenta que pueden repercutir en el funcionamiento de WinCC, p. ej. en cuanto al comportamiento en runtime o al requerimiento de memoria. Los patrones que rigen la amigabilidad y funcionalidad de los Smart Tools no son necesariamente los que son aplicables al software bsico de WinCC.
Resumen
Smart Tools
Exportacin/importacin de variables
2.1 Exportacin/importacin de variables
Descripcin breve
El programa exporta todas las conexiones, estructuras de datos y variables de un proyecto abierto a los archivos ASCII correspondientes. Luego se pueden importar a un segundo proyecto. El formato ASCII permite procesar los archivos con un programa de hojas de clculo antes de importarlos de nuevo.
2.2
Introduccin
Instalacin de Exportacin/Importacin de variables
La aplicacin "Exportacin/importacin de variables" se puede instalar de dos maneras: El programa slo se puede utilizar correctamente si WinCC tambin est instalado.
Requisitos
En los proyectos multipuesto de WinCC no se puede utilizar la Smart Tool "Exportacin/importacin de variables" en un cliente sin proyecto propio.
Procedimiento
1. En el setup de WinCC en el cuadro de dilogo "Programas", seleccione la entrada "WinCC V7 completo". WinCC se instala con SmartTools, WinCC ConfigurationTool y WinCC Archive ConfigurationTool. La aplicacin "Exportacin/importacin de variables" se inicia mediante "SIMATIC > WinCC > Tools > Tag Export Import".
Procedimiento alternativo
La aplicacin "Exportacin/importacin de variables" tambin se puede instalar desde el DVD de WinCC. 1. Pase, en el DVD de WinCC, al directorio "WinCC\InstData\Smarttools\Setup". 2. Haga doble clic en el archivo "setup.exe". 3. Seleccione en el cuadro de dilogo "Componentes" la entrada "VarExpImp". 4. Haga clic en el botn "Siguiente". Siga las instrucciones de la pantalla.
Exportacin/importacin de variables 2.3 Manejo
2.3
Manejo
EXPORTACIN
1. Primero inicie WinCC y luego abra el proyecto del que desea exportar las variables. Inicie "VAR_EXIM.EXE" 2. Seleccione la ruta y el nombre del archivo al que se debe exportar. Inicialmente se necesita slo el nombre del archivo sin extensin. 3. Ajuste el modo "Exportar". 4. Haga clic en "Execute". Confirme los datos en el cuadro de aviso. 5. Espere hasta que el indicador "End Export/Import" aparezca en el campo de estado. 6. Los archivos creados se pueden visualizar mediante los interruptores "tag" (variables), "con" (conexiones), "dex" (estructuras) y "diag" (informe).
Los grupos vacos no se exportan. El guin bajo ( _ ) est reservado para formar los nombres. Por tanto, los nombres de archivo no deben contener guiones bajos.
IMPORTACIN
1. Primero inicie WinCC y luego abra el proyecto al que desea importar las variables. 2. Todos los drivers de canal deben existir en el proyecto al que desea importar las conexiones. Si es preciso, agregue al proyecto los drivers faltantes 3. Inicie "VAR_EXIM.EXE" 4. Seleccione la ruta y el nombre del archivo del que se debe importar. Inicialmente se necesita slo el nombre del archivo sin extensin. Si utiliza el dilogo de seleccin, haga clic en uno de los tres archivos exportados 5. Ajuste el modo "Import" o "ImportOverwrite". En el modo "ImportOverwrite" se sobrescribe una variable ya existente en el proyecto de destino con la variable homnima a importar. En cambio, en el modo "Import" se escribe un aviso en el archivo de informe y no se modifica la variable en el proyecto de destino. 6. Haga clic en "Execute". Confirme los datos en el cuadro de aviso. 7. Espere hasta que el indicador "End Export/Import" aparezca en el campo de estado.
Smart Tools
10
Exportacin/importacin de variables 2.3 Manejo

8. Verifique los datos generados en la administracin de variables de WinCC.
La importacin en ambos modos no es posible si est activado WinCC Runtime. En los apartados posteriores se describen los detalles tcnicos de la exportacin/importacin de variables. El conocimiento de estos captulos no es estrictamente necesario para el caso estndar, en el que el equipo de destino tiene la misma configuracin que la instalacin de WinCC a la que se efectu la exportacin. Slo es necesario conocer la estructura de variables de WinCC si, mediante los archivos ASCII, desea crear nuevas variables o modificar variables existentes.
11
Exportacin/importacin de variables 2.4 La herramienta "Exportacin/importacin de variables"
2.4
La herramienta "Exportacin/importacin de variables"

La herramienta "Exportacin/importacin de variables" es una aplicacin independiente basada en WinCC-API. Esta herramienta se puede utilizar tanto para exportar todas las variables de WinCC de un proyecto a archivos ASCII, como para importar variables, p. ej. a un segundo proyecto. De esta manera se generan tres archivos, a saber: [name]_cex.csv para las conexiones lgicas [name]_dex.csv para las descripciones de las estructuras [name]_vex.csv para las descripciones de las variables En los archivos se genera una lnea de cabecera que proporciona informacin sobre los datos generados. Durante la importacin se leen automticamente los tres archivos. El archivo [name]_cex.csv se importa primero, puesto que las variables slo se pueden generar si la conexin correspondiente ya existe. Luego siguen las estructuras de datos definidas en el archivo [name]_dex.csv. Se trata de tipos de datos definidos por el usuario que, por supuesto, deben conocerse antes de crear una variable de este tipo. Luego se leen las definiciones de variable del archivo [name]_vex.csv. Los grupos de variables no se pueden crear independientemente de una variable. Si un grupo no existe, se genera automticamente con la variable. Por este motivo tampoco se genera ningn archivo de grupo durante la exportacin. Si en el proyecto se han definido grupos que no contienen variables, estos grupos tampoco se exportan. Al crear una variable se configura, entre otros, el direccionamiento. ste determina la ubicacin fsica de la variable en el sistema de automatizacin. La direccin depende del canal de la conexin y del sistema de automatizacin conectado. Durante la configuracin mediante el WinCC Explorer aparece una mscara de entrada dependiente del canal. Al editar un archivo de importacin de "Exportacin/importacin de variables" deben tenerse en cuenta estas especificaciones. Por tanto, las variables exportadas slo se deben importar a otro proyecto WinCC si esta instalacin tiene la misma configuracin que la instalacin a la que se han exportado los datos. Antes de importar datos a un proyecto, se debe tener constancia de la posible existencia de variables. En caso necesario, las direcciones se deben corregir manualmente. Sin embargo, no se excluye que sea posible importar variables de instalaciones con una configuracin diferente. El xito de una accin de este tipo depende del canal y del AS. En cambio, los tipos de estructuras exportados no dependen del hardware. Se ignoran todos los parmetros especficos del canal y de la conexin, como p. ej. Connection, GroupName, AddressInformation. Estos parmetros se determinan tan slo al crear una variable de estructura.
Particularidades al exportar la cadena de direccin a szSpecific. Al crear una variable, el software especfico de canal verifica la cadena de direccin. Estas DLL de canal exigen una sintaxis determinada que no se debe modificar regionalmente. Por este motivo, al realizar la exportacin, las cadenas de direccin se encierran entre comillas " " adicionales que se eliminan durante la importacin. Ello garantiza que las herramientas utilizadas, p. ej. Excel, no modifiquen la informacin de direccin (problema del separador de listas).
Smart Tools
12
Exportacin/importacin de variables 2.5 Conexiones
2.5
Conexiones
Una conexin slo se puede importar si se ha configurado un driver de canal correspondiente. Adems, los parmetros en el archivo [name]_cex.csv deben ser compatibles con el driver de canal configurado. Si el equipo de destino utiliza un canal diferente al de la instalacin de la que provienen los datos, sta es la primera modificacin que se debe efectuar en los datos exportados. Un procedimiento sencillo para determinar los datos de conexin necesarios consiste en configurar en el equipo de destino todas las conexiones e iniciar la exportacin. Los parmetros del equipo de destino se pueden consultar luego en el archivo [name]_cex.csv.
Ejemplo de una conexin lgica:

#Conname VerbAS1 VerbAS2 Unit Industrial Ethernet Profibus FMS Common General General Specific "" "" Flag 0 0
La segunda fila muestra la conexin lgica de un driver Industrial Ethernet de Simatic S7 Protocol Suite. La tercera fila contiene la conexin lgica de un driver Profibus FMS. Bajo #Conname aparece el nombre de la conexin lgica. En el archivo exportado, el nombre de la conexin lgica se encuentra en los datos de la variable. La comunicacin con el sistema de automatizacin se realiza a travs de la conexin lgica, con objeto de acceder a las variables externas en el proceso.
13
Exportacin/importacin de variables 2.6 Estructuras de archivo
2.6
Estructuras de archivo
Estructura del archivo [name]_dex.csv:
#Structure Name Regulacin_1 #Varname NuevaVariable1 NuevaVariable2 NuevaVariable3 etc... Type-Id 1001 C.Vartype ... ... ... ... Creator-ID 2500 C.CreatorID ... ... ... ... Project Path C:\DatosTest\Proj.mcp C.VarLength ... ... ... ... etc. ... ... ... ...
#:
Caracteres de comentario
#Structure Name: La fila siguiente contiene el nombre de una estructura de archivo con parmetros especficos de la estructura. La indicacin de la ruta de proyecto sirve slo para documentar de qu proyecto se han exportado los datos. Los datos se importan automticamente en el proyecto que se acaba de abrir. #Varname: Las filas siguientes contienen los elementos de la estructura de archivo hasta que se detecte una nueva fila #Structure Name o no haya ms filas definidas. Una fila contiene todos los parmetros necesarios para definir una variable.
Nota para usuarios de WinCC API: La primera fila contiene como ttulo de columna los nombres de los parmetros en las estructuras de archivo correspondientes de las llamadas API. Luego los datos se pueden interpretar claramente en una tabla de Excel. Si un nombre aparece definido por una letra y seguido de un punto, ello facilita la asignacin a las llamadas API.
Ejemplo: C.nnnnnn P.nnnnnn L.nnnnnn S.nnnnnn est contenido en la subestructura Common est contenido en la subestructura Protocol est contenido en la subestructura Limits est contenido en la subestructura Scaling
Smart Tools
14
Exportacin/importacin de variables 2.7 Variable
2.7
Variable
Las variables y conexiones comprenden una seccin general y una especfica. La seccin especfica siempre es provista por la respectiva DLL de canal. Aunque, a la hora de configurar, esta seccin puede faltar (debiendo estar definida antes de la activacin), durante la importacin se ignoran todos los objetos que carezcan de seccin especfica. Durante la exportacin, estas secciones faltantes se reemplazan por '*'.
Importacin de variables de un tipo definido por el usuario.

Una variable de WinCC predefinida se identifica mediante un tipo de datos cuyo valor est comprendido entre 1 y 18. Un tipo de estructura definida por el usuario recibe como tipo de datos el ID de tipo asignado por el administrador de datos al crear la estructura de datos. Este ID de tipo es mayor que 1000. Un tipo de estructura se define mediante su nombre y tipo de datos. El nombre de la estructura de datos del equipo al que se realiz la exportacin es igual al del equipo al que se efecta la importacin. Sin embargo, el ID de tipo no tiene que ser necesariamente idntico. Para poder crear una variable de tipo de estructura es preciso asignar el ID de tipo al nombre de estructura.
Ejemplo: Los tipos de estructura se han exportado al archivo [name]_dex.csv.

#Structur Name ExternStr1 #Varname Variable1 Variable2 Variable3 Variable4 Type-ID 1046 C.Vartype 1 2 3 4 Creator-ID 0 C.CreatorID 0 0 0 0 Project Path G:\DatosTest\... C.VarLength 2 1 1 2 C.VarProperty ... ... ... ... ... ... ... ... ...
Las variables se han exportado al archivo [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
En el archivo [name]_dex.csv se define un tipo de estructura con el nombre ExternStr1 y el ID de tipo 1046.
15
Exportacin/importacin de variables 2.7 Variable

En el archivo [name]_vex.csv est definida una variable de estructura del tipo ExternStr1 con el nombre InstExStr1. La asignacin del tipo de estructura ExternStr1 se efecta a travs del valor en la columna CTyp que contiene el ID de tipo 1046 de este tipo de estructura. Para poder importar una variable de estructura, el tipo de estructura debe estar contenido en el archivo [name]_dex.csv y las variables de este tipo en el archivo [name]_vex.csv. La herramienta "Exportacin/importacin de variables" registra la asignacin de nombre e ID de tipo, pudiendo as crear instancias, incluso si el ID de tipo es diferente en el equipo de destino. Si se desea importar variables del tipo "definido por el usuario" sin que la estructura de datos sea leda durante la importacin (p. ej. ningn archivo [name]_dex.csv), es preciso posteditar manualmente en el archivo csv el ID de tipo del equipo de destino de dicha estructura. El ID de tipo se determina en este caso mediante el archivo exportado [name]_dex.csv del equipo de destino, tal y como se describe arriba. La propiedad de una variable se representa en la columna CPro como valor decimal en el archivo exportado [name]_vex.csv . Se diferencian las siguientes propiedades de la variable:
Propiedad de la variable Variable interna con actualizacin en todo el proyecto Valor decimal 2 Valor hexadecimal 2 2002 4
Variable interna con actualizacin en el 8194 equipo local Variable externa 4
Si p. ej. se exportan de WinCC variables internas con actualizacin en el equipo local, debindose importar nuevamente a WinCC variables internas con actualizacin en todo el proyecto, se puede modificar en el archivo de exportacin el valor de la propiedad de la variable de 8194 a 2 en la columna CPro para las variables correspondientes. Luego se guarda el archivo de exportacin modificado y se importa a WinCC.
Smart Tools
16
Exportacin/importacin de variables 2.8 Anexo
2.8
Anexo
Campos de variables ---------------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
17
Exportacin/importacin de variables 2.8 Anexo
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] ;
Smart Tools
18
Simulador de variables
3.1 El simulador de variables
Descripcin breve
El simulador de variables se utiliza para simular variables internas y variables de proceso. Un campo de aplicacin tpico del simulador de variables es p. ej. comprobar una configuracin sin estar conectada la periferia del proceso, o bien estando conectada la periferia del proceso pero sin un proceso en curso. Si no est conectada la periferia del proceso, slo se pueden simular variables internas. Si est conectada la periferia del proceso, se pueden suministrar directamente valores a las variables de proceso a travs del simulador de variables. De esta manera es posible realizar una prueba funcional del sistema de control y supervisin mediante el hardware original. El tiempo de actualizacin para valores de variables es un segundo. Un cambio tendr efecto tan slo cuando se activen las funciones o cuando se cambie la carpeta de proyectos. Es posible configurar 300 variables como mximo. Otra posibilidad de aplicacin del simulador de variables es la implementacin de un proyecto con fines demostrativos. En muchas ocasiones no existe una conexin con la instalacin para presentar el sistema de control y supervisin. En este caso, la simulacin se encarga de forzar las variables internas. En la Ayuda en pantalla correspondiente encontrar una descripcin detallada del simulador de variables. ADVERTENCIA El simulador de variables escribe los valores de proceso en el sistema de automatizacin conectado. Esto significa que se debe tener en cuenta una eventual reaccin de la periferia de proceso conectada.
19
Simulador de variables 3.2 Aplicacin del simulador de variables
3.2
Aplicacin del simulador de variables

Un campo de aplicacin tpico del simulador de variables es comprobar la configuracin sin estar conectada la periferia de proceso, o bien estando conectada la periferia de proceso, pero sin un proceso en curso.
Simulacin de las variables de proceso sin periferia de proceso

Si no est conectada la periferia del proceso, slo se pueden simular variables internas. Para simular de antemano el proceso offline, realice los siguientes pasos: 1. Cree una copia de seguridad del proyecto copiando la carpeta de proyecto y cambiando el nombre, p. ej. a xxx_. Esta copia de seguridad se puede utilizar como objeto de prueba. En WinCC, abra el proyecto copiado. 2. Utilizando la funcin "Cortar" y "Pegar", agregue a las variables internas las variables de proceso que desea simular. No utilice "Copiar" y "Pegar", puesto que WinCC Explorer genera automticamente una extensin de nombre y la aade al nombre de la variable para que ste sea unvoco dentro del proyecto. La informacin de direccin de las variables de proceso declaradas como variables internas se pierde. 3. Ahora es posible suministrar valores a las variables por medio del simulador. 4. Tras finalizar la fase de prueba se puede seguir trabajando con el proyecto original.
Simulacin de las variables de proceso estando conectada la periferia de proceso

Si est conectada la periferia del proceso, se pueden suministrar directamente valores a las variables de proceso a travs del simulador. De esta manera es posible realizar una prueba funcional del sistema de control y supervisin mediante el hardware original, p. ej.: Comprobacin de niveles de valor lmite, salidas de avisos. Verificacin de la universalidad de alarmas, advertencias, mensajes de error y control de indicadores de estado. Predeterminacin, lectura y modificacin de entradas y salidas, tanto analgicas como digitales. Simulacin de alarmas.
Smart Tools
20
Simulador de variables 3.3 Funciones del simulador
3.3
Introduccin
Funciones del simulador
La simulacin pone a disposicin del ingeniero 6 funciones diferentes. A travs de estas funciones, los objetos configurados pueden abastecerse con valores realistas. Con el fin de probar diferentes casos, la simulacin ofrece 6 funciones. A cada variable se puede asignar una de estas 6 funciones.
Seno
Como funcin peridica no lineal.
Oscilacin
Para simular saltos de una magnitud piloto.
Nmeros aleatorios
La funcin "Nmeros aleatorios" provee valores generados de forma aleatoria.
Increment
Contador incremental que, tras alcanzar el valor mximo, reinicia el contaje a partir del valor mnimo.
Decrement
Contador decremental que, tras alcanzar el valor mnimo, reinicia el contaje a partir del valor mximo.
Deslizador
Control deslizante con el que el usuario puede ajustar un valor fijo.
21
Simulador de variables 3.4 Instalacin del simulador
3.4
Instalacin del simulador

El simulador de variables se puede instalar de dos maneras:
Procedimiento
1. En el setup de WinCC en el cuadro de dilogo "Programas", seleccione la entrada "WinCC V7 completo". WinCC se instala con SmartTools, WinCC ConfigurationTool y WinCC Archive ConfigurationTool. El simulador de variables se inicia mediante "SIMATIC > WinCC > Tools > WinCC Tag Simulator".
Modo de proceder alternativo

La aplicacin Simulador de variables tambin se puede instalar desde el DVD de WinCC. 1. Pase, en el DVD de WinCC, al directorio "WinCC\InstData\Smarttools\Setup". 2. Haga doble clic en el archivo "setup.exe". 3. En el cuadro de dilogo "Componentes", seleccione la entrada "WinCC Simulador de variables". 4. Haga clic en el botn "Siguiente". Siga las instrucciones de la pantalla.
Inicio del simulador

El simulador Simulation.exe se puede iniciar desde el Explorador de Windows, o bien introducindolo en la lista de arranque del WinCC Explorer. Gracias a ello, se inicia automticamente al activar un proyecto. La activacin de un proyecto en WinCC Explorer es requisito para el funcionamiento correcto del simulador. Este requisito se cumple si el simulador ha sido introducido en la lista de arranque del proyecto.
Smart Tools
22
Simulador de variables 3.5 Agregar/borrar variables
3.5
Agregar/borrar variables
Agregar nuevas variables

El comando de men "Edicin > Nueva variable" permite agregar variables para la simulacin. Para ello se abre el dilogo de seleccin de variables de WinCC Explorer que permite seleccionar la variable deseada del proyecto activo. Si desea crear una nueva variable, ello tambin es posible en el dilogo de seleccin de variables. Al confirmar la seleccin a travs del botn "Aceptar", la variable previamente seleccionada se introduce en la ficha "Propiedades" del simulador. Aqu se puede seleccionar la forma en que se debe modificar el valor de la variable. Para que el simulador acepte definitivamente la modificacin, es preciso hacer clic en la ficha "Variables" antes de poder agregar la siguiente variable. La simulacin de variables configurada se puede guardar en un archivo de configuracin con la extensin "sim".
Borrar una variable

Si desea borrar una variable de la lista del simulador, seleccinela y elija luego el comando de men "Edicin > Borrar variable". La variable seleccionada se borra sin consulta previa de la lista de las variables a simular.
23
Simulador de variables 3.6 Posibilidad de parametrizar funciones
3.6
Posibilidad de parametrizar funciones

Los parmetros de las funciones se pueden ajustar de manera individual para cada variable.
Seno
En la funcin Seno, el rango de valores se puede ajustar mediante el parmetro Amplitud. El punto cero del rango de valores se puede indicar con el Offset. La duracin del perodo se ajusta con el parmetro Tiempo de oscilacin (valor ajustado * Cycle Time).
Oscilacin
A travs del parmetro Valor de consigna se ajusta el valor que permanece despus del proceso de estabilizacin. El parmetro Sobreoscilacin indica hasta qu punto se pueden desviar los valores del valor de consigna cuando se activa la atenuacin cero. Mediante el parmetro Tiempo de oscilacin se especifica el intervalo de tiempo. Una vez concluido el tiempo indicado en el intervalo de tiempo, comienza nuevamente la oscilacin.
Nmeros aleatorios
Mediante los parmetros Lmite inferior y Lmite superior se especifica el intervalo para los nmeros aleatorios.
Increment
Mediante los parmetros Valor inicial y Valor final se especifica el intervalo para el contador incremental.
Decrement
Mediante los parmetros Valor inicial y Valor final se especifica el intervalo para el contador decremental.
Deslizador
Mediante los parmetros Valor inicial y Valor final se especifica el rango de ajuste para el control deslizante.
Smart Tools
24
Simulador de variables 3.7 Activar/desactivar variables
3.7
Activar/desactivar variables
Para poder pasar sin obstculos de la configuracin offline a la configuracin online, las variables se pueden activar y desactivar individualmente mediante su respectiva casilla de verificacin. Si est activada una variable, la simulacin calcula los valores y los transfiere al WinCC Explorer. Si no est activada la casilla de verificacin, los valores de simulacin no se transfieren al WinCC Explorer.
3.8
Representacin de las variables

La informacin visualizada a continuacin en la ficha Variables le facilita al ingeniero el control de las variables durante la fase de configuracin: el proyecto WinCC actual el nombre de la variable la funcin asignada el estado (activo / inactivo) el valor actualmente aplicado Si se selecciona el nombre de una variable, los dems parmetros se introducen en la ficha "Propiedades".
3.9
Cargar/guardar datos de simulacin

Los datos de simulacin se pueden guardar para que estn disponibles nuevamente cuando se vuelva a iniciar el simulador. Ello se efecta mediante el comando de men "Archivo > Guardar", o "Archivo > Guardar como...". Una configuracin de simulacin previamente guardada se carga mediante el comando de men "Archivo > Abrir". Al iniciar el simulador se carga automticamente la ltima configuracin utilizada con referencia a un proyecto WinCC.
25
Simulador de variables 3.10 FAQ
3.10
FAQ
Error en DM-API, imposible encontrar la DLL Si ocurre un error al abrir el simulador en conexin con DLLs, ello se debe a que falta una indicacin de ruta en el archivo AUTOEXE.BAT. Verifique si este archivo contiene la siguiente entrada en la indicacin de ruta: SET PATH = .....;<unidad de WinCC>:\<directorio de WinCC>\bin p. ej.: SET PATH=C:\SIEMENS\WINCC\BIN;
Smart Tools
26
Dynamic Wizard Editor

4.1 Dynamic Wizard Editor
Descripcin breve
El Dynamic Wizard Editor es una herramienta para crear Dynamic Wizards propios. Los Dynamic Wizards permiten automatizar los procesos de configuracin frecuentes.
4.2
Introduccin
Resumen
El Dynamic Wizard es una funcionalidad adicional disponible en el Graphics Designer. El Dynamic Wizard ayuda al usuario en procesos de configuracin frecuentes. De esta manera se optimiza el proceso de configuracin y se reducen los posibles errores. El Dynamic Wizard comprende diversas funciones. Ya existen numerosas funciones del Dynamic Wizard. stas se pueden complementar mediante funciones personalizadas. Para crear funciones del Dynamic Wizard personalizadas se dispone de un editor independiente. Se trata del programa dynwizedit.exe.
27
Dynamic Wizard Editor 4.2 Resumen
Todas las funciones del Dynamic Wizard estn guardadas en una base de datos en el disco duro (...\WinCC\wscript\Dynwiz.cwd). El Dynamic Wizard tiene una visualizacin estandardizada y una interfaz de usuario que permite seleccionar y parametrizar las funciones del Dynamic Wizard. Una vez seleccionada la funcin del Dynamic Wizard, ste la carga en la memoria y la ejecuta.
Smart Tools
28
Dynamic Wizard Editor 4.3 Instalacin del Dynamic Wizard Editor
Interfaz entre el Dynamic Wizard y una funcin del Dynamic Wizard

El vnculo entre el Dynamic Wizard y una funcin del Dynamic Wizard se efecta a travs de una interfaz de sistema en la funcin del Dynamic Wizard, cuya estructura est predeterminada. Esta interfaz contiene informaciones que son evaluadas por el Dynamic Wizard. El contenido fundamental de la interfaz es: Referencia a la funcin de procesamiento El procesamiento es la funcin principal del Dynamic Wizard. Contiene el "servicio" que una funcin del Dynamic Wizard le presta al usuario, p. ej. la creacin de una accin en un objeto grfico. La lista de opciones define los parmetros necesarios para la funcin de procesamiento, determinando asimismo cmo stos se predeterminan en la interfaz del dilogo. La lista de triggers define los triggers con los que debe vincularse un objeto creado, determinando asimismo cmo stos se predeterminan en la interfaz del dilogo.
4.3
Instalacin del Dynamic Wizard Editor

El Dynamic Wizard Editor se puede instalar de dos maneras:
Procedimiento
1. En el setup de WinCC en el cuadro de dilogo "Programas", seleccione la entrada "WinCC V7 completo". WinCC se instala con SmartTools, WinCC ConfigurationTool y WinCC Archive ConfigurationTool. El Dynamik Wizard Editor se inicia mediante "SIMATIC > WinCC > Tools".

Dynamic Wizard Editor tambin se puede instalar desde el DVD de WinCC. 1. Pase, en el DVD de WinCC, al directorio "WinCC\InstData\Smarttools\Setup". 2. Haga doble clic en el archivo "setup.exe". 3. En el cuadro de dilogo "Componentes" seleccione la entrada "Dynamic Wizard Editor". 4. Haga clic en el botn "Siguiente". Siga las instrucciones de la pantalla.
29
Dynamic Wizard Editor 4.4 Estructura
4.4
Estructura
4.4.1
Estructura
El "Dynamic Wizard Editor" contiene los siguientes elementos: Barra de mens La barra de mens contiene las funciones del Dynamic Wizard Editor. La barra de mens siempre es visible. Barra de herramientas En caso necesario, la barra de herramientas se puede mostrar y situar en cualquier posicin de la pantalla mediante el ratn. Ventana de edicin La ventana de edicin se visualiza slo si est abierta una funcin del Dynamic Wizard para editarla, o bien al crear una funcin nueva. Toda funcin se abre en una ventana de edicin propia. Varias ventanas de edicin pueden estar abiertas simultneamente. Ventana de resultados La ventana de resultados se puede mostrar en caso necesario. sta contiene el resultado de las funciones "Create CWD", "Read Wizard Script" y "Compile Script". Barra de estado La barra de estado se puede mostrar en caso necesario. Esta barra proporciona informacin acerca de la configuracin del teclado e indica la posicin del cursor en la ventana de edicin. Dynamic Wizard El Dynamic Wizard ofrece la posibilidad de dinamizar un objeto mediante acciones C. Al ejecutar los Wizards (asistentes) se especifican acciones C y eventos de trigger preprogramados y se guardan en las propiedades del objeto.
Smart Tools
30
4.4.2
Introduccin
Barra de herramientas
La barra de herramientas ofrece la posibilidad de ejecutar las acciones ms rpidamente. De esta manera no es necesario seleccionar a travs del men hasta llegar a la funcin requerida.
Botones
Botn Descripcin Crea una nueva funcin del Dynamic Wizard. Abre una funcin del Dynamic Wizard (*.wnf) existente. Guarda la funcin del Dynamic Wizard. Corta el texto seleccionado y lo copia en el portapapeles. Copia el texto seleccionado y lo deposita en el portapapeles. Inserta el contenido del portapapeles en la posicin del cursor. Imprime el contenido de la ventana de edicin activa. Muestra informacin detallada sobre el Dynamic Wizard Editor. Genera los datos del Dynamic Wizard (CWD). Esta funcin lee todos los scripts del Wizard existentes para el idioma ajustado actualmente y los prepara para su procesamiento en el Dynamic Wizard. El archivo creado se encuentra en la ruta de instalacin de WinCC (ruta de instalacin\wscripts\dynwiz.cwd). Lee los scripts del Wizard y los pone a disposicin del Dynamic Wizard. Ajusta el idioma para el que el se configura el script del Wizard. Aqu se ofrecen los idiomas conocidos por WinCC, independientemente del idioma instalado. La conmutacin del idioma del Wizard no tiene efecto en el sistema completo ni en la interfaz de configuracin.
31
Botn
Descripcin Cambia el objeto. El Dynamic Wizard, disponible tambin en el editor a fines de test, depende de las diferentes propiedades de un objeto en el Graphics Designer. Para poder comprobar en el editor un script del Wizard nuevo o existente, esta funcin permite cambiar a otro objeto existente en una imagen existente. Conforme al objeto recientemente ajustado, el Dynamic Wizard se adapta de manera que slo se visualicen los scripts del Wizard apropiados para este objeto. Muestra todos los scripts del Dynamic Wizard para el idioma configurado. Adems, en el cuadro de dilogo se pueden borrar los scripts del Wizard de la lista. Abre el editor de Ayuda. Compila el script.
Smart Tools
32
4.4.3
Introduccin
Ventana de edicin
En la ventana de edicin se crean y editan funciones del Dynamic Wizard.
Codificacin de color
La representacin del cdigo C est codificada por colores del siguiente modo:
Color azul verde rojo negro Significado Palabras clave Comentarios Cadenas de caracteres Otros cdigos C Ejemplo
33
4.4.4
Introduccin
Editor de Ayuda
En este cuadro de dilogo se puede introducir un texto de Ayuda para toda pgina creada con el script del Wizard. Slo se pueden almacenar textos de Ayuda para Dynamic Wizards ya creados.
Elementos del editor de Ayuda

Elemento Descripcin
Grupo del Wizard A travs del campo de seleccin se determina en qu grupo (= ficha) se encuentra el Dynamic Wizard. Nombre del Wizard Pgina Texto de Ayuda A travs del campo de seleccin se determina para qu Dynamic Wizard se crea un texto de Ayuda. A travs del campo de seleccin se determina para qu pgina del cuadro de dilogo se crea el texto de Ayuda. En este campo se introduce el texto de Ayuda.
Smart Tools
34
4.4.5
Introduccin
Ventana de resultados
La ventana de resultados contiene el resultado de las funciones "Create CWD", "Read Wizard Script" y "Compile Script".
La ventana de resultados ayuda a buscar errores en los scripts. Si se detecta un error en el script, el aviso aparece as: ...\WinCC\wscripts\wscripts.esp\DemoWiz1.wnf(6):error(003a): 'include': invalid function definition
Descripcin ...\WinCC\wscripts\wscripts.esp\ DemoWiz1.wnf(6) error(003a): 'include': invalid function definition Directorio en el que se encuentra el archivo wnf. Nombre del archivo y nmero de la fila en la que aparece el error. Nmero y descripcin del error.
35
Dynamic Wizard Editor 4.5 Estructura de una funcin del Dynamic Wizard
4.5
Estructura de una funcin del Dynamic Wizard
4.5.1
Introduccin
Estructura de una funcin del Dynamic Wizard
Una funcin del Dynamic Wizard debe tener una estructura predeterminada. sta ha sido estructurada segn los componentes necesarios. 1. Integracin de archivos de cabecera y DLLs 2. Definicin dependiente del idioma 3. Flags del Wizard 4. Lista de propiedades 5. Interfaz de sistema 6. Variables globales 7. Lista de opciones 8. Lista de triggers 9. Visualizacin de la parametrizacin
4.5.2
Introduccin
Cuadro de dilogo del Dynamic Wizard
Toda funcin del Dynamic Wizard tiene su funcionalidad especfica. Gracias a la estructura predeterminada de una funcin, todas las funciones tienen un proceso y una interfaz de dilogo similares. El cuadro de dilogo del Dynamic Wizard comprende varias pginas. Dilogo "Bienvenido al Dynamic Wizard". Dilogo "Seleccionar un trigger" Dilogo "Definir opciones" Dilogo "Listo"
Smart Tools
36
4.5.3
Introduccin
Integracin de archivos de cabecera y DLLs
Un archivo de cabecera contiene declaraciones de constantes, tipos de datos, variables y funciones. Los archivos de cabecera se integran en la funcin mediante una instruccin #include. El archivo dynamic.h es el ms importante por lo que respecta a su integracin. En este archivo estn declaradas, entre otras, las funciones para disear la interfaz del Dynamic Wizard.
Los archivos DLL (Dynamic Link Library) son rutinas ejecutables que puede cargar un programa si son requeridas por ste. Para poder aprovechar los archivos DLL, stos se integran en la funcin mediante una instruccin #pragma.
En el Dynamic Wizard Editor estn ajustadas las siguientes rutas: Archivos de cabecera de WinCC: ...\WinCC\aplib\ DLLs de WinCC: ...\WinCC\bin\ Si los archivos se encuentran en un directorio diferente, es preciso indicar la ruta completa en las instrucciones #include- y #pragma.
37
4.5.4
Introduccin
Definiciones multilinges
Las funciones estndar del Dynamic Wizard estn a disposicin en alemn, ingls y francs. Con un cambio de idioma en el WinCC Explorer se selecciona tambin la versin del idioma correspondiente de las funciones del Dynamic Wizard. Dentro de las rutas ..\WinCC\wscripts\wscripts.deu ..\WinCC\wscripts\wscripts.enu ..WinCC\wscripts\wscripts.fra debe existir un archivo WNF para cada funcin del Wizard. A la hora de la creacin, todas las definiciones multilinges deben estar dispuestas en esta seccin. Ello facilita la creacin de las dems versiones de idioma.
Smart Tools
38
4.5.5
Introduccin
Flags del Wizard
Mediante estos flags se determina para qu tipo de configuracin es aplicable la funcin del Dynamic Wizard.
Flags
FLAG WIZARD_FLAG_OCX WIZARD_FLAG_ALL_PROJECT_TYPES Para todos los archivos OCX Para todos los proyectos
WIZARD_FLAG_SINGLEUSER_PROJECT Slo para proyectos monopuesto WIZARD_FLAG_MULTICLIENT_PROJECT Slo para proyectos cliente WIZARD_FLAG_MULTIUSER_PROJECT Slo para clientes sin datos de proyecto
39
4.5.6
Introduccin
Lista de propiedades
En la lista de propiedades se determina en qu tipos de objeto se puede utilizar una funcin del Dynamic Wizard. Para ello se indica una lista de propiedades de objeto. Si un objeto dispone como mnimo de una de las propiedades enumeradas, la funcin del Dynamic Wizard se puede aplicar a ese objeto.
Toda entrada de la lista de propiedades comprende dos parmetros: Nombre de la propiedad en ingls p. ej. color de fondo (Backcolor) Tipos de datos de WinCC Si se utiliza una lista de propiedades vaca, la funcin del Dynamic Wizard se puede aplicar a todos los tipos de objeto. La lista de propiedades debe existir siempre, incluso si est vaca.
Smart Tools
40
4.5.7
Introduccin
Interfaz de sistema
Mediante la interfaz de sistema se determinan las propiedades de la nueva funcin del Dynamic Wizard.
Descripcin de los parmetros

1. El primer parmetro determina en qu ficha debe aparecer la funcin del Dynamic Wizard. 2. El segundo parmetro determina bajo qu nombre debe aparecer la funcin del Dynamic Wizard. 3. El tercer parmetro es siempre NULL. 4. El cuarto parmetro denomina el smbolo que se utilizar para la funcin del Dynamic Wizard. 5. El quinto parmetro es un texto de Ayuda que incluye una descripcin detallada de la funcionalidad de la funcin del Dynamic Wizard. 6. El sexto parmetro es una lista con los nombres de las funciones creadas para las distintas ventanas. Esta lista se debe finalizar con una entrada NULL. Es posible crear cinco ventanas como mximo. Encontrar ms informacin en el apartado "Lista de opciones".
41
7. El sptimo parmetro es el nombre de la funcin de procesamiento que se llama al hacer clic en el botn "Finalizar". El procesamiento es la funcin principal del Dynamic Wizard. Contiene el "servicio" que una funcin del Dynamic Wizard le presta al usuario, p. ej. la creacin de una accin en un objeto grfico. 8. El octavo parmetro es el nombre de la funcin que resume los ajustes efectuados en las ventanas de opciones. El resumen se muestra al usuario antes de que ste pulse el botn "Finalizar". Encontrar ms informacin en el apartado "Visualizacin de la parametrizacin". 9. El noveno parmetro es una lista de los triggers a visualizar en la pgina de triggers. Para los casos de aplicacin ms frecuentes hay macros disponibles que rellenan esta lista de triggers. Encontrar ms informacin en el apartado "Lista de triggers".
4.5.8
Introduccin
Variables globales
Para todo parmetro que deba configurarse en las ventanas es preciso definir una variable global. De esta manera se dan a conocer los parmetros ajustados en todas las funciones creadas, facilitando as el trabajo con ellos. La transferencia de datos entre las funciones de sistema slo es posible a travs de variables globales. Ello es necesario siempre que se deban transferir parmetros de opcin y/o de trigger a la funcin de edicin.
Smart Tools
42
4.5.9
Introduccin
Lista de opciones
Las opciones son parmetros necesarios para la funcionalidad de la funcin del Dynamic Wizard. Las opciones no requieren un trigger. Las opciones se definen en la lista de opciones de la interfaz del sistema. La lista de opciones contiene para toda opcin el nombre de la funcin asignada, p. ej. "OnOption1".
La lista de opciones se finaliza con un puntero NULL. Se pueden definir como mximo cinco opciones en la lista.
Funcin de opciones
El Dynamic Wizard llama consecutivamente a las funciones de opciones, conforme a su orden en la lista de opciones. Para toda funcin de opciones se visualiza el dilogo "Definir opciones", en el que la funcin programa su entrada especfica. Para programar la entrada se dispone de funciones de sistema del Wizard. Encontrar ms informacin en el apartado "Funciones de sistema del Wizard". En el dilogo "Definir opciones" se dispone de un rea determinada en la que se pueden ordenar textos estticos, campos de entrada, as como otros cuadros de entrada.
43
En el dilogo "Definir opciones", el rea con las filas 1 a 15 est completamente llena. La funcin de opcin correspondiente aparece as:
Smart Tools
44
4.5.10
Introduccin
Lista de triggers
Los triggers slo son necesarios en conexin con acciones en un objeto grfico. Los triggers se definen en la lista de triggers de la interfaz del sistema. La lista de triggers contiene una entrada para cada trigger.
La entrada se compone de dos parmetros. El primer parmetro es la denominacin del trigger que se visualiza en la interfaz, p. ej. pulsar el botn izquierdo del ratn. El segundo parmetro indica el nombre de la funcin de trigger asignada. La lista de triggers se finaliza con un pareja de punteros NULL. Se pueden definir como mximo 50 triggers en la lista. Existen macros predefinidas para los triggers que se utilizan ms frecuentemente.
45
Macro JCR_TRIGGERS Eventos de trigger DECLARE_JCR_TRIGGERS Clic del ratn, Botn izquierdo del ratn, Botn derecho del ratn Triggers cclicos DECLARE_JCR_ZYKL_TRIGGERS Ciclo de imagen, Ciclo de ventana, Al modificar, 250 ms, 500 ms, 1 segundo, 2 segundos , 5 segundos, 10 segundos, 1 minuto, 5 minutos, Ciclo de usuario 1, Ciclo de usuario 2, Ciclo de usuario 3, Ciclo de usuario 4, Ciclo de usuario 5 Triggers de accin DECLARE_JCR_ACTION_TRIGGERS
JCR_ZYCL_TRIGGERS
JCR_ACTION_TRIGGERS
A partir de la lista de triggers se crea el cuadro de dilogo "Seleccionar un trigger". En un cuadro de lista se visualizan todas las denominaciones de trigger que se pueden seleccionar.
Smart Tools
46
Tras haberse seleccionado un trigger, el Dynamic Wizard llama la funcin de trigger asignada.
47
4.5.11
Introduccin
Visualizacin de la parametrizacin
Los parmetros de opcin y de trigger se pueden visualizar en el cuadro de dilogo "Listo". Esto le permite al usuario verificar una vez ms la parametrizacin y, si es preciso, modificarla. En el campo de visualizacin "Listo" se puede visualizar un texto mediante la funcin de Windows SetWindowText. El campo de visualizacin tiene una altura de 12 filas.
Smart Tools
48
4.5.12
4.5.12.1 Introduccin
Funciones del Wizard para la entrada de parmetros

CreateStatic
En el dilogo "Definir opciones" se visualiza un texto esttico para las coordenadas x,y.
Sintaxis
HWND CreateStatic (int x, int y, char* "Text")
Parmetros
Parmetros int x int y char* Text Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada Y. Indica el texto de salida.
Valor de retorno
Valor de retorno HWND Devuelve el handle del objeto.
49
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin.
char* DynWizEditStatic = "Introduzca un texto:"; ... .. void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; }
//Texto esttico
CreateStatic(0,5,DynWizEditStatic); ..... ...... }
Smart Tools
50
CreateEdit
En el dilogo "Definir opciones" se visualiza un campo de entrada en las coordenadas x,y. En el campo de entrada se puede introducir un texto.
Sintaxis
HWND CreateEdit ( int x, int y, char* pText )
Parmetros
Parmetros int x int y char* pText Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada y. Puntero a un bfer de entrada. El bfer de entrada puede estar ocupado con un valor. ste se visualiza en el campo de entrada.
Valor de retorno
Valor de retorno HWND pText Devuelve el handle del objeto. El bfer de entrada contiene el texto introducido.
51
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un campo de entrada.
char* DynWizEditStatic = "Introduzca un texto:"; char* DynWizEdit = "Texto de ejemplo"; ... .. char g_szEdit[256]; void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; }
Smart Tools
52
//Texto esttico para el campo de entrada
CreateStatic(0,5,DynWizEditStatic);
//Campo de entrada
hWnd = CreateEdit(0,20,g_szEdit) GetWindowRect(GetParent(hWnd), &rect); MoveWindow(hWnd,0,20,(rect.right-rect.left),21,TRUE); ..... ...... }
53
CreateSpinEdit
En el dilogo "Definir opciones" se visualiza un campo de entrada con un regulador giratorio en las coordenadas x,y. Mediante el campo de entrada se introduce un nmero entero en una variable de entrada.
Sintaxis
HWND CreateSpinEdit (int x, int y, int* pValue, int Min, int Max, int Base )
Parmetros
Parmetros int x int y int* pValue int Min int Max int Base Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada y. Puntero a una variable de entrada de nmero entero. La variable de entrada puede estar ocupada con un valor estndar. Lmite inferior para el valor de entrada Lmite superior para el valor de entrada Formato numrico de la entrada: 10 = entrada decimal 16 = entrada hexadecimal
Valor de retorno
Valor de retorno HWND pValue Devuelve el handle del objeto. La variable de entrada contiene el valor introducido.
Smart Tools
54
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un campo de entrada con un regulador giratorio. Puede ajustar un valor comprendido entre 0 y 1000.
char* DynWizSpinStatic= "Introduzca un valor (0 - 1000):"; char* DynWizEdit = "Texto de ejemplo"; ... ... char g_szEdit[256]; void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; }
55
... ...
//Texto esttico para el campo de entrada con regulador giratorio

CreateStatic(0,50,DynWizSpinStatic);
... //Campo de entrada con regulador giratorio

hWnd = CreateSpinEdit(0,65,&g_iSpinEdit,0,1000,10);
MoveWindow(hWnd,0,65,(rect.right-rect.left)/4,21,TRUE);
... ... }
Smart Tools
56
CreateListBox
En el dilogo "Definir opciones" se visualiza un campo de seleccin en las coordenadas x,y. En el campo de seleccin se pueden listar varias entradas. Haciendo clic con el ratn se puede seleccionar una entrada.
Sintaxis
HWND CreateListbox (int X, int Y, char* Headline, int NumLines, int* pSelect )
Parmetros
Parmetros int x int y char* Headline int NumLines int* pSelect Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada y. Ttulo del campo de seleccin Cantidad de filas en el campo de seleccin. Se debe predeterminar: NumLines = cantidad de filas + 1 (1 =< NumLines = <16) Puntero a la variable de resultado
Valor de retorno
Valor de retorno HWND pSelect Devuelve el handle del objeto. Nmero de la entrada seleccionada. El nmero es el ndice en la lista (comenzando con 0).
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un campo de seleccin. El campo de seleccin puede comprender tres filas. Puesto que hay ms de tres entradas, se visualiza una barra de desplazamiento. Nota Mediante la funcin "CreateListbox" slo se crea el campo de seleccin. El contenido de las filas se debe introducir a travs de la funcin "SendMessage".
57
char* DynWizListStatic= "Seleccione una entrada:"; ... int g_iListBox = 0;
//Definicin de tipo de los elementos en el campo de seleccin.

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"},
Smart Tools
58
{ 4, "Fifth Element"} };
void OnOption1(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; ..... if (bFirst == TRUE) { strcpy(g_szEdit,DynWizEdit); bFirst = FALSE; } ... ...
//Texto esttico para el campo de seleccin

CreateStatic(0,162,DynWizListStatic); ...
//Campo de seleccin
hWnd = CreateListbox(0,177,"Headline",LB_NUM_LINES,&g_iListBox);
MoveWindow(hWnd,0,177,(rect.right-rect.left),50,TRUE); //Mediante la funcin "CreateListbox" slo se crea el cuadro. El contenido de las filas se debe introducir a travs de //la funcin "SendMessage".
for (i=0; i<LB_NUM_LINES; i++) { SendMessage(hWnd,LB_INSERTSTRING,(WPARAM)-1,(LPARAM)g_itemListBox[i].szItemText); } }
59
CreateCheckBox
En el dilogo "Definir opciones" se visualiza una casilla de verificacin en las coordenadas x,y. Mediante la casilla de verificacin se puede activar una opcin. En un cuadro de dilogo se pueden utilizar varias casillas de verificacin.
Sintaxis
HWND CreateCheckBox (int x, int y, char* Text, BOOL* pSelect )
Parmetros
Parmetros int x int y char* Text BOOL* pSelect Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada y. Texto que se visualiza a la derecha de la casilla de verificacin. Puntero a la variable de resultado. La variable de resultado se debe ocupar con un valor estndar (True/False).
Valor de retorno
Valor de retorno HWND pSelect Devuelve el handle del objeto. Estado de la activacin FALSE = no activada TRUE = activada
Smart Tools
60
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualizan tres casillas de verificacin, representando cada una de ellas una opcin. Cada opcin se puede activar independientemente.
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) { ... } ...
61
...
//Casilla de verificacin
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 }
Smart Tools
62
CreateFrame
En el dilogo "Definir opciones" se visualiza un recuadro rectangular. La esquina superior izquierda del recuadro se define a travs de las coordenadas x,y. La esquina inferior derecha del recuadro es idntica a la esquina inferior derecha de la ventana de opciones.
Sintaxis
HWND CreateFrame (int x, int y, char* Title )
Parmetros
Parmetros int x int y char* Title Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada y. Rotulacin en el borde superior del rectngulo
Valor de retorno
Valor de retorno HWND Devuelve el handle del objeto.
63
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un recuadro con el ttulo "Frame".
void OnOption2(void) { //Recuadro CreateFrame(0,150,"Frame"); } ... ...
Smart Tools
64
CreateRadioButton
En el dilogo "Definir opciones" se visualiza un botn de opcin en las coordenadas x,y. Mediante el botn de opcin se puede activar una opcin. La utilizacin de botones de opcin slo tiene sentido si en el dilogo estn previstos varios botones de opcin. Slo hay un botn de opcin activo a la vez.
Sintaxis
HWND CreateRadioButton (int x, int y, char* Text, BOOL* pSelect )
Parmetros
Parmetros int x int y char* Text BOOL* pSelect Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada Y. Denominacin de la opcin que se activa con el botn de opcin. El texto se dispone a la derecha del botn de opcin. Puntero a la variable de resultado. La variable de resultado se debe ocupar con un valor estndar (True/False).
Valor de retorno
Valor de retorno HWND pSelect Devuelve el handle del objeto. Estado de la activacin: FALSE = no activado TRUE = activado
65
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualizan tres botones de opcin, representando cada una de ellos una opcin. Slo se puede activar una opcin a la vez.
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) { ... } ... ...
Smart Tools
66
//Botones de opcin
CreateRadioButton(0,100,"RadioButton 1",&g_bOption1); CreateRadioButton(0,116,"RadioButton 2",&g_bOption2); CreateRadioButton(0,132,"RadioButton 3",&g_bOption3); }
67
CreateFileBrowser
En el dilogo "Definir opciones" se visualiza un campo de entrada con un botn Examinar en las coordenadas x,y. En el campo de entrada se puede introducir un nombre de archivo.
Haciendo clic en el botn Examinar se abre un dilogo de seleccin de archivos.
Sintaxis
HWND CreateFileBrowser (int x, int y, DWORD Flags, char* Filter, char* Dateiname )
Parmetros
Parmetros int x int y DWORD Flags Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada y. Flags de control de la ventana de seleccin: FB_WITHPATH = Nombre de archivo con ruta FB_SAVE_AS = En vez del cuadro de dilogo Abrir, aparece el cuadro de dilogo "Guardar como".
Smart Tools
68
Parmetros char* Filter
Descripcin Filtro para visualizar tipos de datos en el campo de seleccin del dilogo de seleccin de archivos. Predeterminando la extensin se especifica qu tipos de datos se visualizan en el campo de seleccin. Un filtro se compone de una pareja de cadenas. La 1 cadena es el nombre del filtro. La 2 cadena es la funcin de filtro en formato *.typ, siendo 'typ' una extensin de archivo. En el campo de seleccin slo se visualizan los archivos con esta extensin. 1. La 1 y la 2 cadenas estn separadas por |. Es posible concatenar varios filtros mediante |. El ltimo filtro se limita mediante ||. Ejemplos: char* Filter1 = "Imgenes grficas (*.PDL) | *.PDL||"; char* Filter2 = "Documentos (*.doc) | *.doc|" "Archivos de texto *.txt | *.txt|" "Archivos WNF | *.wnf|" "Todos los archivos (*.*) | *.*||";
Al final de la funcin de filtro no estn permitidos los espacios en blanco. char* Nombre de archivo Bfer de entrada para el nombre del archivo. Un nombre de ruta se puede predeterminar como valor estndar. Este valor estndar tiene el efecto siguiente: El nombre de la ruta se visualiza por defecto en la ventana de entrada. Si hace clic en el botn Examinar, se ajusta la ruta en el dilogo de seleccin de archivos. Si el nombre de archivo tiene la extensin '*.typ', se visualizan todos los archivos de este tipo en el campo de seleccin del dilogo de seleccin.
Valor de retorno
Valor de retorno HWND Nombre del archivo Devuelve el handle del objeto. El bfer de entrada contiene el nombre del archivo.
69
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un campo de entrada con un botn Examinar. Haciendo clic en el botn Examinar se abre el dilogo de seleccin de archivos.
char* DynWizFileBrowserStatic = "Seleccione un archivo:"; char* DynWizFileBrowser = "C:\\Archivo de ejemplo"; char* DynWizFilter = "Archivos de texto (*.txt) | *.txt|" "Todos los archivos (*.*) | *.*||"; ... char g_szFileBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE)
Smart Tools
70
{ ... strcpy(g_szFileBrowser,DynWizFileBrowser); First = FALSE; } ... ...
// Texto esttico para el campo de entrada con botn Examinar

CreateStatic(0,95,DynWizFileBrowserStatic);
//Dilogo de seleccin de archivos

hWnd = CreateFileBrowser(0,110,FB_WITHPATH,DynWizFilter,g_szFileBrowser); MoveWindow(hWnd,0,110,(rect.right-rect.left),21,TRUE); }
71
CreateVarBrowser / CreateVarBrowserEx
En el dilogo "Definir opciones" se visualiza un campo de entrada con un botn Examinar en las coordenadas x,y. En el campo de entrada se puede introducir un nombre de variable. Haciendo clic en el botn Examinar se abre el dilogo de seleccin de variables de WinCC. En la funcin "CreateVarBrowserEx" se puede parametrizar adicionalmente un filtro de variables. Por medio de este filtro se limitan las variables visualizadas en el dilogo de seleccin de variables. Es posible filtrar segn el tipo de datos, el grupo de variables, el nombre de la variable y la conexin.
Sintaxis
HWND CreateVarBrowser (int x, int y, char* VarName ) HWND CreateVarBrowserEx (int x, int y, LPDM_VARFILTER VarFilter, char* VarName )
Parmetros
Parmetros int x int y LPDM_VARFILTER VarFilter Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada y. Indicacin opcional de un puntero a un filtro de variables. Al indicar un puntero NULL, no hay ningn filtro activado. El filtro de variables se debe definir mediante la estructura DM_VARFILTER. Para ms informacin, consulte la documentacin de WinCC ODK. Contiene el nombre de la variable. El nombre de la variable puede estar ocupado con un valor estndar. Esta entrada se visualiza siempre.
char* VarName
Valor de retorno
Valor de retorno HWND VarName Devuelve el handle del objeto. El bfer de entrada contiene el nombre de la variable.
Smart Tools
72
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un campo de entrada con un botn Examinar. Haciendo clic en el botn Examinar se abre el dilogo de seleccin de variables de WinCC.
char* DynWizVarBrowser = "Variable de ejemplo"; char* DynWizPicBrowserStatic = "Seleccione una imagen:"; ... char g_szVarBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE) { ...
73
strcpy(g_szVarBrowser,DynWizVarBrowser); First = FALSE; } ... ...

CreateStatic(0,95,DynWizFileBrowserStatic);
//Dilogo de seleccin 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); }
Smart Tools
74
CreatePackageBrowser/CreatePackageBrowserEx
En el dilogo "Definir opciones" se visualiza un campo de entrada con un botn Examinar en las coordenadas x,y. En el campo de entrada se puede introducir un nombre. El PackageBrowser se activa mediante el botn Examinar en el borde derecho del campo de entrada. Con el flag o el ProgID se define qu datos deben visualizarse del Package. En la funcin "CreatePackageBrowserEx" se puede transferir un ProgID en vez de un flag.
Sintaxis
HWND CreatePackageBrowser (int x, int y, DWORD flags, char* Name ) HWND CreatePackageBrowserEx (int x, int y, char* ProgID, char* Name )
Parmetros
Parmetros int x int y DWORD flags char* ProgID Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada Y. Actualmente slo se puede utilizar PB_PICTURE. Con ello se activa la seleccin de imgenes. ID programtica del componente que estructura la seleccin. Transfiriendo "WinCC.CCFileASOStub.1" se accede a la seleccin de imagen. Contiene el nombre. El nombre puede estar ocupado con un valor estndar. Esta entrada se visualiza siempre.
char* Name
Valor de retorno
Valor de retorno HWND Nombre Devuelve el handle del objeto. El bfer de entrada contiene el nombre.
75
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un campo de entrada con un botn Examinar. Haciendo clic en el botn Examinar se abre el dilogo de seleccin de archivos.
char* DynWizPicBrowserStatic = "Seleccione una imagen:"; char* DynWizPicBrowser = "Imagen de ejemplo";
... char g_szPicBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE) {
Smart Tools
76
... strcpy(g_szPicBrowser,DynWizPicBrowser);
First = FALSE; } ... ...

CreateStatic(0,50,DynWizPicBrowserStatic);
//Dilogo de seleccin de imgenes

hWnd = CreatePackageBrowser(0,65,PB_PICTURE,g_szPicBrowser); MoveWindow(hWnd,0,65,(rect.right-rect.left),21,TRUE); }
77
CreateObjectBrowser
En el dilogo "Definir opciones" se visualiza un campo de entrada con un botn Examinar en las coordenadas x,y. En el campo de entrada se puede introducir un nombre de objeto o de propiedad. Haciendo clic en el botn Examinar se abre un dilogo de seleccin. En el dilogo de seleccin es posible buscar y seleccionar un nombre de objeto o de propiedad.
Sintaxis
HWND CreateObjectBrowser (int x, int y, char* Title, DWORD flags, char* ObjectName )
Parmetros
Parmetros int x int y char* title DWORD flags Descripcin Indica el valor de la coordenada x. Indica el valor de la coordenada Y. Rotulacin del dilogo de seleccin. Se pueden transferir dos flags diferentes: OB_OBJECTS Visualizacin de todos los objetos OB_PROPERTIES Adicionalmente se ofrece la seleccin de las propiedades. Bfer de entrada para el nombre del objeto o de la propiedad. El bfer de entrada se puede predeterminar con un valor estndar.
char* ObjectName
Valor de retorno
Valor de retorno HWND ObjectName Devuelve el handle del objeto. El bfer de entrada contiene el nombre del objeto y de la propiedad.
Smart Tools
78
Ejemplo
El extracto siguiente del archivo "Demo.wnf" muestra la utilizacin de esta funcin. En el dilogo "Definir opciones" del "Demo Wizard" se visualiza un campo de entrada con un botn Examinar. Haciendo clic en el botn Examinar se abre el dilogo de seleccin de objetos de ventana.
char* DynWizObjectBrowserStatic = "Seleccione un objeto:"; char* DynWizObjectBrowser = "Objeto"; char* DynWizObject = "Seleccin de objeto de ventana"; ; ... char g_szObjectBrowser[256]; ... void OnOption2(void) { static BOOL bFirst = TRUE; HWND hWnd = NULL; RECT rect; ... if (bFirst == TRUE)
79
{ ... strcpy(g_szObjectBrowser,DynWizObjectBrowser); First = FALSE; } ... ...

CreateStatic(0,50, CreateStatic(0,140,DynWizObjectBrowserStatic););
//Dilogo de seleccin de ventanas

hWnd = CreateObjectBrowser(0,155,DynWizObject,OB_OBJECTS,g_szObjectBrowser);
MoveWindow(hWnd,0,155,(rect.right-rect.left),21,TRUE); }
Smart Tools
80
4.5.13
Funciones del Wizard para generar dinmicas

GenerateBLOB
La funcin GenerateBLOB (BLOB = Binary Large OBject) genera una accin que se puede aadir a una propiedad de un objeto grfico. Una accin comprende 3 partes. Prlogo: ste es la cabecera de la funcin C. Ejemplo: #include "apdefap.h" void OnLButtonDown(char* lpszPictureName,char* lpszObjectName,char* lpszPropertyName, UINT nFlags, int x, int y) { El prlogo depende del trigger con el que se inicia la accin (en el ejemplo de arriba: pulsar el botn izquierdo del ratn) Eplogo: ste es el fin de la funcin C y se compone del carcter '}'. Tronco: Esta parte contiene la funcionalidad propiamente dicha de la funcin C. Ejemplo: ProgramExecute("notepad.exe"); La funcin crea y compila el cdigo C de la accin. El resultado de la compilacin es un cdigo P. ste se interpreta y edita con el sistema runtime de WinCC. Si el cdigo C contiene errores, no se crea un cdigo P. La funcin crea un BLOB en el que se guardan las partes de la accin (p. ej. el cdigo C, el cdigo P, el trigger, ...). Antes de finalizar la funcin del Wizard es preciso borrar el BLOB. Encontrar ms informacin acerca del borrado de la funcin BLOB en el apartado "DeleteBLOB".
Sintaxis
AP_BLOB GenerateBLOB (char* Prolog, char* Epilog, char* Format, ... )
Parmetros
Parmetros char* Prolog char* Epilog char* Format Descripcin Prlogo de la accin como cadena ASCII. Eplogo de la accin como cadena ASCII. Tronco de la accin como cadena ASCII o cadena de formato segn la funcin estndar "printf".
81
Nota El cdigo C se crea mediante la funcin C sprintf. El parmetro se edita como cadena de formato, es decir, se evalan los caracteres de control de formato (p. ej. \ % "). Si stos deben adoptarse en el cdigo C (p. ej. como cadena de formato para la llamada printf en una accin), entonces se deben dotar de un \. Ejemplo: \\ \ \% % " \"
Valor de retorno
La funcin suministra como valor de retorno una variable estructurada del tipo AP_BLOB con los siguientes componentes de estructura
Componente de estructura DWORD dwPCodeSize LPVOID lpPCode int nErrors int nWarnings Valor de retorno Longitud del cdigo C creado en bytes Puntero al cdigo P creado Nmero de errores de compilador Nmero de errores de compilador
Ejemplo
El extracto siguiente del archivo "Execute Programm.wnf" muestra la utilizacin de esta funcin. La funcin del Wizard crea un script C con el que se inicia otra aplicacin (en este ejemplo: notepad.exe).
... ... void OnGenerate(void) { PCMN_ERROR pError; AP_BLOB *blob; char code[500]; char sError[500]; .. Slash2DblSlash(g_Bild, strlen(g_Bild)); .. sprintf(code,"%sProgramExecute(\"%s\");",ifcode,g_Bild); ..
Smart Tools
82
//Prlogo
blob = GenerateBLOB("#include \"apdefap.h\"\r\n" "void OnClick(char* lpszPictureName," "char*lpszObjectName,char* lpszPropertyName," "UINT nFlags,int x, int y) {",
//Eplogo
"}",
//Tronco
code);
BEGIN_JCR_BLOBERRORS
SetAction(NULL, blob, g_Trigger);
END_JCR_BLOBERRORS
DeleteBLOB(blob); }
Script C creado:
#include "apdefap.h" void OnLButtonDown(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName, UINT nFlags, int x, int y) { ProgramExecute("notepad.exe"); }
83
DeleteBLOB
La funcin GenerateBLOB crea un BLOB. Al finalizar la funcin del Wizard se debe borrar el BLOB. La funcin DeleteBLOB borra el BLOB.
Sintaxis
void DeleteBLOB (AP_BLOB* blob)
Parmetros
Parmetros AP_BLOB* blob Descripcin Puntero a la variable de resultado de la funcin "GenerateBLOB".
Ejemplo
DeleteBLOB(blob);
SetAction
Al objeto grfico seleccionado se le aade una accin en el trigger indicado. Si el trigger es un evento, ste se indica directamente como parmetro de llamada. Si el trigger es la dinamizacin de una propiedad, es preciso introducirlo previamente en el BLOB mediante las funciones AddVarTrigger o AddTimeTrigger. Nota Si la accin no se debe aadir al objeto seleccionado, sino a un objeto diferente, es preciso utilizar la funcin API PDLCSSetAction. Encontrar ms informacin acerca de la funcin PDLCSSetAction en el manual de WinCC ODK.
Sintaxis
BOOL SetAction (char* Property, AP_BLOB* Blob, DWORD Trigger )
Smart Tools
84
Parmetros
Parmetros char* Property Descripcin Nombre de la propiedad. Se debe usar siempre el nombre de la propiedad en ingls. A un trigger dentro de un evento se le debe transferir un puntero NULL. Puntero a la variable de resultado de la funcin "GenerateBLOB". ID de trigger: NOTDEFINED = trigger introducido en el BLOB MOUSECLICK = clic del ratn MOUSELBUTTONDOWN = pulsar botn izquierdo del ratn MOUSELBUTTONUP = soltar botn izquierdo del ratn MOUSERBUTTONDOWN = pulsar botn derecho del ratn MOUSERBUTTONUP = soltar botn derecho del ratn KEYBOARDDOWN = pulsar tecla KEYBOARDUP = soltar tecla OBJECTCHANGE = cambiar objeto PROPERTYCHANGE = cambiar propiedad PICTUREOPEN = abrir imagen PICTURECLOSE = cerrar imagen
AP_BLOB* Blob DWORD TriggerID
Valor de retorno
Valor de retorno Valor de retorno BOOL TRUE = Funcin ejecutada correctamente. FALSE = Funcin ejecutada con errores.
Ejemplo
Consulte el ejemplo en la funcin GenerateBLOB.
85
AddTimeTrigger
La funcin complementa la accin con un trigger del tipo "Trigger cclico".
Sintaxis
BOOL AddTimeTrigger (AP_BLOB* Blob, char* Name, DWORD TriggerType, DWORD GraphCycleType, DWORD CycleID )
Parmetros
Parmetros AP_BLOB* Blob char* Name DWORD TriggerType Descripcin Puntero a la variable de resultado de la funcin "GenerateBLOB". Nombre del evento. Es una cadena ASCII cualquiera. El nombre se indica en la ventana de la accin como nombre de evento. Tipo de trigger cclico: 2 = Ciclo de tiempo (ciclo estndar) 4 = Ciclo del objeto grfico Tipo de ciclo del objeto grfico: 0= ciclo de ventana 1 = ciclo de imagen Ciclo de trigger: 0 = Al cambiar 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 = Ciclo de usuario 1 12 = Ciclo de usuario 2 13 = Ciclo de usuario 3 14 = Ciclo de usuario 4 15 = Ciclo de usuario 5
DWORD GraphCycleType
DWORD CycleID
Valor de retorno
Valor de retorno BOOL TRUE = Funcin ejecutada correctamente. FALSE = Funcin ejecutada con errores.
Smart Tools
86
Ejemplo
El tiempo que transcurre entre dos disparos de accin es 1 segundo.
BOOL FctRet; .. FctRet = AddTimeTrigger(blob, "1 sec", 2, 0, 3);
87
AddVarTrigger/AddVarTriggerEx
La funcin complementa la accin con un trigger del tipo "Trigger de variables".
Sintaxis
BOOL AddVarTrigger (AP_BLOB* Blob, char* EventName, char* VarName ) BOOL AddVarTriggerEx (AP_BLOB* Blob, char* EventName, char* VarName, DWORD CycleID )
Parmetros
Parmetros AP_BLOB* Blob char* EventName char* VarName DWORD CycleID Descripcin Puntero a la variable de resultado de la funcin "GenerateBLOB". Nombre del evento. Es una cadena ASCII cualquiera. El nombre se indica en la ventana de la accin como nombre de evento. Nombre de la variable WinCC que dispara el trigger o que participa en el mismo. Ciclo de trigger: 0 = Al cambiar 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 = Ciclo de usuario 1 12 = Ciclo de usuario 2 13 = Ciclo de usuario 3 14 = Ciclo de usuario 4 15 = Ciclo de usuario 5 En la funcin AddVarTrigger est predeterminado el valor CycleID = 4.
Valor de retorno
Smart Tools
88
Ejemplo
En el tipo de trigger "Variable" se ha introducido como trigger la variable 'StartTurbine1'. La accin se inicia tan pronto como cambie el valor de dicha variable.
BOOL FctRet
FctRet = AddVarTriggerEx(blob,"Turbine Start","StartTurbine1",0);
89
SetValidateFct
El nombre de una funcin de verificacin se comunica al Dynamic Wizard. Mediante esta funcin se pueden verificar las opciones y los parmetros de trigger. Si se obtiene un resultado de verificacin negativo, se puede provocar una nueva entrada. La funcin de verificacin se activa haciendo clic en el botn "Siguiente" del cuadro de dilogo "Seleccionar opciones" o del cuadro de dilogo "Definir trigger". Si se obtiene un resultado de verificacin positivo, se sale del cuadro de dilogo y se visualiza la siguiente pgina. Si se obtiene un resultado de verificacin negativo, el cuadro de dilogo permanece abierto. Slo tras haber introducido los parmetros correctos es posible continuar. La funcin de verificacin es efectiva a partir del momento en que se activa en el Dynamic Wizard. Tambin tiene efecto en las ventanas de opcin siguientes. Si ninguna funcin de verificacin debe tener efecto, o bien si debe aplicarse una funcin de verificacin diferente, es preciso activar una funcin dummy (con un resultado de verificacin positivo) u otra funcin de verificacin.
Sintaxis
BOOL SetValidateFct (LPCSTR FctName)
Parmetros
Parmetros LPCSTR FctName Descripcin Nombre de la funcin de verificacin como cadena ASCII.
Valor de retorno
Valor de retorno BOOL Resultado de la verificacin TRUE = resultado de verificacin positivo. FALSE = resultado de verificacin negativo.
Ejemplo
El extracto siguiente del archivo "Instanzobjekt.wnf" muestra la utilizacin de esta funcin. La funcin del Wizard se ha complementado con una funcin de verificacin.
... ...
// Validacin opcin 1
Smart Tools
90
BOOL ValidateOpt1(void) {
// Property seleccionada
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, ""); .. }
91
EnumProperty/EnumPropertyEx
La funcin EnumProperty lista las propiedades de un objeto. En la funcin EnumPropertyEx se pueden especificar las propiedades del objeto que se deben listar.
Sintaxis
BOOL EnumProperty (char* FName, LPVOID pItem, DWORD dwFlags ); BOOL EnumPropertyEx (LPCTSTR Projectname, LPCTSTR Picturename, LPCTSTR Objectname, char* FName, LPVOID pItem, DWORd dwFlags );
Parmetros
Parmetros LPCTSTR Projectname LPCTSTR Picturename LPCTSTR Objectname char* FName LPVOID pItem Descripcin Puntero al nombre del proyecto, incluyendo el directorio y la extensin de archivo. Puntero al nombre de la imagen cuyos objetos se deben listar. Se distingue entre maysculas y minsculas. Puntero al nombre del objeto Nombre de la funcin Callback que se llama una vez para cada propiedad de objeto. Puntero a datos especficos de la aplicacin que se transfiere a la funcin Callback. Este puntero no es evaluado por la funcin, sino que se pone a disposicin nuevamente en la funcin Callback. dwFlags especifica los tipos de propiedad a listar. De momento son posibles los siguientes datos: PropertyHasDynamic (valor: 0x0001) Slo se enumeran las propiedades de objeto que poseen una dinamizacin. PropertyHasEvents (valor: 0x0002) Slo se enumeran las propiedades de objeto que poseen un evento. PropertyIsDynamicable (valor: 0x0003) Slo se enumeran las propiedades de objeto que son dinamizables.
DWORD dwFlags
Valor de retorno
Valor de retorno BOOL TRUE = Se listan las propiedades de un tipo de objeto FALSE = Error
Smart Tools
92
Ejemplo
El extracto siguiente del archivo "Dynamic Property.wnf" muestra la utilizacin de esta funcin.
... ... // Funcin 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,"Propiedades del objeto actual :"); LBHwnd=CreateListbox(0, 30, g_Headline, 8, &g_indexProperty); EnumProperty("EnumFct", LBHwnd, 3); GetWindowRect(GetParent(LBHwnd), &rect); ...
93
4.5.14
Funciones de WinCC del Wizard

GetProjectName
Esta funcin averigua la ruta del proyecto WinCC actual.
Sintaxis
LPCSTR GetProjectName ( void )
Valor de retorno
Valor de retorno LPCSTR Puntero a la cadena ASCII del archivo MCP
Ejemplo
LPCSTR Name; Name = GetProjectName(); La funcin arroja p. ej. el siguiente resultado: C:\Siemens\WinCC\WinCCProjects\Example.mcp
Smart Tools
94
4.5.14.2 Descripcin
GetPictureName
Esta funcin averigua el nombre de la imagen actual (*.pdl).
Sintaxis
LPCSTR GetPictureName ( void )
Valor de retorno
Valor de retorno LPCSTR Puntero a la cadena ASCII del archivo PDL.
Ejemplo
LPCSTR Name; Name = GetPictureName(); La funcin arroja p. ej. el siguiente resultado: TurbineControl.PDL
95
4.5.14.3 Descripcin
GetDefaultWNFPath
Esta funcin averigua la ruta del directorio WNF actual.
Sintaxis
LPCSTR GetDefaultWNFPath ( void )
Valor de retorno
Valor de retorno LPCSTR Puntero a la cadena ASCII del nombre de ruta.
Ejemplo
LPCSTR Name; Name = GetDefaultWNFPath(); La funcin arroja p. ej. el siguiente resultado: C:\Siemens\WinCC\wscripts\wscripts.esp\
Smart Tools
96
GetObjectName
Esta funcin averigua el nombre del objeto grfico seleccionado en la imagen actual.
Sintaxis
LPCSTR GetObjectName ( void )
Valor de retorno
Valor de retorno LPCSTR Puntero a la cadena ASCII del nombre de objeto.
Ejemplo
LPCSTR Name; Name = GetObjectName(); La funcin arroja p. ej. el siguiente resultado: Button1
97
4.5.14.5 Descripcin
InsertXRefSection
Esta funcin inserta en el cdigo fuente transferido una seccin segn la notacin Xref, de tal manera que las variables y los nombres de imagen transferidos queden introducidos como Define.
Sintaxis
BOOL InsertXRefSection (char * SourceCode, char* TagName[], int TagCount, char* PictName[], int PictCount)
Parmetros
Parmetros char *SourceCode char *TagName[] int TagCount char *PictName[] int PictCount Descripcin Bfer de cdigo en el que debe insertarse la seccin Xref. NULL o campo de nombres de variables a insertar en la seccin Xref. Cantidad de nombres de variables en el campo TagName[] NULL o campo de nombres de imagen a insertar en la seccin Xref Cantidad de nombres de imagen en el campo PictName[]
Valor de retorno
Valor de retorno BOOL char *TagName[] char *PictName[] El valor del resultado indica si la funcin se ha ejecutado correctamente. Campo de Defines para las variables transferidas en la misma posicin Campo de Defines para las imgenes transferidas en la misma posicin
Smart Tools
98
Ejemplo
char* szPictureArray[1]; char szPictName[255]; char szSourceCode[1100]; strcpy(szPictName, "Newpdl.pdl"); szPictureArray[0] = szPictName; strcpy(szSourceCode, ""); InsertXrefSection(szSourceCode,NULL,0,szPictureArray,1); Resultado arrojado por la funcin: 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"
99
4.5.15
Funciones Progress del Wizard

Funciones Progress del Wizard
Las funciones Progress sirven para visualizar el progreso (en %) de un proceso en una ventana de progreso.
Al crear una barra de progreso (CreateProgressDlg) se predeterminan un valor inicial y un valor final as como un incremento. El valor inicial corresponde al progreso 0% y el valor final al progreso 100%. El incremento define los pasos en que puede variar el progreso. Generalmente, el valor inicial es = 0 y el incremento = 1. El valor final equivale a la cantidad de etapas de procesamiento del proceso. En el procesamiento, el progreso se aumenta en un incremento (Progress_StepIt) o se ajusta a un valor definido (Progress_SetPos). Al final del procesamiento se debe borrar la barra de progreso (DestroyProgressDlg). En la barra de progreso se puede visualizar un texto (Progress_SetStatus), p. ej. el texto "Crear objetos grficos". ste se puede modificar durante el procesamiento, con objeto de diferenciar entre distintos procesos parciales. Generalmente no es posible subdividir el procesamiento de manera que se logre una visualizacin lineal del progreso. Esto tampoco es estrictamente necesario. La visualizacin del progreso en curso es suficiente.
Smart Tools
100
CreateProgressDlg
En una barra de progreso se visualiza el progreso de un proceso en el rango comprendido entre 0 y 100%.
Sintaxis
PROGRESS_DLG CreateProgessDlg (int nLower, int nUpper, int nStepInc )
Parmetros
Parmetros int nLower int nUpper int nStepInc Descripcin Valor inicial del progreso (equivale a 0%) Valor final del progreso (equivale a 100 %) Incremento del progreso
Valor de retorno
Valor de retorno PROGRESS_DLG Handle del objeto
4.5.15.3 Descripcin
Progress_SetStatus
En la barra de progreso se introduce un texto como ttulo.
Sintaxis
void Progress_SetStatus (PROGRESS_DLG hDlg, char* ActionName )
Parmetros
Parmetros PROGRESS_DLG hDlg char* ActionName Descripcin Handle del objeto Texto del ttulo
101
4.5.15.4 Descripcin
Progress_Steplt
El progreso de un proceso se aumenta en un incremento.
Sintaxis
void Progress_Steplt (PROGRESS_DLG hDlg )
Parmetros
Parmetros PROGRESS_DLG hDlg Descripcin Handle del objeto
4.5.15.5 Descripcin
Progress_SetPos
El progreso se ajusta en la barra de progreso a un valor definido. Este valor debe estar comprendido entre el valor inicial y el valor final.
Sintaxis
void Progress_SetPos (PROGRESS_DLG hDlg, int nPos )
Parmetros
Parmetros PROGRESS_DLG hDlg int nPos Descripcin Handle del objeto Valor del progreso
Smart Tools
102
DestroyProgressDlg
Se cierra la barra de progreso.
Sintaxis
void DestroyProgressDlg (PROGRESS_DLG hDlg )
Parmetros
Parmetros PROGRESS_DLG hDlg Descripcin Handle del objeto
103
4.5.16
Funciones de Windows del Wizard

Funciones de Windows del Wizard
A continuacin se describen brevemente las funciones de Windows que pueden o deben utilizarse en relacin con las funciones de sistema del Wizard (en particular con las funciones de ventanas para la entrada de parmetros). Para ms informacin al respecto, consulte el Microsoft Developers Studio /Win32 SDK Programmer's Reference.
GetParent
Para una ventana se determina el handle de la ventana padre p. ej. del handle de una ventana de opciones.
Sintaxis
HWND GetParent (HWND hWnd )
Parmetros
Parmetros HWND hWnd Descripcin Handle de la ventana para la que se debe determinar la ventana padre.
Valor de retorno
Valor de retorno HWND Handle de la ventana padre NULL = No existe ninguna ventana padre.
Smart Tools
104
GetWindowRect
Se determinan el tamao y las coordenadas de una ventana, p. ej. el tamao de una ventana de opciones.
Sintaxis
BOOL GetWindowRect (HWND hWnd, LPRECT lpRect )
Parmetros
Parmetros HWND hWnd LPRECT lpRect Descripcin Handle de la ventana Puntero a una variable de resultado estructurada
Valor de retorno
Valor de retorno BOOL LPRECT lpRect TRUE = Funcin ejecutada correctamente. FALSE = Funcin ejecutada con errores. Variable de resultado segn la estructura LPRECT con los componentes estructurales: LONG left: Coordenada X de la esquina superior izquierda LONG top: Coordenada Y de la esquina superior izquierda LONG right: Coordenada X de la esquina inferior derecha LONG bottom: Coordenada Y de la esquina inferior derecha
105
MoveWindow
Se modifican la posicin y las dimensiones de una ventana, p. ej. la posicin y el tamao de los campos de entrada en la ventana de opciones.
Sintaxis
BOOL MoveWindow (HWND hWnd, int x, int y, int nWidth, int nHeight, BOOL bRepaint )
Parmetros
Parmetros HWND hWnd int x int y, int nWidth int nHeight BOOL bRepaint Descripcin Handle de la ventana Coordenada X de la esquina superior izquierda Coordenada Y de la esquina superior izquierda Ancho Altura TRUE = La ventana se est redibujando.
Valor de retorno
Smart Tools
106
SendMessage
Se enva un mensaje a una ventana. La funcin se utiliza p. ej. para rellenar un campo de seleccin.
Sintaxis
LRESULT SendMessage (HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam )
Parmetros
Parmetros HWND hWnd UINT Msg, WPARAM wParam LPARAM lParam Descripcin Handle de la ventana Tipo de mensaje: LB_INSERTSTRING = Insertar texto en un cuadro de lista 1. Parmetros del mensaje: -1 = El texto se aade al final. 2. Parmetros del mensaje: Puntero al texto
Valor de retorno
Valor de retorno LRESULT Handle del objeto
107
GetWindow
Esta funcin determina el handle de la ventana que tiene una relacin especial con otra ventana (ventana original).
Sintaxis
GetWindow (HWND hWnd, UINT uCmd )
Parmetros
Parmetros HWND hWnd UINT uCmd Descripcin Handle de la ventana original Relacin GW_HWNDFIRST = primera ventana
Valor de retorno
Valor de retorno HWND Handle de la ventana encontrada o NULL
Smart Tools
108
ShowWindow
Se define el tipo de visualizacin de una ventana.
Sintaxis
ShowWindow (HWND hWnd, int nCmdShow )
Parmetros
Parmetros HWND hWnd int nCmdShow Descripcin Handle de la ventana Estado de visualizacin de la ventana SW_HIDE = oculta
Valor de retorno
Valor de retorno BOOL TRUE = ventana visible FALSE = ventana oculta
109
MessageBox
La funcin sirve para visualizar un mensaje al usuario si ha ocurrido un error o si se precisa la intervencin del usuario. El aviso se visualiza con un mensaje especfico del usuario, ttulo y botn. ATENCIN Puede ocurrir que no pueda manejarse el sistema si la MessageBox se encuentra en segundo plano y no se puede cerrar. Por ello, al abrir la MessageBox, active el flag "MB_SYSTEMMODAL".
Sintaxis
int MessageBox (HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption, UINT uType )
Parmetros
Parmetros HWND hWnd LPCTSTR lpText LPCTSTR lpCaption UINT uType Descripcin Handle de la ventana padre NULL = El aviso no tiene ventana padre. Texto del mensaje Texto del ttulo MB_SYSTEMMODAL = impide que se bloquee el sistema mientras est abierto el MessageBox. Tipo de cuadro: MB_OK = Aviso con un botn 'Aceptar' - Botn MB_OKCANCEL = Aviso con los botones 'Aceptar' y 'Cancelar'
Valor de retorno
Valor de retorno int ID del botn pulsado: IDOK = botn 'Aceptar' pulsado IDCANCEL = botn 'Cancelar' pulsado
Smart Tools
110
Ejemplo
int RetMsg; RetMsg = MessageBox (NULL, "Error al llamar las funciones API", "Error de sistema", MB_SYSTEMMODAL | MB_OK);
111
Dynamic Wizard Editor 4.6 Ejemplos
4.6
Ejemplos
4.6.1
Introduccin
Ejemplos
Esta descripcin contiene dos ejemplos para la utilizacin de las funciones del Dynamic Wizard: Demo Wizard Dinamizar el motor
4.6.2
4.6.2.1 Introduccin
Demo Wizard
Demo Wizard
En el archivo "Demo.wnf" se crea un Dynamic Wizard denominado "Demo Wizard". Este Dynamic Wizard muestra las funciones bsicas que estn a disposicin del usuario, con el fin de facilitarle la entrada de datos. Sin embargo, el Demo Wizard no ejecuta ninguna accin.
4.6.2.2 Requisitos
Cmo crear una funcin del Dynamic Wizard para el Demo Wizard
Un proyecto WinCC debe estar abierto.
Procedimiento
1. En el Explorador de Windows, copie el archivo "Demo.wnf" del directorio "Siemens\ WinCC\ documents\ spanish" en el directorio "Siemens\ WinCC\ wscript\ wscript.esp". 2. Inicie el Dynamic Wizard Editor. 3. En el Dynamic Wizard Editor, elija el comando de men "Archivo > Abrir". Se abrir el dilogo de seleccin de archivos. 4. Seleccione el archivo "Demo.wnf". Haga clic en el botn "Abrir". El archivo "Demo.wnf" se visualiza en una ventana de edicin. 5. Haga clic en el botn de la barra de herramientas para compilar el script. El resultado se visualiza en la ventana de resultados.
Smart Tools
112
4.6.2.3 Introduccin
Cmo crear el texto de ayuda
En este apartado se crea una ayuda para el dilogo "Seleccionar un trigger".
Procedimiento
1. Haga clic en el botn de la barra de herramientas. Se abrir el editor de Ayuda. 2. Seleccione en el campo "Wizard - Grupo" la entrada "Ejemplo". 3. Seleccione en el campo "Wizard - Nombre" la entrada "Demo Wizard". 4. Seleccione en el campo "Pgina" la entrada "TriggerPage". 5. Introduzca en el campo "Texto de ayuda:" el siguiente texto: "Seleccionar un trigger En este dilogo puede definir el evento que debe disparar una accin." 6. Cierre el editor de ayuda mediante el botn "Aceptar". 7. Ejecute el Demo Wizard. Haga clic en el botn "Ayuda" del cuadro de dilogo "Seleccionar un trigger".
113
4.6.2.4 Introduccin
Cmo insertar el script "Demo.wnf" en la base de datos
Para poder utilizar la funcin del Dynamic Wizard "Demo.wnf" en el Graphics Designer, sta debe integrarse en la base de datos del Dynamic Wizard. Para ello deben realizarse los siguientes pasos: 1. Lectura del script del Wizard 2. Creacin del archivo cwd
Procedimiento
1. Haga clic en el botn de archivos. 3. Haga clic en el botn de la barra de herramientas. Se abrir el dilogo de seleccin
2. Seleccione el archivo "Demo.wnf". Haga clic en el botn "Abrir". de la barra de herramientas para crear la base de datos. 4. En el Dynamic Wizard Editor, elija el comando de men "Ver > Dynamic Wizard".
5. Haga clic en la ficha "Ejemplo". Haga doble clic en la entrada "Demo Wizard".
Smart Tools
114
4.6.3
4.6.3.1 Introduccin
Dinamizar el motor
Dinamizar el motor
En el archivo de script "Motor.wnf" se crea un Dynamic Wizard denominado "Dinamizar el motor". Nota ste ha sido creado especialmente para dinamizar un objeto de usuario denominado "Motor" y no se puede utilizar en ningn otro tipo de objeto.
4.6.3.2 Requisitos
Cmo crear una funcin del Dynamic Wizard para el motor
Un proyecto WinCC debe estar abierto.
Procedimiento
1. En el Explorador de Windows, abra el archivo comprimido "Motor.zip" en el directorio "Siemens\ WinCC\ documents\ spanish". 2. Extraiga el archivo "Motor.wnf" en el directorio "..\WinCC\wscripts\wscripts.esp". 3. Extraiga el archivo "Motor_dyn.pdl" en el directorio "..\WinCC\WinCCProjects\nombre del proyecto WinCC\GraCs". 4. Inicie el Dynamic Wizard Editor. 5. En el Dynamic Wizard Editor, elija el comando de men "Archivo > Abrir". Se abrir el dilogo de seleccin de archivos. 6. Seleccione el archivo "Motor.wnf". Haga clic en el botn "Abrir". El archivo "Motor.wnf" se visualiza en una ventana de edicin. 7. Haga clic en el botn de la barra de herramientas para compilar el script. El resultado se visualiza en la ventana de resultados.
115
4.6.3.3 Introduccin
Cmo insertar el script "Motor.wnf" en la base de datos.
Para poder utilizar la funcin del Dynamic Wizard "Motor.wnf" en el Graphics Designer, sta debe integrarse en la base de datos del Dynamic Wizard. Para ello deben realizarse los siguientes pasos: 1. Lectura del script del Wizard 2. Creacin del archivo cwd
Procedimiento
1. Haga clic en el botn de archivos. 3. Haga clic en el botn de la barra de herramientas. Se abrir el dilogo de seleccin
2. Seleccione el archivo "Motor.wnf". Haga clic en el botn "Abrir". de la barra de herramientas para crear la base de datos.
Smart Tools
116
4.6.3.4 Introduccin
Cmo dinamizar el objeto de usuario "Motor"
El objeto de usuario Motor se vincula con una variable de estructura WinCC del tipo "MotorStruct" mediante el Dynamic Wizard "Dinamizar el motor" . Para ello se crean diferentes acciones C y conexiones de variables en este objeto. Este Wizard no se puede utilizar en ningn otro tipo de objeto.
Requisitos
Cree una variable interna "T08i_course_wiz_selected" del tipo de datos "Variable de texto, juego de caracteres 8 bits". Cree una estructura con el nombre "MotorStruct" y tres elementos internos denominados "Activ", "Hand" y "Error" del tipo de datos BIT. Cree una variable interna denominada "STR_Course_wiz1" del tipo de datos "MotorStruct".
Procedimiento
1. Abra el Graphics Designer. Elija el comando de men "Archivo > Abrir". En el dilogo de seleccin de archivos, seleccione la imagen "Motor_dyn.pdl". 2. Seleccione el objeto de usuario Motor. En la ficha "Ejemplo" se ofrece el Wizard "Dinamizar el motor".
3. Inicie el Dynamic Wizard. En el cuadro de dilogo "Bienvenido al Dynamic Wizard", haga clic en el botn "Siguiente". Se abrir el dilogo "Definir opciones". 4. En el dilogo "Definir opciones", haga clic en el botn Examinar. Se abrir el dilogo de seleccin de variables. Seleccione la entrada "STR_Course_wiz1" como variable de estructura. Cierre el cuadro de dilogo haciendo clic en el botn "Aceptar". 5. En el dilogo "Definir opciones", haga clic en el botn "Siguiente". Se abrir el cuadro de dilogo "Listo". Cierre el cuadro de dilogo haciendo clic en el botn "Finalizar". 6. Guarde la imagen. Active Graphics Designer Runtime. 7. Los valores de variables del motor seleccionado se pueden simular mediante los botones de comando.
117
4.6.3.5 Introduccin
Cmo crear la estructura y la variable de estructura
En este apartado se explica cmo configurar la estructura "MotorStruc" y la variable de estructura "STR_Course_wiz1". La estructura y la variable de estructura se emplean en el ejemplo "Dinamizar el motor".
Procedimiento
1. En el men contextual "Tipos de estructura", elija el comando "Nueva estructura". Se abrir el cuadro de dilogo "Propiedades de estructura". 2. Cambie el nombre de la estructura a "MotorStruc". Haga clic en el botn "Nuevo elemento" y cree una variable interna "Active" del tipo de datos BIT. 3. Haga clic en el botn "Nuevo elemento" y cree una variable interna "Hand" del tipo de datos BIT. 4. Haga clic en el botn "Nuevo elemento" y cree una variable interna "Error" del tipo de datos BIT. Cierre el cuadro de dilogo haciendo clic en el botn "Aceptar". 5. En la ventana de navegacin, haga clic en el "+" (signo ms) antepuesto al icono "Administracin de variables". En el men contextual "Variables internas", elija el comando "Nueva variable". Cree una variable WinCC "STR_Course_wiz1" del tipo de datos "MotorStruct".
Smart Tools
118
Documentation Viewer
5.1 WinCC Documentation Viewer
Descripcin breve
Los trabajos de impresin del sistema de informes de WinCC se pueden desviar a un archivo. Si se trabaja con un gran volumen de datos, se crea un archivo para cada pgina del informe. El WinCC Documentation Viewer sirve para visualizar e imprimir estos archivos.
5.2
Instalacin del WinCC Documentation Viewer

El WinCC Documentation Viewer se puede instalar de dos maneras:
Procedimiento
1. En el setup de WinCC en el cuadro de dilogo "Programas", seleccione la entrada "WinCC V7 completo". WinCC se instala con SmartTools, WinCC ConfigurationTool y WinCC Archive ConfigurationTool. El WinCC Documentation Viewer se inicia mediante "SIMATIC > WinCC > Tools".

WinCC Documentation Viewer tambin se puede instalar desde el DVD de WinCC. 1. Pase, en el DVD de WinCC, al directorio "WinCC\InstData\Smarttools\Setup". 2. Haga doble clic en el archivo "setup.exe". 3. En el cuadro de dilogo "Componentes", seleccione la entrada "WinCC Documentation Viewer". 4. Haga clic en el botn "Siguiente". Siga las instrucciones de la pantalla.
Nota Si est activado un proyecto WinCC, slo se pueden ver e imprimir los archivos emf de dicho proyecto. Si WinCC no est activado, se pueden abrir e imprimir todos los archivos emf por medio del WinCC Documentation Viewer.
119
Documentation Viewer 5.3 Descripcin
5.3
Introduccin
Descripcin
Los trabajos de impresin se pueden desviar a un archivo. Si se trabaja con un gran volumen de datos, se crea un archivo para cada pgina del informe. Con el WinCC Documentation Viewer se pueden visualizar e imprimir estos archivos. Nota Si al iniciar el WinCC Documentation Viewer ya hay un proyecto WinCC activado, slo se pueden visualizar e imprimir los archivos emf de dicho proyecto. Si, al iniciar el Viewer, el proyecto WinCC est abierto pero no activado, se pueden abrir e imprimir todos los archivos emf mediante el Viewer. El Viewer se cierra en todo caso cuando se desactiva Runtime.
El WinCC Documentation Viewer est subdividido en tres reas. En el borde superior de la pantalla se encuentra la barra de mens. A travs de la ayuda directa se explican los comandos de men. La barra de herramientas se encuentra directamente debajo de la barra de mens. Las funciones frecuentes (p. ej. avanzar y retroceder) estn disponibles aqu en forma de botones. Las funciones de los distintos botones se explican a travs de la ayuda directa. En la ventana se representa el documento actual. La representacin se puede ampliar en dos niveles diferentes haciendo clic. En el borde inferior de la pantalla se encuentra la barra de estado, que muestra informacin acerca de la accin actual.
Smart Tools
120
Documentation Viewer 5.4 Creacin de archivo(s) .emf
5.4
Introduccin
Creacin de archivo(s) .emf
Los trabajos de impresin se pueden desviar a un archivo. Si se trabaja con un gran volumen de datos, se crea un archivo para cada pgina del informe. La salida de impresin se efecta en uno o varios archivos .emf. Los archivos se guardan con el nombre Page<nnnnnn>.emf en la ruta, siendo <nnnnn> un nmero consecutivo de cinco dgitos. El nombre de la ruta comprende: la ruta del proyecto (p. ej. "C:\VFSWinCC\PRT\") as como la <ubicacin> + <JJJJMMTTHHMM> (JJJJ = ao, MM = mes, TT = da, HH = hora, MM = minuto). Si se introducen "Datos PD" en el campo "Ubicacin", se crea dentro del directorio de proyecto la siguiente estructura de ruta para el trabajo de impresin.
Procedimiento
1. En el WinCC Editor, elija el comando de men "Archivo > Configurar documentacin de proyecto". 2. En el cuadro de dilogo "Propiedades de los trabajos de impresin", haga clic en el botn "Configurar impresora". 3. En la ficha "Configurar impresora", active la casilla de verificacin "Archivo (*.emf)". Si no desea una salida simultnea en la impresora, desactive la casilla de verificacin "Impresora". 4. En el campo "Ubicacin", introduzca el nombre de la ruta en la que debe guardarse el archivo. Cierre el cuadro de dilogo haciendo clic en el botn "Aceptar". 5. Elija el comando de men "Archivo > Imprimir documentacin del proyecto". La salida de impresin se efecta en uno o varios archivos .emf. Los archivos se guardan con el nombre Page<nnnnnn>.emf en la ruta, siendo <nnnnn> un nmero consecutivo de cinco dgitos.
121
Documentation Viewer 5.4 Creacin de archivo(s) .emf
Smart Tools
122
WinCC CrossReferenceAssistant
6.1 WinCC CrossReferenceAssistant
Descripcin breve
WinCC CrossReferenceAssistant es una herramienta que busca nombres de imagen y variables en scripts, complementando los scripts en cuestin de manera que el componente de WinCC Cross Reference encuentre los nombres de imagen y variables, y los incluya en la lista de referencias cruzadas.
6.2
Instalacin del CrossReferenceAssistant

La interfaz de usuario del WinCC CrossReferenceAssistant est disponible en alemn, ingls y francs.
Procedimiento
1. En el setup de WinCC en el cuadro de dilogo "Programas", seleccione la entrada "WinCC V7 completo". WinCC se instala con SmartTools, WinCC ConfigurationTool y WinCC Archive ConfigurationTool. El WinCC CrossReferenceAssistant se inicia mediante "SIMATIC > WinCC > Tools".

WinCC CrossReferenceAssistant tambin se puede instalar desde el DVD de WinCC. 1. Pase, en el DVD de WinCC, al directorio "WinCC\InstData\Smarttools\Setup". 2. Haga doble clic en el archivo "setup.exe". 3. Seleccione en el cuadro de dilogo "Componentes" la entrada "CrossReferenceAssistant". 4. Haga clic en el botn "Siguiente". Siga las instrucciones de la pantalla.
123
WinCC CrossReferenceAssistant 6.3 General
6.3
Introduccin
General
WinCC permite crear listas de referencias cruzadas (CrossReference). Para que, durante la creacin de estas listas, puedan detectarse correctamente la variables en las llamadas a funciones, WinCC se ha complementado con una regla de configuracin que prev lo siguiente: Para poder buscar y reemplazar los nombres de variables o imgenes utilizados en acciones C, el script se tiene que escribir del siguiente modo:
Principio
Al comienzo del script deben declararse en dos secciones todas las variables y nombres de imagen utilizados. En estas secciones no se puede introducir ninguna instruccin ms. Estas secciones tienen la siguiente estructura: // WINCC:TAGNAME_SECTION_START // sintaxis: #define TagNameInAction DMTagName // next TagID : 1 #define ApcVarName1 "VarName1" // WINCC:TAGNAME_SECTION_END // WINCC:PICNAME_SECTION_START // sintaxis: #define PicNameInAction PictureName // next PicID : 1 #define ApcBildname1 "Bildname1" #define ApcBildname2 "Bildname2" #define ApcBildname3 "Bildname3" // WINCC:PICNAME_SECTION_END La llamada a las funciones estndar para leer o escribir las variables debe efectuarse entonces a travs de las variables e imgenes definidas. GetTagDWord (ApcVarName1); OpenPicture(ApcBildname1); SetPictureName( ApcBildname2, "Bildfenster1",ApcBildname3); Si no se respeta esta regla de configuracin, no se pueden crear listas CrossReference, ya que las referencias de las variables e imgenes en los scripts no se pueden deshacer. El WinCC CrossReferenceAssistant reemplaza todas las llamadas a funciones conocidas en la gestin de scripts de la forma descrita ms arriba. Slo se convierten funciones de proyecto, imgenes y acciones. El entorno de runtime para el WinCC CrossReferenceAssistant es WinCC. Si WinCC no se ha iniciado o el proyecto a convertir no est cargado, el WinCC CrossReferenceAssistant se encarga de iniciar WinCC y/o de que WinCC cargue el proyecto.
Smart Tools
124
WinCC CrossReferenceAssistant 6.4 Funciones conocidas (gestin de scripts)
6.4
Funciones conocidas (gestin de scripts)

El Wizard conoce las siguientes funciones de manera estndar y las aplica durante la conversin.
Funciones con variables como parmetros:

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()
Smart Tools
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
Funciones con nombres de imagen como parmetros:

SetPictureName() GetPictureName() GetVisible() SetVisible() GetLink() SetLink() Set_Focus() OpenPicture() GetLinkedVariable()
Smart Tools
128
WinCC CrossReferenceAssistant 6.5 Seleccin de proyectos
6.5
Seleccin de proyectos
Haciendo en el botn "..." se abre el cuadro de dilogo OpenFile que permite seleccionar un proyecto cualquiera. Si se hace clic en "Proyecto actual", el WinCC CrossReferenceAssistant intenta leer y visualizar el proyecto cargado actualmente en WinCC . Si WinCC no se ha iniciado an o si no se ha cargado ningn proyecto, se iniciar WinCC o se cargar el proyecto deseado. Si se ha cargado ya otro proyecto, pero no est activado, se cerrar el proyecto y se abrir el proyecto deseado. Este proceso puede tardar varios minutos. Tan pronto como aparezca el requerimiento "Seleccione un proyecto WinCC:" y se haya introducido texto en la lnea de entrada, se puede hacer clic en el botn "Siguiente >". Se verifica si el proyecto indicado es efectivamente un proyecto WinCC vlido. De no ser as, se destaca la lnea de entrada y aparece una ventana con una advertencia sobre el error correspondiente. "Cancelar" finaliza el WinCC CrossReferenceAssistant.
129
WinCC CrossReferenceAssistant 6.6 Seleccin de archivos
6.6
Seleccin de archivos
Todas la imgenes, funciones de proyecto y acciones C pertenecientes al proyecto se visualizan en la lista derecha del cuadro de dilogo. En el ajuste estndar se convierten todos los archivos pertenecientes al proyecto.
El usuario tiene la libertad de excluir determinados archivos de la conversin y, si as lo desea, volver a incluirlos ms tarde. Para borrar un elemento de la lista de conversin es preciso efectuar una seleccin (mltiple) de los archivos correspondientes en la lista "Archivos a convertir" y luego hacer clic en el botn "<--Quitar". Los archivos eliminados se visualizan en la lista izquierda y se pueden volver a incluir en la conversin. Para este fin, estos archivos deben seleccionarse en la lista "Seleccionar archivos". Haciendo clic en el botn "Agregar-->", stos se vuelven a incluir en la lista derecha "Archivos a convertir". Una vez finalizada la seleccin de archivos, haga clic en "Siguiente >". A continuacin, todos los archivos indicados se leen y analizan. < Atrs"permite retroceder a la seleccin de proyectos, "Cancelar" finaliza el WinCC CrossReferenceAssistant.
Smart Tools
130
WinCC CrossReferenceAssistant 6.7 Conversin
6.7
Introduccin
Conversin
La ltima pgina del Wizard que se visualiza, permite por una parte efectuar "Ajustes adicionales" (vase "Configuracin adicional") y por la otra ver el progreso una vez iniciada la conversin, as como el archivo que se est editando.
Descripcin
"< Atrs" permite retroceder a la seleccin de archivos, "Cancelar" finaliza el WinCC CrossReferenceAssistant. Para iniciar la conversin del script, haga clic en "Finalizar". Una vez iniciada la conversin, no se puede retroceder ("< Atrs"), ni tampoco hacer clic en "Configuracin adicional". Durante la conversin se indica en la barra de progreso el porcentaje de la conversin que ha finalizado hasta ese momento. Adems, se visualiza qu archivo se est convertiendo en ese momento. Durante la conversin se procede del modo siguiente: Se verifica si los scripts contienen llamadas a funciones que requieren parmetros de imagen o variable. Si se encuentra una funcin de este tipo en el script, la secuencia de caracteres que ha sido transferida como parmetro se reemplaza por un Define (vase "Reglas de configuracin").
131
WinCC CrossReferenceAssistant 6.7 Conversin

En un archivo de gestin de scripts se comprueba qu funciones requieren parmetros de imagen o variable. Por lo tanto, todas estas funciones deben haberse introducido en este archivo, de manera que el sistema las pueda reconocer. Mediante la conversin de scripts, la lista de estas funciones se puede ampliar con funciones de proyecto y funciones estndar que tambin requieren parmetros de imagen o variable ("Configuracin adicional"). Una vez finalizada la conversin aparece un resumen de la cantidad de funciones, imgenes, scripts en las imgenes y variables que se han convertido. Si ocurre un error, puede consultar el archivo de informe creado durante la conversin para obtener informacin detallada sobre la causa del error. Este archivo, denominado CCCrossReferenceAssistant.log, se encuentra en el directorio de proyecto.
Smart Tools
132
WinCC CrossReferenceAssistant 6.8 Configuracin adicional
6.8
Configuracin adicional
En caso necesario puede dar a conocer aqu las funciones personalizadas. En la lista "Seleccione una funcin con parmetros de variable o imagen:" se visualizan todas las funciones del proyecto. Si se activa la casilla de verificacin "Mostrar funciones estndar", se visualizan tambin las funciones estndar contenidas en WinCC.
En la lista de funciones, el usuario puede seleccionar las funciones que requieren una variable o imagen como parmetro en una posicin determinada. Todas las funciones seleccionadas aqu se guardan en un archivo de gestin de scripts especfico del proyecto. El CrossReferenceAssistant reconoce slo aquellas funciones con parmetros de imagen o variable que se han dado a conocer al sistema previamente como tales. Para que las llamadas a funciones personalizadas que requieren parmetros de variable tambin se puedan ajustar segn las reglas de configuracin, stas se deben guardar en la gestin de scripts en el curso de la conversin. En el cuadro de dilogo "Funciones en la gestin de scripts" se muestran todas las funciones ya guardadas en la gestin de scripts. Cuando aparece este cuadro de dilogo, se leen los archivos de configuracin estndar y del proyecto y se visualiza el contenido comn de los dos archivos. Para identificar una funcin que requiera parmetros de variable o imagen, es preciso seleccionarla primero en el cuadro combinado "Seleccione una funcin con parmetros de variable o imagen:" . A continuacin se puede definir mediante la lista de parmetros si el parmetro especial representa una variable o una imagen. Haciendo clic en "..." se abre un men contextual que permite elegir si el parmetro seleccionado es una variable o una imagen. El proceso se debe repetir para todos los parmetros que cumplan uno de los dos criterios.
133
WinCC CrossReferenceAssistant 6.8 Configuracin adicional

"Agregar funcin -->" confirma la entrada y agrega la funcin seleccionada a la lista derecha del cuadro de dilogo. Las entradas errneas se pueden deshacer seleccionando en la lista "Funciones en la gestin de scripts" las funciones que deben borrarse y haciendo clic luego en "<-- Quitar funciones seleccionadas" para borrarlas. Haciendo clic en "Cerrar" se escribe la informacin acumulada en los archivos de configuracin, consderando la informacin modificada durante la conversin, y se cierra el cuadro de dilogo.
Smart Tools
134
WinCC Communication Configurator

Descripcin breve
El WinCC Communication Configurator (CCComunicationConfigurator.exe) es una herramienta que permite configurar fcilmente los parmetros de comunicacin de WinCC conforme al entorno de red existente.
Descripcin
El WinCC Communication Configurator (CCComunicationConfigurator.exe) es una herramienta que permite configurar fcilmente los parmetros de comunicacin de WinCC conforme al entorno de red existente. La utilizacin del WinCC Communication Configurator tiene sentido si no se dispone de un Ethernet LAN con una velocidad de transferencia de 100 Mbit/s. Incluso en caso de inestabilidades espordicas en la conexin por sobrecarga en la red (p. ej. si no hay conexin con los servidores de datos, campos ES sin valor visualizado) se recomienda la utilizacin del configurador. Los parmetros estndar de la comunicacin WinCC se han configurado de manera que se reaccione de forma muy sensible a errores de comunicacin, p. ej. para notificar al usuario muy rpidamente si se presentan fallos o tambin para garantizarle a un equipo cliente un tiempo de failover breve con respecto al servidor redundante. En una red con una velocidad de transferencia baja o con una carga de CPU o de red alta, este comportamiento sensible a fallos afecta la estabilidad de las conexiones de red lgicas de WinCC, ya que en los mecanismos subordinados del control de seal de vida no pueden alcanzarse los tiempos de respuesta esperados. El Communication Configurator adapta los parmetros de comunicacin a las circunstancias existentes para garantizar una sintonizacin ptima entre la sensibilidad a los fallos y la estabilidad de la conexin. Nota Si se utiliza el WinCC Communication Configurator, ello se debe efectuar en el equipo cliente WinCC y en el servidor WinCC. El Communication Configurator modifica slo la configuracin de la comunicacin WinCC, pero no los parmetros de las conexiones de comunicacin del sistema operativo.
135
WinCC Communication Configurator
Campo / Opcin 100 Mbit/s 10 Mbit/s 1 Mbit/s 0,1 Mbit/s
Descripcin Aplicable en LANs Ethernet con una velocidad de transferencia de 100 Mbit/s (ajuste estndar). Para LANs Ethernet con una velocidad de transferencia de 10 Mbit/s. Para redes con una velocidad de transferencia de 1 Mbit/s. Para redes o conexiones de comunicacin con una velocidad de transferencia de 0,1 Mbit/s. Este ajuste es adecuado para conexiones vas RSDI (MultiLink), RSDI y mdem. Comprueba la conexin con el cliente a travs del servidor.
Casilla de verificacin "Server Pings Client" Botn "Default"
Aplica el valor estndar "Ethernet LAN (100 Mbit/s)"
Nota Se recomienda la utilizacin de clientes con una velocidad de transferencia de 128 Kbit/s como mnimo.
Smart Tools
136
ndice alfabtico
G
Gestin de scripts, 133
.
.emf, 121
A
Amplitud, 24 Archivo .emf, 121 Archivo ASCII, 12
I
Importacin, 10, 12, 15 Importar, 10, 12, 15 Increment, 21, 24
C
Communication Configurator, 135 Cross Reference, 123, 124
L
Lmite inferior, 24 Lmite superior, 24
D
Decrement, 21, 24 Deslizador, 21, 24 Dynamic Wizard Editor, 27 Barra de herramientas, 31 Editor de Ayuda, 34 Estructura, 30 Instalacin, 29 Ventana de edicin, 33 Ventana de resultados, 35
N
Nombres de archivo, 10 Nmeros aleatorios, 21, 24
O
Offset, 24 Oscilacin, 21, 24
P
Pgina del informe, 120 Periferia de proceso, 20 Propiedades del trabajo de impresin, 121 Prueba funcional, 19
E
Equipo de destino, 13, 15 Estructura, 36 Estructura de archivo, 14 Estructura de datos, 15 Exportacin, 10, 12, 13, 15 Exportar, 10
S
Script, 124 Seleccin de archivos, 130 Seleccin de proyectos, 129 Seno, 21, 24 Simulacin, 19 Simulador, 19 Simulador de variables, 19 Sistema de informes de WinCC, 120 Sobreoscilacin, 24
F
Funcin del Dynamic Wizard, 36 Funciones, 125
137
ndice alfabtico
T
Tiempo de oscilacin, 24 Tipos de estructura, 15 Trabajos de impresin, 120
V
Valor de consigna, 24 Valor final, 24 Valor inicial, 24 Variable de proceso, 20 Variables, 15
W
WinCC CrossReferenceAssistant, 123, 124
Smart Tools
138

@@smart Tools

Загружено:

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

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

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

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

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

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

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

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

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

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

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

@@smart Tools

Загружено:

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

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

 Smart Tools

SIMATIC HMI WinCC V7.0 SP3 Smart Tools

3 ___________________ Simulador de variables 4 ___________________ Dynamic Wizard Editor

___________________ 5 Documentation Viewer

Notas jurdicas Notas jurdicas Filosofa en la sealizacin de advertencias y peligros

Uso previsto o de los productos de Siemens

Siemens AG Industry Sector Postfach 48 48 90026 NRNBERG ALEMANIA

Impresin de la Ayuda online 12/2011

Copyright Siemens AG 2011. Sujeto a cambios sin previo aviso

Simulador de variables ............................................................................................................................ 19

Dynamic Wizard Editor ............................................................................................................................ 27

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

12/2011, Impresin de la Ayuda en pantalla

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

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

WinCC Communication Configurator ..................................................................................................... 135 ndice alfabtico..................................................................................................................................... 137

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

12/2011, Impresin de la Ayuda en pantalla

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

12/2011, Impresin de la Ayuda en pantalla

Instalacin de Exportacin/Importacin de variables

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.3 Manejo

12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.3 Manejo

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.4 La herramienta "Exportacin/importacin de variables"

La herramienta "Exportacin/importacin de variables"

12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.5 Conexiones

Ejemplo de una conexin lgica:

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.6 Estructuras de archivo

12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.7 Variable

Importacin de variables de un tipo definido por el usuario.

Ejemplo: Los tipos de estructura se han exportado al archivo [name]_dex.csv.

Las variables se han exportado al archivo [name]_vex.csv.

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.7 Variable

Variable interna con actualizacin en el 8194 equipo local Variable externa 4

12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.8 Anexo

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

Exportacin/importacin de variables 2.8 Anexo

12/2011, Impresin de la Ayuda en pantalla

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

Simulador de variables 3.2 Aplicacin del simulador de variables

Aplicacin del simulador de variables

Simulacin de las variables de proceso sin periferia de proceso

Simulacin de las variables de proceso estando conectada la periferia de proceso

12/2011, Impresin de la Ayuda en pantalla

Simulador de variables 3.3 Funciones del simulador

Funciones del simulador

Smart Tools 12/2011, Impresin de la Ayuda en pantalla

Simulador de variables 3.4 Instalacin del simulador

Instalacin del simulador

Modo de proceder alternativo

Inicio del simulador

12/2011, Impresin de la Ayuda en pantalla

Simulador de variables 3.5 Agregar/borrar variables

Agregar nuevas variables

Borrar una variable

Smart Tools

3 _ Simulador de variables 4 _ Dynamic Wizard Editor