Documentos de Académico
Documentos de Profesional
Documentos de Cultura
ES PI DataLink User Guide PDF
ES PI DataLink User Guide PDF
Versión 3.1
2006-12
OSIsoft Japan KK
Tokio, Japón
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.
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
Índice ...........................................................................................................................................163
iv
Capítulo 1: Introducción
Contenido de PI DataLink
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.
TCP/IP
Los usuarios de Microsoft Windows deben utilizar la capa TCP/IP creada en el sistema
operativo.
TCP/IP en OpenVMS
PI DataLink es compatible con los siguientes programas de hoja de datos (sólo versiones de
32 bits):
Lotus 1-2-3 versión 9.5 (incluida como parte de Lotus SmartSuite Millennium) y
posterior.
2
Instalación
Instalación
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.
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.
6 = SHARED="P:\APPS\PIPC"
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.
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.
1. Inicie Excel.
4
Instalación
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:
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.
6
Instalación
5. Salga de Lotus 1-2-3 y vuelva a iniciarlo. El menú PI-DataLink deberá estar disponible
ahora.
Corrección de errores
Servidor PI 2
Servicio de servidor PI
Archivo de seguridad
8
Para el administrador de PI System
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.
Este PIServer.Dat es el mismo que el del ejemplo anterior, excepto en dos casos:
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.
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.
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
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 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
Para el administrador de PI System
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
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 PathWay de VAX para un equipo, debe editar el
archivo twg$etc:Hosts. Para obtener más detalles, consulte su documentación de PathWay.
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
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 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.
Servidor PI 3
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".
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".
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
Para el administrador de PI System
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.
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".
Resumen
Valor actual
Datos de muestra para una matriz de marcas de tiempo especificada por el usuario
Tutorial
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.
En este ejemplo obtendremos el descriptor del tag, el valor actual y las unidades de ingeniería
para algunos tags.
1. Abra Excel.
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.
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.
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
1. Haga clic con el botón derecho del ratón sobre cualquier parte de la matriz creada en el
ejemplo anterior.
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.
22
Menú PI
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
Valor de archivo histórico recupera un único valor del archivo histórico (se puede
interpolar)
Atributos del tag recupera un atributo del tag
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
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
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.
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.
El campo Salida le permite especificar la esquina superior izquierda del rango en el que PI
DataLink colocará los datos resultantes.
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.
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.
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
Tiempo en PI DataLink
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.
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.
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.
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.
30
Tiempo en PI DataLink
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.
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.
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.
32
Funciones de PI DataLink
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.
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 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.
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 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".
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
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".
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
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.
Campo obligatorio
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()
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
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Este cuadro de diálogo obtiene un valor a una hora especificada. Hay cinco modos de
selección:
Campos obligatorios
Marca de tiempo
Consulte también
PIArcVal()
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea el valor de archivo histórico.
time stamp (cadena) La marca de tiempo PI.
outcode (entero) Un código de salida; 0, 1 o 2.
PIServer (cadena) El servidor PI.
mode (cadena) El modo de recuperación.
Devoluciones
Código Columna 1 Columna 2
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()
Argumentos
Argumento Explicación
expression (cadena) La cadena para la que desea el valor de archivo histórico.
time stamp (cadena) La marca de tiempo PI.
PIServer (cadena) El servidor PI.
38
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Devoluciones
Código Columna 1 Columna 2
de salida
0 Valor de archivo
histórico
1 Marca de tiempo Valor de archivo
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")
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".
Atributo Explicación
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.
location2 Parámetro de ubicación 2.
location3 Parámetro de ubicación 3.
location4 Parámetro de ubicación 4.
location5 Parámetro de ubicación 5.
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Atributo Explicación
pointid Número de identificación interno único que no se reutiliza al eliminar un punto.
PITagAtt()
PITagAtt(tagname, attribute, PIServer)
Argumentos
Argumento Explicación
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).
PIServer (cadena) El servidor PI.
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",)
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
Expresión de filtro
Tipo de límite
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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
PINCompDat()
PINCompDat(tagname, stime, numvals, outcode, PIServer)
Argumentos
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
Devoluciones
Códigos de salida
Ejemplo
PINCompFilDat()
PINCompFilDat(tagname, stime, numvals, filtexp, filtcode, outcode,
PIServer)
Argumentos
Argumento Explicación
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.
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.
outcode (entero) Un código de salida. Para obtener más información sobre los códigos de
salida, consulte Códigos de salida.
PIServer (cadena) El servidor PI.
Devoluciones
Ejemplo
44
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Este cuadro de diálogo devuelve valores comprimidos del servidor PI basándose en una hora
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
Expresión de filtro
Tipo de límite
Casillas de verificación
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.
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
PICompDat()
PICompDat(tagname, stime, etime, outcode, PIServer)
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea datos comprimidos.
46
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Argumento Explicación
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
outcode (entero) Un código de salida. Para obtener más información sobre los códigos de
salida, consulte Códigos de salida.
PIServer (cadena) El servidor PI.
Devoluciones
Ejemplo
PICompFilDat()
PICompFilDat(tagname, stime, etime, filtexp, filtcode, outcode,
PIServer)
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea datos comprimidos.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
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.
outcode (entero) Un código de salida. Para obtener más información sobre los códigos de
salida, consulte Códigos de salida.
PIServer (cadena) El servidor PI.
Devoluciones
Ejemplo
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
Hora de finalización
Intervalo de tiempo
Expresión de filtro
48
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Notas especiales
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 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
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
PISampDat()
PISampDat(tagname, stime, etime, interval, outcode, PIServer)
Argumentos
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos de muestra
1 Marcas de tiempo Datos de muestra
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
Argumento Explicación
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.
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.
outcode (entero) Un código de salida; 0, 1, 2 ó 3.
PIServer (cadena) El servidor PI.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos de muestra
1 Marcas de tiempo Datos de muestra
50
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Ejemplo
PIExpDat()
PIExpDat(expression, stime, etime, interval, outcode, PIServer)
Argumentos
Argumento Explicación
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).
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.
PIServer (cadena) El servidor PI.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos calculados
1 Marcas de tiempo Datos calculados
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.
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:
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()
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea datos de muestra.
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.
PIServer (cadena) El servidor PI.
mode (cadena) El modo de recuperación.
52
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
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 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,)
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)
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
Hora de finalización
Factor de conversión
Modo de cálculo
Intervalo
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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 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.
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()
PICalcVal(tagname, stime, etime, mode, cfactor, outcode, PIServer)
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea el valor calculado.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
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.
PIServer (cadena) El servidor PI.
Devoluciones
56
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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.
Un código de salida 6 transpone la matriz de salida que resulta de un código de salida 4; p.ej.,
los resultados se devuelven en filas en vez de en columnas.
Un código de salida 7 transpone la matriz de salida que resulta de un código de salida 5; p.ej.,
los resultados se devuelven en filas en vez de en columnas.
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
Argumento Explicación
tagname (cadena) El tag para el cual desea los datos calculados.
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.
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.
PIServer (cadena) El servidor PI.
Devoluciones
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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)
Range (Rango)
Average (Promedio)
Count (Cuenta)
Campos obligatorios
Hora de finalización
Factor de conversión
Modo de cálculo
Expresión de filtro
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.
Existen 3 modos de muestreo de expresión para realizar una muestra de la expresión de filtro:
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.
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Casilla de verificación
Notas especiales
Temas relacionados
PIAdvCalcVal()
PIAdvCalcVal(tagname, stime, etime, mode, calcbasis, minpctgood,
cfactor, outcode, PIServer)
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea el valor calculado.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
Argumento Explicación
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
calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7 excepto 3.
PIServer (cadena) El servidor PI.
Devoluciones
Para obtener información sobre la función PICalcVal() (en la página 56), consulte la sección
Devoluciones.
Ejemplo
La siguiente fórmula calcula un total de tiempo ponderado para el tag cdf144 desde ayer a
hoy del servidor PI predeterminado:
=PIAdvCalcVal("cdf144","y","t","total",0,50,1,4,)
Este resultado se multiplica por 1. El valor de minpctgood es el 50 por ciento, de modo que el
resultado únicamente se mostrará si el porcentaje correcto es del 50% o superior. El
porcentaje correcto se devuelve junto al total.
PIAdvCalcFilVal()
PIAdvCalcFilVal(tagname, stime, etime, filtexp, mode, calcbasis,
sampmode, sampinterval, minpctgood, cfactor, outcode, PIServer)
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea el valor calculado.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
62
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Argumento Explicación
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).
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.
sampmode (cadena) El modo de muestreo (pto. comprimido, exp. comprimida o
interpolado).
sampinterval (cadena) El intervalo de muestreo en formato de hora PI.
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 calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7 excepto 3.
PIServer (cadena) El servidor PI.
Devoluciones
Para obtener información sobre la función PICalcVal() (en la página 56), consulte la sección
Devoluciones.
Ejemplo
La siguiente fórmula calcula un total de tiempo ponderado para el tag cdf144 desde ayer a
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
porcentaje correcto se devuelve junto al total.
PIAdvCalcExpVal()
PIAdvCalcExpVal(expression, stime, etime, mode, calcbasis, sampmode,
sampinterval, minpctgood, cfactor, outcode, PIServer)
Argumentos
Argumento Explicación
expression (cadena) La expresión para la que desea el valor de archivo histórico.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
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.
sampmode (cadena) El modo de muestreo (comprimido o interpolado).
sampinterval (cadena) El intervalo de muestreo en formato de hora PI.
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
calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7 excepto 3.
PIServer (cadena) El servidor PI.
Devoluciones
Para obtener información sobre la función PICalcVal() (en la página 56), consulte la sección
Devoluciones.
Ejemplo
64
Detalles para las funciones y los cuadros de diálogo de PI DataLink
PIAdvCalcExpFilVal()
PIAdvCalcExpFilVal(expression, stime, etime, filtexp, mode,
calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode,
PIServer)
Argumentos
Argumento Explicación
expression (cadena) La expresión para la que desea el valor de archivo histórico.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
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).
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.
sampmode (cadena) El modo de muestreo (comprimido o interpolado).
sampinterval (cadena) El intervalo de muestreo en formato de hora PI.
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 calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7 excepto 3.
PIServer (cadena) El servidor PI.
Devoluciones
Para obtener información sobre la función PICalcVal() (en la página 56), consulte la sección
Devoluciones.
Ejemplo
PIAdvCalcDat()
PIAdvCalcDat(tagname, stime, etime, interval, mode, calcbasis,
minpctgood, cfactor, outcode, PIServer)
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea los datos calculados.
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.
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 calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7.
PIServer (cadena) El servidor PI.
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Este resultado se multiplica por 1. El valor de minpctgood es el 50 por ciento, de modo que el
resultado únicamente se mostrará si el porcentaje correcto es del 50% o superior. El
porcentaje correcto se devuelve junto al total.
PIAdvCalcFilDat()
PIAdvCalcFilDat(tagname, stime, etime, interval, filtexp, mode,
calcbasis, sampmode, sampinterval, minpctgood, cfactor, outcode,
PIServer)
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea los datos calculados.
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.
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).
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.
sampmode (cadena) El modo de muestreo (pto. comprimido, exp. comprimida o
interpolado).
sampinterval (cadena) El intervalo de muestreo en formato de hora PI.
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 calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7.
PIServer (cadena) El servidor PI.
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 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
Argumento Explicación
expression (cadena) La expresión para la cual desea los datos calculados.
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.
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.
sampmode (cadena) El modo de muestreo (comprimido o interpolado).
sampinterval (cadena) El intervalo de muestreo en formato de hora PI.
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 calculados (en la página 53).
outcode (entero) Un código de salida; de 0 a 7.
PIServer (cadena) El servidor PI.
68
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Devoluciones
Para obtener información sobre la función PICalcDat() (en la página 57), consulte la sección
Devoluciones.
Ejemplo
PIAdvCalcExpFilDat()
PIAdvCalcExpFilDat(expression, stime, etime, interval, filtexp,
mode, calcbasis, sampmode, sampinterval, minpctgood, cfactor,
outcode, PIServer)
Argumentos
Argumento Explicación
expression (cadena) La expresión para la que desea el valor de archivo
histórico.
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.
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).
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. (tiempo ponderado o evento
ponderado).
sampmode (cadena) El modo de muestreo (comprimido o interpolado).
sampinterval (cadena) El intervalo de muestreo en formato de hora PI.
minpctgood (número) Porcentaje mínimo de datos correctos durante un rango
temporal.
Argumento Explicación
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 excepto 3.
PIServer (cadena) El servidor PI.
Devoluciones
Para obtener información sobre la función PICalcDat() (en la página 57), consulte la sección
Devoluciones.
Ejemplo
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
70
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Hora de finalización
Notas especiales
Temas relacionados
PITimeFilterVal()
PITimeFilterVal(expression, stime, etime, timeunit, outcode,
PIServer)
Argumentos
Argumento Explicación
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).
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
timeunit (cadena) La unidad de tiempo del resultado que se va a mostrar. Las
entradas válidas son: segundos, minutos, horas y días.
outcode (entero) Un código de salida; de 0 a 7 excepto 3.
PIServer (cadena) El servidor PI.
Devoluciones
Ejemplo
PITimeFilter()
PITimeFilter(expression, stime, etime, interval, timeunit, outcode,
PIServer)
Argumentos
Argumento Explicación
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).
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.
timeunit (cadena) La unidad de tiempo del resultado que se va a mostrar. Las
entradas válidas son: segundos, minutos, horas y días.
outcode (entero) Un código de salida; de 0 a 7.
PIServer (cadena) El servidor PI.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos calculados
1 Marcas de tiempo Datos calculados
72
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Ejemplo
Este cuadro de diálogo devuelve el nombre de tag del identificador del punto especificado.
Campos obligatorios
Identificador de punto
Temas relacionados
PIPointIDToTag()
PIPointIDToTag(pointid, PIServer)
Argumentos
Argumento Explicación
PointID (cadena) Número de identificación interno único que no se reutiliza al
eliminar un punto.
PIServer (cadena) El servidor PI.
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")
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 ()
PIAttributeMaskToTag(tagname, descriptor, pointsource, pointtype,
pointclass, engunits, outcode, PIServer)
Argumentos
Argumento Explicación
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Argumento Explicación
engunits (cadena) Máscara de unidades de ingeniería.
outcode (entero) Un código de salida; 0 o 2.
PIServer (cadena) El servidor PI.
Devoluciones
Código Columna 1 Columna 2
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")
Campos obligatorios
Alias
Ruta de módulo
Fecha de consulta
Temas relacionados
PIAliasToTag()
PIAliasToTag(alias, modulepath, querydate, outcode, PIServer)
Argumentos
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Nombre de
tag
1 Nombre de Servidor de tag
tag
Ejemplo
Campos obligatorios
Propiedad
Ruta de módulo
Fecha de consulta
76
Detalles para las funciones y los cuadros de diálogo de PI DataLink
Temas relacionados
PIPropertyToValue()
Argumentos
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
Outcode (entero) Un código de salida; 0 o 2.
Devoluciones
Ejemplo
=PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax")
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 PI
El Asistente de trends se puede utilizar para crear una trend desde los datos de una hoja de
cálculo de Excel.
78
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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.
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.
80
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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.
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
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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.
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.
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.
84
Detalles para las funciones y los cuadros de diálogo de PI DataLink
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 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.
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.
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.
86
Detalles para las funciones y los cuadros de diálogo de PI DataLink
• 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
Ayuda
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
Argumento Explicación
Devoluciones
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.
Ejemplo
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
PI DataLink proporciona las siguientes funciones para recuperar datos del servidor PI:
Valor actual.
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.
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).
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
En este ejemplo, obtendremos el descriptor del tag, el valor actual y las unidades de
ingeniería de unos pocos tags.
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
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".
"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.
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]".
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.
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.
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.
{PITagAtt c2,'descriptor,',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.
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
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 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.
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.
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.
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 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.
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.
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.
Por tanto, puede realizar cambios menores en el cuadro de diálogo y ejecutar el mismo.
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.
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.
Tiempo en PI DataLink
Valores devueltos
Las marcas de tiempo devueltas por PI DataLink se encuentran en formato Lotus 1-2-3; es
decir, es un 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.
108
Tiempo en PI DataLink
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.
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.
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:
tiempo a la izquierda
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.
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.
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
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.
Campo obligatorio
{PICurrVal}
{PICurrVal tagname, outcode, PIServer, outcell}
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.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Código Columna 1 Columna 2
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}
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
Argumento Explicación
tagname (cadena) El tag para el cual desea el valor de archivo histórico.
time stamp (cadena) La marca de tiempo PI.
outcode (entero) Un código de salida; 0, 1 o 2.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
112
Detalles del cuadro de diálogo y la macro personalizada PI
Devoluciones
Código Columna 1 Columna 2
de salida
0 Valor de archivo
histórico
1 Marca de tiempo Valor de archivo
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}
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
Argumento Explicación
tagname (cadena) El tag para el cual desea el valor de archivo histórico.
time stamp (cadena) La marca de tiempo PI.
PIServer (cadena) El servidor PI.
Argumento Explicación
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Si existe, un valor del servidor PI. Si no existe 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}
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
Mínimo
Máximo
Rango
Campos obligatorios
Hora de inicio
Hora de finalización
Factor de conversión
114
Detalles del cuadro de diálogo y la macro personalizada PI
Modo de cálculo
Casilla de verificación
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.
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
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.
1 para unidades/hora
60 para unidades/minuto
{PICalcVal}
{PICalcVal tagname, stime, etime, mode, cfactor, outcode, PIServer,
outcell}
Argumentos
Argumento Explicación
tagname (cadena) El tag para el cual desea el valor calculado.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
mode (cadena) El modo de cálculo (total, mínimo, máximo, desviación
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.
outcode (entero) Un código de salida; de 0 a 7 excepto 3.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
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.
116
Detalles del cuadro de diálogo y la macro personalizada PI
Un código de salida 6 transpone la matriz de salida que resulta de un código de salida 4; p.ej.,
los resultados se devuelven en filas en vez de en columnas.
Un código de salida 7 transpone la matriz de salida que resulta de un código de salida 5; p.ej.,
los resultados se devuelven en filas en vez de en columnas.
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}
Campos obligatorios
Elija un atributo del tag del cuadro de lista. El atributo predeterminado es descriptor. Los
atributos del tag son:
Atributo Explicación
descriptor Descriptor de tag de 26 caracteres
Atributo Explicación
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
location2 Parámetro de ubicación 2
location3 Parámetro de ubicación 3
location4 Parámetro de ubicación 4
location5 Parámetro de ubicación 5
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
Detalles del cuadro de diálogo y la macro personalizada PI
Atributo Explicación
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
Argumento Explicación
tagname (cadena) El tag para el cual desea un atributo.
Attribute (cadena) El atributo del tag, consultar lista superior.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Atributo de tag
Ejemplo
Para obtener el descriptor del tag sinusoid desde el servidor PI predeterminado y colocar el
resultado en la celda A5:
{PITagAtt 'sinusoid,'descriptor,',A5}
Este cuadro de diálogo recopila valores de muestra espaciados de forma uniforme desde el
archivo histórico.
Campos obligatorios
Hora de inicio
Hora de finalización
Intervalo de tiempo
{PISampDat}
{PISampDat tagname, stime, etime, interval, outcode, PIServer,
outcell}
Argumentos
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
Outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos de muestra
1 Marcas de tiempo 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
Detalles del cuadro de diálogo y la macro personalizada PI
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.
Campos obligatorios
Nombre de tag
Hora de inicio
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.
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
Argumento Explicación
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 los datos del archivo histórico que va
hacia atrás desde la stime.
Outcode (entero) Un código de salida; 0, 1, 2 ó 3.
PIServer (cadena) El servidor PI.
Argumento Explicación
Outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este comando
de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos comprimidos
1 Marcas de tiempo Datos comprimidos
Ejemplo
Los resultados se colocan en un rango de salida cuya esquina superior izquierda es la celda
A5.
Este cuadro de diálogo devuelve valores comprimidos del servidor PI basándose en una hora
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
Hora de finalización
122
Detalles del cuadro de diálogo y la macro personalizada PI
Notas especiales
La función de este cuadro de diálogo sólo devuelve el número real de puntos de datos
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
Argumento Explicación
tagname (cadena) El tag para el cual desea datos comprimidos.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
outcode (entero) Un código de salida; 0, 1, 2 ó 3.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos comprimidos
1 Marcas de tiempo Datos comprimidos
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.
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
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda
del rango de salida que mantiene los resultados de este
comando de macro.
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.
124
Detalles del cuadro de diálogo y la macro personalizada PI
Ejemplo
Para obtener datos de muestra de cdf144 desde el servidor PI predeterminado para las marcas
de tiempo crecientes especificadas en las celdas de A5 a A25 y colocar el resultado en un
rango de salida cuya esquina superior izquierda sea la celda B5:
{PITimeDat 'cdf144,A5..A25,',B5}
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
Hora de finalización
Intervalo de tiempo
Factor de conversión
Modo de cálculo
Casilla de verificación
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
Argumento Explicación
tagname (cadena) El tag para el cual desea los datos calculados.
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.
mode (cadena) El modo de cálculo (total, mínimo, máximo, desviación
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.
outcode (entero) Un código de salida; de 0 a 7.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este comando
de macro.
Devoluciones
126
Detalles del cuadro de diálogo y la macro personalizada PI
Ejemplo
Para obtener marcas de tiempo y totales (con un factor multiplicador 24) en intervalos de una
hora desde la medianoche de ayer hasta la medianoche de hoy para el tag cdf144 desde el
servidor PI predeterminado y colocar el resultado en un rango de salida cuya esquina superior
izquierda sea la celda A10:
{PICalcDat 'cdf144,'y,'t,'1h,'total,24,1,',A10}
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
Hora de finalización
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).
Casillas de verificación
{PISampFilDat}
{PISampFilDat tagname, stime, etime, interval, filtexp, filtcode,
outcode, PIServer, outcell}
Argumentos
Argumento Explicación
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.
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).
filtcode (entero) Un código de filtro, utilice 1 para devolver el estado Filtrado
y 0 para omitirlo.
outcode (entero) Un código de salida; 0, 1, 2 ó 3.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos de muestra
1 Marcas de tiempo 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
izquierda sea la celda A5:
{PISampFilDat 'sinusoid,'y,'t,'3h,'('cdep158'>80),1,1,',A5}
128
Detalles del cuadro de diálogo y la macro personalizada PI
Campos obligatorios
Nombre de tag
Hora de inicio
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).
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.
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 PINCompFilDat dejará en blanco las
44 celdas finales.
{PINCompFilDat}
{PINCompFilDat tagname, stime, numvals, filtexp, filtcode, outcode,
PIServer, outcell}
Argumentos
Argumento Explicación
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.
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).
Argumento Explicación
filtcode (entero) Un código de filtro, utilice 1 para devolver el estado Filtrado y
0 para omitirlo.
outcode (entero) Un código de salida; 0, 1, 2 ó 3.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este comando
de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos comprimidos
1 Marcas de tiempo Datos comprimidos
Ejemplo
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
Hora de finalización
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).
130
Detalles del cuadro de diálogo y la macro personalizada PI
Casillas de verificación
Notas especiales
La función de este cuadro de diálogo sólo devuelve el número real de puntos de datos
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
Argumento Explicación
tagname (cadena) El tag para el cual desea datos comprimidos.
stime (cadena) La hora de inicio en formato de hora PI.
etime (cadena) La hora de finalización en formato de hora PI.
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).
filtcode (entero) Un código de filtro, utilice 1 para devolver el estado Filtrado
y 0 para omitirlo.
outcode (entero) Un código de salida; 0, 1, 2 ó 3.
PIServer (cadena) El servidor PI.
outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos comprimidos
1 Marcas de tiempo Datos comprimidos
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}
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
Hora de finalización
Intervalo de tiempo
{PIExpDat}
{PIExpDat expression, stime, etime, interval, outcode, PIServer,
outcell}
132
Detalles del cuadro de diálogo y la macro personalizada PI
Argumentos
Argumento Explicación
Expression (cadena) La expresión de cálculo. Para obtener más información
sobre la sintaxis de las expresiones de cálculo, consulte
Sintaxis de expresiones (en la página 147).
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.
PIServer (cadena) El servidor PI.
Outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos calculados
1 Marcas de tiempo 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
izquierda sea la celda A5:
{PIExpDat'('sinusoid'+'sqf100'),'y,'t,'1h,1,',A5}
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
Sintaxis de expresiones (en la página 147).
Hora de inicio
Hora de finalización
Intervalo de tiempo
{PITimeFilter}
{PITimeFilter expression, stime, etime, interval, timeunit, outcode,
PIServer, outcell}
Argumentos
Argumento Explicación
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).
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.
Timeunit La unidad de tiempo del resultado que se va a mostrar. Las
entradas válidas son: segundos, minutos, horas y días.
Outcode (entero) Un código de salida; 0, 1, 2 ó 3.
PIServer (cadena) El servidor PI.
Outcell (referencia) Una celda que especifica la esquina superior izquierda del
rango de salida que mantiene los resultados de este
comando de macro.
Devoluciones
Código Columna 1 Columna 2
de salida
0 Datos calculados
1 Marcas de tiempo Datos calculados
134
Detalles del cuadro de diálogo y la macro personalizada PI
Ejemplo
{PITimeFilter($A$1,"y","t","1h","seconds",1,"thevax",E1}
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.
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.
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.
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.
Ayuda de PI DataLink
Acerca de 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
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
Outcell (referencia) Una referencia a una celda en la que se muestra el valor
devuelto de esta función de macros.
Devoluciones
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
Escribir datos de Lotus 1-2-3 a PI
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
Argumento Explicación
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.
PIServer (cadena) El servidor PI.
Outcell (referencia) Una referencia a una celda en la que se muestra el valor
devuelto de esta función de macros.
Devoluciones
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}
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 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.
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.
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.
MultiNet PISysExe:MTNPIServer.log
PathWay PISysExe:PTWPIServer.log
TCPware PISysExe:TCPIServer.log
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.)
Problemas de conexión informados en los archivos de registro
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.
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.
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
Para el servidor PI 3
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.
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.
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
Problemas de conexión informados en los archivos de registro
service PIServer. Si está ejecutando otro servicio TCP/IP (por ejemplo, TGV
MultiNet) en el VAX/AlphaAXP, solicite a su administrador del sistema VMS que
compruebe si el servidor auxiliar del servidor PI ha sido configurado. Las instrucciones
se encuentran en PIBuild:PIServer.txt.
Expresiones de cálculo
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
+ 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
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
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.
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
Expresiones de filtro
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.
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:
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)
Intervalo de tiempo
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
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:
∑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
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
158
Apéndice F: Soporte técnico y recursos
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)
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.
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.
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
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.
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.
160
Antes de llamar o escribir solicitando ayuda
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).
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
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
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
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