PI DataLink 2014 User Guide ES

 

PI DataLink 2014 Manual del usuario

 

OSIsoft, LLC 777 Davis St., Suite 250 San Leandro, CA 94577 EE.UU. Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Web: http://www.osisoft.com Manual del usuario de PI DataLink 2014 © 1992-2014 by 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, mecánico, fotocopiado, grabado o de cualquier otro modo, sin el consentimiento previo por escrito de OSIsoft, LLC. OSIsoft, el logotipo de OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset  Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports and RtWebParts son todas marcas comerciales de OSIsoft, LLC. Todas las otras marcas comerciales 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, LLC, de acuerdo con lo que establecen las regulaciones DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, según proceda. OSIsoft, LLC. Versión: 5.1.0 Publicación: 9 de abril de 2014

 

Contenido Introducción................ Introducción... ........................... ........................... .......................... .......................... ........................... ........................... ...................... ......... 1 Descripción general de PI DataLink........................................................................................................... DataLink...........................................................................................................11 PI DataLink Server (DLS).......................................................................................................................2 Acerca de esta versión.............................................................................................................................. versió n.............................................................................................................................. 2 Requisitos del sistema...........................................................................................................................2 sistema...........................................................................................................................2 Actualización de compatibilidad........................................................................................................... compatibilidad........................................................................................................... 2 Tipos de datos admitidos...................................................................................................................... admitidos...................................................................................................................... 3 Proceso de configuración configuración de PI DataLink.................................................................................................. 4 Instalar PI DataLink...............................................................................................................................4 DataLink...............................................................................................................................4 Instalación silenciosa.............................................................................................................................5 silenciosa.............................................................................................................................5 Ver PI DataLink en en un idioma compatible..............................................................................................5 Preferencias de conexión conexión a PI Server Server collectives.................................................................................... 5 Configuración de Configuración  de PI Server....................................................................................................................6 Server.................................................................................................................... 6 Configuración del complemento para Microsoft Excel.............................................................................. 6 Ver el estado de los complementos....................................................................................................... 7 Activar un complemento complemento desactivado....................................................................................................7 Activar un complemento complemento desactivado................................................................................................... 8 Recomendaciones de seguridad................................................................................................................8 de seguridad................................................................................................................8 Seguridad de los archivos archivos Excel.............................................................................................................8 Seguridad del complemento complemento para Excel................................................................................................ 9 Privilegios de las cuentas.....................................................................................................................10 cuentas.....................................................................................................................10 Prácticas de seguridad seguridad organizativa.....................................................................................................10 Estrategias de registro.........................................................................................................................11 registro.........................................................................................................................11 Acerca de este documento...................................................................................................................... documento...................................................................................................................... 11

Conceptos básicos........... básicos........................ .......................... .......................... ........................... ........................... .......................... .................. ..... 13 Interfaz de usuario...................................................................................................................................13 usuario...................................................................................................................................13 Pestaña PI DataLink............................................................................................................................ DataLink............................................................................................................................ 13 Paneles de tareas de d e funciones............................................................................................................14 Menú contextual..................................................................................................................................15 contextual..................................................................................................................................15 Descripción general general de las funciones de PI DataLink................................................................................15 Elementos de datos.............................................................................................................................16 Campo de entrada............................................................................................................................... entrada............................................................................................................................... 17 Campos de entrada de entrada de tiempo............................................................................................................. 17 Datos añadidos................................................................................................................................... añadidos................................................................................................................................... 18 Formatos de presentación...................................................................................................................19 presentación...................................................................................................................19 Búsquedas.............................................................................................................................................. Búsquedas................. ............................................................................................................................. 19 Buscar elementos de de datos................................................................................................................. 20 Buscar activos mediante mediante filtros............................................................................................................24 Configuración de pref erencia.................................................................................................................. erencia.................................................................................................................. 26 Límites de configuración configuración de zona horaria............................................................................................ 28 Gestionar conexiones con conexiones con servidores...................................................................................................... 29

Creación de hojas de de cálculo......... cálculo...................... .......................... ........................... ........................... .......................... ................... ...... 31 Proceso de creación de de hojas de cálculo.................................................................................................. 31 Despliegues relacionados relacionados con activos......................................................................................................32 Crear un despliegue despliegue relacionado con activos....................................................................................... 32 Eventos en hojas de cálculo..................................................................................................................... cálculo..................................................................................................................... 35 Explorar los eventos eventos relacionados con un elemento............................................................................. 37 Explorar eventos con con eventos secundarios.......................................................................................... 39 Comparación de eventos eventos mediante la inclusión de eventos secundarios.............................................. secundarios.............................................. 41 Comparación de eventos eventos mediante la inclusión de eventos principales................................................47 Nombres de atributo atributo reservados......................................................................................................... 49 Manual del usuario de PI DataLink 2014 

iii

 

Contenido

Funciones de PI DataLink....... DataLink.................... ........................... ........................... .......................... ........................... ......................... ........... 51 Función Valor actual................................................................................................................................51 Ejemplo de Valor actual.......................................................................................................................52 Función Valor de archivo histórico...........................................................................................................53 Ejemplo de Valor de archivo................................................................................................................ 55 Función Datos comprimidos....................................................................................................................55 comprimidos....................................................................................................................55 Ejemplo de Datos comprimidos........................................................................................................... comprimidos........................................................................................................... 57 Función Datos de muestra.......................................................................................................................58 muestra.......................................................................................................................58 Ejemplo de Datos de de muestra............................................................................................................. 60 Función Datos temporizados...................................................................................................................61 temporizados...................................................................................................................61 Ejemplo de Datos temporizados......................................................................................................... temporizados......................................................................................................... 62 Función Datos calculados........................................................................................................................63 calculados........................................................................................................................63 Ejemplo de Datos calculados............................................................................................................... calculados............................................................................................................... 67 Función Filtrado de tiempo......................................................................................................................67 tiempo......................................................................................................................67 Ejemplo de Filtrado  Filtrado de tiempo............................................................................................................ 69 Función Explorar eventos........................................................................................................................ eventos........................................................................................................................ 70 Referencia del panel panel de tareas Explorar eventos.................................................................................. eventos.................................................................................. 70 Ejemplo de Explorar Explorar eventos............................................................................................................... 74 Función Comparar eventos......................................................................................................................74 eventos......................................................................................................................74 Referencia del panel panel de tareas Comparar eventos................................................................................75 Notación de ruta para ruta para la funció función n Comparar eventos............................................................................80 eventos............................................................................ 80 Ejemplo de comparación comparación de eventos................................................................................................... 80 Función de búsqueda de filtro de activo...................................................................................................81 Función Propiedades...............................................................................................................................81 Propiedades...............................................................................................................................81 Ejemplo de propiedades...................................................................................................................... propiedades...................................................................................................................... 83

Uso y mantenimien mantenimiento to de las hojas de cálculo........ cálculo...................... ........................... .......................... ...................... ......... 85 Matrices de función.................................................................................................................................85 función.................................................................................................................................85 Tareas comunes relacionadas con las matrices de función...................................................................85 Actualizar entradas en entradas en una matriz de función......................................................................................86 Tamaño de la matriz............................................................................................................................87 matriz............................................................................................................................87 Redimensionar matrices......................................................................................................................87 matrices......................................................................................................................87 Frecuencia de cálculo.............................................................................................................................. cálculo.............................................................................................................................. 88 Función Actualización Actualización automática.......................................................................................................88 Recálculo provocado........................................................................................................................... provocado........................................................................................................................... 89 Recalcular manualmente.....................................................................................................................90 Compartir hojas de cálculo......................................................................................................................90 cálculo......................................................................................................................90 Definir la opción Cálculo de libro de trabajo como manual...................................................................91

Temas avanzados................ avanzados............................. .......................... .......................... ........................... ........................... .......................... ............... 93 Tiempo PI................................................................................................................................................93 PI................................................................................................................................................93 Abreviaturas de tiempo tiempo PI................................................................................................................... 93 Expresiones de tiempo tiempo PI.................................................................................................................... 94 Especificación de intervalos intervalos de tiempo................................................................................................94 Especificación de intervalos intervalos de tiempo................................................................................................95 Expresiones............................................................................................................................................ Expresiones........... ................................................................................................................................. 96 Uso de expresiones en expresiones en funciones de PI DataLink..................................................................................97 Sintaxis de las expresiones.................................................................................................................. expresiones.................................................................................................................. 97 Restricciones relativas relativas a los elementos de datos en expresiones..........................................................97 expresiones.......................................................... 97 Ejemplos de expresiones.....................................................................................................................98 expresiones.....................................................................................................................98 Expresiones de filtro............................................................................................................................98 filtro............................................................................................................................98 Entrada manual de funciones..................................................................................................................98 Definir funciones manualmente.......................................................................................................... manualmente.......................................................................................................... 99 Pautas para introducir introducir argumentos de forma manual..........................................................................99 Códigos de salida...............................................................................................................................100 salida...............................................................................................................................100 Funciones para escribir escribir datos.................................................................................................................101 iv

Manual del usuario de PI DataLink 2014

 

Contenido

Funciones de tags......... tags...................... ........................... ........................... .......................... .......................... ........................... ................... ..... 103 Función Apuntar ID al Tag..................................................................................................................... 103 Ejemplo de Apuntar ID al Tag............................................................................................................ 104 Función Máscara de atributo para tag................................................................................................... 104 Ejemplo de Máscara de atributo para tag...........................................................................................105 Buscar PI points.....................................................................................................................................105

Tendencias.................. Tendencias..... .......................... ........................... ........................... .......................... .......................... ........................... .................... ......107 107 Crear una tendencia...............................................................................................................................107 tendencia.. .............................................................................................................................107 Crear un trazo de valores valores en la hoja de cálculo................................................................................... 108 Crear un trazo de valores valores de PI point obtenidos de un PI Server.........................................................109 Menú contextual de tendencias.............................................................................................................109 tendencias.............................................................................................................109

Objetos de PI Module Module Database....... Database..................... ........................... .......................... .......................... ........................... .............. 111 PI Module Database y hojas y hojas de cálculo...................................................................................................111 Insertar objetos de PI Module Database en la hoja de cálculo.................................................................111 Funciones de bases de de datos de módulos...............................................................................................112 Función Alias para tag........................................................................................................................113 tag........................................................................................................................113 Función Propiedad para valor.............................................................................................................113

Notificaciones.................... Notificaciones....... .......................... .......................... ........................... ........................... .......................... .......................... ............. 115 Búsqueda e inserción de notificaciones..................................................................................................115 Añadir un servidor de PI AF a la función fu nción Búsqueda de notificación..................................................... 116 Ajustar la visualización visualización de las notificaciones recuperadas...................................................................117 Gestionar las notificaciones notificaciones recuperadas........................................................................................... 118 Notificaciones insertadas...................................................................................................................... insertadas...................................................................................................................... 118 Configuración de visualización visualización de notificaciones................................................................................... 118

Referencia de función......... función...................... .......................... ........................... ........................... .......................... .......................... ............... 121 Funciones de valor único....................................................................................................................... único....................................................................................................................... 121 PICurrVal().........................................................................................................................................121 PICurrVal()......... ................................................................................................................................121 PIArcVal().......................................................................................................................................... PIArcVal()....... ................................................................................................................................... 122 PIExpVal()..........................................................................................................................................123 PITagAtt()......................................................................................................................................... PITagAtt().......... ............................................................................................................................... 124 Funciones de valor múltiple...................................................................................................................124 PINCompDat()...................................................................................................................................125 PINCompDat()....... ............................................................................................................................125 PINCompFilDat()............................................................................................................................... PINCompFilDat()... ............................................................................................................................ 126 PICompDat()......................................................................................................................................127 PICompDat()......... .............................................................................................................................127 PICompFilDat()..................................................................................................................................128 PICompFilDat().. ................................................................................................................................128 PISampDat()......................................................................................................................................129 PISampDat().. ....................................................................................................................................129 PISampFilDat().................................................................................................................................. 130 PIExpDat()......................................................................................................................................... PIExpDat()............. ............................................................................................................................ 131 PITimeDat()....................................................................................................................................... PITimeDat()........... ............................................................................................................................ 132 PITimeExpDat()................................................................................................................................. PITimeExpDat(). ................................................................................................................................ 133 Funciones de cálculo..............................................................................................................................134 cálculo..............................................................................................................................134 PIAdvCalcVal()...................................................................................................................................135 PIAdvCalcVal()... ................................................................................................................................135 PIAdvCalcFilVal()............................................................................................................................... PIAdvCalcFilV al()............................................................................................................................... 136 PIAdvCalcExpVal()............................................................................................................................. 137 PIAdvCalcExpFilVal()......................................................................................................................... PIAdvCalcExpFil Val()......................................................................................................................... 139 PIAdvCalcDat().................................................................................................................................. PIAdvCalcDat()...... ............................................................................................................................ 141 PIAdvCalcFilDat().............................................................................................................................. PIAdvCalcFilDat().. ............................................................................................................................ 142 PIAdvCalcExpDat()............................................................................................................................ PIAdvCalcExpDa t()............................................................................................................................ 144 PIAdvCalcExpFilDat().........................................................................................................................145 PIAdvCalcExp FilDat().........................................................................................................................145 PITimeFilter().....................................................................................................................................147 PITimeFilter(). ....................................................................................................................................147 PITimeFilterVal()............................................................................................................................... 148

Manual del usuario de PI DataLink 2014 

v

 

Contenido Funciones de tags..................................................................................................................................149 PIPointIDToTag().............................................................................................................................. 149 PIAttributeMaskToTag ()................................................................................................................... 150 Funciones de Module Database............................................................................................................. Database............................................................................................................. 151 PIAliasToTag()................................................................................................................................... 151 PIPropertyToValue()..........................................................................................................................152 Funciones de entrada............................................................................................................................ 152 PIPutVal() y PIPutValX().....................................................................................................................152

Resolución de problemas....... problemas.................... .......................... .......................... ........................... ........................... ........................155 ...........155 Archivos de registro...............................................................................................................................155 La pestaña PI DataLink no está disponible.............................................................................................155 Límites de matriz y de celda.................................................................................................................. 156 Límites de recuperación de datos.......................................................................................................... 156 Elemento de datos no admitido por función.......................................................................................... 156 Existe un evento duplicado....................................................................................................................156 Seguridad.............................................................................................................................................. 157 Problemas de conexión de PI Server...................................................................................................... 157 Configurar un ordenador para permitir solicitudes de inicio de sesión explícitas.................................158 Activar un protocolo de autenticación............................................................................................... 158 Eliminar error de excepción de tiempo de espera...................................................................................159 Los datos no se actualizan..................................................................................................................... 159

Soporte técnico y otros recursos............... recursos............................ .......................... .......................... ........................... ................... ..... 161

vi

Manual del usuario de PI DataLink 2014

 

Introducción Bienvenido a PI DataLink. En esta sección se proporciona una descripción general de PI DataLink, se describen las características de esta versión y se explica el procedimiento de instalación y configuración.

En esta sección • Descripción general de PI DataLink  • Acerca de esta versión • Proceso de configuración de PI DataLink  • Configuración del complemento para Microsoft Excel • Recomendaciones de seguridad • Acerca de este documento

Descripción general de PI DataLink PI DataLink es un complemento para Microsoft Excel que permite recuperar información de su PI Server directamente en una hoja de cálculo. Combinado 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 de PI System. Con PI DataLink, puede: • Recuperar Recuperar valores valores de un PI p point oint de un PI Server Server • Recuperar Recuperar valores valores de los atri atributos butos de un servidor servidor de PI Asset Asset Fra Framework mework ((PI PI AF) • Recuperar Recuperar metadatos metadatos de siste sistema ma para crear una visualizac visualización ión estructurada estructurada de dat datos os de PI System: ◦

Nombres y atributos de los PI points

◦

Rutas, alias y propiedades de PI Module Database

◦

Atributos y elementos de PI AF

• Hacer referencia referencia a estos el elemento ementoss utilizando utilizando funciones funciones de PI DataLink DataLink para calcular calcular y filtrar datos • Mantener Mantener los valore valoress actualizados actualizados cuan cuando do la hoja de cálculo se recalcule recalcule • Recuperar Recuperar las notificacione notificacioness a las que se haya suscri suscrito to con PI Notifica Notifications tions 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 activas de datos en tiempo real d de e PI System. También puede utilizar utilizar las múltiples capacidades de cálculo y formato de Excel para organizar y presentar datos de PI System para adecuarlos a su propósito o a su audie audiencia ncia Existen dos formas de trabajar de trabajar con las funciones de PI DataLink DataLin k en hojas de cálculo de Excel: • Inst Instal alar ar u una na vers versió ión n independiente de PI DataLink en un PC local. • Util Utiliza izarr un nave navega gador dor web para ver la hoja de cálculo con PI DataLink Server (DLS), (DLS), un producto aparte que permite ver las hojas creadas con PI DataLink. Póngase en contacto con el representante de ventas de OSIsoft para obtener más información.

Manual del usuario de PI DataLink 2014 

1

 

Introducción

PI DataLink Server (DLS) PI DataLink Server es una versión de servidor de PI DataLink para utilizar con Microsoft  SharePoint Server 2007 o posterior. PI DataLink Server admite todas las funciones de PI DataLink y PI BatchView proporcionadas por los complementos Excel en una configuración típica de PI client. Con PI DataLink Server, puede utilizar un navegador web para recuperar y ver datos de PI Server incluidos en una hoja de cálculo de Microsoft Excel. Podrá ampliar el acceso a datos de PI System en tiempo real a muchos clientes distintos, independientemente de su ubicación o de sus conocimientos sobre Microsoft Excel o las funciones de PI DataLink. Esta versión de servidor de PI DataLink utiliza tecnologías de Microsoft SharePoint, como Servicios de Excel y el elemento web de Excel Web Access. Juntos, estos componentes de Microsoft admiten la mayoría de funciones estándar de hoja de cálculo. PI DataLink Server amplía estos servicios dado que añade conectividad y compatibilidad con las funciones de PI DataLink. Se puede acceder de forma independiente a libros de Excel publicados en bibliotecas de documentos de SharePoint SharePoint o añadirlos añadirlos a páginas de elementos web. El elemento web de Excel Web Access admite conexiones que permiten intercambiar parámetros entre entre un libro de trabajo y otros elementos web, integrando las funciones de PI DataLink con el entorno de PI WebParts. Póngase en contacto con el representante de ventas de OSIsoft para obtener más información sobre PI DataLink Server. Server.

Acerca de esta versión Esta versión de PI DataLink instala un complemento para Microsoft Excel 2007 SP3 o posterior. Este complemento no se puede ejecutar en versiones anteriores de Excel. Los temas incluidos en esta sección describen los requisitos del sistema, la actualización de la compatibilidad con versiones anteriores y los tipos de datos admitidos.

En esta sección • Requisitos del sistema • Actualización de compatibilidad • Tipos de datos admitidos

Requisitos del sistema Para obtener requisitos del sistema actualizados, visite la página de productos del soporte técnico de OSIsoft (https://techsupport.osisoft.com/Products/). (https://techsupport.osisoft.com/Products/). Haga clic en el enlace del producto para ver información sobre el producto, incluidos los requisitos del sistema actuales.

Actualización de compatibil compatibilidad idad PI DataLink es compatible con versiones anteriores. Con esta versión de PI DataLink, se pueden leer libros creados con versiones anteriores sin necesidad de realizar ninguna conversión. Sin embargo, lo contrario no es necesariamente cierto. Después de modificar una hoja de cálculo en la versión actual, es posible que no funcione con versiones anteriores de PI DataLink.

2

Manual del usuario de PI DataLink 2014

 

Introducción PI DataLink 2014 utiliza PI AF SDK. PI DataLink 2010 y versiones anteriores utilizan PI SDK o PI API. Diferentes comportamientos pueden obligarle a cambiar las hojas de trabajo existentes creadas con PI DataLink 2010 o versiones anteriores: • Es posible posible que difieran los me mensajes nsajes de error error devueltos. devueltos. Puede que ne necesite cesite cam cambiar biar las hojas de cálculo que buscan determinadas cadenas (por ejemplo, en código VBA o macros de Excel). • PI DataLink DataLink no crea conexiones conexiones con con PI SDK o PI API. E Ess posible posible que necesite necesite modificar modificar el código VBA en los libros que dependen de una conexión a PI SDK o PI API existente para crear una nueva conexión explícita a PI SDK o PI API. • Algunos format formatos os de hora, como por por ejem ejemplo plo 10:, ya no son compatibles. Tendrá que cambiar las entradas de tiempo que utilicen formatos no compatibles. • Las conexiones conexiones de usuario usuario predeterminad predeterminadas as a PI Server ya no son compatibles. compatibles. Si se le solicita, puede introducir un nombre de usuario y una contraseña. Sin embargo, OSIsoft le recomienda configurar PI mappings para conectarse a PI Server. La versión de 64 bits de PI DataLink 2014 no permite crear objetos de tendencia ActiveX. La versión de 64 bits sólo mostrará una imagen de la última tendencia en una hoja de cálculo existente y no actualizará esas tendencias.

Tipos de datos admitidos PI DataLink admite los siguientes tipos de datos de PI point: • Digital: Digital: D Digital igital (estados (estados defini definidos) dos) • En Ente tero: ro: In Intt (16 (16 y 32) 32) • Flotan Flotante: te: Floa Floatt (16 (16,, 32 y 64) 64) • Cadena Cadena:: Stri String ng ((tex texto) to) • Marca Marca de tie tiempo mpo:: Tim Timest estamp amp PI DataLink no admite el tipo blob. PI DataLink admite los siguientes tipos de valores de atributo de PI AF: • Byt Byte: Byte Byte • Entero: Entero: Int (16, (16, 32 y 64) 64) • Single • Double • Ca Cade dena na:: St Stri ring* ng* • Fecha Fecha y hora: hora: DateT DateTime ime** • Boole Booleano ano:: Boo Boole lean an** • Enumer Enumeració ación: n: En Enume umerat ration* ion* *No admitido por la función Datos calculados PI DataLink no admite los tipos de valores de atributos de PI AF Guid, Attribute, Element, File, o Array.

Manual del usuario de PI DataLink 2014 

3

 

Introducción

Proceso de configuración de PI DataLink Para preparar el ordenador para que utilice PI DataLink, debe instalar PI DataLink desde un CD de distribución o descargar un kit de instalación de OSIsoft. Si lo desea, puede utilizar una instalación silenciosa. También puede instalar el paquete de idiomas para habilitar la compatibilidad con otros idiomas. Además, tendrá que considerar la configuración de PI Server que desea realizar y asegurarse de que tiene un acceso correcto a los PI points.

En esta sección • Instalar PI DataLink  • Instalación silenciosa • Ver PI DataLink en un idioma compatible • Preferencias de conexión a PI Server collectives • Configuración de PI Server

Instalar PI DataLink Inicie el programa de configuración para instalar PI DataLink. En sistemas operativos de 64 bits, el programa de configuración instala automáticamente la versión de 32 bits y de 64 bits de PI DataLink. Puede modificar el archivo setup.ini si desea instalar una única versión. Si tiene instalada una versión anterior de PI DataLink en el ordenador, el programa de configuración actualizará automáticamente la instalación y mantendrá los ajustes de preferencia de versiones anteriores.

Procedimiento 1. Localice Localice el kit de de configuració configuración. n. Puede: Puede: ◦

◦

Descargue el kit de la página de descargas descargas del Servicio de asistencia técnica de OSIsoft  (https://techsupport.osisoft.com/Downloads/All-Downloads/).. (https://techsupport.osisoft.com/Downloads/All-Downloads/) Insertar el CD de distribución.

2. Extraiga Extraiga los los a archivos rchivos en ssu u ordenador. ordenador. 3. Si desea instala instalarr una única ver versión sión (32 bits bits o 64 bits), modifiqu modifique e el archivo archivo setup.ini. 4. Ejecut Ejecute e el program programa a setup.exe. El programa de instalación instala PI DataLink bajo el directorio raíz de PIPC, normalmente en:

C:\Archivos de programa\PIPC\Excel programa\PIPC\Excel

El programa instala el archivo de Ayuda en línea en el directorio de idioma correspondiente bajo el directorio ../PIPC/Help. Puede descargar la versión PDF y las notas de la versión de la página de descargas del Servicio de asistencia técnica de OSIsoft (https:// techsupport.osisoft.com/Downloads/All-Downloads/).. techsupport.osisoft.com/Downloads/All-Downloads/)

4

Manual del usuario de PI DataLink 2014

 

Introducción

Qué hacer a continuación • Para cambiar cambiar la configuración configuración predeterminad predeterminada a de PI DataLink, DataLink, consulte consulte el artícul artículo o de la OSIsoft Knowledge Base How to change the default DataLink Settings for all users during install or upgrade (https://techsupport.osisoft.com/Troubleshooting/KB/KB00951). (https://techsupport.osisoft.com/Troubleshooting/KB/KB00951). • Para ver PI DataLink DataLink en un idioma que no sea el inglés, inglés, insta instale le el paquete de idi idiomas omas MUI de PI DataLink. Consulte Ver PI DataLink en un idioma compatible. compatible . • Para utilizar utilizar funciones funciones de tag, funciones funciones de base de datos de módulo módulo o tendencias, tendencias, activ active e de forma manual el complemento PI DataLink (Legacy). Consulte Configuración del complemento para Microsoft Excel. Excel.

Instalación silenciosa Puede instalar este software con la función de instalación silenciosa de Windows. En algunas ocasiones denominada instalación desatendida, la instalación silenciosa no requiere ningún tipo de comentario durante durante el proceso de configuraci configuración. ón. Los administradores del sistema con una aplicación de distribución de software automatizada pueden utilizar la inst alación alación silenciosa para implementar el software de forma automática en un gran número de equipos de la empresa. Para iniciar una instalación silenciosa, escriba:

Setup.exe –f silent.ini El archivo silent.ini se encuentra incluido en el kit de instalación. Puede realice en el archivo las modificaciones específicas del sitio que sean necesarias. Consulte el archivo silent.ini para obtener más información y descripciones de los argumentos disponibles.

Ver PI DataLink en un idioma compatible PI DataLink admite varios idiomas. Instale el paquete de idiomas MUI (interfaz de usuario multilingüe) de PI DataLink para ver la interfaz de usuario de PI DataLink en el mismo idioma que Microsoft Excel. Si PI DataLink no admite un idioma, la interfaz de usuario de PI DataLink  aparece en inglés.

Procedimiento 1. Defina el idioma idioma que desee en en Microsoft Microsoft Excel. Excel. a. Insta Instale le el paquete paquete de idiomas de Microsoft Microsoft Office. Office. b. Utilice Utilice la herramienta herramienta de configu configuración ración de idiomas idiomas de Microsoft Microsoft Office para cambiar cambiar el idioma de Microsoft Excel. 2. Descargue Descargue el paquete paquete de iidioma dioma MUI MUI de PI DataLink DataLink en la página de descargas del Servicio de asistencia técnica de OSIsoft (https://techsupport.osisoft.com/Downloads/AllDownloads/).. Downloads/) 3. Instale Instale el paquete paquete de iidiomas diomas MUI de PI DataLink. DataLink.

Preferencias de conexión a PI Server collectives Si PI DataLink se conecta conecta a un PI Server collective, establece establ ece una preferencia de conexión sobre la primera conexión al colectivo. La preferencia depende del componente que inicia la conexión:

Manual del usuario de PI DataLink 2014 

5

 

Introducción • Las funciones funciones de PI Da DataLink taLink establ establecen ecen la preferencia preferencia como como Cualquiera. • La búsqueda búsqueda establece establece la prefere preferencia ncia como como Cualquiera. • Gestor de conexione conexioness (al que se accede accede desd desde e el cuadro de diálogo diálogo Configuración) establece la preferencia como Cualquiera. • Los objetos objetos heredados heredados de control de tendencia tendencia esta establecen blecen la preferencia preferencia como como Preferir primario. • Tag Search (al que que se accede desde las las funciones de tags tags heredad heredados) os) establece establece la preferencia preferencia como Preferir primario. • PI Connection Connection Manage Managerr (al que se accede desde el Tag Tag Search hereda heredado) do) establece establece la preferencia como Preferir primario. Consulte el manual High Availability Administrator Guide para Guide para obtener más información sobre las conexiones cliente a PI Server.

Configuración n de PI Server Configuració PI DataLink puede obtener puede obtener datos de Server 3.4.380 y versiones posteriores. posterior es. No obstante, PI DataLink debe poder conectarse al PI Server adecuado y los usuarios deben tener un acceso adecuado a los PI points. Es posible que esto exija realizar algunos cambios de configuración en: • Base de datos de firewall La base de datos de firewall de cada equipo de PI Server debe configurarse para permitir el acceso desde equipos cliente que ejecutan PI DataLink. • Autenticación y autorización Es necesario que los usuarios que utilicen PI DataLink puedan autenticar su identidad con PI Server y tener acceso a PI Server. Asigne a los usuarios un acceso con el mínimo de privilegios, por ejemplo, otórgueles permisos de solo lectura. Para la autenticación, OSIsoft  recomienda utilizar PI mappings (disponibles en PI Server versión 3.4.380 y posteriores). También puede utilizar PI trusts o autenticación de contraseñas de PI. OSIsoft no recomienda la autenticación de contraseñas de PI, porque es el método menos seguro. • Definiciones de puntos Deben definirse los puntos para conceder acceso de lectura a los usuarios autorizados y también acceso de escritura, si es necesario. Para obtener más información, consulte la documentación relativa a PI Server, incluido el manual Configuring PI Server Security . Puede descargar la documentación de la página de descargas del Servicio de asistencia técnica de OSIsoft (https://techsupport.osisoft.com/ Downloads/All-Downloads/).. Downloads/All-Downloads/)

Configuración del complemento para Microsoft Excel PI DataLink tiene tres complementos de aplicación para Microsoft Excel.

Nombre PI DataLink    PI DataLink 

Ubicación ..\PIPC\Excel\OSIsoft.PIDataLink.UI.vsto ..\PIPC\Excel\OSIsoft.PIDataLink.UI(Legacy).vsto

(Legacy)

6

Manual del usuario de PI DataLink 2014

Tipo Complemento COM Complemento COM

 

Introducción Nombre

Ubicación

Tipo

PI DataLink  Notifications

..\PIPC\Excel \OSIsoft.PIDataLink.Not \OSIsoft.PI DataLink.Notifications20 ifications2007.UI.vsto 07.UI.vsto

Complemento COM

Para utilizar todas las funciones de PI DataLink, estos complementos de aplicación deben estar activos. El programa de configuración instala todos los complementos y activa el complemento de PI DataLink. Si PI Notifications están instalado en el equipo, el programa de configuración también activa el complemento de PI DataLink Notifications. En caso contrario, deberá activar ese complemento después de instalar PI Notifications. El programa de configuración no activa el complemento de PI DataLink (Legacy). Debe activar el complemento si desea utilizar funciones de tag, objetos de Module Database o tendencias. En casos excepcionales, Microsoft Excel podría deshabilitar un complemento. Deberá habilitarlo para poder activarlo.

Nota: Para activar el complemento de una aplicación, debe tener privilegios de administrador en el equipo. Si no es administrador, haga clic con el botón derecho del ratón en Excel.exe en Windows Explorer y, a continuación, haga clic en Ejecutar como administrador para ejecutar Microsoft Excel como administrador.

Consulte también Funciones de tags Objetos de PI Module Database Tendencias Notificaciones

En esta sección • Ver el estado de lo loss complementos • Activar un comple complemento mento desactivado • Activar un complemento desactivado

Ver el estado de los complement complementos os Compruebe el estado de un complemento para conocer si está activo, inactivo o desactivado.

Procedimiento 1. Haga Haga clic clic e la pestañ pestaña a Archivo y, a continuación, en Opciones. (En Microsoft Excel 2007, haga clic en el botón de Microsoft Office y, a continuación, en Opciones de Excel.) 2. En la vent ventan ana a Opciones de Excel, haga clic en Complementos. 3. Busque en la lista lista de complementos complementos el estado estado actual de un complement complemento. o. Cada complemento se incluirá en una de las siguientes categorías: ◦

◦

◦

Complementos de aplicaciones activas Complementos de aplicaciones inactivas Complementos de aplicaciones deshabilitadas

Activar un complemen complemento to desactivado Si un complemento está desactivado, debe habilitarlo primero para activarlo.

Manual del usuario de PI DataLink 2014 

7

 

Introducción

Procedimiento 1. Haga clic clic en la pest pestaña aña Archivo y, a continuación, en Opciones. (En Microsoft Excel 2007, haga clic en el botón de Microsoft Office y, a continuación, en Opciones de Excel.) 2. En la vent ventan ana a Opciones de Excel, haga clic en Complementos. 3. En la list lista a Administrar, seleccione Elementos deshabilitados y, a continuación, haga clic en Ir. 4. Seleccione Seleccione la casil casilla la de verificación verificación situ situada ada junto al complemento complemento.. 5. Ha Haga ga clic clic en Habilitar.

Activar un complemen complemento to desactivado Active un complemento complemento desactivado para que que esté disponible en Microsoft Excel.

Nota: Para activar un complemento de aplicación, debe tener privilegios de administrador en el equipo. Si no es administrador, haga clic con el botón derecho en Excel.exe en Windows Explorer y, a continuación, haga clic en Ejecutar como administrador para ejecutar Microsoft Excel como administrador.

Procedimiento 1. Haga clic clic en la pest pestaña aña Archivo y, a continuación, en Opciones. (En Microsoft Excel 2007, haga clic en el botón de Microsoft Office y, a continuación, en Opciones de Excel.) 2. En la vent ventan ana a Opciones de Excel, haga clic en Complementos. 3. En la list lista a Administrar, seleccione Complementos COM y, a continuación, haga clic en Ir. 4. Seleccione Seleccione la casil casilla la de verificación verificación situ situada ada junto al complemento complemento.. 5. Ha Haga ga clic clic en Aceptar.

Recomendaciones de seguridad Su PI System puede almacenar datos confidenciales que desea proteger. OSIsoft designa sus productos para minimizar el riesgo de accesos no autorizados. Los temas de esta sección describen las prácticas recomendadas para maximizar la seguridad de los datos cuando se trabaja con PI DataLink.

En esta sección • Seguridad de los archivos Excel • Seguridad del complemento para Excel • Privilegios de las cuentas • Prácticas de seguridad organizativa • Estrategias de registro

Seguridad de los archivos Excel Los libros de trabajo de Excel pueden incluir datos confidenciales que deben protegerse cuando se encuentran en un equipo cliente. La seguridad subyacente que ofrece PI System no es aplicable tras recuperar la información en un libro de trabajo. Por lo tanto, OSIsoft  recomienda proteger todos los archivos de libro de trabajo. Puede:

8

Manual del usuario de PI DataLink 2014

 

Introducción

• Proteger Proteger sus archivos archivos de libro de trabajo en Exce Excell mediante mediante contrase contraseñas. ñas. Las cont contraseña raseñass permiten que solo los usuarios autorizados puedan ver o modificar los datos del libro de trabajo. Para obtener más información, consulte el artículo de Microsoft Office Secure a workbook with a password (http://office.microsoft.com/en-us/excel-help/secure-aworkbook-with-a-password-HP001112410.aspx).. workbook-with-a-password-HP001112410.aspx) • Emplee Emplee las prácticas prácticas más seguras seguras para definir contraseña contraseñass para sus libros libros de trabajo. ◦

◦

◦

Defina una contraseña para abrir el libro de trabajo y otra para modificarlo. Utilice una combinación de mayúsculas y minúsculas, números y símbolos en sus contraseñas. Seleccione la casilla Cifrar propiedades del documento para evitar que usuarios no autorizados puedan ver el resumen y las propiedades personalizadas del archivo del libro de trabajo.

• Active Informati Information on Rights Management Management (IRM) (IRM) en los libros de trabajo trabajo Excel. Excel. IRM permite a los usuarios y administradores especificar los permisos de acceso al libro de trabajo y ayuda a evitar que personas no autorizadas impriman, reenvíen o copien datos confidenciales de PI System. Tras restringir los permisos de un archivo mediante IRM, se aplican las restricciones de acceso y uso independientemente de la ubicación de la información, porque el permiso de acceso se guarda en el propio archivo. Para obtener más información, consulte el artículo de Microsoft Microsoft Office Information Information Rights Management en Office 2010 (http:// office.microsoft.com/en-us/excel-help/information-rights-management-in-office-2010office.microsoft.com/en-us/excel-help/informationrights-management-in-office-2010HA010354260.aspx).. Si es necesario, puede establecer una fecha de caducidad para los HA010354260.aspx) datos en el archivo Excel. En el artículo de Microsoft Office, vea el procedimiento Establecer una fecha de caducidad para un archivo (http://office.microsoft.com/en-us/excel-help/ information-rights-manageme information-rights -management-in-office-2010-HA010354260.aspx#BMexpire) nt-in-office-2010-HA010354260.aspx#BMexpire).. • Utilice Utilice el cifrado IPSec IPSec (Internet (Internet Protocol Security Security)) en los enlaces entre entre equipos que alojan alojan PI DataLink y almacenes de archivos que contienen libros de trabajo Excel si se guardan libros de trabajo Excel en unidades remotas. Para obtener más información, consulte el artículo de Microsoft TechNet Step-by-Step Guide to Internet Protocol Security (IPSec) (http://technet.microsoft.com/en-us/library/bb742429.aspx) (http://technet.microsoft.com/en-us/library/bb 742429.aspx) (disponible  (disponible solo en inglés). • Aplique Aplique los permisos permisos de protección de archivos archivos a sus libros libros de trabajo Excel Excel para asegurarse asegurarse de que los usuarios no autorizados no puedan acceder al contenido de estos archivos. Para obtener más información, consulte el artículo de Microsoft TechNet File and Folder Permissions (http://technet.microsoft.com/en-us/library/bb727008.aspx) (disponible (http://technet.microsoft.com/en-us/library/bb727008.aspx) (disponible solo en inglés). • Aplique Aplique una firma digital digital al archivo de libro de trabajo trabajo Excel Excel.. Para obtener más informaci información, ón, vea el artículo de Microsoft Office Descripción de las firmas digitales y la firma de código en los libros de Excel (http://support.microsoft.com/kb/820738) (http://support.microsoft.com/kb/820738)..

Seguridad del complemento para Excel Excel Trust Center se utiliza para controlar el comportamiento de los complementos. Para evitar que programas no autorizados actúen sobre las hojas de cálculo de Microsoft Excel, OSIsoft le recomienda que solicite la firma de los complementos por parte de editores de confianza. En concreto, utilice la página Complementos de Trust Center para lo siguiente: • Solicitar Solicitar la firma de los complement complementos os de aplicaciones aplicaciones por parte de editores editores de confi confianza. anza. • Desactivar Desactivar la notifica notificación ción de com compleme plementos ntos si sin n firmar. Si instala PI DataLink fuera del directorio C:\Archivos de programa estándar y solicita la firma de los complementos por parte de editores de confianza, deberá añadir manualmente el

Manual del usuario de PI DataLink 2014 

9

 

Introducción certificado PI DataLink al almacén de certificados de confianza. Consulte Añadir certificado PI DataLink a almacén de certificados de confianza. confianza. Para obtener más información, vea el artículo de Microsoft Office Ver, administrar e instalar los complementos de los programas de Office (http://office.microsoft.com/en-us/excel-help/ view-manage-and-install-add-ins-in-office-programs-HA010354315.aspx).. view-manage-and-install-add-ins-in-office-programs-HA010354315.aspx)

Añadir certificado PI DataLink a almacén de certificados de confianza Si configura Microsoft Excel para que solicite la firma de los complementos por parte de un editor de confianza e instala PI DataLink fuera del directorio C:\Archivos de programa estándar, deberá añadir manualmente el certificado PI DataLink al almacén de certificados de confianza.

Procedimiento 1. Abra una ventana de comandos comandos com como o admin administrad istrador. or. 2. En una ventana de símbolo símbolo del sis sistema, tema, despláces desplácese e al directorio directorio que contiene el certificad certificado o PI DataLink (pidlcert.cer). Encontrará el certificado en la subcarpeta Excel de la carpeta de instalación (definida por la variable de entorno PIHOME ). PIHOME). 3. Introduzca Introduzca el siguiente siguiente comando: comando:

C:\Windows\System32\certutil.exe -addstore TrustedPublisher C:\Windows\System32\certutil.exe pidlcert.cer

Privilegios de las cuentas Para evitar que usuarios malintencionados puedan causar daños, asigne a los usuarios un acceso con el mínimo de privilegios, por ejemplo otórgueles permisos de solo lectura.

Prácticas de seguridad organizativa Para evitar que posibles intrusos tengan acceso al sistema, OSIsoft le recomienda que su organización adopte prácticas generales de seguridad: • Proteja Proteja físicamente físicamente sus equip equipos. os. Si un intruso intruso logra acceder a equipos equipos en los que se ejecuta PI DataLink, podría tener acceso a todos los datos de PI System recuperados y almacenados en archivos Excel de ese equipo. • Restrinja Restrinja el acceso a los equipos equipos a emplead empleados os e invitados autoriza autorizados. dos. Debe est establece ablecerr procedimientos que eviten que un equipo que se haya perdido o haya sido robado pueda acceder a la red de la empresa. • Aplique Aplique las actualizaciones actualizaciones de seguridad seguridad más recient recientes es a todos los equipos. Sus Suscríbase críbase al servicio de notificaciones de seguridad para estar informado sobre las nuevas actualizaciones de seguridad de los sistemas operativos y otros componentes. Para obtener más información, consulte el artículo del TechCenter de seguridad Notificaciones técnicas de seguridad de Microsoft (http://technet.microsoft.com/en-us/security/dd252948). (http://technet.microsoft.com/en-us/security/dd252948). • Protéjase Protéjase contra administrad administradores ores no autorizad autorizados. os. Los administrado administradores res no autorizad autorizados os pueden ocasionar numerosos ataques. Por ejemplo, pueden hacer lo siguiente:

10

◦

Instalar y ejecutar software malicioso.

◦

Configurar el acceso remoto para hacerse con el control de un equipo.

Manual del usuario de PI DataLink 2014

 

Introducción

• Auditar Auditar toda la actividad actividad adminis administrati trativa va y revisar de forma rutinaria rutinaria los registros registros de auditoría. Pida a todos los administradores que efectúen comprobaciones de antecedentes antes de contratar a nuevos empleados y que realicen comprobaciones periódicas como condición laboral. • Prevea múltiples múltiples capas de seguridad. seguridad. Confiar Confiar únicamente únicamente en la seguridad perime perimetral, tral, como los cortafuegos, incrementa el riesgo en caso de problemas en el cortafuegos. Puede prever otra capa de protección diseñando su red para separar los clientes menos seguros de los clientes más seguros. Los cortafuegos personales en equipos cliente agregan una capa adicional. Mejore aún más la seguridad con software para la detección de intrusos y software para la detección de intrusos basados en host que ayudan a filtrar actividades sospechosas. La ejecución de software antivirus es esencial. Finalmente, la formación de los usuarios en cuestiones de seguridad informática es una parte crítica de una estrategia de seguridad de la red. • Cree y mantenga líneas líneas base seguras para todo todoss los sistema sistemas. s. Especifique Especifique todas las líneas líneas base con una descripción detallada de cómo configurar y administrar el equipo. La descripción debe incluir todos los parámetros de configuración pertinentes para un equipo seguro. Para crear una línea base segura, utilice el sistema operativo más seguro posible. Es más probable que los sistemas operativos más recientes estén diseñados pensando en la seguridad y que contengan funciones destinadas a mejorar su seguridad. Mantenga el sistema operativo y las aplicaciones actualizados aplicando las actualizaciones de seguridad a medida que estén disponibles. • Utilice Utilice contraseñas contraseñas o claves segu seguras. ras. No utilice utilice nunca contraseñas contraseñas en bla blanco. nco. Para obtener obtener más información sobre las contraseñas, consulte el artículo de Microsoft TechNet Account  Passwords and Policies (http://technet.microsoft.com/en-us/library/cc783860.aspx) (Contraseñas de cuentas y políticas). • Controle Controle el acceso a los archi archivos vos Excel de PI DataLink. DataLink. Im Impleme plemente nte procedi procedimiento mientoss de control de acceso para asegurarse de que todos los archivos Excel estén guardados en un lugar seguro y que ningún intruso pueda modificar el contenido de los archivos o buscar información en ellos.

Estrategias de registro Las organizaciones deben desarrollar una estrategia de registro adecuada. Puede utilizar archivos de registro para: • Seguimiento. Seguimiento. Puede Puede utilizar utilizar archivos de registro para ofrecer ofrecer datos estad estadístico ísticoss sobre transacciones. • Verificación. Verificación. Pue Puede de utilizar utilizar archivos de registro registro para ofre ofrecer cer un registro registro completo de transacciones para recrear las transacciones. • Demostrar Demostrar la la validez validez de una una transacci transacción. ón. PI DataLink envía todas las solicitudes de datos a través de PI AF SDK. Aunque PI DataLink no mantiene archivos de registro separados, puede utilizar los archivos de registro de PI Server y PI AF SDK para obtener información sobre las transacciones de PI DataLink. Consulte la documentación de PI Server y PI AF SDK para obtener más información.

Acerca de este documento El Manual de usuario de PI DataLink  ofrece  ofrece una descripción detallada de las características del producto y una referencia completa a las funciones de DataLink. El contenido de las versiones en PDF y de la Ayuda del manual es idéntico.

Manual del usuario de PI DataLink 2014 

11

 

Introducción Este documento asume que tiene conocimientos sobre conceptos de PI System. Consulte la documentación de PI Server y PI AF para obtener más información sobre esos productos. Conocer PI Server y PI AF le ayudará a comprender los términos que se utilizan en PI DataLink. Es posible que los materiales de formación puedan serle de utilidad. Los materiales incluyen ejercicios que OSIsoft utiliza en los cursos de formación de PI DataLink. Puede descargar los materiales de formación y la documentación relativa a otros productos de OSIsoft en la Página de descargas del Servicio de asistencia técnica de OSIsoft (https:// techsupport.osisoft.com/Downloads/All-Downloads/).. techsupport.osisoft.com/Downloads/All-Downloads/)

12

Manual del usuario de PI DataLink 2014

 

Conceptos básicos Cuando utiliza PI DataLink, define funciones de PI DataLink que extraen datos de PI System en matrices de función en una hoja de cálculo de Excel. Una matriz de función es un grupo de celdas que contiene la salida de una función de PI DataLink. 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 hojas de cálculo y recuperar datos de PI System. Estos apartados describen: • Funcion Funciones es de inter interfaz faz de usua usuario rio • Las funciones funciones esenciales esenciales nece necesarias sarias para para comenzar a trabajar trabajar con PI DataLink  DataLink  • Los diferentes diferentes enfo enfoques ques para construir construir una hoja de cálculo cálculo con PI DataL DataLink ink dependiendo dependiendo de sus objetivos, necesidades y recursos

En esta sección • Interfaz de usuario • Descripción general de las funciones de PI DataLink  • Búsquedas • Configuración de preferencia • Gestionar conexiones con servidores

Interfaz de usuario PI DataLink añade comandos de menú, ventanas y paneles de tareas específicos a Microsoft  Excel. Los siguientes apartados describen los elementos fundamentales de la interfaz de PI DataLink.

En esta sección • Pestaña PI DataLink  • Paneles de tareas de funciones • Menú contextual

Pestaña PI DataLink DataLink PI DataLink inserta la pestaña PI DataLink en la cinta de Microsoft Excel.

• Haga clic clic en la pestañ pestaña a PI DataLink para acceder a los comandos de PI DataLink. • Haga clic en un comando comando para abrir abrir el correspondien correspondiente te panel de ttareas areas o el cua cuadro dro de diálogo. • Sitúe el cursor cursor sobre un comando para mos mostrar trar una ayuda inmediata inmediata de descript scriptiva. iva.

Manual del usuario de PI DataLink 2014 

13

 

Conceptos básicos

Paneles de tareas de funciones Utilice paneles de tareas de funciones para definir funciones de PI DataLink.

Un panel de tareas es un panel de controles que puede mover y acoplar. Puede continuar trabajando en una hoja de cálculo mientras el panel de tareas está abierto. Para abrir un panel de tareas tare as de función: • Haga clic en la celda celda de salida salida deseada deseada y, a conti continuación nuación,, haga clic en un com comando ando de func función ión de la pestaña PI DataLink para añadir una función. • Haga clic en una una celda de una matriz matriz de función función existente existente para mostrar mostrar el panel panel de tareas tareas correspondiente y editar las entradas de la función.

Nota: Si lo prefiere, puede desactivar la aparición automática de paneles de tareas. Consulte Configuración de preferencia. preferencia. • Haga clic con el botón botón derecho derecho en una celda d de e matriz de función función y sele seleccione ccione el nom nombre bre de la función para mostrar manualmente el panel de tareas. Una vez que está abierto un panel de tareas de función: • Introduzca Introduzca o modifiqu modifique e valor valores es y, a continu continuación: ación: ◦

◦

Haga clic en Aceptar para guardar los valores de entrada, escribir la matriz de función resultante y cerrar el panel de tareas. Haga clic en Aplicar para guardar los valores de entrada y escribir la matriz de función resultante sin cerrar el panel de tareas.

• Haga clic clic en el botó botón n de flecha flecha para seleccio seleccionar nar los co comandos mandos Mover, Tamaño o Cerrar. • Arrastre Arrastre la barra de título título para desacopl desacoplar ar el panel de tareas. tareas. • Haga doble doble clic en la barra de ttítulo ítulo pa para ra acoplar el panel panel de tar tareas. eas. • Coloque Coloque el cursor sobre sobre el borde para para arrastrar arrastrar y redimen redimensionar sionar el panel. panel.

14

Manual del usuario de PI DataLink 2014

 

Conceptos básicos

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. Para abrir el menú contextual contextual con los comandos de PI DataLink, haga clic con el botón derecho del ratón en cualquier lugar de una matriz de función de PI DataLink. PI DataLink añade los siguientes comandos al menú contextual: • Seleccionar función DataLink Selecciona la matriz de función completa. Debe seleccionar seleccionar una matriz antes de intentar intenta r copiarla, cortarla o arrastrarla a una nueva ubicación en la hoja de cálculo. • Recalcular (Redimensionar) función Vuelve a escribir la matriz de función completa: PI DataLink recupera valores nuevos de PI Server o PI AF y redimensiona automáticamente la matriz para que se ajuste a los datos obtenidos. • Nombre de función Abre el panel de tareas de función correspondiente y muestra las entradas de la matriz de función. Las tendencias ofrecen un menú contextual alternativo.

Consulte también Menú contextual de tendencias Paneles de tareas de funciones

Descripción general de las funciones de PI DataLink Las funciones de PI DataLink extraen datos de PI System en Excel. Puede utilizar el panel de tareas de función para introducir de forma sencilla las entradas que definen la función. O también, a medida que vaya adquiriendo más experiencia, puede introducir una función directamente en la barra de fórmulas de Excel. Los siguientes apartados describen: • Las funciones funciones comu comunes nes de los paneles paneles de tareas tareas de funciones funciones de PI DataLi DataLink  nk  • La obtención obtención y presentación presentación de datos en tiempo tiempo real • El uso de de las fu funciones nciones de de PI DataLink DataLink en u una na hoja de de cálculo cálculo

Consulte también Paneles de tareas de funciones Entrada manual de funciones

En esta sección • Elementos de datos • Campo de entrada • Campos de entrada de tiempo

Manual del usuario de PI DataLink 2014 

15

 

Conceptos básicos • Datos añadidos • Formatos de presentación

Elementos de datos Las funciones de PI DataLink devuelven datos sobre determinados elementos de datos de PI System, ya sean PI points o atributos de PI AF. Las funciones pueden obtener valores registrados de una base de datos o valores calculados en función de determinados criterios o una expresión concreta. Al definir una función, especifique las rutas de los elementos de datos con los campos Elemento de datos, Expresión y Expresión de filtro junto con el campo opcional Ruta raíz. Puede especificar: • Rutas Rutas compl completa etass en los camp campos os Elemento de datos, Expresión o Expresión de filtro. Una ruta completa comienza con dos barras diagonales inversas (\\) y evalúa un PI point o un atributo de PI AF. • Las rutas parciales parciales en los campos Elemento de datos, Expresión o Expresión de filtro y la ruta de acceso base en el campo Ruta raíz. Los nombres de PI point o los nombres de atributos de PI AF son ejemplos de rutas parciales. PI DataLink combina la ruta de acceso base común con la ruta parcial para establecer la ruta completa que evalúa un PI point o un atributo de PI AF. PI DataLink requiere una ruta completa para localizar el elemento de datos. Para localizar un PI point, PI DataLink debe conocer el PI Server donde realizará la búsqueda y el nombre del punto. Para localizar un atributo de PI AF, PI DataLink debe conocer el servidor de PI AF, la base de datos, el elemento y todos los subelementos y atributos primarios. Utilice una barra vertical (|) para separar los atributos de los elementos o de los atributos primarios. Puede dejar el campo Ruta raíz en blanco si los campos Elemento de datos, Expresión y Expresión de filtro contienen una ruta completa o un PI point en el PI Server predeterminado. Si se especifica, el campo Ruta raíz indica la ruta común de los elementos de datos especificados.

Tipo de elemento de datos

Contenido del campo de ruta raíz

PI point

PI Server que almacena el punto o un valor en blanco para indicar el PI Server predeterminado. Las entradas válidas incluyen: •   PIServer

Atri Atribu buto to d de e PI AF

•   \\PIServer Serv Servid idor or d de e PI AF y base base d de e da dato toss ju junt nto o con con cual cualqu quie ierr el elem emen ento to,, sube subele leme ment nto o o atributos primarios no especificados en Elemento de datos. Las entradas válidas incluyen:

\\PIAFserver\database r\database •   \\PIAFserve \\PIAFserver\database\e r\database\element lement •   \\PIAFserve •   \\PIAFserver\database\element\subelement

\\PIAFserver\database\e r\database\element|Paren lement|ParentAttribute tAttribute •   \\PIAFserve \\PIAFserver\database\e r\database\element|Paren lement|ParentAttribute1| tAttribute1| •   \\PIAFserve ParentAttribute2

Nota: El servidor de PI AF y la base de datos deben estar en el mismo campo. No puede especificar el servidor de PI AF en el campo Ruta raíz y la base de datos en el campo Elemento de datos.

16

Manual del usuario de PI DataLink 2014

 

Conceptos básicos

Consulte también Expresiones

Campo de entrada Los campos etiquetados como de entrada en los paneles de tareas de función aceptan valores correctos para la función. Encelda la mayor parte los campos de entrada, puede introducir un de valor o una referencia a una de hoja dede cálculo que contenga el valor. Algunos campos entrada muestran un valor predeterminado cuando se abre el panel de tareas. Los campos de entrada que tienen la marca (opcional) son opcionales y no requieren un valor. En el caso de entradas con campos de edición

, puede:

• Introducir Introducir texto texto directamente directamente en el campo de edición; edición; por ejemplo un nombre nombre de atributo de PI AF o la dirección de una celda de salida. • Hacer clic en el el campo de edición edición y después después en una celda o rango rango de la hoja de cálculo cálculo que contenga valores correctos, como nombres de atributo de PI AF, marcas de tiempo o ubicaciones de celdas de salida. • Haga clic en el campo campo de edición edición para abrir un una a lista de va valores lores válidos válidos entre entre los que pue puede de seleccionar (solo disponible para los campos Ruta raíz y Base de datos). • Hacer clic en

para abrir la herramienta herramienta de búsqueda búsqueda y, a continuación, continuación, seleccionar seleccionar los

elementos de datos obtenidos en una búsqueda de un PI Server o un servidor de PI AF conectado. En el caso de entradas con listas

, puede:

• Seleccionar Seleccionar una opc opción ión de la lista, lista, como un cálculo cálculo o un método método de muest muestreo. reo. • Hacer clic en

y, a continuación, continuación, en una celda o rango de hoja de cálculo cálculo que contenga contenga

valores correctos, como el modo, la unidad de tiempo, el límite o la propiedad.

Nota: En los campos de edición, introduzca cadenas sin comillas. Sin embargo, en las celdas de hojas de cálculo, introduzca las cadenas con comillas sencillas iniciales (') para obligar a Excel a interpretar el contenido como una cadena. Por ejemplo, para especificar un PI point en el campo Elemento(s) de datos, puede: • Introducir Introducir la la cade cadena na del nombre del punto. punto. • Hacer clic en

para abrir la herramienta herramienta de búsqueda búsqueda y buscar el punto en el PI Server. Server.

• Introducir Introducir una referencia referencia a una celda celda de hoja de cál cálculo culo de contenga contenga el nombr nombre e del punto punto:: a. Hac Hacer er cclic lic en e ell campo campo Elemento(s) de datos. b. Hacer clic clic en la la celd celda a de la hoja de cálculo. cálculo. PI DataLink introducirá automáticamente la referencia de la celda en el campo de edición.

Campos de entrada de tiempo Muchas funciones de PI DataLink requieren campos de entrada de Hora de inicio y Hora de finalización para recuperar una matriz de valores a lo largo de un intervalo de tiempo específico. Otras funciones de PI DataLink requieren un campo de entrada de Marca de tiempo

Manual del usuario de PI DataLink 2014 

17

 

Conceptos básicos para obtener los valores de momento específico. Siga estas indicaciones para especificar valores en los campos de entrada de tiempo: • Introduzca Introduzca un tiempo tiempo absolu absoluto, to, como 10-dic-99 19:12, o una expresión de tiempo de PI que especifique un tiempo relativo; por ejemplo, -3h. Por ejemplo, puede introducir un tiempo absoluto para definir un periodo de tiempo en el pasado o puede introducir una expresión de tiempo relativa para definir un periodo de tiempo que incluya el momento actual. • Si la hora de inicio es más reciente reciente que la hora de final finalización, ización, PI Dat DataLink aLink muestra muestra los resultados en orden cronológico inverso. • Coloque Coloque comillas simples simples delante delante de las expresiones expresiones tempora temporales les introducidas introducidas en las celdas para indicar que se trata de una cadena (por ejemplo, '10-dic-99 19:12 o '-3h). • Las referencias referencias de celd celda a también pueden pueden utiliz utilizar ar el formato absoluto absoluto de tiempo 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. • Alguna Algunass entr entrada adass de tiempo, tiempo, como como 9:45, pueden representar un tiempo válido y un rango válido de filas de hoja de cálculo. En el campo del panel de tareas, coloque al principio de estas entradas comillas comillas simples, como '9:45, para forzar forzar a PI DataLink a interpretarlas como una hora. Algunas funciones de PI DataLink requieren una entrada de Intervalo de tiempo, que se especifica con un solo valor: • Introduzca Introduzca un valor y una unidad unidad temporal, temporal, como 1d o 30m; nunca incluya una hora de referencia. Por ejemplo, para especificar un intervalo de 32 minutos, introduzca 32m o haga referencia a una celda que contenga esa cadena. • Para introducir introducir inter intervalos valos en térm términos inos de frecuencia, frecuencia, convierta convierta la frecuencia frecuencia a los segund segundos os equivalentes. Por ejemplo, una frecuencia de 25 Hz debe introducirse como un intervalo de 0,04s (=1/25 de segundo).

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.

Consulte también Especificación de intervalos de tiempo Especificación de intervalos de tiempo

Datos añadidos PI DataLink puede añadir información sobre los valores recuperados. Los datos añadidos pueden proporcionar un contexto a los valores recuperados. Los datos añadidos pueden incluir: • Marcas de tiempo tiempo que muestra muestran n cuándo se registraro registraron n los valor valores es • Marcas de tiempo tiempo que indican indican las horas horas de inicio inicio y finalización finalización de un intervalo intervalo • Marcas de tiempo tiempo que indican indican la ocurrencia ocurrencia de lo loss valores mínimo mínimo y máxi máximo mo • El porcentaje porcentaje de valores valores correctos correctos durante durante un inte intervalo rvalo de muestra muestra • At Atri ribut butos os d de e va valo lorr

18

Manual del usuario de PI DataLink 2014

 

Conceptos básicos

• Anotaciones Anotaciones introducidas introducidas manualmente manualmente • Nombres Nombres de servid servidore oress fue fuente nte PI DataLink muestra los datos añadidos especificados en las columnas (o filas) junto a los valores principales que la función devuelve: • Los datos datos de tiempo se se muestr muestran an en columnas columnas a la izquierda izquierda (o en filas encima) encima) de los los valores principales. • Otros datos datos relaci relacionados onados se añad añaden en en columnas a la derecha derecha (o en filas debaj debajo) o) de los valores principales.

Formatos de presentación Utilice la ventana Configuración para especificar los formatos de fecha y número que PI DataLink utiliza para dar formato a los datos en las matrices de función. Hay dos configuraciones: • Formato de número El formato para los números en la salida de función. El ajuste predeterminado, General, da formato a los números (y a todos los datos que no son marcas de tiempo) para que coincidan con el formato de la categoría General en la ventana Formato de celdas. • Formato de hora El formato para las marcas de tiempo en la salida de función. El formato de fecha predeterminado, dd-mmm-yy 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-yy hh:mm:ss: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 celdas en Excel. Para obtener detalles en la ventana Configuración, consulte Configuración de preferencia. preferencia. 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 con el cuadro de diálogo Formato de celdas. Consulte su documentación sobre Excel para obtener más información sobre cómo dar formato a fechas y horas.

Búsquedas PI DataLink ofrece dos formas de buscar elementos de datos: • La herramienta de búsqueda La herramienta de búsqueda permite buscar PI points o atributos de PI AF buscando texto coincidente o explorando un PI Server o una base de datos PI AF. Según cómo se abra la herramienta, inserta los puntos o atributos encontrados en hojas de cálculo o en paneles de tareas de funciones. • Función de búsqueda de filtro de activo La función Búsqueda de filtro de activo permite buscar elementos PI AF que satisfacen unos criterios y filtrarlos en función de ciertos valores de atributos. La función puede devolver los elementos filtrados o atributos seleccionados de los elementos filtrados. La función puede pegar los activos filtrados en la hoja de cálculo como valores o como matriz de función.

Manual del usuario de PI DataLink 2014 

19

 

Conceptos básicos

En esta sección • Buscar elementos de datos • Buscar activos mediante filtros

Buscar elementos de datos Utilice la herramienta Búsqueda para buscar elementos deladatos determinado PI Server o servidor de PI AF. Puede insertar elementos de datos en hoja en de un cálculo y referenciar posteriormente estos elementos de datos en las funciones de PI DataLink. También puede insertar un elemento de datos directamente en un panel de tareas de funciones.

Antes de empezar Conéctese al PI Server o al servidor de PI AF en el que desea realizar la búsqueda. Consulte servidores. Gestionar conexiones con servidores.

Procedimiento 1. Abra la la herramie herramienta nta Búsqu Búsqueda eda:: ◦

◦

Para insertar uno o varios elementos en una hoja de cálculo, seleccione la celda superior izquierda del intervalo en la hoja de cálculo donde desea insertar los elementos de datos y, a continuación, en la pestaña PI DataLink, en el grupo Buscar, haga clic en Buscar. Para insertar uno o varios elementos en un panel de tareas de función, haga clic en el botón , situado junto al campo Elemento(s) de datos.

2. Defina el ámbito ámbito de la búsqueda búsqueda,, que se mues muestra tra en la ruta en en la parte su superior. perior. Tras el primer uso, la herramienta se inicia en el nodo principal, que muestra todos los PI Servers (indicados por ) y los servidores de PI AF (indicados por ) que aparecen listados en el Gestor de conexiones. Debe limitar la búsqueda a un solo PI Server o un solo servidor de PI AF e incluso aún más, a una única base de datos en un servidor de PI AF y después a determinados elementos y atributos primarios. La siguiente vez que se utiliza, la herramienta inicia la sesión con el ámbito de la búsqueda definido en el último PI Server, servidor de PI AF o base de datos de PI AF utilizados en la búsqueda. Puede: ◦

◦

Utilizar el panel del navegador para limitar la búsqueda Utilizar la ruta del ámbito para limitar la búsqueda

Si define el ámbito de búsqueda como un elemento o un atributo, en el panel de resultados se incluirán los atributos secundarios inmediatos de ese elemento o atributo. 3. Según proceda, proceda, busque busque element elementos os de datos dentro dentro del ámbito para que apa aparezcan rezcan listados listados en el panel de resultados. a. En el camp campo o situado en la parte superior de la herramienta, her ramienta, escriba el texto que identifica los elementos de datos que desea encontrar en el ámbito seleccionado. La herramienta añade caracteres comodín implícitos detrás del texto que escriba. Por ejemplo:

20

Manual del usuario de PI DataLink 2014

 

Conceptos básicos ▪

▪

Escriba sin para localizar todos los elementos de datos que comiencen por "sin," como sinusoid o sinusoidu. Escriba * para localizar todos los elementos de datos.

b. Si el ámbito ámbito de búsqueda búsqueda es un PI Server, Server, configure configure los campos campos bajo Filtros para especificar cualquier criterio adicional que deban cumplir los PI points recuperados. El panel incluye seis listas que contienen atributos comunes de las clases de puntos clásicos y básicos. Seleccione atributo de punto una listalos y, apuntos continuación, introduzca texto en el campo un correspondiente parade encontrar PI coincidentes con su entrada. Puede utilizar caracteres comodín; la búsqueda no añade caracteres comodín implícitos. Puede filtrar la lista obtenida en función del tipo de punto y seleccionar el tipo de valor almacenado que desea encontrar. Por ejemplo, seleccione Descriptor y, a continuación, introduzca *vapor* para obtener solo los PI points que contienen la palabra vapor  en  en cualquier posición del atributo de punto descriptor Consulte la documentación de PI Server para obtener más información sobre los atributos de PI point. c. Haga Haga cl clic ic en Buscar 

para iniciar la búsqueda.

La herramienta busca dentro del ámbito especificado los elementos de datos que coinciden con el texto que se ha escrito y devuelve los elementos de datos encontrados en el panel de resultados. La herramientacuando busca en totalidad la jerarquía debajo ámbito de búsqueda. (En contraposición, selabusca en lade jerarquía, el panel de del resultados solo muestra los atributos secundarios inmediatos del ámbito de búsqueda.) La herramienta localiza: ▪

PI points con nombres coincidentes.

▪

Atributos de PI AF con nombres coincidentes.

▪

Atributos de PI AF que tienen elementos principales con nombres, descripciones, categorías o plantillas coincidentes.

Nota: Las búsquedas de PI Server devuelven un máximo de 100.000 PI points. Para asegurarse de ver todos los resultados, limite la búsqueda para que devuelva menos PI points. 4. Si lo desea, desea, cambie la lass columnas columnas que se muestran muestran en el panel panel de resultado resultados: s: ◦

◦

Haga clic con el botón derecho del ratón en el panel de resultados y, a continuación, haga clic en el nombre de una columna para añadirla o eliminarla de las columnas mostradas. Arrastre los encabezados de columna para cambiar el orden de las columnas mostradas.

5. Si lo desea, desea, mueva el cont control rol deslizant deslizante e Longitud de ruta raíz  para dividir la ruta de elemento de datos entre las columnas Ruta raíz y Elemento de datos: ◦

◦

◦

Seleccione Mínimo para especificar una ruta completa en la columna Elemento de datos. Seleccione Máximo para especificar solo el atributo o el nombre de punto en la columna Elemento de datos, con el resto de la ruta en la columna Ruta raíz. Seleccione posiciones intermedias para otras divisiones de contenido entre las columnas.

El contenido de estas columnas determina el contenido que se añade a los campos del panel de tareas o las columnas de hoja de cálculo. 6. Si va a insertar elementos elementos de datos datos en una hoja de cálculo, cálculo, especif especifique ique cómo se insertará insertará el contenido de Ruta raíz:

Manual del usuario de PI DataLink 2014 

21

 

Conceptos básicos ◦

Seleccione Columna o fila para insertar el contenido de las columnas Ruta raíz y Elemento de datos en las celdas de hoja de cálculo designadas. Si ambas columnas contienen datos, PI DataLink inserta siempre el contenido de Ruta raíz en la primera columna de la hoja de cálculo y el contenido de Elemento de datos en la segunda. Si únicamente la columna Elemento de datos incluye contenido (es decir, una ruta completa), PI DataLink solo inserta esa columna en la hoja de cálculo:

◦

Seleccione Lista desplegable para insertar una lista desplegable de rutas (procedentes de la columna Ruta raíz) seguida de los elementos de datos (procedentes de la columna Elemento de datos) en las celdas de hoja de cálculo designadas. Si referencia la lista desplegable y los elementos de datos insertados en una función de PI DataLink, la hoja de cálculo actualizará de forma dinámica los valores recuperados cuando se seleccione una ruta diferente en la lista.

Nota: PI DataLink inserta la lista de rutas raíz en la columna EZ de la hoja de cálculo. Si esa columna contiene datos, PI DataLink inserta las rutas en la siguiente columna disponible a la derecha. 7. Seleccione Seleccione los elementos elementos que desee desee insertar insertar y haga haga clic en en Aceptar.

Consulte también Crear un despliegue relacionado con activos

Utilizar el panel del navegador para limitar la búsqueda El panel del navegador se encuentra a la izquierda de la herramienta Búsqueda. El panel del navegador muestra lo que incluye el actual ámbito de búsqueda (en la parte superior de la ventana, se muestra la correspondiente ruta del ámbito). Para los ámbitos en un servidor del PI AF, el panel del navegador solo muestra bases de datos, elementos o atributos que contienen atributos en la jerarquía por debajo de ellos. Por lo tanto, el panel del navegador nunca escuchará elementos o atributos sin ningún atributo secundario. Puede utilizar el panel del navegador para limitar el ámbito de una búsqueda (y definir la ruta del ámbito). Por ejemplo, puede limitar una búsqueda a un servidor de PI AF concreto o a una una determinada base de datos en ese servidor o a un elemento específico de la base de datos. A medida que navegue por la jerarquía del servidor de PI AF en el panel del navegador, el panel de resultados se actualizará para mostrar los atributos directamente en la ruta de ámbito seleccionada en ese momento.

Procedimiento • En el el panel panel del navega navegador: dor: ◦

Haga clic en un servidor para limitar la búsqueda a ese servidor. La herramienta actualiza la ruta del ámbito en la parte superior de la venta para listar el servidor seleccionado y actualiza el panel de navegación. Si ha hecho clic en un servidor de AF (indica (indicado do por ), el panel del navegado navegadorr mues muestra tra ttodas odas las bases bases de datos datos de ese servidor. servid or. Si ha hecho hecho cli clicc en un un PI Server (indicado (indicado por

), el panel del navegado navegadorr

muestra filtros que puede utilizar para limitar el número de PI points recuperados en función de los valores de atributos. ◦

Haga clic clic en una ba base se de datos (indicado (indicado por datos.

22

Manual del usuario de PI DataLink 2014

) para limitar limitar la búsqueda búsqueda a e esa sa base base de

 

Conceptos básicos La herramienta actualiza el panel del navegador para mostrar todos los elementos de primer nivel en la base de datos seleccionada y actualiza la ruta del ámbito en la parte superior de la ventana para listar la base de datos seleccionada. ◦

Haga clic en un elemento (indicado por

) para limitar la búsqueda a ese elemento.

La herramienta actualiza el panel del navegador para mostrar todos los elementos y atributos principales bajo el elemento seleccionado, actualiza la ruta del ámbito en la parte superior de la ventana para listar el elemento de datos seleccionado y lista todos los atributos bajo el elemento seleccionado en el panel de resultados. Tenga en cuenta que el panel del navegador solo muestra atributos principales, en tanto que el panel de resultados muestra atributos principales y no principales bajo el elemento seleccionado. ◦

Haga clic en un atributo (indicado por

) para limitar la búsqueda a ese atributo.

La herramienta actualiza el panel del navegador para mostrar todos los atributos principales bajo el elemento seleccionado, actualiza la ruta del ámbito en la parte superior de la ventana para listar el atributo seleccionado y lista todos los atributos bajo el atributo seleccionado en el panel de resultados.

Utilizar la ruta del ámbito para limitar la búsqueda La ruta del ámbito se encuentra en la parte superior de la herramienta Búsqueda.

La ruta del ámbito muestra la ubicación en la que la herramienta Búsqueda busca elementos de datos. Puede utilizar la ruta del ámbito para limitar el ámbito de una búsqueda. Por ejemplo, puede limitar una búsqueda a un servidor de PI AF concreto o a una una determinada base de datos en ese servidor o a un elemento específico de la base de datos. A medida que navegue por la jerarquía del servidor de PI AF en la ruta del ámbito, el panel de resultados se actualizará para mostrar los atributos directamente en la ruta de ámbito seleccionada en ese momento.

Procedimiento • En la la ru ruta ta del ámbito: ámbito: ◦

◦

◦

◦

◦

◦

◦

◦

Haga clic en Inicio para navegar al nodo principal. En el nodo principal, el panel del navegador muestra todos los PI Servers y servidores de PI AF listados en Gestor de conexiones. No es posible efectuar búsquedas en el nodo principal. El ámbito más amplio para realizar búsquedas es un solo PI Server o un solo servidor de PI AF. Haga clic en la flecha situada junto a Inicio y, a continuación, haga clic en un servidor concreto para restablecer el ámbito a ese servidor. Haga clic en el servidor para restablecer el ámbito a ese servidor completo. Haga clic en la flecha situada junto a un servidor de PI AF y, a continuación, haga clic en una determinada base de datos para restablecer el ámbito a esa base de datos. Haga clic en la base de datos para restablecer el ámbito a esa base de datos completa. Haga clic en la flecha situada junto a la base de datos y, a continuación, haga clic en un elemento concreto para restablecer el ámbito a ese elemento. Haga clic en un elemento para restablecer el ámbito al elemento completo. Haga clic en la flecha situada junto a un elemento y, a continuación, haga clic en un subelemento o atributo para restablecer el ámbito a ese subelemento o atributo.

Manual del usuario de PI DataLink 2014 

23

 

Conceptos básicos ◦

◦

Haga clic en un atributo principal para restablecer el ámbito a todos sus subatributos. Haga clic en la flecha situada junto a un atributo principal y, a continuación, haga clic en un subatributo concreto para restablecer el ámbito a ese subatributo.

Buscar activos mediante filtros Utilice la función Búsqueda de filtro de activo para buscar elementos en una base de datos de PI AF y filtrar los elementos devueltos por valor de atributo. Puede indicar si desea que la función devuelva los elementos filtrados o atributos seleccionados de los elementos filtrados. También puede indicar si desea pegar los activos devueltos en la hoja de cálculo como valores estáticos o como matriz de función, que puede actualizarse automáticamente.

Procedimiento 1. Seleccione Seleccione la celda su superior perior izquierda izquierda del inte intervalo rvalo de la hoja de cálculo cálculo donde dese desea a insertar los activos recuperados. 2. En la pe pest stañ aña a PI DataLink, en el grupo Buscar, haga clic en Filtro de activo para abrir el panel de tareas Búsqueda de filtro de activo . 3. En el ca camp mpo o Ruta raíz introduzca la ruta común de los elementos que desea buscar. La ruta común debe incluir el servidor y la base de datos, y puede contener elementos principales. Utilice el formato \\NombreServidor\NombreBaseDatos \NombreElementoPrincipal. Por ejemplo, para buscar elementos en el nivel raíz de la base de datos MyDatabase en el servidor MyServer, introduzca \\MyServer\MyDatabase; para buscar elementos bajo el elemento Calderas de la misma base de datos, introduzca \\MyServer\MyDatabase \Calderas. 4. Especifique Especifique llos os elementos elementos de PI AF que desea desea recuperar: recuperar: a. En la list lista a Plantilla de elemento, seleccione la plantilla de elementos recuperados. Debe seleccionar una plantilla para filtrar elementos en función de los valores de los atributos. Tenga en cuenta que si selecciona una plantilla base, la función también recuperará elementos de plantillas derivadas. b. En el ca camp mpo o Nombre de elemento, introduzca el nombre de los elementos que desea recuperar. Utilice caracteres comodín para especificar parte del nombre. c. En la list lista a Categoría de elemento, seleccione la categoría de elementos que desea recuperar. d. En el camp campo o Descripción de elemento, introduzca el texto que aparece en la descripción de todos los elementos que desea recuperar. Utilice caracteres comodín para especificar parte de la descripción. e. Sel Selecc eccione ione la casi casilla lla Limitar a nivel raíz para recuperar únicamente elementos en el nivel especificado en el campo Ruta raíz. Desmarque la casilla para recuperar también elementos secundarios. f. Opcion Opcional: al: En la la tabla tabla Filtros de valor de atributo, especifique las condiciones de los valores de atributo de los elementos que desea recuperar. Antes de especificar una condición de valor de atributo, debe seleccionar una plantilla de elemento. También puede filtrar con valores de atributos definidos en esa plantilla de elementos. Puede especificar hasta cinco condiciones. Para cada condición, defina tres campos:

24

Manual del usuario de PI DataLink 2014

 

Conceptos básicos ▪

▪

▪

En la lista Atributo, seleccione un atributo de los elementos basados en la plantilla de elementos seleccionada. En la lista Operador, seleccione el operador relacional, como =, . Para los atributos que contienen valores de cadena, booleanos o enumerados, los únicos operadores válidos son = y . En el campo Valor, escriba el valor del filtro. Puede utilizar caracteres comodín para los atributos de cadena.

Por ejemplo, para recuperar elementos cuyo atributo Fabricante empiece por ABC y que tengan un atributo de CódigoPostal entre 94102 y 94188 (ambos inclusive), introduzca tres condiciones:

Fabricante =ABC* CódigoPostal >=94102 CódigoPostal 75  

-7d

Hora de finalización

 

*

Unidades de tiempo

 

h

Mostrar porcentaje correcto

Seleccionado

Columna

Seleccionado

La función devuelve la siguiente matriz:

Manual del usuario de PI DataLink 2014 

69

 

Funciones de PI DataLink En este ejemplo, la función calcula que el valor de sinusoid ha estado por encima de 75 durante 7,85 horas a lo largo de los 7 días anteriores y que el 100% de los valores fueron correctos durante ese periodo.

Función Explorar eventos La función Explorar eventos que satisfacen criterios especificados en unaeventos base dedevuelve datos de aquellos PI AF. Utilice la función Explorarlos eventos para ver eventos en formato jerárquico. La función devuelve un evento por fila. Utilice los campos de la parte superior del panel de tareas Explorar eventos para especificar qué eventos de PI AF desea recuperar. A medida que especifique los criterios de los eventos, la lista Vista previa del panel de tareas mostrará los eventos coincidentes. Modifique los criterios para ajustar los eventos coincidentes antes de insertar la matriz de función en la hoja de cálculo. Utilice los campos de la parte inferior del panel de tareas para especificar las columnas que desea incluir y la posición de la matriz de función insertada. Para obtener más información, consulte los temas siguientes: • Eventos en hojas de cálculo PI DataLink puede mostrar datos de los eventos de PI AF con la función Explorar eventos o la función Comparar eventos. • Explorar los eventos relacionados con un elemento Siga este procedimiento para utilizar la función Explorar eventos para analizar los eventos relacionados con un elemento de PI AF concreto. • Explorar eventos con eventos secundarios Siga este procedimiento para utilizar la función Explorar eventos para analizar los eventos con eventos secundarios. • Referencia del panel de tareas Explorar eventos Los campos del panel de tareas permiten especificar los eventos que se desea recuperar y las columnas y los datos que se devolverán en la hoja de cálculo. • Nombres de atributo reservados Para evitar conflictos con atributos generados automáticamente, no defina eventos que utilicen nombres de atributos reservados. • Ejemplo de Explorar eventos Establezca las entradas de la función Explorar eventos para ver los eventos que han estado activos durante el último mes y que están basados en una plantilla determinada. • Configuración de preferencia Utilice la ventana Ajustes para definir el número máximo de eventos que devuelve la función.

Referencia del panel de tareas Explorar eventos La función Explorar eventos devuelve eventos en un formato jerárquico. La configuración de las preferencias limita el número de eventos que se recuperan en la lista Vista preliminar y se devuelven a la hoja de cálculo.

Nota: Expanda Más opciones de búsqueda para acceder a todas las entradas de función.

70

Manual del usuario de PI DataLink 2014

 

Funciones de PI DataLink Entrada

Descripción

Base de datos

La base de datos de PI AF desde la que la función devuelve eventos. Utilice el formato \\NombreServidor \NombreBaseDatos. Haga clic en el campo para ver una lista de bases de datos que contienen plantillas de eventos en servidores PI AF conectados. Para que la función pueda encontrar los eventos coincidentes, debe especificar la base de datos.

Inicio de la búsqueda

Una expresión de tiempo de PI que especifica en qué momento la función empieza a buscar eventos en la base de datos. Por ejemplo, especifique *-12h para buscar eventos en registros de la base de datos desde hace 12 horas.

Final de la búsqueda

Una expresión de tiempo de PI que especifica en qué momento la función deja de buscar eventos en la base de datos. Por ejemplo, especifique * para buscar eventos hasta la hora actual.

Limitar a nivel de base de datos

Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raíz de la base de datos. Si desmarca esta casilla, la función busca eventos coincidentes en cualquier nivel de la jerarquía.

Nombre de evento

El nombre de eventos coincidentes. Puede especificar nombres parciales con caracteres comodín.

Plantilla de eventos

Una plantilla de eventos de los eventos coincidentes. Tenga en cuenta que si selecciona una plantilla de eventos base, la función incluye eventos de plantillas derivadas. Al seleccionar una plantilla de eventos, la lista Columnas para mostrar se actualiza para reflejar atributos de la plantilla seleccionada. La actualización suprime los atributos insertados con anterioridad.

Nombre de elemento

Un elemento de PI AF al que hacen referencia los eventos coincidentes. Puede especificar nombres parciales con caracteres comodín.

Plantilla de elemento

Una plantilla de elementos de un elemento al que hacen referencia los eventos coincidentes. Tenga en cuenta que si selecciona una plantilla de elementos base, la función incluye eventos que hacen referencia a elementos de plantillas derivadas. Se necesita la versión 2.6 o posterior del servidor de PI AF para filtrar plantillas de elementos.

Categoría de evento

La categoría de los eventos coincidentes.

Duración mínima

La duración mínima de los eventos coincidentes. Especifique un valor y una abreviatura de unidad temporal.

Duración máxima

La duración máxima de los eventos coincidentes. Especifique un valor y una abreviatura de unidad temporal.

Manual del usuario de PI DataLink 2014 

71

 

Funciones de PI DataLink Entrada

Descripción

Modo de búsqueda

El método que utiliza la función para buscar eventos coincidentes en relación con el período de tiempo especificado por el inicio de la búsqueda y el final de la búsqueda: • activo en intervalo Permite buscar eventos activos en cualquier momento durante el período de tiempo especificado. • completamente en intervalo Permite buscar eventos que empiezan y acaban durante el período de tiempo especificado. • comenzando en intervalo Permite buscar eventos que empiezan durante el período de tiempo especificado y acaban durante o después del período de tiempo especificado. • finalizando en intervalo Permite buscar eventos que acaban durante el período de tiempo especificado y empiezan antes o durante del período de tiempo especificado. • en curso Permite buscar eventos que empiezan durante el período de tiempo especificado pero que todavía no han finalizado. Solo está disponible con la versión 2.6 o posteriores del servidor de PI AF.

Criterio de ordenación

El método que utiliza la función para clasificar los eventos coincidentes: • nombre ascendente Permite ordenar los eventos por nombre de evento, de la A a la Z. • nombre descendente Permite ordenar los eventos por nombre de evento, de la Z a la A. • hora de inicio ascendente Permite ordenar los eventos por hora de inicio, del más temprano al más tardío. • hora de inicio descendente Permite ordenar los eventos por hora de inicio, del más tardío al más temprano. • hora de finalización ascendente Permite ordenar los eventos por hora de finalización, del más temprano al más tardío. • hora de finalización descendente Permite ordenar los eventos por hora de finalización, del más tardío al más temprano.

72

Manual del usuario de PI DataLink 2014

 

Funciones de PI DataLink Entrada

Descripción

Filtros de valor de atributo

Hasta cinco condiciones de atributo que la función utiliza para filtrar eventos coincidentes.

Nota: Antes de especificar un filtro de valor de atributo, debe especificar una plantilla de evento. Para cada filtro, especifique: • Atributo Un atributo de evento para el que la función filtra eventos coincidentes. Los atributos disponibles dependen de la plantilla de eventos seleccionada. • Operador El operador relacional que la función aplica al valor de atributo especificado. Los operadores disponibles dependen del tipo de datos del atributo. • Valor El valor que la función utiliza para buscar atributos coincidentes. Por ejemplo, si define el valor = para el campo Operador, la función limita los eventos a aquellos en los que el atributo especificado equivale a este valor.

Columnas para mostrar

Las columnas de la matriz de función devuelta. La lista contiene los nombres de los atributos. De forma predeterminada, la lista incluye los atributos virtuales generados para todos los eventos y los atributos de eventos de la plantilla de evento seleccionada. Puede: • Marc Marcar ar lla a casil casilla la Seleccionar todo para incluir todos los atributos listados como columnas en la matriz de función devuelta. • Selecc Seleccione ione una casi casilla lla para inc incluir luir el atr atributo ibuto o desma desmarque rque una casi casilla lla para excluir un atributo como columna de la matriz de función devuelta. • Hag Haga a cli clicc en

para para abri abrirr la vent ventana ana Añadir atributos donde puede

seleccionar atributos adicionales que puede incluir como columnas en la matriz de función. Consulte Añadir columnas de atributos al panel de tareas Explorar eventos. eventos. • Escriba e ell nombre d de e un atribu atributo to de event evento o junto a la ca casilla silla en b blanco lanco de dell final de la lista. • Haga cl clic ic con el bot botón ón derech derecho o sobre un at atributo ributo,, haga cli clicc en Insertar  para insertar un atributo en blanco encima del atributo atributo seleccionado y, a continuación, escriba el nombre de un atributo de evento. • Selecc Seleccione ione un atribu atributo to y haga clic en

para mover el atribut atributo o hacia

arriba en la lista. • Selecc Seleccione ione un atribu atributo to y haga clic en

para mover el atribut atributo o hacia

abajo en la lista. • Selecc Seleccione ione un atribu atributo to y haga clic en

para elimi eliminar nar el atribu atributo to de la

lista. • Selecc Seleccione ione un atributo atributo y hag haga a cl clic ic en Eliminar atributo para eliminar el atributo de la lista.

Manual del usuario de PI DataLink 2014 

73

 

Funciones de PI DataLink Entrada

Descripción

Número de niveles de eventos secundarios

El número de niveles de eventos secundarios que la función incluye en la matriz de función. Los eventos secundarios no deben coincidir con los criterios especificados. La función devuelve cada evento secundario en una fila separada y añade una columna adicional por cada nivel devuelto. En las filas que contienen eventos secundarios, la columna añadida contiene el nombre del evento secundario.

Celda de salida

La celda de hoja de cálculo donde la función escribe la matriz de función resultante. Si selecciona una celda antes de abrir el panel de tareas de función, PI DataLink inserta la celda seleccionada en el campo Celda de salida. Especifique la esquina superior izquierda de la matriz de función. PI DataLink  expande el rango hacia abajo y a la derecha de la celda de salida, según resulte necesario para devolver los datos especificados. PI DataLink puede sobrescribir las celdas adyacentes. Si especifica una matriz multiceldas en el campo Celda de salida y la matriz especificada es mayor que la matriz de función resultante, PI DataLink pega la fórmula de función en las celdas de la matriz especificada que no se necesitan.

Consulte también Eventos en hojas de cálculo Añadir columnas de atributos al panel de tareas Explorar eventos Configuración de preferencia

Ejemplo de Explorar eventos Para ver los eventos basados en la plantilla de eventos PowerPlantShutDown de la base de datos Producción en el servidor de PI AF AFSRV1 y activos durante el último mes, establezca las entradas siguientes para la función Explorar eventos:

Entrada Base de datos

Valor  

\\AFSRV1\Producción

Inicio de la búsqueda

 

*-1mo

Final de la búsqueda

 

*

Plantilla de eventos

PowerPlantDownTime

La función devuelve devuelve la siguiente matriz:

Función Comparar eventos La función Comparar eventos devuelve aquellos eventos que satisfacen los criterios especificados en una base de datos de PI AF. Utilice la función Comparar eventos para ver eventos en un formato plano. La función devuelve un evento por fila, pero puede devolver atributos de eventos relacionados en la misma fila. Concretamente, para facilitar la comparación demisma eventos, función puede devolver atributos de eventos secundarios o primarios en la filalaque el evento devuelto.

74

Manual del usuario de PI DataLink 2014

 

Funciones de PI DataLink Utilice los campos en la parte superior del panel de tareas Comparar eventos para especificar qué eventos de PI AF desea recuperar. A medida que especifique los criterios de búsqueda de eventos, el panel de tareas de lista de Vista previa mostrará los eventos coincidentes. Modifique los criterios para ajustar los eventos coincidentes antes de insertar la matriz de función en la hoja de cálculo. Utilice los campos de la parte inferior del panel de tareas para especificar las columnas que desea incluir y la posición de la matriz de función insertada. Para obtener más información, consulte los temas siguientes: • Eventos en hojas de cálculo PI DataLink puede mostrar datos de los eventos de PI AF con la función Explorar eventos o la función Comparar eventos. • Comparación de eventos mediante la inclusión de eventos secundarios Siga este procedimiento para utilizar la función Comparar eventos para comparar eventos que tienen eventos secundarios con los mismos nombres. • Comparación de eventos mediante la inclusión de eventos principales Siga este procedimiento para utilizar la función Comparar eventos para comparar eventos de jerarquías coincidentes cuando existen eventos secundarios con nombres diferentes. • Referencia del panel de tareas Comparar eventos Los campos del panel de tareas permiten especificar los eventos que se desea recuperar y las columnas y los datos que se devolverán en la hoja de cálculo. • Notación de ruta para la función Comparar eventos Utilice la notación de ruta específica en los nombres nom bres de atributos para designar la ubicación en la jerarquía de eventos. • Nombres de atributo reservados Para evitar conflictos conflictos con atributos generados automát icamente, icamente, no defina eventos que utilicen nombres de atributos reservados. • Ejemplo de comparación de eventos Defina las entradas entradas de la función Comparar eventos para eventos para comparar eventos de alerta de temperatura. • Configuración de preferencia Utilice la ventana Ajustes para definir el número máximo de eventos que q ue devuelve la función.

panel de tareas Comparar eventos Referencia del panel La función Comparar eventos devuelve eventos en un formato plano. La configuración de las preferencias limita el número de eventos que se recuperan en la lista Vista preliminar y se devuelven a la hoja de cálculo. de cálculo.

Nota: Haga clic en el signo + junto a Más opciones de búsqueda para acceder a todas las entradas de función.

Entrada

Descripción

Base de datos

La base de datos de PI AF desde la que la función devuelve eventos. Utilice el formato \\NombreServidor \NombreBaseDatos. Haga clic en el campo para ver una lista de bases de datos que contienen plantillas de eventos en servidores PI AF conectados. Para que la función pueda encontrar los eventos coincidentes, debe especificar la base de datos.

Manual del usuario de PI DataLink 2014 

75

 

Funciones de PI DataLink Entrada

Descripción

Inicio de la búsqueda

Una expresión de tiempo de PI que especifica en qué momento la función empieza a buscar eventos en la base de datos. Por ejemplo, especifique *-12h para buscar eventos en registros de la base de datos desde hace 12 horas.

Final de la búsqueda

Una expresión de tiempo de PI que especifica en qué momento la función deja de buscar eventos en la base de datos. Por ejemplo, especifique * para buscar eventos hasta la hora actual.

Limitar a nivel de base de datos

Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raíz de la base de datos. Si desmarca esta casilla, la función busca eventos coincidentes en cualquier nivel de la jerarquía.

Nombre de evento

El nombre de eventos coincidentes. Puede especificar nombres parciales con caracteres comodín.

Plantilla de eventos

Una plantilla de evento de los eventos coincidentes. Tenga en cuenta que si selecciona una plantilla de evento base, la función incluye eventos de plantillas derivadas. Al seleccionar una plantilla de eventos, la lista Columnas para mostrar se actualiza para reflejar atributos de la plantilla seleccionada. La actualización suprime los atributos insertados con anterioridad.

Nombre de elemento

Un elemento de PI AF al que hacen referencia los eventos coincidentes. Puede especificar nombres parciales con carácteres comodín.

Plantilla de elemento

Una plantilla de elementos de un elemento al que hacen referencia los eventos coincidentes. Tenga en cuenta que que si selecciona una plantilla de elementos base, la función incluye eventos hacen referencia a elementos de plantillas derivadas. Se necesita la versión 2.6 o posterior del servidor de PI AF para filtrar plantillas de elementos.

Categoría de evento

La categoría de los eventos coincidentes.

Duración mínima

La duración mínima de los eventos coincidentes. Especifique un valor y una abreviatura de unidad temporal.

Duración máxima

La duración máxima de los eventos coincidentes. Especifique un valor y una abreviatura de unidad temporal.

76

Manual del usuario de PI DataLink 2014

 

Funciones de PI DataLink Entrada

Descripción

Modo de búsqueda

El método que utiliza la función para buscar eventos coincidentes en relación con el período de tiempo especificado por el inicio de la búsqueda y el final de la búsqueda: • activo en intervalo Permite buscar eventos activos en cualquier momento durante el período de tiempo especificado. • completamente en intervalo Permite buscar eventos que empiezan y acaban durante el período de tiempo especificado. • comenzando en intervalo Permite buscar eventos que empiezan durante el período de tiempo especificado y acaban durante o después del período de tiempo especificado. • finalizando en intervalo Permite buscar eventos que acaban durante el período de tiempo especificado y empiezan antes o durante del período de tiempo especificado. • en curso Permite buscar eventos que empiezan durante el período de tiempo especificado pero que todavía no han finalizado. Solo está disponible con la versión 2.6 o posteriores del servidor de PI AF.

Criterio de ordenación

El método que utiliza la función para clasificar los eventos que se devolverán: • nombre ascendente Permite ordenar los eventos por nombre de evento, de la A a la Z. • nombre descendente Permite ordenar los eventos por nombre de evento, de la Z a la A. • hora de inicio ascendente Permite ordenar los eventos por hora de inicio, del más temprano al más tardío. • hora de inicio descendente Permite ordenar los eventos por hora de inicio, del más tardío al más temprano. • hora de finalización ascendente Permite ordenar los eventos por hora de finalización, del más temprano al más tardío. • hora de finalización descendente Permite ordenar los eventos por hora de finalización, del más tardío al más temprano.

Manual del usuario de PI DataLink 2014 

77

 

Funciones de PI DataLink Entrada

Descripción

Filtros de valor de atributo

Hasta cinco condiciones de atributo que la función utiliza para filtrar eventos coincidentes.

Nota: Antes de especificar un filtro de valor de atributo debe especificar una plantilla de eventos. Para cada filtro, especifique: • Atributo Un atributo de evento para el que la función filtra eventos coincidentes. Los atributos disponibles dependen de la plantilla de eventos seleccionada. • Operador El operador relacional que la función aplica al valor de atributo especificado. Los operadores disponibles dependen del tipo de datos del atributo. • Valor El valor que la función utiliza para buscar atributos coincidentes. Por ejemplo, si define el valor = para el campo Operador, la función limita los eventos a aquellos en los que el atributo especificado equivale a este valor.

78

Manual del usuario de PI DataLink 2014

 

Funciones de PI DataLink Entrada

Descripción

Columnas para mostrar

Las columnas de la matriz de función devuelta. La lista contiene los nombres de los atributos. De forma predeterminada, la lista incluye los atributos virtuales generados para todos los eventos y los atributos de eventos de la plantilla de evento seleccionada. La función incluye la ruta de los atributos; la función identifica los atributos únicos por su nombre y posición en la jerarquía. Puede: • Marc Marcar ar lla a casil casilla la Seleccionar todo para incluir todos los atributos listados como columnas en la matriz de función devuelta. • Selecc Seleccione ione una casi casilla lla para inc incluir luir el atr atributo ibuto o desma desmarque rque una casi casilla lla para excluir un atributo como como colu columna mna de la matriz de función devuelta. • Haga Haga cl clic ic en

pa para ra abr abriir la ventana Añadir atributos donde puede

seleccionar atributos adicionales adicionales que puede incluir como columnas como columnas en la matriz de función. Consulte Añadir atributos de eventos secundarios como columnas en el panel de tareas Comparar eventos. eventos . • Haga cl clic ic con el bot botón ón derech derecho o en un atri atributo buto y segu seguidamen idamente te haga clic clic en Clonar para evento principal para insertar el atributo del evento primario como columna en la matriz de función. Consulte Añadir atributos de eventos principales como columnas en el panel de tareas Comparar eventos.. eventos • Escriba e ell nombre d de e un atribu atributo to de event evento o junto a la ca casilla silla en b blanco lanco de dell final de la lista. • atributo Haga cl clic ic para con el bot botón ón derech derecho o sobre un at atributo ributo, , haga clic c en Insertar insertar un atributo en blanco encima delcli atributo seleccionado y, a continuación, escriba el nombre de un atributo de evento. • Selecc Seleccione ione un atribu atributo to y haga clic en

para mover el atribut atributo o hacia

arriba en la lista. • Selecc Seleccione ione un atribu atributo to y haga clic en

para mover el atribut atributo o hacia

abajo en la lista. • Selecc Seleccione ione un atribu atributo to y haga clic en

para elimi eliminar nar el atribu atributo to de la

lista. • Selecc Seleccione ione un atributo atributo y hag haga a cl clic ic en Eliminar atributo para eliminar el atributo de la lista.

Celda de salida

La celda de hoja de cálculo donde la función escribe la matriz de función resultante. Si selecciona una celda antes de abrir el panel de tareas de función, PI DataLink inserta la celda seleccionada en el campo Celda de salida. Especifique la esquina superior izquierda de la matriz de función. PI DataLink  expande el rango hacia abajo y a la derecha de la celda de salida, según resulte necesario para devolver los datos especificados. PI DataLink puede sobrescribir las celdas adyacentes. Si especifica una matriz multiceldas multiceldas en el campo Celda de salida salida y la matriz especificada es mayor que la matriz de función resultante, PI DataLink pega la fórmula de función en las celdas celd as de la matriz especificada que no se necesitan.

Consulte también Eventos en hojas de cálculo Añadir atributos de eventos secundarios como columnas en el panel de tareas Comparar eventos Configuración de preferencia

Manual del usuario de PI DataLink 2014 

79

 

Funciones de PI DataLink

Notación de ruta para la función Comparar eventos La función Comparar eventos identifica a los atributos por ruta; por lo tanto, los nombres de atributo siempre deben incluir información de la ruta, especificada en relación con el evento coincidente que se muestra en cada fila. Cuando especifique los atributos, utilice la notación que designe la ubicación correcta en la jerarquía de eventos.

Notación de ruta admitida Notación

Descripción

.| A1

El atributo A1 atributo A1 del  del evento coincidente.

..| A1

El atributo A1 atributo A1 del  del evento principal del evento coincidente.

..\..| A1

El atributo A1 atributo A1 del  del evento primario principal del evento coincidente.

.\E1| A1

El atributo A1 atributo A1 del  del evento secundario E1 E1 del  del evento coincidente.

Puede combinar la notación para designar los atributos superiores de la jerarquía. Por ejemplo, puede especificar el atributo Duración para diferentes eventos de la jerarquía: • Evento primari primario o principa principall superior: superior: ..\..\..|Duration • Evento Evento coincid coincident ente: e: .|Duration • Evento Evento se secund cundari ario o denom denomina inado do Phase1: .\Phase1|Duration

Ejemplo de comparación de eventos Utilice la función Comparar eventos para ver los atributos de eventos secundarios en un formato que permita comparar fácilmente los eventos principales. Supongamos que tiene eventos de alerta de temperatura y que cada uno tiene un único evento secundario que indica una amenaza cuando la temperatura de la bomba alcanza un determinado nivel. Puede recuperar una matriz de función que muestre la hora de inicio, la duración y la temperatura registrada para el evento de amenaza de temperatura almacenado para cada evento de alerta de temperatura. Los eventos principales tienen nombres que empiezan por TempAlert y los nombres de los eventos secundarios usan TempThreat. Para recuperar la matriz de función para los eventos almacenados durante la última semana en la base de datos Producción del servidor de PI AF AFSRV1, introduzca las entradas siguientes:

Entrada Base de datos Inicio de la búsqueda

Valor  

\\AFSRV1\Producción  

*-1w

Final de la búsqueda

 

*

Nombre del evento

 

TempAlert*

80

Manual del usuario de PI DataLink 2014

 

Funciones de PI DataLink Entrada

Valor

Encabezados de columna

Seleccione lo siguiente: • Nombre de evento • .|Hora de inicio • .|Hora de finalización • .|Duración • .|Elemento primario • .\TempThreat|Hora de inicio* • .\TempThreat|Duración* • .\TempThreat|Temperatura* *Se añade a la lista desde la ventana Añadir atributos.

La función devuelve la siguiente matriz:

Función de búsqueda de filtro de activo La función de búsqueda de filtro de activo devuelve activos (es decir, elementos o atributos de PI AF) que satisfacen los criterios especificados. Los criterios pueden incluir el nombre de elemento, la plantilla de elementos, la categoría de elemento y la descripción del elemento, así como el valor de los atributos. Puede insertar los activos devueltos en la hoja de cálculo como valores estáticos o como matriz de función. Utilice los campos de la parte superior panel de tareas Búsqueda de filtro de activo para especificar qué elemento de PI AF desea recuperar. Utilice los campos de la parte inferior del panel de tareas para especificar los atributos que desea recuperar, el formato de salida y la posición. Para obtener más información, consulte los temas siguientes: • Búsquedas Puede buscar elementos de datos con la herramienta de búsqueda o con la función Búsqueda de filtro de activo. • Buscar activos mediante filtros Siga este procedimiento para utilizar la función Búsqueda de filtro de activo para especificar los elementos que desea recuperar y la salida para la hoja de cálculo. • Configuración de preferencia Utilice la ventana Ajustes para definir el número máximo de elementos y atributos que devuelve la función.

Función Propiedades La función Propiedades recupera el valor de propiedad de un elemento de datos especificado.

Manual del usuario de PI DataLink 2014 

81

 

Funciones de PI DataLink Entrada

Descripción

Ruta raíz

Ruta común a los elementos de datos especificados. Las entradas válidas incluyen: • Nombre d del el PI S Server erver si e ell elem elemento ento de d datos atos es un un PI point. point. • Servid Servidor or de PI AF y bas base e de datos si el elemen elemento to de datos e ess un atribu atributo to de PI AF. • En blanc blanco o si el elem elemento ento de dat datos os es un PI poi point nt del PI S Server erver predeterminado. Consulte Elementos de datos datos..

Elemento(s) de datos

Uno o varios nombres de PI point o de nombres de atributo de PI AF para los que la función recupera valores de propiedad. Incluya un rango de celdas que contenga nombres de PI point o de atributos de PI AF para mostrar valores para cada uno de ellos. De forma predeterminada, PI DataLink graba valores en filas para una columna de elementos de datos referenciados y en columnas para una fila de elementos de datos referenciados.

Propiedad

La propiedad para la que devuelve valores la función. Las propiedades incluidas en la lista dependen del elemento de datos introducido: • PI point ún único. ico. La list lista a contiene lo loss atributo atributoss de punto de la clas clase e de punto del punto introducido.

Nota: Esta sustituyede  porEngUnits EngUnits. EngUnits uom valorlista del atributo punto . . Seleccione uom si desea ver el EngUnits. • Atribu Atributo to de PI AF único. L La a lista conti contiene ene cuatro pr propiedad opiedades es de atributo de PI AF: categorías, descripción, uom y pipoint. • Referen Referencia cia a varia variass celdas. L La a lista de depende pende del tipo de el elemento emento de d datos atos en la primera celda referenciada: referenciada: ◦

◦

PI point. La lista contiene los atributos de punto de la PointClass  de PointClass de ese punto. Atributo de PI AF. La lista contiene cuatro propiedades de atributo de PI AF: categories categories,, description description,, uom y pipoint.

Si la lista está en blanco, PI DataLink no podría encontrar el elemento de datos. Seleccione la propiedad deseada o especifique una referencia de celda a una celda que contenga la propiedad.

Celda de salida

La celda de hoja de cálculo donde la función escribe la matriz de función resultante. Si selecciona una celda antes de abrir el panel de tareas de función, PI DataLink inserta la celda seleccionada en el campo Celda de salida. Especifique la esquina superior izquierda de la matriz de función. PI DataLink  expande el rango hacia abajo y a la derecha de la celda de salida, según resulte necesario para devolver los datos especificados. PI DataLink puede sobrescribir las celdas adyacentes. Si especifica una matriz multiceldas en el campo Celda de salida y la matriz especificada es mayor que la matriz de función resultante, PI DataLink pega la fórmula de función en las celdas de la matriz especificada que no se necesitan.

Consulte también PITagAtt()

82

Manual del usuario de PI DataLink 2014

 

Funciones de PI DataLink

Ejemplo de propiedades Para ver los atributos de valor de algunos de los PI points listados en la hoja de cálculo, defina las siguientes entradas para la función Propiedades:

Entrada Elemento de datos

Valor  

Propiedad

B3..B5 (matriz de celda que contiene puntos)

description (descripción)

La función devuelve la siguiente matriz:

En este caso, los nombres de los PI points están en una columna a la izquierda. Puede utilizar la función Propiedades aparte para mostrar atributos adicionales en las columnas siguientes.

Manual del usuario de PI DataLink 2014 

 

Funciones de PI DataLink

83

84

Manual del usuario de PI DataLink 2014

 

Uso y mantenimiento de las hojas de cálculo En esta sección se explica cómo funcionan las funciones de PI DataLink en una hoja de cálculo y cómo gestionar y mantener la hoja de cálculo a lo largo del tiempo.

En esta sección • Matrices de función • Frecuencia de cálculo • Compartir hojas de cálculo

Matrices de función función Una matriz de función es función es un grupo de celdas que contiene la salida de una función de PI DataLink única. Cuando se añade una función a una hoja de cálculo, PI DataLink introduce la fórmula de la función en las celdas de salida especificadas. La función realiza un una a consulta a PI Server o al servidor de PI AF y devuelve valores en una matriz de función. El tamaño de la matriz depende de la función, del número de valores coincidentes disponible, del número de valores solicitado y de la salida solicitada. La hoja de cálculo muestra los valores devueltos en las celdas de una matriz de función. Sin embargo, estas celdas contienen en realidad la fórmula de función. Puede ver la fórmula de función en la barra de fórmulas de Excel al hacer clic en una celda.

barr a de fórmulas 1. Fórmula de función en la barra 2. Valores devueltos en la matriz de función

En esta sección • Tareas comunes relacionadas con las matrices de función • Actualizar entradas en una matriz de función • Tamaño de la matriz • Redimensionar matrices

Tareas comunes relacionadas con las matrices de función Las matrices de función se pueden mover, copiar o eliminar de una hoja de trabajo. Para seleccionar una matriz, realice una de las acciones siguientes:

Manual del usuario de PI DataLink 2014 

85

 

Uso y mantenimiento de las hojas de cálculo

• Haga clic y arrastre arrastre para selecc seleccionar ionar todas todas las celdas de la mat matriz. riz. Tenga presente presente que la matriz puede contener valores vacíos, que también deben ser seleccionados. • Haga clic con el botón botón derecho derecho en cualqu cualquier ier parte de lla a matriz y eli elija ja Seleccionar función DataLink para seleccionar todas las celdas de la matriz. Una vez seleccionadas, podrá gestionar la matriz fácilmente. • Elimine Elimine m manualm anualmente ente los caracte caracteres res $ de la barra de fórmulas para convertir las referencias de celda en relativas.

Nota: Después de realizar un cambio en la barra de fórmulas, pulse Ctrl + Alt + Entrar para aplicar el cambio. • Haga clic con el botón derecho derecho en cualqui cualquier er celda de la matriz matriz y seleccione, se según gún desee, desee, la operación Cortar, Copiar, Eliminar, Borrar o Formato. • Haga clic clic con el bot botón ón derecho derecho en una nue nueva va celda celda y selec seleccione cione Pegar para volver a insertar una matriz cortada o copiada. • Sitúe el cursor cursor sobre el borde de la matri matrizz seleccionada seleccionada hasta que aparezca aparezca un cursor cursor en forma de cruz y, a continuación, arrastre la matriz a una nueva celda para desplazarla.

Nota: Debe trasladar o borrar una matriz Excel completa, incluidas todas las celdas, o PI DataLink mostrará un mensaje de error: You cannot change part of an array. • Abra el cuadro cuadro de diálog diálogo o de función o el panel panel de tarea tareass y actual actualice ice el campo Celda de salida para colocar la matriz en una nueva ubicación. Consulte Actualizar entradas en una matriz de función. función. También puede copiar los valores de una matriz de función si desea utilizarlos en otra parte en una hoja de cálculo. Una vez copiados y pegados los valores, ya no forman parte de una matriz de función; son simplemente valores de celda y no se actualizan. Para copiar valores de matriz: • Seleccione Seleccione los va valores lores de función función que desea, desea, cópielos cópielos y utilice utilice Pegado especial para pegarlos en la ubicación deseada. No es necesario seleccionar la columna o fila completa de la matriz para copiar valores.

Actualizar entradas en una matriz de función Utilice el panel de tareas de función para actualizar una matriz de función con nuevos valores de entrada.

Procedimiento 1. Abra el panel de tareas tareas de funcione funcioness de una una matriz: matriz: ◦

◦

Con la visualización automática del panel de tareas de funciones activada, haga clic en una o varias celdas. Con la visualización automática del panel de tareas de funciones desactivada, seleccione una celda o varias, haga clic con el botón derecho del ratón y elija un nombre de función.

El panel de tareas de funciones muestra las entradas actuales de la matriz de función seleccionada. Si ha seleccionado una única celda, PI DataLink detecta de forma automática las matrices de función adyacentes que únicamente difieren por el origen (es decir, por el elemento de datos o la expresión) y selecciona las matrices para editar.

86

Manual del usuario de PI DataLink 2014

 

Uso y mantenimiento de las hojas de cálculo Si ha seleccionado varias celdas, PI DataLink sólo selecciona las matrices con el mismo origen (es decir, con los mismos valores para el elemento de datos o la expresión) que las celdas seleccionadas. 2. Modifique Modifique los valor valores es de entrada como desee desee para actual actualizar izar las matrices matrices seleccionada seleccionadass y haga clic en Aceptar o Aplicar. Si ha modificado el campo Celda de salida, los resultados dependen de la ubicación de la nueva referencia de celda: ◦

◦

Si la nueva referencia de celda forma parte de la matriz original, PI DataLink desplaza toda la matriz, de forma que la celda superior izquierda de la matriz se coloca en la nueva celda a la que se hace referencia. Si la nueva referencia de celda no forma parte de la matriz original, PI DataLink copia la matriz y la pega con la celda superior izquierda colocada en la nueva celda a la que se hace referencia. La matriz original permanece en su ubicación original.

matriz Tamaño de la matriz Cuando una función función de PI DataLink escri escribe be una matriz de función, ajusta automáticamente el tamaño de la matriz para que se ajuste a los datos obtenidos. Las funciones escriben la matriz de función cuando se hace clic en Aceptar o Aplicar en un panel de tareas o al hacer clic en Recalcular (Redimensionar) función en el menú contextual. Otros métodos que recalculan o actualizan un función no escriben una nueva matriz de función. Estos métodos solo actualizan valores de matriz; el tamaño de la matriz permanece invariable. Por ejemplo, si especifica entradas de función con referencias de celda y cambia el valor de una celda, la función actualizará los valores devueltos, pero el tamaño de la matriz seguirá siendo el mismo. La actualización puede devolver un número mayor o menor de valores que la matriz de función de la hoja de cálculo puede mostrar. La configuración controla los valores devueltos por PI DataLink. • Si la actualización actualización dev devuelve uelve menos menos valores, valores, PI DataLink DataLink devuelve devuelve valores en blanc blanco o o #N/A en las celdas sin valores. • Si la actualización actualización dev devuelve uelve más valores valores de los que puede mostrar mostrar la matri matrizz de función, PI DataLink devuelve el texto Redimensionar para mostrar todos los valores en la parte inferior de la matriz a no ser que la configuración de preferencias inhabilite el mensaje. Los valores vacíos pueden modificar el aspecto de una hoja de cálculo. Para mantener un tamaño constante, plantéese configurar entradas de función para limitar los datos devueltos. Por ejemplo, en la función Datos comprimidos, puede especificar el número de valores para recuperar en lugar del periodo de tiempo durante el cual se recuperarán todos los valores.

Consulte también Frecuencia de cálculo Redimensionar matrices Configuración de preferencia

Redimensionar matrices Una actualización o un recálculo de una función de PI DataLink puede mostrar más o menos valores de los que la matriz de función puede mostrar. Utilice el comando Recalcular (Redimensionar) función para volver a escribir la totalidad de la matriz de función: PI DataLink  recupera valores nuevos de PI Server o PI AF y redimensiona automáticamente la matriz para que se ajuste a los datos obtenidos.

Manual del usuario de PI DataLink 2014 

87

 

Uso y mantenimiento de las hojas de cálculo

Procedimiento • Haga clic con el botón botón derecho derecho del rató ratón n en cualquier cualquier parte de una matriz matriz de fun función ción y, a continuación, haga clic en Recalcular (Redimensionar) función. La función vuelve a escribir la matriz de función, utilizando las entradas actuales, y redimensiona automáticamente la matriz para que se ajuste a los datos obtenidos.

Frecuencia de cálculo PI DataLink escribe una matriz de función y calcula los valores actuales de la función al hacer clic en Aceptar o Aplicar en el panel de tareas de función. Para mantener actualizados lo datos, debe recalcular la matriz de función. En las secciones posteriores se explican los métodos para volver a calcular una matriz de función. Para obtener información detallada de cómo gestiona Excel el cálculo, consulte el tema Recálculo en Excel (http://msdn.microsoft.com/en-us/library/bb687891.aspx) (http://msdn.microsoft.com/en-us/library/bb687891.aspx) en  en la biblioteca MSDN.

En esta sección • Función Actualización automática • Recálculo provocado • Recalcular manualmente

Función Actualización automática La función Actualización automática inicia de forma automática un recálculo de las funciones y tendencias dentro de un determinado intervalo. Se aplica a cualquier libro de cálculo abierto en la misma sesión de Excel. La función Actualización automática se detiene al abrir un menú, panel de tareas o ventana o cuando la hoja de cálculo actual esta en modo de edición. No puede actualizar libros de cálculo protegidos que son de solo lectura. La configuración de las preferencias afectan a la función Actualización automática: • Tipo Tipo d de ea actu ctuali alizaci zación ón Una configuración de preferencia determina qué funciones se actualizan durante la actualización automática. Hay dos opciones: ◦

Calcular (F9) Seleccione esta opción para volver a calcular las funciones volátiles y cualquier función que haga referencia a ellas durante cada recálculo.

◦

Cálculo completo (Ctrl+Alt+Mayúsculas+F9) Seleccione esta opción para volver a calcular todas las funciones, independientemente de la volatilidad, durante cada recálculo.

• Frec Frecue uenc ncia ia d de ea actualización ctualización En el campo Intervalo, indique el número de segundos entre cada recálculo automático. El valor mínimo es cinco segundos. Introduzca 0 para que PI DataLink establezca automáticamente el intervalo como dos veces la duración del cálculo, con un intervalo mínimo de cinco segundos. OSIsoft recomienda utilizar el intervalo automático para garantizar que Excel permanecerá receptivo el 50% del tiempo. Si el recálculo tarda más que el intervalo especificado, un mensaje pregunta si se desea cambiar al ajuste de intervalo automático o desactivar completamente la función Actualización automática.

88

Manual del usuario de PI DataLink 2014

 

Uso y mantenimiento de las hojas de cálculo

Consulte también Configuración de preferencia Activar Actualización automática Cancelación de Actualización automática

Activar Actualización automática Active la función Actualización automática para recalcular las funciones de PI DataLink  automáticamente dentro de un intervalo especificado.

Procedimiento • En la la pe pest stañ aña a PI DataLink, haga clic en el botón Actualizar. Excel recalcula de forma inmediata todas las funciones de PI DataLink en todos los libros abiertos en la sesión actual de Excel. A continuación, Excel recalcula de forma automática estas funciones dentro del intervalo especificado en los ajustes de preferencia. Cuando se habilita la función Actualización automática, el botón Actualizar se resalta y la barra de estado muestra un mensaje de indicador.

Consulte también Configuración de preferencia

Cancelación de Actualización automática Cancele la función Actualización automática para detener el recálculo automático de las funciones de PI DataLink.

Procedimiento • En la la pe pest stañ aña a PI DataLink, haga clic en el botón Actualizar para anular la selección. • Pulse ESC ESC para cancelar cancelar un recálculo en curso. curso. PI DataLi DataLink nk finaliza finaliza el cálculo de la función función actualmente en proceso, muestra Cálculo cancelado en las celdas de matriz de función sin procesar y anula la Actualización automática.

Recálculo provocado Excel vuelve a calcular funciones volátiles y cualquier función que haga referencia a una función volátil siempre que se edita una celda de la hoja de cálculo o se pulsa F9. Las funciones volátiles incluyen las funciones de tiempo de Excel: ahora() y hoy(). La función Valor actual es una función volátil, en tanto que otras funciones de PI DataLink no lo son. Puede iniciar el recálculo de funciones de PI DataLink no volátiles haciendo referencia a una función volátil dentro de las funciones no volátiles de PI DataLink.

Basar funciones de PI DataLink en funciones volátiles de Excel Si no utiliza la función Actualización automática, puede maximizar la frecuencia de actualización y mantener las matrices de función actualizadas basando las funciones de PI DataLink en una función volátil de Excel.

Manual del usuario de PI DataLink 2014 

89

 

Uso y mantenimiento de las hojas de cálculo

Nota: Para maximizar la frecuencia de actualizaciones cuando no se utiliza Actualización automática, compruebe sus preferencias de cálculo en Excel para asegurarse de que tanto la hoja de cálculo como la aplicación están ajustadas a cálculo Automático en lugar de Manual. Tenga presente que esto podría afectar al rendimiento y dificultar el uso de hojas de cálculo grandes.

Procedimiento 1. Utilice Utilice la barra de fórmulas fórmulas de Excel para introducir introducir una función función voláti volátill en una celda de la hoja de cálculo. Por ejemplo, puede utilizar ( hoy()+1/3) para representar las 8 am del mismo día, o ahora() como una referencia de celda para remplazar el tiempo PI actual, *. Para crear una marca de tiempo absoluta que inicie actualizaciones, añada y reste ahora(); por ejemplo, 2-fe 2-feb-12 b-12 00:30:30 + aho ahora() ra() - ahora(). 2. Haga referencia referencia a lla a celda al definir definir las entradas entradas Hora de inicio u Hora de finalización finalización de una función PI DataLink.

Recalcular manualmente En cualquier momento, puede recalcular de forma manual funciones de PI DataLink.

Procedimiento • Pulse F9 para para forzar el recálcu recálculo lo de todas las funciones funciones vol volátile átiless (y cualquie cualquierr función que haga referencia a ellas). • Pulse Ctrl+Alt Ctrl+Alt+Mayús +Mayúsculas+ culas+F9 F9 para forzar el recálculo recálculo de todas las funciones funciones.. • Haga clic en cualquie cualquierr parte de una ma matriz triz de función función y, a continuación, continuación, ha haga ga clic en Recalcular (Redimensionar) función. Este comando escribirá la totalidad de la matriz y redimensionará de forma automática la raíz para que se ajuste a los datos recuperados.

Compartir hojas de cálculo Para compartir datos de PI System con otros, puede compartir hojas de cálculo creadas con PI DataLink. Para determinar la mejor forma de compartir las hojas de cálculo, tenga presente lo siguiente: • Puede enviar enviar un libro de trabajo de PI Data DataLink Link a otro usuario usuario de Microsoft Microsoft Excel. El usuario usuario debe tener instalado PI DataLink y una conexión activa con el mismo PI Server y servidor de PI AF para poder recalcular las funciones y ver valores de PI point y atributos de PI AF actualizados de forma dinámica. • Los usuarios usuarios que no tengan instalado instalado PI Data DataLink Link podrán podrán ver los últimos últimos datos guard guardados ados en la hoja de cálculo siempre que la opción Cálculo de libro de Excel esté configurada como Manual antes de abrir la hoja de cálculo en Excel. Consulte Definir la opción Cálculo de libro de trabajo como manual. manual. • También También puede guard guardar ar un libro de trabajo trabajo como una página página web o un archivo archivo PDF para compartir una versión estática de la hoja de cálculo. • Puede copiar copiar y pegar val valores ores de matr matrices ices de función función en nuevas nuevas ubicacio ubicaciones nes de una hoja hoja de cálculo utilizando el mandato Pegado especial. Aunque no se puedan recalcular los datos de hoja de cálculo una vez copiada, este método permite distribuir una instantánea

90

Manual del usuario de PI DataLink 2014

 

Uso y mantenimiento de las hojas de cálculo personalizada de los datos a cualquier usuario que disponga de una copia de Excel. Consulte Tareas comunes relacionadas con las matrices de función. función . • Si dispone de Microsoft Microsoft SharePoin SharePointt Server en su entorno entorno informáti informático, co, puede publicar publicar una hoja de cálculo de PI DataLink en un sitio de SharePoint y utilizar PI DataLink Server (DLS)para (DLS) para mostrar y volver a calcular los datos de las funciones de PI DataLink.

Definir la opción Cálculo de libro de trabajo como manual Para permitir a los usuarios sin PI DataLink consultar los datos más recientes guardados en el libro de trabajo, defina la opción Cálculo de libro de Excel como Manual antes de guardar un libro.

Procedimiento 1. Haga clic clic en la pest pestaña aña Archivo y seleccione Opciones. (En Excel 2007, haga clic en el botón de Microsoft Office y, a continuación, haga clic en Opciones de Excel.) 2. En el el cuadr cuadro o de diá diálog logo o Opciones de Excel, haga clic en Fórmulas. 3. En Opciones de cálculo, establezca Cálculo de libro como Manual y, a continuación, haga clic en Aceptar.

Manual del usuario de PI DataLink 2014 

 

Uso y mantenimiento de las hojas de cálculo

91

92

Manual del usuario de PI DataLink 2014

 

Temas avanzados Los temas incluidos en esa sección ofrecen información útil más detallada para trabajar con las funciones de PI DataLink.

En esta sección • Tiempo PI • Expresiones • Entrada manual de funciones • Funciones para escribir datos

Tiempo PI Puede utilizar una sintaxis especial, denominada tiempo PI, para especificar entradas para las marcas de tiempo y los intervalos de tiempo. Tiempo PI utiliza abreviaturas específicas, que puede combinar para crear expresiones temporales.

En esta sección • Abreviaturas de tiempo PI • Expresiones de tiempo PI • Especificación de intervalos de tiempo • Especificación de intervalos de tiempo

Abreviaturas de tiempo PI Al especificar un tiempo PI, puede utilizar abreviaturas concretas que representen unidades de tiempo y referencias temporales.

 Abreviaturas de unidad  de  de tiempo Abreviatura

Unidad de tiempo

s

segundo

m

minuto

h

hora

d

día

mo

mes

y

año

w

semana

Para especificar unidades de tiempo, puede especificar la abreviatura, la unidad de tiempo completa o la versión plural de la unidad de tiempo s, second o seconds. Debe incluir un valor válido con una unidad de unidad de tiempo. Si indica segundo segundos, s, minutos u horas, puede especificar un

Manual del usuario de PI DataLink 2014 

93

 

Temas avanzados valor fraccionario, como 1.25h. No se pueden especificar valores fraccionarios con otras unidades de tiempo.

 Abreviaturas de referencias temporales Abreviatura

Versión completa

*

Referencia temporal Hora actual

t

hoy

00:00:00 (medianoche) del día en curso

y

ayer

00:00:00 (medianoche) del día anterior

dom1

domingo

00:00:00 (m (medianoche) de del do domingo m má ás rre eciente

jun2

junio

00:00:00 (medianoche) del día en curso del mes de junio del año actual

dic DD

diciembreDD diciembre DD

00:00:00 (medianoche) del DD DDésimo ésimo día del mes de diciembre del año en curso

YYYY 

 

00:00:00 (medianoche) del día, mes y año en curso cursoYYYY  YYYY 

M -D o M /D

 

00:00:00 (medianoche) del Désimo día del mesM  mesM  del  del año en curso

DD

 

00:00:00 (medianoche) del DD DDésimo ésimo del mes en curso

1:

Utilice las tres primeras letras como abreviatura de un día de la semana. dom, lun, mar, mie, jue, vie o sab 2: Utilice las tres primeras letras como abreviatura de un mes del año: ene, feb, mar, abr, may, jun, jul, ago, sep, oct, nov o dic.

Expresiones de tiempo PI Las expresiones de tiempo PI pueden incluir puntos temporales fijos, abreviaturas de referencias temporales y desplazamientos temporales. Un desplazamiento temporal indica la dirección del desplazamiento (+ o -) y el intervalo del desplazamiento (una abreviatura de unidad de tiempo con un valor). Las expresiones de tiempo PI válidas son: • Solo Solo un pun punto to tempor temporal al fi fijo, jo, como como 24-aug-2012 09:50:00 • Solo una una abreviatura abreviatura de refe referencia rencia ttempora emporal, l, como t • Solo un de desplaza splazamiento miento temporal, temporal, como +3h • Una abreviatura abreviatura de referencia referencia tempo temporal ral con un desplazamient desplazamiento o temporal, temporal, como t+3h Incluya un único desplazamiento temporal en una expresión. Si incluye varios, los resultados pueden ser imprevisibles. Por ejemplo, las siguientes expresiones temporales no no son  son válidas: •  *+1d+4h •  t-1d+12h

Especificación Especificación de intervalos de tiempo Para especificar entradas para las marcas de tiempo, puede introducir expresiones temporales que contengan: • Puntos Puntos tempora temporales les fijos fijos Un punto temporal fijo representa siempre el mismo punto temporal, independientemente de la hora en curso.

Entrada

Significado

23 23-a -ago go-1 -12 2 15: 15:00 00:0 :00 0

3:00 3:00 p. p.m. m. del del 2 23 3 de de ago agost sto od de e2 201 012 2

94

Manual del usuario de PI DataLink 2014

 

Temas avanzados Entrada

Significado

25-sep-12

00:00:00 (medianoche) del 25 de septiembre de 2012

• Abreviaturas Abreviaturas de referenc referencias ias tempor temporales ales Una abreviatura de referencia temporal representa siempre a una hora relativa a la hora actual.

Entrada

Significado

*

Hora actual (ahora)

3-1 o 3/1

00:00:00 (medianoche) del 1 de marzo del año en curso

2011

00:00:00 (medianoche) del mes y el día en curso del año 2011

25

00:00:00 (medianoche) del día 25º del mes actual

t

00:00:00 (medianoche) de la fecha en curso (hoy)

y

00:00:00 (medianoche) de la fecha anterior (ayer)

tue

00:00:00 (medianoche) del martes más reciente

• Abreviaturas Abreviaturas de re referenci ferencia a tempora temporall con un desplazamien desplazamiento to temporal temporal Cuando se incluye con una abreviatura de referencia temporal, un desplazamiento temporal se añade o resta a la hora especificada.

Entrada

Significado

*-1h

Hace una hora

t+8h

08:00:00 (8:00 a.m.) de hoy

y-8h

16:00:00 (4:00 p.m.) del día anterior a ayer

mon+14.5h

14:30:00 (2:30 p.m.) del último lunes

sat-1m

23:59:00 (11:59 p.m.) del último viernes

• Despla Desplazami zamient entos os temporal temporales es Si se introducen solos, los desplazamientos especifican un punto en el tiempo relativo a una referencia temporal implicada. Una referencia temporal implicada puede ser la hora de reloj actual u otra hora, en función de dónde introduzca la expresión.

Entrada

Significado

- 1d

Un día antes del momento actual

+6h

Seis horas después de la hora actual

Especificación de intervalos de tiempo Especificación Las entradas de intervalo de tiempo definen intervalos para recopilar o calcular valores a lo largo de un período de tiempo. Por ejemplo, puede especificar un intervalo de 60 minutos para calcular el promedio por hora para un período de 12 horas. Para especificar entradas de intervalo de tiempo, introduzca un valor y una unidad de tiempo válidos: • Los valores valores positivo positivoss definen int intervalos ervalos que que comienzan en el primer primer momento del per período íodo y finalizan en o antes del último momento del periodo.

Hora de inicio

2:00:00

Hora de finalización

3:15:00

Intervalo de tiempo

30m

Manual del usuario de PI DataLink 2014 

95

 

Temas avanzados Intervalos devueltos

2:00:00 a 2:30:00 2:30:00 a 3:00:00

• Los valores valores negativo negativoss definen intervalos intervalos que finalizan finalizan en el último último moment momento o del período y comienzan en o antes del primer momento del periodo.

Hora de inicio

2:00:00

Hora de finalización Intervalo de tiempo

3:15:00

Intervalos devueltos

2:15:00 a 2:45:00

-30m

2:45:00 a 3:15:00

Expresiones En PI DataLink, las expresiones son ecuaciones de rendimiento que se pueden utilizar en funciones para incorporar operaciones matemáticas y cálculos basados en elementos de datos de PI System. Por ejemplo, puede utilizar una expresión en una función de PI DataLink para calcular valores a medida que se obtengan de PI Server.

Nota: PI DataLink restringe los elementos datos quede sedatos pueden en las .expresiones. Restricciones relativas a losde elementos expresiones.. Consulte en incluir expresiones. Algunas funciones de PI DataLink aceptan un elemento el emento de datos o una expresión como entrada. Estas funciones tienen tienen las opciones Elemento de datos datos y Expresión en la parte superior del panel de tareas. Algunas funciones de DataLink tienen también un campo Expresión de filtro. Especifique una expresión expresión de filtro para limitar los valores que devuelve una función. Las funciones de PI DataLink DataLink que pueden utilizar expresiones expresiones son: • Función Valor de archivo archivo histórico • Función Datos comprimidos • Función Datos de muestra • Función Datos temporizados • Función Datos calculados • Función Filtrado de tiempo En las siguientes secciones se proporciona información básica sobre las expresiones. PI DataLink admite la sintaxis, operadores y funciones admitidos por PI Server. Para obtener una descripción completa de las ecuaciones de rendimiento y ejemplos, consulte PI Server Applications User Guide o Guide  o el archivo de ayuda PI 3 Performance Equations. Equations. Puede descargar estos documentos de la página de descargas del Servicio de asistencia técnica de OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/). (https://techsupport.osisoft.com/Downloads/All-Downloads/). También puede consultar estos temas en la PI Live Library (http://livelibrary.osisoft.com) (http://livelibrary.osisoft.com)..

En esta sección • Uso de expresiones en funciones de PI DataLink  • Sintaxis de las expresiones • Restricciones relativas a los elementos de datos en expresiones. • Ejemplos de expresiones • Expresiones de filtro

96

Manual del usuario de PI DataLink 2014

 

Temas avanzados

Uso de expresiones en funciones de PI DataLink Utilice expresiones en funciones de PI DataLink para incorporar operaciones matemáticas y cálculos basados en elementos de datos de PI System. Las funciones que aceptan un elemento de datos o una expresión tienen las opciones Elemento de dato y Expresión en la parte superior del panel de tareas.

Antes de empezar Abra el panel de tareas de función

Procedimiento 1. Haga Haga cl clic ic en lla a opc opció ión n Expresión en la parte superior del panel de tareas de función. El campo Elemento(s) de datos se convierte en un campo Expresión(es). La disponibilidad de otros campos puede variar. 2. Especifique Especifique lla a expresión expresión direct directamente amente e en n el campo campo Expresión(es) o introduzca una referencia a una celda que contenga una expresión. Utilice referencias de celda para especificar varias expresiones para una función. Recuerde que una expresión en una celda referenciada es una cadena y debe ir precedida de comillas simples.

Sintaxis de las expresiones Siga estas indicaciones cuando escriba expresiones: • Incluya Incluya cualquie cualquierr PI point o los nombres de atributos atributos de PI AF entre comillas comillas si simples. mples. • Si va a introducir introducir una exp expresión resión en una una celda de Excel, Excel, escriba escriba una comil comilla la simple simple al principio de la expresión para obligar a Excel a interpretar la expresión como una cadena. • Si va a introducir introducir una exp expresión resión en una una celda de Excel Excel y la expresión expresión empieza empieza con un PI point o un nombre de atributo de PI AF, escriba unas comillas dobles al principio de la expresión. • Si va a introducir introducir un valo valorr para comparar comparar con un PI point di digital, gital, especif especifique ique un valor valor negativo del número de código de estado digital.

relativass a los elementos de datos en expresiones. Restricciones relativa PI DataLink permite los siguientes elementos de datos en expresiones: • PI poi poin nts • Atributos Atributos de PI AF que alm almacenan acenan referenci referencias as de datos a PI p points oints • Atributos Atributos de PI AF que almacenan almacenan valores valores constant constantes es Además, una función de PI DataLink solo puede devolver datos de un solo PI Server. Por lo tanto, todos los PI points de una expresión, incluidos aquellos a los que hacen referencia los atributos de PI AF, deben almacenarse en el mismo PI Server. De forma similar, los PI points de una expresión de filtro deben almacenarse en el mismo PI Server que cualquier PI point  especificado en los campos Elemento de datos o Expresión.

Manual del usuario de PI DataLink 2014 

97

 

Temas avanzados

Ejemplos de expresiones La siguientes expresión calcula el total del valor del PI point sinusoid al cubo y el valor del PI point cdf144 dividido por 10:

(('sinusoid')^3 + 'cdf144'/10) + 'cdf144'/10) La expresión e se14,65: evalúa como verdadera (distinta  (distinta de cero) si el valor absoluto del PI point al menos mytagessiguient 

(abs('mytag') >= 14.65) La siguiente expresión se evalúa como true si el valor del atributo de PI AF Manufacturer  es Manufacturer es ACME:

('\\Server\Database\Element|Manufa ('\\Server\Datab ase\Element|Manufacturer' cturer' = "ACME") La siguiente expresión se evalúa como verdadera si el valor del PI point sinusoid es menor que 45 y la raíz cuadrada del valor del PI point vdf1002 es mayor que 2:

('sinusoid' < 45 and sqr('vdf1002') > 2)

Expresiones de filtro Utilice expresión de filtro en una función PI DataLink para filtrar valores registrados con unauna ecuación de rendimiento booleana. PIde DataLink elimina los datoslos para los que la expresión se evalúa como falsa. PI DataLink aplica la expresión de filtro a los datos recuperados sin procesar (y no a los valores que resultan del propio cálculo). Por ejemplo, si se añade la expresión de filtro simple 'sinusoid' < 70 a la función Datos calculados, se eliminarán del cálculo todos los valores iguales o por encima de 70. Las expresiones de filtro pueden contener cualquier ecuación de rendimiento booleana válida; sin embargo los elementos de datos de las expresiones de filtro deben hacer referencia a un PI point. Puede crear expresiones complejas. Por ejemplo, puede utilizar expresiones de filtro para eliminar picos atípicos en los valores registrados. Si está disponible, seleccione la casilla Marcar como filtrado para insertar la etiqueta Filtrado en lugar de un valor o un bloque de valores que la función ha filtrado de la salida en función de la expresión de filtro.

Consulte también Sintaxis de las expresiones Restricciones relativas a los elementos de datos en expresiones.

Entrada manual de funciones Aunque se puede utilizar la interfaz de PI DataLink para crear cualquier función de PI DataLink, es posible que los usuarios con más experiencia prefieran introducir las funciones directamente en la barra de fórmulas de Excel. Los siguientes temas se refieren a las funciones de PI DataLink introducidas directamente en la barra de fórmulas.

En esta sección • Definir funciones manualmente • Pautas para introducir argumentos de forma manual

98

Manual del usuario de PI DataLink 2014

 

Temas avanzados • Códigos de salida

Definir funciones manualmente Si no desea utilizar el panel de tareas de función, puede definir las funciones de PI DataLink de forma manual.

Procedimiento 1. Seleccione Seleccione un interv intervalo alo adecuado adecuado en la hoja de cálculo para la matriz matriz de salid salida a en función del número de valores previstos. 2. Introduzca Introduzca la función función de PI DataLink y sus argumentos argumentos en la barra de fórmulas fórmulas de Exce Excel. l. 3. Pulse Ctrl+May Ctrl+Mayús+In ús+Intro tro para situar situar la función de PI DataLink DataLink en las celdas celdas de salida seleccionadas. Consulte la ayuda en línea de Microsoft Excel para obtener más información sobre las fórmulas de matriz.

Pautas para introducir argumentos de forma manual En la siguiente tabla, se incluyen los tipos de datos que pueden introducirse como argumentos de funciones de PI DataLink y proporciona pautas para introducirlos:

Datos introducidos como argumento

Pauta

Funciones estándar

Puede incluir varias funciones en argumentos que acepten expresiones. Consulte el manual PI Server Applications User Guide o Guide  o el PI 3 Performance Equations Help File para File  para obtener una lista de funciones.

Cadenas

Incluya los argumentos de cadena entre comillas dobles. Por ejemplo, para recuperar la hora del snapshot y el valor del PI point  sinusoid del PI Server denominado casaba, seleccione una matriz de salida de 1 x 2 e introduzca:

=PICurrVal("sinusoid", =PICurrVal( "sinusoid", 1, "casaba") Refere ren ncias d de e ce celda

Puede ut utilizar refere ren ncias d de e cce elda pa para cu cualquier arg argu umento de de lla as funciones PI DataLink. Por ejemplo, supongamos que las celdas de hoja de cálculo tienen los siguientes valores: • A1: "sinusoid" • A2: 1 • A3: "casaba" Por lo tanto, la introducción de la siguiente función en la barra de fórmulas:

=PICurrVal(A1, =PICurrVal( A1, A2, A3) es equivalente a introducir:

=PICurrVal("sinusoid", =PICurrVal( "sinusoid", 1, "casaba") Ruta raíz

Incluya una entrada entre comillas dobles. Por ejemplo, para recuperar el valor actual de los atributos de PI AF especificados en las celdas B3 a B5 y almacenados en el servidor de PI AF DLAFPI, la base de datos MyTest y el elemento Reactor, introduzca:

=PICurrVal(B3:B5,0,"\\D =PICurrVal( B3:B5,0,"\\DLAFPI\MyTest LAFPI\MyTest\Reactor") \Reactor") Consulte Elementos de datos datos para  para obtener información sobre las entradas válidas.

Manual del usuario de PI DataLink 2014 

99

 

Temas avanzados Datos introducidos como argumento

Pauta

Códigos de salida

Determina lo los da datos añadidos que devuelve la fu función y lla a forma en que la función orienta la salida. Consulte Códigos de salida salida..

Códigos de salida La sintaxis de la función PI DataLink contiene un argumento OutCode OutCode de  de entero. Este argumento toma un código de salida que determina que datos añadidos devuelve añadidos devuelve la función y la orientación de las celdas de salida. Los paneles de tareas de PI DataLink generan valores de código de salida automáticamente. Sin embargo, si introduce de forma manual una función en la barra de fórmulas de Excel, tendrá que calcular e incluir un valor de código de salida adecuado. Un código de salida es una representación con enteros de bits binarios. En PI DataLink, el significado del bit depende de la función:

Significado de los bits para las funciones Valor actual y Valor de archivo Bit

Finalidad

1

Mostrar marca de tiempo en la columna a la izquierda del valor

2

Mostrar marca de tiempo en la fila encima del valor

Significado de los bits para otras funciones de PI DataLink  Bit

Finalidad

1

Mostrar marcas de tiempo

2

Orientar datos en filas en lugar de en columnas

3

Mostrar porcentaje correcto

4

Ocultar recuento

5

Mostrar estado extendido

6

Mostrar anotaciones

71

Mostrar hora de inicio

81

Mostrar hora de finalización

91 Mostrar tiempo mín/máx 1 Requiere que el bit 1 esté también habilitado

Con el argumento OutCode  de 0, una función devuelve el valor en una orientación de columna OutCode de sin datos añadidos. Para calcular el argumento OutCode OutCode,, utilice la siguiente fórmula:

Por ejemplo, con un argumento OutCode  de 0, la función PISampDat() devuelve los valores de OutCode de muestra en la celda de salida designada. Con un argumento OutCode  de 1, la la función devu devuelve elve OutCode de marcas de tiempo en la columna uno y los valores de muestra en la columna dos de una matriz n x 2. Con un argumento OutCode  de 3, la función devuelve marcas de tiempo en la fila uno y OutCode de

100

Manual del usuario de PI DataLink 2014

 

Temas avanzados las valores de muestra en la fila dos de una matriz n x 2. (En estos resultados, n es el número de los valores de muestra).

Nota: Las funciones admiten distintos bits y, por lo tanto, valores de argumento de OutCode OutCode.. Aquellos que son válidos para una función no son necesariamente válidos para otra. función los  los bits que cada función admite en su especificación Consulte en la Referencia de función de OutCode OutCode..

Ejemplo Supongamos que desea que la función Datos calculados muestre el porcentaje correcto, la hora de inicio y el tiempo mín/máx. Para mostrar la hora de inicio y el tiempo mín/máx, debe activar el bit mostrar marcas de tiempo. Para calcular el argumento OutCode OutCode::

En la barra de fórmulas de Excel, introduzca:

=PICalcDat("sinusoid","y","t","1h" =PICalcDat("sinu soid","y","t","1h","minimum", ,"minimum", 1, 325,"piserver")

Nota: Si un argumento OutCode  especifica que una función debe mostrar varias columnas o OutCode especifica filas, pero la hoja de cálculo no las muestra, haga clic con el botón derecho en la matriz de función y seleccione Recalcular/Redimensionar para actualizar la matriz de función.

Funciones para escribir datos A diferencia de las funciones estándar de PI DataLink, que recuperan datos de un PI Server o un servidor de PI AF, las funciones PIPutVal() y PIPutValX() escriben un valor de una hoja de cálculo en un PI Server o un servidor de PI AF. Estas funciones pueden sustituir los valores existentes con los valores nuevos proporcionados por el usuario que tienen marcas de tiempo coincidentes. Las funciones PIPutVal() y PIPutValX() son funciones macro de Excel. Puede ejecutar la función PIPutVal() o PIPutValX() desde una hoja de macros Excel 4.0. Esta hoja utiliza el método VBA application.run. Consulte el módulo putval_code en el archivo piexam32.xls, distribuido con PI DataLink para Excel de 32 bits, y el archivo piexam64.xls, distribuido con PI DataLink para Excel de 64 bits. Tenga en cuenta que VBA no reconoce las funciones de PI DataLink, pero puede formular una función como cadena de texto y después definir la propiedad FormulaArray de un rango de celdas con el valor de cadena de texto. De este modo, el código VBA puede comprobar los

Manual del usuario de PI DataLink 2014 

 

Temas avanzados valores de celda de los resultados de las funciones de PI DataLink. Esto produce los mismos resultados que la entrada manual de funciones de PI DataLink en el mismo rango de celdas.

Consulte también PIPutVal() y PIPutValX()

101

102

Manual del usuario de PI DataLink 2014

 

Funciones de tags Un PI point es un flujo de datos en tiempo real procedentes de una fuente definida. Los atributos de punto, incluido el Tag  (es decir, el nombre del PI point) y el origen de punto, Tag (es describen un PI point. Utilice las funciones de tags de PI DataLink para localizar los puntos que corresponden a IDs de PI point y otros atributos de punto. Podrá encontrar funciones de tag en la pestaña PI DataLink, en el grupo Funciones de tag.

Nota: Debe activar el complemento PI DataLink (Legacy) para utilizar estas funciones (consulte Excel). ). Configuración del complemento para Microsoft Excel

Consulte también Descripción general de las funciones de PI DataLink  Función Propiedades Tendencias

En esta sección • Función Apuntar ID al Tag • Función Máscara de atributo para tag • Buscar PI points

Función Apuntar ID al Tag La función Apuntar ID al Tag devuelve el nombre del PI point correspondiente a un determinado ID de punto.

Entrada

Descripción

PI Server

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

ID(s) de punto

Uno o varios ID de punto para los que desea que la función devuelva nombres de punto. Necesario.

Celda de salida

La celda de hoja de cálculo donde la función escribe la matriz de función resultante. Si selecciona una celda antes de abrir el panel de tareas de función, PI DataLink inserta la celda seleccionada en el campo Celda de salida. Especifique la esquina superior izquierda de la matriz de función. PI DataLink  expande el rango hacia abajo y a la derecha de la celda de salida, según resulte necesario para devolver los datos especificados. PI DataLink puede sobrescribir las celdas adyacentes. Si especifica una matriz multiceldas multiceldas en el campo Celda de salida y la matriz especificada es mayor que la matriz de función resultante, PI DataLink pega la fórmula de función en las celdas de la matriz especificada que no se necesitan.

Consulte también PIPointIDToTag()

Manual del usuario de PI DataLink 2014 

103

 

Funciones de tags

Ejemplo de Apuntar ID al Tag Para ver el nombre del PI point correspondiente a un ID de punto, defina las siguientes entradas para la función Apuntar ID al Tag:

Entrada

Valor  

ID de punto

A5 (una celda que contiene un ID de punto)

La función devuelve la siguiente matriz:

En este caso, 1 es el ID de punto y SINUSOID es el nombre de punto devuelto.

Función Máscara de atributo para tag La función Máscara de atributo para tag devuelve los nombres de PI points que coinciden con uno o varios valores de atributos de puntos específicos. Entrada Descripción

PI Server

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

Nombre(s) de tag

Valor de atributo de PI point para el que la función busca el correspondiente nombre de punto. Debe introducir un valor en un campo de entrada como mínimo. Utilice el carácter comodín (*) para encontrar todas las coincidencias o las coincidencias limitadas a determinados caracteres. Por ejemplo, introduzca S* en Origen de punto para localizar cualquier punto con un origen de punto de S o un origen de punto que empiece por S.

Descriptor Fuente de punto Tipo de punto Clase de punto Unidades de ingeniería Celda de salida

La celda de hoja de cálculo donde la función escribe la matriz de función resultante. Si selecciona una celda antes de abrir el panel de tareas de función, PI DataLink inserta la celda seleccionada en el campo Celda de salida. Especifique la esquina superior izquierda de la matriz de función. PI DataLink  expande el rango hacia abajo y a la derecha de la celda de salida, según resulte necesario para devolver los datos especificados. PI DataLink puede sobrescribir las celdas adyacentes. Si especifica una matriz multiceldas en el campo Celda de salida y la matriz especificada es mayor que la matriz de función resultante, PI DataLink pega la fórmula de función en las celdas de la matriz especificada que no se necesitan.

Columna

Haga clic en esta opción para devolver valores en una columna.

Fila

Haga clic en esta opción para devolver valores en una fila.

Consulte también PIAttributeMaskToTag ()

104

Manual del usuario de PI DataLink 2014

 

Funciones de tags

Ejemplo de Máscara de atributo para tag Para ver los PI points de tipo Float32 que tienen un nombre que empieza por BA, defina las siguientes entradas para la función Máscara de atributo para tag:

Entrada Nombre de tag Tipo de punto

Valor    

BA* Float32

La función devuelve la siguiente matriz:

Tenga en cuenta que puede utilizar comodines. Las cadenas introducidas deben coincidir con los valores de atributo en PI Server.

Buscar PI points Con las funciones relacionadas con la información de tags, utilice la ventana Búsqueda de etiquetas para consultar el PI Server en busca de IDs o nombres de PI points para insertar en el panel de tareas.

Procedimiento 1. En el panel de tareas, tareas, haga clic en

junto al campo ID(s) de punto o Nombre(s) de tag.

2. En la vent ventan ana a Búsqueda de tags, haga clic en la pestaña adecuada para su búsqueda: ◦

Búsqueda básica Utilice esta opción para crear una máscara a partir de determinados atributos de PI point  y buscar puntos que tengan valores de atributo coincidentes.

◦

Búsqueda avanzada

Utilice esta opción para crear una consulta para una búsqueda compleja que implique más atributos de punto que la búsqueda básica. ◦

Búsqueda de alias Utilice esta opción para seleccionar puntos por sus alias descriptivos en PI Module Database.

3. Introduzca Introduzca los criteri criterios os de búsqueda. búsqueda. Utilice * o ? como caracteres comodín, según proceda. Por ejemplo, si el campo Máscara de tag se establece en Tem*, devuelve todos los nombres de punto que comienzan por Tem, mientras que si el campo se establece en Tem?, devuelve solo los puntos que empiezan con Tem y terminan con otro carácter simple. Los campos de búsqueda no distinguen entre mayúsculas y minúsculas. 4. Si lo lo desea, desea, haga haga clic clic en en Favoritos para acceder a las búsquedas anteriores.

Manual del usuario de PI DataLink 2014 

105

 

Funciones de tags 5. Ha Haga ga clic clic en Buscar para encontrar los puntos que coincidan con los criterios especificados. 6. Seleccione Seleccione el punt punto o deseado en el el panel de resultad resultados os y haga clic en Aceptar para insertar el valor en el panel de tareas.

106

Manual del usuario de PI DataLink 2014

 

Tendencias La versión de PI DataLink para Microsoft Office de 32 bits incluye un objeto de tendencia ActiveX. Puede insertar una tendencia en una hoja de cálculo para mostrar visualmente los cambios en los valores registrados a lo largo del tiempo. Las tendencias pueden mostrar datos en la hoja de cálculo o de PI points seleccionados.

Nota: Debe activar el complemento PI DataLink (Legacy) para insertar o editar tendencias Excel). ). (consulte Configuración del complemento para Microsoft Excel

En esta sección • Crear una tendencia • Menú contextual de tendencias

Crear una tendencia Una tendencia incluye uno o varios trazos, que muestran visualmente un conjunto de valores. Utilice el Asistente para complementos de tendencia para insertar y configurar tendencias.

Procedimiento 1. En una hoja de cálculo, cálculo, haga clic en la celda donde donde desee sit situar uar la esquin esquina a izquierda superior superior de la tendencia. Al seleccionar la celda, recuerde que la tendencia requiere de forma predeterminada aproximadamente 14 x 8 celdas estándar. 2. En la pe pest stañ aña a PI DataLink, en el grupo Funciones de tag, haga clic en Insertar tendencia para abrir el Asistente para complementos de tendencia. 3. Defina uno uno o varios trazos para para incluir incluir en la tendenci tendencia. a. Pued Puede: e: ◦

Crear un trazo de valores en la hoja de cálculo cálculo..

◦

Crear un trazo de valores de PI point obtenidos de un PI Server . 4. Ajuste Ajuste el aspe aspecto cto de lo loss trazos de la ten tendencia. dencia. Puede:

Manual del usuario de PI DataLink 2014 

107

 

Tendencias ◦

Seleccionar la casilla de verificación en la columna Marcadores para incluir marcadores que indiquen la ubicación de los puntos de datos archivados.

Nota: Los trazos se dibujan con distintos colores. De forma predeterminada, una tendencia incluye también marcadores ocultos para diferenciar los trazos en las pantallas monocromas. Los marcadores ocultos tienen una separación regular a lo largo del trazo y no indican puntos de datos archivados. ◦

Seleccionar un trazo y, a continuación, utilizar los botones de flecha para mover el trazo hacia arriba o abajo en la leyenda.

◦

Seleccionar un trazo y hacer clic en X para eliminar el trazo.

◦

Hacer clic en x todo para eliminar todos los trazos.

◦

Seleccionar un trazo y hacer clic en Cambiar nombre para cambiar el nombre del trazo.

5. Ha Haga ga clic clic en Siguiente. 6. Si alguno alguno de los trazos d de e la tendencia tendencia contiene contiene valores valores de PI point obt obtenidos enidos de un PI Server, especifique el periodo de tiempo para recuperar valores. a. Espec Especifique ifique el inic inicio io del periodo en el campo campo Hora de inicio y el final del periodo en el campo Hora de finalización. Puede: ▪

Seleccionar una cadena de tiempo de la lista.

▪

Introducir un valor de tiempo en el campo.

▪

Hacer clic en

para convertir el campo en un campo de referencia de datos y, a

continuación, hacer clic en la celda de hoja de cálculo que contenga una serie de tiempo o escribir la dirección de esa celda. Consulte Tiempo PI PI para  para ver una explicación de las cadenas de tiempo válidas. b. Selecc Seleccione ione la casill casilla a Activar actualizaciones para actualizar la tendencia con nuevos datos de PI Server si el intervalo de tiempo cambia o se extiende hasta el presente. 7. Ha Haga ga clic clic en Siguiente. 8. Especifique Especifique el título título y la colocación colocación de la la tendencia: tendencia: a. En el camp campo o Título de trend, escriba un título para la tendencia. b. Anule Anule la se selec lecció ción n de la casilla casilla Mostrar atributos de valor  si no desea que los atributos de valor aparezcan en los trazos de la tendencia. Los iconos aparecen cuando los datos contienen valores registrados que tienen ajustados los bits Cuestionable, Sustituido o Anotado. c. Si lo desea, especifique especifique una ubicación ubicación diferente diferente para la tendencia. Pued Puede e seleccion seleccionar: ar: ▪

Hoja de cálculo nueva para situar la tendencia en la esquina superior izquierda de una hoja de cálculo en blanco.

▪

Hoja de cálculo existente para colocar la tendencia en la hoja de cálculo actual que empieza en la celda especificada. Si cambia la celda, asegúrese de que la celda nueva no contenga datos.

9. Ha Haga ga clic clic en Finalizar.

Crear un trazo de valores en la hoja de cálculo Al crear una tendencia con el Asistente para complementos de trend, puede definir un trazo para la tendencia a partir de los valores de una hoja de cálculo.

108

Manual del usuario de PI DataLink 2014

 

Tendencias

Procedimiento 1. En el Asistent Asistente e para complemen complementos tos de trend, trend, haga haga clic en Datos de la hoja de cálculo . 2. Haga Haga cl clic ic e en n el ccam ampo po Rango de celdas con datos y, a continuación, seleccione las celdas que contengan los valores. 3. Especifique Especifique opcio opciones nes adecu adecuadas adas para el intervalo intervalo de celdas celdas especif especificado. icado. ◦

◦

◦

Seleccione la casilla El primer elemento es el nombre de tendencia para utilizar el valor de una celda adyacente como nombre del trazo. (Si el intervalo de celdas es una columna, el nombre del trazo estará en la celda situada encima del primer valor; si el intervalo de celda es una fila, el nombre del trazo estará en la celda situada a la izquierda del primer valor.) Seleccione la casilla Incluir todas las celdas en la matriz para incluir todas las celdas en una matriz de función en el intervalo de celdas. Si selecciona esta casilla, el campo Rango de celdas con datos solo necesita especificar una celda en una matriz de función. Seleccione la casilla Escalonado trazar un plot de tendencia escalonado en lugar de un trazo continuo Puede seleccionar esta casilla para PI points que almacenen valores discretos.

4. Ha Haga ga clic clic en Añadir para insertar el trazo en la tendencia.

Crear un trazo de valores de PI point obtenidos de un PI Server Al crear una tendencia con el Asistente para complementos de trend, puede definir un trazo para la tendencia a partir de los valores obtenidos de un PI Server.

Procedimiento 1. En el Asistent Asistente e para complemen complementos tos de trend, trend, haga haga clic en Datos de PI. 2. En el ca camp mpo o Nombre de tag, especifique el nombre de PI point para el que desea recuperar valores. Puede: ◦

◦

◦

Escribir el nombre del punto. Hacer clic en el campo y seleccionar las celdas de hoja de cálculo que contengan nombres de puntos. Hacer clic en

para abrir la ventana Búsqueda de tags, que puede utilizar para buscar

puntos (consulte Buscar PI points). points). 3. En el ca camp mpo o Nombre de servidor, especifique el PI Server que almacena valores para el punto. Puede: ◦

Seleccionar el servidor de la lista.

◦

Hacer clic en

para convertir el campo en un campo de referencia de datos y, a

continuación, hacer clic en la celda de hoja de cálculo que contenga un servidor o escriba la dirección de esa celda. 4. Ha Haga ga clic clic en Añadir para insertar el trazo en la tendencia.

Menú contextual de tendencias Utilice el menú contextual para actualizar, editar o gestionar una tendencia insertada en una hoja de cálculo. Haga clic con el botón derecho del ratón en una tendencia para abrir un menú con varios comandos:

Manual del usuario de PI DataLink 2014 

109

 

Tendencias

• Cambiar escala Abra la ventana Cambiar escala para cambiar la escala del eje Y o el intervalo de tiempo del eje X. • Revertir Deshaga los cambios y vuelva a la configuración original de la tendencia definida en el Asistente para complementos de trend. • Barra de desplazamiento Habilite una barra de desplazamiento en la parte inferior de la tendencia para desplazar la pantalla por los intervalos de tiempo adyacentes. • Formato Abra el cuadro de diálogo Propiedades de control PI Trend para modificar el aspecto de trazos individuales o de la tendencia entera. Puede cambiar el color o el grosor de la línea de un trazo o añadir elementos de leyenda a la tendencia. • Definir trend Abra la página de definición de trazos del asistente de tendencias para actualizar o cambiar los trazos. • Definir rango temporal de trend Abra la página de definición del intervalo de tiempo del asistente de tendencias para actualizar el intervalo. • Eliminar trend Elimine la tendencia de la hoja de cálculo.

Nota: No se puede restaurar una tendencia eliminada, solo se puede volver a crear. • Exportar datos Abra el cuadro de diálogo Exportar datos para pegar los valores de la tendencia en filas o columnas de la hoja de cálculo. También puede exportar nombres de trazos como títulos. • Mover/Cambiar tamaño Abra el cuadro de diálogo Mover/Cambiar tamaño para mover la esquina superior izquierda de la tendencia a la celda especificada. Introduzca un intervalo de celdas para redimensionar la tendencia. • Copiar/Pegar Abra el cuadro de diálogo Copiar/Pegar para pegar una copia de la tendencia a una determinada celda.

110

Manual del usuario de PI DataLink 2014

 

Objetos de PI Module Database Los temas de este apartado describen las herramientas que PI DataLink proporciona para acceder a objetos de PI Module Database. Podrá encontrar estas herramientas en la pestaña PI DataLink, en el grupo Módulo de base de datos. Consulte la documentación de PI Server para obtener más información sobre las bases de datos de módulos y su configuración.

Nota: Debe activar el complemento PI DataLink (Legacy) para utilizar estas herramientas (consulte Configuración del complemento para Microsoft Excel). Excel).

En esta sección • PI Module Database y hojas de cálculo • Insertar objetos de PI Module Database en la hoja de cálculo • Funciones de bases de datos de módulos

PI Module Database y hojas de cálculo PI Module Database es una estructura jerárquica en árbol basada en el contenido de un PI Server. PI Module Database proporciona una forma completamente diferente de crear la infraestructura de una hoja de cálculo. Si la base de datos del módulo del PI Server se configura e incluye objetos que representan los PI points que desea utilizar, será más sencillo crear hojas de cálculo y proporcionar más flexibilidad y potencial de reutilización. La configuración de PI Module Database normalmente es tarea del administrador del sistema o de PI. PI Module Database almacena alias y propiedades que hacen referencia a PI points y sus atributos, respectivamente. La estructura jerárquica de estos objetos proporciona un contexto relacional entre puntos. Por ejemplo, puede tener cinco PI points que representen los niveles de cinco tanques individuales idénticos. Cada punto tiene un nombre distinto (atributo Tag Tag)) y representa un objeto físico diferente, pero sus requisitos de uso o de supervisión son los mismos. Mediante la recuperación de objetos de la base de datos del módulo, puede crear una única hoja de cálculo construida con los alias y propiedades que representan los cinco tanques. Las funciones de la base de datos de módulo resuelven estos objetos en nombres de punto y valores de atributo. Las rutas de módulo paralelas para cada tanque proporcionan un contexto diferente para las referencias de alias. Con este tipo de estructura, puede utilizar la misma hoja de cálculo para cambiar entre distintas vistas de varios recursos. Por ejemplo, cuando selecciona el nombre de cualquiera de los cinco tanques en una hoja de cálculo, la asociación de alias con el PI point coincidente permite que las funciones de PI DataLink recuperen los valores del tanque apropiado.

Insertar objetos objetos de  de PI Module Database en la hoja de cálculo Utilice el cuadro de diálogo Buscar módulo para buscar alias de PI, propiedades y rutas de módulos en PI Module Database. Puede seleccionar estos elementos y copiarlos directamente en una hoja de cálculo.

Nota: Los alias y propiedades correspondientes a los PI points deben configurarse en PI Server Module Database para utilizar las funciones de Module Database en PI DataLink.

Manual del usuario de PI DataLink 2014 

111

 

Objetos de PI Module Database

Procedimiento 1. Selecci Seleccione one una una celda celda y en PI DataLink haga clic en Buscar módulo para abrir el cuadro de diálogo Buscar módulo. 2. Seleccione Seleccione el tipo de objeto que es está tá buscando: buscando: ◦

◦

◦

Alias Propiedad Módulo

3. En la la lis lista ta desp despllegable PI Server, seleccione el PI Server conectado que q ue contiene la base de datos de módulo que desea examinar. 4. En la list lista a Fecha de consulta, especifique la fecha y hora efectivas de la jerarquía de base de datos de módulo que desea ver. 5. Navegue Navegue por la jerarquía jerarquía de árbol para para localiz localizar ar el elemento elemento deseado. deseado. 6. Seleccione Seleccione el eleme elemento nto o el objeto de colección colección principal principal que desea copiar copiar en la hoja de cálculo: ◦

◦

Seleccione un elemento para copiar en la hoja de cálculo. Seleccione un objeto principal (Alias o Propiedades) de un módulo para copiar todos los alias o propiedades de ese módulo en la hoja de cálculo.

7. Selecci Seleccione one la casi casilla lla Copiar ruta de módulo para copiar la ruta de módulo completa del alias o la propiedad en una celda de hoja de cálculo adyacente. La ruta de módulo proporciona el contexto para el objeto seleccionado. Nota: si el ajuste Copiar nombre de PI Server está activado, PI DataLink también copiará el nombre del PI Server correspondiente.

Nota: Si el ajuste Copiar nombre de PI Server (consulte Configuración de preferencia preferencia)) está activado, PI DataLink también copiará el nombre del PI Server correspondiente. 8. Ha Haga ga clic clic en Aceptar para copiar los elementos seleccionados en la hoja de cálculo y cerrar el cuadro de diálogo.

Funciones de bases de datos de módulos Utilice las funciones de base de datos del módulo PI DataLink para localizar los PI points correspondientes a los alias y las propiedades de un árbol de base de datos de módulo. Estas funciones utilizan la ruta de módulo. Puede introducir una ruta de módulo como argumento de función o hacer referencia a él en una celda de hoja de cálculo. Podrá encontrar estas funciones de base de datos de módulo en la pestaña PI DataLink, en el grupo Module Database.

Nota: La función no puede resolver un alias o un objeto de propiedad en un PI point sin una ruta de módulo. La ruta proporciona un contexto que correlaciona el alias con un PI point  específico.

Consulte también Descripción general de las funciones de PI DataLink 

En esta sección • Función Alias para tag • Función Propiedad para valor

112

Manual del usuario de PI DataLink 2014

 

Objetos de PI Module Database

Función Alias para tag La función Alias para tag devuelve el nombre del PI point correspondiente a un determinado alias de PI.

Entrada

Descripción

PI Server

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

Alias

Alias de PI Module Database. Necesario.

Ruta de módulo

La ruta de módulo procedente de PI Module Database donde puede encontrarse el alias especificado. Si especifica Alias al navegar por Module Database, PI DataLink introduce Ruta de módulo de forma automática. Necesario.

Fecha de consulta

Fecha efectiva del alias. PI DataLink devuelve el punto correspondiente al alias especificado en esa fecha. Necesario.

Celda de salida

La celda de hoja de cálculo donde la función escribe la matriz de función resultante. Si selecciona una celda antes de abrir el panel de tareas de función, PI DataLink inserta la celda seleccionada en el campo Celda de salida. Especifique la esquina superior izquierda de la matriz de función. PI DataLink  expande el rango hacia abajo y a la derecha de la celda de salida, según resulte necesario para devolver los datos especificados. PI DataLink puede sobrescribir las celdas adyacentes. El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

Sin servidor

Seleccione esta opción para recuperar sólo el nombre del PI point.

Servidor a la derecha

Seleccione esta opción para mostrar el PI Server que almacena el punto en la celda a la derecha del nombre del punto.

Servidor en la parte inferior

Seleccione esta opción para mostrar el PI Server que almacena el punto en la celda debajo del nombre del punto.

Consulte también PIAliasToTag()

Función Propiedad para valor La función Propiedad para valor devuelve el valor o valores correspondientes a una propiedad de PI especificada. PI DataLink puede devolver valores para tipos de propiedad Boolean, Date, Double, Integer, Long, Null, Single y String, o tipos de propiedad de matriz Double, Integer, Long y Single.

Entrada

Descripción

PI Server

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

Propiedad(es)

Una propiedad de PI en PI Module Database. Necesario.

Manual del usuario de PI DataLink 2014 

113

 

Objetos de PI Module Database Entrada

Descripción

Ruta de módulo

La ruta de módulo procedente de PI Module Database donde puede encontrarse la propiedad especificada. Si especifica Propiedad al navegar por Module Database, PI DataLink introduce Ruta de módulo de forma automática. Necesario.

Fecha de consulta

Fecha efectiva de la propiedad de PI. PI DataLink devuelve el valor de la propiedad especificada en esa fecha. Necesario.

Celda de salida

La celda de hoja de cálculo donde la función escribe la matriz de función resultante. Si selecciona una celda antes de abrir el panel de tareas de función, PI DataLink inserta la celda seleccionada en el campo Celda de salida. Especifique la esquina superior izquierda de la matriz de función. PI DataLink  expande el rango hacia abajo y a la derecha de la celda de salida, según resulte necesario para devolver los datos especificados. PI DataLink puede sobrescribir las celdas adyacentes. Si especifica una matriz multiceldas en el campo Celda de salida y la matriz especificada es mayor que la matriz de función resultante, PI DataLink pega la fórmula de función en las celdas de la matriz especificada que no se necesitan.

Columna Fila

Consulte también PIPropertyToValue()

Haga clic en esta opción para devolver valores en una columna. Haga clic en esta opción para devolver valores en una fila.

114

Manual del usuario de PI DataLink 2014

 

Notificaciones PI DataLink incluye el complemento PI DataLink Notifications. Al activarse, este complemento añade la función Búsqueda de notificación a la pestaña PI DataLink. Utilice la función Búsqueda de notificación para recuperar notificaciones de PI System a las que se haya suscrito e insertar estas notificaciones en hojas de cálculo. El complemento PI DataLink Notifications se ejecuta en Windows XP y sistemas operativos posteriores y requiere Excel 2007 SP3 o versiones posteriores. PI Notifications debe estar instalado en el ordenador para poder activar el complemento (consulte Configuración del complemento para Microsoft Excel). Excel ).

Nota: Debe tener una cuenta como mínimo en un servidor de PI AF 2.0 con PI Notifications 1.0 y estar suscrito a una regla de notificación como mínimo para recibir notificaciones. Para obtener más información sobre PI Notifications, consulte el Manual del usuario de PI  Notifications.. Notifications Para acceder a la función Búsqueda de notificación, haga clic en la celda de salida de la hoja de cálculo que desee y, a continuación, en la pestaña PI DataLink (en el grupo Notificaciones), haga clic en Notification Search para abrir el cuadro de diálogo Notification Search.

En esta sección • Búsqueda e inserción de notificaciones • Notificaciones insertadas • Configuración de visualización de notificaciones

Búsqueda e inserción de notificaciones Utilice el cuadro de diálogo Notification Search para buscar notificaciones a las que se haya sucrito desde un determinado servidor PI AF y, a continuación, insértelas en su hoja de cálculo. El servidor PI AF contiene una base de datos de elementos estructurales y eventos de notificación que le permiten permiten trabajar con datos en su PI Server.

Manual del usuario de PI DataLink 2014 

115

 

Notificaciones

Procedimiento 1. En la pe pest stañ aña a PI DataLink, en el grupo Notifications, haga clic en Notification Search para abrir el cuadro de diálogo Notification Search. 2. En la pe pest stañ aña a Search, seleccione el servidor PI AF en el que buscará las notificaciones: ◦

En la lista PI Systems, seleccione un servidor PI AF y haga clic en Conectar para conectarse a ese servidor. Si es necesario, haga clic en Mostrar lista 

para abrir la ventana Servidores AF, donde

podrá añadir un servidor de PI AF a la lista. Consulte Añadir un servidor de PI AF a la función Búsqueda de notificación. notificación. ◦

Haga clic en

y, a continuación haga clic en una celda de hoja de cálculo que contenga

el nombre de un servidor de PI AF. Vuelva a hacer clic en el botón para mostrar la lista PI Systems. 3. En la list lista a View Notifications, seleccione la opción de filtrado de las notificaciones devueltas: ◦

Seleccione Active para devolver todas las notificaciones activas actualmente.

◦

Seleccione Timerange e introduzca valores en Start Time y End Time para devolver las

◦

notificaciones que se produzcan a lo largo de un intervalo de tiempo especificado. Seleccione Recent e introduzca un número y un intervalo de tiempo para devolver las notificaciones más recientes de un periodo de tiempo específico.

4. En el ca camp mpo o Output Cell, especifique la hoja de celda de cálculo en la que desee insertar las notificaciones. 5. Ha Haga ga clic clic en Search para  para recuperar las notificaciones que coincidan con determinados determinados criterios en el área de resultados en la parte inferior de la ficha. 6. Examine Examine las notificacione notificacioness recup recuperadas eradas.. Puede: Puede: ◦

Ajustar la visualización de las notificaciones recuperadas

◦

Gestionar las notificaciones recuperadas

7. Ha Haga ga clic clic en OK para insertar las notificaciones mostradas en la hoja de cálculo y cerrar el cuadro de diálogo. PI DataLink inserta la consulta de notificación en la hoja de cálculo como matriz de función en la ubicación designada. Al igual que otras funciones de PI DataLink, la función Búsqueda de notificación actualiza los datos cuando se recalcula la hoja de cálculo. Consulte Recálculo provocado.. provocado

Añadir un servidor de PI AF a la función Búsqueda de notificación El PI System puede tener varios servidores PI AF, cada uno de los cuales puede tener instalado PI Notifications y ser fuente de notificaciones relevantes. Por ejemplo, puede suscribirse a notificaciones de servidores de PI AF que se ejecuten en distintas instalaciones o que representen diferentes unidades de negocio. Para poder ver las notificaciones de un determinado servidor de PI AF en Excel, deberá añadir el servidor a la lista PI Systems B úsqueda de notificación. Systems que mantiene la función Búsqueda

Antes de empezar Suscríbase a las notificaciones en PI System Explorer.

116

Manual del usuario de PI DataLink 2014

 

Notificaciones

Procedimiento 1. En la pe pest stañ aña a Buscar de la ventana Búsqueda de notificación, haga clic en Mostrar lista  junto a la lista PI Systems para abrir la ventana Servidores AF.

2. Ha Haga ga clic clic en Añadir servidor AF para abrir el cuadro de diálogo Propiedades de servidor de PI

AF. 3. Introduzca Introduzca la información información de red red pertine pertinente nte para localizar localizar el servidor servidor PI AF AF y para autenticar su equipo en ese servidor. a. En el camp campo o Nombre, introduzca el nombre que identificará al servidor de PI AF en la función Búsqueda de notificación. b. Ha Haga ga cl clic ic en Configurar Active Directory para configurar el acceso a Active Directory para obtener información de inicio de sesión. 4. Ha Haga ga clic clic en Aceptar para guardar las propiedades y añadirlo a la lista de servidores de PI AF. 5. Ha Haga ga clic clic en Aceptar para cerrar el cuadro de diálogo Servidores AF. El servidor de PI AF aparece en la lista PI Systems. Para obtener más información sobre los servidores de PI AF, consulte la documentación relativa a PI AF.

notificaciones es recuperadas Ajustar la visualización de las notificacion En el cuadro de diálogo Notification Search, el área de resultados situada en la parte inferior de la pestaña Search muestra las notificaciones que coinciden con los criterios de búsqueda especificados. Puede ajustar la visualización de estas notificaciones.

Procedimiento • Haga clic en las cabeceras cabeceras de columna columna para ordenar notificaci notificaciones ones según un atributo atributo determinado. • Haga clic con el botón botón derecho derecho en los resu resultado ltadoss para most mostrar rar y ocultar ocultar columna columnas: s: ◦

◦

Haga clic en Expand All o Collapse All para expandir o contraer un grupo de notificaciones. Haga clic en Show Contact Events para activar y desactivar la visualización de los eventos de contacto para cada notificación.

Manual del usuario de PI DataLink 2014 

117

 

Notificaciones

Gestionar las notificacio notificaciones nes recuperadas En el cuadro de diálogo Notification Search, el área de resultados situada en la parte inferior de la pestaña Search muestra las notificaciones que coinciden con los criterios de búsqueda especificados. Antes de insertar las notificaciones obtenidas en la hoja de cálculo, puede evaluar, gestionar y responder a estas notificaciones.

Procedimiento • Haga clic clic con el bot botón ón derecho derecho en una not notificaci ificación ón y elij elija a un comando. comando. ◦

Acknowledge Instance Reconocimiento de que se ha llevado a cabo una acción en respuesta a la notificación y de que no es necesario escalar la notificación. Si lo desea, introduzca un comentario y haga clic en Aceptar.

◦

Acknowledge Subscription Acusar recibo de una notificación a la que está suscrito. Si lo desea, introduzca un comentario y haga clic en Aceptar.

◦

Add Comment Comentario sobre una notificación.

◦

View Notification Rule Summary Muestra las propiedades de la regla de notificación que ha desencadenado la notificación seleccionada.

Notificaciones insertadas Las funciones de PI DataLink pueden hacer referencia a datos de notificaciones en celdas de hoja de cálculo. Por ejemplo, puede utilizar el valor de Start Time de Time de una notificación recuperada para obtener datos de muestra que indiquen el progreso de un proceso por lotes.

Si sus notificaciones están ajustadas para mostrar confirmaciones, dichas columnas incluyen enlaces a páginas web de PI Notifications en las que podrá confirmar o comentar una notificación. Para obtener más información sobre notificaciones, suscripción y confirmación, consulte el Manual de usuario de PI Notifications. Notifications.

Configuración de visualización de notificaciones Utilice la pestaña Display Format del cuadro de diálogo Notification Search para especificar el aspecto de las notificaciones insertadas en las celdas de hoja de cálculo. Puede seleccionar las columnas que se mostrarán y cambiar la forma en que están organizadas y el formato.

118

Manual del usuario de PI DataLink 2014

 

Notificaciones

Columnas • Selecci Seleccione one columna columnass en la lista lista columns y haga clic en Add para moverlas a la lista datos que se insertarán en la hoja de cálculo. Column order, que especifica losAvailable

Nota: Incluya la columna Acknowledge para añadir un enlace a la hoja de cálculo para confirmar la recepción e incluya la columna Acknowledge With Comment para añadir un enlace en la hoja de cálculo para comentar una notificación. • Ha Haga ga clic clic en Add All para mover todas las columnas a la lista Column order. • Selecci Seleccione one column columnas as de la lista lista Column order y haga clic en los botones de flecha situados encima de la lista para cambiar el orden de las columnas. • Selecci Seleccione one column columnas as en la lista lista Column order y haga clic en Remove para eliminar las columnas seleccionadas de la lista. • Ha Haga ga clic clic en Clear para eliminar todas las columnas de la lista Column order.

Eventos de contacto • Selecci Seleccione one la casill casilla a Display contact events para incluir eventos de contacto relacionados con cada notificación, como el envío a cada destinatario, comentarios y confirmaciones. • Selecci Seleccione one la casill casilla a Indent contacts para añadir un sangrado a los eventos de contacto en la hoja de cálculo. Esto ayuda a identificarlos. ◦

◦

Seleccione Using separate columns para añadir una segunda columna para eventos de contactos. Seleccione Formatting cells para añadir un sangrado a los eventos de contacto en la misma columna que los eventos de notificación.

• Selecci Seleccione one la casill casilla a Group notifications with Excel grouping para utilizar la funcionalidad de agrupación de Excel para anidar eventos de contactos bajo las notificaciones primarias individuales que los generan.

Nota: (DLS) no  no admite la agrupación de Excel. PI DataLink Server (DLS)

Manual del usuario de PI DataLink 2014 

119

 

Notificaciones

Presentación y orientación • Selecci Seleccione one la casill casilla a Display column headers para añadir cabeceras de columna y fila sobre los datos de notificaciones. • Selecci Seleccione one la casill casilla a Display count para añadir una fila o una columna que contenga el total de notificaciones delante de los datos de notificaciones. • En Orient results in, seleccione Columns para mostrar los datos de notificaciones en columnas o seleccione Rows para mostrarlos en filas.

120

Manual del usuario de PI DataLink 2014

 

Referencia de función Puede generar funciones de PI DataLink en los paneles de tareas de PI DataLink (consulte Descripción general de las funciones de PI DataLink ). ). La matriz de la función resultante depende de las entradas. También puede introducir estas mismas funciones directamente en la barra de fórmulas de Excel (consulte Entrada manual de funciones). funciones ). En esta sección se incluye una referencia a las funciones de PI DataLink admitidas. En cada tema, se describen la sintaxis de función y los argumentos; la mayor parte de los temas incluyen un ejemplo. En las secciones siguientes, se agrupan las funciones por tipo.

En esta sección • Funciones de valor único • Funciones de valor múltiple • Funciones de cálculo • Funciones de tags • Funciones de Module Database • Funciones de entrada

Funciones de valor único Las funciones de valor único recuperan el valor de un elemento de datos en un punto específico en el tiempo. Recuperan Recuperan exactamente exactamente un valor por elemento de datos.

En esta sección • PICurrVal() • PIArcVal() • PIExpVal() • PITagAtt()

PICurrVal()

Devuelve el valor actual de un PI point procedente del snapshot o un atributo de PI AF procedente de la base de base de datos.

Sintaxis PICurrVal(DataItem, OutCode, PICurrVal(DataItem,  OutCode, RootP RootPath) ath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve un valor. Especifique un rango de celdas que contengan nombres de PI point o de atributos de PI AF para devolver un valor para cada uno de ellos.

Manual del usuario de PI DataLink 2014 

121

 

Referencia de función Argumento

Tipo

Descripción

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1 y 2.

RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. Consulte Elementos de datos. datos.

Ejemplo =PICurrVal("let439",1,"holden")

Recupera el valor actual y la marca de tiempo correspondiente para el PI point let439 del PI Server denominado holden y coloca la marca de tiempo en la columna a la izquierda del valor.

Consulte también Función Valor actual Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIArcVal() Recupera el valor de un PI point o un atributo de PI AF para una marca de tiempo específica.

Sintaxis PIArcVal(DataItem, PIArcVal(Da taItem, TimeStamp, OutCode, RootPath, Mode)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve un valor. Especifique un rango de celdas que contengan nombres de PI point o de atributos de PI AF para devolver un valor para cada uno de ellos.

TimeStamp

Cadena

La marca de tiempo para la que devuelve valores la función. Consulte Campos de entrada de tiempo. tiempo.

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1 y 2.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

122

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

Mode

Cadena

Método que la función utiliza para obtener valores: •  anterior •  solo anterior •  interpolado •  auto •  siguiente •  solo siguiente •  hora exacta

Ejemplo =PIArcVal("cdep158","11 =PIArcVal(" cdep158","11-dec-92 -dec-92 19:20",0, "casaba","in "casaba","interpolated") terpolated")

Recupera el valor interpolado del PI point cdep158 a las 7:20 p.m. del 11 de diciembre de 1992 procedente del PI Server denominado casaba.

Consulte también Función Valor de archivo histórico Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIExpVal() Recupera el valor calculado de una ecuación de rendimiento para una marca de tiempo específica.

Sintaxis PIExpVal(Expression, PIExpVal(Ex pression, TimeStamp, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Una o varias ecuaciones de rendimiento para los que la función calcula un valor. Consulte Expresiones. Expresiones. Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas.

TimeStamp

Cadena

La m ma arca d de e ttiiempo pa para lla aq qu ue d de evuelve v va alores la la ffu unción. tiempo.. Consulte Campos de entrada de tiempo

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 1 y 2.

RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. Consulte Elementos de datos datos..

Ejemplo =PIExpVal("sqr('sinusoi =PIExpVal(" sqr('sinusoid')","y",0," d')","y",0,"thevax") thevax")

Calcula la raíz cuadrada del valor del PI point sinusoid procedente del PI Server denominado thevax en la medianoche de ayer.

Manual del usuario de PI DataLink 2014 

123

 

Referencia de función

Consulte también Función Valor de archivo histórico Definir funciones manualmente Pautas para introducir argumentos de forma manual

PITagAtt() Recupera un valor de propiedad asoc asociado iado con un elemento de datos específico.

Sintaxis PITagAtt(DataItem, Property, Roo RootPath) tPath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve un valor. Especifique un rango de celdas que contengan nombres de PI point o de atributos de PI AF para devolver un valor para cada uno de ellos.

Propiedad

Cadena

El atributo del PI point o la propiedad del atributo de PI AF para los que la función devuelve un valor.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Ejemplo =PITagAtt(d1,"uom",)

Recupera las unidades de ingeniería del PI point especificado en la celda D1 del PI Server predeterminado.

Consulte también Función Propiedades

Funciones de valor múltiple Las funciones de valor múltiple asocian un PI point o un atributo de PI con un periodo de tiempo a lo largo del cual puede haber uno o muchos valores correspondientes.

En esta sección • PINCompDat() • PINCompFilDat() • PICompDat() • PICompFilDat() • PISampDat() • PISampFilDat() • PIExpDat() • PITimeDat()

124

Manual del usuario de PI DataLink 2014

 

Referencia de función • PITimeExpDat()

PINCompDat() Recupera un número específico de valores de PI point o de atributos de PI AF a partir de una determinada hora.

Sintaxis PINCompDat(DataItem, STime, NumVals, OutCode, RootPath, Mode)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para devolver valores para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función devuelve valores. Consulte Campos de entrada de tiempo. tiempo.

NumVals

Integer

El número de valores que la función recupera, a partir de STime  (especifique un número negativo STime (especifique para recuperar valores hacia atrás en el tiempo).

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1, 2, 5 y 6.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Mode

Cadena

Método que la función utiliza para determinar qué valores se recuperarán cerca de la hora de inicio (tipo de límite): •  interior •  externo •  interpolado •  auto

Ejemplo =PINCompDat("cdf144","1:00:00",10,1,,"inside")

Devuelve diez valores y sus marcas de tiempo correspondientes procedentes del PI Server predeterminado para el PI point cdf144 a partir de la 1:00 a.m. de esta mañana, utilizando el tipo de límite interior.

Consulte también Función Datos comprimidos Definir funciones manualmente Pautas para introducir argumentos de forma manual

Manual del usuario de PI DataLink 2014 

125

 

Referencia de función

PINCompFilDat() Recupera un número específico de valores de PI point filtrados o de atributos de PI AF filtrados a partir de una determinada hora.

Sintaxis PINCompFilDat(DataItem, STime, NumVals, FiltExp, FiltCode, OutCode, RootPath, Mode)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve un valor. Especifique un rango de celdas que contengan nombres de PI point o de atributos de PI AF para devolver un valor para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función devuelve valores. Consulte Campos de entrada de tiempo. tiempo.

NumVals

Integer

El número de valores que la función recupera, a partir de STime STime (especifique  (especifique un número negativo

FiltExp

Cadena

FiltCode

Integer

para recuperar valores hacia atrás en el tiempo). Ecuación de rendimiento booleana que la función utiliza para filtrar valores. Cuando la expresión se evalúa como falsa, la función excluye los valores correspondientes. Consulte Expresiones de filtro filtro.. Código que indica si deben etiquetarse los valores filtrados: •  1 Insertar la etiqueta Filtered en lugar de un valor o un bloque de valores que la función ha filtrado de la salida en función de FiltExp FiltExp.. •  0 No etiquetar valores filtrados.

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la la función la forma Códigos en que lade función orienta salida.yConsulte salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1, 2, 5 y 6.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Mode

Cadena

Método que la función utiliza para determinar qué valores se recuperarán cerca de la hora de inicio (tipo de límite): •  interior •  externo •  interpolado •  auto

Ejemplo

=PINCompFilDat("cdf144","2:00:00",10,"'cdep158'>38",1,1,,)

126

Manual del usuario de PI DataLink 2014

 

Referencia de función Devuelve diez valores y las marcas de tiempo correspondientes procedentes del PI Server predeterminado para el PI point cdf144 a partir de las 02:00 a.m. de esta mañana, cuando el punto cdep158 es mayor que 38, utilizando el tipo de límite interior. La salida contiene la etiqueta Filtered entre todos los valores en los que la condición de filtro ha sido falsa.

Consulte también Función Datos comprimidos Expresiones de filtro Definir funciones manualmente Pautas para introducir argumentos de forma manual

PICompDat() Devuelve valores de PI point o de atributos de PI AF, almacenados durante un determinado periodo de tiempo.

Sintaxis PICompDat(DataItem, PICompDat(D ataItem, STime, ETime, OutCode, RootPath, Mode)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para devolver valores para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función devuelve valores. Consulte Campos de entrada de tiempo. tiempo.

ETime

Cadena

El final del periodo de tiempo para el que la función devuelve valores.

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1, 2, 4, 5 y 6.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Mode

Cadena

Método que la función utiliza para determinar qué valores se recuperarán cerca de la hora de inicio (tipo de límite): •  interior •  externo •  interpolado •  auto

Ejemplo =PICompDat("cdf1 44","1:00:00","3:00:00", 1,,"inside")

Manual del usuario de PI DataLink 2014 

127

 

Referencia de función Devuelve valores y sus marcas de tiempo correspondientes procedentes del PI Server predeterminado para el PI point cdf144 a partir de la 1:00 a.m. a las 3:00 a.m. de esta mañana, utilizando el tipo de límite interior.

Consulte también Función Datos comprimidos Definir funciones manualmente Pautas para introducir argumentos de forma manual

PICompFilDat() Devuelve valores de PI point filtrados o de atributos de PI AF filtrados, almacenados durante un determinado periodo de tiempo.

Sintaxis PICompFilDat(DataItem, PICompFilDa t(DataItem, STime, ETime, FiltExp, FiltCode, OutCode, RootPath, Mode)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para devolver valores para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función devuelve valores. Consulte Campos de entrada de tiempo. tiempo.

ETime

Cadena

El final del periodo de tiempo para el que la función devuelve valores.

FiltExp

Cadena

Ecuación de rendimiento booleana que la función utiliza para filtrar valores. Cuando la expresión se evalúa como falsa, la función excluye los valores filtro.. correspondientes. Consulte Expresiones de filtro

FiltCode

Integer

Código que indica si deben etiquetarse los valores filtrados: •  1 Insertar la etiqueta Filtered en lugar de un valor o un bloque de valores que la función ha filtrado de la salida en función de FiltExp FiltExp.. •  0 No etiquetar valores filtrados.

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1, 2, 4, 5 y 6.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

128

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

Mode

Cadena

Método que la función utiliza para determinar qué valores se recuperarán cerca de STime STime o  o ETime (tipo de límite): •  interior •  externo •  interpolado •  auto

Ejemplo =PICompFilDat("cdf144", =PICompFilD at("cdf144","2:00:00","1 "2:00:00","10:00:00","'c 0:00:00","'cdep158'>38", dep158'>38",1,1,,) 1,1,,)

Devuelve valores y sus marcas de tiempo correspondientes procedentes del PI Server predeterminado para el PI point cdf144, desde las 2:00 a.m. hasta las 10:00 a.m., cuando el PI point cdep158 es mayor que 38, utilizando el tipo de límite interior. La salida contiene la etiqueta Filtered entre todos los valores en los que la condición de filtro ha sido falsa.

Consulte también Función Datos comprimidos Expresiones de filtro Definir funciones manualmente Pautas para introducir argumentos de forma manual

PISampDat() Recupera valores interpolados, con intervalos iguales, para un PI point o un atributo de PI AF almacenados a lo largo de un determinado periodo de tiempo.

Sintaxis PISampDat(DataItem, STime, ETime, Interval, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para devolver valores para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función devuelve valores. Consulte Campos de entrada de tiempo. tiempo.

ETime

Cadena

El final del periodo de tiempo para el que la función devuelve valores.

Interval

Cadena

El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo.. tiempo

Manual del usuario de PI DataLink 2014 

129

 

Referencia de función Argumento

Tipo

Descripción

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1 y 2.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Ejemplo =PISampDat("sinusoid","y","t","3h",1,)

Recupera datos de muestra y las marcas de tiempo correspondientes para el PI point sinusoid procedentes del PI Server predeterminado, desde la medianoche de ayer hasta la medianoche de hoy, notificando valores en intervalos de 3 horas.

Consulte también Función Datos de muestra Definir funciones manualmente Pautas para introducir argumentos de forma manual

PISampFilDat() Recupera valores interpolados y filtrados, con intervalos iguales, para un PI point o un atributo de PI AF almacenados a lo largo de un determinado periodo de tiempo.

Sintaxis PISampFilDat(DataItem, STime, ETime, Interval, FiltExp, FiltCode, OutCode, PISampFilDat(DataItem, RootPath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre del atributo de PI AF para los que la función devuelve valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para devolver valores para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función devuelve valores. Consulte Campos de entrada de tiempo. tiempo.

ETime

Cadena

El final del periodo de tiempo para el que la función devuelve valores.

Interval

Cadena

El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo.. tiempo

130

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

FiltExp

Cadena

Ecuación de rendimiento booleana que la función utiliza para filtrar valores. Cuando la expresión se evalúa como falsa, la función excluye los valores correspondientes. Consulte Expresiones de filtro filtro..

FiltCode

Integer

Código que indica si deben etiquetarse los valores filtrados: •  1 Insertar la etiqueta Filtered en lugar de un valor o un bloque de valores que la función ha filtrado de la salida en función de FiltExp FiltExp.. •  0 No etiquetar valores filtrados.

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1 y 2.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Ejemplo =PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,)

Recupera datos de muestra para el PI point sinusoid procedentes del PI Server predeterminado. La La función recupera valores valores a  a las 12 de las noche del 11-ene-97, a la 1:00 a.m del 11-ene-97, a las 2:00 a.m. del 11-ene-97 y a las 3:00 a.m. del 11-ene-97. Si no se ha satisfecho la condición de la celda A1 en alguna de esas horas, la función devuelve la etiqueta Filtered para esa hora. La función muestra marcas de tiempo en la primera columna y valores en la segunda columna.

Consulte también Función Datos de muestra Expresiones de filtro Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIExpDat() Recupera valores calculados, con intervalos iguales, de una ecuación de rendimiento a lo largo de un determinado periodo de tiempo.

Sintaxis PIExpDat(Expression, PIExpDat(Ex pression, STime, ETime, Interval, OutCode, RootPath)

Manual del usuario de PI DataLink 2014 

131

 

Referencia de función

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Una o varias ecuaciones de rendimiento para los que la función calcula un valor. Consulte Expresiones Expresiones.. Incluya un rango celdas valores que contenga expresiones para de devolver para cada una de ellas.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula un valor. Consulte Campos de entrada de tiempo. tiempo.

ETime

Cadena

El final del periodo de tiempo para el que la función calcula un valor.

Interval

Cadena

El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo.. tiempo

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida  para obtener información sobre cómo calcular el código. Esta función admite los bits 1 y 2.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Ejemplo =PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")

Calcula la raíz cuadrada del valor del PI point sinusoid recuperad  recuperado o del PI Server denominado thevax a intervalos de una hora, comenzando por la medianoche de ayer hasta la medianoche de hoy. La función muestra la marca de tiempo de cada valor en la columna  situa  situada da a la izquierda del valor calculado.

Consulte también Función Datos de muestra Definir funciones manualmente Pautas para introducir argumentos de forma manual

PITimeDat() Recupera los valores de muestra reales o interpolados de un PI point o un atributo de PI AF con determinadas marcas de tiempo.

Sintaxis PITimeDat(DataItem, TimeStamps, RootPath, Mode)

132

Manual del usuario de PI DataLink 2014

 

Referencia de función

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre d de el atributo de PI AF para los que la función devuelve valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para devolver valores para cada uno de ellos.

TimeStamps

Re Refferencia

Refere ren ncia a una o va varias rias hojas d de e ccá álculo qu que cco ont ntiienen marcas de tiempo para las que la función devuelve valores. Consulte Campos de entrada de tiempo tiempo..

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Mode

Cadena

Método que la función u uttiliza para ob obtener datos: •  interpolado •  hora exacta

Devoluciones Valores con las marcas de tiempo especificadas, presentados con la misma orientación que la referencia de marca de tiempo. Si la referencia de marca de tiempo es una fila, la función presenta valores en una fila. Si la referencia de marca de tiempo es una columna, la función presenta valores en una columna. La orientación de la matriz de salida debe coincidir con la de la referencia de marca de tiempo.

Ejemplo =PITimeDat("myta g",b1:b12,,"interpolated")

Recupera valores interpolados interpolados con las marcas de d e tiempo ubicadas en las celdas B1 a B12 para el PI point mytag en el PI Server predeterminado. Esta función requiere una matriz de salida horizontal de doce celdas; por ejemplo, C1:C12 o B14:B25.

Consulte también Función Datos temporizados Definir funciones manualmente Pautas para introducir argumentos de forma manual

PITimeExpDat() Recupera los valores de una ecuación de rendimiento calculados para unas determinadas marcas de tiempo.

Sintaxis PITimeExpDat(Expression PITimeExpDa t(Expression, , TimeStamps, RootPath)

Manual del usuario de PI DataLink 2014 

133

 

Referencia de función

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Una o varias ecuaciones de rendimiento para los que la función calcula un valor. Consulte Expresiones Expresiones.. Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas.

TimeStamps

Referencia

Referencia a una o varias hojas de cálculo que contienen marcas de tiempo para las que la función devuelve valores. Consulte Campos de entrada de tiempo. tiempo.

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos. datos.

Devoluciones Valores con las marcas de tiempo especificadas, presentados con la misma orientación que la referencia de marca de tiempo. Si la referencia de marca de tiempo es una fila, la función presenta valores en una fila. Si la referencia de marca de tiempo es una columna, la función presenta valores en una columna. La orientación de la matriz de salida debe coincidir con la de la referencia de marca de tiempo.

Ejemplo =PITimeExpDat("sqr('sinusoid')",b1:b12,)

Calcula la raíz cuadrada del valor del PI point sinusoid recuperado del PI Server predeterminado a las horas especificadas en las celdas B1 a B12. Esta función requiere una matriz de salida horizontal de doce celdas; por ejemplo, C1:C12 o B14:B25.

Consulte también Función Datos temporizados Definir funciones manualmente Pautas para introducir argumentos de forma manual

Funciones de cálculo Las funciones de cálculo calculan nuevos valores a partir de valores de PI points, atributos de PI AF o evaluaciones de ecuaciones de rendimiento durante un periodo de tiempo específico.

En esta sección • PIAdvCalcVal() • PIAdvCalcFilVal() • PIAdvCalcExpVal() • PIAdvCalcExpFilVal() • PIAdvCalcDat() • PIAdvCalcFilDat()

• PIAdvCalcExpDat()

134

Manual del usuario de PI DataLink 2014

 

Referencia de función • PIAdvCalcExpFilDat() • PITimeFilter() • PITimeFilterVal()

PIAdvCalcVal() Recupera un valor calculado a partir de valores de PI point o de atributo de PI AF durante un determinado periodo de tiempo.

Sintaxis PIAdvCalcVal(DataItem, PIAdvCalcVa l(DataItem, STime, ETime, Mode, CalcBasis, MinPctGood, CFactor, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre d de el atributo de PI AF para los que la función calcula un valor. Especifique un rango de celdas que contengan nombres de PI point o de atributos de PI AF para calcular un valor para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula

ETime

Cadena

un valor. Consulte Campos de entrada de tiempo tiempo.. El final del periodo de tiempo para el que la función calcula un valor.

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell periodo de tiempo para calcular y devolver un valor.

CFactor

Número

Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día).

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3 y 9 (si Mode Mode se  se establece en mínimo, máximo o rango).

RootPath

Cadena

datos.. La ruta del elemento de datos. Consulte Elementos de datos

Ejemplo =PIAdvCalcVal("cdf144", =PIAdvCalcV al("cdf144","y","t","tot "y","t","total","time-we al","time-weighted",50,1 ighted",50,1,4,) ,4,)

Manual del usuario de PI DataLink 2014 

135

 

Referencia de función Devuelve un total de tiempo ponderado para el PI point cdf144 calculado a partir de los valores del PI Server predeterminado desde ayer a hoy. La función multiplica el resultado por 1 y sólo devuelve un resultado si al menos un 50 por ciento de los datos son correctos. La función devuelve el porcentaje correcto a la derecha del total calculado.

Consulte también

Función Datos calculados Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIAdvCalcFilVal() Recupera un valor calculado a partir de valores filtrados de PI point o de atributo de PI AF durante un determinado periodo de tiempo.

Sintaxis PIAdvCalcFilVal(DataItem, STime, ETime, FiltExp, Mode, CalcBasis, SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre d de el atributo de PI AF para los que la función calcula un valor. Especifique un rango de celdas que contengan nombres de PI point o de atributos de PI AF para calcular un valor para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula un valor. Consulte Campos de entrada de tiempo tiempo..

ETime

Cadena

El final del periodo de tiempo para el que la función calcula un valor.

FiltExp

Cadena

Ecuación de rendimiento booleana que la función utiliza para filtrar valores. Cuando la expresión se evalúa como falsa, la función excluye los valores correspondientes. Consulte Expresiones de filtro. filtro.

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

SampMode

Cadena

Método de muestreo que la función utiliza para determinar cuándo evaluar el argumento FiltExp FiltExp:: •  comprimido •  interpolado

136

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

SampFreq

Cadena

Frecuencia con que la función evalúa el argumento FiltExp si SampMode SampMode se  se define como interpolado. Introduzca un valor y una unidad de tiempo. Por ejemplo, defina 10m (10 minutos) para devolver un valor interpolado por cada intervalo de 10 minutos. Consulte Especificación de intervalos de tiempo

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell periodo de tiempo para calcular y devolver un valor.

CFactor

Número

Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día).

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3 y 9 (si Mode  se establece en mínimo, máximo o rango). Mode se

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos datos..

Ejemplo =PIAdvCalcFilVal ("cdf144","y","t","'cdm158' ("cdf144","y","t","'cdm158'=""Manual""","total","time=""Manual""","total","timeweighted","compressed", weighted"," compressed","10m",50,1,4 "10m",50,1,4,) ,)

Devuelve el total de de tiempo ponderado para el para el PI point cdf144 calculado a partir de los valores del PI Server predeterminado, sumando los valores de ayer a hoy durante los períodos de tiempo en que el PI point cdm158 se ha establecido como Manual. La función multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la función ignora el intervalo de muestreo y realiza un muestreo de la expresión de filtro en los eventos comprimidos del punto cdf144. La función solo devuelve un resultado si al menos un 50 por ciento de los datos son correctos. La función devuelve el porcentaje correcto a la derecha del total calculado.

Consulte también Función Datos calculados Expresiones de filtro Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIAdvCalcExpVal() Devuelve un valor calculado a partir de una ecuación de rendimiento du rante un determ determinado inado período de tiempo.

Sintaxis PIAdvCalcExpVal(Express PIAdvCalcEx pVal(Expression, ion, STime, ETime, Mode, CalcBasis, SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Manual del usuario de PI DataLink 2014 

137

 

Referencia de función

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Una o varias ecuaciones de rendimiento para los que la función calcula un valor. Consulte Expresiones. Expresiones. Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas. El inicio del periodo de tiempo para el que la función calcula tiempo.. un valor. Consulte Campos de entrada de tiempo

STime

Cadena

ETime

Cadena

El final del periodo de tiempo para el que la función calcula un valor.

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

SampMode

Cadena

Método de muestreo que la función utiliza para determinar cuándo evaluar el argumento Expression Expression:: •  comprimido •  interpolado

SampFreq

Cadena

Frecuencia con que la función evalúa el argumento  si SampMode  se define como interpolado. Expression si Expression SampMode se Introduzca un valor y una unidad de tiempo. Por ejemplo, defina 10m (10 minutos) para devolver un valor interpolado por cada intervalo de 10 minutos. Consulte Especificación de intervalos de tiempo

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell

CFactor

Número

OutCode

Integer

periodo de tiempo para calcular y devolver un valor. Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día). Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3 y 9 (si Mode  se establece en Mode se mínimo , máximo  o rango).

RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. Consulte Elementos de datos datos..

138

Manual del usuario de PI DataLink 2014

 

Referencia de función

Ejemplo =PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total"," timeweighted","compressed","10m",50,1,4,)

Devuelve el total de tiempo ponderado para la expresión 'cdf144'+'cdt158' calculado a partir de los valores del PI Server predeterminado desde ayer a hoy: La función multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la función ignora el intervalo de muestreo y realiza un muestreo de la expresión de filtro en los eventos comprimidos de cdf144 y cdt158. La función solo devuelve un resultado si al menos un 50 por ciento de los datos son correctos. La función devuelve el porcentaje correcto a la derecha del total calculado.

Consulte también Función Datos calculados Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIAdvCalcExpFilVal() Devuelve un valor filtrado de PI point calculado en función de una ecuación de rendimiento.

Sintaxis PIAdvCalcExpFilVal(Expr PIAdvCalcEx pFilVal(Expression, ession, STime, ETime, FiltExp, Mode, CalcBasis, SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Una o varias ecuaciones de rendimiento para los que la función calcula un valor. Consulte Expresiones. Expresiones. Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula tiempo.. un valor. Consulte Campos de entrada de tiempo

ETime

Cadena

E l fvalor. inal del periodo de tiempo para el que la función calcula un

FiltExp

Cadena

Ecuación de rendimiento booleana que la función utiliza para filtrar valores. Cuando la expresión se evalúa como falsa, la función excluye los valores correspondientes. Consulte filtro. Expresiones de filtro.

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

Manual del usuario de PI DataLink 2014 

139

 

Referencia de función Argumento

Tipo

Descripción

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

SampMode

Cadena

Método de muestreo que la función utiliza para determinar cuándo evaluar los argumentos Expression Expression y  y FiltExp FiltExp:: •  comprimido •  interpolado

SampFreq

Cadena

Frecuencia con que la función evalúa los argumentos Expression y Expression  y FiltExp FiltExp si  si SampMode SampMode se  se define como interpolado. Introduzca un valor y una unidad de tiempo. Por ejemplo, defina 10m (10 minutos) para devolver un valor interpolado por cada intervalo de 10 minutos. Consulte Especificación de intervalos de tiempo tiempo..

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell periodo de tiempo para calcular y devolver un valor.

CFactor

Número

Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día).

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3 y 9 (si Mode  se establece en Mode se

mínimo , máximo  o rango). RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. Consulte Elementos de datos datos..

Ejemplo =PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'= "Product2"","total","ti "Product2"" ,"total","time-weighted" me-weighted","compressed ,"compressed","10m",50,1 ","10m",50,1,4,) ,4,)

Devuelve el total de tiempo ponderado para la expresión 'cdf144'+'cdt158' calculado a partir de los valores del PI Server predeterminado cuando 'productid' = "Product2" desde ayer a hoy: La función multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la función ignora el intervalo de muestreo y realiza un muestreo de la expresión de filtro en los eventos comprimidos de cdf144 y cdt158. La función solo devuelve un resultado si al menos un 50 por ciento de los datos son correctos. La función devuelve el porcentaje correcto a la derecha del total calculado.

Consulte también Función Datos calculados Expresiones de filtro Definir funciones manualmente Pautas para introducir argumentos de forma manual

140

Manual del usuario de PI DataLink 2014

 

Referencia de función

PIAdvCalcDat() Recupera valores espaciados regularmente calculados a partir de valores de PI point o de atributo de PI AF durante un determinado periodo de tiempo.

Sintaxis PIAdvCalcDat(DataItem, STime, ETime, Interval, Mode, CalcBasis, MinPctGood, PIAdvCalcDat(DataItem, CFactor, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre d de el atributo de PI AF para los que la función calcula valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para calcular valores para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula tiempo.. valores. Consulte Campos de entrada de tiempo

ETime

Cadena

El final del periodo de tiempo para el que la función calcula valores.

Interval

Cadena

El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo tiempo..

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell periodo de tiempo para calcular y devolver un valor.

CFactor

Número

Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día).

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3, 7, 8 y 9 (si Mode  se establece Mode se en mínimo, máximo o rango).

RootPath

Cadena

La ruta del elemento de datos. Consulte Elementos de datos datos..

Manual del usuario de PI DataLink 2014 

141

 

Referencia de función

Ejemplo =PIAdvCalcDat("cdf144","y","t","3h","total","time-weighted",50,

1,4,)

Devuelve el total de tiempo ponderado para el PI point cdf144 calculado a partir de los valores del PI Server predeterminado en intervalos de tres horas desde la medianoche de ayer a la medianoche de hoy. La función multiplica el resultado por 1 y sólo devuelve un resultado si al menos un 50 por ciento de los datos son correctos. La función devuelve el porcentaje correcto a la derecha de cada total calculado.

Consulte también Función Datos calculados Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIAdvCalcFilDat() Recupera un valores espaciados regularmente calculados a partir de valores filtrados de PI point o de atributo de PI AF durante un determinado periodo de tiempo.

Sintaxis PIAdvCalcFilDat(DataItem, STime, ETime, Interval, FiltExp, Mode, CalcBasis, SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

DataItem

Cadena

El nombre del PI point o el nombre d de el atributo de PI AF para los que la función calcula valores. Especifique un rango de celdas que contengan nombres de PI point o nombres de atributos de PI AF para calcular valores para cada uno de ellos.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula valores. Consulte Campos de entrada de tiempo tiempo..

ETime

Cadena

El final del periodo de tiempo para el que la función calcula

Interval

Cadena

FiltExp

Cadena

valores. El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo tiempo.. Ecuación de rendimiento booleana que la función utiliza para filtrar valores. Cuando la expresión se evalúa como falsa, la función excluye los valores correspondientes. Consulte Expresiones de filtro. filtro.

142

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

SampMode

Cadena

Método de muestreo que la función utiliza para determinar cuándo evaluar el argumento FiltExp FiltExp:: •  comprimido •  interpolado

SampFreq

Cadena

Frecuencia con que la función evalúa el argumento FiltExp si SampMode  se define como interpolado. Introduzca un SampMode se valor y una unidad de tiempo. Porinterpolado ejemplo, defina 10m (10 minutos) para devolver un valor por cada intervalo de 10 minutos. Consulte Especificación de intervalos de tiempo

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell periodo de tiempo para calcular y devolver un valor.

CFactor

Número

Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día).

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3, 7, 8 y 9 (si Mode Mode se  se establece en mínimo, máximo o rango).

RootPath

Cadena

datos.. La ruta del elemento de datos. Consulte Elementos de datos

Ejemplo =PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""", weighted","compressed", weighted"," compressed","10m",50,1,4 "10m",50,1,4,) ,)

"total","time-

Devuelve el total de tiempo ponderado para el PI point cdf144 calculado a partir de los valores del PI Server predeterminado en intervalos de tres horas desde la medianoche de ayer a la medianoche de hoy cuando el PI point cdf144 se ha establecido como Manual. La función multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la función ignora el intervalo de muestreo y realiza un muestreo de la expresión de filtro en los eventos comprimidos de cdf144. La función solo devuelve un resultado si al menos un 50 por ciento de los datos son correctos. La función devuelve el porcentaje correcto a la derecha del total calculado.

Manual del usuario de PI DataLink 2014 

143

 

Referencia de función

Consulte también Función Datos calculados Expresiones de filtro Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIAdvCalcExpDat() Devuelve valores espaciados regularmente calculados a partir de una ecuación de rendimiento durante un determinado período de tiempo.

Sintaxis PIAdvCalcExpDat(Expression, STime, ETime, Interval, Mode, CalcBasis,SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Una o varias ecuaciones de rendimiento para los que la función calcula un valor. Consulte Expresiones. Expresiones. Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula valores. Consulte Campos de entrada de tiempo tiempo..

ETime

Cadena

El final del periodo de tiempo para el que la función calcula valores.

Interval

Cadena

El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo tiempo..

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

SampMode

Cadena

Método de muestreo que la función utiliza para determinar cuándo evaluar el argumento Expression Expression:: •  comprimido •  interpolado

144

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

SampFreq

Cadena

Frecuencia con que la función evalúa el argumento Expression si Expression  si SampMode SampMode se  se define como interpolado. Introduzca un valor y una unidad de tiempo. Por ejemplo, defina 10m (10 minutos) para devolver un valor interpolado por cada intervalo de 10 minutos. Consulte Especificación de intervalos de tiempo

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell periodo de tiempo para calcular y devolver un valor.

CFactor

Número

Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día).

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3, 7, 8 y 9 (si Mode Mode se  se establece en mínimo, máximo o rango).

RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. Consulte Elementos de datos datos..

Ejemplo =PIAdvCalcExpDat("'cdf144'+'cdt158' =PIAdvCalcExpDat("'cdf1 44'+'cdt158'","y","t","3 ","y","t","3h","total", h","total", "timeweighted","compressed", "10m",50,1,4,)

Calcula la expresión 'cdf144'+'cdt158' con cualquier marca de tiempo entre la medianoche de ayer y la medianoche de hoy con un valor registrado almacenado en el PI Server predeterminado y calcula el total de tiempo ponderado de los valores calculados en intervalos de tres horas. La función multiplica cada total calculado por 1 y devuelve un valor cuando el porcentaje de valores correctos es como mínimo del 50% durante el intervalo de tres horas. La función devuelve el porcentaje correcto a la derecha del total calculado. Tenga en cuenta que dado que el modo de muestreo es compressed, la función ignora el intervalo de muestreo y realiza un muestreo de valores siempre que cdf144 o cdt158 tenga almacenado un valor registrado.

Consulte también Función Datos calculados Definir funciones manualmente Pautas para introducir argumentos de forma manual

PIAdvCalcExpFilDat() Devuelve valores espaciados regularmente calculados a partir de una ecuación de rendimiento filtrada durante un determinado período de tiempo.

Sintaxis PIAdvCalcExpFilDat(Expr PIAdvCalcEx pFilDat(Expression, ession, STime, ETime, Interval, FiltExp, Mode, CalcBasis, SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Manual del usuario de PI DataLink 2014 

145

 

Referencia de función

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Una o varias ecuaciones de rendimiento para los que la función calcula un valor. Consulte Expresiones. Expresiones. Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula tiempo.. valores. Consulte Campos de entrada de tiempo

ETime

Cadena

El final del periodo de tiempo para el que la función calcula valores.

Interval

Cadena

El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo tiempo..

FiltExp

Cadena

Ecuación de rendimiento booleana que la función utiliza para filtrar valores. Cuando la expresión se evalúa como falsa, la función excluye los valores correspondientes. Consulte Expresiones de filtro. filtro.

Mode

Cadena

Tipo de cálculo que realiza la función: •  total •  mínimo •  máximo •  desviación estándar •  intervalo •  promedio •  recuento •  media

CalcBasis

Cadena

El método de cálculo: •  ponderado a tiempo •  ponderado a evento

SampMode

Cadena

Método de muestreo que la función utiliza para determinar cuándo evaluar los argumentos Expression  y FiltExp Expression y FiltExp:: •  comprimido •  interpolado

SampFreq

Cadena

Frecuencia con que la función evalúa los argumentos Expression y Expression  y FiltExp FiltExp si  si SampMode SampMode se  se define como interpolado. Introduzca un valor y una unidad de tiempo. Por ejemplo, defina 10m (10 minutos) para devolver un valor interpolado por cada intervalo de 10 minutos. Consulte Especificación de intervalos de tiempo tiempo..

MinPctGood

Número

Porcentaje m míínimo d de ed da atos co correctos ne necesarios d du urante e ell periodo de tiempo para calcular y devolver un valor.

CFactor

Número

Factor qu que lla a ffu unción ap aplica a all v va alor d de evuelto. In Introduzca 1 si el factor de conversión no es necesario. Para los cálculos de totales ponderados en el tiempo, especifique un factor que convierta los valores de velocidad registrados a la unidad de tiempo predeterminada del servidor (unidades por día).

146

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3, 7, 8 y 9 (si Mode Mode se  se establece en mínimo, máximo o rango).

RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. datos.. Consulte Elementos de datos

Ejemplo =PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'productid'="Product2"","tot al","time-weighted","co al","time-w eighted","compressed","1 mpressed","10m",50,1,4,) 0m",50,1,4,)

Calcula un total de tiempo ponderado para la expresión 'cdf144'+'cdt158' cuando aye r a hoy del PI Server 'productid' = "Product2" en intervalos de 3 horas desde ayer predeterminado: La función multiplica cada total calculado por 1 y devuelve un valor cuando el porcentaje de valores correctos es como mínimo del 50% durante el intervalo de tres horas. La función devuelve el porcentaje correcto a la derecha del total calculado. Tenga en cuenta que debido a que el modo de muestreo es compressed, la función ignora la frecuencia de muestreo y realiza un muestreo de los valores siempre que cdf144 o cdt158 tenga un evento almacenado o el valor de productid cambie de o a Product2.

Consulte también Función Datos calculados Expresiones de filtro Definir funciones manualmente Pautas para introducir argumentos de forma manual

PITimeFilter() Devuelve la cantidad de tiempo durante el que una ecuación de rendimiento se evalúa como verdadera a lo largo de intervalos iguales de un determinado periodo de tiempo especificado.

Sintaxis PITimeFilter(Expression PITimeFilte r(Expression, , STime, ETime, Interval, TimeUnit, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Ecuación d de e rre endimiento bo booleana q qu ue lla a fu función e ev valúa. Expresiones.. Consulte Expresiones Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula tiempo.. valores. Consulte Campos de entrada de tiempo

ETime

Cadena

El final del periodo de tiempo para el que la función calcula valores.

Manual del usuario de PI DataLink 2014 

147

 

Referencia de función Argumento

Tipo

Descripción

Interval

Cadena

El intervalo entre valores devueltos. Introduzca un valor y la unidad temporal que especifica la duración del intervalo. Por ejemplo, introduzca 15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos durante el periodo de tiempo. Consulte Especificación de intervalos de tiempo tiempo..

TimeUnit

Cadena

Unidad de tiempo del resultado calculado: •  segundos •  minutos •  horas •  días

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2, 3, 7 y 8.

RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. Consulte Elementos de datos datos..

Ejemplo =PITimeFilter($A$1,"y","t","1h","seconds",65,"thevax")

Devuelve el número de segundos durante los cuales la expresión de la celda A1 es verdadera en el PI Server denominado thevax en intervalos de 1 hora, comenzando en la medianoche de ayer hasta la medianoche de hoy. La función muestra muestra la marca de tiempo del inicio de cada intervalo de c álculo a la izquierda del valor.

Consulte también Función Filtrado de tiempo Definir funciones manualmente Pautas para introducir argumentos de forma manual

PITimeFilterVal() Devuelve la cantidad de tiempo durante el que una ecuación de rendimiento se evalúa como verdadera a lo largo de un determinado periodo de tiempo.

Sintaxis PITimeFilterVal(Expression, STime, ETime, TimeUnit, OutCode, RootPath)

Argumentos Argumento

Tipo

Descripción

Expression

Cadena

Ecuación d de e rre endimiento bo booleana q qu ue lla a fu función e ev valúa. Consulte Expresiones Expresiones.. Incluya un rango de celdas que contenga expresiones para devolver valores para cada una de ellas.

STime

Cadena

El inicio del periodo de tiempo para el que la función calcula un valor. Consulte Campos de entrada de tiempo tiempo..

148

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

ETime

Cadena

El final del periodo de tiempo para el que la función calcula un valor.

TimeUnit

Cadena

Unidad de tiempo del resultado calculado: •  segundos •  minutos •  horas •  días

OutCode

Integer

Código de salida que determina los datos añadidos que devuelve la función y la forma en que la función orienta la salida. Consulte Códigos de salida para salida para obtener información sobre cómo calcular el código. Esta función admite los bits 2 y 3.

RootPath

Cadena

Ruta al elemento de datos al que hace referencia la expresión. datos.. Consulte Elementos de datos

Ejemplo =PITimeFilterVal($A$1," =PITimeFilt erVal($A$1,"y","t","seco y","t","seconds",0,"thev nds",0,"thevax") ax")

Devuelve el número de segundos durante los cuales la expresión de la celda A1 es verdadera en el PI Server denominado thevax desde la medianoche de ayer hasta la medianoche de hoy.

Consulte también Función Filtrado de tiempo Definir funciones manualmente Pautas para introducir argumentos de forma manual

Funciones de tags Las funciones le ayudan ayudan a trabajar con PI points.

En esta sección • PIPointIDToTag() • PIAttributeMaskToTag ()

PIPointIDToTag() Devuelve el nombre del PI point correspondiente a un ID de PI point específico.

Sintaxis PIPointIDToTag(PointID, PIServer)

Argumentos Argumento

Tipo

Descripción

PointID

Cadena

ID de PI point, el cual es un ID interno ex exclusivo que no se ha vuelto a utilizar tras eliminar un punto.

Manual del usuario de PI DataLink 2014 

149

 

Referencia de función Argumento

Tipo

Descripción

PIServer

Cadena

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

Ejemplo =PIPointIDToTag("123","thevax")

Busca el PI Server denominado thevax para el ID de punto 123 y devuelve el nombre de dicho punto (el atributo Tag ). Tag).

Consulte también Función Apuntar ID al Tag

PIAttributeMaskToTag PIAttributeMa skToTag () Obtiene los nombres de PI Points que coinciden con uno o más de los valores de atributos de PI point especificados.

Sintaxis PIAttributeMaskToTag(TagName, EngUnits, OutCode, PIServer) Descriptor, PointSource, PointType, PointClass,

Argumentos Argumento

Tipo

Descripción

TagName

Cadena

Nombre de los puntos devueltos. 1

Descriptor

Cadena

Descriptor de los puntos devueltos. 1

PointSource

Cadena

Origen de punto de los puntos devueltos.1

PointType

Cadena

Tipo de punto de los puntos devueltos.1

PointClass

Cadena

Clase de punto de los puntos devueltos.1

EngUnits

Cadena

Unidades de ingeniería de los puntos devueltos. 1

OutCode

Integer

Código de salida que d de etermina la forma en que lla a función orienta la salida: •  0 Escribir valores en una columna. •  2 Escribir valores en una fila.

PIServer

Cadena

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

1 Utilice

el carácter comodín (*) para encontrar todas las coincidencias o las coincidencias limitadas a determinados caracteres.

Ejemplo =PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")

La siguiente función devuelve los tags que empiezan por sin del PI Server denominado

thevax.

150

Manual del usuario de PI DataLink 2014

 

Referencia de función

Consulte también Función Máscara de atributo para tag

Funciones de Module Database En esta sección • PIAliasToTag() • PIPropertyToValue()

PIAliasToTag() Devuelve el nombre del PI point correspondiente a un determinado alias de PI.

Sintaxis PIAliasToTag(Alias, ModulePath, QueryDate, OutCode, PIServer)

Argumentos Argumento

Tipo

Descripción

Alias

Cadena

El alias de de lla ab ba ase d de ed da atos d de e mó módulo cco orrespondiente a all P PII point para devolver.

ModulePath

Cadena

Ruta de módulo completa del alias.

QueryDate

Integer

Fecha efectiva del alias. La función devuelve el nombre del punto correspondiente al alias especificado en esa fecha.

OutCode

Integer

Código de de ssa alida q qu ue d de etermina ssii sse ea añ ñadirá e ell n no ombre d de el servidor al resultado: • 0 Devuelve solo el nombre del punto. • 1 Devuelve el PI Server que almacena el punto en la celda a la derecha del nombre del punto. • 2 Devuelve el PI Server que almacena el punto en la celda debajo del nombre del punto. punto.

PIServer

Cadena

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

Ejemplo =PIAliasToTag("Temperat =PIAliasToT ag("Temperature","\Unit1 ure","\Unit1\Reactor1"," \Reactor1","*",0,"thevax *",0,"thevax") ")

La siguiente función devuelve el PI point correspondiente al alias Temperature del módulo Reactor1, que es un submódulo de Unit1. Unit1 está en la raíz de la base de datos de módulo de un PI Server denominado thevax. La base de datos de módulo se consulta a la hora actual.

Consulte también Función Alias para tag

Manual del usuario de PI DataLink 2014 

151

 

Referencia de función

PIPropertyToValue() Devuelve el valor o valores correspondientes a una propiedad de PI especificada.

Sintaxis PIPropertyToValue(Prope PIPropertyT oValue(Property, rty, ModulePath, QueryDate, PIServer, OutCode)

Argumentos Argumento

Tipo

Descripción

Propiedad

Cadena

La p prropiedad d de eb ba ase d de ed da atos d de e mó módulo cco orrespondiente a all PI point para el que la función recupera valores.

ModulePath

Cadena

Ruta de módulo completa de la propiedad.

QueryDate

Integer

Fecha e effectiva d de el valor d de e lla ap prropiedad d de e PI PI. la la ffu unción devuelve los valores correspondientes a la propiedad especificada en esa fecha.

PIServer

Cadena

El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o deja este campo en blanco, la función buscará el PI Server predeterminado.

OutCode

Integer

Código de salida que determina la forma en que se orientará el resultado: •  0 Devuelve valores en una columna. •  2 Devuelve valores en una fila.

Ejemplo =PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax")

Devuelve el valor correspondiente a la propiedad Implementer del módulo Reactor1, que es un submódulo de Unit1. Unit1 está en la raíz de la base de datos de módulo de un PI Server denominado thevax. La base de datos de módulo se consulta a la hora actual.

Consulte también Función Propiedad para valor

Funciones de entrada PIPutVal() y PIPutValX() Escribe un valor en PI Server o el servidor de PI AF y devuelve una cadena que indica el estado.

Sintaxis PIPutVal(DataItem, PIPutVal(Da taItem, Value, TimeStamp, RootPath, OutCell) PIPutValX(DataItem, Value, TimeStamp, RootPath, OutCell)

Argumentos Argumento DataItem

Tipo

Cadena

Descripción

El nombre del PI point o el atributo de PI AF para que la

función escribe un valor.

152

Manual del usuario de PI DataLink 2014

 

Referencia de función Argumento

Tipo

Descripción

Valor

Re Refferencia

Refere ren ncia a la ccel eld da q qu ue ccon onttiene e ell valo alor q qu ue sse ev va aa escribir, ya sea una cadena o un número.

TimeStamp

Cadena

La marca de tiempo del valor. Consulte Campos de entrada de tiempo. tiempo.

RootPath

Cadena

datos.. La ruta del elemento de datos. Consulte Elementos de datos

OutCell

Refe Refere renc ncia ia

Refe Refere renc ncia ia a la cel celda en la que que PI Data DataLi Link nk escr escrib ibe e la cad caden ena a que la función macro devuelve. La cadena devuelta varía: • Si lla a escrit escritura ura es corre correcta: cta: ◦

◦

La función PIPutVal devuelve  xxx  Written  Written , donde  xxx es Real Value, Integer, Digital State o Value, en función del tipo de valor escrito. La función PIPutValX devuelve Value Written.

• Si la escri escritura tura fal falla, la, la fu función nción dev devuelve uelve un ccódigo ódigo de de error, como [-5] Tag not found por ejemplo.

Notas Las funciones PIPutVal y PIPutValX no pueden escribir en atributos de PI AF que sean atributos de configuración. Estas funciones sólo pueden escribir en un atributo PI AF para el que no esté seleccionada la casilla Elemento de configuración. Puede comprobar el estado de la casilla en la pestaña Atributos de PI System Explorer. Las funciones PIPutVal y PIPutValX admiten todos los tipos de datos de PI Server. Las funciones interpretan las marcas de tiempo utilizando la información de la zona horaria del ordenador cliente de PI Server a menos que se haya activado la opción Utilizar zona horaria de PI Server. Las funciones no verifican el intervalo especificado por el usuario para un punto antes de escribir el valor. El intervalo se define desde zero desde zero a  a zero  zero + span, span, donde zero donde zero y span span son  son atributos de punto especificados durante la creación del punto. La función devuelve una cadena Value Written aunque Over Range o Under Range estén almacenados en PI Server.

Ejemplo =PIPutVal("testtag",a5,"t",,e5)

Escribe el valor localizado en la celda A5 del archivo de PI Server en el PI Server predeterminado testtag con la marca de tiempo de la medianoche de hoy. La función escribe el resultado de la función de macros en la celda E5 de la hoja de cálculo.

Manual del usuario de PI DataLink 2014 

 

Referencia de función

153

154

Manual del usuario de PI DataLink 2014

 

Resolución de problemas Consulte los temas incluidos en esta sección si tiene alguna dificultad con el uso de PIDataLink. Si estos temas no explican o resuelven el problema, consulte Soporte técnico y otros recursos para obtener más detalles sobre cómo ponerse en contacto con el Servicio de asistencia técnica.

En esta sección • Archivos de registro • La pestaña PI DataLink no está disponible • Límites de matriz y de celda • Límites de recuperación de datos • Elemento de datos no admitido por función • Existe un event o duplicado • Seguridad • Problemas de conexión de PI Server • Eliminar error de excepción de tiempo de espera • Los datos no se actualizan

Archivos de registro PI DataLink no genera un archivo de registro genérico. Puede utilizar los mensajes de error de las hojas de cálculo para diagnosticar problemas. Sin embargo, algunos procesos específicos no generan archivos de registro: • Inst Instal alac ació ión n El directorio ../pipc/dat contiene los archivos de registro de instalación SetupPIDataLink_x64.log y SetupPIDataLink_x86.log. • Conect Conectivid ividad ad d de e PI Server Server Examine el archivo de registro de PI Server en PI SMT para detectar problemas de conectividad de PI Server.

La pestaña PI DataLink no está disponible Si la pestaña PI DataLink no aparece después de instalar PI DataLink, es posible que necesite configurar de forma manual manual el complemento complemento para Excel (consulte Configuración del complemento para Microsoft Microsoft Excel) Excel) o reducir los parámetros los parámetros de seguridad para los complementos (consulte Seguridad). Seguridad). Algunas secuencias VBA escritas por el usuario en las hojas de cálculo (o complementos) de Excel restablecen la cinta cinta principal de Excel. En estos ccasos, asos, la pestaña PI DataLink puede desaparecer aunque el el complemento de PI DataLi DataLink nk esté todavía cargado y las funciones de PI DataLink integradas pueden funcionar aunque la pestaña PI DataLink no esté disponible. Reiniciar Excel suele corregir este problema.

Manual del usuario de PI DataLink 2014 

155

 

Resolución de problemas

Límites de matriz y de celda PI DataLink está sujeto a una limitación de Excel en el número de elementos de la matriz de cálculos. Una única función de PI DataLink puede devolver como máximo 1.048.576 valores por recuperación. El SDK de Excel utilizado por PI DataLink limita las cadenas a 255 caracteres de longitud. Las cadenas de entrada para expresiones de PI DataLink en una celda referenciada no pueden exceder este límite de 255 caracteres. Del mismo modo, PI DataLink puede truncar la salida de cadena, como los nombres de los PI points, a 255 caracteres.

Límites de recuperación de datos El código de error -11091 indica que una consulta única iniciada por una función de PI DataLink ha intentado recuperar más valores registrados de PI Server de los que permite el parámetro de ajuste ArcMaxCollect ArcMaxCollect.. Dado que este límite se aplica a los valores registrados recuperados del archivo de PI Server, incluso las funciones que devuelven un número menor de valores pueden superar el límite establecido por este parámetro de ajuste. Por ejemplo, valor del PI point  varía sinusoid constantemente entre 0 y 100. Puede crear una funciónelque devuelva valores de muestra de sinusoid cada 30 segundos a lo largo de un año con un filtro para excluir los valores inferiores a 95. Esta función podría devolver un número relativamente pequeño de valores, pero recuperará muchos más valores registrados de los archivos para procesar la consulta. Si recibe este error, plantéese modificar los criterios de búsqueda para reducir los datos recuperados. Por ejemplo, podría reducir el periodo de tiempo a lo largo del cual la función recuperará datos.

Elemento de datos no admitido por función El mensaje Data item not supported by function puede indicar lo siguiente: • Un atributo atributo de PI AF utiliza una refer referencia encia de datos pe personal rsonalizada izada que no permite permite los cálculos. Para utilizarlo en PI DataLink, modifique el código de referencia de datos personalizado para que permita el uso de métodos de acceso a datos. Esta desactivado de forma predeterminada. • La función Datos Datos calculados calculados ha intentado intentado realizar realizar un cálculo cálculo de resumen en un atribut atributo o de PI AF de tipo PI Point Array.

Existe un evento duplicado El mensaje devuelto Duplicate event exists: specify index for EventName indica que el evento principal de esta fila de la hoja de cálculo contiene más de un evento secundario con el nombre EventName. Para resolverlo, cambie la especificación de la función Comparar eventos para utilizar una versión indexada del evento para el atributo visualizado en esta columna. Cuando un evento principal tiene eventos secundarios con nombres duplicados, PI DataLink  añade automáticamente un índice al nombre del evento secundario en la ventana Añadir atributos. Si otros eventos del mismo nivel no tienen nombres duplicados, no tendrán el índice.

156

Manual del usuario de PI DataLink 2014

 

Resolución de problemas Para obtener más información, consulte Añadir atributos de eventos secundarios como columnas en el panel de tareas Comparar eventos. eventos .

Seguridad Las funciones de seguridad decomponentes Excel para losque complementos, los controles de Los ActiveX y las macros controlan los tipos de se pueden ejecutar en Excel. parámetros de seguridad proporcionan los medios para desactivar, activar bajo demanda o activar completamente estos tipos de objetos. Los parámetros de seguridad de Excel pueden entrar en conflicto con algunas funciones de PI DataLink: • PI DataLink DataLink es un complemento complemento para Exce Excel. l. La configuración configuración de seguridad seguridad que desactiva desactiva los complementos impide que PI DataLink se cargue en Excel • Las tendencias tendencias utilizan utilizan un control control ActiveX ActiveX firmado firmado marcado co como mo seguro pa para ra su inicialización y requieren que se activen los controles ActiveX. • Las hojas hojas de cálculo cálculo que co contiene ntienen n una función función PIPutVal() o PIPutValX () utilizan macros y requieren que estén activadas (consulte PIPutVal() y PIPutValX()). PIPutValX()). Si aplica con regularidad la seguridad de Excel a las hojas de cálculo, o encuentra problemas utilizando estas funciones de PI DataLink, deberáutilizar reducirPI o eliminar seguridad de Excel dependiendo de cómo prevea DataLink.la configuración de Para más información sobre la seguridad de Excel, consulte los recursos y la ayuda en línea de Microsoft Excel.

Problemas de conexión conexión de PI Server Esta versión de Problemas de conexión utiliza parámetros de seguridad más estrictos para conectarse a PI Server. Esta nueva configuración reduce la exposición a problemas de seguridad asociados con la autenticación de contraseñas en PI. Consulte el boletín de asistencia técnica, Security Alert: PI Authentication Weakness (https://techsupport.osisoft.com/ Troubleshooting/Alerts/AL00206),, para obtener más información. Troubleshooting/Alerts/AL00206) Los nuevos parámetros de seguridad pueden producir errores si PI DataLink utiliza: • Nombres de de usuari usuario o y contraseñas contraseñas de PI para con conectars ectarse e a PI Server • El usuario usuario predetermi predeterminado nado para conectarse conectarse a PI Server Server De manera específica, estos parámetros podrían generar el error -10407 "No Access Secure Object" con información sobre privilegios insuficientes para acceder a PI Server. La configuración también podría generar un mensaje sobre una solicitud de de inicio de sesión explícita desactivada. Para resolver estos errores, puede: • Configurar Configurar PI mappings mappings para usuarios usuarios qu que e se conecten conecten a PI Server. OSIsoft recomienda este enfoque (disponible en la versión 3.4.380 de PI Server y posteriores). Este es el método de conexión más seguro. Consulte el manual Configuring PI  Server Security  para  para obtener información sobre la creación de PI mappings. Para utilizar PI mappings, deberá activar también el protocolo de autenticación de Windows Security en cada ordenador en el que se ejecute PI DataLink. • Configurar Configurar PI trusts trusts para usuarios usuarios qu que e se conecten conecten a PI Server.

Manual del usuario de PI DataLink 2014 

157

 

Resolución de problemas Este es el segundo mejor enfoque. Consulte el manual Configuring PI Server Security  para  para obtener información sobre la creación de PI trusts. Para utilizar PI trusts, deberá activar también el protocolo de autenticación de PI Trust en cada ordenador en el que se ejecute PI DataLink. • Configurar Configurar cada ordenador ordenador para permitir permitir una solicit solicitud ud de inicio de sesió sesión n explícita explícita cuando no estén disponibles una PI mapping o un PI trust. OSIsoft no recomienda este enfoque. Los inicios de sesión explícitos no son seguros.

Nota: La introducción de una contraseña incorrecta en una solicitud de inicio de sesión puede generar el mismo mensaje de error.

En esta sección • Configurar un ordenador para permitir solicitudes de inicio de sesión explícitas • Activar un protocolo de autenticación

Configurar un ordenador para permitir solicitudes de inicio de sesión explícitas Para conectarse a PI Server a través de un inicio de sesión como usuario de PI, utilice PI SDK Utility para permitir solicitudes de inicio de sesión explícitas en su ordenador. Deberá configurar cada ordenador desde el que se conecte a PI Server iniciando sesión como usuario de PI.

PRECAUCIÓN: OSIsoft recomienda utilizar un método alternativo más seguro para conectarse a PI Server.

Procedimiento 1. Ha Haga ga clic clic en Inicio > Todos los programas > PI System > PISDKUtility para abrir PI SDK Utility. 2. En PI-SDK, haga clic en Conexiones para mostrar los PI Servers disponibles y actualizar los menús de utilidades. 3. Ha Haga ga clic clic en Conexiones > Opciones para abrir la ventana Opciones de conexión. 4. Selecci Seleccione one la casi casilla lla Solicitar inicio de sesión (si fallan protocolos configurados). 5. Ha Haga ga clic clic en Aceptar.

Resultados Se le solicitará el nombre de usuario y la contraseña cada vez que inicie una conexión nueva a PI Server.

Activar un protocolo de autenticación Para conectarse a PI Server con una PI mapping o un PI trust, utilice PI SDK Utility para activar el protocolo correspondiente en su ordenador. Deberá configurar cada ordenador desde el que se conecte a PI Server con una PI mapping o un PI trust.

158

Manual del usuario de PI DataLink 2014

 

Resolución de problemas

Procedimiento 1. Ha Haga ga clic clic en Inicio > Todos los programas > PI System > PISDKUtility para abrir PI SDK Utility. 2. En PI-SDK, haga clic en Conexiones para mostrar los PI Servers disponibles y actualizar los menús de utilidades. 3. Ha Haga ga clic clic en Conexiones > Opciones para abrir la ventana Opciones de conexión. 4. En Especificar procedimiento de autenticación, utilice las teclas de fecha para mover y ordenar los protocolos activados en Orden de protocolos. Liste los protocolos necesarios: ◦

◦

Para utilizar PI mappings, Windows Security debe estar en la lista. Debe ser el primer protocolo en la lista Orden de protocolos. Para utilizar PI trusts, PI Trust debe estar en la lista.

5. Ha Haga ga clic clic en Aceptar.

Eliminar error de excepción de tiempo de espera Las búsquedas de PI Servers con bases de datos de puntos grandes podría alcanzar el tiempo de espera para datos antes de que PI Server haya devuelto todos los resultados. En este caso, recibirá el siguiente error:

OSIsoft.PI.Net.PITimeoutException: [-10722] PINET: Timeout on PI RPC or OSIsoft.PI.Net.PITimeoutException: System Call. Para eliminar el error, utilice Gestor de conexiones para aumentar el valor del tiempo de espera para los datos.

Procedimiento 1. En la pe pest stañ aña a PI DataLink, en el grupo Recursos, haga clic en Configuración para abrir el cuadro de diálogo Configuración. 2. Ha Haga ga clic clic en Gestor de conexiones para abrir el cuadro de diálogo Servidores. 3. Haga clic con el botón botón derecho derecho en el PI Serv Server er que ha devuelto devuelto el error error y, a continua continuación, ción, haga clic en Propiedades para abrir el cuadro de diálogo Propiedades de PI Server. 4. Increme Incremente nte el el valor valor del ccamp ampo o Tiempo de espera de datos y, a continuación, haga clic en Aceptar.

Los datos no se actualizan PI DataLink almacena en caché los datos de configuración de los PI points y los datos no basados en el tiempo de PI AF (es decir, los datos que no son eventos y referencias de datos de PI point). Como resultado, los datos insertados en hojas de cálculo podrían no actualizarse para mostrar los valores modificados, aunque recalcule la función. Para ver los valores actualizados, cierre Microsoft Excel y vuelva a abrirlo.

Manual del usuario de PI DataLink 2014 

 

Resolución de problemas

159

160

Manual del usuario de PI DataLink 2014

 

Soporte técnico y otros recursos Para obtener asistencia técnica, póngase en contacto con el soporte técnico de OSIsoft  llamando al +1 510-297-5828 o visitando el sitio web de asistencia técnica de OSIsoft (https:// techsupport.osisoft.com). techsupport.osisoft.com) . ElUnidos. sitio web ofrece opciones de contacto adicionales para los clientes que están fuera de Estados Cuando se ponga en contacto con el soporte técnico de OSIsoft, tenga a mano la siguiente información: • Nombre del producto, producto, versión versión y núme números ros de versión • Detalles Detalles sobre la plataform plataforma a del equipo (tip (tipo o de CPU, sistema sistema operativo operativo y número de versión) • Hora a la qu que e se in inici ició ó el pr probl oblema ema • Archivos Archivos de registro registro en ese instant instante e concreto concreto • Detalles Detalles sobre cualquier cualquier cambio cambio en el entorno antes de que se produjera produjera el problema problema • Resumen Resumen del problema, incluidos incluidos los archi archivos vos de registro perti pertinentes nentes durante durante el interva intervalo lo de tiempo en que se produjo el problema El sitio web de OSIsoft Virtual Campus (vCampus) (http://vcampus.osisoft.com) ofrece (http://vcampus.osisoft.com) ofrece recursos basados en suscripción para ayudarle en todo lo relativo a la programación e integración de productos de OSIsoft.

Manual del usuario de PI DataLink 2014 

 

Soporte técnico y otros recursos

161