Manual del usuario de PI DataLink
Versión 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, República Popular China OSIsoft Japan KK • Tokio, Japón
OSIsoft Mexico S. De R.L. De C.V. • Ciudad de México, México OSIsoft do Brasil Sistemas Ltda. • Sao Paulo, Brasil
Copyright: © <COPYRIGHT_FECHA> OSIsoft, LLC. Todos los derechos reservados.
Ninguna parte de esta publicación puede ser reproducida, almacenada en un sistema de recuperación o transmitida, de ninguna forma ni por ningún medio, ya sea mecánico, 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 demás marcas o nombres comerciales aquí utilizados son propiedad de sus respectivos propietarios.
DERECHOS DEL GOBIERNO DE LOS EE.UU.
Su uso, réplica o difusión 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, según proceda. OSIsoft, LLC.
Manual del usuario de PI DataLink iii
Tabla de contenido
Capítulo 1 Introducción ...1
Ediciones de PI DataLink ...1
Requisitos del sistema ...3
Instalación y actualización ...3
Configuración ...3
Acerca de este documento ...5
Capítulo 2 Conceptos básicos ...7
Interfaz de usuario...7
Conexiones del servidor PI ...11
Componentes de funciones gráficas...12
Configuración de preferencia ...21
Construcción de una hoja de cálculo ...23
Capítulo 3 Funciones PI...25
Valor actual ...25
Valor de archivo histórico...26
Datos comprimidos...27
Datos de muestra ...30
Datos temporizados ...31
Datos calculados ...33
Filtrado de tiempo...37
Capítulo 4 Tags PI y atributos ...39
Búsqueda de tags ...39
Funciones de tags ...41
Capítulo 5 Objetos de Module Database...45
Buscar en la base de datos de módulos...45
Funciones de base de datos de módulos ...47
Capítulo 6 Hojas de cálculo...49
Frecuencia de cálculo ...49
Funciones y valores de matriz ...51
Gestión de matrices ...52
Compartir hojas de cálculo...54
Capítulo 7 Pantallas de tendencias ...55
Crear un trend ...55
Especificar el Intervalo de tiempo ...58
Título y posición ...59
iv
Capítulo 8 Notificaciones...63
Búsqueda y visualización de notificaciones...63
Ver notificaciones ...66
Insertar notificaciones ...66
Apéndice A Información complementaria ...69
Configuración ...69
Tiempo PI ...71
Compatibilidad con el tipo de datos PI...74
Expresiones PI ...74
Entrada manual de función ...81
Escribir datos en PI ...84
Resolución de problemas...85
Apéndice B Referencia de funciones de PI DataLink ...87
Funciones de valor único ...87
Funciones de valor múltiple ...90
Funciones de cálculo...99
Funciones de tags ...112
Funciones de base de datos de módulos ...115
Funciones de entrada ...117
Apéndice C Soporte técnico y recursos ...119
Index ...123
Manual del usuario de PI DataLink 1
PI DataLink es un complemento para Microsoft Excel que permite recuperar información de su PI Server directamente a una hoja de cálculo. Con PI DataLink, puede:
• recuperar valores de punto de un servidor PI
• recuperar metadatos de sistema para crear una visualización 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 cálculo se recalcule
• recuperar de un PI System las PI Notifications a las que esté suscrito
• crear una tendencia con datos de la hoja de cálculo o con puntos PI
PI DataLink proporciona una interfaz gráfica para recuperar datos y crear funciones y cálculos. Las funciones de DataLink se integran en celdas de hoja de cálculo y pueden proporcionar actualizaciones activas de datos en tiempo real del servidor PI.
También puede utilizar las ricas capacidades de cálculo y formato de Excel para organizar y presentar datos de un sistema PI para adecuarlos a su propósito o a su audiencia. Combinadas con las capacidades gráficas, de cálculo 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 edición se configura
automáticamente 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
(página 3).
Las diferencias entre estos complementos residen principalmente en cambios en la
interfaz de usuario y diseño (página 7) para Office 2007 y posteriores.
Capítulo 1
2
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 función intenta recuperar el valor actual para un tag que no existe, la celda de salida muestra un mensaje "PIPoint no encontrado".
PI SDK permite también 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 más información, póngase en contacto con el personal de ventas de OSIsoft.
PI DataLink for Excel Services (DLES)
PI DataLink for Excel Services (PI DLES) es una versión 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 configuración típica de cliente PI.
PI DLES permite recuperar y visualizar datos de PI Servers en formato de hoja de cálculo 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 ubicación o de su familiaridad con las funciones de Microsoft Excel o de PI DataLink. Esta versión de servidor de PI DataLink utiliza tecnologías MOSS, incluidos Excel Services y el elemento web Excel Web Access. Reunidos, estos componentes de
Microsoft admiten la mayoría de las funciones estándar de hojas de cálculo. PI DataLink for Excel Services aumenta estos servicios, añadiendo 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 añadidos a páginas de elementos web. El elemento web Excel Web Access admite conexiones que permiten el intercambio de parámetros entre un libro de trabajo y otros elementos web, integrando hojas de cálculo con funciones PI DataLink en el entorno PI WebParts.
Para obtener más información sobre PI DLES, póngase en contacto con el personal de ventas de OSIsoft.
Compatibilidad con idiomas de PI DataLink
Esta versión 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 inglés.
Para ver el complemento en un idioma distinto, utilice la herramienta de configuración de idioma de Microsoft Office para cambiar el idioma de Microsoft Excel.
Para obtener la compatibilidad con múltiples idiomas, debe instalar un paquete de idioma aparte.
Requisitos del sistema
Manual del usuario de PI DataLink 3
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)
Instalación y actualización
Instalación
Para instalar, descargue el kit de instalación desde http://techsupport.osisoft.com y ejecute el kit de de instalación de PI DataLink.
El programa de instalación instala PI DataLink bajo el directorio raíz de PIPC, normalmente en:
C:\Archivos de programa\PIPC\Excel
La instalación incluye también archivos de ayuda en línea y notas de la versión, que también están disponibles para su descarga en http://techsupport.osisoft.com. Actualizar
Si tiene una versión anterior de PI ProcessBook instalada en su equipo, el programa de instalación actualiza automáticamente su instalación. 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 leídos por la versión actual sin realizar ninguna conversión. No obstante, lo contrario no es necesariamente cierto. Una vez que modifique una hoja de cálculo en la versión 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 cálculo buscan determinadas cadenas (por ejemplo, en código o macros de Excel VBA) el texto puede no ser el mismo.
ο Las versiones 3.x y 4.x no crean una conexión API con el PI Server, por lo que el código VBA en libros de trabajo que dependa de una conexión API existente deben editarse para crear una nueva conexión explícita con PI API.
Configuración
Después de la instalación, tal vez necesite configurar el complemento PI DataLink en Excel.
Microsoft Excel 2007
El programa de configuración de PI DataLink instala automáticamente el complemento DataLink para Microsoft Excel 2007 si dicha versión se encuentra en el sistema. No es necesaria configuración alguna.
4
La instalación pone DataLink a disposición 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 botón 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 después de la instalación. También puede utilizar este procedimiento para restaurar el complemento si el menú PI no aparece en la barra de menús de Excel.
Para añadir DataLink a versiones de Excel XP-2003:
1. En Excel, seleccione Herramientas > Complementos. Aparecerá el cuadro de diálogo 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.
Acerca de este documento
Manual del usuario de PI DataLink 5
Acerca de este documento
El Manual del usuario de PI DataLink proporciona una descripción detallada de las características del producto y una completa referencia sobre las funciones de PI DataLink. El contenido de las versiones en línea e impresa del manual es idéntico. Los objetos de control de trend lanzan también un archivo de ayuda aparte que incluye información sobre controles de programación para trends.
Las versiones impresas del Manual del usuario de PI DataLink incluyen tutoriales de ejercicios utilizados por OSIsoft para los cursos de formación de PI DataLink. Estos ejercicio también están disponibles en formato PDF (junto con los archivos de ejercicios de formación 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 específicas a PI DataLink para Excel XP-2003 están marcadas (2003) y las específicas para PI DataLink para Excel 2007 están marcadas (2007),cuando es necesario.
Manual del usuario de PI DataLink 7
Los siguientes apartados presentan las funciones y conceptos básicos de PI DataLink. Debería familiarizarse con estos apartados entes de utilizar PI DataLink para crear una hoja de cálculo 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 cálculo PI DataLink, dependiendo de sus objetivos, necesidades y recursos
Interfaz de usuario
PI DataLink es una aplicación complementaria de Microsoft Excel, y aparece dentro de la interfaz de usuario de Microsoft Excel en forma de menús, cuadros de diálogo y paneles de tareas específicos de PI DataLink.
Mientras que la funcionalidad subyacente de PI DataLink es la misma para Excel XP-2003 y 2007, la interfaz de usuario y las herramientas utilizadas para construir y gestionar hojas de cálculo PI DataLink difieren ligeramente para reflejar el diseño y los objetos disponibles para la versión correspondiente de Microsoft Excel.
Dependiendo de su versión de Excel, tendrá que trabajar con uno de los siguientes grupos de componentes de PI DataLink:
PI DataLink para Excel XP-2003 PI DataLink para Excel 2007
Menú PI Cinta PI
cuadros de diálogo de funciones paneles de tareas de funciones menú contextual del botón derecho del
ratón
menú contextual del botón derecho del ratón Asistente de control de trend Asistente de control de trend
Cuadro de diálogo de Notificaciones PI Cuadro de diálogo de Notificaciones PI
El siguiente apartado describe las diferencias visuales y de funcionamiento entre los complementos PI DataLink.
Capítulo 2
8
PI DataLink para Excel 2007
PI DataLink para Excel 2007 incluye elementos de diseño presentados en Microsoft Office 2007.
Si actualiza desde una versión anterior de PI DataLink, familiarícese con los nuevos elementos de diseño 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ú gráfico que combina funciones de un menú estándar y de una barra de herramientas.
• Haga clic en PI en la barra de menús 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 diálogo o panel de tareas.
• Sitúe 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 diálogo, excepto porque se puede continuar trabajando en una hoja de cálculo mientras el panel de tareas está abierto.
Interfaz de usuario
Manual del usuario de PI DataLink 9
PI DataLink abre un panel de tareas cuando añade una función o selecciona una celda de una matriz de función para editarla. Para abrir un panel de tareas de función:
• Haga clic en la celda de salida deseada y, a continuación, haga clic en una función de la cinta PI para añadir una función.
• Haga clic en una celda de una matriz de función existente para mostrar el panel de tareas correspondiente y editar los argumentos de la función.
• Haga clic con el botón derecho en una celda de matriz de función y seleccione el nombre de la función para mostrar manualmente el panel de tareas.
Nota: Puede desactivar la aparición automática (página 20) de paneles de tareas si lo prefiere.
Una vez que está abierto un panel de tareas de función:
• Introduzca o modifique valores y, a continuación, 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 botón X de la barra de título del panel de tareas para cerrarlo sin guardar los cambios.
• Haga clic en el botón de flecha de la barra de título del panel de tareas para separar y
Mover o Redimensionar el panel de tareas.
También puede hacer clic en la barra de título 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 diálogo se utilizan para otras tareas, incluidas la Búsqueda
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ú estándar y los controles de cuadros de diálogo 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 añade un menú PI a la barra de menús de Excel una vez que el complemento PI DataLink ha sido cargado. Si no ve el menú PI, necesitará
10
PI DataLink para Excel XP-2003 utiliza un menú estándar de configuración:
• Seleccione una opción del menú PI para abrir el correspondiente cuadro de diálogo.
Cuadros de diálogo de función
PI DataLink para Microsoft Excel XP-2003 proporciona cuadros de diálogo para definir funciones de PI DataLink.
PI DataLink abre el correspondiente cuadro de diálogo cuando se añade o edita una función. Para abrir un cuadro de diálogo de función:
• Haga clic en una celda y, a continuación, seleccione una función en el menú PI para añadir una función.
• Haga clic con el botón derecho en una matriz de función existente para mostrar el menú contextual y, a continuación, seleccione el nombre de la función en el menú para editar sus argumentos.
Conexiones del servidor PI
Manual del usuario de PI DataLink 11
Una vez que está abierto un cuadro de diálogo de función:
• Introduzca o modifique valores y, a continuación, haga clic en Aceptar para guardar sus cambios y cerrar el cuadro de diálogo.
PI DataLink recupera automáticamente valores de PI y rellena la matriz de función de su hoja de cálculo cuando haga clic en Aceptar.
• Haga clic en Cancelar o en X para cerrar el cuadro de diálogo sin guardar los cambios.
Menú contextual
PI DataLink añade varios comandos al menú contextual estándar de Microsoft Excel. Puede utilizar estos comandos para gestionar matrices de función que ya estén insertadas en una hoja de cálculo.
Nota: Los menús 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 función de PI DataLink.
Una matriz de función es el grupo de celdas que contiene la salida de una función de PI DataLink. También puede hacer clic con el botón derecho en un control de tren incrustado para ver un menú contextual relacionado (página 59).
En el menú contextual aparecen los siguientes elementos:
• Elija Seleccionar función DataLink para seleccionar la matriz de función completa. Debe seleccionar una matriz antes de intentar copiarla, cortarla o arrastrarla a una nueva ubicación en la hoja de cálculo.
• Seleccione Recalcula (redimensionar) función para recalcular (página 50) la matriz, recuperando nuevos valores de PI.
Para algunas funciones, puede haber disponible un número distinto de valores en cada recálculo, haciendo que la matriz se redimensione.
• Seleccione <nombre de función> para abrir el correspondiente cuadro de diálogo de función (página 10) y actualizar los argumentos para recopilar datos distintos.
Conexiones del servidor PI
Utilice el cuadro de diálogo Conexiones para gestionar las conexiones con los servidores PI de su entorno informático. 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 diálogo Conexiones.
Los servidores PI configurados disponibles para PI DataLink aparecen en el panel
Servidor de la izquierda.
Si no ve el servidor deseado, puede añadir una conexión. Para añadir conexiones a servidores PI adicionales:
12
Seleccione Servidor > Añadir servidor o haga clic con el botón derecho en el panel de servidores y seleccione Añadir servidor en el menú contextual para mostrar el cuadro de diálogo Añadir servidor y configurar una nueva conexión a servidor PI. Una casilla seleccionada junto a un nombre de servidor en el cuadro de diálogo Conexiones indica una conexión abierta a un servidor PI.
Para gestionar la configuración de la conexión:
• Haga clic para seleccionar una casilla y abra una conexión a un servidor PI de la lista. Anule la selección de una casilla para cerrar una conexión.
• Seleccione un servidor PI en el panel de servidores para acceder a la configuración de conexión.
Se requiere una conexión abierta con un servidor PI para añadir funciones DataLink a una hoja de cálculo y recuperar valores de PI. Nota: El nombre del servidor PI predeterminado aparece en la parte inferior derecha del cuadro de diálogo. Puede mantener conexiones con más de un servidor PI a la vez, aunque tendrá que especificar el servidor de destino cuando defina una función PI DataLink.
Componentes de funciones gráficas
PI DataLink proporciona una interfaz gráfica de usuario para construir funciones en Excel. Un cuadro de diálogo común facilita el suministro de argumentos para definir la función.
La herramienta utilizada para construir una función depende de la versión de PI DataLink instalada:
• El complemento para Excel XP-2003 proporciona cuadros de diálogo (página 10) para definir funciones.
• El complemento para Excel 2007 proporciona paneles de tareas (página 8) para definir funciones.
Componentes de funciones gráficas
Manual del usuario de PI DataLink 13
• Los usuarios avanzados familiarizados con PI DataLink y el PI Server pueden
introducir la sintaxis de la función (página 81) directamente en la barra de fórmulas de Excel.
Los siguientes apartados describen funciones comunes en los cuadros de diálogo y paneles de tareas de PI DataLink, el modo en que los datos en tiempo real son obtenidos y presentados, y cómo pueden ser utilizadas las funciones de PI DataLink dentro de una hoja de cálculo.
Campos de entrada
Los campos etiquetados como de entrada aceptan argumentos específicos utilizados para definir una función. La mayor parte de los argumentos pueden ser introducidos
directamente o mediante referencias en celdas de hoja de cálculo. Aunque las opciones son distintas según el argumento, todos los campos de entrada permiten una o más de las siguientes opciones:
• Introducir texto directamente en un campo de edición , por ejemplo, un nombre de tag o la dirección de una celda de salida.
• Seleccionar un elemento entre las opciones de una lista , como, por ejemplo, un cálculo o un método de muestreo.
• Hacer referencia a celdas de hoja de cálculo que contienen argumentos, como, por ejemplo, un nombre de tag, la ubicación de una celda de salida o una marca de tiempo.
Nota: Asegúrese de introducir con un apóstrofe delante (') cadenas en las celdas a las que vaya a hacer referencia. Esto obliga a Excel a interpretar el contenido como una cadena.
• Seleccionar valores de un servidor PI o de otras fuentes mediante una búsqueda en base de datos de módulos o tags.
Por ejemplo, puede introducir una cadena de nombre de tag en el campo Nombre de tag
o hacer clic en el botón junto al campo para mostrar el cuadro de diálogo Búsqueda de tags, y buscar tags en el servidor PI.
También puede proporcionar una referencia a una celda de hoja de cálculo que contenga un nombre de tag:
• Haga clic primero en el campo de edición y después en la celda (o haga clic en la celda y arrastre a una celda adyacente para seleccionar un intervalo) de la hoja de cálculo.
DataLink introduce automáticamente la referencia de celda en el campo de edición. Nota: Algunos campos de entrada muestran una entrada predeterminada cuando el
panel o el cuadro de diálogo se abren. Los campos marcados Opcional son opcionales y no se requiere un valor.
14
Argumentos estándar
Algunos argumentos son comunes a la mayoría de los cuadros de diálogo o paneles de tareas de funciones de PI DataLink, y habitualmente son requeridos para definirlas:
Nombre(s) de tag o Expresión
El campo Nombre(s) de tag o Expresión es requerido por la mayoría de las funciones para evaluar datos de punto (tag) PI o el resultado de una expresión PI (página 75). Uno o más nombres de tag, o la sintaxis de una expresión PI pueden ser:
• Introducidos directamente en un campo. Por ejemplo, sinusoid.
• Introducidos en una o más celdas de hoja de cálculo, a las que después 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 función, mientras que no se pueden especificar varios nombres de tag para una función directamente, a menos que el campo esté etiquetado Nombre(s) de tag. Nota: Recuerde que se añaden 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 diálogo Búsqueda de tags (página 39), basado en una búsqueda de tags por nombre, alias o atributo.
Hora de inicio
El comienzo de un intervalo de tiempo (página 15) a lo largo del cual es evaluada la función, desde Hora de inicio hasta Hora de finalización. Todos los valores de evento correspondientes al intervalo de tiempo son recuperados del archivo PI o calculados para crear la matriz de función resultante.
Hora de finalización
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 finalización pueden ser expresadas en términos absolutos o relativos para establecer un intervalo de tiempo en el pasado o hasta, incluida, la hora actual.
Servidor PI
Una instancia de una función 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 (página 11).
Los servidores que aparecen por encima de la línea de puntos en la lista de servidores, están conectados actualmente; los de debajo están desconectados.
Componentes de funciones gráficas
Manual del usuario de PI DataLink 15
Celda de salida
Especifique dónde desea colocar la matriz de función resultante utilizando el campo
Celda de salida. Si selecciona una celda antes de que se muestre el cuadro de diálogo 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 función. Si añade (página 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 ubicación de la celda de salida, sobrescribiendo datos en las celdas adyacentes.
Si hace clic en el campo Celda de salida y, a continuación, selecciona una matriz
multicelda en la hoja de cálculo, puede anular la presentación predeterminada de todos los resultados de la función. En su lugar, solo los resultados que encajen dentro de las
dimensiones de la matriz especificada serán mostrados.
Argumentos de tiempo
Muchas funciones de PI DataLink requieren argumentos Hora de inicio y Hora de finalización para recuperar una matriz de valores de evento a lo largo de un intervalo de tiempo específico. Siga estas indicaciones para especificar argumentos de tiempo:
• Las cadenas de tiempo pueden introducirse directamente en los campos de edición, ya sea en formato de tiempo PI (página 71) absoluto o relativo (por ejemplo,
10-dic-99 19:12 o -3h).
• Si la hora de inicio es más reciente que la hora de finalización, los resultados se muestran en orden cronológico inverso.
• Las marcas de tiempo a las que se hace referencia en celdas de hoja de cálculo pueden utilizar también los formatos de tiempo PI fijo y relativo, y deben ser precedidas por un apóstrofe para indicar una cadena (por ejemplo, '10-dic-99 19:12 o '-3h).
• Las referencias de celda también 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 número acumulado de días 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 duración de tiempo, representado por un único valor en lugar de horas de inicio y finalización. Ya sea mediante referencia o introducidos directamente, los valores de intervalo deben utilizar cadenas de tiempo PI relativo, como un número 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 términos 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 finalización de la función. 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 finalización relativa.
16
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 añadidos
Las marcas de tiempo son particularmente importantes para los eventos de punto PI. Cada valor de evento es acompañado por una marca de tiempo que le proporciona contexto. La mayoría 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 añadidos a los valores devueltos en una matriz de función PI, e incluyen:
• marcas de tiempo de evento
• marcas de tiempo que indican las horas de inicio y finalización de un intervalo
• marcas de tiempo que indican la ocurrencia de los valores mínimo y máximo
• 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 añadidos aparecen en columnas (o filas) adyacentes a los valores principales devueltos por una función conforme a las siguientes reglas:
• Los datos temporizados se añaden en columnas a la izquierda (o en filas encima) de los valores principales.
• Otros datos relacionados se añaden en columnas a la derecha (o en filas debajo) de los valores principales.
Componentes de funciones gráficas
Manual del usuario de PI DataLink 17
Matriz de datos añadidos
La tabla siguiente ilustra cómo son añadidos los datos por función. Para las funciones que puedan mostrar la salida en filas o columnas (página 19), sustituya las Columnas 1-5 por las Filas 1-5.
Columnas de matriz de función
Función/modo Celda de
salida
Columna 2 Columna 3 Columna 4 Columna 5 Cualquier función con
datos añadidos
valor Valor actual e histórico,
Datos de muestra marca de tiempo valor Datos comprimidos marca de
tiempo valor anotaciones Filtrado de tiempo hora de inicio hora de
finalización
valor porcent. correcto Calculado (mínimo) hora de inicio hora de
finalización
tiempo mín. valor mín. Calculado (máximo) hora de inicio hora de
finalización
tiempo máx.: valor máx.: Calculado (intervalo) hora de inicio hora de
finalización tiempo mín. tiempo máx.: valor Calculado (otros) hora de inicio hora de
finalización
valor porcent. correcto
Alias servidor valor
Nota: La tabla da por hecho que todos los datos añadidos se especifican para su visualización, y que algunas matrices de función se pueden extender hasta cinco columnas si se añaden todos los datos relacionados.
Mostrar marcas de tiempo
Cuando una función devuelve una matriz de valores PI a lo largo del tiempo, aparece una casilla mostrar marcas de tiempo. Si se selecciona, esta opción 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 orientación (página 19) determinan el modo en que las marcas de tiempo se muestran en relación con cada valor..
Para algunas funciones que devuelven un único valor (por ejemplo, Valor actual), se proporcionan botones de selección para facilitar las opciones equivalentes:
• Seleccione sin marca de tiempo para suprimir la visualización 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.
18
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 orientación de la matriz de tags de entrada. Para los nombres de tag en una única columna, las marcas de tiempo aparecerán a la izquierda de los valores. Para los nombres de tag en una única fila, las marcas de tiempo aparecerán encima de los valores.
Marcas de tiempo de intervalo
Las funciones que devuelven valores a intervalos de tiempo específicos (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 finalización para mostrar la hora de finalización de cada intervalo.
Para los valores calculados de mínimo, máximo e intervalo:
• Seleccione mostrar tiempo mín/máx para mostrar marcas de tiempo para los valores mínimo y máximo de cada intervalo.
Las marcas de tiempo se muestran de forma coincidente con la orientación 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 finalización, hora del valor mínimo, hora del valor máximo, 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 añadir 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 válidos y que no están en estado de error. El porcentaje de valores correctos ayuda a valorar la fiabilidad de los cálculos generados en valores de puntos PI, particularmente si los valores calculados van a ser utilizados en otros cálculos.
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 fracción del intervalo en la que hay disponibles datos correctos.
Sin embargo, esta normalización 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 fracción extensa del intervalo de tiempo contiene datos malos.
Componentes de funciones gráficas
Manual del usuario de PI DataLink 19
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 añadido 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 precisión 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 añadidos a un valor de dato en PI con propósitos descriptivos.
Controles de orientación
Para las funciones que devuelven una matriz de valores PI, utilice los botones columna y
fila para determinar la orientación de los datos devueltos.
• Seleccione columna para mostrar los datos en columnas.
• Seleccione fila para mostrar los datos en filas.
Se añadirán filas o columnas adicionales (página 16) para marcas de tiempo y datos adicionales si son seleccionados para su visualización. El campo Salida de la función indica la esquina superior izquierda del intervalo completo utilizado para la matriz. Nota: Para las funciones que devuelven un intervalo de valores, la orientación de la
matriz de tag de entrada anula la selección de fila y columna para determinar la orientación de los datos de salida.
Formatos de presentación
Puede cambiar los formatos predeterminados de fecha y número utilizados por PI DataLink para dar formato a los datos en las matrices de función. Los formatos predeterminados se especifican en el cuadro de diálogo Configuración (página 20), en donde hay disponibles dos configuraciones para los formatos:
20
• El formato de número predeterminado General da formato a los números (y a todos los datos que no son marcas de tiempo) para coincidir con el formato Categoría
General del cuadro de diálogo Formato de celdas de Excel.
• El formato de fecha predeterminado dd-mmm-aa hh:mm:ss coincide con el formato de marca de tiempo estándar de PI. Puede añadir ,000 al final de la cadena ( dd-mmm-aa hh:mm:000) para mostrar marcas temporales por debajo de un segundo. Tenga en cuenta que Excel no admite formatos con precisión de microsegundos.
Puede personalizar las cadenas de formato predeterminadas utilizando cualquier código de formato de Excel válido del cuadro de diálogo 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.
También puede aplicar un formato de fecha y hora individual a cualquier celda de hoja de cálculo, incluidas las que contienen funciones de PI DataLink, seleccionando Formato > Celdas > Número. Consulte su documentación sobre Excel para obtener más
Configuración de preferencia
Manual del usuario de PI DataLink 21
Configuración de preferencia
Utilice el cuadro de diálogo Configuración para especificar preferencias globales y formatos predeterminados para la salida de las funciones de PI DataLink.
Para acceder a la configuración:
1. Haga clic en Configuración en la cinta PI(2007), o seleccione PI > Configuración
(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 Búsqueda de tags(o los elementos de una búsqueda Buscar módulo) a la hoja de cálculo en una fila o columna de valores, respectivamente. La configuración predeterminada es En una columna.
El comando también está disponible como acceso directo a la opción de la cinta
22
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 cálculo.
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 opción es relevante únicamente si un servidor PI tiene un ajuste de zona horaria distinto del de la máquina 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 función. Las funciones añadidas a una hoja de cálculo mantienen su tamaño de matriz original, incluso si la variación en un periodo de tiempo en particular produce menos valores de datos, dando como resultado una o más celdas vacías.
Esta función es particularmente útil cuando los resultados de la función se trazan mediante el paquete de gráficas 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 están en inglés 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 configuración regional del ordenador cliente, recurriendo al formato de tiempo PI solo si es necesario. Desactivar la visualización automática del panel de tareas al hacer clic Solo para Excel 2007, seleccione esta casilla para evitar la aparición automática del panel de tareas de función al hacer clic en una celda de función. Haga clic con el botón derecho para mostrar el menú contextual y seleccionar el nombre de la función 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 número de valores recuperados por una matriz recalculada exceda el número que se puede mostrar. Formato de número
Introduzca un formato numérico para indicar cómo debe mostrarse de forma predeterminada la salida de una función numérica. La cadena de formato puede ser cualquier código de formato numérico válido del cuadro de diálogo Formato de Excel
(página 19).
Durante le instalación, PI DataLink asigna el formato numérico predeterminado de Excel a este campo, a menos que haya ajustado su propia preferencia de formato anteriormente en DataLink. Si su versión de Excel se ejecuta con un formato local diferente, este formato incluye la sintaxis correcta para reflejarlo.
Construcción de una hoja de cálculo
Manual del usuario de PI DataLink 23
Por ejemplo: 35.03 aparecerá como 35,03 en Excel francés. Formato de hora
Introducir un formato de marca de tiempo para la salida de la función. La cadena de formato puede ser cualquier código de formato de fecha-hora (página 15) válido del cuadro de diálogo Formato de Excel.
Durante le instalación, 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 versión 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 francés.
Actualización automática
Utilice este apartado para ajustar preferencias para la Actualización automática (página 49) cuando esta función está activada.
Seleccione un método de cálculo:
• Calcular (F9) fuerza el recálculo de todas las funciones volátiles (y de las funciones que hagan referencia a ellas).
• Cálculo completo (Ctrl+Alt+Mayúsculas+F9) fuerza el recálculo de todas las funciones incrustadas, independientemente de la volatilidad.
A continuación, introduzca un intervalo de cálculo en segundos. El valor mínimo es 5 segundos. Introduzca 0 para aceptar el intervalo automático seleccionado por PI DataLink en base a la duración de los tiempos de cálculo anteriores.
Construcción de una hoja de cálculo
Una vez familiarizado con los conceptos y herramientas básicas de PI DataLink y preparado para crear una hoja de cálculo y utilizar las funciones de PI DataLink, ¿por dónde empezar?
Sus objetivos
En primer lugar, considere sus objetivos.
• ¿Qué datos desea mostrar en una hoja de cálculo a fin de controlar el rendimiento o responder a un problema del negocio?
• ¿En qué PI Server residen los datos?
• ¿Cómo puede mostrar de la forma más eficaz la información, tanto para comunicar puntos esenciales como para proporcionar el necesario contexto de fondo?
24
Las respuestas le ayudarán a determinar qué funciones de PI DataLink pueden devolver los datos más adecuados para la tarea.
Funcional
Una manera de construir una hoja de cálculo consiste simplemente en añadir funciones
(página 25), creando a su alrededor su presentación según sea necesario. Más tarde puede añadir información de tags para ayudar a clarificar lo que representan los datos. Este puede ser el mejor enfoque si todavía está explorando sus requerimientos o aprendiendo cómo funciona PI DataLink.
Estructurada
Otra forma de construir una hoja de cálculo es añadir una estructura desde el principio. Utilice la búsqueda de tags y las funciones de tags (página 39) para añadir tags y otros atributos como metadatos para estructurar su contenido y, después, añada funciones para recuperar los datos de puntos PI correspondientes. Esto requiere algo más de planificación y familiaridad con PI DataLink, pero una vez que la información de los tag esté presente en la hoja de cálculo, puede utilizarla para crear las funciones más fácilmente mediante referencias de celda. Las hojas de cálculo construidas de esta manera son también más flexibles para su reutilización.
Basada en módulos
Si tiene una PI Module Database configurada para su servidor PI, puede incorporar máxima flexibilidad a su hoja de cálculo incorporando objetos de la base de datos de módulos (página 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 módulos. También se pueden añadir funciones de contexto de módulos para maximizar la potencial reutilización de la hoja de cálculo sobre objetos paralelos o redundantes.
Orientados a informes
Si es usted administrador del sistema o creador de hojas de cálculo para otros usuarios, tal vez desee poner funciones de PI DataLink en una segunda hoja de cálculo de un libro de trabajo y copiar/pegar los resultados de la primera hoja para mostrarlos. La sintaxis de las funciones y la lógica del negocio pueden ocultarse y protegerse utilizando Excel para asegurar la segunda hoja de cálculo. Esta estrategia también funciona bien para los documentos distribuidos mediante PI DLES (página 2).
Manual del usuario de PI DataLink 25
Las funciones de PI DataLink le permiten consultar, calcular y devolver atributos y valores de puntos PI a celdas de hoja de cálculo. 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 según se necesite.
Para acceder a las funciones PI:
• Haga clic en la celda de salida deseada y, a continuación, seleccione PI > (nombre de función) para abrir un cuadro de diálogo de función (XP-2003), o haga clic en una función en la cinta PI para abrir un panel de tareas de nueva función (2007).
Las descripciones de funciones de este apartado describen argumentos específicos de cada función en cuanto a esas características comunes.
Valor actual
Recupera el valor actual, o el más reciente (snapshot) de un punto PI, basándose 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 cálculo. Para forzar un recálculo inmediato, pulse F9.
EJEMPLO
Para ver el valor actual del tag sinusoid, se han de ajustar los siguientes argumentos
para la función Valor actual:
Nombre de tag = sinusoid
tiempo a la izquierda
y la matriz de función resultante aparece como:
TEMAS RELACIONADOS
• PICurrVal() (página 87)
Capítulo 3
26
Valor de archivo histórico
Recupera un valor de punto PI, o evalúa una expresión correspondiente a una marca de tiempo específica.
ARGUMENTOS OBLIGATORIOS
• Nombre de tag o expresión
• 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 (página 15) fijo o expresado en relación a la hora actual.
MODO DE RECUPERACIÓN
Se puede elegir entre 5 modos para producir un valor de archivo.
• Anterior - recupera el valor del archivo histórico 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 histórico 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 ningún 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 cálculo Auto e Interpolado, respectivamente.
• PIExpVal() se utiliza si una expresión es sustituida por un tag; en caso contrario,
se utiliza PIArcVal().
EJEMPLO
Para ver el valor del tag sinusoid correspondiente a un tiempo específico, se han de
ajustar los siguientes argumentos para la función Valor de archivo histórico:
Nombre de tag = sinusoid
Marca de tiempo = 30-Sep-07 15:13
Modo de recuperación = anterior
Datos comprimidos
Manual del usuario de PI DataLink 27
y la matriz de función resultante aparece como:
TEMAS RELACIONADOS
• PIArcVal() (página 88)
• PIExpVal() (página 88)
Datos comprimidos
Devuelve todos los valores de un punto PI que se producen dentro de un intervalo de tiempo especificado o un número de valores de punto comenzando a una hora determinada.
Los valores comprimidos son datos grabados por el servidor PI después de que un algoritmo de compresión haya eliminado todos los valores que representan la misma pendiente.
Nota: Se proporcionan cuadros de diálogo separados para Datos comprimidos (hora de inicio/Hora de finalización) y Datos comprimidos (Hora de inicio/Número) en PI DataLink para Excel XP-2003. Para 2007, puede seleccionar un cálculo de Intervalo de tiempo o de Número de valores en el panel de tareas.
ARGUMENTOS OBLIGATORIOS
• Nombre de tag
• Hora de inicio
• Hora de finalización o Número de valores, dependiendo del tipo de función
EXPRESIÓN DE FILTRO
Añadir una expresión de filtro para filtrar valores de evento utilizando una expresión matemática, eliminando datos por los que la expresión se evalúa como falso. La expresión de filtro se aplica a los datos sin tratar de PI (y no a los valores que resultan del propio cálculo).
Por ejemplo, la simple expresión de filtro: sinusoid < 70
eliminará del cálculo todos los valores por encima de 70. También puede utilizar
cualquier ecuación de rendimiento PI en la expresión de filtro para crear expresiones más complejas para eliminar picos atípicos en valores de datos, por ejemplo.
Seleccione marcar como filtrado para sustituir Filtrado como marcador de posición para cada valor o bloque de valores filtrado de la raíz basada en el filtro expression (página 75).
28
TIPO DE LÍMITE
Especifique un tipo de límite para determinar el modo en que es gestionada la búsqueda de valores de datos por el Editor de archivo histórico cerca de las horas de inicio y de finalización del intervalo de valores:
• Dentro (predeterminado): Devuelve los valores en las horas de inicio y finalización, o los más próximos que se produzcan dentro del intervalo.
• Fuera: Devuelve los valores más próximos que se produzcan inmediatamente fuera del intervalo.
• Interpolado: Devuelve valores interpolados en las horas de inicio y finalización.
• 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 añadido 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 precisión 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 añadidos a un valor de dato en PI con propósitos 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 finalización 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 compresión del PI Server, no puede ser grabado realmente en PI.
Datos comprimidos
Manual del usuario de PI DataLink 29
• La función PICompFilDat() se utiliza para funciones de Hora de finalización si
se especifica una expresión de filtro; en caso contrario, se utiliza la funciónPICompDat().
• La función PINCompFilDat() se utiliza para funciones de Número de valores si
se especifica una expresión de filtro; en caso contrario, se utiliza la funciónPINCompDat().
EJEMPLO
Para ver los 10 valores más recientes del tag sinusoid, se han de ajustar los siguientes
argumentos para la función Datos comprimidos:
Número de valores
Nombre de tag = sinusoid
Hora de inicio = <referencia de celda a la hora actual>
Número de valores = 10
atrás en el tiempo Tipo de límite = interior
mostrar marcas de tiempo columna
y la matriz de función resultante aparece como:
Observe que todos los eventos entre dos tiempos especificados pueden ser recuperados también por la misma función utilizando el argumento Intervalo de tiempo.
TEMAS RELACIONADOS
• Expresiones de filtro (página 75)
• PICompDat() (página 91)
• PICompFilDat() (página 92)
• PINCompDat() (página 90)
30
Datos de muestra
Devuelve valores de muestra interpolados, separados por espacios, de una expresión o punto PI a lo largo de un intervalo regular.
ARGUMENTOS OBLIGATORIOS
• Nombre de tag o expresión
• Hora de inicio
• Hora de finalización
• Intervalo de tiempo
INTERVALO DE TIEMPO
Introduzca un intervalo de tiempo como una expresión de tiempo PI (página 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.
EXPRESIÓN DE FILTRO
Añadir una expresión de filtro para filtrar valores de evento utilizando una expresión matemática, eliminando datos por los que la expresión se evalúa como falso. La expresión de filtro se aplica a los datos sin tratar de PI (y no a los valores que resultan del propio cálculo).
Por ejemplo, la simple expresión de filtro: sinusoid < 70
eliminará del cálculo todos los valores por encima de 70. También puede utilizar
cualquier ecuación de rendimiento PI en la expresión de filtro para crear expresiones más complejas para eliminar picos atípicos en valores de datos, por ejemplo.
Seleccione marcar como filtrado para sustituir Filtrado como marcador de posición para cada valor o bloque de valores filtrado de la raíz basada en el filtro expression (página 75).
NOTAS ESPECIALES
• Puede utilizar una PI Expression (página 75) para esta función, 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 función PISampFilDat() se utiliza si se especifica una expresión de filtro; en
caso contrario, se utiliza la funciónPISampDat().
Datos temporizados
Manual del usuario de PI DataLink 31
EJEMPLO
Para ver valores periódicos, interpolados durante las 24 horas anteriores para el tag
sinusoid, se han de ajustar los siguientes argumentos para la función Datos de
muestra:
Nombre de tag = sinusoid
Hora de inicio = -1d
Hora de finalización = <referencia de celda a la hora actual>
Intervalo de tiempo = 3h
mostrar marcas de tiempo columna
y la matriz de función resultante aparece como:
en donde se muestra un valor por cada intervalo de 3 horas
TEMAS RELACIONADOS
• PISampDat() (página 93)
• PISampFilDat() (página 94)
• PIExpDat() (página 96)
Datos temporizados
Devuelve 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 más celdas de hoja de cálculo que contienen valores de marcas de tiempo.
32
MODO DE RECUPERACIÓN
Existen dos modos de selección:
• 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 ningún valor.
NOTAS ESPECIALES
• Puede utilizar una PI Expression (página 75) para esta función, 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 cálculo 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 función 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 recuperación = interpolado
y la matriz de función 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.
Datos calculados
Manual del usuario de PI DataLink 33
TEMAS RELACIONADOS
• PITimeDat() (página 96)
• PITimeExpDat() (página 97)
Datos calculados
Devuelve uno o más valores calculados, separados por espacios, basados en valores de punto PI o expresiones evaluadas. Se proporcionan varios cálculos distintos y
preferencias de muestreo.
Nota: Se proporcionan cuadros de diálogo separados para Datos calculados y Datos calculados avanzados en PI DataLink para Excel XP-2003. Para la versión 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 expresión
• Hora de inicio
• Hora de finalización
• Factor de conversión
EXPRESIÓN DE FILTRO
Añadir una expresión de filtro para filtrar valores de evento utilizando una expresión matemática, eliminando datos por los que la expresión se evalúa como falso. La expresión de filtro se aplica a los datos sin tratar de PI (y no a los valores que resultan del propio cálculo).
Por ejemplo, la simple expresión de filtro: sinusoid < 70
eliminará del cálculo todos los valores por encima de 70. También puede utilizar
cualquier ecuación de rendimiento PI en la expresión de filtro para crear expresiones más complejas para eliminar picos atípicos en valores de datos, por ejemplo.
Seleccione marcar como filtrado para sustituir Filtrado como marcador de posición para cada valor o bloque de valores filtrado de la raíz basada en el filtro expression (página 75).
INTERVALO DE TIEMPO
Introduzca un intervalo de tiempo como una expresión de tiempo PI (página 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.
34
MODO DE CÁLCULO
Se proporcionan los siguientes cálculos:
• Total • Mínimo • Máximo • Desviación estándar • Intervalo • Promedio • Recuento • Media
Todos los modos de cálculo son ponderados en el tiempo excepto para la función media, que es una versión ponderada a evento de la función promedio.
BASES DE CÁLCULO
Seleccione para el cálculo una base ponderada en el tiempo o el evento:
• Los cálculos son ponderados en el tiempo de forma predeterminada. Cada valor de evento es ponderado con fines del cálculo por la duración de tiempo sobre la que se aplica el evento.
• Los cálculos ponderados en eventos ponderan la calidad de cada valor de evento. Debe existir al menos un evento (dos para cálculos de desviación estándar) dentro de un intervalo de tiempo para que el cálculo sea correcto.
FACTOR DE CONVERSIÓN
El factor de conversión es utilizado para los cálculos 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 conversión para convertir las unidades deseadas para el cálculo a partir de las unidades por día predeterminadas en el servidor.
La tabla siguiente ilustra el uso de factores de conversión para puntos utilizando
diferentes unidades de flujo. Tenga en cuenta que un factor de conversión de uno significa que el factor de conversión no es necesario, y que no se pueden especificar unidades.
Unidad de flujo Factor de conversión necesario para coincidir con el predeterminado del servidor (unidades/día)
Unidades/día 1.0 Unidades/hora 24 Unidades/minuto 1440 Unidades/segundo 86400