wincc: scripting (vbs, ansi-c, vba) - siemens ag · simatic hmi wincc v7.2 wincc: scripting (vbs,...

SIMATIC HMI

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

Manual de sistema

Impresin de la Ayuda en pantalla

02/2013A5E32315921-AA

VBS para crear procedimientos y acciones

1

ANSI-C para crear funciones y acciones

2

VBA para configuracin automatizada

3

Notas jurdicasFilosofa 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

Significa que si no se adoptan las medidas preventivas adecuadas, pueden producirse lesiones corporales.

ATENCINSignifica que si no se adoptan las medidas preventivas adecuadas, pueden producirse daos materiales.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 cualificadoEl 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 SiemensConsidere 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 registradasTodos 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 responsabilidadHemos 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 AGIndustry SectorPostfach 48 4890026 NRNBERGALEMANIA

A5E32315921-AA 02/2013 Sujeto a cambios sin previo aviso

Copyright Siemens AG 2013.Reservados todos los derechos

ndice

1 VBS para crear procedimientos y acciones................................................................................................11 1.1 VBS para crear procedimientos y acciones.................................................................................11 1.2 Emplear Visual Basic Script en WinCC.......................................................................................12 1.3 Mdulos y procedimientos...........................................................................................................16 1.4 Acciones......................................................................................................................................19 1.5 Cmo emplear procedimientos y acciones varias veces.............................................................22 1.6 Relaciones con CrossReference.................................................................................................24 1.7 Emplear variables globales con VBS..........................................................................................26 1.8 Los editores de VBScript.............................................................................................................28 1.8.1 Los editores de VBScript.............................................................................................................28 1.8.2 El Global Script Editor.................................................................................................................29 1.8.3 Operar en la ventana de edicin.................................................................................................32 1.8.4 Operar con las barras de herramientas.......................................................................................35 1.8.5 Cmo borrar acciones o procedimientos.....................................................................................38 1.9 Crear y editar procedimientos.....................................................................................................39 1.9.1 Crear y editar procedimientos.....................................................................................................39 1.9.2 Cmo crear un procedimiento nuevo..........................................................................................42 1.9.3 Manera de escribir el cdigo del procedimiento..........................................................................44 1.9.4 Cmo emplear procedimientos estndar y de proyecto..............................................................47 1.9.5 Cmo aadir informacin sobre el mdulo..................................................................................48 1.9.6 Cmo proteger un mdulo con una contrasea..........................................................................50 1.9.7 Cmo guardar un procedimiento.................................................................................................51 1.9.8 Cmo cambiar el nombre de un procedimiento o de un mdulo.................................................53 1.10 Crear y editar acciones................................................................................................................55 1.10.1 Crear y editar acciones................................................................................................................55 1.10.2 Cmo crear una accin nueva.....................................................................................................59 1.10.3 Manera de editar una accin.......................................................................................................61 1.10.4 Manera de agregar informacin referente a la accin.................................................................64 1.10.5 Cmo proteger una accin con una contrasea..........................................................................66 1.10.6 Cmo guardar una accin...........................................................................................................67 1.10.7 Disparador...................................................................................................................................69 1.10.7.1 Disparador...................................................................................................................................69 1.10.7.2 Disparador de animacin.............................................................................................................73 1.10.7.3 Manera de agregar un disparador del tipo "Temporizador".........................................................74 1.10.7.4 Manera de agregar un disparador del tipo "Variable"..................................................................75 1.10.7.5 Manera de modificar un disparador.............................................................................................76 1.10.7.6 Manera de eliminar un disparador...............................................................................................77 1.10.8 Manera de cambiar el nombre de una accin.............................................................................78 1.11 Cmo activar acciones globales en Runtime..............................................................................80 1.12 Diagnstico..................................................................................................................................81

WinCC: Scripting (VBS, ANSI-C, VBA)Manual de sistema, 02/2013, A5E32315921-AA 3

1.12.1 Diagnstico..................................................................................................................................81 1.12.2 Diagnstico GSC.........................................................................................................................82 1.12.2.1 Diagnstico GSC.........................................................................................................................82 1.12.2.2 Cmo insertar una ventana de GSC Diagnstico en la imagen..................................................83 1.12.2.3 Atributos de Diagnstico GSC.....................................................................................................84 1.12.2.4 Barra de herramientas de Diagnstico GSC...............................................................................84 1.12.3 GSC - Runtime............................................................................................................................85 1.12.3.1 GSC - Runtime............................................................................................................................85 1.12.3.2 Cmo insertar la ventana GSC-Runtime en una imagen............................................................86 1.12.3.3 Atributos de Runtime GSC..........................................................................................................87 1.12.4 Verificar con el Debugger............................................................................................................88 1.12.4.1 Verificar con el Debugger............................................................................................................88 1.12.4.2 Manera de activar el debugger....................................................................................................89 1.12.4.3 Conceptos bsicos de la limpieza con debugger........................................................................91 1.12.4.4 Componentes del Microsoft Script Debugger..............................................................................93 1.12.4.5 Diseo de los archivos de VBScript............................................................................................95 1.12.4.6 Nombres de acciones y de procedimientos en el debugger........................................................97 1.12.4.7 Cmo seleccionar un script para editarlo....................................................................................99 1.12.4.8 Cmo ejecutar un script paso a paso........................................................................................100 1.12.4.9 Cmo posicionar puntos de parada...........................................................................................101 1.12.4.10 Cmo borrar puntos de parada............................................................................................102 1.12.4.11 Manera de posicionar un marcador en un script..................................................................103 1.12.4.12 Manera de determinar o modificar valores de variables o de propiedades..........................104 1.12.4.13 Cmo ejecutar comandos script...........................................................................................105 1.13 Cmo imprimir scripts VB..........................................................................................................107 1.14 Referencia VBS.........................................................................................................................108 1.14.1 Referencia VBS.........................................................................................................................108 1.14.2 Objetos y listados......................................................................................................................112 1.14.2.1 Objetos y listados......................................................................................................................112 1.14.2.2 Objeto Alarm..............................................................................................................................115 1.14.2.3 Objeto Alarms (listado)..............................................................................................................116 1.14.2.4 Objeto AlarmLogs......................................................................................................................117 1.14.2.5 Objeto DataItem........................................................................................................................118 1.14.2.6 Objeto DataLogs........................................................................................................................120 1.14.2.7 Objeto DataSet (listado)............................................................................................................121 1.14.2.8 Objeto HMIRuntime...................................................................................................................123 1.14.2.9 Objeto Item................................................................................................................................124 1.14.2.10 Objeto Layer.........................................................................................................................125 1.14.2.11 Objeto Layers (listado).........................................................................................................126 1.14.2.12 Objeto Logging.....................................................................................................................127 1.14.2.13 Objeto ProcessValue............................................................................................................128 1.14.2.14 Objeto ProcessValues (listado)............................................................................................129 1.14.2.15 Objeto de proyecto...............................................................................................................129 1.14.2.16 Objeto ScreenItem...............................................................................................................130 1.14.2.17 Objeto ScreenItems (listado)................................................................................................134 1.14.2.18 Objeto Screen......................................................................................................................136 1.14.2.19 Objeto Screens (listado).......................................................................................................139 1.14.2.20 Objeto SmartTags................................................................................................................141 1.14.2.21 Objeto Tag............................................................................................................................142 1.14.2.22 Objeto Tags (listado)............................................................................................................145 1.14.2.23 Objeto TagSet (listado)........................................................................................................147

ndice

WinCC: Scripting (VBS, ANSI-C, VBA)4 Manual de sistema, 02/2013, A5E32315921-AA

1.14.3 Tipos de objeto del objeto ScreenItem......................................................................................148 1.14.3.1 Tipos de objeto del objeto ScreenItem......................................................................................148 1.14.3.2 Objetos estndar.......................................................................................................................149 1.14.3.3 Objetos Smart............................................................................................................................177 1.14.3.4 Objetos Windows.......................................................................................................................208 1.14.3.5 Objetos de tubo.........................................................................................................................220 1.14.3.6 Controles...................................................................................................................................222 1.14.3.7 Objeto personalizado.................................................................................................................290 1.14.3.8 Grupo.........................................................................................................................................291 1.14.4 Propiedades..............................................................................................................................292 1.14.4.1 Propiedades..............................................................................................................................292 1.14.4.2 A................................................................................................................................................293 1.14.4.3 B................................................................................................................................................312 1.14.4.4 C................................................................................................................................................339 1.14.4.5 D................................................................................................................................................371 1.14.4.6 E................................................................................................................................................381 1.14.4.7 F................................................................................................................................................391 1.14.4.8 G................................................................................................................................................412 1.14.4.9 H................................................................................................................................................416 1.14.4.10 I............................................................................................................................................424 1.14.4.11 L...........................................................................................................................................429 1.14.4.12 M..........................................................................................................................................462 1.14.4.13 N...........................................................................................................................................483 1.14.4.14 O...........................................................................................................................................485 1.14.4.15 P...........................................................................................................................................502 1.14.4.16 Q...........................................................................................................................................519 1.14.4.17 R...........................................................................................................................................520 1.14.4.18 S...........................................................................................................................................531 1.14.4.19 T...........................................................................................................................................568 1.14.4.20 U...........................................................................................................................................644 1.14.4.21 V...........................................................................................................................................653 1.14.4.22 W..........................................................................................................................................669 1.14.4.23 X - Z......................................................................................................................................673 1.14.5 Mtodos.....................................................................................................................................681 1.14.5.1 Mtodos.....................................................................................................................................681 1.14.5.2 Mtodos A a E...........................................................................................................................683 1.14.5.3 Mtodos Get..............................................................................................................................691 1.14.5.4 Mtodos H a M..........................................................................................................................740 1.14.5.5 Mtodos N a R...........................................................................................................................750 1.14.5.6 Mtodos S a T...........................................................................................................................769 1.14.5.7 Mtodos U a Z...........................................................................................................................783 1.14.6 Anexo........................................................................................................................................791 1.14.6.1 Avisos de fallos del rea de bases de datos.............................................................................791 1.15 Ejemplos de VBScript................................................................................................................793 1.15.1 Ejemplos de VBScript................................................................................................................793 1.15.2 Ejemplos en WinCC..................................................................................................................793 1.15.2.1 Ejemplos en WinCC..................................................................................................................793 1.15.2.2 Ejemplo: As Ud. puede acceder a objetos en Graphics Designer...........................................794 1.15.2.3 Ejemplo: De esta manera Ud. determina el color de objetos....................................................795 1.15.2.4 Ejemplo: Manera de configurar un cambio de idioma...............................................................795 1.15.2.5 Ejemplo: As desactiva Ud. Runtime.........................................................................................796 1.15.2.6 Ejemplo: As puede Ud. proyectar un cambio de imagen global...............................................796

ndice


1.15.2.7 Ejemplo: As puede Ud. proyectar un cambio de imagen a travs de Propiedad.....................797 1.15.2.8 Ejemplo: As puede Ud. proyectar una edicin de diagnstico por medio de Trace.................797 1.15.2.9 Ejemplo: As escribe Ud. valores de variables..........................................................................798 1.15.2.10 Ejemplo: Manera de leer valores de variables.....................................................................800 1.15.2.11 Ejemplo: As escribe Ud. propiedades del objeto.................................................................803 1.15.2.12 Ejemplo: Manera de iniciar una accin en el servidor (objeto Logging)...............................806 1.15.2.13 Dinamizacin del control......................................................................................................808 1.15.3 Ejemplos en general..................................................................................................................820 1.15.3.1 Ejemplos generales para VBScript............................................................................................820 1.15.3.2 Ejemplo: Proyectar una conexin a una base de datos con VBS.............................................821 1.15.3.3 Ejemplo: As puede Ud. utilizar el interfase MS Automation.....................................................823 1.15.3.4 Ejemplo: As inicia Ud. una aplicacin externa..........................................................................825 1.16 Conceptos bsicos de VBScript................................................................................................826 1.16.1 Conceptos bsicos de VBScript................................................................................................826 1.16.2 Bases de VBScript.....................................................................................................................826

2 ANSI-C para crear funciones y acciones..................................................................................................827 2.1 Creacin de funciones y acciones con ANSI-C.........................................................................827 2.2 Crear funciones y acciones.......................................................................................................828 2.3 Caractersticas de funciones de proyecto.................................................................................831 2.4 Caractersticas de funciones estndar......................................................................................832 2.5 Caractersticas de funciones internas.......................................................................................834 2.6 Caractersticas de acciones locales..........................................................................................835 2.7 Caractersticas de acciones globales........................................................................................836 2.8 Cmo incorporar Global Script Runtime a la lista de arranque del proyecto.............................837 2.9 Usar variables globales C..........................................................................................................839 2.10 Uso de DLLs en funciones y acciones......................................................................................841 2.11 El editor Global Script................................................................................................................843 2.11.1 El editor Global Script................................................................................................................843 2.11.2 Operar en la ventana de edicin...............................................................................................845 2.11.2.1 Operar en la ventana de edicin...............................................................................................845 2.11.2.2 Funciones de edicin con el teclado.........................................................................................847 2.11.2.3 Funciones de edicin con el ratn.............................................................................................848 2.11.3 Operar con las barras de herramientas.....................................................................................848 2.11.4 Cmo configurar diferentes vistas.............................................................................................851 2.11.5 Cmo configurar el estilo de fuente...........................................................................................851 2.11.6 Cmo utilizar "Guardar como..."................................................................................................852 2.11.7 Cmo borrar acciones o funciones de proyecto y funciones estndar......................................853 2.11.8 Cmo generar una nueva cabecera..........................................................................................853 2.11.9 Cmo compilar todas las funciones...........................................................................................854 2.11.10 Cmo efectuar bsquedas en archivos.....................................................................................855 2.11.11 Imprimir funciones y acciones...................................................................................................856 2.11.11.1 Imprimir funciones y acciones..............................................................................................856 2.11.11.2 Cmo configurar los parmetros de impresin....................................................................856 2.11.11.3 Cmo abrir la vista preliminar...............................................................................................857 2.11.11.4 Cmo imprimir la documentacin de un proyecto................................................................857

ndice


2.12 Crear y editar funciones............................................................................................................858 2.12.1 Crear y editar funciones............................................................................................................858 2.12.2 Cmo crear una funcin nueva.................................................................................................861 2.12.3 El cdigo de funcin se escribe de la siguiente forma:.............................................................862 2.12.4 Cmo utilizar funciones internas...............................................................................................863 2.12.5 Cmo utilizar funciones estndar y de proyecto........................................................................864 2.12.6 Cmo aadir informaciones que acompaan a las funciones...................................................865 2.12.7 Cmo proteger una funcin ante modificaciones y accesos indebidos.....................................866 2.12.8 Cmo compilar y guardar una funcin.......................................................................................867 2.12.9 Cmo cambiar el nombre de una funcin..................................................................................869 2.12.10 Cmo utilizar funciones de otras fuentes..................................................................................870 2.13 Crear y editar acciones..............................................................................................................871 2.13.1 Crear y editar acciones..............................................................................................................871 2.13.2 Regla de cdigo WinCC............................................................................................................874 2.13.3 Cmo crear una accin nueva...................................................................................................875 2.13.4 Cmo editar una accin.............................................................................................................876 2.13.5 Cmo agregar informacin referente a la accin......................................................................877 2.13.6 Cmo proteger una accin ante modificaciones y accesos indebidos......................................878 2.13.7 Cmo compilar y guardar una accin........................................................................................879 2.13.8 Disparador.................................................................................................................................880 2.13.8.1 Disparador.................................................................................................................................880 2.13.8.2 Cmo agregar un nuevo disparador del tipo "Temporizador"...................................................883 2.13.8.3 Cmo agregar un nuevo disparador del tipo "Variable"............................................................884 2.13.8.4 Manera de modificar un disparador...........................................................................................885 2.13.8.5 Manera de eliminar un disparador.............................................................................................886 2.13.9 Cmo asignar un permiso.........................................................................................................886 2.13.10 Cmo exportar una accin........................................................................................................887 2.13.11 Cmo importar una accin........................................................................................................888 2.13.12 Cmo cambiar el nombre de una accin...................................................................................889 2.13.13 Cmo utilizar acciones no conocidas por el proyecto...............................................................889 2.14 Comportamiento de ejecucin de acciones...............................................................................891 2.14.1 Comportamiento de ejecucin de acciones...............................................................................891 2.14.2 GSC - Runtime..........................................................................................................................892 2.14.2.1 GSC - Runtime..........................................................................................................................892 2.14.2.2 Cmo aportar GSC-Runtime a una imagen del proceso...........................................................895 2.14.2.3 Los atributos de GSC-Runtime..................................................................................................896 2.14.2.4 Cmo editar una accin.............................................................................................................897 2.14.3 GSC Diagnstico.......................................................................................................................897 2.14.3.1 GSC Diagnstico.......................................................................................................................897 2.14.3.2 Cmo aportar GSC Diagnstico a una imagen del proceso......................................................898 2.14.3.3 Los atributos de GSC Diagnstico............................................................................................899 2.14.3.4 La barra de herramientas de GSC Diagnstico.........................................................................900 2.15 ANSI-C Descripciones de funciones.........................................................................................901 2.15.1 lpszPictureName.......................................................................................................................901 2.15.2 Funciones estndar...................................................................................................................901 2.15.2.1 Resumen tcnico de las funciones estndar.............................................................................901 2.15.2.2 Alarm.........................................................................................................................................902 2.15.2.3 Graphics....................................................................................................................................907 2.15.2.4 Obsolete functions.....................................................................................................................912 2.15.2.5 Report........................................................................................................................................970

ndice


2.15.2.6 WinCC.......................................................................................................................................972 2.15.2.7 Windows....................................................................................................................................979 2.15.3 Funciones internas....................................................................................................................980 2.15.3.1 Resumen tcnico de las funciones internas..............................................................................980 2.15.3.2 allocate......................................................................................................................................981 2.15.3.3 c_bib..........................................................................................................................................982 2.15.3.4 graphics...................................................................................................................................1066 2.15.3.5 tag............................................................................................................................................1394 2.15.3.6 WinCC.....................................................................................................................................1506 2.15.4 Ejemplos..................................................................................................................................1513 2.15.4.1 Ejemplos - A a G.....................................................................................................................1513 2.15.4.2 Ejemplos - GetAlarmHigh hasta GetPropChar........................................................................1516 2.15.4.3 Ejemplos - GetRangeMax hasta GetWidth..............................................................................1532 2.15.4.4 Ejemplos - H a S......................................................................................................................1553 2.15.4.5 Ejemplos - SetAlarmHigh hasta SetPropChar.........................................................................1555 2.15.4.6 Ejemplos - SetRangeMax a SetWidth.....................................................................................1565 2.15.4.7 Ejemplos - T a Z......................................................................................................................1575 2.15.4.8 Ejemplos de controles WinCC.................................................................................................1580 2.15.5 Listados...................................................................................................................................1583 2.15.5.1 Orientacin de la barra............................................................................................................1583 2.15.5.2 Escala de la barra....................................................................................................................1583 2.15.5.3 Frecuencias de intermitencia...................................................................................................1584 2.15.5.4 Campo E/S, formato de salida.................................................................................................1584 2.15.5.5 Campo E/S, tipo de datos del contenido del campo...............................................................1585 2.15.5.6 Campo E/S, tipo de campo......................................................................................................1586 2.15.5.7 Alineacin de elementos en casillas de verificacin y opcionales..........................................1586 2.15.5.8 Tabla de colores......................................................................................................................1586 2.15.5.9 Descriptores de formato..........................................................................................................1587 2.15.5.10 Tipo de relleno....................................................................................................................1588 2.15.5.11 Tipos de lnea.....................................................................................................................1589 2.15.5.12 Finales de lnea..................................................................................................................1589 2.15.5.13 Tipos de listas....................................................................................................................1590 2.15.5.14 Identificadores de idioma...................................................................................................1590 2.15.5.15 Alineacin del texto............................................................................................................1591 2.15.5.16 Estados de variable............................................................................................................1591 2.15.6 Definiciones de estructura.......................................................................................................1592 2.15.6.1 Definicin de estructura CCAPErrorExecute...........................................................................1592 2.15.6.2 Definicin de estructura CCAPTime........................................................................................1594 2.15.6.3 Definicin de estructura CMN_ERROR...................................................................................1595 2.15.6.4 Definicin de estructura DM_TYPEREF..................................................................................1595 2.15.6.5 Definicin de estructura DM_VAR_UPDATE_STRUCT..........................................................1596 2.15.6.6 Definicin de estructura DM_VAR_UPDATE_STRUCTEX.....................................................1597 2.15.6.7 Definicin de estructura DM_VARKEY....................................................................................1598 2.15.6.8 Definicin de estructura LINKINFO.........................................................................................1599 2.15.6.9 Definicin de estructura MSG_FILTER_STRUCT...................................................................1600 2.15.6.10 Definicin de estructura MSG_RTDATA_STRUCT............................................................1603

3 VBA para configuracin automatizada...................................................................................................1605 3.1 Configuracin automatizada....................................................................................................1605 3.2 Introduccin: colocar VBA en WinCC......................................................................................1606 3.2.1 Introduccin: colocar VBA en WinCC......................................................................................1606 3.2.2 Diferenciacin: aplicacin de VBA...........................................................................................1606

ndice


3.2.3 Organizar cdigo VBA en el proyecto WinCC.........................................................................1607 3.2.4 Manera de exportar e importar cdigos VBA..........................................................................1610 3.2.5 Ejecutar macros VBA en el Graphics Designer.......................................................................1611 3.3 VBA en el Graphics Designer..................................................................................................1613 3.3.1 VBA en el Graphics Designer..................................................................................................1613 3.3.2 Adaptar Graphics Designer con VBA......................................................................................1615 3.3.2.1 Adaptar Graphics Designer con VBA......................................................................................1615 3.3.2.2 Configuracin dependiente del idioma con VBA.....................................................................1616 3.3.2.3 Crear un men y barra de herramientas propias.....................................................................1618 3.3.2.4 Acceso a la librera de bloques VBA.......................................................................................1638 3.3.3 Editar imgenes con VBA........................................................................................................1645 3.3.3.1 Editar imgenes con VBA........................................................................................................1645 3.3.3.2 Manera de crear mens y barras de herramientas especficos de la imagen.........................1646 3.3.3.3 Editar niveles con VBA............................................................................................................1648 3.3.3.4 Editar una copia de una imagen con VBA...............................................................................1649 3.3.4 Editar objetos con VBA............................................................................................................1651 3.3.4.1 Editar objetos con VBA............................................................................................................1651 3.3.4.2 Objetos estndar, Smart, Windows y de tubo.........................................................................1653 3.3.4.3 Objetos de grupos...................................................................................................................1666 3.3.4.4 Objetos de usuario..................................................................................................................1674 3.3.5 Crear dinamizaciones con VBA...............................................................................................1678 3.3.5.1 Crear dinamizaciones con VBA...............................................................................................1678 3.3.5.2 Dinamizar propiedades de imgenes y objetos.......................................................................1679 3.3.5.3 Configuracin de acciones controladas por eventos con VBA................................................1690 3.3.5.4 Editar disparador.....................................................................................................................1697 3.3.6 Event-Handling........................................................................................................................1700 3.3.7 Acceso a aplicaciones externas con VBA...............................................................................1703 3.3.7.1 Acceso a aplicaciones externas con VBA...............................................................................1703 3.3.7.2 Ejemplo: acceso a MS Excel con VBA....................................................................................1704 3.4 AddIns.....................................................................................................................................1710 3.4.1 AddIns.....................................................................................................................................1710 3.4.2 Integracin de AddIns..............................................................................................................1710 3.4.3 Manera de cargar un AddIn en el Graphics Designer.............................................................1712 3.4.4 Ejemplo: Creacin de AddIns..................................................................................................1714 3.4.4.1 Ejemplo: Creacin de AddIns..................................................................................................1714 3.4.4.2 Ejemplo: Crear AddIn con Visual Basic 6.0.............................................................................1714 3.5 Referencia VBA.......................................................................................................................1720 3.5.1 El modelo de objeto del Graphics Designer............................................................................1720 3.5.1.1 Referencia VBA.......................................................................................................................1720 3.5.1.2 Referencia VBA: ActionDynamic.............................................................................................1722 3.5.1.3 Referencia VBA: Objetos HMI.................................................................................................1724 3.5.1.4 Referencia VBA: Languages...................................................................................................1726 3.5.1.5 Eventos....................................................................................................................................1726 3.5.1.6 Mtodos...................................................................................................................................1761 3.5.1.7 Objetos y listados....................................................................................................................1863 3.5.1.8 Propiedades............................................................................................................................2050 3.5.2 VBA en otros editores WinCC.................................................................................................2478 3.5.2.1 VBA en otros editores WinCC.................................................................................................2478 3.5.2.2 VBA en administracin de variables........................................................................................2480 3.5.2.3 VBA en el Tag Logging............................................................................................................2491 3.5.2.4 VBA en la Text Library.............................................................................................................2519

ndice


3.5.2.5 VBA en el Alarm Logging........................................................................................................2532

ndice alfabtico......................................................................................................................................2547

ndice


VBS para crear procedimientos y acciones 11.1 VBS para crear procedimientos y acciones

ContenidoWinCC le ofrece la posibilidad de dinamizar su entorno Runtime con la ayuda de Visual Basic Script. Con VBS pueden programarse acciones globales y procedimientos, dinamizar objetos grficos en Runtime y activar acciones.

Este captulo le mostrar

como trabajar con los editores VBScript

como crear y editar procedimientos

como crear y editar acciones,

como activar guiones VB en Runtime

como diagnosticar guiones en Runtime

el modelo objeto del sistema grfico Runtime

ejemplos completos para la aplicacin de VBScript


1.2 Emplear Visual Basic Script en WinCC

IntroduccinEn WinCC dispone, adems del script C, el lenguaje de programacin VBScript como interfaz de programacin para dinamizar el entorno WinCC Runtime.

Grupo objetivo de la documentacinEsta documentacin se dirige a proyectistas con conocimientos de Visual Basic o del scripting WinCC (C) anterior.

posibilidades de aplicacinCon VBScript (VBS) dispone en Runtime de un acceso a variables y objetos del sistema grfico runtime y pueden ejecutarse acciones independientes de imgenes:

Variables: Pueden leerse y esciribirse valores de variables, p.ej. con el fin de determinar valores de variables para el control en un botn mediante el ratn.

Objetos: Pueden dinamizarse propiedades de objetos con acciones y activar acciones mediante eventos de objetos.

Acciones independientes de imgenes: Las acciones independientes de imgenes se pueden activar de forma cclica o controladas por valores de variables, p.ej. la insercin diaria de valores a una tabla Excel.

Es posible utilizar VBS en WinCC en los siguientes puntos:

En el editor Global Script: Aqu se configuran acciones y procedimientos independientes de imgenes. Estos procediemientos se pueden emplear en acciones dependientes e independientes de imgenes. Se recogen varios procedimientos de forma temtica en un mdulo.

En el Graphics Designer: Aqu se configuran acciones dependientes de imgenes con los que se pueden dinamizar las propiedades de objetos grficos o reaccionar en el caso de eventos en Runtime.

En mens y barras de herramientas definidos por el usuario. Aqu se configuran los procedimiento, que se llaman en Runtime con auxilio del men y barras de herramientas.

NotaActualizar en Runtime la configuracin modificada

Un VB script modificado, conectado con "Mens y barras de herramientas", se actualiza despus de reiniciar Runtime.

Si las propiedades de "Mens y barras de herramientas" se modifican en runtime, las modificaciones solo se aceptan en los siguientes casos: Tras un cambio de imagen, si la modificacin de la configuracin no afecta a la imagen

inicial. Al cargar otro archivo de configuracin y al cargar de nuevo el archivo de configuracin

modificado.

VBS para crear procedimientos y acciones1.2 Emplear Visual Basic Script en WinCC


Variables registradas en mens y barras de herramientas Las variables registradas en los scripts de "Mens y barras de herramientas" se mantienen registradas al deseleccionar las imgenes. En una lectura indirecta de la imagen de proceso se registran las variables y se dan de baja tras la deseleccin de imgenes. Sin embargo, en los scripts de "Mens y barras de herramientas" las variables se mantienen registradas en caso de deseleccin de las imgenes

Escenarios de aplicacionesCon VBS es posible, en runtime, p.ej.:

configurar valores tericos de variables para el manejo de un objeto grfico, p.ej. para definir mediante un clic de ratn un valor para el control.

Configurar el cambio del lenguaje runtime segn el manejo del objeto grfico.

Configurar cambios de color, p.ej. cclicos (intermitencia) o la visualizacin de estados (motor activado).

Aparte de las aplicaciones especficas de WinCC tambin es posible adaptar el entorno de Windows con la ayuda de las funciones generales de VBS, p.ej.:

Transferir datos a otras aplicaciones (p.ej. Excel).

Activar aplicaciones externas desde WinCC.

Crear archivos y carpetas.

Para adaptar su entorno Windows dispone de los objetos de automacin de su entorno.

Nota

Se pueden integrar todos los objetos suministrados con Windows Script Host (WSH) de Microsoft en su entorno mediante el mtodo VBS estndar CreateObject. Sin embargo, con VBS desde WinCC Ud. no tiene acceso directo al objeto WSH.

No se puede ofrecer ninguna garanta ni Support WinCC para la funcionalidad VBS para la adaptacin del entorno de Windows.

Diferencias frente a otros lenguajes de programacin en WinCC

VBS y CSe puede utilizar VBScript en WinCC de forma paralela a C-Script aunque no es posible mezclar los tipos de scripts:

Dentro de una imagen y de un proyecto es posible configurar scripts VB y scripts C.

No podr iniciar scripts C desde scripts VB ni viceversa.

Con VBS no dispone de interfaces internas a variables y a objetos de imagen mientres en el entorno C tambin tiene acceso a otros subsistemas de WinCC (p.ej. el sistema de informes).



VBS y VBAPuede utilizarse VBA en WinCC Configuration durante la configuracin para adaptar Graphics Designer a sus requerimientos individuales y simplificar y automatizar la configuracin. Los programas VBA solamente funcionan en el entorno de configuracin de WinCC.

Contrariamente al caso de VBA, los scripts VB solamente funcionan con WinCC Runtime donde le permiten acceder a objetos grficos y a variables. Contrastando con VBA, con VBS no podr ni crear objetos e imgenes ni modificarlos permanentemente.

Algunas diferencias de lenguaje entre VBA y VBS:

VBS ha sido desarrollado para su aplicacin en Internet, VBA para automatizar aplicaciones de software.

El tipo de datos de las variables VBS siempre es VARIANT. Sin embargo, VBA diferencia los distintos tipos de datos como INT, DOUBLE, STRING etc.

En VBS se han eliminado o reducido algunas construcciones de lenguaje de VBA.

En VBS, tambin es diferente el tratamiento de errores a la forma en que se tratan en VBA.

Encontrar una lista completa de las diferencias entre VBA y VBS en el anexo bajo "Conceptos bsicos de VBScript".

Procedimientos, mdulos y accionesVBS en WinCC le permite la utilizacin de procedimientos, mdulos y acciones para dinamizar su entorno runtime:

Procedimientos: Un procedimiento corresponde a una funcin de C. Los procediemientos contienen cdigos que desea emplar en varios puntos de su configuracin. Se inicia un cdigo en una accin o en otro procedimiento llamando el nombre del procedimiento deseado. En WinCC se pueden crear procedimientos con o sin valor de retorno. Los procedimientos de tienen disparador propio, su inicio siempre se lleva a cabo mediante una accin.

Mdulos: En los mdulos se integran procedimientos para formar unidades. Por ejemplo, un mdulo puede contener los procedimientos que se emplean para una determinada imagen o que pertenecen a un tema comn como pueden ser las funciones matemticas de bsqueda o las funciones para acceder a bases de datos.

Acciones: Las acciones siempre se activan mediante un disparador como evento que provoca su activacin. Se configura las acciones en las propiedades de objetos grficos, en eventos realizados con un objeto grfico o se configura de forma global en un proyecto. En las acciones podr iniciar cdigos que se utilicen varias veces en la forma de procedimientos.



1.3 Mdulos y procedimientos

IntroduccinSe emplean procedimientos para tener cdigos disponibles en varios puntos de un proyecto sin tener que crearlos repetidamente. En vez de introducir varias veces un cdigo ste solamente se inicia mediante el procedimiento correspondiente. As, los cdigos son ms sencillos y ms fciles de mantener.

Los procedimientos que pertenecen al mismo tema siempre se guardan en mdulos. Al iniciar un procedimiento determinado mediante una accin de runtime se cargar siempre el mdulo en el que se encuentra el procedimiento. Por lo tanto, respecto a la estructura de sus mdulos y procedimiento debe tener en cuanto lo siguiente:

Cuanto ms mdulos se cargarn al iniciarse una imagen peor ser el rendimiento en runtime.

Al ser un mdulo ms grande por contener ms procedimientos el tiempo que necesitar para cargar el mdulo ser ms largo.

Los mdulos deben estructurarse de una forma lgica, p.ej. puede emplearse un mdulo por cada componente/imagen.

Otra posible estructura de los procedimientos en mdulos consiste en elegir una estructura funcional, p.ej. un mdulo con funciones matemticas. Esta estructura se elige p.ej. con

VBS para crear procedimientos y acciones1.3 Mdulos y procedimientos


mdulos que se utilizarn en ms de un proyecto. El siguiente ejemplo muestra un mdulo que contiene funciones matemticas derivadas de funciones estndar:

Caractersticas de procedimientosLos procedimientos de WinCC tienen las caractersticas siguientes:

El usuario mismo crea y modifica los procedimientos.

Pueden protegerse contra modificaciones y visualizacin con una contrasea.

No disponen de disparador.

Se guardan en un mdulo.

WinCC no dispone de procedimientos preconfigurados, sin embargo, le ofrece plantillas de cdigo e Intellisense para simplificar la programacin. Se difierencian los procedimientos segn el mdulo al que pertenecen en:

Los procedimientos estndar se emplean en ms de un proyecto y se reconocen en todos los proyectos del ordenador en el que fueron creados.

Los procedimientos de proyecto solamente se pueden emplear con el proyecto en el que fueron creados.



Caractersticas de mdulosUn mdulo es un archivo en el que se guarda uno o ms procedimientos. Los mdulos de WinCC tienen las propiedades siguientes:

Pueden protegerse contra modificaciones y visualizacin con una contrasea.

La terminacin del archivo es *.bmo.

Dependiendo de la validez de sus procediminientos los mdulos se diferencian de forma siguiente:

Mdulos estndar: contienen procedimientos que estn disponibles en ms de un proyecto. Los mdulos estndar se encuentran en el sistema de archivos de WinCC en: \ApLib\ScriptLibStd\.bmo

Mdulos de proyecto: contienen procedimientos de un determinado proyecto. Los mdulos de proyecto se encuentran en el sistema de archivos de WinCC en: \ScriptLib\.bmo. Los mdulos de proyecto estn ubicados en el directorio del proyecto, por lo tanto se copiarn tambin al copiarse un proyecto WinCC.

Nota

En el caso de instalar de nuevo WinCC y para utilizar de nuevo los procedimientos y mdulos estndar primero copiar los archivos de los mdulos a otro directorio antes de la reinstalacin y despus de la instalacin volver a copiarlos en el directorio WinCC correspondiente. De otra forma se borraran durante la instalacin los mdulos estndar del directorio de instalacin de WinCC.

Emplear procedimientos y mdulosLos procedimientos se utilizan en:

Acciones (con Graphics Designer y con Global Script)

Otros procedimientos (con Global Script)

Mens y barras de herramientas definidos por el usuario

Los procedimientos se estructuran en mdulos.

Consulte tambinCrear y editar procedimientos (Pgina 39)

Los editores de VBScript (Pgina 28)

Conceptos bsicos de VBScript (Pgina 826)

Acciones (Pgina 19)

Emplear Visual Basic Script en WinCC (Pgina 12)



1.4 Acciones

IntroduccinUna accin siempre se activa mediante un trigger. En Runtime se activa una accin, p.ej., al operar un objeto con un clic de ratn, cuando se haya llegado a un determinado momento o se ha modificado el valor de una variable.

Caractersticas de accionesEn Global Script se definen las acciones una vez para disponer de ellas independientemente de imgenes. Las acciones de Global Script solamente son vlidas en el proyecto en el que fueron definidas. Las acciones que estn conectadas con objetos grficos solamente son vlidas para la imagen en la que fueron definidas.

Nota

Con VBS, la definicin de acciones especficas para cada ordenador no es posible de momento.

Para clientes en un sistema de varias plazas se aplica los siguiente: Al abrir un proyecto se ejecutarn todas las acciones globales configuradas en un servidor tambin en los clientes correspondientes. Para clientes en un sistema distribuido se aplica los siguiente: Para poder usar acciones en un ordenador cliente se debe copiar los archivos de las acciones al directorio del proyecto correspondiente del cliente.

Las acciones tienen las caractersticas siguientes:

El usuario mismo crea y modifica las acciones.

Las acciones de Global Script pueden protegerse contra modificaciones y visualizacin con una contrasea.

Las acciones disponen como mnimo de un trigger.

En Global Script, los archivos de las acciones tienen la terminacin *.bac.

Las acciones de Global Script estn ubicadas en el sistema de archivos de WinCC en: \ScriptAct\Nombre de la accin.bac

Disparadores para accionesPara ejecutar acciones en runtime se necesitan disparadores. Se conecta un disparador con una accin que a partir de ese momento ser el evento de inicio de la accin. Las acciones sin disparador no se ejecutan.

En WinCC dispone de estos tipos de disparadores:

Temporizador: Disparadores acclicos o cclicos, p.ej. para activar una imagen o cada hora.

Variables: Cambios de valores

Eventos: Modificacin de las propiedades de un objeto (p.ej. cambio del color) o eventos para un objeto (p.ej. clic de ratn).

VBS para crear procedimientos y acciones1.4 Acciones


Ejecucin consecutiva de acciones en runtime

En Graphics DesignerCon runtime se pueden ejecutar dos acciones del mismo tipo simultneamente. Para que una accin cclica, p.ej. no sea afectada negativamente por otra accin provocada por un clic de ratn se ejecutan en Graphics Designer las acciones accionadas por disparador y las acciones cclicas/accionadas por variables de forma separada.

Nota

Hay que observar que en WinCC una sincronizacin de los tipos de accin solamente se puede llevar a cabo por el objeto DataSet o por variables internas de WinCC. Por la ejecucin por separado no existe ningn rea comn de datos entre las acciones activadas por un evento y las cclicas/activadas por un disparador.

Si la ejecucin de acciones cclicas de imgenes, por ejemplo, es afectada negativamente, p.ej., por una alta carga de trabajo o por otras acciones se ejecutar la accin afectada otra vez en la siguiente ocasin. Los ciclos no ejecutados no entrarn una lista de espera sino que se cancelarn.

Despus de cambiar la imagen se terminarn automticamente todos los scripts que an est ejecutndose al cabo de un minuto.

Los scripts que estn todava ejecutndose al terminar runtime se terminarn despus de 5 segundos.

En Global ScriptLas acciones independientes de imgenes de Global Script se ejecutan en runtime consecutivamente despus de iniciarlos. Si se inicia una accin mientras otra accin est ejecutndose la segunda accin entrar una lista de espera hasta que sea posible iniciarla.

Nota

Hay que observar que una sincronizacin de acciones en Global Script y de Graphics Designer solamente se puede llevar a cabo por el objeto DataSet o variables internas de WinCC. No existe ningn rea comn de datos entre acciones de Graphics Designer y de Global Script.

Emplear accionesLas acciones se pueden usar de forma siguiente:

En Global Script: Las acciones globales definidas aqu se ejecutan en runtime independientemente de imgenes.

En el Graphics Designer: Las acciones definidas aqu solamente se ejecutan en la imagen configurada. En Graphics Designer, se configura una accin siempre con la propiedad de un objeto o de un evento en un objeto grfico.



Consulte tambinCrear y editar acciones (Pgina 55)


Mdulos y procedimientos (Pgina 16)




1.5 Cmo emplear procedimientos y acciones varias veces

IntroduccinUna accin configurada en WinCC siempre es vlida para el proyecto para el que fue definida.

Los procedimientos tienen los siguientes mbitos de validez:

Los procedimientos estndar se emplean en ms de un proyecto y se reconocen en todos los proyectos del ordenador en el que fueron creados.

Los procedimientos de proyecto solamente se pueden emplear con el proyecto en el que fueron creados. Al copiar un proyeto tambin se copiarn los procedimientos y mdulos del proyecto junto con el proyecto.

Emplear procedimientos y acciones varias vecesPara utilizar acciones o procedimientos/mdulos en otros proyectos o en otros ordenadores se puede:

Utilizar la funcin "Guardar como" para guardar la accin o el mdulo en otro directorio de proyecto en un disquete o en otro disco.

Copiar el archivo de la accin o del mdulo con el Explorador de Windows al directorio del proyecto o estndar en el ordenador deseado.

Las propiedades configuradas se mantendrn al copiarse los archivos. Los mdulos copiados estn directamente disponibles en runtime. Se ejecutan las acciones copiadas en runtime despus de abrirlos a guardarlos una vez.

Nota

Las variables utilizadas en una accin o en un procedimiento tambin deben encontrarse en el ordenador destino. Si una variable no est disponible no ser posible ejecutar la accin o el procedimiento.

Los procedimientos que se inician en una accin deben encontrarse en el ordenador destino. Si no se encuentra el procedimiento ocurrir un error de ejecucin en runtime.

Archivar procedimientosPara copiar procedimientos a directorios de otros proyectos con el fin de utilizarlos en otros proyectos o con otros ordenadores debe tenerse en cuenta la ruta de acceso de los procedimiento dentro del sistema de archivos de WinCC:

Procedimientos estndar: \ApLib\ScriptLibStd\Modulname.bmo

Procedimientos de proyectos: \ScriptLib\Modulname.bmo

VBS para crear procedimientos y acciones1.5 Cmo emplear procedimientos y acciones varias veces


Nota

Ya ue los procedimientos siempre se encuentran en mdulos debe copiarse siempre el mdulo (*.bmo) en el que se encuentra el procedimiento deseado.

Los procedimientos/mdulos copiados se visualizan despus de actualizar la ventana del navegador de Global Script (Men emergente "Actualizar") o despus de reiniciar el editor.

Archivar accionesPara copiar acciones a directorios de otros proyectos con el fin de utilizarlos en otros proyectos o con otros ordenadores debe tenerse en cuenta la ruta de acceso de los procedimiento dentro del sistema de archivos de WinCC:

\ScriptAct\Nombre de la accin.bac

Cada accin se guarda como un archivo propio. Al copiarse acciones tambin se copiarn todos los disparados pertenecientes a estas acciones.

Nota

Solamente aquellas acciones que fueron creadas con Global Script se encuentran en el sistema de archivos de WinCC. Las acciones programadas con Graphics Designer siempre que guardan con la imagen actual y no se pueden transferir individualmente. Sin embargo, si se copia una imagen de Graphics Designer al directorio de otro proyecto se copian tambin las acciones guardadas con esta imagen.

Las acciones copiadas se visualizan despus de actualizar la ventana del navegador de Global Script (Men emergente "Actualizar") o despus de reiniciar el editor.

Consulte tambinMdulos y procedimientos (Pgina 16)

Cmo cambiar el nombre de un procedimiento o de un mdulo (Pgina 53)

Cmo guardar un procedimiento (Pgina 51)

Cmo proteger un mdulo con una contrasea (Pgina 50)

Cmo aadir informacin sobre el mdulo (Pgina 48)

Cmo emplear procedimientos estndar y de proyecto (Pgina 47)

Manera de escribir el cdigo del procedimiento (Pgina 44)

Cmo crear un procedimiento nuevo (Pgina 42)

Crear y editar procedimientos (Pgina 39)

VBS para crear procedimientos y acciones1.5 Cmo emplear procedimientos y acciones varias veces


1.6 Relaciones con CrossReference

CrossReference y disparadores de variables Con la CrossReference de WinCC pueden encontrarse rpidamente todos los puntos de aplicacin de las variables tambin en acciones de VBS. Los disparadores de variables de acciones en Graphics Designer pueden reasignarse con CrossReference de tal forma que se sustituyen en todos los puntos o en puntos seleccionados por otras variables.

Nota

Tambin pueden modificarse variables directamente con Graphics Designer marcando el objeto grfico y seleccionar en el men emergente "Reasignar...".

Obtendr ms informacin en la documentacin de WinCC en el apartado sobre CrossReference.

Acciones y CrossReferencePueden visualizarse todas las propiedades de las acciones utilizadas en una imagen mediante las propiedades de esta imagen. Para ello, seleccionar la imagen en WinCCExplorer y elegir el men emergente "Propiedades". Haciendo doble clic sobre una opcin obtendr informacin detallada acerca del tipo de dinmica.

Tambin pueden visualizarse todas las variables e imgenes utilizadas en acciones mediante la CrossReference de WinCC. Con CrossReference se puede tambin reasignar fcilmente la conexin de variables de las acciones en Graphics Designer.

Variables y CrossReferenceTodas las variables direccionadas con la siguiente frmula estndar se registran automticamente con la CrossReference de WinCC y estn recogidas en las propiedades de imagen.

' VBS1HMIRuntime.Tags("Tagname")

Si accede a variables con otras frmulas en el cdigo, puede darlas a conocer mediante la siguiente seccin de la CrossReference:

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

VBS para crear procedimientos y acciones1.6 Relaciones con CrossReference


Se puede insertar esta seccin cuantas veces se desee en las acciones VBS.

Nota

No se puede garantizar la adquisicin de nombres de variables reunidos de la CrossReference.

Imgenes y CrossReferenceTodas las imgenes direccionadas con la siguiente frmula estndar se registran automticamente con la CrossReference de WinCC y estn recogidas en las propiedades de imagen.

'VBS2HMIRuntime.BaseScreenName = "Screenname"

Si accede a imgenes con otras frmulas en el cdigo, puede darlas a conocer mediante la siguiente seccin de la CrossReference:

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

Se puede insertar esta seccin cuantas veces se desee en las acciones VBS.

Nota

Por motivos de compatibilidad, los nombres de imgenes se debern escribir en versiones futuras siempre sin la extensin de archivo ".PDL".

Consulte tambinReferencia VBS (Pgina 108)



Acciones (Pgina 19)



VBS para crear procedimientos y acciones1.6 Relaciones con CrossReference


1.7 Emplear variables globales con VBS

Introduccin Con el editor de Global Script pueden definirse variables globales que a continuacin se podrn utilizar en todas las acciones y en todos los procedimientos.

Emplear variables globales en Graphics Designer y en Global ScriptPara utilizar variables con Graphics Designer y con Global Script deben observarse las condiciones siguientes:

Para emplear una variable global con Graphics Designer debe iniciarse el procedimiento en el que est definida la variable con el fin de cargar el mdulo correspondiente a runtime.

Para utilizar una variable global en una accin de Global Script debe iniciarse en una accin global como mnimo un procedimiento del mdulo en el que est definida la variable con el fin de cargar este mdulo a Global Script Runtime. No tiene que ser necesariamente el procedimiento en el que se defini la variable.

Este modo de proceder es necesario porque las acciones de Global Script y de Graphics Designer en runtime se ejecutan de forma independiente. No existe ningn rea comn de datos entre los dos sistemas runtime.

Para sincronizar acciones de Global Script y de Graphics Designer debe emplearse el objeto DataSet o variables internas de WinCC.

Emplear variables globales con Graphics DesignerPara utilizar variables globales con Graphics Designer deben observarse las condiciones siguientes:

Para emplear una variable global en una accin cclica o iniciada por un disparador con Graphics Designer debe iniciarse el procedimiento en el que est definida la variable. Esto tambin es necesario si ya se inici la variable en una accin activada por un disparador.

Para emplear una variable global en una accin iniciada por un disparador con Graphics Designer debe iniciarse el procedimiento en el que est definida la variable. Esto tambin es necesario si ya se inici la variable en una accin cclica o activada por un disparador.

Este modo de proceder es necesario porque las acciones cclicas y las acciones activadas por un disparador se ejecutan en Graphics Designer de runtime de forma independiente. No existe ningn rea comn de datos entre los dos tipos de accin.

Para sincronizar acciones cclicas o activadas por un disparador y acciones iniciadas por un evento debe utilizarse el objeto DataSet o variables internas de WinCC.

Con Graphics Designer tambin es posible definir variables globales en un segmento de declaracin independiente. Dado que en runtime las acciones lanzadas por evento y cclicas/lanzadas por variable se procesan por separado, aqu las variables globales solo pueden llamarse dentro de las acciones lanzadas por evento o cclicas/lanzadas por variable.

VBS para crear procedimientos y acciones1.7 Emplear variables globales con VBS


Consulte tambinConceptos bsicos de VBScript (Pgina 826)

Diseo de los archivos de VBScript (Pgina 95)

Crear y editar acciones (Pgina 55)

Crear y editar procedimientos (Pgina 39)


Relaciones con CrossReference (Pgina 24)

Acciones (Pgina 19)


VBS para crear procedimientos y acciones1.7 Emplear variables globales con VBS


1.8 Los editores de VBScript

1.8.1 Los editores de VBScript

IntroduccinEn WinCC se pueden programar scripts VB de dos formas:

En Global Script: Global Script es el editor central para la programacin de VBS. Se inicia mediante el WinCCExplorer.

En el Graphics Designer: En Graphics Designer se programan las acciones en las propiedades de objetos o eventos de objetos grficos. El editor de acciones se inicia en Graphics Designer mediante el men emergente en el dilogo de propiedades de un objeto grfico.

VBS para crear procedimientos y acciones1.8 Los editores de VBScript


Diferencia Global Script - Graphics DesignerEn Graphics Designer pueden programarse acciones y procedimientos especficos de imgenes pero no se pueden programar procedimientos globales vlidos para todo el proyecto. Sin embargo, se pueden iniciar procedimientos programados con Global Script.

Nota

Esta documentacin contempla en primer lugar la descripcin de Global Script haciendo hincapi en las diferencias de funcin frente a Graphics Designer. Obentdr una descripcin detallada del editor de acciones de Graphics Designer en el tema de ayuda "Dinmicas" de WinCC.

Ms informacinObtendr ms informacin en la documentacin de WinCC en el apartado sobre "Dinmicas".

Consulte tambinEl Global Script Editor (Pgina 29)

1.8.2 El Global Script Editor

IntroduccinLos procedimientos y acciones globales se crean y se modifican con el editor de Global Script.

Global Script ofrece un nmero de funciones similar al editor C-Script de WinCC.

Nota

En el tema "Dinamizacin" de la ayuda de WinCC encontrar una descripcin detallada del editor de acciones para crear acciones y procedimientos referidos a imgenes en el Graphics Designer.

Iniciar Global ScriptGlobal Script se inicia mediante el men emergente "Abrir" en la venta de proyecto del WinCCExplorer.



Global Script se inicia tambin de forma automtica al abrir un mdulo o una accin mediante doble clic en el WinCCExplorer.

Diseo de Global ScriptGlobal Script se rige por los estndares de Windows.

El editor de acciones de Graphics Designer ofrece unas funciones similares a las de Global Script. Obtendr una descripcin detallada del editor de acciones de Graphics Designer en el tema de ayuda "Dinmicas" de WinCC.

Barra de men (1) y barra de herramientas (2)La barra de men y la barra de herramientas contienen todos los comandos que se necesitan para crear procedimientos y acciones.

Se pueden visualizar/ocultar las barras de herramientas mediante el comando de men "Ver" > "Barras de herramientas" y se pueden desplazar a cualquier posicin dentro del editor.

Ventana de navegacin (3)La ventana de navegacin le permite gestionar sus procedimientos, mdulos y acciones. Aqu encuentra adems plantillas de cdigo que puede insertar en su accin o procedimiento mediante Arrastrar y Colocar.



Es posible iniciar un procedimiento dentro de otro procedimiento o en una accin movindolo de la ventana de navegacin al lugar correspondiente del cdigo mediante arrastrar&colocar.

La visualizacin de la ventana de navegacin slo se actualiza al guardarse el documento editado. Si modifica un archivo, se indica mediante un * detrs del nombre del archivo.

En la venta de navegacin se visualizan los procedimientos de un mdulo debajo de los archivos del mdulo. En la ficha Acciones tambin se visualizan los disparadores configurados para una accin y, si se da el caso, los procedimientos definidos directamente en un mdulo de accin.

En la ventana de navegacin tambin es posible:

Crear subdirectorios para estructurar scripts.

Directamente desplazar, copiar, insertar, borrar y cambiar el nombre de mdulos y de directorios.

Se puede configurar individualmente la visualizacin de la venta de navegacin con el comando de men "Ver" > "Estacin de trabajo". Aqu se puede seleccionar si se visualizan todos los tipos de archivo, solamente archivos script o solamente archivos script sintcticamente correctos. Con el comando de men "Ver" > "Estacin de trabajo" > "Mostrar" es posible visualizar/ocultar la ventana de navegacin.

Ventana de edicin (4)En la ventana de edicin se escriben y se modifican los procedimientos y las acciones. Cada procedimiento y cada accin se abre en una venta de edicin propia. Se pueden encontrar abiertas varias ventanas de edicin simultneamente.

En la ventana de edicin se asiste al usuario resaltando la sintaxis y mediante Intellisense. Tambin estn disponibles todas las funciones comunes de edicin (z.B. Undo/Redo, Buscar/Reemplazar, Copiar, Insertar, Cortar, Propiedades de fuentes, Soporte para impresoras).

Ventana de resultados (5)En la ventana de resultados se visualizan avisos de fallos al finalizar la verificacin de la sintaxis. Se visualizar la lnea correspondiente del cdigo al hacer doble clic sobre la lnea en la que se encuentra el fallo.

Barra de estado (6)La barra de estado contiene informacin acerca de la funcin seleccionada o consejos para la programacin.

Nota

Para obtener informacin sobre comandos o smbolos del editor, seleccionar el comando de men "?" > "Qu es esto?" Hacer clic con el ratn sobre el smbolo/comando correspondiente. As obtendr una ayuda rpida y directa acerca de todos los elementos de manejo del editor. Para salir del modo de ayuda directa pulsar la tecla "ESC".

Acoplamiento de ventanaEl acoplamiento de ventana permite ordenar las diferentes ventanas con total flexibilidad. Puede cambiar libremente la disposicin de las ventanas, posicionarlas como



ventanas independientes o agruparlas en grupos de pestaas. Coloque sus acciones en paralelo, apiladas o en forma de pestaas, por ejemplo. Puede ocultar ventanas automticamente y volver a mostrarlas en caso necesario. Para ms informacin, consulte el captulo "Crear sinpticos de proceso".

Consulte tambinCmo borrar acciones o procedimientos (Pgina 38)

Operar con las barras de herramientas (Pgina 35)

Operar en la ventana de edicin (Pgina 32)

1.8.3 Operar en la ventana de edicin

Introduccin En la venta de edicin se modifican procedimientos y acciones.

Seccin de declaracin en acciones (solamente Graphics Designer)Si se crean acciones en el editor de acciones del Graphics Designer, se puede visualizar la seccin de declaracin de la accin en la ventana de edicin con el botn .

El rea de declaracin permite tambin determinar propiedades generales que solamente se emplearn para la imagen actual, p.ej.:

Definiciones de variables

Procedimientos que desee utilizar slo en esta imagen

Nota

No debe crearse ningn cdigo directamente ejecutable en el rea de declaracin!

Considere que al crear una variable, sta no debe contener ningn valor (Value = VT_EMPTY). Inicialice variables de acuerdo a la declaracin con un valor correspondiente.

En las definiciones del rea de declaracin, observar el diseo de los archivos script tal y como se describen en "Diseo de archivos VBScript".

"Opcin explcita" en accionesAl crear una accin nueva se inserta la instruccin "Opcin explcita" de forma automtica y no borrable dentro del rea de declaracin (Graphics Designer) o en la primera lnea de una accin (Global Script). La instruccin se necesita para evitar errores debidos a escribir



incorrectamente variables sin declaracin. La instruccin requiere que usted defina siempre variables con la instruccin "Dim" en su cdigo.

Nota

No utilice la instruccin "Opcin explcita" en su cdigo, pues se pueden presentar errores en el tiempo de ejecucin (runtime).

Soporte para el usuario en la ventana de edicinEn la ventana de edicin, el usuario dispone de la ayuda siguiente.

Cdigos de colores e insercin en la ventana de edicinPor defecto, algunas partes del cdigo se marcan con los colores siguientes:

Color Significado Ejemploazul Contraseas

FuncionesSub, End Sub, Next

verde Comentarios ' esto es un comentariorojo Strings (letras y nmeros) "Object1"azul oscuro Instrucciones de preprocesador --negro en negrita Constantes vbTrue, vbFalsenegro otros cdigos --

Es posible modificar individualmente los cdigos de colores de la ventana de edicin mediante las propiedades del editor. Para ello, iniciar el comando de men "Herramientas" > "Opciones" y el dilogo "Opciones del Script Editor" y determinar los valores deseados.

Tambin podr utilizar inserciones para obtener una estructura ms clara de su cdigo. En el dilogo "Opciones

wincc: scripting (vbs, ansi-c, vba) - siemens ag · simatic hmi wincc v7.2 wincc: scripting (vbs,...

Documents