ES PI DataLink User Guide PDF

Manual del usuario de PI DataLink
Versión 3.1
2006-12
© 1992-2007 OSIsoft, Inc. Reservados todos los derechos

OSIsoft, Inc. OSIsoft Australia
777 Davis St., Suite 250 Perth, Australia
San Leandro, CA 94577 EE.UU. Auckland, Nueva Zelanda
(01) 510-297-5800 (teléfono principal)
(01) 510-357-8136 (fax) OSI Software GmbH
(01) 510-297-5828 (teléfono de soporte técnico) Altenstadt, Alemania
support@osisoft.com
OSI Software Asia Pte Ltd.
Houston, TX
Johnson City, TN Singapur
Mayfield Heights, OH
Phoenix, AZ
OSIsoft Canada ULC
Savannah, GA Montreal, Canadá
Seattle, WA
Yardley, PA OSIsoft, Inc. Oficina representativa
Shanghai, República Popular China
OSIsoft Japan KK
Tokio, Japón
OSIsoft Mexico S. De R.L. De C.V.

Ciudad de México, México
Puntos de venta/Distribuidores
Brasil América del Sur/Caribe
Oriente Medio/África del Norte Asia Suroriental
República de Sudáfrica Korea del Sur Taiwán
Rusia/Asia central
www.osisoft.com
OSIsoft, Inc. es el propietario de las siguientes marcas comerciales y marcas comerciales
registradas: PI System, PI ProcessBook, Sequencia, Sigmafine, gRecipe, sRecipe y RLINK.
Todos los términos mencionados en este manual que sean marcas comerciales o marcas de
servicio irán en mayúscula. 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
ningún concepto, una aprobación, recomendación o garantía de los productos de dicha parte o
ningún tipo de afiliación con la misma.
LEYENDA DE DERECHOS LIMITADOS
Su uso, réplica o difusión por parte del Gobierno está sujeto a las restricciones estipuladas en
el subpárrafo (c)(1)(ii) de la cláusula de Derechos de los Datos Técnicos y Software de
Equipo en DFARS 252.227-7013
Contenido
Capítulo 1: Introducción .............................................................................................................1

Contenido de PI DataLink..........................................................................................1
Requisitos del sistema...............................................................................................1
Instalación..................................................................................................................3
Para el administrador de PI System ..........................................................................8
Capítulo 2: Complemento para Excel......................................................................................15

Resumen..................................................................................................................15
Tutorial .....................................................................................................................16
Menú PI....................................................................................................................23
Cuadros de diálogo..................................................................................................25
Tiempo en PI DataLink ............................................................................................28
Funciones de PI DataLink........................................................................................32
Detalles para las funciones y los cuadros de diálogo de PI DataLink.....................35
Escribir datos de Excel a PI.....................................................................................88
Límites de Excel para PI DataLink ..........................................................................90
Capítulo 3: Complemento para Lotus 1-2-3 ............................................................................91

Tutorial .....................................................................................................................91
Menú PI..................................................................................................................101
Cuadros de diálogo................................................................................................103
Tiempo en PI DataLink ..........................................................................................108
Comandos de macro personalizados de PI DataLink ...........................................110
Detalles del cuadro de diálogo 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
Apéndice A: Resolución de problemas ...................................................................................141

El complemento de DataLink no se carga correctamente.....................................141
Problemas de conexión informados en los archivos de registro ...........................142
Apéndice B: Sintaxis de expresiones......................................................................................147

Expresiones de cálculo..........................................................................................147
Manual del usuario de PI DataLink iii

Contenido
Expresiones de filtro ..............................................................................................150
Apéndice C: Ejemplos de cadenas de tiempo PI....................................................................153

Hora de inicio y de finalización ..............................................................................153
Intervalo de tiempo ................................................................................................154
Apéndice D: Argumentos de Setup.ini ....................................................................................155

Instalaciones silenciosas .......................................................................................155
Instalación de PI SDK............................................................................................155
Instalación de PI DataLink .....................................................................................156
Apéndice E: Códigos de salida ................................................................................................157
Apéndice F: Soporte técnico y recursos ................................................................................159

Opciones del soporte técnico ................................................................................159
Antes de llamar o escribir solicitando ayuda .........................................................160
Índice ...........................................................................................................................................163
iv
Capítulo 1: Introducción
PI DataLink proporciona un enlace entre el servidor PI 3 o PI 2 de OSIsoft y los programas

de hoja de cálculo 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
información directamente con las bases de datos de PI System. Combinada con la
funcionalidad de los programas de hoja de cálculo, esta función convierte a PI DataLink en
una herramienta potente y fácil de manejar para recopilar, analizar y comunicar datos PI.
Contenido de PI DataLink
PI DataLink está compuesto por los dos módulos 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 programación 1-2-3 LotusScript
puedan desarrollar rutinas de hojas de cálculo 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. Póngase en contacto con su
representante de ventas de OSIsoft para obtener más información.
Requisitos del sistema
PI DataLink se ejecuta en una aplicación de hoja de cálculo adecuada en un equipo cliente

Microsoft Windows PC y recupera la información almacenada en un servidor PI a través del
software de red estándar.
Manual del usuario de PI DataLink 1

Introducción
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 través 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, versión 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, versión 2.0+
Software de proceso TCPWare, versión 3.1+
Cisco MultiNet, versión 3.4+
Attachmate Pathway, versión de ejecución 1.1+
Programas de hoja de cálculo compatibles
PI DataLink es compatible con los siguientes programas de hoja de datos (sólo versiones de
32 bits):
Microsoft Excel 2000, versión 9.0 y posterior.
Lotus 1-2-3 versión 9.5 (incluida como parte de Lotus SmartSuite Millennium) y
posterior.
2
Instalación
Instalación
Nota: Antes de la instalación, cada usuario de PI DataLink debe disponer de la licencia

para utilizar este producto. Para obtener más información, póngase en contacto
con el personal de ventas de OSIsoft.
El usuario puede instalar PI DataLink desde el CD de distribución, 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 podrán instalar una versión independiente completa o una versión compartida
de PI DataLink desde la unidad de red a un equipo local.
La instalación de una versión independiente crea una copia de los archivos de PI DataLink en
el equipo local del usuario. En una instalación de la versión 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.
Instalación en un servidor de archivos de red
Esta opción está ideada como un procedimiento único para un administrador del sistema. Esta
instalación por sí sola no permite que se pueda ejecutar PI DataLink. Por lo tanto, los
usuarios individuales deben instalar una versión independiente o una versión compartida de
PI DataLink.
La instalación en un servidor de archivos de red se realizar en un equipo local.
A continuación se resume el procedimiento para la instalación en un servidor de archivos de

red:
1. Ejecute AdminSetup.exe desde el CD de distribución en el servidor de archivos de

red.
2. Seleccione el directorio de destino (por ejemplo: C:\APPS\). El programa de

instalación creará los subdirectorios EXCEL, DAT, LIBRARY, LOTUS y SETUP en
C:\APPS\PIPC.
3. Para las instalaciones compartidas, edite la sección [COMMANDLINES] de setup.ini en

el directorio SETUP:
6 = SHARED="P:\APPS\PIPC"

Introducción
donde P: es la letra de unidad que todos los equipos locales especifican para indicar la
unidad C: del servidor de archivos de red. Consulte Setup.ini Arguments (consulte
"Argumentos de Setup.ini" en la página 155) para obtener más argumentos.
4. Para crear una lista de servidores PI, realice una instalación compartida en un equipo que
disponga de derechos de escritura en el directorio P:\APPS\PIPC\DAT. Añada
servidores PI como lo haría normalmente. Todos los cambios que se efectúen se
propagarán al resto de instalaciones compartidas.
Las notas de la versión actual se encuentran en

C:\APPS\PIPC\readme_datalink.txt.
Las notas de la versión de las versiones anteriores se encuentran en

C:\APPS\PIPC\readme_dl<version>.txt.
Instalación en un equipo local (independiente y compartida)
Para poder utilizar PI DataLink, cada usuario debe instalar un versión independiente completa
o una versión compartida. La instalación de una versión idependiente se puede llevar a cabo
desde el CD de distribución o desde la unidad de red. La instalación de una versión
compartida únicamente se puede realizar desde la unidad de red.
A continuación se resume el procedimiento para la instalación en un equipo local:
1. Ejecute el archivo setup.exe del CD de distribución o del directorio de instalación de la

unidad de red (por ejemplo, P:\APPS\PIPC\SETUP\setup.exe).
2. Seleccione el directorio de destino.
Las notas de la versión 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.
Configuración de Microsoft Excel
Si PI DataLink se va a utilizar con Microsoft Excel y se trata de la primera instalación (no

una actualización) de PI DataLink, tendrá que añadir PI DataLink.
1. Inicie Excel.
2. Abra el administrador de complementos de Excel a través de Herramientas >

Complementos.
4
Instalación
3. Busque y seleccione el archivo PIPC32.XLL. Para una instalación local, el archivo

PIPC32.xll se encontrará en el directorio ...\PIPC\EXCEL. Para una instalación
compartida de PI DataLink, acuda al directorio ...\PIPC\EXCEL de la unidad de red.
Si PI DataLink se actualiza y se coloca en un directorio diferente al de las versiones

anteriores, el administrador de complementos de Excel se deberá utilizar en primer lugar para
eliminar el anterior archivo PIPC32.XLL. A continuación, se debe seleccionar el nuevo
archivo PIPC32.XLL en la nueva ubicación.
Usuarios fuera de EE.UU.
Para configurar el formato de número y de hora para fuera de EE.UU., lleve a cabo los
siguientes pasos en Microsoft Excel después de haber instalado DataLink:
1. En el menú PI, haga clic en Ajustes. Se mostrará el siguiente cuadro de diálogo:
2. Modifique las entradas de Formato de número y Formato de hora para que reflejen el
equivalente a "General" y "dd-mmm-yy hh:mm:ss" de su país respectivamente. Las
entradas para los campos de formato de número y de hora pueden ser cualquier código de
formato válido de Excel de Formato, Celdas, Número, Personalizar.

Introducción
Por ejemplo, en Alemania los equivalentes de "General" y "dd-mmm-yyyy hh:mm" son

"Standard" y "TT-MM-JJJJ hh:mm" respectivamente.
6
Instalación
Configuración de Lotus 1-2-3
Para configurar PI DataLink para que funcione con Lotus 1-2-3:
1. Inicie Lotus 1-2-3.
2. En el menú principal, vaya a: Archivo > Complementos > Administrar complementos...
3. en el directorio ...\lotus\addins y haga clic en Abrir.
4. Compruebe el espacio situado delante de la ruta de archivo de pidl.12a y haga clic en

Listo.
5. Salga de Lotus 1-2-3 y vuelva a iniciarlo. El menú PI-DataLink deberá estar disponible
ahora.
PI DataLink para Lotus 1-2-3 no es compatible con instalaciones compartidas. PI

DataLink para 1-2-3 se debe instalar independientemente en cada equipo (estas
instalaciones se pueden llevar a cabo desde una instalación de red central).rar en el
cuadro de diálogo Administrar complementos.
6. Seleccione pidl.12aHaga clic en Regist

Introducción
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 versión 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 versión de PI DataLink.
Corrección de errores
En el archivo ...\PIPC\readme_datalink.txt encontrará una lista de los

problemas conocidos que se han corregido en esta versión 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 través del TCP/IP, el administrador de PI

System debe llevar a cabo una configuración única del servicio de servidor PI. Este servicio
de servidor PI lo utiliza no sólo PI DataLink, sino también todas las aplicaciones cliente del
equipo OSIsoft. Consulte el archivo PIBuild:PIServer.txt del equipo VAX/Alpha.
Archivo de seguridad
El servicio del servidor PI admite una combinación de autentificación de nodo y seguridad de

nombre de usuario/contraseña para aplicaciones cliente del equipo. El archivo de acceso del
servidor PI, PISysDat:PIServer.Dat, determina qué máquinas tienen acceso a los
datos PI. Si no existe este archivo, se debe crear.
Para la seguridad de la autentificación de nodos, añada entradas para determinadas máquinas.

Por ejemplo:
8
[USERDATABASE] DEFAULT=PI [CLIENTACCESS] DEFAULT=R PINET1=RW

PINET2=RW PC1=RW PC2=NONE
Las entradas anteriores de PISysDat:PIServer.Dat tienen como resultado lo siguiente:
1. Las máquinas 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 máquina denominada "PC1" también 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 través 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
cálculos.
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 máquinas podrán obtener datos
de PI, pero no escribirlos en él, con PI DataLink.
5. Para la seguridad de nombre de usuario/contraseña, añada la letra L después del tipo de

acceso:
[USERDATABASE] DEFAULT=PI [CLIENTACCESS] DEFAULT=RL PINET1=RW

PINET2=RW PC1=RLWL PC2=NONE
Este PIServer.Dat es el mismo que el del ejemplo anterior, excepto en dos casos:
• La máquina denominada "PC1" dispone de acceso de lectura y escritura condicional.

Este nivel de seguridad implica que sólo el usuario con el nombre de usuario y
contraseña adecuados puede leer y escribir en "PC1" a través 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 contraseña válidos para acceder a los datos PI y ningún usuario puede escribir de
nuevo los datos en PI.
Recuerde que los nombres del nodo TCP/IP distinguen entre mayúsculas y minúsculas.
Además, los valores de las entradas de la sección CLIENTACCESS (es decir, R y W)
también distinguen entre mayúsculas y minúsculas.
Para que la seguridad del nodo o del nombre de usuario/contraseña 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 información específica para
DECNet y los TCP/IP de los diversos proveedores.

Introducción
Traducción 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 conexión PI DataLink. A su vez, UCX consulta a la base
de datos de host UCX de VAX/Alpha o del servidor de nombres de dominio (si está
configurado).
Para confirmar que UCX está determinando el nombre del equipo correctamente, introduzca
lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:
$ ucx show device /port=545
Deberá ver el nombre de host remoto incluido bajo Remoto. PISysDat:PIServer.Dat
controla el nivel de acceso a los datos PI de este nombre de host.
Si en su lugar observa un número (por ejemplo, 192.168.100.77) para el host remoto, esto
querrá decir que UCX (y por lo tanto el servidor PI 2) no puede determinar el nombre del
equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en
PISysDat:PIServer.Dat.
Para añadir una entrada en la tabla de host UCX para un equipo:

$ ucx set host "mypc" /addr=192.168.100.77
Consulte su documentación sobre UCX para obtener más detalles.
Traducción de nombre - MultiNet
En MultiNet, el servidor PI 2 le pide a MultiNet que le suministre el nombre de host de una

determinada conexión PI DataLink. A su vez, MultiNet consulta a la base de datos de host
MultiNet de VAX/Alpha o del servidor de nombres de dominio (si está configurado). Para
confirmar que MultiNet está determinando el nombre del equipo correctamente, introduzca lo
siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:
$ multinet show
Deberá ver el nombre del host local, así como el nombre del host (del equipo) externo.
PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este último
nombre de host.
Si en su lugar observa un número (por ejemplo, 192.168.100.77) para el host externo, esto
querrá decir que MultiNet (y por lo tanto el servidor PI 2) no puede determinar el nombre del
Para añadir una entrada en la tabla de host Multinet del VAX/Alpha para un equipo, debe
editar el archivo MultiNet:Hosts.Local. Una vez editado, debe ejecutar los
siguientes comandos:
$ multinet host_table compile $ @multinet:install_databases
10
Consulte su documentación sobre Multinet para obtener más detalles.
Traducción de nombre - PathWay
En PathWay, el servidor PI 2 le pide a PathWay que le suministre el nombre de host de una

determinada conexión PI DataLink. A su vez, PathWay consulta a la base de datos de host de
VAX/Alpha o del servidor de nombres de dominio (si está configurado). Para confirmar que
PathWay está determinando el nombre del equipo correctamente, introduzca lo siguiente de
DCL una vez que PI DataLink se haya conectado al servidor PI 2:
$ netstat
Deberá ver el nombre del host local, así como el nombre del host (del equipo) externo.
PISysDat:PIServer.Dat. controla el nivel de acceso a los datos PI de este último nombre de
host.
Si en su lugar observa un número (por ejemplo, 192.168.100.77) para el host externo, esto
querrá decir que PathWay (y por lo tanto el servidor PI 2) no puede determinar el nombre del
Para añadir una entrada en la tabla de host PathWay de VAX para un equipo, debe editar el
archivo twg$etc:Hosts. Para obtener más detalles, consulte su documentación de PathWay.
Traducción de nombre - TCPWare
En TCPWare, el servidor PI 2 le pide a TCPWare que le suministre el nombre de host de una

determinada conexión PI DataLink. A su vez, TCPWare consulta a la base de datos de host
de VAX/AlphaAXP o del servidor de nombres de dominio (si está configurado). Para
confirmar que TCPWare está determinando el nombre del equipo correctamente, introduzca
lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:
$ netcu show connections /host_names
Deberá ver el nombre del host local, así como el nombre del host (del equipo) remoto.
PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este último
nombre de host.
Si en su lugar observa un número (por ejemplo, 192.168.100.77) para el host remoto, esto
querrá decir que TCPWare (y por lo tanto el servidor PI 2) no puede determinar el nombre del
Para añadir 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 documentación sobre TCPWare para obtener más detalles.

Introducción
Servidor PI 3
Base de datos de firewall
La base de datos de firewall que se encuentre en la máquina 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 sólo está permitido que se conecten los equipos cuya dirección TCP/IP comience
por 192.168.100.
Para obtener más información, consulte los manuales de usuario del servidor PI que se
pueden descargar de http://techsupport.osisoft.com/downloadcenter.aspx
(http://techsupport.osisoft.com/downloadcenter.aspx) en "PI 3 Enterprise Server".
Base de datos segura
La base de datos segura que se encuentre en la máquina en la que se esté ejecutando el

servidor PI 3 se puede configurar para que permita el acceso, sin inicio de sesión explícito, a
los equipos en los que se esté ejecutando PI DataLink. Por ejemplo,
PIconfig> @table pitrust PIconfig> @ostr trust,ipaddr,iphost,piuser
PIconfig> @select trust=* PIconfig> @ends
MyPCTrust,0.0.0.0,mypc,piadmin
Esto indica que cualquier aplicación que se conecte al servidor PI 3 desde "mypc" obtendrá
privilegios piadmin de forma predeterminada.
Atributos de acceso de puntos/acceso de datos
Cuando PI DataLink se conecta con PI 3 Server, le solicita al usuario un nombre de usuario y

una contraseña. 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 sesión como
USER1 para poder ver este tag. De otro modo, no se podrá encontrar el tag.
12
También, si SINUSOID DataAccess es O:R, G:NONE, W:NONE y DataOwner es USER1,

los usuarios de PI DataLink deben iniciar la sesión 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 sesión como USER1, en este caso no se permitirá que PI
DataLink escriba datos en SINUSOID puesto que el atributo de DataAccess es O:R (sólo
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 sesión como USER1 podrán leer y escribir datos para SINUSOID.
Nota: El usuario PIAdmin es un usuario superprivilegiado. Un usuario de PI DataLink

que inicie la sesión como PIAdmin dispondrá de acceso de lectura y escritura a
todos los tags. Por este motivo, los usuarios de PI DataLink normalmente NO
deberían iniciar la sesión como PIAdmin.

Capítulo 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 cálculo. Aún más, los usuarios pueden escribir valores de la hoja de cálculo 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 expresión determinada es verdadera
Datos comprimidos (archivados)
Datos comprimidos si una expresión determinada es verdadera
Datos de muestra para una matriz de marcas de tiempo especificada por el usuario
Datos de los cálculos en las expresiones del tag PI
Cantidad de tiempo mientras una expresión de tag PI era verdadera
Totales, mínima, máxima, desviaciones estándar, rangos, promedios, recuentos y

métodos para tags y expresiones PI
Nombre de tag de un identificador del punto especificado
Nombres de tags de máscaras de atributos especificadas
Valor de alias de una base de datos de módulo
Valor de propiedad de una base de datos de módulo

Complemento para Excel
Tutorial
El objetivo de este tutorial es iniciarle en el uso de PI DataLink en Excel lo más rápido

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 asegúrese de que la selección de menú PI se encuentra en la barra de menús de

Excel. Si PI no aparece en ella, tendrá que utilizar el administrador de complementos de
Excel. Consulte Configuración de Microsoft Excel.
Desde la barra de menús de PI, seleccione Conexiones....
Si el estado indica que el servidor PI no está conectado, haga clic en la casilla de verificación
para conectarlo. Si la cuenta de usuario predeterminada del servidor PI seleccionado requiere
una contraseña, aparecerá el cuadro de diálogo de inicio de sesión en el que se le solicitará la
contraseña:
16
Tutorial
En este cuadro de diálogo también se puede modificar el nombre de usuario para el inicio de
sesión y utilizar uno diferente al del usuario predeterminado.
Un nombre de usuario/contraseña válido modifica el cuadro de diálogo Estados en las

conexiones y muestra el usuario con el que está conectado DataLink. Cierre el cuadro de
diálogo de conexiones haciendo clic en Cancelar.
Si aparece un cuadro de diálogo de fallo al iniciar la sesión, confirme que su nombre de

usuario/contraseña PI sean válidos. Si el cuadro de diálogo de fallo al iniciar la sesión aparece
a pesar de que el nombre de usuario/contraseña PI son válidos, quiere decir que PI DataLink
no se puede conectar al servidor PI. Consulte la sección Resolución de problemas (en la
página 141).
Atributos del tag y Valor actual
En este ejemplo obtendremos el descriptor del tag, el valor actual y las unidades de ingeniería
para algunos tags.
1. Abra Excel.
2. En el menú PI, seleccione Ajustes... y asegúrese de que está seleccionado el botón de

exclusión mútua En una columna de la sección "Copiar elementos a la hoja".
3. A continuación, cierre el cuadro de diálogo y sitúe el cursor en la celda A2 de la hoja de

cálculo.
4. Seleccione Búsqueda de tags... en el menú PI e introduzca "BA*" en el campo Máscara

de tag.

5. Haga clic en Buscar para buscar los tags que comiencen con "BA". La lista Resultados de
búsqueda 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 búsqueda 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 edición de Nombre(s) de tag.
18
Tutorial
8. Coloque el puntero del ratón sobre la celda A2 de la hoja de cálculo. 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 diálogo, 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 edición de Nombre de tag. Coloque el puntero del ratón sobre la celda A2
de la hoja de cálculo. Haga clic y arrastre para seleccionar la referencia A2:A6. En el
cuadro de diálogo, haga clic en el botón de exclusión mútua tiempo a la izquierda.

12. En el cuadro de diálogo, haga clic en Aceptar. PI DataLink recupera los valores actuales
y sus marcas de tiempo en las columnas D y C respectivamente.
13. Sitúe el cursor en la celda E2 de la hoja de cálculo. En el menú PI, seleccione Atributos
del tag... de nuevo. Haga clic en el cuadro de edición de Nombre(s) de tag.
14. Coloque el puntero del ratón sobre la celda A2 de la hoja de cálculo. Haga clic y arrastre
para seleccionar la referencia A2:A6. Seleccione engunits del cuadro de lista Atributo.
15. En el cuadro de diálogo, haga clic en Aceptar. A continuación, PI DataLink recuperará

unidades de ingeniería 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 botón Búsqueda de tags. Aparecerá el cuadro de diálogo Búsqueda de tags.
2. Introduzca "CD*" en el campo Máscara de tag. Haga clic en Buscar para buscar tags
que comiencen con CD. Debería 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 diálogo Datos de
muestra. Introduzca t (para medianoche de hoy) en el campo Hora de inicio, +8h
(período de 8 horas desde la hora de inicio) en el campo Hora de finalización y 1h
(intervalos de una hora) en el campo Intervalo de tiempo. Marque la casilla de
verificación 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 diálogo
En este ejemplo, modificaremos la hora de finalización utilizada en el ejemplo anterior.

1. Haga clic con el botón derecho del ratón sobre cualquier parte de la matriz creada en el
ejemplo anterior.
2. Seleccione Datos de muestra...
3. Cambie la hora de finalización 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. Fíjese en que el tamaño de la matriz a aumentado en una fila.
Utilizar matrices antiguas como plantillas
En este ejemplo mostraremos cómo utilizar una matriz antigua como plantilla para un tag
diferente.
1. Haga clic con el botón derecho del ratón sobre cualquier parte de la matriz creada en el
ejemplo anterior.
2. Seleccione Datos de muestra...
22
Menú PI
3. Modifique el campo de edición del tag de "CDT158" a "SINUSOID".
4. Modifique la Celda de salida de $C$10 a $A$10 y haga clic en Aceptar. Fíjese 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 más rápida de utilizar PI DataLink para
transferir datos entre PI y Excel es seleccionando una opción del elemento de menú PI. En
ese caso aparecerá un cuadro de diálogo. Introduzca los parámetros adecuados y PI DataLink
recuperará los valores PI solicitados. Las siguientes secciones describen las funciones de PI
DataLink con más detalle.
Menú PI
Si PI DataLink se añade a Excel, el elemento de menú PI se añade a la barra de menú de

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 histórico recupera un único valor del archivo histórico (se puede
interpolar)
Atributos del tag recupera un atributo del tag
Datos comprimidos (hora de inicio/número) recupera datos comprimidos basándose en una

hora de inicio y en un número especificado de valores con una condición de filtro
opcional
Datos comprimidos (hora de inicio/de finalización) recupera datos comprimidos basándose
en una hora de inicio y en una hora de finalización con una condición de filtro opcional
Datos de muestra recupera datos espaciados de forma uniforme (de muestra) del archivo
histórico con una opción de filtro opcional
Datos temporizados recupera datos de muestra sincronizados con una matriz de marcas de
tiempo
Datos calculados recupera totales, mínima, máxima, rangos, desviaciones estándar,
promedios y medias para múltiples períodos de tiempo
24
Cuadros de diálogo
Datos calculados avanzados es similar a datos calculados pero con más opciones
avanzadas (esto es, evento ponderado)
Filtrado de tiempo recupera la cantidad de tiempo durante la que una expresión de tag es
verdadera
Identificador del punto para tag recupera un nombre de tag del identificador del punto
especificado
Máscara de atributo para tag recupera nombres de tag de las máscaras de atributo
especificadas
Alias recupera un nombre de tag de alias de la base de datos de módulo
Propiedad recupera un valor de propiedad de la base de datos de módulo
Insertar trend crea una trend que puede obtener datos directamente de PI o de la hoja de
cálculo
Búsqueda de tags busca tags PI
Module Database muestra el contenido de la base de datos de módulo, como alias y

propiedades
Conexiones gestiona las conexiones del servidor PI
Ajustes muestra los ajustes y preferencias de PI DataLink
Acerca de muestra la información de la versión PI DataLink
Ayuda muestra la ayuda sobre PI DataLink
Cuadros de diálogo
Campos de edición
Los campos de edición pueden conterner la información de texto necesaria o referencias a las
celdas que contengan la información de texto necesaria. PI DataLink determina el tipo de
información introducida en el campo de edición según el contexto.
De forma alternativa a la introducción de la referencia de celda, también puede utilizar el

ratón para hacer clic en el campo de edición y luego en la celda (o hacer clic en la celda y
arrastrar a las celdas adyacentes) de la hoja de cálculo. En este procedimiento, Excel
introduce automáticamente las referencias de celdas en el campo de edición.

Por ejemplo, en el siguiente cuadro de diálogo, los campos de edición para Nombre de tag y
Salida solicitan una celda de la hoja de cálculo que contenga el nombre del tag y la celda de
la hoja de cálculo en la que desee colocar la salida del valor actual respectivamente.
Servidor PI y campos de salida
El campo Servidor PI permite la selección de un servidor PI de la lista de servidores

conocidos. En la lista desplegable, los servidores que se encuentran sobre la línea de puntos
son los servidores actualmente conectados y los que se encuentran por debajo de ella son los
que actualmente están desconectados. El campo Servidor PI de todos los cuadros de diálogo
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 diálogo 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 diálogo que esperan devolver una matriz de valores PI (por ejemplo,
Datos de muestra), existe un grupo de botones de exclusión mútua 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 mostrarán marcas de tiempo O porcentajes correctos, o en tres
columnas si se mostrarán marcas de tiempo Y porcentajes correctos. Seleccione fila(s) para
mostrar los datos en una, dos o tres filas.
26
Cuadros de diálogo
Para los cuadros de diálogo que esperan devolver un único valor PI (p. ej., Valor actual),
existe un grupo de botones de exclusión mútua 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 diálogo que son compatibles con una matriz de tags, la orientación de la
matriz de tags sobrescribirá su selección de fila/columna a la hora de determinar la
orientación de los datos de salida.
Cuadros de lista
Los cuadros de lista aparecen para el campo Modo en Valor de archivo histórico..., para los
campos Tipo en Datos comprimidos (número) y (horas)..., para los campos Modo en Datos
calculados y Datos calculados avanzados..., y para los campos Unidad de tiempo en los
cuadros de diálogo Filtrado de tiempo... El modo de recuperación predeterminado de Valor
de archivo... es interpolado, el tipo de límite predeterminado de Datos comprimidos (número)
y (horas)... es interior, el modo de cálculo predeterminado de Datos calculados y Datos
calculados avanzados... es total, el modo de muestreo de expresión 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 automáticamente 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 válido, su clase de punto se recuperará e introducirá en el campo Clase de punto
automáticamente.
Buscar tags en los cuadros de diálogo
El botón <...>, que se encuentra junto al campo de nombre de tag en los cuadros de diálogo, le
permite buscar tags en la base de datos PI. Si hace clic en este botón, aparecerá el cuadro de
diálogo Búsqueda de tags. Si pulsa Aceptar en el cuadro de diálogo Búsqueda de tags, el
primer nombre de tag seleccionado se copiará en el campo de edición de nombre de tag. El
nombre de servidor PI también se copiará en el campo de edición Servidor PI si seleccionó la
casilla "Copiar nombre de servidor PI" en los ajustes de PI DataLink.

Tiempo en PI DataLink
Valores devueltos
Las marcas de tiempo devueltas por los cuadros de diálogo de PI DataLink se encuentran en
formato Excel; es decir, el número representa el número de días desde 1900. Por ejemplo,
10-Dec-99 7:12pm se introduce en una celda con el número 36504.8.
Sin embargo, PI DataLink formatea estas marcas de tiempo y las convierte en una cadena de
tiempo PI; específicamente, dd-mmm-aa hh:mm:ss. Por ejemplo, 7:12 PM del 10 de
diciembre de 1999 se muestra como 10-Dec-99 19:12:00.
Puede cambiar este formato por otro seleccionando las celdas y, a continuación,
seleccionando Formato, Celdas, Número. Consulte su documentación sobre Excel para
obtener información sobre el formateo de números como horas.
Formato de tiempo y número especificado por el usuario
Si no le gustan los códigos de formato general y dd-mmm-aa hh:mm:ss para números y horas
respectivamente, puede especificar otro código de formato de número y hora predeterminado
en PI DataLink. Para ello, vaya al cuadro de diálogo PI > Configuración...
28
El formato de número "0.0" muestra los números 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 diálogo solicitan una hora de inicio y una hora de finalización. En
los campos de edición, 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 finalización. El reloj
tiempo real actual es la hora de referencia para la traducción 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
traducción de la hora relativa en el campo de hora de finalización.
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 días desde 1900, pero las muestra según Formato,
Celdas, Número.

Para el campo de edición de intervalo de tiempo, puede especificar un número 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 edición.
Si desea utilizar referencias de celdas, únicamente podrá referirse a las celdas que contengan
una cadena de intervalo de hora PI válida. Esto es, no puede hacer referencia a una celda que
contenga una hora Excel (es decir, un número). Por ejemplo, para especificar un intervalo de
32 minutos, el campo de edición de intervalo de tiempo debe hacer referncia a una celda que
contenga la cadena 32m.
Consulte Hora de inicio y de finalización (consulte "Ejemplos de cadenas de tiempo PI" en la

página 153) e Intervalo de tiempo (en la página 154) para obtener ejemplos de cadenas de
tiempo PI válidas.
Casilla de verificación Mostrar hora
En algunos cuadros de diálogo aparece la casilla de verificación mostrar hora, cuya función
PI generalmente devuelve una matriz de valores PI. Si selecciona esta casilla de verificación,
se devolverán 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 botón de exclusión mútua
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 diálogo Datos de muestra o Datos
calculados, PI DataLink devuelve un grupo común de marcas de tiempo para todo el grupo
de tags.
Colocar los datos de marca de tiempo devueltos por PI DataLink
Algunos cuadros de diálogo que devuelven un valor único (por ejemplo, Valor actual)
disponen de botones de exclusión mútua 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
Nota: Cuando se especifica una referencia matricial en el campo Nombre de tag, los
botones de exclusión mútua 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 función 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 aparecerán a la izquierda de los valores. Para los nombres de tag en
una única fila, las marcas de tiempo aparecerán encima de los valores.
Datos de marca de tiempo para un intervalo o rango temporal
Algunos cuadros de diálogo que devuelven un único valor a cada intervalo de tiempo (por
ejemplo, Datos calculados) proporcionan casillas de verificación 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 finalización para mostrar la hora de finalización del intervalo.
Para las funciones de mínimo, máximo y rango:
Seleccione Tiempo mín/máx para mostrar las marcas de tiempo para los valores mínimo
y máximo del intervalo.
Las marcas de tiempo se muestran según la orientación (por filas o por columnas)
especificada. Por ejemplo, si la orientación es por columnas y están activadas todas las
casillas de verificación, el orden de las columnas de izquierda a derecha sería: hora de inicio,
hora de finalización, la marca de tiempo del valor mínimo, la marca de tiempo del valor
máximo. Si en el ejemplo anterior se desactiva la casilla de verificación Hora de
finalización, el orden de izquierda a derecha sería: hora de inicio, la marca de tiempo del
valor mínimo, la marca de tiempo del valor máximo.

Funciones de PI DataLink
Funciones y valores
Cuando un cuadro de diálogo PI DataLink transmite datos del servidor PI a Excel, no pone
el valor real en una celda. En su lugar, PI DataLink pega una función PI personalizada en la
celda.
Por ejemplo, cuando se abre el cuadro de diálogo Valor actual y se introduce SINUSOID en
el campo Nombre de tag, PI DataLink pega la siguiente función en la celda:
=PICurrVal("sinusoid",0,)
Excel evalúa entonces esta función y muestra el número resultante. De este modo, los cuadros
de diálogo PI DataLink son aplicaciones para el usuario que sirven para construir las
funciones PI DataLink correspondientes y formatear el resultado.
Estas funciones PI DataLink también se pueden introducir manualmente en las celdas de una
hoja de cálculo. Los argumentos de la función se describen más detalladamente en Detalles
para las funciones y los cuadros de diálogo PI DataLink (consulte "Detalles para las
funciones y los cuadros de diálogo de PI DataLink" en la página 35). Debido a que la mayoría
de las funciones PI DataLink devuelven más de un elemento de datos, las funciones se deben
introducir en Excel como funciones de matriz. Para obtener una explicación más detallada de
cómo se utilizan las funciones de matriz, consulte la sección Introducir funciones PI
directamente en Excel más adelante.
Estas funciones PI DataLink sólo se pueden utilizar en las celdas de una hoja de cálculo. 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 función como una cadena de texto y después establecer la fórmula 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
código VBA puede comprobar los valores de celda de los resultados de las funciones PI. Para
ver un ejemplo acerca de la introducción de funciones PI en una hoja de cálculo utilizando
VBA, consulte el módulo putval_code en el archivo piexam32.xls distribuido con PI
DataLink.
La función de salida PIPutVal() de PI DataLink es una función para macros de Excel y no

puede utilizarse directamente en las celdas de una hoja de cálculo. PIPutVal() sólo se puede
utilizar en una hoja de macros de Excel 4.0 o ejecutar como una macro en VBA. En VBA,
utilice el método application.run para invocar las funciones para macros. Para ver un ejemplo
acerca de cómo invocar la función para macros en VBA, consulte el módulo putval_code
module en el archivo piexam32.xls.
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 cálculo
Hay dos formas de actualizar los datos en una hoja de cálculo. Una forma es hacer clic con el
botón derecho del ratón en la matriz y seleccionar la función Recalcular (cambiar de tamaño).
Este método funciona mejor si se dispone de una matriz de tamaño variable en la que el
número de valores devueltos puede ser diferente según el rango de valores recuperados. Si
hay pocos valores, no hay problema. Sin embargo, si se recuperan más valores, dichos
valores no se mostrarán a menos que se seleccione la función 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 través de las funciones,
los valores de la hoja de cálculo sólo se actualizan cuando se cambia un argumento de
función. Pulsar F9 en Excel no obliga a las funciones PI DataLink a obtener nuevos datos del
servidor PI. La única excepción es la función Valor actual, que se actualiza siempre que Excel
realiza un nuevo cálculo. Esto se hizo de forma intencionada, ya que la mayoría de las
funciones DataLink no muestran los datos modificados cronológicamente. 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 cálculo que se actualice con la mínima intervención del
usuario es utilizar algunas funciones de tiempo dinámicas 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 continuación, consulte esta celda en el argumento de hora de inicio o de hora de
finalización 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 cálculo), Excel actualizará las
funciones de tiempo dinámicas, haciendo que se ejecute la función PI DataLink. Observe que
el valor de la marca de tiempo no tiene que cambiar para que Excel desencadene la función PI
DataLink. Siempre que se utilice la función de tiempo dinámico de Excel para construir la
marca de tiempo y ésta se utilice a su vez en el argumento de DataLink, Excel desencadenará
la función DataLink cuando se recalcule la hoja de cálculo.
Cambiar argumentos utilizando cuadros de diálogo
Si es necesario cambiar un argumento, haga clic con el botón derecho del ratón en cualquier
parte de la matriz y seleccione la función PI DataLink. Aparecerá un cuadro de diálogo con
todos los campos de edición rellenados con los argumentos que previamente se habían

especificado para dicha matriz. Se puede modificar cualquiera de los campos de edición y la
nueva matriz reflejará dichos cambios.
Si el campo de edición de salida se modifica, existen dos comportamientos diferentes en

función 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 función DataLink completa
Si es necesario copiar, mover o eliminar una gran matriz de funciones PI DataLink, la forma
más fácil es hacer clic con el botón derecho del ratón en cualquier parte de la matriz y
seleccionar Seleccionar fórmula de DataLink. A continuación, realice la función 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 continuación,
introduzca la función PI y sus argumentos en la barra de fórmulas de Excel. Por último,
coloque la función PI en las celdas con la combinación de teclas CTRL+SHIFT+ENTER.
Para obtener más información acerca de las funciones matriciales, consulte la ayuda en línea
de Microsoft Excel. Tenga en cuenta también que el Asistente para funciones de Excel sólo
insertará la función en una celda de la hoja de cálculo. Por lo tanto, no es muy recomendable
utilizar el asistente de funciones para introducir funciones PI en Excel.
Código de salida
El argumento de código de salida es un número 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 código de salida 0 en PICurrVal() produce el valor snapshot en la celda

única. Un código 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 código 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 código de salida, consulte la descripción detallada de cada función PI
individual. En general, si se especifica un rango de salida matricial mayor que el número de
34
Detalles para las funciones y los cuadros de diálogo de PI DataLink
valores devueltos de la función, las celdas adicionales se mostrarán como celdas vacías
aunque tengan una fórmula 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 función:
=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 diálogo Conexiones. Si desea utilizar el servidor predeterminado, puede omitir el
argumento de PIServer. Por ejemplo, para recuperar el valor actual para el tag sinusoid del
servidor PI predeterminado, introduzca:
=PICurrVal("sinusoid",0,)
en un rango de salida de 1x1.
Las siguientes secciones describen cada una de las funciones de PI DataLink con más detalle.
Cada sección describe primero el cuadro de diálogo y, a continuación, discute cada
argumento de la correspondiente función (o funciones) PI personalizada.
Cuadro de diálogo Valor actual
Este cuadro de diálogo 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.
Notas especiales
Esta función se actualiza siempre que Excel calcula o recalcula cualquier celda de la hoja de
cálculo. Para forzar un recálculo inmediato, pulse la tecla F9.
PICurrVal()
PICurrVal(tagname, outcode, PIServer)
Argumentos
Argumento Explicación
Tagname (cadena) El tag para el cual desea el valor snapshot (actual).
outcode (entero) Un código de salida; 0, 1 o 2.
PIServer (cadena) El servidor PI.
Devoluciones
Código Columna 1 Columna 2

de salida
0 Valor actual
1 Marcas de Valor actual
tiempo
Un código de salida 2 transpone la matriz de salida que resulta de un código de salida 1.
Ejemplo
La siguiente fórmula recupera el valor actual y la marca de tiempo correspondiente para el tag
let439 del servidor PI "holden":
=PICurrVal("let439",1,"holden")
36
Cuadro de diálogo Valor de archivo histórico
Este cuadro de diálogo obtiene un valor a una hora especificada. Hay cinco modos de
selección:
Previous (Anterior) - Recupera el valor del archivo histórico en el momento o antes de la

marca de tiempo especificada.
Previous only (Solo anterior) - Recupera el valor del archivo histórico sólo antes de la
Interpolated (Interpolado) - Interpola el valor en la marca de tiempo especificada, excepto
para los 4 tags de código de resolución 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 reenvía.
Auto - Igual que Interpolado, excepto para los 4 tags de código de resolución 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 histórico en el momento o después de la
Next only (Solo posterior) - Recupera el valor del archivo histórico sólo después de la
Exact Time (Tiempo exacto) - Recupera el valor del archivo histórico en un tiempo
especificado si existe una entrada en dicho tiempo. Si no existe ningún valor, se devuelve
el mensaje "No se han encontrado eventos".
Campos obligatorios
Nombre de tag o expresión
Marca de tiempo
Consulte también
PIArcVal() (en la página 37)
PIExpVal() (en la página 38)
PIArcVal()
PIArcVal(tagname, timestamp, outcode, PIServer, mode)

Argumentos
tagname (cadena) El tag para el cual desea el valor de archivo histórico.
time stamp (cadena) La marca de tiempo PI.
mode (cadena) El modo de recuperación.
Devoluciones
de salida
0 Valor de archivo
histórico
1 Marca de tiempo Valor de archivo
histórico
Ejemplo
La siguiente fórmula recupera un valor interpolado para el tag cdep158 a las 7:20 pm del 11
de diciembre de 1992 del servidor PI "casaba":
=PIArcVal("cdep158","11-dec-92 19:20",0, "casaba","interpolated")
PIExpVal()
PIExpVal(expression, timestamp, PIServer)
Argumentos
expression (cadena) La cadena para la que desea el valor de archivo histórico.
38
Devoluciones
de salida
0 Valor de archivo
histórico
histórico
Ejemplo
La siguiente fórmula calcula la raíz cuadrada del valor del tag sinusoid del servidor PI
denominado THEVAX en la medianoche de ayer:
=PIExpVal("sqr('sinusoid')","y","thevax")
Cuadro de diálogo Atributos del tag
Este cuadro de diálogo 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 descripción de atributos para cada clase de punto en los manuales del usuario
del servidor PI, disponibles en http://techsupport.osisoft.com/downloadcenter.aspx
(http://techsupport.osisoft.com/downloadcenter.aspx), bajo "PI 3 Enterprise Server".
Para PI 2, seleccione un atributo de tag del cuadro combinado. El atributo predeterminado es

descriptor. Los atributos de tag son:
Atributo Explicación
Descriptor Descriptor de tag de 26 caracteres.
Exdesc Descriptor extendido de tag de 80 caracteres.
typicalvalue Valor típico.
Units Cadena de unidades de ingeniería.
Zero Cero.

Span Rango.
digstartcode Código para la primera cadena de estado digital del tag.
dignumber Número de estados digitales menos 1.
pointtype Carácter de tipo de punto.
pointsource Carácter de origen de punto.
location1 Parámetro de ubicación 1.
filtercode Código de filtro.
squareroot Flag de raíz cuadrada.
scan Flag de exploración.
excdev Desviación por excepción en porcentaje de rango.
excmin Tiempo mínimo de excepción en segundos.
excmax Tiempo máximo de excepción en segundos.
archiving Flag de archivado histórico.
compressing Flag de compresión.
Res Código de resolución.
compdev Desviación de compresión en porcentaje de rango.
compmin Tiempo mínimo de compresión en segundos.
compmax Tiempo máximo de compresión en segundos.
totalcode Código de totalización.
convers Factor de conversión para puntos postprocesados.
displaydigits Controla el formato de los valores numéricos en pantallas PI basadas en
terminales.
instrumenttag Nombre de tag para un valor en otro sistema, lo utilizan algunas interfaces.
sourcept Nombre de tag para la salida a otro sistema, lo utilizan algunas interfaces.
taglong Nombre de tag largo (hasta 80 caracteres).
tagshort Nombre de tag de 12 caracteres.
creator Creador del tag.
createdate Fecha de creación del tag.
changer Usuario que modificó los atributos del tag.
changedate Fecha de modificación del tag.
pointnumber Número de identificación reutilizado al eliminar un punto.
40
pointid Número de identificación interno único que no se reutiliza al eliminar un punto.
PITagAtt() (en la página 41)
PITagAtt()
PITagAtt(tagname, attribute, PIServer)
Argumentos
tagname (cadena) El tag para el cual desea un atributo.
attribute (cadena) El atributo del tag, consulte la lista en Cuadro de diálogo Atributos del tag
(en la página 39).
Devoluciones
Atributo de tag
Ejemplo
La siguiente fórmula recupera del servidor PI predeterminado las unidades de ingeniería para
el tag situado en la celda D1:
=PITagAtt(d1,"units",)
Cuadro de diálogo Datos comprimidos (hora de inicio/número)
Este cuadro de diálogo devuelve valores comprimidos del servidor PI basándose en una hora
de inicio y en un número especificado de puntos de datos. Si no se especifica una expresión
de filtro, se ejecuta la función PINCompDat(). De lo contrario, se abre la función
PINCompFilDat().
Campos obligatorios
Nombre de tag
Hora de inicio

Número de puntos de datos
Expresión de filtro
Si se especifica una expresión de filtro, el número de valores comprimidos especificado se

recupera del servidor PI mientras una determinada expresión de filtro sea verdadera. Si se ha
seleccionado la opción de marcar como filtrado, para cada grupo de valores que no satisfaga
la expresión de filtro se devolverá el estado "Filtrado". Para obtener más información sobre la
sintaxis de la expresión de filtro, consulte Expresiones de filtro (en la página 150).
Tipo de límite
Existen 4 tipos de límites:
Inside (Dentro) (predeterminado): devuelve un número 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 número 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 número 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 límite interpolado, excepto si el código de resolución 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 verificación
Seleccione atrás en el tiempo si desea recopilar datos del archivo histórico 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 diálogo devuelve cadenas vacías si existe un número menor de valores que el
número que se especificó. Por ejemplo, si desea recuperar 400 valores, comenzando por la
42
medianoche de hoy, y sólo existen 356 valores (incluidos los eventos filtrados), las 44 celdas
finales incluirán cadenas en blanco.
Si introduce la expresión de filtro en una celda de la hoja de cálculo y hace referencia a ella
en el cuadro de diálogo, asegúrese de comenzar la expresión 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 expresión de filtro comienza con un nombre de tag
y va a almacenarla en una celda o en la hoja de cálculo, deberá iniciar dicha expresión con
dos comillas simples.
Temas relacionados
Expresiones de filtro (en la página 150)
PINCompDat() (en la página 43)
PINCompFilDat() (en la página 44)
PINCompDat()
PINCompDat(tagname, stime, numvals, outcode, PIServer)
Argumentos
tagname (cadena) El tag para el cual desea datos comprimidos.
stime (cadena) La hora de inicio en formato de hora PI.
numvals (entero) El número de puntos de datos comprimidos. Utilice un número negativo
para recopilar datos del archivo histórico que retrocede desde stime.
outcode (entero) Un código de salida. Para obtener más información sobre los códigos de
salida, consulte Códigos de salida.
Devoluciones
Códigos de salida

Ejemplo
La siguiente fórmula recupera 10 puntos de datos comprimidos y las correspondientes marcas

de tiempo para el tag cdf144 , comenzando por 1:00 a.m. de esta mañana del servidor PI
predeterminado con el tipo de límite Dentro:
=PINCompDat("cdf144","1:00",10,1,,"inside")
PINCompFilDat()
PINCompFilDat(tagname, stime, numvals, filtexp, filtcode, outcode,
PIServer)
Argumentos
numvals (entero) El número de puntos de datos comprimidos. Utilice un número negativo
para recopilar datos del archivo histórico que retrocede desde stime.
filtexp (cadena) La expresión de filtro. Para obtener más información sobre la sintaxis de la
expresión de filtro, consulte Expresiones de filtro (en la página 150).
filtcode (entero) Un código de filtro, utilice 1 para devolver el estado Filtrado y 0 para
omitirlo.
Devoluciones
Consulte Códigos de salida.
Ejemplo
La siguiente fórmula 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 condición del filtro es falsa. Los datos se
recuperan del servidor PI predeterminado con el tipo de límite Dentro.
44
Cuadro de diálogo Datos comprimidos (hora de inicio/hora de finalización)
de inicio y una hora de finalización. The number of data points retrieved for the given time
period is returned in the first cell. Si no se especifica una expresión de filtro, se ejecuta la
función PICompDat(). De lo contrario, se abre la función PICompFilDat().
Campos obligatorios
Nombre de tag
Hora de inicio
Hora de finalización
Si se especifica una expresión de filtro, el rango de valores comprimidos especificado se

recupera del servidor PI mientras una determinada expresión de filtro sea verdadera. Si se ha
seleccionado la opción marcar como filtrado, para cada grupo de valores que no satisfaga la
expresión de filtro se devolverá el estado "Filtrado". Para obtener más información sobre la
sintaxis de la expresión de filtro, consulte Expresiones de filtro (en la página 150).
Tipo de límite
Existen 4 tipos de límites:
Inside (Dentro) (predeterminado): devuelve puntos de datos a la hora de inicio y de

finalización y entre ellas.
Outside (Fuera): devuelve puntos de datos entre la hora de inicio y la hora de
finalización, incluido un punto de datos a la hora de inicio, o anterior a ella, y un punto de
datos a la hora de finalización, o anterior a ella.
Interpolated (Interpolado): devuelve puntos de datos entre la hora de inicio y la hora de
finalización, incluido un punto de datos interpolado a la hora de inicio y un punto de
datos interpolado a la hora de finalización.
Auto: igual que el límite interpolado, excepto si el código de resolución 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".

Seleccione cuenta oculta si no desea mostrar la cantidad de eventos de datos recuperados del
archivo histórico.
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 diálogo devuelve cadenas en blanco en las celdas de salida no utilizadas si
existe un número menor de valores en el archivo que el especificado originariamente por la
matriz de salida. Esta situación se puede producir si utiliza referencias de tiempo relativas.
Por ejemplo, si recupera valores que comiencen de y a y+5h, el número de valores del
servidor PI puede ser diferente al abrir la hoja de cálculo en días diferentes.
Excel la interprete como una cadena. Puesto que los nombres de tag en las expresiones de
filtro se cierran con comillas simples, si la expresión de filtro comienza con un nombre de tag
Temas relacionados
PICompDat() (en la página 46)
PICompFilDat() (en la página 47)
PICompDat()
PICompDat(tagname, stime, etime, outcode, PIServer)
Argumentos
46
etime (cadena) La hora de finalización en formato de hora PI.
Devoluciones
Ejemplo
La siguiente fórmula 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 mañana del
servidor PI predeterminado con el tipo de límite Dentro:
=PICompDat("cdf144","1:00","3:00",1,,"inside")
PICompFilDat()
PICompFilDat(tagname, stime, etime, filtexp, filtcode, outcode,
PIServer)
Argumentos
filtexp (cadena) La expresión de filtro. Para obtener más información sobre la sintaxis de
la expresión de filtro, consulte Expresiones de filtro (en la página 150).
omitirlo.

Devoluciones
Ejemplo
La siguiente fórmula 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 condición del filtro es falsa. Los datos se
recuperan del servidor PI predeterminado con el tipo de límite Dentro.
Cuadro de diálogo Datos de muestra
Este cuadro de diálogo recopila datos espaciados de forma uniforme, valores de muestra del
archivo histórico. Si no se especifica una expresión de filtro, se ejecuta la función
PISampDat(). De lo contrario, se abre la función PISampFilDat().
Campos obligatorios
Nombre de tag
Hora de inicio
Intervalo de tiempo
Si se especifica una expresión de filtro, el rango de valores comprimidos especificado se

recupera del servidor PI mientras una determinada expresión de filtro sea verdadera. Si se
selecciona la opción marcar como filtrado, se devuelve un estado "Filtrado" para cada
conjunto continuo (bloque) de valores de muestra que no satisfaga la expresión 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 expresión de filtro se devolverá el estado "Filtrado". Para obtener
más información sobre la sintaxis de la expresión de filtro, consulte Expresiones de filtro (en
la página 150).
48
Notas especiales
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 expresión de filtro comienza con un nombre de tag
Temas relacionados
PISampDat() (en la página 49)
PISampFilDat() (en la página 50)
PIExpDat() (en la página 51)
PISampDat()
PISampDat(tagname, stime, etime, interval, outcode, PIServer)
Argumentos
tagname (cadena) El tag para el cual desea datos de muestra.
interval (cadena) El intervalo de tiempo en formato de hora PI.
outcode (entero) Un código de salida; 0, 1, 2 ó 3.
Devoluciones
de salida
0 Datos de muestra
1 Marcas de tiempo Datos de muestra

Un código de salida 2 transpone la matriz de salida resultante de un código de salida 0

mientras que un código de salida 3 transpone la matriz de salida resultante de un código de
salida 1.
Ejemplo
La siguiente fórmula 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,)
También se devuelven marcas de tiempo.
PISampFilDat()
PISampFilDat(tagname, stime, etime, interval, filtexp, filtcode,
outcode, PI Server)
Argumentos
filtexp (cadena) La expresión de filtro. Para obtener más información sobre la sintaxis de
la expresión de filtro, consulte Expresiones de filtro (en la página 150).
omitirlo.
Devoluciones
de salida
0 Datos de muestra
Un código de salida 2 transpone la matriz de salida resultante de un código de salida 0 y el

código de salida 3 transpone la matriz de salida resultante de un código de salida 1.
50
Ejemplo
La siguiente fórmula 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 condición de filtro en la celda A1 se devuelve el estado "Filtrado".
PIExpDat()
PIExpDat(expression, stime, etime, interval, outcode, PIServer)
Argumentos
expression (cadena) La expresión de cálculo. Para obtener más información sobre la sintaxis
de la expresión de cálculo, consulte Expresiones de cálculo (en la
página 147).
Devoluciones
de salida
0 Datos calculados
1 Marcas de tiempo Datos calculados
Un código de salida 2 transpone la matriz de salida resultante de un código de salida 0

salida 1.
Ejemplo
La siguiente fórmula calcula la raíz 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")
También muestra las marcas de tiempo.

Cuadro de diálogo Datos temporizados
Este cuadro de diálogo devuelve valores de muestra de un solo tag que están sincronizados
con una matriz de marcas de tiempo. Existen dos modos de selección:
Interpolated (Interpolado): interpola valores en las marcas de tiempo especificadas, excepto

para los 4 tags de código de resolución 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
reenvía.
Exact Time (Tiempo exacto): recupera el valor del archivo histórico para una hora
especificada si existe una entrada en dicha hora. Si no existe ningún 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
monotónicamente crecientes o monotónicamente decrecientes.
Temas relacionados
PITimeDat() (en la página 52)
PITimeExpDat() (en la página 53)
PITimeDat()
PITimeDat(tagname, timestamps, PIServer, mode)
Argumentos
timestamps (referencia) Una referencia a una matriz de horas en formato PI. Para PI 2, los
valores en esta matriz de tiempo deben ser monotónicamente
crecientes o monotónicamente decrecientes.
mode (cadena) El modo de recuperación.
52
Devoluciones
Datos de muestra. Si las marcas de tiempo están en una sola columna, los datos se devuelven
en una sola columna. Si las marcas de tiempo están en una sola fila, los datos se devuelven en
una sola fila.
Ejemplo
La siguiente fórmula 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
expression (cadena) La expresión de cálculo. Para obtener más información sobre la
sintaxis de la expresión de cálculo, consulte Expresiones de cálculo
(en la página 147).
timestamps (referencia) Una referencia a una matriz de horas en formato PI. Para PI 2, los
valores en esta matriz de tiempo deben ser monotónicamente
crecientes o monotónicamente decrecientes.
Devoluciones
una sola fila.
Ejemplo
La siguiente fórmula calcula la raíz 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 diálogo Datos calculados
Este cuadro de diálogo devuelve un único valor calculado o valores calculados espaciados de
forma uniforme del archivo de datos PI. Los modos de cálculo son:

Total
Minimum (Mínimo)
Maximum (Máximo)
Standard deviation (Desviación estándar)
Range (Rango)
Average (Promedio)
Count (Cuenta)
Mean (Media)
Todos los modos de cálculo son de tiempo ponderado, excepto la función principal que es de
evento ponderado.
Campos obligatorios
Nombre de tag
Hora de inicio
Factor de conversión
Modo de cálculo
Intervalo
Para recuperar un único valor calculado, no especifique un intervalo y utilice la función

PICalcVal(). Para recuperar un dato calculado espaciado de forma uniforme, el intervalo
especificado determina el espaciado del cálculo y se utiliza la función PICalcDat().
Casilla de verificación
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 cálculo. El valor de porcentaje correcto
se suele devolver a la derecha de la celda de valor calculado. Si selecciona la casilla de
verificación filas, el valor de porcentaje correcto se devuelve a la celda situada debajo de la
celda de valor calculado.
54
Las marcas de tiempo se devuelven cuando el modo de cálculo es mínimo, máximo o rango.
Modo Columna 1 Columna 2 Columna 3
Mínimo Tiempo del valor mín. Valor mínimo
Máximo Tiempo del valor máx. Valor máximo
Rango Tiempo del valor mín. Tiempo del valor máx. Valor de rango
Notas especiales
Si no se especifica un intervalo y el modo es Total, Desviación estándar, Promedio, Cuenda o

Media, no se mostrarán las marcas de tiempo, aunque se haya seleccionado la casilla de
verificación Mostrar marcas de tiempo.
Si se especifica un intervalo y el modo es Máx o Mín, las marcas de tiempo mostradas son la
hora de inicio de cada intervalo de cálculo.
Cuando el modo de cálculo 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
fracción del período de tiempo con datos archivados correctos. Esta normalización de datos
es equivalente a la suposición 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 suposición puede no ser
válida cuando una amplia fracción 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 cálculo.
El factor de conversión se utiliza más a menudo cuando el modo de cálculo 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 mayoría de los servidores PI 2, el valor predeterminado
de totalización es "unidades por día". En el servidor PI 2, el tiempo de totalización
predeterminado (totdefaulttime es la unidad de tiempo en segundos) se puede encontrar en el
archivo pilink:piparams.for.
La siguiente tabla muestra los factores de conversión para dos de las unidades de tiempo
predeterminadas del servidor PI 2 común frente a diversas unidades de tag de flujo.
Unidad de tag El valor predeterminado del El valor predeterminado del servidor es
de flujo servidor es unidades/día unidades/hora (totdefaulttime = 3600)
(totdefaulttime = 86400)
Unidades/día 1.0 0.041667
Unidades/hora 24 1
Unidades/minuto 1440 60
Unidades/segun 86400 3600
do

Temas relacionados
PICalcVal() (en la página 56)
PICalcDat() (en la página 57)
PICalcVal()
PICalcVal(tagname, stime, etime, mode, cfactor, outcode, PIServer)
Argumentos
tagname (cadena) El tag para el cual desea el valor calculado.
mode (cadena) El modo de cálculo (total, mínimo, máximo, desviación estándar, rango,
promedio, cuenta o media).
cfactor (número) Un factor de conversión multiplicador. Debe ser 1 para máx, mín,
promedio, cuenta, media, desviación estándar y rango. Para obtener más
información sobre el factor de conversión, consulte Notas especiales
(consulte "Cuadro de diálogo Datos calculados" en la página 53) en Cuadro
de diálogo Datos calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7 excepto 3.
Devoluciones
Si el código de salida es 0, sólo se devuelve el valor calculado.
Si el código de salida es 1, se aplica lo siguiente:

Total Valor total
Stdev Valor Stdev.
Promedio Valor de promedio
Cuenta Valor de cuenta
Media Valor de media
56
Un código de salida 2 transpone la matriz de salida que resulta de un código de salida 1; p.ej.,
los resultados se devuelven en filas en vez de en columnas.
El código de salida 3 no se utiliza.
Si el código de salida es 4, el porcentaje correcto se devuelve a la derecha de la celda de

valor.

Modo Columna 1 Columna 2 Columna 3 Columna 4
Total Valor total Porcentaje correcto
Mínimo Tiempo del valor mín. Valor mínimo Porcentaje
correcto
Máximo Tiempo del valor Valor máximo Porcentaje
máx. correcto
Stdev Valor Stdev. Porcentaje correcto
Rango Tiempo del valor mín. Tiempo del valor Valor de rango Porcentaje
máx. correcto
Promedio Valor de promedio Porcentaje correcto
Cuenta Valor de cuenta Porcentaje correcto
Media Valor de media Porcentaje correcto
Ejemplo
La siguiente fórmula 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)

Argumentos
tagname (cadena) El tag para el cual desea los datos calculados.
mode (cadena) El modo de cálculo (total, mínimo, máximo, desviación estándar,
rango, promedio, cuenta o media).
cfactor (número) Un factor de conversión multiplicativo. Debe ser 1 para máx, mín,
promedio, cuenta, media, desviación estándar y rango. Para obtener
más información sobre el factor de conversión, consulte Notas
especiales (consulte "Cuadro de diálogo Datos calculados" en la
página 53) en Cuadro de diálogo Datos calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7.
Devoluciones
El código de salida afecta a la salida de la forma siguiente:
0 Valores calculados en una columna

1 Marcas de tiempo y valores en 2 columnas
2 Valores calculados en una fila
3 Marcas de tiempo y valores en 2 filas
4 Valores y pctgood en 2 columnas
5 Marcas de tiempo, valores y pctgood en 3 columnas
6 Valores y pctgood en 2 filas
7 Marcas de tiempo, valores y pctgood en 3 filas
Ejemplo
La siguiente fórmula 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 PILogin.ini:
=PICalcDat(b1,"y","t","3h","total",24,1,)
También se devuelven marcas de tiempo. Los valores se multiplican por 24 antes de
mostrarse en la hoja de cálculo.
58
Cuadro de diálogo Datos calculados avanzados
Este cuadro de diálogo devuelve un único valor calculado o valores calculados espaciados de
forma uniforme del archivo de datos PI. Los modos de cálculo son:
Total
Minimum (Mínimo)
Maximum (Máximo)
Standard deviation (Desviación estándar)
Range (Rango)
Average (Promedio)
Count (Cuenta)
Campos obligatorios
Nombre de tag o expresión. Para obtener más información sobre la sintaxis de la

expresión de cálculo, consulte Expresiones de cálculo (en la página 147).
Hora de inicio
Modo de cálculo
Si se especifica una expresión de filtro, los resúmenes solicitados en el punto de origen se

calculan para los rangos de tiempo en los que la expresión se evalúe como verdadera. Para
obtener más información sobre la sintaxis de las expresiones de filtro, consulte Expresiones
de filtro (en la página 150).
Intervalo
Para recuperar un único valor calculado, no especifique ningún intervalo. Para recuperar
datos calculados espaciados de forma uniforme, el intervalo especificado determina el
espaciado del cálculo.

Modo Muestreo de expresión
Existen 3 modos de muestreo de expresión para realizar una muestra de la expresión de filtro:
Pt. Compressed (Pto. comprimido) (predeterminado): evalúa la expresión de filtro en la

marca de tiempo para cualquier valor comprimido del punto de origen.
Exp Compressed (Exp. comprimida): evalúa la expresión de filtro en la marca de tiempo
de cualquier valor comprimido de cualquier tag de la expresión de filtro.
Interpolated (Interpolado): evalúa la expresión de filtro en intervalos de muestra
espaciados de forma uniforme.
Existen 2 modos de muestreo de expresión para realizar una muestra de las expresiones que
se van a resumir:
Compressed (Comprimido) (predeterminado): evalúa la expresión en la marca de tiempo

de cualquier valor comprimido de cualquier tag de la expresión.
Interpolated (Interpolado): evalúa la expresión en intervalos de muestra espaciados de
forma uniforme.
Intervalo de muestreo de expresión
Si el modo Muestreo de expresión se especifica como interpolado, el intervalo de muestreo de

expresión especificado determina el espaciado con el que se evalúa la expresión. Si el modo
Muestreo de expresión no se interpola, el intervalo de muestreo de la expresión se ignora.
Bases de cálculo
Existen dos tipos de bases de cálculo:
Time Weighted (Tiempo ponderado) (predeterminado): pondera los valores del cálculo
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 cálculo correcto.
Para la desviación estándar son necesarios dos eventos.
Porcentaje correcto mínimo
El porcentaje correcto mínimo es el porcentaje mínimo de datos correctos a lo largo del rango
temporal con el que se devolverán datos en lugar de un error "Datos correctos insuficientes".
60
Consulte la descripción de casilla de verificación que se ofrece en Cuadro de diálogo Datos

calculados (en la página 53).
Notas especiales
Consulte la descripción de notas especiales que se ofrece en Cuadro de diálogo Datos

Temas relacionados
PIAdvCalcVal() (en la página 61)
PIAdvCalcFilVal() (en la página 62)
PIAdvCalcExpVal() (en la página 64)
PIAdvCalcExpFilVal() (en la página 65)
PIAdvCalcDat() (en la página 66)
PIAdvCalcFilDat() (en la página 67)
PIAdvCalcExpDat() (en la página 68)
PIAdvCalcExpFilDat() (en la página 69)
PIAdvCalcVal()
PIAdvCalcVal(tagname, stime, etime, mode, calcbasis, minpctgood,
cfactor, outcode, PIServer)
Argumentos

mode (cadena) El modo de cálculo (total, mínimo, máximo, desviación
estándar, rango, promedio, cuenta o media).
calcbasis (entero) La base del cálculo. 0 para tiempo ponderado; 1 para evento
ponderado.
minpctgood (número) Porcentaje mínimo de datos correctos durante un rango
temporal.
Cfactor (número) Un factor de conversión multiplicativo. Debe ser 1 para máx,
mín, promedio, cuenta, media, desviación estándar y rango.
Para obtener más información sobre el factor de conversión,
consulte Notas especiales (consulte "Cuadro de diálogo Datos
calculados" en la página 53) en Cuadro de diálogo Datos
Devoluciones
Para obtener información sobre la función PICalcVal() (en la página 56), consulte la sección
Devoluciones.
Ejemplo
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
62
filtexp (cadena) La expresión de filtro. Para obtener más información sobre la
sintaxis de las expresiones de filtro, consulte Expresiones de
filtro (en la página 150).
ponderado.
sampmode (cadena) El modo de muestreo (pto. comprimido, exp. comprimida o
interpolado).
sampinterval (cadena) El intervalo de muestreo en formato de hora PI.
temporal.
Cfactor (número) Un factor de conversión multiplicativo. Debe ser 1 para máx,
consulte Notas especiales (consulte "Cuadro de diálogo
Datos calculados" en la página 53) en Cuadro de diálogo
Datos calculados (en la página 53).
Devoluciones
Devoluciones.
Ejemplo
hoy durante los períodos 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 pt.compressed es el modo de muestreo
especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresión en
los eventos comprimidos de cdf144. El minpctgood es del 50 por ciento, por lo que
únicamente se mostrarán resultados si el porcentaje correcto es del 50% o superior. El

PIAdvCalcExpVal()
PIAdvCalcExpVal(expression, stime, etime, mode, calcbasis, sampmode,
sampinterval, minpctgood, cfactor, outcode, PIServer)
Argumentos
expression (cadena) La expresión para la que desea el valor de archivo histórico.
ponderado.
sampmode (cadena) El modo de muestreo (comprimido o interpolado).
temporal.
cfactor (número) Un factor de conversión multiplicativo. Debe ser 1 para máx,
consulte Notas especiales (consulte "Cuadro de diálogo Datos
calculados" en la página 53) en Cuadro de diálogo Datos
Devoluciones
Devoluciones.
Ejemplo
La siguiente fórmula calcula un total de tiempo ponderado para la expresión '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 expresión en los eventos
comprimidos combinados de cdf144 y cdt158. El minpctgood es del 50 por ciento, por lo que
64
PIAdvCalcExpFilVal()
PIAdvCalcExpFilVal(expression, stime, etime, filtexp, mode,
calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode,
PIServer)
Argumentos
expression (cadena) La expresión para la que desea el valor de archivo histórico.
ponderado.
temporal.
Devoluciones
Devoluciones.
Ejemplo

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


PIAdvCalcDat()
PIAdvCalcDat(tagname, stime, etime, interval, mode, calcbasis,
minpctgood, cfactor, outcode, PIServer)
Argumentos
ponderado.
temporal.
Devoluciones
Para obtener información sobre la función PICalcDat() (en la página 57), consulte la sección
Devoluciones.
Ejemplo
La siguiente fórmula 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
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
PIAdvCalcFilDat()
PIAdvCalcFilDat(tagname, stime, etime, interval, filtexp, mode,
calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode,
PIServer)
Argumentos
filtexp (cadena) La expresión de filtro. Para obtener más información sobre
la sintaxis de las expresiones de filtro, consulte Expresiones
calcbasis (entero) La base del cálculo. 0 para tiempo ponderado; 1 para
evento ponderado.
sampmode (cadena) El modo de muestreo (pto. comprimido, exp. comprimida o
interpolado).
temporal.
Devoluciones
Devoluciones.

Ejemplo
La siguiente fórmula recupera totales para el tag cdf144 desde la medianoche de ayer hasta la
medianoche de hoy en intervalos de 3 horas durante los períodos 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 pt.compressed es el modo de muestreo
especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresión 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
expression (cadena) La expresión para la cual desea los datos calculados.
calcbasis (entero) La base del cálculo. 0 para tiempo ponderado; 1 para
evento ponderado.
temporal.
cfactor (número) Un factor de conversión multiplicativo. Debe ser 1 para
máx, mín, promedio, cuenta, media, desviación estándar y
rango. Para obtener más información sobre el factor de
conversión, consulte Notas especiales (consulte "Cuadro
de diálogo Datos calculados" en la página 53) en Cuadro
68
Devoluciones
Devoluciones.
Ejemplo
La siguiente fórmula recupera totales para la expresión '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,)
PIAdvCalcExpFilDat()
PIAdvCalcExpFilDat(expression, stime, etime, interval, filtexp,
mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor,
outcode, PIServer)
Argumentos
expression (cadena) La expresión para la que desea el valor de archivo
histórico.
filtexp (cadena) La expresión de filtro. Para obtener más información
sobre la sintaxis de las expresiones de filtro, consulte
Expresiones de filtro (en la página 150).
calcbasis (entero) La base del cálculo. (tiempo ponderado o evento
ponderado).
temporal.

cfactor (número) Un factor de conversión multiplicativo. Debe ser 1 para
máx, mín, promedio, cuenta, media, desviación estándar
y rango. Para obtener más información sobre el factor de
conversión, consulte Notas especiales (consulte "Cuadro
de diálogo Datos calculados" en la página 53) en Cuadro
Devoluciones
Devoluciones.
Ejemplo

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,)
Cuadro de diálogo Filtrado de tiempo
Este cuadro de diálogo devuelve la cantidad de tiempo para la que una expresión dada es
verdadera en un rango temporal especificado. El usuario puede especificar múltiples rangos
temporales como intervalos espaciados de forma uniforme, como en el cuadro de diálogo
Datos calculados.
Campos obligatorios
Expresión. Para obtener más información sobre la sintaxis de la expresión de cálculo,

consulte Expresiones de cálculo (en la página 147).
Hora de inicio
70
Unidades de tiempo (predeterminadas a segundos)
Notas especiales
Si introduce la expresión en una celda de la hoja de cálculo y hace referencia a ella en el

cuadro de diálogo, comience la expresión 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 expresión de filtro comienza con un nombre de tag y va a almacenarla
en una celda o en la hoja de cálculo, deberá iniciar dicha expresión con dos comillas simples.
Temas relacionados
Expresiones de cálculo (en la página 147)
PITimeFilterVal() (en la página 71)
PITimeFilter() (en la página 72)
PITimeFilterVal()
PITimeFilterVal(expression, stime, etime, timeunit, outcode,
PIServer)
Argumentos
expression (cadena) La expresión de cálculo. Para obtener más información sobre
la sintaxis de la expresión de cálculo, consulte Expresiones
de cálculo (en la página 147).
timeunit (cadena) La unidad de tiempo del resultado que se va a mostrar. Las
entradas válidas son: segundos, minutos, horas y días.
Devoluciones
Si el código de salida es 0, 1 o 2, sólo se devuelve el valor calculado.

Si el código de salida es 4 o 5, el porcentaje correcto se devuelve a la derecha de la celda

de valor.
Si el código de salida es 6 o 7, el porcentaje correcto se devuelve debajo de la celda de
valor.
Ejemplo
La siguiente fórmula calcula la cantidad de tiempo que la expresión 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 cálculo se expresa en segundos.
PITimeFilter()
PITimeFilter(expression, stime, etime, interval, timeunit, outcode,
PIServer)
Argumentos
expression (cadena) La expresión de cálculo. Para obtener más información sobre
la sintaxis de la expresión de cálculo, consulte Expresiones
de cálculo (en la página 147).
timeunit (cadena) La unidad de tiempo del resultado que se va a mostrar. Las
Devoluciones
de salida
0 Datos calculados
72

Ejemplo
La siguiente fórmula calcula la cantidad de tiempo que la expresión 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")
También muestra las marcas de tiempo para la hora de inicio de cada intervalo de cálculo. El
resultado del cálculo se expresa en segundos.
Cuadro de diálogo Identificador del punto para tag
Este cuadro de diálogo devuelve el nombre de tag del identificador del punto especificado.
Campos obligatorios
Identificador de punto
Temas relacionados
PIPointIDToTag() (en la página 73)
PIPointIDToTag()
PIPointIDToTag(pointid, PIServer)
Argumentos
PointID (cadena) Número de identificación interno único que no se reutiliza al
eliminar un punto.
Devoluciones
Nombre de tag

Ejemplo
La siguiente fórmula devuelve el nombre de tag del tag con identificador de punto 123 del
servidor denominado THEVAX.
=PIPointIDToTag("123","thevax")
Cuadro de diálogo Máscara de atributo para tag
Este cuadro de diálogo devuelve una lista de tags correspondientes a las máscaras de atributos
de tag especificadas.
Campos obligatorios
Nombre de tag
Descriptor
Origen de punto
Tipo de punto
Clase de punto
Unidades de ingeniería
Temas relacionados
PIAttributeMaskToTag () (en la página 74)
PIAttributeMaskToTag ()
PIAttributeMaskToTag(tagname, descriptor, pointsource, pointtype,
pointclass, engunits, outcode, PIServer)
Argumentos
tagname (cadena) Máscara de nombre del tag.
descriptor (cadena) Máscara de descriptor.
pointsource (cadena) Máscara de fuente del punto.
pointtype (cadena) Máscara de tipo de punto.
pointclass (cadena) Máscara de Clase de punto.
74
engunits (cadena) Máscara de unidades de ingeniería.
outcode (entero) Un código de salida; 0 o 2.
Devoluciones
de salida
0 Nombre de
tag
Ejemplo
La siguiente fórmula devuelve el nombre de tag de los tags que empiezan por "sin" en el
servidor denominado THEVAX.
=PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")
Cuadro de diálogo Alias
Este cuadro de diálogo devuelve un nombre de tag cuando se especifica un alias.
Campos obligatorios
Alias
Ruta de módulo
Fecha de consulta
Temas relacionados
PIAliasToTag() (en la página 75)
PIAliasToTag()
PIAliasToTag(alias, modulepath, querydate, outcode, PIServer)

Argumentos
alias (cadena) Elemento del módulo que es una referencia a un punto PI.
modulepath (cadena) Ruta completa a un módulo de la base de datos de módulos.
querydate (entero) Consulta de módulos con fechas efectivas en el momento o después de esta
fecha.
Outcode (entero) Un código de salida; 0, 1 o 2.
Devoluciones
de salida
0 Nombre de
tag
1 Nombre de Servidor de tag
tag
Ejemplo
La siguiente fórmula devuelve el nombre de tag correspondiente al alias "Temperature" del

módulo "Reactor1" que es un submódulo de "Unit1". "Unit1" está en la raíz de la base de
datos de módulos de un servidor PI denominado THEVAX. La base de datos de módulos se
consulta a la hora actual.
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")
Cuadro de diálogo Propiedad
Este cuadro de diálogo devuelve un valor cuando se especifica una propiedad.
Campos obligatorios
Propiedad
Ruta de módulo
Fecha de consulta
76
Temas relacionados
PIPropertyToValue() (en la página 77)
PIPropertyToValue()
PIPropertyToValue (property, modulepath, querydate, PIServer, outcode)
Argumentos
Property (cadena) Elemento del módulo que tiene un valor virtual cualquiera.
modulepath (cadena) Ruta completa a un módulo de la base de datos de módulos.
querydate (entero) Consulta de módulos con fechas efectivas en el momento o después de esta
fecha.
Outcode (entero) Un código de salida; 0 o 2.
Devoluciones
Un código de salida 0 muestra el valor de la propiedad en una columna.
Un código de salida 2 muestra el valor de la propiedad en una fila.
Ejemplo
La siguiente fórmula devuelve el valor correspondiente a la propiedad "Implementer" del

módulo "Reactor1" que es un submódulo de "Unit1". "Unit1" está en la raíz de la base de
datos de módulos de un servidor PI denominado THEVAX. La base de datos de módulos 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 cálculo de
Excel. La trend puede mostrar datos de la hoja de cálculo y de un tag del servidor PI.

Para crear una trend, se proporciona un asistente de trends que facilita la inserción de trends.
Hay dos fuentes de datos que Trend Control puede trazar:
Datos de la hoja de cálculo
Datos PI
Datos de la hoja de cálculo
El Asistente de trends se puede utilizar para crear una trend desde los datos de una hoja de
cálculo de Excel.
78
Si los datos proceden de la hoja de cálculo, se deberá especificar el rango de celdas de los
datos. El rango de celdas se puede introducir manualmente o se puede utilizar el ratón para
especificarlo. Para especificar el rango con el ratón, haga clic en el botón a la derecha del
campo. Aparecerá otro cuadro de diálogo. Al seleccionar el rango en la hoja de cálculo, se
generará el formato de referencia de celdas en el cuadro de diálogo.
La opción El primer elemento es el nombre de trace se utiliza cuando se va a dar un

nombre al trace de la trend. Si esta opción 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 opción Incluir todas las celdas en la
matriz está especificada como predeterminada. Si esta opción está especificada, entonces
solo habrá que especificar una celda de la matriz para el rango de celdas. El resto de la matriz
se añade automáticamente a la referencia de rangos de celda cuando se selecciona el botón
Añadir ->.
La opción Trazar como datos escalonados proporciona al trace una apariencia de vista
escalonada. Esta opción suele especificar tags discretos.
Datos de PI
El Asistente de trends también se puede utilizar para crear una trend con datos procedentes
directamente del servidor PI.

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 botón Buscar..., aparece el cuadro de diálogo Búsqueda de tags. Este es el
mismo cuadro de diálogo Búsqueda de tags que el del menú PI. Todos los tags que se
seleccionen en el cuadro de diálogo Búsqueda de tags se añadirán automáticamente 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 separación regular a lo largo
del trace y no indican puntos de datos de archivo histórico. Seleccione la casilla de
verificación Marcadores para mostrar los marcadores que indican la ubicación de los puntos
de datos de archivo histórico en el trace.
Otra forma de especificar los tags es por referencia de celdas. Si los nombres de tag están en
la hoja de cálculo de Excel, se podrán 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.
Después de hacer clic en Siguiente, habrá que especificar la hora de inicio y la hora de
finalización de la trend en el formato de hora PI.
Título y posición de la trend
La última pantalla sirve para configurar el título de la trend y la posición de la trend.
80
Si se selecciona una nueva hoja de cálculo, la trend se colocará en la esquina superior

izquierda de una hoja de cálculo en blanco.
Para mostrar los iconos de atributo de valor en la parte superior de la trend, seleccione la
casilla de verificación Mostrar atributos de valor; los iconos aparecerán cuando el rango de
datos contenga eventos que tengan establecidos los bits Cuestionable, Sustituido o Anotado.
Si se especifica la opción de hoja de cálculo 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. Asegúrese 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 eliminarán. Para mover la trend, haga clic con el botón
derecho del ratón en la trend y seleccione Mover/Cambiar tamaño.
Menú del botón derecho del ratón
Después de insertar la trend en la hoja de cálculo Excel, se pueden realizar cambios rápidos
en la misma seleccionando algunos de los elementos en el menú derecho del ratón.

Para cambiar la escala del eje Y, puede seleccionar la opción Cambiar escala.... De este modo,
podrá cambiar tanto el rango temporal como el eje Y de la trend. Si desea eliminar algún
cambio de la escala, puede seleccionar la opción Revertir para deshacer los cambios
realizados. La opción Revertir siempre revierte a los ajustes definidos en el Asistente de
trends.
Para desplazarse, puede habilitar las barras de desplazamiento con la opción Barra de
desplazamiento. La barra de desplazamiento se mostrará en la parte inferior de la trend. De
nuevo, se puede utilizar la opción 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 opción Formato....
Por ejemplo, se puede utilizar esta opción para cambiar el color o el grosor de línea de un
trace. También, se puede utilizar para añadir 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 opción Exportar datos... pega los valores utilizados para trazar la
trend en la hoja de cálculo. La opción Mover/Cambiar tamaño mueve y cambia el tamaño de
la trend por el del rango de celdas especificado. La opción Copiar/Pegar copia la trend al
portapapeles y, a continuación, 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
Información adicional
Para obtener información adicional acerca de la utilización de Trend Control, pulse el botón
Ayuda en el Asistente para trends. También hay archivos de ayuda adicionales en
...\PIPC\HELP\PITrend*. Por ejemplo, para saber más acerca de la automatización de
Trend Control, hay un archivo de ayuda ...\PIPC\HELP\PITrendAuto.hlp.
Cuadro de diálogo Búsqueda de tags
Este cuadro de diálogo permite buscar tags desde los servidores PI y copiar los resultados a la
hoja de cálculo. 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 después presione la tecla
MAYÚS y haga clic en la parte inferior del rango. Haga clic en Aceptar para copiar tags a la
hoja de cálculo. Si la opción "Copiar nombre de PIServer" del cuadro de diálogo Ajustes...
está activada, el servidor PI de cada tag se copiará a la hoja de cálculo junto con los nombres
de tag.
Los tags se copian en la hoja de cálculo en una sola columna o en una sola fila, dependiendo
de la opción seleccionada en la sección "Copiar elementos a la hoja" del cuadro de diálogo
Ajustes... de PI DataLink.

La posición inicial en donde se realiza el copiado es la celda actual. Si la opción "Copiar

nombre de PIServer" está activada, los nombres de los servidores se copiarán a una columna
situada a la derecha de los nombres de tag de la hoja cálculo cuando se seleccione la opción
En una columna de la sección "Copiar elementos a la hoja". Si la opción En una fila está
activada en la sección "Copiar elementos a la hoja", los nombres de servidor se copiarán bajo
los nombres de tag de la hoja de cálculo.
Cuadro de diálogo Module Database
Este cuadro de diálogo permite buscar alias, propiedades y módulos desde los servidores PI y
copiar los resultados a la hoja de cálculo.
El cuadro de diálogo consiste principalmente en una vista de árbol de la base de datos de

módulos. El cuadro de diálogo permite a los usuarios copiar los elementos de la base de datos
de módulos a la hoja de cálculo. El árbol de vistas muestra tres tipos de elementos de la base
de datos de módulos.
84
Alias
Propiedades
Módulos
Hay dos formas de seleccionar los alias y las propiedades de la base de datos de módulos, con
cada método se copia un conjunto distinto de elementos en la hoja de cálculo.
Seleccionar sólo un elemento, que copia dicho elemento a la hoja de cálculo.
Seleccionar el elemento "Alias" o "Propiedades" de un módulo, que copia todos los alias
o propiedades de dicho módulo respectivamente.
Si se activa la opción "copiar ruta del módulo", se copiará toda la ruta de módulo del alias o
propiedad, junto con el alias o propiedad, a una celda adyacente de la hoja de cálculo.
Al seleccionar un módulo, seleccionando sólo un módulo y seleccionando copiar ruta del

módulo, se copiará toda la ruta del módulo a la hoja de cálculo. Si la casilla de verificación
copiar ruta del módulo no está activada, entonces sólo se pegará el nombre del módulo a la
hoja de cálculo.
La lista desplegable Servidor PI se puede utilizar para alternar entre las bases de datos de
módulos 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 módulos mostrada. Si la opción
"Copiar nombre de PIServer" del cuadro de diálogo Ajustes... está activada, el servidor PI de
cada uno de los elementos de la base de datos de módulos se copiará a la hoja de cálculo
junto con el elemento de la base de datos de módulos.
Cuadro de diálogo Conexiones
Un cuadro de diálogo administra sus conexiones con el servidor PI.

Mediante el menú del botón derecho del ratón, puede añadir 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 verificación para conectarse y desconectarse de los

servidores PI de la lista. Después de conectarse correctamente al servidor PI, el campo Estado
se activa, la columna de usuario muestra el usuario al que se ha conectado la conexión y la
columna de la versión PI muestra la versión del servidor PI al que se ha conectado.
Cuadro de diálogo Ajustes
Este cuadro de diálogo controla sus ajustes y preferencias de PI DataLink.
86
El conjunto de botones de exclusión mútua En una fila o En una columna determina si

los tags seleccionados en el cuadro de diálogo TagSearch se copian a la hoja de cálculo
en una fila o en una columna.
La casilla de verificación Copiar nombre de PIServer determina si el nombre del
servidor PI se copia en el campo de edición de PIServer en el caso de que se llame a
TagSearch desde un cuadro de diálogo PI. Esta opción también determina si los nombres
del servidor se copian a la hoja de cálculo de los tags seleccionados en el caso de que se
llame a TagSearch directamente desde el menú PI.
La casilla de verificación 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 información de zona horaria del equipo cliente. Esta opción afecta a los
sistemas en los que el equipo del servidor PI 3 tiene una configuración de zona horaria
diferente a la del equipo cliente.
La casilla de verificación 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 tamaño de
la matriz de funciones DataLink. Seleccione esta casilla de verificación cuando los
resultados de la función DataLink sean trazados por el paquete de gráficos de Excel.
La casilla de verificación Independiente regional determina si se deben utilizar las
cadenas de hora localizadas al analizar los datos de hora.

• Seleccione esta casilla de verificación 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 inglés como idioma de las
cadenas.
• Desactive esta casilla de verificación para que PI DataLink pueda analizar la cadena
de hora según su configuración regional, que incluye las preferencias de formato de
fecha y hora. Si falla el análisis específico regional, PI DataLink intentará analizar de
acuerdo con las reglas de formato de hora PI.
El cuadro de edición Formato de número permite especificar un código de formato de
número predeterminado. Esta cadena puede ser cualquier código válido de la lista
Formato/Celdas/Número.
El cuadro de edición Formato de hora permite especificar un código de formato de hora
predeterminado. Esta cadena puede ser cualquier código válido de la lista
Formato/Celdas/Número.
Seleccione Aceptar para guardar su configuración y Cancelar para cancelar sus cambios.
Acerca de
Esta opción de menú muestra información de la versión PI DataLink.
Ayuda
Esta opción 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 cálculo al servidor PI. La función 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 histórico por el nuevo valor
introducido por el usuario.
PIPutVal() sólo se puede invocar desde una hoja de macros de Excel o desde un módulo
VBA de Excel usando el método application.run. Consulte el archivo
...\PIPC\EXCEL\piexam32.xls para saber cómo llamar a PIPutVal en un módulo
VBA. Específicamente, observe los tags marcados "PutVal" y el módulo VBA
"PutVal_code".
88
Escribir datos de Excel a PI
PIPutVal()
PIPutVal(tagname, value, time stamp, PIServer, outcell)
Argumentos
tagname (cadena) El tag para el que se escribe el valor en PI.

value (referencia) La referencia que se escribe de un valor. Puede ser una
cadena (para estados digitales) o un número.
time stamp (cadena) Una marca de tiempo en formato de tiempo PI.
outcell (referencia) Una referencia a una celda en la que se muestra el valor
devuelto de esta función de macros.
Devoluciones
La cadena FALSO se devolverá si la función 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 función (PIPutVal) no comprueba si el número 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 creación 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 información de la zona horaria del equipo cliente, a menos
que la opción "Utilizar la zona horaria del servidor PI" esté habilitada o se trate de
un servidor PI 2.
Ejemplo
La siguiente fórmula 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)

El resultado de la función de macros se coloca en la celda E5 de la hoja de macros.
Límites de Excel para PI DataLink
Excel tiene una limitación en el número de elementos de la matriz de cálculos. PI DataLink

está sujeto a este limitación. Por lo tanto, hay un número máximo de valores que se pueden
devolver para una función PI única. El número máximo de eventos PI por recuperación es
65536.
El SDK de Excel que utiliza PI DataLink tiene una longitud de cadena de máximo 255
caracteres. Por ello, las cadenas de entrada de DataLink, como las fórmulas 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
Capítulo 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. Además, 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 expresión determinada es verdadera.
Datos comprimidos (archivados).
Datos comprimidos mientras una expresión determinada es verdadera.
Datos del tag PI de muestra sincronizados con una matriz de marcas de tiempo
especificadas por el usuario.
Datos de los cálculos en las expresiones de tag PI.
La cantidad de tiempo durante el cual una expresión de tag PI determinada fue verdadera.
Totales, mínima, máxima, desviaciones estándar, rangos, promedios y métodos para tags
PI.
Tutorial
El objetivo de esta sección es iniciarle en el uso de PI DataLink en Lotus 1-2-3 lo más rápido
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.

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 página de diálogos. Seleccione el botón
<cuadros de diálogo> para cargar los cuadros de diálogo situados bajo la opción de menú
PI. Asegúrese de que la opción de menú PI está en la barra de menús de Lotus 1-2-3. Si el
menú PI no aparece en el menú principal de 1-2-3, consulte la sección Resolución de
problemas (en la página 141).
Desde el menú de PI, seleccione Conexiones...
Si el estado indica que el servidor PI está DESCONECTADO, haga clic en el botón

Conectar. Si la cuenta de usuario predeterminada del servidor PI seleccionado requiere una
contraseña, aparecerá el cuadro de diálogo de inicio de sesión en el que se le solicitará la
contraseña.
En este cuadro de diálogo también se puede modificar el nombre de usuario para el inicio de
sesión y utilizar uno diferente al del usuario predeterminado.
92
Tutorial
Un nombre de usuario o contraseña válido cambia el Estado del cuadro de diálogo

Conexiones a LECTURA o LECTURA/ESCRITURA. Cierre el cuadro de diálogo
Conexiones haciendo clic en Cancelar.
Si aparece un cuadro de diálogo de fallo al iniciar la sesión, confirme que su nombre de

usuario y su contraseña PI sean válidos. Si el cuadro de diálogo de fallo al iniciar la sesión
aparece a pesar de que el nombre de usuario y la contraseña PI son válidos, quiere decir que
PI DataLink no se puede conectar al servidor PI. Consulte la sección Resolución de
problemas (en la página 141).
Atributos del tag y valor actual
En este ejemplo, obtendremos el descriptor del tag, el valor actual y las unidades de
ingeniería de unos pocos tags.
1. Cargue el archivo ...\pipc\lotus\pidl_tutorial.123.
2. Conéctese a un servidor PI válido en el cuadro de diálogo de conexiones.
3. En la barra de menús de PI, seleccione Ajustes... y asegúrese de que está seleccionado el

botón de exclusión mútua "En una columna" de la sección "Copiar elementos a la hoja".

4. A continuación, cierre el cuadro de diálogo y sitúe el cursor en la celda A2 de la hoja de

cálculo.
5. Seleccione Búsqueda de tags... en el menú PI e introduzca BA en el campo Máscara 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
búsqueda 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 búsqueda 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 edición

Salida de datos.
9. Haga clic en el botón a la derecha de la segunda casilla de edición "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 introducción manual también son aceptables.
11. Cuando la casilla de edición contenga un rango válido, pulse Aceptar. Observe cómo el
rango seleccionado aparece en la casilla de edición del cuadro de diálogo Atributos del
tag. Si se selecciona una sola celda, el texto de dicha celda también se mostrará en el
cuadro de edición de nombre del tag. Si se selecciona un rango, entonces sólo se mostrará
el rango y no habrá nada escrito en la casilla de edición 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 válido. Los rangos no válidos son rangos múltiples, rangos que
consisten en más de una hoja, un rango que consista en más de una columna y una fila o
cualquier dirección de celda que no contenga nombres de tag.
12. Desplácese desde el cuadro de lista etiquetado "Atributos" hasta que la palabra
"Descriptor" se haga visible. Seleccione "Descriptor".
13. En el cuadro de edición etiquetado "Salida de macros [opc]", introduzca manualmente la

dirección de la celda como A:A10. Como alternativa, se puede seleccionar el botón

"celda", como se describe arriba. Esta opción escribirá el código de macro asociado con
{PITAGATT} a la dirección de la celda de salida de macros. Observe cómo la dirección
de la celda se utiliza en el código de macro cuando se designa una dirección de celda en
el cuadro de edición de dirección del nombre de tag. El nombre de tag absoluto se utiliza
al escribir un nombre de tag en el cuadro de edición de nombre del tag. Si se utilizan la
dirección 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 edición designado. No se requiere ninguna
entrada en el cuadro de edición 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. También escribirá el código 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 edición situado bajo el nombre del tag, introduzca manualmente
la dirección de celda A:A2..A:A6 o haga clic en el botón situado junto al cuadro de
edición y seleccione A:A2..A:A6.
18. En el cuadro de edición etiquetado "Salida de macros [opc]", observe cómo la dirección
de celda A:A15 ya existe. Ésta es una función que pega automáticamente el código de
macro bajo la entrada de código de macro anterior hasta que el usuario ejecuta un cuadro
de diálogo sin una dirección de celda en el cuadro de edición "Salida de macros [opc]".
19. En la casilla de edición Salida de datos, observe cómo la dirección predeterminada de la

celda ya es A:C2.
20. Bajo la casilla de edición Salida de datos, hay tres botones de exclusión mútua que
describen la ubicación 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. Además, tenga en
cuenta que el código 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 edición situado bajo el nombre del tag, introduzca manualmente
la dirección de celda A:A2..A:A6 o haga clic en el botón situado junto al cuadro de
edición y seleccione A:A2..A:A6.
24. Seleccione "Unidades" en el cuadro de lista Atributos.
25. En el cuadro de edición etiquetado "Salida de macros [opc]", introduzca la dirección de la

celda A:A20.
En la casilla de edición Salida de datos, observe cómo la dirección predeterminada de la

celda ya es A:E2.

26. Haga clic en Aceptar y PI DataLink escribirá las unidades en las celdas A:E2..A:E6 y el
código 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.... Fíjese
en que el cuadro de diálogo está rellenado completamente según la información provista
en la macro en A:A10. Ésta es una función de ahorro de tiempo que resulta útil cuando ya
existen códigos de macros similares para la operación 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 diálogo detecta que hay un nombre de tag en la celda actual e intenta
rellenar el cuadro de diálogo lo máximo posible. El nombre del tag se escribe en el
cuadro de edición de nombre del tag. Debido a que hay datos con marcas de tiempo
directamente a la derecha del nombre del tag, el cuadro de diálogo escribe en el cuadro de
edición 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
diálogo Atributo del tag... desde la opción 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 simultáneamente. Se mostrará el cuadro de diálogo
Ejecutar secuencias de comandos & Macros:
33. Haga clic en el botón de exclusión mútua Macro y, a continuación, 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 continuación:

Cel Comando de macro Función
da
A10 {PITagAtt} Obtener un atributo del tag (descriptor)
A15 {PICurrVal} Obtener el valor actual
A20 {PITagAtt} Obtener un atributo del tag (unidades)

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 ingeniería. 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 cómo una comilla simple (o apóstrofe) 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);
Ningún servidor PI determinado (etiqueta en blanco o sólo una comilla simple o un

apóstrofe); y
Una celda que representa la celda de salida (celda D2).
En el comando de macro superior, hay un sólo espacio entre el nombre de macro (PITagAtt)
y el primer argumento de macro (c2). Además, no hay espacios entre cada argumento de la
macro y las comas sirven como separadores del argumento.
Si no se especifica ningún servidor PI en el argumento PIServer (p.ej., en blanco o sólo una

comilla simple), PI DataLink obtendrá información del tag PI desde el servidor
predeterminado. Éste es el servidor PI especificado en su archivo PILogin.ini, el cual se
puede modificar mediante el cuadro de diálogo 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 Búsqueda de tags.

Aparecerá entonces el cuadro de diálogo Búsqueda de tags.
2. Introduzca "CD" en el campo Máscara de tag de modo que se lea "cd*". Haga clic en
Buscar para buscar tags que comiencen con CD. El tag "cdt158" debería 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 cálculo).
3. Haga clic en la celda A:E:10 para activar la celda. Vuelva al menú PI y seleccione Datos
comprimidos (horas) ....
100
Menú PI
4. Haga clic en el botón 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 finalización. Marque la casilla
de verificación 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 más rápida de utilizar PI DataLink para
transferir datos entre PI y 1-2-3 es seleccionando una opción del menú PI. En ese caso,
aparecerá un cuadro de diálogo. Introduzca los parámetros adecuados y PI DataLink
recuperará los valores PI solicitados. Las siguientes secciones describen las funciones de PI
DataLink con más detalle.
Menú PI
Cuando se añada PI DataLink a Lotus 1-2-3, se añadirá el elemento del menú de PI a la barra
de menú de 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 histórico recupera un único valor del archivo histórico (se puede
interpolar).
Valor de tiempo exacto recupera un único valor de una marca de tiempo determinada
del archivo histórico.
Valor calculado recupera un único valor calculado (total, mínimo, máximo, rango,
desviación estándar, promedio o media).
Atributos del tag recupera un atributo del tag.
Datos de muestra recupera datos espaciados de forma uniforme (de muestra) del archivo
histórico.
Datos comprimidos (número) recupera datos comprimidos basados en una hora de
inicio y un número determinado de valores.
102
Cuadros de diálogo
Datos comprimidos (horas) recupera datos comprimidos basados en una hora de inicio y
una hora de finalización.
Datos temporizados recupera datos de muestra sincronizados con una matriz de marcas
de tiempo.
Datas calculados recupera totales, mínima, máxima, rangos, desviaciones estándar,
promedios y medias para múltiples períodos de tiempo.
Datos de muestra filtrados recupera datos espaciados de forma uniforme (de muestra)
que satisfacen una condición de filtro.
Datos comprimidos filtrados (número) recupera un número específico de datos
comprimidos que cumplen una condición de filtro.
Datos comprimidos filtrados (hora) recupera datos comprimidos que cumplen una
condición de filtro de una hora de inicio y una hora de finalización.
Cálculo de expresiones recupera datos de los cálculos en las expresiones de tags.
Filtrado de tiempo calcula el tiempo que una expresión de tag fue verdadera.
Conexiones gestiona las conexiones del servidor PI.
Búsqueda de tags busca los tags de los servidores PI conectados.
Ajustes muestra los ajustes y preferencias de PI DataLink.
Acerca de muestra la información de la versión PI DataLink.
Ayuda muestra la ayuda sobre PI DataLink.
Cuadros de diálogo
Las siguientes secciones describen la interacción del usuario y la operación con los cuadros
de diálogo.
Campos de edición
Hay dos tipos de campos de edición en los cuadros de diálogo: campos de edición de texto y
campos de edición de referencias. Una Celda (o Celdas) indica los campos de edición de
referencias situados junto al cuadro de edición. La información solicitada se debe introducir
en un campo de edición 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 edición (Celda) de referencias, tiene que introducir una

referencia a una celda de la hoja de cálculo que contenga la información necesaria. En un

campo de edición de referencias matriciales, puede introducir una referencia a una matriz de
celdas en la hoja de cálculo. En cualquier caso, también puede utilizar el ratón para hacer clic
en el botón Celda o Celdas que muestra el cuadro de diálogo de referencia de celdas. A
continuación, puede hacer clic en la celda (o hacer clic en la celda y arrastrarla a las celdas
adyacentes) de la hoja de cálculo. En este procedimiento, Lotus 1-2-3 introduce
automáticamente las referencias de celdas en el campo de edición.
Por ejemplo, en el cuadro de diálogo PICurrVal de la sección de tutorial, los campos de

edición para Nombre de tag y Salida solicitan una celda de la hoja de cálculo que contenga
el nombre del tag y la celda de la hoja de cálculo en la que desee colocar la salida del valor
actual respectivamente.
Muchos de los parámetros contienen un campo de edición de texto y un campo de edición de

referencias. Si hay entradas en el campo de edición de texto y en el campo de edición de
referencias, el campo de edición 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 diálogo están
etiquetados como "opc" u opcionales. Si el campo de edición 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 diálogo Conexión del menú PI.
El campo Salida de macros es un campo de edición de referencias, que le permite especificar

la esquina superior izquierda del rango en el que PI DataLink colocará el código 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 cálculo actual.
Visualizar datos en columnas o filas
Para los cuadros de diálogo que se espera que devuelvan una matriz de valores PI (p.ej.,
Datos de muestra), existe un grupo de botones de exclusión mútua con las opciones
columna(s) o fila(s). Elija columna(s) para mostrar los datos en una columna (o dos
columnas si también se muestran marcas de tiempo). Seleccione fila(s) para mostrar los datos
en una o dos filas.
Para los cuadros de diálogo que esperan devolver un único valor PI (p. ej., Valor actual),
existe un grupo de botones de exclusión mútua 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 diálogo
para visualizar los datos en dos columnas. Seleccione tiempo en la parte superior para
visualizar los datos en dos filas.
Para los cuadros de diálogo que son compatibles con una matriz de tags, la orientación de la
matriz de tags sobrescribirá su selección de fila/columna a la hora de determinar la
orientación 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 diálogo 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 cálculo predeterminado es Promedio.
Buscar tags en los cuadros de diálogo
El botón Búsqueda de tags de los cuadros de diálogo le permite buscar la base de datos PI de
los tags. Desafortunadamente, la función que permite que se pegue el tag seleccionado en el
cuadro de diálogo PI DataLink no funciona en PI DataLink para 1-2-3.
Rellenar automáticamente los cuadros de diálogo
La posición del cursor en la hoja de cálculo al abrirse un cuadro de diálogo determinará

cuánto se va a rellenar el cuadro de diálogo. Si ya existe un código de macros para un
determinado cuadro de diálogo y el cursor se coloca sobre dicho código de macros al abrirse
el cuadro de diálogo, éste se rellenará completamente en base al código de macros. Por
ejemplo, en el caso de que el cursor se colocara sobre una celda que tuviera el código de
macros siguiente:
{PICALCVAL 'Sinusoid,'T,'*,'Average,1,0,'CASABA,A:B2}
Si se selecciona ahora Valor calculado... de la opción de menú PI, se muestra el cuadro de
diálogo siguiente:

Por tanto, puede realizar cambios menores en el cuadro de diálogo y ejecutar el mismo.
El relleno automático anterior de cuadros de diálogo no está disponible para el cuadro de

diálogo Filtrado de tiempo... de PI DataLink 1.9.
PI123DLG.123 intentará determinar cómo rellenar el cuadro de diálogo según en dónde se

coloca el cursor en una hoja de cálculo 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 información de la hoja de cálculo en el cuadro de diálogo.
La siguiente hoja de cálculo representa el escenario anterior:
106
Cuadros de diálogo
Cuando se abra el cuadro de diálogo Datos de muestra... con el rango A1...A4 seleccionado, el
cuadro de diálogo Datos de muestra aparecerá tal y como se muestra a continuación:
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 cálculo. En el caso anterior, la celda Salida de datos
predeterminada es A:E1. Este escenario también funcionaría si los datos de la hoja de cálculo
estuviesen debajo del nombre de tag de la columna A.

Opción Salida de macros
Cada cuadro de diálogo tiene la opción Salida de macros. La opción Salida de macros le
permitirá especificar en donde escribir las cadenas de macros asociadas a cada cuadro de
diálogo. El código de macro escrito en la dirección de la celda de salida designada se basará
en la información dada en el cuadro de diálogo. Esta opción resulta útil cuando se crea una
hoja de cálculo que desea actualizar en el futuro. Después de crear la hoja de cálculo
utilizando los cuadros de diálogo con la opción de salida de macros, puede ejecutar el código
de macro creado para actualizar la hoja de cálculo en vez de volver a abrir todos los cuadros
de diálogo.
PI123DLG.123 muestra el código de macro de las celdas que se está escribiendo con el fin
de rellenar automáticamente la dirección de referencias Salida de macros al abrir un cuadro
de diálogo. El mecanismo de seguimiento se invoca cuando introduce por primera vez una
dirección de celda en el campo de edición de referencias Salida de macros. Después del cual,
PI123DLG.123 supone que desea seguir escribiendo el código en la siguiente fila disponible
de la misma columna en la que escribió el código de macro. El mecanismo de seguimiento se
cancela cuando se ejecuta un cuadro de diálogo sin dirección de celda en el cuadro de diálogo
Salida de macros, o se eliminó la macro anterior generada en la hoja de cálculo, o el usuario
selecciona un archivo diferente.
El mecanismo de seguimiento elimina la entrada de dirección de celda manual cuando se

crean hojas de cálculo que requieren las ejecuciones de varios cuadros de diálogo. El código
de macro se generará automáticamente para que las actualizaciones posteriores de las hojas
de cálculo se puedan realizar con sólo ejecutar las macros, en vez de tener que volver a abrir
los cuadros de diálogo.
Valores devueltos
Las marcas de tiempo devueltas por PI DataLink se encuentran en formato Lotus 1-2-3; es
decir, es un número que representa el número de días desde 1900. Por ejemplo, 24-jul-00
07:12:00 a.m. se introduce en una celda como el número 36731,3.
PI DataLink automáticamente da formato de fecha y hora a estas marcas de tiempo; es decir,

24/07/2000 07:12:00 a.m. Para cambiar este formato de tiempo por otro, seleccione las celdas
y utilice la función Formato... de la opción Rango de la barra de menús. Para obtener más
información, consulte la documentación de su Lotus 1-2-3.
108
Argumentos de tiempo en comandos de macro
Muchos de los comandos de macro solicitan una hora de inicio y una hora de finalización.
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 (p.ej., '-1d') la hora de
referencia es diferente para la hora de inicio que para la hora de finalización. El reloj tiempo
real actual es la hora de referencia para la traducción 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 traducción
de la hora relativa en el campo de hora de finalización.
Para obtener ejemplos de cadenas de tiempo PI válidas, consulte Ejemplos de cadenas de

tiempo PI (en la página 153). Ponga entre paréntesis la cadena de tiempo, si su cadena de
tiempo es una marca de tiempo absoluta; p.ej., utilice '(24-jun-00 13:38) para representar las
13:38 del 24 de junio de 2000.
Casilla de verificación Mostrar hora
En algunos cuadros de diálogo aparece la casilla de verificación mostrar hora, cuya función
PI generalmente devuelve una matriz de valores PI. Si selecciona esta casilla de verificación,
se devolverán 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 botón de exclusión mútua
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 diálogo Datos de muestra o Datos
calculados, PI DataLink devuelve un grupo común de marcas de tiempo para todo el grupo de
tags.
Botones de exclusión mútua: Sin marca de tiempo/Tiempo a la

izquierda/Tiempo en la parte superior
Algunos de los cuadros de diálogo que devuelven un solo valor (por ejemplo, Valor actual)
tienen un conjunto de botones de exclusión mútua que permiten elegir:
sin marca de tiempo
tiempo a la izquierda
tiempo en la parte superior

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

botón de exclusión mútua tiempo a la izquierda o tiempo en la parte superior, PI DataLink
devolverá la marca de tiempo y el valor según si la referencia de los nombres de tag es
horizontal o vertical. Específicamente, cuando los nombres de tag están en una única
columna, las marcas de tiempo aparecerán a la izquierda de los valores. Asimismo, cuando
los nombres de tag están en una sola fila, las marcas de tiempo aparecerán en la parte superior
de los valores.
Comandos de macro personalizados de PI DataLink
Macro y cuadro de diálogo
Cuando un cuadro de diálogo PI DataLink transfiere datos del servidor PI a Lotus 1-2-3,
primero genera el comando de macro personalizado PI y después ejecuta la macro para
colocar los datos en la celda de salida. Puede obtener el mismo resultado introduciendo la
macro y ejecutándola manualmente. Sin embargo, es mucho más sencillo generar la cadena
de macro con los cuadros de diálogo, 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 cálculo
Mientras PI DataLink transfiere datos a Lotus 1-2-3 mediante los comandos de macros
personalizados, la hoja de cálculo no se actualiza automáticamente. Cuando cambia una
entrada de celda en la hoja de cálculo, debe volver a ejecutar los comandos de macro que
hacen referencia a la celda modificada para que su hoja de cálculo muestre los nuevos
valores. También debe volver a ejecutar los comandos de macro que contienen marcas de
tiempo relativas. Además, tendrá que volver a ejecutar la macro {PICurrVal} cada vez que
desee el valor actual de un tag.
110
Detalles del cuadro de diálogo y la macro personalizada PI
Por ejemplo, el comando

{PIArcVal a1,'t+8h,1,',d1}
recupera un valor del archivo histórico para el tag situado en la celda A1 a las 8:00 a.m. del
día actual. Debe volver a ejecutar esta macro cuando (1) cambie el contenido de la celda A1 y
(2) cuando evoque la hoja de cálculo por primera vez cada día ya que t+8h es una marca de
tiempo relativa.
Las siguientes secciones describen cada una de las funciones PI DataLink con más detalle.
Cada sección describe primero el cuadro de diálogo y, a continuación, explica cada uno de los
argumentos de la función de macro PI correspondiente.
Cuadro de diálogo Valor actual
Este cuadro de diálogo obtiene el valor snapshot actual de un tag PI.
Campo obligatorio
{PICurrVal}
{PICurrVal tagname, outcode, PIServer, outcell}
Argumentos
tagname (cadena) El tag para el cual desea el valor snapshot (actual).
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.

Devoluciones
de salida
0 Valor actual
1 Marcas de Valor actual
tiempo
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 diálogo Valor de archivo histórico
Este cuadro de diálogo obtiene un valor a una hora especificada. El resultado es un valor
interpolado, excepto para los 4 tags de código de resolución del servidor PI 2. En este caso, el
valor se devuelve en el momento o antes de la hora especificada.
Campos obligatorios
Marca de tiempo
{PIArcVal}
{PIArcVal tagname, timestamp, outcode, PIServer, outcell}
Argumentos
comando de macro.
112
Devoluciones
de salida
0 Valor de archivo
histórico
histórico
Ejemplo
Para obtener el valor de archivo histórico 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 diálogo Valor de tiempo exacto
Este cuadro de diálogo obtiene un valor del servidor PI en una hora especificada, si existe una
entrada en el archivo histórico en ese momento. Si no existe ningún valor, se devuelve el
mensaje "Sin entrada de archivo histórico en el tiempo dado".
Campos obligatorios
Marca de tiempo
{PIExTimeVal}
{PIExTimeVal tagname, timestamp, PIServer, outcell}
Argumentos

comando de macro.
Devoluciones
Si existe, un valor del servidor PI. Si no existe ningún valor, se devuelve el mensaje "Sin
entrada de archivo histórico en el tiempo dado".
Ejemplo
Para obtener el valor de archivo histórico 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 diálogo Valor calculado
Este cuadro de diálogo devuelve un único valor calculado de un rango de valores archivados
de un tag. Los modos de cálculo son
Total (tiempo ponderado)
Mínimo
Máximo
Desviación estándar (tiempo ponderado)
Rango
Promedio (tiempo ponderado)
Media (tiempo no ponderado)
Campos obligatorios
Hora de inicio
114
Modo de cálculo
Seleccione mostrar pctgood si desea que PI DataLink muestre el porcentaje del rango de
tiempo que contenía valores correctos. Le recomendamos que siempre se fije en el valor de
porcentaje correcto antes de utilizar el resultado del cálculo. El valor de porcentaje correcto
se suele devolver a la derecha de la celda de valor calculado. Si se selecciona el botón 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 cálculo es mínimo, máximo o rango.
Notas especiales
Cuando el modo de cálculo 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 fracción del
período de tiempo con datos archivados correctos. Esta normalización de datos es equivalente
a la suposición 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 suposición puede no ser válida cuando
una amplia fracción 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
cálculo.
El factor de conversión se utiliza más a menudo cuando el modo de cálculo 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/día, mientras que
la del tag PI que se totaliza es unidades/hora, de modo que utiliza el factor de conversión de
24. Para el servidor PI 2 con velocidad predeterminada de unidades por hora, utilice los
siguientes factores de conversión:
0,041667 para unidades/día
1 para unidades/hora
60 para unidades/minuto
3.600 para unidades/segundo

{PICalcVal}
{PICalcVal tagname, stime, etime, mode, cfactor, outcode, PIServer,
outcell}
Argumentos
estándar, rango, promedio o media).
cfactor (número) Debe ser 1 para máx, mín, promedio, desviación estándar
y rango. Para obtener el total, consulte las notas
especiales anteriores.
comando de macro.
Devoluciones
Si el código de salida es 0, sólo se devuelve el valor calculado.

Total Valor total
Stdev Valor de desviación estándar
Promedio Valor de promedio
Media Valor de media
Si el código de salida es 4, el porcentaje correcto se devuelve a la derecha de la celda de

valor.
116

Modo Columna 1 Columna 2 Columna 3 Columna 4
Total Valor total Porcentaje correcto
Mínimo Tiempo del valor mín. Valor mínimo Porcentaje
correcto
Máximo Tiempo del valor máx. Valor máximo Porcentaje
correcto
Stdev Desviación estándar Porcentaje correcto
Rango Tiempo del valor mín. Tiempo del valor máx. Valor de rango Porcentaje
correcto
Promedio Valor de promedio Porcentaje correcto
Media Valor de media Porcentaje correcto
Ejemplo
Para obtener el tiempo y el valor mínimo (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 diálogo Atributos del tag
Este cuadro de diálogo recupera un atributo de punto para un tag determinado.
Campos obligatorios
Atributo del tag.
Elija un atributo del tag del cuadro de lista. El atributo predeterminado es descriptor. Los
atributos del tag son:
descriptor Descriptor de tag de 26 caracteres

exdesc Descriptor extendido de tag de 80 caracteres
typicalvalue Valor típico
units Cadena de unidades de ingeniería
zero Cero
span Rango
digstartcode Código para la primera cadena de estado digital del tag
dignumber Número de estados digitales menos 1
pointtype Carácter de tipo de punto
pointsource Carácter de origen de punto
location1 Parámetro de ubicación 1
filtercode Código de filtro
squareroot Flag de raíz cuadrada
scan Flag de exploración
excdev Desviación por excepción en porcentaje de rango
excmin Tiempo mínimo de excepción en segundos
excmax Tiempo máximo de excepción en segundos
archiving Flag de archivado histórico
compressing Flag de compresión
res Código de resolución
compdev Desviación de compresión en porcentaje de rango
compmin Tiempo mínimo de compresión en segundos
compmax Tiempo máximo de compresión en segundos
totalcode Código de totalización
convers Factor de conversión de puntos postprocesados
displaydigits Controla el formato de los valores numéricos en pantallas PI basadas en
terminales
instrumenttag Nombre de tag para un valor en otro sistema, lo utilizan algunas
interfaces
sourcept Nombre de tag para la salida a otro sistema, lo utilizan algunas interfaces
taglong Nombre de tag largo (hasta 80 caracteres)
tagshort Nombre de tag de 12 caracteres
118
creator Creador del tag
createdate Fecha de creación del tag
changer Usuario que modificó los atributos del tag
changedate Fecha de modificación del tag
pointnumber Número de punto del tag
pointid Número de identificación del punto interno
{PITagAtt}
{PITagAtt tagname, attribute, PIServer, outcell}
Argumentos
tagname (cadena) El tag para el cual desea un atributo.
Attribute (cadena) El atributo del tag, consultar lista superior.
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 diálogo Datos de muestra
Este cuadro de diálogo recopila valores de muestra espaciados de forma uniforme desde el
archivo histórico.
Campos obligatorios

Hora de inicio
Intervalo de tiempo
{PISampDat}
{PISampDat tagname, stime, etime, interval, outcode, PIServer,
outcell}
Argumentos
Tagname (cadena) El tag para el cual desea datos de muestra.
Stime (cadena) La hora de inicio en formato de hora PI.
Etime (cadena) La hora de finalización en formato de hora PI.
Interval (cadena) El intervalo de tiempo en formato de hora PI.
Outcode (entero) Un código de salida; 0, 1, 2 ó 3.
Outcell (referencia) Una celda que especifica la esquina superior izquierda del
comando de macro.
Devoluciones
de salida
0 Datos de muestra

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
Cuadro de diálogo Datos comprimidos (número)
de inicio y en un número especificado de puntos de datos.
Campos obligatorios
Nombre de tag
Hora de inicio
Notas especiales
La función de este cuadro de diálogo sólo devuelve el número real de puntos de datos
archivados en el archivo histórico PI cuando este número es inferior que el número de valores
solicitados. Por ejemplo, si desea recuperar 400 valores, desde la medianoche de hoy, y sólo
existen 356 valores en el archivo histórico, la función PINCompDat dejará en blanco las 44
celdas finales.
{PINCompDat}
{PINCompDat tagname, stime, numvals, outcode, PIServer, outcell}
Argumentos
Numvals (entero) El número de puntos de datos comprimidos. Utilice un número
negativo para recopilar los datos del archivo histórico que va
hacia atrás desde la stime.

rango de salida que mantiene los resultados de este comando
de macro.
Devoluciones
de salida
0 Datos comprimidos
1 Marcas de tiempo Datos comprimidos

Ejemplo
La siguiente fórmula recupera 10 puntos de datos comprimidos y marcas de tiempo

correspondientes para el tag cdf144 desde la 1:00 de esta mañana:
{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 diálogo Datos comprimidos (horas)
de inicio y una hora de finalización. El número de puntos de datos recuperados para el
período de tiempo dado se devuelve a la primera celda.
Campos obligatorios
Nombre de tag
Hora de inicio
122
Notas especiales
archivados al archivo histórico PI. Por ejemplo, si ayer ejecutó la función PICompDat
utilizando los argumentos 'y y 't para la hora de inicio y hora de finalización, y recuperó 100
valores. Si hoy ejecuta la misma función, ésta recuperará los valores entre la medianoche de
ayer y la medianoche de hoy y, sin importar cuántos valores recupere, los mostrará tal cual. Si
hoy sólo hay 50 valores, los primeros 50 valores de ayer serán reemplazados por nuevos
valores y los últimos 50 valores de la llamada de función de ayer permanecerán en la hoja de
cálculo.
{PICompDat}
{PICompDat tagname, stime, etime, outcode, PIServer, outcell}
Argumentos
comando de macro.
Devoluciones
de salida
0 Datos comprimidos
Un código de salida 2 transpone la matriz de salida resultante de un código de salida 0,

salida 1. El número 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 fórmula 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 mañana.

{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 diálogo Datos temporizados
Este cuadro de diálogo devuelve valores de muestra de un solo tag que están 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
monotónicamente crecientes o monotónicamente decrecientes.
{PITimeDat}
{PITimeDat tagname, timestamps, PIServer, outcell}
Argumentos
tagname (cadena) El tag para el cual desea los datos de muestra.
timestamps (referencia) Una referencia a una matriz de horas en formato PI. Los
valores de esta matriz de tiempo deben ser
monotónicamente crecientes o monotónicamente
decrecientes.
outcell (referencia) Una celda que especifica la esquina superior izquierda
del rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
una sola fila.
124
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 diálogo Datos calculados
Este cuadro de diálogo devuelve valores calculados espaciados de forma uniforme desde el
archivo de datos PI. El modo de cálculo puede ser total, mínimo, máximo, desviación
estándar, rango, promedio o media.
Campos obligatorios
Hora de inicio
Intervalo de tiempo
Modo de cálculo
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 cálculo. Los valores de porcentaje
correctos se suelen devolver a la derecha de las celdas de valor calculado. Si tanto el botón
fila como el botón mostrar hora están 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 diálogo Valor calculado (consulte "Cuadro de diálogo
Valor calculado" en la página 114).

{PICalcDat}
{PICalcDat tagname, stime, etime, interval, mode, cfactor, outcode,
PIServer, outcell}
Argumentos
estándar, rango, promedio o media).
cfactor (número) Un factor de conversión multiplicador. Debe ser 1 para máx,
mín, promedio, desviación estándar y rango. Consulte las
notas especiales de cfactor en PIcalcVal() para los totales.
de macro.
Devoluciones
El código 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
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 diálogo Datos de muestra filtrados
Este cuadro de diálogo recopila valores de muestra espaciados de forma uniforme desde el
archivo histórico cuando una expresión de filtro dada es verdadera. Si se selecciona la opción
Marcador, se devuelve un estado "Filtrado" para cada conjunto continuo (bloque) de valores
de muestra que no satisfaga la expresión 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 expresión
de filtro se devolverá el estado "Filtrado".
Campos obligatorios
Hora de inicio
Intervalo de tiempo
Expresión. Para obtener más información sobre la sintaxis de las expresiones de filtro,
consulte Sintaxis de expresiones (en la página 147).
Desactive la casilla Marcadores para suprimir la devolución de un estado "Filtrado" en la

celda del rango temporal, cuando los valores no satisfagan la condición de filtro.
{PISampFilDat}
{PISampFilDat tagname, stime, etime, interval, filtexp, filtcode,
outcode, PIServer, outcell}

Argumentos
la sintaxis de las expresiones de filtro, consulte
Expresiones de filtro (en la página 150).
filtcode (entero) Un código de filtro, utilice 1 para devolver el estado Filtrado
y 0 para omitirlo.
comando de macro.
Devoluciones
de salida
0 Datos de muestra

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
{PISampFilDat 'sinusoid,'y,'t,'3h,'('cdep158'>80),1,1,',A5}
Cuadro de diálogo Datos comprimidos filtrados (número)
Este cuadro de diálogo devuelve un número determinado de valores comprimidos del

servidor PI, mientras que una expresión de filtro dada es verdadera. Si se ha seleccionado la
opción Marcador, para cada grupo de valores que no satisfaga la expresión de filtro se
devolverá el estado "Filtrado".
128
Campos obligatorios
Nombre de tag
Hora de inicio
Desactive la casilla Marcadores para suprimir la devolución de un estado Filtrado en la celda

del rango temporal cuyo valor no satisfaga la condición de filtro.
Notas especiales
archivados en el archivo histórico PI cuando este número es inferior que el número de valores
solicitados. Por ejemplo, si desea recuperar 400 valores, desde la medianoche de hoy, y sólo
existen 356 valores en el archivo histórico, la función PINCompFilDat dejará en blanco las
44 celdas finales.
{PINCompFilDat}
{PINCompFilDat tagname, stime, numvals, filtexp, filtcode, outcode,
PIServer, outcell}
Argumentos
numvals (entero) El número de puntos de datos comprimidos. Utilice un número
negativo para recopilar datos del archivo histórico que
retrocede desde stime.

filtcode (entero) Un código de filtro, utilice 1 para devolver el estado Filtrado y
0 para omitirlo.
de macro.
Devoluciones
de salida
0 Datos comprimidos

Ejemplo
La siguiente fórmula 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 condición 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 diálogo Datos comprimidos filtrados (horas)
Este cuadro de diálogo devuelve valores comprimidos del servidor PI cuando la expresión de
filtro dada es verdadera para la hora de inicio y la hora de finalización dadas. El número de
puntos de datos recuperados para el período de tiempo dado se devuelve a la primera celda.
Campos obligatorios
Nombre de tag
Hora de inicio
130
Desactive la casilla marcadores para suprimir la devolución de un estado Filtrado en la celda

del rango temporal cuyo valor no satisfaga la condición de filtro.
Notas especiales
archivados al archivo histórico PI. Por ejemplo, suponga que ayer ejecutó la función
PICompFilDat utilizando los argumentos 'y y 't para la hora de inicio y hora de finalización y
recuperó 100 valores. Si hoy ejecuta la misma función, ésta recuperará los valores entre la
medianoche de ayer y la medianoche de hoy. Si hoy sólo hay 50 valores que satisfacen los
criterios de filtro, los primeros 50 valores de ayer serán reemplazados por nuevos valores,
mientras que los últimos 50 valores de la llamada de función de ayer permanecerán en la hoja
de cálculo.
{PICompFilDat}
{PICompFilDat tagname, stime, etime, filtexp, filtcode, outcode,
PIServer, outcell}
Argumentos
la sintaxis de las expresiones de filtro, consulte Expresiones
filtcode (entero) Un código de filtro, utilice 1 para devolver el estado Filtrado
y 0 para omitirlo.
comando de macro.

Devoluciones
de salida
0 Datos comprimidos
Un código de salida 2 transpone la matriz de salida resultante de un código de salida 0 y un

código de salida 3 transpone la matriz de salida resultante de un código de salida 1. El
número 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 fórmula 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 condición 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 diálogo Cálculo de expresiones
Este cuadro de diálogo realiza cálculos, sobre un rango de tiempo espaciado de forma
uniforme, en una expresión que contiene tags.
Campos obligatorios
Expresión. Para obtener más información sobre la sintaxis de las expresiones, consulte
Sintaxis de expresiones (en la página 147).
Hora de inicio
Intervalo de tiempo
{PIExpDat}
{PIExpDat expression, stime, etime, interval, outcode, PIServer,
outcell}
132
Argumentos
Expression (cadena) La expresión de cálculo. Para obtener más información
sobre la sintaxis de las expresiones de cálculo, consulte
Stime (cadena) La hora de inicio en formato de hora PI.
Etime (cadena) La hora de finalización en formato de hora PI.
comando de macro.
Devoluciones
de salida
0 Datos calculados

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
{PIExpDat'('sinusoid'+'sqf100'),'y,'t,'1h,1,',A5}
Cuadro de diálogo Filtrado de tiempo
Este cuadro de diálogo devuelve la cantidad de tiempo para la que una expresión dada es
verdadera en un rango temporal. El usuario puede especificar múltiples rangos temporales
(intervalos espaciados de forma uniforme) como en el cuadro de diálogo Datos calculados.

Campos obligatorios
Expresión. Para obtener más información sobre la sintaxis de las expresiones, consulte
Hora de inicio
Intervalo de tiempo
Unidades de tiempo (predeterminadas a segundos)
{PITimeFilter}
{PITimeFilter expression, stime, etime, interval, timeunit, outcode,
PIServer, outcell}
Argumentos
expression (cadena) La expresión de cálculo. Para obtener más información
sobre la sintaxis de la expresión de cálculo, consulte
Expresiones de cálculo (en la página 147).
Timeunit La unidad de tiempo del resultado que se va a mostrar. Las
comando de macro.
Devoluciones
de salida
0 Datos calculados

134
Ejemplo
{PITimeFilter($A$1,"y","t","1h","seconds",1,"thevax",E1}
La macro anterior calcula el tiempo en el que la expresión 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. También muestra las marcas de tiempo para la hora de inicio de cada intervalo de
cálculo. El resultado del cálculo se expresa en segundos.
Cuadro de diálogo Conexiones
Este cuadro de diálogo administra sus conexiones con el servidor PI.
Mediante los botones inferiores, puede realizar las tareas siguientes:
Añadir: añade 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. Después de conectarse correctamente a un servidor PI, el campo Estado cambia a
LECTURA o LECTURA/ESCRITURA.
Para obtener información como el nombre/dirección del nodo del equipo local y el
nombre/dirección del servidor PI, haga clic en el botón Información.

Cuadro de diálogo Búsqueda de tags
Este cuadro de diálogo permite buscar tags desde los servidores PI y copiar los resultados a la
hoja de cálculo. 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 después presione la tecla
MAYÚS y haga clic en la parte inferior del rango. Haga clic en Aceptar para copiar los
nombres de tags a la hoja de cálculo. Si la opción "Copiar nombre de PIServer" del cuadro de
diálogo Ajustes... está activada, el servidor PI de cada tag se copiará a la hoja de cálculo
junto con los nombres de tag.
En el ejemplo citado a continuación, se seleccionaron los tags 01:TEST.TF, 01TEST.LF,

01TEST.QA, 01TEST.VF y 413P11.PV.
Los tags se copian en la hoja de cálculo en una sola columna o en una sola fila, dependiendo
de la opción seleccionada en la sección "Copiar elementos a la hoja" del cuadro de diálogo
Ajustes... de PI DataLink. La posición de la celda en donde se inicia el copiado es la celda
actual. Si la opción "Copiar nombre de PIServer" está activada, los nombres de los servidores
se copiarán a una columna situada a la izquierda de los nombres de tag de la hoja cálculo
cuando se seleccione la opción En una columna de la sección "Copiar elementos a la hoja".
Si se selecciona la opción En una fila, los nombres de los servidores se copiarán debajo de
los nombres de tag de la hoja de cálculo.
Cuadro de diálogo Ajustes
Este cuadro de diálogo controla sus ajustes y preferencias de PI DataLink.
136
Escribir datos de Lotus 1-2-3 a PI
El conjunto de botones de exclusión mútua En una fila o En una columna determina si los
tags seleccionados en el cuadro de diálogo TagSearch se copian a la hoja de cálculo en una
fila o en una columna.
La casilla de verificación de nombre Copiar nombre de PIServer facilita la opción de

copiar el nombre del servidor PI junto al nombre del tag cuando se utiliza el cuadro de
diálogo TagSearch para llenar las celdas de una hoja de cálculo.
PI DataLink utiliza la casilla de verificación 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 configuración de la zona horaria del servidor PI.
La casilla de verificación 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 opción de menú llama a la ayuda de PI DataLink.
Acerca de PI DataLink
Esta opción de menú muestra información de la versión PI DataLink.
PI DataLink permite escribir un valor de la hoja de cálculo al archivo de datos PI. Los
comandos de la macro PI DataLink que realizan estas tareas son PIPutVal y PIPutValX.

PIPutVal soporta los tipos de puntos PI clásicos, mientras que PIPutValX soporta los tipos de
puntos PI nuevos del servidor PI 3. Ambas funciones reemplazarán un evento existente en
una marca de tiempo específica. Consulte el archivo
...\PIPC\LOTUS\PIDL_input.123 para saber cómo utilizar estas macros.
{PIPutVal}
{PIPutVal tagname, value, time stamp, PIServer, outcell}
Argumentos
Value (referencia) La referencia que se escribe de un valor. Puede ser una
Outcell (referencia) Una referencia a una celda en la que se muestra el valor
Devoluciones
Si la función de la macro falla, se escribirá un mensaje de error en la celda de salida. Si la

función funciona correctamente, se escribirán 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 número 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 creación 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 función (PIPutVal) sólo 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 información de la zona horaria del servidor.
138
Ejemplo
La siguiente fórmula 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
Value (referencia) La referencia que se escribe de un valor. Puede ser una
Outcell (referencia) Una referencia a una celda en la que se muestra el valor
Devoluciones
Si la función de la macro falla, se escribirá un mensaje de error en la celda de salida. Si la

función es correcta, el valor de cadena enviado se escribirá en la celda exterior.
Nota: PIPutValX no comprueba si el número 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 creación 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 función (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 información de la zona horaria del
equipo cliente, a menos que la opción "Utilizar la zona horaria del PIServer" esté
habilitada o se trate de un servidor PI 2.

Ejemplo
La siguiente fórmula 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 limitación significa que para
un único comando de macro PI personalizado, sólo se pueden recuperar 65.536 valores a la
vez. Éste es el límite para el número de filas de la hoja de cálculo de Lotus 1-2-3.
140
Apéndice A: Resolución de problemas
Si está teniendo dificultades con PI DataLink, consulte las secciones inferiores.
El complemento de DataLink no se carga correctamente (en la página 141)
Problemas de conexión informados en los archivos de registro (en la página 142)
Límites de Excel para PI DataLink (en la página 90)
Limitaciones de PI DataLink para Lotus 1-2-3 (en la página 140)
Si sigue teniendo problemas después de seguir estas sugerencias, consulte Soporte técnico y
recursos (en la página 159) para obtener detalles de la conexión al soporte técnico.
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 cálculo (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 síntomas de
este fenómeno 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 mayoría de los cuadros de diálogo de DataLink y

debe cargarse para que los cuadros de diálogo de DataLink estén disponibles. Si puede ver el
menú PI pero no puede ver las funciones DataLink del menú PI en 1-2-3, asegúrese de que
este archivo esté en ...\lotus\123\auto y reinicie 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 opción
Registrar... del cuadro de diálogo 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

instalación de PI DataLink de nuevo.
Problemas de conexión informados en los archivos de registro
En el servidor PI 3, se puede obtener información acerca de los intentos de conexión a través

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 conexión PI DataLink deben comenzar por "PINet".)
Para el servidor PI 2, los archivos de registro se ordenan de la manera siguiente:

UCX PISysExe:UCXPIServer.log
MultiNet PISysExe:MTNPIServer.log
PathWay PISysExe:PTWPIServer.log
TCPware PISysExe:TCPIServer.log
PI DataLink para Excel
En el equipo local, se puede obtener información acerca de los intentos de conexión a través
de la utilidad PIGetMsg:
pigetmsg * "EXCEL.EXE" *-15m *
La utilidad anterior muestra todos los mensajes que produce EXCEL.EXE desde hace 15
minutos hasta ahora. (Los mensajes de conexión PI DataLink deben proceder de
EXCEL.EXE.)
PI DataLink para Lotus 1-2-3
El archivo de registro para los intentos de conexión se encuentra en el equipo en

C:\PIPC\DAT\pipc.log.
El procedimiento general para determinar la causa de la falta de conexión 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 síntomas comunes:
Error de Gethostbyname en pipc.log
Este error de Gethostbyname indica que el equipo no puede traducir el nombre del servidor PI
en una dirección TCP/IP. Una solución de corrección rápida es añadir la dirección 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\hosts.sam 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 hosts.sam.
Para Windows NT, 2000 y XP la tabla de host se encuentra en

C:\WINNT\SYSTEM32\DRIVERS\ETC\hosts.
Asegúrese 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 símbolo del sistema.
Tiempo de espera Connect() en pipc.log
El error de tiempo de espera connect() suele indicar que PI DataLink no puede conectarse al
número 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 máquina 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.

Tiempo de espera Select() en pipc.log
El error de tiempo de espera select() suele indicar que la máquina del servidor PI 2 no está
traduciendo, lo suficientemente rápido, la dirección del equipo por un nombre. La solución es
añadir el nombre del equipo y la dirección TCP/IP en la tabla de host local de VAX/Alpha.
Para obtener más información, consulte la sección anterior acerca de la traducción de
nombres.
También puede aumentar el parámetro de tiempo de espera de PI DataLink en el archivo

C:\PIPC\DAT\pilogin.ini:
[network] timeout=60
El parámetro 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 sección [network] anterior y la entrada de tiempo de espera no existen actualmente,

deberá crearlas.
Recv: Error: 0 en pipc.log
La fórmula 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. Asegúrese 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 más información, consulte PIBuild:PIServer.txt.
Problemas de conexión TCP/IP
1. La versión 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 través 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 configuración del protocolo de red (Inicio >
Configuración > 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, asegúrese
de que el servicio auxiliar del servidor PI está habilitado actualmente: $ ucx show
service PIServer. Habilite el servidor PI en caso necesario: $ ucx enable
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:PIServer.txt.

Apéndice B: Sintaxis de expresiones
Las expresiones PI se utilizan en las funciones PI DataLink que requieren el cálculo de

funciones matemáticas, que incluyen tags PI. Las funciones que requieren que el usuario
especifique una expresión PI válida son: PIExpDat, PITimeFilter, PINCompFilDat,
PICompFilDat y PISampFilDat.
Las expresiones PI (también 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 Guía 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 información más
detallada, el usuario deberá consultar los manuales citados anteriormente).
Nota: Existen algunas diferencias en el cálculo 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 según si el servidor PI al que se hace
referencia es un servidor PI 2 o un PI 3.
Expresiones de cálculo
A continuación, se describe la sintaxis de las expresiones de cálculo válidas (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 expresión de cálculo tag, los operadores matemáticos y las funciones actúan sobre los
nombres de tags.
Operadores matemáticos
Los operadores matemáticos son:

+ suma
- resta
* multiplicación
/ división
^ elevación a una potencia
Ejemplo
(('sinusoid')^3 + 'cdf144'/10)
La expresión anterior determina la suma del valor de sinusoid al cubo y el valor de cdf144
dividido por 10.
Funciones matemáticas
Las funciones matemáticas admitidas son:
abs valor absoluto

atn tangente del arco (ángulo devuelto en radianes)
cos coseno (argumento en radianes)
exp e (2.71828...) elevado a una potencia
int parte entera de un número
log logaritmo natural
sgn función del signo (-1 si el argumento es negativo, 0 si es cero, 1 si es
positivo)
sin seno (argumento en radianes)
sqr función de raíz cuadrada
tan tangente (argumento en radianes)
Ejemplo
(log('cdep158') - cos('cdep158'))
La expresión anterior encuentra la diferencia entre el logaritmo natural del valor del tag
cdep158 y el coseno del valor del tag cdep158.
Expresiones de cálculo
Funciones de Performance Equations
Si la versión de su servidor PI 2 es 2.0.9 o superior, o si utiliza un servidor PI 3, también

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 función 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 cálculo utilizando la palabra clave curtime
explícitamente en la expresión. Por ejemplo, especifique 20-Oct-97 como Hora de inicio,
21-Oct-97 como Hora de finalización, 12h como Intervalo de tiempo y la siguiente
expresión en la función PI PIExpDat:
(curtime - `20-Oct-97')/1s

Se devolverán tres conjuntos de datos de la siguiente manera:

20-Oct-97 00:00:000 20-Oct-97 12:00:0043200 21-Oct-97 00:00:0086400
Para obtener más información acerca de las funciones de Performance Equation, consulte la
Guía de aplicaciones del servidor PI o el archivo de ayuda de Performance Equations de PI
3. Recuerde también que la sintaxis PE del servidor PI 3 difiere ligeramente de la del servidor
PI 2.
Expresiones de filtro
A continuación se describe la sintaxis de las expresiones de filtro válidas 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 expresión de filtro utiliza los mismos operadores y funciones aritméticos que una
expresión de cálculo. Además, son necesarios uno o más 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 expresión anterior se evalúa 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 número de código 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 lógicos
Una expresión de filtro también puede contar con operadores lógicos 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 expresión se evalúa como VERDADERA si el valor del tag sinusoid es menor
que 45 y la raíz cuadrada del valor del tag vdf1002 es mayor que 2:
('sinusoid' < 45 y sqr('vd:f1002') > 2)

Apéndice C: Ejemplos de cadenas de tiempo PI
Hora de inicio y de finalización
En los ejemplos siguientes, omita la comilla a la izquierda si va a introducir la cadena de

tiempo PI en un campo de edición de texto de un cuadro de diálogo Excel. Si está utilizando
el complemento para Lotus 1-2-3, deberá delimitar el argumento de la cadena de tiempo PI
entre paréntesis. Por ejemplo:
{PIArcVal 'sinusoid,'(25-dic-92 14:23),1,',A5}
Cadena de tiempo PI Significado
'06-dic-91 15:00:00 15:00:00 del 6 de diciembre de 1991
'* Hora actual (ahora)
'25 00:00:00 (medianoche) del día 25 del mes actual
'25-ago-92 00:00:00 (medianoche) del 25 de agosto de 1992
'8: 08:00:00 de la fecha actual
'25 8: 08:00:00 del día 25 del mes actual
't 00:00:00 de la fecha actual (hoy)
'y 00:00:00 de la fecha anterior (ayer)
'sun, mon, tue, wed, thu, fri, sat 00:00:00 del domingo, lunes,... sábado más
reciente.
'*-1h Hace una hora
't+8h 8:00:00 a.m. de hoy
'y-8h 16:00:00 de antes de ayer.
'mon+14.5h 14:30:00 del último lunes
'sat-1m 23:59:00 del último viernes

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 edición de texto de un cuadro de diálogo Excel.
Cadena de Significado
tiempo PI
'1.5h Una hora y media.
'32m Treinta y dos minutos.
'49s Cuarenta y nueve segundos.
`+5h Cinco horas fijando la hora de inicio.
`-5h Cinco horas fijando la hora de finalización.
Nota: Un intervalo positivo significa fijar la hora de inicio y un intervalo negativo significa
fijar la hora de finalización. Si no se utilizan signos de más o menos, el intervalo
se considera positivo. De modo que si la hora de inicio es "y", la hora de
finalización es "t" y el intervalo es "+5h" para la función 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.
Apéndice D: Argumentos de Setup.ini
Instalaciones silenciosas
Para instalaciones silenciosas, utilice el silent.ini incluido en el kit de distribución de

DataLink. Realice las especificaciones específicas del sitio que sean necesarias. Los
argumentos de silent.ini se describen más detalladamente en las secciones de los argumentos
Setup.ini de PI SDK y de los argumentos Setup.ini de PI DataLink. Para utilizar el INI de
forma silenciosa, escriba:
Setup.exe -f silent.ini
Instalación de PI SDK
Hay unos pocos argumentos que se pueden añadir como argumentos a la línea de comandos
para instalar el SDK silenciosamente. Para hacer que funcione cualquiera de los argumentos,
la línea de comandos debe contener /qn. Todos los argumentos deben separarse por un
espacio. La siguiente expresión es un ejemplo del aspecto que el setup.ini debe tener:
[COMMANDLINE] 5 = /qn PI_SERVER=localhost
Argumento Significado
/qn Instalar silenciosamente
PI_SERVER Nombre del servidor PI predeterminado
PI _ALIAS Nombre de alias del servidor PI predeterminado
PI_PORT Puerto predeterminado del servidor PI predeterminado
PI_TYPE Tipo de servidor del servidor PI predeterminado (2 ó 3)
PI_USER Usuario predeterminado del servidor PI predeterminado
INSTALLDIR Ruta de instalación
PIBUF_ENABL Habilita/deshabilita el almacenamiento
E
ALLUSERS Instalaciones de todos los usuarios del equipo

Instalación de PI DataLink
Hay unos pocos argumentos que se pueden añadir como argumentos a la línea de comandos
para instalar el PI DataLink. Todos los argumentos deben separarse por un espacio. La
siguiente expresión es un ejemplo del aspecto que el setup.ini debe tener:
[COMMANDLINE] 6 = /q SHARED=P:\APPS
Argumento Significado
/q Instalar silenciosamente
SHARED Nombre de ruta de la instalación de red
ALLUSERS Instalaciones de todos los usuarios del
equipo
Apéndice E: Códigos de salida
El código de salida es la representación decimal de los bits binarios. Los bits son los
siguientes:
bit 1: Mostrar marcas de tiempo
bit 2: Orientación (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 finalización
bit 9: Mostrar tiempo mín/máx
La fórmula para calcular el código de salida correspondiente es:
∑2
i
xi −1
(where i is the bit number for each bit that is set)
Nota: No todos los códigos de salida son válidos para cada función porque no todas las
opciones están disponibles para cada función.
Ejemplo
Supongamos que necesitamos la función Datos calculados para mostrar el Porcentaje

correcto, la Hora de inicio y la Hora mín/máx. Al mostrarse la Hora de inicio y la Hora
mín/máx, también tendremos que establecer el bit Mostrar marcas de tiempo.

bits set = { Show Timestamps, Show Pct Good, Show Start Time, Show Min/Max Time }
= {1, 3, 7, 9 }
outcode = ∑2
i
xi −1
= 21−1 + 2 3−1 + 2 7 −1 + 2 9−1
= 2 + 2 2 + 2 6 + 28
0
= 1 + 4 + 64 + 256
= 325
De este modo, la función mostrada en Excel se parecerá a:

=PICalcDat("sinusoid","y","t","1h","minimum", 1, 325,"piserver")
158
Apéndice F: Soporte técnico y recursos
Opciones del soporte técnico
OSIsoft proporciona soporte técnico dedicado en ámbito internacional, 24 horas al día, 7 días
a la semana. Puede leer toda la información acerca de las opciones de soporte técnico y
acceder a los siguientes recursos en el sitio web Soporte Técnico OSIsoft:
http://techsupport.osisoft.com (http://techsupport.osisoft.com)
OSIsoft proporciona las opciones y recursos siguientes.
Asistencia y soporte telefónico
El soporte telefónico está disponible 24 horas al día, 7 días 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.
EE.UU. y Canadá: (510) 297-5828
Fuera de América del Norte: +01 510-297-5828
FAX: (510) 352-2349
Soporte por correo electrónico
Envíe sus preguntas, con la descripción del problema y los registros de mensajes, a la
dirección del soporte técnico techsupport@osisoft.com (mailto:techsupport@osisoft.com).
Recibirá una respuesta en 24 horas.

Soporte técnico en línea personalizado
El Centro de llamadas en línea le permite realizar una llamada de soporte, que será contestada
en 24 horas. También le permite revisar la información de sus llamadas de soporte previas.
Elija Mi soporte> Mis llamadas (soporte en línea) en el sitio web Soporte técnico. El menú
Mi soporte le permite revisar Mis productos, Mi historial de descargas y los Términos
SRP, que abarcan los acuerdos de servicio del Service Reliance Program (SRP).
Centro de conocimiento
El Centro de conocimiento proporciona una biblioteca de búsqueda de documentación y datos

técnicos, así como una recopilación especial de recursos para los administradores del sistema.
Para obtener estas opciones, haga clic en el Centro de conocimiento del sitio Web Soporte
técnico.
La función Buscar permite encontrar soluciones de soporte, noticias, páginas de soporte

técnico, problemas conocidos, mejoras y documentación (que incluyen manuales del
usuario, notas de la versión y notas del producto).
Los recursos del administrador del sistema incluyen herramientas e instrucciones que le
ayudan a tratar: el tamaño de los archivos históricos, las copias de seguridad de las
secuencias de comandos, el mantenimiento diario, la configuración de horario de verano,
la seguridad del servidor PI, el tamaño y la configuración del PI System, los PI Trusts de
los nodos de interfaz y mucho más.
Acceso al servidor remoto
Los ingenieros del soporte técnico pueden acceder remotamente a su servidor PI para
proporcionar diagnósticos, resolución de problemas prácticos y asistencia. Elija
Contactarnos > Opciones de acceso remoto en el sitio Web Soporte técnico.
Soporte técnico en línea
OSIsoft proporciona servicio in situ según los contratos de nivel de servicio de SRP. Para ver
el estado actual de SRP, vaya a Mi soporte > Términos SRP en el sitio Web Soporte
técnico.
Antes de llamar o escribir solicitando ayuda
Cuando se ponga en contacto con el Soporte técnico OSIsoft, deberá facilitar:
160
Antes de llamar o escribir solicitando ayuda
El nombre del producto, los números de versión y/o compilación
La plataforma del equipo (tipo de CPU, sistema operativo y número de versión)
La hora en la que se inició la dificultad
Los registros de mensajes en ese momento
Encontrar los números de versión y compilación
Para encontrar los números de versión y compilación de cada subsistema de PI System (que
varían según las mejoras, actualizaciones o revisiones instaladas) utilice uno de los métodos
siguientes:
Si ha instalado las Herramientas de administración del PI System (PI SMT), elija Inicio >
Programas > PI System > Herramientas de administración del PI System. En PI
SMT, seleccione el nombre del servidor y, a continuación, bajo Complementos de
administración del sistema, abra Operación > Versión PI. El árbol Versión PI muestra
todas las versiones.
Si no ha instalado PI SMT, abra un símbolo del sistema, cambie al directorio pi\adm e
introduzca piversion -v. Para ver los números de las versiones individuales de cada
subsistema, cambie al directorio pi\bin e introduzca el nombre del subsistema seguido de
la opción -v (por ejemplo, piarchss.exe -v).
Ver información de la plataforma del equipo
Para ver las especificaciones de la plataforma:
En Windows, haga clic con el botón derecho del ratón en Mi PC y elija Propiedades.
Para obtener información más detallada, elija Inicio > Ejecutar e introduzca
msinfo32.exe
En UNIX, utilice el comando uname -a

Índice
Conexiones • 137
A Cuadro de diálogo • 137
Acceso de datos • 12 Problemas • 144
Servidor PI 3 • 12 Configurar
Acceso de puntos • 12 Lotus 1-2-3 • 7
Servidor PI 3 • 12 Control ActiveX • 78
Actualizar los datos PI en una hoja de cálculo Corrección de errores
Lotus 1-2-3 • 112 Lista de • 8
Administrador de PI System • 8 Cuadro de diálogo • 105, 113
Ajustes • 138 Ajustes • 138
Apóstrofe • 95 Alias • 76
Atributos del tag • 95, 119 Atributos del tag • 119
Autentificación de nodo Búsqueda de tags • 138
Servidor PI 2 • 8 Cálculo de expresiones • 134
Ayuda • 89 Campos de edición • 105
Conexiones • 137
B Datos calculados • 127
Datos calculados avanzados • 59
Barra de herramientas • 103
Datos comprimidos (horas) • 45, 124
Base de datos de firewall • 12
Datos comprimidos (número) • 41, 123
Búsqueda de tags • 107, 138
Datos comprimidos filtrados (horas) • 132
Datos comprimidos filtrados (número) • 130
C
Datos de muestra • 122
Cadenas de tiempo PI • 155 Datos de muestra filtrados • 129
Cambiar argumentos • 21, 34 Datos temporizados • 126
Campos de edición • 105 Filtrado de tiempo • 135
Campos de PIServer • 26, 106 Funciones • 35, 113
Campos de resultados • 26, 106 Identificador del punto para tag • 73
Casilla de verificación Mostrar hora • 111 Introducir hora en Excel • 29
Comilla simple • 95 Introducir hora en Lotus 1-2-3 • 111
Complemento de Lotus 1-2-3 • 1, 93 Máscara de atributo para tag • 74
Comprobar conexiones Module Database • 85
Tutorial de complementos de Excel • 94 Propiedad • 77
Tutorial de complementos de Lotus 1-2-3 • 94 Valor actual • 113

ĺndice
Valor calculado • 116 Funciones matemáticas • 150

Valor de archivo histórico • 114 Operadores lógicos • 153
Valor de tiempo exacto • 115 Operadores matemáticos • 149
Cuadros combinados • 27 Operadores relacionales • 152
Cuadros de lista • 107 Performance Equations • 151
D F
Datos calculados • 127 Funciones • 32
Datos calculados avanzados • 59 Cuadros de diálogo • 35
Datos comprimidos Excel • 35
(Horas) • 45, 124 Incluido en Excel • 15
(Horas) Filtrado • 132 Incluido en Lotus 1-2-3 • 93
(Número) • 41, 123 Performance Equation • 151
(Número) Filtrado • 130
Datos de muestra • 122 I
Ejemplo • 20 Identificador del punto para tag • 74
Filtrado • 129 Informar sobre errores • 112
Datos filtrados Instalación
Comprimido (horas) • 132 Argumentos • 158
Comprimido (número) • 130 Configurar 1-2-3 • 7
Muestreado • 129 Local • 4
Datos temporizados • 126 Red • 3
Delimitadores • 149 SDK • 157
Desviaciones estándar • 59, 116, 127 Introducir hora en PI DataLink • 111
E L
Error de Gethostbyname • 144 Limitaciones
Error de tiempo de espera connect() • 144 PI DataLink para 1-2-3 • 142
Error de tiempo de espera select() • 144
Errores • 143 M
Error de tiempo de espera connect() • 144
Macros
Error de tiempo de espera select() • 144
Campos de resultados • 106
Gethostbyname • 144
Comandos de macro
Informe • 112
recv Error 0 • 144 Lotus 1-2-3 • 95
Expresiones • 51, 71, 72, 135 Macros y cuadros de diálogo • 112
Cálculo • 134 Opción Salida • 110
Filtrado de tiempo • 135 Marcas de tiempo
Sintaxis • 149 En Lotus 1-2-3 • 110
Expresiones de cálculo • 149 En Microsoft Excel • 110
Expresiones de filtro • 152 Intervalo de tiempo • 156
Expresiones PI • 149 Introducir en PI DataLink • 29
Marcas de tiempo de entrada
164
Hora de inicio y de finalización • 155 Problemas de carga • 143
Intervalo de tiempo • 156 PI SDK
Máscara de atributo para tag • 75 Instalación silenciosa • 157
Matriz PIADMIN
Opciones • 106 Privilegios del usuario • 12
Máxima y mínima • 59, 116, 127 PIAdvCalcDat • 66
Menú • 103 PIAdvCalcExpDat • 68
Menú PI PIAdvCalcExpFilDat • 69
No se muestra • 143 PIAdvCalcExpFilVal • 65
Microsoft Excel PIAdvCalcExpVal • 64
Complemento • 1, 15 PIAdvCalcFilDat • 67
Modos de cálculo • 59, 116, 127 PIAdvCalcFilVal • 63
Module Database • 85 PIAdvCalcVal • 62
MultiNet PIAliasToTag • 76
Traducción de nombre, Cliente PI • 8 PIArcVal • 38, 114
PICalcDat • 58, 128
N PICalcVal • 56, 118
No se puede conectar al servidor PI • 144 PICompDat • 46, 125
Nodos PINet PICompFilDat • 47, 133
seguridad en • 8 PICurrVal • 36, 113
Nombre cliente del equipo • 8 PIExpDat • 51, 135
nombre de usuario/contraseña PIExpVal • 38
Servidor PI 3 • 12 PIExTimeVal • 115
Nombres del nodo PINCompDat • 43, 123
TCP/IP • 8 PINCompFilDat • 44, 131
PIPropertyValue • 77
O PIPutVal • 90, 140
PIPutValX • 141
Opción Barra de desplazamiento • 82
PISampDat • 49, 122
Opción Cambiar escala • 82
PISampFilDat • 50, 129
Opción Definir trend • 82
PITagAtt • 41, 121
Opción Formato • 82
PITimeDat • 52, 126
Opción Revertir • 82
PITimeExpDat • 53
PITimeFilter • 72
P
PITimeFilterVal • 71
Palabra clave Curtime • 151 Porcentaje correcto • 116, 127
PathWay Privilegios del usuario
Traducción de nombre, Cliente PI • 8 PIADMIN • 12
Performance Equation Problemas de carga • 143
Sintaxis • 151 Promedio de medias • 116, 127
Performance Equations • 149 Promedios • 59, 116, 127
PI DataLink
Argumentos de instalación • 158
Funciones • 35

ĺndice
R V
Reconoce mayúsculas y minúsculas Valor actual • 95, 113
Nombres del nodo • 8 Valor calculado • 116
recv Error 0 • 144 Valor de archivo histórico • 114
Resolución de problemas • 143 Valor de tiempo exacto • 115
Resumen de características • 103 Valores
Escribir en PI • 89, 139
S Versión
Seguridad PI System 2.0.9 • 151
Servidor PI 2 • 8 Software de hoja de cálculo • 2
Servidor PI 3 • 12 TCP/IP • 2
Servidor PI 2
Configuración del servidor • 8
Servidor PI 3
configuración • 12
seguridad • 12
setup.ini
Argumentos • 157
PI DataLink • 158
Sintaxis
Performance Equation • 151
Sistema operativo • 2
Soporte técnico OSIsoft • 143
T
TCP/IP • 2
Nombres del nodo • 8
TCPWare
Traducción de nombre, Cliente PI • 8
Totales • 116, 127
Trend
Menú del botón derecho del ratón • 82
Trend Control • 78
Tutorial
DataLink para Lotus 1-2-3 • 93
DataLink para Microsoft Excel • 93
U
UCX
Traducción de nombre para cliente PI • 8
166

ES PI DataLink User Guide PDF

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

ES PI DataLink User Guide PDF

Cargado por

Copyright:

Formatos disponibles

Manual del usuario de PI DataLink

© 1992-2007 OSIsoft, Inc. Reservados todos los derechos

OSIsoft Mexico S. De R.L. De C.V.

LEYENDA DE DERECHOS LIMITADOS

Capítulo 1: Introducción .............................................................................................................1

Capítulo 2: Complemento para Excel......................................................................................15

Capítulo 3: Complemento para Lotus 1-2-3 ............................................................................91

Apéndice A: Resolución de problemas ...................................................................................141

Apéndice B: Sintaxis de expresiones......................................................................................147

Manual del usuario de PI DataLink iii

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

Apéndice C: Ejemplos de cadenas de tiempo PI....................................................................153

Apéndice D: Argumentos de Setup.ini ....................................................................................155

Apéndice E: Códigos de salida ................................................................................................157

Apéndice F: Soporte técnico y recursos ................................................................................159

PI DataLink proporciona un enlace entre el servidor PI 3 o PI 2 de OSIsoft y los programas

PI DataLink está compuesto por los dos módulos siguientes:

 Un complemento para Microsoft Excel

 Un complemento para Lotus 1-2-3

Requisitos del sistema

PI DataLink se ejecuta en una aplicación de hoja de cálculo adecuada en un equipo cliente

Manual del usuario de PI DataLink 1

Sistema operativo y software de red

El servidor PI se puede ejecutar en OpenVMS, Windows o UNIX. PI DataLink se comunica

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

 Microsoft Windows 98, 2000, o XP

 Microsoft Windows NT, versión 4 SP6a

Si el servidor PI se ejecuta en OpenVMS, en el equipo VMS será necesario uno de los

 Servicios DEC TCP/IP para OpenVMS, versión 2.0+

 Software de proceso TCPWare, versión 3.1+

 Cisco MultiNet, versión 3.4+

 Attachmate Pathway, versión de ejecución 1.1+

Programas de hoja de cálculo compatibles

 Microsoft Excel 2000, versión 9.0 y posterior.

Nota: Antes de la instalación, cada usuario de PI DataLink debe disponer de la licencia

El usuario puede instalar PI DataLink desde el CD de distribución, ya sea localmente en un

Instalación en un servidor de archivos de red

La instalación en un servidor de archivos de red se realizar en un equipo local.

A continuación se resume el procedimiento para la instalación en un servidor de archivos de

1. Ejecute AdminSetup.exe desde el CD de distribución en el servidor de archivos de

2. Seleccione el directorio de destino (por ejemplo: C:\APPS\). El programa de

3. Para las instalaciones compartidas, edite la sección [COMMANDLINES] de setup.ini en

Manual del usuario de PI DataLink 3

Las notas de la versión actual se encuentran en

Las notas de la versión de las versiones anteriores se encuentran en

Instalación en un equipo local (independiente y compartida)

A continuación se resume el procedimiento para la instalación en un equipo local:

1. Ejecute el archivo setup.exe del CD de distribución o del directorio de instalación de la

2. Seleccione el directorio de destino.

Las notas de la versión se encuentran en P:\APPS\PIPC\readme_datalink.txt.

Las notas de las versiones anteriores se encuentran en

Configuración de Microsoft Excel

Si PI DataLink se va a utilizar con Microsoft Excel y se trata de la primera instalación (no

2. Abra el administrador de complementos de Excel a través de Herramientas >

3. Busque y seleccione el archivo PIPC32.XLL. Para una instalación local, el archivo

Si PI DataLink se actualiza y se coloca en un directorio diferente al de las versiones

Usuarios fuera de EE.UU.

1. En el menú PI, haga clic en Ajustes. Se mostrará el siguiente cuadro de diálogo:

Manual del usuario de PI DataLink 5

Por ejemplo, en Alemania los equivalentes de "General" y "dd-mmm-yyyy hh:mm" son

Configuración de Lotus 1-2-3

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

1. Inicie Lotus 1-2-3.

Un complemento para Microsoft Excel

Un complemento para Lotus 1-2-3

Microsoft Windows 98, 2000, o XP

Microsoft Windows NT, versión 4 SP6a

Servicios DEC TCP/IP para OpenVMS, versión 2.0+

Software de proceso TCPWare, versión 3.1+

Cisco MultiNet, versión 3.4+

Attachmate Pathway, versión de ejecución 1.1+

Microsoft Excel 2000, versión 9.0 y posterior.

Valor en un momento determinado

Atributos del tag

Datos espaciados de forma uniforme (de muestra)

Datos de muestra mientras una expresión determinada es verdadera

Datos comprimidos (archivados)

Datos comprimidos si una expresión determinada es verdadera

Datos de los cálculos en las expresiones del tag PI

Cantidad de tiempo mientras una expresión de tag PI era verdadera

Totales, mínima, máxima, desviaciones estándar, rangos, promedios, recuentos y

Nombres de tags de máscaras de atributos especificadas

Valor de alias de una base de datos de módulo

Valor de propiedad de una base de datos de módulo