PI Datalink 2010 User Guide ES

Manual del usuario de PI DataLinkVersin 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: 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 contenidoCaptulo 1 Introduccin ................................................................................................................1 Ediciones de PI DataLink ...................................................................................................1 Requisitos del sistema .......................................................................................................3 Instalacin y actualizacin .................................................................................................3 Configuracin .....................................................................................................................3 Acerca de este documento ................................................................................................5 Captulo 2 Conceptos bsicos .....................................................................................................7 Interfaz de usuario..............................................................................................................7 Conexiones del servidor PI ..............................................................................................11 Componentes de funciones grficas................................................................................12 Configuracin de preferencia ...........................................................................................21 Construccin de una hoja de clculo ...............................................................................23 Captulo 3 Funciones PI..............................................................................................................25 Valor actual ......................................................................................................................25 Valor de archivo histrico.................................................................................................26 Datos comprimidos...........................................................................................................27 Datos de muestra .............................................................................................................30 Datos temporizados .........................................................................................................31 Datos calculados ..............................................................................................................33 Filtrado de tiempo.............................................................................................................37 Captulo 4 Tags PI y atributos ....................................................................................................39 Bsqueda de tags ............................................................................................................39 Funciones de tags ............................................................................................................41 Captulo 5 Objetos de Module Database...................................................................................45 Buscar en la base de datos de mdulos ..........................................................................45 Funciones de base de datos de mdulos ........................................................................47 Captulo 6 Hojas de clculo........................................................................................................49 Frecuencia de clculo ......................................................................................................49 Funciones y valores de matriz .........................................................................................51 Gestin de matrices .........................................................................................................52 Compartir hojas de clculo...............................................................................................54 Captulo 7 Pantallas de tendencias ...........................................................................................55 Crear un trend ..................................................................................................................55 Especificar el Intervalo de tiempo ....................................................................................58 Ttulo y posicin ...............................................................................................................59 Men contextual ...............................................................................................................59

Manual del usuario de PI DataLink

iii

Tabla de contenido

Captulo 8 Notificaciones............................................................................................................63 Bsqueda y visualizacin de notificaciones.....................................................................63 Ver notificaciones .............................................................................................................66 Insertar notificaciones ......................................................................................................66 Apndice A Informacin complementaria ................................................................................69 Configuracin ...................................................................................................................69 Tiempo PI .........................................................................................................................71 Compatibilidad con el tipo de datos PI.............................................................................74 Expresiones PI .................................................................................................................74 Entrada manual de funcin ..............................................................................................81 Escribir datos en PI ..........................................................................................................84 Resolucin de problemas.................................................................................................85 Apndice B Referencia de funciones de PI DataLink ..............................................................87 Funciones de valor nico .................................................................................................87 Funciones de valor mltiple .............................................................................................90 Funciones de clculo........................................................................................................99 Funciones de tags ..........................................................................................................112 Funciones de base de datos de mdulos ......................................................................115 Funciones de entrada ....................................................................................................117 Apndice C Soporte tcnico y recursos .................................................................................119 Index ............................................................................................................................................123

iv

Captulo 1

IntroduccinPI 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 DataLinkNota: 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.


1

Introduccin

PI SDKPI 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 DataLinkEsta versin de PI DataLink proporciona compatibilidad con varios idiomas. La interfaz de usuario del complemento aparece en el mismo idioma que el Microsoft Excel en el que se ejecuta, si el idioma est contemplado por DataLink. En caso contrario, el complemento aparece en ingls. Para ver el complemento en un idioma distinto, utilice la herramienta de configuracin de idioma de Microsoft Office para cambiar el idioma de Microsoft Excel. Para obtener la compatibilidad con mltiples idiomas, debe instalar un paquete de idioma aparte.

2

Requisitos del sistema

Requisitos del sistemaPara 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 actualizacinInstalacin 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.

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


3

Introduccin

La instalacin pone DataLink a disposicin de todos los usuarios del ordenador cliente. Si un usuario individual desactiva PI DataLink o un complemento relacionado, las actualizaciones no reactivan el complemento; debe restaurarse manualmente. Para restaurar complementos: 1. Haga clic en el botn Microsoft Office y seleccione Opciones de Excel. 2. Haga clic en Complementos > Administrar Elementos deshabilitados > Ir y active PIDatlink.UI.dll.manifest. 3. Vaya a Complementos > Administrar Complementos COM > Ir y active PIDatlink.UI.dll.manifesto PI Notifications. 4. Haga clic en Aceptar. Microsoft Excel XP-2003 Si instala PI DataLink para Excel XP-2003, tendr que configurar el complemento para Excel despus de la instalacin. Tambin puede utilizar este procedimiento para restaurar el complemento si el men PI no aparece en la barra de mens de Excel. Para aadir DataLink a versiones de Excel XP-2003: 1. En Excel, seleccione Herramientas > Complementos. Aparecer el cuadro de dilogo de Complementos.

2. Si el complemento PI DataLink no aparece en la lista, haga clic en Examinar para localizar el archivo PIPC32.XLL en su disco duro local. La ruta predeterminada de PI DataLink es PIPC\EXCEL. 3. Haga clic en la casilla junto a PI DataLink y haga clic en Aceptar.

4

Acerca de este documento

Acerca de este documentoEl 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.


5

Captulo 2

Conceptos bsicosLos 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 usuarioPI 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.


7

Conceptos bsicos

PI DataLink para Excel 2007PI DataLink para Excel 2007 incluye elementos de diseo presentados en Microsoft Office 2007. Si actualiza desde una versin anterior de PI DataLink, familiarcese con los nuevos elementos de diseo antes de comenzar a trabajar con PI DataLink. PI Ribbon El complemento PI DataLink para Microsoft Excel 2007 utiliza un men de cinta.

El men de cinta es un men grfico que combina funciones de un men estndar y de una barra de herramientas.

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

Paneles de tareas de funciones PI DataLink para Microsoft Excel 2007 proporciona paneles de tareas personalizados para definir funciones de PI DataLink.

Un panel de tareas es un panel de controles movible y apilable que funciona principalmente como un cuadro de dilogo, excepto porque se puede continuar trabajando en una hoja de clculo mientras el panel de tareas est abierto.

8

Interfaz de usuario

PI DataLink abre un panel de tareas cuando aade una funcin o selecciona una celda de una matriz de funcin para editarla. Para abrir un panel de tareas de funcin:

Haga clic en la celda de salida deseada y, a continuacin, haga clic en una funcin de la cinta PI para aadir una funcin. Haga clic en una celda de una matriz de funcin existente para mostrar el panel de tareas correspondiente y editar los argumentos de la funcin. Haga clic con el botn derecho en una celda de matriz de funcin y seleccione el nombre de la funcin para mostrar manualmente el panel de tareas.

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

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

Introduzca o modifique valores y, a continuacin, haga clic en Aceptar para guardar sus cambios y cerrar el panel de tareas. Haga clic en Aplicar para guardar los cambios sin cerrar el panel de tareas. Haga clic en el botn X de la barra de ttulo del panel de tareas para cerrarlo sin guardar los cambios. Haga clic en el botn de flecha de la barra de ttulo del panel de tareas para separar y Mover o Redimensionar el panel de tareas. Tambin puede hacer clic en la barra de ttulo para arrastrar y acoplar un panel de tareas, o colocar el cursor sobre el borde y arrastrar para redimensionar el panel.

Nota: Los cuadros de dilogo se utilizan para otras tareas, incluidas la Bsqueda de tags, Preferencias y Conexiones en el complemento para Excel 2007.

PI DataLink para Excel XP-2003PI 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.


9

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 contextualPI 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 para abrir el correspondiente cuadro de dilogo de funcin (pgina 10) y actualizar los argumentos para recopilar datos distintos.

Conexiones del servidor PIUtilice 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 grficasPI 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

Componentes de funciones grficas

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 entradaLos 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 estndarAlgunos 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 tiempoMuchas 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 aadidosLas 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 orientacinPara 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 presentacinPuede 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 preferenciaUtilice 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 clculoUna 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 PILas 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 actualRecupera 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 histricoRecupera un valor de punto PI, o evala una expresin correspondiente a una marca de tiempo especfica.ARGUMENTOS OBLIGATORIOS

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 comprimidosDevuelve 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 = 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 muestraDevuelve valores de muestra interpolados, separados por espacios, de una expresin o punto PI a lo largo de un intervalo regular.ARGUMENTOS OBLIGATORIOS

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


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).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 = 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 horasTEMAS RELACIONADOS

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

Datos temporizadosDevuelve valores de muestra reales o interpolados para un punto PI que coinciden con una matriz de marcas de tiempo especificadas.ARGUMENTOS OBLIGATORIOS

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 = 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 calculadosDevuelve 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


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


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 tiempoDevuelve 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.ARGUMENTOS OBLIGATORIOS

Expresin Hora de inicio


37

Funciones PI

Hora de finalizacin Unidades 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.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 atributosUn 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 tagsUtilice 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 tagsEl 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:

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 funciones de tags utilizan componentes de funcin (pgina 12) comunes.

Identificador del punto para tagDevuelve 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 tagDevuelve 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 tagRecupera 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 DatabaseLa 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 mdulosEl 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

Objetos de Module Database

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

PI Datalink 2010 User Guide ES

Documents

Transcript of PI Datalink 2010 User Guide ES