PI Datalink 2010 User Guide ES

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
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.
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.
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.
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 XP2003 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 Men PI cuadros de dilogo de funciones men contextual del botn derecho del ratn Asistente de control de trend Cuadro de dilogo de Notificaciones PI PI DataLink para Excel 2007 Cinta PI paneles de tareas de funciones men contextual del botn derecho del ratn Asistente de control de trend 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.
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:
11
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 ejemplo, un nombre de tag o la direccin de una celda de salida. Seleccionar un elemento entre las opciones de una lista clculo o un mtodo de muestreo.
, por
, como, por ejemplo, un
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 bsqueda en base de datos de mdulos o tags.
mediante una
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.
13
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-dic99 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.
15
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 Cualquier funcin con datos aadidos Valor actual e histrico, Datos de muestra Datos comprimidos Filtrado de tiempo Calculado (mnimo) Calculado (mximo) Calculado (intervalo) Calculado (otros) Alias Celda de salida valor marca de tiempo marca de tiempo hora de inicio hora de inicio hora de inicio hora de inicio hora de inicio servidor valor valor hora de finalizacin hora de finalizacin hora de finalizacin hora de finalizacin hora de finalizacin valor anotaciones valor tiempo mn. tiempo mx.: tiempo mn. valor porcent. correcto valor mn. valor mx.: tiempo mx.: porcent. correcto valor Columna 2 Columna 3 Columna 4 Columna 5
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.
17
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. Seleccione mostrar tiempo mn/mx para mostrar marcas de tiempo para los valores mnimo y mximo de cada intervalo.
Para los valores calculados de mnimo, mximo e 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:
19
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-mmmaa 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).
Manual del usuario de PI DataLink 21
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?
23
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)

25
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: Nombre de tag = sinusoid Marca de tiempo = 30-Sep-07 15:13 Modo de recuperacin = anterior tiempo a la izquierda
26
Datos comprimidos
y la matriz de funcin resultante aparece como:
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. ARGUMENTOS OBLIGATORIOS
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).
27
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 Nombre de tag = sinusoid 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 y la matriz de funcin resultante aparece como:
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)
29
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.
Nombre de tag o expresin 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
sinusoid < 70
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 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. 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: Nombre de tag = sinusoid Hora de inicio = -1d Hora de finalizacin = <referencia de celda a la hora actual> Intervalo de tiempo = 3h mostrar marcas de tiempo columna y la matriz de funcin resultante aparece como:
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.
31
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
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 temporizados 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. 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 y la matriz de funcin resultante aparece como:
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. ARGUMENTOS OBLIGATORIOS
Nombre de tag o expresin Hora de inicio Hora de finalizacin Factor de conversin
EXPRESIN DE FILTRO
sinusoid < 70
INTERVALO DE TIEMPO
33
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 Unidades/da Unidades/hora Unidades/minuto Unidades/segundo Factor de conversin necesario para coincidir con el predeterminado del servidor (unidades/da) 1.0 24 1440 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.
35
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
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 calculados 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. 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 Nombre de tag = sinusoid 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
y la matriz de funcin resultante aparece como:
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
37
Funciones PI
Hora de finalizacin Unidades de tiempo
INTERVALO DE TIEMPO
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 y la matriz de funcin resultante aparece como:
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.
39
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) y la matriz de funcin resultante aparece como:
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)
41
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 y la matriz de funcin resultante aparece como:
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)
43
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.
45
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.
47
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.
49
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 2feb-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.
51
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. 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.
Una vez seleccionadas, puede gestionar la matriz fcilmente.
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.
57
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.
59
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.
61
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.
63
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 y aadir PI System (pgina 64) al men. para acceder a la Lista de sistemas
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.
65
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. 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.
Tambin puede gestionar la visualizacin de notificaciones en el visor:
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.
67
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.
69
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 segundo minuto hora da mes ao semana da de la semana da del ao Nombre corto s m h d m a s ds da Nombre plural segundos minutos horas das meses aos semanas das de la semana das del ao Nombres de miembros no no no no s (por ejemplo, diciembre) no no s (por ejemplo, martes) no Fraccion es s s s no no no no 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 * Hoy o h Ayer o a Domingo o dom Resultado La hora y fecha actual. 12:00 am del da actual. 12:00 am del da anterior. 00:00:00 (medianoche) del domingo ms reciente (en referencia al servidor PI).
71
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 Tiempo relativo Descripcin Las expresiones de tiempo relativo especifican un nmero de das, horas, minutos o segundos, precedidas de un signo + o -. En ausencia de un tiempo de referencia (tal como * o 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. Una expresin de tiempo combinado es una referencia de tiempo especfica precedida de una expresin de tiempo relativa. Una expresin de tiempo absoluto es cualquier expresin de tiempo que no sea una expresin relativa o combinada. Ejemplos +1d -24h -3m +24s
Tiempo combinado
*+8h 18-dic-02 3m t+32s * 14-dic-97 11-nov-96 2:00:00.0001 hoy a
Tiempo absoluto
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 06-dic-91 15:00:00 * 25 25-ago-92 8: 25 8: hoy a dom, lun, mar, mi, jue, vie, sb * - 1h t+8h y-8h lun+14.5h sb-1m Significado 3:00:00 PM el 6 de diciembre de 1991 Hora actual (tiempo real) 00:00:00 (medianoche) del da 25 del mes actual 00:00:00 (medianoche) del 25 de agosto de 1992 08:00:00 de la fecha actual 08:00:00 del da 25 del mes actual 00:00:00 de la fecha actual (hoy) 00:00:00 de la fecha anterior (ayer) 00:00:00 del domingo, lunes, ... ms reciente Sbado Hace una hora 8:00:00 AM hoy 16:00:00 de anteayer 14:30:00 del pasado lunes 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 tiempo PI 1.5h 32m 49 s +5 h -5 h Significado Una hora y media Treinta y dos minutos Cuarenta y nueve segundos Cinco horas aadidas al tiempo, empezando con la hora de inicio Cinco horas restadas al tiempo, empezando con la hora de finalizacin
73
Compatibilidad con el tipo de datos PI

PI DataLink admite los siguientes tipos de datos de punto PI:
Tipo de datos Digital (estados definidos) Int (16 y 32) Float (16, 32 y 64) String (texto) Marca de tiempo Objeto blob Soporte compatible compatible compatible compatible compatible 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.
75
Operadores
Los siguientes operadores son admitidos en PI Expressions:
Tipo Aritmtico Operador + * / ^ Mod Relacional < = > <= <> >= Prefijo Not Conjuncin, Disyuncin e Inclusin And Ejemplo de sintaxis A + B A - B A * B A / B A ^ B A mod B A < B A = B A > B A <= B A <> B A >= B NOT A - A A and B Significado Suma: A + B Resta: A menos B Multiplicacin: A por B Divisin: A dividido por B Elevacin a una potencia: A elevado a B (AB) Mdulo: el resto de A dividido por B Menor que: devuelve verdadero si A es menor que B Igual que: devuelve verdadero si A es igual que B Mayor que: devuelve verdadero si A es mayor que B Menor o igual que: devuelve verdadero si A es menor o igual que B No igual que: devuelve verdadero si A no es igual que B Mayor o igual que: devuelve verdadero si A es mayor o igual que B Complementacin: devuelve verdadero si A es 0 y falso en caso contrario. Negacin (como operador prefijo): devuelve el negativo de A Conjuncin: devuelve verdadero si los operandos A & B son evaluados ambos como verdaderos. Si tanto A como B son enteros, devuelve el resultado de una operacin AND a nivel de bit. 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. Inclusin en un intervalo: devuelve verdadero si el valor de A est entre B y D Inclusin en un conjunto discreto: devuelve verdadero si el valor de A coincide con alguno de los valores encerrados entre los parntesis. Expresin if-then-else: devuelve B si A es verdadero, en caso contrario devuelve D
Or
A or B
in .. in ( )
A in B..D A in (B1, B2, BN) if A then B else D
Expresiones If-Then-Else
if then else
76
Expresiones PI
Funciones de Performance Equations

Tambin puede evaluar expresiones que contengan funciones de PI Performance Equation:
Funciones matemticas Nombre Abs Asin Acos Atn Atn2 Cos Cosh Exp Flotar Frac Int Log Log10 Poly Round Sgn Sin Sinh Sqr Tanh Tan Trunc Descripcin Valor absoluto Arco seno Arco coseno Arco tangente Arco tangente (dos argumentos) Coseno Coseno hiperblico Exponencial Conversin de cadena a nmero Parte fraccional de un nmero Parte entera de un nmero Logaritmo natural Logaritmo comn Evaluar polinomio Redondeo a la siguiente unidad Signo numrico Seno Seno hiperblico Raz cuadrada Tangente hiperblica Tangente Truncar a la siguiente unidad inferior
Funciones de conjunto Nombre Avg Max Median Min PStDev SStDev Total Descripcin Promedio Mximo Selector de mediana Mnimo Desviacin estndar de poblacin Desviacin estndar de muestra Suma
77
Funciones diversas Nombre BadVal() Curve DigState IsDST IsSet StateNo TagBad Descripcin Comprobar si un valor es errneo (no numrico o de tiempo) Obtener el valor de una curva Obtener el estado digital de una cadena Comprobar si una hora est dentro del periodo local de ahorro de energa Comprobar si un valor PI es anotado, sustituido o cuestionable El nmero de cdigo de un estado digital Comprobar si un punto tiene un estado anormal
Recuperacin de archivo histrico PI Nombre NextEvent NextVal PrevEvent PrevVal TagVal Descripcin La hora del prximo evento de archivo histrico de un punto El siguiente valor de un punto despus de una hora La hora del anterior evento de archivo histrico de un punto El valor anterior de un punto antes de una hora El valor de un punto a una hora
Bsqueda de archivos histricos PI Nombre FindEq FindGE FindGT FindLE FindLT FindNE TimeEq TimeGE TimeGT TimeLE TimeLT TimeNE Descripcin Marca de tiempo cuando el punto = valor Marca de tiempo cuando el punto >= valor Marca de tiempo cuando el punto > valor Marca de tiempo cuando el punto <= valor Marca de tiempo cuando el punto < valor Marca de tiempo cuando el punto != valor Periodo total cuando el punto = valor Periodo total cuando el punto >= valor Periodo total cuando el punto > valor Periodo total cuando el punto <= valor Periodo total cuando el punto < valor Periodo total cuando el punto != valor
Estadsticas de archivos histricos PI Nombre EventCount PctGood Range StDev TagAvg TagMean Descripcin Nmero de eventos de archivo histrico Porcentaje de tiempo correcto en un periodo Intervalo del valor mnimo al mximo Desviacin estndar ponderada en el tiempo Promedio ponderado al tiempo Promedio ponderado a evento
78
Expresiones PI
Nombre TagMax TagMin TagTot
Descripcin Valor mximo en un periodo Valor mnimo en un periodo Integral de tiempo durante un periodo
Atributos de punto Nombre TagDesc TagEU TagExDesc TagName TagNum TagSource TagSpan TagType TagTypVal TagZero Descripcin Obtener el descriptor de un punto Obtener la cadena de unidad de ingeniera de un punto Obtener el descriptor ampliado de un punto Obtener el nombre de un punto Obtener el ID de un punto Obtener la cadena fuente de punto de un punto Obtener el rango de un punto Obtener el carcter de tipo de un punto Obtener el valor tpico de un punto Obtener el valor cero de un punto
Funciones de tiempo Nombre Bod Bom Bonm Day DaySec Hour Minute Month Noon ParseTime Second Weekday Year Yearday Descripcin Marca de tiempo para el principio del da para un valor fecha/hora dado Marca de tiempo para el principio del mes para un valor fecha/hora dado Marca de tiempo para el principio del mes prximo para un valor fecha/hora dado Da del mes de un valor fecha/hora Segundos desde la medianoche de un valor fecha/hora Hora de un valor fecha/hora Minuto de un valor fecha/hora Mes de un valor fecha/hora Marca de tiempo para el medioda local de un valor fecha/hora Convierte una cadena de caracteres en un valor fecha/hora Segundo de un valor fecha/hora Da de la semana de un valor fecha/hora Ao de un valor fecha/hora Da del ao de un valor fecha/hora
79
Respuesta dinmica Nombre Arma Delay MedianFilt Impulse Descripcin Respuesta dinmica de un modelo de media mvil auto regresiva Introducir retardo de tiempo Seleccionar el valor medio de series de tiempo Respuesta dinmica caracterizada por forma de respuesta de impulso
Funciones de estado de alarma Nombre AlmAckStat AlmCondition AlmCondText AlmPriority Descripcin Cdigo de estado de reconocimiento de error Nmero de cdigo de condicin para estado de alarma Condicin de alarma en formato de texto Nmero de prioridad de alarma
Funciones de cadena Nombre Ascii Char Compare DigText Format InStr LCase Len Left LTrim Mid Right RTrim Trim UCase Descripcin Cdigo de carcter ASCII de un carcter Cadena para cdigos de carcter ASCII Comparacin de dos cadenas Texto de un estado digital Formato de un nmero en tipo numrico Instancia de una subcadena Conversin de todos los caracteres a minscula Longitud de una cadena Los primeros caracteres de una cadena Eliminacin de espacios en blanco a la izquierda de una cadena Extraccin de una subcadena de una cadena Los ltimos caracteres de una cadena Eliminacin de espacios en blanco a la derecha de una cadena Eliminacin de espacios en blanco en ambos lados de una cadena Conversin de todos los caracteres a mayscula
Conversin de cadenas Nombre Concat String Text Descripcin Concatenar dos o ms cadenas Cadena representando cualquier valor PI 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
sinusoid < 70

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.
81
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
83
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.
85
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 Tagname (cadena) outcode (entero) PIServer (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. Un cdigo de salida para determinar la colocacin del resultado; 0, 1 2. El servidor PI destino
VALORES DEVUELTOS
Cdigo de salida 0 1 2 Valor celda de salida columna derecha celda de salida Marca de tiempo ninguno celda de salida fila superior
87
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 tagname (cadena) time stamp (cadena) outcode (entero) PIServer (cadena) mode (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. La marca de tiempo correspondiente al valor de archivo histrico Un cdigo de salida para determinar la colocacin de los resultados; 0, 1 2. El servidor PI destino El modo utilizado para determinar qu valores son recuperados.
DEVOLUCIONES
Cdigo de salida 0 1 2 Valor de archivo histrico celda de salida columna izquierda celda de salida celda de salida fila superior Marca de tiempo
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
Valor de archivo histrico (pgina 26)
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 expression (cadena) time stamp (cadena) PIServer (cadena) Valor Una expresin de clculo PI La marca de tiempo correspondiente al valor de archivo histrico El servidor PI destino
VALORES DEVUELTOS
Cdigo de salida 0 1 2 Valor de archivo histrico celda de salida columna izquierda celda de salida celda de salida fila superior Marca de tiempo
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
Valor de archivo histrico (pgina 26)
89
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 tagname (cadena) stime (cadena) numvals (entero) outcode (entero) PIServer (cadena) mode (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. La hora de inicio para el intervalo de valores recuperados (en formato de tiempo PI). El nmero de valores deseados (negativo si se cuenta hacia atrs en el tiempo) Un cdigo de salida El servidor PI destino 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
Datos comprimidos (pgina 27)
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 tagname (cadena) stime (cadena) numvals (entero) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) mode (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. La hora de inicio para el intervalo de valores recuperados (en formato de tiempo PI). El nmero de valores deseados (negativo si se cuenta hacia atrs en el tiempo) Una expresin de filtro utilizada para filtrar los resultados. Un cdigo de filtro, 1 para denotar el estado Filtrado y 0 para omitirlo. Un cdigo de salida El servidor PI. El mtodo para manejar valores en los lmites del intervalo de tiempo
VALORES DEVUELTOS
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
Datos comprimidos (pgina 27) expresin de filtro (pgina 75)
91
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 tagname (cadena) stime (cadena) etime (cadena) outcode (entero) PIServer (cadena) mode (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. La hora de inicio para el intervalo de valores recuperados (en formato de tiempo PI). La hora de finalizacin para el intervalo (en formato de tiempo PI) Un cdigo de salida El servidor PI destino El mtodo para manejar valores en los lmites del intervalo de tiempo
VALORES DEVUELTOS
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
Datos comprimidos (pgina 27)
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 tagname (cadena) stime (cadena) etime (cadena) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) mode (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. La hora de inicio para el intervalo de valores recuperados (en formato de tiempo PI). La hora de finalizacin para el intervalo (en formato de tiempo PI) La expresin de filtro utilizada para filtrar los resultados Un cdigo de filtro, 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida El servidor PI destino El mtodo para manejar valores en los lmites del intervalo de tiempo
VALORES DEVUELTOS
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
Datos comprimidos (pgina 27) expresin de filtro (pgina 75)
93
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 tagname (cadena) stime (cadena) etime (cadena) interval (cadena) outcode (entero) PIServer (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. La hora de inicio para el intervalo de muestreo (en formato de tiempo PI). La hora de finalizacin para el intervalo (en formato de tiempo PI) El intervalo entre valores de muestra (en formato de tiempo PI). Un cdigo de salida, 0, 1, 2 3. El servidor PI destino
VALORES DEVUELTOS
Cdigo de salida 0 1 2 3 Valor de muestra celda de salida columna derecha celda de salida fila inferior Marca de tiempo ninguno celda de salida ninguno 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
Datos de muestra (pgina 29)
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 tagname (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) Valor El nombre o nombres de tag coincidentes con los puntos PI deseados. La hora de inicio para el intervalo de muestreo (en formato de tiempo PI). La hora de finalizacin en formato de tiempo PI El intervalo entre valores de muestra (en formato de tiempo PI). La expresin de filtro utilizada para filtrar los resultados Un cdigo de filtro, 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida, 0, 1, 2 3. El servidor PI destino
VALORES DEVUELTOS
Un cdigo de salida (pgina 83) 2 transpone la matriz de salida resultante de un cdigo de salida 0 y el cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1.
EJEMPLO
La siguiente frmula recupera datos de muestra para sinusoid en 11-Ene-97, 11-Ene97 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
Datos de muestra (pgina 29) expresin de filtro (pgina 75)
95
PIExpDat()
Recupera valores de puntos PI basados en una expresin, utilizando la siguiente sintaxis:
PIExpDat(expression, stime, etime, interval, outcode, PIServer) ARGUMENTOS
Argumento expression (cadena) stime (cadena) etime (cadena) interval (cadena) outcode (entero) PIServer (cadena) Explicacin Una expresin de clculo PI La hora de inicio para el intervalo de valores de muestra (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El intervalo entre valores de muestra (en formato de tiempo PI). Un cdigo de salida para determinar la colocacin de los resultados; 0, 1, 2 3. El servidor PI destino
VALORES DEVUELTOS
Un cdigo de salida (pgina 83) 2 transpone la matriz de salida resultante de un cdigo de salida 0 mientras que un cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1.
EJEMPLO
La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid del servidor PI denominado thevax en intervalos de una hora, comenzando por la medianoche de ayer hasta la medianoche de hoy:
=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")
Tambin muestra las marcas de tiempo.

TEMAS RELACIONADOS
Datos de muestra (pgina 29) 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
Argumento tagname (cadena) timestamps (referencia) PIServer (cadena) mode (cadena) Explicacin El nombre o nombres de tag coincidentes con los puntos PI deseados. Una referencia a una matriz de marcas de tiempo en formato de tiempo PI. El servidor PI destino 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
Datos temporizados (pgina 31)
97
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
Argumento expression (cadena) timestamps (referencia) PIServer (cadena) Explicacin Una expresin de clculo PI Una referencia a una matriz de marcas de tiempo en formato de tiempo PI (aumentando o disminuyendo montonamente para servidores PI 2). El servidor PI destino
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
Datos temporizados (pgina 31) expresin de clculo PI (pgina 75)
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
Argumento tagname (cadena) stime (cadena) etime (cadena) mode (cadena) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin El nombre o nombres de tag coincidentes con los puntos PI deseados para el clculo La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El tipo de clculo a utilizar para computar valores de punto. La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida; de 0 a 7, y no 3. El servidor PI destino
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:
Columna 1 Valor total Tiempo del valor mn. Tiempo del valor mx. Stdev. Valor Tiempo del valor mn. Valor de promedio Valor de cuenta Valor de media Tiempo del valor mx. Valor de rango Valor mnimo Valor mximo Columna 2 Columna 3
Modo Total Minimum Maximum Stdev Range Average Count Mean
99
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:
Columna 1 Valor total Tiempo del valor mn. Tiempo del valor mx. Valor Stdev. Tiempo del valor mn. Valor de promedio Valor de cuenta Valor de media Columna 2 Porcentaje correcto Valor mnimo Valor mximo Porcentaje correcto Tiempo del valor mx. Porcentaje correcto Porcentaje correcto Porcentaje correcto Valor de rango Porcentaje correcto Porcentaje correcto Porcentaje correcto Columna 3 Columna 4
Modo Total Minimum Maximum Stdev Range Average Count Mean
Un cdigo de salida 6 transpone la matriz de salida que resulta de un cdigo de salida 4 y los resultados se devuelven en filas en vez de en columnas. Un cdigo de salida 7 transpone la matriz de salida que resulta de un cdigo de salida 5 y los resultados se devuelven en filas en vez de en columnas.
EJEMPLO
La siguiente frmula calcula un total de tiempo ponderado para el tag cdf144 desde ayer a hoy del 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
Datos calculados (pgina 33)
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
Argumento tagname (cadena) stime (cadena) etime (cadena) mode (cadena) calcbasis (string) minpctgood (nmero) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin El nombre del tag coincidente con el punto PI deseado para el clculo La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
VALORES DEVUELTOS
Consulte informacin especfica sobre cdigos de salida de PICalcVal() (pgina 99).

EJEMPLO
La siguiente frmula calcula un total de tiempo ponderado para el tag cdf144 desde 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
101
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
Argumento tagname (cadena) stime (cadena) etime (cadena) filtexp (cadena) mode (cadena) calcbasis (string) sampmode (string) sampfreq (string) minpctgood (nmero) Cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin El nombre o nombres de tag coincidentes con los puntos PI deseados para el clculo La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) La expresin de filtro utilizada para filtrar los resultados El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mtodo de muestreo utilizado para las expresiones de clculo La frecuencia utilizada para el muestreo interpolado El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
VALORES DEVUELTOS

EJEMPLO
La siguiente frmula calcula un total de tiempo ponderado para el tag cdf144 desde 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
Datos calculados (pgina 33) expresin de filtro (pgina 75)
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
Argumento expression (cadena) stime (cadena) etime (cadena) mode (cadena) calcbasis (string) sampmode (string) sampfreq (string) minpctgood (nmero) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin Una expresin de clculo PI La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mtodo de muestreo utilizado para las expresiones de clculo La frecuencia utilizada para el muestreo interpolado El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
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","timeweighted","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
Datos calculados (pgina 33) expresin de clculo PI (pgina 75)
103
PIAdvCalcExpFilVal()
Recupera un valor filtrado de punto PI calculado basado en una expresin, utilizando la siguiente sintaxis:
PIAdvCalcExpFilVal(expression, stime, etime, filtexp, mode, calcbasis, sampmode, sampfreq, minpctgood, cfactor, outcode, PIServer) ARGUMENTOS
Argumento expression (cadena) stime (cadena) etime (cadena) filtexp (cadena) mode (cadena) calcbasis (string) sampmode (string) sampfreq (string) minpctgood (nmero) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin Una expresin de clculo PI La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) La expresin de filtro utilizada para filtrar los resultados El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mtodo de muestreo utilizado para las expresiones de clculo La frecuencia utilizada para el muestreo interpolado El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
VALORES DEVUELTOS

EJEMPLO
La siguiente frmula calcula un total de tiempo ponderado para la expresin 'cdf144'+' 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
Datos calculados (pgina 33) expresin de clculo PI (pgina 75) expresin de filtro (pgina 75)
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
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) mode (cadena) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin El nombre o nombres de tag coincidentes con los puntos PI deseados para el clculo La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El intervalo entre valores calculados (en formato de tiempo PI). El tipo de clculo a utilizar para computar valores de punto. La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, de 0 a 7. El servidor PI destino
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

105
PIAdvCalcDat()
Recupera valores de puntos PI calculados utilizando la siguiente sintaxis:
PIAdvCalcDat(tagname, stime, etime, interval, mode, calcbasis, minpctgood, cfactor, outcode, PIServer) ARGUMENTOS
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) mode (cadena) calcbasis (string) minpctgood (nmero) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin El nombre o nombres de tag coincidentes con los puntos PI deseados para el clculo La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El intervalo entre valores calculados (en formato de tiempo PI). El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, de 0 a 7. El servidor PI destino
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","timeweighted",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, calcbasis, sampmode, sampfreq, minpctgood, cfactor, outcode, PIServer) ARGUMENTOS
Argumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) mode (cadena) calcbasis (string) sampmode (string) sampfreq (string) minpctgood (nmero) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin El nombre o nombres de tag coincidentes con los puntos PI deseados para el clculo La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El intervalo entre valores calculados (en formato de tiempo PI). La expresin de filtro utilizada para filtrar los resultados El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mtodo de muestreo utilizado para las expresiones de clculo La frecuencia utilizada para el muestreo interpolado El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, de 0 a 7. El servidor PI destino
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
Datos calculados (pgina 33) expresin de filtro (pgina 75)
107
PIAdvCalcExpDat()
Recupera valores de puntos PI calculados basados en una expresin, utilizando la siguiente sintaxis:
PIAdvCalcExpDat(expression, stime, etime, interval, mode, calcbasis, sampmode, sampfreq, minpctgood, cfactor, outcode, PIServer) ARGUMENTOS
Argumento expression (cadena) stime (cadena) etime (cadena) interval (cadena) mode (cadena) calcbasis (string) sampmode (string) sampfreq (string) minpctgood (nmero) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin Una expresin de clculo PI La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El intervalo entre valores calculados (en formato de tiempo PI). El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mtodo de muestreo utilizado para las expresiones de clculo La frecuencia utilizada para el muestreo interpolado El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
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
Datos calculados (pgina 33) expresin de clculo PI (pgina 75)
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
Argumento expression (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) mode (cadena) calcbasis (string) sampmode (string) sampfreq (string) minpctgood (nmero) cfactor (nmero) outcode (entero) PIServer (cadena) Explicacin Una expresin de clculo PI La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El intervalo entre valores calculados (en formato de tiempo PI). La expresin de filtro utilizada para filtrar los resultados El tipo de clculo a utilizar para computar valores de punto. El mtodo de ponderacin utilizado para calcular valores El mtodo de muestreo utilizado para las expresiones de clculo La frecuencia utilizada para el muestreo interpolado El mnimo porcentaje de datos correctos requerido para calcular y devolver un valor La unidad de tiempo de flujo para el tag origen, necesario para clculos Total Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
VALORES DEVUELTOS

EJEMPLO
La siguiente frmula calcula un total de tiempo ponderado para la expresin 'cdf144'+' 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","timeweighted","compressed","10m",50,1,4,)
TEMAS RELACIONADOS
Datos calculados (pgina 33) expresin de clculo PI (pgina 75) expresin de filtro (pgina 75)
109
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
Argumento expression (cadena) stime (cadena) etime (cadena) interval (cadena) timeunit (cadena) outcode (entero) PIServer (cadena) Explicacin Una expresin de clculo PI La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) El intervalo entre evaluaciones (en formato de tiempo PI). Unidad de tiempo del resultado calculado (en formato de tiempo PI). Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
VALORES DEVUELTOS
Cdigo de salida 0 1 Columna 1 Datos calculados Marcas de tiempo Datos calculados Columna 2
Un cdigo de salida (pgina 83) 2 transpone la matriz de salida resultante de un cdigo de salida 0 y el cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1.
EJEMPLO
La siguiente frmula calcula la cantidad de tiempo que la expresin de la celda $A$1 es verdadera para el 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
Filtrado de tiempo (pgina 37) expresin de clculo PI (pgina 75)
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
Argumento expression (cadena) stime (cadena) etime (cadena) timeunit (cadena) outcode (entero) PIServer (cadena) Explicacin Una expresin de clculo PI La hora de inicio para el intervalo de clculo (en formato de tiempo PI). La hora de finalizacin (en formato de tiempo PI) Unidad de tiempo del resultado calculado (en formato de tiempo PI). Un cdigo de salida, 0, 1, 2, 4, 5, 6 7, y no 3. El servidor PI destino
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
Filtrado de tiempo (pgina 37) expresin de clculo PI (pgina 75)
111
Funciones de tags
PIPointIDToTag()
Recupera un nombre de tag correspondiente a un ID de punto PI, utilizando la siguiente sintaxis:
PIPointIDToTag(pointid, PIServer) ARGUMENTOS
Argumento PointID (cadena) PIServer (cadena) Explicacin In ID de punto PI, que es un ID interno nico no reutilizado tras la eliminacin de un punto El servidor PI destino
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
Argumento tagname (cadena) descriptor (cadena) pointsource (cadena) pointtype (cadena) pointclass (cadena) engunits (cadena) outcode (entero) PIServer (cadena) Explicacin Mscara de nombre del tag Mscara de descriptor Mscara de fuente del punto Mscara de tipo de punto Mscara de clase de punto. Mscara de unidades Un cdigo de salida, 0 2. El servidor PI destino
VALORES DEVUELTOS
Cdigo de salida 0 Columna 1 Nombre de tag Columna 2
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)
113
PITagAtt()
Recupera el valor de un atributo de tag basndose en el nombre del tag, utilizando la siguiente sintaxis:
PITagAtt(tagname, attribute, PIServer) ARGUMENTOS
Argumento tagname (cadena) attribute (cadena) PIServer (cadena) Explicacin El nombre o nombres de tag coincidentes con los atributos deseados. El atributo de punto PI deseado El servidor PI destino
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
Argumento alias (cadena) modulepath (cadena) querydate (entero) Outcode (entero) PIServer (cadena) Explicacin El alias de la base de datos de mdulos correspondiente al punto PI deseado. La ruta de mdulo completa al alias Una fecha lmite tal que solo son devueltos los alias creados en ella o despus Un cdigo de salida, 0, 1 2 El servidor PI destino
VALORES DEVUELTOS
Cdigo de salida 0 1 Columna 1 Nombre de tag Nombre de tag Servidor de tag Columna 2
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)
115
PIPropertyToValue()
Recupera el valor de una propiedad de punto PI especificado, utilizando la siguiente sintaxis:
PIPropertyToValue(property, modulepath, querydate, PIServer, outcode) ARGUMENTOS
Argumento Property (cadena) modulepath (cadena) querydate (entero) PIServer (cadena) Outcode (entero) Explicacin La propiedad de la base de datos de mdulos correspondiente al punto PI deseado. La ruta de mdulo completa a la propiedad Una fecha lmite tal que solo son devueltas las propiedades creadas en ella o despus El servidor PI destino 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
Argumento tagname (cadena) value (referencia) time stamp (cadena) PIServer (cadena) outcell (referencia) Explicacin El tag para el que se escribe el valor en PI La referencia a un valor para ser escrito, ya sea una cadena (para estados digitales) o un nmero. Una marca de tiempo en formato de tiempo PI El servidor PI destino 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.
117
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 San Leandro, CA (EE. UU.) Filadelfia, PA (EE. UU.) Johnson City, TN (EE. UU.) Montreal, QC (Canad) So Paulo (Brasil) Frankfurt (Alemania) Manama (Bahrin) Singapur Perth, WA (Australia) Nmero de acceso 1 510 297 5828 1 215 606 0705 1 423 610 3800 1 514 493 0663 55 11 3053 5040 49 6047 989 333 973 1758 4429 65 6391 1811 86 021 2327 8686 61 8 9282 9220 Opciones de idioma local Ingls Ingls Ingls Ingls y francs Ingls y portugus Ingls y alemn Ingls y rabe Ingls y chino mandarn Mandarn Ingls
119
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.
121
Index
A
acceso de datos - 70 Acceso de puntos - 70 actualizar, datos - 50 automtico - 50 manual - 51 Ajustes - 21 anotaciones, mostrar - 19 apstrofe, uso en Excel - 13, 14 argumento outcode - 81, 83 argumento, funcin de PI DataLink - 14 argumentos de tiempo - 15 atrs en el tiempo - 27 atributos de valor, mostrar - 19 average - 33 formatos de nmero - 15, 19, 21 formatos de tiempo - 15, 71 formatos, tiempo y nmero - 15, 19 frecuencia de muestreo de expresin - 33 funcin Alias para tag - 47 funcin Atributos del tag - 43 funcin Datos calculados - 33 funcin Datos calculados avanzados - 33 funcin Datos comprimidos - 27 funcin Datos de muestra - 30 funcin Datos temporizados - 31 funcin Filtrado de tiempo - 37 funcin Identificador del punto para tag - 41 funcin Mscara de atributo para tag - 42 funcin Propiedad para valor - 48 funcin Valor actual - 25 funcin Valor de archivo histrico - 26 funciones - 25, 47, 49 Actualizar los datos PI en una hoja de clculo 49 Cuadros de dilogo - 87 cuadros de dilogo de funciones - 10 definir - 8, 10, 12 Excel - 12 Introduciendo en Excel - 81 modificar - 53 paneles de tareas de funciones - 8 funciones de tags - 41
B
base de clculo - 33 Bsqueda de tags - 39
C
Cadenas de tiempo PI - 71 clculo de expresiones - 75 Campos de resultados - 14 celdas, hoja de clculo referencias - 13, 14 valores de funcin - 51 comilla simple - 13, 14 Complemento, Excel - 1, 9 Conexiones - 11 conexiones del servidor PI - 11 controles de orientacin - 19
H
hojas de clculo - 49
I
instalacin - 69 configurar Excel: - 3 instalacin silenciosa - 69 intervalo de tiempo - 26 Intervalo de tiempo - 30
D
desviacin estndar - 33
E
errores - 85 explorar - 47 expresiones clculo PI - 75 filtro - 81 sintaxis - 74 expresiones de clculo PI - 75 expresiones de filtro - 81
M
marcas de tiempo - 16, 17 matriz, funcin - 50, 51, 52 Men PI - 8, 9 Microsoft Excel - 3 modo de clculo - 33 modo de muestreo de expresin - 33 modo de recuperacin - 31 Module Database, buscar - 45 mostrar anotaciones - 19 mostrar atributos de valor - 19
123
F
factor de conversin - 33
Index
mostrar marca de tiempo - 17 mostrar porcentaje correcto - 18 mover matrices de funcin - 52
resolucin de problemas - 85
S
Soporte tcnico OSIsoft - 119
N
notificaciones, PI system - 63
T
tamao de matriz - 53 tipo de lmite - 27 Totales - 33 trend - 55
O
operadores - 74
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

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

PI Datalink 2010 User Guide ES

Hochgeladen von

Copyright:

Verfügbare Formate

Manual del usuario de PI DataLink

Manual del usuario de PI DataLink

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

Manual del usuario de PI DataLink

PI DataLink for Excel Services (DLES)

Compatibilidad con idiomas de PI DataLink

Requisitos del sistema

Requisitos del sistema

Manual del usuario de PI DataLink

Acerca de este documento

Acerca de este documento

Manual del usuario de PI DataLink

Manual del usuario de PI DataLink

PI DataLink para Excel 2007

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

PI DataLink para Excel XP-2003

Manual del usuario de PI DataLink

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

Conexiones del servidor PI

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

Para mostrar el men contextual:

En el men contextual aparecen los siguientes elementos:

Conexiones del servidor PI

Manual del usuario de PI DataLink

Para gestionar la configuracin de la conexin:

Componentes de funciones grficas

Componentes de funciones grficas

, como, por ejemplo, un

Manual del usuario de PI DataLink

Componentes de funciones grficas

Manual del usuario de PI DataLink

Componentes de funciones grficas

Manual del usuario de PI DataLink

Para los valores calculados de mnimo, mximo e intervalo:

Componentes de funciones grficas

Manual del usuario de PI DataLink

Construccin de una hoja de clculo

Construccin de una hoja de clculo

Manual del usuario de PI DataLink

PICurrVal() (pgina 87)

Manual del usuario de PI DataLink

Valor de archivo histrico

Nombre de tag o expresin Marca de tiempo

Se puede elegir entre 5 modos para producir un valor de archivo.

y la matriz de funcin resultante aparece como:

PIArcVal() (pgina 88) PIExpVal() (pgina 88)

Manual del usuario de PI DataLink

Manual del usuario de PI DataLink

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

en donde se muestra un valor por cada intervalo de 3 horas

PISampDat() (pgina 93) PISampFilDat() (pgina 94) PIExpDat() (pgina 96)

Nombre de tag Marca de tiempo

Manual del usuario de PI DataLink

Existen dos modos de seleccin:

PITimeDat() (pgina 96) PITimeExpDat() (pgina 97)

Nombre de tag o expresin Hora de inicio Hora de finalizacin Factor de conversin

Manual del usuario de PI DataLink

Se proporcionan los siguientes clculos:

Total Mnimo Mximo Desviacin estndar Intervalo Promedio Recuento Media

Seleccione para el clculo una base ponderada en el tiempo o el evento:

MODO MUESTREO DE EXPRESIN

FRECUENCIA DE MUESTREO DE EXPRESIN

Manual del usuario de PI DataLink

y la matriz de funcin resultante aparece como:

+8h 18-dic-02 3m t+32s 14-dic-97 11-nov-96 2:00:00.0001 hoy a