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 [Link]. (01) 510-297-5800 (telfono principal) (01) 510-357-8136 (fax) (01) 510-297-5828 (telfono de soporte tcnico) support@[Link] 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

[Link]
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

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

Manual del usuario de PI DataLink

iii

Contenido

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 [Link] ....................................................................................155 Instalaciones silenciosas .......................................................................................155 Instalacin de PI SDK............................................................................................155 Instalacin de PI DataLink .....................................................................................156 Apndice E: Apndice F: Cdigos de salida ................................................................................................157 Soporte tcnico y recursos ................................................................................159 Opciones del soporte tcnico ................................................................................159 Antes de llamar o escribir solicitando ayuda .........................................................160 ndice ...........................................................................................................................................163

iv

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.

Manual del usuario de PI DataLink

Introduccin

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 [Link] 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 [Link] en el directorio SETUP: 6 = SHARED="P:\APPS\PIPC"

Manual del usuario de PI DataLink

Introduccin

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 [Link] Arguments (consulte "Argumentos de [Link]" 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<version>.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 [Link] del CD de distribucin o del directorio de instalacin de la unidad de red (por ejemplo, P:\APPS\PIPC\SETUP\[Link]). 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<version>.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 [Link]. Para una instalacin local, el archivo [Link] 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 [Link]. A continuacin, se debe seleccionar el nuevo archivo [Link] en la nueva ubicacin. Usuarios fuera de [Link]. Para configurar el formato de nmero y de hora para fuera de [Link]., 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.

Manual del usuario de PI DataLink

Introduccin

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... en el directorio ...\lotus\addins y haga clic en Abrir.

3.

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

Manual del usuario de PI DataLink

Introduccin

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:[Link] 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:[Link], 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:

Para el administrador de PI System

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

Las entradas anteriores de PISysDat:[Link] 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 [Link] 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.

Manual del usuario de PI DataLink

Introduccin

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:[Link] controla el nivel de acceso a los datos PI de este nombre de host. Si en su lugar observa un nmero (por ejemplo, [Link]) 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:[Link]. Para aadir una entrada en la tabla de host UCX para un equipo:
$ ucx set host "mypc" /addr=[Link]

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:[Link] controla el nivel de acceso a los datos PI de este ltimo nombre de host. Si en su lugar observa un nmero (por ejemplo, [Link]) 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:[Link]. Para aadir una entrada en la tabla de host Multinet del VAX/Alpha para un equipo, debe editar el archivo MultiNet:[Link]. Una vez editado, debe ejecutar los siguientes comandos:
$ multinet host_table compile $ @multinet:install_databases

10

Para el administrador de PI System

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:[Link]. controla el nivel de acceso a los datos PI de este ltimo nombre de host. Si en su lugar observa un nmero (por ejemplo, [Link]) 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:[Link]. 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:[Link] controla el nivel de acceso a los datos PI de este ltimo nombre de host. Si en su lugar observa un nmero (por ejemplo, [Link]) 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:[Link]. 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.

Manual del usuario de PI DataLink

11

Introduccin

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 [Link] ([Link] 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,[Link],mypc,piadmin

Esto indica que cualquier aplicacin que se conecte al servidor PI 3 desde "mypc" obtendr privilegios piadmin de forma predeterminada. Para obtener ms informacin, consulte los manuales de usuario del servidor PI que se pueden descargar de [Link] ([Link] en "PI 3 Enterprise Server". 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.

12

Para el administrador de PI System

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. Para obtener ms informacin, consulte los manuales de usuario del servidor PI que se pueden descargar de [Link] ([Link] en "PI 3 Enterprise Server".
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.

Manual del usuario de PI DataLink

13

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

Manual del usuario de PI DataLink

15

Complemento para Excel

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:

16

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.

Manual del usuario de PI DataLink

17

Complemento para Excel

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.

18

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.

Manual del usuario de PI DataLink

19

Complemento para Excel

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.

20

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.

Manual del usuario de PI DataLink

21

Complemento para Excel

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...

22

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.

Manual del usuario de PI DataLink

23

Complemento para Excel

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

24

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.

Manual del usuario de PI DataLink

25

Complemento para Excel

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.

26

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.

Manual del usuario de PI DataLink

27

Complemento para Excel

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 [Link]. 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...

28

Tiempo en PI DataLink

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.

Manual del usuario de PI DataLink

29

Complemento para Excel

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.

30

Tiempo en PI DataLink

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.

Manual del usuario de PI DataLink

31

Complemento para Excel

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 [Link] 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 [Link] 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 [Link].

32

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

Manual del usuario de PI DataLink

33

Complemento para Excel

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

34

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.

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

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.

Manual del usuario de PI DataLink

35

Complemento para Excel

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 Tagname (cadena) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea el valor snapshot (actual). Un cdigo de salida; 0, 1 o 2. El servidor PI.

Devoluciones
Cdigo de salida 0 1 Columna 1 Valor actual Marcas de tiempo Valor actual Columna 2

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")

36

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

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)

Manual del usuario de PI DataLink

37

Complemento para Excel

Argumentos
Argumento tagname (cadena) time stamp (cadena) outcode (entero) PIServer (cadena) mode (cadena) Explicacin El tag para el cual desea el valor de archivo histrico. La marca de tiempo PI. Un cdigo de salida; 0, 1 o 2. El servidor PI. El modo de recuperacin.

Devoluciones
Cdigo de salida 0 1 Columna 1 Valor de archivo histrico Marca de tiempo Valor de archivo histrico Columna 2

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

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

Argumento expression (cadena) time stamp (cadena) PIServer (cadena) Explicacin La cadena para la que desea el valor de archivo histrico. La marca de tiempo PI. El servidor PI.

38

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

Devoluciones
Cdigo de salida 0 1 Columna 1 Valor de archivo histrico Marca de tiempo Valor de archivo histrico Columna 2

Un cdigo de salida 2 transpone la matriz de salida que resulta 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 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 [Link] ([Link] 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 Descriptor Exdesc typicalvalue Units Zero Explicacin Descriptor de tag de 26 caracteres. Descriptor extendido de tag de 80 caracteres. Valor tpico. Cadena de unidades de ingeniera. Cero.

Manual del usuario de PI DataLink

39

Complemento para Excel

Atributo Span digstartcode dignumber pointtype pointsource location1 location2 location3 location4 location5 filtercode squareroot scan excdev excmin excmax archiving compressing Res compdev compmin compmax totalcode convers displaydigits instrumenttag sourcept taglong tagshort creator createdate changer changedate pointnumber

Explicacin Rango. Cdigo para la primera cadena de estado digital del tag. Nmero de estados digitales menos 1. Carcter de tipo de punto. Carcter de origen de punto. Parmetro de ubicacin 1. Parmetro de ubicacin 2. Parmetro de ubicacin 3. Parmetro de ubicacin 4. Parmetro de ubicacin 5. Cdigo de filtro. Flag de raz cuadrada. Flag de exploracin. Desviacin por excepcin en porcentaje de rango. Tiempo mnimo de excepcin en segundos. Tiempo mximo de excepcin en segundos. Flag de archivado histrico. Flag de compresin. Cdigo de resolucin. Desviacin de compresin en porcentaje de rango. Tiempo mnimo de compresin en segundos. Tiempo mximo de compresin en segundos. Cdigo de totalizacin. Factor de conversin para puntos postprocesados. Controla el formato de los valores numricos en pantallas PI basadas en terminales. Nombre de tag para un valor en otro sistema, lo utilizan algunas interfaces. Nombre de tag para la salida a otro sistema, lo utilizan algunas interfaces. Nombre de tag largo (hasta 80 caracteres). Nombre de tag de 12 caracteres. Creador del tag. Fecha de creacin del tag. Usuario que modific los atributos del tag. Fecha de modificacin del tag. Nmero de identificacin reutilizado al eliminar un punto.

40

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

Atributo pointid

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

PITagAtt() (en la pgina 41) PITagAtt()

PITagAtt(tagname, attribute, PIServer)

Argumentos
Argumento tagname (cadena) attribute (cadena) PIServer (cadena) Explicacin El tag para el cual desea un atributo. El atributo del tag, consulte la lista en Cuadro de dilogo Atributos del tag (en la pgina 39). El servidor PI.

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

Manual del usuario de PI DataLink

41

Complemento para Excel

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

42

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

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
Argumento tagname (cadena) stime (cadena) numvals (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar datos del archivo histrico que retrocede desde stime. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.

Devoluciones Cdigos de salida

Manual del usuario de PI DataLink

43

Complemento para Excel

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
Argumento tagname (cadena) stime (cadena) numvals (entero) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar datos del archivo histrico que retrocede desde stime. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.

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.

44

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

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".

Manual del usuario de PI DataLink

45

Complemento para Excel

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
Expresiones de filtro (en la pgina 150) PICompDat() (en la pgina 46) PICompFilDat() (en la pgina 47) PICompDat()
PICompDat(tagname, stime, etime, outcode, PIServer)

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

46

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

Argumento stime (cadena) etime (cadena) outcode (entero) PIServer (cadena)

Explicacin La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.

Devoluciones Consulte Cdigos de salida.

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
Argumento tagname (cadena) stime (cadena) etime (cadena) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.

Manual del usuario de PI DataLink

47

Complemento para Excel

Devoluciones Consulte Cdigos de salida. 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).

48

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

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
Expresiones de filtro (en la pgina 150) PISampDat() (en la pgina 49) PISampFilDat() (en la pgina 50) PIExpDat() (en la pgina 51) PISampDat()
PISampDat(tagname, stime, etime, interval, outcode, PIServer)

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos de muestra. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. Un cdigo de salida; 0, 1, 2 3. El servidor PI.

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos de muestra Marcas de tiempo Datos de muestra Columna 2

Manual del usuario de PI DataLink

49

Complemento para Excel

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
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos de muestra. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida; 0, 1, 2 3. El servidor PI.

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos de muestra Marcas de tiempo Datos de muestra Columna 2

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.

50

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

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
Argumento expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147). La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. Un cdigo de salida; 0, 1, 2 3. El servidor PI.

stime (cadena) etime (cadena) interval (cadena) outcode (entero) PIServer (cadena)

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos calculados Marcas de tiempo Datos calculados Columna 2

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.

Manual del usuario de PI DataLink

51

Complemento para Excel

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 el mensaje "No se han encontrado eventos".

Campos obligatorios
Nombre de tag Marca de tiempo. El campo de marca de tiempo tiene que ser una referencia de una

matriz de tiempo. Para PI 2, las marcas de tiempo de esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes.

Temas relacionados
PITimeDat() (en la pgina 52) PITimeExpDat() (en la pgina 53) PITimeDat() PITimeDat(tagname, timestamps, PIServer, mode) Argumentos
Argumento tagname (cadena) timestamps (referencia) Explicacin El tag para el cual desea datos de muestra. Una referencia a una matriz de horas en formato PI. Para PI 2, los valores en esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes. El servidor PI. El modo de recuperacin.

PIServer (cadena) mode (cadena)

52

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

Devoluciones Datos de muestra. Si las marcas de tiempo estn en una sola columna, los datos se devuelven en una sola columna. Si las marcas de tiempo estn en una sola fila, los datos se devuelven en una sola fila. Ejemplo La siguiente frmula recupera datos temporizados interpolados para las horas ubicadas en las celdas B1 a B12 para el tag mytag del servidor PI predeterminado:
=PITimeDat("mytag",b1:b12,,"interpolated")

PITimeExpDat()
PITimeExpDat(expression, timestamps, PIServer)

Argumentos
Argumento expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147). Una referencia a una matriz de horas en formato PI. Para PI 2, los valores en esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes. El servidor PI.

timestamps (referencia)

PIServer (cadena)

Devoluciones Datos de muestra. Si las marcas de tiempo estn en una sola columna, los datos se devuelven en una sola columna. Si las marcas de tiempo estn en una sola fila, los datos se devuelven en una sola fila. Ejemplo La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid para las horas ubicadas en las celdas B1 a B12 del servidor PI predeterminado:
=PITimeExpDat("sqr('sinusoid')",b1:b12,)

Cuadro de dilogo Datos calculados

Este cuadro de dilogo devuelve un nico valor calculado o valores calculados espaciados de forma uniforme del archivo de datos PI. Los modos de clculo son:

Manual del usuario de PI DataLink

53

Complemento para Excel

Total Minimum (Mnimo) Maximum (Mximo) Standard deviation (Desviacin estndar) Range (Rango) Average (Promedio) Count (Cuenta) Mean (Media)

Todos los modos de clculo son de tiempo ponderado, excepto la funcin principal que es de evento ponderado.

Campos obligatorios
Nombre de tag Hora de inicio Hora de finalizacin Factor de conversin Modo de clculo

Intervalo
Para recuperar un nico valor calculado, no especifique un intervalo y utilice la funcin PICalcVal(). Para recuperar un dato calculado espaciado de forma uniforme, el intervalo especificado determina el espaciado del clculo y se utiliza la funcin PICalcDat().

Casilla de verificacin
Compruebe mostrar pctgood si desea que PI DataLink muestre el porcentaje del rango de tiempo que contiene un valor correcto. Le recomendamos que siempre se fije en el valor de porcentaje correcto antes de utilizar el resultado del clculo. El valor de porcentaje correcto se suele devolver a la derecha de la celda de valor calculado. Si selecciona la casilla de verificacin filas, el valor de porcentaje correcto se devuelve a la celda situada debajo de la celda de valor calculado.

54

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

Las marcas de tiempo se devuelven cuando el modo de clculo es mnimo, mximo o rango.
Modo Mnimo Mximo Rango Columna 1 Tiempo del valor mn. Tiempo del valor mx. Tiempo del valor mn. Columna 2 Valor mnimo Valor mximo Tiempo del valor mx. Valor de rango Columna 3

Notas especiales
Si no se especifica un intervalo y el modo es Total, Desviacin estndar, Promedio, Cuenda o Media, no se mostrarn las marcas de tiempo, aunque se haya seleccionado la casilla de verificacin Mostrar marcas de tiempo. Si se especifica un intervalo y el modo es Mx o Mn, las marcas de tiempo mostradas son la hora de inicio de cada intervalo de clculo. Cuando el modo de clculo es Total de tiempo ponderado y parte de los datos archivados en el rango son incorrectos, el valor informado es igual al valor total calculado dividido por la fraccin del perodo de tiempo con datos archivados correctos. Esta normalizacin de datos es equivalente a la suposicin de que para un rango de tiempo de datos incorrecto el valor del tag utiliza el valor promedio de todo el rango. Sin embargo, esta suposicin puede no ser vlida cuando una amplia fraccin del rango temporal contiene datos incorrectos. Por ello, le recomendamos que siempre se fije en el valor de porcentaje correcto antes de utilizar el resultado del clculo. El factor de conversin se utiliza ms a menudo cuando el modo de clculo es Total y la unidad de tiempo del tag PI que se totaliza no es la misma que la predeterminada del servidor. En todos los servidores PI 3 y en la mayora de los servidores PI 2, el valor predeterminado de totalizacin es "unidades por da". En el servidor PI 2, el tiempo de totalizacin predeterminado (totdefaulttime es la unidad de tiempo en segundos) se puede encontrar en el archivo pilink:[Link]. La siguiente tabla muestra los factores de conversin para dos de las unidades de tiempo predeterminadas del servidor PI 2 comn frente a diversas unidades de tag de flujo.
Unidad de tag de flujo Unidades/da Unidades/hora Unidades/minuto Unidades/segun do El valor predeterminado del servidor es unidades/da (totdefaulttime = 86400) 1.0 24 1440 86400 El valor predeterminado del servidor es unidades/hora (totdefaulttime = 3600) 0.041667 1 60 3600

Manual del usuario de PI DataLink

55

Complemento para Excel

Temas relacionados
PICalcVal() (en la pgina 56) PICalcDat() (en la pgina 57) PICalcVal()
PICalcVal(tagname, stime, etime, mode, cfactor, outcode, PIServer)

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) mode (cadena) cfactor (nmero) Explicacin El tag para el cual desea el valor calculado. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). Un factor de conversin multiplicador. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI.

outcode (entero) PIServer (cadena)

Devoluciones Si el cdigo de salida es 0, slo se devuelve el valor calculado. Si el cdigo de salida es 1, se aplica lo siguiente:
Modo Total Mnimo Mximo Stdev Rango Promedio Cuenta Media Columna 1 Valor total Tiempo del valor mn. Tiempo del valor mx. Valor Stdev. Tiempo del valor mn. Valor de promedio Valor de cuenta Valor de media Tiempo del valor mx. Valor de rango Valor mnimo Valor mximo Columna 2 Columna 3

56

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

Un cdigo de salida 2 transpone la matriz de salida que resulta de un cdigo de salida 1; [Link]., los resultados se devuelven en filas en vez de en columnas. El cdigo de salida 3 no se utiliza. Si el cdigo de salida es 4, el porcentaje correcto se devuelve a la derecha de la celda de valor. Si el cdigo de salida es 5, se aplica lo siguiente:
Modo Total Mnimo Mximo Stdev Rango Promedio Cuenta Media Columna 1 Valor total Tiempo del valor mn. Tiempo del valor mx. Valor Stdev. Tiempo del valor mn. Valor de promedio Valor de cuenta Valor de media Columna 2 Porcentaje correcto Valor mnimo Valor mximo Porcentaje correcto Tiempo del valor mx. Porcentaje correcto Porcentaje correcto Porcentaje correcto Valor de rango Porcentaje correcto Porcentaje correcto Porcentaje correcto Columna 3 Columna 4

Un cdigo de salida 6 transpone la matriz de salida que resulta de un cdigo de salida 4; [Link]., los resultados se devuelven en filas en vez de en columnas. Un cdigo de salida 7 transpone la matriz de salida que resulta de un cdigo de salida 5; [Link]., los resultados se devuelven en filas en vez de en columnas. Ejemplo La siguiente frmula calcula un total de tiempo ponderado para el tag cdf144 desde ayer a hoy del servidor PI predeterminado:
=PICalcVal("cdf144","y","t","total",1440,4,)

El resultado se multiplica por 1440. El porcentaje correcto se devuelve junto al total. PICalcDat()
PICalcDat(tagname, stime, etime, interval, mode, cfactor, outcode, PIServer)

Manual del usuario de PI DataLink

57

Complemento para Excel

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) mode (cadena) cfactor (nmero) Explicacin El tag para el cual desea los datos calculados. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7. El servidor PI.

outcode (entero) PIServer (cadena)

Devoluciones El cdigo de salida afecta a la salida de la forma siguiente:

0 1 2 3 4 5 6 7

Valores calculados en una columna Marcas de tiempo y valores en 2 columnas Valores calculados en una fila Marcas de tiempo y valores en 2 filas Valores y pctgood en 2 columnas Marcas de tiempo, valores y pctgood en 3 columnas Valores y pctgood en 2 filas Marcas de tiempo, valores y pctgood en 3 filas

Ejemplo La siguiente frmula recupera totales para el tag ubicado en la celda B1, desde la medianoche de ayer hasta la medianoche de hoy en intervalos de 3 horas del servidor PI predeterminado especificado en el archivo [Link]:
=PICalcDat(b1,"y","t","3h","total",24,1,)

Tambin se devuelven marcas de tiempo. Los valores se multiplican por 24 antes de mostrarse en la hoja de clculo.

58

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

Cuadro de dilogo Datos calculados avanzados

Este cuadro de dilogo devuelve un nico valor calculado o valores calculados espaciados de forma uniforme del archivo de datos PI. Los modos de clculo son:
Total Minimum (Mnimo) Maximum (Mximo) Standard deviation (Desviacin estndar) Range (Rango) Average (Promedio) Count (Cuenta)

Campos obligatorios
Nombre de tag o expresin. Para obtener ms informacin sobre la sintaxis de la

expresin de clculo, consulte Expresiones de clculo (en la pgina 147).

Hora de inicio Hora de finalizacin Factor de conversin Modo de clculo

Expresin de filtro
Si se especifica una expresin de filtro, los resmenes solicitados en el punto de origen se calculan para los rangos de tiempo en los que la expresin se evale como verdadera. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150).

Intervalo
Para recuperar un nico valor calculado, no especifique ningn intervalo. Para recuperar datos calculados espaciados de forma uniforme, el intervalo especificado determina el espaciado del clculo.

Manual del usuario de PI DataLink

59

Complemento para Excel

Modo Muestreo de expresin

Existen 3 modos de muestreo de expresin para realizar una muestra de la expresin de filtro:
Pt. Compressed (Pto. comprimido) (predeterminado): evala la expresin de filtro en la

marca de tiempo para cualquier valor comprimido del punto de origen.

Exp Compressed (Exp. comprimida): evala la expresin de filtro en la marca de tiempo

de cualquier valor comprimido de cualquier tag de la expresin de filtro.

Interpolated (Interpolado): evala la expresin de filtro en intervalos de muestra

espaciados de forma uniforme. Existen 2 modos de muestreo de expresin para realizar una muestra de las expresiones que se van a resumir:
Compressed (Comprimido) (predeterminado): evala la expresin en la marca de tiempo

de cualquier valor comprimido de cualquier tag de la expresin.

Interpolated (Interpolado): evala la expresin en intervalos de muestra espaciados de

forma uniforme.

Intervalo de muestreo de expresin

Si el modo Muestreo de expresin se especifica como interpolado, el intervalo de muestreo de expresin especificado determina el espaciado con el que se evala la expresin. Si el modo Muestreo de expresin no se interpola, el intervalo de muestreo de la expresin se ignora.

Bases de clculo
Existen dos tipos de bases de clculo:
Time Weighted (Tiempo ponderado) (predeterminado): pondera los valores del clculo

por el tiempo durante el cual se aplican.

Event Weighted (Evento ponderado): pondera cada evento con el mismo peso. Debe

existir al menos un evento dentro del rango temporal para realizar un clculo correcto. Para la desviacin estndar son necesarios dos eventos.

Porcentaje correcto mnimo

El porcentaje correcto mnimo es el porcentaje mnimo de datos correctos a lo largo del rango temporal con el que se devolvern datos en lugar de un error "Datos correctos insuficientes".

60

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

Casilla de verificacin
Consulte la descripcin de casilla de verificacin que se ofrece en Cuadro de dilogo Datos calculados (en la pgina 53).

Notas especiales
Consulte la descripcin de notas especiales que se ofrece en Cuadro de dilogo Datos calculados (en la pgina 53).

Temas relacionados
Expresiones de filtro (en la pgina 150) PIAdvCalcVal() (en la pgina 61) PIAdvCalcFilVal() (en la pgina 62) PIAdvCalcExpVal() (en la pgina 64) PIAdvCalcExpFilVal() (en la pgina 65) PIAdvCalcDat() (en la pgina 66) PIAdvCalcFilDat() (en la pgina 67) PIAdvCalcExpDat() (en la pgina 68) PIAdvCalcExpFilDat() (en la pgina 69) PIAdvCalcVal()
PIAdvCalcVal(tagname, stime, etime, mode, calcbasis, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) Explicacin El tag para el cual desea el valor calculado. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI.

Manual del usuario de PI DataLink

61

Complemento para Excel

Argumento mode (cadena) calcbasis (entero) minpctgood (nmero) Cfactor (nmero)

Explicacin El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. 0 para tiempo ponderado; 1 para evento ponderado. Porcentaje mnimo de datos correctos durante un rango temporal. Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI.

outcode (entero) PIServer (cadena)

Devoluciones Para obtener informacin sobre la funcin PICalcVal() (en la pgina 56), consulte la seccin Devoluciones. Ejemplo La siguiente frmula calcula un total de tiempo ponderado para el tag cdf144 desde ayer a hoy del servidor PI predeterminado:
=PIAdvCalcVal("cdf144","y","t","total",0,50,1,4,)

Este resultado se multiplica por 1. El valor de minpctgood es el 50 por ciento, de modo que el resultado nicamente se mostrar si el porcentaje correcto es del 50% o superior. El porcentaje correcto se devuelve junto al total. PIAdvCalcFilVal()
PIAdvCalcFilVal(tagname, stime, etime, filtexp, mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) Explicacin El tag para el cual desea el valor calculado. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI.

62

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

Argumento filtexp (cadena)

Explicacin La expresin de filtro. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150). El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. 0 para tiempo ponderado; 1 para evento ponderado. El modo de muestreo (pto. comprimido, exp. comprimida o interpolado). El intervalo de muestreo en formato de hora PI. Porcentaje mnimo de datos correctos durante un rango temporal. Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI.

mode (cadena) calcbasis (entero) sampmode (cadena) sampinterval (cadena) minpctgood (nmero) Cfactor (nmero)

outcode (entero) PIServer (cadena)

Devoluciones Para obtener informacin sobre la funcin PICalcVal() (en la pgina 56), consulte la seccin Devoluciones. Ejemplo La siguiente frmula calcula un total de tiempo ponderado para el tag cdf144 desde ayer a hoy durante los perodos de tiempo en los que el tag cdm158 se encuentra en Manual en el servidor PI predeterminado:
=PIAdvCalcFilVal("cdf144","y","t","'cdm158'=""Manual""","total",0, "pt. compressed","10m",50,1,4,)

El resultado se multiplica por 1. Puesto que [Link] es el modo de muestreo especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin en los eventos comprimidos de cdf144. El minpctgood es del 50 por ciento, por lo que nicamente se mostrarn resultados si el porcentaje correcto es del 50% o superior. El porcentaje correcto se devuelve junto al total.

Manual del usuario de PI DataLink

63

Complemento para Excel

PIAdvCalcExpVal()
PIAdvCalcExpVal(expression, stime, etime, mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento expression (cadena) stime (cadena) etime (cadena) mode (cadena) calcbasis (entero) sampmode (cadena) sampinterval (cadena) minpctgood (nmero) cfactor (nmero) Explicacin La expresin para la que desea el valor de archivo histrico. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. 0 para tiempo ponderado; 1 para evento ponderado. El modo de muestreo (comprimido o interpolado). El intervalo de muestreo en formato de hora PI. Porcentaje mnimo de datos correctos durante un rango temporal. Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI.

outcode (entero) PIServer (cadena)

Devoluciones Para obtener informacin sobre la funcin PICalcVal() (en la pgina 56), consulte la seccin Devoluciones. Ejemplo La siguiente frmula calcula un total de tiempo ponderado para la expresin 'cdf144'+' cdt158' desde ayer a hoy del servidor PI predeterminado:
=PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total",0,"compressed ","10m",0,1,4,)

El resultado se multiplica por 1. Puesto que compressed es el modo de muestreo especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin en los eventos comprimidos combinados de cdf144 y cdt158. El minpctgood es del 50 por ciento, por lo que nicamente se mostrarn resultados si el porcentaje correcto es del 50% o superior. El porcentaje correcto se devuelve junto al total.

64

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

PIAdvCalcExpFilVal()
PIAdvCalcExpFilVal(expression, stime, etime, filtexp, mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento expression (cadena) stime (cadena) etime (cadena) filtexp (cadena) Explicacin La expresin para la que desea el valor de archivo histrico. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150). El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. 0 para tiempo ponderado; 1 para evento ponderado. El modo de muestreo (comprimido o interpolado). El intervalo de muestreo en formato de hora PI. Porcentaje mnimo de datos correctos durante un rango temporal. Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI.

mode (cadena) calcbasis (entero) sampmode (cadena) sampinterval (cadena) minpctgood (nmero) cfactor (nmero)

outcode (entero) PIServer (cadena)

Devoluciones Para obtener informacin sobre la funcin PICalcVal() (en la pgina 56), consulte la seccin Devoluciones. Ejemplo La siguiente frmula calcula un total de tiempo ponderado para la expresin 'cdf144'+' cdt158' si 'productid' = "Product2" desde ayer a hoy del servidor PI predeterminado:
=PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'="Prod uct2"", "total",0,"compressed","10m",0,1,4,)

Manual del usuario de PI DataLink

65

Complemento para Excel

El resultado se multiplica por 1. Puesto que compressed es el modo de muestreo especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin en los eventos comprimidos combinados de cdf144 y cdt158. El minpctgood es del 50 por ciento, por lo que nicamente se mostrarn resultados si el porcentaje correcto es del 50% o superior. El porcentaje correcto se devuelve junto al total. PIAdvCalcDat()
PIAdvCalcDat(tagname, stime, etime, interval, mode, calcbasis, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) mode (cadena) calcbasis (entero) minpctgood (nmero) cfactor (nmero) Explicacin El tag para el cual desea los datos calculados. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. 0 para tiempo ponderado; 1 para evento ponderado. Porcentaje mnimo de datos correctos durante un rango temporal. Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7. El servidor PI.

outcode (entero) PIServer (cadena)

Devoluciones Para obtener informacin sobre la funcin PICalcDat() (en la pgina 57), consulte la seccin Devoluciones. Ejemplo La siguiente frmula recupera totales para el tag cdf144 desde la medianoche de ayer hasta la medianoche de hoy en intervalos de 3 horas del servidor predeterminado PI:
=PIAdvCalcDat("cdf144","y","t","3h","total",0,50,1,4,)

66

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

Este resultado se multiplica por 1. El valor de minpctgood es el 50 por ciento, de modo que el resultado nicamente se mostrar si el porcentaje correcto es del 50% o superior. El porcentaje correcto se devuelve junto al total. PIAdvCalcFilDat()
PIAdvCalcFilDat(tagname, stime, etime, interval, filtexp, mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) Explicacin El tag para el cual desea los datos calculados. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150). El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. 0 para tiempo ponderado; 1 para evento ponderado. El modo de muestreo (pto. comprimido, exp. comprimida o interpolado). El intervalo de muestreo en formato de hora PI. Porcentaje mnimo de datos correctos durante un rango temporal. Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7. El servidor PI.

mode (cadena) calcbasis (entero) sampmode (cadena) sampinterval (cadena) minpctgood (nmero) cfactor (nmero)

outcode (entero) PIServer (cadena)

Devoluciones Para obtener informacin sobre la funcin PICalcDat() (en la pgina 57), consulte la seccin Devoluciones.

Manual del usuario de PI DataLink

67

Complemento para Excel

Ejemplo La siguiente frmula recupera totales para el tag cdf144 desde la medianoche de ayer hasta la medianoche de hoy en intervalos de 3 horas durante los perodos temporales en los que el tag cdf144 se encuentra en Manual en el servidor PI predeterminado:
=PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""","tota l",0,"pt. compressed","10m",50,1,4,)

El resultado se multiplica por 1. Puesto que [Link] es el modo de muestreo especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin de filtro en los eventos comprimidos de cdf144. El porcentaje correcto se devuelve junto al total. PIAdvCalcExpDat()
PIAdvCalcExpDat(expression, stime, etime, interval, mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento expression (cadena) stime (cadena) etime (cadena) interval (cadena) mode (cadena) calcbasis (entero) sampmode (cadena) sampinterval (cadena) minpctgood (nmero) cfactor (nmero) Explicacin La expresin para la cual desea los datos calculados. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. 0 para tiempo ponderado; 1 para evento ponderado. El modo de muestreo (comprimido o interpolado). El intervalo de muestreo en formato de hora PI. Porcentaje mnimo de datos correctos durante un rango temporal. Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7. El servidor PI.

outcode (entero) PIServer (cadena)

68

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

Devoluciones Para obtener informacin sobre la funcin PICalcDat() (en la pgina 57), consulte la seccin Devoluciones. Ejemplo La siguiente frmula recupera totales para la expresin 'cdf144'+'cdt158' desde la medianoche de ayer hasta la medianoche de hoy en intervalos de 3 horas del servidor predeterminado PI:
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total",0,"compr essed", "10m",50,1,4,)

El resultado se multiplica por 1. Puesto que compressed es el modo de muestreo especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin en los eventos comprimidos combinados de cdf144 y cdt158. El minpctgood es del 50 por ciento, por lo que nicamente se mostrarn resultados si el porcentaje correcto es del 50% o superior. El porcentaje correcto se devuelve junto al total. PIAdvCalcExpFilDat()
PIAdvCalcExpFilDat(expression, stime, etime, interval, filtexp, mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode, PIServer)

Argumentos
Argumento expression (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) Explicacin La expresin para la que desea el valor de archivo histrico. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150). El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio, cuenta o media). La base del clculo. (tiempo ponderado o evento ponderado). El modo de muestreo (comprimido o interpolado). El intervalo de muestreo en formato de hora PI. Porcentaje mnimo de datos correctos durante un rango temporal.

mode (cadena) calcbasis (entero) sampmode (cadena) sampinterval (cadena) minpctgood (nmero)

Manual del usuario de PI DataLink

69

Complemento para Excel

Argumento cfactor (nmero)

Explicacin Un factor de conversin multiplicativo. Debe ser 1 para mx, mn, promedio, cuenta, media, desviacin estndar y rango. Para obtener ms informacin sobre el factor de conversin, consulte Notas especiales (consulte "Cuadro de dilogo Datos calculados" en la pgina 53) en Cuadro de dilogo Datos calculados (en la pgina 53). Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI.

outcode (entero) PIServer (cadena)

Devoluciones Para obtener informacin sobre la funcin PICalcDat() (en la pgina 57), consulte la seccin Devoluciones. Ejemplo La siguiente frmula calcula un total de tiempo ponderado para la expresin 'cdf144'+' cdt158' si 'productid' = "Product2" en intervalos de 3 horas desde ayer a hoy del servidor PI predeterminado:
=PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'productid'= "Product2"","total",0,"compressed","10m",0,1,4,)

El resultado se multiplica por 1. Puesto que compressed es el modo de muestreo especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin en los eventos comprimidos combinados de cdf144 y cdt158. El minpctgood es del 50 por ciento, por lo que nicamente se mostrarn resultados si el porcentaje correcto es del 50% o superior. El porcentaje correcto se devuelve junto al total.

Cuadro de dilogo Filtrado de tiempo

Este cuadro de dilogo devuelve la cantidad de tiempo para la que una expresin dada es verdadera en un rango temporal especificado. El usuario puede especificar mltiples rangos temporales como intervalos espaciados de forma uniforme, como en el cuadro de dilogo Datos calculados.

Campos obligatorios
Expresin. Para obtener ms informacin sobre la sintaxis de la expresin de clculo,

consulte Expresiones de clculo (en la pgina 147).

Hora de inicio

70

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

Hora de finalizacin Unidades de tiempo (predeterminadas a segundos)

Notas especiales
Si introduce la expresin en una celda de la hoja de clculo y hace referencia a ella en el cuadro de dilogo, comience la expresin con una comilla simple para que Excel la interprete como una cadena. Puesto que un 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
Expresiones de clculo (en la pgina 147) PITimeFilterVal() (en la pgina 71) PITimeFilter() (en la pgina 72) PITimeFilterVal()
PITimeFilterVal(expression, stime, etime, timeunit, outcode, PIServer)

Argumentos
Argumento expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147). La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. La unidad de tiempo del resultado que se va a mostrar. Las entradas vlidas son: segundos, minutos, horas y das. Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI.

stime (cadena) etime (cadena) timeunit (cadena) outcode (entero) PIServer (cadena)

Devoluciones
Si el cdigo de salida es 0, 1 o 2, slo se devuelve el valor calculado.

Manual del usuario de PI DataLink

71

Complemento para Excel

El cdigo de salida 3 no se utiliza. Si el cdigo de salida es 4 o 5, el porcentaje correcto se devuelve a la derecha de la celda

de valor.
Si el cdigo de salida es 6 o 7, el porcentaje correcto se devuelve debajo de la celda de

valor. Ejemplo La siguiente frmula calcula la cantidad de tiempo que la expresin de la celda $A$1 es verdadera para el servidor PI denominado THEVAX, comenzando la medianoche de ayer hasta la medianoche de hoy:
=PITimeFilterVal($A$1,"y","t","seconds",1,"thevax")

El resultado del clculo se expresa en segundos. PITimeFilter()

PITimeFilter(expression, stime, etime, interval, timeunit, outcode, PIServer)

Argumentos
Argumento expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147). La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. La unidad de tiempo del resultado que se va a mostrar. Las entradas vlidas son: segundos, minutos, horas y das. Un cdigo de salida; de 0 a 7. El servidor PI.

stime (cadena) etime (cadena) interval (cadena) timeunit (cadena) outcode (entero) PIServer (cadena)

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos calculados Marcas de tiempo Datos calculados Columna 2

72

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

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 calcula la cantidad de tiempo que la expresin de la celda $A$1 es verdadera para el servidor PI denominado THEVAX en intervalos de 1 hora, comenzando la medianoche de ayer hasta la medianoche de hoy:
=PITimeFilter($A$1,"y","t","1h","seconds",1,"thevax")

Tambin muestra las marcas de tiempo para la hora de inicio de cada intervalo de clculo. El resultado del clculo se expresa en segundos.

Cuadro de dilogo Identificador del punto para tag

Este cuadro de dilogo devuelve el nombre de tag del identificador del punto especificado.

Campos obligatorios
Identificador de punto

Temas relacionados
PIPointIDToTag() (en la pgina 73) PIPointIDToTag()
PIPointIDToTag(pointid, PIServer)

Argumentos
Argumento PointID (cadena) PIServer (cadena) Explicacin Nmero de identificacin interno nico que no se reutiliza al eliminar un punto. El servidor PI.

Devoluciones Nombre de tag

Manual del usuario de PI DataLink

73

Complemento para Excel

Ejemplo La siguiente frmula devuelve el nombre de tag del tag con identificador de punto 123 del servidor denominado THEVAX.
=PIPointIDToTag("123","thevax")

Cuadro de dilogo Mscara de atributo para tag

Este cuadro de dilogo devuelve una lista de tags correspondientes a las mscaras de atributos de tag especificadas.

Campos obligatorios
Nombre de tag Descriptor Origen de punto Tipo de punto Clase de punto Unidades de ingeniera

Temas relacionados
PIAttributeMaskToTag () (en la pgina 74) PIAttributeMaskToTag ()
PIAttributeMaskToTag(tagname, descriptor, pointsource, pointtype, pointclass, engunits, outcode, PIServer)

Argumentos
Argumento tagname (cadena) descriptor (cadena) pointsource (cadena) pointtype (cadena) pointclass (cadena) Explicacin Mscara de nombre del tag. Mscara de descriptor. Mscara de fuente del punto. Mscara de tipo de punto. Mscara de Clase de punto.

74

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

Argumento engunits (cadena) outcode (entero) PIServer (cadena)

Explicacin Mscara de unidades de ingeniera. Un cdigo de salida; 0 o 2. El servidor PI.

Devoluciones
Cdigo de salida 0 Columna 1 Nombre de tag Columna 2

Un cdigo de salida 2 transpone la matriz de salida que resulta de un cdigo de salida 1. Ejemplo La siguiente frmula devuelve el nombre de tag de los tags que empiezan por "sin" en el servidor denominado THEVAX.
=PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")

Cuadro de dilogo Alias

Este cuadro de dilogo devuelve un nombre de tag cuando se especifica un alias.

Campos obligatorios
Alias Ruta de mdulo Fecha de consulta

Temas relacionados
PIAliasToTag() (en la pgina 75) PIAliasToTag()
PIAliasToTag(alias, modulepath, querydate, outcode, PIServer)

Manual del usuario de PI DataLink

75

Complemento para Excel

Argumentos
Argumento alias (cadena) modulepath (cadena) querydate (entero) Outcode (entero) PIServer (cadena) Explicacin Elemento del mdulo que es una referencia a un punto PI. Ruta completa a un mdulo de la base de datos de mdulos. Consulta de mdulos con fechas efectivas en el momento o despus de esta fecha. Un cdigo de salida; 0, 1 o 2. El servidor PI.

Devoluciones
Cdigo de salida 0 1 Columna 1 Nombre de tag Nombre de tag Servidor de tag Columna 2

Un cdigo de salida 2 transpone la matriz de salida que resulta de un cdigo de salida 1. Ejemplo La siguiente frmula devuelve el nombre de tag correspondiente al alias "Temperature" del mdulo "Reactor1" que es un submdulo de "Unit1". "Unit1" est en la raz de la base de datos de mdulos de un servidor PI denominado THEVAX. La base de datos de mdulos se consulta a la hora actual.
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")

Cuadro de dilogo Propiedad

Este cuadro de dilogo devuelve un valor cuando se especifica una propiedad.

Campos obligatorios
Propiedad Ruta de mdulo Fecha de consulta

76

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

Temas relacionados
PIPropertyToValue() (en la pgina 77) PIPropertyToValue() PIPropertyToValue (property, modulepath, querydate, PIServer, outcode) Argumentos
Argumento Property (cadena) modulepath (cadena) querydate (entero) PIServer (cadena) Outcode (entero) Explicacin Elemento del mdulo que tiene un valor virtual cualquiera. Ruta completa a un mdulo de la base de datos de mdulos. Consulta de mdulos con fechas efectivas en el momento o despus de esta fecha. El servidor PI. Un cdigo de salida; 0 o 2.

Devoluciones
Un cdigo de salida 0 muestra el valor de la propiedad en una columna. Un cdigo de salida 2 muestra el valor de la propiedad en una fila.

Ejemplo La siguiente frmula devuelve el valor correspondiente a la propiedad "Implementer" del mdulo "Reactor1" que es un submdulo de "Unit1". "Unit1" est en la raz de la base de datos de mdulos de un servidor PI denominado THEVAX. La base de datos de mdulos se consulta a la hora actual. =PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax")

Insertar Trend Control

Trend Control es un control ActiveX que se puede insertar en cualquier hoja de clculo de Excel. La trend puede mostrar datos de la hoja de clculo y de un tag del servidor PI.

Manual del usuario de PI DataLink

77

Complemento para Excel

Para crear una trend, se proporciona un asistente de trends que facilita la insercin de trends. Hay dos fuentes de datos que Trend Control puede trazar:
Datos de la hoja de clculo Datos PI

Datos de la hoja de clculo El Asistente de trends se puede utilizar para crear una trend desde los datos de una hoja de clculo de Excel.

78

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

Si los datos proceden de la hoja de clculo, se deber especificar el rango de celdas de los datos. El rango de celdas se puede introducir manualmente o se puede utilizar el ratn para especificarlo. Para especificar el rango con el ratn, haga clic en el botn a la derecha del campo. Aparecer otro cuadro de dilogo. Al seleccionar el rango en la hoja de clculo, se generar el formato de referencia de celdas en el cuadro de dilogo. La opcin El primer elemento es el nombre de trace se utiliza cuando se va a dar un nombre al trace de la trend. Si esta opcin est especificada, la cadena de la primera celda se utiliza para el nombre del trace. La primera celda es la celda sobre el primer valor del rango, si los datos se organizan en el formato de columnas. Si los datos se organizan en el formato de filas, la primera celda ser la celda situada a la izquierda del primer valor del rango. Para facilitar el uso de las funciones PI DataLink, la opcin Incluir todas las celdas en la matriz est especificada como predeterminada. Si esta opcin est especificada, entonces solo habr que especificar una celda de la matriz para el rango de celdas. El resto de la matriz se aade automticamente a la referencia de rangos de celda cuando se selecciona el botn Aadir ->. La opcin Trazar como datos escalonados proporciona al trace una apariencia de vista escalonada. Esta opcin suele especificar tags discretos. Datos de PI El Asistente de trends tambin se puede utilizar para crear una trend con datos procedentes directamente del servidor PI.

Manual del usuario de PI DataLink

79

Complemento para Excel

Para obtener datos directamente del servidor PI, hay que especificar el nombre de tag. El nombre de tag conveniente se puede buscar en la base de datos de puntos del servidor PI. Pulsando el botn Buscar..., aparece el cuadro de dilogo Bsqueda de tags. Este es el mismo cuadro de dilogo Bsqueda de tags que el del men PI. Todos los tags que se seleccionen en el cuadro de dilogo Bsqueda de tags se aadirn automticamente a la lista de traces. De forma predeterminada, DataLink muestra marcadores ocultos para diferenciar los traces en los visores monocromos; los marcadores ocultos tienen una separacin regular a lo largo del trace y no indican puntos de datos de archivo histrico. Seleccione la casilla de verificacin Marcadores para mostrar los marcadores que indican la ubicacin de los puntos de datos de archivo histrico en el trace. Otra forma de especificar los tags es por referencia de celdas. Si los nombres de tag estn en la hoja de clculo de Excel, se podrn consultar activando el cuadro de opciones Ref. de celda y especificando las celdas en las que se encuentran los nombres de tag. El nombre del servidor se puede especificar del mismo modo. Despus de hacer clic en Siguiente, habr que especificar la hora de inicio y la hora de finalizacin de la trend en el formato de hora PI. Ttulo y posicin de la trend La ltima pantalla sirve para configurar el ttulo de la trend y la posicin de la trend.

80

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

Si se selecciona una nueva hoja de clculo, la trend se colocar en la esquina superior izquierda de una hoja de clculo en blanco. Para mostrar los iconos de atributo de valor en la parte superior de la trend, seleccione la casilla de verificacin Mostrar atributos de valor; los iconos aparecern cuando el rango de datos contenga eventos que tengan establecidos los bits Cuestionable, Sustituido o Anotado. Si se especifica la opcin de hoja de clculo existente, entonces se deber especificar la celda en la que se vaya a colocar la trend. La celda seleccionada antes de introducir el asistente de trends es la referencia de celdas predeterminada. Asegrese de elegir una celda, que no contenga datos. Si la celda hace referencia a una celda que contiene datos, la trend cubrir los datos. No obstante, los datos no se eliminarn. Para mover la trend, haga clic con el botn derecho del ratn en la trend y seleccione Mover/Cambiar tamao. Men del botn derecho del ratn Despus de insertar la trend en la hoja de clculo Excel, se pueden realizar cambios rpidos en la misma seleccionando algunos de los elementos en el men derecho del ratn.

Manual del usuario de PI DataLink

81

Complemento para Excel

Para cambiar la escala del eje Y, puede seleccionar la opcin Cambiar escala.... De este modo, podr cambiar tanto el rango temporal como el eje Y de la trend. Si desea eliminar algn cambio de la escala, puede seleccionar la opcin Revertir para deshacer los cambios realizados. La opcin Revertir siempre revierte a los ajustes definidos en el Asistente de trends. Para desplazarse, puede habilitar las barras de desplazamiento con la opcin Barra de desplazamiento. La barra de desplazamiento se mostrar en la parte inferior de la trend. De nuevo, se puede utilizar la opcin Revertir para deshacer los cambios que realice la barra de desplazamiento. Para cambiar el formato del trace o de la propia trend, se puede utilizar la opcin Formato....

Por ejemplo, se puede utilizar esta opcin para cambiar el color o el grosor de lnea de un trace. Tambin, se puede utilizar para aadir leyendas a la trend. Definir trend... y Definir rango temporal de trend... vuelven a mostrar las pantallas del Asistente de trends. Eliminar trend elimina la trend. La opcin Exportar datos... pega los valores utilizados para trazar la trend en la hoja de clculo. La opcin Mover/Cambiar tamao mueve y cambia el tamao de la trend por el del rango de celdas especificado. La opcin Copiar/Pegar copia la trend al portapapeles y, a continuacin, solicita el destino del pegado. La trend pegada es una copia de la trend en cuanto a todo su formato y referencias a las celdas.

82

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

Informacin adicional Para obtener informacin adicional acerca de la utilizacin de Trend Control, pulse el botn Ayuda en el Asistente para trends. Tambin hay archivos de ayuda adicionales en ...\PIPC\HELP\PITrend*. Por ejemplo, para saber ms acerca de la automatizacin de Trend Control, hay un archivo de ayuda ...\PIPC\HELP\[Link].

Cuadro de dilogo Bsqueda de tags

Este cuadro de dilogo permite buscar tags desde los servidores PI y copiar los resultados a la hoja de clculo. Para copiar tags de la lista de resultados, primero debe seleccionar cada tag haciendo clic en el nombre del tag mientras mantiene presionada la tecla Ctrl. Para seleccionar un rango completo de tags, haga clic en el primer tag y despus presione la tecla MAYS y haga clic en la parte inferior del rango. Haga clic en Aceptar para copiar tags a la hoja de clculo. Si la opcin "Copiar nombre de PIServer" del cuadro de dilogo Ajustes... est activada, el servidor PI de cada tag se copiar a la hoja de clculo junto con los nombres de tag.

Los tags se copian en la hoja de clculo en una sola columna o en una sola fila, dependiendo de la opcin seleccionada en la seccin "Copiar elementos a la hoja" del cuadro de dilogo Ajustes... de PI DataLink.

Manual del usuario de PI DataLink

83

Complemento para Excel

La posicin inicial en donde se realiza el copiado es la celda actual. Si la opcin "Copiar nombre de PIServer" est activada, los nombres de los servidores se copiarn a una columna situada a la derecha de los nombres de tag de la hoja clculo cuando se seleccione la opcin En una columna de la seccin "Copiar elementos a la hoja". Si la opcin En una fila est activada en la seccin "Copiar elementos a la hoja", los nombres de servidor se copiarn bajo los nombres de tag de la hoja de clculo.

Cuadro de dilogo Module Database

Este cuadro de dilogo permite buscar alias, propiedades y mdulos desde los servidores PI y copiar los resultados a la hoja de clculo.

El cuadro de dilogo consiste principalmente en una vista de rbol de la base de datos de mdulos. El cuadro de dilogo permite a los usuarios copiar los elementos de la base de datos de mdulos a la hoja de clculo. El rbol de vistas muestra tres tipos de elementos de la base de datos de mdulos.

84

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

Alias Propiedades Mdulos

Hay dos formas de seleccionar los alias y las propiedades de la base de datos de mdulos, con cada mtodo se copia un conjunto distinto de elementos en la hoja de clculo.
Seleccionar slo un elemento, que copia dicho elemento a la hoja de clculo. Seleccionar el elemento "Alias" o "Propiedades" de un mdulo, que copia todos los alias

o propiedades de dicho mdulo respectivamente. Si se activa la opcin "copiar ruta del mdulo", se copiar toda la ruta de mdulo del alias o propiedad, junto con el alias o propiedad, a una celda adyacente de la hoja de clculo. Al seleccionar un mdulo, seleccionando slo un mdulo y seleccionando copiar ruta del mdulo, se copiar toda la ruta del mdulo a la hoja de clculo. Si la casilla de verificacin copiar ruta del mdulo no est activada, entonces slo se pegar el nombre del mdulo a la hoja de clculo. La lista desplegable Servidor PI se puede utilizar para alternar entre las bases de datos de mdulos de los distintos servidores PI. El campo de fecha de consulta se puede utilizar para especificar el contexto de fecha y hora de la base de datos de mdulos mostrada. Si la opcin "Copiar nombre de PIServer" del cuadro de dilogo Ajustes... est activada, el servidor PI de cada uno de los elementos de la base de datos de mdulos se copiar a la hoja de clculo junto con el elemento de la base de datos de mdulos.

Cuadro de dilogo Conexiones

Un cuadro de dilogo administra sus conexiones con el servidor PI.

Manual del usuario de PI DataLink

85

Complemento para Excel

Mediante el men del botn derecho del ratn, puede aadir servidores PI adicionales a la lista, editar o eliminar los servidores PI existentes y establecer un servidor PI existente como servidor PI predeterminado. Puede hacer clic en la casilla de verificacin para conectarse y desconectarse de los servidores PI de la lista. Despus de conectarse correctamente al servidor PI, el campo Estado se activa, la columna de usuario muestra el usuario al que se ha conectado la conexin y la columna de la versin PI muestra la versin del servidor PI al que se ha conectado.

Cuadro de dilogo Ajustes

Este cuadro de dilogo controla sus ajustes y preferencias de PI DataLink.

86

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

El conjunto de botones de exclusin mtua En una fila o En una columna determina si

los tags seleccionados en el cuadro de dilogo TagSearch se copian a la hoja de clculo en una fila o en una columna.
La casilla de verificacin Copiar nombre de PIServer determina si el nombre del

servidor PI se copia en el campo de edicin de PIServer en el caso de que se llame a TagSearch desde un cuadro de dilogo PI. Esta opcin tambin determina si los nombres del servidor se copian a la hoja de clculo de los tags seleccionados en el caso de que se llame a TagSearch directamente desde el men PI.
La casilla de verificacin Utilizar la zona horaria del servidor PI determina si todas las

funciones DataLink interpretan o no la hora utilizando la zona horaria del servidor PI en vez de la informacin de zona horaria del equipo cliente. Esta opcin afecta a los sistemas en los que el equipo del servidor PI 3 tiene una configuracin de zona horaria diferente a la del equipo cliente.
La casilla de verificacin Mostrar #N/D en vez de espacios blancos determina si se

debe mostrar "#N/D" o celdas en blanco cuando los datos son menores que el tamao de la matriz de funciones DataLink. Seleccione esta casilla de verificacin cuando los resultados de la funcin DataLink sean trazados por el paquete de grficos de Excel.
La casilla de verificacin Independiente regional determina si se deben utilizar las

cadenas de hora localizadas al analizar los datos de hora.

Manual del usuario de PI DataLink

87

Complemento para Excel

Seleccione esta casilla de verificacin para hacer que PI DataLink analice la cadena de hora correspondiente a las reglas de formato de hora PI. De este modo, se define dd-mmm-aaaa hh:mm:ss como el orden de fecha/hora y el ingls como idioma de las cadenas. Desactive esta casilla de verificacin para que PI DataLink pueda analizar la cadena de hora segn su configuracin regional, que incluye las preferencias de formato de fecha y hora. Si falla el anlisis especfico regional, PI DataLink intentar analizar de acuerdo con las reglas de formato de hora PI.

El cuadro de edicin Formato de nmero permite especificar un cdigo de formato de

nmero predeterminado. Esta cadena puede ser cualquier cdigo vlido de la lista Formato/Celdas/Nmero.
El cuadro de edicin Formato de hora permite especificar un cdigo de formato de hora

predeterminado. Esta cadena puede ser cualquier cdigo vlido de la lista Formato/Celdas/Nmero. Seleccione Aceptar para guardar su configuracin y Cancelar para cancelar sus cambios.

Acerca de
Esta opcin de men muestra informacin de la versin PI DataLink.

Ayuda
Esta opcin de men llama a la Ayuda de PI DataLink.

Escribir datos de Excel a PI

PI DataLink permite escribir un valor de la hoja de clculo al servidor PI. La funcin de macros de PI DataLink que realiza estas tareas es PIPutVal(). PIPutVal() reemplaza un evento existente con la misma marca de tiempo en el archivo histrico por el nuevo valor introducido por el usuario. PIPutVal() slo se puede invocar desde una hoja de macros de Excel o desde un mdulo VBA de Excel usando el mtodo [Link]. Consulte el archivo ...\PIPC\EXCEL\[Link] para saber cmo llamar a PIPutVal en un mdulo VBA. Especficamente, observe los tags marcados "PutVal" y el mdulo VBA "PutVal_code".

88

Escribir datos de Excel a PI

PIPutVal()
PIPutVal(tagname, value, time stamp, PIServer, outcell)

Argumentos
Argumento tagname (cadena) value (referencia) time stamp (cadena) PIServer (cadena) outcell (referencia) Explicacin El tag para el que se escribe el valor en PI. La referencia que se escribe de un valor. Puede ser una cadena (para estados digitales) o un nmero. Una marca de tiempo en formato de tiempo PI. El servidor PI. Una referencia a una celda en la que se muestra el valor devuelto de esta funcin de macros.

Devoluciones La cadena FALSO se devolver si la funcin de macros falla y se muestra un mensaje de error en la celda exterior. Si se escribe correctamente en el servidor PI, la cadena VERDADERO se devolver y el estado "estado digital escrito", "entero escrito" o "valor real escrito" se escribir en la celda exterior.
Nota: Esta funcin (PIPutVal) no comprueba si el nmero que se debe escribir est dentro del rango especificado por el usuario para un tag. El rango de un tag va de cero a cero + rango, en donde cero y rango son atributos del tag que el usuario especifica durante la creacin de puntos (tags). PI DataLink devolver el mensaje Valor escrito aunque se haya introducido un valor "Superior al rango" o "Inferior al rango" en el servidor PI.

Nota: PIPutVal admite todo tipo de datos de PI 3 (incluida la entrada de cadenas en tags de cadena), as como datos de los subsegundos. Las marcas de tiempo se interpretan utilizando informacin de la zona horaria del equipo cliente, a menos que la opcin "Utilizar la zona horaria del servidor PI" est habilitada o se trate de un servidor PI 2.

Ejemplo La siguiente frmula coloca el valor situado en la celda A5 en el servidor PI del servidor PI predeterminado a medianoche de hoy para el tag testtag:
=PIPutVal("testtag",a5,"t",,e5)

Manual del usuario de PI DataLink

89

Complemento para Excel

El resultado de la funcin de macros se coloca en la celda E5 de la hoja de macros.

Lmites de Excel para PI DataLink

Excel tiene una limitacin en el nmero de elementos de la matriz de clculos. PI DataLink est sujeto a este limitacin. Por lo tanto, hay un nmero mximo de valores que se pueden devolver para una funcin PI nica. El nmero mximo de eventos PI por recuperacin es 65536. El SDK de Excel que utiliza PI DataLink tiene una longitud de cadena de mximo 255 caracteres. Por ello, las cadenas de entrada de DataLink, como las frmulas o expresiones PI DataLink, no pueden exceder los 255 caracteres en una celda de referencia. Del mismo modo, la salida de cadenas de PI DataLink, como los resultados de los tags de cadena PI, ser truncada por PI DataLink a 255 caracteres.

90

Captulo 3: Complemento para Lotus 1-2-3

El complemento PI DataLink para Lotus 1-2-3 permite a los usuarios intercambiar directamente los datos del tag PI con sus servidores PI. Con PI DataLink, los usuarios pueden importar datos PI de varias formas desde un servidor PI. Adems, PI DataLink permite a los usuarios escribir valores de un tag PI en un servidor PI. PI DataLink proporciona las siguientes funciones para recuperar datos del servidor 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 mientras una expresin determinada es verdadera. Datos del tag PI de muestra sincronizados con una matriz de marcas de tiempo

especificadas por el usuario.

Datos de los clculos en las expresiones de tag PI. La cantidad de tiempo durante el cual una expresin de tag PI determinada fue verdadera. Totales, mnima, mxima, desviaciones estndar, rangos, promedios y mtodos para tags

PI.

Tutorial
El objetivo de esta seccin es iniciarle en el uso de PI DataLink en Lotus 1-2-3 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.

Manual del usuario de PI DataLink

91

Complemento para Lotus 1-2-3

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 Lotus 1-2-3. PI DataLink mostrar una pgina de dilogos. Seleccione el botn <cuadros de dilogo> para cargar los cuadros de dilogo situados bajo la opcin de men PI. Asegrese de que la opcin de men PI est en la barra de mens de Lotus 1-2-3. Si el men PI no aparece en el men principal de 1-2-3, consulte la seccin Resolucin de problemas (en la pgina 141). Desde el men de PI, seleccione Conexiones...

Si el estado indica que el servidor PI est DESCONECTADO, haga clic en el botn Conectar. 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.

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.

92

Tutorial

Un nombre de usuario o contrasea vlido cambia el Estado del cuadro de dilogo Conexiones a LECTURA o LECTURA/ESCRITURA. Cierre el cuadro de dilogo Conexiones haciendo clic en Cancelar. Si aparece un cuadro de dilogo de fallo al iniciar la sesin, confirme que su nombre de usuario y su contrasea PI sean vlidos. Si el cuadro de dilogo de fallo al iniciar la sesin aparece a pesar de que el nombre de usuario y la 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 de unos pocos tags. 1. Cargue el archivo ...\pipc\lotus\pidl_tutorial.123. 2. Conctese a un servidor PI vlido en el cuadro de dilogo de conexiones. 3. En la barra de mens de 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".

Manual del usuario de PI DataLink

93

Complemento para Lotus 1-2-3

4. A continuacin, cierre el cuadro de dilogo y site el cursor en la celda A2 de la hoja de clculo. 5. Seleccione Bsqueda de tags... en el men PI e introduzca BA en el campo Mscara de tag de modo que se lea "BA*".

6. Haga clic en Buscar para buscar los tags que comiencen con "BA". La lista Resultados de bsqueda contendr al menos cinco tags: BA:ACTIVE.1, BA:CONC.1, BA:LEVEL.1, BA:PHASE.1 y BA:TEMP.1. 7. 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. 8. Desplace el cursor a la celda B2. En el men PI, seleccione Atributos del tag...

94

Tutorial

Recuerde que la celda actual se muestra como la predeterminada en la casilla de edicin Salida de datos. 9. Haga clic en el botn a la derecha de la segunda casilla de edicin "Celdas" situado bajo el nombre del tag.

10. La celda actual se muestra como la predeterminada. Resalte las celdas A:A2..A:A6. Los rangos de introduccin manual tambin son aceptables. 11. Cuando la casilla de edicin contenga un rango vlido, pulse Aceptar. Observe cmo el rango seleccionado aparece en la casilla de edicin del cuadro de dilogo Atributos del tag. Si se selecciona una sola celda, el texto de dicha celda tambin se mostrar en el cuadro de edicin de nombre del tag. Si se selecciona un rango, entonces slo se mostrar el rango y no habr nada escrito en la casilla de edicin de nombre del tag. Una sola celda, una sola columna y una sola fila de nombres de tag (en la misma hoja) son ejemplos de un rango vlido. Los rangos no vlidos son rangos mltiples, rangos que consisten en ms de una hoja, un rango que consista en ms de una columna y una fila o cualquier direccin de celda que no contenga nombres de tag. 12. Desplcese desde el cuadro de lista etiquetado "Atributos" hasta que la palabra "Descriptor" se haga visible. Seleccione "Descriptor". 13. En el cuadro de edicin etiquetado "Salida de macros [opc]", introduzca manualmente la direccin de la celda como A:A10. Como alternativa, se puede seleccionar el botn

Manual del usuario de PI DataLink

95

Complemento para Lotus 1-2-3

"celda", como se describe arriba. Esta opcin escribir el cdigo de macro asociado con {PITAGATT} a la direccin de la celda de salida de macros. Observe cmo la direccin de la celda se utiliza en el cdigo de macro cuando se designa una direccin de celda en el cuadro de edicin de direccin del nombre de tag. El nombre de tag absoluto se utiliza al escribir un nombre de tag en el cuadro de edicin de nombre del tag. Si se utilizan la direccin de celda y un nombre de tag determinado, el nombre del tag tendr prioridad y aparecer en la macro resultante. 14. Si el usuario desea obtener datos de un servidor distinto del predeterminado, el nombre del servidor se introducir en el cuadro de edicin designado. No se requiere ninguna entrada en el cuadro de edicin Servidor PI, cuando se desea utilizar el servidor predeterminado.

15. Haga clic en Aceptar. PI DataLink escribir los descriptores del tag en las celdas A:B2..A:B6. Tambin escribir el cdigo de macro necesario que se utiliza para obtener los descriptores del tag en las celdas A:A10..A:A14. Desplace el cursor a la celda A:C2. 16. En el men PI, seleccione Valor actual...

96

Tutorial

17. En el segundo cuadro de edicin situado bajo el nombre del tag, introduzca manualmente la direccin de celda A:A2..A:A6 o haga clic en el botn situado junto al cuadro de edicin y seleccione A:A2..A:A6. 18. En el cuadro de edicin etiquetado "Salida de macros [opc]", observe cmo la direccin de celda A:A15 ya existe. sta es una funcin que pega automticamente el cdigo de macro bajo la entrada de cdigo de macro anterior hasta que el usuario ejecuta un cuadro de dilogo sin una direccin de celda en el cuadro de edicin "Salida de macros [opc]". 19. En la casilla de edicin Salida de datos, observe cmo la direccin predeterminada de la celda ya es A:C2. 20. Bajo la casilla de edicin Salida de datos, hay tres botones de exclusin mtua que describen la ubicacin de salida relativa de la marca de tiempo para la de los datos. Seleccione "Tiempo a la izquierda". 21. Haga clic en Aceptar y PI DataLink escribir los valores actuales en las celdas A:D2..A:D6 con sus marcas de tiempo asociadas en A:C2..A:C6. Adems, tenga en cuenta que el cdigo de macro asociado se escribe en las celdas A:A15..A:A19. 22. Desplace el cursor de celda a la celda A:E2. En el men PI, seleccione Atributos del tag... de nuevo. 23. En el segundo cuadro de edicin situado bajo el nombre del tag, introduzca manualmente la direccin de celda A:A2..A:A6 o haga clic en el botn situado junto al cuadro de edicin y seleccione A:A2..A:A6. 24. Seleccione "Unidades" en el cuadro de lista Atributos. 25. En el cuadro de edicin etiquetado "Salida de macros [opc]", introduzca la direccin de la celda A:A20. En la casilla de edicin Salida de datos, observe cmo la direccin predeterminada de la celda ya es A:E2.

Manual del usuario de PI DataLink

97

Complemento para Lotus 1-2-3

26. Haga clic en Aceptar y PI DataLink escribir las unidades en las celdas A:E2..A:E6 y el cdigo de macro asociado en las celdas A:A20..A:A24.

27. Desplace el cursor a la celda A:A10. En el men PI, seleccione Atributos del tag.... Fjese en que el cuadro de dilogo est rellenado completamente segn la informacin provista en la macro en A:A10. sta es una funcin de ahorro de tiempo que resulta til cuando ya existen cdigos de macros similares para la operacin deseada. 28. Pruebe a mover el cursor a la celda A:A15 y seleccione Valor actual... en el men PI. 29. Coloque el cursor en la celda A:A2. En el men PI, seleccione Valor actual.... Recuerde que el cuadro de dilogo detecta que hay un nombre de tag en la celda actual e intenta rellenar el cuadro de dilogo lo mximo posible. El nombre del tag se escribe en el cuadro de edicin de nombre del tag. Debido a que hay datos con marcas de tiempo directamente a la derecha del nombre del tag, el cuadro de dilogo escribe en el cuadro de edicin de celda de salida A:B2 con marcas de tiempo a la izquierda. 30. Pruebe a seleccionar los rangos de los nombres de tags y seleccione Valor actual... o Atributo del tag.... 31. Pruebe a seleccionar todo el rango A:A2..A:A6 y a abrir Valor actual... o el cuadro de dilogo Atributo del tag... desde la opcin de men PI.

98

Tutorial

32. Para actualizar la tabla creada en los pasos anteriores, coloque el cursor en la celda A:A10. Pulse las teclas ALT y F3 simultneamente. Se mostrar el cuadro de dilogo Ejecutar secuencias de comandos & Macros:

33. Haga clic en el botn de exclusin mtua Macro y, a continuacin, haga clic en Ejecutar o pulse la tecla Intro. Lotus 1-2-3 ejecuta los comandos de macro contenidos en las celdas de A:A10 a A:A24. Los comandos de macro y sus funciones se resumen a continuacin:
Cel da A10 A11 A12 A13 A14 A15 A16 A17 A18 A19 A20 A21 A22 A23 A24 Comando de macro {PITagAtt} {PITagAtt} {PITagAtt} {PITagAtt} {PITagAtt} {PICurrVal} {PICurrVal} {PICurrVal} {PICurrVal} {PICurrVal} {PITagAtt} {PITagAtt} {PITagAtt} {PITagAtt} {PITagAtt} Funcin Obtener un atributo del tag (descriptor) Obtener un atributo del tag (descriptor) Obtener un atributo del tag (descriptor) Obtener un atributo del tag (descriptor) Obtener un atributo del tag (descriptor) Obtener el valor actual Obtener el valor actual Obtener el valor actual Obtener el valor actual Obtener el valor actual Obtener un atributo del tag (unidades) Obtener un atributo del tag (unidades) Obtener un atributo del tag (unidades) Obtener un atributo del tag (unidades) Obtener un atributo del tag (unidades)

Manual del usuario de PI DataLink

99

Complemento para Lotus 1-2-3

Una vez que Lotus 1-2-3 ejecuta los comandos de macro, la celda B2 contiene el descriptor del tag (BA:ACTIVE.1), la celda D2 contiene el valor actual de BA:CONC.1, la celda C2 contiene el tiempo correspondiente y la celda E2 contiene las unidades de ingeniera. Los tags BA:LEVEL.1, BA:PHASE.1 y BA:TEMP.1 tienen datos similares en las celdas de B3 a E3, B4 a E4, B5 a E5 y B6 a E6, respectivamente. Observe cmo una comilla simple (o apstrofe) precede a muchos de los argumentos de los comandos de macro de A10 a A24. Esto se debe a que Lotus 1-2-3 utiliza una comilla simple para indicar una etiqueta o una cadena. Por ejemplo, el comando de macro de la celda A10 y sus argumentos son:
{PITagAtt c2,'descriptor,',d2} Una referencia para un nombre de tag (celda C2); Un atributo del tag (descriptor); Ningn servidor PI determinado (etiqueta en blanco o slo una comilla simple o un

apstrofe); y
Una celda que representa la celda de salida (celda D2).

En el comando de macro superior, hay un slo espacio entre el nombre de macro (PITagAtt) y el primer argumento de macro (c2). Adems, no hay espacios entre cada argumento de la macro y las comas sirven como separadores del argumento. Si no se especifica ningn servidor PI en el argumento PIServer ([Link]., en blanco o slo una comilla simple), PI DataLink obtendr informacin del tag PI desde el servidor predeterminado. ste es el servidor PI especificado en su archivo [Link], el cual se puede modificar mediante el cuadro de dilogo PI > Conexiones....

Valores reales del archivo de datos PI

En este ejemplo, recopilaremos datos de muestra para un solo tag. 1. Desplace el cursor a la celda A:C10. En el men PI, seleccione Bsqueda de tags. Aparecer entonces el cuadro de dilogo Bsqueda de tags. 2. Introduzca "CD" en el campo Mscara de tag de modo que se lea "cd*". Haga clic en Buscar para buscar tags que comiencen con CD. El tag "cdt158" debera ser uno de los tags devueltos. Seleccione este tag (o cualquier otro tag) y haga clic en Aceptar. El tag cdt158 se copiar a la celda A:C10 (la celda activa actual de la hoja de clculo). 3. Haga clic en la celda [Link] para activar la celda. Vuelva al men PI y seleccione Datos comprimidos (horas) ....

100

Men PI

4. Haga clic en el botn de referencia de celdas de nombre de tag "Celda" y seleccione la celda A:C10. Introduzca una t (para medianoche de hoy) en el campo Hora de inicio y +8h (desplazamiento de ocho horas) en el campo Hora de finalizacin. Marque la casilla de verificacin Mostrar horas. 5. Haga clic en Aceptar. PI DataLink recuperar los datos archivados a partir de medianoche hasta las 8:00 a.m. en el rango, A:C10..A:C18.

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 1-2-3 es seleccionando una opcin del 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
Cuando se aada PI DataLink a Lotus 1-2-3, se aadir el elemento del men de PI a la barra de men de 1-2-3.

Manual del usuario de PI DataLink

101

Complemento para Lotus 1-2-3

Se pueden acceder a las opciones del men desplegable siguiente desde este elemento de men:
Valor actual recupera el valor actual de un tag. Valor de archivo histrico recupera un nico valor del archivo histrico (se puede

interpolar).
Valor de tiempo exacto recupera un nico valor de una marca de tiempo determinada

del archivo histrico.

Valor calculado recupera un nico valor calculado (total, mnimo, mximo, rango,

desviacin estndar, promedio o media).

Atributos del tag recupera un atributo del tag. Datos de muestra recupera datos espaciados de forma uniforme (de muestra) del archivo

histrico.
Datos comprimidos (nmero) recupera datos comprimidos basados en una hora de

inicio y un nmero determinado de valores.

102

Cuadros de dilogo

Datos comprimidos (horas) recupera datos comprimidos basados en una hora de inicio y

una hora de finalizacin.

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

de tiempo.
Datas calculados recupera totales, mnima, mxima, rangos, desviaciones estndar,

promedios y medias para mltiples perodos de tiempo.

Datos de muestra filtrados recupera datos espaciados de forma uniforme (de muestra)

que satisfacen una condicin de filtro.

Datos comprimidos filtrados (nmero) recupera un nmero especfico de datos

comprimidos que cumplen una condicin de filtro.

Datos comprimidos filtrados (hora) recupera datos comprimidos que cumplen una

condicin de filtro de una hora de inicio y una hora de finalizacin.

Clculo de expresiones recupera datos de los clculos en las expresiones de tags. Filtrado de tiempo calcula el tiempo que una expresin de tag fue verdadera. Conexiones gestiona las conexiones del servidor PI. Bsqueda de tags busca los tags de los servidores PI conectados. 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
Las siguientes secciones describen la interaccin del usuario y la operacin con los cuadros de dilogo.

Campos de edicin
Hay dos tipos de campos de edicin en los cuadros de dilogo: campos de edicin de texto y campos de edicin de referencias. Una Celda (o Celdas) indica los campos de edicin de referencias situados junto al cuadro de edicin. La informacin solicitada se debe introducir en un campo de edicin de texto. Por ejemplo, en el campo Nombre del tag, escriba el nombre del tag del que desea obtener datos. No obstante, en un campo de edicin (Celda) de referencias, tiene que introducir una referencia a una celda de la hoja de clculo que contenga la informacin necesaria. En un

Manual del usuario de PI DataLink

103

Complemento para Lotus 1-2-3

campo de edicin de referencias matriciales, puede introducir una referencia a una matriz de celdas en la hoja de clculo. En cualquier caso, tambin puede utilizar el ratn para hacer clic en el botn Celda o Celdas que muestra el cuadro de dilogo de referencia de celdas. A continuacin, puede hacer clic en la celda (o hacer clic en la celda y arrastrarla a las celdas adyacentes) de la hoja de clculo. En este procedimiento, Lotus 1-2-3 introduce automticamente las referencias de celdas en el campo de edicin. Por ejemplo, en el cuadro de dilogo PICurrVal de la seccin de tutorial, 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. Muchos de los parmetros contienen un campo de edicin de texto y un campo de edicin de referencias. Si hay entradas en el campo de edicin de texto y en el campo de edicin de referencias, el campo de edicin de texto reemplazar la referencia de la celda o rango.

Campos opcionales
Los campos PIServer, Salida de macros y Salida de todos los cuadros de dilogo estn etiquetados como "opc" u opcionales. Si el campo de edicin de texto PIServer se deja en blanco, PI DataLink se conectar al servidor PI predeterminado. Puede modificar el servidor PI predeterminado en el cuadro de dilogo Conexin del men PI. El campo Salida de macros es un campo de edicin de referencias, que le permite especificar la esquina superior izquierda del rango en el que PI DataLink colocar el cdigo de macro que recupera sus datos. La macro resulta til cuando posteriormente se desea volver a ejecutar el comando para recuperar un nuevo conjunto de datos. El campo Salida le permite especificar la esquina superior izquierda del rango en el que PI DataLink colocar los datos resultantes. Si no especifica una celda Salida, este campo utiliza la celda activa de manera predeterminada en la hoja de clculo actual.

Visualizar datos en columnas o filas

Para los cuadros de dilogo que se espera que devuelvan una matriz de valores PI ([Link]., Datos de muestra), existe un grupo de botones de exclusin mtua con las opciones columna(s) o fila(s). Elija columna(s) para mostrar los datos en una columna (o dos columnas si tambin se muestran marcas de tiempo). Seleccione fila(s) para mostrar los datos en una o dos filas. 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

104

Cuadros de dilogo

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 Atributo en Atributos del tag... y para el campo Modo en los cuadros de dilogo Valor calculado... y Datos calculados.... El elemento predeterminado de estos cuadros de lista es el primer elemento de la lista. De este modo, el atributo del punto predeterminado que se recupera de Atributos del tag... es Descriptor y el modo de clculo predeterminado es Promedio.

Buscar tags en los cuadros de dilogo

El botn Bsqueda de tags de los cuadros de dilogo le permite buscar la base de datos PI de los tags. Desafortunadamente, la funcin que permite que se pegue el tag seleccionado en el cuadro de dilogo PI DataLink no funciona en PI DataLink para 1-2-3.

Rellenar automticamente los cuadros de dilogo

La posicin del cursor en la hoja de clculo al abrirse un cuadro de dilogo determinar cunto se va a rellenar el cuadro de dilogo. Si ya existe un cdigo de macros para un determinado cuadro de dilogo y el cursor se coloca sobre dicho cdigo de macros al abrirse el cuadro de dilogo, ste se rellenar completamente en base al cdigo de macros. Por ejemplo, en el caso de que el cursor se colocara sobre una celda que tuviera el cdigo de macros siguiente:
{PICALCVAL 'Sinusoid,'T,'*,'Average,1,0,'CASABA,A:B2}

Si se selecciona ahora Valor calculado... de la opcin de men PI, se muestra el cuadro de dilogo siguiente:

Manual del usuario de PI DataLink

105

Complemento para Lotus 1-2-3

Por tanto, puede realizar cambios menores en el cuadro de dilogo y ejecutar el mismo. El relleno automtico anterior de cuadros de dilogo no est disponible para el cuadro de dilogo Filtrado de tiempo... de PI DataLink 1.9. PI123DLG.123 intentar determinar cmo rellenar el cuadro de dilogo segn en dnde se coloca el cursor en una hoja de clculo con datos. Por ejemplo, si el cursor se coloca en un nombre de tag con dos marcas de tiempo reconocibles a la derecha del nombre del tag y un intervalo de tiempo a la derecha de las marcas de tiempo, PI123DLG.123 insertar correctamente la informacin de la hoja de clculo en el cuadro de dilogo. La siguiente hoja de clculo representa el escenario anterior:

106

Cuadros de dilogo

Cuando se abra el cuadro de dilogo Datos de muestra... con el rango A1...A4 seleccionado, el cuadro de dilogo Datos de muestra aparecer tal y como se muestra a continuacin:

Tenga en cuenta que la celda Salida de datos se supone que es la primera celda libre a la derecha de los datos de la hoja de clculo. En el caso anterior, la celda Salida de datos predeterminada es A:E1. Este escenario tambin funcionara si los datos de la hoja de clculo estuviesen debajo del nombre de tag de la columna A.

Manual del usuario de PI DataLink

107

Complemento para Lotus 1-2-3

Opcin Salida de macros

Cada cuadro de dilogo tiene la opcin Salida de macros. La opcin Salida de macros le permitir especificar en donde escribir las cadenas de macros asociadas a cada cuadro de dilogo. El cdigo de macro escrito en la direccin de la celda de salida designada se basar en la informacin dada en el cuadro de dilogo. Esta opcin resulta til cuando se crea una hoja de clculo que desea actualizar en el futuro. Despus de crear la hoja de clculo utilizando los cuadros de dilogo con la opcin de salida de macros, puede ejecutar el cdigo de macro creado para actualizar la hoja de clculo en vez de volver a abrir todos los cuadros de dilogo. PI123DLG.123 muestra el cdigo de macro de las celdas que se est escribiendo con el fin de rellenar automticamente la direccin de referencias Salida de macros al abrir un cuadro de dilogo. El mecanismo de seguimiento se invoca cuando introduce por primera vez una direccin de celda en el campo de edicin de referencias Salida de macros. Despus del cual, PI123DLG.123 supone que desea seguir escribiendo el cdigo en la siguiente fila disponible de la misma columna en la que escribi el cdigo de macro. El mecanismo de seguimiento se cancela cuando se ejecuta un cuadro de dilogo sin direccin de celda en el cuadro de dilogo Salida de macros, o se elimin la macro anterior generada en la hoja de clculo, o el usuario selecciona un archivo diferente. El mecanismo de seguimiento elimina la entrada de direccin de celda manual cuando se crean hojas de clculo que requieren las ejecuciones de varios cuadros de dilogo. El cdigo de macro se generar automticamente para que las actualizaciones posteriores de las hojas de clculo se puedan realizar con slo ejecutar las macros, en vez de tener que volver a abrir los cuadros de dilogo.

Tiempo en PI DataLink
Valores devueltos
Las marcas de tiempo devueltas por PI DataLink se encuentran en formato Lotus 1-2-3; es decir, es un nmero que representa el nmero de das desde 1900. Por ejemplo, 24-jul-00 [Link] a.m. se introduce en una celda como el nmero 36731,3. PI DataLink automticamente da formato de fecha y hora a estas marcas de tiempo; es decir, 24/07/2000 [Link] a.m. Para cambiar este formato de tiempo por otro, seleccione las celdas y utilice la funcin Formato... de la opcin Rango de la barra de mens. Para obtener ms informacin, consulte la documentacin de su Lotus 1-2-3.

108

Tiempo en PI DataLink

Argumentos de tiempo en comandos de macro

Muchos de los comandos de macro solicitan una hora de inicio y una hora de finalizacin. Para estos argumentos, puede introducir la cadena de tiempo como un argumento o hacer referencia a las celdas que contienen un tiempo PI en formato de cadena o las celdas que contienen un tiempo en formato de valor Lotus 1-2-3. Recuerde que para la hora PI en el formato de tiempo relativo ([Link]., '-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. Para obtener ejemplos de cadenas de tiempo PI vlidas, consulte Ejemplos de cadenas de tiempo PI (en la pgina 153). Ponga entre parntesis la cadena de tiempo, si su cadena de tiempo es una marca de tiempo absoluta; [Link]., utilice '(24-jun-00 13:38) para representar las 13:38 del 24 de junio de 2000.

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 seleccion 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.

Botones de exclusin mtua: Sin marca de tiempo/Tiempo a la izquierda/Tiempo en la parte superior

Algunos de los cuadros de dilogo que devuelven un solo valor (por ejemplo, Valor actual) tienen un conjunto de botones de exclusin mtua que permiten elegir:
sin marca de tiempo tiempo a la izquierda tiempo en la parte superior

Manual del usuario de PI DataLink

109

Complemento para Lotus 1-2-3

Elija tiempo a la izquierda si desea que PI DataLink muestre una marca de tiempo en una celda a la izquierda de los valores recuperados. Elija tiempo en la parte superior si desea mostrar la marca de tiempo en una celda en la parte superior de los valores recuperados. No obstante, si utiliza una referencia matricial en el campo Nombre de tag y selecciona el botn de exclusin mtua tiempo a la izquierda o tiempo en la parte superior, PI DataLink devolver la marca de tiempo y el valor segn si la referencia de los nombres de tag es horizontal o vertical. Especficamente, cuando los nombres de tag estn en una nica columna, las marcas de tiempo aparecern a la izquierda de los valores. Asimismo, cuando los nombres de tag estn en una sola fila, las marcas de tiempo aparecern en la parte superior de los valores.

Comandos de macro personalizados de PI DataLink

Macro y cuadro de dilogo
Cuando un cuadro de dilogo PI DataLink transfiere datos del servidor PI a Lotus 1-2-3, primero genera el comando de macro personalizado PI y despus ejecuta la macro para colocar los datos en la celda de salida. Puede obtener el mismo resultado introduciendo la macro y ejecutndola manualmente. Sin embargo, es mucho ms sencillo generar la cadena de macro con los cuadros de dilogo, especialmente para funciones con opciones de salida complejas.

Informar sobre errores

PI DataLink est escrito en LotusScript y C++, y utiliza API de PI System y SDK de Lotus 1-2-3. Cuando se produce un error en el nivel PI API, PI DataLink muestra el error PI API en la celda. Por ejemplo, si intenta encontrar el valor actual para un tag que no existe, aparecer el mensaje "Tag no encontrado: -5" en la celda de salida.

Actualizar los datos PI en una hoja de clculo

Mientras PI DataLink transfiere datos a Lotus 1-2-3 mediante los comandos de macros personalizados, la hoja de clculo no se actualiza automticamente. Cuando cambia una entrada de celda en la hoja de clculo, debe volver a ejecutar los comandos de macro que hacen referencia a la celda modificada para que su hoja de clculo muestre los nuevos valores. Tambin debe volver a ejecutar los comandos de macro que contienen marcas de tiempo relativas. Adems, tendr que volver a ejecutar la macro {PICurrVal} cada vez que desee el valor actual de un tag.

110

Detalles del cuadro de dilogo y la macro personalizada PI

Por ejemplo, el comando

{PIArcVal a1,'t+8h,1,',d1}

recupera un valor del archivo histrico para el tag situado en la celda A1 a las 8:00 a.m. del da actual. Debe volver a ejecutar esta macro cuando (1) cambie el contenido de la celda A1 y (2) cuando evoque la hoja de clculo por primera vez cada da ya que t+8h es una marca de tiempo relativa.

Detalles del cuadro de dilogo y la macro personalizada PI

Las siguientes secciones describen cada una de las funciones PI DataLink con ms detalle. Cada seccin describe primero el cuadro de dilogo y, a continuacin, explica cada uno de los argumentos de la funcin de macro PI correspondiente.

Cuadro de dilogo Valor actual

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

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

{PICurrVal}
{PICurrVal tagname, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) outcode (entero) PIServer (cadena) outcell (referencia) Explicacin El tag para el cual desea el valor snapshot (actual). Un cdigo de salida; 0, 1 o 2. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Manual del usuario de PI DataLink

111

Complemento para Lotus 1-2-3

Devoluciones
Cdigo de salida 0 1 Columna 1 Valor actual Marcas de tiempo Valor actual Columna 2

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

Ejemplo
Para obtener el valor actual de cdf144 desde el servidor PI MYVAX y colocar el resultado en la celda A5:
{PICurrVal 'cdf144,0,'myvax,A5}

Cuadro de dilogo Valor de archivo histrico

Este cuadro de dilogo obtiene un valor a una hora especificada. El resultado es un valor interpolado, excepto para los 4 tags de cdigo de resolucin del servidor PI 2. En este caso, el valor se devuelve en el momento o antes de la hora especificada.

Campos obligatorios
Nombre de tag. La referencia a un nombre de tag puede ser una matriz. Marca de tiempo

{PIArcVal}
{PIArcVal tagname, timestamp, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) time stamp (cadena) outcode (entero) PIServer (cadena) outcell (referencia) Explicacin El tag para el cual desea el valor de archivo histrico. La marca de tiempo PI. Un cdigo de salida; 0, 1 o 2. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

112

Detalles del cuadro de dilogo y la macro personalizada PI

Devoluciones
Cdigo de salida 0 1 Columna 1 Valor de archivo histrico Marca de tiempo Valor de archivo histrico Columna 2

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

Ejemplo
Para obtener el valor de archivo histrico desde el servidor PI PHOEBE para el tag sinusoid a medianoche de ayer y colocar el resultado en un rango de salida cuya esquina superior izquierda es la celda A5:
{PIArcVal 'sinusoid,'y,0,'phoebe,A5}

Cuadro de dilogo Valor de tiempo exacto

Este cuadro de dilogo obtiene un valor del servidor PI en una hora especificada, si existe una entrada en el archivo histrico en ese momento. Si no existe ningn valor, se devuelve el mensaje "Sin entrada de archivo histrico en el tiempo dado".

Campos obligatorios
Nombre de tag. La referencia a un nombre de tag puede ser una matriz. Marca de tiempo

{PIExTimeVal}
{PIExTimeVal tagname, timestamp, PIServer, outcell}

Argumentos
Argumento tagname (cadena) time stamp (cadena) PIServer (cadena) Explicacin El tag para el cual desea el valor de archivo histrico. La marca de tiempo PI. El servidor PI.

Manual del usuario de PI DataLink

113

Complemento para Lotus 1-2-3

Argumento outcell (referencia)

Explicacin Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Devoluciones Si existe, un valor del servidor PI. Si no existe ningn valor, se devuelve el mensaje "Sin entrada de archivo histrico en el tiempo dado".

Ejemplo
Para obtener el valor de archivo histrico desde el servidor PI PHOEBE para el tag sinusoid exactamente a la medianoche de ayer y colocar el resultado en un rango de salida cuya esquina superior izquierda es la celda A5:
{PIExTimeVal 'sinusoid,'y,'phoebe,A5}

Cuadro de dilogo Valor calculado

Este cuadro de dilogo devuelve un nico valor calculado de un rango de valores archivados de un tag. Los modos de clculo son
Total (tiempo ponderado) Mnimo Mximo Desviacin estndar (tiempo ponderado) Rango Promedio (tiempo ponderado) Media (tiempo no ponderado)

Campos obligatorios
Nombre de tag. La referencia a un nombre de tag puede ser una matriz. Hora de inicio Hora de finalizacin Factor de conversin

114

Detalles del cuadro de dilogo y la macro personalizada PI

Modo de clculo

Casilla de verificacin
Seleccione mostrar pctgood si desea que PI DataLink muestre el porcentaje del rango de tiempo que contena valores correctos. Le recomendamos que siempre se fije en el valor de porcentaje correcto antes de utilizar el resultado del clculo. El valor de porcentaje correcto se suele devolver a la derecha de la celda de valor calculado. Si se selecciona el botn tiempo en la parte superior, el valor de porcentaje correcto se devuelve a la celda debajo de la de valor calculado. Las marcas de tiempo se devuelven cuando el modo de clculo es mnimo, mximo o rango.
Modo Mnimo Mximo Rango Columna 1 Tiempo del valor mn. Tiempo del valor mx. Tiempo del valor mn. Columna 2 Valor mnimo Valor mximo Tiempo del valor mx. Valor de rango Columna 3

Notas especiales
Cuando el modo de clculo es Total y parte de los datos archivados en el rango son incorrectos, el valor informado es igual al valor total calculado dividido por la fraccin del perodo de tiempo con datos archivados correctos. Esta normalizacin de datos es equivalente a la suposicin de que para un rango de tiempo de datos incorrecto el valor del tag utiliza el valor promedio de todo el rango. Sin embargo, esta suposicin puede no ser vlida cuando una amplia fraccin del rango temporal contiene datos incorrectos. Por ello, le recomendamos que siempre se fije en el valor de porcentaje correcto antes de utilizar el resultado del clculo. El factor de conversin se utiliza ms a menudo cuando el modo de clculo es Total y la unidad de tiempo del tag PI que se totaliza no es la misma que la predeterminada del servidor. Por ejemplo, la unidad de tiempo del servidor predeterminado es unidades/da, mientras que la del tag PI que se totaliza es unidades/hora, de modo que utiliza el factor de conversin de 24. Para el servidor PI 2 con velocidad predeterminada de unidades por hora, utilice los siguientes factores de conversin:
0,041667 para unidades/da 1 para unidades/hora 60 para unidades/minuto 3.600 para unidades/segundo

Manual del usuario de PI DataLink

115

Complemento para Lotus 1-2-3

{PICalcVal}
{PICalcVal tagname, stime, etime, mode, cfactor, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) mode (cadena) cfactor (nmero) Explicacin El tag para el cual desea el valor calculado. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio o media). Debe ser 1 para mx, mn, promedio, desviacin estndar y rango. Para obtener el total, consulte las notas especiales anteriores. Un cdigo de salida; de 0 a 7 excepto 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

outcode (entero) PIServer (cadena) outcell (referencia)

Devoluciones Si el cdigo de salida es 0, slo se devuelve el valor calculado. Si el cdigo de salida es 1, se aplica lo siguiente:
Modo Total Mnimo Mximo Stdev Rango Promedio Media Columna 1 Valor total Tiempo del valor mn. Tiempo del valor mx. Valor de desviacin estndar Tiempo del valor mn. Valor de promedio Valor de media Tiempo del valor mx. Valor de rango Valor mnimo Valor mximo Columna 2 Columna 3

Un cdigo de salida 2 transpone la matriz de salida que resulta de un cdigo de salida 1; [Link]., los resultados se devuelven en filas en vez de en columnas. El cdigo de salida 3 no se utiliza. Si el cdigo de salida es 4, el porcentaje correcto se devuelve a la derecha de la celda de valor.

116

Detalles del cuadro de dilogo y la macro personalizada PI

Si el cdigo de salida es 5, se aplica lo siguiente:

Modo Total Mnimo Mximo Stdev Rango Promedio Media Columna 1 Valor total Tiempo del valor mn. Tiempo del valor mx. Desviacin estndar Tiempo del valor mn. Valor de promedio Valor de media Columna 2 Porcentaje correcto Valor mnimo Valor mximo Porcentaje correcto Tiempo del valor mx. Porcentaje correcto Porcentaje correcto Valor de rango Porcentaje correcto Porcentaje correcto Porcentaje correcto Columna 3 Columna 4

Un cdigo de salida 6 transpone la matriz de salida que resulta de un cdigo de salida 4; [Link]., los resultados se devuelven en filas en vez de en columnas. Un cdigo de salida 7 transpone la matriz de salida que resulta de un cdigo de salida 5; [Link]., los resultados se devuelven en filas en vez de en columnas. Ejemplo Para obtener el tiempo y el valor mnimo (con un factor multiplicador 1) durante las 8 ltimas horas para el tag sqf100 desde el servidor PI predeterminado y colocar el resultado en un rango de salida cuya esquina superior izquierda sea la celda A5:
{PICalcVal 'sqf100,'*-8h,'*,'minimum,1,1,',A5}

Cuadro de dilogo Atributos del tag

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

Campos obligatorios
Nombre de tag. La referencia a un nombre de tag puede ser una matriz. Atributo del tag.

Elija un atributo del tag del cuadro de lista. El atributo predeterminado es descriptor. Los atributos del tag son:
Atributo descriptor Explicacin Descriptor de tag de 26 caracteres

Manual del usuario de PI DataLink

117

Complemento para Lotus 1-2-3

Atributo exdesc typicalvalue units zero span digstartcode dignumber pointtype pointsource location1 location2 location3 location4 location5 filtercode squareroot scan excdev excmin excmax archiving compressing res compdev compmin compmax totalcode convers displaydigits instrumenttag sourcept taglong tagshort

Explicacin Descriptor extendido de tag de 80 caracteres Valor tpico Cadena de unidades de ingeniera Cero Rango Cdigo para la primera cadena de estado digital del tag Nmero de estados digitales menos 1 Carcter de tipo de punto Carcter de origen de punto Parmetro de ubicacin 1 Parmetro de ubicacin 2 Parmetro de ubicacin 3 Parmetro de ubicacin 4 Parmetro de ubicacin 5 Cdigo de filtro Flag de raz cuadrada Flag de exploracin Desviacin por excepcin en porcentaje de rango Tiempo mnimo de excepcin en segundos Tiempo mximo de excepcin en segundos Flag de archivado histrico Flag de compresin Cdigo de resolucin Desviacin de compresin en porcentaje de rango Tiempo mnimo de compresin en segundos Tiempo mximo de compresin en segundos Cdigo de totalizacin Factor de conversin de puntos postprocesados Controla el formato de los valores numricos en pantallas PI basadas en terminales Nombre de tag para un valor en otro sistema, lo utilizan algunas interfaces Nombre de tag para la salida a otro sistema, lo utilizan algunas interfaces Nombre de tag largo (hasta 80 caracteres) Nombre de tag de 12 caracteres

118

Detalles del cuadro de dilogo y la macro personalizada PI

Atributo creator createdate changer changedate pointnumber pointid

Explicacin Creador del tag Fecha de creacin del tag Usuario que modific los atributos del tag Fecha de modificacin del tag Nmero de punto del tag Nmero de identificacin del punto interno

{PITagAtt}
{PITagAtt tagname, attribute, PIServer, outcell}

Argumentos
Argumento tagname (cadena) Attribute (cadena) PIServer (cadena) outcell (referencia) Explicacin El tag para el cual desea un atributo. El atributo del tag, consultar lista superior. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Devoluciones Atributo de tag Ejemplo Para obtener el descriptor del tag sinusoid desde el servidor PI predeterminado y colocar el resultado en la celda A5:
{PITagAtt 'sinusoid,'descriptor,',A5}

Cuadro de dilogo Datos de muestra

Este cuadro de dilogo recopila valores de muestra espaciados de forma uniforme desde el archivo histrico.

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

Manual del usuario de PI DataLink

119

Complemento para Lotus 1-2-3

Hora de inicio Hora de finalizacin Intervalo de tiempo

{PISampDat}
{PISampDat tagname, stime, etime, interval, outcode, PIServer, outcell}

Argumentos
Argumento Tagname (cadena) Stime (cadena) Etime (cadena) Interval (cadena) Outcode (entero) PIServer (cadena) Outcell (referencia) Explicacin El tag para el cual desea datos de muestra. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. Un cdigo de salida; 0, 1, 2 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos de muestra Marcas de tiempo Datos de muestra Columna 2

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 Para obtener datos de muestra del tag sinusoid en intervalos de tres horas desde la medianoche de ayer hasta la medianoche de hoy desde el servidor PI predeterminado y colocar el resultado en un rango de salida cuya esquina superior izquierda sea la celda A5:
{PISampDat 'sinusoid,'y,'t,'3h,1,',A5}

120

Detalles del cuadro de dilogo y la macro personalizada PI

Cuadro de dilogo Datos comprimidos (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.

Campos obligatorios
Nombre de tag Hora de inicio Nmero de puntos de datos

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.

Notas especiales
La funcin de este cuadro de dilogo slo devuelve el nmero real de puntos de datos archivados en el archivo histrico PI cuando este nmero es inferior que el nmero de valores solicitados. Por ejemplo, si desea recuperar 400 valores, desde la medianoche de hoy, y slo existen 356 valores en el archivo histrico, la funcin PINCompDat dejar en blanco las 44 celdas finales. {PINCompDat}
{PINCompDat tagname, stime, numvals, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) stime (cadena) Numvals (entero) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar los datos del archivo histrico que va hacia atrs desde la stime. Un cdigo de salida; 0, 1, 2 3. El servidor PI.

Outcode (entero) PIServer (cadena)

Manual del usuario de PI DataLink

121

Complemento para Lotus 1-2-3

Argumento Outcell (referencia)

Explicacin Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos comprimidos Marcas de tiempo Datos comprimidos Columna 2

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 10 puntos de datos comprimidos y marcas de tiempo correspondientes para el tag cdf144 desde la 1:00 de esta maana:
{PINCompDat 'cdf144,'(1:00),10,1,',A5}

Los resultados se colocan en un rango de salida cuya esquina superior izquierda es la celda A5.

Cuadro de dilogo Datos comprimidos (horas)

Este cuadro de dilogo devuelve valores comprimidos del servidor PI basndose en una hora de inicio y una hora de finalizacin. El nmero de puntos de datos recuperados para el perodo de tiempo dado se devuelve a la primera celda.

Campos obligatorios
Nombre de tag Hora de inicio Hora de finalizacin

122

Detalles del cuadro de dilogo y la macro personalizada PI

Notas especiales
La funcin de este cuadro de dilogo slo devuelve el nmero real de puntos de datos archivados al archivo histrico PI. Por ejemplo, si ayer ejecut la funcin PICompDat utilizando los argumentos 'y y 't para la hora de inicio y hora de finalizacin, y recuper 100 valores. Si hoy ejecuta la misma funcin, sta recuperar los valores entre la medianoche de ayer y la medianoche de hoy y, sin importar cuntos valores recupere, los mostrar tal cual. Si hoy slo hay 50 valores, los primeros 50 valores de ayer sern reemplazados por nuevos valores y los ltimos 50 valores de la llamada de funcin de ayer permanecern en la hoja de clculo. {PICompDat}
{PICompDat tagname, stime, etime, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) outcode (entero) PIServer (cadena) outcell (referencia) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. Un cdigo de salida; 0, 1, 2 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos comprimidos Marcas de tiempo Datos comprimidos Columna 2

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. El nmero de puntos de datos recuperados a partir del intervalo de tiempo dado se devuelve en la primera celda de la fila/columna. Ejemplo La siguiente frmula recupera los puntos de datos comprimidos y las marcas de tiempo correspondientes del tag cdf144 desde la 1:00 a las 3:00 de esta maana.

Manual del usuario de PI DataLink

123

Complemento para Lotus 1-2-3

{PICompDat 'cdf144,'(1:00),'(3:00),1,',A5}

Los resultados se colocan en un rango de salida cuya esquina superior izquierda es la celda A5.

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.

Campos obligatorios
Nombre de tag Marca de tiempo. El campo de marca de tiempo tiene que ser una referencia de una

matriz de tiempo. Las marcas de tiempo de esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes. {PITimeDat}
{PITimeDat tagname, timestamps, PIServer, outcell}

Argumentos
Argumento tagname (cadena) timestamps (referencia) Explicacin El tag para el cual desea los datos de muestra. Una referencia a una matriz de horas en formato PI. Los valores de esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

PIServer (cadena) outcell (referencia)

Devoluciones Datos de muestra. Si las marcas de tiempo estn en una sola columna, los datos se devuelven en una sola columna. Si las marcas de tiempo estn en una sola fila, los datos se devuelven en una sola fila.

124

Detalles del cuadro de dilogo y la macro personalizada PI

Ejemplo Para obtener datos de muestra de cdf144 desde el servidor PI predeterminado para las marcas de tiempo crecientes especificadas en las celdas de A5 a A25 y colocar el resultado en un rango de salida cuya esquina superior izquierda sea la celda B5:
{PITimeDat 'cdf144,A5..A25,',B5}

Cuadro de dilogo Datos calculados

Este cuadro de dilogo devuelve valores calculados espaciados de forma uniforme desde el archivo de datos PI. El modo de clculo puede ser total, mnimo, mximo, desviacin estndar, rango, promedio o media.

Campos obligatorios
Nombre de tag. La referencia a un nombre de tag puede ser una matriz. Hora de inicio Hora de finalizacin Intervalo de tiempo Factor de conversin Modo de clculo

Casilla de verificacin
Seleccione mostrar pctgood si desea que PI DataLink muestre el porcentaje del rango de tiempo que contiene valores correctos. Le recomendamos que siempre se fije en el valor de porcentaje correcto antes de utilizar el resultado del clculo. Los valores de porcentaje correctos se suelen devolver a la derecha de las celdas de valor calculado. Si tanto el botn fila como el botn mostrar hora estn seleccionados, los valores de porcentaje correctos se devuelven a las celdas situadas bajo las celdas de valor calculado.

Notas especiales
Consulte las notas en el cuadro de dilogo Valor calculado (consulte "Cuadro de dilogo Valor calculado" en la pgina 114).

Manual del usuario de PI DataLink

125

Complemento para Lotus 1-2-3

{PICalcDat}
{PICalcDat tagname, stime, etime, interval, mode, cfactor, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) mode (cadena) cfactor (nmero) Explicacin El tag para el cual desea los datos calculados. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. El modo de clculo (total, mnimo, mximo, desviacin estndar, rango, promedio o media). Un factor de conversin multiplicador. Debe ser 1 para mx, mn, promedio, desviacin estndar y rango. Consulte las notas especiales de cfactor en PIcalcVal() para los totales. Un cdigo de salida; de 0 a 7. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

outcode (entero) PIServer (cadena) outcell (referencia)

Devoluciones El cdigo de salida afecta a la salida de la forma siguiente:

Valores calculados en una columna Marcas de tiempo y valores en 2 columnas Valores calculados en una fila Marcas de tiempo y valores en 2 filas Valores y pctgood en 2 columnas Marcas de tiempo, valores y pctgood en 3 columnas Valores y pctgood en 2 filas Marcas de tiempo, valores y pctgood en 3 filas

126

Detalles del cuadro de dilogo y la macro personalizada PI

Ejemplo Para obtener marcas de tiempo y totales (con un factor multiplicador 24) en intervalos de una hora desde la medianoche de ayer hasta la medianoche de hoy para el tag cdf144 desde el servidor PI predeterminado y colocar el resultado en un rango de salida cuya esquina superior izquierda sea la celda A10:
{PICalcDat 'cdf144,'y,'t,'1h,'total,24,1,',A10}

Cuadro de dilogo Datos de muestra filtrados

Este cuadro de dilogo recopila valores de muestra espaciados de forma uniforme desde el archivo histrico cuando una expresin de filtro dada es verdadera. Si se selecciona la opcin Marcador, 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".

Campos obligatorios
Nombre de tag. La referencia a un nombre de tag puede ser una matriz. Hora de inicio Hora de finalizacin Intervalo de tiempo Expresin. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro,

consulte Sintaxis de expresiones (en la pgina 147).

Casillas de verificacin
Desactive la casilla Marcadores para suprimir la devolucin de un estado "Filtrado" en la celda del rango temporal, cuando los valores no satisfagan la condicin de filtro. {PISampFilDat}
{PISampFilDat tagname, stime, etime, interval, filtexp, filtcode, outcode, PIServer, outcell}

Manual del usuario de PI DataLink

127

Complemento para Lotus 1-2-3

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) Explicacin El tag para el cual desea datos de muestra. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida; 0, 1, 2 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

filtcode (entero) outcode (entero) PIServer (cadena) outcell (referencia)

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos de muestra Marcas de tiempo Datos de muestra Columna 2

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 Para obtener datos de muestra de sinusoid, cuando el tag cdep158 sea mayor que 80, en intervalos de tres horas desde la medianoche de ayer hasta la medianoche de hoy desde el servidor PI predeterminado y colocar el resultado en un rango de salida cuya esquina superior izquierda sea la celda A5:
{PISampFilDat 'sinusoid,'y,'t,'3h,'('cdep158'>80),1,1,',A5}

Cuadro de dilogo Datos comprimidos filtrados (nmero)

Este cuadro de dilogo devuelve un nmero determinado de valores comprimidos del servidor PI, mientras que una expresin de filtro dada es verdadera. Si se ha seleccionado la opcin Marcador, para cada grupo de valores que no satisfaga la expresin de filtro se devolver el estado "Filtrado".

128

Detalles del cuadro de dilogo y la macro personalizada PI

Campos obligatorios
Nombre de tag Hora de inicio Nmero de puntos de datos Expresin. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro,

consulte Sintaxis de expresiones (en la pgina 147).

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. Desactive la casilla Marcadores para suprimir la devolucin de un estado Filtrado en la celda del rango temporal cuyo valor no satisfaga la condicin de filtro.

Notas especiales
La funcin de este cuadro de dilogo slo devuelve el nmero real de puntos de datos archivados en el archivo histrico PI cuando este nmero es inferior que el nmero de valores solicitados. Por ejemplo, si desea recuperar 400 valores, desde la medianoche de hoy, y slo existen 356 valores en el archivo histrico, la funcin PINCompFilDat dejar en blanco las 44 celdas finales. {PINCompFilDat}
{PINCompFilDat tagname, stime, numvals, filtexp, filtcode, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) stime (cadena) numvals (entero) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar datos del archivo histrico que retrocede desde stime. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150).

filtexp (cadena)

Manual del usuario de PI DataLink

129

Complemento para Lotus 1-2-3

Argumento filtcode (entero) outcode (entero) PIServer (cadena) outcell (referencia)

Explicacin Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida; 0, 1, 2 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos comprimidos Marcas de tiempo Datos comprimidos Columna 2

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 10 puntos de datos comprimidos y las horas correspondientes, desde las 2:00 a.m., para el tag cdf144, mientras que el tag cdep158 es mayor que 80. El estado "Filtrado" se muestra en las ocasiones en las que la condicin de filtro es falsa. Los resultados se colocan en un rango de salida cuya esquina superior izquierda es la celda A5.
{PINCompFilDat 'cdf144,'(2:00),10,'('cdep158'>80),1,1,',A5}

Cuadro de dilogo Datos comprimidos filtrados (horas)

Este cuadro de dilogo devuelve valores comprimidos del servidor PI cuando la expresin de filtro dada es verdadera para la hora de inicio y la hora de finalizacin dadas. El nmero de puntos de datos recuperados para el perodo de tiempo dado se devuelve a la primera celda.

Campos obligatorios
Nombre de tag Hora de inicio Hora de finalizacin Expresin. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro,

consulte Sintaxis de expresiones (en la pgina 147).

130

Detalles del cuadro de dilogo y la macro personalizada PI

Casillas de verificacin
Desactive la casilla marcadores para suprimir la devolucin de un estado Filtrado en la celda del rango temporal cuyo valor no satisfaga la condicin de filtro.

Notas especiales
La funcin de este cuadro de dilogo slo devuelve el nmero real de puntos de datos archivados al archivo histrico PI. Por ejemplo, suponga que ayer ejecut la funcin PICompFilDat utilizando los argumentos 'y y 't para la hora de inicio y hora de finalizacin y recuper 100 valores. Si hoy ejecuta la misma funcin, sta recuperar los valores entre la medianoche de ayer y la medianoche de hoy. Si hoy slo hay 50 valores que satisfacen los criterios de filtro, los primeros 50 valores de ayer sern reemplazados por nuevos valores, mientras que los ltimos 50 valores de la llamada de funcin de ayer permanecern en la hoja de clculo. {PICompFilDat}
{PICompFilDat tagname, stime, etime, filtexp, filtcode, outcode, PIServer, outcell}

Argumentos
Argumento tagname (cadena) stime (cadena) etime (cadena) filtexp (cadena) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de las expresiones de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida; 0, 1, 2 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

filtcode (entero) outcode (entero) PIServer (cadena) outcell (referencia)

Manual del usuario de PI DataLink

131

Complemento para Lotus 1-2-3

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos comprimidos Marcas de tiempo Datos comprimidos Columna 2

Un cdigo de salida 2 transpone la matriz de salida resultante de un cdigo de salida 0 y un cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1. El nmero de puntos de datos recuperados a partir del intervalo de tiempo dado se devuelve en la primera celda de la fila/columna. Ejemplo La siguiente frmula recupera los puntos de datos comprimidos y las marcas de tiempo correspondientes, desde las 0:00 a.m. de ayer a las 0:00 a.m. de hoy, para el tag cdf144, mientras que el tag cdep158 sea mayor que 80. El estado "Filtrado" se muestra en las ocasiones en las que la condicin de filtro es falsa. Los resultados se colocan en un rango de salida cuya esquina superior izquierda es la celda A5:
{PICompFilDat'cdf144,'y,'t,'('cdep158'>80),1,1,',A5}

Cuadro de dilogo Clculo de expresiones

Este cuadro de dilogo realiza clculos, sobre un rango de tiempo espaciado de forma uniforme, en una expresin que contiene tags.

Campos obligatorios
Expresin. Para obtener ms informacin sobre la sintaxis de las expresiones, consulte

Sintaxis de expresiones (en la pgina 147).

Hora de inicio Hora de finalizacin Intervalo de tiempo

{PIExpDat}
{PIExpDat expression, stime, etime, interval, outcode, PIServer, outcell}

132

Detalles del cuadro de dilogo y la macro personalizada PI

Argumentos
Argumento Expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de las expresiones de clculo, consulte Sintaxis de expresiones (en la pgina 147). La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. Un cdigo de salida; 0, 1, 2 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

Stime (cadena) Etime (cadena) Interval (cadena) Outcode (entero) PIServer (cadena) Outcell (referencia)

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos calculados Marcas de tiempo Datos calculados Columna 2

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 Para calcular la suma de los valores de sinusoid y sqf100 en intervalos de una hora desde la medianoche de ayer hasta la medianoche de hoy desde el servidor PI predeterminado, y colocar las marcas de tiempo y los resultados en un rango de salida cuya esquina superior izquierda sea la celda A5:
{PIExpDat'('sinusoid'+'sqf100'),'y,'t,'1h,1,',A5}

Cuadro de dilogo Filtrado de tiempo

Este cuadro de dilogo devuelve la cantidad de tiempo para la que una expresin dada es verdadera en un rango temporal. El usuario puede especificar mltiples rangos temporales (intervalos espaciados de forma uniforme) como en el cuadro de dilogo Datos calculados.

Manual del usuario de PI DataLink

133

Complemento para Lotus 1-2-3

Campos obligatorios
Expresin. Para obtener ms informacin sobre la sintaxis de las expresiones, consulte

Sintaxis de expresiones (en la pgina 147).

Hora de inicio Hora de finalizacin Intervalo de tiempo Unidades de tiempo (predeterminadas a segundos)

{PITimeFilter}
{PITimeFilter expression, stime, etime, interval, timeunit, outcode, PIServer, outcell}

Argumentos
Argumento expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147). La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. La unidad de tiempo del resultado que se va a mostrar. Las entradas vlidas son: segundos, minutos, horas y das. Un cdigo de salida; 0, 1, 2 3. El servidor PI. Una celda que especifica la esquina superior izquierda del rango de salida que mantiene los resultados de este comando de macro.

stime (cadena) etime (cadena) Interval (cadena) Timeunit Outcode (entero) PIServer (cadena) Outcell (referencia)

Devoluciones
Cdigo de salida 0 1 Columna 1 Datos calculados Marcas de tiempo Datos calculados Columna 2

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.

134

Detalles del cuadro de dilogo y la macro personalizada PI

Ejemplo
{PITimeFilter($A$1,"y","t","1h","seconds",1,"thevax",E1}

La macro anterior calcula el tiempo en el que la expresin de la celda $A$1 es verdadera desde el servidor PI denominado THEVAX en intervalos de una hora, desde la medianoche de ayer hasta la medianoche de hoy, y coloca el resultado en las celdas E1 y E2 de las hojas activas. Tambin muestra las marcas de tiempo para la hora de inicio de cada intervalo de clculo. El resultado del clculo se expresa en segundos.

Cuadro de dilogo Conexiones

Este cuadro de dilogo administra sus conexiones con el servidor PI.

Mediante los botones inferiores, puede realizar las tareas siguientes:

Aadir: aade servidores PI adicionales a la lista. Editar: modifica los servidores PI existentes. Quitar: quita los servidores PI existentes. Establecer como predeterminado: define un servidor PI como el servidor PI

predeterminado. Puede utilizar los botones de la derecha para conectarse y desconectarse de los servidores PI de la lista. Despus de conectarse correctamente a un servidor PI, el campo Estado cambia a LECTURA o LECTURA/ESCRITURA. Para obtener informacin como el nombre/direccin del nodo del equipo local y el nombre/direccin del servidor PI, haga clic en el botn Informacin.

Manual del usuario de PI DataLink

135

Complemento para Lotus 1-2-3

Cuadro de dilogo Bsqueda de tags

Este cuadro de dilogo permite buscar tags desde los servidores PI y copiar los resultados a la hoja de clculo. Para copiar tags de la lista de resultados, primero debe seleccionar cada tag haciendo clic en el nombre del tag mientras mantiene presionada la tecla Ctrl. Para seleccionar un rango completo de tags, haga clic en el primer tag y despus presione la tecla MAYS y haga clic en la parte inferior del rango. Haga clic en Aceptar para copiar los nombres de tags a la hoja de clculo. Si la opcin "Copiar nombre de PIServer" del cuadro de dilogo Ajustes... est activada, el servidor PI de cada tag se copiar a la hoja de clculo junto con los nombres de tag. En el ejemplo citado a continuacin, se seleccionaron los tags 01:[Link], [Link], [Link], [Link] y [Link].

Los tags se copian en la hoja de clculo en una sola columna o en una sola fila, dependiendo de la opcin seleccionada en la seccin "Copiar elementos a la hoja" del cuadro de dilogo Ajustes... de PI DataLink. La posicin de la celda en donde se inicia el copiado es la celda actual. Si la opcin "Copiar nombre de PIServer" est activada, los nombres de los servidores se copiarn a una columna situada a la izquierda de los nombres de tag de la hoja clculo cuando se seleccione la opcin En una columna de la seccin "Copiar elementos a la hoja". Si se selecciona la opcin En una fila, los nombres de los servidores se copiarn debajo de los nombres de tag de la hoja de clculo.

Cuadro de dilogo Ajustes

Este cuadro de dilogo controla sus ajustes y preferencias de PI DataLink.

136

Escribir datos de Lotus 1-2-3 a PI

El conjunto de botones de exclusin mtua En una fila o En una columna determina si los tags seleccionados en el cuadro de dilogo TagSearch se copian a la hoja de clculo en una fila o en una columna. La casilla de verificacin de nombre Copiar nombre de PIServer facilita la opcin de copiar el nombre del servidor PI junto al nombre del tag cuando se utiliza el cuadro de dilogo TagSearch para llenar las celdas de una hoja de clculo. PI DataLink utiliza la casilla de verificacin Utilizar la zona horaria de PIServer para determinar si el usuario desea o no que DataLink interprete todas las marcas de tiempo basadas en la configuracin de la zona horaria del servidor PI. La casilla de verificacin Conectar con PIServer durante el inicio determina si PI DataLink se conecta inmediatamente al servidor PI predeterminado cuando se inicia Lotus 1-2-3.

Ayuda de PI DataLink
Esta opcin de men llama a la ayuda de PI DataLink.

Acerca de PI DataLink
Esta opcin de men muestra informacin de la versin PI DataLink.

Escribir datos de Lotus 1-2-3 a PI

PI DataLink permite escribir un valor de la hoja de clculo al archivo de datos PI. Los comandos de la macro PI DataLink que realizan estas tareas son PIPutVal y PIPutValX.

Manual del usuario de PI DataLink

137

Complemento para Lotus 1-2-3

PIPutVal soporta los tipos de puntos PI clsicos, mientras que PIPutValX soporta los tipos de puntos PI nuevos del servidor PI 3. Ambas funciones reemplazarn un evento existente en una marca de tiempo especfica. Consulte el archivo ...\PIPC\LOTUS\PIDL_input.123 para saber cmo utilizar estas macros.

{PIPutVal}
{PIPutVal tagname, value, time stamp, PIServer, outcell}

Argumentos
Argumento tagname (cadena) Value (referencia) time stamp (cadena) PIServer (cadena) Outcell (referencia) Explicacin El tag para el que se escribe el valor en PI. La referencia que se escribe de un valor. Puede ser una cadena (para estados digitales) o un nmero. Una marca de tiempo en formato de tiempo PI. El servidor PI. Una referencia a una celda en la que se muestra el valor devuelto de esta funcin de macros.

Devoluciones Si la funcin de la macro falla, se escribir un mensaje de error en la celda de salida. Si la funcin funciona correctamente, se escribirn el estado digital de la cadena enviado, el entero enviado o el valor real enviado en la celda exterior.
Nota: PIPutVal no comprueba si el nmero que se debe escribir est dentro del rango especificado por el usuario para un tag. El rango de un tag va de cero a cero + rango, en donde cero y rango son atributos de tag que especifica el usuario durante la creacin de puntos (tags). PI DataLink devolver el mensaje Valor escrito aunque se haya introducido un valor "Superior al rango" o "Inferior al rango" en el archivo de datos PI.

Nota: Esta funcin (PIPutVal) slo admite enteros, estados digitales y tipos de datos reales. No admite escribir datos de cadena en tags de cadena y no admite marcas de tiempo de subsegundos. Las marcas de tiempo se interpretan utilizando la informacin de la zona horaria del servidor.

138

Escribir datos de Lotus 1-2-3 a PI

Ejemplo La siguiente frmula coloca el valor situado en la celda A5 en el archivo de datos del servidor PI predeterminado a medianoche de hoy para el tag testtag. El estado devuelto se coloca en la celda A10.
{PIPutVal 'testtag,a5,'t,',a10}

{PIPutValX}
{PIPutValX tagname, value, time stamp, PIServer, outcell}

Argumentos
Argumento tagname (cadena) Value (referencia) time stamp (cadena) PIServer (cadena) Outcell (referencia) Explicacin El tag para el que se escribe el valor en PI. La referencia que se escribe de un valor. Puede ser una cadena (para estados digitales) o un nmero. Una marca de tiempo en formato de tiempo PI. El servidor PI. Una referencia a una celda en la que se muestra el valor devuelto de esta funcin de macros.

Devoluciones Si la funcin de la macro falla, se escribir un mensaje de error en la celda de salida. Si la funcin es correcta, el valor de cadena enviado se escribir en la celda exterior.
Nota: PIPutValX no comprueba si el nmero que se debe escribir est dentro del rango especificado por el usuario para un tag. El rango de un tag va de cero a cero + rango, en donde cero y rango son atributos del tag que especifica el usuario durante la creacin de puntos (tags). PI DataLink devolver el mensaje Valor escrito aunque se haya introducido un valor "Superior al rango" o "Inferior al rango" en el archivo de datos PI.

Nota: Esta funcin (PIPutValX) admite todo tipo de datos del servidor PI 3 (incluida la entrada de cadenas en tags de cadena), as como datos de los subsegundos. Las marcas de tiempo se interpretan utilizando informacin de la zona horaria del equipo cliente, a menos que la opcin "Utilizar la zona horaria del PIServer" est habilitada o se trate de un servidor PI 2.

Manual del usuario de PI DataLink

139

Complemento para Lotus 1-2-3

Ejemplo La siguiente frmula coloca el valor situado en la celda A5 en el archivo de datos del servidor PI predeterminado, a la medianoche de hoy para el tag testtag. El estado devuelto se coloca en la celda A10.
{PIPutValX 'testtag,a5,'t,',a10}

Limitaciones de PI DataLink para Lotus 1-2-3

PI DataLink est limitado a 65.536 marcas de tiempo y sus valores correspondientes para un nico comando de macro PI personalizado en Lotus 1-2-3. Esta limitacin significa que para un nico comando de macro PI personalizado, slo se pueden recuperar 65.536 valores a la vez. ste es el lmite para el nmero de filas de la hoja de clculo de Lotus 1-2-3.

140

Apndice A: Resolucin de problemas

Si est teniendo dificultades con PI DataLink, consulte las secciones inferiores.
El complemento de DataLink no se carga correctamente (en la pgina 141) Problemas de conexin informados en los archivos de registro (en la pgina 142) Lmites de Excel para PI DataLink (en la pgina 90) Limitaciones de PI DataLink para Lotus 1-2-3 (en la pgina 140)

Si sigue teniendo problemas despus de seguir estas sugerencias, consulte Soporte tcnico y recursos (en la pgina 159) para obtener detalles de la conexin al soporte tcnico.

El complemento de DataLink no se carga correctamente

Men PI no disponible en la barra de herramientas de Excel Se sabe que algunas secuencias VBA escritas por el usuario en las hojas de clculo (o complementos) de Excel restablecen el men principal de Excel. Si esto ocurre, el men PI desaparece aun cuando el complemento de PI DataLink siga cargado. Uno de los sntomas de este fenmeno es que las funciones matriciales PI DataLink embebidas siguen funcionando mientras que el propio men PI no est disponible. Reiniciar Excel suele corregir el problema. Funciones DataLink no disponibles mediante el men PI de Lotus 1-2-3: El archivo PI123DLG.123 contiene la mayora de los cuadros de dilogo de DataLink y debe cargarse para que los cuadros de dilogo de DataLink estn disponibles. Si puede ver el men PI pero no puede ver las funciones DataLink del men PI en 1-2-3, asegrese de que este archivo est en ...\lotus\123\auto y reinicie Lotus 1-2-3.

Manual del usuario de PI DataLink

141

Complemento para Lotus 1-2-3

Men PI no disponible en la barra de herramientas de Lotus 1-2-3 En el men principal de Lotus 1-2-3, vaya a: Archivo > Complementos > Administrar complementos... y verifique que PIDL.12A se muestre en la lista de complementos. Compruebe el espacio delante de la ruta de archivo de complementos y haga clic en Listo. Guarde los archivos en los que est trabajando y reinicie Lotus 1-2-3. Si el archivo PIDL.12A no aparece en la lista de complementos disponibles, compruebe si est disponible en el directorio ...\lotus\123\addins. Si es as, haga clic en la opcin Registrar... del cuadro de dilogo Administrar complementos, vaya al directorio \lotus\123\addins y haga doble clic en PIDL.12A. Si PIDL.12A no se encuentra en ...\lotus\123\addins, ejecute el programa de instalacin de PI DataLink de nuevo.

Problemas de conexin informados en los archivos de registro

En el servidor PI 3, se puede obtener informacin acerca de los intentos de conexin a travs de la utilidad PIGetMsg:
pigetmsg * * *-15m * "PInet*"

La utilidad anterior muestra todos los mensajes que comienzan por "PINet" desde hace 15 minutos hasta ahora. (Los mensajes de conexin PI DataLink deben comenzar por "PINet".) Para el servidor PI 2, los archivos de registro se ordenan de la manera siguiente:
UCX MultiNet PathWay TCPware PISysExe:[Link] PISysExe:[Link] PISysExe:[Link] PISysExe:[Link]

PI DataLink para Excel

En el equipo local, se puede obtener informacin acerca de los intentos de conexin a travs de la utilidad PIGetMsg:
pigetmsg * "[Link]" *-15m *

La utilidad anterior muestra todos los mensajes que produce [Link] desde hace 15 minutos hasta ahora. (Los mensajes de conexin PI DataLink deben proceder de [Link].)

Problemas de conexin informados en los archivos de registro

PI DataLink para Lotus 1-2-3

El archivo de registro para los intentos de conexin se encuentra en el equipo en C:\PIPC\DAT\[Link]. El procedimiento general para determinar la causa de la falta de conexin entre PI DataLink y el servidor PI es comprobar los archivos de registro en el equipo y en el servidor PI. Los siguientes son algunos sntomas comunes: Error de Gethostbyname en [Link] Este error de Gethostbyname indica que el equipo no puede traducir el nombre del servidor PI en una direccin TCP/IP. Una solucin de correccin rpida es aadir la direccin del servidor PI a la tabla de host local del equipo. Para Windows 98, la tabla de host se encuentra en C:\WINDOWS\hosts. Recuerde que Windows 98 incluye un archivo predeterminado C:\WINDOWS\[Link] y que Windows 98 suele ocultar las extensiones de los nombres de archivos. De este modo, puede creer que est editando hosts cuando, en realidad, est editando [Link]. Para Windows NT, 2000 y XP la tabla de host se encuentra en C:\WINNT\SYSTEM32\DRIVERS\ETC\hosts. Asegrese de hacer PING al equipo del servidor PI mediante el nombre para confirmar las comunicaciones entre el servidor PI y PI DataLink. El comando PING se puede ejecutar desde cualquier directorio en el smbolo del sistema. Tiempo de espera Connect() en [Link] El error de tiempo de espera connect() suele indicar que PI DataLink no puede conectarse al nmero de puerto especificado (545 5450) del equipo del servidor PI especificado. Para el servidor PI 2 1. Compruebe que el servicio del servidor PI se ha creado y habilitado en la mquina del servidor PI. 2. Compruebe el equipo que PI DataLink est intentando conectar al puerto 545. Para el servidor PI 3 Compruebe el equipo que PI DataLink est intentando conectar al puerto 5450.

Manual del usuario de PI DataLink

143

Complemento para Lotus 1-2-3

Tiempo de espera Select() en [Link] El error de tiempo de espera select() suele indicar que la mquina del servidor PI 2 no est traduciendo, lo suficientemente rpido, la direccin del equipo por un nombre. La solucin es aadir el nombre del equipo y la direccin TCP/IP en la tabla de host local de VAX/Alpha. Para obtener ms informacin, consulte la seccin anterior acerca de la traduccin de nombres. Tambin puede aumentar el parmetro de tiempo de espera de PI DataLink en el archivo C:\PIPC\DAT\[Link]:
[network] timeout=60

El parmetro anterior indica que PI DataLink debe esperar 60 segundos antes de que se supere el tiempo de espera mientras espera una respuesta del servidor PI. Si la seccin [network] anterior y la entrada de tiempo de espera no existen actualmente, deber crearlas. Recv: Error: 0 en [Link] La frmula recv:Error:0 suele indicar que PI DataLink se ha conectado correctamente al puerto 545/5450 del equipo del servidor PI, pero que no ha recibido una respuesta. 1. Asegrese de que el servidor PI efectivamente se est ejecutando en el equipo del servidor PI. 2. Para el servidor PI 2, confirme que el servicio del servidor PI est configurado correctamente. Para obtener ms informacin, consulte PIBuild:[Link]. Problemas de conexin TCP/IP 1. La versin de su servidor PI 2 no es compatible con TCP/IP. Debe disponer de PI 2.0.8+ (PI 2.0.7 para los servicios DEC TCP/IP para VMS). 2. El equipo no puede comunicarse con el servidor PI a travs de TCP/IP. Puede que haya un error en el hardware o enrutador asociado a su red. Ejecute un test ping entre el servidor y el equipo: \>ping mypiserver 3. En los sistemas Windows, compruebe la configuracin del protocolo de red (Inicio > Configuracin > Panel de control > Red) y confirme que TCP/IP est habilitado. 4. El servicio del servidor PI no se ha habilitado en el VAX/AlphaAXP. 5. Si su VAX/AlphaAXP est ejecutando los servicios DEC TCP/IP para VMS, asegrese de que el servicio auxiliar del servidor PI est habilitado actualmente: $ ucx show service PIServer. Habilite el servidor PI en caso necesario: $ ucx enable

Problemas de conexin informados en los archivos de registro

service PIServer. Si est ejecutando otro servicio TCP/IP (por ejemplo, TGV MultiNet) en el VAX/AlphaAXP, solicite a su administrador del sistema VMS que compruebe si el servidor auxiliar del servidor PI ha sido configurado. Las instrucciones se encuentran en PIBuild:[Link].

Manual del usuario de PI DataLink

145

Apndice B: Sintaxis de expresiones

Las expresiones PI se utilizan en las funciones PI DataLink que requieren el clculo de funciones matemticas, que incluyen tags PI. Las funciones que requieren que el usuario especifique una expresin PI vlida son: PIExpDat, PITimeFilter, PINCompFilDat, PICompFilDat y PISampFilDat. Las expresiones PI (tambin conocidas como Performance Equations) utilizadas en las funciones anteriores deben cumplir las reglas de sintaxis que se explican en las secciones Performance Equation de la Gua de aplicaciones del servidor PI o en el archivo de ayuda de Performance Equations de PI 3. Aqu se reproduce un breve esquema de estas reglas de sintaxis para mayor comodidad del usuario (aun as, para obtener una informacin ms detallada, el usuario deber consultar los manuales citados anteriormente).
Nota: Existen algunas diferencias en el clculo y las reglas de sintaxis de Performance Equation entre el servidor PI 2 y el PI 3. Estas diferencias pueden requerir que los usuarios editen expresiones separadas segn si el servidor PI al que se hace referencia es un servidor PI 2 o un PI 3.

Expresiones de clculo
A continuacin, se describe la sintaxis de las expresiones de clculo vlidas (utilizadas por PIExpDat) en PI DataLink.
Nota: Los ejemplos anteriores utilizan dos delimitadores de tags, dos puntos (:) y punto (.). Su PI System puede utilizar otros distintos.

En una expresin de clculo tag, los operadores matemticos y las funciones actan sobre los nombres de tags.

Operadores matemticos
Los operadores matemticos son:

Manual del usuario de PI DataLink

147

Complemento para Lotus 1-2-3

+ * / ^

suma resta multiplicacin divisin elevacin a una potencia

Ejemplo
(('sinusoid')^3 + 'cdf144'/10)

La expresin anterior determina la suma del valor de sinusoid al cubo y el valor de cdf144 dividido por 10.

Funciones matemticas
Las funciones matemticas admitidas son:
abs atn cos exp int log sgn

valor absoluto tangente del arco (ngulo devuelto en radianes) coseno (argumento en radianes) e (2.71828...) elevado a una potencia parte entera de un nmero logaritmo natural funcin del signo (-1 si el argumento es negativo, 0 si es cero, 1 si es seno (argumento en radianes) funcin de raz cuadrada tangente (argumento en radianes)

positivo)
sin sqr tan

Ejemplo
(log('cdep158') - cos('cdep158'))

La expresin anterior encuentra la diferencia entre el logaritmo natural del valor del tag cdep158 y el coseno del valor del tag cdep158.

Expresiones de clculo

Funciones de Performance Equations

Si la versin de su servidor PI 2 es 2.0.9 o superior, o si utiliza un servidor PI 3, tambin puede evaluar las expresiones que contengan funciones de Performance Equation actuales. Algunas funciones tiles son:
BadVal() StateNo() TagBad() NextVal() PctGood() PrevVal() TimeEq() TimeGE() TimeGT() TimeLE() TimeLT() TimeNE()

Ejemplo
PctGood('cdep158', 'y', 't')

La funcin PctGood encuentra el porcentaje de tiempo, sobre un rango dado, cuando los valores archivados de un tag son correctos. En el ejemplo anterior, el porcentaje de tiempo, entre la medianoche de ayer y la medianoche de hoy, cuando el tag est recibiendo valores "correctos", ser devuelto. Palabra clave Curtime Puede consultar la marca de tiempo del clculo utilizando la palabra clave curtime explcitamente en la expresin. Por ejemplo, especifique 20-Oct-97 como Hora de inicio, 21-Oct-97 como Hora de finalizacin, 12h como Intervalo de tiempo y la siguiente expresin en la funcin PI PIExpDat:
(curtime - `20-Oct-97')/1s

Manual del usuario de PI DataLink

149

Complemento para Lotus 1-2-3

Se devolvern tres conjuntos de datos de la siguiente manera:

20-Oct-97 [Link] 20-Oct-97 [Link] 21-Oct-97 [Link]

Para obtener ms informacin acerca de las funciones de Performance Equation, consulte la Gua de aplicaciones del servidor PI o el archivo de ayuda de Performance Equations de PI 3. Recuerde tambin que la sintaxis PE del servidor PI 3 difiere ligeramente de la del servidor PI 2.

Expresiones de filtro
A continuacin se describe la sintaxis de las expresiones de filtro vlidas en PI DataLink.
Nota: Los ejemplos citados abajo utilizan los delimitadores de tags : (dos puntos) y . (punto). Su PI System puede utilizar otros distintos.

Operadores relacionales
Una expresin de filtro utiliza los mismos operadores y funciones aritmticos que una expresin de clculo. Adems, son necesarios uno o ms operadores relacionales. Los operadores relacionales son:
< = > <= <> >=

menor que igual que mayor que menor o igual que no igual que mayor o igual que

Ejemplo
(abs('my:tag') >= 14.65)

La expresin anterior se evala como VERDADERA (distinta de cero) si el valor absoluto del tag mytag es al menos 14.65. Cuando compare tags digitales, utilice el valor negativo del nmero de cdigo de estado digital. Para PI 2.0.9 o superior, utilice la propia cadena de estado digital. Por ejemplo:
('my:tag' = "Manual")

Expresiones de filtro

Operadores lgicos
Una expresin de filtro tambin puede contar con operadores lgicos como:
y devuelve VERDADERO si ambos argumentos son VERDADEROS. o devuelve VERDADERO si al menos uno de sus argumentos es VERDADERO. no devuelve VERDADERO si sus argumentos son FALSOS y viceversa.

Ejemplo La siguiente expresin se evala como VERDADERA si el valor del tag sinusoid es menor que 45 y la raz cuadrada del valor del tag vdf1002 es mayor que 2:
('sinusoid' < 45 y sqr('vd:f1002') > 2)

Manual del usuario de PI DataLink

151

Apndice C: Ejemplos de cadenas de tiempo PI

Hora de inicio y de finalizacin

En los ejemplos siguientes, omita la comilla a la izquierda si va a introducir la cadena de tiempo PI en un campo de edicin de texto de un cuadro de dilogo Excel. Si est utilizando el complemento para Lotus 1-2-3, deber delimitar el argumento de la cadena de tiempo PI entre parntesis. Por ejemplo:
{PIArcVal 'sinusoid,'(25-dic-92 14:23),1,',A5}
Cadena de tiempo PI '06-dic-91 [Link] '* '25 '25-ago-92 '8: '25 8: 't 'y 'sun, mon, tue, wed, thu, fri, sat '*-1h 't+8h 'y-8h 'mon+14.5h 'sat-1m Significado [Link] del 6 de diciembre de 1991 Hora actual (ahora) [Link] (medianoche) del da 25 del mes actual [Link] (medianoche) del 25 de agosto de 1992 [Link] de la fecha actual [Link] del da 25 del mes actual [Link] de la fecha actual (hoy) [Link] de la fecha anterior (ayer) [Link] del domingo, lunes,... sbado ms reciente. Hace una hora [Link] a.m. de hoy [Link] de antes de ayer. [Link] del ltimo lunes [Link] del ltimo viernes

Manual del usuario de PI DataLink

153

Complemento para Lotus 1-2-3

Intervalo de tiempo
En los ejemplos siguientes, omita la comilla a la izquierda si va a introducir una cadena de tiempo PI directamente en un campo de edicin de texto de un cuadro de dilogo Excel.
Cadena de tiempo PI '1.5h '32m '49s `+5h `-5h Significado Una hora y media. Treinta y dos minutos. Cuarenta y nueve segundos. Cinco horas fijando la hora de inicio. Cinco horas fijando la hora de finalizacin.

Nota: Un intervalo positivo significa fijar la hora de inicio y un intervalo negativo significa fijar la hora de finalizacin. Si no se utilizan signos de ms o menos, el intervalo se considera positivo. De modo que si la hora de inicio es "y", la hora de finalizacin es "t" y el intervalo es "+5h" para la funcin Datos de muestra, entonces los valores interpolados se generan en y, y+5h, y+10h, y+15h, y+20h. Si, en su lugar, el intervalo es "-5h", entonces los valores interpolados se generan en y+4h, y+9h, y+14h, y+19h, t.

Apndice D: Argumentos de [Link]

Instalaciones silenciosas
Para instalaciones silenciosas, utilice el [Link] incluido en el kit de distribucin de DataLink. Realice las especificaciones especficas del sitio que sean necesarias. Los argumentos de [Link] se describen ms detalladamente en las secciones de los argumentos [Link] de PI SDK y de los argumentos [Link] de PI DataLink. Para utilizar el INI de forma silenciosa, escriba:
[Link] -f [Link]

Instalacin de PI SDK
Hay unos pocos argumentos que se pueden aadir como argumentos a la lnea de comandos para instalar el SDK silenciosamente. Para hacer que funcione cualquiera de los argumentos, la lnea de comandos debe contener /qn. Todos los argumentos deben separarse por un espacio. La siguiente expresin es un ejemplo del aspecto que el [Link] debe tener:
[COMMANDLINE] 5 = /qn PI_SERVER=localhost
Argumento /qn PI_SERVER PI _ALIAS PI_PORT PI_TYPE PI_USER INSTALLDIR PIBUF_ENABL E ALLUSERS Significado Instalar silenciosamente Nombre del servidor PI predeterminado Nombre de alias del servidor PI predeterminado Puerto predeterminado del servidor PI predeterminado Tipo de servidor del servidor PI predeterminado (2 3) Usuario predeterminado del servidor PI predeterminado Ruta de instalacin Habilita/deshabilita el almacenamiento Instalaciones de todos los usuarios del equipo

Manual del usuario de PI DataLink

155

Complemento para Lotus 1-2-3

Instalacin de PI DataLink
Hay unos pocos argumentos que se pueden aadir como argumentos a la lnea de comandos para instalar el PI DataLink. Todos los argumentos deben separarse por un espacio. La siguiente expresin es un ejemplo del aspecto que el [Link] debe tener:
[COMMANDLINE] 6 = /q SHARED=P:\APPS
Argumento /q SHARED ALLUSERS Significado Instalar silenciosamente Nombre de ruta de la instalacin de red Instalaciones de todos los usuarios del equipo

Apndice E: Cdigos de salida

El cdigo de salida es la representacin decimal de los bits binarios. Los bits son los siguientes:
bit 1: Mostrar marcas de tiempo bit 2: Orientacin (columnas/filas) bit 3: Mostrar porcentaje correcto bit 4: Ocultar cuenta bit 5: Mostrar estado extendido bit 6: Mostrar anotaciones bit 7: Mostrar hora de inicio bit 8: Mostrar hora de finalizacin bit 9: Mostrar tiempo mn/mx

La frmula para calcular el cdigo de salida correspondiente es:

2
i

xi 1

(where i is the bit number for each bit that is set)

Nota: No todos los cdigos de salida son vlidos para cada funcin porque no todas las opciones estn disponibles para cada funcin.

Ejemplo Supongamos que necesitamos la funcin Datos calculados para mostrar el Porcentaje correcto, la Hora de inicio y la Hora mn/mx. Al mostrarse la Hora de inicio y la Hora mn/mx, tambin tendremos que establecer el bit Mostrar marcas de tiempo.

Manual del usuario de PI DataLink

157

Complemento para Lotus 1-2-3

bits set = { Show Timestamps, Show Pct Good, Show Start Time, Show Min/Max Time } = {1, 3, 7, 9 } outcode =

2
i 0

xi 1

= 211 + 2 31 + 2 7 1 + 2 91

= 2 + 2 2 + 2 6 + 28 = 1 + 4 + 64 + 256 = 325

De este modo, la funcin mostrada en Excel se parecer a:

=PICalcDat("sinusoid","y","t","1h","minimum", 1, 325,"piserver")

158

Apndice F: Soporte tcnico y recursos

Opciones del soporte tcnico

OSIsoft proporciona soporte tcnico dedicado en mbito internacional, 24 horas al da, 7 das a la semana. Puede leer toda la informacin acerca de las opciones de soporte tcnico y acceder a los siguientes recursos en el sitio web Soporte Tcnico OSIsoft: [Link] ([Link] OSIsoft proporciona las opciones y recursos siguientes.

Asistencia y soporte telefnico

El soporte telefnico est disponible 24 horas al da, 7 das a la semana. Es posible que el servicio directo no sea posible en algunos lugares y durante determinadas horas; en este caso, deje un mensaje y le devolveremos la llamada en 15 minutos.
[Link]. y Canad: (510) 297-5828 Fuera de Amrica del Norte: +01 510-297-5828 FAX: (510) 352-2349

Soporte por correo electrnico

Enve sus preguntas, con la descripcin del problema y los registros de mensajes, a la direccin del soporte tcnico techsupport@[Link] ([Link] Recibir una respuesta en 24 horas.

Manual del usuario de PI DataLink

159

Complemento para Lotus 1-2-3

Soporte tcnico en lnea personalizado

El Centro de llamadas en lnea le permite realizar una llamada de soporte, que ser contestada en 24 horas. Tambin le permite revisar la informacin de sus llamadas de soporte previas. Elija Mi soporte> Mis llamadas (soporte en lnea) en el sitio web Soporte tcnico. El men Mi soporte le permite revisar Mis productos, Mi historial de descargas y los Trminos SRP, que abarcan los acuerdos de servicio del Service Reliance Program (SRP).

Centro de conocimiento
El Centro de conocimiento proporciona una biblioteca de bsqueda de documentacin y datos tcnicos, as como una recopilacin especial de recursos para los administradores del sistema. Para obtener estas opciones, haga clic en el Centro de conocimiento del sitio Web Soporte tcnico.
La funcin Buscar permite encontrar soluciones de soporte, noticias, pginas de soporte

tcnico, problemas conocidos, mejoras y documentacin (que incluyen manuales del usuario, notas de la versin y notas del producto).
Los recursos del administrador del sistema incluyen herramientas e instrucciones que le

ayudan a tratar: el tamao de los archivos histricos, las copias de seguridad de las secuencias de comandos, el mantenimiento diario, la configuracin de horario de verano, la seguridad del servidor PI, el tamao y la configuracin del PI System, los PI Trusts de los nodos de interfaz y mucho ms.

Acceso al servidor remoto

Los ingenieros del soporte tcnico pueden acceder remotamente a su servidor PI para proporcionar diagnsticos, resolucin de problemas prcticos y asistencia. Elija Contactarnos > Opciones de acceso remoto en el sitio Web Soporte tcnico.

Soporte tcnico en lnea

OSIsoft proporciona servicio in situ segn los contratos de nivel de servicio de SRP. Para ver el estado actual de SRP, vaya a Mi soporte > Trminos SRP en el sitio Web Soporte tcnico.

Antes de llamar o escribir solicitando ayuda

Cuando se ponga en contacto con el Soporte tcnico OSIsoft, deber facilitar:

160

Antes de llamar o escribir solicitando ayuda

El nombre del producto, los nmeros de versin y/o compilacin La plataforma del equipo (tipo de CPU, sistema operativo y nmero de versin) La hora en la que se inici la dificultad Los registros de mensajes en ese momento

Encontrar los nmeros de versin y compilacin

Para encontrar los nmeros de versin y compilacin de cada subsistema de PI System (que varan segn las mejoras, actualizaciones o revisiones instaladas) utilice uno de los mtodos siguientes:
Si ha instalado las Herramientas de administracin del PI System (PI SMT), elija Inicio >

Programas > PI System > Herramientas de administracin del PI System. En PI SMT, seleccione el nombre del servidor y, a continuacin, bajo Complementos de administracin del sistema, abra Operacin > Versin PI. El rbol Versin PI muestra todas las versiones.
Si no ha instalado PI SMT, abra un smbolo del sistema, cambie al directorio pi\adm e

introduzca piversion -v. Para ver los nmeros de las versiones individuales de cada subsistema, cambie al directorio pi\bin e introduzca el nombre del subsistema seguido de la opcin -v (por ejemplo, [Link] -v).

Ver informacin de la plataforma del equipo

Para ver las especificaciones de la plataforma:
En Windows, haga clic con el botn derecho del ratn en Mi PC y elija Propiedades.

Para obtener informacin ms detallada, elija Inicio > Ejecutar e introduzca [Link]
En UNIX, utilice el comando uname -a

Manual del usuario de PI DataLink

161

ndice
Conexiones 137 Cuadro de dilogo 137 Problemas 144 Configurar Lotus 1-2-3 7 Control ActiveX 78 Correccin de errores Lista de 8 Cuadro de dilogo 105, 113 Ajustes 138 Alias 76 Atributos del tag 119 Bsqueda de tags 138 Clculo de expresiones 134 Campos de edicin 105 Conexiones 137 Datos calculados 127 Datos calculados avanzados 59 Datos comprimidos (horas) 45, 124 Datos comprimidos (nmero) 41, 123 Datos comprimidos filtrados (horas) 132 Datos comprimidos filtrados (nmero) 130 Datos de muestra 122 Datos de muestra filtrados 129 Datos temporizados 126 Filtrado de tiempo 135 Funciones 35, 113 Identificador del punto para tag 73 Introducir hora en Excel 29 Introducir hora en Lotus 1-2-3 111 Mscara de atributo para tag 74 Module Database 85 Propiedad 77 Valor actual 113

A
Acceso de datos 12 Servidor PI 3 12 Acceso de puntos 12 Servidor PI 3 12 Actualizar los datos PI en una hoja de clculo Lotus 1-2-3 112 Administrador de PI System 8 Ajustes 138 Apstrofe 95 Atributos del tag 95, 119 Autentificacin de nodo Servidor PI 2 8 Ayuda 89

B
Barra de herramientas 103 Base de datos de firewall 12 Bsqueda de tags 107, 138

C
Cadenas de tiempo PI 155 Cambiar argumentos 21, 34 Campos de edicin 105 Campos de PIServer 26, 106 Campos de resultados 26, 106 Casilla de verificacin Mostrar hora 111 Comilla simple 95 Complemento de Lotus 1-2-3 1, 93 Comprobar conexiones Tutorial de complementos de Excel 94 Tutorial de complementos de Lotus 1-2-3 94

Manual del usuario de PI DataLink

163

ndice

Valor calculado 116 Valor de archivo histrico 114 Valor de tiempo exacto 115 Cuadros combinados 27 Cuadros de lista 107

Funciones matemticas 150 Operadores lgicos 153 Operadores matemticos 149 Operadores relacionales 152 Performance Equations 151

D
Datos calculados 127 Datos calculados avanzados 59 Datos comprimidos (Horas) 45, 124 (Horas) Filtrado 132 (Nmero) 41, 123 (Nmero) Filtrado 130 Datos de muestra 122 Ejemplo 20 Filtrado 129 Datos filtrados Comprimido (horas) 132 Comprimido (nmero) 130 Muestreado 129 Datos temporizados 126 Delimitadores 149 Desviaciones estndar 59, 116, 127

F
Funciones 32 Cuadros de dilogo 35 Excel 35 Incluido en Excel 15 Incluido en Lotus 1-2-3 93 Performance Equation 151

I
Identificador del punto para tag 74 Informar sobre errores 112 Instalacin Argumentos 158 Configurar 1-2-3 7 Local 4 Red 3 SDK 157 Introducir hora en PI DataLink 111

E
Error de Gethostbyname 144 Error de tiempo de espera connect() 144 Error de tiempo de espera select() 144 Errores 143 Error de tiempo de espera connect() 144 Error de tiempo de espera select() 144 Gethostbyname 144 Informe 112 recv Error 0 144 Expresiones 51, 71, 72, 135 Clculo 134 Filtrado de tiempo 135 Sintaxis 149 Expresiones de clculo 149 Expresiones de filtro 152 Expresiones PI 149

L
Limitaciones PI DataLink para 1-2-3 142

M
Macros Campos de resultados 106 Comandos de macro Lotus 1-2-3 95 Macros y cuadros de dilogo 112 Opcin Salida 110 Marcas de tiempo En Lotus 1-2-3 110 En Microsoft Excel 110 Intervalo de tiempo 156 Introducir en PI DataLink 29 Marcas de tiempo de entrada

164

Hora de inicio y de finalizacin 155 Intervalo de tiempo 156 Mscara de atributo para tag 75 Matriz Opciones 106 Mxima y mnima 59, 116, 127 Men 103 Men PI No se muestra 143 Microsoft Excel Complemento 1, 15 Modos de clculo 59, 116, 127 Module Database 85 MultiNet Traduccin de nombre, Cliente PI 8

N
No se puede conectar al servidor PI 144 Nodos PINet seguridad en 8 Nombre cliente del equipo 8 nombre de usuario/contrasea Servidor PI 3 12 Nombres del nodo TCP/IP 8

O
Opcin Barra de desplazamiento 82 Opcin Cambiar escala 82 Opcin Definir trend 82 Opcin Formato 82 Opcin Revertir 82

P
Palabra clave Curtime 151 PathWay Traduccin de nombre, Cliente PI 8 Performance Equation Sintaxis 151 Performance Equations 149 PI DataLink Argumentos de instalacin 158 Funciones 35

Problemas de carga 143 PI SDK Instalacin silenciosa 157 PIADMIN Privilegios del usuario 12 PIAdvCalcDat 66 PIAdvCalcExpDat 68 PIAdvCalcExpFilDat 69 PIAdvCalcExpFilVal 65 PIAdvCalcExpVal 64 PIAdvCalcFilDat 67 PIAdvCalcFilVal 63 PIAdvCalcVal 62 PIAliasToTag 76 PIArcVal 38, 114 PICalcDat 58, 128 PICalcVal 56, 118 PICompDat 46, 125 PICompFilDat 47, 133 PICurrVal 36, 113 PIExpDat 51, 135 PIExpVal 38 PIExTimeVal 115 PINCompDat 43, 123 PINCompFilDat 44, 131 PIPropertyValue 77 PIPutVal 90, 140 PIPutValX 141 PISampDat 49, 122 PISampFilDat 50, 129 PITagAtt 41, 121 PITimeDat 52, 126 PITimeExpDat 53 PITimeFilter 72 PITimeFilterVal 71 Porcentaje correcto 116, 127 Privilegios del usuario PIADMIN 12 Problemas de carga 143 Promedio de medias 116, 127 Promedios 59, 116, 127

Manual del usuario de PI DataLink

165

ndice

R
Reconoce maysculas y minsculas Nombres del nodo 8 recv Error 0 144 Resolucin de problemas 143 Resumen de caractersticas 103

V
Valor actual 95, 113 Valor calculado 116 Valor de archivo histrico 114 Valor de tiempo exacto 115 Valores Escribir en PI 89, 139 Versin PI System 2.0.9 151 Software de hoja de clculo 2 TCP/IP 2

S
Seguridad Servidor PI 2 8 Servidor PI 3 12 Servidor PI 2 Configuracin del servidor 8 Servidor PI 3 configuracin 12 seguridad 12 [Link] Argumentos 157 PI DataLink 158 Sintaxis Performance Equation 151 Sistema operativo 2 Soporte tcnico OSIsoft 143

T
TCP/IP 2 Nombres del nodo 8 TCPWare Traduccin de nombre, Cliente PI 8 Totales 116, 127 Trend Men del botn derecho del ratn 82 Trend Control 78 Tutorial DataLink para Lotus 1-2-3 93 DataLink para Microsoft Excel 93

U
UCX Traduccin de nombre para cliente PI 8

166