Servidor OLE Automation

5.2

Puesta en marcha

Presentación

Objeto de este apartado

Contenido

Este apartado describe la puesta en marcha del servidor OLE Automation.

Esta sección contiene los siguientes apartados:

Apartado

Instalación de OLE Automation

Mecanismo de acceso al servidor PL7 OLE Automation

Inicio del servidor en modo local (modo COM)

Inicio del servidor en modo remoto (DCOM)

Puesta en funcionamiento del servidor de forma remota

Modos de ejecución del servidor PL7

Puntos de entrada: función OLE

Página

83

84

85

86

87

90

91

82

35013159.01 07/2008

Servidor OLE Automation

Instalación de OLE Automation

Descripción La instalación del servidor OLE Automation con PL7 es transparente para el usuario y se realiza de forma implícita al instalar PL7.

La instalación incluye: z z z

Cuatro ejemplos de cliente OLE Automation completos con su código fuente y un archivo README suministrados con el programa.

Dichos ejemplos corresponden a: z z un cliente Visual C++ 4.2 "mínimo": los conocimientos mínimos para escribir un cliente OLE.

un cliente Visual C++ 4.2 "completo" que utiliza todos los puntos de entrada disponibles.

z un cliente Visual Basic ++ 5.0 que utiliza todos los puntos de entrada disponibles.

z un cliente Excel.

Un archivo *.h que define los valores de los códigos de error procedentes del servidor.

Un archivo TLB de interfaz para un cliente Visual C++.

35013159.01 07/2008

83

Servidor OLE Automation

Mecanismo de acceso al servidor PL7 OLE Automation

El servidor PL7 OLE Automation permite dos modos de acceso a los servicios que ofrece.

Acceso en modo local

La aplicación cliente y el servidor PL7 OLE Automation están en el mismo puesto.

Acceso remoto a través de DCOM

La aplicación cliente y el servidor PL7 Automation están en puestos distintos, conectados a través de la red TCP/IP:

Estación del cliente Estación del servidor

DCOM

84

35013159.01 07/2008

Servidor OLE Automation

Inicio del servidor en modo local (modo COM)

Introducción

Inicio del servidor en modo local

(modo COM)

El modo COM (Component Object Model) define una interface de comunicación entre aplicaciones que proporciona independencia respecto a las herramientas de desarrollo.

Para iniciar el servidor en modo local, siga el procedimiento que se describe a continuación:

1

2

3

4

Declare un objeto «A» en la aplicación cliente para comunicarse con la aplicación del servidor.

Ejecute la función Createdispatch en el objeto "A" de la aplicación cliente para iniciar una instancia en la aplicación del servidor.

Registre PL7Pro en la base de registro como servidor OLE para un funcionamiento correcto en modo servidor (el enlace entre la aplicación cliente y la aplicación servidor se crea si éste se ha referenciado en la base de registro).

La aplicación cliente puede ahora interrogar a la aplicación servidor a través de la interface accesible del objeto «A».

Ejemplo: OpenStx("C:\appli.stx).

35013159.01 07/2008

85

Servidor OLE Automation

Inicio del servidor en modo remoto (DCOM)

Introducción El servidor Pl7 se ejecuta en función de la información presente en la base de registro. Puede encontrarse en el equipo cliente o en un equipo remoto.

El modo DCOM es una extensión del modo COM (Component Object Model). Este modo permite establecer el diálogo entre una aplicación cliente y una aplicación servidor en un mismo equipo.

El modo DCOM permite dialogar entre dos equipos remotos. Sustituye los protocolos de comunicación entre procesos por los protocolos de red.

En la siguiente figura, se muestra el funcionamiento de OLE Automation en modo servidor remoto:

Elección del driver

Servidor PL7

Cliente

PC a

Cliente

Cliente

PC b

COM tiempo de ejecución

Seguridad proveedor

DCE RPC

Pila de protocolos

Elección del driver

Servidor PL7

PC c

COM tiempo de ejecución

Seguridad proveedor

DCE RPC

Pila de protocolos

Componente red DCOM protocolo

86

35013159.01 07/2008

Servidor OLE Automation

Puesta en funcionamiento del servidor de forma remota

Introducción

Configuración del Cliente

DCOM es una configuración específica necesaria en un PC cliente para soportar el acceso remoto al PC en el que está instalado el servidor (PL7 Pro Server). En un

PC que soporte Windows XP Professionnal o

Windows VISTA Professional Edition 32, DCOM debe estar configurado utilizando la herramienta DCOMCnfg.exe.

El siguiente procedimiento explica cómo configurar el DCOM y se aplica a los sistemas de explotación Windows XP Professional o

Windows VISTA Professional Edition 32:

Etapa

1

2

3

Acción z z

Inicie DCOMCnfg.exe

situado en la agenda:

C:\Windows\System32

Y en el icono Raíz de la consola

→

Servicio de componentes

→

Ordenadores

→

Puesto de trabajo , muestre las propiedades haciendo clic con el botón derecho del ratón, o

Haga clic en Panel de configuración

→

Herramientas de administración

→

Servicios de componentes .

En la ventana que aparece, haga glic en Servicios de componentes

→

Ordenadores .

En el icono Puesto de trabajo , muestre las propiedades haciendo clic con el botón derecho del ratón.

En la pestaña Propiedades por defecto , verifique que: z La opción Activar Distributed COM (DCOM) en este ordenador se encuentra seleccionada.

z El campo

Conectar .

Nivel de autenticación por defecto se encuentra definido en z El campo Nivel de copia de identidad por defecto se encuentra definido en Identificar .

En la pestaña Seguridad COM :

Modifique la lista Autorizaciones de acceso con el fin de asegurarse de que los usuarios SISTEMA , INTERACTIVO , RED y Todo el mundo aparezcan.

Este último parámetro sólo se necesita para autorizar al servidor para que reenvíe notificaciones al cliente.

35013159.01 07/2008

87

Servidor OLE Automation

Configuración del Servidor

Estos parámetros de configuración deben ser definidos en el curso de conexión con el equipo cuando disponga de una cuenta con las autorizaciones necesarias de acceso y de inicio del servidor

Etapa

1

2

3

Acción z z

Inicie DCOMCnfg.exe

situado en la agenda:

C:\Windows\System32

Y en el icono Raíz de la consola

→

Servicio de componentes

→

Ordenadores

→

Puesto de trabajo , muestre las propiedades haciendo clic con el botón derecho del ratón, o

Haga clic en Panel de configuración

→

Herramientas de administración

→

Servicios de componentes .

En la ventana que aparece, haga glic en Servicios de componentes

→

Ordenadores .

En el icono Puesto de trabajo , muestre las propiedades haciendo clic con el botón derecho del ratón.

En la pestaña Propiedades por defecto , verifique que: z La opción Activar Distributed COM (DCOM) en este ordenador se encuentra z z seleccionada.

El campo Nivel de autenticación por defecto se encuentra definido en Conectar .

El campo Nivel de copia de identidad por defecto

Identificar .

se encuentra definido en

En la agenda Configuración DCOM

→

OLE Automation muestre las propiedades haciendo clic con el botón derecho del ratón. La ventana de diálogo Propiedades de

OLE Automation Server aparece.

z Haga clic en la pestaña Identidad . La opción El usuario interactivo debe ser seleccionada. La opción Este usuario con la contraseña adecuada debe ser seleccionada si ningún usuario se conecta al servidor o si la sesión es modificada o interrumpida sin motivo.

z Haga clic en la pestaña defecto .

General , el nivel de autentificación debe ser definido en Por z z

Haga clic en la pestaña Ubicación , la opción Ejecutar la aplicación en este equipo debe ser seleccionada.

En la pestaña Seguridad

→

Autorizaciones de ejecución y de activación , seleccione Personalizar .

z Haga clic en Modificar , la ventana de diálogo Autorización de ejecución z z aparece.

Haga clic en Agregar , agregar usuarios, y autorizar el acceso (los usuarios

SISTEMA , INTERACTIVO y RED deben aparecer en esta lista, otros como Todo el mundo pueden ser agregados), z Haga clic en OK y cierre las ventanas de diálogo.

En la pestaña Seguridad

→

Autorizaciones de acceso , seleccione Personalizar .

z Haga clic en Modificar , la ventana de diálogo Autorización de acceso aparece.

z Haga clic en Agregar , agregar usuarios, y autorizar el inicio del servidor (los z usuarios SISTEMA , INTERACTIVO y RED deben aparecer en esta lista, otros como Todo el mundo pueden ser agregados).

Haga clic en OK y cierre las ventanas de diálogo.

88

35013159.01 07/2008

Servidor OLE Automation

Nota: si el cliente y el servidor no pertenecen al mismo dominio XP o VISTA, o si no existe ningún dominio XP o vista, no olvide que unos usuarios idénticos que dispongan de una contraseña idéntica deben crearse en los dos equipos (tenga cuidado en respetar la casilla).

35013159.01 07/2008

89

Servidor OLE Automation

Modos de ejecución del servidor PL7

Introducción

Modos de ejecución

El servidor OLE Automation con PL7 posee dos modos de ejecución que se pueden elegir de forma dinámica durante la ejecución (véase SetIHMServer ).

z z

Modo de ejecución sin IHM. PL7 se inicia como "tarea de fondo" sin ninguna visualización ni posibilidad de entrada del operador. Es el modo típico que debe emplearse, por ejemplo, para automatizar las tareas repetitivas o acceder a información en una aplicación contenida en un archivo stx.

Modo de ejecución con IHM. PL7 se inicia como un PL7 "interactivo" con visualización y posibilidad de entrada del operador, y sigue recibiendo los comandos emitidos por su aplicación cliente. Este modo se ha desarrollado para visualizar elementos de programa o de configuración de una aplicación contenida en un archivo stx desde herramientas externas, por ejemplo, DIAG

Viewer.

Nota: los servicios relativos a la visualización de programas, herramientas o módulos sólo se ejecutan en el modo con IHM.

El servidor OLE Automation con PL7, en el modo con IHM, está sujeto a los controles de derechos de usuarios. Está situado en el perfil del derecho de usuario

"Read Only", que corresponde a su función de visualizador de códigos y módulos de E/S PL7.

El servidor OLE Automation con PL7, en el modo sin IHM, no está sujeto a los controles de derechos de usuarios, pero los servicios ofrecidos no permiten modificar la aplicación.

90

35013159.01 07/2008

Servidor OLE Automation

Puntos de entrada: función OLE

Introducción

Contexto de ejecución

Los puntos de entrada se clasifican en cuatro tipos: z z z z

Contexto de ejecución

Control API

Lectura de la información

Visualización de elementos de la aplicación

Puntos de entrada

Nombre

OpenStx

SaveStx

CloseStx

Set DriverAndAddress

SetServerIHM

GetPL7IHM

GetMessageError

Descripción

Apertura de una aplicación

Registro de la aplicación activa

Cierre de la aplicación activa

Modificación de la dirección y el driver del autómata al que se accede

Cambio del modo interactivo del servidor PL7 OLE

Automation

Proporciona el estado: aplicación abierta o cerrada, modo local - conectado, estado API

Lee el mensaje de error asociado al código de error

Control API Puntos de entrada

Nombre

ConnectPLC

DisconnectPLC

SenCommandToPLC

DownloadToPLC

UploadFromPLCM

DownloadStationWithSym bol

Descripción

Entra en el modo conectado

Sale del modo conectado

Envía un comando al autómata (RUN, STOP INIT)

Carga de la aplicación activa en un autómata

Copia de una aplicación del autómata en la aplicación activa

Carga de una aplicación y su base comprimida de símbolos en el autómata

35013159.01 07/2008

91

Servidor OLE Automation

Lectura de la información

Puntos de entrada

Nombre

ExportScyFile

ExportFefFile

GetSymbol

GetSTXAppIdentity

GetPLCAppIdentity

GetServerVersion

CompareSymbolPCAndSymb olPLCAppli

Descripción

Exportación de los símbolos a la aplicación activa en forma de archivo scy

Exportación de la aplicación activa en forma de archivo tipo fef

Lee el símbolo y el comentario asociado a una variable

Lee la información general de una aplicación incluida en un archivo STX

Lee la información general de una aplicación incluida en un autómata

Lee la versión del servidor

Muestra la información general de una aplicación incluida en un autómata

Visualización de elementos de la aplicación

Puntos de entrada

Nombre

SetPosPL7Window

ShowProgram

CloseProgram

ShowIOModule

CloseIOModule

ShowDFB

CloseDFB

OpenTool

Descripción

Modifica las características de visualización del PL7

(posición y forma)

Apertura de un editor en un módulo de programa determinado

Cierre de un editor de programa

Apertura de un editor en un módulo de E/S determinado

Cierre de un editor en un módulo de E/S determinado

Apertura de un editor en el código de un DFB determinado

Cierre de un editor en el código de un DFB

Apertura de una herramienta MDI cualquiera sin contexto

Nota: los puntos de entrada relativos a la visualización de elementos de la aplicación no funcionan si el servidor está en modo sin IHM.

92

35013159.01 07/2008