You are on page 1of 170

PI DataLink 2016

Gua 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 2016


1992-2016 by OSIsoft, LLC. Todos los derechos reservados.
Ninguna parte de esta publicacin puede ser reproducida, almacenada en un sistema de recuperacin o
transmitida, de ninguna forma ni por ningn medio, mecnico, fotocopiado, grabado o de cualquier otro
modo, sin el consentimiento previo por escrito de OSIsoft, LLC.
OSIsoft, el logotipo de OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services, OSIsoft
Connected Services, PI ACE, PI Advanced Computing Engine, PI AF SDK, PI API, PI Asset Framework, PI
Audit Viewer, PI Builder, PI Cloud Connect, PI Connectors, PI Coresight, PI Data Archive, PI DataLink, PI
DataLink Server, PI Developers Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC driver, PI
Manual Logger, PI Notifications, PI ODBC, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI
ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI Visualization Suite, PI Web API,
PI Web Services y RLINK son marcas comerciales de OSIsoft, LLC. Todas las dems marcas y nombres
comerciales utilizados en el presente documento pertenecen a sus respectivos propietarios.
DERECHOS DEL GOBIERNO DE LOS EE. UU.
Su uso, rplica o difusin por parte del Gobierno de EE. UU. est sujeto a las restricciones estipuladas en el
contrato de licencia de OSIsoft, LLC, de acuerdo con lo que establecen las regulaciones DFARS 227.7202,
DFARS 252.227-7013, FAR 12.212, FAR 52.227, segn proceda. OSIsoft, LLC.
Versin: 5,3
Publicacin: 20 de abril de 2016
Contenido

Introduccin......................................................................................................... 1
Descripcin general de PI DataLink........................................................................................................... 1
PI DataLink Server (DLS).......................................................................................................................2
Acerca de esta versin.............................................................................................................................. 2
Requisitos del sistema para PI DataLink................................................................................................ 2
Actualizacin de compatibilidad........................................................................................................... 2
Tipos de datos admitidos...................................................................................................................... 3
Instalacin de PI DataLink.........................................................................................................................4
Instalar PI DataLink............................................................................................................................... 4
Instalacin silenciosa.............................................................................................................................5
Ver PI DataLink en un idioma compatible.............................................................................................. 5
Preferencias de conexin a colectivos de PI Data Archive...................................................................... 6
Configuracin de PI Data Archive.......................................................................................................... 6
Configuracin del complemento para Microsoft Excel.............................................................................. 6
Ver el estado de los complementos....................................................................................................... 7
Activar un complemento desactivado................................................................................................... 8
Activar un complemento desactivado................................................................................................... 8
Recomendaciones de seguridad................................................................................................................8
Seguridad de los archivos Excel.............................................................................................................9
Seguridad del complemento para Excel...............................................................................................10
Privilegios de las cuentas..................................................................................................................... 10
Prcticas de seguridad organizativa.....................................................................................................10
Estrategias de registro......................................................................................................................... 11
Acerca de este documento...................................................................................................................... 12

Conceptos bsicos............................................................................................... 13
Interfaz de usuario...................................................................................................................................13
Pestaa PI DataLink............................................................................................................................ 13
Paneles de tareas de funciones............................................................................................................14
Men del botn derecho......................................................................................................................15
Descripcin general de las funciones de PI DataLink................................................................................15
Elementos de datos.............................................................................................................................16
Campo de entrada............................................................................................................................... 17
Campos de entrada de tiempo.............................................................................................................18
Datos aadidos................................................................................................................................... 19
Formatos de presentacin................................................................................................................... 19
Valores interpolados........................................................................................................................... 20
Bsquedas.............................................................................................................................................. 20
Buscar elementos de datos..................................................................................................................21
Buscar activos mediante filtros............................................................................................................25
Administrar configuraciones de PI DataLink............................................................................................ 27
Lmites de configuracin de zona horaria............................................................................................ 30
Gestionar conexiones con servidores.......................................................................................................30

Creacin de hojas de clculo................................................................................. 33


Proceso de creacin de hojas de clculo.................................................................................................. 33
Recuperacin de grandes cantidades de datos........................................................................................ 34
Despliegues relacionados con activos......................................................................................................34
Crear un despliegue relacionado con activos........................................................................................35
Eventos en hojas de clculo..................................................................................................................... 37
Explorar los eventos relacionados con un elemento.............................................................................39
Explorar eventos con eventos secundarios.......................................................................................... 42

Manual del usuario de PI DataLink 2016 iii


Contenido

Comparacin de eventos mediante la inclusin de eventos secundarios..............................................44


Comparacin de eventos mediante la inclusin de eventos principales................................................50
Nombres de atributo reservados......................................................................................................... 52

Funciones de PI DataLink..................................................................................... 53
Funcin Valor actual................................................................................................................................ 53
Ejemplo de Valor actual.......................................................................................................................54
Funcin Valor de archivo histrico...........................................................................................................55
Ejemplo de Valor de archivo................................................................................................................ 57
Funcin Datos comprimidos.................................................................................................................... 57
Ejemplo de Datos comprimidos.......................................................................................................... 60
Funcin Datos de muestra...................................................................................................................... 60
Ejemplo de Datos de muestra............................................................................................................. 62
Funcin Datos temporizados...................................................................................................................63
Ejemplo de Datos temporizados......................................................................................................... 64
Funcin Datos calculados........................................................................................................................65
Ejemplo de Datos calculados...............................................................................................................69
Funcin Filtrado de tiempo......................................................................................................................70
Ejemplo de Filtrado de tiempo............................................................................................................. 71
Funcin Explorar eventos........................................................................................................................ 72
Referencia del panel de tareas Explorar eventos.................................................................................. 73
Ejemplo de Explorar eventos............................................................................................................... 77
Funcin Comparar eventos...................................................................................................................... 77
Referencia del panel de tareas Comparar eventos............................................................................... 78
Notacin de ruta para la funcin Comparar eventos............................................................................ 82
Ejemplo de comparacin de eventos................................................................................................... 82
Funcin de bsqueda de filtro de activo.................................................................................................. 83
Funcin Propiedades.............................................................................................................................. 84
Ejemplo de propiedades...................................................................................................................... 85

Uso y mantenimiento de las hojas de clculo......................................................... 87


Matrices de funcin................................................................................................................................. 87
Tareas comunes relacionadas con las matrices de funcin................................................................... 87
Actualizar entradas en una matriz de funcin...................................................................................... 88
Tamao de la matriz........................................................................................................................... 89
Redimensionar matrices......................................................................................................................89
Frecuencia de clculo.............................................................................................................................. 90
Funcin Actualizacin automtica.......................................................................................................90
Reclculo provocado........................................................................................................................... 91
Recalcular manualmente.....................................................................................................................92
Compartir hojas de clculo......................................................................................................................92
Definir la opcin Clculo de libro de trabajo como manual...................................................................93

Temas avanzados................................................................................................ 95
Tiempo PI............................................................................................................................................... 95
Abreviaturas de tiempo PI................................................................................................................... 95
Expresiones de tiempo PI.................................................................................................................... 96
Especificacin de intervalos de tiempo................................................................................................96
Especificacin de intervalos de tiempo................................................................................................ 97
Expresiones............................................................................................................................................ 98
Uso de expresiones en funciones de PI DataLink................................................................................. 99
Sintaxis de las expresiones.................................................................................................................. 99
Restricciones relativas a los elementos de datos en expresiones......................................................... 99
Ejemplos de expresiones................................................................................................................... 100
Expresiones de filtro.......................................................................................................................... 100
Entrada manual de funciones................................................................................................................ 100
Definir funciones manualmente.........................................................................................................101

iv Manual del usuario de PI DataLink 2016


Contenido

Pautas para introducir argumentos de forma manual........................................................................ 101


Cdigos de salida...............................................................................................................................102
Funciones para escribir datos.................................................................................................................103

Funciones de tags.............................................................................................. 105


Funcin Identificador del punto al tag....................................................................................................105
Ejemplo de Apuntar ID al Tag............................................................................................................ 106
Funcin Mscara de atributo para tag................................................................................................... 106
Ejemplo de Mscara de atributo para tag........................................................................................... 107
Bsqueda de PI points........................................................................................................................... 107

Tendencias....................................................................................................... 109
Crear una tendencia.............................................................................................................................. 109
Crear un trazo de valores en la hoja de clculo................................................................................... 111
Crear un trace de valores de PI point obtenidos de Archivo de datos de PI..........................................111
Men contextual de tendencias............................................................................................................. 112

Objetos de PI Module Database.......................................................................... 113


PI Module Database y hojas de clculo...................................................................................................113
Insertar objetos de PI Module Database en la hoja de clculo.................................................................113
Funciones de bases de datos de mdulos...............................................................................................114
Funcin Alias para tag........................................................................................................................115
Funcin Propiedad para valor.............................................................................................................115

Notificaciones................................................................................................... 117
Bsqueda e insercin de notificaciones.................................................................................................. 117
Aadir un servidor de PI AF a la funcin Bsqueda de notificacin..................................................... 118
Ajustar la visualizacin de las notificaciones recuperadas.................................................................. 119
Gestionar las notificaciones recuperadas........................................................................................... 120
Notificaciones insertadas...................................................................................................................... 120
Configuracin de visualizacin de notificaciones................................................................................... 120

Referencia de funcin.........................................................................................123
Funciones de valor nico....................................................................................................................... 123
PICurrVal()......................................................................................................................................... 123
PIArcVal().......................................................................................................................................... 124
PIExpVal()..........................................................................................................................................125
PITagAtt()......................................................................................................................................... 126
Funciones de valor mltiple...................................................................................................................126
PINCompDat()................................................................................................................................... 127
PINCompFilDat()............................................................................................................................... 128
PICompDat()..................................................................................................................................... 129
PICompFilDat().................................................................................................................................. 130
PISampDat()...................................................................................................................................... 131
PISampFilDat().................................................................................................................................. 132
PIExpDat()......................................................................................................................................... 133
PITimeDat()....................................................................................................................................... 134
PITimeExpDat()................................................................................................................................. 135
Funciones de clculo..............................................................................................................................136
PIAdvCalcVal()................................................................................................................................... 137
PIAdvCalcFilVal()............................................................................................................................... 138
PIAdvCalcExpVal()............................................................................................................................. 139
PIAdvCalcExpFilVal()......................................................................................................................... 141
PIAdvCalcDat().................................................................................................................................. 143
PIAdvCalcFilDat().............................................................................................................................. 144
PIAdvCalcExpDat()............................................................................................................................ 146

Manual del usuario de PI DataLink 2016 v


Contenido

PIAdvCalcExpFilDat()........................................................................................................................ 148
PITimeFilter().................................................................................................................................... 149
PITimeFilterVal()............................................................................................................................... 150
Funciones de tags.................................................................................................................................. 151
PIPointIDToTag()............................................................................................................................... 151
PIAttributeMaskToTag ()................................................................................................................... 152
Funciones de Module Database............................................................................................................. 153
PIAliasToTag()................................................................................................................................... 153
PIPropertyToValue()..........................................................................................................................154
Funciones de entrada............................................................................................................................ 154
PIPutVal() y PIPutValX()..................................................................................................................... 155
Funciones obsoletas.............................................................................................................................. 156

Resolucin de problemas....................................................................................157
Archivos de registro............................................................................................................................... 157
La pestaa PI DataLink no est disponible............................................................................................. 157
Lmites de matriz y de celda.................................................................................................................. 158
Lmites de recuperacin de datos.......................................................................................................... 158
Elemento de datos no admitido por funcin.......................................................................................... 158
Existe un evento duplicado.................................................................................................................... 158
Seguridad..............................................................................................................................................159
Problemas de conexin de PI Data Archive............................................................................................159
Activar un protocolo de autenticacin............................................................................................... 160
Configurar un ordenador para permitir solicitudes de inicio de sesin explcitas................................ 160
Ingrese las credenciales de inicio de sesin del Administrador de conexiones.................................... 161
Eliminar error de excepcin de tiempo de espera...................................................................................161
Los datos no se actualizan..................................................................................................................... 162

Soporte tcnico y otros recursos......................................................................... 163

vi Manual del usuario de PI DataLink 2016


Introduccin
Bienvenido a PI DataLink. En esta seccin se proporciona una descripcin general de PI
DataLink, se describen las caractersticas de esta versin y se explica el procedimiento de
instalacin y configuracin.

En esta seccin
Descripcin general de PI DataLink
Acerca de esta versin
Instalacin de PI DataLink
Configuracin del complemento para Microsoft Excel
Recomendaciones de seguridad
Acerca de este documento

Descripcin general de PI DataLink


PI DataLink es un complemento para Microsoft Excel que permite recuperar informacin de su
PI Server directamente en una hoja de clculo. Combinado con las capacidades grficas, de
clculo y de formato de Microsoft Excel, PI DataLink ofrece potentes herramientas para
obtener, controlar, analizar y realizar informes sobre datos de PI System.
Con PI DataLink, puede:
Recuperar valores de un PI point de un servidor de Archivo de datos de PI
Recuperar valores de los atributos de un servidor de PI Asset Framework (PI AF)
Recuperar metadatos de sistema para crear una visualizacin estructurada de datos 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 a estos elementos utilizando funciones de PI DataLink para calcular y
filtrar datos
Mantener los valores actualizados cuando la hoja de clculo se recalcule
Recuperar las notificaciones a las que se haya suscrito con PI Notifications
PI DataLink proporciona una interfaz grfica para recuperar datos y crear funciones y clculos.
Las funciones de DataLink se integran en celdas de hoja de clculo y pueden proporcionar
actualizaciones activas de datos en tiempo real de PI System.
Tambin puede utilizar las mltiples capacidades de clculo y formato de Excel para organizar
y presentar datos de PI System para adecuarlos a su propsito o a su audiencia
Existen dos formas de trabajar con las funciones de PI DataLink en hojas de clculo de Excel:
Instalar una versin independiente de PI DataLink en un PC local.
Utilizar un navegador web para ver la hoja de clculo con PI DataLink Server (DLS), un
producto aparte que permite ver las hojas de clculo creadas con PI DataLink.
Pngase en contacto con el representante de ventas de OSIsoft para obtener ms informacin.

Manual del usuario de PI DataLink 2016 1


Introduccin

PI DataLink Server (DLS)


PI DataLink Server es una versin 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 configuracin
tpica de PI client.
PI DataLink Server permite utilizar un navegador web para recuperar y ver datos de Archivo
de datos de PI incluidos en una hoja de clculo de Microsoft Excel. Podr ampliar el acceso a
datos de PI System en tiempo real a muchos clientes distintos, independientemente de su
ubicacin o de sus conocimientos sobre Microsoft Excel o las funciones de PI DataLink.
Esta versin de servidor de PI DataLink utiliza tecnologas de Microsoft SharePoint, como
Servicios de Excel y el elemento web de Excel Web Access. Juntos, estos componentes de
Microsoft admiten la mayor parte de las funciones estndar de hojas de clculo. PI DataLink
Server ampla estos servicios dado que aade 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 o aadirlos a pginas de elementos web. El elemento web de Excel
Web Access admite conexiones que permiten intercambiar parmetros entre un libro de
trabajo y otros elementos web, integrando las funciones de PI DataLink con el entorno de PI
WebParts.
Pngase en contacto con el representante de ventas de OSIsoft para obtener ms informacin
sobre PI DataLink Server.

Acerca de esta versin


Esta versin 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 seccin describen los requisitos del sistema, la actualizacin de la compatibilidad con
versiones anteriores y los tipos de datos admitidos.

En esta seccin
Requisitos del sistema para PI DataLink
Actualizacin de compatibilidad
Tipos de datos admitidos

Requisitos del sistema para PI DataLink


Para conocer los requisitos del sistema actualizados, consulte la pgina de soporte tcnico de
OSIsoft Requisitos del sistema para PI DataLink (https://techsupport.osisoft.com/Products/PI-
Visualization/PI-DataLink/System-Requirements).

Actualizacin de compatibilidad
PI DataLink es compatible con las versiones anteriores. Con esta versin de PI DataLink, se
pueden leer libros creados con versiones anteriores sin necesidad de realizar ninguna
conversin. Sin embargo, lo contrario no es necesariamente cierto. Despus de modificar una
hoja de clculo en la versin actual, es posible que no funcione con versiones anteriores de PI
DataLink.

2 Manual del usuario de PI DataLink 2016


Introduccin

Esta versin de PI DataLink 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 que difieran los mensajes de error devueltos. Puede que necesite cambiar las
hojas de clculo que buscan determinadas cadenas (por ejemplo, en cdigo VBA o macros de
Excel).
PI DataLink no crea conexiones con PI SDK o PI API. Es posible que necesite modificar el
cdigo VBA en los libros que dependen de una conexin a PI SDK o PI API existente para
crear una nueva conexin explcita a PI SDK o PI API.
Algunos formatos de hora, como por ejemplo 10:, han dejado de ser compatibles. Tendr
que cambiar las entradas de tiempo que utilicen formatos no compatibles.
Las conexiones de usuario predeterminadas a Archivo de datos de PI han dejado de ser
compatibles. Si se le solicita, puede introducir un nombre de usuario y una contrasea. Sin
embargo, OSIsoft recomienda configurar PI mappings para conectarse a Archivo de datos de
PI.
La versin de 64 bits de PI DataLink no permite crear objetos de tendencia ActiveX. La versin
de 64 bits slo mostrar una imagen de la ltima tendencia en una hoja de clculo existente y
no actualizar esas tendencias.

Tipos de datos admitidos


PI DataLink admite los siguientes tipos de datos de PI point:
Digital: Digital (estados definidos)
Entero: Int (16 y 32)
Flotante: Float (16, 32 y 64)
Cadena: String (texto)
Marca de tiempo: Timestamp
PI DataLink no admite el tipo blob.
PI DataLink admite los siguientes tipos de valores de atributo de PI AF:
Byte: Byte
Entero: Int (16, 32 y 64)
Single
Double
Cadena: String*
Fecha y hora: DateTime*
Booleano: Boolean*
Enumeracin: Enumeration*
*No admitido por la funcin 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 2016 3


Introduccin

Instalacin de PI DataLink
Antes de utilizar PI DataLink, debe instalar PI DataLink desde un CD de distribucin o
descargar un kit de instalacin de OSIsoft. Si lo desea, puede utilizar una instalacin silenciosa.
Tambin puede instalar el paquete de idiomas para habilitar la compatibilidad con idiomas
distintos al ingls. Adems, tendr que considerar la configuracin de Archivo de datos de PI y
asegurarse de que tiene acceso correcto a los PI points.

En esta seccin
Instalar PI DataLink
Instalacin silenciosa
Ver PI DataLink en un idioma compatible
Preferencias de conexin a colectivos de PI Data Archive
Configuracin de PI Data Archive

Instalar PI DataLink
Inicie el programa de configuracin para instalar PI DataLink. En sistemas operativos de 64
bits, el programa de configuracin instala automticamente la versin de 32 bits y de 64 bits de
PI DataLink. Puede modificar el archivo setup.ini si desea instalar una nica versin. Si tiene
instalada una versin anterior de PI DataLink en el ordenador, el programa de configuracin
actualizar automticamente la instalacin y mantendr los ajustes de preferencia de versiones
anteriores. El programa de instalacin no instala el complemento PI DataLink (Legacy), incluso
aunque realice la actualizacin desde una instalacin previa en la que el complemento
estuviese habilitado, a menos que modifique el archivo setup.ini.

Procedimiento
1. Localice el kit de configuracin. Puede:
Descargue el kit de la pgina de descargas del Servicio de asistencia tcnica de OSIsoft
(https://techsupport.osisoft.com/Downloads/All-Downloads/).
Insertar el CD de distribucin.
2. Extraiga los archivos en su ordenador.
3. Si lo precisa, siga estos pasos para modificar el archivo setup.ini:
Instale una versin de PI DataLink (32 bits o 64 bits).
Instale y active el complemento PI DataLink (Legacy) (en el caso de la versin de 32 bits
de PI DataLink en Microsoft Office de 32 bits). Se requiere el complemento PI DataLink
(Legacy) para utilizar funciones de tag, funciones de Module Database o tendencias.
PRECAUCIN:
El complemento PI DataLink (Legacy) emplea tecnologa antigua, como ActiveX, que
presentan riesgos de seguridad conocidos. Los controles de ActiveX pueden
disponer de acceso a su equipo sin restricciones y, por tanto, acceder a su sistema
de archivos local y cambiar la configuracin del registro de su sistema operativo. Si
un pirata informtico recurre al control de ActiveX para hacerse con el control de
su equipo, los daos pueden ser considerables.
Para modificar el archivo setup.ini, siga el ejemplo que se indica en el archivo.
4. Ejecute el programa setup.exe. El programa de instalacin instala PI DataLink en el
directorio raz PIPC, normalmente en:

4 Manual del usuario de PI DataLink 2016


Introduccin

C:\Program Files\PIPC\Excel
El programa instala el archivo de Ayuda en lnea en el directorio de idioma correspondiente
en el directorio ../PIPC/Help. Puede descargar la versin PDF y las notas de la versin de
la pgina de descargas del Servicio de asistencia tcnica de OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/).

Qu hacer a continuacin

Para cambiar la configuracin predeterminada de PI DataLink, consulte el artculo 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) (Cmo
cambiar la configuracin predeterminada de DataLink para todos los usuarios durante la
instalacin o una actualizacin).
Para ver PI DataLink en un idioma que no sea el ingls, instale el paquete de idiomas MUI de
PI DataLink. Consulte Ver PI DataLink en un idioma compatible.

Instalacin silenciosa
Puede instalar este software con la funcin de instalacin silenciosa de Windows. En algunas
ocasiones denominada instalacin desatendida, la instalacin silenciosa no requiere ningn
tipo de comentario durante el proceso de configuracin. Los administradores del sistema con
una aplicacin de distribucin de software automatizada pueden utilizar la instalacin
silenciosa para implementar el software de forma automtica en un gran nmero de equipos
de la empresa.
Para iniciar una instalacin silenciosa, escriba:
Setup.exe f silent.ini
El archivo silent.ini se encuentra incluido en el kit de instalacin. Puede realice en el
archivo las modificaciones especficas del sitio que sean necesarias. Consulte el archivo
silent.ini para obtener ms informacin 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
multilinge) 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 ingls.

Procedimiento
1. Defina el idioma que desee en Microsoft Excel.
a. Instale el paquete de idiomas de Microsoft Office.
b. Utilice la herramienta de configuracin de idiomas de Microsoft Office para cambiar el
idioma de Microsoft Excel.
2. Descargue el paquete de idioma MUI de PI DataLink en la pgina de descargas del Servicio
de asistencia tcnica de OSIsoft (https://techsupport.osisoft.com/Downloads/All-
Downloads/).
3. Instale el paquete de idiomas MUI de PI DataLink.

Manual del usuario de PI DataLink 2016 5


Introduccin

Preferencias de conexin a colectivos de PI Data Archive


Si PI DataLink se conecta a un Archivo de datos de PI colectivo, PI DataLink establece una
preferencia de conexin cuando se conecta por primera vez al colectivo. La preferencia
depende del componente que inicia la conexin:
Las funciones de PI DataLink establecen la preferencia como Any.
La bsqueda establece la preferencia como Any.
El Administrador de conexiones (al que se accede desde la ventana Configuracin) establece
la preferencia como Prefer Primary.
Los objetos heredados de control de tendencia establecen la preferencia como Prefer
Primary.
La bsqueda de tags (a la que se accede desde las funciones de tags heredados) establece la
preferencia como Prefer Primary.
El Administrador de conexiones PI (al que se accede desde la bsqueda de tags heredados)
establece la preferencia como Prefer Primary.

Configuracin de PI Data Archive


PI DataLink puede obtener datos de Archivo de datos de PI 3.4.380 y versiones posteriores. No
obstante, PI DataLink debe poder conectarse al servidor de Archivo de datos de PI adecuado y
los usuarios deben tener un acceso adecuado a los puntos. Esto puede requerir cambios de
configuracin en:

Base de datos de firewall


La base de datos de firewall de cada equipo de Archivo de datos de PI debe configurarse
para permitir el acceso desde ordenadores de clientes que ejecutan PI DataLink.

Autenticacin y autorizacin
Es necesario que los usuarios que utilicen PI DataLink puedan autenticar su identidad con
Archivo de datos de PI y tener acceso a Archivo de datos de PI. Asigne a los usuarios un
acceso con el mnimo de privilegios, por ejemplo, otrgueles permisos de solo lectura. Para
la autenticacin, OSIsoft recomienda utilizar PI mappings (disponibles en Archivo de datos
de PI versin 3.4.380 y posteriores). Tambin puede utilizar PI trusts o la autenticacin de
contraseas en PI. OSIsoft no recomienda la autenticacin mediante contrasea de PI
porque este mtodo es menos seguro.

Definiciones de puntos
Los puntos deben definirse para autorizar a los usuarios un acceso de lectura y escritura, si
fuera necesario.
Para obtener ms informacin, consulte la documentacin de Archivo de datos de PI, incluida la
Archivo de datos de PI Security Configuration Guide. Puede ver esta documentacin en la
Biblioteca PI Live (https://livelibrary.osisoft.com) o descargarla desde la pgina de descargas
de soporte tcnico de OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/).

Configuracin del complemento para Microsoft Excel


PI DataLink tiene tres complementos de aplicacin para Microsoft Excel.

6 Manual del usuario de PI DataLink 2016


Introduccin

Nombre Ubicacin Tipo


PI DataLink ..\PIPC\Excel\OSIsoft.PIDataLink.UI.vsto Complemento
COM
PI DataLink ..\PIPC\Excel\OSIsoft.PIDataLink.UI(Legacy).vsto Complemento
(Legacy) COM
PI DataLink ..\PIPC\Excel Complemento
Notifications \OSIsoft.PIDataLink.Notifications2007.UI.vsto COM

El programa de instalacin siempre instala los complementos PI DataLink y PI DataLink


Notifications. Para que el programa de instalacin tambin instale el complemento PI DataLink
(Legacy), modifique el archivo setup.ini siguiendo el ejemplo que se indica en el archivo.
Para utilizar todas las funciones de PI DataLink, estos complementos de aplicacin deben estar
activos. El programa de instalacin siempre activa el complemento PI DataLink (Legacy).
Si PI Notifications est instalado en el ordenador, el programa de instalacin tambin activa el
complemento de PI DataLink Notifications. En caso contrario, deber activar ese complemento
despus de instalar PI Notifications. Si instala PI Notifications para admitir el complemento de
PI DataLink Notifications, OSIsoft recomienda instalar solamente la funcin PI Notifications
Client.
El programa de instalacin instala y activa el complemento PI DataLink (Legacy) si modifica el
archivo setup.ini convenientemente. Debe activar el complemento si desea utilizar
funciones de tag, objetos de Module Database o tendencias.
En casos excepcionales, Microsoft Excel debe desactivar un complemento. Deber habilitarlo
para poder activarlo.
Nota:
Para activar el complemento de aplicacin, debe disponer de privilegios de administrador
en el ordenador. Si no es administrador, haga clic con el botn derecho en Excel.exe en
Windows Explorer y, a continuacin, haga clic en Ejecutar como administrador para
ejecutar Microsoft Excel como administrador.

Consulte tambin
Funciones de tags
Objetos de PI Module Database
Tendencias
Notificaciones

En esta seccin
Ver el estado de los complementos
Activar un complemento desactivado
Activar un complemento desactivado

Ver el estado de los complementos


Compruebe el estado de un complemento para conocer si est activo, inactivo o desactivado.

Manual del usuario de PI DataLink 2016 7


Introduccin

Procedimiento
1. Haga clic e la pestaa Archivo y, a continuacin, en Opciones. (En Microsoft Excel 2007, haga
clic en el botn de Microsoft Office y, a continuacin, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. Busque en la lista de complementos el estado actual de un complemento. Cada
complemento se incluir en una de las siguientes categoras:
Complementos de aplicaciones activas
Complementos de aplicaciones inactivas
Complementos de aplicaciones deshabilitadas

Activar un complemento desactivado


Si un complemento est desactivado, debe habilitarlo primero para activarlo.

Procedimiento
1. Haga clic en la pestaa Archivo y, a continuacin, en Opciones. (En Microsoft Excel 2007,
haga clic en el botn de Microsoft Office y, a continuacin, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. En la lista Administrar, seleccione Elementos deshabilitados y, a continuacin, haga clic en
Ir.
4. Seleccione la casilla de verificacin situada junto al complemento.
5. Haga clic en Habilitar.

Activar un complemento desactivado


Active un complemento desactivado para que est disponible en Microsoft Excel.
Nota:
Para activar un complemento de aplicacin, debe tener privilegios de administrador en el
equipo. Si no es administrador, haga clic con el botn derecho en Excel.exe en Windows
Explorer y, a continuacin, haga clic en Ejecutar como administrador para ejecutar
Microsoft Excel como administrador.

Procedimiento
1. Haga clic en la pestaa Archivo y, a continuacin, en Opciones. (En Microsoft Excel 2007,
haga clic en el botn de Microsoft Office y, a continuacin, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. En la lista Administrar, seleccione Complementos COM y, a continuacin, haga clic en Ir.
4. Seleccione la casilla de verificacin situada junto al complemento.
5. Haga 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 seccin
describen las prcticas recomendadas para maximizar la seguridad de los datos cuando se
trabaja con PI DataLink.

8 Manual del usuario de PI DataLink 2016


Introduccin

En esta seccin
Seguridad de los archivos Excel
Seguridad del complemento para Excel
Privilegios de las cuentas
Prcticas 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 informacin en un libro de trabajo. Por lo tanto, OSIsoft
recomienda proteger todos los archivos de libro de trabajo. Puede:
Proteger sus archivos de libro de trabajo en Excel mediante contraseas. Las contraseas
permiten que solo los usuarios autorizados puedan ver o modificar los datos del libro de
trabajo. Para obtener ms informacin, consulte el artculo de Microsoft Office Proteger
elementos de hojas de clculo o de libros de trabajo con contrasea (https://
support.office.com/en-US/article/password-protect-worksheet-or-workbook-elements-
dbf706e0-ba22-4a08-84d8-552db16eef11).
Emplee las prcticas ms seguras para definir contraseas para sus libros de trabajo.
Defina una contrasea para abrir el libro de trabajo y otra para modificarlo.
Utilice una combinacin de maysculas y minsculas, nmeros y smbolos en sus
contraseas.
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 Information Rights Management (IRM) en los libros de trabajo 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, reenven 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 ubicacin de la informacin, porque
el permiso de acceso se guarda en el propio archivo. Para obtener ms informacin, consulte
el artculo de Microsoft Office Information Rights Management en Office 2010 (http://
office.microsoft.com/en-us/excel-help/information-rights-management-in-office-2010-
HA010354260.aspx). Si es necesario, puede establecer una fecha de caducidad para los
datos del archivo de Excel. En el artculo de Microsoft Office, vea el procedimiento
Establecer una fecha de caducidad para un archivo (http://office.microsoft.com/en-us/
excel-help/information-rights-management-in-office-2010-HA010354260.aspx#BMexpire).
Utilice el cifrado IPSec (Internet Protocol Security) en los enlaces entre equipos que 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 ms informacin, consulte el
artculo de Microsoft TechNet IPSec (https://technet.microsoft.com/en-us/library/
bb531150.aspx).
Aplique los permisos de proteccin de archivos a sus libros de trabajo Excel para asegurarse
de que los usuarios no autorizados no puedan acceder al contenido de estos archivos. Para

Manual del usuario de PI DataLink 2016 9


Introduccin

obtener ms informacin, consulte el artculo de Microsoft TechNet Permisos de archivos y


carpetas (http://technet.microsoft.com/en-us/library/bb727008.aspx).
Aplique una firma digital al archivo de libro de trabajo Excel. Para obtener ms informacin,
consulte el artculo de Microsoft Support Descripcin de las firmas digitales y la firma de
cdigo en los libros de Excel (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 acten sobre las hojas de clculo de Microsoft Excel,
OSIsoft le recomienda que solicite la firma de los complementos por parte de editores de
confianza. En concreto, utilice la pgina Complementos de Trust Center para lo siguiente:
Solicitar la firma de los complementos de aplicaciones por parte de editores de confianza.
Desactivar la notificacin de complementos sin firmar.
Si instala PI DataLink fuera del directorio C:\Program Files estndar y solicita la firma de
los complementos por parte de editores de confianza, deber aadir manualmente el
certificado PI DataLink al almacn de certificados de confianza. Consulte Aadir certificado PI
DataLink a almacn de certificados de confianza.
Para obtener ms informacin, vea el artculo 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).

Aadir certificado PI DataLink a almacn 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
estndar, deber aadir manualmente el certificado PI DataLink al almacn de certificados de
confianza.

Procedimiento
1. Abra una ventana de comandos como administrador.
2. En una ventana de smbolo del sistema, desplcese al directorio que contiene el certificado
PI DataLink (pidlcert.cer).
Encontrar el certificado en la subcarpeta Excel de la carpeta de instalacin (definida por
la variable de entorno PIHOME).
3. Introduzca el siguiente comando:
C:\Windows\System32\certutil.exe -addstore TrustedPublisher
pidlcert.cer

Privilegios de las cuentas


Para evitar que usuarios malintencionados puedan causar daos, asigne a los usuarios un
acceso con el mnimo de privilegios, por ejemplo otrgueles permisos de solo lectura.

Prcticas de seguridad organizativa


Para evitar que posibles intrusos tengan acceso al sistema, OSIsoft le recomienda que su
organizacin adopte prcticas generales de seguridad:

10 Manual del usuario de PI DataLink 2016


Introduccin

Proteja fsicamente sus equipos. Si un intruso logra acceder a equipos en los que se ejecuta
PI DataLink, podra tener acceso a todos los datos de PI System recuperados y almacenados
en archivos Excel de ese equipo.
Restrinja el acceso a los equipos a empleados e invitados autorizados. Debe establecer
procedimientos que eviten que un equipo que se haya perdido o haya sido robado pueda
acceder a la red de la empresa.
Aplique las actualizaciones de seguridad ms recientes a todos los equipos. Suscrbase al
servicio de notificaciones de seguridad para estar informado sobre las nuevas
actualizaciones de seguridad de los sistemas operativos y otros componentes. Para obtener
ms informacin, consulte el artculo de Security TechCenter Notificaciones tcnicas de
seguridad de Microsoft (http://technet.microsoft.com/en-us/security/dd252948).
Protjase contra administradores no autorizados. Los administradores no autorizados
pueden ocasionar numerosos ataques. Por ejemplo, pueden hacer lo siguiente:
Instalar y ejecutar software malicioso.
Configurar el acceso remoto para hacerse con el control de un equipo.
Auditar toda la actividad administrativa y revisar de forma rutinaria los registros de
auditora. Pida a todos los administradores que efecten comprobaciones de antecedentes
antes de contratar a nuevos empleados y que realicen comprobaciones peridicas como
condicin laboral.
Prevea mltiples capas de seguridad. Confiar nicamente en la seguridad perimetral, como
los cortafuegos, incrementa el riesgo en caso de problemas en el cortafuegos. Puede prever
otra capa de proteccin diseando su red para separar los clientes menos seguros de los
clientes ms seguros. Los cortafuegos personales en equipos cliente agregan una capa
adicional. Mejore an ms la seguridad con software para la deteccin de intrusos y
software para la deteccin de intrusos basados en host que ayudan a filtrar actividades
sospechosas. La ejecucin de software antivirus es esencial. Finalmente, la formacin de los
usuarios en cuestiones de seguridad informtica es una parte crtica de una estrategia de
seguridad de la red.
Cree y mantenga lneas base seguras para todos los sistemas. Especifique todas las lneas
base con una descripcin detallada de cmo configurar y administrar el equipo. La
descripcin debe incluir todos los parmetros de configuracin pertinentes para un equipo
seguro. Para crear una lnea base segura, utilice el sistema operativo ms seguro posible. Es
ms probable que los sistemas operativos ms recientes estn diseados 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 estn disponibles.
Utilice contraseas o claves seguras. No utilice nunca contraseas en blanco. Para obtener
ms informacin sobre las contraseas, consulte el artculo de Microsoft TechNet Polticas
de cuentas (https://technet.microsoft.com/en-us/library/dd349793(v=ws.10).aspx).
Controle el acceso a los archivos Excel de PI DataLink. Implemente procedimientos de
control de acceso para asegurarse de que todos los archivos Excel estn guardados en un
lugar seguro y que ningn intruso pueda modificar el contenido de los archivos o buscar
informacin en ellos.

Estrategias de registro
Las organizaciones deben desarrollar una estrategia de registro adecuada. Puede utilizar
archivos de registro para:

Manual del usuario de PI DataLink 2016 11


Introduccin

Seguimiento. Puede utilizar archivos de registro para ofrecer datos estadsticos sobre
transacciones.
Verificacin. Puede utilizar archivos de registro para ofrecer un registro completo de
transacciones para recrear las transacciones.
Demostrar la validez de una transaccin.
PI DataLink enva todas las solicitudes de datos a travs de PI AF SDK. Aunque PI DataLink no
mantiene archivos de registro separados, puede utilizar los archivos de registro de Archivo de
datos de PI y de PI AF SDK para obtener informacin sobre las transacciones de PI DataLink.
Consulte la documentacin de Archivo de datos de PI y de PI AF SDK para obtener ms
informacin.

Acerca de este documento


PI DataLink User Guide proporciona una descripcin detallada de las caractersticas del
producto y una referencia completa sobre las funciones de PI DataLink. El contenido de las
versiones en PDF y de la Ayuda del manual es idntico.
Este documento asume que tiene conocimientos sobre conceptos de PI System. Consulte la
documentacin de Archivo de datos de PI y de PI AF para obtener ms informacin sobre esos
productos. Conocer Archivo de datos de PI y PI AF lo ayudar a comprender los trminos que
se utilizan en PI DataLink.
Es posible que los materiales de formacin puedan serle de utilidad. Los materiales incluyen
ejercicios que OSIsoft utiliza en los cursos de formacin de PI DataLink.
Puede descargar los materiales de capacitacin y la documentacin relativa a otros productos
de OSIsoft en la Pgina de descargas de soporte tcnico de OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/). Tambin puede ver la documentacin
en la Biblioteca PI Live (https://livelibrary.osisoft.com).

Cambio de terminologa
OSIsoft revisa su terminologa para reflejar el crecimiento de PI System de su arquitectura
original de servidor nico. En la terminologa revisada, PI Data Archive se refiere al
componente que almacena datos de series temporales (anteriormente, PI Server), y PI Server
se refiere a PI Data Archive y a PI Asset Framework. Este documento utiliza la terminologa
revisada.

12 Manual del usuario de PI DataLink 2016


Conceptos bsicos
Cuando utiliza PI DataLink, define funciones de PI DataLink que extraen datos de PI System en
matrices de funcin en una hoja de clculo de Excel. Una matriz de funcin es un grupo de
celdas que contiene la salida de una funcin de PI DataLink. Los siguientes apartados presentan
las funciones y conceptos bsicos de PI DataLink. Debera familiarizarse con estos apartados
entes de utilizar PI DataLink para crear hojas de clculo y recuperar datos de PI System.
Estos apartados describen:
Funciones de interfaz de usuario
Las funciones esenciales necesarias para comenzar a trabajar con PI DataLink
Los diferentes enfoques para construir una hoja de clculo con PI DataLink dependiendo de
sus objetivos, necesidades y recursos

En esta seccin
Interfaz de usuario
Descripcin general de las funciones de PI DataLink
Bsquedas
Administrar configuraciones de PI DataLink
Gestionar conexiones con servidores

Interfaz de usuario
PI DataLink aade comandos de men, ventanas y paneles de tareas especficos a Microsoft
Excel.
Los siguientes apartados describen los elementos fundamentales de la interfaz de PI DataLink.

En esta seccin
Pestaa PI DataLink
Paneles de tareas de funciones
Men del botn derecho

Pestaa PI DataLink
PI DataLink inserta la pestaa PI DataLink en la cinta de Microsoft Excel.

Haga clic en la pestaa PI DataLink para acceder a los comandos de PI DataLink.


Haga clic en un comando para abrir el correspondiente panel de tareas o el cuadro de
dilogo.
Site el cursor sobre un comando para mostrar una ayuda inmediata descriptiva.

Manual del usuario de PI DataLink 2016 13


Conceptos bsicos

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 clculo mientras el panel de tareas est abierto.
Para abrir un panel de tareas de funcin:
Haga clic en la celda de salida deseada y, a continuacin, haga clic en un comando de funcin
de la pestaa PI DataLink para aadir una funcin.
Haga clic en una celda de una matriz de funcin existente para mostrar el panel de tareas
correspondiente y editar las entradas de la funcin.
Nota:
Si lo prefiere, puede desactivar la aparicin automtica de paneles de tareas. Consulte
Administrar configuraciones de PI DataLink.
Haga clic con el botn derecho en una celda de matriz de funcin y seleccione el nombre de
la funcin para mostrar manualmente el panel de tareas.
Una vez que est abierto un panel de tareas de funcin:
Introduzca o modifique valores y, a continuacin:
Haga clic en Aceptar para guardar los valores de entrada, escribir la matriz de funcin
resultante y cerrar el panel de tareas.
Haga clic en Aplicar para guardar los valores de entrada y escribir la matriz de funcin
resultante sin cerrar el panel de tareas.
Haga clic en el botn de flecha para seleccionar los comandos Mover, Tamao o Cerrar.
Arrastre la barra de ttulo para desacoplar el panel de tareas.
Haga doble clic en la barra de ttulo para acoplar el panel de tareas.
Coloque el cursor sobre el borde para arrastrar y redimensionar el panel.

14 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Men del botn derecho


PI DataLink aade varios comandos al men contextual estndar de Microsoft Excel. Puede
utilizar estos comandos para gestionar matrices de funcin que ya estn insertadas en una hoja
de clculo.
Para abrir el men contextual con los comandos de PI DataLink, haga clic con el botn derecho
del ratn en cualquier lugar de una matriz de funcin de PI DataLink.
PI DataLink aade los siguientes comandos al men contextual:
Seleccionar funcin de DataLink
Selecciona la matriz de funcin completa.
Debe seleccionar una matriz antes de intentar copiarla, cortarla o arrastrarla a una nueva
ubicacin en la hoja de clculo.
Recalcular (Redimensionar) funcin
Actualiza la matriz completa de la funcin: PI DataLink recupera valores nuevos de Archivo
de datos de PI o de PI AF y redimensiona automticamente la matriz para que se ajuste a los
datos obtenidos.
Nombre de funcin
Abre el panel de tareas de funcin correspondiente y muestra las entradas de la matriz de
funcin.
Las tendencias ofrecen un men contextual alternativo.

Consulte tambin
Men contextual de tendencias
Paneles de tareas de funciones

Descripcin 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 funcin para introducir de forma sencilla las entradas que definen la funcin. O
tambin, a medida que vaya adquiriendo ms experiencia, puede introducir una funcin
directamente en la barra de frmulas de Excel.
Los siguientes apartados describen:
Las funciones comunes de los paneles de tareas de funciones de PI DataLink
La obtencin y presentacin de datos en tiempo real
El uso de las funciones de PI DataLink en una hoja de clculo

Consulte tambin
Paneles de tareas de funciones
Entrada manual de funciones

En esta seccin
Elementos de datos
Campo de entrada
Campos de entrada de tiempo

Manual del usuario de PI DataLink 2016 15


Conceptos bsicos

Datos aadidos
Formatos de presentacin
Valores interpolados

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 funcin de determinados criterios o
una expresin concreta.
Cuando define una funcin, especifica las rutas de los elementos de datos con los campos
Elemento de datos, Expresin y Expresin de filtro junto con el campo opcional Ruta raz.
Puede especificar:
Rutas completas en los campos Elemento de datos, Expresin o Expresin de filtro. Una ruta
completa comienza con dos barras diagonales inversas (\\) y evala un PI point o un
atributo de PI AF.
Rutas parciales en los campos Elemento de datos, Expresin o Expresin de filtro y la ruta
de acceso base en el campo Ruta raz. 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 comn
con la ruta parcial para establecer la ruta completa que evala 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 servidor de Archivo de datos de PI donde realizar la
bsqueda 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 raz en blanco si los campos Elemento de datos, Expresin y
Expresin de filtro contienen una ruta completa o un PI point en el servidor predeterminado de
Archivo de datos de PI.
Si se especifica, el campo Ruta raz indica la ruta comn de los elementos de datos
especificados.
Tipo de elemento de Contenido del campo de ruta raz
datos
PI point Servidor de Archivo de datos de PI que almacena el punto o un valor en
blanco para indicar el servidor predeterminado de Archivo de datos de PI.
Las entradas vlidas incluyen:
MyPIDataArchiveServer
\\MyPIDataArchiveServer

16 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Tipo de elemento de Contenido del campo de ruta raz


datos
Atributo de PI AF Servidor de PI AF y base de datos junto con cualquier elemento, subelemento
o atributo principal no especificados en Elemento de datos. Las entradas
vlidas incluyen:
\\MyPIAFServer\MyDatabase
\\MyPIAFServer\MyDatabase\MyElement
\\MyPIAFServer\MyDatabase\MyElement\MySubElement
\\MyPIAFServer\MyDatabase\MyElement|MyParentAttribute
\\MyPIAFServer\MyDatabase\MyElement|MyParentAttribute1|
MyParentAttribute2
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 raz y la
base de datos en el campo Elemento de datos.

Consulte tambin
Expresiones

Campo de entrada
Los campos etiquetados como de entrada en los paneles de tareas de funcin aceptan valores
correctos para la funcin. En la mayor parte de los campos de entrada, puede introducir un
valor o una referencia a una celda de hoja de clculo que contenga el valor. Algunos campos de
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 edicin , puede hacer lo
siguiente:
Introducir texto directamente en el campo de edicin; por ejemplo un nombre de atributo
de PI AF o la direccin de una celda de salida.
Hacer clic en el campo de edicin y despus en una celda o rango de la hoja de clculo que
contenga valores correctos, como nombres de atributo de PI AF, marcas de tiempo o
ubicaciones de celdas de salida.
Hacer clic en el campo de edicin para abrir una lista de valores vlidos entre los que puede
seleccionar (solo disponible para los campos Ruta raz y Base de datos).
Hacer clic en para abrir la herramienta de bsqueda y, a continuacin, seleccionar los
elementos de datos obtenidos en una bsqueda de un servidor de Archivo de datos de PI o
de PI AF conectado.
En el caso de entradas con listas , puede hacer los siguiente:
Seleccionar una opcin de la lista, como un clculo o un mtodo de muestreo.
Hacer clic en y, a continuacin, en una celda o rango de hoja de clculo que contenga
valores correctos, como el modo, la unidad de tiempo, el lmite o la propiedad.
Nota:
En los campos de edicin, introduzca cadenas sin comillas. Sin embargo, en las celdas de
hojas de clculo, introduzca las cadenas con comillas sencillas iniciales (') para obligar a
Excel a interpretar el contenido como una cadena.

Manual del usuario de PI DataLink 2016 17


Conceptos bsicos

Por ejemplo, para especificar un PI point en el campo Elemento(s) de datos, puede hacer lo
siguiente:
Introducir la cadena del nombre del punto.
Hacer clic en para abrir la herramienta de bsqueda y buscar el punto en el servidor de
Archivo de datos de PI.
Introducir una referencia a una celda de hoja de clculo de contenga el nombre del punto:
a. Hacer clic en el campo Elemento(s) de datos.
b. Hacer clic en la celda de la hoja de clculo.
PI DataLink introducir automticamente la referencia de la celda en el campo de
edicin.

Campos de entrada de tiempo


Muchas funciones de PI DataLink requieren campos de entrada de Hora de inicio y Hora de
finalizacin para recuperar una matriz de valores a lo largo de un intervalo de tiempo
especfico. Otras funciones de PI DataLink requieren un campo de entrada de Marca de tiempo
para obtener los valores de momento especfico. Siga estas indicaciones para especificar
valores en los campos de entrada de tiempo:
Introduzca un tiempo absoluto, como 10-dic-99 19:12, o una expresin 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
expresin de tiempo relativa para definir un periodo de tiempo que incluya el momento
actual.
Si la hora de inicio es ms reciente que la hora de finalizacin, PI DataLink muestra los
resultados en orden cronolgico inverso.
Coloque comillas simples delante de las expresiones temporales introducidas en las celdas
para indicar que se trata de una cadena (por ejemplo, '10-dic-99 19:12 o '-3h).
Las referencias de celda tambin pueden utilizar el formato absoluto de tiempo de Excel
(como 39299.6146, equivalente a 8/5/2007 2:45:00 PM). Excel almacena las marcas de
tiempo en este formato, que representa el nmero acumulado de das desde 1900. Excel
puede mostrar las mismas marcas de tiempo utilizando cualquier formato de fecha y hora
asignado a la celda.
Algunas entradas de tiempo, como 9:45, pueden representar un tiempo vlido y un rango
vlido de filas de hoja de clculo. En el campo del panel de tareas, coloque al principio de
estas entradas comillas simples, como '9:45, para 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 un valor y una unidad 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 intervalos en trminos de frecuencia, convierta la frecuencia a los segundos
equivalentes. Por ejemplo, una frecuencia de 25 Hz debe introducirse como un intervalo de
0,04s (=1/25 de segundo).

18 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Nota:
PI DataLink solo admite el sistema predeterminado de fecha de 1900 admitido por Excel.
PI DataLink no admite el sistema de fecha de 1904 de Excel, y devuelve marcas de tiempo
incorrectas si se utiliza dicho sistema.

Consulte tambin
Especificacin de intervalos de tiempo
Especificacin de intervalos de tiempo

Datos aadidos
PI DataLink puede aadir informacin sobre los valores recuperados. Los datos aadidos
pueden proporcionar un contexto a los valores recuperados. Los datos aadidos pueden
incluir:
Marcas de tiempo que muestran cundo se registraron los valores
Marcas de tiempo que indican las horas de inicio y finalizacin de un intervalo
Marcas de tiempo que indican la ocurrencia de los valores mnimo y mximo
El porcentaje de valores correctos durante un intervalo de muestra
Atributos de valor
Anotaciones introducidas manualmente
Nombres de servidores fuente
PI DataLink muestra los datos aadidos especificados en las columnas (o filas) junto a los
valores principales que la funcin devuelve:
Los datos de tiempo se muestran en columnas a la izquierda (o en filas encima) de los
valores principales.
Otros datos relacionados se aaden en columnas a la derecha (o en filas debajo) de los
valores principales.

Formatos de presentacin
Utilice la ventana Configuracin para especificar los formatos de fecha y nmero que PI
DataLink utiliza para dar formato a los datos en las matrices de funcin. Hay dos
configuraciones:
Formato de nmero
El formato para los nmeros en la salida de funcin. El ajuste predeterminado, General, da
formato a los nmeros (y a todos los datos que no son marcas de tiempo) para que
coincidan con el formato de la categora General en la ventana Formato de celdas de Excel.
Formato de hora
El formato para las marcas de tiempo en la salida de funcin. El formato predeterminado,
dd-mmm-yy hh:mm:ss, coincide con el formato de marca de tiempo estndar de PI. Puede
aadir .000 al final de la cadena (dd-mmm-yy hh:mm:ss.000) para mostrar marcas de
tiempo con subsegundos. Tenga en cuenta que Excel no admite formatos con precisin de
microsegundos.
Puede personalizar las cadenas de formato con cualquier cdigo de formato de Excel vlido de
la ventana Formato de celdas en Excel.

Manual del usuario de PI DataLink 2016 19


Conceptos bsicos

Para obtener detalles en la ventana Configuracin, consulte Administrar configuraciones de PI


DataLink.
Tambin puede aplicar un formato de nmero y hora individual a cualquier celda de hoja de
clculo, incluidas las que contienen funciones de PI DataLink con el cuadro de dilogo Format
Cells (Formato de celdas). Consulte su documentacin sobre Excel para obtener informacin
sobre el formato de nmeros y horas. PI DataLink sobrescribe o aplica formatos de celdas
individuales como se indica a continuacin:
Cuando escribe una matriz de funcin y hace clic en OK (Aceptar) o Apply (Aplicar) en un
panel de tareas, PI DataLink sobrescribe cualquier formato de nmero o de hora individual
aplicado a una celda de la matriz de funcin con la configuracin de la ventana Settings
(Configuracin).
Cuando escribe una matriz de funcin y hace clic con el botn secundario en una matriz de
funcin para seleccionar Recalculate (Resize) function (Recalcular funcin [Ajustar
tamao]), PI DataLink localiza la celda superior izquierda de la matriz con un formato de
nmero y lo aplica a todas las celdas de la matriz con formato de nmero, tanto si se trata de
un formato individual como el formato de la ventana Settings. De igual modo, PI DataLink
localiza la celda superior izquierda de la matriz con un formato de hora y lo aplica a todas
las celdas de la matriz con formato de hora, tanto si se trata de un formato individual como
el formato de la ventana Settings.

Valores interpolados
Muchas funciones de PI DataLink pueden arrojar valores interpolados, tiles para los PI points
asociados con marcas de tiempo. Por ejemplo, puede solicitar que la funcin Valor de archivo
histrico arroje un valor interpolado en una marca de tiempo particular en lugar del ltimo
valor registrado que precede a la marca de tiempo. El valor interpolado depende de las marcas
de tiempo de los valores registrados y, posiblemente, del tipo de PI point:
Para las marcas de tiempo anteriores al primer valor registrado, la funcin arroja Pt
Created o No Data.
Para las marcas de tiempo entre dos valores registrados, la funcin determina el valor de la
marca de tiempo mediante el uso de la interpolacin lineal entre los valores registrados.
Para los puntos que almacenan valores discretos, como puntos de estado digital o puntos de
paso, la funcin arroja el ltimo valor registrado que precede a la marca de tiempo.
Para las marcas de tiempo posteriores al ltimo valor registrado, el valor arrojado depende
del tipo de punto:
Para PI points histricos, la funcin arroja el valor ms reciente.
Para PI points futuros, la funcin arroja No Data.

Bsquedas
PI DataLink ofrece dos formas de buscar elementos de datos:

Herramienta de bsqueda
La herramienta de bsqueda permite buscar PI points o atributos de PI AF ya sea mediante
la bsqueda de texto coincidente o mediante la exploracin de un servidor de Archivo de
datos de PI o de una base de datos de PI AF. Segn cmo se abra la herramienta, inserta los
puntos o atributos encontrados en hojas de clculo o en paneles de tareas de funciones.

20 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Funcin de bsqueda de filtro de activo


La funcin Bsqueda de filtro de activo permite buscar elementos PI AF que satisfacen unos
criterios y filtrarlos en funcin de ciertos valores de atributos. La funcin puede devolver
los elementos filtrados o atributos seleccionados de los elementos filtrados. La funcin
puede pegar los activos filtrados en la hoja de clculo como valores o como matriz de
funcin.

En esta seccin
Buscar elementos de datos
Buscar activos mediante filtros

Buscar elementos de datos


Utilice la herramienta de bsqueda para buscar elementos de datos en un determinado
servidor de Archivo de datos de PI o de PI AF. Puede insertar elementos de datos en la hoja de
clculo y referenciar posteriormente estos elementos de datos en las funciones de PI DataLink.
Tambin puede insertar un elemento de datos directamente en un panel de tareas de
funciones.

Antes de empezar
Conctese a cualquier servidor de Archivo de datos de PI o de PI AF en el que desee realizar la
bsqueda. Consulte Gestionar conexiones con servidores.

Procedimiento
1. Abra la herramienta Bsqueda:
Para insertar uno o varios elementos en una hoja de clculo, seleccione la celda superior
izquierda del intervalo en la hoja de clculo donde desea insertar los elementos de datos
y, a continuacin, en la pestaa PI DataLink, en el grupo Buscar, haga clic en Buscar.
Para insertar uno o varios elementos en un panel de tareas de funcin, haga clic en el
botn , situado junto al campo Elemento(s) de datos.

2. Defina el mbito de la bsqueda, que se muestra en la ruta en la parte superior.


Tras el primer uso, la herramienta se inicia en el nodo principal, que muestra todos los
servidores de Archivo de datos de PI (indicados por ) y los servidores de PI AF (indicados
por ) que aparecen listados en el Administrador de conexiones. Debe limitar la bsqueda
a un solo servidor de Archivo de datos de PI o a un solo servidor de PI AF e, incluso an ms,
a una nica base de datos en un servidor de PI AF y despus a determinados elementos y
atributos principales.
La siguiente vez que se utiliza, la herramienta inicia la sesin con el mbito de la bsqueda
definido en el ltimo servidor de Archivo de datos de PI, servidor de PI AF o base de datos
de PI AF en que busc.
Puede:
Utilizar el panel del navegador para limitar la bsqueda
Utilizar la ruta del mbito para limitar la bsqueda
Si define el mbito de bsqueda como un elemento o un atributo, en el panel de resultados
se incluirn los atributos secundarios inmediatos de ese elemento o atributo.
3. Segn proceda, busque elementos de datos dentro del mbito para que aparezcan listados
en el panel de resultados.
a. En el campo situado en la parte superior de la herramienta, escriba el texto que identifica
los elementos de datos que desea encontrar en el mbito seleccionado.

Manual del usuario de PI DataLink 2016 21


Conceptos bsicos

Puede utilizar caracteres comodn para mejorar su bsqueda. Por ejemplo:


Escriba sinusoid para localizar todos los elementos de datos denominados
sinusoid.
Escriba sinusoid* para localizar los elementos de datos que comiencen por
"sinusoid", como sinusoid o sinusoidu.
Escriba *u para localizar los elementos de datos que comiencen por "u", como
sinusoidu.
Escriba * para localizar todos los elementos de datos.
b. Si el mbito de bsqueda es un servidor de Archivo de datos de PI, configure los campos
de 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
clsicos y bsicos, incluido el atributo future. Seleccione un atributo de punto de una
lista y, a continuacin, introduzca texto en el campo correspondiente para encontrar los
puntos PI coincidentes con su entrada. Puede utilizar caracteres comodn; la bsqueda
no aade caracteres comodn implcitos. Puede filtrar la lista obtenida en funcin del tipo
de punto y seleccionar el tipo de valor almacenado que desea encontrar.
Por ejemplo, seleccione Descriptor y, a continuacin, introduzca *vapor* para obtener
solo los PI points que contienen la palabra vapor en cualquier posicin del atributo de
punto descriptor.
Consulte la documentacin de Archivo de datos de PI para obtener ms informacin
sobre los atributos de PI point.
c. Haga clic en Buscar para iniciar la bsqueda.

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 herramienta busca en la totalidad de la jerarqua debajo del
mbito de bsqueda. (En contraposicin, cuando se busca en la jerarqua, el panel de
resultados solo muestra los atributos secundarios inmediatos del mbito de bsqueda.)
La herramienta localiza:
PI points con nombres coincidentes.
Atributos de PI AF con nombres coincidentes.
Los atributos de PI AF con descripciones coincidentes (si utiliza PI AF Server 2015 o
superior)
Atributos de PI AF que tienen elementos principales con nombres, descripciones,
categoras o plantillas coincidentes.
Nota:
Las bsquedas de Archivo de datos de PI arrojan un mximo de 100 000 PI points.
Para asegurarse de ver todos los resultados, limite la bsqueda para que devuelva
menos PI points.
4. Si lo desea, cambie las columnas que se muestran en el panel de resultados:
Haga clic con el botn derecho del ratn en el panel de resultados y, a continuacin, haga
clic en el nombre de una columna para aadirla o eliminarla de las columnas mostradas.
Arrastre los encabezados de columna para cambiar el orden de las columnas mostradas.
5. Si lo desea, mueva el control deslizante Longitud de elemento de datos para dividir la ruta
del elemento de datos entre las columnas Ruta raz y Elemento de datos:

22 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Seleccione Ruta completa para especificar una ruta completa en la columna Elemento de
datos.
Seleccione Solo nombre 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 raz.
Seleccione posiciones intermedias para otras divisiones de contenido entre las columnas.
El contenido de estas columnas determina el contenido que se aade a los campos del panel
de tareas o las columnas de hoja de clculo.
6. Si inserta atributos de PI AF en la hoja de clculo y divide el contenido del elemento de
datos, especifique la manera de insertar el contenido de Ruta raz en la hoja de clculo:
Seleccione Lista desplegable para insertar una lista desplegable de rutas (procedentes de
la columna Ruta raz) seguida de los elementos de datos (procedentes de la columna
Elemento de datos) en las celdas de hoja de clculo designadas.
Si referencia la lista desplegable y los elementos de datos insertados en una funcin de PI
DataLink, la hoja de clculo actualizar de forma dinmica los valores recuperados
cuando se seleccione una ruta diferente en la lista.
Nota:
PI DataLink inserta la lista de rutas raz en la columna ALL de la hoja de clculo. Si
esa columna contiene datos, PI DataLink inserta las rutas en la siguiente columna
disponible a la derecha.
Seleccione Columna o fila para insertar el contenido de las columnas Ruta raz y
Elemento de datos en las celdas de hoja de clculo designadas.
En este caso, PI DataLink inserta siempre el contenido de Ruta raz en la primera
columna de la hoja de clculo y el contenido de Elemento de datos en la segunda.
7. Seleccione los elementos que desee insertar y haga clic en Aceptar.

Consulte tambin
Crear un despliegue relacionado con activos

Utilizar el panel del navegador para limitar la bsqueda


El panel del navegador se encuentra a la izquierda de la herramienta Bsqueda. El panel del
navegador muestra lo que incluye el actual mbito de bsqueda (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 jerarqua por debajo de ellos. Por lo tanto, el panel del navegador nunca
escuchar elementos o atributos sin ningn atributo secundario.
Puede utilizar el panel del navegador para limitar el mbito de una bsqueda (y definir la ruta
del mbito). Por ejemplo, puede limitar una bsqueda a un servidor de PI AF concreto o a una
una determinada base de datos en ese servidor o a un elemento especfico de la base de datos.
A medida que navegue por la jerarqua 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 panel del navegador:
Haga clic en un servidor para limitar la bsqueda 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 navegacin. Si ha hecho clic en un servidor

Manual del usuario de PI DataLink 2016 23


Conceptos bsicos

de PI AF (indicado por ), el panel del navegador muestra todas las bases de datos de
ese servidor. Si ha hecho clic en un servidor de Archivo de datos de PI (indicado por ),
el panel del navegador muestra filtros que puede utilizar para limitar el nmero de PI
points recuperados en funcin de los valores de atributos.
Haga clic en una base de datos (indicado por ) para limitar la bsqueda a esa base de
datos.
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 bsqueda 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 bsqueda 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 bsqueda


La ruta del mbito se encuentra en la parte superior de la herramienta Bsqueda.

La ruta del mbito muestra la ubicacin en la que la herramienta Bsqueda busca elementos de
datos. Puede utilizar la ruta del mbito para limitar el mbito de una bsqueda. Por ejemplo,
puede limitar una bsqueda a un servidor de PI AF concreto o a una una determinada base de
datos en ese servidor o a un elemento especfico de la base de datos. A medida que navegue por
la jerarqua 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 ruta del mbito:
Haga clic en Inicio para navegar al nodo principal. En el nodo principal, el panel del
navegador muestra todos los servidores de Archivo de datos de PI y de PI AF
enumerados en el Administrador de conexiones. No es posible efectuar bsquedas en el
nodo principal. El mbito ms amplio para realizar bsquedas es un solo servidor de
Archivo de datos de PI o un solo servidor de PI AF.
Haga clic en la flecha situada junto a Inicio y, a continuacin, 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 continuacin, 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.

24 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Haga clic en la flecha situada junto a la base de datos y, a continuacin, 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 continuacin, haga clic en un
subelemento o atributo para restablecer el mbito a ese subelemento o atributo.
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 continuacin, haga clic en
un subatributo concreto para restablecer el mbito a ese subatributo.

Buscar activos mediante filtros


Utilice la funcin Bsqueda 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
funcin devuelva los elementos filtrados o atributos seleccionados de los elementos filtrados.
Tambin puede indicar si desea pegar los activos devueltos en la hoja de clculo como valores
estticos o como matriz de funcin, que puede actualizarse automticamente.

Procedimiento
1. Seleccione la celda superior izquierda del intervalo de la hoja de clculo donde desea
insertar los activos recuperados.
2. En la pestaa PI DataLink, en el grupo Buscar, haga clic en Filtro de activo para abrir el
panel de tareas Bsqueda de filtro de activo.
3. En el campo Ruta raz, introduzca la ruta comn de los elementos que desea buscar.
La ruta comn debe incluir el servidor y la base de datos, y puede contener elementos
principales. Especifique en el formato \\ServerName\DatabaseName
\ParentElementName.
Por ejemplo, para buscar elementos en el nivel raz de la base de datos MyDatabase en el
servidor MyPIAFServer, introduzca \\MyPIAFServer\MyDatabase; para buscar
elementos en el elemento Boilers de la misma base de datos, introduzca \\MyPIAFServer
\MyDatabase\Boilers.
4. Especifique los elementos de PI AF que desea recuperar:
a. En la lista Plantilla de elemento, seleccione la plantilla de elementos recuperados.
Debe seleccionar una plantilla para filtrar elementos en funcin de los valores de los
atributos. Tenga en cuenta que si selecciona una plantilla base, la funcin tambin
recuperar elementos de plantillas derivadas.
b. En el campo Nombre de elemento, introduzca el nombre de los elementos que desea
recuperar. Utilice caracteres comodn para especificar parte del nombre.
c. En la lista Categora de elemento, seleccione la categora de elementos que desea
recuperar.
d. En el campo Descripcin de elemento, introduzca el texto que aparece en la descripcin
de todos los elementos que desea recuperar. Utilice caracteres comodn para especificar
parte de la descripcin.
e. Seleccione la casilla Limitar a nivel raz para recuperar nicamente elementos en el nivel
especificado en el campo Ruta raz. Desmarque la casilla para recuperar tambin
elementos secundarios.
f. Opcional: En la tabla Filtros de valor de atributo, especifique las condiciones de los
valores de atributo de los elementos que desea recuperar.

Manual del usuario de PI DataLink 2016 25


Conceptos bsicos

Antes de especificar una condicin de valor de atributo, debe seleccionar una plantilla de
elemento. Tambin puede filtrar con valores de atributos definidos en esa plantilla de
elementos.
Puede especificar hasta cinco condiciones. Para cada condicin, defina tres campos:
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 =, < o >. Para los atributos
que contienen valores de cadena, booleanos o enumerados, los nicos operadores
vlidos son = y <>.
En el campo Valor, escriba el valor del filtro. Puede utilizar caracteres comodn para
los atributos de cadena.
Por ejemplo, para recuperar elementos cuyo atributo Manufacturer empieza por ABC y
que tengan un atributo de ZipCode entre 94102 y 94188 (ambos inclusive), introduzca
tres condiciones:
Fabricante = ABC*
Cdigo postal >= 94102
Cdigo postal <= 94188
Para obtener mejores resultados, limite los atributos a aquellos que tengan valores
almacenados en la base de datos de PI AF (es decir, omita los atributos con referencias de
datos). Si especifica un atributo con una referencia de datos, la funcin utiliza la
configuracin de las preferencias de mximo de filtros de bsqueda para limitar el
nmero de elementos en los que se buscan valores de atributo coincidentes. Consulte
Administrar configuraciones de PI DataLink.
5. Especifique la salida de la hoja de clculo:
a. En la lista Atributos para mostrar, seleccione los atributos que desea incluir y defina el
orden de los atributos.
Si no selecciona ningn atributo, la funcin Bsqueda de filtro de activo solo devuelve los
elementos coincidentes. Si selecciona como mnimo un atributo, la funcin devuelve los
atributos seleccionados para cada elemento.
De forma predeterminada, la lista incluye los atributos en la plantilla de elementos
seleccionada. Puede:
Marcar la casilla Seleccionar todo para incluir todos los atributos enumerados.
Seleccionar una casilla para incluir un atributo o deseleccionarla para excluirlo.
Escribir el nombre de un atributo junto a la casilla en blanco del final de la lista.
Seleccionar un atributo y hacer clic en para mover el atributo hacia arriba en la
lista de atributos visualizados.
Seleccionar un atributo y hacer clic en para mover el atributo hacia abajo en la
lista de atributos visualizados.
Seleccionar un atributo y hacer clic en para eliminar el atributo de la lista de
atributos visualizados.
b. Indique cmo pegar los elementos o atributos coincidentes en la hoja de clculo:

26 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Haga clic en Columna para insertar la ruta completa de los elementos o de los
atributos en las celdas designadas de la hoja de clculo.
Haga clic en Lista desplegable para insertar una lista desplegable que incluya las rutas
de los atributos (es decir, el servidor nico, la base de datos y los elementos
principales) seguida de los atributos seleccionados en las celdas designadas de la hoja
de clculo.
Seleccione solo Lista desplegable si ha seleccionado como mnimo un atributo.
En otra funcin de PI DataLink, puede incluir una referencia a la lista desplegable
insertada desde un campo Ruta raz y a los atributos desde un campo Elemento de
datos para crear visualizaciones relacionadas con activos: la hoja de clculo
actualizar de manera dinmica los valores recuperados cuando seleccione una ruta
diferente de la lista. Consulte Despliegues relacionados con activos.
c. Indique el formato de salida:
Haga clic en Matriz de funcin para pegar una matriz de funcin. Este es el formato de
salida de otras funciones de PI DataLink. Con una matriz de funcin, puede actualizar
fcilmente las entradas del panel de tareas y recalcular los resultados.
Haga clic en Valores para pegar la salida como valores. Puede copiar fcilmente
valores para utilizarlos en otro lugar.
Consejo:
Las matrices de funcin son especialmente tiles cuando los resultados de la
funcin cambian con frecuencia. Sin embargo, el reclculo de la matriz de funcin
que se produce cada vez que se abre una hoja de clculo puede ser lento. Por otra
parte, los valores son tiles cuando no se espera que cambien los resultados y no se
quiere esperar a que vuelva a calcularse la matriz de la funcin.
d. Compruebe que el campo Celda de salida contiene la celda superior izquierda del
intervalo de la hoja de clculo donde desea insertar los activos arrojados.
6. Haga clic en Aceptar para insertar los elementos o los atributos en la hoja de clculo y cerrar
el panel de tareas.

Administrar configuraciones de PI DataLink


Utilice la ventana Configuracin para especificar preferencias globales y formatos de salida
predeterminados para las funciones de PI DataLink. Estas configuraciones se aplican a un
determinado usuario o equipo. Desde esta ventana, tambin puede borrar el cach de los datos
de configuracin de PI points y los datos no basados en el tiempo de PI AF.

Procedimiento
1. En la pestaa PI DataLink, en el grupo Recursos, haga clic en Configuracin.
2. Para borrar el cach de PI DataLink manualmente, haga clic en Borrar cach.
De manera predeterminada, PI DataLink almacena en cach los datos de configuracin 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). Este almacenamiento en cach mejora el
rendimiento. Antes de calcular una funcin, PI DataLink verifica cundo el cach se borr
por ltima vez; si no se ha borrado en las ltimas seis horas, PI DataLink lo borra
automticamente. Para borrar el cach y obtener datos actualizados antes, borre el cach
manualmente.
3. Para actualizar la configuracin, ingrese la configuracin que desee y haga clic en Aceptar.

Manual del usuario de PI DataLink 2016 27


Conceptos bsicos

Ajuste Descripcin
Copiar nombre de PI Data Seleccione esta opcin para pegar el nombre de la fuente de datos
Archive (solo complemento de Archivo de datos de PI en una celda de hoja de clculo
heredado) adyacente cuando inserte nombres de PI point procedentes de
funciones de tags en una hoja de clculo.
Mostrar #N/A en vez de Seleccione esta opcin para mostrar #N/A (no aplicable) en lugar
espacios en blanco de celdas en blanco sin valores cuando el reclculo arroja menos
valores de los que puede mostrar una matriz de funcin.
Esta funcin es particularmente til cuando los resultados de la
funcin se trazan mediante el paquete de grficas de Excel.
Independiente regional Seleccione esta casilla para interpretar las cadenas de tiempo de
entrada conforme a las reglas de formato de tiempo de PI,
independientemente de los ajustes locales en el ordenador cliente.
PI time asume que todas las cadenas estn en ingls y utilizan el
formato de fecha-hora dd-mmm-yyyy hh:mm:ss.
Borre la casilla para analizar los formatos de fecha-hora conforme
a la configuracin regional de la estacin de trabajo cliente,
recurriendo al formato de tiempo PI solo si es necesario.
Desactivar la visualizacin Seleccione esta casilla para evitar la aparicin automtica del
automtica del panel de tareas panel de tareas de funcin al hacer clic en una celda de funcin.
al hacer clic
Desactivar el mensaje Seleccione esta casilla para no mostrar un mensaje de advertencia
"Redimensionar para mostrar cuando el nmero de valores recuperados por una matriz
todos los valores" recalculada exceda el nmero que una matriz puede mostrar.
Zona horaria de cliente Seleccinela para interpretar las marcas de tiempo de entrada y
mostrar marcas de tiempo de salida en la zona horaria de la
estacin de trabajo cliente. Algunas funciones mostrarn
determinadas marcas de tiempo en la zona horaria del servidor de
Archivo de datos de PI. Consulte Lmites de configuracin de zona
horaria para encontrar ms informacin sobre estas excepciones.
Zona horaria de PI Data Archive Seleccinela para interpretar las marcas de tiempo de entrada y
mostrar marcas de tiempo de salida en la zona horaria del
servidor de Archivo de datos de PI. Este ajuste solo es vlido para
los elementos de datos o las expresiones que contienen un PI
point o un atributo de PI AF, es decir, una referencia de datos de PI
point. Si el elemento de datos o la expresin contienen un atributo
de PI AF que no es una referencia de datos de PI point, PI DataLink
interpreta las marcas de tiempo de entrada y de salida como
dentro de la zona horaria de la estacin de trabajo cliente.
Esta opcin solo tiene importancia si la configuracin de zona
horaria de un servidor de Archivo de datos de PI no coincide con
la de la estacin de trabajo del cliente.
Zona horaria UTC Seleccinela para interpretar las marcas de tiempo de entrada y
mostrar marcas de tiempo de salida en la hora universal
coordinada (UTC). Algunas funciones no admiten esta
configuracin. Consulte Lmites de configuracin de zona horaria
para encontrar ms informacin sobre estas excepciones.
En una fila Seleccione esta opcin para pegar varios resultados de una
bsqueda en una fila de valores en la hoja de clculo.
En una columna Seleccione esta opcin para pegar varios resultados de una
bsqueda en una columna de valores en la hoja de clculo. Valor
predeterminado.

28 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Ajuste Descripcin
Formato de nmero Introduzca el formato para los nmeros en la salida de funcin. La
cadena de formato puede ser cualquier cdigo de formato
numrico vlido de la ventana Formato de Excel (consulte
Formatos de presentacin).
Durante la instalacin, PI DataLink asigna el formato numrico
predeterminado de Excel a este campo, a menos que haya ajustado
su propia preferencia de formato anteriormente en PI DataLink. Si
su versin de Excel se ejecuta con una configuracin regional
diferente, este formato incluye la sintaxis correcta para reflejar la
configuracin. Por ejemplo:
35.03
aparecer como
35,03
en Excel francs.
Formato de hora Introduzca el formato para las marcas de tiempo en la salida de
funcin. La cadena de formato de hora puede ser cualquier cdigo
de formato de fecha-hora vlido de la ventana Formato de Excel.
Durante la instalacin, PI DataLink asigna el formato estndar de
marca de tiempo de PI a este campo, a menos que haya ajustado su
propia preferencia de formato anteriormente en PI DataLink. Si su
versin de Excel se ejecuta con una configuracin regional
diferente, este formato incluye la sintaxis correcta para reflejar la
configuracin. Por ejemplo:
dd-mmm-yy hh:mm:ss
aparecer como
jj-mmm-aa hh:mm:ss
en Excel francs.
Mximo de eventos Introduzca el nmero mximo de eventos que devuelven las
funciones Explorar eventos y Comparar eventos para la vista
previa y a la hoja de clculo.
Mximo de filtros de bsqueda Introduzca el nmero mximo de elementos que devuelve la
funcin Bsqueda de filtro de activo en la hoja de clculo, excepto
cuando se especifica un filtro de valor de atributo para un atributo
con una referencia de datos. En este caso, introduzca el nmero
total de elementos entre los que desea buscar un atributo con una
referencia de datos; tenga en cuenta que si el nmero es
demasiado bajo, la funcin podra devolver menos resultados de
los esperados.
Calcular (F9) Seleccione esta opcin para volver a calcular todas las funciones
voltiles (y las funciones que hagan referencia a ellas) durante
todos los procesos de reclculo que la funcin Actualizacin
automtica inicie. La funcin Valor actual es la nica funcin de PI
DataLink voltil.
Clculo completo (Ctrl+Alt Seleccione esta opcin para volver a calcular todas las funciones,
+Shift+F9) independientemente de la volatilidad, durante todos los procesos
de reclculo que la funcin Actualizacin automtica inicie.
Intervalo (segundos) Introduzca el nmero de segundos entre cada reclculo que la
funcin Actualizacin automtica inicie. El valor mnimo es cinco
segundos. Introduzca 0 para que PI DataLink calcule un intervalo
automtico en funcin de la duracin de los tiempos de clculo
anteriores.

Manual del usuario de PI DataLink 2016 29


Conceptos bsicos

Lmites de configuracin de zona horaria


La configuracin de la zona horaria est restringida a determinados lmites:
La funcin Bsqueda de notificaciones actualmente no es compatible con la configuracin
de zona horaria UTC. La funcin de bsqueda de notificaciones siempre utiliza la zona
horaria del cliente.
Si una anotacin contiene una marca de tiempo, la funcin Datos comprimidos siempre
muestra la marca de tiempo en la zona horaria del servidor de Archivo de datos de PI.
La funcin de propiedades siempre muestra los valores de atributos de PI point que
contienen marcas de tiempo (como la fecha de creacin y la fecha de modificacin) en la
zona horaria del servidor de Archivo de datos de PI.
Las tendencias creadas con el complemento PI DataLink (Legacy) siempre muestran los
datos en la zona horaria del servidor de Archivo de datos de PI.
Las funciones de la base de datos del mdulo de PI DataLink (funcin Alias para tag y
funcin Propiedad para valor) no son compatibles con la configuracin de la zona horaria
UTC. Cuando se selecciona la zona horaria UTC, estas funciones utilizan la zona horaria del
cliente.

Gestionar conexiones con servidores


Utilice el Administrador de conexiones para administrar las conexiones con cualquier servidor
de Archivo de datos de PI o de PI AF, incluida la seleccin del servidor de Archivo de datos de
PI o de PI AF predeterminado.

Procedimiento
1. En la pestaa PI DataLink, en el grupo Recursos, haga clic en Configuracin para abrir la
ventana Configuracin.
2. Haga clic en Administrador de conexiones para abrir la ventana Servidores, que muestra las
conexiones de servidor definidas y el estado actual de esas conexiones, incluidos los
servidores predeterminados.
3. Modifique las conexiones, segn desee:
Haga clic en Aadir servidor de activos para abrir la ventana Propiedades del servidor de
PI AF, donde podr definir una conexin con un servidor de PI AF.
Haga clic en Aadir servidor de datos para abrir la ventana Propiedades de PI Data
Archive, donde podr definir una conexin con un servidor de Archivo de datos de PI.
Seleccione un servidor que no est conectado actualmente y haga clic en Conectar para
conectarse a ese servidor.
Para conectarse a servidores de PI AF, PI DataLink utiliza las credenciales de Windows
del usuario que ha iniciado sesin. Para conectarse con servidores de Archivo de datos de
PI, PI DataLink puede utilizar un PI trust o un usuario predeterminado, adems de las
credenciales de Windows del usuario que ha iniciado sesin.
Seleccione un servidor que no sea actualmente la conexin predeterminada y haga clic en
Establecer como predeterminado para que ese servidor sea la conexin predeterminada
(un servidor de Archivo de datos de PI o de PI AF).

30 Manual del usuario de PI DataLink 2016


Conceptos bsicos

Seleccione un servidor y haga clic en Propiedades para ver las propiedades de conexin
de ese servidor.
Haga clic con el botn derecho en un servidor y haga clic en Eliminar para suprimir la
definicin de conexin con ese servidor.

Manual del usuario de PI DataLink 2016 31


Conceptos bsicos

32 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo
En esta seccin se explica cmo crear hojas de clculo con PI DataLink y algunos tipos
especficos de pantallas que puede crear con PI DataLink. Los temas sobre pantallas incluyen
procedimientos para crear dichas pantallas.

En esta seccin
Proceso de creacin de hojas de clculo
Recuperacin de grandes cantidades de datos
Despliegues relacionados con activos
Eventos en hojas de clculo

Proceso de creacin de hojas de clculo


Una vez familiarizado con los conceptos y herramientas bsicas de PI DataLink, estar
preparado para crear una hoja de clculo que utilice funciones de PI DataLink.

Considere sus objetivos


Hgase estas preguntas:
Qu datos desea mostrar en una hoja de clculo a fin de controlar el rendimiento o
responder a un problema del negocio?
Dnde residen los datos?
Cmo puede mostrar de la forma ms eficaz la informacin, tanto para comunicar puntos
esenciales como para proporcionar el necesario contexto de fondo?
Las respuestas le ayudarn a determinar qu funciones de PI DataLink pueden devolver los
datos ms adecuados para la tarea.

Seleccione un enfoque
Entre las tcnicas que puede utilizar para construir una hoja de clculo estn:
Basada en funciones
Aada la funcin de PI DataLink a la hoja de clculo y cree la presentacin alrededor de
estas funciones segn sea necesario. Por ejemplo, es posible que desee aadir informacin
de punto para que le ayude a aclarar lo que representan los datos. Este puede ser el mejor
enfoque si todava est averiguando cules son sus requisitos o aprendiendo cmo funciona
PI DataLink.
Basado en estructuras
Aada una estructura cuando construya una hoja de clculo. Utilice la herramienta
Bsqueda para insertar elementos de datos que enmarquen el asunto de su hoja de clculo
y, a continuacin, aada funciones para recuperar los datos correspondientes. Este enfoque
requiere algo ms de planificacin y familiaridad con PI DataLink, pero despus de aadir
los elementos de datos a la hoja de clculo, podr utilizarlos para crear funciones ms
fcilmente mediante referencias de celda. De esta forma, podr reutilizar ms fcilmente las
hojas de clculo.
Basado en informes

Manual del usuario de PI DataLink 2016 33


Creacin de hojas de clculo

Coloque las funciones de PI DataLink en la segunda hoja de clculo de un libro y referencie


los resultados de esas funciones en la primera hoja de clculo. Utilice las funciones de
seguridad de Excel para ocultar y proteger la sintaxis de las funciones y la lgica del negocio
en la segunda hoja de clculo de la mayora de usuarios. Este enfoque es til si es un
administrador del sistema o crea hojas de clculo para otros usuarios. Esta estrategia
tambin funciona bien con documentos distribuidos mediante PI DataLink Server.

Consulte tambin
Funciones de PI DataLink
Buscar elementos de datos
PI DataLink Server (DLS)

Recuperacin de grandes cantidades de datos


Para cada elemento de datos de una funcin, PI DataLink debe realizar una llamada a Archivo
de datos de PI o a PI Asset Framework para recuperar los valores. Cuando PI DataLink
recupera los valores de grandes cantidades de elementos de datos, procesar cada llamada por
separado puede derivar en un tiempo de recuperacin largo. Para reducir este tiempo, PI
DataLink realiza llamadas a granel para ciertas funciones en determinadas condiciones.
Deben cumplirse las siguientes condiciones para realizar una llamada a granel:
Las entradas de funcin especifican elementos de datos y no, expresiones o expresiones de
filtro.
La entrada de funcin especifica elementos de datos con una referencia a un rango de
celdas.
Los parmetros de PI DataLink especifican marcas de tiempo en la zona horaria del cliente.
Si se cumplen las condiciones mencionadas, las siguientes funciones pueden realizar llamadas
a granel:
Valor actual
Valor de archivo histrico
Datos calculados (sin intervalo de tiempo especificado)
PI DataLink arroja valores de una llamada a granel en una nica matriz de funcin.
Las llamadas a granel provocan mejoras en el rendimiento cuando las funciones recuperan
valores para ms de 1000 elementos de datos o en entornos con demoras entre PI DataLink y
las fuentes de datos. Cuando las funciones recuperan valores para ms de 10 000 elementos de
datos, las llamadas a granel reducen el tiempo de recuperacin por un orden de magnitud. Por
lo tanto, cuando crea hojas de clculo que recuperan valores para grandes cantidades de
elementos de datos, evale la posibilidad de utilizar estas funciones en las condiciones
requeridas.

Despliegues relacionados con activos


Los despliegues relacionados con activos muestran los valores de un conjunto de atributos de
PI AF junto con el correspondiente activo (un elemento de PI AF). Puede seleccionar un activo
diferente para mostrar los valores de ese activo.

34 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Despliegue relativo a activos para el elemento React1

Despliegue relativo a activos para el elemento React2

Los despliegues relativos a activos requieren un conjunto comn de nombres de atributo para
los activos. Por ejemplo, para crear un despliegue relativo a activos, puede utilizar elementos
de PI AF en base al mismo elemento y plantillas de atributo.

Crear un despliegue relacionado con activos


Para crear un despliegue relativo a activos, inserte un conjunto de elementos de datos que
tenga una estructura comn en la hoja de clculo con una lista desplegable de rutas raz y, a
continuacin, aada una funcin de PI DataLink que haga referencia a esas celdas. Una vez
creado el despliegue relativo a activos, puede seleccionar un activo diferente en la lista para
ver los valores de atributo de ese activo.

Procedimiento
1. Insertar un conjunto de elementos de datos con una estructura comn en la hoja de clculo.
2. Configurar una funcin de PI DataLink que haga referencia a los elementos de datos
insertados.

Consulte tambin
Buscar elementos de datos

Insertar un conjunto de elementos de datos con una estructura comn


en la hoja de clculo
Los despliegues relativos a activos requieren que la hoja de clculo contenga un conjunto de
elementos de datos (atributos de PI AF) que tengan una estructura comn junto con una lista
desplegable de rutas raz para esos elementos de datos.

Procedimiento
1. Seleccione una celda en la hoja de clculo donde va a insertar los elementos de datos.
2. En la pestaa PI DataLink, haga clic en Buscar para abrir la herramienta de bsqueda.

Manual del usuario de PI DataLink 2016 35


Creacin de hojas de clculo

3. Defina el mbito de la bsqueda, especifique los elementos de datos que desea encontrar y
haga clic en Buscar .

En el caso de los despliegues relativos a activos, es posible que desee localizar atributos de
PI AF que tengan un elemento principal comn y la misma estructura de atributos. Estos
atributos podran tener la misma plantilla de atributos. Por ejemplo, es posible que desee
localizar todos los reactores de sus instalaciones.
4. Divida las rutas de los elementos de datos para que los activos a visualizar aparezcan en la
columna Ruta raz.
Desplace el control deslizante Longitud de elemento de datos hasta que la columna Ruta
raz muestre los elementos exclusivos de los atributos enumerados. Por lo general,
coincidir exactamente con el valor Solo nombre o estar muy prximo a l.

5. Seleccione los elementos de datos que desee insertar en la hoja de clculo.


6. En Insertar rutas raz en, seleccione Lista desplegable.
7. Haga clic en Aceptar.
PI DataLink inserta los elementos de datos exclusivos en la hoja de clculo debajo de una
lista desplegable que contiene los activos exclusivos (procedentes de la columna de ruta
raz).

Nota:
PI DataLink inserta la lista de rutas raz en la columna ALL de la hoja de clculo. Si esa
columna contiene datos, PI DataLink inserta las rutas en la siguiente columna
disponible a la derecha.

36 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Configurar una funcin de PI DataLink que haga referencia a los


elementos de datos insertados
Los despliegues relativos a activos exigen que configure una funcin de PI DataLink para
obtener datos para los elementos de datos y la ruta raz que ha insertado en la hoja de clculo:
un conjunto de elementos de datos con una estructura comn y la ruta raz de esa estructura.

Procedimiento
1. Haga clic en la celda de la hoja de clculo situada junto al primer elemento de datos del
intervalo que ha insertado.
2. En la pestaa PI DataLink, haga clic en la funcin que desee utilizar para obtener valores.
El panel de tareas de funcin se abre en la celda pulsada especificada en Celda de salida.
3. En el panel de tareas de funcin, haga clic en el campo Elemento(s) de datos y, a
continuacin, seleccione el intervalo de hojas de clculo que contenga los elementos de
datos que ha insertado.
PI DataLink inserta el intervalo de celdas en el campo.
4. En el panel de tareas de funcin, haga clic en el campo Ruta raz y, a continuacin, seleccione
la celda de hoja de clculo que contenga la lista desplegable de rutas raz.
PI DataLink inserta una referencia de celda en el campo.
5. Especifique otras entradas de funcin, segn desee.
6. Haga clic en Aceptar para insertar la matriz de funcin en la hoja de clculo.
Puede seleccionar un activo diferente en la lista para ver los valores de atributo de ese
activo.

Puede seleccionar un activo diferente en la lista para ver los valores de atributo de ese
activo.

Eventos en hojas de clculo


Puede utilizar PI DataLink para crear pantallas para ver, entender y analizar los eventos
almacenados en PI AF. La configuracin del sistema y el tipo de datos que se recopilan
determinan qu eventos almacena el sistema. Por ejemplo, el sistema puede tener eventos que
almacenan informacin sobre procesos por lotes o eventos creados a partir de clculos.
Puede utilizar dos funciones de PI DataLink para recuperar eventos:

Funcin Explorar eventos


La funcin Explorar eventos devuelve un evento por fila y resulta til para explorar eventos
en cualquier posicin de la jerarqua de eventos. Puede utilizar la funcin Explorar eventos
para examinar los datos en una jerarqua sencilla, por ejemplo, para analizar los eventos de
un elemento concreto. Pongamos que quiere examinar el tiempo de inactividad de una
caldera determinada.

Manual del usuario de PI DataLink 2016 37


Creacin de hojas de clculo

Explorar los eventos relacionados con un elemento

Tambin puede utilizar la funcin Explorar eventos para examinar los eventos en una
jerarqua completa, por ejemplo para analizar los eventos secundarios de un tipo de evento.
(La plantilla de eventos suele indicar el tipo de evento). Pongamos que quiere examinar las
fases de inicio de las turbinas.

Explorar eventos con eventos secundarios

Funcin Comparar eventos


La funcin Comparar eventos puede devolver atributos de eventos relacionados en una
nica fila y resulta til para comparar eventos jerrquicos. En las pantallas creadas con la
funcin Comparar eventos, cada fila puede mostrar un evento recuperado junto con
informacin de los eventos secundarios y primarios de dicho evento. La inclusin de esta
informacin puede ayudarle a comparar los eventos recuperados. Por ejemplo, incluir
informacin sobre los eventos de fase de un evento de inicio puede ayudarle a comparar
mltiples eventos de inicio.
La funcin Comparar eventos identifica los atributos por ruta. Por lo tanto, la visualizacin
depende de los nombres de atributo y su posicin jerrquica. Las capacidades de la funcin
difieren segn la estructura de los eventos y sus atributos:

Eventos que tienen eventos secundarios con nombres idnticos


Si tiene un conjunto de eventos que incluye eventos secundarios con nombres idnticos,
puede comparar dichos eventos incluyendo informacin del evento secundario e
informacin del evento primario. Especifique los criterios para localizar los eventos con
eventos secundarios con nombres idnticos. La funcin Comparar eventos puede incluir
informacin sobre eventos secundarios en la misma fila que cada evento coincidente. Por
ejemplo, puede comparar eventos de inicio de turbina que tienen eventos de fase con
nombres idnticos, como Phase1, Phase2 y Phase3.

Comparacin de eventos mediante la inclusin de informacin de eventos secundarios

La funcin Comparar eventos tambin puede incluir informacin sobre eventos


primarios en la misma fila que un evento coincidente. Puede incluir informacin del
evento principal para tener ms datos sobre los eventos coincidentes. Por ejemplo, para
los eventos de inicio de turbina coincidentes, la informacin sobre el evento de proceso
principal mejorara la comparacin.

38 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Comparacin de eventos mediante la inclusin de informacin de eventos secundarios y de


eventos primarios

Eventos que tienen eventos secundarios con nombres diferentes


Si tiene un conjunto de eventos que incluye eventos secundarios con nombres diferentes,
solo puede comparar eventos incluyendo la informacin del evento primario. Especifique
los criterios para localizar los eventos de nivel inferior en la jerarqua. La funcin
Comparar eventos puede incluir informacin sobre eventos principales en la misma fila
que cada evento coincidente. Por ejemplo, supongamos que tiene eventos de primera
fase con nombres distintos, como Phase1, P1, PhaseX y PhaseA. Puede comparar los
eventos de fase e incluir informacin sobre el evento de inicio principal.

Comparacin de eventos mediante la inclusin de informacin de eventos principales

En esta seccin
Explorar los eventos relacionados con un elemento
Explorar eventos con eventos secundarios
Comparacin de eventos mediante la inclusin de eventos secundarios
Comparacin de eventos mediante la inclusin de eventos principales
Nombres de atributo reservados

Explorar los eventos relacionados con un elemento


Puede utilizar la funcin Explorar eventos para explorar y analizar los eventos relacionados
con un elemento de PI AF concreto. Pongamos, por ejemplo, que quiere analizar el tiempo de
inactividad de una caldera determinada. Puede recuperar todos los eventos de inactividad de
esa caldera en Microsoft Excel y crear un grfico para analizar los datos. En ese caso, podra
encontrar eventos que coincidan con un nombre de elemento y un nombre de evento.

Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Events (Eventos), haga clic en Explore (Explorar)
para abrir el panel de tareas Explore events (Explorar eventos).
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Preview (Vista previa) se actualizar para mostrar los
eventos que coincidan con los criterios introducidos.
a. En el campo Database (Base de datos), introduzca la base de datos de PI AF que
almacena los eventos.

Manual del usuario de PI DataLink 2016 39


Creacin de hojas de clculo

Especifique en el formato \\ServerName\DatabaseName. Haga clic en el campo para


abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Search start (Inicio de bsqueda) y Search end (Fin de bsqueda)
especifican el perodo de tiempo en el que buscar eventos activos.
Introduzca una expresin de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el ltimo mes, introduzca *-1mo en el campo Search start y * en el campo
Search end.
Consejo:
Para localizar eventos que tengan una relacin ms especfica con este perodo de
tiempo, como eventos iniciados o finalizados durante este perodo de tiempo,
expanda More search options (Ms opciones de bsqueda) y seleccione un mtodo
alternativo de la lista Search mode (Modo de bsqueda).
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
funcin (que se muestran en la lista Preview).
Consulte Referencia del panel de tareas Explorar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Event name (Nombre de evento) para limitar los eventos
devueltos a aquellos con un nombre determinado. Puede introducir *shut* para
encontrar todos los eventos que contienen shut en el nombre, como shutdown y
BoilerShutdown. Si acepta la entrada predeterminada, *, la funcin encontrar eventos
con distintos nombres.
Por ejemplo, utilice el campo Element name (Nombre de elemento) para limitar los
eventos devueltos a aquellos asociados con elementos determinados. Puede introducir
Boiler5 para analizar los eventos asociados con esa caldera.
4. Especifique la salida de la hoja de clculo:
a. En la lista Columns to display (Columnas para mostrar), seleccione las columnas que
desee incluir en la matriz de funcin y defina el orden de las columnas.
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:
Marcar la casilla Seleccionar todo para incluir todos los atributos enumerados como
columnas en la matriz de funcin arrojada.
Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de funcin devuelta.
Haga clic en para abrir la ventana Aadir atributos donde puede seleccionar
atributos adicionales para incluir como columnas en la matriz de funcin. Consulte
Aadir columnas de atributos al panel de tareas Explorar eventos.
Escriba el nombre de un atributo de evento junto a la casilla en blanco del final de la
lista.
Haga clic con el botn derecho sobre un atributo, haga clic en Insertar atributo para
insertar un atributo en blanco sobre el atributo seleccionado y, a continuacin, escriba
el nombre de un atributo de evento.
Seleccione un atributo y haga clic en para mover el atributo hacia arriba en la
lista.
Seleccione un atributo y haga clic en para mover el atributo hacia abajo en la lista.

40 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Seleccione un atributo y haga clic en para eliminar el atributo de la lista.

Haga clic con el botn derecho sobre un atributo y luego haga clic en Eliminar atributo
para eliminar el atributo de la lista.
Si la longitud de los nombres de columnas seleccionados supera los 759 caracteres, la
funcin no podr procesar las columnas de manera individual. En ese caso, el panel de
tareas le pedir que especifique todas las columnas como un grupo. Cuando se
especifican todas las columnas como un grupo, la lista dice All event attributes and
template attributes (Todos los atributos de evento y de plantilla) y la matriz de funcin
devuelta incluye todos los atributos predeterminados y sus atributos secundarios, pero
ninguno de los atributos adicionales que ha especificado.
b. Compruebe que el campo Output cell (Celda de salida) contiene la celda de la hoja de
clculo en la que desea insertar la esquina superior izquierda de la matriz de funcin.
Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automticamente la celda en este campo.
5. Haga clic en OK (Aceptar) para insertar la matriz de funcin en la hoja de clculo.

Qu hacer a continuacin
Utilice las funciones de Excel para analizar los datos. Puede crear un grfico, por ejemplo.

Aadir columnas de atributos al panel de tareas Explorar eventos


Utilice la ventana Aadir atributos para aadir atributos de eventos a la lista Aadir atributos
en el panel de tareas Explorar eventos. Seguidamente podr incluir dichos atributos en la matriz
de funcin insertada en la hoja de clculo.

Antes de empezar
Abra el panel de tareas Explorar eventos y especifique los eventos que desea recuperar en la
hoja de clculo.

Procedimiento
1. Haga clic en , junto a la lista Columnas para mostrar en el panel de tareas, para abrir la
ventana Aadir atributos.
La ventana muestra una lista con los eventos que cumplen los criterios especificados en ese
momento en el panel de tareas.
2. Expanda un evento para ver los atributos de evento guardados para ese evento.
Puede incluir cualquier atributo de evento como una columna en la matriz de funcin.
Cuando en la matriz de funcin se incluye una columna de atributos, esta muestra los
valores guardados para un evento.
3. Seleccione la casilla que aparece junto al atributo que desee aadir a la lista Columnas para
mostrar en el panel de tareas.
La funcin Explorar eventos identifica los atributos por nombre. Un nombre de atributo y
evento define de forma exclusiva un valor. Por lo tanto, solo es necesario aadir un atributo
concreto una sola vez. Cuando se selecciona un atributo, la ventana selecciona
automticamente ese atributo cada vez que aparece en la jerarqua del evento.

Manual del usuario de PI DataLink 2016 41


Creacin de hojas de clculo

Nota:
PI DataLink no sincroniza las selecciones de esta ventana con la lista Columnas para
mostrar en el panel de tareas. En esta ventana, puede seleccionar un atributo ya
disponible o seleccionado en la lista de columnas del panel de tareas; de esta forma,
podr aadir el mismo atributo varias veces a la lista de columnas del panel de tareas.
4. Haga clic en Aceptar para insertar el atributo en la lista Columnas para mostrar y
seleccionar esa columna.

Explorar eventos con eventos secundarios


Puede usar la funcin Explorar eventos para analizar los eventos con eventos secundarios
examinndolos en un formato jerrquico. Supongamos, por ejemplo, que desea analizar las
fases de inicio de las turbinas y ha configurado cada fase como evento secundario de un evento
global de inicio. Puede recuperar todos los eventos de inicio de turbina junto con sus eventos
secundarios (los eventos de fase) en Microsoft Excel y, posteriormente, analizar los datos. En
ese caso, puede recuperar los eventos por plantilla de eventos.

Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Events (Eventos), haga clic en Explore (Explorar)
para abrir el panel de tareas Explore events (Explorar eventos).
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Preview (Vista previa) se actualizar para mostrar los
eventos que coincidan con los criterios introducidos.
a. En el campo Database (Base de datos), introduzca la base de datos de PI AF que
almacena los eventos.
Especifique en el formato \\ServerName\DatabaseName. Haga clic en el campo para
abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Search start (Inicio de bsqueda) y Search end (Fin de bsqueda)
especifican el perodo de tiempo en el que buscar eventos activos.
Introduzca una expresin de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el ltimo mes, introduzca *-1mo en el campo Search start y * en el campo
Search end.
Consejo:
Para localizar eventos que tengan una relacin ms especfica con este perodo de
tiempo, como eventos iniciados o finalizados durante este perodo de tiempo,
expanda More search options (Ms opciones de bsqueda) y seleccione un mtodo
alternativo de la lista Search mode (Modo de bsqueda).
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
funcin (que se muestran en la lista Preview).
Consulte Referencia del panel de tareas Explorar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Event template (Plantilla de eventos) para limitar los eventos
devueltos a aquellos que estn basados en una plantilla de evento determinada. Puede
seleccionar la plantilla TurbineStartUp para analizar los eventos de inicio de la turbina.
4. Especifique la salida de la hoja de clculo:

42 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

a. En la lista Columns to display (Columnas para mostrar), seleccione las columnas que
desee incluir en la matriz de funcin y defina el orden de las columnas.
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:
Marcar la casilla Seleccionar todo para incluir todos los atributos enumerados como
columnas en la matriz de funcin arrojada.
Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de funcin devuelta.
Haga clic en para abrir la ventana Aadir atributos donde puede seleccionar
atributos adicionales para incluir como columnas en la matriz de funcin. Consulte
Aadir columnas de atributos al panel de tareas Explorar eventos.
Escriba el nombre de un atributo de evento junto a la casilla en blanco del final de la
lista.
Haga clic con el botn derecho sobre un atributo, haga clic en Insertar atributo para
insertar un atributo en blanco sobre el atributo seleccionado y, a continuacin, escriba
el nombre de un atributo de evento.
Seleccione un atributo y haga clic en para mover el atributo hacia arriba en la
lista.
Seleccione un atributo y haga clic en para mover el atributo hacia abajo en la lista.

Seleccione un atributo y haga clic en para eliminar el atributo de la lista.

Haga clic con el botn derecho sobre un atributo y luego haga clic en Eliminar atributo
para eliminar el atributo de la lista.
Si la longitud de los nombres de columnas seleccionados supera los 759 caracteres, la
funcin no podr procesar las columnas de manera individual. En ese caso, el panel de
tareas le pedir que especifique todas las columnas como un grupo. Cuando se
especifican todas las columnas como un grupo, la lista dice All event attributes and
template attributes (Todos los atributos de evento y de plantilla) y la matriz de funcin
devuelta incluye todos los atributos predeterminados y sus atributos secundarios, pero
ninguno de los atributos adicionales que ha especificado.
b. En la lista Number of child event levels (Nmero de niveles de eventos secundarios),
seleccione el nmero de niveles de eventos secundarios que deben incluirse en la matriz
de funcin.
Seleccione 0 para no recuperar eventos secundarios y seleccione 1 para recuperar
eventos secundarios del primer nivel (es decir, los eventos inmediatamente por debajo
de los eventos coincidentes) y sucesivos. Puede identificar eventos con eventos
secundarios en la lista Preview mediante un + junto al nombre del evento. Los eventos
secundarios no deben coincidir con los criterios especificados.
La funcin aade una columna por cada nivel recuperado. Al recuperar eventos
secundarios, la funcin inserta cada evento secundario en una fila independiente. En las
filas que contienen eventos secundarios, la columna aadida contiene el nombre del
evento secundario.
c. Compruebe que el campo Output cell (Celda de salida) contiene la celda de la hoja de
clculo en la que desea insertar la esquina superior izquierda de la matriz de funcin.

Manual del usuario de PI DataLink 2016 43


Creacin de hojas de clculo

Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automticamente la celda en este campo.
5. Haga clic en OK (Aceptar) para insertar la matriz de funcin en la hoja de clculo.

Comparacin de eventos mediante la inclusin de eventos secundarios


Puede utilizar la funcin Comparar eventos para comparar eventos que tienen eventos
secundarios con los mismos nombres. La funcin Comparar eventos identifica los atributos por
ruta. Por lo tanto, la funcin puede devolver atributos de eventos relacionados en una nica
fila. Por ejemplo, supongamos que tiene eventos de inicio de turbina que incluyen eventos de
fase (eventos secundarios que tienen lugar durante el evento de inicio). Con la funcin
Comparar eventos, puede presentar una fila para cada evento de inicio y mostrar los valores de
las fases correspondientes en columnas separadas dentro de cada fila. Puede utilizar esta
matriz de funcin devuelta para comparar fcilmente los eventos de inicio.

Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Events, haga clic en Compare (Comparar) para abrir
el panel de tareas Compare Events (Comparar eventos).
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Preview (Vista previa) se actualizar para mostrar los
eventos que coincidan con los criterios introducidos.
a. En el campo Database (Base de datos), introduzca la base de datos de PI AF que
almacena los eventos.
Especifique en el formato \\ServerName\DatabaseName. Haga clic en el campo para
abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Search start (Inicio de bsqueda) y Search end (Fin de bsqueda)
especifican el perodo de tiempo en el que buscar eventos activos.
Introduzca una expresin de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el ltimo mes, introduzca *-1mo en el campo Search start y * en el campo
Search end.
Consejo:
Para localizar eventos que tengan una relacin ms especfica con este perodo de
tiempo, como eventos iniciados o finalizados durante este perodo de tiempo,
expanda More search options (Ms opciones de bsqueda) y seleccione un mtodo
alternativo de la lista Search mode (Modo de bsqueda).
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
funcin (que se muestran en la lista Preview).
Consulte Referencia del panel de tareas Comparar eventos para acceder a una lista
completa de campos disponibles.

44 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Por ejemplo, utilice la lista Event template (Plantilla de eventos) para limitar los eventos
devueltos a aquellos que estn basados en una plantilla de evento determinada. Puede
seleccionar la plantilla TurbineStartUp para analizar los eventos de inicio de la turbina.
4. Utilice la lista Columns to display para especificar las columnas en la matriz de funcin
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 funcin identifica los atributos por ruta. Consulte
Notacin de ruta para la funcin Comparar eventos para obtener informacin sobre las
notaciones de ruta admitidas.

a. Haga clic en para abrir la ventana Aadir atributos, donde puede seleccionar los
atributos de eventos secundarios que desea comparar entre eventos principales.
Consulte Aadir atributos de eventos secundarios como columnas en el panel de tareas
Comparar eventos.
b. Inserte todos los atributos de eventos principales que desea incluir en la matriz de
funcin.
Consulte Aadir atributos de eventos principales como columnas en el panel de tareas
Comparar eventos.
c. Seleccione las columnas que desea incluir en la matriz de funcin y defina el orden de las
columnas.
Puede:
Marcar la casilla Seleccionar todo para incluir todos los atributos enumerados como
columnas en la matriz de funcin arrojada.
Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de funcin devuelta.
Escriba el nombre de un atributo de evento junto a la casilla en blanco del final de la
lista.
Seleccione un atributo y haga clic en para mover el atributo hacia arriba en la
lista.
Seleccione un atributo y haga clic en para mover el atributo hacia abajo en la lista.

Seleccione un atributo y haga clic en para eliminar el atributo de la lista.

Haga clic con el botn derecho sobre un atributo y luego haga clic en Eliminar atributo
para eliminar el atributo de la lista.
5. Compruebe que el campo Output cell (Celda de salida) contiene la celda de la hoja de clculo
en la que desea insertar la esquina superior izquierda de la matriz de funcin.
Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automticamente la celda en este campo.
6. Haga clic en OK (Aceptar) para insertar la matriz de funcin en la hoja de clculo.

Manual del usuario de PI DataLink 2016 45


Creacin de hojas de clculo

Aadir atributos de eventos secundarios como columnas en el panel de


tareas Comparar eventos
Utilice la ventana Aadir atributos para aadir atributos de eventos secundarios a la lista
Columnas para mostrar en el panel de tareas Comparar eventos. (Puede incluir dichas columnas
en la matriz de funcin insertada en la hoja de clculo). Tras especificar los criterios de los
eventos en el panel de tareas, esta ventana muestra los eventos coincidentes y sus eventos
secundarios. Puede utilizar esta ventana para aadir cualquier atributo de evento de estos
eventos. Normalmente, esta ventana se utiliza para aadir atributos de eventos secundarios
que le ayudarn a comparar los eventos coincidentes.

Antes de empezar
Abra el panel de tareas Comparar eventos y especifique los eventos que desea recuperar en la
hoja de clculo.

Procedimiento
1. Haga clic en , junto a la lista Columnas para mostrar en el panel de tareas, para abrir la
ventana Aadir atributos.
La ventana muestra una lista con los eventos que cumplen los criterios especificados en ese
momento en el panel de tareas.
2. Expanda un evento para ver los atributos de evento guardados para ese evento junto con los
eventos secundarios.
Si dos o ms eventos secundarios comparten el mismo nombre, PI DataLink aade
automticamente un ndice al nombre del evento secundario. Para crear el ndice, PI
DataLink clasifica dichos eventos por hora de inicio ascendente, seguidamente por hora
final ascendente y finalmente por identificador ascendente.

Evento con dos eventos secundarios con el nombre Phase1

Puede incluir cualquier atributo de evento como una columna en la matriz de funcin.
Cuando se incluye una columna en la matriz de funcin, dicha columna muestra los valores
guardados para el atributo de evento.
3. Seleccione la casilla que aparece junto al atributo que desee aadir a la lista Columnas para
mostrar en el panel de tareas.
La funcin Comparar eventos identifica los atributos por nombre y ruta en relacin con el
evento coincidente. Por ejemplo, supongamos que selecciona el atributo Hora de inicio
bajo un evento coincidente y bajo su evento secundario.

46 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Seleccin de atributo de hora de inicio de evento coincidente y secundario

Se aaden dos columnas:


.|Start time
En la hoja de clculo, esta columna contiene la hora de inicio del evento coincidente que
aparece en cada fila.
.\Phase1|Start time
En la hoja de clculo, esta columna contiene la hora de inicio del evento secundario
Phase1 del evento coincidente que aparece en cada fila.

Hoja de clculo con columna de atributo secundario

Puede aadir atributos desde cualquier lugar de la jerarqua. La ventana no sincroniza las
selecciones: si la ruta y el nombre de atributo coinciden, puede aadir el mismo atributo
ms de una vez.
Si las jerarquas de evento de los eventos no son coherentes, preste atencin cuando
seleccione atributos de eventos secundarios. Si un evento contiene mltiples eventos
secundarios con el mismo nombre, seleccione los atributos bajo un evento secundario
duplicado (es decir, un evento secundario indexado) para asegurarse de que puede ver los
datos de todos los eventos. Por ejemplo, supongamos que selecciona el atributo Hora de
inicio bajo un evento secundario duplicado (el evento secundario Phase1[1] del evento
TurbineStartUp.1.2) y un evento secundario no duplicado (el evento secundario Phase1
del evento TurbineStartUp.3.2).

Manual del usuario de PI DataLink 2016 47


Creacin de hojas de clculo

Seleccin del atributo de hora de inicio de evento secundario duplicado y evento secundario no
duplicado

Se aaden dos columnas que ofrecen resultados diferentes:


.\Phase1[1]|Start time
En la hoja de clculo, esta columna contiene la hora de inicio del primer evento
secundario Phase1 del evento coincidente que aparece en cada fila. Si el evento
coincidente solo tiene un evento secundario con este nombre, la columna muestra la hora
de inicio de dicho evento en esta columna.
.\Phase1|Start time
En la hoja de clculo, esta columna contiene la hora de inicio del nico evento secundario
Phase1 del evento coincidente que aparece en cada fila. Si el evento coincidente tiene
ms de un evento secundario con este nombre, la columna indica Duplicate event
exists: specify index for Phase1.

Hoja de clculo con atributo secundario indexado y no indexado

El atributo indexado garantiza la obtencin de los datos deseados.


4. Haga clic en Aceptar para insertar el atributo en la lista Columnas para mostrar y
seleccionar esa columna.

48 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Aadir atributos de eventos principales como columnas en el panel de


tareas Comparar eventos
Para poder comparar mejor los eventos en una hoja de clculo, puede incluir columnas que
contengan informacin sobre los eventos principales de los eventos coincidentes. Utilice la lista
Columnas para mostrar del panel de tareas Comparar eventos para insertar atributos de
eventos principales (y sus eventos principales o cualquier evento con un nivel superior en la
jerarqua).
Nota:
La funcin Comparar eventos no recupera datos de atributos de eventos principales para
aquellos eventos con relaciones definidas mediante referencias marco de eventos.

Antes de empezar
Abra el panel de tareas Comparar eventos y especifique los eventos que desea recuperar en la
hoja de clculo.

Procedimiento
1. En la lista Columnas para mostrar del panel de tareas Comparar eventos, aada atributos de
evento principal utilizando el mtodo apropiado para el atributo:
Para insertar: Proceda as:
El mismo nombre de a. Haga clic con el botn derecho en el atributo y seleccione Clonar
atributo en el nivel para evento principal.
principal
PI DataLink inserta el atributo de evento principal del mismo
nombre encima del atributo seleccionado.
Por ejemplo, si hace clic con el botn derecho en el atributo .|
Nombre de evento (el atributo Nombre de evento del evento
coincidente) y hace clic en Clonar para evento principal, PI DataLink
inserta el atributo ..|Nombre de evento (el atributo Nombre de
evento del evento principal).

Puede repetir la operacin para aadir el mismo atributo de eventos


situados ms arriba en la jerarqua. Por ejemplo, si hace clic con el
botn derecho en el atributo ..|Nombre de evento y hace clic en
Clonar para evento principal, PI DataLink inserta el atributo ..\..|
Nombre de evento (el atributo Nombre de evento del evento
primario principal).

Manual del usuario de PI DataLink 2016 49


Creacin de hojas de clculo

Para insertar: Proceda as:


Nombre de atributo a. Haga clic con el botn derecho del ratn en el atributo sobre el que
nico desea insertar el atributo de evento principal y, a continuacin, haga
clic en Insertar atributo.
PI DataLink inserta un atributo en blanco en el nivel de evento
primario (.|).
b. Introduzca la ruta y el nombre correctos del atributo de evento
principal.
Por ejemplo, para incluir el atributo Tipo del evento principal,
introduzca ..|Tipo.

Para obtener informacin sobre la sintaxis de la ruta, consulte Notacin de ruta para la
funcin Comparar eventos.

Comparacin de eventos mediante la inclusin de eventos principales


Puede utilizar la funcin Comparar eventos para presentar informacin sobre eventos
principales en la misma fila que un evento. Puede utilizar esta capacidad para comparar
cualquier evento de jerarquas coincidentes, incluidos eventos con nombres diferentes. Por
ejemplo, supongamos que tiene eventos de inicio de turbina que incluyen eventos de fase, pero
algunos eventos de fase tienen nombres diferentes. Con la funcin Comparar eventos, puede
devolver una fila para cada evento de fase y mostrar los valores del evento principal en
columnas separadas dentro de cada fila de evento de fase. La informacin devuelta puede
ayudarle a comparar eventos de fase.

Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Events, haga clic en Compare (Comparar) para abrir
el panel de tareas Compare Events (Comparar eventos).
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Preview (Vista previa) se actualizar para mostrar los
eventos que coincidan con los criterios introducidos.
a. En el campo Database (Base de datos), introduzca la base de datos de PI AF que
almacena los eventos.
Especifique en el formato \\ServerName\DatabaseName. Haga clic en el campo para
abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Search start (Inicio de bsqueda) y Search end (Fin de bsqueda)
especifican el perodo de tiempo en el que buscar eventos activos.
Introduzca una expresin de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el ltimo mes, introduzca *-1mo en el campo Search start y * en el campo
Search end.

50 Manual del usuario de PI DataLink 2016


Creacin de hojas de clculo

Consejo:
Para localizar eventos que tengan una relacin ms especfica con este perodo de
tiempo, como eventos iniciados o finalizados durante este perodo de tiempo,
expanda More search options (Ms opciones de bsqueda) y seleccione un mtodo
alternativo de la lista Search mode (Modo de bsqueda).
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
funcin (que se muestran en la lista Preview).
Consulte Referencia del panel de tareas Comparar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Event template (Plantilla de eventos) para limitar los eventos
devueltos a aquellos que estn basados en una plantilla de evento determinada. Puede
seleccionar la plantilla StartUpPhase1 para analizar los eventos de inicio de primera
fase.
4. Utilice la lista Columns to display para especificar las columnas en la matriz de funcin
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 funcin identifica los atributos por ruta. Consulte
Notacin de ruta para la funcin Comparar eventos para obtener informacin sobre las
notaciones de ruta admitidas.

a. Inserte los atributos de eventos principales que desea incluir en la matriz de funcin.
Consulte Aadir atributos de eventos principales como columnas en el panel de tareas
Comparar eventos.
Por ejemplo, puede hacer clic con el botn derecho en algunos de los atributos virtuales
y, a continuacin, hacer clic en Clonar para evento principal para insertar los
correspondientes atributos de evento principal, como:
..|Nombre del evento
..|Hora de inicio
..|Elemento primario
b. Seleccione los atributos que desea incluir como columnas en la matriz de funcin y
defina el orden de las columnas.
Puede:
Marcar la casilla Seleccionar todo para incluir todos los atributos enumerados como
columnas en la matriz de funcin arrojada.
Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de funcin devuelta.
Escriba el nombre de un atributo de evento junto a la casilla en blanco del final de la
lista.
Seleccione un atributo y haga clic en para mover el atributo hacia arriba en la
lista.
Seleccione un atributo y haga clic en para mover el atributo hacia abajo en la lista.

Seleccione un atributo y haga clic en para eliminar el atributo de la lista.

Haga clic con el botn derecho sobre un atributo y luego haga clic en Eliminar atributo
para eliminar el atributo de la lista.

Manual del usuario de PI DataLink 2016 51


Creacin de hojas de clculo

5. Compruebe que el campo Output cell (Celda de salida) contiene la celda de la hoja de clculo
en la que desea insertar la esquina superior izquierda de la matriz de funcin.
Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automticamente la celda en este campo.
6. Haga clic en OK (Aceptar) para insertar la matriz de funcin en la hoja de clculo.

Nombres de atributo reservados


PI DataLink genera automticamente algunos atributos virtuales para eventos y utiliza los
nombres reservados para identificar estos atributos virtuales. Para evitar conflictos con
atributos definidos por eventos, no defina eventos que utilicen los siguientes nombres
reservados como nombres de atributo.
Acknowledged by
Acknowledged date
Annotations
Duracin
Plantilla de elementos
Hora de finalizacin
Categoras de evento
Nombre de evento
Ruta de evento
Plantilla de eventos
Is acknowledged
Elemento primario
Ruta de elemento primario
Severity
Hora de inicio

52 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink
Las funciones de PI DataLink permiten consultar cualquier servidor de Archivo de datos de PI o
de PI AF, aplicar clculos a los resultados obtenidos y mostrar valores en celdas de hojas de
clculo. Al igual que otras funciones de Excel, los resultados de las funciones de PI DataLink se
muestran en matrices,que pueden ser recalculadas para mostrar valores actualizados segn se
necesite Utilice los paneles de tareas de funcin para definir entradas de funciones de PI
DataLink y pegarlas en una hoja de clculo.
Las descripciones de funciones de este apartado describen entradas especficas de cada
funcin.

Consulte tambin
Paneles de tareas de funciones
Matrices de funcin
Referencia de funcin

En esta seccin
Funcin Valor actual
Funcin Valor de archivo histrico
Funcin Datos comprimidos
Funcin Datos de muestra
Funcin Datos temporizados
Funcin Datos calculados
Funcin Filtrado de tiempo
Funcin Explorar eventos
Funcin Comparar eventos
Funcin de bsqueda de filtro de activo
Funcin Propiedades

Funcin Valor actual


La funcin Valor actual arroja el valor ms reciente de un PI point histrico o de un atributo de
PI AF. Para un PI point de datos futuros, el valor arrojado depende de las marcas de tiempo de
los valores registrados relacionados con la hora actual:
Si todos los valores registrados tienen marcas de tiempo anteriores a la hora actual, la
funcin arroja el ltimo valor registrado.
Si los valores registrados tienen marcas de tiempo que abarcan la hora actual, la funcin
arroja un valor interpolado.
Si todos los valores registrados tienen marcas de tiempo posteriores a la hora actual, la
funcin no arroja datos.
El valor actual es una funcin voltil: la funcin vuelve a calcular los valores y los actualiza
siempre que Excel calcula o vuelve a calcular una celda en la hoja de clculo. Para forzar un
reclculo inmediato, pulse F9.
Esta funcin admite llamadas a granel.

Manual del usuario de PI DataLink 2016 53


Funciones de PI DataLink

Entrada Descripcin
Ruta raz La ruta comn a elementos de datos especificados. Las entradas vlidas
incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.
Elemento(s) de datos Uno o varios nombres de PI point o nombres de atributos de PI AF para los
que la funcin arroja valores.
Incluya un rango de celdas que contengan nombres de PI point o de atributos
de PI AF para arrojar valores para cada uno de ellos.
Necesario.
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.
Sin marca de tiempo Haga clic en esta opcin para obtener solo valores. La funcin devuelve
valores en una columna para una columna de elementos de datos
referenciados o devuelve valores en una fila para una fila de elementos de
datos referenciados.
Tiempo a la izquierda Haga clic en esta opcin para arrojar dos columnas: la marca de tiempo en la
columna izquierda y el valor en la columna derecha.
Tiempo en la parte Haga clic en esta opcin para arrojar dos filas: la marca de tiempo en la fila
superior superior y el valor en la fila inferior.

Consulte tambin
PICurrVal()
Recuperacin de grandes cantidades de datos
Valores interpolados

Ejemplo de Valor actual


Para ver el valor actual del PI point sinusoid, defina las siguientes entradas para la funcin
Valor actual:
Entrada Valor
Elemento(s) de datos sinusoid
Tiempo a la izquierda Seleccionado

La funcin devuelve la siguiente matriz:

54 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Funcin Valor de archivo histrico


Si selecciona la opcin Elemento de datos, la funcin Valor de archivo histrico arroja el
valor de un PI point o de un atributo de PI AF con una marca de tiempo determinada. Esta
funcin admite llamadas a granel.
Si selecciona la opcin Expresin, la funcin Valor de archivo histrico arroja el valor de una
ecuacin de rendimiento calculado para una marca de tiempo determinada.
Entrada Descripcin
Ruta raz La ruta comn a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas vlidas incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.
Elemento(s) de datos Uno o varios nombres de PI point o nombres de atributos de PI AF para los
que la funcin arroja valores.
Incluya un rango de celdas que contengan nombres de PI point o de atributos
de PI AF para arrojar valores para cada uno de ellos.
Necesaria si selecciona la opcin Elemento de datos.

Expresin(es) Una o varias ecuaciones de rendimiento para las que la funcin calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para arrojar valores
para cada una de ellas.
Necesaria si selecciona la opcin Expresin.

Marca de tiempo La marca de tiempo para la que devuelve valores la funcin. Especifique una
hora fija o una expresin de tiempo relativa a la hora actual. Consulte Campos
de entrada de tiempo.
Necesario.

Manual del usuario de PI DataLink 2016 55


Funciones de PI DataLink

Entrada Descripcin
Modo de recuperacin Mtodo que la funcin utiliza para determinar los valores que se devolvern:
Las opciones son:
anterior
Recupera el valor que coincide exactamente o es anterior a la marca de
tiempo especificada.
solo anterior
Recupera el valor anterior a la marca de tiempo especificada.
interpolado
Recupera el valor interpolado en el tiempo especificado.
Consulte Valores interpolados.
auto
Arroja el valor interpolado en el tiempo especificado o sigue el mtodo
anterior. (Utiliza el mtodo anterior para elementos de datos con
atributos de paso).
siguiente
Recupera el valor que coincide exactamente o que sigue a la marca de
tiempo especificada.
solo siguiente
Recupera el valor que sigue a la marca de tiempo especificada.
hora exacta
Arroja nicamente un valor que coincide exactamente con la marca de
tiempo o arroja No events found si no existe ningn valor con esa
marca de tiempo.
Disponible si selecciona la opcin Elemento de datos.

Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.
Sin marca de tiempo Haga clic en esta opcin para obtener solo valores. La funcin devuelve
valores en una columna para una columna de elementos de datos o
expresiones referenciados o devuelve valores en una fila para una fila de
elementos de datos o expresiones referenciados.
Tiempo a la izquierda Haga clic en esta opcin para arrojar dos columnas: la marca de tiempo en la
columna izquierda y el valor en la columna derecha.
Tiempo en la parte Haga clic en esta opcin para arrojar dos filas: la marca de tiempo en la fila
superior superior y el valor en la fila inferior.

Consulte tambin

PIArcVal()

56 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Especificar elementos de datos.


PIExpVal()
Especificar una expresin.
Recuperacin de grandes cantidades de datos

Ejemplo de Valor de archivo


Para ver el valor actual del PI point sinusoiden un momento concreto, defina las siguientes
entradas para la funcin Valor de archivo:
Entrada Valor
Elemento(s) de datos sinusoid
Marca de tiempo 30-Sep-07 15:13
Modo de recuperacin anterior
Tiempo a la izquierda Seleccionado

La funcin devuelve la siguiente matriz:

Funcin Datos comprimidos


Si selecciona la opcin Intervalo de tiempo, la funcin Datos comprimidos arroja todos los
valores de un PI point o de un atributo de PI AF junto con un recuento de los valores que se
producen durante un perodo de tiempo determinado.
Si selecciona la opcin Nmero de valores, la funcin Datos comprimidos arroja un nmero
especfico de valores de punto o de atributo que comienzan en un determinado momento.
Nota:
Los valores almacenados en el archivo de Archivo de datos de PI se someten a un
algoritmo de compresin que elimina todos los valores que representan la misma
pendiente. Los valores almacenados en el snapshot de Archivo de datos de PI no se han
sometido a este algoritmo de compresin. Si especifica la hora actual en el periodo de
tiempo de la funcin Datos comprimidos, la funcin recupera un valor de snapshot para
esa hora. El valor de snapshot puede no almacenarse posteriormente en el archivo debido
a la compresin.

Entrada Descripcin
Ruta raz La ruta comn a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas vlidas incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.

Manual del usuario de PI DataLink 2016 57


Funciones de PI DataLink

Entrada Descripcin
Elemento(s) de datos Uno o varios nombres de PI point o nombres de atributos de PI AF para los
que la funcin arroja valores.
Incluya un rango de celdas que contengan nombres de PI point o de atributos
de PI AF para arrojar valores para cada uno de ellos.
Necesario.
Hora de inicio El inicio del perodo de tiempo para el que la funcin arroja valores. Consulte
Campos de entrada de tiempo.
Necesario.
Hora de finalizacin El final del perodo de tiempo para el que la funcin arroja valores.
Necesaria si selecciona la opcin Intervalo de tiempo.

Nmero de valores El nmero de valores que la funcin arroja, a partir de la Hora de inicio.
Necesaria si selecciona la opcin Nmero de valores.

Atrs en el tiempo Seleccione esta casilla para recuperar valores registrados en la Hora de inicio
y anteriores. Disponible si selecciona la opcin Nmero de valores e
introduce un valor en el campo Nmero de valores.
Si introduce una referencia de celda en el campo Nmero de valores, est
casilla aparece deshabilitada. En su lugar, introduzca un nmero negativo en
la celda referenciada para conseguir el mismo efecto.
Expresin de filtro Una ecuacin de rendimiento booleana que la funcin utiliza para filtrar
valores. Cuando la expresin se evala como falsa, la funcin excluye los
valores correspondientes. Consulte Expresiones de filtro.
Marcar como filtrado Seleccione esta casilla para insertar la etiqueta Filtered en lugar de un
valor o un bloque de valores que la funcin ha filtrado de la salida en funcin
de la Expresin de filtro.
Tipo de lmite Mtodo que la funcin utiliza para determinar qu valores se recuperarn
cerca de la hora de inicio o de la hora de finalizacin:
interior(predeterminado)
Recupera valores a las horas de inicio y de finalizacin, si existen, o los
valores ms cercanos producidos dentro del intervalo.
exterior
Recupera los valores ms cercanos que se producen inmediatamente
fuera del intervalo.
interpolado
Recupera valores interpolados a las horas de inicio y de finalizacin.
Consulte Valores interpolados.
auto
Arroja valores interpolados, pero utiliza el mtodo inside para los
elementos de datos con atributos de paso.

58 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.
Ocultar recuento Seleccione esta casilla para ocultar el recuento de valores devueltos y
mostrar slo los valores. Disponible si selecciona la opcin Intervalo de
tiempo.
Mostrar marcas de Seleccione esta casilla para mostrar la marca de tiempo que corresponde a
tiempo cada valor arrojado. PI DataLink muestra marcas de tiempo a la izquierda de
los valores mostrados en una columna o sobre ellos en una fila.
Mostrar atributos de Seleccione esta casilla para mostrar los bits de estado ampliados asociados
valor con los valores devueltos. Los bits de estado pueden ser:
A
Anotados. Indica que el valor incluye un comentario.

S
Sustituido. Indica que el valor ha cambiado y ya no presenta el valor
originariamente registrado.

Q
Cuestionable. Indica que existen razones para dudar de la precisin del
valor.
PI DataLink muestra los atributos de valor en una columna a la derecha de los
valores.
Mostrar anotaciones Seleccione esta casilla para mostrar las anotaciones asociadas con los valores
devueltos. Las anotaciones contienen notas o comentarios que describen un
valor de datos. PI DataLink muestra las anotaciones en una columna a la
derecha de los valores.
Columna Haga clic en esta opcin para arrojar valores en una columna.
Fila Haga clic en esta opcin para arrojar valores en una fila.
Nota:
Si especifica un rango de elementos en Elemento(s) de datos o un rango
de expresiones en Expresin(es), PI DataLink automticamente
seleccionar Columna o Fila para coincidir con la orientacin del rango
especificado.

Consulte tambin
PICompDat()
Especifique un intervalo de tiempo sin una expresin de filtro.
PICompFilDat()
Especifique un intervalo de tiempo con una expresin de filtro.
PINCompDat()

Manual del usuario de PI DataLink 2016 59


Funciones de PI DataLink

Especifique un nmero de valores sin una expresin de filtro.


PINCompFilDat()
Especifique un nmero de valores con una expresin de filtro.

Ejemplo de Datos comprimidos


Para ver el valor actual del PI point sinusoid, defina las siguientes entradas para la funcin
Datos comprimidos:
Entrada Valor
Nmero de valores Seleccionado
Elemento(s) de datos sinusoid
Hora de inicio $A$10 (asumiendo que la celda A-10 tiene la hora
actual)
Nmero de valores 10
Atrs en el tiempo Seleccionado
Tipo de lmite interior
Mostrar marcas de tiempo Seleccionado
Columna Seleccionado

La funcin devuelve la siguiente matriz:

Tenga en cuenta que podra seleccionar la opcin Intervalo de tiempo y especificar la Hora de
inicio y la Hora de finalizacin adecuadas para obtener los mismos valores.

Funcin Datos de muestra


Si selecciona la opcin Elemento de datos, la funcin Datos de muestra arroja valores
interpolados, separados por espacios, de un PI point o de un atributo de PI AF a lo largo de
un intervalo regular.
Si selecciona la opcin Expresin, la funcin Datos de muestra arroja valores interpolados,
con intervalos iguales, de una ecuacin de rendimiento a lo largo de un intervalo regular.
Consulte Valores interpolados.

60 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Ruta raz La ruta comn a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas vlidas incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.
Elemento(s) de datos Uno o varios nombres de PI point o nombres de atributos de PI AF para los
que la funcin arroja valores.
Incluya un rango de celdas que contengan nombres de PI point o de atributos
de PI AF para arrojar valores para cada uno de ellos.
Necesaria si selecciona la opcin Elemento de datos.

Expresin(es) Una o varias ecuaciones de rendimiento para las que la funcin calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para arrojar valores
para cada una de ellas.
Necesaria si selecciona la opcin Expresin.

Hora de inicio El inicio del perodo de tiempo para el que la funcin arroja valores. Consulte
Campos de entrada de tiempo.
Necesario.
Hora de finalizacin El final del perodo de tiempo para el que la funcin arroja valores.
Necesario.
Intervalo de tiempo Frecuencia de muestreo utilizada para calcular valores durante el perodo de
tiempo. Introduzca un valor y una unidad de tiempo. Por ejemplo, introduzca
15m (15 minutos) para arrojar un valor por cada intervalo de 15 minutos en
el perodo de tiempo. Consulte Especificacin de intervalos de tiempo.
Necesario.
Expresin de filtro Una ecuacin de rendimiento booleana que la funcin utiliza para filtrar
valores. Cuando la expresin se evala como falsa, la funcin excluye los
valores correspondientes. Consulte Expresiones de filtro.
Marcar como filtrado Seleccione esta casilla para insertar la etiqueta Filtered en lugar de un
valor o un bloque de valores que la funcin ha filtrado de la salida en funcin
de la Expresin de filtro.
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.

Manual del usuario de PI DataLink 2016 61


Funciones de PI DataLink

Entrada Descripcin
Mostrar marcas de Seleccione esta casilla para mostrar la marca de tiempo que corresponde a
tiempo cada valor arrojado. PI DataLink muestra marcas de tiempo a la izquierda de
los valores mostrados en una columna o sobre ellos en una fila.
Columna Haga clic en esta opcin para arrojar valores en una columna.
Fila Haga clic en esta opcin para arrojar valores en una fila.
Nota:
Si especifica un rango de elementos en Elemento(s) de datos o un rango
de expresiones en Expresin(es), PI DataLink automticamente
seleccionar Columna o Fila para coincidir con la orientacin del rango
especificado.

Consulte tambin
PISampDat()
Especifique un elemento de datos con una expresin de filtro.
PISampFilDat()
Especifique un elemento de datos sin una expresin de filtro.
PIExpDat()
Especificar una expresin.

Ejemplo de Datos de muestra


Para ver los valores interpolados peridicos a lo largo de las 24 horas anteriores para el PI
point sinusoid, defina las siguientes entradas para la funcin Datos de muestra:
Entrada Valor
Elemento(s) de datos sinusoid
Hora de inicio -1d
Hora de finalizacin $A$10 (asumiendo que la celda A-10 tiene la hora
actual)
Intervalo de tiempo 3h
Mostrar marcas de tiempo Seleccionado
Columna Seleccionado

La funcin devuelve la siguiente matriz:

62 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

La matriz contiene un valor para cada intervalo de tres horas.

Funcin Datos temporizados


Si selecciona la opcin Elemento de datos, la funcin Datos temporizados recupera valores
de muestra reales o interpolados para un PI point o para un atributo de PI AF con marcas de
tiempo determinadas.
Si selecciona la opcin Expresin, la funcin Datos temporizados recupera los valores de
una ecuacin de rendimiento calculados para marcas de tiempo determinadas.
Entrada Descripcin
Ruta raz La ruta comn a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas vlidas incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.
Elemento(s) de datos Uno o varios nombres de PI point o nombres de atributos de PI AF para los
que la funcin arroja valores.
Incluya un rango de celdas que contengan nombres de PI point o de atributos
de PI AF para arrojar valores para cada uno de ellos.
Necesaria si selecciona la opcin Elemento de datos.

Expresin(es) Una o varias ecuaciones de rendimiento para las que la funcin calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para arrojar valores
para cada una de ellas.
Necesaria si selecciona la opcin Expresin.

Marca(s) de tiempo Las marcas de tiempo para las que devuelve valores la funcin. Introduzca
una marca de tiempo o una referencia a una o varias celdas de hoja de clculo
que contengan valores de marca de tiempo.
Necesario.

Manual del usuario de PI DataLink 2016 63


Funciones de PI DataLink

Entrada Descripcin
Modo de recuperacin Mtodo que la funcin utiliza para obtener datos:
interpolado
Devuelve los valores interpolados correspondientes a determinadas
marcas de tiempo. En el caso de elementos de datos con atributos de paso,
recupera el valor que precede a la marca de tiempo especificada.
Consulte Valores interpolados.
hora exacta
Arroja nicamente valores que coinciden exactamente con las marcas de
tiempo especificadas; arroja No events found si no existe ningn valor.
Disponible si selecciona la opcin Elemento de datos.

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

Consulte tambin
PITimeDat()
Especificar un elemento de datos.
PITimeExpDat()
Especificar una expresin.

Ejemplo de Datos temporizados


Para ver los valores correspondientes a una matriz de marcas de tiempo para el PI point
sinusoidu, defina las siguientes entradas para la funcin Datos temporizados:
Entrada Valor
Elemento(s) de datos sinusoidu
Marcas de tiempo $A$3..$A$12 (las celdas A-3 hasta A-12 contienen
las marcas de tiempo de una matriz de datos
comprimidos)
Modo de recuperacin interpolado

La funcin devuelve la siguiente matriz de datos temporizados en la columna de la derecha:

64 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

La matriz de datos temporizados se basa en las marcas de tiempo de la primera columna.

Funcin Datos calculados


Si selecciona la opcin Elemento de datos, la funcin Datos calculados arroja uno o ms
valores con intervalos iguales, calculados en base a valores de PI point o de atributos de PI
AF y preferencias de clculo determinadas. Si no especifica expresiones de filtro e intervalos
de tiempo, la funcin admite llamadas a granel.
Si selecciona la opcin Expresin, la funcin Datos calculados arroja uno o ms valores con
intervalos iguales, calculados en base a una ecuacin de rendimiento evaluada y
preferencias de clculo determinadas.
Nota:
Haga clic en el signo + junto a Avanzado para acceder a todas las entradas de funcin.

Entrada Descripcin
Ruta raz La ruta comn a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas vlidas incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.
Elemento(s) de datos Uno o varios nombres de PI point o nombres de atributos de PI AF para los
que la funcin arroja valores.
Incluya un rango de celdas que contengan nombres de PI point o de atributos
de PI AF para arrojar valores para cada uno de ellos.
Necesaria si selecciona la opcin Elemento de datos.

Expresin(es) Una o varias ecuaciones de rendimiento para las que la funcin calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para arrojar valores
para cada una de ellas.
Necesaria si selecciona la opcin Expresin.

Manual del usuario de PI DataLink 2016 65


Funciones de PI DataLink

Entrada Descripcin
Hora de inicio El inicio del perodo de tiempo para el que la funcin arroja valores. Consulte
Campos de entrada de tiempo.
Necesario.
Hora de finalizacin El final del perodo de tiempo para el que la funcin arroja valores.
Necesario.
Intervalo de tiempo Frecuencia de muestreo utilizada para calcular valores durante el perodo de
tiempo. Introduzca un valor y una unidad de tiempo. Por ejemplo, introduzca
15m (15 minutos) para arrojar un valor por cada intervalo de 15 minutos en
el perodo de tiempo. Consulte Especificacin de intervalos de tiempo.
Expresin de filtro Una ecuacin de rendimiento booleana que la funcin utiliza para filtrar
valores. Cuando la expresin se evala como falsa, la funcin excluye los
valores correspondientes. Consulte Expresiones de filtro.
Factor de conversacin Factor que la funcin aplica a los valores devueltos. Introduzca 1 si el factor
de conversin no es necesario. Para los clculos 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
da).
Necesario.
Por ejemplo, entre los factores de conversin comunes se incluyen:
1.0 para valores que almacenan unidades/da
24 para valores que almacenan unidades/hora
1440 para valores que almacenan unidades/minuto
86400 para valores que almacenan unidades/segundo
Modo de clculo Tipo de clculo que realiza la funcin:
total
Suma los valores durante el intervalo.
mnimo
Localiza el valor mnimo durante el intervalo.
mximo
Localiza el valor mximo durante el intervalo.
desviacin estndar
Calcula la desviacin estndar de los valores durante el intervalo.
intervalo
Calcula el valor mximo menos el valor mnimo durante el intervalo.
recuento
Cuenta el nmero de segundos del intervalo si el campo Calculation basis
(Bases de clculo) est establecido en time-weighted (con ponderacin
temporal).
Cuenta el nmero de valores almacenados durante el intervalo si el campo
Calculation basis est establecido en event-weighted (ponderacin por
eventos).
average (time-weighted) (promedio [con ponderacin temporal])
Computa el promedio con ponderacin temporal de los valores
registrados durante el intervalo.
average (event-weighted) (promedio [ponderacin por eventos])
Computa el promedio de ponderacin por eventos de los valores
registrados durante el intervalo.

66 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Bases de clculo El mtodo de clculo:
con ponderacin temporal
Valor predeterminado de todos los modos de clculo excepto para el
promedio de ponderacin por eventos. La funcin pondera cada valor
registrado segn el intervalo de tiempo durante el que se aplica el valor.
La funcin interpola los valores de los lmites del intervalo.
ponderado por eventos
La funcin sospesa del mismo modo cada valor registrado. Seleccione esta
opcin para los valores en lotes. Este mtodo requiere como mnimo un
valor registrado en un periodo de tiempo (dos eventos registrados para
los clculos de desviacin estndar).
Muestreo de expresin Mtodo que la funcin utiliza para determinar cundo evaluar una expresin:
comprimido
La funcin evala la expresin durante el periodo de tiempo en las marcas
de tiempo donde los PI points o los atributos de PI AF de la expresin han
almacenado valores.
interpolado
La funcin evala la expresin en intervalos de muestra espaciados
regularmente determinados por la Frecuencia de muestreo de expresin.
Consulte Valores interpolados.
Disponible si selecciona Expresin o si especifica una Expresin de filtro.

Frecuencia de muestreo La frecuencia con que la funcin evala una expresin. Necesario si establece
de expresin Muestreo de expresin como interpolado.
Por ejemplo, defina en 10m (10 minutos) para arrojar un valor interpolado
por cada intervalo de 10 minutos.
Porcentaje correcto Porcentaje mnimo de datos correctos necesarios durante cada intervalo de
mnimo tiempo para calcular y devolver un valor para ese intervalo. La funcin arroja
la etiqueta Insufficient good data para los intervalos que no alcanzan
este porcentaje.
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.
Mostrar hora de inicio Seleccione esta casilla para mostrar la hora de inicio del intervalo de tiempo
que se utiliza para calcular el valor arrojado. PI DataLink muestra la hora de
inicio en una columna a la izquierda de los valores arrojados o en una fila
sobre ellos. Solo estar disponible si especifica Intervalo de tiempo.
Mostrar hora de Seleccione esta casilla para mostrar la hora de finalizacin del intervalo de
finalizacin tiempo que se utiliza para calcular el valor arrojado. PI DataLink muestra la
hora de finalizacin en una columna a la izquierda de los valores arrojados o
en una fila sobre ellos. Solo estar disponible si especifica Intervalo de
tiempo.

Manual del usuario de PI DataLink 2016 67


Funciones de PI DataLink

Entrada Descripcin
Mostrar tiempo mn./ Seleccione esta casilla para mostrar la marca de tiempo correspondiente al
mx. valor mnimo o mximo durante el intervalo utilizado para calcular el valor.
Solo est disponible para tres valores de Modo de clculo:
mximo
Muestra la marca de tiempo del valor mximo.
mnimo
Muestra la marca de tiempo del valor mnimo.
intervalo
Muestra las marcas de tiempo del valor mnimo y el valor mximo.
Mostrar porcentaje Seleccione esta casilla para mostrar el porcentaje de tiempo en el que se han
correcto arrojado valores correctos durante el perodo de tiempo de la matriz. PI
DataLink muestra el porcentaje de valores correctos en una columna a la
derecha de los valores arrojados o en una fila debajo de ellos.
Los valores correctos son valores registrados que Archivo de datos de PI ha
determinado que eran vlidos y que no tenan un estado de error. Puede
utilizar el porcentaje de valores correctos para evaluar la fiabilidad de los
clculos basados en valores de PI point, en especial, si utiliza los valores de
otros clculos posteriores.
Por ejemplo, si un perodo de tiempo incluye datos incorrectos, el total
resultante con ponderacin temporal ser equivalente al total dividido por la
fraccin del intervalo donde datos correctos estn disponibles. Esta
normalizacin asume que el promedio a lo largo del periodo de tiempo con
datos incorrectos es equivalente al valor promedio durante todo el intervalo
de tiempo. Por lo tanto, el promedio ser menos confiable si una fraccin
grande del perodo de tiempo incluye datos incorrectos.
Columna Haga clic en esta opcin para arrojar valores en una columna.
Fila Haga clic en esta opcin para arrojar valores en una fila.
Nota:
Si especifica un rango de elementos en Elemento(s) de datos o un rango
de expresiones en Expresin(es), PI DataLink automticamente
seleccionar Columna o Fila para coincidir con la orientacin del rango
especificado.

Consulte tambin
PIAdvCalcVal()
Especifique un elemento de datos para obtener un solo valor
PIAdvCalcFilVal()
Especifique un elemento de datos y una expresin de filtro para obtener un solo valor
PIAdvCalcExpVal()
Especifique una expresin para obtener un solo valor
PIAdvCalcExpFilVal()
Especifique una expresin y una expresin de filtro para obtener un solo valor
PIAdvCalcDat()
Especifique un elemento de datos y un intervalo de tiempo para obtener varios valores
PIAdvCalcFilDat()

68 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Especifique un elemento de datos, un intervalo de tiempo y una expresin de filtro para


obtener varios valores
PIAdvCalcExpDat()
Especifique una expresin y un intervalo de tiempo para obtener varios valores
PIAdvCalcExpFilDat()
Especifique una expresin, un intervalo de tiempo y una expresin de filtro para obtener
varios valores
Recuperacin de grandes cantidades de datos

Ejemplo de Datos calculados


Para ver los intervalos de valores por hora desde la medianoche de hoy hasta la hora actual del
PI point sinusoid, defina las siguientes entradas para la funcin Datos calculados:
Entrada Valor
Elemento(s) de datos sinusoid
Hora de inicio t
Hora de finalizacin *
Intervalo de tiempo 1h
Modo de clculo intervalo
Bases de clculo ponderado a tiempo
Mostrar hora de inicio seleccionada
Mostrar hora de finalizacin seleccionada
Columna seleccionada

La funcin devuelve la siguiente matriz:

En este ejemplo, la funcin calcula el rango de cada intervalo de una hora. Puede especificar
cualquier clculo disponible a lo largo de cualquier intervalo.

Manual del usuario de PI DataLink 2016 69


Funciones de PI DataLink

Funcin Filtrado de tiempo


La funcin Filtrado de tiempo arroja la cantidad de tiempo durante la cual una ecuacin de
rendimiento se evala como true durante un perodo de tiempo determinado.
Nota:
Los resultados de la funcin Filtrado de tiempo varan ligeramente en funcin de la
versin de Archivo de datos de PI.

Entrada Descripcin
Ruta raz La ruta comn a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas vlidas incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.
Expresin(es) Una ecuacin de rendimiento booleana que la funcin evala. Consulte
Expresiones.
Incluya un rango de celdas que contenga expresiones para arrojar valores
para cada una de ellas.
Necesario.
Hora de inicio El inicio del perodo de tiempo para el que la funcin arroja valores. Consulte
Campos de entrada de tiempo.
Necesario.
Hora de finalizacin El final del perodo de tiempo para el que la funcin arroja valores.
Necesario.
Intervalo de tiempo Frecuencia de muestreo utilizada para calcular valores durante el perodo de
tiempo. Introduzca un valor y una unidad de tiempo. Por ejemplo, introduzca
15m (15 minutos) para arrojar un valor por cada intervalo de 15 minutos en
el perodo de tiempo. Consulte Especificacin de intervalos de tiempo.
Unidades de tiempo Unidades de tiempo en las que la funcin devuelve el resultado.
Necesario.
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.
Mostrar hora de inicio Seleccione esta casilla para mostrar la hora de inicio del intervalo de tiempo
que se utiliza para calcular el valor arrojado. PI DataLink muestra la hora de
inicio en una columna a la izquierda de los valores arrojados o en una fila
sobre ellos. Solo estar disponible si especifica Intervalo de tiempo.

70 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Mostrar hora de Seleccione esta casilla para mostrar la hora de finalizacin del intervalo de
finalizacin tiempo que se utiliza para calcular el valor arrojado. PI DataLink muestra la
hora de finalizacin en una columna a la izquierda de los valores arrojados o
en una fila sobre ellos. Solo estar disponible si especifica Intervalo de
tiempo.
Mostrar porcentaje Seleccione esta casilla para mostrar el porcentaje de tiempo en el que se han
correcto arrojado valores correctos durante el perodo de tiempo de la matriz. PI
DataLink muestra el porcentaje de valores correctos en una columna a la
derecha de los valores arrojados o en una fila debajo de ellos.
Los valores correctos son valores registrados que Archivo de datos de PI ha
determinado que eran vlidos y que no tenan un estado de error. Puede
utilizar el porcentaje de valores correctos para evaluar la fiabilidad de los
clculos basados en valores de PI point, en especial, si utiliza los valores de
otros clculos posteriores.
Por ejemplo, si un perodo de tiempo incluye datos incorrectos, el total
resultante con ponderacin temporal ser equivalente al total dividido por la
fraccin del intervalo donde datos correctos estn disponibles. Esta
normalizacin asume que el promedio a lo largo del periodo de tiempo con
datos incorrectos es equivalente al valor promedio durante todo el intervalo
de tiempo. Por lo tanto, el promedio ser menos confiable si una fraccin
grande del perodo de tiempo incluye datos incorrectos.
Columna Haga clic en esta opcin para arrojar valores en una columna.
Fila Haga clic en esta opcin para arrojar valores en una fila.
Nota:
Si especifica un rango de elementos en Expresin(es), PI DataLink
automticamente seleccionar Columna o Fila para ajustarse a la
orientacin de los elementos.

Consulte tambin
PITimeFilterVal()
Devolver un nico valor.
PITimeFilter()
Especificar un intervalo de tiempo y obtener varios valores.

Ejemplo de Filtrado de tiempo


Para ver el nmero de horas que el valor de PI point sinusoid ha sobrepasado el valor 75
durante los siete das anteriores, defina las siguientes entradas para la funcin Filtrado de
tiempo:
Entrada Valor
Expresin 'sinusoid' > 75
Hora de inicio -7d
Hora de finalizacin *
Unidades de tiempo h
Mostrar porcentaje correcto Seleccionado
Columna Seleccionado

La funcin devuelve la siguiente matriz:

Manual del usuario de PI DataLink 2016 71


Funciones de PI DataLink

En este ejemplo, la funcin calcula que el valor de sinusoid ha estado por encima de 75
durante 7,85 horas a lo largo de los 7 das anteriores y que el 100% de los valores fueron
correctos durante ese periodo.

Funcin Explorar eventos


La funcin Explorar eventos devuelve aquellos eventos que satisfacen los criterios
especificados en una base de datos de PI AF. Utilice la funcin Explorar eventos para ver
eventos en formato jerrquico. La funcin 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 funcin en la hoja de
clculo. Utilice los campos de la parte inferior del panel de tareas para especificar las columnas
que desea incluir y la posicin de la matriz de funcin insertada.
Para obtener ms informacin, consulte los temas siguientes:
Eventos en hojas de clculo
PI DataLink puede mostrar datos de los eventos de PI AF con la funcin Explorar eventos o
la funcin Comparar eventos.
Explorar los eventos relacionados con un elemento
Siga este procedimiento para utilizar la funcin 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 funcin 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 devolvern en la hoja de clculo.
Nombres de atributo reservados
Para evitar conflictos con atributos generados automticamente, no defina eventos que
utilicen nombres de atributos reservados.
Ejemplo de Explorar eventos
Establezca las entradas de la funcin Explorar eventos para ver los eventos que han estado
activos durante el ltimo mes y que estn basados en una plantilla determinada.
Administrar configuraciones de PI DataLink
Utilice la ventana Ajustes para definir el nmero mximo de eventos que devuelve la
funcin.

72 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Referencia del panel de tareas Explorar eventos


La funcin Explorar eventos devuelve eventos en un formato jerrquico. La configuracin de
las preferencias limita el nmero de eventos que se recuperan en la lista Preview y se
devuelven a la hoja de clculo.
Nota:
Expanda More search options para acceder a todas las entradas de funcin.

Entrada Descripcin
Base de datos La base de datos de PI AF desde la que la funcin devuelve eventos.
Especifique en el formato \\ServerName\DatabaseName. 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 funcin pueda encontrar
los eventos coincidentes, debe especificar la base de datos.
Search start (Inicio de Una expresin de tiempo de PI que especifica en qu momento la funcin
bsqueda) 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.
Search end (Final de Una expresin de tiempo de PI que especifica en qu momento la funcin deja
bsqueda) de buscar eventos en la base de datos. Por ejemplo, especifique * para buscar
eventos hasta la hora actual.
Limit to database level Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raz
(Limitar al nivel de la de la base de datos. Si desmarca esta casilla, la funcin busca eventos
base de datos) coincidentes en cualquier nivel de la jerarqua.
Event name (Nombre de El nombre de eventos coincidentes. Puede especificar nombres parciales con
evento) caracteres comodn.
Event template Una plantilla de eventos de los eventos coincidentes. Tenga en cuenta que si
(Plantilla de eventos) selecciona una plantilla de eventos base, la funcin incluye eventos de
plantillas derivadas.
Al seleccionar una plantilla de eventos, la lista Columns to display se actualiza
para reflejar atributos de la plantilla seleccionada. La actualizacin suprime
los atributos insertados con anterioridad.

Element name (Nombre Un elemento de PI AF al que hacen referencia los eventos coincidentes. Puede
de elemento) especificar nombres parciales con caracteres comodn. Si utiliza la versin 2.8
del servidor de PI AF u otra posterior, puede indicar la ruta a un elemento
especfico.
Element template Una plantilla de elementos de un elemento al que hacen referencia los
(Plantilla de elementos) eventos coincidentes. Tenga en cuenta que si selecciona una plantilla de
elementos base, la funcin incluye eventos que hacen referencia a elementos
de plantillas derivadas.
Se necesita la versin 2.6 o posterior del servidor de PI AF para filtrar
plantillas de elementos.
Event category La categora de los eventos coincidentes.
(Categora de evento)
Minimum duration La duracin mnima de los eventos coincidentes. Especifique un valor y una
(Duracin mnima) abreviatura de unidad temporal.
Maximum duration La duracin mxima de los eventos coincidentes. Especifique un valor y una
(Duracin mxima) abreviatura de unidad temporal.

Manual del usuario de PI DataLink 2016 73


Funciones de PI DataLink

Entrada Descripcin
Search mode (Modo de El mtodo que utiliza la funcin para buscar eventos coincidentes en relacin
bsqueda) con el perodo de tiempo especificado por el inicio de la bsqueda y el final de
la bsqueda:
activo en intervalo
Permite buscar eventos activos en cualquier momento durante el perodo
de tiempo especificado.

completamente en intervalo
Permite buscar eventos que empiezan y acaban durante el perodo de
tiempo especificado.

comenzando en intervalo
Permite buscar eventos que empiezan durante el perodo de tiempo
especificado y acaban durante o despus del perodo de tiempo
especificado.

finalizando en intervalo
Permite buscar eventos que acaban durante el perodo de tiempo
especificado y empiezan antes o durante del perodo de tiempo
especificado.

en curso
Permite buscar eventos que empiezan durante el perodo de tiempo
especificado pero que todava no han finalizado. Solo est disponible con
la versin 2.6 o posteriores del servidor de PI AF.
Sort order (Criterio de El mtodo que utiliza la funcin para clasificar los eventos coincidentes:
ordenacin) 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 ms temprano al ms
tardo.

hora de inicio descendente


Permite ordenar los eventos por hora de inicio, del ms tardo al ms
temprano.

hora de finalizacin ascendente


Permite ordenar los eventos por hora de finalizacin, del ms temprano al
ms tardo.

hora de finalizacin descendente


Permite ordenar los eventos por hora de finalizacin, del ms tardo al
ms temprano.
Severity (Gravedad) La gravedad de los eventos coincidentes. Indique un operador y un tipo de
gravedad. La funcin filtra los eventos coincidentes en funcin de la
condicin especificada. Los tipos de gravedad corresponden a un valor y se
ordenan de mayor a menor. Por ejemplo, si escribe < Warning (<
Advertencia), la funcin hace corresponder los eventos de menor gravedad
que Warning: Information o None.

74 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Attribute value filters Hasta cuatro condiciones de atributo que la funcin utiliza para filtrar
(Filtros de valor de eventos coincidentes.
atributo)
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 funcin filtra eventos coincidentes.
Los atributos disponibles dependen de la plantilla de eventos
seleccionada.

Operador
El operador relacional que la funcin aplica al valor de atributo
especificado. Los operadores disponibles dependen del tipo de datos del
atributo.

Valor
El valor que la funcin utiliza para buscar atributos coincidentes. Por
ejemplo, si define el campo Operator (Operador) en el valor =, la funcin
limita los eventos a aquellos en los que el atributo especificado equivale a
este valor.

Acknowledgment filters Limita los eventos coincidentes a aquellos cuyo recibo puede acusarse:
(Filtros de acuse de Seleccione la casilla Acknowledged (Recibo acusado) para hacer
recibo) corresponder los eventos cuyo recibo se haya acusado.
Seleccione la casilla Unacknowledged (Recibo no acusado) para hacer
corresponder los eventos cuyo recibo no se haya acusado.
Seleccione ambas casillas para hacer coincidir cualquier evento cuyo
recibo pueda acusarse, independientemente de su actual estado de acuse
de recibo.
Limit to annotated Seleccione esta casilla para hacer coincidir nicamente los eventos anotados.
(Limitar a los anotados) Desmarque esta casilla para hacer coincidir todos los eventos, tanto con
anotaciones como sin ellas.

Manual del usuario de PI DataLink 2016 75


Funciones de PI DataLink

Entrada Descripcin
Columns to display Las columnas de la matriz de funcin arrojada. La lista contiene los nombres
(Columnas para de los atributos. De forma predeterminada, la lista incluye los atributos
mostrar) virtuales generados para todos los eventos y los atributos de eventos de la
plantilla de evento seleccionada. Puede:
Marcar la casilla Seleccionar todo para incluir todos los atributos
enumerados como columnas en la matriz de funcin arrojada.
Seleccione una casilla para incluir el atributo o desmarque una casilla
para excluir un atributo como columna de la matriz de funcin devuelta.
Haga clic en para abrir la ventana Aadir atributos donde puede

seleccionar atributos adicionales para incluir como columnas en la matriz


de funcin. Consulte Aadir columnas de atributos al panel de tareas
Explorar eventos.
Escriba el nombre de un atributo de evento junto a la casilla en blanco del
final de la lista.
Haga clic con el botn derecho sobre un atributo, haga clic en Insertar
atributo para insertar un atributo en blanco sobre el atributo
seleccionado y, a continuacin, escriba el nombre de un atributo de
evento.
Seleccione un atributo y haga clic en para mover el atributo hacia

arriba en la lista.
Seleccione un atributo y haga clic en para mover el atributo hacia

abajo en la lista.
Seleccione un atributo y haga clic en para eliminar el atributo de la

lista.
Haga clic con el botn derecho sobre un atributo y luego haga clic en
Eliminar atributo para eliminar el atributo de la lista.
Si la longitud de los nombres de columnas seleccionados supera los 759
caracteres, la funcin no podr procesar las columnas de manera individual.
En ese caso, el panel de tareas le pedir que especifique todas las columnas
como un grupo. Cuando se especifican todas las columnas como un grupo, la
lista dice All event attributes and template attributes (Todos los atributos de
evento y de plantilla) y la matriz de funcin devuelta incluye todos los
atributos predeterminados y sus atributos secundarios, pero ninguno de los
atributos adicionales que ha especificado.
Number of child event El nmero de niveles de eventos secundarios que la funcin incluye en la
levels (Nmero de matriz de funcin. Los eventos secundarios no deben coincidir con los
niveles de eventos criterios especificados. La funcin devuelve cada evento secundario en una
secundarios) fila separada y aade una columna adicional por cada nivel devuelto. En las
filas que contienen eventos secundarios, la columna aadida contiene el
nombre del evento secundario.
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.

76 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Consulte tambin
Eventos en hojas de clculo
Aadir columnas de atributos al panel de tareas Explorar eventos
Administrar configuraciones de PI DataLink

Ejemplo de Explorar eventos


Para ver los eventos basados en la plantilla de eventos PowerPlantShutDown de la base de
datos Produccin en el servidor de PI AF AFSRV1 y activos durante el ltimo mes, establezca
las entradas siguientes para la funcin Explorar eventos:
Entrada Valor
Base de datos \\AFSRV1\Produccin
Inicio de la bsqueda *-1mo
Final de la bsqueda *
Plantilla de eventos PowerPlantDownTime

La funcin devuelve la siguiente matriz:

Funcin Comparar eventos


La funcin Comparar eventos devuelve aquellos eventos que satisfacen los criterios
especificados en una base de datos de PI AF. Utilice la funcin Comparar eventos para ver
eventos en un formato plano. La funcin devuelve un evento por fila, pero puede devolver
atributos de eventos relacionados en la misma fila. Concretamente, para facilitar la
comparacin de eventos, la funcin puede devolver atributos de eventos secundarios o
primarios en la misma fila que el evento devuelto.
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 bsqueda 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 funcin en la
hoja de clculo. Utilice los campos de la parte inferior del panel de tareas para especificar las
columnas que desea incluir y la posicin de la matriz de funcin insertada.
Para obtener ms informacin, consulte los temas siguientes:
Eventos en hojas de clculo
PI DataLink puede mostrar datos de los eventos de PI AF con la funcin Explorar eventos o
la funcin Comparar eventos.
Comparacin de eventos mediante la inclusin de eventos secundarios
Siga este procedimiento para utilizar la funcin Comparar eventos para comparar eventos
que tienen eventos secundarios con los mismos nombres.
Comparacin de eventos mediante la inclusin de eventos principales
Siga este procedimiento para utilizar la funcin Comparar eventos para comparar eventos
de jerarquas coincidentes cuando existen eventos secundarios con nombres diferentes.

Manual del usuario de PI DataLink 2016 77


Funciones de PI DataLink

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 devolvern en la hoja de clculo.
Notacin de ruta para la funcin Comparar eventos
Utilice la notacin de ruta especfica en los nombres de atributos para designar la ubicacin
en la jerarqua de eventos.
Nombres de atributo reservados
Para evitar conflictos con atributos generados automticamente, no defina eventos que
utilicen nombres de atributos reservados.
Ejemplo de comparacin de eventos
Defina las entradas de la funcin Comparar eventos para comparar eventos de alerta de
temperatura.
Administrar configuraciones de PI DataLink
Utilice la ventana Ajustes para definir el nmero mximo de eventos que devuelve la
funcin.

Referencia del panel de tareas Comparar eventos


La funcin Comparar eventos devuelve eventos en un formato plano. La configuracin de las
preferencias limita el nmero de eventos que se recuperan en la lista Preview y se devuelven a
la hoja de clculo.
Nota:
Haga clic en el signo + junto a More search options (Ms opciones de bsqueda) para
acceder a todas las entradas de funcin.

Entrada Descripcin
Base de datos La base de datos de PI AF desde la que la funcin devuelve eventos.
Especifique en el formato \\ServerName\DatabaseName. 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 funcin pueda encontrar
los eventos coincidentes, debe especificar la base de datos.
Search start (Inicio de Una expresin de tiempo de PI que especifica en qu momento la funcin
bsqueda) 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.
Search end (Final de Una expresin de tiempo de PI que especifica en qu momento la funcin deja
bsqueda) de buscar eventos en la base de datos. Por ejemplo, especifique * para buscar
eventos hasta la hora actual.
Limit to database level Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raz
(Limitar al nivel de la de la base de datos. Si desmarca esta casilla, la funcin busca eventos
base de datos) coincidentes en cualquier nivel de la jerarqua.
Event name (Nombre de El nombre de eventos coincidentes. Puede especificar nombres parciales con
evento) caracteres comodn.
Event template Una plantilla de evento de los eventos coincidentes. Tenga en cuenta que si
(Plantilla de eventos) selecciona una plantilla de eventos base, la funcin incluye eventos de
plantillas derivadas.
Al seleccionar una plantilla de eventos, la lista Columns to display se actualiza
para reflejar atributos de la plantilla seleccionada. La actualizacin suprime
los atributos insertados con anterioridad.

78 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Element name (Nombre Un elemento de PI AF al que hacen referencia los eventos coincidentes. Puede
de elemento) especificar nombres parciales con caracteres comodn. Si utiliza la versin 2.8
del servidor de PI AF u otra posterior, puede indicar la ruta a un elemento
especfico.
Element template Una plantilla de elementos de un elemento al que hacen referencia los
(Plantilla de elementos) eventos coincidentes. Tenga en cuenta que si selecciona una plantilla de
elementos base, la funcin incluye eventos que hacen referencia a elementos
de plantillas derivadas.
Se necesita la versin 2.6 o posterior del servidor de PI AF para filtrar
plantillas de elementos.
Event category La categora de los eventos coincidentes.
(Categora de evento)
Minimum duration La duracin mnima de los eventos coincidentes. Especifique un valor y una
(Duracin mnima) abreviatura de unidad temporal.
Maximum duration La duracin mxima de los eventos coincidentes. Especifique un valor y una
(Duracin mxima) abreviatura de unidad temporal.
Search mode (Modo de El mtodo que utiliza la funcin para buscar eventos coincidentes en relacin
bsqueda) con el perodo de tiempo especificado por el inicio de la bsqueda y el final de
la bsqueda:
activo en intervalo
Permite buscar eventos activos en cualquier momento durante el perodo
de tiempo especificado.

completamente en intervalo
Permite buscar eventos que empiezan y acaban durante el perodo de
tiempo especificado.

comenzando en intervalo
Permite buscar eventos que empiezan durante el perodo de tiempo
especificado y acaban durante o despus del perodo de tiempo
especificado.

finalizando en intervalo
Permite buscar eventos que acaban durante el perodo de tiempo
especificado y empiezan antes o durante del perodo de tiempo
especificado.

en curso
Permite buscar eventos que empiezan durante el perodo de tiempo
especificado pero que todava no han finalizado. Solo est disponible con
la versin 2.6 o posteriores del servidor de PI AF.

Manual del usuario de PI DataLink 2016 79


Funciones de PI DataLink

Entrada Descripcin
Sort order (Criterio de El mtodo que utiliza la funcin para clasificar los eventos que se devolvern:
ordenacin) 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 ms temprano al ms
tardo.

hora de inicio descendente


Permite ordenar los eventos por hora de inicio, del ms tardo al ms
temprano.

hora de finalizacin ascendente


Permite ordenar los eventos por hora de finalizacin, del ms temprano al
ms tardo.

hora de finalizacin descendente


Permite ordenar los eventos por hora de finalizacin, del ms tardo al
ms temprano.
Severity (Gravedad) La gravedad de los eventos coincidentes. Indique un operador y un tipo de
gravedad. La funcin filtra los eventos coincidentes en funcin de la
condicin especificada. Los tipos de gravedad corresponden a un valor y se
ordenan de mayor a menor. Por ejemplo, si escribe < Warning (<
Advertencia), la funcin hace corresponder los eventos de menor gravedad
que Warning: Information o None.
Attribute value filters Hasta cuatro condiciones de atributo que la funcin utiliza para filtrar
(Filtros de valor de eventos coincidentes.
atributo)
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 funcin filtra eventos coincidentes.
Los atributos disponibles dependen de la plantilla de eventos
seleccionada.

Operador
El operador relacional que la funcin aplica al valor de atributo
especificado. Los operadores disponibles dependen del tipo de datos del
atributo.

Valor
El valor que la funcin utiliza para buscar atributos coincidentes. Por
ejemplo, si define el campo Operator (Operador) en el valor =, la funcin
limita los eventos a aquellos en los que el atributo especificado equivale a
este valor.

80 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Acknowledgment filters Limita los eventos coincidentes a aquellos cuyo recibo puede acusarse:
(Filtros de acuse de Seleccione la casilla Acknowledged (Recibo acusado) para hacer
recibo) corresponder los eventos cuyo recibo se haya acusado.
Seleccione la casilla Unacknowledged (Recibo no acusado) para hacer
corresponder los eventos cuyo recibo no se haya acusado.
Seleccione ambas casillas para hacer coincidir cualquier evento cuyo
recibo pueda acusarse, independientemente de su actual estado de acuse
de recibo.
Limit to annotated Seleccione esta casilla para hacer coincidir nicamente los eventos anotados.
(Limitar a los anotados) Desmarque esta casilla para hacer coincidir todos los eventos, tanto con
anotaciones como sin ellas.
Columns to display Las columnas de la matriz de funcin arrojada. La lista contiene los nombres
(Columnas para de los atributos. De forma predeterminada, la lista incluye los atributos
mostrar) virtuales generados para todos los eventos y los atributos de eventos de la
plantilla de evento seleccionada. La funcin incluye la ruta de los atributos; la
funcin identifica los atributos nicos por su nombre y posicin en la
jerarqua. Puede:
Marcar la casilla Seleccionar todo para incluir todos los atributos
enumerados como columnas en la matriz de funcin arrojada.
Seleccione una casilla para incluir el atributo o desmarque una casilla
para excluir un atributo como columna de la matriz de funcin devuelta.
Haga clic en para abrir la ventana Aadir atributos donde puede

seleccionar atributos adicionales para incluir como columnas en la matriz


de funcin. Consulte Aadir atributos de eventos secundarios como
columnas en el panel de tareas Comparar eventos.
Haga clic con el botn derecho en un atributo y seguidamente haga clic en
Clonar para evento principal para insertar el atributo del evento principal
como columna en la matriz de funcin. Consulte Aadir atributos de
eventos principales como columnas en el panel de tareas Comparar
eventos.
Escriba el nombre de un atributo de evento junto a la casilla en blanco del
final de la lista.
Haga clic con el botn derecho sobre un atributo, haga clic en Insertar
atributo para insertar un atributo en blanco sobre el atributo
seleccionado y, a continuacin, escriba el nombre de un atributo de
evento.
Seleccione un atributo y haga clic en para mover el atributo hacia

arriba en la lista.
Seleccione un atributo y haga clic en para mover el atributo hacia

abajo en la lista.
Seleccione un atributo y haga clic en para eliminar el atributo de la

lista.
Haga clic con el botn derecho sobre un atributo y luego haga clic en
Eliminar atributo para eliminar el atributo de la lista.
Si la longitud de los nombres de columnas seleccionados supera los 759
caracteres, la funcin no podr procesar las columnas de manera individual.
En ese caso, el panel de tareas le pedir que especifique todas las columnas
como un grupo. Cuando se especifican todas las columnas como un grupo, la
lista dice All event attributes and template attributes (Todos los atributos de
evento y de plantilla) y la matriz de funcin devuelta incluye todos los
atributos predeterminados y sus atributos secundarios, pero ninguno de los
atributos adicionales que ha especificado.

Manual del usuario de PI DataLink 2016 81


Funciones de PI DataLink

Entrada Descripcin
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.

Consulte tambin
Eventos en hojas de clculo
Aadir atributos de eventos secundarios como columnas en el panel de tareas Comparar
eventos
Administrar configuraciones de PI DataLink

Notacin de ruta para la funcin Comparar eventos


La funcin Comparar eventos identifica a los atributos por ruta; por lo tanto, los nombres de
atributo siempre deben incluir informacin de la ruta, especificada en relacin con el evento
coincidente que se muestra en cada fila. Cuando especifique los atributos, utilice la notacin
que designe la ubicacin correcta en la jerarqua de eventos.
Notacin de ruta admitida
Notacin Descripcin
.|A1 El atributo A1 del evento coincidente.
..|A1 El atributo A1 del evento principal del evento coincidente.
..\..|A1 El atributo A1 del evento primario principal del evento coincidente.
.\E1|A1 El atributo A1 del evento secundario E1 del evento coincidente.

Puede combinar la notacin para designar los atributos superiores de la jerarqua. Por ejemplo,
puede especificar el atributo Duracin para diferentes eventos de la jerarqua:
Evento primario principal superior: ..\..\..|Duration
Evento coincidente: .|Duration
Evento secundario denominado Phase1: .\Phase1|Duration

Ejemplo de comparacin de eventos


Utilice la funcin Comparar eventos para ver los atributos de eventos secundarios en un
formato que permita comparar fcilmente 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 funcin que muestre la hora de inicio, la duracin 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 funcin

82 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

para los eventos almacenados durante la ltima semana en la base de datos Produccin del
servidor de PI AF AFSRV1, introduzca las entradas siguientes:
Entrada Valor
Base de datos \\AFSRV1\Produccin
Inicio de la bsqueda *-1w
Final de la bsqueda *
Nombre del evento TempAlert*
Encabezados de columna Seleccione lo siguiente:
Nombre de evento
.|Hora de inicio
.|Hora de finalizacin
.|Duracin
.|Elemento primario
.\TempThreat|Hora de inicio*
.\TempThreat|Duracin*
.\TempThreat|Temperatura*
*Se aade a la lista desde la ventana Aadir
atributos.

La funcin devuelve la siguiente matriz:

Funcin de bsqueda de filtro de activo


La funcin de bsqueda 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 categora de elemento y la descripcin del elemento, as
como el valor de los atributos. Puede insertar los activos devueltos en la hoja de clculo como
valores estticos o como matriz de funcin.
Utilice los campos de la parte superior panel de tareas Bsqueda 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
posicin.
Para obtener ms informacin, consulte los temas siguientes:
Bsquedas
Puede buscar elementos de datos con la herramienta de bsqueda o con la funcin
Bsqueda de filtro de activo.
Buscar activos mediante filtros
Siga este procedimiento para utilizar la funcin Bsqueda de filtro de activo para especificar
los elementos que desea recuperar y la salida para la hoja de clculo.
Administrar configuraciones de PI DataLink

Manual del usuario de PI DataLink 2016 83


Funciones de PI DataLink

Utilice la ventana Ajustes para definir el nmero mximo de elementos y atributos que
devuelve la funcin.

Funcin Propiedades
La funcin Propiedades recupera el valor de propiedad de un elemento de datos especificado.
Entrada Descripcin
Ruta raz La ruta comn a elementos de datos especificados. Las entradas vlidas
incluyen lo siguiente:
Nombre del servidor de Archivo de datos de PI si el elemento de datos es
un PI point.
PI AF Server y base de datos si el elemento de datos es un atributo de PI
AF.
En blanco si el elemento de datos es un PI point del servidor de Archivo de
datos de PI predeterminado.
Consulte Elementos de datos.
Elemento(s) de datos Uno o varios nombres de PI point o de nombres de atributo de PI AF para los
que la funcin 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 funcin. Las propiedades
incluidas en la lista dependen del elemento de datos introducido:
PI point nico. La lista contiene los atributos de punto de la clase de punto
del punto introducido.
Nota:
Esta lista sustituye uom por EngUnits. Seleccione uom si desea ver el
valor del atributo de punto EngUnits.
Atributo de PI AF nico. La lista contiene cuatro propiedades de atributo
de PI AF: categoras, descripcin, uom y pipoint.
Referencia a varias celdas. La lista depende del tipo de elemento de datos
en la primera celda referenciada:
PI point. La lista contiene los atributos de punto de la PointClass de
ese punto.
Atributo de PI AF. La lista contiene cuatro propiedades de atributo de PI
AF: categories, description, uom y pipoint.
Si la lista est en blanco, PI DataLink no podra encontrar el elemento de
datos.
Seleccione la propiedad deseada o especifique una referencia de celda a una
celda que contenga la propiedad.

84 Manual del usuario de PI DataLink 2016


Funciones de PI DataLink

Entrada Descripcin
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.

Consulte tambin
PITagAtt()

Ejemplo de propiedades
Para ver los atributos de valor de algunos de los PI points listados en la hoja de clculo, defina
las siguientes entradas para la funcin Propiedades:
Entrada Valor
Elemento de datos B3..B5 (matriz de celda que contiene puntos)
Propiedad description (descripcin)

La funcin devuelve la siguiente matriz:

En este caso, los nombres de los PI points estn en una columna a la izquierda. Puede utilizar la
funcin Propiedades aparte para mostrar atributos adicionales en las columnas siguientes.

Manual del usuario de PI DataLink 2016 85


Funciones de PI DataLink

86 Manual del usuario de PI DataLink 2016


Uso y mantenimiento de las hojas de clculo
En esta seccin se explica cmo funcionan las funciones de PI DataLink en una hoja de clculo y
cmo gestionar y mantener la hoja de clculo a lo largo del tiempo.

En esta seccin
Matrices de funcin
Frecuencia de clculo
Compartir hojas de clculo

Matrices de funcin
Una matriz de funcin es un grupo de celdas que contiene la salida de una funcin de PI
DataLink nica. Cuando se aade una funcin a una hoja de clculo, PI DataLink introduce la
frmula de la funcin en las celdas de salida especificadas. La funcin realiza una consulta al
servidor de Archivo de datos de PI o al servidor de PI AF y arroja valores en una matriz de
funcin. El tamao de la matriz depende de la funcin, del nmero de valores coincidentes
disponible, del nmero de valores solicitado y de la salida solicitada.
La hoja de clculo muestra los valores devueltos en las celdas de una matriz de funcin. Sin
embargo, estas celdas contienen en realidad la frmula de funcin. Puede ver la frmula de
funcin en la barra de frmulas de Excel al hacer clic en una celda.

1. Frmula de funcin en la barra de frmulas


2. Valores arrojados en la matriz de funcin

En esta seccin
Tareas comunes relacionadas con las matrices de funcin
Actualizar entradas en una matriz de funcin
Tamao de la matriz
Redimensionar matrices

Tareas comunes relacionadas con las matrices de funcin


Las matrices de funcin se pueden mover, copiar o eliminar de una hoja de clculo.
Para seleccionar una matriz, realice una de las acciones siguientes:

Manual del usuario de PI DataLink 2016 87


Uso y mantenimiento de las hojas de clculo

Haga clic y arrastre para seleccionar todas las celdas de la matriz. Tenga presente que la
matriz puede contener valores vacos, que tambin deben ser seleccionados.
Haga clic con el botn derecho en cualquier parte de la matriz y elija Seleccionar funcin de
DataLink para seleccionar todas las celdas de la matriz.
Una vez seleccionadas, podr gestionar la matriz fcilmente.
Elimine manualmente los caracteres $ iniciales de la barra de frmulas para convertir las
referencias de celda en relativas.
Nota:
Despus de realizar un cambio en la barra de frmulas, pulse Ctrl + Alt + Entrar para
aplicar el cambio.
Haga clic con el botn derecho en cualquier celda de la matriz y seleccione, segn desee, el
comando Cortar, Copiar, Eliminar, Borrar o Formato.
Haga clic con el botn derecho en una nueva celda y seleccione Pegar para volver a insertar
una matriz cortada o copiada.
Site el cursor sobre el borde de la matriz seleccionada hasta que aparezca un cursor en
forma de cruz y, a continuacin, arrastre la matriz a una nueva celda para desplazarla.
Nota:
Debe trasladar o borrar una matriz de funcin completa, incluidas todas las celdas, de
lo contrario, PI DataLink mostrar un mensaje de error: No puede cambiar parte
de una matriz.
Abra el panel de tareas de funcin y actualice el campo Celda de salida para colocar la
matriz en una nueva ubicacin. Consulte Actualizar entradas en una matriz de funcin.
Tambin puede copiar los valores de una matriz de funcin si desea utilizarlos en otra parte en
una hoja de clculo. Una vez copiados y pegados los valores, ya no forman parte de una matriz
de funcin; son simplemente valores de celda y no se actualizan. Para copiar valores de matriz:
Seleccione los valores de funcin que desea, cpielos y utilice el comando Pegado especial
para pegarlos en la ubicacin deseada.
No es necesario seleccionar la columna o fila completa de la matriz para copiar valores.

Actualizar entradas en una matriz de funcin


Utilice el panel de tareas de funcin para actualizar una matriz de funcin con nuevos valores
de entrada.

Procedimiento
1. Abra el panel de tareas de funciones de una matriz:
Con la visualizacin automtica del panel de tareas de funciones activada, haga clic en
una o varias celdas.
Con la visualizacin automtica del panel de tareas de funciones desactivada, seleccione
una celda o varias, haga clic con el botn derecho del ratn y elija un nombre de funcin.
El panel de tareas de funciones muestra las entradas actuales de la matriz de funcin
seleccionada.
Si ha seleccionado una nica celda, PI DataLink detecta de forma automtica las matrices de
funcin adyacentes que nicamente difieren por el origen (es decir, por el elemento de
datos o la expresin) y selecciona las matrices para editar.

88 Manual del usuario de PI DataLink 2016


Uso y mantenimiento de las hojas de clculo

Si ha seleccionado varias celdas, PI DataLink slo selecciona las matrices con el mismo
origen (es decir, con los mismos valores para el elemento de datos o la expresin) que las
celdas seleccionadas.
2. Modifique los valores de entrada como desee para actualizar las matrices seleccionadas y
haga clic en Aceptar o Aplicar.
Si ha modificado el campo Celda de salida, los resultados dependen de la ubicacin de la
nueva referencia de celda:

Si la nueva referencia de celda forma parte de la matriz original, 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 ubicacin original.

Tamao de la matriz
Cuando una funcin de PI DataLink escribe una matriz de funcin, ajusta automticamente el
tamao de la matriz para que se ajuste a los datos obtenidos. Las funciones escriben la matriz
de funcin cuando hace clic en Aceptar o Aplicar en un panel de tareas o cuando hace clic en
Recalcular (Redimensionar) funcin en el men contextual.
Otros mtodos que recalculan o actualizan un funcin no escriben una nueva matriz de funcin.
Estos mtodos solo actualizan valores de matriz; el tamao de la matriz permanece invariable.
Por ejemplo, si especifica entradas de funcin con referencias de celda y cambia el valor de una
celda, la funcin actualizar los valores devueltos, pero el tamao de la matriz seguir siendo el
mismo. La actualizacin puede devolver un nmero mayor o menor de valores que la matriz de
funcin de la hoja de clculo puede mostrar. La configuracin controla los valores devueltos
por PI DataLink.
Si la actualizacin arroja menos valores, PI DataLink arroja valores en blanco o #N/A en las
celdas sin valores.
Si la actualizacin arroja ms valores de los que puede mostrar la matriz de funcin, PI
DataLink arroja el texto Resize to show all values en la parte inferior de la matriz a
no ser que la configuracin de preferencias inhabilite el mensaje.
Los valores vacos pueden modificar el aspecto de una hoja de clculo. Para mantener un
tamao constante, plantese configurar entradas de funcin para limitar los datos devueltos.
Por ejemplo, en la funcin Datos comprimidos, puede especificar el nmero de valores para
recuperar en lugar del periodo de tiempo durante el cual se recuperarn todos los valores.

Consulte tambin
Frecuencia de clculo
Redimensionar matrices
Administrar configuraciones de PI DataLink

Redimensionar matrices
Una actualizacin o un reclculo de una funcin de PI DataLink puede mostrar ms o menos
valores de los que la matriz de funcin puede mostrar. Utilice el comando Recalcular
(Redimensionar) funcin para actualizar la matriz completa de la funcin: PI DataLink recupera
valores nuevos de Archivo de datos de PI o de PI AF y redimensiona automticamente la matriz
para que se ajuste a los datos obtenidos.

Manual del usuario de PI DataLink 2016 89


Uso y mantenimiento de las hojas de clculo

Procedimiento
Haga clic con el botn derecho en una celda de la matriz de funcin y, a continuacin, haga
clic en Recalcular (Redimensionar) funcin.
La funcin vuelve a escribir la matriz de funcin, utilizando las entradas actuales, y
redimensiona automticamente la matriz para que se ajuste a los datos obtenidos.

Frecuencia de clculo
PI DataLink escribe una matriz de funcin y calcula los valores actuales de la funcin al hacer
clic en OK o Apply (Aplicar) en el panel de tareas de funcin. Para mantener actualizados lo
datos, debe recalcular la matriz de funcin. En las secciones posteriores se explican los
mtodos para volver a calcular una matriz de funcin.
Para obtener informacin detallada de cmo gestiona Excel el clculo, consulte el tema Excel
Recalculation (http://msdn.microsoft.com/en-us/library/bb687891.aspx) (Reclculo en
Excel) en la biblioteca MSDN.

En esta seccin
Funcin Actualizacin automtica
Reclculo provocado
Recalcular manualmente

Funcin Actualizacin automtica


La funcin Actualizacin automtica inicia de forma automtica un reclculo de las funciones y
tendencias dentro de un determinado intervalo. Se aplica a cualquier libro de clculo abierto en
la misma sesin de Excel. La funcin Actualizacin automtica se detiene al abrir un men,
panel de tareas o ventana o cuando la hoja de clculo actual esta en modo de edicin. No puede
actualizar libros de clculo protegidos que son de solo lectura.
La configuracin de las preferencias afectan a la funcin Actualizacin automtica:
Tipo de actualizacin
Una configuracin de preferencia determina qu funciones se actualizan durante la
actualizacin automtica. Hay dos opciones:

Calcular (F9)
Seleccione esta opcin para volver a calcular las funciones voltiles y cualquier funcin
que haga referencia a ellas durante cada reclculo.
Clculo completo (Ctrl+Alt+Maysculas+F9)
Seleccione esta opcin para volver a calcular todas las funciones, independientemente de
la volatilidad, durante cada reclculo.
Frecuencia de actualizacin
En el campo Intervalo, indique el nmero de segundos entre cada reclculo automtico. El
valor mnimo es cinco segundos. Introduzca 0 para que PI DataLink establezca
automticamente el intervalo como dos veces la duracin del clculo, con un intervalo
mnimo de cinco segundos. OSIsoft recomienda utilizar el intervalo automtico para
garantizar que Excel permanecer receptivo el 50% del tiempo.
Si el reclculo tarda ms que el intervalo especificado, un mensaje pregunta si se desea
cambiar al ajuste de intervalo automtico o desactivar completamente la funcin
Actualizacin automtica.

90 Manual del usuario de PI DataLink 2016


Uso y mantenimiento de las hojas de clculo

Consulte tambin
Administrar configuraciones de PI DataLink
Activar Actualizacin automtica
Cancelacin de Actualizacin automtica

Activar Actualizacin automtica


Active la funcin Actualizacin automtica para recalcular las funciones de PI DataLink
automticamente dentro de un intervalo especificado.

Procedimiento
En la pestaa PI DataLink, haga clic en el botn Actualizar.
Excel recalcula de forma inmediata todas las funciones de PI DataLink en todos los libros
abiertos en la sesin actual de Excel. A continuacin, Excel recalcula de forma automtica
estas funciones dentro del intervalo especificado en los ajustes de preferencia.
Cuando se habilita la funcin Actualizacin automtica, el botn Actualizar se resalta y la
barra de estado muestra un mensaje de indicador.

Consulte tambin
Administrar configuraciones de PI DataLink

Cancelacin de Actualizacin automtica


Cancele la funcin Actualizacin automtica para detener el reclculo automtico de las
funciones de PI DataLink.

Procedimiento
En la pestaa PI DataLink, haga clic en el botn Actualizar para anular la seleccin.
Pulse ESC para cancelar un reclculo en curso. PI DataLink finaliza el clculo de la funcin
actualmente en proceso, muestra Clculo cancelado en las celdas de matriz de funcin
sin procesar y anula la Actualizacin automtica.

Reclculo provocado
Excel vuelve a calcular funciones voltiles y cualquier funcin que haga referencia a una
funcin voltil siempre que se edita una celda de la hoja de clculo o se pulsa F9. Las funciones
voltiles incluyen las funciones de tiempo de Excel: ahora() y hoy(). La funcin Valor actual
es una funcin voltil, en tanto que otras funciones de PI DataLink no lo son. Puede iniciar el
reclculo de funciones de PI DataLink no voltiles haciendo referencia a una funcin voltil
dentro de las funciones no voltiles de PI DataLink.

Basar funciones de PI DataLink en funciones voltiles de Excel


Si no utiliza la funcin Actualizacin automtica, puede maximizar la frecuencia de
actualizacin y mantener las matrices de funcin actualizadas basando las funciones de PI
DataLink en una funcin voltil de Excel.

Manual del usuario de PI DataLink 2016 91


Uso y mantenimiento de las hojas de clculo

Nota:
Para maximizar la frecuencia de actualizaciones cuando no se utiliza Actualizacin
automtica, compruebe sus preferencias de clculo en Excel para asegurarse de que tanto
la hoja de clculo como la aplicacin estn ajustadas a clculo Automtico en lugar de
Manual. Tenga presente que esto podra afectar al rendimiento y dificultar el uso de hojas
de clculo grandes.

Procedimiento
1. Utilice la barra de frmulas de Excel para introducir una funcin voltil en una celda de la
hoja de clculo.
Por ejemplo, puede utilizar (hoy()+1/3) para representar las 8 am del mismo da, o
ahora() como una referencia de celda para remplazar el tiempo PI actual, *.
Para crear una marca de tiempo absoluta que inicie actualizaciones, aada y reste ahora();
por ejemplo, 2-feb-12 00:30:30 + ahora() - ahora().
2. Haga referencia a la celda al definir las entradas Hora de inicio u Hora de finalizacin de una
funcin PI DataLink.

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

Procedimiento
Pulse F9 para forzar el reclculo de todas las funciones voltiles (y cualquier funcin que
haga referencia a ellas).
Pulse Ctrl+Alt+Maysculas+F9 para forzar el reclculo de todas las funciones.
Haga clic en cualquier parte de una matriz de funcin y, a continuacin, haga clic en
Recalcular (Redimensionar) funcin. Este comando escribir la totalidad de la matriz y
redimensionar de forma automtica la raz para que se ajuste a los datos recuperados.

Compartir hojas de clculo


Para compartir datos de PI System con otros, puede compartir hojas de clculo creadas con PI
DataLink. Para determinar la mejor forma de compartir las hojas de clculo, tenga presente lo
siguiente:
Puede enviar un libro de trabajo de PI DataLink a otro usuario de Microsoft Excel. El usuario
debe tener instalado PI DataLink y una conexin activa con el mismo servidor de Archivo de
datos de PI y de PI AF para poder recalcular las funciones y ver valores de PI point y
atributos de PI AF actualizados en forma dinmica.
Los usuarios que no tengan instalado PI DataLink podrn ver los ltimos datos guardados
en la hoja de clculo siempre que la opcin Clculo de libro de trabajo de Excel est
configurada como Manual antes de abrir la hoja de clculo en Excel. Consulte Definir la
opcin Clculo de libro de trabajo como manual.
Tambin puede guardar un libro de trabajo como una pgina web o un archivo PDF para
compartir una versin esttica de la hoja de clculo.
Puede copiar y pegar valores de matrices de funcin en nuevas ubicaciones de una hoja de
clculo mediante el comando Pegado especial. Aunque no se puedan recalcular los datos de
hoja de clculo una vez copiada, este mtodo permite distribuir una instantnea

92 Manual del usuario de PI DataLink 2016


Uso y mantenimiento de las hojas de clculo

personalizada de los datos a cualquier usuario que disponga de una copia de Excel. Consulte
Tareas comunes relacionadas con las matrices de funcin.
Si dispone de Microsoft SharePoint Server en su entorno informtico, puede publicar una
hoja de clculo de PI DataLink en un sitio de SharePoint y utilizar PI DataLink Server
(DLS)para mostrar y volver a calcular los datos de las funciones de PI DataLink.

Definir la opcin Clculo de libro de trabajo como manual


Para permitir a los usuarios sin PI DataLink consultar los datos ms recientes guardados en el
libro de trabajo, defina la opcin Clculo de libro de Excel como Manual antes de guardar un
libro.

Procedimiento
1. Haga clic en la pestaa Archivo y seleccione Opciones. (En Excel 2007, haga clic en el botn
de Microsoft Office y, a continuacin, haga clic en Opciones de Excel.)
2. En el cuadro de dilogo Opciones de Excel, haga clic en Frmulas.
3. En Opciones de clculo, establezca Clculo de libro como Manual y, a continuacin, haga clic
en Aceptar.

Manual del usuario de PI DataLink 2016 93


Uso y mantenimiento de las hojas de clculo

94 Manual del usuario de PI DataLink 2016


Temas avanzados
Los temas incluidos en esa seccin ofrecen informacin til ms detallada para trabajar con las
funciones de PI DataLink.

En esta seccin
Tiempo PI
Expresiones
Entrada manual de funciones
Funciones para escribir datos

Tiempo PI
Puede utilizar una sintaxis especial, denominada PI time, para especificar entradas de marcas
de tiempo e intervalos de tiempo. PI time utiliza abreviaturas especficas, que puede combinar
para crear expresiones temporales.

En esta seccin
Abreviaturas de tiempo PI
Expresiones de tiempo PI
Especificacin de intervalos de tiempo
Especificacin 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 unidades temporales
Abreviatura Versin completa Versin plural Unidad de tiempo correspondiente
s second seconds Second
m minute minutes Minute
h hour hours Hour
d day days Day
mo month months Month
y year years Year
w week weeks Semana

Para especificar unidades de tiempo, puede indicar la abreviatura, el nombre completo o la


versin plural de la unidad de tiempo; por ejemplo, s, second o seconds. Debe incluir un valor
vlido con cualquier unidad de tiempo. Al especificar segundos, minutos y horas, puede utilizar

Manual del usuario de PI DataLink 2016 95


Temas avanzados

un valor fraccionario; por ejemplo, 1.25h. No se pueden utilizar valores fraccionarios con otras
unidades de tiempo.
Abreviaturas de referencia temporal
Abreviatura Versin completa Referencia temporal correspondiente
* Hora actual
t today 00:00:00 (medianoche) del da en curso
y yesterday 00:00:00 (medianoche) del da anterior
sun1 sunday 00:00:00 (medianoche) del domingo ms reciente

jun2 june 00:00:00 (medianoche) del da en curso del mes de junio del
ao actual
dec DD december DD 00:00:00 (medianoche) del da DD de diciembre del ao
actual
YYYY 00:00:00 (medianoche) del da y el mes actual del ao YYYY
M-D o M/D 00:00:00 (medianoche) del da D del mes de M del ao actual
DD 00:00:00 (medianoche) del da DD del mes actual
1: Utilice las tres primeras letras como abreviatura de cualquier da de la semana: sun, mon, tue, wed,

thu, fri o sat.


2: Utilice las tres primeras letras como abreviatura de cualquier mes del ao: jan, feb, mar, apr, may,

jun, jul, aug, sep, oct, nov o dec.

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
direccin del desplazamiento (+ o -) y el intervalo del desplazamiento (una abreviatura de
unidad de tiempo con un valor). Las expresiones de tiempo PI vlidas son:
Solo un punto temporal fijo, como 24-aug-2012 09:50:00
Solo una abreviatura de referencia temporal, como t
Solo un desplazamiento temporal, como +3h
Una abreviatura de referencia temporal con un desplazamiento temporal, como t+3h
Incluya un nico desplazamiento temporal en una expresin. Si incluye varios, los resultados
pueden ser imprevisibles. Por ejemplo, las siguientes expresiones temporales no son vlidas:
*+1d+4h
t-1d+12h

Especificacin de intervalos de tiempo


Para especificar las entradas de las marcas de tiempo, puede introducir expresiones de tiempo
que contengan:
Tiempos fijos
Una hora fija representa siempre la misma hora, independientemente de la hora actual.
Entrada Significado
23-aug-12 15:00:00 3:00 p. m. del 23 de agosto de 2012

96 Manual del usuario de PI DataLink 2016


Temas avanzados

Entrada Significado
25-sep-12 00:00:00 (medianoche) del 25 de septiembre de 2012

Abreviaturas de referencia temporal


Una abreviatura de referencia temporal representa 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 ao actual
2011 00:00:00 (medianoche) del mes y da en curso de 2011
25 00:00:00 (medianoche) del da 25 del mes actual
t 00:00:00 (medianoche) del da en curso (hoy)
y 00:00:00 (medianoche) de la fecha anterior al da en curso (ayer)
tue 00:00:00 (medianoche) del martes ms reciente

Abreviaturas de referencia temporal con compensacin horaria


Cuando se incluye con una abreviatura de referencia temporal, se aade una compensacin
horaria a la hora especificada o se resta de ella.
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.) de antes de 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

Desplazamientos temporales
Cuando se introducen solos, estos desplazamientos temporales especifican una hora relativa
a una hora de referencia implcita. La hora de referencia implcita puede ser la hora de reloj
actual u otra, en funcin de dnde introduzca la expresin.
Entrada Significado
-1d Un da antes de la hora actual
+6h Seis horas despus de la hora actual

Especificacin de intervalos de tiempo


Las entradas de intervalos temporales definen intervalos para recopilar o calcular valores
durante un perodo de tiempo. Por ejemplo, puede especificar un intervalo de 60 minutos para
calcular el promedio por hora para un perodo de 12 horas. Para especificar entradas de
intervalo de tiempo, introduzca un valor y una unidad de tiempo vlidos:
Los valores positivos definen intervalos que comienzan en un momento anterior dentro del
perodo y finalizan en o antes de un momento posterior dentro del perodo.
Hora de inicio 2:00:00
Hora de finalizacin 3:15:00
Intervalo de tiempo 30m

Manual del usuario de PI DataLink 2016 97


Temas avanzados

Intervalos devueltos 2:00:00 a 2:30:00


2:30:00 a 3:00:00

Los valores negativos definen intervalos que finalizan en un momento posterior dentro del
perodo y comienzan en o despus de un momento anterior dentro del perodo.
Hora de inicio 2:00:00
Hora de finalizacin 3:15:00
Intervalo de tiempo -30m
Intervalos devueltos 02:15:00 a 02:45:00
02:45:00 a 03:15:00

Expresiones
En PI DataLink, las expresiones son ecuaciones de rendimiento que se pueden utilizar en
funciones para incorporar operaciones matemticas y clculos basados en elementos de datos
de PI System. Por ejemplo, puede utilizar una expresin en una funcin de PI DataLink para
calcular valores a medida que se obtengan de Archivo de datos de PI.
Nota:
PI DataLink restringe los elementos de datos que se pueden incluir en las expresiones.
Consulte Restricciones relativas a los elementos de datos en expresiones..
Algunas funciones de PI DataLink aceptan un elemento de datos o una expresin como entrada.
Estas funciones tienen las opciones Elemento de datos y Expresin en la parte superior del
panel de tareas. Algunas funciones de PI DataLink tienen tambin el campo Expresin de filtro.
Especifique una expresin de filtro para limitar los valores que devuelve una funcin.
Las funciones de PI DataLink que pueden utilizar expresiones son:
Funcin Valor de archivo histrico
Funcin Datos comprimidos
Funcin Datos de muestra
Funcin Datos temporizados
Funcin Datos calculados
Funcin Filtrado de tiempo
En las siguientes secciones se proporciona informacin bsica sobre las expresiones. PI
DataLink admite la sintaxis, los operadores y las funciones admitidos por Archivo de datos de
PI.
Para obtener una descripcin completa de las ecuaciones de rendimiento y ejemplos, consulte
Archivo de datos de PI Applications User Guide o PI 3 Performance Equations Help File. Puede
descargar estos documentos de la pgina de descargas de soporte tcnico de OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/). Tambin puede consultar estos temas
en la Biblioteca PI Live (http://livelibrary.osisoft.com).

En esta seccin
Uso de expresiones en funciones de PI DataLink
Sintaxis de las expresiones
Restricciones relativas a los elementos de datos en expresiones.
Ejemplos de expresiones

98 Manual del usuario de PI DataLink 2016


Temas avanzados

Expresiones de filtro

Uso de expresiones en funciones de PI DataLink


Utilice expresiones en funciones de PI DataLink para incorporar operaciones matemticas y
clculos basados en elementos de datos de PI System. Las funciones que aceptan un elemento
de datos o una expresin tienen las opciones Elemento de dato y Expresin en la parte
superior del panel de tareas.

Antes de empezar
Abra el panel de tareas de funcin

Procedimiento
1. Haga clic en la opcin Expresin en la parte superior del panel de tareas de funcin.
El campo Elemento(s) de datos se convierte en un campo Expresin(es). La disponibilidad
de otros campos puede variar.
2. Especifique la expresin directamente en el campo Expresin(es) o introduzca una
referencia a una celda que contenga una expresin.
Utilice referencias de celda para especificar varias expresiones para una funcin. Recuerde
que una expresin 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 cualquier PI point o los nombres de atributos de PI AF entre comillas simples.
Si va a introducir una expresin en una celda de Excel, escriba una comilla simple al
principio de la expresin para obligar a Excel a interpretar la expresin como una cadena.
Si va a introducir una expresin en una celda de Excel y la expresin empieza con un PI
point o un nombre de atributo de PI AF, escriba unas comillas dobles al principio de la
expresin.
Si va a introducir un valor para comparar con un PI point digital, especifique un valor
negativo del nmero de cdigo de estado digital.

Restricciones relativas a los elementos de datos en expresiones.


PI DataLink permite los siguientes elementos de datos en expresiones:
PI points
Atributos de PI AF que almacenan referencias de datos a PI points
Atributos de PI AF que almacenan valores constantes
Adems, una funcin de PI DataLink solo puede arrojar datos de un solo servidor de Archivo de
datos de PI. Por lo tanto, todos los PI points de una expresin, incluidos aquellos a los que
hacen referencia los atributos de PI AF, deben almacenarse en el mismo servidor de Archivo de
datos de PI. De forma similar, los PI points de una expresin de filtro deben almacenarse en el
mismo servidor de Archivo de datos de PI que cualquier PI point especificado en los campos
Elemento de datos o Expresin.

Manual del usuario de PI DataLink 2016 99


Temas avanzados

Ejemplos de expresiones
La siguientes expresin 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)
La expresin siguiente se evala como verdadera (distinta de cero) si el valor absoluto del PI
point mytages al menos 14,65:
(abs('mytag') >= 14.65)
La siguiente expresin se evala como true si el valor del atributo de PI AF Manufacturer es
ACME:
('\\Server\Database\Element|Manufacturer' = "ACME")
La siguiente expresin se evala como verdadera si el valor del PI point sinusoid es menor
que 45 y la raz cuadrada del valor del PI point vdf1002 es mayor que 2:
('sinusoid' < 45 and sqr('vdf1002') > 2)

Expresiones de filtro
Utilice una expresin de filtro en una funcin de PI DataLink para filtrar los valores registrados
con una ecuacin de rendimiento booleana. PI DataLink elimina los datos para los que la
expresin se evala como falsa.
PI DataLink aplica la expresin de filtro a los datos recuperados sin procesar (y no a los valores
que resultan del propio clculo). Por ejemplo, si se aade la expresin de filtro simple
'sinusoid' < 70 a la funcin Datos calculados, se eliminarn del clculo todos los valores
iguales o por encima de 70.
Las expresiones de filtro pueden contener cualquier ecuacin de rendimiento booleana vlida;
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 atpicos 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 funcin ha filtrado de la salida en funcin de
la expresin de filtro.

Consulte tambin
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 funcin de PI DataLink,
es posible que los usuarios con ms experiencia prefieran introducir las funciones
directamente en la barra de frmulas de Excel.
Los siguientes temas se refieren a las funciones de PI DataLink introducidas directamente en la
barra de frmulas.

En esta seccin
Definir funciones manualmente
Pautas para introducir argumentos de forma manual

100 Manual del usuario de PI DataLink 2016


Temas avanzados

Cdigos de salida

Definir funciones manualmente


Si no desea utilizar el panel de tareas de funcin, puede definir las funciones de PI DataLink de
forma manual.

Procedimiento
1. Seleccione un intervalo adecuado en la hoja de clculo para la matriz de salida en funcin
del nmero de valores previstos.
2. Introduzca la funcin de PI DataLink y sus argumentos en la barra de frmulas de Excel.
3. Pulse Ctrl+Mays+Intro para situar la funcin de PI DataLink en las celdas de salida
seleccionadas.
Consulte la ayuda en lnea de Microsoft Excel para obtener ms informacin sobre las
frmulas 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 Pauta
argumento
Funciones estndar Puede incluir varias funciones en argumentos que acepten
expresiones. Consulte Archivo de datos de PI Applications User Guide
o PI 3 Performance Equations Help 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 servidor de Archivo de datos de PI denominado casaba,
seleccione una matriz de salida de 1 x 2 e introduzca lo siguiente:
=PICurrVal("sinusoid", 1, "casaba")

Referencias de celda Puede utilizar referencias de celda para cualquier argumento de las
funciones de PI DataLink. Por ejemplo, supongamos que las celdas
de hoja de clculo tienen los siguientes valores:
A1: "sinusoid"
A2: 1
A3: "casaba"
Por lo tanto, la introduccin de la siguiente funcin en la barra de
frmulas:
=PICurrVal(A1, A2, A3)
es equivalente a introducir:
=PICurrVal("sinusoid", 1, "casaba")

Ruta raz 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,"\\DLAFPI\MyTest\Reactor")
Consulte Elementos de datos para obtener informacin sobre las
entradas vlidas.

Manual del usuario de PI DataLink 2016 101


Temas avanzados

Datos introducidos como Pauta


argumento
Cdigos de salida Determina los datos aadidos que devuelve la funcin y la forma en
que la funcin orienta la salida. Consulte Cdigos de salida.

Cdigos de salida
La sintaxis de la funcin de PI DataLink contiene un argumento OutCode de entero. Este
argumento toma un cdigo de salida que determina qu datos aadidos arroja la funcin y la
orientacin de las celdas de salida.
Los paneles de tareas de PI DataLink generan valores de cdigo de salida automticamente. Sin
embargo, si introduce de forma manual una funcin en la barra de frmulas de Excel, tendr
que calcular e incluir un valor de cdigo de salida adecuado.
Un cdigo de salida es una representacin con enteros de bits binarios. En PI DataLink, el
significado del bit depende de la funcin:
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 finalizacin
91 Mostrar tiempo mn/mx
1 Requiere que el bit 1 est tambin habilitado

Con el argumento OutCode configurado como 0, una funcin arroja el valor en una orientacin
de columna sin datos aadidos. Para calcular el argumento OutCode, utilice la siguiente
frmula:

Por ejemplo, con un argumento OutCode de 0, la funcin PISampDat() arroja los valores de
muestra en la celda de salida designada. Con un argumento OutCode de 1, la funcin arroja
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 funcin arroja marcas de tiempo en la fila uno y los

102 Manual del usuario de PI DataLink 2016


Temas avanzados

valores de muestra en la fila dos de una matriz n x 2. (En estos resultados, n es el nmero de los
valores de muestra).
Nota:
Las funciones admiten distintos bits y, por lo tanto, valores de argumento de OutCode.
Aquellos que son vlidos para una funcin no son necesariamente vlidos para otra.
Consulte Referencia de funcin para obtener informacin sobre los bits que cada funcin
admite en su especificacin de OutCode.

Ejemplo
Supongamos que desea que la funcin Datos calculados muestre el porcentaje correcto, la hora
de inicio y el tiempo mn/mx. Para mostrar la hora de inicio y el tiempo mn/mx, debe
activar el bit mostrar marcas de tiempo. Para calcular el argumento OutCode:

En la barra de frmulas de Excel, introduzca:


=PIAdvCalcDat("sinusoid","y","t","1h","minimum","time-weighted", 50, 1,
325,"MyDataServer")
Nota:
Si un argumento OutCode especifica que una funcin debe mostrar varias columnas o
filas, pero la hoja de clculo no las muestra, haga clic con el botn derecho en la matriz de
funcin y seleccione Recalcular/Redimensionar para actualizar la matriz de funcin.

Funciones para escribir datos


A diferencia de las funciones estndar de PI DataLink, que recuperan datos de un servidor de
Archivo de datos de PI o de un servidor de PI AF, las funciones PIPutVal() y PIPutValX()
escriben un valor de una hoja de clculo en un servidor de Archivo de datos de PI o en 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
funcin PIPutVal() o PIPutValX() desde una hoja de macros Excel 4.0. Esta hoja utiliza el
mtodo VBA application.run. Consulte el mdulo putval_code en el archivo
piexam32.xls, distribuido con PI DataLink para Excel de 32 bits, y en 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
funcin como cadena de texto y despus definir la propiedad FormulaArray de un rango de
celdas con el valor de cadena de texto. De este modo, el cdigo VBA puede comprobar los

Manual del usuario de PI DataLink 2016 103


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 tambin
PIPutVal() y PIPutValX()

104 Manual del usuario de PI DataLink 2016


Funciones de tags
Un PI point es un flujo de datos en tiempo real procedentes de una fuente definida. Los
atributos de punto, incluido Tag (es decir, el nombre del PI point) y el origen de punto,
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 pestaa PI DataLink,
en el grupo Tag Functions (Funciones de tag).
Nota:
Debe activar el complemento PI DataLink (Legacy) para utilizar estas funciones (consulte
Configuracin del complemento para Microsoft Excel).

Consulte tambin
Descripcin general de las funciones de PI DataLink
Funcin Propiedades
Tendencias

En esta seccin
Funcin Identificador del punto al tag
Funcin Mscara de atributo para tag
Bsqueda de PI points

Funcin Identificador del punto al tag


La funcin Apuntar ID al Tag devuelve el nombre del PI point correspondiente a un
determinado ID de punto.
Entrada Descripcin
PI Data Archive El servidor de Archivo de datos de PI cuyos datos arroja la funcin. Si no
selecciona un servidor o deja este campo en blanco, la funcin buscar el
servidor de Archivo de datos de PI predeterminado.
Identificador(es) de Uno o varios ID de punto para los que desea que la funcin devuelva nombres
punto de punto.
Necesario.
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.

Consulte tambin
PIPointIDToTag()

Manual del usuario de PI DataLink 2016 105


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 funcin Apuntar ID al Tag:
Entrada Valor
ID de punto A5 (una celda que contiene un ID de punto)

La funcin devuelve la siguiente matriz:

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

Funcin Mscara de atributo para tag


La funcin Mscara de atributo para tag devuelve los nombres de PI points que coinciden con
uno o varios valores de atributos de puntos especficos.
Entrada Descripcin
PI Data Archive El servidor de Archivo de datos de PI cuyos datos arroja la funcin. Si no
selecciona un servidor o deja este campo en blanco, la funcin buscar el
servidor de Archivo de datos de PI predeterminado.
Nombres de tag Valor de atributo de PI point para el que la funcin busca el correspondiente
Descriptor nombre de punto. Debe introducir un valor en un campo de entrada como
mnimo. Utilice el carcter comodn (*) para encontrar todas las coincidencias
Origen de punto o las coincidencias limitadas a determinados caracteres. Por ejemplo,
Tipo de punto 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.
Clase de punto
Unidades de ingeniera
Celda de salida La celda de la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.
Columna Haga clic en esta opcin para arrojar valores en una columna.
Fila Haga clic en esta opcin para arrojar valores en una fila.

Consulte tambin
PIAttributeMaskToTag ()

106 Manual del usuario de PI DataLink 2016


Funciones de tags

Ejemplo de Mscara 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 funcin Mscara de atributo para tag:
Entrada Valor
Nombre de tag BA*
Tipo de punto Float32

La funcin devuelve la siguiente matriz:

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

Bsqueda de PI points
Con las funciones relacionadas con la informacin de tags, utilice la ventana Bsqueda de tags
para consultar Archivo de datos de PI en busca de IDs o de nombres de PI points para insertar
en el panel de tareas.

Procedimiento
1. En el panel de tareas, haga clic en junto al campo Point ID(s) o Nombre(s) de tag.

2. En la ventana Bsqueda de tags, haga clic en la pestaa adecuada para su bsqueda:


Bsqueda bsica
Utilice esta opcin para crear una mscara a partir de determinados atributos de PI point
y buscar puntos que tengan valores de atributo coincidentes.
Bsqueda avanzada
Utilice esta opcin para crear una consulta para una bsqueda compleja que implique
ms atributos de punto que la bsqueda bsica.
Bsqueda de alias
Utilice esta opcin para seleccionar puntos por sus alias descriptivos en PI Module
Database.
3. Introduzca los criterios de bsqueda.
Utilice * o ? como caracteres comodn, segn corresponda. Por ejemplo, configure el campo
Mscara de tag en Tem* para que arroje todos los nombres de punto que comienzan por
Tem, pero configure el campo en Tem? para arrojar solo los puntos que comienzan por Tem y
terminan con otro carcter simple. Los campos de bsqueda no distinguen entre
maysculas y minsculas.
4. Si lo desea, haga clic en Favoritos para acceder a las bsquedas anteriores.

Manual del usuario de PI DataLink 2016 107


Funciones de tags

5. Haga clic en Buscar para encontrar los puntos que coincidan con los criterios especificados.
6. Seleccione el punto deseado en el panel de resultados y haga clic en Aceptar para insertar el
valor en el panel de tareas.

108 Manual del usuario de PI DataLink 2016


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

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

En esta seccin
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 clculo, haga clic en la celda donde desee situar la esquina izquierda superior
de la tendencia.
Al seleccionar la celda, recuerde que la tendencia requiere de forma predeterminada
aproximadamente 14 x 8 celdas estndar.
2. En la pestaa PI DataLink, en el grupo Funciones de tag, haga clic en Insertar tendencia para
abrir el Asistente para complementos de tendencia.
3. Defina uno o varios trazos para incluir en la tendencia. Puede:
Crear un trazo de valores en la hoja de clculo.
Crear un trace de valores de PI point obtenidos de Archivo de datos de PI.
4. Ajuste el aspecto de los trazos de la tendencia. Puede:

Manual del usuario de PI DataLink 2016 109


Tendencias

Seleccionar la casilla en la columna Marcadores para incluir marcadores que indiquen la


ubicacin de puntos de datos archivados.
Nota:
Los traces se dibujan con distintos colores. De forma predeterminada, una
tendencia incluye tambin marcadores ocultos para diferenciar los traces en las
pantallas monocromas. Los marcadores ocultos tienen una separacin regular a lo
largo del trace y no indican puntos de datos archivados.
Seleccionar un trazo y, a continuacin, utilizar los botones de flecha para mover el trazo
hacia arriba o abajo en la leyenda.
Seleccionar un trace y hacer clic en X para eliminar el trace.
Hacer clic en x todo para eliminar todos los traces.
Seleccionar un trace y hacer clic en Cambiar nombre para cambiar el nombre del trace.
5. Haga clic en Siguiente.
6. Si alguno de los traces de la tendencia contiene valores de PI point obtenidos de un servidor
de Archivo de datos de PI, especifique el perodo de tiempo para recuperar valores:
a. Especifique el inicio del perodo en el campo Hora de inicio y el final del periodo en el
campo Hora de finalizacin. 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
continuacin, hacer clic en la celda de hoja de clculo que contenga una cadena de
tiempo o escribir la direccin de esa celda.
Consulte Tiempo PI para ver una explicacin de las cadenas de tiempo vlidas.
b. Seleccione la casilla Activar actualizaciones para actualizar la tendencia con nuevos
datos de Archivo de datos de PI si el intervalo de tiempo cambia o se extiende hasta el
presente.
7. Haga clic en Siguiente.
8. Especifique el ttulo y la colocacin de la tendencia:
a. En el campo Ttulo de tendencia, escriba un ttulo para la tendencia.
b. Anule la seleccin de la casilla Mostrar atributos de valor si no desea que los atributos de
valor aparezcan en los traces 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 una ubicacin diferente para la tendencia. Puede seleccionar:
Hoja de clculo nueva para colocar la tendencia en la esquina superior izquierda de
una hoja de clculo en blanco.
Hoja de clculo existente para colocar la tendencia en la hoja de clculo actual que
empieza en la celda especificada.
Si cambia la celda, asegrese de que la celda nueva no contenga datos.
9. Haga clic en Finalizar.

110 Manual del usuario de PI DataLink 2016


Tendencias

Crear un trazo de valores en la hoja de clculo


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

Procedimiento
1. En el Asistente para complementos de trend, haga clic en Datos de la hoja de clculo.
2. Haga clic en el campo Rango de celdas con datos y, a continuacin, seleccione las celdas que
contengan los valores.
3. Especifique opciones adecuadas para el intervalo de celdas especificado.
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 funcin 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 funcin.
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. Haga clic en Aadir para insertar el trazo en la tendencia.

Crear un trace de valores de PI point obtenidos de Archivo de datos de PI


Cuando se crea una tendencia con el Asistente para complementos de tendencia, puede definir
un trace para la tendencia a partir de los valores obtenidos de Archivo de datos de PI.

Procedimiento
1. En el Asistente para complementos de tendencia, haga clic en Datos de PI.
2. En el campo 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 clculo que contengan nombres
de puntos.
Hacer clic en para abrir la ventana Bsqueda de tags, que puede utilizar para buscar
puntos (consulte Bsqueda de PI points).
3. En el campo Nombre de servidor, especifique el servidor de Archivo de datos de PI 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
continuacin, hacer clic en la celda de hoja de clculo que contenga un servidor o escribir
la direccin de esa celda.
4. Haga clic en Aadir para insertar el trace en la tendencia.

Manual del usuario de PI DataLink 2016 111


Tendencias

Men contextual de tendencias


Utilice el men contextual para actualizar, editar o gestionar una tendencia insertada en una
hoja de clculo. Haga clic con el botn derecho del ratn en una tendencia para abrir un men
con varios comandos:

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 configuracin 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 dilogo 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 lnea de
un trazo o aadir elementos de leyenda a la tendencia.

Definir trend
Abra la pgina de definicin de trazos del asistente de tendencias para actualizar o cambiar
los trazos.

Definir rango temporal de trend


Abra la pgina de definicin del intervalo de tiempo del asistente de tendencias para
actualizar el intervalo.

Eliminar trend
Elimine la tendencia de la hoja de clculo.
Nota:
No se puede restaurar una tendencia eliminada, solo se puede volver a crear.

Exportar datos
Abra el cuadro de dilogo Exportar datos para pegar los valores de la tendencia en filas o
columnas de la hoja de clculo. Tambin puede exportar nombres de trazos como ttulos.

Mover/Cambiar tamao
Abra el cuadro de dilogo Mover/Cambiar tamao 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 dilogo Copiar/Pegar para pegar una copia de la tendencia a una
determinada celda.

112 Manual del usuario de PI DataLink 2016


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 pestaa PI
DataLink, en el grupo Module database. Consulte la documentacin de Archivo de datos de PI
para obtener ms informacin sobre las bases de datos de mdulo y su configuracin.
Nota:
Debe activar el complemento PI DataLink (Legacy) para utilizar estas herramientas
(consulte Configuracin del complemento para Microsoft Excel).

En esta seccin
PI Module Database y hojas de clculo
Insertar objetos de PI Module Database en la hoja de clculo
Funciones de bases de datos de mdulos

PI Module Database y hojas de clculo


PI Module Database es una estructura jerrquica en rbol basada en el contenido de Archivo de
datos de PI. PI Module Database proporciona una forma completamente diferente de crear la
infraestructura de una hoja de clculo. Si la base de datos del mdulo del Archivo de datos de PI
se configura e incluye objetos que representan los PI points que desea utilizar, ser ms
sencillo crear hojas de clculo y proporcionar ms flexibilidad y potencial de reutilizacin.
La configuracin 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 a
sus atributos, respectivamente. La estructura jerrquica de estos objetos proporciona un
contexto relacional entre puntos.
Por ejemplo, puede tener cinco PI points que representen los niveles de cinco tanques
individuales idnticos. Cada punto tiene un nombre distinto (atributo Tag) y representa un
objeto fsico diferente, pero sus requisitos de utilizacin o de supervisin son los mismos.
Mediante la recuperacin de objetos de la base de datos del mdulo, puede crear una nica
hoja de clculo construida con los alias y propiedades que representan los cinco tanques. Las
funciones de la base de datos de mdulo resuelven estos objetos en nombres de punto y
valores de atributo. Las rutas de mdulo paralelas para cada tanque proporcionan un contexto
diferente para las referencias de alias.
Con este tipo de estructura, puede utilizar la misma hoja de clculo para cambiar entre
distintas vistas de varios recursos. Por ejemplo, cuando selecciona el nombre de cualquiera de
los cinco tanques en una hoja de clculo, la asociacin de alias con el PI point coincidente
permite que las funciones de PI DataLink recuperen los valores del tanque apropiado.

Insertar objetos de PI Module Database en la hoja de clculo


Utilice el cuadro de dilogo Buscar mdulo para buscar alias de PI, propiedades y rutas de
mdulos en PI Module Database. Puede seleccionar estos elementos y copiarlos directamente
en una hoja de clculo.
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 2016 113


Objetos de PI Module Database

Procedimiento
1. Seleccione una celda y en PI DataLink haga clic en Buscar mdulo para abrir la ventana
Buscar mdulo.
2. Seleccione el tipo de objeto que est buscando:
Alias
Propiedad
Mdulo
3. En la lista PI Data Archive, seleccione el servidor de Archivo de datos de PI conectado que
contiene la base de datos de mdulo que desea examinar.
4. En la lista Fecha de consulta, especifique la fecha y la hora efectivas de la jerarqua de la
base de datos de mdulo que desea ver.
5. Navegue por la jerarqua de rbol para localizar el elemento deseado.
6. Seleccione el elemento o el objeto de coleccin principal que desea copiar en la hoja de
clculo:
Seleccione un elemento para copiar en la hoja de clculo.
Seleccione un objeto principal (Alias o Propiedades) de un mdulo para copiar todos los
alias o propiedades de ese mdulo en la hoja de clculo.
7. Seleccione la casilla Copiar ruta de mdulo para copiar la ruta de mdulo completa del alias
o la propiedad en una celda de hoja de clculo adyacente.
La ruta de mdulo proporciona el contexto para el objeto seleccionado.
Nota:
Si el ajuste Copiar nombre de PI Data Archive (consulte Administrar configuraciones
de PI DataLink) est activado, PI DataLink tambin copiar el nombre del servidor de
Archivo de datos de PI correspondiente.
8. Haga clic en Aceptar para copiar los elementos seleccionados en la hoja de clculo y cerrar
la ventana.

Funciones de bases de datos de mdulos


Utilice las funciones de base de datos del mdulo PI DataLink para localizar los PI points
correspondientes a los alias y las propiedades de un rbol de base de datos de mdulo. Estas
funciones utilizan la ruta de mdulo. Puede introducir una ruta de mdulo como argumento de
funcin o hacer referencia a l en una celda de hoja de clculo. Podr encontrar estas funciones
de base de datos de mdulo en la pestaa PI DataLink, en el grupo Module Database.
Nota:
La funcin no puede resolver un alias o un objeto de propiedad en un PI point sin una
ruta de mdulo. La ruta proporciona un contexto que correlaciona el alias con un PI point
especfico.

Consulte tambin
Descripcin general de las funciones de PI DataLink

En esta seccin
Funcin Alias para tag
Funcin Propiedad para valor

114 Manual del usuario de PI DataLink 2016


Objetos de PI Module Database

Funcin Alias para tag


La funcin Alias para tag devuelve el nombre del PI point correspondiente a un determinado
alias de PI.
Entrada Descripcin
PI Data Archive El servidor de Archivo de datos de PI cuyos datos arroja la funcin. Si no
selecciona un servidor o deja este campo en blanco, la funcin buscar el
servidor de Archivo de datos de PI predeterminado.
Alias Alias de PI Module Database.
Necesario.
Ruta de mdulo La ruta de mdulo procedente de PI Module Database donde puede
encontrarse el alias especificado. Si especifica Alias cuando navega por
Module Database, PI DataLink introduce la Ruta de mdulo en forma
automtica.
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 la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
El servidor de Archivo de datos de PI cuyos datos arroja la funcin. Si no
selecciona un servidor o deja este campo en blanco, la funcin buscar el
servidor de Archivo de datos de PI predeterminado.
Sin servidor Seleccione esta opcin para recuperar slo el nombre del PI point.
Servidor a la derecha Seleccione esta opcin para mostrar el servidor de Archivo de datos de PI que
almacena el punto en la celda a la derecha del nombre del punto.
Servidor en la parte Seleccione esta opcin para mostrar el servidor de Archivo de datos de PI que
inferior almacena el punto en la celda debajo del nombre del punto.

Consulte tambin
PIAliasToTag()

Funcin Propiedad para valor


La funcin 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 Descripcin
PI Data Archive El servidor de Archivo de datos de PI cuyos datos arroja la funcin. Si no
selecciona un servidor o deja este campo en blanco, la funcin buscar el
servidor de Archivo de datos de PI predeterminado.

Manual del usuario de PI DataLink 2016 115


Objetos de PI Module Database

Entrada Descripcin
Propiedad(es) Una propiedad de PI en PI Module Database.
Necesario.
Ruta de mdulo La ruta de mdulo procedente de PI Module Database donde puede
encontrarse la propiedad especificada. Si especifica Propiedad al navegar por
Module Database, PI DataLink introduce Ruta de mdulo en forma
automtica.
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 la hoja de clculo donde la funcin escribe la matriz de la funcin
resultante. Si selecciona una celda antes de abrir el panel de tareas de
funcin, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de funcin. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, segn
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de la funcin resultante, PI DataLink pega
la frmula de funcin en las celdas de la matriz especificada que no se
necesitan.
Columna Haga clic en esta opcin para arrojar valores en una columna.
Fila Haga clic en esta opcin para arrojar valores en una fila.

Consulte tambin
PIPropertyToValue()

116 Manual del usuario de PI DataLink 2016


Notificaciones
PI DataLink incluye el complemento PI DataLink Notifications. La funcin PI Notifications
Client debe estar instalada en el equipo para poder activar el complemento (consulte
Configuracin del complemento para Microsoft Excel). Al activarse, este complemento aade la
funcin Notification Search (Bsqueda de notificacin) a la pestaa PI DataLink. Utilice la
funcin Bsqueda de notificacin para recuperar notificaciones de PI System a las que se haya
suscrito e insertar estas notificaciones en hojas de clculo.
Nota:
Debe tener una cuenta en, por lo menos, un servidor de PI AF con PI Notifications y estar
suscrito a una regla de notificacin como mnimo para recibir notificaciones.
Para conocer los requisitos de la versin del software, consulte Pgina de productos de
soporte tcnico de OSIsoft (https://techsupport.osisoft.com/Products/) y haga clic en el
enlace del producto de PI DataLink para ver informacin sobre PI DataLink, incluidos los
requisitos actuales del sistema. Para obtener ms informacin sobre PI Notifications,
consulte PI Notifications User Guide.

Para acceder a la funcin Bsqueda de notificacin, haga clic en la celda de salida de la hoja de
clculo que desee y, a continuacin, en la pestaa PI DataLink (en el grupo Notificaciones),
haga clic en Bsqueda de notificacin para abrir la ventana Bsqueda de notificacin.

En esta seccin
Bsqueda e insercin de notificaciones
Notificaciones insertadas
Configuracin de visualizacin de notificaciones

Bsqueda e insercin de notificaciones


Utilice la ventana Bsqueda de notificacin para buscar notificaciones a las que se haya suscrito
desde un servidor de PI AF determinado y, a continuacin, insrtelas en la hoja de clculo. El
servidor de PI AF contiene una base de datos de elementos estructurales y eventos de
notificacin que le permiten trabajar con datos en su servidor de Archivo de datos de PI.

Manual del usuario de PI DataLink 2016 117


Notificaciones

Procedimiento
1. En la pestaa PI DataLink, en el grupo Notificaciones, haga clic en Bsqueda de notificacin
para abrir la ventana Bsqueda de notificacin.
2. En la pestaa Buscar, seleccione el servidor de PI AF en el que buscar las notificaciones:
En la lista PI Systems, seleccione un servidor de 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 aadir un servidor de PI AF a la lista. Consulte Aadir un servidor de PI AF a la
funcin Bsqueda de notificacin.
Haga clic en y, a continuacin, haga clic en una celda de hoja de clculo que contenga
el nombre de un servidor de PI AF.
Vuelva a hacer clic en el botn para mostrar la lista PI Systems.
3. En lalista Ver notificaciones, seleccione la opcin de filtrado de las notificaciones arrojadas:
Seleccione Activa para mostrar todas las notificaciones activas actualmente.
Seleccione Intervalo de tiempo e introduzca valores en Hora de inicio y Hora de
finalizacin para mostrar las notificaciones que se produzcan a lo largo de un intervalo
de tiempo especfico.
Seleccione Reciente e introduzca un valor y un intervalo de tiempo para mostrar las
notificaciones ms recientes de un perodo de tiempo especfico.
4. En el campo Celda de salida, especifique la celda de la hoja de clculo en la que desea
insertar las notificaciones.
5. Haga clic en Buscar para recuperar las notificaciones que coincidan con determinados
criterios en el rea de resultados en la parte inferior de la pestaa.
6. Examine las notificaciones recuperadas. Puede:
Ajustar la visualizacin de las notificaciones recuperadas
Gestionar las notificaciones recuperadas
7. Hacer clic en Aceptar para insertar las notificaciones mostradas en la hoja de clculo y
cerrar el cuadro de dilogo.
PI DataLink inserta la consulta de notificacin en la hoja de clculo como matriz de funcin
en la ubicacin designada. Al igual que otras funciones de PI DataLink, la funcin Bsqueda
de notificacin actualiza los datos cuando se recalcula la hoja de clculo. Consulte Reclculo
provocado.

Aadir un servidor de PI AF a la funcin Bsqueda de notificacin


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 aadir
el servidor a la lista PI Systems que mantiene la funcin Bsqueda de notificacin.

Antes de empezar
Suscrbase a las notificaciones en PI System Explorer.

118 Manual del usuario de PI DataLink 2016


Notificaciones

Procedimiento
1. En la pestaa Buscar de la ventana Bsqueda de notificacin, haga clic en Mostrar lista
junto a la lista PI Systems para abrir la ventana Servidores AF.

2. Haga clic en Aadir servidor AF para abrir el cuadro de dilogo Propiedades de servidor de PI
AF.
3. Introduzca la informacin de red pertinente para localizar el servidor PI AF y para
autenticar su equipo en ese servidor.
a. En el campo Nombre, introduzca el nombre que identificar al servidor de PI AF en la
funcin Bsqueda de notificacin.
b. Haga clic en Configurar Active Directory para configurar el acceso a Active Directory para
obtener informacin de inicio de sesin.
4. Haga clic en Aceptar para guardar las propiedades y aadirlo a la lista de servidores de PI
AF.
5. Haga clic en Aceptar para cerrar el cuadro de dilogo Servidores AF.
El servidor de PI AF aparece en la lista PI Systems. Para obtener ms informacin sobre los
servidores de PI AF, consulte la documentacin relativa a PI AF.

Ajustar la visualizacin de las notificaciones recuperadas


En el cuadro de dilogo Notification Search, el rea de resultados situada en la parte inferior de
la pestaa Search muestra las notificaciones que coinciden con los criterios de bsqueda
especificados. Puede ajustar la visualizacin de estas notificaciones.

Procedimiento
Haga clic en las cabeceras de columna para ordenar notificaciones segn un atributo
determinado.
Haga clic con el botn derecho en los resultados para mostrar y ocultar columnas:
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 visualizacin de los
eventos de contacto para cada notificacin.

Manual del usuario de PI DataLink 2016 119


Notificaciones

Gestionar las notificaciones recuperadas


En el cuadro de dilogo Notification Search, el rea de resultados situada en la parte inferior de
la pestaa Search muestra las notificaciones que coinciden con los criterios de bsqueda
especificados. Antes de insertar las notificaciones obtenidas en la hoja de clculo, puede
evaluar, gestionar y responder a estas notificaciones.

Procedimiento
Haga clic con el botn derecho en una notificacin y elija un comando.
Acknowledge Instance
Reconocimiento de que se ha llevado a cabo una accin en respuesta a la notificacin y de
que no es necesario escalar la notificacin. Si lo desea, introduzca un comentario y haga
clic en Aceptar.
Acknowledge Subscription
Acusar recibo de una notificacin a la que est suscrito. Si lo desea, introduzca un
comentario y haga clic en Aceptar.
Add Comment
Comentario sobre una notificacin.
View Notification Rule Summary
Muestra las propiedades de la regla de notificacin que ha desencadenado la notificacin
seleccionada.

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

Si sus notificaciones estn ajustadas para mostrar confirmaciones, dichas columnas incluyen
enlaces a pginas web de PI Notifications en las que podr confirmar o comentar una
notificacin.
Para obtener ms informacin sobre notificaciones, suscripcin y confirmacin, consulte el
Manual de usuario de PI Notifications.

Configuracin de visualizacin de notificaciones


Utilice la pestaa Display Format del cuadro de dilogo Notification Search para especificar el
aspecto de las notificaciones insertadas en las celdas de hoja de clculo. Puede seleccionar las
columnas que se mostrarn y cambiar la forma en que estn organizadas y el formato.

120 Manual del usuario de PI DataLink 2016


Notificaciones

Columnas
Seleccione columnas en la lista Available columns y haga clic en Add para moverlas a la lista
Column order, que especifica los datos que se insertarn en la hoja de clculo.
Nota:
Incluya la columna Acknowledge para aadir un enlace a la hoja de clculo para
confirmar la recepcin e incluya la columna Acknowledge With Comment para aadir
un enlace en la hoja de clculo para comentar una notificacin.
Haga clic en Add All para mover todas las columnas a la lista Column order.
Seleccione columnas de la lista Column order y haga clic en los botones de flecha situados
encima de la lista para cambiar el orden de las columnas.
Seleccione columnas en la lista Column order y haga clic en Remove para eliminar las
columnas seleccionadas de la lista.
Haga clic en Clear para eliminar todas las columnas de la lista Column order.

Eventos de contacto
Seleccione la casilla Display contact events para incluir eventos de contacto relacionados
con cada notificacin, como el envo a cada destinatario, comentarios y confirmaciones.
Seleccione la casilla Indent contacts para aadir un sangrado a los eventos de contacto en la
hoja de clculo. Esto ayuda a identificarlos.
Seleccione Using separate columns para aadir una segunda columna para eventos de
contactos.
Seleccione Formatting cells para aadir un sangrado a los eventos de contacto en la
misma columna que los eventos de notificacin.
Seleccione la casilla Group notifications with Excel grouping para utilizar la funcionalidad
de agrupacin de Excel para anidar eventos de contactos bajo las notificaciones primarias
individuales que los generan.
Nota:
PI DataLink Server (DLS) no admite la agrupacin de Excel.

Manual del usuario de PI DataLink 2016 121


Notificaciones

Presentacin y orientacin
Seleccione la casilla Display column headers para aadir cabeceras de columna y fila sobre
los datos de notificaciones.
Seleccione la casilla Display count para aadir 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.

122 Manual del usuario de PI DataLink 2016


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

En esta seccin
Funciones de valor nico
Funciones de valor mltiple
Funciones de clculo
Funciones de tags
Funciones de Module Database
Funciones de entrada
Funciones obsoletas

Funciones de valor nico


Las funciones de valor nico recuperan el valor de un elemento de datos en un punto especfico
en el tiempo. Recuperan exactamente un valor por elemento de datos.

En esta seccin
PICurrVal()
PIArcVal()
PIExpVal()
PITagAtt()

PICurrVal()
Arroja el valor ms reciente de un PI point histrico o de un atributo de PI AF. Para un PI point
de datos futuros, el valor arrojado depende de las marcas de tiempo de los valores registrados
relacionados con la hora actual:
Si todos los valores registrados tienen marcas de tiempo anteriores a la hora actual, la
funcin arroja el ltimo valor registrado.
Si los valores registrados tienen marcas de tiempo que abarcan la hora actual, la funcin
arroja un valor interpolado.
Si todos los valores registrados tienen marcas de tiempo posteriores a la hora actual, la
funcin no arroja datos.
Esta funcin admite llamadas a granel.

Sintaxis
PICurrVal(DataItem, OutCode, RootPath)

Manual del usuario de PI DataLink 2016 123


Referencia de funcin

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja 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.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1 y 2.
RootPath Cadena La ruta al elemento de datos al que hace referencia
la expresin. Consulte Elementos de datos.

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

Arroja el valor actual y la marca de tiempo correspondiente para el PI point let439 del
servidor de Archivo de datos de PI denominado holden y coloca la marca de tiempo en la
columna a la izquierda del valor.

Consulte tambin
Funcin Valor actual
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Recuperacin de grandes cantidades de datos
Valores interpolados

PIArcVal()
Recupera el valor de un PI point o un atributo de PI AF para una marca de tiempo especfica.
Esta funcin admite llamadas a granel.

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

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja 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
funcin. Consulte Campos de entrada de tiempo.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1 y 2.

124 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.
Mode Cadena Mtodo que la funcin utiliza para obtener valores:
previous
previous only
interpolated
auto
next
next only
exact time

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

Arroja el valor interpolado del PI point cdep158 a las 7:20 p. m. del 11 de diciembre de 1992
procedente del servidor de Archivo de datos de PI denominado casaba.

Consulte tambin
Funcin Valor de archivo histrico
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados
Recuperacin de grandes cantidades de datos

PIExpVal()
Recupera el valor calculado de una ecuacin de rendimiento para una marca de tiempo
especfica.

Sintaxis
PIExpVal(Expression, TimeStamp, OutCode, RootPath)

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una o varias ecuaciones de rendimiento para las que la
funcin calcula un valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
arrojar valores para cada una de ellas.

TimeStamp Cadena La marca de tiempo para la que devuelve valores la funcin.


Consulte Campos de entrada de tiempo.
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo. Esta funcin admite los bits 1 y 2.
RootPath Cadena La ruta al elemento de datos al que hace referencia la
expresin. Consulte Elementos de datos.

Manual del usuario de PI DataLink 2016 125


Referencia de funcin

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

Calcula la raz cuadrada del valor del PI point sinusoid procedente del servidor de Archivo de
datos de PI denominado thevax en la medianoche de ayer.

Consulte tambin
Funcin Valor de archivo histrico
Definir funciones manualmente
Pautas para introducir argumentos de forma manual

PITagAtt()
Recupera un valor de propiedad asociado con un elemento de datos especfico.

Sintaxis
PITagAtt(DataItem, Property, RootPath)

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja 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.
Property Cadena El atributo del PI point o la propiedad del atributo
de PI AF para los que la funcin devuelve un valor.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.

Ejemplo
=PITagAtt(d1,"uom",)

Arroja las unidades de ingeniera del PI point especificado en la celda D1 del servidor
predeterminado de Archivo de datos de PI.

Consulte tambin
Funcin Propiedades

Funciones de valor mltiple


Las funciones de valor mltiple 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 seccin
PINCompDat()
PINCompFilDat()
PICompDat()
PICompFilDat()

126 Manual del usuario de PI DataLink 2016


Referencia de funcin

PISampDat()
PISampFilDat()
PIExpDat()
PITimeDat()
PITimeExpDat()

PINCompDat()
Recupera un nmero especfico 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 Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para arrojar valores para cada uno de ellos.
STime Cadena El inicio del perodo de tiempo para el que la
funcin arroja valores. Consulte Campos de
entrada de tiempo.
NumVals Entero El nmero de valores que la funcin recupera, a
partir de STime (especifique un nmero negativo
para recuperar valores hacia atrs en el tiempo).
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1, 2, 5 y 6.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.
Mode Cadena Mtodo que la funcin utiliza para determinar qu
valores se recuperarn cerca de la hora de inicio
(tipo de lmite):
inside
outside
interpolated
auto

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

Arroja diez valores y sus marcas de tiempo correspondientes procedentes del servidor
predeterminado de Archivo de datos de PI para el PI point cdf144 a partir de la 1:00 a. m. de
esta maana, con el tipo de lmite inside.

Consulte tambin
Funcin Datos comprimidos
Definir funciones manualmente

Manual del usuario de PI DataLink 2016 127


Referencia de funcin

Pautas para introducir argumentos de forma manual


Valores interpolados

PINCompFilDat()
Recupera un nmero especfico 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 Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja 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 perodo de tiempo para el que la
funcin arroja valores. Consulte Campos de
entrada de tiempo.
NumVals Entero El nmero de valores que la funcin recupera, a
partir de STime (especifique un nmero negativo
para recuperar valores hacia atrs en el tiempo).
FiltExp Cadena Una ecuacin de rendimiento booleana que la
funcin utiliza para filtrar valores. Cuando la
expresin se evala como falsa, la funcin excluye
los valores correspondientes. Consulte
Expresiones de filtro.
FiltCode Entero Cdigo que indica si deben etiquetarse los valores
filtrados:
1
Inserte la etiqueta Filtered en lugar de un
valor o un bloque de valores que la funcin ha
filtrado de la salida en funcin de FiltExp.
0
No etiquetar valores filtrados.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1, 2, 5 y 6.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.
Mode Cadena Mtodo que la funcin utiliza para determinar qu
valores se recuperarn cerca de la hora de inicio
(tipo de lmite):
inside
outside
interpolated
auto

128 Manual del usuario de PI DataLink 2016


Referencia de funcin

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

Arroja diez valores y las marcas de tiempo correspondientes procedentes del servidor
predeterminado de Archivo de datos de PI para el PI point cdf144 a partir de las 2:00 a. m. de
esta maana, cuando el punto cdep158 es mayor que 38, con el tipo de lmite inside.
La salida contiene la etiqueta Filtered entre todos los valores en los que la condicin de filtro
ha sido falsa.

Consulte tambin
Funcin Datos comprimidos
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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

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

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para arrojar valores para cada uno de ellos.
STime Cadena El inicio del perodo de tiempo para el que la
funcin arroja valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la
funcin arroja valores.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1, 2, 4, 5 y 6.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.
Mode Cadena Mtodo que la funcin utiliza para determinar qu
valores se recuperarn cerca de la hora de inicio
(tipo de lmite):
inside
outside
interpolated
auto

Manual del usuario de PI DataLink 2016 129


Referencia de funcin

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

Arroja valores y sus marcas de tiempo correspondientes procedentes del servidor


predeterminado de Archivo de datos de PI para el PI point cdf144 de la 1:00 a. m. a las
3:00 a. m. de esta maana, con el tipo de lmite inside.

Consulte tambin
Funcin Datos comprimidos
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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

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

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para arrojar valores para cada uno de ellos.
STime Cadena El inicio del perodo de tiempo para el que la
funcin arroja valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la
funcin arroja valores.
FiltExp Cadena Una ecuacin de rendimiento booleana que la
funcin utiliza para filtrar valores. Cuando la
expresin se evala como falsa, la funcin excluye
los valores correspondientes. Consulte
Expresiones de filtro.
FiltCode Entero Cdigo que indica si deben etiquetarse los valores
filtrados:
1
Inserte la etiqueta Filtered en lugar de un
valor o un bloque de valores que la funcin ha
filtrado de la salida en funcin de FiltExp.
0
No etiquetar valores filtrados.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1, 2, 4, 5 y 6.

130 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.
Mode Cadena Mtodo que la funcin utiliza para determinar qu
valores se recuperarn cerca de STime o ETime
(tipo de lmite):
inside
outside
interpolated
auto

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

Arroja valores y sus marcas de tiempo correspondientes para el PI point cdf144 procedentes
del servidor predeterminado de Archivo de datos de PI, de las 2:00 a. m. a las 10:00 a. m.,
cuando el PI point cdep158 es mayor que 38, con el tipo de lmite inside.
La salida contiene la etiqueta Filtered entre todos los valores en los que la condicin de filtro
ha sido falsa.

Consulte tambin
Funcin Datos comprimidos
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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 Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para arrojar valores para cada uno de ellos.
STime Cadena El inicio del perodo de tiempo para el que la
funcin arroja valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la
funcin arroja valores.

Manual del usuario de PI DataLink 2016 131


Referencia de funcin

Argumento Tipo Descripcin


Interval Cadena El intervalo entre valores arrojados. Introduzca un
valor y la unidad temporal que especifica la
duracin del intervalo. Por ejemplo, introduzca
15m (15 minutos) para arrojar un valor por cada
intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de
tiempo.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1 y 2.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.

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

Arroja datos de muestra y las marcas de tiempo correspondientes para el PI point sinusoid
procedentes del servidor predeterminado de Archivo de datos de PI, desde la medianoche de
ayer hasta la medianoche de hoy, e informa valores en intervalos de tres horas.

Consulte tambin
Funcin Datos de muestra
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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,
RootPath)

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para el que la funcin arroja valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para arrojar valores para cada uno de ellos.
STime Cadena El inicio del perodo de tiempo para el que la
funcin arroja valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la
funcin arroja valores.

132 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


Interval Cadena El intervalo entre valores arrojados. Introduzca un
valor y la unidad temporal que especifica la
duracin del intervalo. Por ejemplo, introduzca
15m (15 minutos) para arrojar un valor por cada
intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de
tiempo.
FiltExp Cadena Una ecuacin de rendimiento booleana que la
funcin utiliza para filtrar valores. Cuando la
expresin se evala como falsa, la funcin excluye
los valores correspondientes. Consulte
Expresiones de filtro.
FiltCode Entero Cdigo que indica si deben etiquetarse los valores
filtrados:
1
Inserte la etiqueta Filtered en lugar de un
valor o un bloque de valores que la funcin ha
filtrado de la salida en funcin de FiltExp.
0
No etiquetar valores filtrados.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1 y 2.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.

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

Arroja datos de muestra para el PI point sinusoid procedentes del servidor predeterminado
de Archivo de datos de PI. La funcin recupera valores en la medianoche del 11 de enero
de 1997, a la 1:00 a. m. del 11 de enero de 1997, a las 2:00 a. m. del 11 de enero de 1997 y a las
3:00 a. m. del 11 de enero de 1997. Si no se ha satisfecho la condicin de la celda A1 en alguna
de esas horas, la funcin arroja la etiqueta Filtered para esa hora. La funcin muestra marcas
de tiempo en la primera columna y valores en la segunda columna.

Consulte tambin
Funcin Datos de muestra
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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

Manual del usuario de PI DataLink 2016 133


Referencia de funcin

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

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una o varias ecuaciones de rendimiento para las
que la funcin calcula un valor. Consulte
Expresiones.
Incluya un rango de celdas que contenga
expresiones para arrojar valores para cada una de
ellas.

STime Cadena El inicio del perodo de tiempo para el que la


funcin calcula un valor. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la
funcin calcula un valor.
Interval Cadena El intervalo entre valores arrojados. Introduzca un
valor y la unidad temporal que especifica la
duracin del intervalo. Por ejemplo, introduzca
15m (15 minutos) para arrojar un valor por cada
intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de
tiempo.
OutCode Entero Cdigo de salida que determina los datos aadidos
que arroja la funcin y la forma en que la funcin
orienta la salida. Consulte Cdigos de salida para
obtener informacin sobre cmo calcular el cdigo.
Esta funcin admite los bits 1 y 2.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.

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

Calcula la raz cuadrada del valor del PI point sinusoid recuperado del servidor de Archivo de
datos de PI denominado thevax a intervalos de una hora, desde la medianoche de ayer hasta la
medianoche de hoy:
La funcin muestra la marca de tiempo de cada valor en la columna situada a la izquierda del
valor calculado.

Consulte tambin
Funcin Datos de muestra
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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

134 Manual del usuario de PI DataLink 2016


Referencia de funcin

Sintaxis
PITimeDat(DataItem, TimeStamps, RootPath, Mode)

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
el que la funcin arroja valores. Especifique un rango de
celdas que contengan nombres de PI point o nombres de
atributos de PI AF para arrojar valores para cada uno de ellos.
TimeStamps Referencia Referencia a una o a varias celdas de hoja de clculo que
contienen marcas de tiempo para las que la funcin arroja
valores. Consulte Campos de entrada de tiempo.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos de datos.
Mode Cadena Mtodo que la funcin utiliza para obtener datos:
interpolated
exact time

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

Ejemplo
=PITimeDat("mytag",b1:b12,,"interpolated")

Recupera valores interpolados con las marcas de tiempo ubicadas en las celdas B1 a B12 para
el PI point mytag en el servidor predeterminado de Archivo de datos de PI.
Esta funcin requiere una matriz de salida horizontal de doce celdas; por ejemplo, C1:C12 o
B14:B25.

Consulte tambin
Funcin Datos temporizados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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

Sintaxis
PITimeExpDat(Expression, TimeStamps, RootPath)

Manual del usuario de PI DataLink 2016 135


Referencia de funcin

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una o varias ecuaciones de rendimiento para las
que la funcin calcula un valor. Consulte
Expresiones.
Incluya un rango de celdas que contenga
expresiones para arrojar valores para cada una de
ellas.

TimeStamps Referencia Referencia a una o a varias celdas de hoja de


clculo que contienen marcas de tiempo para las
que la funcin arroja valores. Consulte Campos de
entrada de tiempo.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos
de datos.

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

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

Calcula la raz cuadrada del valor del PI point sinusoid recuperado del servidor
predeterminado de Archivo de datos de PI a las horas especificadas en las celdas B1 a B12.
Esta funcin requiere una matriz de salida horizontal de doce celdas; por ejemplo, C1:C12 o
B14:B25.

Consulte tambin
Funcin Datos temporizados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual

Funciones de clculo
Las funciones de clculo 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 especfico.

En esta seccin
PIAdvCalcVal()
PIAdvCalcFilVal()
PIAdvCalcExpVal()
PIAdvCalcExpFilVal()
PIAdvCalcDat()
PIAdvCalcFilDat()
PIAdvCalcExpDat()

136 Manual del usuario de PI DataLink 2016


Referencia de funcin

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. Esta funcin admite llamadas a granel.

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

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
el que la funcin 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 perodo de tiempo para el que la funcin calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
un valor.
Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)
CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted
MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.
CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo. Esta funcin admite los bits 2, 3 y 9
(si Mode est configurado como minimum, maximum o range).
RootPath Cadena La ruta al elemento de datos. Consulte Elementos de datos.

Ejemplo
=PIAdvCalcVal("cdf144","y","t","total","time-weighted",50,1,4,)

Manual del usuario de PI DataLink 2016 137


Referencia de funcin

Arroja un total con ponderacin temporal para el PI point cdf144 calculado a partir de los
valores del servidor predeterminado de Archivo de datos de PI de ayer a hoy.
La funcin multiplica el resultado por 1 y slo devuelve un resultado si al menos un 50 por
ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la derecha del
total calculado.

Consulte tambin
Funcin Datos calculados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Recuperacin de grandes cantidades de datos

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 Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
el que la funcin 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 perodo de tiempo para el que la funcin calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
un valor.
FiltExp Cadena Una ecuacin de rendimiento booleana que la funcin utiliza
para filtrar valores. Cuando la expresin se evala como falsa,
la funcin excluye los valores correspondientes. Consulte
Expresiones de filtro.
Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)
CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted

138 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


SampMode Cadena Mtodo de muestreo que la funcin utiliza para determinar
cundo evaluar FiltExp:
compressed
interpolated
SampFreq Cadena La frecuencia con la que la funcin evala FiltExp si
SampMode est configurado en interpolated. Introduzca
un valor y una unidad de tiempo. Por ejemplo, defina en 10m
(10 minutos) para arrojar un valor interpolado por cada
intervalo de 10 minutos. Consulte Especificacin de
intervalos de tiempo
MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.
CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo. Esta funcin admite los bits 2, 3 y 9
(si Mode est configurado como minimum, maximum o range).
RootPath Cadena La ruta al elemento de datos. Consulte Elementos de datos.

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

Arroja el total de ponderacin temporal para el PI point cdf144 calculado a partir de los
valores de servidor predeterminado de Archivo de datos de PI, mediante la suma de los valores
de ayer a hoy durante los perodos de tiempo en que el PI point cdm158 se ha establecido como
Manual.
La funcin multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la
funcin ignora la frecuencia de muestreo y realiza un muestreo de la expresin de filtro en los
eventos comprimidos del punto cdf144. La funcin solo devuelve un resultado si al menos un
50 por ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la
derecha del total calculado.

Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

PIAdvCalcExpVal()
Devuelve un valor calculado a partir de una ecuacin de rendimiento durante un determinado
perodo de tiempo.

Manual del usuario de PI DataLink 2016 139


Referencia de funcin

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

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una o varias ecuaciones de rendimiento para las que la
funcin calcula un valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
arrojar valores para cada una de ellas.

STime Cadena El inicio del perodo de tiempo para el que la funcin calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
un valor.
Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)
CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted
SampMode Cadena Mtodo de muestreo que la funcin utiliza para determinar
cundo evaluar Expression:
compressed
interpolated
SampFreq Cadena La frecuencia con la que la funcin evala Expression si
SampMode est configurado en interpolated. Introduzca un
valor y una unidad de tiempo. Por ejemplo, defina en 10m
(10 minutos) para arrojar un valor interpolado por cada
intervalo de 10 minutos. Consulte Especificacin de
intervalos de tiempo
MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.
CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2, 3 y 9 (si Mode est configurado
como minimum, maximum o range).

140 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


RootPath Cadena La ruta al elemento de datos al que hace referencia la
expresin. Consulte Elementos de datos.

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

Arroja el total con ponderacin temporal para la expresin 'cdf144'+'cdt158' calculado a


partir de los valores del servidor predeterminado de Archivo de datos de PI, mediante la
utilizacin de valores de ayer a hoy:
La funcin multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la
funcin ignora la frecuencia de muestreo y realiza un muestreo de la expresin de filtro en los
eventos comprimidos combinados de cdf144 y cdt158. La funcin solo devuelve un resultado
si al menos un 50 por ciento de los datos son correctos. La funcin devuelve el porcentaje
correcto a la derecha del total calculado.

Consulte tambin
Funcin Datos calculados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

PIAdvCalcExpFilVal()
Devuelve un valor filtrado de PI point calculado en funcin de una ecuacin de rendimiento.

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

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una o varias ecuaciones de rendimiento para las que la
funcin calcula un valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
arrojar valores para cada una de ellas.

STime Cadena El inicio del perodo de tiempo para el que la funcin calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
un valor.
FiltExp Cadena Una ecuacin de rendimiento booleana que la funcin utiliza
para filtrar valores. Cuando la expresin se evala como falsa,
la funcin excluye los valores correspondientes. Consulte
Expresiones de filtro.

Manual del usuario de PI DataLink 2016 141


Referencia de funcin

Argumento Tipo Descripcin


Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)
CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted
SampMode Cadena Mtodo de muestreo que la funcin utiliza para determinar
cundo evaluar Expression y FiltExp:
compressed
interpolated
SampFreq Cadena La frecuencia con la que la funcin evala Expression y
FiltExp si SampMode est configurado en interpolated.
Introduzca un valor y una unidad de tiempo. Por ejemplo,
defina en 10m (10 minutos) para arrojar un valor interpolado
por cada intervalo de 10 minutos. Consulte Especificacin de
intervalos de tiempo.
MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.
CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2, 3 y 9 (si Mode est configurado
como minimum, maximum o range).

RootPath Cadena La ruta al elemento de datos al que hace referencia la


expresin. Consulte Elementos de datos.

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

Arroja el total con ponderacin temporal para la expresin 'cdf144'+'cdt158' calculado a


partir de los valores del servidor predeterminado de Archivo de datos de PI cuando
'productid' = "Product2" utiliza valores de ayer a hoy.
La funcin multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la
funcin ignora la frecuencia de muestreo y realiza un muestreo de la expresin de filtro en los
eventos comprimidos combinados de cdf144 y cdt158. La funcin solo devuelve un resultado
si al menos un 50 por ciento de los datos son correctos. La funcin devuelve el porcentaje
correcto a la derecha del total calculado.

142 Manual del usuario de PI DataLink 2016


Referencia de funcin

Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

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,
CFactor, OutCode, RootPath)

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
el que la funcin 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 perodo de tiempo para el que la funcin calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
valores.
Interval Cadena El intervalo entre valores arrojados. Introduzca un valor y la
unidad temporal que especifica la duracin del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para arrojar un valor
por cada intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de tiempo.
Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)
CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted
MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.

Manual del usuario de PI DataLink 2016 143


Referencia de funcin

Argumento Tipo Descripcin


CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2, 3, 7, 8 y 9 (si Mode est
configurado como minimum, maximum o range).

RootPath Cadena La ruta al elemento de datos. Consulte Elementos de datos.

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

Arroja el total con ponderacin temporal para el PI point cdf144 calculado a partir de los
valores del servidor predeterminado de Archivo de datos de PI en intervalos de tres horas
desde la medianoche de ayer a la medianoche de hoy.
La funcin multiplica el resultado por 1 y slo devuelve un resultado si al menos un 50 por
ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la derecha de
cada total calculado.

Consulte tambin
Funcin 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 Descripcin
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
el que la funcin 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 perodo de tiempo para el que la funcin calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
valores.

144 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


Interval Cadena El intervalo entre valores arrojados. Introduzca un valor y la
unidad temporal que especifica la duracin del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para arrojar un valor
por cada intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de tiempo.
FiltExp Cadena Una ecuacin de rendimiento booleana que la funcin utiliza
para filtrar valores. Cuando la expresin se evala como falsa,
la funcin excluye los valores correspondientes. Consulte
Expresiones de filtro.
Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)
CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted
SampMode Cadena Mtodo de muestreo que la funcin utiliza para determinar
cundo evaluar FiltExp:
compressed
interpolated
SampFreq Cadena La frecuencia con la que la funcin evala FiltExp si
SampMode est configurado en interpolated. Introduzca
un valor y una unidad de tiempo. Por ejemplo, defina en 10m
(10 minutos) para arrojar un valor interpolado por cada
intervalo de 10 minutos. Consulte Especificacin de
intervalos de tiempo
MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.
CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2, 3, 7, 8 y 9 (si Mode est
configurado como minimum, maximum o range).

RootPath Cadena La ruta al elemento de datos. Consulte Elementos de datos.

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

Arroja el total con ponderacin temporal para el PI point cdf144 calculado a partir de los
valores del servidor predeterminado de Archivo de datos de PI en intervalos de tres horas a

Manual del usuario de PI DataLink 2016 145


Referencia de funcin

partir de la medianoche de ayer a la medianoche de hoy cuando el PI point cdf144 se ha


establecido como Manual.
La funcin multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la
funcin ignora la frecuencia de muestreo y realiza un muestreo de la expresin de filtro en los
eventos comprimidos de cdf144. La funcin solo devuelve un resultado si al menos un 50 por
ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la derecha del
total calculado.

Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

PIAdvCalcExpDat()
Devuelve valores espaciados regularmente calculados a partir de una ecuacin de rendimiento
durante un determinado perodo de tiempo.

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

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una o varias ecuaciones de rendimiento para las que la
funcin calcula un valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
arrojar valores para cada una de ellas.

STime Cadena El inicio del perodo de tiempo para el que la funcin calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
valores.
Interval Cadena El intervalo entre valores arrojados. Introduzca un valor y la
unidad temporal que especifica la duracin del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para arrojar un valor
por cada intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de tiempo.
Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)

146 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted
SampMode Cadena Mtodo de muestreo que la funcin utiliza para determinar
cundo evaluar Expression:
compressed
interpolated
SampFreq Cadena La frecuencia con la que la funcin evala Expression si
SampMode est configurado en interpolated. Introduzca un
valor y una unidad de tiempo. Por ejemplo, defina en 10m
(10 minutos) para arrojar un valor interpolado por cada
intervalo de 10 minutos. Consulte Especificacin de
intervalos de tiempo
MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.
CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2, 3, 7, 8 y 9 (si Mode est
configurado como minimum, maximum o range).

RootPath Cadena La ruta al elemento de datos al que hace referencia la


expresin. Consulte Elementos de datos.

Ejemplo
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total", "time-
weighted","compressed", "10m",50,1,4,)

Calcula la expresin 'cdf144'+'cdt158' con cualquier marca de tiempo entre la medianoche


de ayer y la medianoche de hoy con un valor registrado almacenado en el servidor
predeterminado de Archivo de datos de PI y, a continuacin, calcula el total con ponderacin
temporal de los valores calculados en intervalos de tres horas.
La funcin multiplica cada total calculado por 1 y devuelve un valor cuando el porcentaje de
valores correctos es como mnimo del 50% durante el intervalo de tres horas. La funcin
devuelve el porcentaje correcto a la derecha del total calculado. Tenga en cuenta que dado que
el modo de muestreo es compressed, la funcin ignora la frecuencia de muestreo y realiza un
muestreo de valores siempre que cdf144 o cdt158 tenga almacenado un valor registrado.

Consulte tambin
Funcin Datos calculados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

Manual del usuario de PI DataLink 2016 147


Referencia de funcin

PIAdvCalcExpFilDat()
Devuelve valores espaciados regularmente calculados a partir de una ecuacin de rendimiento
filtrada durante un determinado perodo de tiempo.

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

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una o varias ecuaciones de rendimiento para las que la
funcin calcula un valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
arrojar valores para cada una de ellas.

STime Cadena El inicio del perodo de tiempo para el que la funcin calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
valores.
Interval Cadena El intervalo entre valores arrojados. Introduzca un valor y la
unidad temporal que especifica la duracin del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para arrojar un valor
por cada intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de tiempo.
FiltExp Cadena Una ecuacin de rendimiento booleana que la funcin utiliza
para filtrar valores. Cuando la expresin se evala como falsa,
la funcin excluye los valores correspondientes. Consulte
Expresiones de filtro.
Mode Cadena Tipo de clculo que realiza la funcin:
total
minimum
maximum
stdev
range
count
average (time-weighted)
average (event-weighted)
CalcBasis Cadena El mtodo de clculo:
time-weighted
event-weighted
SampMode Cadena Mtodo de muestreo que la funcin utiliza para determinar
cundo evaluar Expression y FiltExp:
compressed
interpolated
SampFreq Cadena La frecuencia con la que la funcin evala Expression y
FiltExp si SampMode est configurado en interpolated.
Introduzca un valor y una unidad de tiempo. Por ejemplo,
defina en 10m (10 minutos) para arrojar un valor interpolado
por cada intervalo de 10 minutos. Consulte Especificacin de
intervalos de tiempo.

148 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


MinPctGood Nmero Porcentaje mnimo de datos correctos necesarios durante el
perodo de tiempo para calcular y arrojar un valor.
CFactor Nmero Factor que la funcin aplica al valor arrojado. Introduzca 1 si
el factor de conversin no es necesario. Para los clculos 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 da).
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2, 3, 7, 8 y 9 (si Mode est
configurado como minimum, maximum o range).

RootPath Cadena La ruta al elemento de datos al que hace referencia la


expresin. Consulte Elementos de datos.

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

Calcula un total con ponderacin temporal para la expresin 'cdf144'+'cdt158' cuando


'productid' = "Product2" en intervalos de tres horas de ayer a hoy del servidor
predeterminado de Archivo de datos de PI.
La funcin multiplica cada total calculado por 1 y devuelve un valor cuando el porcentaje de
valores correctos es como mnimo del 50% durante el intervalo de tres horas. La funcin
devuelve el porcentaje correcto a la derecha del total calculado. Tenga en cuenta que dado que
el modo de muestreo es compressed, la funcin ignora la frecuencia de muestreo y realiza un
muestreo de valores siempre que cdf144 o cdt158 tenga un valor registrado o el valor de
productid cambie de o desde Product2.

Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Valores interpolados

PITimeFilter()
Arroja la cantidad de tiempo durante la cual una ecuacin de rendimiento se evala como true
a lo largo de intervalos iguales de un determinado perodo de tiempo especificado.

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

Manual del usuario de PI DataLink 2016 149


Referencia de funcin

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una ecuacin de rendimiento booleana que la funcin evala.
Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
arrojar valores para cada una de ellas.

STime Cadena El inicio del perodo de tiempo para el que la funcin calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
valores.
Interval Cadena El intervalo entre valores arrojados. Introduzca un valor y la
unidad temporal que especifica la duracin del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para arrojar un valor
por cada intervalo de 15 minutos durante el perodo de
tiempo. Consulte Especificacin de intervalos de tiempo.
TimeUnit Cadena Unidad de tiempo del resultado calculado:
seconds
minutes
hours
days
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2, 3, 7 y 8.

RootPath Cadena La ruta al elemento de datos al que hace referencia la


expresin. Consulte Elementos de datos.

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

Arroja el nmero de segundos durante los cuales la expresin de la celda A1 es verdadera en el


servidor de Archivo de datos de PI denominado thevax en intervalos de una hora, desde la
medianoche de ayer hasta la medianoche de hoy.
La funcin muestra la marca de tiempo del inicio de cada intervalo de clculo a la izquierda del
valor.

Consulte tambin
Funcin Filtrado de tiempo
Definir funciones manualmente
Pautas para introducir argumentos de forma manual

PITimeFilterVal()
Arroja la cantidad de tiempo durante la cual una ecuacin de rendimiento se evala como true
durante un perodo de tiempo determinado.

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

150 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumentos
Argumento Tipo Descripcin
Expression Cadena Una ecuacin de rendimiento booleana que la funcin evala.
Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
arrojar valores para cada una de ellas.

STime Cadena El inicio del perodo de tiempo para el que la funcin calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del perodo de tiempo para el que la funcin calcula
un valor.
TimeUnit Cadena Unidad de tiempo del resultado calculado:
seconds
minutes
hours
days
OutCode Entero Cdigo de salida que determina los datos aadidos que arroja
la funcin y la forma en que la funcin orienta la salida.
Consulte Cdigos de salida para obtener informacin sobre
cmo calcular el cdigo.
Esta funcin admite los bits 2 y 3.

RootPath Cadena La ruta al elemento de datos al que hace referencia la


expresin. Consulte Elementos de datos.

Ejemplo
=PITimeFilterVal($A$1,"y","t","seconds",0,"thevax")

Arroja el nmero de segundos durante los cuales la expresin de la celda A1 es verdadera en el


servidor de Archivo de datos de PI denominado thevax desde la medianoche de ayer hasta la
medianoche de hoy.

Consulte tambin
Funcin Filtrado de tiempo
Definir funciones manualmente
Pautas para introducir argumentos de forma manual

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

En esta seccin
PIPointIDToTag()
PIAttributeMaskToTag ()

PIPointIDToTag()
Devuelve el nombre del PI point correspondiente a un ID de PI point especfico.

Manual del usuario de PI DataLink 2016 151


Referencia de funcin

Sintaxis
PIPointIDToTag(PointID, Server)

Argumentos
Argumento Tipo Descripcin
PointID Cadena ID de PI point, el cual es un ID interno exclusivo que no se ha
vuelto a utilizar tras eliminar un punto.
Server Cadena El servidor de Archivo de datos de PI cuyos datos arroja la
funcin. Si no selecciona un servidor o deja este campo en
blanco, la funcin buscar el servidor de Archivo de datos de
PI predeterminado.

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

Busca el servidor de Archivo de datos de PI denominado thevax para el point ID (identificador


del punto) 123 y arroja el nombre de dicho punto (el atributo Tag).

Consulte tambin
Funcin Identificador del punto al tag

PIAttributeMaskToTag ()
Obtiene los nombres de PI Points que coinciden con uno o ms de los valores de atributos de PI
point especificados.

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

Argumentos
Argumento Tipo Descripcin
TagName Cadena Nombre de los puntos arrojados.1
Descriptor Cadena Descriptor de los puntos arrojados.1
PointSource Cadena Origen de punto de los puntos arrojados.1
PointType Cadena Tipo de punto de los puntos arrojados.1
PointClass Cadena Clase de punto de los puntos arrojados.1
EngUnits Cadena Unidades de ingeniera de los puntos arrojados.1
OutCode Entero Cdigo de salida que determina la forma en que la funcin
orienta la salida:
0
Escribir valores en una columna.
2
Escribir valores en una fila.
Server Cadena El servidor de Archivo de datos de PI cuyos datos arroja la
funcin. Si no selecciona un servidor o deja este campo en
blanco, la funcin buscar el servidor de Archivo de datos de
PI predeterminado.

152 Manual del usuario de PI DataLink 2016


Referencia de funcin

Argumento Tipo Descripcin


1 Utilice el carcter comodn (*) para encontrar todas las coincidencias o las coincidencias limitadas a

determinados caracteres.

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

Arroja los nombres de los puntos que empiezan por sin del servidor de Archivo de datos de PI
denominado thevax.

Consulte tambin
Funcin Mscara de atributo para tag

Funciones de Module Database


En esta seccin
PIAliasToTag()
PIPropertyToValue()

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

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

Argumentos
Argumento Tipo Descripcin
Alias Cadena El alias de la base de datos de mdulo correspondiente al PI
point para devolver.
ModulePath Cadena Ruta de mdulo completa del alias.
QueryDate Entero Fecha efectiva del alias. La funcin devuelve el nombre del
punto correspondiente al alias especificado en esa fecha.
OutCode Entero Cdigo de salida que determina si se aadir el nombre del
servidor al resultado:
0
Devuelve solo el nombre del punto.
1
Arroja el servidor de Archivo de datos de PI que almacena
el punto en la celda a la derecha del nombre del punto.
2
Arroja el servidor de Archivo de datos de PI que almacena
el punto en la celda debajo del nombre del punto.
Server Cadena El servidor de Archivo de datos de PI cuyos datos arroja la
funcin. Si no selecciona un servidor o deja este campo en
blanco, la funcin buscar el servidor de Archivo de datos de
PI predeterminado.

Manual del usuario de PI DataLink 2016 153


Referencia de funcin

Ejemplo
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")

Arroja el nombre del PI point que corresponde al alias Temperature del mdulo Reactor1,
que es un submdulo de Unit1. Unit1 es la raz de la base de datos de mdulo para un
servidor de Archivo de datos de PI denominado thevax. La base de datos de mdulo se
consulta a la hora actual.

Consulte tambin
Funcin Alias para tag

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

Sintaxis
PIPropertyToValue(Property, ModulePath, QueryDate, Server, OutCode)

Argumentos
Argumento Tipo Descripcin
Property Cadena La propiedad de base de datos de mdulo correspondiente al
PI point para el que la funcin recupera valores.
ModulePath Cadena Ruta de mdulo completa de la propiedad.
QueryDate Entero Fecha efectiva del valor de la propiedad de PI. la funcin
devuelve los valores correspondientes a la propiedad
especificada en esa fecha.
Server Cadena El servidor de Archivo de datos de PI cuyos datos arroja la
funcin. Si no selecciona un servidor o deja este campo en
blanco, la funcin buscar el servidor de Archivo de datos de
PI predeterminado.
OutCode Entero Cdigo 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")

Arroja el valor que corresponde a la propiedad Implementer del mdulo Reactor1, que es un
submdulo de Unit1. Unit1 es la raz de la base de datos de mdulo para un servidor de
Archivo de datos de PI denominado thevax. La base de datos de mdulo se consulta a la hora
actual.

Consulte tambin
Funcin Propiedad para valor

Funciones de entrada

154 Manual del usuario de PI DataLink 2016


Referencia de funcin

PIPutVal() y PIPutValX()
Escribe un valor en el servidor de Archivo de datos de PI o en el servidor de PI AF y arroja una
cadena que indica el estado.
Nota:
En la versin actual de PI DataLink, no existe diferencia entre la funcin PIPutVal y la
funcin PIPutValX. En las versiones de PI DataLink anteriores a PI DataLink 2013, la
funcin PIPutVal solo admita tres tipos de PI point tradicionales: real, entero y digital.
En esas versiones de PI DataLink, la funcin PIPutValX agreg compatibilidad para
marcas de tiempo de subsegundos y puntos de cadenas.

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

Argumentos
Argumento Tipo Descripcin
DataItem Cadena El nombre del PI point o el atributo de PI AF para que la
funcin escribe un valor.
Value Referencia Referencia a la celda que contiene el valor que se va a
escribir, ya sea una cadena o un nmero.
TimeStamp Cadena La marca de tiempo del valor. Consulte Campos de entrada de
tiempo.
RootPath Cadena La ruta al elemento de datos. Consulte Elementos de datos.
OutCell Referencia Referencia a la celda en la que PI DataLink escribe la cadena
que la funcin macro devuelve. La cadena devuelta vara:
Si la escritura es correcta:
La funcin PIPutVal arroja xxx Written donde xxx es
Real Value, Integer, Digital State o Value,
segn el tipo de valor escrito.
La funcin PIPutValX arroja Value Written.
Si la escritura falla, la funcin arroja un cdigo de error,
como [-5] Tag not found.

Notas
Las funciones PIPutVal y PIPutValX no pueden escribir en atributos de PI AF que sean
atributos de configuracin. Estas funciones solo pueden escribir en un atributo de PI AF para el
que no est seleccionada la casilla Elemento de configuracin. Puede comprobar el estado de la
casilla en la pestaa Atributos de PI System Explorer.
Las funciones PIPutVal y PIPutValX admiten todos los tipos de datos Archivo de datos de PI.
Las funciones interpretan las marcas de tiempo mediante la utilizacin de la informacin de la
zona horaria del ordenador cliente de Archivo de datos de PI a menos que se haya activado la
opcin Zona horaria de PI Data Archive.
Las funciones no verifican el intervalo especificado por el usuario para un punto antes de
escribir el valor. El intervalo est definido como zero a zero + span, donde zero y span son
atributos de punto especificados durante la creacin del punto. La funcin arroja una cadena
Value Written incluso si Over Range o Under Range estn almacenados en Archivo de
datos de PI.

Manual del usuario de PI DataLink 2016 155


Referencia de funcin

Ejemplo
=PIPutVal("testtag",a5,"t",,e5)

Escribe el valor ubicado en la celda A5 para el PI point testtag en el servidor predeterminado


de Archivo de datos de PI; asigna a este valor la marca de tiempo de medianoche del da en
curso. La funcin escribe el resultado de la funcin de macros en la celda E5 de la hoja de
clculo.

Funciones obsoletas
Se han reemplazado diversas funciones por funciones ms potentes. Para admitir hojas de
clculo anteriores que utilizan estas funciones reemplazadas, PI DataLink admite las funciones
anteriores y obsoletas, pero OSIsoft recomienda el uso de las nuevas funciones
correspondientes.
Funcin anterior Funcin nueva
PICalcVal PIAdvCalcVal
PICalcDat PIAdvCalcDat
PIExTimeVal PIArcVal (con Mode configurado en exact time)

156 Manual del usuario de PI DataLink 2016


Resolucin de problemas
Consulte los temas incluidos en esta seccin si tiene alguna dificultad con el uso de PI DataLink.
Si estos temas no explican ni resuelven el problema, pngase en contacto con el soporte tcnico
(consulte la Pgina de contacto de soporte tcnico de OSIsoft (https://
techsupport.osisoft.com/Contact-Us/)).

En esta seccin
Archivos de registro
La pestaa PI DataLink no est disponible
Lmites de matriz y de celda
Lmites de recuperacin de datos
Elemento de datos no admitido por funcin
Existe un evento duplicado
Seguridad
Problemas de conexin de PI Data Archive
Eliminar error de excepcin de tiempo de espera
Los datos no se actualizan

Archivos de registro
PI DataLink no genera un archivo de registro genrico. Puede utilizar los mensajes de error de
las hojas de clculo para diagnosticar problemas. Sin embargo, algunos procesos especficos no
generan archivos de registro:
Instalacin
El directorio de ../pipc/dat contiene los archivos de registro de instalacin,
SetupPIDataLink_x64.log y SetupPIDataLink_x86.log.
Conectividad del servidor de Archivo de datos de PI
Examine el archivo de registro de Archivo de datos de PI en PI SMT para detectar problemas
de conectividad del servidor de Archivo de datos de PI.

La pestaa PI DataLink no est disponible


Si la pestaa PI DataLink no aparece despus de instalar PI DataLink, es posible que necesite
configurar de forma manual el complemento para Excel (consulte Configuracin del
complemento para Microsoft Excel) o reducir los parmetros de seguridad para los
complementos (consulte Seguridad).
Algunas secuencias VBA escritas por el usuario en las hojas de clculo (o complementos) de
Excel restablecen la cinta principal de Excel. En estos casos, la pestaa PI DataLink puede
desaparecer aunque el complemento de PI DataLink est todava cargado y las funciones de PI
DataLink integradas pueden funcionar aunque la pestaa PI DataLink no est disponible.
Reiniciar Excel suele corregir este problema.

Manual del usuario de PI DataLink 2016 157


Resolucin de problemas

Lmites de matriz y de celda


PI DataLink est sujeto a una limitacin de Excel en el nmero de elementos de la matriz de
clculos. Una nica funcin de PI DataLink puede devolver como mximo 1.048.576 valores por
recuperacin.
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 lmite de 255 caracteres.
Del mismo modo, PI DataLink puede truncar la salida de cadena, como los nombres de los PI
points, a 255 caracteres.

Lmites de recuperacin de datos


El cdigo de error -11091 indica que una consulta nica iniciada por una funcin de PI
DataLink ha intentado recuperar ms valores registrados de Archivo de datos de PI de los que
permite el parmetro de ajuste ArcMaxCollect.
Dado que este lmite se aplica a los valores registrados recuperados de Archivo de datos de PI,
incluso las funciones que arrojan un nmero menor de valores pueden superar el lmite
establecido por este parmetro de ajuste. Por ejemplo, el valor de PI point sinusoid vara
constantemente entre 0 y 100. Puede crear una funcin que arroje valores de muestra de
sinusoid cada 30 segundos durante un ao con un filtro que excluya valores menores a 95.
Esta funcin puede arrojar una cantidad relativamente pequea de valores, pero recuperar
muchos ms valores registrados de los archivos para procesar la consulta.
Si recibe este error, plantese modificar los criterios de bsqueda para reducir los datos
recuperados. Por ejemplo, podra reducir el periodo de tiempo a lo largo del cual la funcin
recuperar datos.

Elemento de datos no admitido por funcin


El mensaje mostrado Data item not supported by function puede indicar lo siguiente:
Un atributo de PI AF utiliza una referencia de datos personalizada que no permite los
clculos. Para utilizarlo en PI DataLink, modifique el cdigo de referencia de datos
personalizado para que permita el uso de mtodos de acceso a datos. Esta desactivado de
forma predeterminada.
La funcin Datos calculados ha intentado realizar un clculo de resumen en un atributo de
PI AF de tipo PI Point Array.

Existe un evento duplicado


El mensaje mostrado Duplicate event exists: specify index for EventName indica
que el evento principal de esta fila de la hoja de clculo contiene ms de un evento secundario
con el nombre EventName. Para resolverlo, cambie la especificacin de la funcin Comparar
eventos para utilizar una versin indexada del evento para el atributo visualizado en esta
columna.
Cuando un evento principal tiene eventos secundarios con nombres duplicados, PI DataLink
aade automticamente un ndice al nombre del evento secundario en la ventana Aadir
atributos. Si otros eventos del mismo nivel no tienen nombres duplicados, no tendrn el ndice.

158 Manual del usuario de PI DataLink 2016


Resolucin de problemas

Para obtener ms informacin, consulte Aadir atributos de eventos secundarios como


columnas en el panel de tareas Comparar eventos.

Seguridad
Las funciones de seguridad de Excel para los complementos, los controles de ActiveX y las
macros controlan los tipos de componentes que se pueden ejecutar en Excel. Los parmetros
de seguridad proporcionan los medios para desactivar, activar bajo demanda o activar
completamente estos tipos de objetos.
Los parmetros de seguridad de Excel pueden entrar en conflicto con algunas funciones de PI
DataLink:
PI DataLink es un complemento para Excel. La configuracin de seguridad que desactiva los
complementos impide que PI DataLink se cargue en Excel
Las tendencias utilizan un control ActiveX firmado marcado como seguro para su
inicializacin y requieren que se activen los controles ActiveX.
Las hojas de clculo que contienen una funcin PIPutVal() o PIPutValX () utilizan
macros y requieren que estn activadas (consulte PIPutVal() y PIPutValX()).
Si aplica con regularidad la seguridad de Excel a las hojas de clculo, o encuentra problemas
utilizando estas funciones de PI DataLink, deber reducir o eliminar la configuracin de
seguridad de Excel dependiendo de cmo prevea utilizar PI DataLink.
Para ms informacin sobre la seguridad de Excel, consulte los recursos y la ayuda en lnea de
Microsoft Excel.

Problemas de conexin de PI Data Archive


Esta versin de PI DataLink utiliza parmetros de seguridad ms estrictos para conectarse a
Archivo de datos de PI. Esta nueva configuracin reduce la exposicin a problemas de
seguridad asociados con la autenticacin de contraseas en PI. Para obtener ms informacin,
consulte el boletn de soporte tcnico, Alerta de seguridad: problemas de autenticacin de PI
(https://techsupport.osisoft.com/Troubleshooting/Alerts/AL00206).
Los nuevos parmetros de seguridad pueden producir errores si PI DataLink utiliza:
Nombres de usuario y contraseas de PI para conectarse a Archivo de datos de PI
Usuario predeterminado para conectarse a Archivo de datos de PI
Especficamente, es probable que esta configuracin genere el siguiente error:
Cannot connect to the PI Data Archive. Windows authentication trial
failed because insufficient privilege to access the PI Data Archive.
Trust authentication trial failed because insufficient privilege to
access the PI Data Archive.
Para resolver estos errores, puede:
Configurar PI mappings para usuarios que se conecten a Archivo de datos de PI.
OSIsoft recomienda este enfoque (disponible en la versin 3.4.380 de Archivo de datos de PI
y posteriores). Este es el mtodo de conexin ms seguro. Para obtener ms informacin
sobre la creacin de PI mappings, consulte Archivo de datos de PI Security Configuration
Guide o la Biblioteca PI Live (https://livelibrary.osisoft.com). Para utilizar PI mappings,
deber activar tambin el protocolo de autenticacin de Windows Security en cada
ordenador en el que se ejecute PI DataLink.
Configurar PI trusts para usuarios que se conecten a Archivo de datos de PI.

Manual del usuario de PI DataLink 2016 159


Resolucin de problemas

Este es el segundo mejor enfoque. Para obtener ms informacin sobre la creacin de PI


trusts, consulte Archivo de datos de PI Security Configuration Guide o la Biblioteca PI Live
(https://livelibrary.osisoft.com). Para utilizar PI trusts, deber activar tambin el protocolo
de autenticacin de PI Trust en cada ordenador en el que se ejecute PI DataLink.
Configurar cada ordenador para permitir una solicitud de inicio de sesin explcita cuando
no estn disponibles una PI mapping o un PI trust.
OSIsoft no recomienda este enfoque. Los inicios de sesin explcitos no son seguros. Con
este enfoque, debe ingresar su nombre de usuario y contrasea la primera vez que se
conecta a cada Archivo de datos de PI durante una sesin particular de Microsoft Excel.
Nota:
La introduccin de una contrasea incorrecta en una solicitud de inicio de sesin puede
generar el mismo mensaje de error.

En esta seccin
Activar un protocolo de autenticacin
Configurar un ordenador para permitir solicitudes de inicio de sesin explcitas
Ingrese las credenciales de inicio de sesin del Administrador de conexiones

Activar un protocolo de autenticacin


Para conectarse a Archivo de datos de PI con una PI mapping o un PI trust definido, utilice PI
SDK Utility para activar el protocolo correspondiente en su ordenador. Deber configurar cada
ordenador desde el que se conecte a Archivo de datos de PI con una PI mapping o un PI trust.

Procedimiento
1. Haga 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 servidores de Archivo de datos de PI
disponibles y actualizar los mens de utilidades.
3. Haga clic en Conexiones > Opciones para abrir la ventana Opciones de conexin.
4. En Especificar procedimiento de autenticacin, utilice las teclas de flecha 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. Haga clic en Aceptar.

Configurar un ordenador para permitir solicitudes de inicio de sesin


explcitas
Para conectarse a Archivo de datos de PI a travs de un inicio de sesin como usuario de PI,
utilice PI SDK Utility para configurar su ordenador para permitir solicitudes de inicio de sesin
explcitas. Deber configurar cada ordenador desde el que desee conectarse a Archivo de datos
de PI iniciando sesin como usuario de PI.
PRECAUCIN:
OSIsoft recomienda utilizar un mtodo alternativo ms seguro para conectarse a Archivo
de datos de PI.

160 Manual del usuario de PI DataLink 2016


Resolucin de problemas

Procedimiento
1. Haga clic en Inicio > Todos los programas > PI System > PISDKUtility para abrir PI SDK
Utility.
2. Haga clic en Conexiones > Opciones para abrir la ventana Opciones de conexin.
3. Seleccione la casilla Permitir peticin de inicio de sesin (si fallan todos los protocolos
configurados).
4. Haga clic en Aceptar.

Qu hacer a continuacin
Escriba su nombre de usuario y contrasea para acceder a cada sesin nueva de Excel de
Archivo de datos de PI. Puede acceder a la solicitud de conexin mediante la bsqueda de
Archivo de datos de PI con la herramienta de bsqueda o mediante la conexin manual desde
el Administrador de conexiones. Consulte Ingrese las credenciales de inicio de sesin del
Administrador de conexiones.

Ingrese las credenciales de inicio de sesin del Administrador de conexiones


Si se conecta a Archivo de datos de PI cuando inicia sesin como un usuario de PI, debe escribir
su nombre y contrasea para cada Archivo de datos de PI al que se conecte durante cada sesin
de Excel.

Antes de empezar
Configurar un ordenador para permitir solicitudes de inicio de sesin explcitas.

Procedimiento
1. En la pestaa PI DataLink, en el grupo Recursos, haga clic en Configuracin para abrir la
ventana Configuracin.
2. Haga clic en Administrador de conexiones para abrir la ventana Servidores.
3. En la lista de servidores, haga clic con el botn derecho en el servidor de Archivo de datos
de PI al que desea conectarse y, a continuacin, haga clic en Conectarse como para abrir la
ventana Conectarse a PI Data Archive.
4. En la lista Autenticacin, seleccione Autenticacin de usuario de PI.
Si la ventana no muestra la lista Autenticacin, debe configurar el ordenador para permitir
solicitudes de inicio de sesin explcitas.
5. Escriba su nombre de usuario y contrasea y, a continuacin, haga clic en Aceptar.

Eliminar error de excepcin de tiempo de espera


Las bsquedas de servidores de Archivo de datos de PI con bases de datos de puntos grandes
podra alcanzar el tiempo de espera para datos antes de que Archivo de datos de PI haya
arrojado todos los resultados. En este caso, recibir el siguiente error:
OSIsoft.PI.Net.PITimeoutException: [-10722] PINET: Timeout on PI RPC or
System Call.
Para eliminar el error, utilice Gestor de conexiones para aumentar el valor del tiempo de
espera para los datos.

Manual del usuario de PI DataLink 2016 161


Resolucin de problemas

Procedimiento
1. En la pestaa PI DataLink, en el grupo Recursos, haga clic en Configuracin para abrir la
ventana Configuracin.
2. Haga clic en Administrador de conexiones para abrir la ventana Servidores.
3. Haga clic con el botn derecho en el servidor de Archivo de datos de PI que arroj el error y,
a continuacin, haga clic en Propiedades para abrir la ventana Propiedades de PI Data
Archive.
4. Aumente el valor del campo Tiempo de espera de datos y, a continuacin, haga clic en
Aceptar.

Los datos no se actualizan


PI DataLink almacena en cach los datos de configuracin 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, es posible que no se actualicen los datos insertados en las hojas de
clculo para mostrar los valores en funcin de la configuracin modificada o de datos que no
estn basados en el tiempo, aunque recalcule la funcin. Antes de calcular una funcin, PI
DataLink verifica cundo el cach se borr por ltima vez; si no se ha borrado en las ltimas
seis horas, PI DataLink lo borra automticamente. Para borrar el cach y obtener datos
actualizados antes, realice una de las siguientes acciones:
Haga clic en Borrar cach en la ventana Configuracin. Consulte Administrar configuraciones
de PI DataLink.
Cierre y vuelva a abrir Microsoft Excel.

162 Manual del usuario de PI DataLink 2016


Soporte tcnico y otros recursos
Para obtener asistencia tcnica, pngase en contacto con el soporte tcnico de OSIsoft
llamando al +1 510-297-5828 o visitando la pgina Contact Us del Soporte Tcnico OSIsoft
(https://techsupport.osisoft.com/Contact-Us/). El sitio web ofrece ms opciones de contacto
para clientes fuera de los Estados Unidos.
Cuando se ponga en contacto con el soporte tcnico de OSIsoft, tenga a mano la siguiente
informacin:
Nombre de producto, versin y nmeros de versin
Detalles sobre la plataforma del equipo (tipo de CPU, sistema operativo y nmero de
versin)
Hora a la que se inici el problema
Archivos de registro en ese instante concret
Detalles sobre cualquier cambio en el entorno antes de que se produjera el problema
Resumen del problema, incluidos los archivos de registro pertinentes durante el intervalo
de tiempo en que se produjo el problema
Para consultar a otros usuarios del software OSIsoft, participe en la comunidad de usuarios de
OSIsoft, PI Square (https://pisquare.osisoft.com). Los integrantes de la comunidad pueden
solicitar asesoramiento y compartir ideas sobre PI System. El espacio PI Developers Club
dentro de PI Square ofrece recursos para ayudarle con la programacin e integracin de los
productos OSIsoft.

Manual del usuario de PI DataLink 2016 163


Soporte tcnico y otros recursos

164 Manual del usuario de PI DataLink 2016