ES PI DataLink User Guide

Manual del usuario de PI DataLink

Versin 3.1

2006-12

1992-2007 OSIsoft, Inc. Reservados todos los derechos

OSIsoft, Inc. 777 Davis St., Suite 250 San Leandro, CA 94577 EE.UU. (01) 510-297-5800 (telfono principal) (01) 510-357-8136 (fax) (01) 510-297-5828 (telfono de soporte tcnico)

[email protected]

Houston, TX Johnson City, TN Mayfield Heights, OH Phoenix, AZ Savannah, GA Seattle, WA Yardley, PA

OSIsoft Australia Perth, Australia Auckland, Nueva Zelanda

OSI Software GmbH Altenstadt, Alemania

OSI Software Asia Pte Ltd. Singapur

OSIsoft Canada ULC Montreal, Canad

OSIsoft, Inc. Oficina representativa Shanghai, Repblica Popular China

OSIsoft Japan KK Tokio, Japn

OSIsoft Mexico S. De R.L. De C.V. Ciudad de Mxico, Mxico

Puntos de venta/Distribuidores Brasil Oriente Medio/frica del Norte Repblica de Sudfrica Rusia/Asia central

Amrica del Sur/Caribe Asia Suroriental Korea del Sur Taiwn

www.osisoft.com

OSIsoft, Inc. es el propietario de las siguientes marcas comerciales y marcas comerciales registradas: PI System, PI ProcessBook, Sequencia, Sigmafine, gRecipe, sRecipe y RLINK. Todos los trminos mencionados en este manual que sean marcas comerciales o marcas de servicio irn en mayscula. Toda marca comercial que aparezca en este libro que no pertenezca a OSIsoft, Inc. es la propiedad de su propietario y su uso aqu no indica, bajo ningn concepto, una aprobacin, recomendacin o garanta de los productos de dicha parte o ningn tipo de afiliacin con la misma.

LEYENDA DE DERECHOS LIMITADOS

Su uso, rplica o difusin por parte del Gobierno est sujeto a las restricciones estipuladas en el subprrafo (c)(1)(ii) de la clusula de Derechos de los Datos Tcnicos y Software de Equipo en DFARS 252.227-7013

Manual del usuario de PI DataLink iii

Contenido

Captulo 1: Introduccin .............................................................................................................1 Contenido de PI DataLink..........................................................................................1 Requisitos del sistema...............................................................................................1 Instalacin..................................................................................................................3 Para el administrador de PI System ..........................................................................8

Captulo 2: Complemento para Excel......................................................................................15 Resumen..................................................................................................................15 Tutorial .....................................................................................................................16 Men PI....................................................................................................................23 Cuadros de dilogo..................................................................................................25 Tiempo en PI DataLink ............................................................................................28 Funciones de PI DataLink........................................................................................32 Detalles para las funciones y los cuadros de dilogo de PI DataLink.....................35 Escribir datos de Excel a PI.....................................................................................88 Lmites de Excel para PI DataLink ..........................................................................90

Captulo 3: Complemento para Lotus 1-2-3............................................................................91 Tutorial .....................................................................................................................91 Men PI..................................................................................................................101 Cuadros de dilogo................................................................................................103 Tiempo en PI DataLink ..........................................................................................108 Comandos de macro personalizados de PI DataLink ...........................................110 Detalles del cuadro de dilogo y la macro personalizada PI.................................111 Escribir datos de Lotus 1-2-3 a PI .........................................................................137 Limitaciones de PI DataLink para Lotus 1-2-3.......................................................140

Apndice A: Resolucin de problemas...................................................................................141 El complemento de DataLink no se carga correctamente.....................................141 Problemas de conexin informados en los archivos de registro...........................142

Apndice B: Sintaxis de expresiones......................................................................................147 Expresiones de clculo..........................................................................................147

Contenido

iv

Expresiones de filtro ..............................................................................................150

Apndice C: Ejemplos de cadenas de tiempo PI....................................................................153 Hora de inicio y de finalizacin ..............................................................................153 Intervalo de tiempo ................................................................................................154

Apndice D: Argumentos de Setup.ini ....................................................................................155 Instalaciones silenciosas .......................................................................................155 Instalacin de PI SDK............................................................................................155 Instalacin de PI DataLink.....................................................................................156

Apndice E: Cdigos de salida ................................................................................................157

Apndice F: Soporte tcnico y recursos ................................................................................159 Opciones del soporte tcnico ................................................................................159 Antes de llamar o escribir solicitando ayuda .........................................................160

ndice ...........................................................................................................................................163

Manual del usuario de PI DataLink 1

Captulo 1: Introduccin

PI DataLink proporciona un enlace entre el servidor PI 3 o PI 2 de OSIsoft y los programas de hoja de clculo que se ejecutan en las plataformas Microsoft Windows. Con PI DataLink, un usuario que est ejecutando Microsoft Excel o Lotus 1-2-3 puede intercambiar informacin directamente con las bases de datos de PI System. Combinada con la funcionalidad de los programas de hoja de clculo, esta funcin convierte a PI DataLink en una herramienta potente y fcil de manejar para recopilar, analizar y comunicar datos PI.

Contenido de PI DataLink

PI DataLink est compuesto por los dos mdulos siguientes:

Un complemento para Microsoft Excel Un complemento para Lotus 1-2-3 PI DataLink para Excel est creado con el producto PI SDK de OSIsoft. Permite que los usuarios que tengan experiencia con Microsoft Visual Basic para Aplicaciones (VBA) puedan desarrollar rutinas que abran las funciones PI SDK.

PI DataLink para Lotus 1-2-3 est creado con el producto PI API de OSIsoft. Permite que los usuarios que tengan experiencia en el uso de la herramienta programacin 1-2-3 LotusScript puedan desarrollar rutinas de hojas de clculo de Lotus que abran las funciones PI API.

Sin embargo, los usuarios que deseen desarrollar programas fuera de Excel o Lotus 1-2-3 deben adquirir una licencia para PI SDK o PI API diferente. Pngase en contacto con su representante de ventas de OSIsoft para obtener ms informacin.

Requisitos del sistema

PI DataLink se ejecuta en una aplicacin de hoja de clculo adecuada en un equipo cliente Microsoft Windows PC y recupera la informacin almacenada en un servidor PI a travs del software de red estndar.

Introduccin

2

Sistema operativo y software de red

El servidor PI se puede ejecutar en OpenVMS, Windows o UNIX. PI DataLink se comunica con el servidor PI a travs del protocolo TCP/IP.

TCP/IP

Para utilizar TCP/IP, es necesario uno de los siguientes sistemas operativos:

Microsoft Windows 98, 2000, o XP Microsoft Windows NT, versin 4 SP6a Los usuarios de Microsoft Windows deben utilizar la capa TCP/IP creada en el sistema operativo.

TCP/IP en OpenVMS

Si el servidor PI se ejecuta en OpenVMS, en el equipo VMS ser necesario uno de los siguientes paquetes de software TCP/IP:

Servicios DEC TCP/IP para OpenVMS, versin 2.0+ Software de proceso TCPWare, versin 3.1+ Cisco MultiNet, versin 3.4+ Attachmate Pathway, versin de ejecucin 1.1+

Programas de hoja de clculo compatibles

PI DataLink es compatible con los siguientes programas de hoja de datos (slo versiones de 32 bits):

Microsoft Excel 2000, versin 9.0 y posterior. Lotus 1-2-3 versin 9.5 (incluida como parte de Lotus SmartSuite Millennium) y

posterior.

Instalacin


Instalacin

Nota: Antes de la instalacin, cada usuario de PI DataLink debe disponer de la licencia para utilizar este producto. Para obtener ms informacin, pngase en contacto con el personal de ventas de OSIsoft.

El usuario puede instalar PI DataLink desde el CD de distribucin, ya sea localmente en un equipo o globalmente en un servidor de archivos de red. Esto ltimo lo suele llevar a cabo un administrador del sistema.

Una vez que PI DataLink se haya instalado correctamente en un servidor de archivos de red, otros usuarios podrn instalar una versin independiente completa o una versin compartida de PI DataLink desde la unidad de red a un equipo local.

La instalacin de una versin independiente crea una copia de los archivos de PI DataLink en el equipo local del usuario. En una instalacin de la versin compartida, los principales archivos PI DataLink permanecen en el servidor de archivos de red y los usuarios ejecutan los archivos de programa desde el servidor.

Instalacin en un servidor de archivos de red

Esta opcin est ideada como un procedimiento nico para un administrador del sistema. Esta instalacin por s sola no permite que se pueda ejecutar PI DataLink. Por lo tanto, los usuarios individuales deben instalar una versin independiente o una versin compartida de PI DataLink.

La instalacin en un servidor de archivos de red se realizar en un equipo local.

A continuacin se resume el procedimiento para la instalacin en un servidor de archivos de red:

1. Ejecute AdminSetup.exe desde el CD de distribucin en el servidor de archivos de red.

2. Seleccione el directorio de destino (por ejemplo: C:\APPS\). El programa de instalacin crear los subdirectorios EXCEL, DAT, LIBRARY, LOTUS y SETUP en C:\APPS\PIPC.

3. Para las instalaciones compartidas, edite la seccin [COMMANDLINES] de setup.ini en el directorio SETUP:

6 = SHARED="P:\APPS\PIPC"

Introduccin

4

donde P: es la letra de unidad que todos los equipos locales especifican para indicar la unidad C: del servidor de archivos de red. Consulte Setup.ini Arguments (consulte "Argumentos de Setup.ini" en la pgina 155) para obtener ms argumentos.

4. Para crear una lista de servidores PI, realice una instalacin compartida en un equipo que disponga de derechos de escritura en el directorio P:\APPS\PIPC\DAT. Aada servidores PI como lo hara normalmente. Todos los cambios que se efecten se propagarn al resto de instalaciones compartidas.

Las notas de la versin actual se encuentran en C:\APPS\PIPC\readme_datalink.txt.

Las notas de la versin de las versiones anteriores se encuentran en C:\APPS\PIPC\readme_dl.txt.

Instalacin en un equipo local (independiente y compartida)

Para poder utilizar PI DataLink, cada usuario debe instalar un versin independiente completa o una versin compartida. La instalacin de una versin idependiente se puede llevar a cabo desde el CD de distribucin o desde la unidad de red. La instalacin de una versin compartida nicamente se puede realizar desde la unidad de red.

A continuacin se resume el procedimiento para la instalacin en un equipo local:

1. Ejecute el archivo setup.exe del CD de distribucin o del directorio de instalacin de la unidad de red (por ejemplo, P:\APPS\PIPC\SETUP\setup.exe).

2. Seleccione el directorio de destino.

Las notas de la versin se encuentran en P:\APPS\PIPC\readme_datalink.txt.

Las notas de las versiones anteriores se encuentran en P:\APPS\PIPC\readme_dl.txt.

Configuracin de Microsoft Excel

Si PI DataLink se va a utilizar con Microsoft Excel y se trata de la primera instalacin (no una actualizacin) de PI DataLink, tendr que aadir PI DataLink.

1. Inicie Excel.

2. Abra el administrador de complementos de Excel a travs de Herramientas > Complementos.

Instalacin


3. Busque y seleccione el archivo PIPC32.XLL. Para una instalacin local, el archivo PIPC32.xll se encontrar en el directorio ...\PIPC\EXCEL. Para una instalacin compartida de PI DataLink, acuda al directorio ...\PIPC\EXCEL de la unidad de red.

Si PI DataLink se actualiza y se coloca en un directorio diferente al de las versiones anteriores, el administrador de complementos de Excel se deber utilizar en primer lugar para eliminar el anterior archivo PIPC32.XLL. A continuacin, se debe seleccionar el nuevo archivo PIPC32.XLL en la nueva ubicacin.

Usuarios fuera de EE.UU.

Para configurar el formato de nmero y de hora para fuera de EE.UU., lleve a cabo los siguientes pasos en Microsoft Excel despus de haber instalado DataLink:

1. En el men PI, haga clic en Ajustes. Se mostrar el siguiente cuadro de dilogo:

2. Modifique las entradas de Formato de nmero y Formato de hora para que reflejen el equivalente a "General" y "dd-mmm-yy hh:mm:ss" de su pas respectivamente. Las entradas para los campos de formato de nmero y de hora pueden ser cualquier cdigo de formato vlido de Excel de Formato, Celdas, Nmero, Personalizar.

Introduccin

6

Por ejemplo, en Alemania los equivalentes de "General" y "dd-mmm-yyyy hh:mm" son "Standard" y "TT-MM-JJJJ hh:mm" respectivamente.

Instalacin


Configuracin de Lotus 1-2-3

Para configurar PI DataLink para que funcione con Lotus 1-2-3:

1. Inicie Lotus 1-2-3.

2. En el men principal, vaya a: Archivo > Complementos > Administrar complementos...

3. en el directorio ...\lotus\addins y haga clic en Abrir.

4. Compruebe el espacio situado delante de la ruta de archivo de pidl.12a y haga clic en Listo.

5. Salga de Lotus 1-2-3 y vuelva a iniciarlo. El men PI-DataLink deber estar disponible ahora.

PI DataLink para Lotus 1-2-3 no es compatible con instalaciones compartidas. PI DataLink para 1-2-3 se debe instalar independientemente en cada equipo (estas instalaciones se pueden llevar a cabo desde una instalacin de red central).rar en el cuadro de dilogo Administrar complementos.

6. Seleccione pidl.12aHaga clic en Regist

Introduccin

8

Nuevas funciones para usuarios de Microsoft Excel

En el archivo ...\PIPC\readme_datalink.txt encontrar una lista con las nuevas funciones que se incluyen en esta versin de PI DataLink.

Nuevas funciones para Lotus 1-2-3

En el archivo ...\PIPC\readme_datalink.txt encontrar una lista con las nuevas funciones que se incluyen en esta versin de PI DataLink.

Correccin de errores

En el archivo ...\PIPC\readme_datalink.txt encontrar una lista de los problemas conocidos que se han corregido en esta versin de PI DataLink.

Para el administrador de PI System

Servidor PI 2

Servicio de servidor PI

Si PI DataLink se comunica con el servidor PI a travs del TCP/IP, el administrador de PI System debe llevar a cabo una configuracin nica del servicio de servidor PI. Este servicio de servidor PI lo utiliza no slo PI DataLink, sino tambin todas las aplicaciones cliente del equipo OSIsoft. Consulte el archivo PIBuild:PIServer.txt del equipo VAX/Alpha.

Archivo de seguridad

El servicio del servidor PI admite una combinacin de autentificacin de nodo y seguridad de nombre de usuario/contrasea para aplicaciones cliente del equipo. El archivo de acceso del servidor PI, PISysDat:PIServer.Dat, determina qu mquinas tienen acceso a los datos PI. Si no existe este archivo, se debe crear.

Para la seguridad de la autentificacin de nodos, aada entradas para determinadas mquinas. Por ejemplo:



[USERDATABASE] DEFAULT=PI [CLIENTACCESS] DEFAULT=R PINET1=RW PINET2=RW PC1=RW PC2=NONE

Las entradas anteriores de PISysDat:PIServer.Dat tienen como resultado lo siguiente:

1. Las mquinas denominadas "PINET1" y "PINET2" disponen de acceso de lectura y escritura incondicional a los datos PI. Este nivel de acceso se debe proporcionar a los nodos PINet.

2. La mquina denominada "PC1" tambin dispone de acceso de lectura y escritura incondicional a los datos PI. Este nivel de seguridad implica que cualquier persona que tenga acceso al propio "PC1" dispondr de acceso de lectura y escritura incondicional a los datos PI a travs de PI DataLink.

3. El equipo denominado "PC2" no tiene acceso a los datos PI. Este nivel de seguridad implica que nadie puede utilizar PI DataLink en "PC2" para recuperar datos en hojas de clculos.

4. El resto de equipos disponen de acceso de lectura incondicionales a los datos PI. Este nivel de seguridad implica que todos los usuarios de estas mquinas podrn obtener datos de PI, pero no escribirlos en l, con PI DataLink.

5. Para la seguridad de nombre de usuario/contrasea, aada la letra L despus del tipo de acceso:

[USERDATABASE] DEFAULT=PI [CLIENTACCESS] DEFAULT=RL PINET1=RW PINET2=RW PC1=RLWL PC2=NONE

Este PIServer.Dat es el mismo que el del ejemplo anterior, excepto en dos casos:

La mquina denominada "PC1" dispone de acceso de lectura y escritura condicional. Este nivel de seguridad implica que slo el usuario con el nombre de usuario y contrasea adecuados puede leer y escribir en "PC1" a travs de PI DataLink.

El resto de equipos disponen de acceso condicional a los datos PI. Este nivel de seguridad implica que los usuarios deben proporcionar un nombre de usuario PI y una contrasea vlidos para acceder a los datos PI y ningn usuario puede escribir de nuevo los datos en PI.

Recuerde que los nombres del nodo TCP/IP distinguen entre maysculas y minsculas. Adems, los valores de las entradas de la seccin CLIENTACCESS (es decir, R y W) tambin distinguen entre maysculas y minsculas.

Para que la seguridad del nodo o del nombre de usuario/contrasea funcione correctamente, es esencial que el servidor PI pueda determinar el nombre del equipo cliente en el que se est ejecutando PI DataLink. Las siguientes secciones proporcionan informacin especfica para DECNet y los TCP/IP de los diversos proveedores.

Introduccin

10

Traduccin de nombre - UCX (o TCPIP para VMS 7.2+)

En Servicios DEC TCP/IP para VMS, el servidor PI 2 solicita a UCX que le proporcione el nombre de host de una determinada conexin PI DataLink. A su vez, UCX consulta a la base de datos de host UCX de VAX/Alpha o del servidor de nombres de dominio (si est configurado).

Para confirmar que UCX est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:

$ ucx show device /port=545 Deber ver el nombre de host remoto incluido bajo Remoto. PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este nombre de host.

Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host remoto, esto querr decir que UCX (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat.

Para aadir una entrada en la tabla de host UCX para un equipo: $ ucx set host "mypc" /addr=192.168.100.77

Consulte su documentacin sobre UCX para obtener ms detalles.

Traduccin de nombre - MultiNet

En MultiNet, el servidor PI 2 le pide a MultiNet que le suministre el nombre de host de una determinada conexin PI DataLink. A su vez, MultiNet consulta a la base de datos de host MultiNet de VAX/Alpha o del servidor de nombres de dominio (si est configurado). Para confirmar que MultiNet est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:

$ multinet show Deber ver el nombre del host local, as como el nombre del host (del equipo) externo. PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este ltimo nombre de host.

Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host externo, esto querr decir que MultiNet (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat.

Para aadir una entrada en la tabla de host Multinet del VAX/Alpha para un equipo, debe editar el archivo MultiNet:Hosts.Local. Una vez editado, debe ejecutar los siguientes comandos:

$ multinet host_table compile $ @multinet:install_databases



Consulte su documentacin sobre Multinet para obtener ms detalles.

Traduccin de nombre - PathWay

En PathWay, el servidor PI 2 le pide a PathWay que le suministre el nombre de host de una determinada conexin PI DataLink. A su vez, PathWay consulta a la base de datos de host de VAX/Alpha o del servidor de nombres de dominio (si est configurado). Para confirmar que PathWay est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:

$ netstat Deber ver el nombre del host local, as como el nombre del host (del equipo) externo. PISysDat:PIServer.Dat. controla el nivel de acceso a los datos PI de este ltimo nombre de host.

Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host externo, esto querr decir que PathWay (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat.

Para aadir una entrada en la tabla de host PathWay de VAX para un equipo, debe editar el archivo twg$etc:Hosts. Para obtener ms detalles, consulte su documentacin de PathWay.

Traduccin de nombre - TCPWare

En TCPWare, el servidor PI 2 le pide a TCPWare que le suministre el nombre de host de una determinada conexin PI DataLink. A su vez, TCPWare consulta a la base de datos de host de VAX/AlphaAXP o del servidor de nombres de dominio (si est configurado). Para confirmar que TCPWare est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:

$ netcu show connections /host_names Deber ver el nombre del host local, as como el nombre del host (del equipo) remoto. PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este ltimo nombre de host.

Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host remoto, esto querr decir que TCPWare (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat.

Para aadir una entrada en la tabla de host TCPWare del VAX/Alpha para un equipo, debe editar el archivo TCPWare:Hosts. Puede que tenga que reiniciar TCPWare para que el cambio sea efectivo. Consulte su documentacin sobre TCPWare para obtener ms detalles.

Introduccin

12

Servidor PI 3

Base de datos de firewall

La base de datos de firewall que se encuentre en la mquina en la que se est ejecutando el servidor PI 3 se debe configurar para que permita el acceso a los equipos en los que se est ejecutando PI DataLink. Por ejemplo,

PIConfig> @table pi_gen,pifirewall PIConfig> @ostr hostmask,value PIConfig> @select hostmask=* PIconfig> @ends *.*.*.*, ALLOW

Esto indica que todos los equipos pueden conectarse al servidor PI 3. *.*.*.*, DISALLOW 192.168.100.*, ALLOW

Indica que slo est permitido que se conecten los equipos cuya direccin TCP/IP comience por 192.168.100.

Para obtener ms informacin, consulte los manuales de usuario del servidor PI que se pueden descargar de http://techsupport.osisoft.com/downloadcenter.aspx (http://techsupport.osisoft.com/downloadcenter.aspx) en "PI 3 Enterprise Server".

Base de datos segura

La base de datos segura que se encuentre en la mquina en la que se est ejecutando el servidor PI 3 se puede configurar para que permita el acceso, sin inicio de sesin explcito, a los equipos en los que se est ejecutando PI DataLink. Por ejemplo,

PIconfig> @table pitrust PIconfig> @ostr trust,ipaddr,iphost,piuser PIconfig> @select trust=* PIconfig> @ends MyPCTrust,0.0.0.0,mypc,piadmin

Esto indica que cualquier aplicacin que se conecte al servidor PI 3 desde "mypc" obtendr privilegios piadmin de forma predeterminada.


Atributos de acceso de puntos/acceso de datos

Cuando PI DataLink se conecta con PI 3 Server, le solicita al usuario un nombre de usuario y una contrasea. El nombre de usuario se utiliza junto con los campos PtOwner, PtAccess, DataOwner y DataAccess.

Por ejemplo, si el tag SINUSOID se configura de forma que PtAccess sea O:RW, G:NONE, W:NONE y PtOwner sea USER1, los usuarios de PI DataLink deben iniciar la sesin como USER1 para poder ver este tag. De otro modo, no se podr encontrar el tag.



Tambin, si SINUSOID DataAccess es O:R, G:NONE, W:NONE y DataOwner es USER1, los usuarios de PI DataLink deben iniciar la sesin como USER1 para poder ver los datos de este tag. De lo contrario, aparecer un mensaje de error de acceso de lectura.

No obstante, incluso al iniciar la sesin como USER1, en este caso no se permitir que PI DataLink escriba datos en SINUSOID puesto que el atributo de DataAccess es O:R (slo lectura). El administrador de PI System deber cambiar DataAccess a O:RW (lectura y escritura). nicamente cuando se haya realizado este cambio los usuarios de PI DataLink que inicien su sesin como USER1 podrn leer y escribir datos para SINUSOID.


Nota: El usuario PIAdmin es un usuario superprivilegiado. Un usuario de PI DataLink que inicie la sesin como PIAdmin dispondr de acceso de lectura y escritura a todos los tags. Por este motivo, los usuarios de PI DataLink normalmente NO deberan iniciar la sesin como PIAdmin.


Captulo 2: Complemento para Excel

Resumen

El complemento PI DataLink para Excel proporciona a los usuarios de Microsoft Excel la capacidad de recuperar datos asociados con tags de un servidor PI directamente en una hoja de clculo. An ms, los usuarios pueden escribir valores de la hoja de clculo en PI.

PI DataLink proporciona las siguientes funciones para recuperar datos de PI:

Valor actual Valor en un momento determinado Atributos del tag Datos espaciados de forma uniforme (de muestra) Datos de muestra mientras una expresin determinada es verdadera Datos comprimidos (archivados) Datos comprimidos si una expresin determinada es verdadera Datos de muestra para una matriz de marcas de tiempo especificada por el usuario Datos de los clculos en las expresiones del tag PI Cantidad de tiempo mientras una expresin de tag PI era verdadera Totales, mnima, mxima, desviaciones estndar, rangos, promedios, recuentos y

mtodos para tags y expresiones PI

Nombre de tag de un identificador del punto especificado Nombres de tags de mscaras de atributos especificadas Valor de alias de una base de datos de mdulo Valor de propiedad de una base de datos de mdulo

Complemento para Excel

16

Tutorial

El objetivo de este tutorial es iniciarle en el uso de PI DataLink en Excel lo ms rpido posible. Las funciones de PI DataLink no se desarrollan de forma detallada en este tutorial. En su lugar, servir para familiarizar al usuario con el funcionamiento general de este complemento.

Verificar comunicaciones con el servidor PI

En este primer ejemplo confirmaremos que PI DataLink se ha instalado adecuadamente y que se puede conectar con el servidor PI.

Inicie Excel y asegrese de que la seleccin de men PI se encuentra en la barra de mens de Excel. Si PI no aparece en ella, tendr que utilizar el administrador de complementos de Excel. Consulte Configuracin de Microsoft Excel.

Desde la barra de mens de PI, seleccione Conexiones....

Si el estado indica que el servidor PI no est conectado, haga clic en la casilla de verificacin para conectarlo. Si la cuenta de usuario predeterminada del servidor PI seleccionado requiere una contrasea, aparecer el cuadro de dilogo de inicio de sesin en el que se le solicitar la contrasea:

Tutorial


En este cuadro de dilogo tambin se puede modificar el nombre de usuario para el inicio de sesin y utilizar uno diferente al del usuario predeterminado.

Un nombre de usuario/contrasea vlido modifica el cuadro de dilogo Estados en las conexiones y muestra el usuario con el que est conectado DataLink. Cierre el cuadro de dilogo de conexiones haciendo clic en Cancelar.

Si aparece un cuadro de dilogo de fallo al iniciar la sesin, confirme que su nombre de usuario/contrasea PI sean vlidos. Si el cuadro de dilogo de fallo al iniciar la sesin aparece a pesar de que el nombre de usuario/contrasea PI son vlidos, quiere decir que PI DataLink no se puede conectar al servidor PI. Consulte la seccin Resolucin de problemas (en la pgina 141).

Atributos del tag y Valor actual

En este ejemplo obtendremos el descriptor del tag, el valor actual y las unidades de ingeniera para algunos tags.

1. Abra Excel.

2. En el men PI, seleccione Ajustes... y asegrese de que est seleccionado el botn de exclusin mtua En una columna de la seccin "Copiar elementos a la hoja".

3. A continuacin, cierre el cuadro de dilogo y site el cursor en la celda A2 de la hoja de clculo.

4. Seleccione Bsqueda de tags... en el men PI e introduzca "BA*" en el campo Mscara de tag.


18

5. Haga clic en Buscar para buscar los tags que comiencen con "BA". La lista Resultados de bsqueda debe contener al menos cinco tags: BA:ACTIVE.1, BA:CONC.1, BA:LEVEL.1, BA:PHASE.1 y BA:TEMP.1.

6. Seleccione estos cinco tags de la lista Resultados de bsqueda haciendo clic en el primer tag (BA:ACTIVE.1) y, manteniendo presionada a la vez la tecla CTRL, haciendo clic en cada uno de los otros cuatro tags. Luego haga clic en Aceptar para copiar los cinco tags en una nica columna, de A2 a A6.

7. Desplace el cursor a la celda B2. En el men PI, seleccione Atributos del tag... Haga clic en el cuadro de edicin de Nombre(s) de tag.

Tutorial


8. Coloque el puntero del ratn sobre la celda A2 de la hoja de clculo. Haga clic y arrastre para seleccionar la referencia A2:A6.

9. Escriba o seleccione "descriptor" en el cuadro desplegable bajo Atributo.

10. En el cuadro de dilogo, haga clic en Aceptar. PI DataLink recupera los descriptores del tag en las celdas B2 a B6.

11. Desplace el cursor a la celda C2. En el men PI, seleccione Valor actual.... Haga clic en el cuadro de edicin de Nombre de tag. Coloque el puntero del ratn sobre la celda A2 de la hoja de clculo. Haga clic y arrastre para seleccionar la referencia A2:A6. En el cuadro de dilogo, haga clic en el botn de exclusin mtua tiempo a la izquierda.


20

12. En el cuadro de dilogo, haga clic en Aceptar. PI DataLink recupera los valores actuales y sus marcas de tiempo en las columnas D y C respectivamente.

13. Site el cursor en la celda E2 de la hoja de clculo. En el men PI, seleccione Atributos del tag... de nuevo. Haga clic en el cuadro de edicin de Nombre(s) de tag.

14. Coloque el puntero del ratn sobre la celda A2 de la hoja de clculo. Haga clic y arrastre para seleccionar la referencia A2:A6. Seleccione engunits del cuadro de lista Atributo.

15. En el cuadro de dilogo, haga clic en Aceptar. A continuacin, PI DataLink recuperar unidades de ingeniera en las celdas E2 a E6.

Valores reales del servidor PI

En este ejemplo, recopilaremos datos de muestra para un solo tag.

1. Desplace el cursor a la celda C10. En el men PI, seleccione Datos de muestra.... Haga clic en el botn Bsqueda de tags. Aparecer el cuadro de dilogo Bsqueda de tags.

2. Introduzca "CD*" en el campo Mscara de tag. Haga clic en Buscar para buscar tags que comiencen con CD. Debera devolverse el tag "cdt158". Seleccione este tag y haga clic en Aceptar.

3. El tag cdt158 aparecer en el campo Nombre de tag del cuadro de dilogo Datos de muestra. Introduzca t (para medianoche de hoy) en el campo Hora de inicio, +8h (perodo de 8 horas desde la hora de inicio) en el campo Hora de finalizacin y 1h (intervalos de una hora) en el campo Intervalo de tiempo. Marque la casilla de verificacin mostrar marcas de tiempo.

Tutorial


4. Haga clic en Aceptar. PI DataLink recuperar los datos interpolados desde la medianoche hasta las 8:00 a.m. en intervalos de 1 hora.

Cambiar argumentos del cuadro de dilogo

En este ejemplo, modificaremos la hora de finalizacin utilizada en el ejemplo anterior.


22

1. Haga clic con el botn derecho del ratn sobre cualquier parte de la matriz creada en el ejemplo anterior.

2. Seleccione Datos de muestra...

3. Cambie la hora de finalizacin de "+8h" a "+9h" y haga clic en Aceptar. PI DataLink recuperar los datos interpolados desde la medianoche hasta las 09:00 a.m. en intervalos de 1 hora. Fjese en que el tamao de la matriz a aumentado en una fila.

Utilizar matrices antiguas como plantillas

En este ejemplo mostraremos cmo utilizar una matriz antigua como plantilla para un tag diferente.

1. Haga clic con el botn derecho del ratn sobre cualquier parte de la matriz creada en el ejemplo anterior.

2. Seleccione Datos de muestra...

Men PI


3. Modifique el campo de edicin del tag de "CDT158" a "SINUSOID".

4. Modifique la Celda de salida de $C$10 a $A$10 y haga clic en Aceptar. Fjese en que los datos de muestra para el tag "SINUSOID" se indican en A10.

Resumen de PI DataLink

Tal y como indican los ejemplos anteriores, la forma ms rpida de utilizar PI DataLink para transferir datos entre PI y Excel es seleccionando una opcin del elemento de men PI. En ese caso aparecer un cuadro de dilogo. Introduzca los parmetros adecuados y PI DataLink recuperar los valores PI solicitados. Las siguientes secciones describen las funciones de PI DataLink con ms detalle.

Men PI

Si PI DataLink se aade a Excel, el elemento de men PI se aade a la barra de men de Excel.


24

En este elemeno de men se dispone de selecciones de men emergentes. stas son:

Valor actual recupera el valor actual de un tag Valor de archivo histrico recupera un nico valor del archivo histrico (se puede

interpolar)

Atributos del tag recupera un atributo del tag Datos comprimidos (hora de inicio/nmero) recupera datos comprimidos basndose en una

hora de inicio y en un nmero especificado de valores con una condicin de filtro opcional

Datos comprimidos (hora de inicio/de finalizacin) recupera datos comprimidos basndose en una hora de inicio y en una hora de finalizacin con una condicin de filtro opcional

Datos de muestra recupera datos espaciados de forma uniforme (de muestra) del archivo histrico con una opcin de filtro opcional

Datos temporizados recupera datos de muestra sincronizados con una matriz de marcas de tiempo

Datos calculados recupera totales, mnima, mxima, rangos, desviaciones estndar, promedios y medias para mltiples perodos de tiempo

Cuadros de dilogo


Datos calculados avanzados es similar a datos calculados pero con ms opciones avanzadas (esto es, evento ponderado)

Filtrado de tiempo recupera la cantidad de tiempo durante la que una expresin de tag es verdadera

Identificador del punto para tag recupera un nombre de tag del identificador del punto especificado

Mscara de atributo para tag recupera nombres de tag de las mscaras de atributo especificadas

Alias recupera un nombre de tag de alias de la base de datos de mdulo Propiedad recupera un valor de propiedad de la base de datos de mdulo Insertar trend crea una trend que puede obtener datos directamente de PI o de la hoja de

clculo

Bsqueda de tags busca tags PI Module Database muestra el contenido de la base de datos de mdulo, como alias y

propiedades

Conexiones gestiona las conexiones del servidor PI Ajustes muestra los ajustes y preferencias de PI DataLink Acerca de muestra la informacin de la versin PI DataLink Ayuda muestra la ayuda sobre PI DataLink

Cuadros de dilogo

Campos de edicin

Los campos de edicin pueden conterner la informacin de texto necesaria o referencias a las celdas que contengan la informacin de texto necesaria. PI DataLink determina el tipo de informacin introducida en el campo de edicin segn el contexto.

De forma alternativa a la introduccin de la referencia de celda, tambin puede utilizar el ratn para hacer clic en el campo de edicin y luego en la celda (o hacer clic en la celda y arrastrar a las celdas adyacentes) de la hoja de clculo. En este procedimiento, Excel introduce automticamente las referencias de celdas en el campo de edicin.


26

Por ejemplo, en el siguiente cuadro de dilogo, los campos de edicin para Nombre de tag y Salida solicitan una celda de la hoja de clculo que contenga el nombre del tag y la celda de la hoja de clculo en la que desee colocar la salida del valor actual respectivamente.

Servidor PI y campos de salida

El campo Servidor PI permite la seleccin de un servidor PI de la lista de servidores conocidos. En la lista desplegable, los servidores que se encuentran sobre la lnea de puntos son los servidores actualmente conectados y los que se encuentran por debajo de ella son los que actualmente estn desconectados. El campo Servidor PI de todos los cuadros de dilogo est etiquetado como opt. u opcional. Si el campo Servidor PI est en blanco, PI DataLink utilizar el servidor PI predeterminado. Puede modificar el servidor PI predeterminado en el cuadro de dilogo Conexiones... disponible en el men PI.

El campo Salida le permite especificar la esquina superior izquierda del rango en el que PI DataLink colocar los datos resultantes.

Visualizar datos en columnas o filas

Para los cuadros de dilogo que esperan devolver una matriz de valores PI (por ejemplo, Datos de muestra), existe un grupo de botones de exclusin mtua con las opciones columna(s) o fila(s). Seleccione columna(s) para visualizar los datos ya sea en una columna, en dos columnas si se mostrarn marcas de tiempo O porcentajes correctos, o en tres columnas si se mostrarn marcas de tiempo Y porcentajes correctos. Seleccione fila(s) para mostrar los datos en una, dos o tres filas.

Cuadros de dilogo


Para los cuadros de dilogo que esperan devolver un nico valor PI (p. ej., Valor actual), existe un grupo de botones de exclusin mtua con las opciones sin marca de tiempo, tiempo a la izquierda o tiempo en la parte superior. Seleccione tiempo a la izquierda para visualizar los datos en dos columnas. Seleccione tiempo en la parte superior para visualizar los datos en dos filas.

Para los cuadros de dilogo que son compatibles con una matriz de tags, la orientacin de la matriz de tags sobrescribir su seleccin de fila/columna a la hora de determinar la orientacin de los datos de salida.

Cuadros de lista

Los cuadros de lista aparecen para el campo Modo en Valor de archivo histrico..., para los campos Tipo en Datos comprimidos (nmero) y (horas)..., para los campos Modo en Datos calculados y Datos calculados avanzados..., y para los campos Unidad de tiempo en los cuadros de dilogo Filtrado de tiempo... El modo de recuperacin predeterminado de Valor de archivo... es interpolado, el tipo de lmite predeterminado de Datos comprimidos (nmero) y (horas)... es interior, el modo de clculo predeterminado de Datos calculados y Datos calculados avanzados... es total, el modo de muestreo de expresin de Datos calculados avanzados... es pto. comprimido, y la unidad de tiempo predeterminada para Filtrado de tiempo... es segundos.

Cuadro combinado

Los cuadros combinados aparecen para el campo Atributo en Atributos del tag.... El campo Clase de punto se rellena automticamente con todas las clases de punto disponibles para el servidor PI indicado. Siempre que se selecciona un nuevo servidor PI en el campo Servidor PI, el campo Clase de punto se rellena de nuevo. Siempre que se selecciona una clase de punto en el campo Clase de punto, el campo Atributo se rellena de nuevo. Si se introduce un tag vlido, su clase de punto se recuperar e introducir en el campo Clase de punto automticamente.

Buscar tags en los cuadros de dilogo

El botn , que se encuentra junto al campo de nombre de tag en los cuadros de dilogo, le permite buscar tags en la base de datos PI. Si hace clic en este botn, aparecer el cuadro de dilogo Bsqueda de tags. Si pulsa Aceptar en el cuadro de dilogo Bsqueda de tags, el primer nombre de tag seleccionado se copiar en el campo de edicin de nombre de tag. El nombre de servidor PI tambin se copiar en el campo de edicin Servidor PI si seleccion la casilla "Copiar nombre de servidor PI" en los ajustes de PI DataLink.


28

Tiempo en PI DataLink

Valores devueltos

Las marcas de tiempo devueltas por los cuadros de dilogo de PI DataLink se encuentran en formato Excel; es decir, el nmero representa el nmero de das desde 1900. Por ejemplo, 10-Dec-99 7:12pm se introduce en una celda con el nmero 36504.8.

Sin embargo, PI DataLink formatea estas marcas de tiempo y las convierte en una cadena de tiempo PI; especficamente, dd-mmm-aa hh:mm:ss. Por ejemplo, 7:12 PM del 10 de diciembre de 1999 se muestra como 10-Dec-99 19:12:00.

Puede cambiar este formato por otro seleccionando las celdas y, a continuacin, seleccionando Formato, Celdas, Nmero. Consulte su documentacin sobre Excel para obtener informacin sobre el formateo de nmeros como horas.

Formato de tiempo y nmero especificado por el usuario

Si no le gustan los cdigos de formato general y dd-mmm-aa hh:mm:ss para nmeros y horas respectivamente, puede especificar otro cdigo de formato de nmero y hora predeterminado en PI DataLink. Para ello, vaya al cuadro de dilogo PI > Configuracin...



El formato de nmero "0.0" muestra los nmeros con un puesto decimal y el formato de hora "hh:mm:ss" muestra las marcas de tiempo como hora:minutos:segundos.

Introducir marcas de tiempo en PI DataLink

Muchos de los cuadros de dilogo solicitan una hora de inicio y una hora de finalizacin. En los campos de edicin, introduzca la cadena de tiempo PI que desee; por ejemplo 10-Dec-99 19:12. Recuerde que para la hora PI en el formato de tiempo relativo (por ejemplo, '-1d') la hora de referencia es diferente para la hora de inicio que para la hora de finalizacin. El reloj tiempo real actual es la hora de referencia para la traduccin de la hora relativa en el campo de hora de inicio. Sin embargo, la hora de inicio se utiliza como hora de referencia para la traduccin de la hora relativa en el campo de hora de finalizacin.

Si desea utilizar referencias de celda, puede referirse tanto a las celdas que contienen una hora PI en formato de cadena (p. ej., '10-Dec-99 19:12) o a las celdas que contienen una hora Excel (por ejemplo, 36504.8, formateado en el estilo que desee). Recuerde que Excel almacena las horas como la cantidad de das desde 1900, pero las muestra segn Formato, Celdas, Nmero.


30

Para el campo de edicin de intervalo de tiempo, puede especificar un nmero seguido de una "h", una "m" o una "s" (para horas, minutos o segundos). Por ejemplo, para indicar un intervalo de tiempo de treinta y dos minutos introduzca 32m en el campo de edicin.

Si desea utilizar referencias de celdas, nicamente podr referirse a las celdas que contengan una cadena de intervalo de hora PI vlida. Esto es, no puede hacer referencia a una celda que contenga una hora Excel (es decir, un nmero). Por ejemplo, para especificar un intervalo de 32 minutos, el campo de edicin de intervalo de tiempo debe hacer referncia a una celda que contenga la cadena 32m.

Consulte Hora de inicio y de finalizacin (consulte "Ejemplos de cadenas de tiempo PI" en la pgina 153) e Intervalo de tiempo (en la pgina 154) para obtener ejemplos de cadenas de tiempo PI vlidas.

Casilla de verificacin Mostrar hora

En algunos cuadros de dilogo aparece la casilla de verificacin mostrar hora, cuya funcin PI generalmente devuelve una matriz de valores PI. Si selecciona esta casilla de verificacin, se devolvern las marcas de tiempo y los valores. Estas marcas de tiempo aparecen en la columna situada a la izquierda del todo, si se ha seleccionado el botn de exclusin mtua columna(s); y a lo largo de la fila superior si se seleccion fila(s). Si esta casilla no est seleccionada, PI DataLink no mostrar las marcas de tiempo.

Si hace referencia a una matriz de tags en el cuadro de dilogo Datos de muestra o Datos calculados, PI DataLink devuelve un grupo comn de marcas de tiempo para todo el grupo de tags.

Colocar los datos de marca de tiempo devueltos por PI DataLink

Algunos cuadros de dilogo que devuelven un valor nico (por ejemplo, Valor actual) disponen de botones de exclusin mtua que controlan el lugar en el que se muestran las marcas de tiempo.

Seleccione sin marca de tiempo para suprimir la marca de tiempo. Seleccione tiempo a la izquierda para mostrar la marca de tiempo en una celda a la

izquierda de los valores recuperados.

Seleccione tiempo en la parte superior para mostrar la marca de tiempo en una celda sobre los valores recuperados.



Nota: Cuando se especifica una referencia matricial en el campo Nombre de tag, los botones de exclusin mtua tiempo a la izquierda y tiempo en la parte superior producen el mismo resultado. En este caso, PI DataLink devuelve la marca de tiempo y el valor en funcin de si la referencia de nombres de tag es horizontal o vertical. Para los nombres de tag en una nica columna, las marcas de tiempo aparecern a la izquierda de los valores. Para los nombres de tag en una nica fila, las marcas de tiempo aparecern encima de los valores.

Datos de marca de tiempo para un intervalo o rango temporal

Algunos cuadros de dilogo que devuelven un nico valor a cada intervalo de tiempo (por ejemplo, Datos calculados) proporcionan casillas de verificacin que controlan qu marcas de tiempo se muestran.

Si se especifica un intervalo de tiempo:

Seleccione Hora de inicio para mostrar la hora de inicio del intervalo. Seleccione Hora de finalizacin para mostrar la hora de finalizacin del intervalo. Para las funciones de mnimo, mximo y rango:

Seleccione Tiempo mn/mx para mostrar las marcas de tiempo para los valores mnimo y mximo del intervalo.

Las marcas de tiempo se muestran segn la orientacin (por filas o por columnas) especificada. Por ejemplo, si la orientacin es por columnas y estn activadas todas las casillas de verificacin, el orden de las columnas de izquierda a derecha sera: hora de inicio, hora de finalizacin, la marca de tiempo del valor mnimo, la marca de tiempo del valor mximo. Si en el ejemplo anterior se desactiva la casilla de verificacin Hora de finalizacin, el orden de izquierda a derecha sera: hora de inicio, la marca de tiempo del valor mnimo, la marca de tiempo del valor mximo.


32

Funciones de PI DataLink

Funciones y valores

Cuando un cuadro de dilogo PI DataLink transmite datos del servidor PI a Excel, no pone el valor real en una celda. En su lugar, PI DataLink pega una funcin PI personalizada en la celda.

Por ejemplo, cuando se abre el cuadro de dilogo Valor actual y se introduce SINUSOID en el campo Nombre de tag, PI DataLink pega la siguiente funcin en la celda:

=PICurrVal("sinusoid",0,) Excel evala entonces esta funcin y muestra el nmero resultante. De este modo, los cuadros de dilogo PI DataLink son aplicaciones para el usuario que sirven para construir las funciones PI DataLink correspondientes y formatear el resultado.

Estas funciones PI DataLink tambin se pueden introducir manualmente en las celdas de una hoja de clculo. Los argumentos de la funcin se describen ms detalladamente en Detalles para las funciones y los cuadros de dilogo PI DataLink (consulte "Detalles para las funciones y los cuadros de dilogo de PI DataLink" en la pgina 35). Debido a que la mayora de las funciones PI DataLink devuelven ms de un elemento de datos, las funciones se deben introducir en Excel como funciones de matriz. Para obtener una explicacin ms detallada de cmo se utilizan las funciones de matriz, consulte la seccin Introducir funciones PI directamente en Excel ms adelante.

Estas funciones PI DataLink slo se pueden utilizar en las celdas de una hoja de clculo. No obstante, no se pueden ejecutar en un procedimiento de Excel Visual Basic. Visual Basic no reconoce las funciones PI DataLink. La nica forma de invocar las funciones PI DataLink en VBA es formular la funcin como una cadena de texto y despus establecer la frmula de propiedad de matriz para un rango de celdas de esta cadena de texto. Es lo mismo que introducir manualmente las funciones PI en el rango de celdas indicado. De este modo, el cdigo VBA puede comprobar los valores de celda de los resultados de las funciones PI. Para ver un ejemplo acerca de la introduccin de funciones PI en una hoja de clculo utilizando VBA, consulte el mdulo putval_code en el archivo piexam32.xls distribuido con PI DataLink.

La funcin de salida PIPutVal() de PI DataLink es una funcin para macros de Excel y no puede utilizarse directamente en las celdas de una hoja de clculo. PIPutVal() slo se puede utilizar en una hoja de macros de Excel 4.0 o ejecutar como una macro en VBA. En VBA, utilice el mtodo application.run para invocar las funciones para macros. Para ver un ejemplo acerca de cmo invocar la funcin para macros en VBA, consulte el mdulo putval_code module en el archivo piexam32.xls.

Funciones de PI DataLink


Informar sobre errores

PI DataLink est escrito en C++ y Visual Basic y utiliza tanto el SDK del sistema PI como el API de Microsoft Excel. Si se produce un error en el nivel PI SDK, PI DataLink muestra el error PI SDK en la celda. Por ejemplo, si intenta encontrar el valor actual para un tag que no existe, aparecer el mensaje "PIPoint no encontrado" en la celda de salida.

Actualizar los datos PI en una hoja de clculo

Hay dos formas de actualizar los datos en una hoja de clculo. Una forma es hacer clic con el botn derecho del ratn en la matriz y seleccionar la funcin Recalcular (cambiar de tamao). Este mtodo funciona mejor si se dispone de una matriz de tamao variable en la que el nmero de valores devueltos puede ser diferente segn el rango de valores recuperados. Si hay pocos valores, no hay problema. Sin embargo, si se recuperan ms valores, dichos valores no se mostrarn a menos que se seleccione la funcin Recalcular.

La segunda forma es realizar un cambio en los argumentos transmitidos a las funciones PI DataLink. Debido a que PI DataLink recupera datos del servidor PI a travs de las funciones, los valores de la hoja de clculo slo se actualizan cuando se cambia un argumento de funcin. Pulsar F9 en Excel no obliga a las funciones PI DataLink a obtener nuevos datos del servidor PI. La nica excepcin es la funcin Valor actual, que se actualiza siempre que Excel realiza un nuevo clculo. Esto se hizo de forma intencionada, ya que la mayora de las funciones DataLink no muestran los datos modificados cronolgicamente. No obstante, para evitar esto, Ctrl+Alt+Shift+F9 hace que todas las funciones DataLink se recalculen.

La mejor forma de crear una hoja de clculo que se actualice con la mnima intervencin del usuario es utilizar algunas funciones de tiempo dinmicas de Excel como ahora() u hoy() para generar una marca temporal, p. ej. utilice (hoy()+1/3) para las 8:00 a.m. de hoy. A continuacin, consulte esta celda en el argumento de hora de inicio o de hora de finalizacin de la consulta de DataLink. Siempre que Excel recalcule (bien porque el usuario haya presionado F9 o haya cambiado alguna celda de la hoja de clculo), Excel actualizar las funciones de tiempo dinmicas, haciendo que se ejecute la funcin PI DataLink. Observe que el valor de la marca de tiempo no tiene que cambiar para que Excel desencadene la funcin PI DataLink. Siempre que se utilice la funcin de tiempo dinmico de Excel para construir la marca de tiempo y sta se utilice a su vez en el argumento de DataLink, Excel desencadenar la funcin DataLink cuando se recalcule la hoja de clculo.

Cambiar argumentos utilizando cuadros de dilogo

Si es necesario cambiar un argumento, haga clic con el botn derecho del ratn en cualquier parte de la matriz y seleccione la funcin PI DataLink. Aparecer un cuadro de dilogo con todos los campos de edicin rellenados con los argumentos que previamente se haban


34

especificado para dicha matriz. Se puede modificar cualquiera de los campos de edicin y la nueva matriz reflejar dichos cambios.

Si el campo de edicin de salida se modifica, existen dos comportamientos diferentes en funcin de la nueva celda a la que se haga referencia. Si la nueva celda a la que se hace referencia forma parte de la matriz original, toda la matriz se desplaza, con la celda superior a la izquierda de la matriz, a la nueva celda. Si la nueva celda a la que se hace referencia no forma parte de la matriz original, la matriz se pega, con la celda superior a la izquierda de la matriz, en la nueva celda.

Seleccionar una funcin DataLink completa

Si es necesario copiar, mover o eliminar una gran matriz de funciones PI DataLink, la forma ms fcil es hacer clic con el botn derecho del ratn en cualquier parte de la matriz y seleccionar Seleccionar frmula de DataLink. A continuacin, realice la funcin deseada. Toda la matriz de funciones Excel se debe mover o eliminar, de lo contrario aparecer el error "No puede modificar parte de una matriz".

Introducir funciones PI directamente en Excel

Valores de matriz

Todas las funciones PI DataLink, excepto PIPutVal(), devuelven valores matriciales. En este caso, primero debe seleccionar el rango de salida matricial apropiado. A continuacin, introduzca la funcin PI y sus argumentos en la barra de frmulas de Excel. Por ltimo, coloque la funcin PI en las celdas con la combinacin de teclas CTRL+SHIFT+ENTER. Para obtener ms informacin acerca de las funciones matriciales, consulte la ayuda en lnea de Microsoft Excel. Tenga en cuenta tambin que el Asistente para funciones de Excel slo insertar la funcin en una celda de la hoja de clculo. Por lo tanto, no es muy recomendable utilizar el asistente de funciones para introducir funciones PI en Excel.

Cdigo de salida

El argumento de cdigo de salida es un nmero entero que controla si se devuelven o no las marcas de tiempo y si las celdas de salida se orientan por filas o columnas.

Por ejemplo, un cdigo de salida 0 en PICurrVal() produce el valor snapshot en la celda nica. Un cdigo de salida 1 coloca el tiempo de snapshot en la columna uno y el valor snapshot en la columna dos de una matriz de 1 x 2. Un cdigo de salida 2 coloca el tiempo de snapshot en la fila uno y el valor snapshot en la fila dos de una matriz de 1 x 2. Para saber el significado de su cdigo de salida, consulte la descripcin detallada de cada funcin PI individual. En general, si se especifica un rango de salida matricial mayor que el nmero de

Detalles para las funciones y los cuadros de dilogo de PI DataLink


valores devueltos de la funcin, las celdas adicionales se mostrarn como celdas vacas aunque tengan una frmula embebida.

Argumentos de cadena

Los argumentos de cadena de las funciones tienen que estar entre comillas dobles. Por ejemplo, seleccione una matriz de salida de 1 x 2 e introduzca:

=PICurrVal("sinusoid", 1, "casaba") para recuperar el tiempo y el valor snapshot del tag sinusoid desde el servidor PI "casaba".

Utilizar referencias de celda en argumentos

Puede utilizar referencias de celda para todos los argumentos de las funciones PI DataLink. Por ejemplo, la siguiente funcin:

=PICurrVal(A1, A2, A3) produce el mismo resultado que el ejemplo anterior cuando se almacenan los tres argumentos en las celdas A1, A2 y A3 respectivamente.

Argumento de PIServer

El argumento de PIServer es opcional. El PIServer predeterminado se puede cambiar en el cuadro de dilogo Conexiones. Si desea utilizar el servidor predeterminado, puede omitir el argumento de PIServer. Por ejemplo, para recuperar el valor actual para el tag sinusoid del servidor PI predeterminado, introduzca:

=PICurrVal("sinusoid",0,) en un rango de salida de 1x1.


Las siguientes secciones describen cada una de las funciones de PI DataLink con ms detalle. Cada seccin describe primero el cuadro de dilogo y, a continuacin, discute cada argumento de la correspondiente funcin (o funciones) PI personalizada.

Cuadro de dilogo Valor actual

Este cuadro de dilogo obtiene el valor Snapshot actual de un tag PI.


36

Campo obligatorio

Nombre de tag. La referencia a un nombre de tag puede ser una matriz.

Notas especiales

Esta funcin se actualiza siempre que Excel calcula o recalcula cualquier celda de la hoja de clculo. Para forzar un reclculo inmediato, pulse la tecla F9.

PICurrVal()

PICurrVal(tagname, outcode, PIServer)

Argumentos

Argumento Explicacin

Tagname (cadena) El tag para el cual desea el valor snapshot (actual).

outcode (entero) Un cdigo de salida; 0, 1 o 2.

PIServer (cadena) El servidor PI.

Devoluciones

Cdigo de salida

Columna 1 Columna 2

0 Valor actual

1 Marcas de tiempo

Valor actual

Un cdigo de salida 2 transpone la matriz de salida que resulta de un cdigo de salida 1.

Ejemplo

La siguiente frmula recupera el valor actual y la marca de tiempo correspondiente para el tag let439 del servidor PI "holden":

=PICurrVal("let439",1,"holden")



Cuadro de dilogo Valor de archivo histrico

Este cuadro de dilogo obtiene un valor a una hora especificada. Hay cinco modos de seleccin:

Previous (Anterior) - Recupera el valor del archivo histrico en el momento o antes de la marca de tiempo especificada.

Previous only (Solo anterior) - Recupera el valor del archivo histrico slo antes de la marca de tiempo especificada.

Interpolated (Interpolado) - Interpola el valor en la marca de tiempo especificada, excepto para los 4 tags de cdigo de resolucin del servidor PI 2 y los tags con atributos de paso establecidos en el servidor PI 3. En este caso, el valor anterior simplemente se reenva.

Auto - Igual que Interpolado, excepto para los 4 tags de cdigo de resolucin del servidor PI 2 y los tags con atributos de paso establecidos en el servidor PI 3. En este caso, se devuelve el valor en el momento o antes de la marca de tiempo especificada.

Next (Posterior) - Recupera el valor del archivo histrico en el momento o despus de la marca de tiempo especificada.

Next only (Solo posterior) - Recupera el valor del archivo histrico slo despus de la marca de tiempo especificada.

Exact Time (Tiempo exacto) - Recupera el valor del archivo histrico en un tiempo especificado si existe una entrada en dicho tiempo. Si no existe ningn valor, se devuelve el mensaje "No se han encontrado eventos".

Campos obligatorios

Nombre de tag o expresin Marca de tiempo

Consulte tambin

PIArcVal() (en la pgina 37)

PIExpVal() (en la pgina 38)

PIArcVal()

PIArcVal(tagname, timestamp, outcode, PIServer, mode)


38

Argumentos


tagname (cadena) El tag para el cual desea el valor de archivo histrico.

time stamp (cadena) La marca de tiempo PI.

outcode (entero) Un cdigo de salida; 0, 1 o 2.


mode (cadena) El modo de recuperacin.

Devoluciones

Cdigo de salida

Columna 1 Columna 2

0 Valor de archivo histrico

1 Marca de tiempo Valor de archivo histrico


Ejemplo

La siguiente frmula recupera un valor interpolado para el tag cdep158 a las 7:20 pm del 11 de diciembre de 1992 del servidor PI "casaba":

=PIArcVal("cdep158","11-dec-92 19:20",0, "casaba","interpolated")

PIExpVal()

PIExpVal(expression, timestamp, PIServer)

Argumentos


expression (cadena) La cadena para la que desea el valor de archivo histrico.

time stamp (cadena) La marca de tiempo PI.




Devoluciones

Cdigo de salida

Columna 1 Columna 2

0 Valor de archivo histrico

1 Marca de tiempo Valor de archivo histrico


Ejemplo

La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid del servidor PI denominado THEVAX en la medianoche de ayer:

=PIExpVal("sqr('sinusoid')","y","thevax")

Cuadro de dilogo Atributos del tag

Este cuadro de dilogo recupera un atributo de punto para un tag determinado.

Campos obligatorios

Nombre de tag Atributo de tag Para PI3, la lista de atributos de tag depende de la clase de punto seleccionada. Para obtener una lista completa de los atributos de tag, consulte los atributos incluidos en el cuadro combinado o la descripcin de atributos para cada clase de punto en los manuales del usuario del servidor PI, disponibles en http://techsupport.osisoft.com/downloadcenter.aspx (http://techsupport.osisoft.com/downloadcenter.aspx), bajo "PI 3 Enterprise Server".

Para PI 2, seleccione un atributo de tag del cuadro combinado. El atributo predeterminado es descriptor. Los atributos de tag son:

Atributo Explicacin

Descriptor Descriptor de tag de 26 caracteres.

Exdesc Descriptor extendido de tag de 80 caracteres.

typicalvalue Valor tpico.

Units Cadena de unidades de ingeniera.

Zero Cero.


40

Atributo Explicacin

Span Rango.

digstartcode Cdigo para la primera cadena de estado digital del tag.

dignumber Nmero de estados digitales menos 1.

pointtype Carcter de tipo de punto.

pointsource Carcter de origen de punto.

location1 Parmetro de ubicacin 1.





filtercode Cdigo de filtro.

squareroot Flag de raz cuadrada.

scan Flag de exploracin.

excdev Desviacin por excepcin en porcentaje de rango.

excmin Tiempo mnimo de excepcin en segundos.

excmax Tiempo mximo de excepcin en segundos.

archiving Flag de archivado histrico.

compressing Flag de compresin.

Res Cdigo de resolucin.

compdev Desviacin de compresin en porcentaje de rango.

compmin Tiempo mnimo de compresin en segundos.

compmax Tiempo mximo de compresin en segundos.

totalcode Cdigo de totalizacin.

convers Factor de conversin para puntos postprocesados.

displaydigits Controla el formato de los valores numricos en pantallas PI basadas en terminales.

instrumenttag Nombre de tag para un valor en otro sistema, lo utilizan algunas interfaces.

sourcept Nombre de tag para la salida a otro sistema, lo utilizan algunas interfaces.

taglong Nombre de tag largo (hasta 80 caracteres).

tagshort Nombre de tag de 12 caracteres.

creator Creador del tag.

createdate Fecha de creacin del tag.

changer Usuario que modific los atributos del tag.

changedate Fecha de modificacin del tag.

pointnumber Nmero de identificacin reutilizado al eliminar un punto.



Atributo Explicacin

pointid Nmero de identificacin interno nico que no se reutiliza al eliminar un punto.

PITagAtt() (en la pgina 41)

PITagAtt() PITagAtt(tagname, attribute, PIServer)

Argumentos


tagname (cadena) El tag para el cual desea un atributo.

attribute (cadena) El atributo del tag, consulte la lista en Cuadro de dilogo Atributos del tag (en la pgina 39).


Devoluciones

Atributo de tag

Ejemplo

La siguiente frmula recupera del servidor PI predeterminado las unidades de ingeniera para el tag situado en la celda D1:

=PITagAtt(d1,"units",)

Cuadro de dilogo Datos comprimidos (hora de inicio/nmero)

Este cuadro de dilogo devuelve valores comprimidos del servidor PI basndose en una hora de inicio y en un nmero especificado de puntos de datos. Si no se especifica una expresin de filtro, se ejecuta la funcin PINCompDat(). De lo contrario, se abre la funcin PINCompFilDat().

Campos obligatorios

Nombre de tag Hora de inicio


42

Nmero de puntos de datos

Expresin de filtro

Si se especifica una expresin de filtro, el nmero de valores comprimidos especificado se recupera del servidor PI mientras una determinada expresin de filtro sea verdadera. Si se ha seleccionado la opcin de marcar como filtrado, para cada grupo de valores que no satisfaga la expresin de filtro se devolver el estado "Filtrado". Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150).

Tipo de lmite

Existen 4 tipos de lmites:

Inside (Dentro) (predeterminado): devuelve un nmero especificado de puntos de datos de una hora de inicio, incluido el valor de la hora de inicio si existe un valor.

Outside (Fuera): devuelve un nmero especificado de puntos de datos de una hora de inicio, incluido un punto de datos a la hora de inicio o anterior a ella.

Interpolated (Interpolado): devuelve un nmero especificado de puntos de datos de una hora de inicio, incluido un punto de datos interpolado a la hora de inicio.

Auto: igual que el lmite interpolado, excepto si el cdigo de resolucin para tags en el servidor PI 2 o atributo de paso est ajustado en el servidor PI 3, el comportamiento es el mismo que el de "dentro".

Casillas de verificacin

Seleccione atrs en el tiempo si desea recopilar datos del archivo histrico retrocediendo a partir del momento que se introdujo en Hora de inicio.

Seleccione mostrar bits si desea mostrar el estado extendido de los bits asociados con los eventos devueltos.

Seleccione mostrar anotaciones si desea mostrar las anotaciones asociadas con los eventos devueltos.

Notas especiales

Este cuadro de dilogo devuelve cadenas vacas si existe un nmero menor de valores que el nmero que se especific. Por ejemplo, si desea recuperar 400 valores, comenzando por la



medianoche de hoy, y slo existen 356 valores (incluidos los eventos filtrados), las 44 celdas finales incluirn cadenas en blanco.

Si introduce la expresin de filtro en una celda de la hoja de clculo y hace referencia a ella en el cuadro de dilogo, asegrese de comenzar la expresin con una comilla simple para que Excel la interprete como una cadena. Puesto que los nombres de tag en las expresiones de filtro se cierran con comillas simples, si la expresin de filtro comienza con un nombre de tag y va a almacenarla en una celda o en la hoja de clculo, deber iniciar dicha expresin con dos comillas simples.

Temas relacionados

Expresiones de filtro (en la pgina 150)

PINCompDat() (en la pgina 43)

PINCompFilDat() (en la pgina 44)

PINCompDat() PINCompDat(tagname, stime, numvals, outcode, PIServer)

Argumentos


tagname (cadena) El tag para el cual desea datos comprimidos.

stime (cadena) La hora de inicio en formato de hora PI.

numvals (entero) El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar datos del archivo histrico que retrocede desde stime.

outcode (entero) Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida.


Devoluciones

Cdigos de salida


44

Ejemplo

La siguiente frmula recupera 10 puntos de datos comprimidos y las correspondientes marcas de tiempo para el tag cdf144 , comenzando por 1:00 a.m. de esta maana del servidor PI predeterminado con el tipo de lmite Dentro:

=PINCompDat("cdf144","1:00",10,1,,"inside")

PINCompFilDat() PINCompFilDat(tagname, stime, numvals, filtexp, filtcode, outcode, PIServer)

Argumentos




numvals (entero) El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar datos del archivo histrico que retrocede desde stime.

filtexp (cadena) La expresin de filtro. Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150).

filtcode (entero) Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo.



Devoluciones

Consulte Cdigos de salida.

Ejemplo

La siguiente frmula recupera 10 puntos de datos comprimidos y las horas correspondientes, comenzando a las 2:00 a.m. para el tag cdf144 mientras el tag cdep158 es superior a 38:

=PINCompFilDat("cdf144","2:00",10,"'cdep158'>38",1,1,,) El estado Filtrado se muestra para las horas si la condicin del filtro es falsa. Los datos se recuperan del servidor PI predeterminado con el tipo de lmite Dentro.



Cuadro de dilogo Datos comprimidos (hora de inicio/hora de finalizacin)

Este cuadro de dilogo devuelve valores comprimidos del servidor PI basndose en una hora de inicio y una hora de finalizacin. The number of data points retrieved for the given time period is returned in the first cell. Si no se especifica una expresin de filtro, se ejecuta la funcin PICompDat(). De lo contrario, se abre la funcin PICompFilDat().

Campos obligatorios

Nombre de tag Hora de inicio Hora de finalizacin

Expresin de filtro

Si se especifica una expresin de filtro, el rango de valores comprimidos especificado se recupera del servidor PI mientras una determinada expresin de filtro sea verdadera. Si se ha seleccionado la opcin marcar como filtrado, para cada grupo de valores que no satisfaga la expresin de filtro se devolver el estado "Filtrado". Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150).

Tipo de lmite

Existen 4 tipos de lmites:

Inside (Dentro) (predeterminado): devuelve puntos de datos a la hora de inicio y de finalizacin y entre ellas.

Outside (Fuera): devuelve puntos de datos entre la hora de inicio y la hora de finalizacin, incluido un punto de datos a la hora de inicio, o anterior a ella, y un punto de datos a la hora de finalizacin, o anterior a ella.

Interpolated (Interpolado): devuelve puntos de datos entre la hora de inicio y la hora de finalizacin, incluido un punto de datos interpolado a la hora de inicio y un punto de datos interpolado a la hora de finalizacin.

Auto: igual que el lmite interpolado, excepto si el cdigo de resolucin para tags en el servidor PI 2 o atributo de paso est ajustado en el servidor PI 3, el comportamiento es el mismo que el de "dentro".


46

Casillas de verificacin

Seleccione cuenta oculta si no desea mostrar la cantidad de eventos de datos recuperados del archivo histrico.

Seleccione mostrar bits si desea mostrar el estado extendido de los bits asociados con los eventos devueltos.

Seleccione mostrar anotaciones si desea mostrar las anotaciones asociadas con los eventos devueltos.

Notas especiales

Este cuadro de dilogo devuelve cadenas en blanco en las celdas de salida no utilizadas si existe un nmero menor de valores en el archivo que el especificado originariamente por la matriz de salida. Esta situacin se puede producir si utiliza referencias de tiempo relativas. Por ejemplo, si recupera valores que comiencen de y a y+5h, el nmero de valores del servidor PI puede ser diferente al abrir la hoja de clculo en das diferentes.

Si introduce la expresin de filtro en una celda de la hoja de clculo y hace referencia a ella en el cuadro de dilogo, asegrese de comenzar la expresin con una comilla simple para que Excel la interprete como una cadena. Puesto que los nombres de tag en las expresiones de filtro se cierran con comillas simples, si la expresin de filtro comienza con un nombre de tag y va a almacenarla en una celda o en la hoja de clculo, deber iniciar dicha expresin con dos comillas simples.

Temas relacionados


PICompDat() (en la pgina 46)

PICompFilDat() (en la pgina 47)

PICompDat() PICompDat(tagname, stime, etime, outcode, PIServer)

Argumentos







etime (cadena) La hora de finalizacin en formato de hora PI.



Devoluciones


Ejemplo

La siguiente frmula recupera 10 puntos de datos comprimidos y las correspondientes marcas de tiempo para el tag cdf144, comenzando desde 1:00 a.m. a 3:00 a.m. de esta maana del servidor PI predeterminado con el tipo de lmite Dentro:

=PICompDat("cdf144","1:00","3:00",1,,"inside")

PICompFilDat() PICompFilDat(tagname, stime, etime, filtexp, filtcode, outcode, PIServer)

Argumentos










48

Devoluciones


Ejemplo

La siguiente frmula recupera puntos de datos comprimidos y las horas correspondientes, comenzando desde las 2:00 a.m. y finalizando a las 10:00 a.m. para el tag cdf144 si el tag cdep158 es superior a 38:

=PICompFilDat("cdf144","2:00","10:00","'cdep158'>38",1,1,,) El estado Filtrado se muestra para las horas si la condicin del filtro es falsa. Los datos se recuperan del servidor PI predeterminado con el tipo de lmite Dentro.

Cuadro de dilogo Datos de muestra

Este cuadro de dilogo recopila datos espaciados de forma uniforme, valores de muestra del archivo histrico. Si no se especifica una expresin de filtro, se ejecuta la funcin PISampDat(). De lo contrario, se abre la funcin PISampFilDat().

Campos obligatorios

Nombre de tag Hora de inicio Hora de finalizacin Intervalo de tiempo

Expresin de filtro

Si se especifica una expresin de filtro, el rango de valores comprimidos especificado se recupera del servidor PI mientras una determinada expresin de filtro sea verdadera. Si se selecciona la opcin marcar como filtrado, se devuelve un estado "Filtrado" para cada conjunto continuo (bloque) de valores de muestra que no satisfaga la expresin de filtro si el tag se encuentra en un servidor PI 3. Si el tag proviene de un servidor PI 2, para cada valor de muestra que no satisfaga la expresin de filtro se devolver el estado "Filtrado". Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150).



Notas especiales

Si introduce la expresin de filtro en una celda de la hoja de clculo y hace referencia a ella en el cuadro de dilogo, asegrese de comenzar la expresin con una comilla simple para que Excel la interprete como una cadena. Puesto que el nombre de tag en las expresiones de filtro se debe cerrar con comillas simples, si la expresin de filtro comienza con un nombre de tag y va a almacenarla en una celda o en la hoja de clculo, deber iniciar dicha expresin con dos comillas simples.

Temas relacionados


PISampDat() (en la pgina 49)

PISampFilDat() (en la pgina 50)

PIExpDat() (en la pgina 51)

PISampDat() PISampDat(tagname, stime, etime, interval, outcode, PIServer)

Argumentos


tagname (cadena) El tag para el cual desea datos de muestra.



interval (cadena) El intervalo de tiempo en formato de hora PI.

outcode (entero) Un cdigo de salida; 0, 1, 2 3.


Devoluciones

Cdigo de salida

Columna 1 Columna 2

0 Datos de muestra

1 Marcas de tiempo Datos de muestra


50

Un cdigo de salida 2 transpone la matriz de salida resultante de un cdigo de salida 0 mientras que un cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1.

Ejemplo

La siguiente frmula recupera datos de muestra para el tag ubicado en la celda B1, desde la medianoche de ayer hasta la medianoche de hoy en intervalos de 3 horas:

=PISampDat(b1,"y","t","3h",1,) Tambin se devuelven marcas de tiempo.

PISampFilDat() PISampFilDat(tagname, stime, etime, interval, filtexp, filtcode, outcode, PI Server)

Argumentos


tagname (cadena) El tag para el cual desea datos de muestra.








Devoluciones

Cdigo de salida

Columna 1 Columna 2

0 Datos de muestra

1 Marcas de tiempo Datos de muestra

Un cdigo de salida 2 transpone la matriz de salida resultante de un cdigo de salida 0 y el cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1.



Ejemplo

La siguiente frmula recupera datos de muestra para SINUSOID en 11-Ene-97, 11-Ene-97 1:00AM, 11-Ene-97 2:00AM y 11-Ene-97 3:00AM:

=PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,) Las marcas de tiempo se muestran en columna 1 y los valores en columna 2. Para los valores que no satisfacen la condicin de filtro en la celda A1 se devuelve el estado "Filtrado".

PIExpDat() PIExpDat(expression, stime, etime, interval, outcode, PIServer)

Argumentos


expression (cadena) La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147).






Devoluciones

Cdigo de salida

Columna 1 Columna 2

0 Datos calculados

1 Marcas de tiempo Datos calculados

Un cdigo de salida 2 transpone la matriz de salida resultante de un cdigo de salida 0 mientras que un cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1.

Ejemplo

La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid del servidor PI denominado THEVAX en intervalos de una hora, comenzando por la medianoche de ayer hasta la medianoche de hoy:

=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax") Tambin muestra las marcas de tiempo.


52

Cuadro de dilogo Datos temporizados

Este cuadro de dilogo devuelve valores de muestra de un solo tag que estn sincronizados con una matriz de marcas de tiempo. Existen dos modos de seleccin:

Interpolated (Interpolado): interpola valores en las marcas de tiempo especificadas, excepto para los 4 tags de cdigo de resolucin del servidor PI 2 y los tags con atributos de paso establecidos en el servidor PI 3. En este caso especial, el valor anterior simplemente se reenva.

Exact Time (Tiempo exacto): recupera el valor del archivo histrico para una hora especificada si existe una entrada en dicha hora. Si no existe ningn valor, se devuelve

ES PI DataLink User Guide

Documents

Transcript of ES PI DataLink User Guide