PI Datalink 2010 User Guide ES PDF

Manual del usuario de PI DataLink
Versin 2010
OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 EE.UU.
Tel: (01) 510-297-5800Fax: (01) 510-357-8136

Web: http://www.osisoft.com
OSIsoft Australia Perth, Australia

OSIsoft Europe GmbH Frankfurt, Alemania
OSIsoft Asia Pte Ltd. Singapur
OSIsoft Canada ULC Montreal & Calgary, Canad
OSIsoft, LLC Representative Office Shanghai, Repblica Popular China
OSIsoft Japan KK Tokio, Japn
OSIsoft Mexico S. De R.L. De C.V. Ciudad de Mxico, Mxico
OSIsoft do Brasil Sistemas Ltda. Sao Paulo, Brasil
Copyright: <COPYRIGHT_FECHA> OSIsoft, LLC. Todos los derechos reservados.

Ninguna parte de esta publicacin puede ser reproducida, almacenada en un sistema de recuperacin o transmitida, de ninguna forma
ni por ningn medio, ya sea mecnico, fotocopiado, grabado o de cualquier otra forma, sin el consentimiento previo por escrito de
OSIsoft, LLC.
OSIsoft, el logotipo de OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, Sigmafine, Analysis Framework, IT Monitor,
MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Data Services, PI Manual Logger, PI
ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports y RtWebParts son todas marcas
comerciales registradas de OSIsoft, LLC. Todas las dems marcas o nombres comerciales aqu utilizados son propiedad de sus
respectivos propietarios.
DERECHOS DEL GOBIERNO DE LOS EE.UU.

Su uso, rplica o difusin por parte del Gobierno de EE.UU. est sujeto a las restricciones estipuladas en el contrato de licencia de
OSIsoft, Inc, de acuerdo con lo que establecen las regulaciones DFARS 227.7202, DFARS 252.227-7013, FAR 12.212 y FAR 52.227,
segn proceda. OSIsoft, LLC.
Publicado: 19/05/2010
Tabla de contenido
Captulo 1 Introduccin ................................................................................................................1
Ediciones de PI DataLink ...................................................................................................1
Requisitos del sistema .......................................................................................................3
Instalacin y actualizacin .................................................................................................3
Configuracin .....................................................................................................................3
Acerca de este documento ................................................................................................5
Captulo 2 Conceptos bsicos .....................................................................................................7

Interfaz de usuario..............................................................................................................7
Conexiones del servidor PI ..............................................................................................11
Componentes de funciones grficas................................................................................12
Configuracin de preferencia ...........................................................................................21
Construccin de una hoja de clculo ...............................................................................23
Captulo 3 Funciones PI..............................................................................................................25

Valor actual ......................................................................................................................25
Valor de archivo histrico.................................................................................................26
Datos comprimidos...........................................................................................................27
Datos de muestra .............................................................................................................30
Datos temporizados .........................................................................................................31
Datos calculados ..............................................................................................................33
Filtrado de tiempo.............................................................................................................37
Captulo 4 Tags PI y atributos ....................................................................................................39

Bsqueda de tags ............................................................................................................39
Funciones de tags ............................................................................................................41
Captulo 5 Objetos de Module Database...................................................................................45

Buscar en la base de datos de mdulos ..........................................................................45
Funciones de base de datos de mdulos ........................................................................47
Captulo 6 Hojas de clculo........................................................................................................49

Frecuencia de clculo ......................................................................................................49
Funciones y valores de matriz .........................................................................................51
Gestin de matrices .........................................................................................................52
Compartir hojas de clculo...............................................................................................54
Captulo 7 Pantallas de tendencias ...........................................................................................55

Crear un trend ..................................................................................................................55
Especificar el Intervalo de tiempo ....................................................................................58
Ttulo y posicin ...............................................................................................................59
Men contextual ...............................................................................................................59
Manual del usuario de PI DataLink iii

Tabla de contenido
Captulo 8 Notificaciones............................................................................................................63
Bsqueda y visualizacin de notificaciones.....................................................................63
Ver notificaciones .............................................................................................................66
Insertar notificaciones ......................................................................................................66
Apndice A Informacin complementaria ................................................................................69

Configuracin ...................................................................................................................69
Tiempo PI .........................................................................................................................71
Compatibilidad con el tipo de datos PI.............................................................................74
Expresiones PI .................................................................................................................74
Entrada manual de funcin ..............................................................................................81
Escribir datos en PI ..........................................................................................................84
Resolucin de problemas.................................................................................................85
Apndice B Referencia de funciones de PI DataLink ..............................................................87

Funciones de valor nico .................................................................................................87
Funciones de valor mltiple .............................................................................................90
Funciones de clculo........................................................................................................99
Funciones de tags ..........................................................................................................112
Funciones de base de datos de mdulos ......................................................................115
Funciones de entrada ....................................................................................................117
Apndice C Soporte tcnico y recursos .................................................................................119
Index ............................................................................................................................................123
iv
Captulo 1
Introduccin
PI DataLink es un complemento para Microsoft Excel que permite recuperar informacin
de su PI Server directamente a una hoja de clculo. Con PI DataLink, puede:
recuperar valores de punto de un servidor PI
recuperar metadatos de sistema para crear una visualizacin estructurada de datos PI:
Nombres y atributos de tags PI
Rutas, alias y propiedades de PI Module Database
hacer referencia a estos elementos utilizando funciones de PI DataLink para calcular
y filtrar datos
mantener los valores actualizados cuando la hoja de clculo se recalcule
recuperar de un PI System las PI Notifications a las que est suscrito
crear una tendencia con datos de la hoja de clculo o con puntos PI
PI DataLink proporciona una interfaz grfica para recuperar datos y crear funciones y
clculos. Las funciones de DataLink se integran en celdas de hoja de clculo y pueden
proporcionar actualizaciones activas de datos en tiempo real del servidor PI.
Tambin puede utilizar las ricas capacidades de clculo y formato de Excel para organizar
y presentar datos de un sistema PI para adecuarlos a su propsito o a su audiencia.
Combinadas con las capacidades grficas, de clculo y de formato de Microsoft Excel, PI
DataLink ofrece potentes herramientas para obtener, controlar, analizar y realizar
informes sobre datos PI.
Ediciones de PI DataLink
Nota: A lo largo de este libro, las referencias a Microsoft Excel 2007 son aplicables
a Microsoft Excel 2007 y posteriores. Las referencias a Microsoft Office
2007 son aplicables a Microsoft Office 2007 y posteriores.
En su sistema se encuentran instaladas dos ediciones de PI DataLink:

Hay instalado un complemento para Microsoft Excel 2007. Este complemento no se
puede ejecutar en versiones anteriores de Excel. Esta edicin se configura
automticamente si dispone de Excel 2007 en su sistema.
Se instala un complemento para Microsoft Excel XP o 2003. Este complemento se
parece a las versiones anteriores de PI DataLink y debe ser configurado manualmente
(pgina 3).
Las diferencias entre estos complementos residen principalmente en cambios en la
interfaz de usuario y diseo (pgina 7) para Office 2007 y posteriores.
Manual del usuario de PI DataLink 1

Introduccin
PI SDK
PI SDK se instala con PI DataLink y conecta PI DataLink con su servidor PI para

recuperar datos de puntos PI.
PI DataLink utiliza tanto PI SDK como Microsoft Excel SDK. Si se produce un error en
el nivel PI SDK, PI DataLink muestra el error en la celda. Por ejemplo, si una funcin
intenta recuperar el valor actual para un tag que no existe, la celda de salida muestra un
mensaje "PIPoint no encontrado".
PI SDK permite tambin que los usuarios que tengan experiencia con Microsoft Visual
Basic para Aplicaciones (VBA) puedan desarrollar rutinas Excel que llamen a funciones
PI SDK. Los usuarios que planeen desarrollar programas fuera de Excel deben adquirir
una licencia aparte para PI SDK o PI API. Para obtener ms informacin, pngase en
contacto con el personal de ventas de OSIsoft.
PI DataLink for Excel Services (DLES)
PI DataLink for Excel Services (PI DLES) es una versin de servidor de PI DataLink para
su uso con Microsoft Office SharePoint Server 2007 (MOSS). PI DLES admite todas las
funciones de DataLink y de PI BatchView proporcionadas por complementos Excel en
una configuracin tpica de cliente PI.
PI DLES permite recuperar y visualizar datos de PI Servers en formato de hoja de clculo
de Microsoft Excel utilizando nicamente un navegador web. El acceso a datos PI en
tiempo real puede extenderse a muchos consumidores diferentes, independientemente de
su ubicacin o de su familiaridad con las funciones de Microsoft Excel o de PI DataLink.
Esta versin de servidor de PI DataLink utiliza tecnologas MOSS, incluidos Excel
Services y el elemento web Excel Web Access. Reunidos, estos componentes de
Microsoft admiten la mayora de las funciones estndar de hojas de clculo. PI DataLink
for Excel Services aumenta estos servicios, aadiendo conectividad y soporte para
funciones PI.
Los libros de trabajo de Excel publicados en bibliotecas de documentos SharePoint
pueden ser accedidos de forma independiente o aadidos a pginas de elementos web. El
elemento web Excel Web Access admite conexiones que permiten el intercambio de
parmetros entre un libro de trabajo y otros elementos web, integrando hojas de clculo
con funciones PI DataLink en el entorno PI WebParts.
Para obtener ms informacin sobre PI DLES, pngase en contacto con el personal de
ventas de OSIsoft.
Compatibilidad con idiomas de PI DataLink
Esta versin de PI DataLink proporciona compatibilidad con varios idiomas. La interfaz

de usuario del complemento aparece en el mismo idioma que el Microsoft Excel en el que
se ejecuta, si el idioma est contemplado por DataLink. En caso contrario, el
complemento aparece en ingls.
Para ver el complemento en un idioma distinto, utilice la herramienta de configuracin de
idioma de Microsoft Office para cambiar el idioma de Microsoft Excel.
Para obtener la compatibilidad con mltiples idiomas, debe instalar un paquete de idioma
aparte.
2
Requisitos del sistema
Requisitos del sistema

Para conocer los requisitos del sistema, consulte el sitio web de soporte de OSIsoft:
http://techsupport.osisoft.com/Products.htm (http://techsupport.osisoft.com/Products.htm)
Instalacin y actualizacin
Instalacin
Para instalar, descargue el kit de instalacin desde http://techsupport.osisoft.com y ejecute
el kit de de instalacin de PI DataLink.
El programa de instalacin instala PI DataLink bajo el directorio raz de PIPC,
normalmente en:
C:\Archivos de programa\PIPC\Excel
La instalacin incluye tambin archivos de ayuda en lnea y notas de la versin, que
tambin estn disponibles para su descarga en http://techsupport.osisoft.com.
Actualizar
Si tiene una versin anterior de PI ProcessBook instalada en su equipo, el programa de
instalacin actualiza automticamente su instalacin. Los ajustes de preferencias de
versiones anteriores se conservan.
Los siguientes aspectos pueden ser de utilidad si se actualiza desde versiones anteriores
de PI DataLink:
PI DataLink es compatible con las versiones anteriores. Los libros de trabajo creados
en versiones anteriores pueden ser ledos por la versin actual sin realizar ninguna
conversin. No obstante, lo contrario no es necesariamente cierto. Una vez que
modifique una hoja de clculo en la versin actual, ya no funcionar en las versiones
anteriores de PI DataLink.
Las versiones actuales de PI DataLink utilizan PI SDK, mientras que las versiones 2.x
y anteriores utilizaban PI API.
Los mensajes de error devueltos pueden ser diferentes, por lo tanto, si las hojas de
clculo buscan determinadas cadenas (por ejemplo, en cdigo o macros de Excel
VBA) el texto puede no ser el mismo.
Las versiones 3.x y 4.x no crean una conexin API con el PI Server, por lo que el
cdigo VBA en libros de trabajo que dependa de una conexin API existente
deben editarse para crear una nueva conexin explcita con PI API.
Configuracin
Despus de la instalacin, tal vez necesite configurar el complemento PI DataLink en
Excel.
Microsoft Excel 2007

El programa de configuracin de PI DataLink instala automticamente el complemento
DataLink para Microsoft Excel 2007 si dicha versin se encuentra en el sistema. No es
necesaria configuracin alguna.

Introduccin
La instalacin pone DataLink a disposicin de todos los usuarios del ordenador cliente. Si
un usuario individual desactiva PI DataLink o un complemento relacionado, las
actualizaciones no reactivan el complemento; debe restaurarse manualmente. Para
restaurar complementos:
1. Haga clic en el botn Microsoft Office y seleccione Opciones de Excel.
2. Haga clic en Complementos > Administrar Elementos deshabilitados > Ir y active
PIDatlink.UI.dll.manifest.
3. Vaya a Complementos > Administrar Complementos COM > Ir y active
PIDatlink.UI.dll.manifesto PI Notifications.
4. Haga clic en Aceptar.
Microsoft Excel XP-2003

Si instala PI DataLink para Excel XP-2003, tendr que configurar el complemento para
Excel despus de la instalacin. Tambin puede utilizar este procedimiento para restaurar
el complemento si el men PI no aparece en la barra de mens de Excel.
Para aadir DataLink a versiones de Excel XP-2003:
1. En Excel, seleccione Herramientas > Complementos.
Aparecer el cuadro de dilogo de Complementos.
2. Si el complemento PI DataLink no aparece en la lista, haga clic en Examinar para

localizar el archivo PIPC32.XLL en su disco duro local.
La ruta predeterminada de PI DataLink es PIPC\EXCEL.
3. Haga clic en la casilla junto a PI DataLink y haga clic en Aceptar.
4
Acerca de este documento
Acerca de este documento

El Manual del usuario de PI DataLink proporciona una descripcin detallada de las
caractersticas del producto y una completa referencia sobre las funciones de PI DataLink.
El contenido de las versiones en lnea e impresa del manual es idntico. Los objetos de
control de trend lanzan tambin un archivo de ayuda aparte que incluye informacin sobre
controles de programacin para trends.
Las versiones impresas del Manual del usuario de PI DataLink incluyen tutoriales de
ejercicios utilizados por OSIsoft para los cursos de formacin de PI DataLink. Estos
ejercicio tambin estn disponibles en formato PDF (junto con los archivos de ejercicios
de formacin adjuntos) en el sitio web de soporte de OSIsoft en techsupport.osisoft.com.
Este manual no duplica o distingue entre los complementos PI DataLink para Excel 2007
y Excel XP-2003 cuando explica funcionalidades comunes, a menos que haya diferencias
funcionales significativas.
Las referencias especficas a PI DataLink para Excel XP-2003 estn marcadas (2003) y
las especficas para PI DataLink para Excel 2007 estn marcadas (2007), cuando es
necesario.

Captulo 2
Conceptos bsicos
Los siguientes apartados presentan las funciones y conceptos bsicos de PI DataLink.
Debera familiarizarse con estos apartados entes de utilizar PI DataLink para crear una
hoja de clculo y recuperar datos PI, particularmente, si no tiene experiencia con PI
DataLink o con Office 2007.
Estos apartados describen:
Componentes comunes de la interfaz y en qu se diferencian entre s los
complementos PI DataLink para Excel XP-2003 y Excel 2007
Las funciones esenciales necesarias para comenzar a trabajar con PI DataLink
Los diferentes enfoques para construir una hoja de clculo PI DataLink, dependiendo
de sus objetivos, necesidades y recursos
Interfaz de usuario
PI DataLink es una aplicacin complementaria de Microsoft Excel, y aparece dentro de la
interfaz de usuario de Microsoft Excel en forma de mens, cuadros de dilogo y paneles
de tareas especficos de PI DataLink.
Mientras que la funcionalidad subyacente de PI DataLink es la misma para Excel XP-
2003 y 2007, la interfaz de usuario y las herramientas utilizadas para construir y gestionar
hojas de clculo PI DataLink difieren ligeramente para reflejar el diseo y los objetos
disponibles para la versin correspondiente de Microsoft Excel.
Dependiendo de su versin de Excel, tendr que trabajar con uno de los siguientes grupos
de componentes de PI DataLink:
PI DataLink para Excel XP-2003 PI DataLink para Excel 2007
Men PI Cinta PI
cuadros de dilogo de funciones paneles de tareas de funciones
men contextual del botn derecho del men contextual del botn derecho del ratn
ratn
Asistente de control de trend Asistente de control de trend
Cuadro de dilogo de Notificaciones PI Cuadro de dilogo de Notificaciones PI
El siguiente apartado describe las diferencias visuales y de funcionamiento entre los

complementos PI DataLink.

Conceptos bsicos
PI DataLink para Excel 2007
PI DataLink para Excel 2007 incluye elementos de diseo presentados en Microsoft

Office 2007.
Si actualiza desde una versin anterior de PI DataLink, familiarcese con los nuevos
elementos de diseo antes de comenzar a trabajar con PI DataLink.
PI Ribbon
El complemento PI DataLink para Microsoft Excel 2007 utiliza un men de cinta.
El men de cinta es un men grfico que combina funciones de un men estndar y de

una barra de herramientas.
Haga clic en PI en la barra de mens de Excel para seleccionar la ficha del men de
cinta de PI DataLink.
haga clic en un elemento de la cinta PI para abrir el correspondiente cuadro de
dilogo o panel de tareas.
Site el cursor sobre un elemento para mostrar una ayuda inmediata descriptiva.
Paneles de tareas de funciones

PI DataLink para Microsoft Excel 2007 proporciona paneles de tareas personalizados para
definir funciones de PI DataLink.
Un panel de tareas es un panel de controles movible y apilable que funciona

principalmente como un cuadro de dilogo, excepto porque se puede continuar trabajando
en una hoja de clculo mientras el panel de tareas est abierto.
8
Interfaz de usuario
PI DataLink abre un panel de tareas cuando aade una funcin o selecciona una celda de
una matriz de funcin para editarla. Para abrir un panel de tareas de funcin:
Haga clic en la celda de salida deseada y, a continuacin, haga clic en una funcin de
la cinta PI para aadir una funcin.
Haga clic en una celda de una matriz de funcin existente para mostrar el panel de
tareas correspondiente y editar los argumentos de la funcin.
Haga clic con el botn derecho en una celda de matriz de funcin y seleccione el
nombre de la funcin para mostrar manualmente el panel de tareas.
Nota: Puede desactivar la aparicin automtica (pgina 20) de paneles de tareas si

lo prefiere.
Una vez que est abierto un panel de tareas de funcin:

Introduzca o modifique valores y, a continuacin, haga clic en Aceptar para guardar
sus cambios y cerrar el panel de tareas. Haga clic en Aplicar para guardar los
cambios sin cerrar el panel de tareas.
Haga clic en el botn X de la barra de ttulo del panel de tareas para cerrarlo sin
guardar los cambios.
Haga clic en el botn de flecha de la barra de ttulo del panel de tareas para separar y
Mover o Redimensionar el panel de tareas.
Tambin puede hacer clic en la barra de ttulo para arrastrar y acoplar un panel de
tareas, o colocar el cursor sobre el borde y arrastrar para redimensionar el panel.
Nota: Los cuadros de dilogo se utilizan para otras tareas, incluidas la Bsqueda
de tags, Preferencias y Conexiones en el complemento para Excel 2007.
PI DataLink para Excel XP-2003
PI DataLink para Excel XP-2003 aparece en Microsoft Excel como un men estndar y
los controles de cuadros de dilogo relacionados.
Si ha utilizado versiones anteriores de PI DataLink, el complemento para Excel XP-2003
mantiene el mismo aspecto.
Men PI
PI DataLink para Excel XP-2003 aade un men PI a la barra de mens de Excel una vez
que el complemento PI DataLink ha sido cargado. Si no ve el men PI, necesitar
configurar (pgina 3) el complemento PI DataLink para Excel.

Conceptos bsicos
PI DataLink para Excel XP-2003 utiliza un men estndar de configuracin:

Seleccione una opcin del men PI para abrir el correspondiente cuadro de dilogo.
Cuadros de dilogo de funcin

PI DataLink para Microsoft Excel XP-2003 proporciona cuadros de dilogo para definir
funciones de PI DataLink.
PI DataLink abre el correspondiente cuadro de dilogo cuando se aade o edita una

funcin. Para abrir un cuadro de dilogo de funcin:
Haga clic en una celda y, a continuacin, seleccione una funcin en el men PI para
aadir una funcin.
Haga clic con el botn derecho en una matriz de funcin existente para mostrar el
men contextual y, a continuacin, seleccione el nombre de la funcin en el men
para editar sus argumentos.
10
Conexiones del servidor PI
Una vez que est abierto un cuadro de dilogo de funcin:

Introduzca o modifique valores y, a continuacin, haga clic en Aceptar para guardar
sus cambios y cerrar el cuadro de dilogo.
PI DataLink recupera automticamente valores de PI y rellena la matriz de funcin de
su hoja de clculo cuando haga clic en Aceptar.
Haga clic en Cancelar o en X para cerrar el cuadro de dilogo sin guardar los
cambios.
Men contextual
PI DataLink aade varios comandos al men contextual estndar de Microsoft Excel.

Puede utilizar estos comandos para gestionar matrices de funcin que ya estn insertadas
en una hoja de clculo.
Nota: Los mens contextuales son los mismos en ambas versiones del
complemento PI DataLink.
Para mostrar el men contextual:

Haga clic en cualquier parte de una celda o grupo de celdas que contenga una matriz
de funcin de PI DataLink.
Una matriz de funcin es el grupo de celdas que contiene la salida de una funcin de
PI DataLink. Tambin puede hacer clic con el botn derecho en un control de tren
incrustado para ver un men contextual relacionado (pgina 59).
En el men contextual aparecen los siguientes elementos:
Elija Seleccionar funcin DataLink para seleccionar la matriz de funcin completa.
Debe seleccionar una matriz antes de intentar copiarla, cortarla o arrastrarla a una
nueva ubicacin en la hoja de clculo.
Seleccione Recalcula (redimensionar) funcin para recalcular (pgina 50) la
matriz, recuperando nuevos valores de PI.
Para algunas funciones, puede haber disponible un nmero distinto de valores en cada
reclculo, haciendo que la matriz se redimensione.
Seleccione <nombre de funcin> para abrir el correspondiente cuadro de dilogo de
funcin (pgina 10) y actualizar los argumentos para recopilar datos distintos.
Conexiones del servidor PI

Utilice el cuadro de dilogo Conexiones para gestionar las conexiones con los servidores
PI de su entorno informtico. Para conectarse a un servidor PI:
Haga clic en el icono Conexiones en la barra de cinta (2007), o seleccione PI >
Conexiones (2003) para mostrar el cuadro de dilogo Conexiones.
Los servidores PI configurados disponibles para PI DataLink aparecen en el panel
Servidor de la izquierda.
Si no ve el servidor deseado, puede aadir una conexin. Para aadir conexiones a
servidores PI adicionales:

Conceptos bsicos
Seleccione Servidor > Aadir servidor o haga clic con el botn derecho en el panel de
servidores y seleccione Aadir servidor en el men contextual para mostrar el cuadro de
dilogo Aadir servidor y configurar una nueva conexin a servidor PI. Una casilla
seleccionada junto a un nombre de servidor en el cuadro de dilogo Conexiones indica
una conexin abierta a un servidor PI.
Para gestionar la configuracin de la conexin:

Haga clic para seleccionar una casilla y abra una conexin a un servidor PI de la lista.
Anule la seleccin de una casilla para cerrar una conexin.
Seleccione un servidor PI en el panel de servidores para acceder a la configuracin de
conexin.
Se requiere una conexin abierta con un servidor PI para aadir funciones DataLink
a una hoja de clculo y recuperar valores de PI. Nota: El nombre del servidor
PI predeterminado aparece en la parte inferior derecha del cuadro de dilogo.
Puede mantener conexiones con ms de un servidor PI a la vez, aunque
tendr que especificar el servidor de destino cuando defina una funcin PI
DataLink.
Componentes de funciones grficas

PI DataLink proporciona una interfaz grfica de usuario para construir funciones en
Excel. Un cuadro de dilogo comn facilita el suministro de argumentos para definir la
funcin.
La herramienta utilizada para construir una funcin depende de la versin de PI DataLink
instalada:
El complemento para Excel XP-2003 proporciona cuadros de dilogo (pgina 10)
para definir funciones.
El complemento para Excel 2007 proporciona paneles de tareas (pgina 8) para
definir funciones.
12
Los usuarios avanzados familiarizados con PI DataLink y el PI Server pueden

introducir la sintaxis de la funcin (pgina 81) directamente en la barra de frmulas
de Excel.
Los siguientes apartados describen funciones comunes en los cuadros de dilogo y
paneles de tareas de PI DataLink, el modo en que los datos en tiempo real son obtenidos y
presentados, y cmo pueden ser utilizadas las funciones de PI DataLink dentro de una
hoja de clculo.
Campos de entrada
Los campos etiquetados como de entrada aceptan argumentos especficos utilizados para
definir una funcin. La mayor parte de los argumentos pueden ser introducidos
directamente o mediante referencias en celdas de hoja de clculo. Aunque las opciones
son distintas segn el argumento, todos los campos de entrada permiten una o ms de las
siguientes opciones:
Introducir texto directamente en un campo de edicin , por

ejemplo, un nombre de tag o la direccin de una celda de salida.
Seleccionar un elemento entre las opciones de una lista , como, por ejemplo, un
clculo o un mtodo de muestreo.
Hacer referencia a celdas de hoja de clculo que contienen argumentos,

como, por ejemplo, un nombre de tag, la ubicacin de una celda de salida o una
marca de tiempo.
Nota: Asegrese de introducir con un apstrofe delante (') cadenas en las

celdas a las que vaya a hacer referencia. Esto obliga a Excel a interpretar
el contenido como una cadena.
Seleccionar valores de un servidor PI o de otras fuentes mediante una

bsqueda en base de datos de mdulos o tags.
Por ejemplo, puede introducir una cadena de nombre de tag en el campo Nombre de tag
o hacer clic en el botn junto al campo para mostrar el cuadro de dilogo Bsqueda de
tags, y buscar tags en el servidor PI.
Tambin puede proporcionar una referencia a una celda de hoja de clculo que contenga
un nombre de tag:
Haga clic primero en el campo de edicin y despus en la celda (o haga clic en la
celda y arrastre a una celda adyacente para seleccionar un intervalo) de la hoja de
clculo.
DataLink introduce automticamente la referencia de celda en el campo de edicin.
Nota: Algunos campos de entrada muestran una entrada predeterminada cuando el

panel o el cuadro de dilogo se abren. Los campos marcados Opcional son
opcionales y no se requiere un valor.

Conceptos bsicos
Argumentos estndar
Algunos argumentos son comunes a la mayora de los cuadros de dilogo o paneles de

tareas de funciones de PI DataLink, y habitualmente son requeridos para definirlas:
Nombre(s) de tag o Expresin

El campo Nombre(s) de tag o Expresin es requerido por la mayora de las funciones
para evaluar datos de punto (tag) PI o el resultado de una expresin PI (pgina 75). Uno o
ms nombres de tag, o la sintaxis de una expresin PI pueden ser:
Introducidos directamente en un campo.
Por ejemplo, sinusoid.
Introducidos en una o ms celdas de hoja de clculo, a las que despus se hace
referencia en el campo.
Por ejemplo, una referencia a la matriz Sheet1!$B$3:Sheet1!$B$4 que, a su
vez, contiene las cadenas de nombre de tag 'sinusoid y 'cdt158.
Observe que las referencias de celda permiten especificar varios nombres de tag para
una funcin, mientras que no se pueden especificar varios nombres de tag para una
funcin directamente, a menos que el campo est etiquetado Nombre(s) de tag.
Nota: Recuerde que se aaden comillas simples a cada nombre de tag para
indicar valores de cadena en Excel. Tanto las cadenas como las
expresiones de tiempo a las que se haga referencia en las celdas deben
estar encerradas ente comillas simples. Por ejemplo:
TimeEq('CD:M158','y' ,'t', "Manual")
Seleccionado en el cuadro de dilogo Bsqueda de tags (pgina 39), basado en una

bsqueda de tags por nombre, alias o atributo.
Hora de inicio
El comienzo de un intervalo de tiempo (pgina 15) a lo largo del cual es evaluada la
funcin, desde Hora de inicio hasta Hora de finalizacin. Todos los valores de evento
correspondientes al intervalo de tiempo son recuperados del archivo PI o calculados para
crear la matriz de funcin resultante.
Hora de finalizacin
El final del intervalo de tiempo, frecuentemente expresado como la hora actual, donde la
Hora de inicio es la hora actual menos un intervalo de tiempo especificado.
Las horas de inicio y finalizacin pueden ser expresadas en trminos absolutos o relativos
para establecer un intervalo de tiempo en el pasado o hasta, incluida, la hora actual.
Servidor PI
Una instancia de una funcin PI DataLink se ejecuta nicamente contra una servidor PI.
El PI Server especifica un servidor PI de destino de una lista de servidores conocidos. Si
no selecciona un servidor o deja el campo en blanco, se utiliza el servidor PI
predeterminado (pgina 11).
Los servidores que aparecen por encima de la lnea de puntos en la lista de servidores,
estn conectados actualmente; los de debajo estn desconectados.
14
Celda de salida
Especifique dnde desea colocar la matriz de funcin resultante utilizando el campo
Celda de salida. Si selecciona una celda antes de que se muestre el cuadro de dilogo o el
panel de tareas, la celda actualmente seleccionada se utiliza como valor predeterminado
de Celda de salida.
El valor de celda de salida siempre especifica la esquina superior izquierda de la matriz de
funcin. Si aade (pgina 16) marcas de tiempo y otros datos, tenga en cuenta que la
columna de datos puede ser desplazada hacia abajo o hacia la derecha de la ubicacin de
la celda de salida, sobrescribiendo datos en las celdas adyacentes.
Si hace clic en el campo Celda de salida y, a continuacin, selecciona una matriz
multicelda en la hoja de clculo, puede anular la presentacin predeterminada de todos los
resultados de la funcin. En su lugar, solo los resultados que encajen dentro de las
dimensiones de la matriz especificada sern mostrados.
Argumentos de tiempo
Muchas funciones de PI DataLink requieren argumentos Hora de inicio y Hora de

finalizacin para recuperar una matriz de valores de evento a lo largo de un intervalo de
tiempo especfico. Siga estas indicaciones para especificar argumentos de tiempo:
Las cadenas de tiempo pueden introducirse directamente en los campos de edicin, ya
sea en formato de tiempo PI (pgina 71) absoluto o relativo (por ejemplo, 10-dic-
99 19:12 o -3h).
Si la hora de inicio es ms reciente que la hora de finalizacin, los resultados se
muestran en orden cronolgico inverso.
Las marcas de tiempo a las que se hace referencia en celdas de hoja de clculo pueden
utilizar tambin los formatos de tiempo PI fijo y relativo, y deben ser precedidas por
un apstrofe para indicar una cadena (por ejemplo, '10-dic-99 19:12 o '-3h).
Las referencias de celda tambin pueden utilizar el formato absoluto de tiempo de
Excel (como 39299.6146, equivalente a 8/5/2007 2:45:00 PM). Excel
almacena las marcas de tiempo en este formato, que representa el nmero acumulado
de das desde 1900. Excel puede mostrar las mismas marcas de tiempo utilizando
cualquier formato de fecha y hora asignado a la celda.
Algunos argumentos invocan un intervalo o duracin de tiempo, representado por un
nico valor en lugar de horas de inicio y finalizacin. Ya sea mediante referencia o
introducidos directamente, los valores de intervalo deben utilizar cadenas de tiempo
PI relativo, como un nmero seguido de una variable de tiempo (por ejemplo, 1d o
30m), y no pueden especificar, o hacer referencia a, una marca de tiempo fija de
Excel o PI. Por ejemplo, para especificar un intervalo de 32 minutos, introduzca, o
haga referencia a una celda que la contenga, la cadena 32m.
Para introducir intervalos en trminos de frecuencia, convierta la frecuencia a los
segundos equivalentes. Por ejemplo, una frecuencia de 25 Hz debe introducirse como
un intervalo de 0,04s (=1/25 de segundo).
Al utilizar formatos relativos (por ejemplo, -2h), la hora de referencia utilizada para
traducir el formato de tiempo es distinta para las horas de inicio y de finalizacin de
la funcin. La hora de reloj actual es la referencia para una hora de inicio relativa,
pero es la hora de inicio la que se utiliza como referencia para la hora de finalizacin
relativa.

Conceptos bsicos
Nota: PI DataLink solo admite el sistema predeterminado de fecha de 1900 admitido

por Excel. PI DataLink no admite el sistema de fecha de 1904 de Excel, y
devuelve marcas de tiempo incorrectas si se utiliza dicho sistema.
Datos aadidos
Las marcas de tiempo son particularmente importantes para los eventos de punto PI. Cada
valor de evento es acompaado por una marca de tiempo que le proporciona contexto.
La mayora de las funciones de PI DataLink pueden devolver los valores de marcas de
tiempo correspondientes y otros datos de punto con valores de evento PI o de expresiones
calculadas. Estos datos pueden ser aadidos a los valores devueltos en una matriz de
funcin PI, e incluyen:
marcas de tiempo de evento
marcas de tiempo que indican las horas de inicio y finalizacin de un intervalo
marcas de tiempo que indican la ocurrencia de los valores mnimo y mximo
el porcentaje de valores correctos durante un intervalo de muestra
atributos de valor
anotaciones de eventos introducidas manualmente
nombres de servidores PI fuente
Cuando se especifican, los datos aadidos aparecen en columnas (o filas) adyacentes a los
valores principales devueltos por una funcin conforme a las siguientes reglas:
Los datos temporizados se aaden en columnas a la izquierda (o en filas encima) de
los valores principales.
Otros datos relacionados se aaden en columnas a la derecha (o en filas debajo) de los
valores principales.
16
Matriz de datos aadidos

La tabla siguiente ilustra cmo son aadidos los datos por funcin. Para las funciones que
puedan mostrar la salida en filas o columnas (pgina 19), sustituya las Columnas 1-5 por
las Filas 1-5.
Columnas de matriz de funcin
Funcin/modo Celda de Columna 2 Columna 3 Columna 4 Columna 5

salida
Cualquier funcin con valor
datos aadidos
Valor actual e histrico, marca de valor
Datos de muestra tiempo
Datos comprimidos marca de valor anotaciones
tiempo
Filtrado de tiempo hora de inicio hora de valor porcent.
finalizacin correcto
Calculado (mnimo) hora de inicio hora de tiempo mn. valor mn.
finalizacin
Calculado (mximo) hora de inicio hora de tiempo mx.: valor mx.:
finalizacin
Calculado (intervalo) hora de inicio hora de tiempo mn. tiempo mx.: valor
finalizacin
Calculado (otros) hora de inicio hora de valor porcent.
finalizacin correcto
Alias servidor valor
Nota: La tabla da por hecho que todos los datos aadidos se especifican para su
visualizacin, y que algunas matrices de funcin se pueden extender hasta
cinco columnas si se aaden todos los datos relacionados.
Mostrar marcas de tiempo

Cuando una funcin devuelve una matriz de valores PI a lo largo del tiempo, aparece una
casilla mostrar marcas de tiempo. Si se selecciona, esta opcin devuelve una marca de
tiempo correspondiente a cada valor de evento PI.
Para las funciones que devuelven varios valores de evento (por ejemplo, Datos de
muestra), los controles de orientacin (pgina 19) determinan el modo en que las marcas
de tiempo se muestran en relacin con cada valor..
Para algunas funciones que devuelven un nico valor (por ejemplo, Valor actual), se
proporcionan botones de seleccin para facilitar las opciones equivalentes:
Seleccione sin marca de tiempo para suprimir la visualizacin de la marca de
tiempo.
Seleccione tiempo a la izquierda para mostrar la marca de tiempo en una celda a la
izquierda de valor de evento.
Seleccione tiempo en la parte superior para mostrar la marca de tiempo en una
celda sobre el valor de evento recuperado.

Conceptos bsicos
Cuando se especifica una referencia a una matriz de nombres de tag en celdas en el

campo Nombre de tag, estas preferencias se ignoran. En su lugar, los valores de evento y
de marca de tiempo se posicionan conforme a la orientacin de la matriz de tags de
entrada. Para los nombres de tag en una nica columna, las marcas de tiempo aparecern
a la izquierda de los valores. Para los nombres de tag en una nica fila, las marcas de
tiempo aparecern encima de los valores.
Marcas de tiempo de intervalo

Las funciones que devuelven valores a intervalos de tiempo especficos (por ejemplo,
Datos calculados) proporcionan opciones para mostrar distintas marcas de tiempo.
Seleccione mostrar hora de inicio para mostrar la hora de inicio de cada intervalo.
Seleccione mostrar hora de finalizacin para mostrar la hora de finalizacin de cada
intervalo.
Para los valores calculados de mnimo, mximo e intervalo:
Seleccione mostrar tiempo mn/mx para mostrar marcas de tiempo para los valores
mnimo y mximo de cada intervalo.
Las marcas de tiempo se muestran de forma coincidente con la orientacin de fila o
columna especificada. Si se muestran todas las marcas de tiempo, el orden desde la
columna de la izquierda a la de la derecha o desde la fila de arriba a la de abajo es: hora
de inicio, hora de finalizacin, hora del valor mnimo, hora del valor mximo, valor de
evento.
Mostrar porcentaje correcto

Seleccione mostrar porcentaje correcto para mostrar el porcentaje de tiempo para el
que se devuelven valores correctos sobre el rango total de tiempo de la matriz. Los
valores del porcentaje correcto se suelen aadir en una columna a la derecha o en una fila
debajo de los valores recuperados.
Los valores correctos son valores de evento que el servidor PI ha determinado que son
vlidos y que no estn en estado de error. El porcentaje de valores correctos ayuda a
valorar la fiabilidad de los clculos generados en valores de puntos PI, particularmente si
los valores calculados van a ser utilizados en otros clculos.
Por ejemplo, los totales pueden seguir siendo calculados a lo largo de un intervalo de
tiempo incluso aunque algunos de los datos no sean buenos. El valor total resultante
ponderado en el tiempo es igual al total dividido por la fraccin del intervalo en la que
hay disponibles datos correctos.
Sin embargo, esta normalizacin asume que el promedio a lo largo del intervalo de
tiempo con datos incorrectos es equivalente al valor promedio durante todo el intervalo de
tiempo, lo que se vuelve menos fiable si una fraccin extensa del intervalo de tiempo
contiene datos malos.
18
Mostrar valores de atributos

Seleccione mostrar atributos del valor para mostrar los bits de estado ampliados
asociados con los valores de evento devueltos. Los bits devueltos corresponden a
atributos de valores almacenados en PI, y pueden ser uno de los siguientes:
A = anotado, indica que se ha aadido un comentario al evento
S = sustituido, indica que el valor de evento ha sido cambiado desde su valor original
Q = cuestionable - indica que existen razones para dudar de la precisin del valor.
Los atributos del valor se muestran en una columna a la derecha de los valores de evento.
Mostrar anotaciones
Seleccione mostrar anotaciones para mostrar las anotaciones asociadas con los valores
de evento devueltos en una columna a la derecha
Las anotaciones son notas o comentarios aadidos a un valor de dato en PI con propsitos
descriptivos.
Controles de orientacin
Para las funciones que devuelven una matriz de valores PI, utilice los botones columna y
fila para determinar la orientacin de los datos devueltos.
Seleccione columna para mostrar los datos en columnas.
Seleccione fila para mostrar los datos en filas.
Se aadirn filas o columnas adicionales (pgina 16) para marcas de tiempo y datos
adicionales si son seleccionados para su visualizacin. El campo Salida de la funcin
indica la esquina superior izquierda del intervalo completo utilizado para la matriz.
Nota: Para las funciones que devuelven un intervalo de valores, la orientacin de la

matriz de tag de entrada anula la seleccin de fila y columna para determinar
la orientacin de los datos de salida.
Formatos de presentacin
Puede cambiar los formatos predeterminados de fecha y nmero utilizados por PI

DataLink para dar formato a los datos en las matrices de funcin. Los formatos
predeterminados se especifican en el cuadro de dilogo Configuracin (pgina 20), en
donde hay disponibles dos configuraciones para los formatos:

Conceptos bsicos
El formato de nmero predeterminado General da formato a los nmeros (y a todos

los datos que no son marcas de tiempo) para coincidir con el formato Categora
General del cuadro de dilogo Formato de celdas de Excel.
El formato de fecha predeterminado dd-mmm-aa hh:mm:ss coincide con el formato
de marca de tiempo estndar de PI. Puede aadir ,000 al final de la cadena (dd-mmm-
aa hh:mm:000) para mostrar marcas temporales por debajo de un segundo. Tenga en
cuenta que Excel no admite formatos con precisin de microsegundos.
Puede personalizar las cadenas de formato predeterminadas utilizando cualquier cdigo
de formato de Excel vlido del cuadro de dilogo Formato de celda de Excel. Por
ejemplo, en Alemania los equivalentes de General y dd-mmm-aaaa hh:mm son Standard
y TT-MM-JJJJ hh:mm, respectivamente.
Tambin puede aplicar un formato de fecha y hora individual a cualquier celda de hoja de
clculo, incluidas las que contienen funciones de PI DataLink, seleccionando Formato >
Celdas > Nmero. Consulte su documentacin sobre Excel para obtener ms
informacin sobre cmo dar formato a fechas y horas.
20
Configuracin de preferencia
Configuracin de preferencia
Utilice el cuadro de dilogo Configuracin para especificar preferencias globales y
formatos predeterminados para la salida de las funciones de PI DataLink.
Para acceder a la configuracin:

1. Haga clic en Configuracin en la cinta PI (2007), o seleccione PI > Configuracin
(2003).
2. Ajuste las preferencias deseadas y haga clic en Aceptar.
Copiar elementos a la hoja

Seleccione En una fila o En una columna para copiar los nombres de varios tags
seleccionados en una Bsqueda de tags(o los elementos de una bsqueda Buscar
mdulo) a la hoja de clculo en una fila o columna de valores, respectivamente. La
configuracin predeterminada es En una columna.
El comando tambin est disponible como acceso directo a la opcin de la cinta
Bsqueda de tags (2007).

Conceptos bsicos
Copiar nombre de PI Server

Seleccione la casilla para copiar el nombre del servidor PI origen de datos en una celda
adyacente cuando los nombres de tag sean copiados a una hoja de clculo.
Utilizar zona horaria de PI Server

Selecciona la casilla para forzar a PI DataLink a utilizar la zona horaria del PI Server
como valor de referencia para interpretar funciones. Si se borra, PI DataLink utiliza el
ajuste de zona horaria del ordenador cliente.
Esta opcin es relevante nicamente si un servidor PI tiene un ajuste de zona horaria
distinto del de la mquina cliente.
Mostrar #N/D en vez de espacios en blancos

Seleccione esta casilla para sustituir #N/A (No Aplicable) por celdas en blanco cuando
hay menos puntos de datos que celdas en una matriz de funcin. Las funciones aadidas a
una hoja de clculo mantienen su tamao de matriz original, incluso si la variacin en un
periodo de tiempo en particular produce menos valores de datos, dando como resultado
una o ms celdas vacas.
Esta funcin es particularmente til cuando los resultados de la funcin se trazan
mediante el paquete de grficas de Excel.
Independiente regional
Seleccione la casilla para obligar a PI DataLink a interpretar las cadenas de tiempo de
entrada conforme a las reglas de formato de tiempo de PI, independientemente de los
ajustes locales en el ordenador cliente. El tiempo PI asume que todas las cadenas estn en
ingls y utilizan el orden de fecha-hora dd-MMM-aaaa hh:mm:ss.
Borre la casilla para analizar los formatos de fecha-hora conforme a la configuracin
regional del ordenador cliente, recurriendo al formato de tiempo PI solo si es necesario.
Desactivar la visualizacin automtica del panel de tareas al hacer clic

Solo para Excel 2007, seleccione esta casilla para evitar la aparicin automtica del panel
de tareas de funcin al hacer clic en una celda de funcin. Haga clic con el botn derecho
para mostrar el men contextual y seleccionar el nombre de la funcin para mostrar el
panel manualmente.
Desactivar el mensaje "Redimensionar para mostrar todos los valores"

Seleccione esta casilla para no mostrar un mensaje de advertencia cuando el nmero de
valores recuperados por una matriz recalculada exceda el nmero que se puede mostrar.
Formato de nmero
Introduzca un formato numrico para indicar cmo debe mostrarse de forma
predeterminada la salida de una funcin numrica. La cadena de formato puede ser
cualquier cdigo de formato numrico vlido del cuadro de dilogo Formato de Excel
(pgina 19).
Durante le instalacin, PI DataLink asigna el formato numrico predeterminado de Excel
a este campo, a menos que haya ajustado su propia preferencia de formato anteriormente
en DataLink. Si su versin de Excel se ejecuta con un formato local diferente, este
formato incluye la sintaxis correcta para reflejarlo.
22
Construccin de una hoja de clculo
Por ejemplo:
35.03
aparecer como
35,03
en Excel francs.
Formato de hora
Introducir un formato de marca de tiempo para la salida de la funcin. La cadena de
formato puede ser cualquier cdigo de formato de fecha-hora (pgina 15) vlido del
cuadro de dilogo Formato de Excel.
Durante le instalacin, DataLink asigna el formato de marca de tiempo predeterminado de
PI a este campo, a menos que haya ajustado su propia preferencia de formato
anteriormente en DataLink. Si su versin de Excel se ejecuta con un formato local
diferente, este formato incluye la sintaxis correcta para reflejarlo. Por ejemplo:
dd-mm-yy (03-07-09)
aparecer como
jj-mm-aa (03-07-09)
en Excel francs.
Actualizacin automtica
Utilice este apartado para ajustar preferencias para la Actualizacin automtica (pgina
49) cuando esta funcin est activada.
Seleccione un mtodo de clculo:
Calcular (F9) fuerza el reclculo de todas las funciones voltiles (y de las funciones
que hagan referencia a ellas).
Clculo completo (Ctrl+Alt+Maysculas+F9) fuerza el reclculo de todas las
funciones incrustadas, independientemente de la volatilidad.
A continuacin, introduzca un intervalo de clculo en segundos. El valor mnimo es 5
segundos. Introduzca 0 para aceptar el intervalo automtico seleccionado por PI DataLink
en base a la duracin de los tiempos de clculo anteriores.
Construccin de una hoja de clculo

Una vez familiarizado con los conceptos y herramientas bsicas de PI DataLink y
preparado para crear una hoja de clculo y utilizar las funciones de PI DataLink, por
dnde empezar?
Sus objetivos
En primer lugar, considere sus objetivos.
Qu datos desea mostrar en una hoja de clculo a fin de controlar el rendimiento o
responder a un problema del negocio?
En qu PI Server residen los datos?
Cmo puede mostrar de la forma ms eficaz la informacin, tanto para comunicar
puntos esenciales como para proporcionar el necesario contexto de fondo?

Conceptos bsicos
Las respuestas le ayudarn a determinar qu funciones de PI DataLink pueden devolver

los datos ms adecuados para la tarea.
Funcional
Una manera de construir una hoja de clculo consiste simplemente en aadir funciones
(pgina 25), creando a su alrededor su presentacin segn sea necesario. Ms tarde puede
aadir informacin de tags para ayudar a clarificar lo que representan los datos. Este
puede ser el mejor enfoque si todava est explorando sus requerimientos o aprendiendo
cmo funciona PI DataLink.
Estructurada
Otra forma de construir una hoja de clculo es aadir una estructura desde el principio.
Utilice la bsqueda de tags y las funciones de tags (pgina 39) para aadir tags y otros
atributos como metadatos para estructurar su contenido y, despus, aada funciones para
recuperar los datos de puntos PI correspondientes. Esto requiere algo ms de planificacin
y familiaridad con PI DataLink, pero una vez que la informacin de los tag est presente
en la hoja de clculo, puede utilizarla para crear las funciones ms fcilmente mediante
referencias de celda. Las hojas de clculo construidas de esta manera son tambin ms
flexibles para su reutilizacin.
Basada en mdulos
Si tiene una PI Module Database configurada para su servidor PI, puede incorporar
mxima flexibilidad a su hoja de clculo incorporando objetos de la base de datos de
mdulos (pgina 45). Al igual que sucede con los datos de tag, en las funciones se puede
hacer referencia a los objetos de la base de datos de mdulos. Tambin se pueden aadir
funciones de contexto de mdulos para maximizar la potencial reutilizacin de la hoja de
clculo sobre objetos paralelos o redundantes.
Orientados a informes
Si es usted administrador del sistema o creador de hojas de clculo para otros usuarios, tal
vez desee poner funciones de PI DataLink en una segunda hoja de clculo de un libro de
trabajo y copiar/pegar los resultados de la primera hoja para mostrarlos. La sintaxis de las
funciones y la lgica del negocio pueden ocultarse y protegerse utilizando Excel para
asegurar la segunda hoja de clculo. Esta estrategia tambin funciona bien para los
documentos distribuidos mediante PI DLES (pgina 2).
24
Captulo 3
Funciones PI
Las funciones de PI DataLink le permiten consultar, calcular y devolver atributos y
valores de puntos PI a celdas de hoja de clculo. Al igual que otras funciones de Excel,
los resultados de las funciones de PI DataLink se muestran en matrices que pueden ser
recalculadas para mostrar valores de eventos actualizados segn se necesite.
Para acceder a las funciones PI:
Haga clic en la celda de salida deseada y, a continuacin, seleccione PI > (nombre
de funcin) para abrir un cuadro de dilogo de funcin (XP-2003), o haga clic en una
funcin en la cinta PI para abrir un panel de tareas de nueva funcin (2007).
Las descripciones de funciones de este apartado describen argumentos especficos de cada
funcin en cuanto a esas caractersticas comunes.
Valor actual
Recupera el valor actual, o el ms reciente (snapshot) de un punto PI, basndose en el
nombre de tag.
ARGUMENTOS OBLIGATORIOS
Nombre de tag
NOTAS ESPECIALES
Hace referencia a un intervalo de celdas que contienen nombres de tag para mostrar
valores snapshot actuales de cada una.
Se actualiza siempre que Excel calcula o recalcula cualquier celda de la hoja de
clculo. Para forzar un reclculo inmediato, pulse F9.
EJEMPLO
Para ver el valor actual del tag sinusoid, se han de ajustar los siguientes argumentos
para la funcin Valor actual:
Nombre de tag = sinusoid
tiempo a la izquierda
y la matriz de funcin resultante aparece como:
TEMAS RELACIONADOS
PICurrVal() (pgina 87)

Funciones PI
Valor de archivo histrico

Recupera un valor de punto PI, o evala una expresin correspondiente a una marca de
tiempo especfica.
Nombre de tag o expresin
Marca de tiempo
MARCA DE TIEMPO
La referencia de tiempo utilizada para recuperar el valor de archivo de PI, que puede ser
un valor de tiempo (pgina 15) fijo o expresado en relacin a la hora actual.
MODO DE RECUPERACIN
Se puede elegir entre 5 modos para producir un valor de archivo.
Anterior - recupera el valor del archivo histrico que coincida exactamente, o sea
anterior, a la marca de tiempo especificada
Anterior nicamente - recupera el valor anterior a la marca de tiempo especificada
Interpolado - interpola el valor en el tiempo especificado, o sigue el comportamiento
de Anterior nicamente.
Auto - interpola el valor en el tiempo especificado, o sigue el comportamiento de
Anterior.
Siguiente - recupera el valor del archivo histrico que coincida exactamente, o sea
posterior, a la marca de tiempo especificada
Siguiente nicamente - recupera el valor siguiente a la marca de tiempo especificada
Tiempo exacto - recupera nicamente un valor que coincida exactamente con la marca
de tiempo o devuelve No se encontraron eventos si no existe ningn valor.
NOTAS ESPECIALES
Hace referencia a un intervalo de celdas que contienen nombres de tag para mostrar
valores de archivo de cada una.
Para los tags con atributos de paso, los modos Anterior y Solo anterior son sustituidos
por modos de clculo Auto e Interpolado, respectivamente.
PIExpVal() se utiliza si una expresin es sustituida por un tag; en caso contrario,
se utiliza PIArcVal().
EJEMPLO
Para ver el valor del tag sinusoid correspondiente a un tiempo especfico, se han de
ajustar los siguientes argumentos para la funcin Valor de archivo histrico:
Marca de tiempo = 30-Sep-07 15:13
Modo de recuperacin = anterior
tiempo a la izquierda
26
Datos comprimidos
TEMAS RELACIONADOS
PIArcVal() (pgina 88)
PIExpVal() (pgina 88)
Datos comprimidos
Devuelve todos los valores de un punto PI que se producen dentro de un intervalo de
tiempo especificado o un nmero de valores de punto comenzando a una hora
determinada.
Los valores comprimidos son datos grabados por el servidor PI despus de que un
algoritmo de compresin haya eliminado todos los valores que representan la misma
pendiente.
Nota: Se proporcionan cuadros de dilogo separados para Datos comprimidos (hora

de inicio/Hora de finalizacin) y Datos comprimidos (Hora de inicio/Nmero)
en PI DataLink para Excel XP-2003. Para 2007, puede seleccionar un clculo
de Intervalo de tiempo o de Nmero de valores en el panel de tareas.
Nombre de tag
Hora de inicio
Hora de finalizacin o Nmero de valores, dependiendo del tipo de funcin
EXPRESIN DE FILTRO
Aadir una expresin de filtro para filtrar valores de evento utilizando una expresin
matemtica, eliminando datos por los que la expresin se evala como falso. La expresin
de filtro se aplica a los datos sin tratar de PI (y no a los valores que resultan del propio
clculo).
Por ejemplo, la simple expresin de filtro:
sinusoid < 70
eliminar del clculo todos los valores por encima de 70. Tambin puede utilizar
cualquier ecuacin de rendimiento PI en la expresin de filtro para crear expresiones ms
complejas para eliminar picos atpicos en valores de datos, por ejemplo.
Seleccione marcar como filtrado para sustituir Filtrado como marcador de posicin para
cada valor o bloque de valores filtrado de la raz basada en el filtro expression (pgina
75).

Funciones PI
TIPO DE LMITE
Especifique un tipo de lmite para determinar el modo en que es gestionada la bsqueda
de valores de datos por el Editor de archivo histrico cerca de las horas de inicio y de
finalizacin del intervalo de valores:
Dentro (predeterminado): Devuelve los valores en las horas de inicio y finalizacin,
o los ms prximos que se produzcan dentro del intervalo.
Fuera: Devuelve los valores ms prximos que se produzcan inmediatamente fuera
del intervalo.
Interpolado: Devuelve valores interpolados en las horas de inicio y finalizacin.
Auto: Interpolado, pero utilizando el comportamiento de Dentro para los tags con
atributos de paso ajustados en los PI Server basados en Windows.
RECUENTO DE VALORES
Normalmente la primera fila o columna de la matriz incluye el recuento de valores
recuperados para el intervalo de tiempo. Seleccione ocultar cuenta para ocultar el
recuento de valores y mostrar nicamente los valores recuperados en la matriz.
MOSTRAR VALORES DE ATRIBUTOS

Seleccione mostrar atributos del valor para mostrar los bits de estado ampliados
asociados con los valores de evento devueltos. Los bits devueltos corresponden a
atributos de valores almacenados en PI, y pueden ser uno de los siguientes:
A = anotado, indica que se ha aadido un comentario al evento
S = sustituido, indica que el valor de evento ha sido cambiado desde su valor original
Q = cuestionable - indica que existen razones para dudar de la precisin del valor.
Los atributos del valor se muestran en una columna a la derecha de los valores de evento.
MOSTRAR ANOTACIONES
Seleccione mostrar anotaciones para mostrar las anotaciones asociadas con los valores
de evento devueltos en una columna a la derecha
Las anotaciones son notas o comentarios aadidos a un valor de dato en PI con propsitos
descriptivos.
NOTAS ESPECIALES
Haga referencia a un intervalo de nombres de tag para mostrar valores comprimidos
para cada uno. Tenga en cuenta que, de forma predeterminada, los valores se
muestran en filas para una columna de tags referenciados y en columnas para una fila
de tags referenciados.
Si la Hora de inicio o de finalizacin es la hora actual (*), entonces el primer (o
ltimo) valor es realmente al valor de snapshot actual, y no un valor de archivo. Una
vez que el valor de snapshot pasa por el algoritmo de compresin del PI Server, no
puede ser grabado realmente en PI.
28
Datos comprimidos
La funcin PICompFilDat() se utiliza para funciones de Hora de finalizacin si

se especifica una expresin de filtro; en caso contrario, se utiliza la
funcinPICompDat().
La funcin PINCompFilDat() se utiliza para funciones de Nmero de valores si
se especifica una expresin de filtro; en caso contrario, se utiliza la
funcinPINCompDat().
EJEMPLO
Para ver los 10 valores ms recientes del tag sinusoid, se han de ajustar los siguientes
argumentos para la funcin Datos comprimidos:
Nmero de valores
Hora de inicio = <referencia de celda a la hora actual>
Nmero de valores = 10
atrs en el tiempo
Tipo de lmite = interior
mostrar marcas de tiempo
columna
Observe que todos los eventos entre dos tiempos especificados pueden ser recuperados
tambin por la misma funcin utilizando el argumento Intervalo de tiempo.
TEMAS RELACIONADOS
Expresiones de filtro (pgina 75)
PICompDat() (pgina 91)
PICompFilDat() (pgina 92)
PINCompDat() (pgina 90)
PINCompFilDat() (pgina 90)

Funciones PI
Datos de muestra
Devuelve valores de muestra interpolados, separados por espacios, de una expresin o
punto PI a lo largo de un intervalo regular.
Hora de inicio
Hora de finalizacin
Intervalo de tiempo
INTERVALO DE TIEMPO
Introduzca un intervalo de tiempo como una expresin de tiempo PI (pgina 71). El
intervalo es la frecuencia de muestreo utilizada para recoger o calcular valores durante el
curso del intervalo de tiempo.
Por ejemplo, un intervalo de 15m (15 minutos) devuelve un valor por cada intervalo de 15
minutos.
EXPRESIN DE FILTRO
clculo).
sinusoid < 70
75).
NOTAS ESPECIALES
Puede utilizar una PI Expression (pgina 75) para esta funcin, en lugar de un
nombre de tag.
Haga referencia a un intervalo de nombres de tag para mostrar valores de muestra
La funcin PISampFilDat() se utiliza si se especifica una expresin de filtro; en
caso contrario, se utiliza la funcinPISampDat().
PIExpDat() se utiliza si una PI Expression es sustituida por un tag.
30
Datos temporizados
EJEMPLO
Para ver valores peridicos, interpolados durante las 24 horas anteriores para el tag
sinusoid, se han de ajustar los siguientes argumentos para la funcin Datos de
muestra:
Hora de inicio = -1d
Hora de finalizacin = <referencia de celda a la hora actual>
Intervalo de tiempo = 3h
mostrar marcas de tiempo
columna
en donde se muestra un valor por cada intervalo de 3 horas
TEMAS RELACIONADOS
PISampDat() (pgina 93)
PISampFilDat() (pgina 94)
PIExpDat() (pgina 96)
Datos temporizados
Devuelve valores de muestra reales o interpolados para un punto PI que coinciden con
una matriz de marcas de tiempo especificadas.
Nombre de tag
Marca de tiempo
MARCA DE TIEMPO
Una referencia a una o ms celdas de hoja de clculo que contienen valores de marcas de
tiempo.

Funciones PI
MODO DE RECUPERACIN
Existen dos modos de seleccin:
Interpolado - interpola los valores correspondientes a las marcas de tiempo
especificadas.
Tiempo exacto - recupera nicamente valores que coincidan exactamente con las
marcas de tiempo especificadas o devuelve No se encontraron eventos si no existe
ningn valor.
NOTAS ESPECIALES
nombre de tag.
Haga referencia a un intervalo de nombres de tag para mostrar valores temporizados
Para tags con atributos de paso, el valor precedente a una marca de tiempo
especificada es sustituido`por un valor interpolado cuando el modo de clculo es
Interpolado.
EJEMPLO
Para ver los valores correspondientes a una matriz de marcas de tiempo para el tag
sinusoidu, se han de ajustar los siguientes argumentos para la funcin Datos
temporizados:
Nombre de tag = sinusoidu
Marcas de tiempo = <referencia de celda a una matriz de datos comprimidos existente
para el tag sinusoid>
Modo de recuperacin = interpolado
en donde la columna de datos temporizados aparece en la columna de la derecha, basada

en marcas de tiempo recuperadas para un tag diferente en las dos primeras columnas de la
izquierda.
32
Datos calculados
TEMAS RELACIONADOS
PITimeDat() (pgina 96)
PITimeExpDat() (pgina 97)
Datos calculados
Devuelve uno o ms valores calculados, separados por espacios, basados en valores de
punto PI o expresiones evaluadas. Se proporcionan varios clculos distintos y
preferencias de muestreo.
Nota: Se proporcionan cuadros de dilogo separados para Datos calculados y Datos

calculados avanzados en PI DataLink para Excel XP-2003. Para la versin
para Excel 2007, haga clic en el signo + situado junto a Avanzado para
acceder a todas las opciones de funciones en un solo panel de tareas Datos
calculados.
Hora de inicio
Hora de finalizacin
Factor de conversin
EXPRESIN DE FILTRO
clculo).
sinusoid < 70
75).
INTERVALO DE TIEMPO
minutos.

Funciones PI
MODO DE CLCULO
Se proporcionan los siguientes clculos:
Total
Mnimo
Mximo
Desviacin estndar
Intervalo
Promedio
Recuento
Media
Todos los modos de clculo son ponderados en el tiempo excepto para la funcin media,
que es una versin ponderada a evento de la funcin promedio.
BASES DE CLCULO
Seleccione para el clculo una base ponderada en el tiempo o el evento:
Los clculos son ponderados en el tiempo de forma predeterminada. Cada valor de
evento es ponderado con fines del clculo por la duracin de tiempo sobre la que se
aplica el evento.
Los clculos ponderados en eventos ponderan la calidad de cada valor de evento.
Debe existir al menos un evento (dos para clculos de desviacin estndar) dentro de
un intervalo de tiempo para que el clculo sea correcto.
FACTOR DE CONVERSIN
El factor de conversin es utilizado para los clculos Total en los que le unidad de tiempo
del punto calculado no es la misma que la unidad de tiempo predeterminada del servidor.
Puede ser necesario un factor de conversin para convertir las unidades deseadas para el
clculo a partir de las unidades por da predeterminadas en el servidor.
La tabla siguiente ilustra el uso de factores de conversin para puntos utilizando
diferentes unidades de flujo. Tenga en cuenta que un factor de conversin de uno significa
que el factor de conversin no es necesario, y que no se pueden especificar unidades.
Unidad de flujo Factor de conversin necesario para coincidir con el
predeterminado del servidor (unidades/da)
Unidades/da 1.0
Unidades/hora 24
Unidades/minuto 1440
Unidades/segundo 86400
34
Datos calculados
MODO MUESTREO DE EXPRESIN

Hay disponibles distintos modos de muestreo para las funciones que incluyen
expresiones:
Para clculos de tags PI, seleccione uno de los tres modos de muestreo.
El modo Punto comprimido es el utilizado de forma predeterminada para los
clculos de tags PI. Este modo considera las marcas de tiempo para el tag PI para
el que se est realizando el clculo. No considera las marcas de tiempo para otros
tags PI utilizados en la expresin de filtro. Este modo realiza el clculo utilizando
los intervalos de tiempo entre marcas de tiempo que la expresin de filtro evala
como verdaderos. Punto comprimido consume menos recursos computacionales
que el modo Expresin comprimida; sin embargo, el modo Expresin
comprimida produce resultados ms exactos.
El modo Expresin comprimida considera las marcas de tiempo para los tags PI
utilizados en la expresin de filtro. No considera las marcas de tiempo para el tag
PI para el que se est realizando el clculo a menos que dicho tag PI sea utilizado
en la expresin de filtro. Este modo determina los intervalos para los que la
expresin de filtro es verdadera y despus realiza los clculos utilizando el valor
interpolado de los puntos finales del intervalo. El modo Expresin comprimida
produce resultados ms precisos a expensas del rendimiento.
El modo Interpolado evala la expresin en intervalos de muestra espaciados
regularmente determinados por la Frecuencia de muestreo de expresin.
Para clculos de expresiones PI, seleccione uno de los dos modos de muestreo:
El modo Comprimido evala la expresin para cada valor de evento en las marcas
de tiempo correspondientes.
El modo Interpolado evala la expresin en intervalos de muestra espaciados
regularmente determinados por la Frecuencia de muestreo de expresin.
FRECUENCIA DE MUESTREO DE EXPRESIN

Especifique la frecuencia con la que es evaluado un clculo o expresin de filtro cuando
el Modo de muestreo de expresin est ajustado en Interpolado.
Por ejemplo, una frecuencia de 10m (10 minutos) devuelve un valor interpolado por cada
intervalo de 10 minutos mientras la expresin de filtro sea evaluada como verdadera.
PORCENTAJE CORRECTO MNIMO

Especifique el mnimo porcentaje de datos correctos (pgina 18) requerido en cada
intervalo de tiempo para calcular y devolver un valor. Insuficientes datos correctos es
sustituido por un marcador de posicin cuando no se devuelve un valor.
MARCAS DE TIEMPO
Seleccione mostrar hora de inicio para mostrar la hora de inicio de cada intervalo
utilizado para calcular un valor. Las horas de inicio se aaden en una columna a la
izquierda o en una fila encima de los valores calculados.
Seleccione mostrar hora de finalizacin para mostrar la hora de finalizacin de cada
intervalo utilizado para calcular un valor. Las horas de finalizacin se aaden en una
columna a la izquierda o en una fila encima de los valores calculados.

Funciones PI
Para los clculos de Mximo, Mnimo e Intervalo, seleccione mostrar tiempo

mn/mx para mostrar las marcas de tiempo correspondientes a la mnima y/o la
mxima en cada intervalo utilizado para calcular un valor:
Para los clculos de Mnimo y Mximo, se muestra el valor de la marca de
tiempo correspondiente.
Para las funciones de Intervalo, se muestran ambas marcas de tiempo.
PORCENTAJE CORRECTO
Seleccione mostrar porcentaje correcto para mostrar el porcentaje de tiempo para el
que se devuelven valores correctos sobre el rango total de tiempo de la matriz. Los
valores del porcentaje correcto se suelen aadir en una columna a la derecha o en una fila
debajo de los valores recuperados.
Los valores correctos son valores de evento que el servidor PI ha determinado que son
vlidos y que no estn en estado de error. El porcentaje de valores correctos ayuda a
valorar la fiabilidad de los clculos generados en valores de puntos PI, particularmente si
los valores calculados van a ser utilizados en otros clculos.
NOTAS ESPECIALES
nombre de tag.
Haga referencia a un intervalo de nombres de tag para mostrar valores calculados
Para clculos de Mximo y Mnimo con intervalos especificados, las marcas de
tiempo indican la hora de inicio de cada intervalo de clculo.
No se pueden mostrar marcas de tiempo para los clculos de Total, Desviacin
estndar, Promedio, Cuenta o Media, cuando el intervalo no se ha especificado.
La funcin PIAdvCalcVal() se utiliza para recuperar un nico valor si no se
especifica un intervalo; en caso contrario, se utiliza la funcin PIAdvCalcDat()
para recuperar valores de varios intervalos. Los nombres de funcin que incluyen
'Exp' y 'Fil' se utilizan para clculos que incluyen PI Expressions y Filter Expressions,
respectivamente.
EJEMPLO
Para ver el intervalo horario de valores que comienzan el mismo da a medianoche hasta
el momento actual para el tag sinusoid, se han de ajustar los siguientes argumentos
para la funcin Datos calculados:
PI Tag
Hora de inicio = t
Hora de finalizacin = *
Intervalo de tiempo = 1h
Modo de clculo = intervalo
Base de Clculo = ponderada a tiempo
mostrar hora de inicio
mostrar hora de finalizacin
columna
36
Filtrado de tiempo
en donde el intervalo se calcula para cada intervalo de una hora. Observe que cualquier
clculo disponible puede ser especificado sobre cualquier intervalo.
TEMAS RELACIONADOS
Expresiones de clculo (pgina 75)
PIAdvCalcVal() (pgina 100)
PIAdvCalcFilVal() (pgina 101)
PIAdvCalcExpVal() (pgina 103)
PIAdvCalcExpFilVal() (pgina 103)
PIAdvCalcDat() (pgina 106)
PIAdvCalcFilDat() (pgina 106)
PIAdvCalcExpDat() (pgina 108)
PIAdvCalcExpFilDat() (pgina 109)
Filtrado de tiempo
Devuelve la cantidad de tiempo durante la que una expresin PI es evaluada como
verdadera para un intervalo de tiempo especificado.
Nota: Los resultados de Filtrado de tiempo varan ligeramente dependiendo de la versin
del PI Server.
Expresin
Hora de inicio

Funciones PI
Hora de finalizacin
Unidades de tiempo
INTERVALO DE TIEMPO
minutos.
UNIDADES DE TIEMPO
Especificar las unidades de tiempo utilizadas para mostrar el resultado de la expresin de
clculo.
NOTAS ESPECIALES
Puede introducir la expresin en una celda de hoja de clculo y hacer referencia al
nombre de la celda en la funcin. Comience las expresiones con una comilla simple si
desea que Excel interprete la expresin como una cadena.
EJEMPLO
Para ver la cantidad de tiempo durante el que el valor del tag sinusoid estuvo por
encima de 75 durante un periodo de 7 das, se han de ajustar los siguientes argumentos
para la funcin Filtrado por tiempo:
Expresin = sgn('sinusoid'-75)=1
Hora de inicio = -7d
Hora de finalizacin = *
Unidades de tiempo = h
mostrar porcentaje correcto
columna
en donde los resultados muestran que el valor del tag estuvo por encima de 75 durante
7,85 horas durante los 7 das anteriores.
TEMAS RELACIONADOS
Expresiones de clculo (pgina 75)
PITimeFilterVal() (pgina 110)
PITimeFilter() (pgina 110)
38
Captulo 4
Tags PI y atributos
Un punto PI es una serie de datos en tiempo real procedentes de una fuente definida y se
describe mediante el correspondiente nombre de tag y otros atributos.
En PI DataLink y en este manual, los puntos PI suelen denominarse tags PI y ambos
trminos se consideran prcticamente equivalentes. Sin embargo, un tag es simplemente
una denominacin de un punto PI. Al recuperar datos PI para una hoja de clculo Excel,
el nombre del tag es el atributo PI que se utiliza ms habitualmente para referirse a los
datos de un punto PI.
Los nombres de tag PI pueden ayudar a identificar datos de punto, describir la fuente de
valores y matrices de datos de funcin, y hacer referencia a ellos como atributos para
recuperar datos. Este apartado describe el uso de tags y otros atributos de puntos en la
construccin de una hoja de clculo PI DataLink, incluyendo:
la recuperacin directa de tags en celdas de hoja de clculo, y
las funciones utilizadas para resolver nombres de tag a partir de otros atributos de
punto, o para recuperar atributos basndose en un nombre de tag.
Bsqueda de tags
Utilice el cuadro de dilogo Bsqueda de tags para buscar directamente en el servidor PI
nombres de tag PI para copiarlos en funciones y hojas de clculo. Los tags seleccionados
se copian en la hoja de clculo o se aaden a un campo de edicin Nombre de tag como
argumento de una funcin.
Para acceder a la bsqueda de tags:
Haga clic en Bsqueda de tags en la cinta PI (2007) o seleccione PI > Bsqueda de
tags (2003), o haga clic en Bsqueda de tags junto a un campo Nombre de tag.
El cuadro de dilogo Bsqueda de tags ofrece tres tipos de bsquedas:
Bsqueda bsica permite crear una mscara de tag especificando atributos de punto
PI. La mscara se utiliza para buscar en el servidor una lista de tags con atributos
coincidentes.
Bsqueda avanzada proporciona una interfaz de diseo de bsquedas con acceso a
ms atributos de puntos para bsquedas complejas.
Bsqueda de alias ofrece una vista en rbol lgico de un servidor PI mediante PI
Module Database, que puede utilizarse para seleccionar tags segn sus alias
descriptivos.

Tags PI y atributos
Para buscar tags:

1. Haga clic en una ficha para elegir una bsqueda Bsica, Avanzada o de Alias.
2. Introduzca los criterios de bsqueda necesarios y haga clic en Buscar.
Utilice '*' o '?' como caracteres comodn para buscar segn nombres y atributos de
tag. Por ejemplo, la mscara de tag Tem* devuelve todos los nombres de punto que
comienzan por Tem , mientras que Tem? devuelve solo los puntos que empiezan con
Tem y terminan con otro carcter simple. Todos los campos de mscaras de punto no
distinguen entre maysculas y minsculas.
Tambin puede hacer clic en Favoritos para acceder a las bsquedas anteriores.
3. Los tags obtenidos en una bsqueda aparecen listados en un panel de resultados de
bsqueda. Seleccione los tags deseados en el panel de resultados y haga clic en
Aceptar.
Haga clic en las cabeceras de las columnas en el panel de resultados de bsqueda para
ordenar los resultados. Pulse Control + clic o Maysculas + clic para
seleccionar varios tags.
Consejos para buscar tags

Si se seleccionan varios tags, el primer nombre de tag seleccionado en la lista es
copiado al campo Nombre de tag para una referencia de funcin.
La celda actual se toma como punto de partida para una lista de tags copiada en una
hoja de clculo en una nica columna o fila, dependiendo del ajuste de Copiar
elementos a la hoja.
40
Funciones de tags
Seleccione En una fila o En una columna en los accesos directos de Bsqueda de

tags en el men de la cinta PI (2007) para copiar los nombres de varios tags a la hoja
de clculo en una fila o columna de valores, respectivamente.
El nombre del PI Server correspondiente a un tag se aade al nombre de ste si el
ajuste Copiar nombre de servidor PI est activado.
Funciones de tags
El siguiente apartado describe las funciones de tags de PI DataLink. Estas funciones
pueden utilizarse para resolver ID de punto PI u otros atributos de punto en un nombre de
tag coincidente. Tambin puede recuperar otros valores de atributos de punto basndose
en el nombre de tag.
Para acceder a las funciones de tags:
Las funciones de tags utilizan componentes de funcin (pgina 12) comunes.
Identificador del punto para tag
Devuelve el nombre del tag que corresponde a un ID de punto PI especfico.
CAMPOS OBLIGATORIOS
Identificador de punto
EJEMPLO
Para recuperar el nombre de un tag correspondiente al ID de un punto PI, se han de
ajustar los siguientes argumentos para la funcin ID de punto para Tag:
ID de punto = (referencia a una celda que contiene un valor de ID de punto)
donde el nombre del tag se muestra en la columna de la derecha, basndose en una

referencia a la celda que contiene el ID de punto de la izquierda.
TEMAS RELACIONADOS
PIPointIDToTag() (pgina 112)

Tags PI y atributos
Mscara de atributo para tag
Devuelve una lista de nombres de tag en PI que coinciden con uno o ms valores de
atributos de tag especificados.
CAMPOS OBLIGATORIOS
Uno o ms de los siguientes campos es obligatorio para recuperar valores coincidentes:
Nombre de tag
Descriptor
Origen de punto
Tipo de punto
Clase del punto
Unidades
EJEMPLO
Para recuperar los nombres de los tags correspondientes a uno o ms atributos de punto
especificados, se han de ajustar los siguientes argumentos para la funcin Mscara de
atributo para Tag:
Nombre de tag = BA*
Tipo de punto = Float32
Observe que las cadenas de atributos deben coincidir con valores de atributos de PI, y que
se pueden utilizar comodines. La funcin opera igual que una bsqueda de tags (pgina
39).
TEMAS RELACIONADOS
PIAttributeMaskToTag () (pgina 112)
42
Funciones de tags
Atributos del tag
Recupera un atributo asociado con un nombre de tag PI especificado.
CAMPOS OBLIGATORIOS
Nombre de tag
Atributo
ATRIBUTO
Especificar el atributo de tag a recuperar de PI.
NOTAS ESPECIALES
Haga referencia a un intervalo de nombres de tag para mostrar atributos para cada
uno.
La lista de atributos de tag disponibles depende de la clase de punto asociado con el
tag.
EJEMPLO
Para recuperar atributos para un punto PI basndose en el nombre del tag, se han de
ajustar los siguientes argumentos para la funcin Atributos del tag:
Nombre de tag = (referencia a una matriz de celdas que contienen nombres de tags)
Atributos = pointid (columna 2), pointsource (columna 3), pointtype (columna 4),
descriptor (columna 5)
y las matrices de funcin resultantes aparecen como:
donde los nombres de tags aparecen referenciados en la columna de la izquierda, y se

utiliza una funcin Atributos del tag para cada columna de atributos.
TEMAS RELACIONADOS
PITagAtt() (pgina 113)

Captulo 5
Objetos de Module Database

La PI Module Database proporciona una forma completamente diferente de construir la
infraestructura de una hoja de clculo. Si la base de datos de mdulos de su servidor PI
est configurada e incluye objetos que representan los tags que desea utilizar, sus hojas de
clculo pueden ser ms fciles de construir y proporcionar ms flexibilidad y potencial
para su reutilizacin.
La PI Module Database es normalmente configurada por el administrador de P o del
sistema, y almacena alias y propiedades que se refieren a puntos PI y a sus atributos,
respectivamente. La estructura jerrquica de estos objetos proporciona un contexto
relacional entre puntos.
Por ejemplo, puede tener cinco puntos PI que representen los niveles de cinco tanques
individuales, idnticos. Cada punto tiene un nombre de tag diferente y representa un
objeto fsico diferente, pero sus requerimientos de utilizacin y control son los mismos.
Recuperando objetos de la base de datos de mdulos, puede crear una sola hoja de clculo
construida con los alias y propiedades que representan a los cinco tanques. Las funciones
de la base de datos de mdulos resuelven estos objetos en nombres de tag y en valores de
atributo. Rutas de mdulo paralelas para cada tanque proporcionan un contexto diferente
para las referencias de alias.
Con este tipo de estructura, puede utilizar la misma hoja de clculo para cambiar entre
vistas de varios recursos. Por ejemplo, cuando selecciona el nombre de cualquiera de los
cinco tanques en una hoja de clculo, la asociacin de alias con el punto PI coincidente
permite que las funciones de DataLink recuperen los valores para el tanque apropiado.
Los siguientes temas describen las herramientas proporcionadas por PI DataLink para
acceder a objetos de PI Module Database. Consulte la documentacin del servidor PI para
obtener ms informacin sobre bases de datos de mdulos y su configuracin.
Buscar en la base de datos de mdulos

El cuadro de dilogo Buscar en la base de datos de mdulos le permite buscar alias,
propiedades y rutas de mdulos PI en la PI Module Database, una estructura jerrquica en
rbol basada en los contenidos de un PI Server. Puede seleccionar estos elementos y
copiarlos directamente en una hoja de clculo.
Nota: Los alias y propiedades correspondientes a puntos PI deben ser configurados

en la PI Server Module Database para utilizar la bsqueda y las funciones de
la base de datos de mdulos.

Para buscar y seleccionar en la PI Module Database:

1. Seleccione una celda y haga clic en Buscar mdulo en la cinta PI, o seleccione PI >
Buscar mdulo. Aparece el cuadro de dilogo Buscar en la base de datos de
mdulos.
2. En Tipos, seleccione el tipo de objeto que est buscando:
Alias
Propiedad
Module
Utilice la lista desplegable PI Server para mostrar bases de datos de mdulos de los
distintos servidores PI conectados.
3. Especifique una Fecha de consulta y hora para proporcionar un contexto temporal
para los objetos mostrados en la base de datos de mdulos, en caso necesario, para
seleccionar la versin correcta del objeto.
4. Navegue por el control en rbol para buscar el elemento deseado y adalo o un
objeto de coleccin primaria a la hoja de clculo.
Seleccione un elemento para copiarlo a la hoja de clculo.
Seleccione los Alias o Propiedades primarios de un mdulo para copiar todos los
alias o propiedades a la hoja de clculo.
46
Funciones de base de datos de mdulos
5. Seleccione Copiar ruta de mdulo para copiar la ruta de mdulo completa del alias
o la propiedad a una celda de hoja de clculo adyacente, junto con el objeto
seleccionado.
La ruta de mdulo proporciona el contexto para el objeto seleccionado.
Si el ajuste Copiar nombre de servidor PI est activado, se copiar tambin el
nombre del servidor PI correspondiente.
6. Haga clic en Aceptar para cerrar el cuadro de dilogo y copiar los elementos
seleccionados.

El siguiente apartado describe las funciones de base de datos de mdulos de PI DataLink.
Las funciones de la Module Database resuelven alias y propiedades de un rbol de base
de datos de mdulos en nombres de tag mediante una ruta de mdulo. Puede introducir
una ruta de mdulo como argumento de una funcin o hacer referencia a ella desde una
celda de hoja de clculo.
Para acceder a las funciones de base de datos de mdulos:
Nota: No se puede resolver un objeto alias o propiedad en un nombre de tag sin una
ruta de mdulo. La ruta proporciona un contexto para el alias que lo asocia a
un punto PI especfico.
Las funciones de Module Database utilizan componentes de funcin (pgina 12) comunes.
Alias para tag
Devuelve un nombre de tag PI que corresponde alias PI especificado.
Alias
Ruta de mdulo
Fecha de consulta
ALIAS
Especificar un nombre de alias PI. Un alias puede ser introducido directamente o
mediante referencia en una celda. Tambin puede navegar hasta un alias de la PI Module
Database.
RUTA DE MDULO
Introducir la ruta de mdulo de la PI Module Database en la que puede hallarse el alias
especificado. La ruta de mdulo es introducida automticamente si el argumento de alias
es seleccionado navegando por la Module Database.

FECHA DE CONSULTA
Especificar una fecha para recuperar una versin especfica del alias.
TEMAS RELACIONADOS
PIAliasToTag() (pgina 115)
Propiedad para valor
Devuelve el valor o valores correspondientes a una propiedad PI especificada.

DataLink puede devolver valores para tipos de propiedad Boolean, Date, Double, Integer,
Long, Null, Single y String, o tipos de propiedad de matriz Double, Integer, Long y
Single.
Propiedad
Ruta de mdulo
Fecha de consulta
PROPIEDAD
Especificar un nombre de propiedad PI. Una propiedad puede ser introducida
directamente o mediante referencia en una celda. Tambin puede navegar hasta una
propiedad de la PI Module Database.
RUTA DE MDULO
Introducir la ruta de mdulo de la PI Module Database en la que puede hallarse la
propiedad especificada. La ruta de mdulo es introducida automticamente si el
argumento de la propiedad es seleccionado navegando por la Module Database.
FECHA DE CONSULTA
Especificar una fecha para recuperar una versin especfica de la propiedad.
TEMAS RELACIONADOS
PIPropertyToValue() (pgina 115)
48
Captulo 6
Hojas de clculo
Cuando aade una funcin a una hoja de clculo, PI DataLink recupera los datos
solicitados del PI Server en una matriz. El tamao de la matriz puede variar dependiendo
de la funcin, de cuntos valores de archivo coincidentes haya disponibles en PI, del
nmero de valores solicitados o del nmero de referencias de entrada.
Los temas siguientes proporcionan una visin general de cmo trabajan las funciones de
PI DataLink dentro de una hoja de clculo y de cmo gestionar y mantener la hoja de
clculo a lo largo del tiempo.
Frecuencia de clculo
Puede seleccionar un intervalo de actualizacin automtico para mantener actualizados
los datos de las funciones de su hoja de clculo, o utilizar los mtodos de reclculo
manual y lanzado por la funcin utilizados en versiones anteriores de PI DataLink.
Para obtener informacin detallada de cmo gestiona Excel el clculo, consulte el tema
Reclculo en Excel (http://msdn.microsoft.com/en-us/library/bb687891.aspx) en la
biblioteca MSDN.
Actualizacin automtica
La Actualizacin automtica fuerza a Excel a recalcular las funciones y trends en las

hojas de clculo abiertas, en un intervalo especificado. Para activar la Actualizacin
automtica:
Haga clic en el botn biestado Actualizar en la cinta PI (2007), o seleccione
Actualizar en el men PI (2003).
Todos los libros de trabajo abiertos en la sesin actual de Excel son calculados
inmediatamente y, a continuacin, en intervalos especficos basados en el ajuste de
preferencias de Actualizacin automtica.
Actualizacin automtica permanece activado (con un mensaje indicador en la barra de
estado de Excel) hasta que sea desactivado. Durante un evento de reclculo la barra de
estado muestra tambin el intervalo de clculo.
Nota: Actualizacin automtica no puede actualizar libros de trabajo protegidos, que

son de solo lectura.

Hojas de clculo
Intervalo de clculo
El intervalo de clculo es un ajuste de preferencia (pgina 20) que se mide en segundos, y
debe ser mayor de 5 segundos.
Un valor de 0 representa un intervalo automtico en el que DataLink ajusta el tiempo
entre ciclos de clculo a dos veces el tiempo de duracin del clculo, con un intervalo
mnimo de 5 segundos. Se recomienda el intervalo automtico para asegurar que Excel
permanece receptivo el 50% del tiempo.
Puede ajustar el intervalo de Actualizacin automtica manualmente, para permitir ms
tiempo entre las actualizaciones. Si el reclculo tarda ms que el intervalo especificado,
un mensaje pregunta si se desea cambiar al ajuste de intervalo automtico o desactivar
completamente Actualizacin automtica.
Tenga en cuenta que las actualizaciones se ponen en pausa cuando un men, un panel de
tareas o un cuadro de dilogo est abierto, o cuando la hoja de clculo actual est en
modo de edicin.
Cancelacin
Pulse Esc para cancelar un reclculo en curso. DataLink finaliza el clculo de la funcin
que est procesando en ese momento y aparece un mensaje Clculo cancelado en las
celdas de matriz de funcin no procesadas. Si cancela durante una actualizacin cuando
Actualizacin automtica est activado, DataLink desactiva Actualizacin automtica.
Reclculo provocado
En Excel, las funciones se recalculan a raz de un evento desencadenante. Si no utiliza la

funcionalidad Actualizacin automtica, puede maximizar la frecuencia de refresco y
mantener las matrices de funcin actualizadas haciendo referencia a funciones de tiempo
voltiles dentro de funciones PI DataLink no voltiles.
Las funciones voltiles de tiempo de Excel, como ahora() y hoy() recalculan con la
mayor frecuencia. Siempre que un usuario edita una celda o pulsa F9, Excel actualiza
todas las funciones de tiempo voltiles de la hoja de clculo. La actualizacin
desencadena sucesivamente las funciones que hacen referencia a una marca de tiempo
basada en una funcin de tiempo voltil.
Para basar una funcin PI DataLink en una funcin voltil de Excel:
1. Utilice la barra de funciones de Excel para introducir una funcin voltil en una celda
de la hoja.
Por ejemplo, puede utilizar (hoy()+1/3) para representar las 8 am del mismo
da, o ahora()como una referencia de celda para remplazar el tiempo PI actual *.
Para crear una marca de tiempo absoluta que se actualice al mismo tiempo, utilice 2-
feb-97 00:30:30 + now() - now().
2. Haga referencia a la celda al definir los argumentos Hora de inicio u Hora de
finalizacin de una funcin DataLink.
50
Funciones y valores de matriz
Nota: Para maximizar la frecuencia de actualizaciones cuando no se utiliza

Actualizacin automtica, compruebe sus preferencias de clculo en Excel
para asegurarse de que tanto la hoja de clculo como la aplicacin estn
ajustadas a clculo Automtico en lugar de Manual. Tenga presente que esto
puede causar impacto en el rendimiento y dificultar el uso de hojas de clculo
grandes.
Reclculo manual
La mayora de las funciones de PI DataLink no son voltiles, pero la funcin Valor

actual (pgina 25) es una excepcin. Valor actual es una funcin voltil y se actualiza
siempre que la hoja de clculo se recalcula. Los valores de las funciones no voltiles no
cambian a menos que un argumento cambie, y deben actualizarse manualmente, mediante
una actualizacin automtica usando el modo Clculo completo o mediante una
referencia a un valor de funcin voltil.
El reclculo manual es el mejor mtodo para matrices de tamao variable (pgina 53) en
las que el nmero de valores devueltos puede variar. Si hay disponibles ms valores que
el tamao actual de la matriz, sta no se expande para mostrar los valores adicionales al
recalcular, a menos que se recalcule manualmente.
Para recalcular manualmente una sola funcin:
Haga clic con el botn derecho en cualquier parte de una matriz y elija Recalcular
(redimensionar) funcin en el men contextual.
Actualice los argumentos de funcin en cualquier versin de PI DataLink. Los
valores de matriz se refrescan cuando hace clic en Aceptar o en Aplicar para cerrar
el cuadro de dilogo o panel de tareas, incluso si no se han realizado cambios a los
argumentos de funcin.
Tambin pueden utilizarse combinaciones de teclas de Excel para recalcular todas las
hojas de clculo de un libro de trabajo, lo que es, esencialmente, una versin manual y a
demanda de Actualizacin automtica. Para recalcular todas las funciones de la hoja de
clculo:
Pulse (F9) para forzar el reclculo de todas las funciones voltiles (y de las funciones
que hagan referencia a ellas).
Pulse Ctrl+Alt+Maysculas+F9 para forzar el reclculo de todas las funciones.
Funciones y valores de matriz

Cuando aade una funcin a una hoja de clculo, PI DataLink introduce la sintaxis de la
funcin activa en la celda de destino. Una vez definida, una funcin consulta al servidor
PI y devuelve valores, que aparecen en la misma celda utilizada para introducir la
funcin.
La diferencia entre el contenido real de las celdas y la presentacin superficial de valores
de datos recuperados por una funcin debera ser familiar para los usuarios de Microsoft
Excel. Para los nuevos usuarios de Excel, sirve de ayuda tener en mente esta distincin, y
recordar que el contenido real de una celda aparece siempre en la barra de frmulas de
Excel, y no necesariamente en celdas individuales.

Hojas de clculo
Por ejemplo, cuando selecciona una celda y aade una funcin Valor actual, especifica el
nombre del tag PI cuyo valor actual desea ver en el campo Nombre de tag. Si introduce
el tag sinusoid, PI DataLink pega la siguiente funcin en la celda de destino:
=PICurrVal("sinusoid",0,)
Excel evala esta funcin, recupera el valor ms reciente de sinusoid desde PI y lo
muestra en la celda. Si selecciona la celda, en la barra de frmulas de Excel aparece la
sintaxis de la funcin anterior.
Gestin de matrices
Las matrices de funcin pueden ser eliminadas, copiadas o desplazadas dentro de una
hoja de clculo. Para seleccionar una matriz, realice una de las acciones siguientes:
Haga clic y arrastre para seleccionar todas las celdas de la matriz. Tenga presente que
la matriz puede contener valores vacos, que tambin deben ser seleccionados.
Haga clic con el botn derecho en cualquier parte de la matriz y elija Seleccionar
funcin DataLink en el men contextual para seleccionar todas las celdas de la
matriz.
Una vez seleccionadas, puede gestionar la matriz fcilmente.
Haga clic con el botn derecho en cualquier celda de la matriz y seleccione, segn
desee, la operacin Cortar, Copiar, Eliminar, Borrar o Formato en el men
contextual. Elimine manualmente los caracteres $ iniciales de la barra de frmulas
para convertir las referencias de celda en relativas.
Haga clic con el botn derecho en una nueva celda y seleccione Pegar para volver a
insertar una matriz cortada o copiada.
Site el cursor sobre el borde de la matriz seleccionada hasta que aparezca un cursor
en forma de cruz y, a continuacin, arrastre la matriz a una nueva celda para
desplazarla.
Abra el cuadro de dilogo de funcin o el panel de tareas y actualice la celda de
salida (pgina 52) para colocar la matriz en una nueva ubicacin.
Nota: Debe trasladar o borrar una matriz Excel completa, incluyendo todas las
celdas, o DataLink mostrar un mensaje de error: No se puede cambiar parte
de una matriz.
Tambin puede copiar los valores de una matriz de funcin si desea utilizarlos en otra
parte en una hoja de clculo. Una vez que copie y pegue los valores, ya no forman parte
de una matriz de funcin; son simplemente valores de celda y no se actualizan. Para
copiar valores de matriz:
Seleccione los valores de funcin que desea, cpielos y utilice Pegado especial para
pegarlos en la ubicacin deseada.
No es necesario seleccionar la columna o fila completa de la matriz para copiar
valores.
52
Gestin de matrices
Argumentos de actualizacin
Puede actualizar una matriz de funcin con nuevos valores de argumento.

1. Haga clic con el botn derecho y seleccione el nombre de la funcin en el men
contextual (2003 o 2007), o muestre el cuadro de dilogo de funcin o el panel de
tareas.
Aparece el correspondiente cuadro de dilogo de funcin y muestra los argumentos
actuales en los campos de edicin adecuados.
2. Cambie los parmetros que desee para actualizar la matriz con nuevos argumentos y
haga clic en Aceptar o en Aplicar.
Si se cambia el argumento Celda de salida, los resultados dependen de la ubicacin
de la nueva referencia de celda:
Si la nueva referencia de celda forma parte de la matriz original, toda la matriz se
desplaza, de forma que la celda superior izquierda de la matriz se coloca en la
nueva celda a la que se hace referencia.
Si la nueva referencia de celda no forma parte de la matriz original, la matriz se
copia y se pega con la celda superior izquierda colocada en la nueva celda a la
que se hace referencia. La matriz original permanece en su ubicacin original.
Recuerde que tambin puede editar la sintaxis de la funcin directamente pulsando F2
para editar en la barra de frmulas de Excel. Pulse Ctrl + Maysculas + Intro para guardar
las ediciones cuando haya finalizado.
Redimensionar matrices
Cuando se llama a una hoja de clculo en momentos diferentes, puede haber un diferente
nmero de valores disponibles para una funcin definida. Si el nmero de valores excede
el tamao actual de la matriz, sta no se expande para mostrar los valores adicionales al
recalcular, a menos que recalcule manualmente (pgina 51) la funcin.
Si existen menos valores recuperados que el nmero original, se devuelven valores vacos
para llenar la matriz recalculada, y se marcan #N/D si se especifica, o se dejan en blanco.
Si existen valores adicionales que no se pueden mostrar, aparece en la parte inferior de la
matriz de funcin el texto Redimensionar para mostrar todos los valores, a menos que
ajuste una preferencia para desactivar este mensaje (pgina 20)
Para redimensionar la matriz para ajustarse a los datos disponibles:
Haga clic con el botn derecho en cualquier parte de una matriz y elija Recalcular
(redimensionar) funcin en el men contextual.
Los valores vacos se suelen aadir cuando una funcin hace referencia a un tiempo que
se extiende hasta la hora actual, utilizando horas de inicio y finalizacin relativas. Cuando
una funcin se recalcula, el intervalo de tiempo abarca un nuevo intervalo que puede
incluir ms variedad de datos y, por lo tanto, un nmero distinto de eventos grabados en
el archivo.
Por ejemplo, considere una funcin de datos comprimidos creada para solicitar 40 valores
que comiencen en la medianoche del da anterior. Cuando la funcin se recalcula una
semana despus y solo se han registrado 35 valores de evento (incluidos los eventos
filtrados), las cinco celdas finales de la matriz original se rellenan con cadenas vacas para
conservar el tamao de la matriz.

Hojas de clculo
Los valores vacos pueden cambiar el aspecto de una hoja, pero ayudan a asegurar que las
variaciones en los datos grabados son incorporadas sin actualizar la funcin. Para
mantener un tamao constante para las funciones de Datos comprimidos (pgina 27),
especifique el nmero de valores a recuperar, en lugar de un intervalo temporal. O, para
mostrar nicamente una porcin predeterminada de los resultados, especifique un
intervalo de celdas de salida (pgina 14) limitado.
Compartir hojas de clculo

Si desea compartir datos PI y hacer las hojas de clculo accesibles a otros usuarios, tenga
en mente las siguientes consideraciones:
Puede enviar una hoja de clculo PI DataLink a otro usuario de Microsoft Excel. El
usuario debe tener instalado PI DataLink y una conexin activa al mismo servidor PI
para poder recalcular funciones y ver valores de punto PI actualizados
dinmicamente.
Si los usuarios no tienen instalado PI DataLink, todava pueden ver los ltimos datos
guardados en la hoja de clculo siempre que las opciones de clculo de Excel estn
ajustadas a Manual antes de que la hoja de clculo sea abierta en Excel. En Excel
2007, haga clic en el botn Office 2007 y, a continuacin, en Opciones de Excel >
Frmulas para acceder a estas opciones. En Excel XP-2003, el juste manual est
disponible en Herramientas > Opciones en la ficha Calcular.
Tambin puede guardar en formato HTML o PDF en Excel 2007 para compartir una
hoja de clculo esttica.
Puede copiar y pegar (pgina 52) valores de matrices de funcin a nuevas
ubicaciones utilizando Pegado especial. Aunque los datos de la hoja de clculo no
pueden ser recalculados una vez copiados, este mtodo le permite distribuir una
instantnea personalizada de los datos a cualquiera que tenga una copia de Excel.
Si tiene Microsoft Office SharePoint Server (MOSS) en su entorno informtico,
puede publicar una hoja de clculo DataLink en un sitio SharePoint y utilizar PI
DataLink for Excel Services (pgina 2) para mostrar y recalcular los datos de
funciones PI.
54
Captulo 7
Pantallas de tendencias
PI DataLink incluye un objeto de control de trend ActiveX que puede ser insertado en
cualquier hoja de clculo Excel para mostrar el trend de valores de evento a lo largo del
tiempo. Los objetos trend incrustados puede mostrar datos tanto de la hoja de clculo
como de los puntos PI seleccionados.
Crear un trend
Un asistente facilita la insercin y configuracin de trends. Para insertar un trend:
1. Haga clic en la celda en la que desea colocar la esquina superior izquierda del objeto
trend, haga clic en PI > Insertar trend (XP-2003), o haga clic en Insertar trend en
la cinta PI (2007) para abrir el Asistente del complemento trend.
Al seleccionar la celda de entrada, considere que el tamao predeterminado del objeto
trend requiere aproximadamente 14 x 8 celdas estndar.
2. Seleccione la fuente de nombres de tag:
Seleccione Datos en la hoja de clculo para basar el trend en valores de matriz
(pgina 56) que ya aparecen en celdas de la hoja de clculo.
Seleccione Datos de PI para basar el trend en puntos de datos especficos
recuperados directamente de PI (pgina 56).
3. Complete los pasos restantes del asistente para trend.

Datos de la hoja de clculo
Si seleccion Datos en la hoja de clculo, el asistente para trend le pedir que seleccione
el intervalo de celdas que contiene los datos con los que desea realizar el trend.
Para especificar datos de la hoja de clculo para el trend:

1. Haga clic en el campo Intervalo de celdas que contienen los datos y, a
continuacin, haga clic y arrastre para seleccionar un intervalo de celdas en la hoja de
clculo.
A menos que quite la seleccin de Incluir todas las celdas en la matriz, solo
necesita seleccionar una celda de una matriz de funcin. El resto de la matriz se aade
automticamente a la referencia de rangos de celda cuando hace clic en Aadir.
Para puntos de datos discretos que no forman parte de una matriz, tendr que
seleccionar cada una de las celdas deseadas.
2. La opcin El primer elemento es el nombre de trace para utilizar el valor de una
celda adyacente para dar nombre al trace de la trend.
El primer elemento es la celda situada sobre el primer valor del intervalo
seleccionado si los datos estn ordenados en formato de columna, y la primera celda a
la izquierda del primer valor del intervalo para los datos en formato de fila.
3. Seleccione Escalonado para trazar un plot de trend escalonado en lugar de un trace
continuo.
Esta opcin suele especificar tags discretos.
4. Haga clic en Aadir para aadir el intervalo de celdas seleccionado al trend.
5. Aada referencias de celda segn sea necesario, o haga clic en Siguiente o en
Finalizar para continuar.
56
Crear un trend
Datos PI
Si selecciona Datos de PI, el asistente para trend le solicitar que haga referencia o que
busque nombres de tag PI.
Para especificar datos PI para el trend:

1. Haga clic en el campo Nombre de tag y, a continuacin, haga clic y arrastre para
seleccionar un intervalo de celdas en la hoja de clculo.
Tambin puede introducir una referencia de celda directamente, o utilizar el botn de
referencia para abrir un cuadro de dilogo de referencia utilizado para buscar
y aadir referencias de celda.
Tambin puede hacer clic en el botn de seleccin para buscar tags (pgina 39)
en PI. Los tags seleccionados mediante una bsqueda de tags se aaden
automticamente a la lista de traces.
2. Cambie el nombre predeterminado del servidor (si es necesario) en el campo Nombre
del servidor y haga clic en Aadir para aadir al trend las referencias a los nombres
de tag seleccionados.
Puede utilizar el botn de referencia para abrir un cuadro de dilogo de

referencia utilizado para buscar y aadir referencias de celda.
3. Aada nombres de tag segn sea necesario, o haga clic en Siguiente o en Finalizar
para continuar.

Gestin de traces
Al crear un trend a partir de una hoja de clculo o de datos PI, acumula traces en el panel
de traces situado a la derecha de la pantalla del asistente. Se proporcionan varios controles
para gestionar los traces que aparecen en el trend:
Seleccione la casilla de verificacin Marcadores situada junto al nombre de un trace
para mostrar marcadores en el trace para indicar la ubicacin de los puntos de datos
de archivo histrico.
Nota: Los traces se dibujan con distintos colores. De forma predeterminada, un

trend incluye tambin marcadores ocultos, para diferenciar los traces en
las pantallas monocromas. Los marcadores ocultos tienen una separacin
regular a lo largo del trace y no indican puntos de datos de archivo
histrico.
Haga clic en los botones de flecha situados sobre el panel de traces para mover los
traces arriba y abajo en la pantalla de leyenda de trace.
Haga clic en los botones X y X Todo para eliminar los traces seleccionados o todos,
respectivamente.
Haga clic en el botn Cambiar nombre para cambiar el nombre de un trace
seleccionado en la leyenda de traces.
Especificar el Intervalo de tiempo

Cuando los traces de trend estn determinados, el asistente le solicita que especifique un
intervalo de tiempo para el trend si alguno de los traces se traza directamente desde PI.
Para especificar un intervalo de tiempo:
1. Haga clic en los campos Hora de inicio y Hora de finalizacin y, a continuacin,
haga clic para seleccionar una celda de marca de tiempo en la hoja de clculo.
Tambin puede introducir una cadena de tiempo directamente, o utilizar el botn de
referencia para abrir un cuadro de dilogo de referencia utilizado para buscar
y aadir referencias de celda.
Nota: Si introduce una cadena de tiempo combinada o absoluta (pgina 71),

asegrese de utilizar el formato de marca de tiempo correcto.
2. Seleccione Activar actualizaciones para actualizar el trend con nuevos datos PI si el

intervalo de tiempo cambia o se extiende hasta el presente.
3. Seleccione siguiente o Finalizar para continuar.
58
Ttulo y posicin
Ttulo y posicin
Complete el trend y determine su ubicacin en la pantalla final.
Para completar el trend:

1. Introduzca un Ttulo de trend.
2. Quite la seleccin de Mostrar atributos de valor si no desea que los atributos de
valor aparezcan en los traces de trend.
Los iconos aparecen cuando el intervalo de datos contiene eventos que tienen
ajustados los bits Cuestionable, Sustituido o Anotado.
3. Seleccione una ubicacin diferente para el trend, si lo desea, ubicndola en una hoja
de trabajo aparte o cambiando la celda de posicin predeterminada.
Si se selecciona Nueva hoja de clculo, la trend se colocar en la esquina superior
izquierda de una hoja de clculo en blanco.
Si se selecciona Hoja de clculo existente, la celda (o el intervalo utilizado para
dimensionar la trend) en la que se va a colocar la trend debe especificarse o ser
referenciada en el campo que acompaa. Si cambia la celda de ubicacin
predeterminada, asegrese de que la nueva celda no contiene datos (que quedarn
cubiertos por la presentacin de la trend).
Men contextual
Una vez que se ha insertado un trend en una hoja de clculo, puede actualizarlo, editarlo o
gestionarlo utilizando el men contextual. Para acceder a las opciones del men
contextual:
Haga clic con el botn derecho en la pantalla del trend y seleccione una opcin en el
men.
Seleccione Cambiar escala para cambiar la escala del eje Y y el intervalo de
tiempo.

Seleccione Revertir para deshacer los cambios y volver a la configuracin

original del tren definida en el Asistente de trends.
Seleccione Barra de desplazamiento para habilitar una barra de desplazamiento
en la parte inferior del trend para desplazar la pantalla por los intervalos de
tiempo adyacentes.
Seleccione Formato para editar la presentacin de traces individuales o del trend
completo utilizando el cuadro de dilogo Propiedades del control Trend. Puede
cambiar el color o el grosor de la lnea de un trace o aadir elementos de leyenda
al trend.
Seleccione Definir trend para mostrar la pantalla de definicin de trace del

asistente de trends, para actualizar o cambiar las fuentes del trace.
Seleccione Definir intervalo de tiempo de trend para mostrar la pantalla de
definicin de intervalo de tiempo del asistente de trends, para actualizar el
intervalo de tiempo.
Seleccione Eliminar trend para eliminar el trend de la hoja de clculo.
Nota: Un trend eliminado no puede ser restaurado y debe volver a crearse.
Seleccione Exportar datos para pegar los valores utilizados para trazar la trend
en celdas de la hoja de clculo. Puede especificar formato e filas o columnas, y
tambin exportar nombres de traces como encabezados.
60
Men contextual
Seleccione Mover/Redimensionar e introduzca una ubicacin de celda para

mover la esquina superior izquierda del trend a la celda especificada. Introduzca
un intervalo de celdas para redimensionar el trend.
Seleccione Copiar/Pegar para copiar la pantalla del trend completa al
portapapeles y, a continuacin, solicita una celda de destino para pegar el control.

Captulo 8
Notificaciones
PI DataLink incluye un complemento PI Notifications Search, que puede utilizar para
recuperar de su PI System notificaciones a las que est suscrito, e insertarlas directamente
en hojas de clculo.
El complemento PI Notifications para Excel se instala con PI DataLink 4.0, puede
ejecutarse en Windows XP y sistemas operativos posteriores, y requiere Excel XP o
versiones posteriores.
Nota: Debe tener una cuenta en al menos un PI System que ejecute un servidor PI
AF 2.0 con PI Notifications 1.0, y estar suscrito al menos a una regla de
notificacin para recibir notificaciones.
Para ms informacin sobre PI Notifications, consulte el Manual del usuario
de PI Notifications.
Para iniciar el visor de PI Notifications:

Haga clic en el icono Notificaciones en la cinta PI (2007), o seleccione PI >
Notification Search (2003).
Bsqueda y visualizacin de notificaciones

Puede utilizar el visor de PI Notifications para buscar y recuperar notificaciones a las que
se haya suscrito en un PI System accesible. UN PI System es una base de datos de
elementos estructurales y de eventos de notificacin que le ayuda a trabajar con datos de
su servidor PI.

Notificaciones
Para buscar notificaciones:

1. En la ficha Buscar, seleccione un PI System en el que buscar notificaciones:
Seleccione un sistema en el men PI System y haga clic en Conectar para
conectar con el PI System seleccionado.
Haga clic en el botn puntos suspensivos para acceder a la Lista de sistemas
y aadir PI System (pgina 64) al men.
Haga clic en Referencia para hacer referencia al nombre de un PI System en
una celda.
Haga clic en el botn de nuevo para mostrar el men PI System.
2. Seleccione una opcin en el men Ver notificaciones para filtrar la lista de
notificaciones devueltas.
Seleccione Activas para mostrar todas las notificaciones activas actualmente.
Seleccione Intervalo de tiempo e introduzca valores de Hora de inicio y Hora de
finalizacin para devolver las notificaciones que se produzcan a lo largo de un
intervalo de tiempo especificado.
Seleccione Recientes e introduzca un nmero y un intervalo de tiempo para
devolver las notificaciones ms recientes de un periodo de tiempo especfico.
3. Cambie la Celda de salida para situar la lista de notificaciones en una celda
diferente, si lo desea.*
4. Haga clic en Buscar.
Las notificaciones devueltas por la bsqueda aparecen en el Visor del historial de
notificaciones (pgina 65).
5. Haga clic en Aceptar para insertar el contenido del visor del Historial de
notificaciones en la hoja de clculo (pgina 66) y cerrar el cuadro de dilogo.
La consulta de notificaciones se inserta como una funcin en la hoja de clculo en la
ubicacin designada. Al igual que otras funciones PI, los datos de notificaciones se
actualizan cuando la hoja de clculo se recalcula (pgina 50).
Haga clic en Cancelar para cerrar el cuadro de dilogo descartando los resultados de
la bsqueda.
Aadir PI Systems
Puede haber varios PI System en su entorno, cada uno de los cuales puede tener PI
Notifications instalado y ser una fuente de notificaciones relevantes para usted. Por
ejemplo, puede suscribirse a notificaciones de sistemas PI ejecutndose en distintas
instalaciones, o representando distintas unidades de negocio.
Para recibir estas notificaciones suscrbase o haga que su administrador le suscriba a las
notificaciones de cada sistema PI utilizando la aplicacin PI System Explorer, y aada
cada PI System al visor de PI Notifications.
64
Bsqueda y visualizacin de notificaciones
Para aadir sistemas al men PI System:
1. Haga clic en Lista de sistemas .

Aparecer el cuadro de dilogo Sistemas.
2. Haga clic con el botn derecho en el panel de sistemas y seleccione Nuevo PI

System.
Haga clic con el botn derecho sobre una entrada de un sistema PI existente para
cambiar propiedades o especificar un sistema predeterminado.
3. Introduzca la informacin de red pertinente para localizar y autenticar su equipo en el
sistema PI.
El campo Nombre contiene el nombre utilizado para describir el sistema PI en el
visor de PI Notifications.
4. haga clic en Configurar Active Directory para sacar la informacin del PI System
de una ubicacin de Active Directory, si procede.
5. Cuando la configuracin est finalizada, haga clic en Aceptar para guardar la entrada
del nuevo PI System.
Los sistemas PI aparecen en el men PI System o en la parte superior del men si se
especifican como sistema predeterminado.
Para obtener ms informacin sobre PI System, consulte el Manual del usuario de AF
2.0.

Notificaciones
Ver notificaciones
El visor del Historial de notificaciones aparece en la mitad inferior de la ficha Buscar
notificaciones, y muestra las notificaciones que coincidan con los criterios de bsqueda.
Utilice el visor del Historial de notificaciones para evaluar, gestionar y responder a
notificaciones.
Seleccione una notificacin y haga clic con el botn derecho para mostrar el men
contextual y seleccione una opcin:
Seleccione Aceptar instancia para aceptar que se ha llevado a cabo una accin
en respuesta a la notificacin e indicar que no es necesario escalar la notificacin.
Introduzca un comentario en el cuadro de dilogo proporcionado, si lo desea, y
haga clic en Aceptar.
Seleccione Aceptar suscripcin para acusar recibo de una notificacin a la que
est suscrito. Introduzca un comentario en el cuadro de dilogo proporcionado, si
lo desea, y haga clic en Aceptar.
Seleccione Aadir comentario para comentar una notificacin.
Seleccione Ver resumen de reglas de notificacin para mostrar las propiedades
de la regla de notificacin que ha desencadenado la notificacin seleccionada.
Tambin puede gestionar la visualizacin de notificaciones en el visor:
Haga clic en las cabeceras de las columnas para ordenar las notificaciones por un
atributo en concreto, o haga clic con el botn derecho para mostrar y ocultar
columnas.
Haga clic con el botn derecho en la ventana de notificaciones y seleccione una
opcin:
Seleccione Expandir todo o Contraer todo para expandir o contraer un grupo
de notificacin.
Seleccione Mostrar eventos de contactos para activar y desactivar la
visualizacin de los eventos de contacto para cada notificacin.
Insertar notificaciones
En las funciones de PI DataLink se puede hacer referencia a los datos de notificaciones en
celdas de hoja de clculo. Por ejemplo, tal vez desee utilizar el valor Hora de inicio
de una notificacin recuperada para obtener datos de muestra que indiquen el progreso de
un proceso por lotes.
66
Insertar notificaciones
Si sus notificaciones estn ajustadas para mostrar confirmaciones, dichas columnas

incluyen enlaces a pginas web de PI Notifications en las que podr confirmar o comentar
una notificacin.
Nota: Cuando confirma una notificacin, aparecen mensajes de advertencia. Puede

desactivar estos mensajes para Office 2003
(http://support.microsoft.com/kb/829072) y Office 2007
(http://support.microsoft.com/kb/925757), pero no para otras versiones
(http://support.microsoft.com/kb/291912) de Microsoft Office.
Para obtener ms informacin sobre notificaciones, suscripcin y confirmacin, Manual

de usuario de PI Notifications.
Configuracin de visualizacin de notificaciones
Utilice la fichaFormato de visualizacin para especificar cmo aparecen las

notificaciones cuando son insertadas en celdas. Puede seleccionar las columnas utilizadas
para mostrar datos de notificacin estndar y cambiar su organizacin y formato.
Columnas
Seleccione columnas en la lista Columnas disponibles y haga clic en Aadir para
moverlas a la lista Orden de columnas para determinar qu datos se insertan en la
hoja de clculo.
Utilice los botones de flecha sobre la lista Orden de columnas para definir el orden
de las columnas (o las filas).
Haga clic en Eliminar para eliminar las columnas seleccionadas de la lista Orden de
columnas o Borrar para eliminar todas las columnas.
Aada columnas confirmacin o Confirmacin con comentario para aadir enlaces
para confirmar la recepcin o comentar una notificacin.

Notificaciones
Eventos de contacto
Seleccione Mostrar eventos de contactos para aadir eventos de contactos
relacionados con cada notificacin a la visualizacin, tales como enviar a cada
destinatario, comentarios y confirmaciones.
Seleccione Sangrar contactos para distinguir los eventos de contactos en la
visualizacin sangrndolos. Seleccione Formato a celdas para mostrarlas sangradas
en la misma columna que los eventos de notificacin o Utilizando columnas
separadas para aadir una segunda columna para eventos de contactos.
Seleccione Usar agrupacin de Excel para utilizar la funcionalidad de agrupacin de
Excel para anidar eventos de contactos bajo las notificaciones primarias individuales
que los generan.
Nota: La agrupacin de Excel no se admite para hojas de clculo publicadas en

PI DLES (pgina 2).
Presentacin y orientacin
Seleccione Mostrar cabeceras de columnas para aadir cabeceras de columna y fila
sobre los datos de notificaciones.
Seleccione Mostrar contador para aadir un contador de notificaciones sobre los
datos de notificaciones.
En Orientar los resultados en, seleccione presentar las notificaciones en Columnas
o Filas.
68
Apndice A
Informacin complementaria
Configuracin
Los usuarios disponen de dos formas de trabajar con las funciones de PI DataLink en
hojas de clculo Excel:
Los usuarios pueden instalar una versin autnoma de PI DataLink en su ordenador
local.
Los usuarios a travs de la web pueden visualizar hojas de clculo con funciones de
PI DataLink utilizando PI DataLink for Excel Services (pgina 2).
Para obtener ms informacin, pngase en contacto con el personal de ventas de OSIsoft.
Nota: Las versiones anteriores de PI DataLink permitan instalar y ejecutar una

versin compartida desde un servidor de archivos central. Esta funcin ya no
se permite.
Puede instalar PI DataLink desde un CD de distribucin o desde un kit de instalacin

descargado desde OSIsoft. El programa de instalacin instala automticamente las dos
versiones para Excel XP-2003 y 2007 del complemento PI DataLink en su sistema,
independientemente de la versin de Excel que tenga instalada.
Si tiene en su equipo Excel XP 2003, deber configurar el complemento
manualmente (pgina 3) despus de la instalacin, aadindolo a Excel.
Si tiene Excel 2007 en su PC, el programa de instalacin configura automticamente
el complemento para Excel 2007.
Instalaciones silenciosas
Para instalaciones silenciosas, utilice el archivo silent.ini incluido en el kit de

distribucin de DataLink escribiendo:
Setup.exe -f silent.ini
Puede realice en el archivo las modificaciones especficas del sitio que sean necesarias.
Consulte el setup.ini del PI SDK para ms informacin y descripciones de los
argumentos disponibles.

Conectividad con PI Server
Los ordenadores cliente que ejecuten Microsoft Excel y PI DataLink pueden recuperar
datos de tres servidores PI.
Para ms informacin sobre seguridad y conectividad de PI Server, consulte su
documentacin de PI Server o descrguela del sitio de soporte tcnico de OSIsoft
(http://techsupport.osisoft.com/downloadcenter.aspx).
Base de datos de firewall

La base de datos de firewall de un ordenador servidor PI debe configurarse para permitir
el acceso desde los ordenadores cliente que ejecutan PI DataLink. Por ejemplo,
PIConfig> @table pi_gen,pifirewall PIConfig> @ostr
hostmask,value PIConfig> @select hostmask=* PIconfig> @ends
*.*.*.*, ALLOW
no bloque intervalos de IP, lo que indica que todos los ordenadores cliente pueden
conectarse a PI 3 Server. En contraste,
*.*.*.*, DISALLOW 192.168.100.*, ALLOW
nicamente permite conexiones desde direcciones TCP/IP que comiencen por
192.168.100.
Trusts
Un trust PI permite a los clientes conectarse a un ordenador servidor PI y recuperar datos
sin iniciar una sesin de usuario explcita. Un trust, en cambio, permite a un usuario
iniciar sesin basndose en una direccin IP, dominio de Windows, nombre de usuario,
aplicacin y otros criterios.
Los trusts PI se establecen en el servidor PI y se almacenan en una base de datos de trusts.
Para obtener informacin sobre cmo configurar trusts para acceder a un servidor PI
consulte su documentacin de PI Server.
Permisos de acceso a puntos

PI DataLink solicita al usuario un nombre de usuario y contrasea al conectarse a un
servidor PI. El nombre de usuario se utiliza junto con los campos PtOwner, PtAccess,
DataOwner y DataAccess.
Por ejemplo, si el tag sinusoid est configurado con PtAccess O:RW, G:NONE,
W:NONE, y PtOwner es user1, un usuario debe iniciar sesin como user1 para
poder acceder al tag. De otro modo, no se podr encontrar el tag.
Si sinusoid DataAccess es O:R, G:NONE, W:NONE, y DataOwner es
user1, un usuario debe iniciar sesin como user1 para poder ver los datos del tag
sinusoid. De lo contrario, aparecer un mensaje de error de acceso de lectura.
Sin embargo, el mismo usuario no puede escribir datos en sinusoid porque el atributo
DataAccess es O:R (solo lectura). El administrador de PI System tendr que cambiar
DataAccess a O:RW (lectura y escritura) para permitir a un usuario iniciar sesin como
user1 para leer y escribir datos en sinusoid.
70
Tiempo PI
Nota: La cuenta PIAdmin es un usuario superprivilegiado y tiene acceso de lectura y

escritura a todos los tags. Por este motivo, los administradores del sistema
normalmente no deben permitir a los usuarios de PI DataLink iniciar sesin
como PIAdmin.
Tiempo PI
Las expresiones y abreviaturas de tiempo PI le permiten especificar tiempos e intervalos
de tiempo para datos PI mediante constantes, variables y expresiones cortas.
Abreviaturas de tiempo PI
Un intervalo es una unidad de tiempo que puede ser utilizada en las entradas de hora. Los
intervalos que admiten valores fraccionados se indican abajo. Para intervalos en los que la
columna de Fracciones indica No, no pueden utilizarse cantidades fraccionadas en las
cadenas temporales.
Nombre Nombre Nombre Nombres de miembros Fraccion
corto plural es
segundo s segundos no s
minuto m minutos no s
hora h horas no s
da d das no no
mes m meses s (por ejemplo, diciembre) no
ao a aos no no
semana s semanas no no
da de la ds das de la s (por ejemplo, martes) no
semana semana
da del ao da das del ao no no
Puede introducir nombres de meses y das de la semana completos o introducir las tres
primeras letras (por ejemplo, dic o mar)
Los tiempos PI tambin se pueden expresar mediante ciertas constantes:
Constante Resultado
* La hora y fecha actual.
Hoy o h 12:00 am del da actual.
Ayer o a 12:00 am del da anterior.
Domingo o dom 00:00:00 (medianoche) del domingo ms reciente (en referencia

al servidor PI).

Expresiones de tiempo PI
PI tiene tres tipos de expresiones de tiempo: tiempo relativo, tiempo combinado y tiempo
absoluto. Estos tipos de expresin de tiempo se definen en la siguiente tabla.
Expresin Descripcin Ejemplos
Tiempo Las expresiones de tiempo relativo especifican un +1d
relativo nmero de das, horas, minutos o segundos, -24h
precedidas de un signo + o -. -3m
En ausencia de un tiempo de referencia (tal como * o +24s
un tiempo absoluto), ya sea en las cadenas de tiempo
de inicio o de fin, el tiempo de fin se calcula respecto al
tiempo actual del reloj y el tiempo de inicio se calcula
respecto al tiempo de fin.
Tiempo Una expresin de tiempo combinado es una referencia *+8h
combinado de tiempo especfica precedida de una expresin de 18-dic-02 -
tiempo relativa. 3m
t+32s
Tiempo Una expresin de tiempo absoluto es cualquier *
absoluto expresin de tiempo que no sea una expresin relativa 14-dic-97
o combinada. 11-nov-96
2:00:00.0001
hoy
a
Al utilizar tiempos PI, siga estas directrices:

Utilice expresiones temporales absolutas o combinadas. Evite utilizar expresiones
temporales relativas. El uso de varias expresiones temporales relativas en un rango
temporal puede provocar una hora de inicio incorrecta o un mensaje de error, segn el
contexto de la expresin.
Las expresiones de tiempo relativas y combinadas contienen un operador nico: un
nico signo de suma (+) o de resta (-). Los operadores adicionales pueden provocar
resultados impredecibles. Por ejemplo, las siguientes no son expresiones de tiempo
vlidas:
*+1d+4h
T-1d+12h
El nombre o nombre corto de un intervalo utilizado para denotar tiempo PI no
distingue entre maysculas y minsculas.
72
Tiempo PI
Ejemplos de cadena de tiempo PI
Ejemplos de sintaxis de tiempo

Cadena de tiempo PI Significado
06-dic-91 15:00:00 3:00:00 PM el 6 de diciembre de 1991
* Hora actual (tiempo real)
25 00:00:00 (medianoche) del da 25 del mes actual
25-ago-92 00:00:00 (medianoche) del 25 de agosto de 1992
8: 08:00:00 de la fecha actual
25 8: 08:00:00 del da 25 del mes actual
hoy 00:00:00 de la fecha actual (hoy)
a 00:00:00 de la fecha anterior (ayer)
dom, lun, mar, mi, jue, vie, sb 00:00:00 del domingo, lunes, ... ms reciente
Sbado
* - 1h Hace una hora
t+8h 8:00:00 AM hoy
y-8h 16:00:00 de anteayer
lun+14.5h 14:30:00 del pasado lunes
sb-1m 23:59:00 del pasado viernes
Ejemplos de intervalos de tiempo

En expresiones de intervalo, un intervalo positivo o sin marcar se basa en la hora de inicio
y un intervalo negativo se basa en el fin de una expresin de tiempo.
Por ejemplo, si la hora de inicio es y, la de finalizacin es t y el intervalo es +5h para una
funcin de datos de muestra, los valores interpolados se generan en y, y+5h, y+10h,
y+15h, y+20h. Si el intervalo es -5h, los valores interpolados se generan en y+4h, y+9h,
y+14h, y+19h y t.
Cadena de Significado
tiempo PI
1.5h Una hora y media
32m Treinta y dos minutos
49 s Cuarenta y nueve segundos
+5 h Cinco horas aadidas al tiempo,
empezando con la hora de inicio
-5 h Cinco horas restadas al tiempo, empezando
con la hora de finalizacin

Compatibilidad con el tipo de datos PI

PI DataLink admite los siguientes tipos de datos de punto PI:
Tipo de datos Soporte
Digital (estados definidos) compatible
Int (16 y 32) compatible
Float (16, 32 y 64) compatible
String (texto) compatible
Marca de tiempo compatible
Objeto blob no compatible
Expresiones PI
Las expresiones PI (tambin conocidas como ecuaciones de rendimiento PI) son
utilizadas para funciones que incorporan operaciones matemticas y clculos basados en
puntos PI.
En algunas expresiones se puede sustituir una PI Expression por un nombre de tag para
calcular valores segn son recuperados del PI Server. Las funciones que permiten un
argumento de expresin incluyen los botones PI Tag y PI Expression en el cuadro
dilogo o panel de tareas de la funcin.
Para basar una funcin en una expresin de clculo PI:
1. Haga clic en el botn PI Expression situado en la parte superior del cuadro de
dilogo o panel de tareas de la funcin.
El campo Nombre(s) de tag se convierte en un campo Expresin(es). Otros campos
pueden activarse o desactivarse.
2. introduzca la expresin directamente en el campo Expresin(es), o utilcelo para
hacer referencia a una celda que contenga una expresin.
El uso de referencias a campos permite especificar varias expresiones para una
funcin. Recuerde que una expresin en una celda a la que se hace referencia es una
cadena, y debe ir precedida por un apstrofe.
Algunas funciones proporcionan tambin una campo para un argumento Filter
Expression. Se puede proporcionar una expresin de filtro para limitar los valores
devueltos por una funcin, y hacer referencia a una expresin de filtro en una celda de
hoja de clculo.
Las funciones que pueden utilizar estas expresiones son:
Valor de archivo histrico (pgina 26)
Datos comprimidos (pgina 27)
Datos de muestra (pgina 29)
Datos temporizados (pgina 31)
Datos calculados (pgina 33)
Filtrado de tiempo (pgina 37)
74
Expresiones PI
Los siguientes apartados explican brevemente los conceptos bsicos de las expresiones
PI: PI DataLink admite toda la sintaxis funcional, los operadores y las funciones
admitidas por el PI Server.
Para ver una descripcin completa de las PI Performance Equations y ejemplos, consulte
la Gua de aplicaciones de PI Server o el archivo de ayuda de Performance Equations de
PI 3.
Sintaxis
Siga estas indicaciones para escribir expresiones PI:

Comience las expresiones con una comilla simple para forzar a Excel a interpretar la
expresin como una cadena.
Encierre entre comillas simples los nombres de tag de la expresin.
Introduzca dos comillas simples si la expresin comienza con un nombre de tag.

Operadores
Los siguientes operadores son admitidos en PI Expressions:

Tipo Operador Ejemplo de sintaxis Significado
Aritmtico + A + B Suma: A + B
- A - B Resta: A menos B
* A * B Multiplicacin: A por B
/ A / B Divisin: A dividido por B
^ A ^ B Elevacin a una potencia: A elevado a B (AB)
Mod A mod B Mdulo: el resto de A dividido por B
Relacional < A < B Menor que: devuelve verdadero si A es menor
que B
= A = B Igual que: devuelve verdadero si A es igual que
B
> A > B Mayor que: devuelve verdadero si A es mayor
que B
<= A <= B Menor o igual que: devuelve verdadero si A es
menor o igual que B
<> A <> B No igual que: devuelve verdadero si A no es
igual que B
>= A >= B Mayor o igual que: devuelve verdadero si A es
mayor o igual que B
Prefijo Not NOT A Complementacin: devuelve verdadero si A es 0
y falso en caso contrario.
- - A Negacin (como operador prefijo): devuelve el
negativo de A
Conjuncin, And A and B Conjuncin: devuelve verdadero si los
Disyuncin e operandos A & B son evaluados ambos como
Inclusin verdaderos. Si tanto A como B son enteros,
devuelve el resultado de una operacin AND a
nivel de bit.
Or A or B Disyuncin inclusiva: devuelve verdadero si
alguno de los operandos A o B es evaluado
como verdadero. Si ambos A y B son enteros,
devuelve el resultado de una operacin OR a
nivel de bit.
in .. A in B..D Inclusin en un intervalo: devuelve verdadero si
el valor de A est entre B y D
in ( ) A in (B1, B2, Inclusin en un conjunto discreto: devuelve
BN) verdadero si el valor de A coincide con alguno
de los valores encerrados entre los parntesis.
Expresiones if then if A then B else Expresin if-then-else: devuelve B si A es
If-Then-Else else D verdadero, en caso contrario devuelve D
76
Expresiones PI
Funciones de Performance Equations
Tambin puede evaluar expresiones que contengan funciones de PI Performance

Equation:
Funciones matemticas
Nombre Descripcin
Abs Valor absoluto
Asin Arco seno
Acos Arco coseno
Atn Arco tangente
Atn2 Arco tangente (dos argumentos)
Cos Coseno
Cosh Coseno hiperblico
Exp Exponencial
Flotar Conversin de cadena a nmero
Frac Parte fraccional de un nmero
Int Parte entera de un nmero
Log Logaritmo natural
Log10 Logaritmo comn
Poly Evaluar polinomio
Round Redondeo a la siguiente unidad
Sgn Signo numrico
Sin Seno
Sinh Seno hiperblico
Sqr Raz cuadrada
Tanh Tangente hiperblica
Tan Tangente
Trunc Truncar a la siguiente unidad inferior
Funciones de conjunto
Nombre Descripcin
Avg Promedio
Max Mximo
Median Selector de mediana
Min Mnimo
PStDev Desviacin estndar de poblacin
SStDev Desviacin estndar de muestra
Total Suma

Funciones diversas
Nombre Descripcin
BadVal() Comprobar si un valor es errneo (no numrico o de tiempo)
Curve Obtener el valor de una curva
DigState Obtener el estado digital de una cadena
IsDST Comprobar si una hora est dentro del periodo local de ahorro de
energa
IsSet Comprobar si un valor PI es anotado, sustituido o cuestionable
StateNo El nmero de cdigo de un estado digital
TagBad Comprobar si un punto tiene un estado anormal
Recuperacin de archivo histrico PI
Nombre Descripcin
NextEvent La hora del prximo evento de archivo histrico de un punto
NextVal El siguiente valor de un punto despus de una hora
PrevEvent La hora del anterior evento de archivo histrico de un punto
PrevVal El valor anterior de un punto antes de una hora
TagVal El valor de un punto a una hora
Bsqueda de archivos histricos PI
Nombre Descripcin
FindEq Marca de tiempo cuando el punto = valor
FindGE Marca de tiempo cuando el punto >= valor
FindGT Marca de tiempo cuando el punto > valor
FindLE Marca de tiempo cuando el punto <= valor
FindLT Marca de tiempo cuando el punto < valor
FindNE Marca de tiempo cuando el punto != valor
TimeEq Periodo total cuando el punto = valor
TimeGE Periodo total cuando el punto >= valor
TimeGT Periodo total cuando el punto > valor
TimeLE Periodo total cuando el punto <= valor
TimeLT Periodo total cuando el punto < valor
TimeNE Periodo total cuando el punto != valor
Estadsticas de archivos histricos PI
Nombre Descripcin
EventCount Nmero de eventos de archivo histrico
PctGood Porcentaje de tiempo correcto en un periodo
Range Intervalo del valor mnimo al mximo
StDev Desviacin estndar ponderada en el tiempo
TagAvg Promedio ponderado al tiempo
TagMean Promedio ponderado a evento
78
Expresiones PI
Nombre Descripcin
TagMax Valor mximo en un periodo
TagMin Valor mnimo en un periodo
TagTot Integral de tiempo durante un periodo
Atributos de punto
Nombre Descripcin
TagDesc Obtener el descriptor de un punto
TagEU Obtener la cadena de unidad de ingeniera de un punto
TagExDesc Obtener el descriptor ampliado de un punto
TagName Obtener el nombre de un punto
TagNum Obtener el ID de un punto
TagSource Obtener la cadena fuente de punto de un punto
TagSpan Obtener el rango de un punto
TagType Obtener el carcter de tipo de un punto
TagTypVal Obtener el valor tpico de un punto
TagZero Obtener el valor cero de un punto
Funciones de tiempo
Nombre Descripcin
Bod Marca de tiempo para el principio del da para un valor fecha/hora dado
Bom Marca de tiempo para el principio del mes para un valor fecha/hora
dado
Bonm Marca de tiempo para el principio del mes prximo para un valor
fecha/hora dado
Day Da del mes de un valor fecha/hora
DaySec Segundos desde la medianoche de un valor fecha/hora
Hour Hora de un valor fecha/hora
Minute Minuto de un valor fecha/hora
Month Mes de un valor fecha/hora
Noon Marca de tiempo para el medioda local de un valor fecha/hora
ParseTime Convierte una cadena de caracteres en un valor fecha/hora
Second Segundo de un valor fecha/hora
Weekday Da de la semana de un valor fecha/hora
Year Ao de un valor fecha/hora
Yearday Da del ao de un valor fecha/hora

Respuesta dinmica
Nombre Descripcin
Arma Respuesta dinmica de un modelo de media mvil auto regresiva
Delay Introducir retardo de tiempo
MedianFilt Seleccionar el valor medio de series de tiempo
Impulse Respuesta dinmica caracterizada por forma de respuesta de impulso
Funciones de estado de alarma
Nombre Descripcin
AlmAckStat Cdigo de estado de reconocimiento de error
AlmCondition Nmero de cdigo de condicin para estado de alarma
AlmCondText Condicin de alarma en formato de texto
AlmPriority Nmero de prioridad de alarma
Funciones de cadena
Nombre Descripcin
Ascii Cdigo de carcter ASCII de un carcter
Char Cadena para cdigos de carcter ASCII
Compare Comparacin de dos cadenas
DigText Texto de un estado digital
Format Formato de un nmero en tipo numrico
InStr Instancia de una subcadena
LCase Conversin de todos los caracteres a minscula
Len Longitud de una cadena
Left Los primeros caracteres de una cadena
LTrim Eliminacin de espacios en blanco a la izquierda de una cadena
Mid Extraccin de una subcadena de una cadena
Right Los ltimos caracteres de una cadena
RTrim Eliminacin de espacios en blanco a la derecha de una cadena
Trim Eliminacin de espacios en blanco en ambos lados de una cadena
UCase Conversin de todos los caracteres a mayscula
Conversin de cadenas
Nombre Descripcin
Concat Concatenar dos o ms cadenas
String Cadena representando cualquier valor PI
Text Concatenacin de cadenas para una serie de argumentos de valores
PI
80
Entrada manual de funcin
Ejemplos de PI Expression
Nota: Estos ejemplos utilizan los delimitadores de tags : (dos puntos) y . (perodo).
Su PI System puede utilizar delimitadores distintos.
La expresin siguiente determina la suma del valor de sinusoid al cubo y el valor de

cdf144 dividido por 10.
(('sinusoid')^3 + 'cdf144'/10)
La expresin siguiente se evala como verdadera (distinta de cero) si el valor absoluto
del tag mytag es al menos 14,65.
(abs('my:tag') >= 14.65)
Cuando compare tags digitales, utilice el valor negativo del nmero de cdigo de estado
digital. Para tags digitales, utilice la propia cadena de estado digital. Por ejemplo:
('my:tag' = "Manual")
La siguiente expresin se evala como verdadera si el valor del tag sinusoid es menor
que 45 y la raz cuadrada del valor del tag vdf1002 es mayor que 2:
('sinusoid' < 45 and sqr('vd:f1002') > 2)
Expresiones de filtro
clculo).
sinusoid < 70
75).

PI DataLink proporciona herramientas que pueden utilizarse para crear grficamente
cualquier funcin PI DataLink. Los usuarios experimentados de Excel y PI tal vez
prefieran introducir las funciones directamente en la barra de frmulas de Excel.
Los siguientes temas son aplicables a las funciones PI DataLink cuando son introducidas
directamente de esta manera.

Uso de funciones de matriz
Al definir funciones de matriz siga estos pasos:

Seleccione un intervalo de salida apropiado para la matriz, basado en el nmero de
valores esperados.
Introduzca la funcin PI y sus argumentos en la barra de frmulas de Excel.
Coloque la funcin PI en las celdas de salida seleccionadas con la combinacin de
teclas Ctrl+Mays+Intro.
Para obtener ms informacin acerca de las funciones matriciales, consulte la ayuda en
lnea de Microsoft Excel.
Funciones matemticas
En una expresin de clculo tag, los operadores matemticos y las funciones actan sobre
los nombres de tags. Las funciones matemticas admitidas son:
abs valor absoluto
atn tangente del arco (ngulo devuelto en radiantes)
cos coseno (argumento en radiantes)
exp e (2,71828...) elevado a una potencia
int parte entera de un nmero
log logaritmo natural
sgn funcin del signo (-1 si el argumento es negativo, 0 si es cero, 1 si es positivo)
sin seno (argumento en radiantes)
sqr funcin de raz cuadrada
tan tangente (argumento en radiantes)
Por ejemplo, la expresin siguiente encuentra la diferencia entre el logaritmo natural del
valor del tag cdep158 y el coseno del valor del tag cdep158.
(log('cdep158') - cos('cdep158'))
Argumentos de cadena
Todos los argumentos deben estar encerrados 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 PI Server
casaba.
82
Referencias de celda
Puede utilizar referencias de celda para cualquier argumentos de las funciones PI

DataLink. Por ejemplo, la siguiente funcin:
=PICurrVal(A1, A2, A3)
produce el mismo resultado que la definicin de la funcin
=PICurrVal("sinusoid", 1, "casaba")
si los tres mismos argumentos se almacenan en las celdas A1, A2 y A3, respectivamente.
Argumento de PIServer
El argumento PIServer es opcional siempre que el PIServer deseado sea especificado

como predeterminado en PI > Conexiones.
Por ejemplo, para recuperar el valor actual para el tag sinusoid del servidor PI
predeterminado, introduzca:
=PICurrVal("sinusoid",0,)
en un rango de salida de 1x1.
Cdigos de salida
La sintaxis de funciones DataLink incluye argumentos de cdigo de salida integer. Los

cdigos de salida determinan cmo son devueltos los datos aadidos (pgina 16) y la
orientacin de las celdas de salida.
Los cdigos de salida son generados automticamente por los cuadros de dilogo y los
paneles de tareas. Sin embargo, si introduce una funcin manualmente en la barra de
funciones de Excel, tendr que calcular e incluir los valores de cdigos de salida
adecuados.
Un cdigo de salida de una funcin es una representacin decimal de los bits binarios. En
PI DataLink, los bits tienen los siguientes significados:
bit 1: Mostrar marcas de tiempo
bit 2: Orientacin (columnas/filas)
bit 3: Mostrar porcentaje correcto
bit 4: Ocultar cuenta
bit 5: Mostrar estado extendido
bit 6: Mostrar anotaciones
bit 7: Mostrar hora de inicio
bit 8: Mostrar hora de finalizacin
bit 9: Mostrar tiempo mn/mx

Por ejemplo, un cdigo de salida 0 en una funcin PICurrVal() produce un valor

snapshot actual en la celda de salida designada. Un cdigo de salida 1 coloca una marca
de tiempo en la columna uno y el valor snapshot en la columna dos de una matriz de 1 x
2. Un cdigo de salida 2 coloca una marca de tiempo en la file uno y el valor snapshot en
la fila dos de una matriz de 2 x 1.
La frmula usada para calcular el cdigo de salida correspondiente es:
Nota: Las funciones tienen distintos argumentos y cdigos de salida. Los que son
vlidos para una funcin no necesariamente son vlidos para otra. Consulte la
referencia de funciones (pgina 87) para ver las especificaciones de cdigo
de salida por funcin.
EJEMPLO
Supongamos que queremos que una funcin Datos calculados muestre el Porcentaje
correcto, la Hora de inicio, y la Hora mn/mx. Al mostrarse la Hora de inicio y la Hora
mn/mx, tambin tendremos que ajustar el bit Mostrar marcas de tiempo. La funcin
mostrada en la barra de funciones de Excel se parecer a:
=PICalcDat("sinusoid","y","t","1h","minimum", 1,
325,"piserver")
Nota: Si un cdigo de salida indica que una funcin debe mostrar varias columnas o
filas, pero solo aparece una, haga clic con el botn derecho y seleccione
Recalcular/redimensionar para actualizar la funcin.
Escribir datos en PI
Mientras que las funciones estndar de PI DataLink recuperan datos de un servidor PI,
una funcin permite escribir un valor de una hoja de clculo en un servidor PI. La funcin
macro de Excel PIPutVal() (pgina 117) sustituye un evento de archivo histrico PI con
una marca de tiempo coincidente con un nuevo valor proporcionado por el usuario.
PIPutVal() solo se puede ejecutar en una hoja de macros Excel 4.0 o en VBA
utilizando el mtodo application.run. Consulte el mdulo putval_code en el libro
piexam32.xls distribuido con PI DataLink y, en particular, los tags marcados PutVal y
el mdulo VBA PutVal_code, para ver un ejemplo de un mdulo VBA utilizado para
introducir funciones PI en una hoja de clculo.
84
Resolucin de problemas
Tenga en cuenta que VBA no reconoce las funciones PI DataLink, pero puede formular
una funcin como cadena de texto y despus ajustar la propiedad FormulaArray de un
intervalo de celdas al valor de la cadena de texto. De este modo, el cdigo VBA puede
comprobar los valores de celda de los resultados de las funciones PI. Esto produce los
mismos resultados que la entrada manual de funciones PI en el mismo intervalo de celdas.
Resolucin de problemas
Consulte las secciones siguientes si est teniendo dificultades con PI DataLink. Si estos
temas no contemplan o no resuelven el problema, consulte Soporte tcnico y recursos
(pgina 119) para obtener detalles de la conexin al soporte tcnico.
Men PI no disponible
Si no aparece un men PI despus de instalar PI DataLink, deber configurar

manualmente (pgina 3) el complemento para Excel, o reducir la configuracin de
seguridad (pgina 86) para complementos.
Algunas secuencias VBA escritas por el usuario en las hojas de clculo (o complementos)
de Excel se conocen para restablecer el men principal de Excel. En tales casos, el men
PI puede desaparecer incluso aunque el complemento PI DataLink est todava cargado, y
las funciones de matriz integradas de PI DataLink pueden funcionar incluso aunque el
propio men PI no est disponible. Reiniciar Excel suele corregir este problema.
Lmites de matriz y de celda
PI DataLink est sujeto a una limitacin de Excel en el nmero de elementos de la matriz

de clculos. El nmero mximo de valores que se pueden devolver para una funcin PI
nica es, por cada recuperacin:
65.536 para Excel XP-2003
1.048.576 para Excel 2007
El SDK de Excel utilizado por PI DataLink limita las cadenas a 255 caracteres de
longitud para Excel XP-2003, y las cadenas de entrada para expresiones de PI DataLink
en una celda referenciada no pueden exceder este lmite de 255 caracteres.
Del mismo modo, la salida de cadena, como las cadenas de nombres de tags PI, puede ser
truncada por PI DataLink a 255 caracteres.
Limitaciones de fila
PI DataLink 4.x puede utilizar el milln de filas de una hoja de clculo de Microsoft
Excel. Pueden recuperarse datos hasta este lmite con una o varias matrices de funcin.
Para recuperar cantidades muy grandes de datos de PI, los usuarios debern configurar el
parmetro ArcMaxCollect en sus servidores PI. El valor predeterminado es 150.000
filas.

Tenga en cuenta que una consulta puede exceder un lmite mximo incluso aunque
devuelva un nmero relativamente pequeo de valores. Lo que cuenta es el nmero real
de eventos llamados de los archivos PI. Por ejemplo, los valores del tag sinusoid
varan constantemente entre 0 y 100. Una consulta de valores de muestra de sinusoid cada
30 segundos durante un ao, con una expresin de filtro que excluya todos los valores
inferiores a 95, puede devolver un nmero relativamente pequeo de valores, pero se
recuperan muchos ms eventos de los archivos mientras se procesa la consulta.
Seguridad
La seguridad de Excel para complementos, controles ActiveX y macros le permiten

determinar los tipos de componentes que puede ejecutar dentro de Excel. Los diferentes
niveles de configuracin proporcionan los medios para desactivar, activar bajo demanda o
activar completamente estos tipos de objetos.
La configuracin de seguridad de Excel puede entrar en conflicto con algunas funciones
de PI DataLink:
DataLink es un complemento para Excel. La configuracin de seguridad que
desactiva los complementos impide que PI DataLink se cargue en Excel.
Los controles de trend (pgina 55) utilizan un control ActiveX firmado marcado
como seguro para su inicializacin y requieren cierto nivel de activacin para
controles ActiveX.
Las hojas de clculo PIPutVal (pgina 117) utilizan macros y requieren cierto nivel
de activacin de macros.
Si aplica con regularidad la seguridad de Excel a las hojas de clculo, o encuentra
problemas utilizando estas funciones de PI DataLink, deber reducir o eliminar la
configuracin de seguridad de Excel dependiendo de cmo prevea utilizar PI DataLink.
Para ms informacin sobre la seguridad de Excel, consulte los recursos y la ayuda en
lnea de Microsoft Excel.
86
Apndice B
Referencia de funciones de PI DataLink

Los cuadros de dilogo de funcin (XP-2003) o los paneles de tareas (2007) (pgina 12)
de PI DataLink se utilizan habitualmente para generar funciones de PI DataLink,
dependiendo la funcin resultante de las opciones y argumentos seleccionados. Estas
mismas funciones tambin pueden introducirse directamente (pgina 81) en la barra de
frmulas de Excel.
La siguiente referencia completa de las funciones admitidas por PI DataLink agrupa las
funciones por tipo. Cada tema describe las opciones de sintaxis completas, e indica cmo
utilizar los argumentos. En la mayora de los casos, se proporciona un ejemplo.
Funciones de valor nico

Las funciones de valor nico asocian un punto PI con un punto especfico en el tiempo, y
devuelven nicamente un valor de datos correspondiente a menos que se haga referencia a
una matriz de nombres de tag.
PICurrVal()
Recupera valores actuales de punto PI de la snapshot, utilizando la siguiente sintaxis:

PICurrVal(tagname, outcode, PIServer)
ARGUMENTOS
Argumento Valor
Tagname (cadena) El nombre o nombres de tag coincidentes con los puntos PI deseados.
outcode (entero) Un cdigo de salida para determinar la colocacin del resultado; 0, 1
2.
PIServer El servidor PI destino
(cadena)
VALORES DEVUELTOS
Cdigo Valor Marca de
de salida tiempo
0 celda de salida ninguno
1 columna derecha celda de salida
2 celda de salida fila superior

EJEMPLO
La siguiente frmula recupera el valor actual y la marca de tiempo correspondiente para
el tag let439 del servidor PI holden y coloca la marca de tiempo en la columna a la
izquierda del valor:
=PICurrVal("let439",1,"holden")
TEMAS RELACIONADOS
Valor actual (pgina 25)
PIArcVal()
Recupera valores archivados de punto PI correspondientes a tiempos especificados,

utilizando la siguiente sintaxis:
PIArcVal(tagname, timestamp, outcode, PIServer, mode)
ARGUMENTOS
Argumento Valor
tagname (cadena) El nombre o nombres de tag coincidentes con los puntos PI
deseados.
time stamp (cadena) La marca de tiempo correspondiente al valor de archivo histrico
outcode (entero) Un cdigo de salida para determinar la colocacin de los
resultados; 0, 1 2.
PIServer (cadena) El servidor PI destino
mode (cadena) El modo utilizado para determinar qu valores son recuperados.
DEVOLUCIONES
Cdigo Valor de archivo Marca de
de salida histrico tiempo
0 celda de salida
1 columna celda de salida
izquierda
EJEMPLO
La siguiente frmula recupera un valor interpolado para el tag cdep158 a las 7:20 pm
del 11 de diciembre de 1992 del servidor PI casaba:
=PIArcVal("cdep158","11-dec-92 19:20",0,
"casaba","interpolated")
TEMAS RELACIONADOS
88
Funciones de valor nico
PIExpVal()
Recupera un valor archivado de punto PI basado en una expresin, utilizando la siguiente

sintaxis:
PIExpVal(expression, timestamp, PIServer)
ARGUMENTOS
Argumento Valor
expression (cadena) Una expresin de clculo PI
time stamp (cadena) La marca de tiempo correspondiente al valor de archivo histrico
VALORES DEVUELTOS
Cdigo Valor de archivo Marca de
de salida histrico tiempo
0 celda de salida
1 columna celda de salida
izquierda
EJEMPLO
La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid del servidor PI
denominado thevax en la medianoche de ayer:
=PIExpVal("sqr('sinusoid')","y",0,"thevax")
TEMAS RELACIONADOS

Funciones de valor mltiple

Las funciones de valor mltiple asocian un punto PI con un intervalo de tiempo durante el
cual puede haber uno o ms valores correspondientes en distintos puntos en el tiempo..
PINCompDat()
Recupera un nmero de valores de punto PI correspondientes a una hora de inicio

especificada, utilizando la siguiente sintaxis:
PINCompDat(tagname, stime, numvals, outcode, PIServer, mode)
ARGUMENTOS
Argumento Valor

deseados.
stime (cadena) La hora de inicio para el intervalo de valores recuperados (en
formato de tiempo PI).
numvals (entero) El nmero de valores deseados (negativo si se cuenta hacia atrs
en el tiempo)
outcode (entero) Un cdigo de salida
mode (cadena) El mtodo para manejar valores en los lmites del intervalo de
tiempo
VALORES DEVUELTOS
La visualizacin de los resultados est determinada por un valor de cdigo de salida
(pgina 83).
EJEMPLO
La siguiente frmula recupera 10 puntos de datos comprimidos y las correspondientes
marcas de tiempo para el tag cdf144 , comenzando desde las 1:00 a.m. de esta maana
del PI Server predeterminado con el tipo de lmite Dentro:
=PINCompDat("cdf144","1:00",10,1,,"inside")
TEMAS RELACIONADOS
90
PINCompFilDat()
Recupera un nmero de valores de punto PI filtrados correspondientes a una hora de

inicio especificada, utilizando la siguiente sintaxis:
PINCompFilDat(tagname, stime, numvals, filtexp, filtcode,
outcode, PIServer, mode)
ARGUMENTOS
Argumento Valor
deseados.
numvals (entero) El nmero de valores deseados (negativo si se cuenta hacia atrs en
el tiempo)
filtexp (cadena) Una expresin de filtro utilizada para filtrar los resultados.
filtcode (entero) Un cdigo de filtro, 1 para denotar el estado Filtrado y 0 para
omitirlo.
PIServer (cadena) El servidor PI.
mode (cadena) El mtodo para manejar valores en los lmites del intervalo de tiempo
VALORES DEVUELTOS
(pgina 83).
EJEMPLO
La siguiente frmula recupera 10 puntos de datos comprimidos y las horas
correspondientes, comenzando a las 2:00 a.m. para el tag cdf144 mientras el tag
cdep158 es superior a 38:
=PINCompFilDat("cdf144","2:00",10,"'cdep158'>38",1,1,,)
El estado Filtrado se muestra para las horas si la condicin del filtro es falsa. Los datos
se recuperan del servidor PI predeterminado con el tipo de lmite Dentro.
TEMAS RELACIONADOS
expresin de filtro (pgina 75)

PICompDat()
Recupera valores de punto PI correspondientes a un intervalo de tiempo especificado,

utilizando la siguiente sintaxis:
PICompDat(tagname, stime, etime, outcode, PIServer, mode)
ARGUMENTOS
Argumento Valor
deseados.
etime (cadena) La hora de finalizacin para el intervalo (en formato de tiempo
PI)
mode (cadena) El mtodo para manejar valores en los lmites del intervalo de
tiempo
VALORES DEVUELTOS
(pgina 83).
EJEMPLO
La siguiente frmula recupera 10 puntos de datos comprimidos y las correspondientes
marcas de tiempo para el tag cdf144 comenzando desde las 1:00 a.m. a las 3:00 a.m. de
esta maana del PI Server predeterminado con el tipo de lmite Dentro:
=PICompDat("cdf144","1:00","3:00",1,,"inside")
TEMAS RELACIONADOS
92
PICompFilDat()
Recupera valores de punto PI filtrados correspondientes a un intervalo de tiempo

especificado, utilizando la siguiente sintaxis:
PICompFilDat(tagname, stime, etime, filtexp, filtcode, outcode,
PIServer, mode)
ARGUMENTOS
Argumento Valor
deseados.
stime (cadena) La hora de inicio para el intervalo de valores recuperados (en formato
de tiempo PI).
etime (cadena) La hora de finalizacin para el intervalo (en formato de tiempo PI)
filtexp (cadena) La expresin de filtro utilizada para filtrar los resultados
filtcode (entero) Un cdigo de filtro, 1 para devolver el estado Filtrado y 0 para omitirlo.
mode (cadena) El mtodo para manejar valores en los lmites del intervalo de tiempo
VALORES DEVUELTOS
(pgina 83).
EJEMPLO
La siguiente frmula recupera puntos de datos comprimidos y las horas correspondientes,
comenzando desde las 2:00 a.m. y finalizando a las 10:00 a.m. para el tag cdf144 si el
tag cdep158 es superior a 38:
=PICompFilDat("cdf144","2:00","10:00","'cdep158'>38",1,1,,)
El estado Filtrado se muestra para las horas si la condicin del filtro es falsa. Los datos se
recuperan del PI Server predeterminado con el tipo de lmite Dentro.
TEMAS RELACIONADOS

PISampDat()
Recupera valores de punto PI de muestra correspondientes a un intervalo de tiempo

especificado, utilizando la siguiente sintaxis:
PISampDat(tagname, stime, etime, interval, outcode, PIServer)
ARGUMENTOS
Argumento Valor
tagname (cadena) El nombre o nombres de tag coincidentes con los puntos PI deseados.
stime (cadena) La hora de inicio para el intervalo de muestreo (en formato de tiempo
PI).
etime (cadena) La hora de finalizacin para el intervalo (en formato de tiempo PI)
interval El intervalo entre valores de muestra (en formato de tiempo PI).
(cadena)
outcode (entero) Un cdigo de salida, 0, 1, 2 3.
PIServer El servidor PI destino
(cadena)
VALORES DEVUELTOS
Cdigo Valor de Marca de tiempo
de salida muestra
3 fila inferior celda de salida
Un cdigo de salida (pgina 83) 2 transpone la matriz de salida resultante de un cdigo de

salida 0. Un cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de
salida 1.
EJEMPLO
La siguiente frmula recupera datos de muestra para el tag ubicado en la celda B1, desde
la medianoche de ayer a la medianoche de hoy en intervalos de 3 horas:
=PISampDat(b1,"y","t","3h",1,)
Tambin se devuelven marcas de tiempo.
TEMAS RELACIONADOS
94
PISampFilDat()
Recupera valores de punto PI de muestra filtrados correspondientes a un intervalo de

tiempo especificado, utilizando la siguiente sintaxis:
PISampFilDat(tagname, stime, etime, interval, filtexp,
filtcode, outcode, PI Server)
ARGUMENTOS
Argumento Valor
deseados.
stime (cadena) La hora de inicio para el intervalo de muestreo (en formato de
tiempo PI).
etime (cadena) La hora de finalizacin en formato de tiempo PI
interval (cadena) El intervalo entre valores de muestra (en formato de tiempo PI).
filtcode (entero) Un cdigo de filtro, 1 para devolver el estado Filtrado y 0 para
omitirlo.
outcode (entero) Un cdigo de salida, 0, 1, 2 3.
VALORES DEVUELTOS
de salida muestra

salida 0 y el cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de
salida 1.
EJEMPLO
La siguiente frmula recupera datos de muestra para sinusoid en 11-Ene-97, 11-Ene-
97 1:00AM, 11-Ene-97 2:00AM y 11-Ene-97 3:00AM:
=PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,)
Las marcas de tiempo se muestran en column1 y los valores en column2. Para los valores
que no satisfacen la condicin de filtro en la celda A1 se devuelve el estado Filtered.
TEMAS RELACIONADOS

PIExpDat()
Recupera valores de puntos PI basados en una expresin, utilizando la siguiente sintaxis:

PIExpDat(expression, stime, etime, interval, outcode, PIServer)
ARGUMENTOS
Argumento Explicacin
stime (cadena) La hora de inicio para el intervalo de valores de muestra (en
etime (cadena) La hora de finalizacin (en formato de tiempo PI)
interval (cadena) El intervalo entre valores de muestra (en formato de tiempo PI).
outcode (entero) Un cdigo de salida para determinar la colocacin de los
resultados; 0, 1, 2 3.
VALORES DEVUELTOS
de salida muestra

salida 0 mientras que un cdigo de salida 3 transpone la matriz de salida resultante de un
cdigo de salida 1.
EJEMPLO
La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid del servidor
PI denominado thevax en intervalos de una hora, comenzando por la medianoche de
ayer hasta la medianoche de hoy:
=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")
Tambin muestra las marcas de tiempo.
TEMAS RELACIONADOS
expresin de clculo PI (pgina 75)
96
PITimeDat()
Recupera valores de punto PI de muestra correspondientes a una matriz de marcas de

tiempo especificadas, utilizando la siguiente sintaxis:
PITimeDat(tagname, timestamps, PIServer, mode)
ARGUMENTOS
deseados.
timestamps Una referencia a una matriz de marcas de tiempo en formato
(referencia) de tiempo PI.
mode (cadena) El modo utilizado para determinar qu valores recuperar
VALORES DEVUELTOS
Datos de muestra. Si las marcas de tiempo estn en una sola columna, los datos se
devuelven en una sola columna. Si las marcas de tiempo estn en una sola fila, los datos
se devuelven en una sola fila.
EJEMPLO
La siguiente frmula recupera datos temporizados interpolados para las horas ubicadas en
las celdas B1 a B12 para el tag mytag desde el PI Server predeterminado:
=PITimeDat("mytag",b1:b12,,"interpolated")
TEMAS RELACIONADOS

PITimeExpDat()
Recupera valores de punto PI basados en una expresin y correspondientes a una matriz

de marcas de tiempo especificadas, utilizando la siguiente sintaxis:
PITimeExpDat(expression, timestamps, PIServer)
ARGUMENTOS
timestamps Una referencia a una matriz de marcas de tiempo en formato
(referencia) de tiempo PI (aumentando o disminuyendo montonamente
para servidores PI 2).
VALORES DEVUELTOS
Datos de muestra. Si las marcas de tiempo estn en una sola columna, los datos se
devuelven en una sola columna. Si las marcas de tiempo estn en una sola fila, los datos
se devuelven en una sola fila.
EJEMPLO
La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid para las horas
ubicadas en las celdas B1 a B12 del servidor PI predeterminado:
=PITimeExpDat("sqr('sinusoid')",b1:b12,)
TEMAS RELACIONADOS
98
Funciones de clculo
Funciones de clculo
Las funciones de clculo calculan nuevos valores a partir de valores de punto PI
correspondientes a un intervalo de tiempo especfico.
PICalcVal()
Recupera un valor de punto PI calculado utilizando la siguiente sintaxis:

PICalcVal(tagname, stime, etime, mode, cfactor, outcode,
PIServer)
Nota: PICalcVal() es generado nicamente por el cuadro de dilogo Datos

calculados en las versiones XP-2003. Las versiones 2007 utilizan
PIAdvCalcVal().
ARGUMENTOS
tagname (cadena) El nombre o nombres de tag coincidentes con los puntos PI deseados
para el clculo
stime (cadena) La hora de inicio para el intervalo de clculo (en formato de tiempo PI).
mode (cadena) El tipo de clculo a utilizar para computar valores de punto.
cfactor (nmero) La unidad de tiempo de flujo para el tag origen, necesario para clculos
Total
outcode (entero) Un cdigo de salida; de 0 a 7, y no 3.
VALORES DEVUELTOS
El argumento cdigo de salida (pgina 83) afecta a la salida de la forma siguiente:
Si el cdigo de salida es 0, slo se devuelve el valor calculado.
Si el cdigo de salida es 1, se aplica lo siguiente:
Modo Columna 1 Columna 2 Columna 3
Total Valor total
Minimum Tiempo del valor mn. Valor mnimo
Maximum Tiempo del valor Valor mximo

mx.
Stdev Stdev. Valor
Range Tiempo del valor mn. Tiempo del valor Valor de rango
mx.
Average Valor de promedio
Count Valor de cuenta
Mean Valor de media

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

1 y los resultados se devuelven en filas en vez de en columnas.
El cdigo de salida 3 no se utiliza.
Si el cdigo de salida es 4, el porcentaje correcto se devuelve a la derecha de la celda
de valor.
Si el cdigo de salida es 5, se aplica lo siguiente:
Modo Columna 1 Columna 2 Columna 3 Columna 4
Total Valor total Porcentaje correcto
Minimum Tiempo del valor mn. Valor mnimo Porcentaje
correcto
Maximum Tiempo del valor mx. Valor mximo Porcentaje
correcto
Stdev Valor Stdev. Porcentaje correcto
Range Tiempo del valor mn. Tiempo del valor Valor de rango Porcentaje
mx. correcto
Average Valor de promedio Porcentaje correcto
Count Valor de cuenta Porcentaje correcto
Mean Valor de media Porcentaje correcto

EJEMPLO
La siguiente frmula calcula un total de tiempo ponderado para el tag cdf144 desde
ayer a hoy del PI Server predeterminado:
=PICalcVal("cdf144","y","t","total",1440,4,)
El resultado se multiplica por 1440. El porcentaje correcto se devuelve junto al total.
TEMAS RELACIONADOS
100
Funciones de clculo
PIAdvCalcVal()
Recupera un valor de punto PI calculado utilizando la siguiente sintaxis:

PIAdvCalcVal(tagname, stime, etime, mode, calcbasis,
minpctgood, cfactor, outcode, PIServer)
ARGUMENTOS
tagname (cadena) El nombre del tag coincidente con el punto PI deseado para el
clculo
stime (cadena) La hora de inicio para el intervalo de clculo (en formato de tiempo
PI).
calcbasis (string) El mtodo de ponderacin utilizado para calcular valores
minpctgood El mnimo porcentaje de datos correctos requerido para calcular y
(nmero) devolver un valor
cfactor (nmero) La unidad de tiempo de flujo para el tag origen, necesario para
clculos Total
outcode (entero) Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3.
VALORES DEVUELTOS
Consulte informacin especfica sobre cdigos de salida de PICalcVal() (pgina 99).
EJEMPLO
ayer a hoy del PI Server predeterminado:
=PIAdvCalcVal("cdf144","y","t","total","time-weighted",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.
TEMAS RELACIONADOS

PIAdvCalcFilVal()
Recupera un valor filtrado de punto PI calculado utilizando la siguiente sintaxis:

PIAdvCalcFilVal(tagname, stime, etime, filtexp, mode,
calcbasis, sampmode, sampfreq, minpctgood, cfactor, outcode,
PIServer)
ARGUMENTOS
deseados para el clculo
stime (cadena) La hora de inicio para el intervalo de clculo (en formato de
tiempo PI).
sampmode (string) El mtodo de muestreo utilizado para las expresiones de clculo
sampfreq (string) La frecuencia utilizada para el muestreo interpolado
minpctgood (nmero) El mnimo porcentaje de datos correctos requerido para calcular y
devolver un valor
Cfactor (nmero) La unidad de tiempo de flujo para el tag origen, necesario para
clculos Total
VALORES DEVUELTOS
EJEMPLO
ayer a hoy durante los periodos de tiempo en los que el tag cdm158 se encuentra en
Manual en el PI Server predeterminado:
=PIAdvCalcFilVal("cdf144","y","t","'cdm158'=""Manual""","total"
,"time-weighted","pt. compressed","10m",50,1,4,)
El resultado se multiplica por 1. Puesto que point compressed es el modo de muestreo
especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin
de filtro en los eventos comprimidos de cdf144. El minpctgood es del 50 por ciento,
por lo que nicamente se mostrar el resultado si el porcentaje correcto es del 50% o
superior. El porcentaje correcto se devuelve junto al total.
TEMAS RELACIONADOS
102
Funciones de clculo
PIAdvCalcExpVal()
Recupera un valor de punto PI calculado basado en una expresin, utilizando la siguiente

sintaxis:
PIAdvCalcExpVal(expression, stime, etime, mode, calcbasis,
sampmode, sampfreq, minpctgood, cfactor, outcode, PIServer)
ARGUMENTOS
PI).
devolver un valor
clculos Total
VALORES DEVUELTOS
EJEMPLO
La siguiente frmula calcula un total de tiempo ponderado para la expresin 'cdf144'+'
cdt158' desde ayer a hoy del servidor PI predeterminado:
=PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total","time-
weighted","compressed","10m",50,1,4,)
El resultado se multiplica por 1. Puesto que compressed es el modo de muestreo
especificado, se ignora la frecuencia de muestreo y se realiza una muestra de la expresin
de en los eventos comprimidos combinados de cdf144 y cdt158. El minpctgood es
del 50 por ciento, por lo que nicamente se mostrar el resultado si el porcentaje correcto
es del 50% o superior. El porcentaje correcto se devuelve junto al total.
TEMAS RELACIONADOS

PIAdvCalcExpFilVal()
Recupera un valor filtrado de punto PI calculado basado en una expresin, utilizando la

siguiente sintaxis:
PIAdvCalcExpFilVal(expression, stime, etime, filtexp, mode,
PIServer)
ARGUMENTOS
PI).
devolver un valor
clculos Total
VALORES DEVUELTOS
EJEMPLO
cdt158' cuando 'productid' = "Product2" desde ayer a hoy del PI Server
predeterminado:
=PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'="P
roduct2"","total","time-weighted","compressed","10m",50,1,4,)
TEMAS RELACIONADOS
104
Funciones de clculo
PICalcDat()
Recupera valores de puntos PI calculados utilizando la siguiente sintaxis:

PICalcDat(tagname, stime, etime, interval, mode, cfactor,
outcode, PIServer)
Nota: PICalcDat() es generado nicamente por el cuadro de dilogo Datos

calculados en las versiones XP-2003. Las versiones 2007 utilizan
PIAdvCalcDat().
ARGUMENTOS
PI).
interval (cadena) El intervalo entre valores calculados (en formato de tiempo PI).
clculos Total
outcode (entero) Un cdigo de salida, de 0 a 7.
VALORES DEVUELTOS
El argumento cdigo de salida (pgina 83) afecta a la salida de la forma siguiente:
0 produce valores calculados en una columna
1 produce marcas de tiempo y valores en 2 columnas
2 produce valores calculados en una fila
3 produce marcas de tiempo y valores en 2 filas
4 produce valores y porcentajes correctos en 2 columnas
5 produce marcas de tiempo, valores y porcentajes correctos en 3 columnas
6 produce valores y porcentajes correctos en 2 filas
7 produce marcas de tiempo, valores y porcentajes correctos en 3 filas
EJEMPLO
La siguiente frmula recupera totales para el tag ubicados en la celda B1, desde la media
noche de ayer a la media noche de hoy en intervalos de 3 horas del PI Server
predeterminado:
=PICalcDat(b1,"y","t","3h","total",24,1,)
Tambin se devuelven marcas de tiempo. Los valores se multiplican por 24 antes de
mostrarse en la hoja de clculo.
TEMAS RELACIONADOS

PIAdvCalcDat()
Recupera valores de puntos PI calculados utilizando la siguiente sintaxis:

PIAdvCalcDat(tagname, stime, etime, interval, mode, calcbasis,
minpctgood, cfactor, outcode, PIServer)
ARGUMENTOS
PI).
minpctgood El mnimo porcentaje de datos correctos requerido para calcular y
(nmero) devolver un valor
clculos Total
VALORES DEVUELTOS
Consulte informacin especfica sobre cdigos de salida de PICalcDat() (pgina 105).
EJEMPLO
La siguiente frmula recupera totales para el tag cdf144 desde la media noche de ayer a
la media noche de hoy en intervalos de 3 horas del servidor predeterminado PI:
=PIAdvCalcDat("cdf144","y","t","3h","total","time-
weighted",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.
TEMAS RELACIONADOS
106
Funciones de clculo
PIAdvCalcFilDat()
Recupera valores filtrados de puntos PI calculados utilizando la siguiente sintaxis:

PIAdvCalcFilDat(tagname, stime, etime, interval, filtexp, mode,
PIServer)
ARGUMENTOS
tiempo PI).
devolver un valor
clculos Total
VALORES DEVUELTOS
EJEMPLO
La siguiente frmula recupera totales para el tag cdf144 desde la media noche de ayer a
la media noche de hoy en intervalos de 3 horas durante los periodos temporales en los que
el tag cdf144 se encuentra en Manual en el servidor PI predeterminado:
=PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""","t
otal","time-weighted","pt. compressed","10m",50,1,4,)
El resultado se multiplica por 1. Puesto que point compressed es el modo de muestreo
especificado, se ignora el intervalo de muestreo y se realiza una muestra de la expresin
de filtro en los eventos comprimidos de cdf144. El porcentaje correcto se devuelve
junto al total.
TEMAS RELACIONADOS

PIAdvCalcExpDat()
Recupera valores de puntos PI calculados basados en una expresin, utilizando la

siguiente sintaxis:
PIAdvCalcExpDat(expression, stime, etime, interval, mode,
PIServer)
ARGUMENTOS
tiempo PI).
devolver un valor
clculos Total
VALORES DEVUELTOS
EJEMPLO
La siguiente frmula recupera totales para la expresin 'cdf144'+'cdt158' desde la
media noche de ayer a la media noche de hoy en intervalos de 3 horas del servidor
predeterminado PI:
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total","time
-weighted","compressed", "10m",50,1,4,)
TEMAS RELACIONADOS
108
Funciones de clculo
PIAdvCalcExpFilDat()
Recupera valores filtrados de puntos PI calculados basados en una expresin, utilizando

la siguiente sintaxis:
PIAdvCalcExpFilDat(expression, stime, etime, interval, filtexp,
mode, calcbasis, sampmode, sampfreq, minpctgood, cfactor,
outcode, PIServer)
ARGUMENTOS
tiempo PI).
devolver un valor
clculos Total
VALORES DEVUELTOS
EJEMPLO
cdt158' cuando 'productid' = "Product2" en intervalos de 3 horas desde ayer a
hoy del PI Server predeterminado:
=PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'producti
d'="Product2"","total","time-
weighted","compressed","10m",50,1,4,)
TEMAS RELACIONADOS

PITimeFilter()
Devuelve la cantidad de tiempo sobre intervalos especificados durante la que una

expresin de punto PI es evaluada como verdadera, utilizando la siguiente sintaxis:
PITimeFilter(expression, stime, etime, interval, timeunit,
outcode, PIServer)
ARGUMENTOS
tiempo PI).
interval (cadena) El intervalo entre evaluaciones (en formato de tiempo PI).
timeunit (cadena) Unidad de tiempo del resultado calculado (en formato de tiempo
PI).
VALORES DEVUELTOS
Cdigo Columna 1 Columna 2
de salida
0 Datos calculados
1 Marcas de tiempo Datos calculados

salida 0 y el cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de
salida 1.
EJEMPLO
La siguiente frmula calcula la cantidad de tiempo que la expresin de la celda $A$1 es
verdadera para el PI Server denominado thevax en intervalos de 1 hora, comenzando en
la medianoche de ayer hasta la medianoche de hoy:
=PITimeFilter($A$1,"y","t","1h","seconds",1,"thevax")
Tambin muestra las marcas de tiempo para la hora de inicio de cada intervalo de clculo.
El resultado del clculo se expresa en segundos.
TEMAS RELACIONADOS
110
Funciones de clculo
PITimeFilterVal()
Devuelve la cantidad de tiempo durante la que una expresin de punto PI es evaluada

como verdadera para un intervalo de tiempo especificado, utilizando la siguiente sintaxis:
PITimeFilterVal(expression, stime, etime, timeunit, outcode,
PIServer)
ARGUMENTOS
PI).
timeunit (cadena) Unidad de tiempo del resultado calculado (en formato de tiempo
PI).
DEVOLUCIONES
Si el cdigo de salida (pgina 83) es 0, 1 2, slo se devuelve el valor calculado.
El cdigo de salida 3 no se utiliza.
Si el cdigo de salida es 4 o 5, el porcentaje correcto se devuelve a la derecha de la
celda de valor.
Si el cdigo de salida es 6 o 7, el porcentaje correcto se devuelve a la derecha de la
celda de valor.
EJEMPLO
La siguiente frmula calcula la cantidad de tiempo que la expresin de la celda $A$1 es
verdadera para el PI Server denominado thevax, comenzando en la medianoche de ayer
hasta la medianoche de hoy:
=PITimeFilterVal($A$1,"y","t","seconds",1,"thevax")
El resultado del clculo se expresa en segundos.
TEMAS RELACIONADOS

Funciones de tags
PIPointIDToTag()
Recupera un nombre de tag correspondiente a un ID de punto PI, utilizando la siguiente

sintaxis:
PIPointIDToTag(pointid, PIServer)
ARGUMENTOS
PointID (cadena) In ID de punto PI, que es un ID interno nico no reutilizado tras la
eliminacin de un punto
VALORES DEVUELTOS
Nombre de tag
EJEMPLO
La siguiente frmula devuelve el nombre de tag del tag con ID de punto 123 del servidor
denominado thevax.
=PIPointIDToTag("123","thevax")
TEMAS RELACIONADOS
Identificador del punto para tag (pgina 41)
112
Funciones de tags
PIAttributeMaskToTag ()
Recupera un nombre de tag correspondiente a uno o ms atributos de punto, utilizando la

siguiente sintaxis:
PIAttributeMaskToTag(tagname, descriptor, pointsource,
pointtype, pointclass, engunits, outcode, PIServer)
ARGUMENTOS
tagname (cadena) Mscara de nombre del tag
descriptor (cadena) Mscara de descriptor
pointsource (cadena) Mscara de fuente del punto
pointtype (cadena) Mscara de tipo de punto
pointclass (cadena) Mscara de clase de punto.
engunits (cadena) Mscara de unidades
outcode (entero) Un cdigo de salida, 0 2.
VALORES DEVUELTOS
de salida
0 Nombre de
tag
Un cdigo de salida (pgina 83) 2 transpone la matriz de salida que resulta de un cdigo
de salida 1.
EJEMPLO
La siguiente frmula devuelve el nombre de tag de los tags que empiezan por "sin" en el
servidor denominado thevax.
=PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")
TEMAS RELACIONADOS
Mscara de atributo para tag (pgina 41)

PITagAtt()
Recupera el valor de un atributo de tag basndose en el nombre del tag, utilizando la

siguiente sintaxis:
PITagAtt(tagname, attribute, PIServer)
ARGUMENTOS
tagname (cadena) El nombre o nombres de tag coincidentes con los atributos
deseados.
attribute (cadena) El atributo de punto PI deseado
VALORES DEVUELTOS
Valor de atributo del tag
EJEMPLO
La siguiente frmula recupera del servidor PI predeterminado las unidades de ingeniera
para el tag situado en la celda D1:
=PITagAtt(d1,"units",)
TEMAS RELACIONADOS
Atributos del tag (pgina 42)
114
PIAliasToTag()
Recupera un nombre de tag basado en un alias de punto PI, utilizando la siguiente

sintaxis:
PIAliasToTag(alias, modulepath, querydate, outcode, PIServer)
ARGUMENTOS
alias (cadena) El alias de la base de datos de mdulos correspondiente al punto
PI deseado.
modulepath La ruta de mdulo completa al alias
(cadena)
querydate (entero) Una fecha lmite tal que solo son devueltos los alias creados en ella
o despus
Outcode (entero) Un cdigo de salida, 0, 1 2
VALORES DEVUELTOS
de salida
0 Nombre de
tag
1 Nombre de Servidor de tag
tag
Un cdigo de salida (pgina 83) 2 transpone la matriz de salida que resulta de un cdigo
de salida 1.
EJEMPLO
La siguiente frmula devuelve el nombre de tag correspondiente al alias Temperature del
mdulo Reactor1 que es un submdulo de Unit1. Unit1 est en la raz de la base de datos
de mdulos de un servidor PI denominado thevax. La base de datos de mdulos se
consulta a la hora actual.
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")
TEMAS RELACIONADOS
Alias para tag (pgina 47)

PIPropertyToValue()
Recupera el valor de una propiedad de punto PI especificado, utilizando la siguiente

sintaxis:
PIPropertyToValue(property, modulepath, querydate, PIServer,
outcode)
ARGUMENTOS
Property (cadena) La propiedad de la base de datos de mdulos correspondiente al
punto PI deseado.
modulepath La ruta de mdulo completa a la propiedad
(cadena)
querydate (entero) Una fecha lmite tal que solo son devueltas las propiedades creadas
en ella o despus
Outcode (entero) Un cdigo de salida, 0, 1 2
VALORES DEVUELTOS
Un cdigo de salida (pgina 83) 0 muestra el valor de la propiedad en una columna.
Un cdigo de salida 2 muestra el valor de la propiedad en una fila.
EJEMPLO
La siguiente frmula devuelve el valor correspondiente a la propiedad Implementer del
mdulo Reactor1 que es un submdulo de Unit1. Unit1 est en la raz de la base de datos
de mdulos de un servidor PI denominado thevax. La base de datos de mdulos se
consulta a la hora actual.
=PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax"
)
TEMAS RELACIONADOS
Propiedad para valor (pgina 48)
116
Funciones de entrada
Funciones de entrada
PIPutVal()
PIPutVal(tagname, value, time stamp, PIServer, outcell)
PIPutVal admite todos los tipos de datos de PI 3 (incluida la entrada de cadenas en tags
de cadena), as como datos de los subsegundos. Las marcas de tiempo se interpretan
utilizando la informacin de la zona horaria del ordenador cliente para PI 3 a menos que
est activado Utilizar zona horaria de PI Server.
ARGUMENTOS
tagname (cadena) El tag para el que se escribe el valor en PI
value (referencia) La referencia a un valor para ser escrito, ya sea una cadena
(para estados digitales) o un nmero.
time stamp (cadena) Una marca de tiempo en formato de tiempo PI
outcell (referencia) Una referencia a una celda en la que se muestra el valor devuelto
de esta funcin de macro
VALORES DEVUELTOS
Devuelve el valor de cadena Falso si la funcin macro falla y escribe un mensaje de error
en la celda de salida. Si la escritura en el PI Server tiene xito , se devuelve la cadena
Verdadero y se escribe el estado en la celda de salida.
Nota: PIPutVal() no verifica antes de escribir el intervalo especificado por el

usuario para un tag. El intervalo se define desde zero a zero + span, en
donde zero y span son atributos de tag especificados durante la creacin del
punto (tag). DataLink devuelve un valor incluso aunque puedan introducirse
en PI Over Range o Under Range.
EJEMPLO
La siguiente frmula coloca el valor situado en la celda A5 en el servidor PI del servidor
PI predeterminado a medianoche de hoy para el tag testtag:
=PIPutVal("testtag",a5,"t",,e5)
El resultado de la funcin de macros se coloca en la celda E5 de la hoja de macros.

Apndice C
Soporte tcnico y recursos

Puede leer toda la informacin acerca de las opciones de soporte tcnico y acceder a los
siguientes recursos en el sitio web Soporte Tcnico OSIsoft:
http://techsupport.osisoft.com
Antes de llamar o escribir solicitando ayuda
Cuando se ponga en contacto con Soporte tcnico OSIsoft, deber facilitar:

El nombre del producto, los nmeros de versin y/o compilacin
La plataforma del equipo (tipo de CPU, sistema operativo y nmero de versin)
La hora en la que comenz el problema
Los archivos de registro en ese momento
Asistencia y soporte telefnico
El equipo de Soporte tcnico de OSIsoft est a su disposicin 24 horas al da. Consulte en

la siguiente tabla el nmero de telfono oportuno para su zona. Al marcar uno de estos
nmeros, su llamada ser dirigida a la cola de soporte global y le atender un miembro de
nuestra red mundial de ingenieros.
Ubicacin de oficina Nmero de acceso Opciones de idioma local
San Leandro, CA (EE. UU.) 1 510 297 5828 Ingls
Filadelfia, PA (EE. UU.) 1 215 606 0705 Ingls
Johnson City, TN (EE. UU.) 1 423 610 3800 Ingls
Montreal, QC (Canad) 1 514 493 0663 Ingls y francs
So Paulo (Brasil) 55 11 3053 5040 Ingls y portugus
Frankfurt (Alemania) 49 6047 989 333 Ingls y alemn
Manama (Bahrin) 973 1758 4429 Ingls y rabe
Singapur 65 6391 1811 Ingls y chino mandarn
86 021 2327 8686 Mandarn
Perth, WA (Australia) 61 8 9282 9220 Ingls

Soporte tcnico y recursos
El soporte puede brindarse en idiomas distintos del ingls en determinados centros

(enumerados arriba), en funcin de la disponibilidad de los agentes. Si selecciona una
opcin de idioma local, haremos todo lo posible para que le atienda un ingeniero de
soporte tcnico (TSE) que hable dicho idioma. Si no hay ninguno disponible, le atender
el primer ingeniero que quede libre.
Si todos los TSE estn ocupados con otros clientes en el momento de su llamada, se le
solicitar que se mantenga en espera hasta que un tcnico pueda atenderle o que deje un
mensaje en el buzn de voz. Si decide dejar un mensaje, conservar su puesto en la cola.
Su mensaje de voz recibir el mismo tratamiento que una llamada ordinaria y ser
dirigido al primer TSE disponible.
Si su llamada guarda relacin con un caso abierto, facilite el nmero de referencia
correspondiente para que podamos transferirle al ingeniero asignado en ese momento al
caso. Si ese ingeniero no est disponible, le atender otro miembro del equipo.
Bsquedas de soporte
Desde el sitio Web de Soporte Tcnico de OSIsoft, haga clic en Bsquedas de soporte.
Gracias al motor de bsqueda SharePoint de Microsoft, puede buscar de forma rpida y
sencilla en las soluciones de soporte, la documentacin y las noticias del sitio web de
Soporte tcnico de OSIsoft.
Soporte tcnico por correo electrnico
techsupport@osisoft.com
Al contactar con Soporte tcnico de OSIsoft, le recomendamos que aporte la siguiente
informacin:
Descripcin del problema: breve descripcin del problema, sntomas, mensajes
informativos o de error e historial del problema.
Archivos de registro: Consulte la documentacin del producto para obtener
informacin sobre cmo obtener los registros pertinentes de la situacin.
Soporte tcnico en lnea
Desde el sitio Web de Soporte Tcnico de OSIsoft, haga clic en Contactarnos > Mi
soporte > Mis llamadas.
Mediante el Soporte tcnico en lnea de OSIsoft, usted puede:
Introducir una llamada nueva directamente en la base de datos de OSIsoft
(supervisada 24 horas al da);
Ver o editar llamadas a OSIsoft introducidas por usted;
Ver cualquier llamada introducida por su organizacin o sitio, si se ha activado esta
opcin;
Consultar su software con licencia y las fechas de sus acuerdos de servicio del
Service Reliance Program.
120
Acceso remoto
Desde el sitio Web de Soporte Tcnico de OSIsoft, haga clic en Contactarnos >
Opciones de soporte remoto.
Los ingenieros de soporte de OSIsoft pueden acceder de forma remota a su servidor para
facilitarle asistencia directa. Consulte en la pgina Acceso remoto los detalles de los
distintos mtodos disponibles para ello.
Asistencia a domicilio
Desde el sitio Web de Soporte Tcnico de OSIsoft, haga clic en Contactarnos > Visita
de servicio a domicilio.
OSIsoft ofrece un servicio de soporte a domicilio cobrando una cuota. Visite nuestra
pgina Visita de servicio a domicilio si desea ms informacin.
Centro de conocimiento
Desde el sitio Web de Soporte Tcnico de OSIsoft, haga clic en Centro de conocimiento.
El Centro de conocimiento proporciona una biblioteca de bsqueda de documentos y
datos tcnicos, as como una recopilacin especial de recursos para los administradores
del sistema. Haga clic en Centro de conocimiento en el sitio web de Soporte tcnico para
acceder a estas opciones.
La funcin Buscar permite encontrar soluciones de soporte, noticias, pginas de
soporte tcnico, problemas conocidos, mejoras y documentacin (que incluyen
manuales del usuario, notas de la versin y notas del producto).
Los recursos del administrador del sistema incluyen herramientas e instrucciones que
le ayudan a tratar: el tamao de los archivos histricos, las copias de seguridad de las
secuencias de comandos, el mantenimiento diario, la configuracin de horario de
verano, la seguridad del servidor PI, el tamao y la configuracin del PI System, los
PI Trusts de los nodos de interfaz y mucho ms.
Actualizaciones
Desde el sitio Web de Soporte Tcnico de OSIsoft, haga clic en Contactarnos > Obtener
actualizaciones.
Usted tiene derecho a descargar o solicitar cualquier versin disponible de un producto
para el que haya suscrito un Service Reliance Program (SRP), anteriormente conocido
como Tech Support Agreement (TSA). Si desea comprobar o modificar su estado de SRP,
pngase en contacto con su representante de ventas o con Soporte tcnico
(http://techsupport.osisoft.com/) para recibir asistencia.

Index
formatos de nmero - 15, 19, 21
A formatos de tiempo - 15, 71
formatos, tiempo y nmero - 15, 19
acceso de datos - 70
frecuencia de muestreo de expresin - 33
Acceso de puntos - 70
funcin Alias para tag - 47
actualizar, datos - 50
funcin Atributos del tag - 43
automtico - 50
funcin Datos calculados - 33
manual - 51
funcin Datos calculados avanzados - 33
Ajustes - 21
funcin Datos comprimidos - 27
anotaciones, mostrar - 19
funcin Datos de muestra - 30
apstrofe, uso en Excel - 13, 14
funcin Datos temporizados - 31
argumento outcode - 81, 83
funcin Filtrado de tiempo - 37
argumento, funcin de PI DataLink - 14
funcin Identificador del punto para tag - 41
argumentos de tiempo - 15
funcin Mscara de atributo para tag - 42
atrs en el tiempo - 27
funcin Propiedad para valor - 48
atributos de valor, mostrar - 19
funcin Valor actual - 25
average - 33
funcin Valor de archivo histrico - 26
funciones - 25, 47, 49
B
Actualizar los datos PI en una hoja de clculo -
base de clculo - 33 49
Bsqueda de tags - 39 Cuadros de dilogo - 87
cuadros de dilogo de funciones - 10
C definir - 8, 10, 12
Cadenas de tiempo PI - 71 Excel - 12
clculo de expresiones - 75 Introduciendo en Excel - 81
Campos de resultados - 14 modificar - 53
celdas, hoja de clculo paneles de tareas de funciones - 8
referencias - 13, 14 funciones de tags - 41
valores de funcin - 51
comilla simple - 13, 14 H
Complemento, Excel - 1, 9 hojas de clculo - 49
Conexiones - 11
conexiones del servidor PI - 11 I
controles de orientacin - 19
instalacin - 69
configurar Excel: - 3
D
instalacin silenciosa - 69
desviacin estndar - 33 intervalo de tiempo - 26
Intervalo de tiempo - 30
E
errores - 85 M
explorar - 47 marcas de tiempo - 16, 17
expresiones matriz, funcin - 50, 51, 52
clculo PI - 75 Men PI - 8, 9
filtro - 81 Microsoft Excel - 3
sintaxis - 74 modo de clculo - 33
expresiones de clculo PI - 75 modo de muestreo de expresin - 33
expresiones de filtro - 81 modo de recuperacin - 31
Module Database, buscar - 45
F mostrar anotaciones - 19
factor de conversin - 33 mostrar atributos de valor - 19

Index
mostrar marca de tiempo - 17 resolucin de problemas - 85

mostrar porcentaje correcto - 18
mover matrices de funcin - 52 S
Soporte tcnico OSIsoft - 119
N
notificaciones, PI system - 63 T
tamao de matriz - 53
O tipo de lmite - 27
operadores - 74 Totales - 33
trend - 55
P
performance equations - 75
PI DataLink - 1
instalacin - 69
interfaz - 7
para Excel Services - 2
PI Module Database - 45
explorar - 47
funciones - 47
PI Notifications - 63
PI SDK - 2
PIAdvCalcDat - 106
PIAdvCalcExpDat - 108
PIAdvCalcExpFilDat - 109
PIAdvCalcExpFilVal - 104
PIAdvCalcExpVal - 103
PIAdvCalcFilDat - 107
PIAdvCalcFilVal - 102
PIAdvCalcVal - 101
PIAliasToTag - 115
PIArcVal - 88
PICalcDat - 105
PICalcVal - 99
PICompDat - 92
PICompFilDat - 93
PICurrVal - 87
PIExpDat - 96
PIExpVal - 89
PINCompDat - 90
PINCompFilDat - 91
PIPropertyValue - 116
PIPutVal - 117
PISampDat - 94
PISampFilDat - 95
PITagAtt - 114
PITimeDat - 97
PITimeExpDat - 98
PITimeFilter - 110
PITimeFilterVal - 111
porcentaje correcto mnimo - 33
R
referencias de celda - 13
124

PI Datalink 2010 User Guide ES PDF

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

PI Datalink 2010 User Guide ES PDF

Cargado por

Copyright:

Formatos disponibles

Manual del usuario de PI DataLink

Tel: (01) 510-297-5800Fax: (01) 510-357-8136

OSIsoft Australia Perth, Australia

Copyright: <COPYRIGHT_FECHA> OSIsoft, LLC. Todos los derechos reservados.

DERECHOS DEL GOBIERNO DE LOS EE.UU.

Captulo 2 Conceptos bsicos .....................................................................................................7

Captulo 3 Funciones PI..............................................................................................................25

Captulo 4 Tags PI y atributos ....................................................................................................39

Captulo 5 Objetos de Module Database...................................................................................45

Captulo 6 Hojas de clculo........................................................................................................49

Captulo 7 Pantallas de tendencias ...........................................................................................55

Manual del usuario de PI DataLink iii

Apndice A Informacin complementaria ................................................................................69

Apndice B Referencia de funciones de PI DataLink ..............................................................87

Apndice C Soporte tcnico y recursos .................................................................................119

En su sistema se encuentran instaladas dos ediciones de PI DataLink:

Manual del usuario de PI DataLink 1

PI SDK se instala con PI DataLink y conecta PI DataLink con su servidor PI para

PI DataLink for Excel Services (DLES)

Compatibilidad con idiomas de PI DataLink

Esta versin de PI DataLink proporciona compatibilidad con varios idiomas. La interfaz

Requisitos del sistema

Microsoft Excel 2007

Manual del usuario de PI DataLink 3

Microsoft Excel XP-2003

2. Si el complemento PI DataLink no aparece en la lista, haga clic en Examinar para

Acerca de este documento

Manual del usuario de PI DataLink 5

El siguiente apartado describe las diferencias visuales y de funcionamiento entre los

Manual del usuario de PI DataLink 7

PI DataLink para Excel 2007

PI DataLink para Excel 2007 incluye elementos de diseo presentados en Microsoft

El men de cinta es un men grfico que combina funciones de un men estndar y de

Paneles de tareas de funciones

Un panel de tareas es un panel de controles movible y apilable que funciona

Nota: Puede desactivar la aparicin automtica (pgina 20) de paneles de tareas si

Una vez que est abierto un panel de tareas de funcin:

PI DataLink para Excel XP-2003

Manual del usuario de PI DataLink 9

PI DataLink para Excel XP-2003 utiliza un men estndar de configuracin:

Cuadros de dilogo de funcin

PI DataLink abre el correspondiente cuadro de dilogo cuando se aade o edita una

Una vez que est abierto un cuadro de dilogo de funcin:

PI DataLink aade varios comandos al men contextual estndar de Microsoft Excel.

Para mostrar el men contextual:

Conexiones del servidor PI

Manual del usuario de PI DataLink 11

Para gestionar la configuracin de la conexin:

Componentes de funciones grficas

Los usuarios avanzados familiarizados con PI DataLink y el PI Server pueden

Introducir texto directamente en un campo de edicin , por

Hacer referencia a celdas de hoja de clculo que contienen argumentos,

Nota: Asegrese de introducir con un apstrofe delante (') cadenas en las

Seleccionar valores de un servidor PI o de otras fuentes mediante una

Nota: Algunos campos de entrada muestran una entrada predeterminada cuando el

Manual del usuario de PI DataLink 13

Algunos argumentos son comunes a la mayora de los cuadros de dilogo o paneles de

Nombre(s) de tag o Expresin

Seleccionado en el cuadro de dilogo Bsqueda de tags (pgina 39), basado en una

Muchas funciones de PI DataLink requieren argumentos Hora de inicio y Hora de

Manual del usuario de PI DataLink 15

Nota: PI DataLink solo admite el sistema predeterminado de fecha de 1900 admitido

Matriz de datos aadidos