PI DataLink 2014

Manual del usuario

OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 [Link].
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: [Link]

Manual del usuario de PI DataLink 2014

© 1992-2014 by OSIsoft, LLC. Todos los derechos reservados.
Ninguna parte de esta publicación puede ser reproducida, almacenada en un sistema de recuperación o
transmitida, de ninguna forma ni por ningún medio, mecánico, fotocopiado, grabado o de cualquier otro
modo, sin el consentimiento previo por escrito de OSIsoft, LLC.
OSIsoft, el logotipo de OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset
Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI
BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI
WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports and RtWebParts son
todas marcas comerciales de OSIsoft, LLC. Todas las otras marcas comerciales o nombres comerciales
aquí utilizados son propiedad de sus respectivos propietarios.
DERECHOS DEL GOBIERNO DE LOS EE UU
Su uso, réplica o difusión por parte del Gobierno de [Link]. está sujeto a las restricciones estipuladas en el
contrato de licencia de OSIsoft, LLC, de acuerdo con lo que establecen las regulaciones DFARS 227.7202,
DFARS 252.227-7013, FAR 12.212, FAR 52.227, según proceda. OSIsoft, LLC.
Versión: 5.1.0
Publicación: 9 de abril de 2014
Contenido
Introducción......................................................................................................... 1
Descripción general de PI DataLink........................................................................................................... 1
PI DataLink Server (DLS).......................................................................................................................2
Acerca de esta versión.............................................................................................................................. 2
Requisitos del sistema...........................................................................................................................2
Actualización de compatibilidad........................................................................................................... 2
Tipos de datos admitidos...................................................................................................................... 3
Proceso de configuración de PI DataLink.................................................................................................. 4
Instalar PI DataLink............................................................................................................................... 4
Instalación silenciosa.............................................................................................................................5
Ver PI DataLink en un idioma compatible.............................................................................................. 5
Preferencias de conexión a PI Server collectives.................................................................................... 5
Configuración de PI Server.................................................................................................................... 6
Configuración del complemento para Microsoft Excel.............................................................................. 6
Ver el estado de los complementos....................................................................................................... 7
Activar un complemento desactivado....................................................................................................7
Activar un complemento desactivado................................................................................................... 8
Recomendaciones de seguridad................................................................................................................8
Seguridad de los archivos Excel.............................................................................................................8
Seguridad del complemento para Excel................................................................................................ 9
Privilegios de las cuentas..................................................................................................................... 10
Prácticas de seguridad organizativa.....................................................................................................10
Estrategias de registro......................................................................................................................... 11
Acerca de este documento...................................................................................................................... 11

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

Creación de hojas de cálculo................................................................................. 31

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

Manual del usuario de PI DataLink 2014 iii

Contenido

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

Uso y mantenimiento de las hojas de cálculo......................................................... 85

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

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

iv Manual del usuario de PI DataLink 2014

 Contenido

Funciones de tags.............................................................................................. 103

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

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

Objetos de PI Module Database.......................................................................... 111

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

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

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

Manual del usuario de PI DataLink 2014 v

Contenido

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

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

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

vi Manual del usuario de PI DataLink 2014

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

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

Descripción general de PI DataLink

PI DataLink es un complemento para Microsoft Excel que permite recuperar información de su
PI Server directamente en una hoja de cálculo. Combinado con las capacidades gráficas, de
cálculo y de formato de Microsoft Excel, PI DataLink ofrece potentes herramientas para
obtener, controlar, analizar y realizar informes sobre datos de PI System.
Con PI DataLink, puede:
• Recuperar valores de un PI point de un PI Server
• Recuperar valores de los atributos de un servidor de PI Asset Framework (PI AF)
• Recuperar metadatos de sistema para crear una visualización 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 cálculo se recalcule
• Recuperar las notificaciones a las que se haya suscrito con PI Notifications
PI DataLink proporciona una interfaz gráfica para recuperar datos y crear funciones y cálculos.
Las funciones de DataLink se integran en celdas de hoja de cálculo y pueden proporcionar
actualizaciones activas de datos en tiempo real de PI System.
También puede utilizar las múltiples capacidades de cálculo y formato de Excel para organizar
y presentar datos de PI System para adecuarlos a su propósito o a su audiencia
Existen dos formas de trabajar con las funciones de PI DataLink en hojas de cálculo de Excel:
• Instalar una versión independiente de PI DataLink en un PC local.
• Utilizar un navegador web para ver la hoja de cálculo con PI DataLink Server (DLS), un
producto aparte que permite ver las hojas creadas con PI DataLink.
Póngase en contacto con el representante de ventas de OSIsoft para obtener más información.

Manual del usuario de PI DataLink 2014 1

Introducción

PI DataLink Server (DLS)

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

Acerca de esta versión

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

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

Requisitos del sistema

Para obtener requisitos del sistema actualizados, visite la página de productos del soporte
técnico de OSIsoft ([Link] Haga clic en el enlace del
producto para ver información sobre el producto, incluidos los requisitos del sistema actuales.

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

2 Manual del usuario de PI DataLink 2014

 Introducción

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

Tipos de datos admitidos

PI DataLink admite los siguientes tipos de datos de PI point:
• Digital: Digital (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*
• Enumeración: Enumeration*
*No admitido por la función Datos calculados
PI DataLink no admite los tipos de valores de atributos de PI AF Guid, Attribute, Element, File, o
Array.

Manual del usuario de PI DataLink 2014 3

Introducción

Proceso de configuración de PI DataLink

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

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

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

Procedimiento
1. Localice el kit de configuración. Puede:
◦ Descargue el kit de la página de descargas del Servicio de asistencia técnica de OSIsoft
([Link]
◦ Insertar el CD de distribución.
2. Extraiga los archivos en su ordenador.
3. Si desea instalar una única versión (32 bits o 64 bits), modifique el archivo [Link].
4. Ejecute el programa [Link]. El programa de instalación instala PI DataLink bajo el
directorio raíz de PIPC, normalmente en:
C:\Archivos de programa\PIPC\Excel
El programa instala el archivo de Ayuda en línea en el directorio de idioma correspondiente
bajo el directorio ../PIPC/Help. Puede descargar la versión PDF y las notas de la versión
de la página de descargas del Servicio de asistencia técnica de OSIsoft (https://
[Link]/Downloads/All-Downloads/).

4 Manual del usuario de PI DataLink 2014

 Introducción

Qué hacer a continuación

• Para cambiar la configuración predeterminada de PI DataLink, consulte el artículo de la

OSIsoft Knowledge Base How to change the default DataLink Settings for all users during
install or upgrade ([Link]
• Para ver PI DataLink en un idioma que no sea el inglés, instale el paquete de idiomas MUI de
PI DataLink. Consulte Ver PI DataLink en un idioma compatible.
• Para utilizar funciones de tag, funciones de base de datos de módulo o tendencias, active de
forma manual el complemento PI DataLink (Legacy). Consulte Configuración del
complemento para Microsoft Excel.

Instalación silenciosa
Puede instalar este software con la función de instalación silenciosa de Windows. En algunas
ocasiones denominada instalación desatendida, la instalación silenciosa no requiere ningún
tipo de comentario durante el proceso de configuración. Los administradores del sistema con
una aplicación de distribución de software automatizada pueden utilizar la instalación
silenciosa para implementar el software de forma automática en un gran número de equipos
de la empresa.
Para iniciar una instalación silenciosa, escriba:
[Link] –f [Link]
El archivo [Link] se encuentra incluido en el kit de instalación. Puede realice en el
archivo las modificaciones específicas del sitio que sean necesarias. Consulte el archivo
[Link] para obtener más información y descripciones de los argumentos disponibles.

Ver PI DataLink en un idioma compatible

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

Procedimiento
1. Defina el idioma que desee en Microsoft Excel.
a. Instale el paquete de idiomas de Microsoft Office.
b. Utilice la herramienta de configuración de idiomas de Microsoft Office para cambiar el
idioma de Microsoft Excel.
2. Descargue el paquete de idioma MUI de PI DataLink en la página de descargas del Servicio
de asistencia técnica de OSIsoft ([Link]
Downloads/).
3. Instale el paquete de idiomas MUI de PI DataLink.

Preferencias de conexión a PI Server collectives

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

Manual del usuario de PI DataLink 2014 5

Introducción

• Las funciones de PI DataLink establecen la preferencia como Cualquiera.

• La búsqueda establece la preferencia como Cualquiera.
• Gestor de conexiones (al que se accede desde el cuadro de diálogo Configuración) establece
la preferencia como Cualquiera.
• Los objetos heredados de control de tendencia establecen la preferencia como Preferir
primario.
• Tag Search (al que se accede desde las funciones de tags heredados) establece la preferencia
como Preferir primario.
• PI Connection Manager (al que se accede desde el Tag Search heredado) establece la
preferencia como Preferir primario.
Consulte el manual High Availability Administrator Guide para obtener más información sobre
las conexiones cliente a PI Server.

Configuración de PI Server
PI DataLink puede obtener datos de Server 3.4.380 y versiones posteriores. No obstante, PI
DataLink debe poder conectarse al PI Server adecuado y los usuarios deben tener un acceso
adecuado a los PI points. Es posible que esto exija realizar algunos cambios de configuración
en:

• Base de datos de firewall

La base de datos de firewall de cada equipo de PI Server debe configurarse para permitir el
acceso desde equipos cliente que ejecutan PI DataLink.

• Autenticación y autorización
Es necesario que los usuarios que utilicen PI DataLink puedan autenticar su identidad con
PI Server y tener acceso a PI Server. Asigne a los usuarios un acceso con el mínimo de
privilegios, por ejemplo, otórgueles permisos de solo lectura. Para la autenticación, OSIsoft
recomienda utilizar PI mappings (disponibles en PI Server versión 3.4.380 y posteriores).
También puede utilizar PI trusts o autenticación de contraseñas de PI. OSIsoft no
recomienda la autenticación de contraseñas de PI, porque es el método menos seguro.

• Definiciones de puntos
Deben definirse los puntos para conceder acceso de lectura a los usuarios autorizados y
también acceso de escritura, si es necesario.
Para obtener más información, consulte la documentación relativa a PI Server, incluido el
manual Configuring PI Server Security. Puede descargar la documentación de la página de
descargas del Servicio de asistencia técnica de OSIsoft ([Link]
Downloads/All-Downloads/).

Configuración del complemento para Microsoft Excel

PI DataLink tiene tres complementos de aplicación para Microsoft Excel.
Nombre Ubicación Tipo
PI DataLink ..\PIPC\Excel\[Link] Complemento
COM
PI DataLink ..\PIPC\Excel\[Link](Legacy).vsto Complemento
(Legacy) COM

6 Manual del usuario de PI DataLink 2014

 Introducción

Nombre Ubicación Tipo

PI DataLink ..\PIPC\Excel Complemento
Notifications \[Link] COM

Para utilizar todas las funciones de PI DataLink, estos complementos de aplicación deben estar
activos. El programa de configuración instala todos los complementos y activa el complemento
de PI DataLink. Si PI Notifications están instalado en el equipo, el programa de configuración
también activa el complemento de PI DataLink Notifications. En caso contrario, deberá activar
ese complemento después de instalar PI Notifications. El programa de configuración no activa
el complemento de PI DataLink (Legacy). Debe activar el complemento si desea utilizar
funciones de tag, objetos de Module Database o tendencias.
En casos excepcionales, Microsoft Excel podría deshabilitar un complemento. Deberá
habilitarlo para poder activarlo.
Nota:
Para activar el complemento de una aplicación, debe tener privilegios de administrador
en el equipo. Si no es administrador, haga clic con el botón derecho del ratón en
[Link] en Windows Explorer y, a continuación, haga clic en Ejecutar como
administrador para ejecutar Microsoft Excel como administrador.

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

En esta sección
• Ver el estado de 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.

Procedimiento
1. Haga clic e la pestaña Archivo y, a continuación, en Opciones. (En Microsoft Excel 2007, haga
clic en el botón de Microsoft Office y, a continuación, en Opciones de Excel.)
2. En la 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 categorías:
◦ 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.

Manual del usuario de PI DataLink 2014 7

Introducción

Procedimiento
1. Haga clic en la pestaña Archivo y, a continuación, en Opciones. (En Microsoft Excel 2007,
haga clic en el botón de Microsoft Office y, a continuación, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. En la lista Administrar, seleccione Elementos deshabilitados y, a continuación, haga clic en
Ir.
4. Seleccione la casilla de verificación 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 aplicación, debe tener privilegios de administrador en el
equipo. Si no es administrador, haga clic con el botón derecho en [Link] en Windows
Explorer y, a continuación, haga clic en Ejecutar como administrador para ejecutar
Microsoft Excel como administrador.

Procedimiento
1. Haga clic en la pestaña Archivo y, a continuación, en Opciones. (En Microsoft Excel 2007,
haga clic en el botón de Microsoft Office y, a continuación, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. En la lista Administrar, seleccione Complementos COM y, a continuación, haga clic en Ir.
4. Seleccione la casilla de verificación 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 sección
describen las prácticas recomendadas para maximizar la seguridad de los datos cuando se
trabaja con PI DataLink.

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

Seguridad de los archivos Excel

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

8 Manual del usuario de PI DataLink 2014

 Introducción

• Proteger sus archivos de libro de trabajo en Excel mediante contraseñas. Las contraseñas
permiten que solo los usuarios autorizados puedan ver o modificar los datos del libro de
trabajo. Para obtener más información, consulte el artículo de Microsoft Office Secure a
workbook with a password ([Link]
[Link]).
• Emplee las prácticas más seguras para definir contraseñas para sus libros de trabajo.
◦ Defina una contraseña para abrir el libro de trabajo y otra para modificarlo.
◦ Utilice una combinación de mayúsculas y minúsculas, números y símbolos en sus
contraseñas.
◦ Seleccione la casilla Cifrar propiedades del documento para evitar que usuarios no
autorizados puedan ver el resumen y las propiedades personalizadas del archivo del
libro de trabajo.
• Active 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, reenvíen o copien datos confidenciales de
PI System. Tras restringir los permisos de un archivo mediante IRM, se aplican las
restricciones de acceso y uso independientemente de la ubicación de la información, porque
el permiso de acceso se guarda en el propio archivo. Para obtener más información, consulte
el artículo de Microsoft Office Information Rights Management en Office 2010 (http://
[Link]/en-us/excel-help/information-rights-management-in-office-2010-
[Link]). Si es necesario, puede establecer una fecha de caducidad para los
datos en el archivo Excel. En el artículo de Microsoft Office, vea el procedimiento Establecer
una fecha de caducidad para un archivo ([Link]
[Link]#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 más información, consulte el
artículo de Microsoft TechNet Step-by-Step Guide to Internet Protocol Security (IPSec)
([Link] (disponible solo en inglés).
• Aplique los permisos de protección 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
obtener más información, consulte el artículo de Microsoft TechNet File and Folder
Permissions ([Link] (disponible solo
en inglés).
• Aplique una firma digital al archivo de libro de trabajo Excel. Para obtener más información,
vea el artículo de Microsoft Office Descripción de las firmas digitales y la firma de código en
los libros de Excel ([Link]

Seguridad del complemento para Excel

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

Manual del usuario de PI DataLink 2014 9

Introducción

certificado PI DataLink al almacén de certificados de confianza. Consulte Añadir certificado PI

DataLink a almacén de certificados de confianza.
Para obtener más información, vea el artículo de Microsoft Office Ver, administrar e instalar los
complementos de los programas de Office ([Link]
[Link]).

Añadir certificado PI DataLink a almacén de certificados de confianza

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

Procedimiento
1. Abra una ventana de comandos como administrador.
2. En una ventana de símbolo del sistema, desplácese al directorio que contiene el certificado
PI DataLink ([Link]).
Encontrará el certificado en la subcarpeta Excel de la carpeta de instalación (definida por
la variable de entorno PIHOME).
3. Introduzca el siguiente comando:
C:\Windows\System32\[Link] -addstore TrustedPublisher
[Link]

Privilegios de las cuentas

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

Prácticas de seguridad organizativa

Para evitar que posibles intrusos tengan acceso al sistema, OSIsoft le recomienda que su
organización adopte prácticas generales de seguridad:
• Proteja físicamente sus equipos. Si un intruso logra acceder a equipos en los que se ejecuta
PI DataLink, podría tener acceso a todos los datos de PI System recuperados y almacenados
en archivos Excel de ese equipo.
• Restrinja 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 más recientes a todos los equipos. Suscríbase al
servicio de notificaciones de seguridad para estar informado sobre las nuevas
actualizaciones de seguridad de los sistemas operativos y otros componentes. Para obtener
más información, consulte el artículo del TechCenter de seguridad Notificaciones técnicas
de seguridad de Microsoft ([Link]
• Protéjase 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.

10 Manual del usuario de PI DataLink 2014

 Introducción

• Auditar toda la actividad administrativa y revisar de forma rutinaria los registros de

auditoría. Pida a todos los administradores que efectúen comprobaciones de antecedentes
antes de contratar a nuevos empleados y que realicen comprobaciones periódicas como
condición laboral.
• Prevea múltiples 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 protección diseñando su red para separar los clientes menos seguros de los
clientes más seguros. Los cortafuegos personales en equipos cliente agregan una capa
adicional. Mejore aún más la seguridad con software para la detección de intrusos y
software para la detección de intrusos basados en host que ayudan a filtrar actividades
sospechosas. La ejecución de software antivirus es esencial. Finalmente, la formación de los
usuarios en cuestiones de seguridad informática es una parte crítica de una estrategia de
seguridad de la red.
• Cree y mantenga líneas base seguras para todos los sistemas. Especifique todas las líneas
base con una descripción detallada de cómo configurar y administrar el equipo. La
descripción debe incluir todos los parámetros de configuración pertinentes para un equipo
seguro. Para crear una línea base segura, utilice el sistema operativo más seguro posible. Es
más probable que los sistemas operativos más recientes estén diseñados pensando en la
seguridad y que contengan funciones destinadas a mejorar su seguridad. Mantenga el
sistema operativo y las aplicaciones actualizados aplicando las actualizaciones de seguridad
a medida que estén disponibles.
• Utilice contraseñas o claves seguras. No utilice nunca contraseñas en blanco. Para obtener
más información sobre las contraseñas, consulte el artículo de Microsoft TechNet Account
Passwords and Policies ([Link]
(Contraseñas de cuentas y políticas).
• Controle el acceso a los archivos Excel de PI DataLink. Implemente procedimientos de
control de acceso para asegurarse de que todos los archivos Excel estén guardados en un
lugar seguro y que ningún intruso pueda modificar el contenido de los archivos o buscar
información en ellos.

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

Acerca de este documento

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

Manual del usuario de PI DataLink 2014 11

Introducción

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

12 Manual del usuario de PI DataLink 2014

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

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

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

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

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

• Haga clic en la pestaña 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
diálogo.
• Sitúe el cursor sobre un comando para mostrar una ayuda inmediata descriptiva.

Manual del usuario de PI DataLink 2014 13

Conceptos básicos

Paneles de tareas de funciones

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

Un panel de tareas es un panel de controles que puede mover y acoplar. Puede continuar
trabajando en una hoja de cálculo mientras el panel de tareas está abierto.
Para abrir un panel de tareas de función:
• Haga clic en la celda de salida deseada y, a continuación, haga clic en un comando de función
de la pestaña PI DataLink para añadir una función.
• Haga clic en una celda de una matriz de función existente para mostrar el panel de tareas
correspondiente y editar las entradas de la función.
Nota:
Si lo prefiere, puede desactivar la aparición automática de paneles de tareas. Consulte
Configuración de preferencia.
• Haga clic con el botón derecho en una celda de matriz de función y seleccione el nombre de
la función para mostrar manualmente el panel de tareas.
Una vez que está abierto un panel de tareas de función:
• Introduzca o modifique valores y, a continuación:
◦ Haga clic en Aceptar para guardar los valores de entrada, escribir la matriz de función
resultante y cerrar el panel de tareas.
◦ Haga clic en Aplicar para guardar los valores de entrada y escribir la matriz de función
resultante sin cerrar el panel de tareas.
• Haga clic en el botón de flecha para seleccionar los comandos Mover, Tamaño o Cerrar.
• Arrastre la barra de título para desacoplar el panel de tareas.
• Haga doble clic en la barra de título 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 2014

 Conceptos básicos

Menú contextual
PI DataLink añade varios comandos al menú contextual estándar de Microsoft Excel. Puede
utilizar estos comandos para gestionar matrices de función que ya estén insertadas en una hoja
de cálculo.
Para abrir el menú contextual con los comandos de PI DataLink, haga clic con el botón derecho
del ratón en cualquier lugar de una matriz de función de PI DataLink.
PI DataLink añade los siguientes comandos al menú contextual:
• Seleccionar función DataLink
Selecciona la matriz de función completa.
Debe seleccionar una matriz antes de intentar copiarla, cortarla o arrastrarla a una nueva
ubicación en la hoja de cálculo.
• Recalcular (Redimensionar) función
Vuelve a escribir la matriz de función completa: PI DataLink recupera valores nuevos de PI
Server o PI AF y redimensiona automáticamente la matriz para que se ajuste a los datos
obtenidos.
• Nombre de función
Abre el panel de tareas de función correspondiente y muestra las entradas de la matriz de
función.
Las tendencias ofrecen un menú contextual alternativo.

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

Descripción general de las funciones de PI DataLink

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

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

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

Manual del usuario de PI DataLink 2014 15

Conceptos básicos

• Datos añadidos
• Formatos de presentación

Elementos de datos
Las funciones de PI DataLink devuelven datos sobre determinados elementos de datos de PI
System, ya sean PI points o atributos de PI AF. Las funciones pueden obtener valores
registrados de una base de datos o valores calculados en función de determinados criterios o
una expresión concreta.
Al definir una función, especifique las rutas de los elementos de datos con los campos
Elemento de datos, Expresión y Expresión de filtro junto con el campo opcional Ruta raíz.
Puede especificar:
• Rutas completas en los campos Elemento de datos, Expresión o Expresión de filtro. Una ruta
completa comienza con dos barras diagonales inversas (\\) y evalúa un PI point o un
atributo de PI AF.
• Las rutas parciales en los campos Elemento de datos, Expresión o Expresión de filtro y la
ruta de acceso base en el campo Ruta raíz. Los nombres de PI point o los nombres de
atributos de PI AF son ejemplos de rutas parciales. PI DataLink combina la ruta de acceso
base común con la ruta parcial para establecer la ruta completa que evalúa un PI point o un
atributo de PI AF.
PI DataLink requiere una ruta completa para localizar el elemento de datos. Para localizar un PI
point, PI DataLink debe conocer el PI Server donde realizará la búsqueda y el nombre del
punto. Para localizar un atributo de PI AF, PI DataLink debe conocer el servidor de PI AF, la
base de datos, el elemento y todos los subelementos y atributos primarios. Utilice una barra
vertical (|) para separar los atributos de los elementos o de los atributos primarios.
Puede dejar el campo Ruta raíz en blanco si los campos Elemento de datos, Expresión y
Expresión de filtro contienen una ruta completa o un PI point en el PI Server predeterminado.
Si se especifica, el campo Ruta raíz indica la ruta común de los elementos de datos
especificados.
Tipo de elemento de Contenido del campo de ruta raíz
datos
PI point PI Server que almacena el punto o un valor en blanco para indicar el PI Server
predeterminado. Las entradas válidas incluyen:
• PIServer
• \\PIServer
Atributo de PI AF Servidor de PI AF y base de datos junto con cualquier elemento, subelemento
o atributos primarios no especificados en Elemento de datos. Las entradas
válidas incluyen:
• \\PIAFserver\database
• \\PIAFserver\database\element
• \\PIAFserver\database\element\subelement
• \\PIAFserver\database\element|ParentAttribute
• \\PIAFserver\database\element|ParentAttribute1|
ParentAttribute2
Nota:
El servidor de PI AF y la base de datos deben estar en el mismo campo.
No puede especificar el servidor de PI AF en el campo Ruta raíz y la
base de datos en el campo Elemento de datos.

16 Manual del usuario de PI DataLink 2014

 Conceptos básicos

Consulte también
Expresiones

Campo de entrada
Los campos etiquetados como de entrada en los paneles de tareas de función aceptan valores
correctos para la función. En la mayor parte de los campos de entrada, puede introducir un
valor o una referencia a una celda de hoja de cálculo 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 edición , puede:

• Introducir texto directamente en el campo de edición; por ejemplo un nombre de atributo

de PI AF o la dirección de una celda de salida.
• Hacer clic en el campo de edición y después en una celda o rango de la hoja de cálculo que
contenga valores correctos, como nombres de atributo de PI AF, marcas de tiempo o
ubicaciones de celdas de salida.
• Haga clic en el campo de edición para abrir una lista de valores válidos entre los que puede
seleccionar (solo disponible para los campos Ruta raíz y Base de datos).
• Hacer clic en para abrir la herramienta de búsqueda y, a continuación, seleccionar los
elementos de datos obtenidos en una búsqueda de un PI Server o un servidor de PI AF
conectado.
En el caso de entradas con listas , puede:
• Seleccionar una opción de la lista, como un cálculo o un método de muestreo.
• Hacer clic en y, a continuación, en una celda o rango de hoja de cálculo que contenga
valores correctos, como el modo, la unidad de tiempo, el límite o la propiedad.
Nota:
En los campos de edición, introduzca cadenas sin comillas. Sin embargo, en las celdas de
hojas de cálculo, introduzca las cadenas con comillas sencillas iniciales (') para obligar a
Excel a interpretar el contenido como una cadena.
Por ejemplo, para especificar un PI point en el campo Elemento(s) de datos, puede:
• Introducir la cadena del nombre del punto.
• Hacer clic en para abrir la herramienta de búsqueda y buscar el punto en el PI Server.

• Introducir una referencia a una celda de hoja de cálculo 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 cálculo.
PI DataLink introducirá automáticamente la referencia de la celda en el campo de
edición.

Campos de entrada de tiempo

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

Manual del usuario de PI DataLink 2014 17

Conceptos básicos

para obtener los valores de momento específico. Siga estas indicaciones para especificar
valores en los campos de entrada de tiempo:
• Introduzca un tiempo absoluto, como 10-dic-99 19:12, o una expresión de tiempo de PI
que especifique un tiempo relativo; por ejemplo, -3h. Por ejemplo, puede introducir un
tiempo absoluto para definir un periodo de tiempo en el pasado o puede introducir una
expresión de tiempo relativa para definir un periodo de tiempo que incluya el momento
actual.
• Si la hora de inicio es más reciente que la hora de finalización, PI DataLink muestra los
resultados en orden cronológico 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 también pueden utilizar el formato absoluto de tiempo de Excel
(como 39299.6146, equivalente a 8/5/2007 [Link] PM). Excel almacena las marcas de
tiempo en este formato, que representa el número acumulado de días desde 1900. Excel
puede mostrar las mismas marcas de tiempo utilizando cualquier formato de fecha y hora
asignado a la celda.
• Algunas entradas de tiempo, como 9:45, pueden representar un tiempo válido y un rango
válido de filas de hoja de cálculo. En el campo del panel de tareas, coloque al principio de
estas entradas comillas 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 términos de frecuencia, convierta la frecuencia a los segundos
equivalentes. Por ejemplo, una frecuencia de 25 Hz debe introducirse como un intervalo de
0,04s (=1/25 de segundo).
Nota:
PI DataLink solo admite el sistema predeterminado de fecha de 1900 admitido por Excel.
PI DataLink no admite el sistema de fecha de 1904 de Excel, y devuelve marcas de tiempo
incorrectas si se utiliza dicho sistema.

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

Datos añadidos
PI DataLink puede añadir información sobre los valores recuperados. Los datos añadidos
pueden proporcionar un contexto a los valores recuperados. Los datos añadidos pueden
incluir:
• Marcas de tiempo que muestran cuándo se registraron los valores
• Marcas de tiempo que indican las horas de inicio y finalización de un intervalo
• Marcas de tiempo que indican la ocurrencia de los valores mínimo y máximo
• El porcentaje de valores correctos durante un intervalo de muestra
• Atributos de valor

18 Manual del usuario de PI DataLink 2014

 Conceptos básicos

• Anotaciones introducidas manualmente

• Nombres de servidores fuente
PI DataLink muestra los datos añadidos especificados en las columnas (o filas) junto a los
valores principales que la función devuelve:
• Los datos de tiempo se muestran en columnas a la izquierda (o en filas encima) de los
valores principales.
• Otros datos relacionados se añaden en columnas a la derecha (o en filas debajo) de los
valores principales.

Formatos de presentación
Utilice la ventana Configuración para especificar los formatos de fecha y número que PI
DataLink utiliza para dar formato a los datos en las matrices de función. Hay dos
configuraciones:
• Formato de número
El formato para los números en la salida de función. El ajuste predeterminado, General, da
formato a los números (y a todos los datos que no son marcas de tiempo) para que
coincidan con el formato de la categoría General en la ventana Formato de celdas.
• Formato de hora
El formato para las marcas de tiempo en la salida de función. El formato de fecha
predeterminado, dd-mmm-yy hh:mm:ss, coincide con el formato de marca de tiempo
estándar de PI. Puede añadir :000 al final de la cadena (dd-mmm-yy hh:mm:ss:000) para
mostrar marcas temporales por debajo de un segundo. Tenga en cuenta que Excel no admite
formatos con precisión de microsegundos.
Puede personalizar las cadenas de formato predeterminadas utilizando cualquier código de
formato de Excel válido del cuadro de diálogo Formato de celdas en Excel.
Para obtener detalles en la ventana Configuración, consulte Configuración de preferencia.
También puede aplicar un formato de fecha y hora individual a cualquier celda de hoja de
cálculo, incluidas las que contienen funciones de PI DataLink con el cuadro de diálogo Formato
de celdas. Consulte su documentación sobre Excel para obtener más información sobre cómo
dar formato a fechas y horas.

Búsquedas
PI DataLink ofrece dos formas de buscar elementos de datos:

• La herramienta de búsqueda
La herramienta de búsqueda permite buscar PI points o atributos de PI AF buscando texto
coincidente o explorando un PI Server o una base de datos PI AF. Según cómo se abra la
herramienta, inserta los puntos o atributos encontrados en hojas de cálculo o en paneles de
tareas de funciones.

• Función de búsqueda de filtro de activo

La función Búsqueda de filtro de activo permite buscar elementos PI AF que satisfacen unos
criterios y filtrarlos en función de ciertos valores de atributos. La función puede devolver
los elementos filtrados o atributos seleccionados de los elementos filtrados. La función
puede pegar los activos filtrados en la hoja de cálculo como valores o como matriz de
función.

Manual del usuario de PI DataLink 2014 19

Conceptos básicos

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

Buscar elementos de datos

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

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

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

2. Defina el ámbito de la búsqueda, 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 PI
Servers (indicados por ) y los servidores de PI AF (indicados por ) que aparecen
listados en el Gestor de conexiones. Debe limitar la búsqueda a un solo PI Server o un solo
servidor de PI AF e incluso aún más, a una única base de datos en un servidor de PI AF y
después a determinados elementos y atributos primarios.
La siguiente vez que se utiliza, la herramienta inicia la sesión con el ámbito de la búsqueda
definido en el último PI Server, servidor de PI AF o base de datos de PI AF utilizados en la
búsqueda.
Puede:
◦ Utilizar el panel del navegador para limitar la búsqueda
◦ Utilizar la ruta del ámbito para limitar la búsqueda
Si define el ámbito de búsqueda como un elemento o un atributo, en el panel de resultados
se incluirán los atributos secundarios inmediatos de ese elemento o atributo.
3. Según proceda, 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.
La herramienta añade caracteres comodín implícitos detrás del texto que escriba. Por
ejemplo:

20 Manual del usuario de PI DataLink 2014

 Conceptos básicos

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

La herramienta busca dentro del ámbito especificado los elementos de datos que
coinciden con el texto que se ha escrito y devuelve los elementos de datos encontrados
en el panel de resultados. La herramienta busca en la totalidad de la jerarquía debajo del
ámbito de búsqueda. (En contraposición, cuando se busca en la jerarquía, el panel de
resultados solo muestra los atributos secundarios inmediatos del ámbito de búsqueda.)
La herramienta localiza:
▪ PI points con nombres coincidentes.
▪ Atributos de PI AF con nombres coincidentes.
▪ Atributos de PI AF que tienen elementos principales con nombres, descripciones,
categorías o plantillas coincidentes.
Nota:
Las búsquedas de PI Server devuelven un máximo de 100.000 PI points. Para
asegurarse de ver todos los resultados, limite la búsqueda para que devuelva menos PI
points.
4. Si lo desea, cambie las columnas que se muestran en el panel de resultados:
◦ Haga clic con el botón derecho del ratón en el panel de resultados y, a continuación, haga
clic en el nombre de una columna para añadirla o eliminarla de las columnas mostradas.
◦ Arrastre los encabezados de columna para cambiar el orden de las columnas mostradas.
5. Si lo desea, mueva el control deslizante Longitud de ruta raíz para dividir la ruta de
elemento de datos entre las columnas Ruta raíz y Elemento de datos:
◦ Seleccione Mínimo para especificar una ruta completa en la columna Elemento de datos.
◦ Seleccione Máximo para especificar solo el atributo o el nombre de punto en la columna
Elemento de datos, con el resto de la ruta en la columna Ruta raíz.
◦ Seleccione posiciones intermedias para otras divisiones de contenido entre las columnas.
El contenido de estas columnas determina el contenido que se añade a los campos del panel
de tareas o las columnas de hoja de cálculo.
6. Si va a insertar elementos de datos en una hoja de cálculo, especifique cómo se insertará el
contenido de Ruta raíz:

Manual del usuario de PI DataLink 2014 21

Conceptos básicos

◦ Seleccione Columna o fila para insertar el contenido de las columnas Ruta raíz y
Elemento de datos en las celdas de hoja de cálculo designadas.
Si ambas columnas contienen datos, PI DataLink inserta siempre el contenido de Ruta
raíz en la primera columna de la hoja de cálculo y el contenido de Elemento de datos en
la segunda. Si únicamente la columna Elemento de datos incluye contenido (es decir, una
ruta completa), PI DataLink solo inserta esa columna en la hoja de cálculo:
◦ Seleccione Lista desplegable para insertar una lista desplegable de rutas (procedentes de
la columna Ruta raíz) seguida de los elementos de datos (procedentes de la columna
Elemento de datos) en las celdas de hoja de cálculo designadas.
Si referencia la lista desplegable y los elementos de datos insertados en una función de PI
DataLink, la hoja de cálculo actualizará de forma dinámica los valores recuperados
cuando se seleccione una ruta diferente en la lista.
Nota:
PI DataLink inserta la lista de rutas raíz en la columna EZ de la hoja de cálculo. Si
esa columna contiene datos, PI DataLink inserta las rutas en la siguiente columna
disponible a la derecha.
7. Seleccione los elementos que desee insertar y haga clic en Aceptar.

Consulte también
Crear un despliegue relacionado con activos

Utilizar el panel del navegador para limitar la búsqueda

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

Procedimiento
• En el panel del navegador:
◦ Haga clic en un servidor para limitar la búsqueda a ese servidor.
La herramienta actualiza la ruta del ámbito en la parte superior de la venta para listar el
servidor seleccionado y actualiza el panel de navegación. Si ha hecho clic en un servidor
de AF (indicado por ), el panel del navegador muestra todas las bases de datos de ese
servidor. Si ha hecho clic en un PI Server (indicado por ), el panel del navegador
muestra filtros que puede utilizar para limitar el número de PI points recuperados en
función de los valores de atributos.
◦ Haga clic en una base de datos (indicado por ) para limitar la búsqueda a esa base de
datos.

22 Manual del usuario de PI DataLink 2014

 Conceptos básicos

La herramienta actualiza el panel del navegador para mostrar todos los elementos de
primer nivel en la base de datos seleccionada y actualiza la ruta del ámbito en la parte
superior de la ventana para listar la base de datos seleccionada.
◦ Haga clic en un elemento (indicado por ) para limitar la búsqueda a ese elemento.
La herramienta actualiza el panel del navegador para mostrar todos los elementos y
atributos principales bajo el elemento seleccionado, actualiza la ruta del ámbito en la
parte superior de la ventana para listar el elemento de datos seleccionado y lista todos
los atributos bajo el elemento seleccionado en el panel de resultados.
Tenga en cuenta que el panel del navegador solo muestra atributos principales, en tanto
que el panel de resultados muestra atributos principales y no principales bajo el
elemento seleccionado.
◦ Haga clic en un atributo (indicado por ) para limitar la búsqueda a ese atributo.
La herramienta actualiza el panel del navegador para mostrar todos los atributos
principales bajo el elemento seleccionado, actualiza la ruta del ámbito en la parte
superior de la ventana para listar el atributo seleccionado y lista todos los atributos bajo
el atributo seleccionado en el panel de resultados.

Utilizar la ruta del ámbito para limitar la búsqueda

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

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

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

Manual del usuario de PI DataLink 2014 23

Conceptos básicos

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

Buscar activos mediante filtros

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

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

24 Manual del usuario de PI DataLink 2014

 Conceptos básicos

▪ En la lista Atributo, seleccione un atributo de los elementos basados en la plantilla de

elementos seleccionada.
▪ En la lista Operador, seleccione el operador relacional, como =, < o >. Para los atributos
que contienen valores de cadena, booleanos o enumerados, los únicos operadores
válidos son = y <>.
▪ En el campo Valor, escriba el valor del filtro. Puede utilizar caracteres comodín para
los atributos de cadena.
Por ejemplo, para recuperar elementos cuyo atributo Fabricante empiece por ABC y
que tengan un atributo de CódigoPostal entre 94102 y 94188 (ambos inclusive),
introduzca tres condiciones:
Fabricante =ABC*
CódigoPostal >=94102
CódigoPostal <=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 función utiliza la
configuración de las preferencias de máximo de filtros de búsqueda para limitar el
número de elementos en los que se buscan valores de atributo coincidentes. Consulte
Configuración de preferencia.
5. Especifique la salida de la hoja de cálculo:
a. En la lista Atributos para mostrar, seleccione los atributos que desea incluir y defina el
orden de los atributos.
Si no selecciona ningún atributo, la función Búsqueda de filtro de activo solo devuelve los
elementos coincidentes. Si selecciona como mínimo un atributo, la función 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 listados.
▪ 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 cómo pegar los elementos o atributos coincidentes en la hoja de cálculo:
▪ Haga clic en Columna para insertar la ruta completa de los elementos o atributos en
las celdas designadas de la hoja de cálculo.
▪ 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 cálculo.
Seleccione solo Lista desplegable si ha seleccionado como mínimo un atributo.

Manual del usuario de PI DataLink 2014 25

Conceptos básicos

En otra función de PI DataLink, puede incluir una referencia a la lista desplegable

insertada desde un campo Ruta raíz y a los atributos desde un campo Elemento de
datos para crear visualizaciones relacionadas con activos: la hoja de cálculo
actualizará dinámicamente los valores recuperados cuando seleccione una ruta
distinta en la lista. Consulte Despliegues relacionados con activos.
c. Indique el formato de salida:
▪ Haga clic en Matriz de función para pegar una matriz de función. Este es el formato de
salida de otras funciones de PI DataLink. Con una matriz de función, puede actualizar
fácilmente las entradas del panel de tareas y recalcular los resultados.
▪ Haga clic en Valores para pegar la salida como valores. Puede copiar fácilmente
valores para utilizarlos en otro lugar.
Consejo:
Las matrices de función son especialmente útiles cuando los resultados de la
función cambian con frecuencia. Sin embargo, el recálculo de la matriz de función
que se produce cada vez que se abre una hoja de cálculo 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 función.
d. Compruebe que el campo Celda de salida contiene la celda superior izquierda del
intervalo de la hoja de cálculo donde desea insertar los activos devueltos.
6. Haga clic en Aceptar para insertar los elementos o atributos en la hoja de cálculo y cerrar el
panel de tareas.

Configuración de preferencia
Utilice el cuadro de diálogo Configuración para especificar preferencias globales y formatos
predeterminados para la salida de las funciones de PI DataLink. Estas configuraciones se
aplican a un determinado usuario o equipo.

Procedimiento
1. En la pestaña PI DataLink, en el grupo Recursos, haga clic en Configuración.
2. Defina el ajuste que desee y haga clic en Aceptar.
Ajuste Descripción
Copiar nombre de PI Server Seleccione esta opción para pegar el nombre del origen de datos
(sólo complemento heredado) de PI Server en una celda de hoja de cálculo adyacente cuando
inserte nombres de PI point procedentes de funciones de tags en
una hoja de cálculo.
Mostrar #N/D en vez de Seleccione esta opción para mostrar #N/A (no aplicable) en lugar
espacios en blanco de celdas en blanco sin valores cuando el recálculo devuelve
menos valores de los que puede mostrar una matriz de función.
Esta función es particularmente útil cuando los resultados de la
función se trazan mediante el paquete de gráficas de Excel.
Independiente regional Seleccione 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.
El tiempo PI asume que todas las cadenas están en inglés 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 configuración regional de la estación de trabajo cliente,
recurriendo al formato de tiempo PI solo si es necesario.

26 Manual del usuario de PI DataLink 2014

 Conceptos básicos

Ajuste Descripción
Desactivar la visualización Seleccione esta casilla para evitar la aparición automática del
automática del panel de tareas panel de tareas de función al hacer clic en una celda de función.
al hacer clic
Desactivar el mensaje Seleccione esta casilla para no mostrar un mensaje de advertencia
"Redimensionar para mostrar cuando el número de valores recuperados por una matriz
todos los valores" recalculada exceda el número que una matriz puede mostrar.
Zona horaria de cliente Selecciónela para interpretar las marcas de tiempo de entrada y
mostrar marcas de tiempo de salida en la zona horaria de la
estación de trabajo cliente. Algunas funciones mostrarán
determinadas marcas de tiempo en la zona horaria de PI Server.
Consulte Límites de configuración de zona horaria para encontrar
más información sobre estas excepciones.
Zona horaria de PI Server Selecciónela para interpretar las marcas de tiempo de entrada y
mostrar marcas de tiempo de salida en la zona horaria de PI
Server. Este ajuste solo es válido 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 expresión 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 estación de trabajo cliente.
Esta opción solo tiene importancia si la configuración de zona
horaria de un un PI Server no coincide con la de la estación de
trabajo cliente.
Zona horaria UTC Selecciónela 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
configuración. Consulte Límites de configuración de zona horaria
para encontrar más información sobre estas excepciones.
En una fila Seleccione esta opción para pegar varios resultados de una
búsqueda en una fila de valores en la hoja de cálculo.
En una columna Seleccione esta opción para pegar varios resultados de una
búsqueda en una columna de valores en la hoja de cálculo. Valor
predeterminado.
Formato de número Introduzca el formato para los números en la salida de función. La
cadena de formato puede ser cualquier código de formato
numérico válido de la ventana Formato de Excel (consulte
Formatos de presentación).
Durante la instalación, PI DataLink asigna el formato numérico
predeterminado de Excel a este campo, a menos que haya ajustado
su propia preferencia de formato anteriormente en PI DataLink. Si
su versión de Excel se ejecuta con una configuración regional
diferente, este formato incluye la sintaxis correcta para reflejar la
configuración. Por ejemplo:
35.03
aparecerá como
35,03
en Excel francés.

Manual del usuario de PI DataLink 2014 27

Conceptos básicos

Ajuste Descripción
Formato de hora Introduzca el formato para las marcas de tiempo en la salida de
función. La cadena de formato puede ser cualquier código de
formato de fecha-hora válido del cuadro de diálogo Formato de
Excel.
Durante la instalación, PI DataLink asigna el formato estándar 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
versión de Excel se ejecuta con una configuración regional
diferente, este formato incluye la sintaxis correcta para reflejar la
configuración. Por ejemplo:
dd-mmm-yy hh:mm:ss
aparecerá como
jj-mmm-aa hh:mm:ss
en Excel francés.
Máximo de eventos Introduzca el número máximo de eventos que devuelven las
funciones Explorar eventos y Comparar eventos para la vista
previa y a la hoja de cálculo.
Máximo de filtros de búsqueda Introduzca el número máximo de elementos que devuelve la
función Búsqueda de filtro de activo en la hoja de cálculo, excepto
cuando se especifica un filtro de valor de atributo para un atributo
con una referencia de datos. En este caso, introduzca el número
total de elementos entre los que desea buscar un atributo con una
referencia de datos; tenga en cuenta que si el número es
demasiado bajo, la función podría devolver menos resultados de
los esperados.
Calcular (F9) Seleccione esta opción para volver a calcular todas las funciones
volátiles (y las funciones que hagan referencia a ellas) durante
todos los procesos de recálculo que la función Actualización
automática inicie. La función Valor actual es la única función de PI
DataLink volátil.
Cálculo completo (Ctrl+Alt Seleccione esta opción para volver a calcular todas las funciones,
+Mayúsculas+F9) independientemente de la volatilidad, durante todos los procesos
de recálculo que la función Actualización automática inicie.
Intervalo (segundos) Introduzca el número de segundos entre cada recálculo que la
función Actualización automática inicie. El valor mínimo es cinco
segundos. Introduzca 0 para que PI DataLink calcule un intervalo
automático en función de la duración de los tiempos de cálculo
anteriores.

Límites de configuración de zona horaria

La configuración de la zona horaria está restringida a determinados límites:
• La función de búsqueda de notificaciones actualmente no es compatible con la configuración
de zona horaria UTC. La función de búsqueda de notificaciones siempre utiliza la zona
horaria del cliente.
• Si una anotación contiene una marca de tiempo, la función de datos comprimidos siempre
muestra la marca de tiempo en la zona horaria del PI Server.
• La función de propiedades siempre muestra los valores de atributos de PI point que
contienen marcas de tiempo (como la fecha de creación y la fecha de modificación) en la
zona horaria del PI Server.

28 Manual del usuario de PI DataLink 2014

 Conceptos básicos

• Las tendencias creadas con el complemento PI DataLink (Legacy) siempre muestran los
datos en la zona horaria del PI Server.
• Las funciones de base de datos del módulo de PI DataLink (función Alias a Tag y función
Propiedad para valor) no son compatibles con la configuración de zona horaria UTC. Cuando
se selecciona la zona horaria UTC, estas funciones utilizan la zona horaria del cliente.

Gestionar conexiones con servidores

Utilice Gestor de conexiones para gestionar las conexiones con cualquier PI Server o servidor
de PI AF, incluida la selección del PI Server o servidor de PI AF predeterminado.

Procedimiento
1. En la pestaña PI DataLink, en el grupo Recursos, haga clic en Configuración para abrir el
cuadro de diálogo Configuración.
2. Haga clic en Gestor de conexiones para abrir el cuadro de diálogo Servidores, que muestra
las conexiones de servidor definidas y el estado actual de esas conexiones, incluidos los
servidores predeterminados.
3. Modifique las conexiones, según desee:
◦ Haga clic en Añadir servidor AF para abrir el cuadro de diálogo Propiedades de servidor
AF, donde podrá definir una conexión con un servidor de PI AF.
◦ Haga clic en Añadir PI Server para abrir el cuadro de diálogo Propiedades de PI Server,
donde podrá definir una conexión con un PI Server.
◦ 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 sesión. Para conectarse con PI Servers, PI DataLink puede
utilizar un PI trust o un usuario predeterminados, además de las credenciales de
Windows del usuario que ha iniciado sesión.
◦ Seleccione un servidor que no sea actualmente la conexión predeterminada y haga clic en
Establecer como predeterminado para que ese servidor sea la conexión predeterminada
(un PI Server o un servidor de PI AF).
◦ Seleccione un servidor y haga clic en Propiedades para ver las propiedades de conexión
de ese servidor.
◦ Haga clic con el botón derecho del ratón en un servidor y seleccione Eliminar para
suprimir la definición de conexión con ese servidor.

Manual del usuario de PI DataLink 2014 29

Conceptos básicos

30 Manual del usuario de PI DataLink 2014

Creación de hojas de cálculo
En esta sección se explica cómo crear hojas de cálculo con PI DataLink y algunos tipos
específicos de pantallas que puede crear con PI DataLink. Los temas sobre pantallas incluyen
procedimientos para crear dichas pantallas.

En esta sección
• Proceso de creación de hojas de cálculo
• Despliegues relacionados con activos
• Eventos en hojas de cálculo

Proceso de creación de hojas de cálculo

Una vez familiarizado con los conceptos y herramientas básicas de PI DataLink, estará
preparado para crear una hoja de cálculo que utilice funciones de PI DataLink.

Considere sus objetivos

Hágase estas preguntas:
• ¿Qué datos desea mostrar en una hoja de cálculo a fin de controlar el rendimiento o
responder a un problema del negocio?
• ¿Dónde residen los datos?
• ¿Cómo puede mostrar de la forma más eficaz la información, tanto para comunicar puntos
esenciales como para proporcionar el necesario contexto de fondo?
Las respuestas le ayudarán a determinar qué funciones de PI DataLink pueden devolver los
datos más adecuados para la tarea.

Seleccione un enfoque
Entre las técnicas que puede utilizar para construir una hoja de cálculo están:
• Basada en funciones
Añada la función de PI DataLink a la hoja de cálculo y cree la presentación alrededor de
estas funciones según sea necesario. Por ejemplo, es posible que desee añadir información
de punto para que le ayude a aclarar lo que representan los datos. Este puede ser el mejor
enfoque si todavía está averiguando cuáles son sus requisitos o aprendiendo cómo funciona
PI DataLink.
• Basado en estructuras
Añada una estructura cuando construya una hoja de cálculo. Utilice la herramienta
Búsqueda para insertar elementos de datos que enmarquen el asunto de su hoja de cálculo
y, a continuación, añada funciones para recuperar los datos correspondientes. Este enfoque
requiere algo más de planificación y familiaridad con PI DataLink, pero después de añadir
los elementos de datos a la hoja de cálculo, podrá utilizarlos para crear funciones más
fácilmente mediante referencias de celda. De esta forma, podrá reutilizar más fácilmente las
hojas de cálculo.
• Basado en informes
Coloque las funciones de PI DataLink en la segunda hoja de cálculo de un libro y referencie
los resultados de esas funciones en la primera hoja de cálculo. Utilice las funciones de

Manual del usuario de PI DataLink 2014 31

Creación de hojas de cálculo

seguridad de Excel para ocultar y proteger la sintaxis de las funciones y la lógica del negocio
en la segunda hoja de cálculo de la mayoría de usuarios. Este enfoque es útil si es un
administrador del sistema o crea hojas de cálculo para otros usuarios. Esta estrategia
también funciona bien con documentos distribuidos mediante PI DataLink Server.

Consulte también
Funciones de PI DataLink
Buscar elementos de datos
PI DataLink Server (DLS)

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.

Despliegue relativo a activos para el elemento React1

Despliegue relativo a activos para el elemento React2

Los despliegues relativos a activos requieren un conjunto común 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 común en la hoja de cálculo con una lista desplegable de rutas raíz y, a
continuación, añada una función 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 común en la hoja de cálculo.
2. Configurar una función de PI DataLink que haga referencia a los elementos de datos
insertados.

32 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

Consulte también
Buscar elementos de datos

Insertar un conjunto de elementos de datos con una estructura común

en la hoja de cálculo
Los despliegues relativos a activos requieren que la hoja de cálculo contenga un conjunto de
elementos de datos (atributos de PI AF) que tengan una estructura común junto con una lista
desplegable de rutas raíz para esos elementos de datos.

Procedimiento
1. Seleccione una celda en la hoja de cálculo donde va a insertar los elementos de datos.
2. En la pestaña PI DataLink, haga clic en Buscar para abrir la herramienta Búsqueda.
3. Defina el ámbito de la búsqueda, 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 común y la misma estructura de atributos. Estos
atributos podrían tener la misma plantilla de atributos. Por ejemplo, es posible que desee
localizar todos los reactores de sus instalaciones.
4. Divida la ruta de elementos de datos para que los activos del despliegue aparezcan en la
columna Ruta raíz.
Desplace el control deslizante Longitud de ruta raíz hasta que la columna Ruta raíz muestre
los elementos exclusivos de los atributos listados. Por lo general, coincidirá exactamente
con el valor Máximo o estará muy próximo a él.

5. Seleccione los elementos de datos que desee insertar en la hoja de cálculo.

Manual del usuario de PI DataLink 2014 33

Creación de hojas de cálculo

6. En Insertar rutas raíz en, seleccione Lista desplegable.

7. Haga clic en Aceptar.
PI DataLink inserta los elementos de datos exclusivos en la hoja de cálculo debajo de una
lista desplegable que contiene los activos exclusivos (procedentes de la columna de ruta
raíz).

Nota:
PI DataLink inserta la lista de rutas raíz en la columna EZ de la hoja de cálculo. Si esa
columna contiene datos, PI DataLink inserta las rutas en la siguiente columna
disponible a la derecha.

Configurar una función de PI DataLink que haga referencia a los

elementos de datos insertados
Los despliegues relativos a activos exigen que configure una función de PI DataLink para
obtener datos para los elementos de datos y la ruta raíz que ha insertado en la hoja de cálculo:
un conjunto de elementos de datos con una estructura común y la ruta raíz de esa estructura.

Procedimiento
1. Haga clic en la celda de la hoja de cálculo situada junto al primer elemento de datos del
intervalo que ha insertado.
2. En la pestaña PI DataLink, haga clic en la función que desee utilizar para obtener valores.
El panel de tareas de función se abre en la celda pulsada especificada en Celda de salida.
3. En el panel de tareas de función, haga clic en el campo Elemento(s) de datos y, a
continuación, seleccione el intervalo de hojas de cálculo 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 función, haga clic en el campo Ruta raíz y, a continuación, seleccione
la celda de hoja de cálculo que contenga la lista desplegable de rutas raíz.
PI DataLink inserta una referencia de celda en el campo.
5. Especifique otras entradas de función, según desee.
6. Haga clic en Aceptar para insertar la matriz de función en la hoja de cálculo.
Puede seleccionar un activo diferente en la lista para ver los valores de atributo de ese
activo.

34 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

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

Eventos en hojas de cálculo

Puede utilizar PI DataLink para crear pantallas para ver, entender y analizar los eventos
almacenados en PI AF. La configuración 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 información sobre procesos por lotes o eventos creados a partir de cálculos.
Puede utilizar dos funciones de PI DataLink para recuperar eventos:

• Función Explorar eventos

La función Explorar eventos devuelve un evento por fila y resulta útil para explorar eventos
en cualquier posición de la jerarquía de eventos. Puede utilizar la función Explorar eventos
para examinar los datos en una jerarquía sencilla, por ejemplo, para analizar los eventos de
un elemento concreto. Pongamos que quiere examinar el tiempo de inactividad de una
caldera determinada.

Explorar los eventos relacionados con un elemento

También puede utilizar la función Explorar eventos para examinar los eventos en una
jerarquía 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

• Función Comparar eventos

La función Comparar eventos puede devolver atributos de eventos relacionados en una
única fila y resulta útil para comparar eventos jerárquicos. En las pantallas creadas con la
función Comparar eventos, cada fila puede mostrar un evento recuperado junto con
información de los eventos secundarios y primarios de dicho evento. La inclusión de esta
información puede ayudarle a comparar los eventos recuperados. Por ejemplo, incluir
información sobre los eventos de fase de un evento de inicio puede ayudarle a comparar
múltiples eventos de inicio.
La función Comparar eventos identifica los atributos por ruta. Por lo tanto, la visualización
depende de los nombres de atributo y su posición jerárquica. Las capacidades de la función
difieren según la estructura de los eventos y sus atributos:

Manual del usuario de PI DataLink 2014 35

Creación de hojas de cálculo

◦ Eventos que tienen eventos secundarios con nombres idénticos

Si tiene un conjunto de eventos que incluye eventos secundarios con nombres idénticos,
puede comparar dichos eventos incluyendo información del evento secundario e
información del evento primario. Especifique los criterios para localizar los eventos con
eventos secundarios con nombres idénticos. La función Comparar eventos puede incluir
información 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 idénticos, como Phase1, Phase2 y Phase3.

Comparación de eventos mediante la inclusión de información de eventos secundarios

La función Comparar eventos también puede incluir información sobre eventos

primarios en la misma fila que un evento coincidente. Puede incluir información del
evento principal para tener más datos sobre los eventos coincidentes. Por ejemplo, para
los eventos de inicio de turbina coincidentes, la información sobre el evento de proceso
principal mejoraría la comparación.

Comparación de eventos mediante la inclusión de información 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 información del evento primario. Especifique
los criterios para localizar los eventos de nivel inferior en la jerarquía. La función
Comparar eventos puede incluir información 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 información sobre el evento de inicio principal.

Comparación de eventos mediante la inclusión de información de eventos principales

En esta sección
• Explorar los eventos relacionados con un elemento
• Explorar eventos con eventos secundarios
• Comparación de eventos mediante la inclusión de eventos secundarios
• Comparación de eventos mediante la inclusión de eventos principales
• Nombres de atributo reservados

36 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

Explorar los eventos relacionados con un elemento

Puede utilizar la función 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 gráfico para analizar los datos. En ese caso, podría
encontrar eventos que coincidan con un nombre de elemento y un nombre de evento.

Procedimiento
1. Seleccione la celda de la hoja de cálculo en la que desea que PI DataLink empiece a
introducir la matriz de función que contiene los eventos.
2. En la pestaña PI DataLink, en el grupo Eventos, haga clic en Explorar para abrir el panel de
tareas Explorar eventos.
3. Especifique los criterios para localizar los eventos en los que está interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizará para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. 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 Inicio de búsqueda y Fin de búsqueda especifican el período de tiempo en el
que buscar eventos activos.
Introduzca una expresión de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el último mes, introduzca *-1mo en el campo Inicio de búsqueda y * en el campo
Fin de búsqueda.
Consejo:
Para localizar eventos que tengan una relación más específica con este período de
tiempo, como eventos iniciados o finalizados durante este período de tiempo,
expanda Más opciones de búsqueda y seleccione un método alternativo de la lista
Modo de búsqueda.
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
función (que se muestran en la lista Vista previa).
Consulte Referencia del panel de tareas Explorar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Nombre de evento para limitar los eventos devueltos a
aquellos con un nombre determinado. Podría introducir *shut* para encontrar todos
los eventos que contienen shut en el nombre, como shutdown y BoilerShutdown. Si
acepta la entrada predeterminada, *, la función encontrará eventos con distintos
nombres.
Por ejemplo, utilice el campo 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 cálculo:
a. En la lista Columnas para mostrar, seleccione las columnas que desee incluir en la matriz
de función y defina el orden de las columnas.

Manual del usuario de PI DataLink 2014 37

Creación de hojas de cálculo

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 listados como
columnas en la matriz de función devuelta.
▪ Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de función devuelta.
▪ Haga clic en para abrir la ventana Añadir atributos donde puede seleccionar
atributos adicionales que puede incluir como columnas en la matriz de función.
Consulte Añadir columnas de atributos al panel de tareas Explorar eventos.
▪ Escriba el nombre de un atributo de evento junto a la casilla en blanco del final de la
lista.
▪ Haga clic con el botón derecho sobre un atributo, haga clic en Insertar atributo para
insertar un atributo en blanco encima del atributo seleccionado y, a continuación,
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.

▪ Seleccione un atributo y haga clic en Eliminar atributo para eliminar el atributo de la

lista.
b. Compruebe que el campo Celda de salida contiene la celda de la hoja de cálculo en la que
desea insertar la esquina superior izquierda de la matriz de función.
Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automáticamente la celda en este campo.
5. Haga clic en Aceptar para insertar la matriz de función en la hoja de cálculo.

Qué hacer a continuación

Utilice las funciones de Excel para analizar los datos. Puede crear un gráfico, por ejemplo.

Añadir columnas de atributos al panel de tareas Explorar eventos

Utilice la ventana Añadir atributos para añadir atributos de eventos a la lista Añadir atributos
en el panel de tareas Explorar eventos. Seguidamente podrá incluir dichos atributos en la matriz
de función insertada en la hoja de cálculo.

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

38 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

Procedimiento
1. Haga clic en , junto a la lista Columnas para mostrar en el panel de tareas, para abrir la
ventana Añadir 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 función.
Cuando en la matriz de función 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 añadir a la lista Columnas para
mostrar en el panel de tareas.
La función 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 añadir un atributo
concreto una sola vez. Cuando se selecciona un atributo, la ventana selecciona
automáticamente ese atributo cada vez que aparece en la jerarquía del evento.
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á añadir 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 función Explorar eventos para analizar los eventos con eventos secundarios
examinándolos en un formato jerárquico. 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 cálculo en la que desea que PI DataLink empiece a
introducir la matriz de función que contiene los eventos.
2. En la pestaña PI DataLink, en el grupo Eventos, haga clic en Explorar para abrir el panel de
tareas Explorar eventos.
3. Especifique los criterios para localizar los eventos en los que está interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizará para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. 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 Inicio de búsqueda y Fin de búsqueda especifican el período de tiempo en el
que buscar eventos activos.

Manual del usuario de PI DataLink 2014 39

Creación de hojas de cálculo

Introduzca una expresión de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el último mes, introduzca *-1mo en el campo Inicio de búsqueda y * en el campo
Fin de búsqueda.
Consejo:
Para localizar eventos que tengan una relación más específica con este período de
tiempo, como eventos iniciados o finalizados durante este período de tiempo,
expanda Más opciones de búsqueda y seleccione un método alternativo de la lista
Modo de búsqueda.
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
función (que se muestran en la lista Vista previa).
Consulte Referencia del panel de tareas Explorar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Plantilla de eventos para limitar los eventos devueltos a
aquellos que estén 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 cálculo:
a. En la lista Columnas para mostrar, seleccione las columnas que desee incluir en la matriz
de función 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 listados como
columnas en la matriz de función devuelta.
▪ Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de función devuelta.
▪ Haga clic en para abrir la ventana Añadir atributos donde puede seleccionar
atributos adicionales que puede incluir como columnas en la matriz de función.
Consulte Añadir columnas de atributos al panel de tareas Explorar eventos.
▪ Escriba el nombre de un atributo de evento junto a la casilla en blanco del final de la
lista.
▪ Haga clic con el botón derecho sobre un atributo, haga clic en Insertar atributo para
insertar un atributo en blanco encima del atributo seleccionado y, a continuación,
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.

▪ Seleccione un atributo y haga clic en Eliminar atributo para eliminar el atributo de la

lista.
b. En la lista Número de niveles de eventos secundarios, seleccione el número de niveles de
eventos secundarios que deben incluirse en la matriz de función.
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

40 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

secundarios en la lista Vista previa mediante un + junto al nombre del evento. Los
eventos secundarios no deben coincidir con los criterios especificados.
La función añade una columna por cada nivel recuperado. Al recuperar eventos
secundarios, la función inserta cada evento secundario en una fila independiente. En las
filas que contienen eventos secundarios, la columna añadida contiene el nombre del
evento secundario. La función puede incluir hasta tres niveles de eventos secundarios.
c. Compruebe que el campo Celda de salida contiene la celda de la hoja de cálculo en la que
desea insertar la esquina superior izquierda de la matriz de función.
Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automáticamente la celda en este campo.
5. Haga clic en Aceptar para insertar la matriz de función en la hoja de cálculo.

Comparación de eventos mediante la inclusión de eventos secundarios

Puede utilizar la función Comparar eventos para comparar eventos que tienen eventos
secundarios con los mismos nombres. La función Comparar eventos identifica los atributos por
ruta. Por lo tanto, la función 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 función
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 función devuelta para comparar fácilmente los eventos de inicio.

Procedimiento
1. Seleccione la celda de la hoja de cálculo en la que desea que PI DataLink empiece a
introducir la matriz de función que contiene los eventos.
2. En la pestaña PI DataLink, en el grupo Eventos, haga clic en Comparar para abrir el panel de
tareas Comparar eventos.
3. Especifique los criterios para localizar los eventos en los que está interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizará para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. 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 Inicio de búsqueda y Fin de búsqueda especifican el período de tiempo en el
que buscar eventos activos.
Introduzca una expresión de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el último mes, introduzca *-1mo en el campo Inicio de búsqueda y * en el campo
Fin de búsqueda.

Manual del usuario de PI DataLink 2014 41

Creación de hojas de cálculo

Consejo:
Para localizar eventos que tengan una relación más específica con este período de
tiempo, como eventos iniciados o finalizados durante este período de tiempo,
expanda Más opciones de búsqueda y seleccione un método alternativo de la lista
Modo de búsqueda.
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
función (que se muestran en la lista Vista previa).
Consulte Referencia del panel de tareas Comparar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Plantilla de eventos para limitar los eventos devueltos a
aquellos que estén 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 Columnas para mostrar para especificar las columnas en la matriz de función
devuelta.
La lista contiene los nombres de los atributos. De forma predeterminada, la lista incluye los
atributos virtuales generados para todos los eventos y los atributos de eventos de la
plantilla de evento seleccionada. La función identifica los atributos por ruta. Consulte
Notación de ruta para la función Comparar eventos para obtener información sobre las
notaciones de ruta admitidas.

a. Haga clic en para abrir la ventana Añadir atributos, donde puede seleccionar los
atributos de eventos secundarios que desea comparar entre eventos principales.
Consulte Añadir 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
función.
Consulte Añadir atributos de eventos principales como columnas en el panel de tareas
Comparar eventos.
c. Seleccione las columnas que desea incluir en la matriz de función y defina el orden de las
columnas.
Puede:
▪ Marcar la casilla Seleccionar todo para incluir todos los atributos listados como
columnas en la matriz de función devuelta.
▪ Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de función 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.

▪ Seleccione un atributo y haga clic en Eliminar atributo para eliminar el atributo de la

lista.
5. Compruebe que el campo Celda de salida contiene la celda de la hoja de cálculo en la que
desea insertar la esquina superior izquierda de la matriz de función.

42 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automáticamente la celda en este campo.
6. Haga clic en Aceptar para insertar la matriz de función en la hoja de cálculo.

Añadir atributos de eventos secundarios como columnas en el panel de

tareas Comparar eventos
Utilice la ventana Añadir atributos para añadir 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 función insertada en la hoja de cálculo). 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 añadir cualquier atributo de evento de estos
eventos. Normalmente, esta ventana se utiliza para añadir atributos de eventos secundarios
que le ayudarán 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 cálculo.

Procedimiento
1. Haga clic en , junto a la lista Columnas para mostrar en el panel de tareas, para abrir la
ventana Añadir 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 más eventos secundarios comparten el mismo nombre, PI DataLink añade
automáticamente 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 función.
Cuando se incluye una columna en la matriz de función, dicha columna muestra los valores
guardados para el atributo de evento.
3. Seleccione la casilla que aparece junto al atributo que desee añadir a la lista Columnas para
mostrar en el panel de tareas.

Manual del usuario de PI DataLink 2014 43

Creación de hojas de cálculo

La función Comparar eventos identifica los atributos por nombre y ruta en relación con el
evento coincidente. Por ejemplo, supongamos que selecciona el atributo Hora de inicio
bajo un evento coincidente y bajo su evento secundario.

Selección de atributo de hora de inicio de evento coincidente y secundario

Se añaden dos columnas:

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

Hoja de cálculo con columna de atributo secundario

Puede añadir atributos desde cualquier lugar de la jerarquía. La ventana no sincroniza las
selecciones: si la ruta y el nombre de atributo coinciden, puede añadir el mismo atributo
más de una vez.
Si las jerarquías de evento de los eventos no son coherentes, preste atención cuando
seleccione atributos de eventos secundarios. Si un evento contiene múltiples 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).

44 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

Selección del atributo de hora de inicio de evento secundario duplicado y evento secundario no
duplicado

Se añaden dos columnas que ofrecen resultados diferentes:

◦ .\Phase1[1]|Start time
En la hoja de cálculo, 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 cálculo, 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
más de un evento secundario con este nombre, la columna indica Duplicate event
exists: specify index for Phase1.

Hoja de cálculo con atributo secundario indexado y no indexado

El atributo indexado garantiza la obtención de los datos deseados.

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

Manual del usuario de PI DataLink 2014 45

Creación de hojas de cálculo

Añadir atributos de eventos principales como columnas en el panel de

tareas Comparar eventos
Para poder comparar mejor los eventos en una hoja de cálculo, puede incluir columnas que
contengan información 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
jerarquía).
Nota:
La función 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 cálculo.

Procedimiento
1. En la lista Columnas para mostrar del panel de tareas Comparar eventos, añada atributos de
evento principal utilizando el método apropiado para el atributo:
Para insertar: Proceda así:
El mismo nombre de a. Haga clic con el botón 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 botón 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 operación para añadir el mismo atributo de eventos

situados más arriba en la jerarquía. Por ejemplo, si hace clic con el
botón 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).

46 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

Para insertar: Proceda así:

Nombre de atributo a. Haga clic con el botón derecho del ratón en el atributo sobre el que
único desea insertar el atributo de evento principal y, a continuación, 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 información sobre la sintaxis de la ruta, consulte Notación de ruta para la
función Comparar eventos.

Comparación de eventos mediante la inclusión de eventos principales

Puede utilizar la función Comparar eventos para presentar información sobre eventos
principales en la misma fila que un evento. Puede utilizar esta capacidad para comparar
cualquier evento de jerarquías 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 función 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 información devuelta puede
ayudarle a comparar eventos de fase.

Procedimiento
1. Seleccione la celda de la hoja de cálculo en la que desea que PI DataLink empiece a
introducir la matriz de función que contiene los eventos.
2. En la pestaña PI DataLink, en el grupo Eventos, haga clic en Comparar para abrir el panel de
tareas Comparar eventos.
3. Especifique los criterios para localizar los eventos en los que está interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizará para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. 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 Inicio de búsqueda y Fin de búsqueda especifican el período de tiempo en el
que buscar eventos activos.
Introduzca una expresión de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el último mes, introduzca *-1mo en el campo Inicio de búsqueda y * en el campo
Fin de búsqueda.

Manual del usuario de PI DataLink 2014 47

Creación de hojas de cálculo

Consejo:
Para localizar eventos que tengan una relación más específica con este período de
tiempo, como eventos iniciados o finalizados durante este período de tiempo,
expanda Más opciones de búsqueda y seleccione un método alternativo de la lista
Modo de búsqueda.
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
función (que se muestran en la lista Vista previa).
Consulte Referencia del panel de tareas Comparar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Plantilla de eventos para limitar los eventos devueltos a
aquellos que están 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 Columnas para mostrar para especificar las columnas en la matriz de función
devuelta.
La lista contiene los nombres de los atributos. De forma predeterminada, la lista incluye los
atributos virtuales generados para todos los eventos y los atributos de eventos de la
plantilla de evento seleccionada. La función identifica los atributos por ruta. Consulte
Notación de ruta para la función Comparar eventos para obtener información sobre las
notaciones de ruta admitidas.

a. Inserte los atributos de eventos principales que desea incluir en la matriz de función.
Consulte Añadir atributos de eventos principales como columnas en el panel de tareas
Comparar eventos.
Por ejemplo, puede hacer clic con el botón derecho en algunos de los atributos virtuales
y, a continuación, 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 función y
defina el orden de las columnas.
Puede:
▪ Marcar la casilla Seleccionar todo para incluir todos los atributos listados como
columnas en la matriz de función devuelta.
▪ Seleccione una casilla para incluir el atributo o desmarque una casilla para excluir un
atributo como columna de la matriz de función 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.

▪ Seleccione un atributo y haga clic en Eliminar atributo para eliminar el atributo de la

lista.
5. Compruebe que el campo Celda de salida contiene la celda de la hoja de cálculo en la que
desea insertar la esquina superior izquierda de la matriz de función.

48 Manual del usuario de PI DataLink 2014

 Creación de hojas de cálculo

Si hace clic en una celda antes de abrir el panel de tareas, PI DataLink inserta
automáticamente la celda en este campo.
6. Haga clic en Aceptar para insertar la matriz de función en la hoja de cálculo.

Nombres de atributo reservados

PI DataLink genera automáticamente 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.
• Duración
• Plantilla de elementos
• Hora de finalización
• Categorías de evento
• Nombre de evento
• Ruta de evento
• Plantilla de eventos
• Elemento primario
• Ruta de elemento primario
• Hora de inicio

Manual del usuario de PI DataLink 2014 49

Creación de hojas de cálculo

50 Manual del usuario de PI DataLink 2014

Funciones de PI DataLink
Las funciones de PI DataLink permiten consultar cualquier PI Server o servidor de PI AF,
aplicar cálculos a los resultados obtenidos y devolver valores en las celdas de la hoja de cálculo.
Al igual que otras funciones de Excel, los resultados de las funciones de PI DataLink se
muestran en matrices,que pueden ser recalculadas para mostrar valores actualizados según se
necesite Utilice los paneles de tareas de función para definir entradas de funciones de PI
DataLink y pegarlas en una hoja de cálculo.
Las descripciones de funciones de este apartado describen entradas específicas de cada
función.

Consulte también
Paneles de tareas de funciones
Matrices de función
Referencia de función

En esta sección
• Función Valor actual
• Función Valor de archivo histórico
• Función Datos comprimidos
• Función Datos de muestra
• Función Datos temporizados
• Función Datos calculados
• Función Filtrado de tiempo
• Función Explorar eventos
• Función Comparar eventos
• Función de búsqueda de filtro de activo
• Función Propiedades

Función Valor actual

La función Valor actual devuelve el valor actual o más reciente de un PI point o un atributo de
PI AF.
Valor actual es una función volátil: la función vuelve a calcular los valores y los actualiza
siempre que Excel calcula o vuelve a calcular una celda en la hoja de cálculo. Para forzar un
recálculo inmediato, pulse F9.

Manual del usuario de PI DataLink 2014 51

Funciones de PI DataLink

Entrada Descripción
Ruta raíz Ruta común a los elementos de datos especificados. Las entradas válidas
incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
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 función devuelve valores.
Incluya un rango de celdas que contenga nombres de PI point o de atributos
de PI AF para devolver valores para cada uno de ellos.
Necesario.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.
Sin marca de tiempo Haga clic en esta opción para obtener sólo [Link] función 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 opción para obtener 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 opción para obtener dos filas: la marca de tiempo en la fila
superior de arriba y el valor en la fila de abajo.

Consulte también
PICurrVal()

Ejemplo de Valor actual

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

La función devuelve la siguiente matriz:

52 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Función Valor de archivo histórico

• Si selecciona la opción Elemento de datos, la función Valor de archivo histórico recupera el
valor de un PI point o un atributo de PI AF con una determinada marca de tiempo.
• Si selecciona la opción Expresión, la función Valor de archivo histórico recupera el valor de
una ecuación de rendimiento calculado para una determinada marca de tiempo.
Entrada Descripción
Ruta raíz La ruta común a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas válidas incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
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 función devuelve valores.
Incluya un rango de celdas que contenga nombres de PI point o de atributos
de PI AF para devolver valores para cada uno de ellos.
Necesaria si selecciona la opción Elemento de datos.

Expresión(es) Una o varias ecuaciones de rendimiento para los que la función calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para devolver valores
para cada una de ellas.
Necesaria si selecciona la opción Expresión.

Marca de tiempo La marca de tiempo para la que devuelve valores la función. Especifique una
hora fija o una expresión de tiempo relativa a la hora actual. Consulte Campos
de entrada de tiempo.
Necesario.

Manual del usuario de PI DataLink 2014 53

Funciones de PI DataLink

Entrada Descripción
Modo de recuperación Método que la función utiliza para determinar los valores que se devolverán:
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.
• auto
Recupera el valor interpolado en el tiempo especificado o sigue el método
anterior. (Utiliza el método 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.
• siguiente únicamente
Recupera el valor que sigue a la marca de tiempo especificada.
• tiempo exacto
Recupera únicamente un valor que coincide exactamente con la marca de
tiempo o devuelve No events found si no existe ningún valor con esa
marca de tiempo.
Disponible si selecciona la opción Elemento de datos.

Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.
Sin marca de tiempo Haga clic en esta opción para obtener sólo [Link] función 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 opción para obtener 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 opción para obtener dos filas: la marca de tiempo en la fila
superior de arriba y el valor en la fila de abajo.

Consulte también

• PIArcVal()
Especificar elementos de datos.
• PIExpVal()

54 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Especificar una expresión.

Ejemplo de Valor de archivo

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

La función devuelve la siguiente matriz:

Función Datos comprimidos

• Si selecciona la opción Intervalo de tiempo, la función Datos comprimidos devuelve todos
los valores de un PI point o un atributo de PI AF junto con un recuento de los valores que se
producen durante un determinado periodo de tiempo.
• Si selecciona la opción Número de valores, la función Datos comprimidos devuelve un
número específico de valores de punto de atributo que comienzan en un determinado
momento.
Nota:
Los valores almacenados en el archivo de PI Server se someten a un algoritmo de
compresión que elimina todos los valores que representan la misma pendiente. Los
valores almacenados en el snapshot de PI Server no se han sometido a este algoritmo de
compresión. Si especifica la hora actual en el periodo de tiempo de la función Datos
comprimidos, la función recupera un valor de snapshot para esa hora. El valor de
snapshot puede no almacenarse posteriormente en el archivo debido a la compresión.

Entrada Descripción
Ruta raíz La ruta común a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas válidas incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
predeterminado.
Consulte Elementos de datos.

Manual del usuario de PI DataLink 2014 55

Funciones de PI DataLink

Entrada Descripción
Elemento(s) de datos Uno o varios nombres de PI point o de nombres de atributo de PI AF para los
que la función devuelve valores.
Incluya un rango de celdas que contenga nombres de PI point o de atributos
de PI AF para devolver valores para cada uno de ellos.
Necesario.
Hora de inicio El inicio del periodo de tiempo para el que la función devuelve valores.
Consulte Campos de entrada de tiempo.
Necesario.
Hora de finalización El final del periodo de tiempo para el que la función devuelve valores.
Necesaria si selecciona la opción Intervalo de tiempo.

Número de valores El número de valores que la función recupera, a partir de la Hora de inicio.
Necesaria si selecciona la opción Número de valores.

Atrás en el tiempo Seleccione esta casilla para recuperar valores registrados en la Hora de inicio
y anteriores. Disponible si selecciona la opción Número de valores e
introduce un valor en el campo Número de valores.
Si introduce una referencia de celda en el campo Número de valores, está
casilla aparece deshabilitada. En su lugar, introduzca un número negativo en
la celda referenciada para conseguir el mismo efecto.
Expresión de filtro Ecuación de rendimiento booleana que la función utiliza para filtrar valores.
Cuando la expresión se evalúa como falsa, la función excluye los valores
correspondientes. Consulte Expresiones de filtro.
Marcar como filtrado Seleccione esta casilla para insertar la etiqueta Filtered en lugar de un
valor o un bloque de valores que la función ha filtrado de la salida en función
de la Expresión de filtro.
Tipo de límite Método que la función utiliza para determinar qué valores se recuperarán
cerca de la hora de inicio o de la hora de finalización:
• interior(valor predeterminado)
Recupera valores a las horas de inicio y de finalización, si existen, o los
valores más cercanos producidos dentro del intervalo.
• externo
Recupera los valores más cercanos que se producen inmediatamente
fuera del intervalo.
• interpolado
Recupera valores interpolados a las horas de inicio y de finalización.
• auto
Recupera valores interpolados, pero utiliza el método interior para los
elementos de datos con atributos de paso.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.

56 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Ocultar recuento Seleccione esta casilla para ocultar el recuento de valores devueltos y
mostrar sólo los valores. Disponible si selecciona la opción Intervalo de
tiempo.
Mostrar marcas de Seleccione esta casilla para mostrar la marca de tiempo que corresponde a
tiempo cada valor devuelto. PI DataLink muestra marcas de tiempo a la izquierda de
los valores mostrados en una columna o encima de los valores mostrados en
una fila.
Mostrar atributos del 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 precisión 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 opción para devolver valores en una columna.
Fila Haga clic en esta opción para devolver valores en una fila.
Nota:
Si especifica un rango de elementos en Elemento(s) de datos o un rango
de expresiones en Expresión(es), PI DataLink automáticamente
seleccionará Columna o Fila para ajustarse a la orientación del rango
especificado.

Consulte también
• PICompDat()
Especifique un intervalo de tiempo sin una expresión de filtro.
• PICompFilDat()
Especifique un intervalo de tiempo con una expresión de filtro.
• PINCompDat()
Especifique un número de valores sin una expresión de filtro.
• PINCompFilDat()
Especifique un número de valores con una expresión de filtro.

Ejemplo de Datos comprimidos

Para ver el valor actual del PI point sinusoid, defina las siguientes entradas para la función
Datos comprimidos:

Manual del usuario de PI DataLink 2014 57

Funciones de PI DataLink

Entrada Valor
Número de valores Seleccionado
Elemento(s) de datos sinusoid
Hora de inicio $A$10 (asumiendo que la celda A-10 tiene la hora
actual)
Número de valores 10
Atrás en el tiempo Seleccionado
Tipo de límite interior
Mostrar marcas de tiempo Seleccionado
Columna Seleccionado

La función devuelve la siguiente matriz:

Tenga en cuenta que podría seleccionar la opción Intervalo de tiempo y especificar la Hora de
inicio y la Hora de finalización adecuadas para obtener los mismos valores.

Función Datos de muestra

• Si selecciona la opción Elemento de datos, la función Datos de muestra devuelve valores
interpolados, separados por espacios, de un PI point o un atributo de PI AF a lo largo de un
intervalo regular.
• Si selecciona la opción Expresión, la función Datos de muestra devuelve valores
interpolados, con intervalos iguales, de una ecuación de rendimiento a lo largo de un
intervalo regular.
Entrada Descripción
Ruta raíz La ruta común a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas válidas incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
predeterminado.
Consulte Elementos de datos.

58 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Elemento(s) de datos Uno o varios nombres de PI point o de nombres de atributo de PI AF para los
que la función devuelve valores.
Incluya un rango de celdas que contenga nombres de PI point o de atributos
de PI AF para devolver valores para cada uno de ellos.
Necesaria si selecciona la opción Elemento de datos.

Expresión(es) Una o varias ecuaciones de rendimiento para los que la función calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para devolver valores
para cada una de ellas.
Necesaria si selecciona la opción Expresión.

Hora de inicio El inicio del periodo de tiempo para el que la función devuelve valores.
Consulte Campos de entrada de tiempo.
Necesario.
Hora de finalización El final del periodo de tiempo para el que la función calcula un valor.
Necesario.
Intervalo de tiempo Frecuencia de muestreo utilizada para calcular valores durante el periodo de
tiempo. Introduzca un valor y una unidad de tiempo. Por ejemplo, introduzca
15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos en
el periodo de tiempo. Consulte Especificación de intervalos de tiempo.
Necesario.
Expresión de filtro Ecuación de rendimiento booleana que la función utiliza para filtrar valores.
Cuando la expresión se evalúa como falsa, la función excluye los valores
correspondientes. Consulte Expresiones de filtro.
Marcar como filtrado Seleccione esta casilla para insertar la etiqueta Filtered en lugar de un
valor o un bloque de valores que la función ha filtrado de la salida en función
de la Expresión de filtro.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.
Mostrar marcas de Seleccione esta casilla para mostrar la marca de tiempo que corresponde a
tiempo cada valor devuelto. PI DataLink muestra marcas de tiempo a la izquierda de
los valores mostrados en una columna o encima de los valores mostrados en
una fila.
Columna Haga clic en esta opción para devolver valores en una columna.

Manual del usuario de PI DataLink 2014 59

Funciones de PI DataLink

Entrada Descripción
Fila Haga clic en esta opción para devolver valores en una fila.
Nota:
Si especifica un rango de elementos en Elemento(s) de datos o un rango
de expresiones en Expresión(es), PI DataLink automáticamente
seleccionará Columna o Fila para ajustarse a la orientación del rango
especificado.

Consulte también
• PISampDat()
Especifique un elemento de datos con una expresión de filtro.
• PISampFilDat()
Especifique un elemento de datos sin una expresión de filtro.
• PIExpDat()
Especificar una expresión.

Ejemplo de Datos de muestra

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

La función devuelve la siguiente matriz:

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

60 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Función Datos temporizados

• Si selecciona la opción Elemento de datos, la función Datos temporizados recupera valores
de muestra reales o interpolados para un PI point o un atributo de PI AF con determinadas
marcas de tiempo.
• Si selecciona la opción Expresión, la función Datos temporizados recupera los valores de
una ecuación de rendimiento calculados para unas determinadas marcas de tiempo.
Entrada Descripción
Ruta raíz La ruta común a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas válidas incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
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 función devuelve valores.
Incluya un rango de celdas que contenga nombres de PI point o de atributos
de PI AF para devolver valores para cada uno de ellos.
Necesaria si selecciona la opción Elemento de datos.

Expresión(es) Una o varias ecuaciones de rendimiento para los que la función calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para devolver valores
para cada una de ellas.
Necesaria si selecciona la opción Expresión.

Marca(s) de tiempo Las marcas de tiempo para las que devuelve valores la función. Introduzca
una marca de tiempo o una referencia a una o varias celdas de hoja de cálculo
que contengan valores de marca de tiempo.
Necesario.
Modo de recuperación Método que la función 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.
• hora exacta
Devuelve únicamente valores que coinciden exactamente con las marcas
de tiempo especificadas; devuelve No events found si no existe ningún
valor.

Manual del usuario de PI DataLink 2014 61

Funciones de PI DataLink

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

Consulte también
• PITimeDat()
Especificar un elemento de datos.
• PITimeExpDat()
Especificar una expresión.

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 función 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 recuperación interpolado

La función devuelve la siguiente matriz de datos temporizados en la columna de la derecha:

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

62 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Función Datos calculados

• Si selecciona la opción Elemento de datos, la función Datos calculados devuelve uno o
varios valores con intervalos iguales, calculados en base a valores de PI point o de atributo
de PI AF y determinadas preferencias de cálculo.
• Si selecciona la opción Expresión, la función Datos calculados devuelve uno o varios valores
con intervalos iguales, calculados en base a una ecuación de rendimiento evaluada y
determinadas preferencias de cálculo.
Nota:
Haga clic en el signo + junto a Avanzado para acceder a todas las entradas de función.

Entrada Descripción
Ruta raíz La ruta común a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas válidas incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
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 función devuelve valores.
Incluya un rango de celdas que contenga nombres de PI point o de atributos
de PI AF para devolver valores para cada uno de ellos.
Necesaria si selecciona la opción Elemento de datos.

Expresión(es) Una o varias ecuaciones de rendimiento para los que la función calcula un
valor. Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para devolver valores
para cada una de ellas.
Necesaria si selecciona la opción Expresión.

Hora de inicio El inicio del periodo de tiempo para el que la función devuelve valores.
Consulte Campos de entrada de tiempo.
Necesario.
Hora de finalización El final del periodo de tiempo para el que la función devuelve valores.
Necesario.
Intervalo de tiempo Frecuencia de muestreo utilizada para calcular valores durante el periodo de
tiempo. Introduzca un valor y una unidad de tiempo. Por ejemplo, introduzca
15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos en
el periodo de tiempo. Consulte Especificación de intervalos de tiempo.
Expresión de filtro Ecuación de rendimiento booleana que la función utiliza para filtrar valores.
Cuando la expresión se evalúa como falsa, la función excluye los valores
correspondientes. Consulte Expresiones de filtro.

Manual del usuario de PI DataLink 2014 63

Funciones de PI DataLink

Entrada Descripción
Factor de conversión Factor que la función aplica a los valores devueltos. Introduzca 1 si el factor
de conversión no es necesario. Para los cálculos de totales ponderados en el
tiempo, especifique un factor que convierta los valores de velocidad
registrados a la unidad de tiempo predeterminada del servidor (unidades por
día).
Necesario.
Por ejemplo, entre los factores de conversión comunes se incluyen:
• 1.0 para valores que almacenan unidades/día
• 24 para valores que almacenan unidades/hora
• 1440 para valores que almacenan unidades/minuto
• 86400 para valores que almacenan unidades/segundo
Modo de cálculo Tipo de cálculo que realiza la función:
• total
Suma los valores durante el intervalo.
• mínimo
Localiza el valor mínimo durante el intervalo.
• máximo
Localiza el valor máximo durante el intervalo.
• desviación estándar
Calcula la desviación estándar de los valores durante el intervalo.
• intervalo
Calcula el valor máximo menos el valor mínimo durante el intervalo.
• promedio
Calcula la media de los valores registrados durante el intervalo utilizando
el método especificado en el campo Bases de cálculo. De forma
predeterminada, este es un cálculo con ponderación temporal.
• recuento
Calcula el número de valores almacenados durante el intervalo.
• media
Calcula la media ponderada a eventos de los valores registrados durante
el intervalo independientemente del método especificado en el campo
Bases de cálculo.
Bases de cálculo El método de cálculo:
• ponderado a tiempo
Predeterminado. La función pondera cada valor registrado según el
intervalo de tiempo durante el que se aplica el valor. Para todos los modos
de cálculo excepto la media, la función interpola los valores en los límites
de los intervalos.
• ponderado a eventos
La función sospesa del mismo modo cada valor registrado. Seleccione esta
opción para los valores en lotes. Este método requiere como mínimo un
valor registrado en un periodo de tiempo (dos eventos registrados para
los cálculos de desviación estándar).

64 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Muestreo de expresión Método que la función utiliza para determinar cuándo evaluar una expresión:
• comprimido
La función evalúa la expresión durante el periodo de tiempo en las marcas
de tiempo donde los PI points o los atributos de PI AF de la expresión han
almacenado valores.
• interpolado
La función evalúa la expresión en intervalos de muestra espaciados
regularmente determinados por la Frecuencia de muestreo de expresión.
Disponible si selecciona Expresión o si especifica una Expresión de filtro.

Frecuencia de muestreo La frecuencia con que la función evalúa una expresión. Necesario si establece
de expresión Muestreo de expresión como interpolado.
Por ejemplo, defina 10m (10 minutos) para devolver un valor interpolado por
cada intervalo de 10 minutos.
Porcentaje correcto Porcentaje mínimo de datos correctos necesarios durante cada intervalo de
mínimo tiempo para calcular y devolver un valor para ese intervalo. La función
devuelve la etiqueta Datos correctos insuficientes para los intervalos
que no alcanzan este porcentaje.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.
Mostrar hora de inicio Seleccione esta casilla para mostrar la hora de inicio del intervalo de tiempo
que se utiliza para calcular el valor devuelto. PI DataLink muestra la hora de
inicio en una columna a la izquierda de los valores devueltos o en una fila
encima de ellos. Solo estará disponible si especifica Intervalo de tiempo.
Mostrar hora de Seleccione esta casilla para mostrar la hora de finalización del intervalo de
finalización tiempo que se utiliza para calcular el valor devuelto. PI DataLink muestra la
hora de finalización en una columna a la izquierda de los valores devueltos o
en una fila encima de ellos. Solo estará disponible si especifica Intervalo de
tiempo.
Mostrar tiempo mín./ Seleccione esta casilla para mostrar la marca de tiempo correspondiente al
máx. valor mínimo o máximo durante el intervalo utilizado para calcular el valor.
Solo está disponible para tres valores de Modo de cálculo:
• máximo
Muestra la marca de tiempo del valor máximo.
• mínimo
Muestra la marca de tiempo del valor mínimo.
• intervalo
Muestra las marcas de tiempo del valor mínimo y el valor máximo.

Manual del usuario de PI DataLink 2014 65

Funciones de PI DataLink

Entrada Descripción
Mostrar porcentaje Seleccione esta casilla para mostrar el porcentaje de tiempo en el que se han
correcto devuelto valores correctos durante el periodo de tiempo de la matriz. PI
DataLink muestra el porcentaje de valores correctos en una columna a la
derecha de los valores devueltos o en una fila debajo de ellos.
Los valores correctos son valores registrados que PI Server ha determinado
que eran válidos y no tenían un estado de error. Puede utilizar el porcentaje
de valores correctos para evaluar la fiabilidad de los cálculos basados en
valores de PI point, en especial, si utiliza los valores de otros cálculos
posteriores.
Por ejemplo, si un periodo de tiempo incluye datos erróneos, el total
resultante ponderado en el tiempo equivaldrá al total dividido por la fracción
del intervalo donde están disponibles los datos correctos. Esta normalización
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 fiable si una fracción
considerable del periodo de tiempo incluye datos incorrectos.
Columna Haga clic en esta opción para devolver valores en una columna.
Fila Haga clic en esta opción para devolver valores en una fila.
Nota:
Si especifica un rango de elementos en Elemento(s) de datos o un rango
de expresiones en Expresión(es), PI DataLink automáticamente
seleccionará Columna o Fila para ajustarse a la orientación del rango
especificado.

Consulte también
• PIAdvCalcVal()
Especifique un elemento de datos para obtener un solo valor
• PIAdvCalcFilVal()
Especifique un elemento de datos y una expresión de filtro para obtener un solo valor
• PIAdvCalcExpVal()
Especifique una expresión para obtener un solo valor
• PIAdvCalcExpFilVal()
Especifique una expresión y una expresión de filtro para obtener un solo valor
• PIAdvCalcDat()
Especifique un elemento de datos y un intervalo de tiempo para obtener varios valores
• PIAdvCalcFilDat()
Especifique un elemento de datos, un intervalo de tiempo y una expresión de filtro para
obtener varios valores
• PIAdvCalcExpDat()
Especifique una expresión y un intervalo de tiempo para obtener varios valores
• PIAdvCalcExpFilDat()
Especifique una expresión, un intervalo de tiempo y una expresión de filtro para obtener
varios valores

66 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

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 función Datos calculados:
Entrada Valor
Elemento(s) de datos sinusoid
Hora de inicio t
Hora de finalización *
Intervalo de tiempo 1h
Modo de cálculo intervalo
Bases de cálculo ponderado a tiempo
Mostrar hora de inicio seleccionada
Mostrar hora de finalización seleccionada
Columna seleccionada

La función devuelve la siguiente matriz:

En este ejemplo, la función calcula el rango de cada intervalo de una hora. Puede especificar
cualquier cálculo disponible a lo largo de cualquier intervalo.

Función Filtrado de tiempo

La función Filtrado de tiempo devuelve la cantidad de tiempo durante el que una ecuación de
rendimiento se evalúa como verdadera a lo largo de un determinado periodo de tiempo.
Nota:
Los resultados de la función Filtrado de tiempo varían ligeramente dependiendo de la
versión del PI Server.

Manual del usuario de PI DataLink 2014 67

Funciones de PI DataLink

Entrada Descripción
Ruta raíz La ruta común a los elementos de datos especificados, incluidos los de las
expresiones. Las entradas válidas incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
predeterminado.
Consulte Elementos de datos.
Expresión(es) Ecuación de rendimiento booleana que la función evalúa. Consulte
Expresiones.
Incluya un rango de celdas que contenga expresiones para devolver valores
para cada una de ellas.
Necesario.
Hora de inicio El inicio del periodo de tiempo para el que la función devuelve valores.
Consulte Campos de entrada de tiempo.
Necesario.
Hora de finalización El final del periodo de tiempo para el que la función devuelve valores.
Necesario.
Intervalo de tiempo Frecuencia de muestreo utilizada para calcular valores durante el periodo de
tiempo. Introduzca un valor y una unidad de tiempo. Por ejemplo, introduzca
15m (15 minutos) para devolver un valor por cada intervalo de 15 minutos en
el periodo de tiempo. Consulte Especificación de intervalos de tiempo. La
función Filtrado por tiempo considera que una unidad de mes equivale a 30
días.
Unidades de tiempo Unidades de tiempo en las que la función devuelve el resultado.
Necesario.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.
Mostrar hora de inicio Seleccione esta casilla para mostrar la hora de inicio del intervalo de tiempo
que se utiliza para calcular el valor devuelto. PI DataLink muestra la hora de
inicio en una columna a la izquierda de los valores devueltos o en una fila
encima de ellos. Solo estará disponible si especifica Intervalo de tiempo.
Mostrar hora de Seleccione esta casilla para mostrar la hora de finalización del intervalo de
finalización tiempo que se utiliza para calcular el valor devuelto. PI DataLink muestra la
hora de finalización en una columna a la izquierda de los valores devueltos o
en una fila encima de ellos. Solo estará disponible si especifica Intervalo de
tiempo.

68 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Mostrar porcentaje Seleccione esta casilla para mostrar el porcentaje de tiempo en el que se han
correcto devuelto valores correctos durante el periodo de tiempo de la matriz. PI
DataLink muestra el porcentaje de valores correctos en una columna a la
derecha de los valores devueltos o en una fila debajo de ellos.
Los valores correctos son valores registrados que PI Server ha determinado
que eran válidos y no tenían un estado de error. Puede utilizar el porcentaje
de valores correctos para evaluar la fiabilidad de los cálculos basados en
valores de PI point, en especial, si utiliza los valores de otros cálculos
posteriores.
Por ejemplo, si un periodo de tiempo incluye datos erróneos, el total
resultante ponderado en el tiempo equivaldrá al total dividido por la fracción
del intervalo donde están disponibles los datos correctos. Esta normalización
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 fiable si una fracción
considerable del periodo de tiempo incluye datos incorrectos.
Columna Haga clic en esta opción para devolver valores en una columna.
Fila Haga clic en esta opción para devolver valores en una fila.
Nota:
Si especifica un rango de elementos en Expresión(es), PI DataLink
automáticamente seleccionará Columna o Fila para ajustarse a la
orientación de los elementos.

Consulte también
• PITimeFilterVal()
Devolver un único valor.
• PITimeFilter()
Especificar un intervalo de tiempo y obtener varios valores.

Ejemplo de Filtrado de tiempo

Para ver el número de horas que el valor de PI point sinusoid ha sobrepasado el valor 75
durante los siete días anteriores, defina las siguientes entradas para la función Filtrado de
tiempo:
Entrada Valor
Expresión 'sinusoid' > 75
Hora de inicio -7d
Hora de finalización *
Unidades de tiempo h
Mostrar porcentaje correcto Seleccionado
Columna Seleccionado

La función devuelve la siguiente matriz:

Manual del usuario de PI DataLink 2014 69

Funciones de PI DataLink

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

Función Explorar eventos

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

Referencia del panel de tareas Explorar eventos

La función Explorar eventos devuelve eventos en un formato jerárquico. La configuración de
las preferencias limita el número de eventos que se recuperan en la lista Vista preliminar y se
devuelven a la hoja de cálculo.
Nota:
Expanda Más opciones de búsqueda para acceder a todas las entradas de función.

70 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Base de datos La base de datos de PI AF desde la que la función devuelve eventos. Utilice el
formato \\NombreServidor\NombreBaseDatos. Haga clic en el campo para
ver una lista de bases de datos que contienen plantillas de eventos en
servidores PI AF conectados. Para que la función pueda encontrar los eventos
coincidentes, debe especificar la base de datos.
Inicio de la búsqueda Una expresión de tiempo de PI que especifica en qué momento la función
empieza a buscar eventos en la base de datos. Por ejemplo, especifique *-12h
para buscar eventos en registros de la base de datos desde hace 12 horas.
Final de la búsqueda Una expresión de tiempo de PI que especifica en qué momento la función deja
de buscar eventos en la base de datos. Por ejemplo, especifique * para buscar
eventos hasta la hora actual.
Limitar a nivel de base Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raíz
de datos de la base de datos. Si desmarca esta casilla, la función busca eventos
coincidentes en cualquier nivel de la jerarquía.
Nombre de evento El nombre de eventos coincidentes. Puede especificar nombres parciales con
caracteres comodín.
Plantilla de eventos Una plantilla de eventos de los eventos coincidentes. Tenga en cuenta que si
selecciona una plantilla de eventos base, la función incluye eventos de
plantillas derivadas.
Al seleccionar una plantilla de eventos, la lista Columnas para mostrar se
actualiza para reflejar atributos de la plantilla seleccionada. La actualización
suprime los atributos insertados con anterioridad.
Nombre de elemento Un elemento de PI AF al que hacen referencia los eventos coincidentes. Puede
especificar nombres parciales con caracteres comodín.
Plantilla de elemento Una plantilla de elementos de un elemento al que hacen referencia los
eventos coincidentes. Tenga en cuenta que si selecciona una plantilla de
elementos base, la función incluye eventos que hacen referencia a elementos
de plantillas derivadas.
Se necesita la versión 2.6 o posterior del servidor de PI AF para filtrar
plantillas de elementos.
Categoría de evento La categoría de los eventos coincidentes.
Duración mínima La duración mínima de los eventos coincidentes. Especifique un valor y una
abreviatura de unidad temporal.
Duración máxima La duración máxima de los eventos coincidentes. Especifique un valor y una
abreviatura de unidad temporal.

Manual del usuario de PI DataLink 2014 71

Funciones de PI DataLink

Entrada Descripción
Modo de búsqueda El método que utiliza la función para buscar eventos coincidentes en relación
con el período de tiempo especificado por el inicio de la búsqueda y el final de
la búsqueda:
• activo en intervalo
Permite buscar eventos activos en cualquier momento durante el período
de tiempo especificado.

• completamente en intervalo
Permite buscar eventos que empiezan y acaban durante el período de
tiempo especificado.

• comenzando en intervalo
Permite buscar eventos que empiezan durante el período de tiempo
especificado y acaban durante o después del período de tiempo
especificado.

• finalizando en intervalo
Permite buscar eventos que acaban durante el período de tiempo
especificado y empiezan antes o durante del período de tiempo
especificado.

• en curso
Permite buscar eventos que empiezan durante el período de tiempo
especificado pero que todavía no han finalizado. Solo está disponible con
la versión 2.6 o posteriores del servidor de PI AF.
Criterio de ordenación El método que utiliza la función para clasificar los eventos coincidentes:
• nombre ascendente
Permite ordenar los eventos por nombre de evento, de la A a la Z.

• nombre descendente
Permite ordenar los eventos por nombre de evento, de la Z a la A.

• hora de inicio ascendente

Permite ordenar los eventos por hora de inicio, del más temprano al más
tardío.

• hora de inicio descendente

Permite ordenar los eventos por hora de inicio, del más tardío al más
temprano.

• hora de finalización ascendente

Permite ordenar los eventos por hora de finalización, del más temprano al
más tardío.

• hora de finalización descendente

Permite ordenar los eventos por hora de finalización, del más tardío al
más temprano.

72 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Filtros de valor de Hasta cinco condiciones de atributo que la función utiliza para filtrar eventos
atributo coincidentes.
Nota:
Antes de especificar un filtro de valor de atributo, debe especificar una
plantilla de evento.
Para cada filtro, especifique:
• Atributo
Un atributo de evento para el que la función filtra eventos coincidentes.
Los atributos disponibles dependen de la plantilla de eventos
seleccionada.

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

• Valor
El valor que la función utiliza para buscar atributos coincidentes. Por
ejemplo, si define el valor = para el campo Operador, la función limita los
eventos a aquellos en los que el atributo especificado equivale a este
valor.

Columnas para mostrar Las columnas de la matriz de función devuelta. La lista contiene los nombres
de los atributos. De forma predeterminada, la lista incluye los atributos
virtuales generados para todos los eventos y los atributos de eventos de la
plantilla de evento seleccionada. Puede:
• Marcar la casilla Seleccionar todo para incluir todos los atributos listados
como columnas en la matriz de función devuelta.
• Seleccione una casilla para incluir el atributo o desmarque una casilla
para excluir un atributo como columna de la matriz de función devuelta.
• Haga clic en para abrir la ventana Añadir atributos donde puede

seleccionar atributos adicionales que puede incluir como columnas en la

matriz de función. Consulte Añadir columnas de atributos al panel de
tareas Explorar eventos.
• Escriba el nombre de un atributo de evento junto a la casilla en blanco del
final de la lista.
• Haga clic con el botón derecho sobre un atributo, haga clic en Insertar
atributo para insertar un atributo en blanco encima del atributo
seleccionado y, a continuación, 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.
• Seleccione un atributo y haga clic en Eliminar atributo para eliminar el
atributo de la lista.

Manual del usuario de PI DataLink 2014 73

Funciones de PI DataLink

Entrada Descripción
Número de niveles de El número de niveles de eventos secundarios que la función incluye en la
eventos secundarios matriz de función. Los eventos secundarios no deben coincidir con los
criterios especificados. La función devuelve cada evento secundario en una
fila separada y añade una columna adicional por cada nivel devuelto. En las
filas que contienen eventos secundarios, la columna añadida contiene el
nombre del evento secundario.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.

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

Ejemplo de Explorar eventos

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

La función devuelve la siguiente matriz:

Función Comparar eventos

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

74 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

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

Referencia del panel de tareas Comparar eventos

La función Comparar eventos devuelve eventos en un formato plano. La configuración de las
preferencias limita el número de eventos que se recuperan en la lista Vista preliminar y se
devuelven a la hoja de cálculo.
Nota:
Haga clic en el signo + junto a Más opciones de búsqueda para acceder a todas las
entradas de función.

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

Manual del usuario de PI DataLink 2014 75

Funciones de PI DataLink

Entrada Descripción
Inicio de la búsqueda Una expresión de tiempo de PI que especifica en qué momento la función
empieza a buscar eventos en la base de datos. Por ejemplo, especifique *-12h
para buscar eventos en registros de la base de datos desde hace 12 horas.
Final de la búsqueda Una expresión de tiempo de PI que especifica en qué momento la función deja
de buscar eventos en la base de datos. Por ejemplo, especifique * para buscar
eventos hasta la hora actual.
Limitar a nivel de base Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raíz
de datos de la base de datos. Si desmarca esta casilla, la función busca eventos
coincidentes en cualquier nivel de la jerarquía.
Nombre de evento El nombre de eventos coincidentes. Puede especificar nombres parciales con
caracteres comodín.
Plantilla de eventos Una plantilla de evento de los eventos coincidentes. Tenga en cuenta que si
selecciona una plantilla de evento base, la función incluye eventos de
plantillas derivadas.
Al seleccionar una plantilla de eventos, la lista Columnas para mostrar se
actualiza para reflejar atributos de la plantilla seleccionada. La actualización
suprime los atributos insertados con anterioridad.
Nombre de elemento Un elemento de PI AF al que hacen referencia los eventos coincidentes. Puede
especificar nombres parciales con carácteres comodín.
Plantilla de elemento Una plantilla de elementos de un elemento al que hacen referencia los
eventos coincidentes. Tenga en cuenta que si selecciona una plantilla de
elementos base, la función incluye eventos que hacen referencia a elementos
de plantillas derivadas.
Se necesita la versión 2.6 o posterior del servidor de PI AF para filtrar
plantillas de elementos.
Categoría de evento La categoría de los eventos coincidentes.
Duración mínima La duración mínima de los eventos coincidentes. Especifique un valor y una
abreviatura de unidad temporal.
Duración máxima La duración máxima de los eventos coincidentes. Especifique un valor y una
abreviatura de unidad temporal.

76 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Modo de búsqueda El método que utiliza la función para buscar eventos coincidentes en relación
con el período de tiempo especificado por el inicio de la búsqueda y el final de
la búsqueda:
• activo en intervalo
Permite buscar eventos activos en cualquier momento durante el período
de tiempo especificado.

• completamente en intervalo
Permite buscar eventos que empiezan y acaban durante el período de
tiempo especificado.

• comenzando en intervalo
Permite buscar eventos que empiezan durante el período de tiempo
especificado y acaban durante o después del período de tiempo
especificado.

• finalizando en intervalo
Permite buscar eventos que acaban durante el período de tiempo
especificado y empiezan antes o durante del período de tiempo
especificado.

• en curso
Permite buscar eventos que empiezan durante el período de tiempo
especificado pero que todavía no han finalizado. Solo está disponible con
la versión 2.6 o posteriores del servidor de PI AF.
Criterio de ordenación El método que utiliza la función para clasificar los eventos que se devolverán:
• nombre ascendente
Permite ordenar los eventos por nombre de evento, de la A a la Z.

• nombre descendente
Permite ordenar los eventos por nombre de evento, de la Z a la A.

• hora de inicio ascendente

Permite ordenar los eventos por hora de inicio, del más temprano al más
tardío.

• hora de inicio descendente

Permite ordenar los eventos por hora de inicio, del más tardío al más
temprano.

• hora de finalización ascendente

Permite ordenar los eventos por hora de finalización, del más temprano al
más tardío.

• hora de finalización descendente

Permite ordenar los eventos por hora de finalización, del más tardío al
más temprano.

Manual del usuario de PI DataLink 2014 77

Funciones de PI DataLink

Entrada Descripción
Filtros de valor de Hasta cinco condiciones de atributo que la función utiliza para filtrar eventos
atributo coincidentes.
Nota:
Antes de especificar un filtro de valor de atributo debe especificar una
plantilla de eventos.
Para cada filtro, especifique:
• Atributo
Un atributo de evento para el que la función filtra eventos coincidentes.
Los atributos disponibles dependen de la plantilla de eventos
seleccionada.

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

• Valor
El valor que la función utiliza para buscar atributos coincidentes. Por
ejemplo, si define el valor = para el campo Operador, la función limita los
eventos a aquellos en los que el atributo especificado equivale a este
valor.

78 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Entrada Descripción
Columnas para mostrar Las columnas de la matriz de función devuelta. La lista contiene los nombres
de los atributos. De forma predeterminada, la lista incluye los atributos
virtuales generados para todos los eventos y los atributos de eventos de la
plantilla de evento seleccionada. La función incluye la ruta de los atributos; la
función identifica los atributos únicos por su nombre y posición en la
jerarquía. Puede:
• Marcar la casilla Seleccionar todo para incluir todos los atributos listados
como columnas en la matriz de función devuelta.
• Seleccione una casilla para incluir el atributo o desmarque una casilla
para excluir un atributo como columna de la matriz de función devuelta.
• Haga clic en para abrir la ventana Añadir atributos donde puede

seleccionar atributos adicionales que puede incluir como columnas en la

matriz de función. Consulte Añadir atributos de eventos secundarios
como columnas en el panel de tareas Comparar eventos.
• Haga clic con el botón derecho en un atributo y seguidamente haga clic en
Clonar para evento principal para insertar el atributo del evento primario
como columna en la matriz de función. Consulte Añadir atributos de
eventos principales como columnas en el panel de tareas Comparar
eventos.
• Escriba el nombre de un atributo de evento junto a la casilla en blanco del
final de la lista.
• Haga clic con el botón derecho sobre un atributo, haga clic en Insertar
atributo para insertar un atributo en blanco encima del atributo
seleccionado y, a continuación, 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.
• Seleccione un atributo y haga clic en Eliminar atributo para eliminar el
atributo de la lista.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.

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

Manual del usuario de PI DataLink 2014 79

Funciones de PI DataLink

Notación de ruta para la función Comparar eventos

La función Comparar eventos identifica a los atributos por ruta; por lo tanto, los nombres de
atributo siempre deben incluir información de la ruta, especificada en relación con el evento
coincidente que se muestra en cada fila. Cuando especifique los atributos, utilice la notación
que designe la ubicación correcta en la jerarquía de eventos.
Notación de ruta admitida
Notación Descripción
.|A1 El atributo A1 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 notación para designar los atributos superiores de la jerarquía. Por ejemplo,
puede especificar el atributo Duración para diferentes eventos de la jerarquía:
• Evento primario principal superior: ..\..\..|Duration
• Evento coincidente: .|Duration
• Evento secundario denominado Phase1: .\Phase1|Duration

Ejemplo de comparación de eventos

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

80 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

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

La función devuelve la siguiente matriz:

Función de búsqueda de filtro de activo

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

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

Manual del usuario de PI DataLink 2014 81

Funciones de PI DataLink

Entrada Descripción
Ruta raíz Ruta común a los elementos de datos especificados. Las entradas válidas
incluyen:
• Nombre del PI Server si el elemento de datos es un PI point.
• Servidor de PI AF 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 PI Server
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 función recupera valores de propiedad.
Incluya un rango de celdas que contenga nombres de PI point o de atributos
de PI AF para mostrar valores para cada uno de ellos. De forma
predeterminada, PI DataLink graba valores en filas para una columna de
elementos de datos referenciados y en columnas para una fila de elementos
de datos referenciados.
Propiedad La propiedad para la que devuelve valores la función. Las propiedades
incluidas en la lista dependen del elemento de datos introducido:
• PI point ú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: categorías, descripción, 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 podría encontrar el elemento de
datos.
Seleccione la propiedad deseada o especifique una referencia de celda a una
celda que contenga la propiedad.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.

Consulte también
PITagAtt()

82 Manual del usuario de PI DataLink 2014

 Funciones de PI DataLink

Ejemplo de propiedades
Para ver los atributos de valor de algunos de los PI points listados en la hoja de cálculo, defina
las siguientes entradas para la función Propiedades:
Entrada Valor
Elemento de datos B3..B5 (matriz de celda que contiene puntos)
Propiedad description (descripción)

La función devuelve la siguiente matriz:

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

Manual del usuario de PI DataLink 2014 83

Funciones de PI DataLink

84 Manual del usuario de PI DataLink 2014

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

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

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

1. Fórmula de función en la barra de fórmulas

2. Valores devueltos en la matriz de función

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

Tareas comunes relacionadas con las matrices de función

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

Manual del usuario de PI DataLink 2014 85

Uso y mantenimiento de las hojas de cálculo

• Haga clic y arrastre para seleccionar todas las celdas de la matriz. Tenga presente que la
matriz puede contener valores vacíos, que también deben ser seleccionados.
• Haga clic con el botón derecho en cualquier parte de la matriz y elija Seleccionar función
DataLink para seleccionar todas las celdas de la matriz.
Una vez seleccionadas, podrá gestionar la matriz fácilmente.
• Elimine manualmente los caracteres $ de la barra de fórmulas para convertir las referencias
de celda en relativas.
Nota:
Después de realizar un cambio en la barra de fórmulas, pulse Ctrl + Alt + Entrar para
aplicar el cambio.
• Haga clic con el botón derecho en cualquier celda de la matriz y seleccione, según desee, la
operación Cortar, Copiar, Eliminar, Borrar o Formato.
• Haga clic con el botón derecho en una nueva celda y seleccione Pegar para volver a insertar
una matriz cortada o copiada.
• Sitúe el cursor sobre el borde de la matriz seleccionada hasta que aparezca un cursor en
forma de cruz y, a continuación, arrastre la matriz a una nueva celda para desplazarla.
Nota:
Debe trasladar o borrar una matriz Excel completa, incluidas todas las celdas, o PI
DataLink mostrará un mensaje de error: You cannot change part of an array.
• Abra el cuadro de diálogo de función o el panel de tareas y actualice el campo Celda de
salida para colocar la matriz en una nueva ubicación. Consulte Actualizar entradas en una
matriz de función.
También puede copiar los valores de una matriz de función si desea utilizarlos en otra parte en
una hoja de cálculo. Una vez copiados y pegados los valores, ya no forman parte de una matriz
de función; son simplemente valores de celda y no se actualizan. Para copiar valores de matriz:
• Seleccione los valores de función que desea, cópielos y utilice Pegado especial para pegarlos
en la ubicación deseada.
No es necesario seleccionar la columna o fila completa de la matriz para copiar valores.

Actualizar entradas en una matriz de función

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

Procedimiento
1. Abra el panel de tareas de funciones de una matriz:
◦ Con la visualización automática del panel de tareas de funciones activada, haga clic en
una o varias celdas.
◦ Con la visualización automática del panel de tareas de funciones desactivada, seleccione
una celda o varias, haga clic con el botón derecho del ratón y elija un nombre de función.
El panel de tareas de funciones muestra las entradas actuales de la matriz de función
seleccionada.
Si ha seleccionado una única celda, PI DataLink detecta de forma automática las matrices de
función adyacentes que únicamente difieren por el origen (es decir, por el elemento de
datos o la expresión) y selecciona las matrices para editar.

86 Manual del usuario de PI DataLink 2014

 Uso y mantenimiento de las hojas de cálculo

Si ha seleccionado varias celdas, PI DataLink sólo selecciona las matrices con el mismo
origen (es decir, con los mismos valores para el elemento de datos o la expresión) que las
celdas seleccionadas.
2. Modifique 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 ubicación de la
nueva referencia de celda:

◦ Si la nueva referencia de celda forma parte de la matriz original, PI DataLink desplaza

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

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

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

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

Manual del usuario de PI DataLink 2014 87

Uso y mantenimiento de las hojas de cálculo

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

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

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

Función Actualización automática

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

◦ Calcular (F9)
Seleccione esta opción para volver a calcular las funciones volátiles y cualquier función
que haga referencia a ellas durante cada recálculo.
◦ Cálculo completo (Ctrl+Alt+Mayúsculas+F9)
Seleccione esta opción para volver a calcular todas las funciones, independientemente de
la volatilidad, durante cada recálculo.
• Frecuencia de actualización
En el campo Intervalo, indique el número de segundos entre cada recálculo automático. El
valor mínimo es cinco segundos. Introduzca 0 para que PI DataLink establezca
automáticamente el intervalo como dos veces la duración del cálculo, con un intervalo
mínimo de cinco segundos. OSIsoft recomienda utilizar el intervalo automático para
garantizar que Excel permanecerá receptivo el 50% del tiempo.
Si el recálculo tarda más que el intervalo especificado, un mensaje pregunta si se desea
cambiar al ajuste de intervalo automático o desactivar completamente la función
Actualización automática.

88 Manual del usuario de PI DataLink 2014

 Uso y mantenimiento de las hojas de cálculo

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

Activar Actualización automática

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

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

Consulte también
Configuración de preferencia

Cancelación de Actualización automática

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

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

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

Basar funciones de PI DataLink en funciones volátiles de Excel

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

Manual del usuario de PI DataLink 2014 89

Uso y mantenimiento de las hojas de cálculo

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

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

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

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

Compartir hojas de cálculo

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

90 Manual del usuario de PI DataLink 2014

 Uso y mantenimiento de las hojas de cálculo

personalizada de los datos a cualquier usuario que disponga de una copia de Excel. Consulte
Tareas comunes relacionadas con las matrices de función.
• Si dispone de Microsoft SharePoint Server en su entorno informático, puede publicar una
hoja de cálculo 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 opción Cálculo de libro de trabajo como manual

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

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

Manual del usuario de PI DataLink 2014 91

Uso y mantenimiento de las hojas de cálculo

92 Manual del usuario de PI DataLink 2014

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

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

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

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

Abreviaturas de tiempo PI
Al especificar un tiempo PI, puede utilizar abreviaturas concretas que representen unidades de
tiempo y referencias temporales.
Abreviaturas de unidad de tiempo
Abreviatura Unidad de tiempo
s segundo
m minuto
h hora
d día
mo mes
y año
w semana

Para especificar unidades de tiempo, puede especificar la abreviatura, la unidad de tiempo

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

Manual del usuario de PI DataLink 2014 93

Temas avanzados

valor fraccionario, como 1.25h. No se pueden especificar valores fraccionarios con otras
unidades de tiempo.
Abreviaturas de referencias temporales
Abreviatura Versión completa Referencia temporal
* Hora actual
t hoy [Link] (medianoche) del día en curso
y ayer [Link] (medianoche) del día anterior
dom1 domingo [Link] (medianoche) del domingo más reciente
jun2 junio [Link] (medianoche) del día en curso del mes de junio del
año actual
dic DD diciembreDD [Link] (medianoche) del DDésimo día del mes de
diciembre del año en curso
YYYY [Link] (medianoche) del día, mes y año en cursoYYYY
M-D o M/D [Link] (medianoche) del Désimo día del mesM del año en
curso
DD [Link] (medianoche) del DDésimo del mes en curso
1: Utilice las tres primeras letras como abreviatura de un día de la semana. dom, lun,

mar, mie, jue, vie o sab

2: Utilice las tres primeras letras como abreviatura de un mes del año: ene, feb, mar,

abr, may, jun, jul, ago, sep, oct, nov o dic.

Expresiones de tiempo PI
Las expresiones de tiempo PI pueden incluir puntos temporales fijos, abreviaturas de
referencias temporales y desplazamientos temporales. Un desplazamiento temporal indica la
dirección del desplazamiento (+ o -) y el intervalo del desplazamiento (una abreviatura de
unidad de tiempo con un valor). Las expresiones de tiempo PI válidas son:
• Solo un punto temporal fijo, como 24-aug-2012 [Link]
• 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 expresión. Si incluye varios, los resultados
pueden ser imprevisibles. Por ejemplo, las siguientes expresiones temporales no son válidas:
• *+1d+4h
• t-1d+12h

Especificación de intervalos de tiempo

Para especificar entradas para las marcas de tiempo, puede introducir expresiones temporales
que contengan:
• Puntos temporales fijos
Un punto temporal fijo representa siempre el mismo punto temporal, independientemente
de la hora en curso.
Entrada Significado
23-ago-12 [Link] 3:00 p.m. del 23 de agosto de 2012

94 Manual del usuario de PI DataLink 2014

 Temas avanzados

Entrada Significado
25-sep-12 [Link] (medianoche) del 25 de septiembre de 2012

• Abreviaturas de referencias temporales

Una abreviatura de referencia temporal representa siempre a una hora relativa a la hora
actual.
Entrada Significado
* Hora actual (ahora)
3-1 o 3/1 [Link] (medianoche) del 1 de marzo del año en curso
2011 [Link] (medianoche) del mes y el día en curso del año 2011
25 [Link] (medianoche) del día 25º del mes actual
t [Link] (medianoche) de la fecha en curso (hoy)
y [Link] (medianoche) de la fecha anterior (ayer)
tue [Link] (medianoche) del martes más reciente

• Abreviaturas de referencia temporal con un desplazamiento temporal

Cuando se incluye con una abreviatura de referencia temporal, un desplazamiento temporal
se añade o resta a la hora especificada.
Entrada Significado
*-1h Hace una hora
t+8h [Link] (8:00 a.m.) de hoy
y-8h [Link] (4:00 p.m.) del día anterior a ayer
mon+14.5h [Link] (2:30 p.m.) del último lunes
sat-1m [Link] (11:59 p.m.) del último viernes

• Desplazamientos temporales
Si se introducen solos, los desplazamientos especifican un punto en el tiempo relativo a una
referencia temporal implicada. Una referencia temporal implicada puede ser la hora de reloj
actual u otra hora, en función de dónde introduzca la expresión.
Entrada Significado
-1d Un día antes del momento actual
+6h Seis horas después de la hora actual

Especificación de intervalos de tiempo

Las entradas de intervalo de tiempo definen intervalos para recopilar o calcular valores a lo
largo de un período de tiempo. Por ejemplo, puede especificar un intervalo de 60 minutos para
calcular el promedio por hora para un período de 12 horas. Para especificar entradas de
intervalo de tiempo, introduzca un valor y una unidad de tiempo válidos:
• Los valores positivos definen intervalos que comienzan en el primer momento del período y
finalizan en o antes del último momento del periodo.
Hora de inicio [Link]
Hora de finalización [Link]
Intervalo de tiempo 30m

Manual del usuario de PI DataLink 2014 95

Temas avanzados

Intervalos devueltos [Link] a [Link]

[Link] a [Link]

• Los valores negativos definen intervalos que finalizan en el último momento del período y
comienzan en o antes del primer momento del periodo.
Hora de inicio [Link]
Hora de finalización [Link]
Intervalo de tiempo -30m
Intervalos devueltos [Link] a [Link]
[Link] a [Link]

Expresiones
En PI DataLink, las expresiones son ecuaciones de rendimiento que se pueden utilizar en
funciones para incorporar operaciones matemáticas y cálculos basados en elementos de datos
de PI System. Por ejemplo, puede utilizar una expresión en una función de PI DataLink para
calcular valores a medida que se obtengan de PI Server.
Nota:
PI DataLink restringe los elementos 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 expresión como entrada.
Estas funciones tienen las opciones Elemento de datos y Expresión en la parte superior del
panel de tareas. Algunas funciones de DataLink tienen también un campo Expresión de filtro.
Especifique una expresión de filtro para limitar los valores que devuelve una función.
Las funciones de PI DataLink que pueden utilizar expresiones son:
• Función Valor de archivo histórico
• Función Datos comprimidos
• Función Datos de muestra
• Función Datos temporizados
• Función Datos calculados
• Función Filtrado de tiempo
En las siguientes secciones se proporciona información básica sobre las expresiones. PI
DataLink admite la sintaxis, operadores y funciones admitidos por PI Server.
Para obtener una descripción completa de las ecuaciones de rendimiento y ejemplos, consulte
PI Server Applications User Guide o el archivo de ayuda PI 3 Performance Equations. Puede
descargar estos documentos de la página de descargas del Servicio de asistencia técnica de
OSIsoft ([Link] También puede
consultar estos temas en la PI Live Library ([Link]

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

96 Manual del usuario de PI DataLink 2014

 Temas avanzados

Uso de expresiones en funciones de PI DataLink

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

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

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

Sintaxis de las expresiones

Siga estas indicaciones cuando escriba expresiones:
• Incluya cualquier PI point o los nombres de atributos de PI AF entre comillas simples.
• Si va a introducir una expresión en una celda de Excel, escriba una comilla simple al
principio de la expresión para obligar a Excel a interpretar la expresión como una cadena.
• Si va a introducir una expresión en una celda de Excel y la expresión empieza con un PI
point o un nombre de atributo de PI AF, escriba unas comillas dobles al principio de la
expresión.
• Si va a introducir un valor para comparar con un PI point digital, especifique un valor
negativo del número de código 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
Además, una función de PI DataLink solo puede devolver datos de un solo PI Server. Por lo
tanto, todos los PI points de una expresión, incluidos aquellos a los que hacen referencia los
atributos de PI AF, deben almacenarse en el mismo PI Server. De forma similar, los PI points de
una expresión de filtro deben almacenarse en el mismo PI Server que cualquier PI point
especificado en los campos Elemento de datos o Expresión.

Manual del usuario de PI DataLink 2014 97

Temas avanzados

Ejemplos de expresiones
La siguientes expresión calcula el total del valor del PI point sinusoid al cubo y el valor del PI
point cdf144 dividido por 10:
(('sinusoid')^3 + 'cdf144'/10)
La expresión siguiente se evalúa como verdadera (distinta de cero) si el valor absoluto del PI
point mytages al menos 14,65:
(abs('mytag') >= 14.65)
La siguiente expresión se evalúa como true si el valor del atributo de PI AF Manufacturer es
ACME:
('\\Server\Database\Element|Manufacturer' = "ACME")
La siguiente expresión se evalúa como verdadera si el valor del PI point sinusoid es menor
que 45 y la raíz cuadrada del valor del PI point vdf1002 es mayor que 2:
('sinusoid' < 45 and sqr('vdf1002') > 2)

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

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

Entrada manual de funciones

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

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

98 Manual del usuario de PI DataLink 2014

 Temas avanzados

• Códigos de salida

Definir funciones manualmente

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

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

Pautas para introducir argumentos de forma manual

En la siguiente tabla, se incluyen los tipos de datos que pueden introducirse como argumentos
de funciones de PI DataLink y proporciona pautas para introducirlos:
Datos introducidos como Pauta
argumento
Funciones estándar Puede incluir varias funciones en argumentos que acepten
expresiones. Consulte el manual PI Server Applications User Guide o
el 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 PI Server denominado casaba, seleccione una matriz de
salida de 1 x 2 e introduzca:
=PICurrVal("sinusoid", 1, "casaba")

Referencias de celda Puede utilizar referencias de celda para cualquier argumento de las
funciones PI DataLink. Por ejemplo, supongamos que las celdas de
hoja de cálculo tienen los siguientes valores:
• A1: "sinusoid"
• A2: 1
• A3: "casaba"
Por lo tanto, la introducción de la siguiente función en la barra de
fórmulas:
=PICurrVal(A1, A2, A3)
es equivalente a introducir:
=PICurrVal("sinusoid", 1, "casaba")

Ruta raíz Incluya una entrada entre comillas dobles. Por ejemplo, para
recuperar el valor actual de los atributos de PI AF especificados en
las celdas B3 a B5 y almacenados en el servidor de PI AF DLAFPI, la
base de datos MyTest y el elemento Reactor, introduzca:
=PICurrVal(B3:B5,0,"\\DLAFPI\MyTest\Reactor")
Consulte Elementos de datos para obtener información sobre las
entradas válidas.

Manual del usuario de PI DataLink 2014 99

Temas avanzados

Datos introducidos como Pauta

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

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

Significado de los bits para otras funciones de PI DataLink

Bit Finalidad
1 Mostrar marcas de tiempo
2 Orientar datos en filas en lugar de en columnas
3 Mostrar porcentaje correcto
4 Ocultar recuento
5 Mostrar estado extendido
6 Mostrar anotaciones
71 Mostrar hora de inicio
81 Mostrar hora de finalización
91 Mostrar tiempo mín/máx
1 Requiere que el bit 1 esté también habilitado

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

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

100 Manual del usuario de PI DataLink 2014

 Temas avanzados

las valores de muestra en la fila dos de una matriz n x 2. (En estos resultados, n es el número de
los valores de muestra).
Nota:
Las funciones admiten distintos bits y, por lo tanto, valores de argumento de OutCode.
Aquellos que son válidos para una función no son necesariamente válidos para otra.
Consulte en la Referencia de función los bits que cada función admite en su especificación
de OutCode.

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

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

=PICalcDat("sinusoid","y","t","1h","minimum", 1, 325,"piserver")
Nota:
Si un argumento OutCode especifica que una función debe mostrar varias columnas o
filas, pero la hoja de cálculo no las muestra, haga clic con el botón derecho en la matriz de
función y seleccione Recalcular/Redimensionar para actualizar la matriz de función.

Funciones para escribir datos

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

Manual del usuario de PI DataLink 2014 101

Temas avanzados

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

Consulte también
PIPutVal() y PIPutValX()

102 Manual del usuario de PI DataLink 2014

Funciones de tags
Un PI point es un flujo de datos en tiempo real procedentes de una fuente definida. Los
atributos de punto, incluido el Tag (es decir, el nombre del PI point) y el origen de punto,
describen un PI point.
Utilice las funciones de tags de PI DataLink para localizar los puntos que corresponden a IDs de
PI point y otros atributos de punto. Podrá encontrar funciones de tag en la pestaña PI DataLink,
en el grupo Funciones de tag.
Nota:
Debe activar el complemento PI DataLink (Legacy) para utilizar estas funciones (consulte
Configuración del complemento para Microsoft Excel).

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

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

Función Apuntar ID al Tag

La función Apuntar ID al Tag devuelve el nombre del PI point correspondiente a un
determinado ID de punto.
Entrada Descripción
PI Server El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o
deja este campo en blanco, la función buscará el PI Server predeterminado.
ID(s) de punto Uno o varios ID de punto para los que desea que la función devuelva nombres
de punto.
Necesario.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.

Consulte también
PIPointIDToTag()

Manual del usuario de PI DataLink 2014 103

Funciones de tags

Ejemplo de Apuntar ID al Tag

Para ver el nombre del PI point correspondiente a un ID de punto, defina las siguientes
entradas para la función Apuntar ID al Tag:
Entrada Valor
ID de punto A5 (una celda que contiene un ID de punto)

La función devuelve la siguiente matriz:

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

Función Máscara de atributo para tag

La función Máscara de atributo para tag devuelve los nombres de PI points que coinciden con
uno o varios valores de atributos de puntos específicos.
Entrada Descripción
PI Server El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o
deja este campo en blanco, la función buscará el PI Server predeterminado.
Nombre(s) de tag Valor de atributo de PI point para el que la función busca el correspondiente
Descriptor nombre de punto. Debe introducir un valor en un campo de entrada como
mínimo. Utilice el carácter comodín (*) para encontrar todas las coincidencias
Fuente 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 ingeniería
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.
Columna Haga clic en esta opción para devolver valores en una columna.
Fila Haga clic en esta opción para devolver valores en una fila.

Consulte también
PIAttributeMaskToTag ()

104 Manual del usuario de PI DataLink 2014

 Funciones de tags

Ejemplo de Máscara de atributo para tag

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

La función devuelve la siguiente matriz:

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

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

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

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

◦ Búsqueda básica
Utilice esta opción para crear una máscara a partir de determinados atributos de PI point
y buscar puntos que tengan valores de atributo coincidentes.
◦ Búsqueda avanzada
Utilice esta opción para crear una consulta para una búsqueda compleja que implique
más atributos de punto que la búsqueda básica.
◦ Búsqueda de alias
Utilice esta opción para seleccionar puntos por sus alias descriptivos en PI Module
Database.
3. Introduzca los criterios de búsqueda.
Utilice * o ? como caracteres comodín, según proceda. Por ejemplo, si el campo Máscara de
tag se establece en Tem*, devuelve todos los nombres de punto que comienzan por Tem,
mientras que si el campo se establece en Tem?, devuelve solo los puntos que empiezan con
Tem y terminan con otro carácter simple. Los campos de búsqueda no distinguen entre
mayúsculas y minúsculas.
4. Si lo desea, haga clic en Favoritos para acceder a las búsquedas anteriores.

Manual del usuario de PI DataLink 2014 105

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.

106 Manual del usuario de PI DataLink 2014

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

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

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

Crear una tendencia

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

Procedimiento
1. En una hoja de cálculo, 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 estándar.
2. En la pestaña PI DataLink, en el grupo Funciones de tag, haga clic en Insertar tendencia para
abrir el Asistente para complementos de tendencia.
3. Defina uno o varios trazos para incluir en la tendencia. Puede:
◦ Crear un trazo de valores en la hoja de cálculo.
◦ Crear un trazo de valores de PI point obtenidos de un PI Server.
4. Ajuste el aspecto de los trazos de la tendencia. Puede:

Manual del usuario de PI DataLink 2014 107

Tendencias

◦ Seleccionar la casilla de verificación en la columna Marcadores para incluir marcadores

que indiquen la ubicación de los puntos de datos archivados.
Nota:
Los trazos se dibujan con distintos colores. De forma predeterminada, una
tendencia incluye también marcadores ocultos para diferenciar los trazos en las
pantallas monocromas. Los marcadores ocultos tienen una separación regular a lo
largo del trazo y no indican puntos de datos archivados.
◦ Seleccionar un trazo y, a continuación, utilizar los botones de flecha para mover el trazo
hacia arriba o abajo en la leyenda.
◦ Seleccionar un trazo y hacer clic en X para eliminar el trazo.
◦ Hacer clic en x todo para eliminar todos los trazos.
◦ Seleccionar un trazo y hacer clic en Cambiar nombre para cambiar el nombre del trazo.
5. Haga clic en Siguiente.
6. Si alguno de los trazos de la tendencia contiene valores de PI point obtenidos de un PI
Server, especifique el periodo de tiempo para recuperar valores.
a. Especifique el inicio del periodo en el campo Hora de inicio y el final del periodo en el
campo Hora de finalización. Puede:
▪ Seleccionar una cadena de tiempo de la lista.
▪ Introducir un valor de tiempo en el campo.
▪ Hacer clic en para convertir el campo en un campo de referencia de datos y, a
continuación, hacer clic en la celda de hoja de cálculo que contenga una serie de
tiempo o escribir la dirección de esa celda.
Consulte Tiempo PI para ver una explicación de las cadenas de tiempo válidas.
b. Seleccione la casilla Activar actualizaciones para actualizar la tendencia con nuevos
datos de PI Server si el intervalo de tiempo cambia o se extiende hasta el presente.
7. Haga clic en Siguiente.
8. Especifique el título y la colocación de la tendencia:
a. En el campo Título de trend, escriba un título para la tendencia.
b. Anule la selección de la casilla Mostrar atributos de valor si no desea que los atributos de
valor aparezcan en los trazos de la tendencia.
Los iconos aparecen cuando los datos contienen valores registrados que tienen ajustados
los bits Cuestionable, Sustituido o Anotado.
c. Si lo desea, especifique una ubicación diferente para la tendencia. Puede seleccionar:
▪ Hoja de cálculo nueva para situar la tendencia en la esquina superior izquierda de una
hoja de cálculo en blanco.
▪ Hoja de cálculo existente para colocar la tendencia en la hoja de cálculo actual que
empieza en la celda especificada.
Si cambia la celda, asegúrese de que la celda nueva no contenga datos.
9. Haga clic en Finalizar.

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

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

108 Manual del usuario de PI DataLink 2014

 Tendencias

Procedimiento
1. En el Asistente para complementos de trend, haga clic en Datos de la hoja de cálculo.
2. Haga clic en el campo Rango de celdas con datos y, a continuación, 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 función en el intervalo de celdas. Si selecciona esta casilla, el campo Rango
de celdas con datos solo necesita especificar una celda en una matriz de función.
◦ Seleccione la casilla Escalonado trazar un plot de tendencia escalonado en lugar de un
trazo continuo Puede seleccionar esta casilla para PI points que almacenen valores
discretos.
4. Haga clic en Añadir para insertar el trazo en la tendencia.

Crear un trazo de valores de PI point obtenidos de un PI Server

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

Procedimiento
1. En el Asistente para complementos de trend, 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 cálculo que contengan nombres
de puntos.
◦ Hacer clic en para abrir la ventana Búsqueda de tags, que puede utilizar para buscar
puntos (consulte Buscar PI points).
3. En el campo Nombre de servidor, especifique el PI Server que almacena valores para el
punto. Puede:
◦ Seleccionar el servidor de la lista.
◦ Hacer clic en para convertir el campo en un campo de referencia de datos y, a
continuación, hacer clic en la celda de hoja de cálculo que contenga un servidor o escriba
la dirección de esa celda.
4. Haga clic en Añadir para insertar el trazo en la tendencia.

Menú contextual de tendencias

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

Manual del usuario de PI DataLink 2014 109

Tendencias

• Cambiar escala
Abra la ventana Cambiar escala para cambiar la escala del eje Y o el intervalo de tiempo del
eje X.

• Revertir
Deshaga los cambios y vuelva a la configuración original de la tendencia definida en el
Asistente para complementos de trend.

• Barra de desplazamiento
Habilite una barra de desplazamiento en la parte inferior de la tendencia para desplazar la
pantalla por los intervalos de tiempo adyacentes.

• Formato
Abra el cuadro de diálogo Propiedades de control PI Trend para modificar el aspecto de
trazos individuales o de la tendencia entera. Puede cambiar el color o el grosor de la línea de
un trazo o añadir elementos de leyenda a la tendencia.

• Definir trend
Abra la página de definición de trazos del asistente de tendencias para actualizar o cambiar
los trazos.

• Definir rango temporal de trend

Abra la página de definición del intervalo de tiempo del asistente de tendencias para
actualizar el intervalo.

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

• Exportar datos
Abra el cuadro de diálogo Exportar datos para pegar los valores de la tendencia en filas o
columnas de la hoja de cálculo. También puede exportar nombres de trazos como títulos.

• Mover/Cambiar tamaño
Abra el cuadro de diálogo Mover/Cambiar tamaño para mover la esquina superior izquierda
de la tendencia a la celda especificada. Introduzca un intervalo de celdas para
redimensionar la tendencia.

• Copiar/Pegar
Abra el cuadro de diálogo Copiar/Pegar para pegar una copia de la tendencia a una
determinada celda.

110 Manual del usuario de PI DataLink 2014

Objetos de PI Module Database
Los temas de este apartado describen las herramientas que PI DataLink proporciona para
acceder a objetos de PI Module Database. Podrá encontrar estas herramientas en la pestaña PI
DataLink, en el grupo Módulo de base de datos. Consulte la documentación de PI Server para
obtener más información sobre las bases de datos de módulos y su configuración.
Nota:
Debe activar el complemento PI DataLink (Legacy) para utilizar estas herramientas
(consulte Configuración del complemento para Microsoft Excel).

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

PI Module Database y hojas de cálculo

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

Insertar objetos de PI Module Database en la hoja de cálculo

Utilice el cuadro de diálogo Buscar módulo para buscar alias de PI, propiedades y rutas de
módulos en PI Module Database. Puede seleccionar estos elementos y copiarlos directamente
en una hoja de cálculo.
Nota:
Los alias y propiedades correspondientes a los PI points deben configurarse en PI Server
Module Database para utilizar las funciones de Module Database en PI DataLink.

Manual del usuario de PI DataLink 2014 111

Objetos de PI Module Database

Procedimiento
1. Seleccione una celda y en PI DataLink haga clic en Buscar módulo para abrir el cuadro de
diálogo Buscar módulo.
2. Seleccione el tipo de objeto que está buscando:
◦ Alias
◦ Propiedad
◦ Módulo
3. En la lista desplegable PI Server, seleccione el PI Server conectado que contiene la base de
datos de módulo que desea examinar.
4. En la lista Fecha de consulta, especifique la fecha y hora efectivas de la jerarquía de base de
datos de módulo que desea ver.
5. Navegue por la jerarquía de árbol para localizar el elemento deseado.
6. Seleccione el elemento o el objeto de colección principal que desea copiar en la hoja de
cálculo:
◦ Seleccione un elemento para copiar en la hoja de cálculo.
◦ Seleccione un objeto principal (Alias o Propiedades) de un módulo para copiar todos los
alias o propiedades de ese módulo en la hoja de cálculo.
7. Seleccione la casilla Copiar ruta de módulo para copiar la ruta de módulo completa del alias
o la propiedad en una celda de hoja de cálculo adyacente.
La ruta de módulo proporciona el contexto para el objeto seleccionado. Nota: si el ajuste
Copiar nombre de PI Server está activado, PI DataLink también copiará el nombre del PI
Server correspondiente.
Nota:
Si el ajuste Copiar nombre de PI Server (consulte Configuración de preferencia) está
activado, PI DataLink también copiará el nombre del PI Server correspondiente.
8. Haga clic en Aceptar para copiar los elementos seleccionados en la hoja de cálculo y cerrar
el cuadro de diálogo.

Funciones de bases de datos de módulos

Utilice las funciones de base de datos del módulo PI DataLink para localizar los PI points
correspondientes a los alias y las propiedades de un árbol de base de datos de módulo. Estas
funciones utilizan la ruta de módulo. Puede introducir una ruta de módulo como argumento de
función o hacer referencia a él en una celda de hoja de cálculo. Podrá encontrar estas funciones
de base de datos de módulo en la pestaña PI DataLink, en el grupo Module Database.
Nota:
La función no puede resolver un alias o un objeto de propiedad en un PI point sin una
ruta de módulo. La ruta proporciona un contexto que correlaciona el alias con un PI point
específico.

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

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

112 Manual del usuario de PI DataLink 2014

 Objetos de PI Module Database

Función Alias para tag

La función Alias para tag devuelve el nombre del PI point correspondiente a un determinado
alias de PI.
Entrada Descripción
PI Server El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o
deja este campo en blanco, la función buscará el PI Server predeterminado.
Alias Alias de PI Module Database.
Necesario.
Ruta de módulo La ruta de módulo procedente de PI Module Database donde puede
encontrarse el alias especificado. Si especifica Alias al navegar por Module
Database, PI DataLink introduce Ruta de módulo de forma automática.
Necesario.
Fecha de consulta Fecha efectiva del alias. PI DataLink devuelve el punto correspondiente al
alias especificado en esa fecha.
Necesario.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o
deja este campo en blanco, la función buscará el PI Server predeterminado.
Sin servidor Seleccione esta opción para recuperar sólo el nombre del PI point.
Servidor a la derecha Seleccione esta opción para mostrar el PI Server que almacena el punto en la
celda a la derecha del nombre del punto.
Servidor en la parte Seleccione esta opción para mostrar el PI Server que almacena el punto en la
inferior celda debajo del nombre del punto.

Consulte también
PIAliasToTag()

Función Propiedad para valor

La función Propiedad para valor devuelve el valor o valores correspondientes a una propiedad
de PI especificada.
PI DataLink puede devolver valores para tipos de propiedad Boolean, Date, Double, Integer,
Long, Null, Single y String, o tipos de propiedad de matriz Double, Integer, Long y Single.
Entrada Descripción
PI Server El PI Server cuyos datos devuelve la función. Si no selecciona un servidor o
deja este campo en blanco, la función buscará el PI Server predeterminado.
Propiedad(es) Una propiedad de PI en PI Module Database.
Necesario.

Manual del usuario de PI DataLink 2014 113

Objetos de PI Module Database

Entrada Descripción
Ruta de módulo La ruta de módulo procedente de PI Module Database donde puede
encontrarse la propiedad especificada. Si especifica Propiedad al navegar por
Module Database, PI DataLink introduce Ruta de módulo de forma
automática.
Necesario.
Fecha de consulta Fecha efectiva de la propiedad de PI. PI DataLink devuelve el valor de la
propiedad especificada en esa fecha.
Necesario.
Celda de salida La celda de hoja de cálculo donde la función escribe la matriz de función
resultante. Si selecciona una celda antes de abrir el panel de tareas de
función, PI DataLink inserta la celda seleccionada en el campo Celda de salida.
Especifique la esquina superior izquierda de la matriz de función. PI DataLink
expande el rango hacia abajo y a la derecha de la celda de salida, según
resulte necesario para devolver los datos especificados. PI DataLink puede
sobrescribir las celdas adyacentes.
Si especifica una matriz multiceldas en el campo Celda de salida y la matriz
especificada es mayor que la matriz de función resultante, PI DataLink pega la
fórmula de función en las celdas de la matriz especificada que no se
necesitan.
Columna Haga clic en esta opción para devolver valores en una columna.
Fila Haga clic en esta opción para devolver valores en una fila.

Consulte también
PIPropertyToValue()

114 Manual del usuario de PI DataLink 2014

Notificaciones
PI DataLink incluye el complemento PI DataLink Notifications. Al activarse, este complemento
añade la función Búsqueda de notificación a la pestaña PI DataLink. Utilice la función Búsqueda
de notificación para recuperar notificaciones de PI System a las que se haya suscrito e insertar
estas notificaciones en hojas de cálculo.
El complemento PI DataLink Notifications se ejecuta en Windows XP y sistemas operativos
posteriores y requiere Excel 2007 SP3 o versiones posteriores. PI Notifications debe estar
instalado en el ordenador para poder activar el complemento (consulte Configuración del
complemento para Microsoft Excel).
Nota:
Debe tener una cuenta como mínimo en un servidor de PI AF 2.0 con PI Notifications 1.0 y
estar suscrito a una regla de notificación como mínimo para recibir notificaciones. Para
obtener más información sobre PI Notifications, consulte el Manual del usuario de PI
Notifications.
Para acceder a la función Búsqueda de notificación, haga clic en la celda de salida de la hoja de
cálculo que desee y, a continuación, en la pestaña PI DataLink (en el grupo Notificaciones),
haga clic en Notification Search para abrir el cuadro de diálogo Notification Search.

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

Búsqueda e inserción de notificaciones

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

Manual del usuario de PI DataLink 2014 115

Notificaciones

Procedimiento
1. En la pestaña PI DataLink, en el grupo Notifications, haga clic en Notification Search para
abrir el cuadro de diálogo Notification Search.
2. En la pestaña Search, seleccione el servidor PI AF en el que buscará las notificaciones:
◦ En la lista PI Systems, seleccione un servidor PI AF y haga clic en Conectar para
conectarse a ese servidor.
Si es necesario, haga clic en Mostrar lista para abrir la ventana Servidores AF, donde
podrá añadir un servidor de PI AF a la lista. Consulte Añadir un servidor de PI AF a la
función Búsqueda de notificación.
◦ Haga clic en y, a continuación haga clic en una celda de hoja de cálculo que contenga
el nombre de un servidor de PI AF.
Vuelva a hacer clic en el botón para mostrar la lista PI Systems.
3. En la lista View Notifications, seleccione la opción de filtrado de las notificaciones
devueltas:
◦ Seleccione Active para devolver todas las notificaciones activas actualmente.
◦ Seleccione Timerange e introduzca valores en Start Time y End Time para devolver las
notificaciones que se produzcan a lo largo de un intervalo de tiempo especificado.
◦ Seleccione Recent e introduzca un número y un intervalo de tiempo para devolver las
notificaciones más recientes de un periodo de tiempo específico.
4. En el campo Output Cell, especifique la hoja de celda de cálculo en la que desee insertar las
notificaciones.
5. Haga clic en Search para recuperar las notificaciones que coincidan con determinados
criterios en el área de resultados en la parte inferior de la ficha.
6. Examine las notificaciones recuperadas. Puede:
◦ Ajustar la visualización de las notificaciones recuperadas
◦ Gestionar las notificaciones recuperadas
7. Haga clic en OK para insertar las notificaciones mostradas en la hoja de cálculo y cerrar el
cuadro de diálogo.
PI DataLink inserta la consulta de notificación en la hoja de cálculo como matriz de función
en la ubicación designada. Al igual que otras funciones de PI DataLink, la función Búsqueda
de notificación actualiza los datos cuando se recalcula la hoja de cálculo. Consulte Recálculo
provocado.

Añadir un servidor de PI AF a la función Búsqueda de notificación

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

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

116 Manual del usuario de PI DataLink 2014

 Notificaciones

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

2. Haga clic en Añadir servidor AF para abrir el cuadro de diálogo Propiedades de servidor de PI
AF.
3. Introduzca la información 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
función Búsqueda de notificación.
b. Haga clic en Configurar Active Directory para configurar el acceso a Active Directory para
obtener información de inicio de sesión.
4. Haga clic en Aceptar para guardar las propiedades y añadirlo a la lista de servidores de PI
AF.
5. Haga clic en Aceptar para cerrar el cuadro de diálogo Servidores AF.
El servidor de PI AF aparece en la lista PI Systems. Para obtener más información sobre los
servidores de PI AF, consulte la documentación relativa a PI AF.

Ajustar la visualización de las notificaciones recuperadas

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

Procedimiento
• Haga clic en las cabeceras de columna para ordenar notificaciones según un atributo
determinado.
• Haga clic con el botón 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 visualización de los
eventos de contacto para cada notificación.

Manual del usuario de PI DataLink 2014 117

Notificaciones

Gestionar las notificaciones recuperadas

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

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

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

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

Configuración de visualización de notificaciones

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

118 Manual del usuario de PI DataLink 2014

 Notificaciones

Columnas
• 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 insertarán en la hoja de cálculo.
Nota:
Incluya la columna Acknowledge para añadir un enlace a la hoja de cálculo para
confirmar la recepción e incluya la columna Acknowledge With Comment para añadir
un enlace en la hoja de cálculo para comentar una notificación.
• 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 notificación, como el envío a cada destinatario, comentarios y confirmaciones.
• Seleccione la casilla Indent contacts para añadir un sangrado a los eventos de contacto en la
hoja de cálculo. Esto ayuda a identificarlos.
◦ Seleccione Using separate columns para añadir una segunda columna para eventos de
contactos.
◦ Seleccione Formatting cells para añadir un sangrado a los eventos de contacto en la
misma columna que los eventos de notificación.
• Seleccione la casilla Group notifications with Excel grouping para utilizar la funcionalidad
de agrupación de Excel para anidar eventos de contactos bajo las notificaciones primarias
individuales que los generan.
Nota:
PI DataLink Server (DLS) no admite la agrupación de Excel.

Manual del usuario de PI DataLink 2014 119

Notificaciones

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

120 Manual del usuario de PI DataLink 2014

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

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

Funciones de valor único

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

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

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

Sintaxis
PICurrVal(DataItem, OutCode, RootPath)

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

Manual del usuario de PI DataLink 2014 121

Referencia de función

Argumento Tipo Descripción

OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1 y
2.
RootPath Cadena Ruta al elemento de datos al que hace referencia la
expresión. Consulte Elementos de datos.

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

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

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

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve un valor.
Especifique un rango de celdas que contengan
nombres de PI point o de atributos de PI AF para
devolver un valor para cada uno de ellos.
TimeStamp Cadena La marca de tiempo para la que devuelve valores la
función. Consulte Campos de entrada de tiempo.
OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1 y
2.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.

122 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

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

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

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

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

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

Sintaxis
PIExpVal(Expression, TimeStamp, OutCode, RootPath)

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

TimeStamp Cadena La marca de tiempo para la que devuelve valores la función.

Consulte Campos de entrada de tiempo.
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código. Esta función admite los bits 1 y
2.
RootPath Cadena Ruta al elemento de datos al que hace referencia la expresión.
Consulte Elementos de datos.

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

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

Manual del usuario de PI DataLink 2014 123

Referencia de función

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

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

Sintaxis
PITagAtt(DataItem, Property, RootPath)

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve un valor.
Especifique un rango de celdas que contengan
nombres de PI point o de atributos de PI AF para
devolver un valor para cada uno de ellos.
Propiedad Cadena El atributo del PI point o la propiedad del atributo
de PI AF para los que la función devuelve un valor.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.

Ejemplo
=PITagAtt(d1,"uom",)

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

Consulte también
Función Propiedades

Funciones de valor múltiple

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

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

124 Manual del usuario de PI DataLink 2014

 Referencia de función

• PITimeExpDat()

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para devolver valores para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la
función devuelve valores. Consulte Campos de
entrada de tiempo.
NumVals Integer El número de valores que la función recupera, a
partir de STime (especifique un número negativo
para recuperar valores hacia atrás en el tiempo).
OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1, 2,
5 y 6.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.
Mode Cadena Método que la función utiliza para determinar qué
valores se recuperarán cerca de la hora de inicio
(tipo de límite):
• interior
• externo
• interpolado
• auto

Ejemplo
=PINCompDat("cdf144","[Link]",10,1,,"inside")

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

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

Manual del usuario de PI DataLink 2014 125

Referencia de función

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve un valor.
Especifique un rango de celdas que contengan
nombres de PI point o de atributos de PI AF para
devolver un valor para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la
función devuelve valores. Consulte Campos de
entrada de tiempo.
NumVals Integer El número de valores que la función recupera, a
partir de STime (especifique un número negativo
para recuperar valores hacia atrás en el tiempo).
FiltExp Cadena Ecuación de rendimiento booleana que la función
utiliza para filtrar valores. Cuando la expresión se
evalúa como falsa, la función excluye los valores
correspondientes. Consulte Expresiones de filtro.
FiltCode Integer Código que indica si deben etiquetarse los valores
filtrados:
• 1
Insertar la etiqueta Filtered en lugar de un
valor o un bloque de valores que la función ha
filtrado de la salida en función de FiltExp.
• 0
No etiquetar valores filtrados.
OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1, 2,
5 y 6.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.
Mode Cadena Método que la función utiliza para determinar qué
valores se recuperarán cerca de la hora de inicio
(tipo de límite):
• interior
• externo
• interpolado
• auto

Ejemplo
=PINCompFilDat("cdf144","[Link]",10,"'cdep158'>38",1,1,,)

126 Manual del usuario de PI DataLink 2014

 Referencia de función

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

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

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para devolver valores para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la
función devuelve valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la
función devuelve valores.
OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1, 2,
4, 5 y 6.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.
Mode Cadena Método que la función utiliza para determinar qué
valores se recuperarán cerca de la hora de inicio
(tipo de límite):
• interior
• externo
• interpolado
• auto

Ejemplo
=PICompDat("cdf144","[Link]","[Link]",1,,"inside")

Manual del usuario de PI DataLink 2014 127

Referencia de función

Devuelve valores y sus marcas de tiempo correspondientes procedentes del PI Server

predeterminado para el PI point cdf144 a partir de la 1:00 a.m. a las 3:00 a.m. de esta mañana,
utilizando el tipo de límite interior.

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

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para devolver valores para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la
función devuelve valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la
función devuelve valores.
FiltExp Cadena Ecuación de rendimiento booleana que la función
utiliza para filtrar valores. Cuando la expresión se
evalúa como falsa, la función excluye los valores
correspondientes. Consulte Expresiones de filtro.
FiltCode Integer Código que indica si deben etiquetarse los valores
filtrados:
• 1
Insertar la etiqueta Filtered en lugar de un
valor o un bloque de valores que la función ha
filtrado de la salida en función de FiltExp.
• 0
No etiquetar valores filtrados.
OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1, 2,
4, 5 y 6.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.

128 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

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

Ejemplo
=PICompFilDat("cdf144","[Link]","[Link]","'cdep158'>38",1,1,,)

Devuelve valores y sus marcas de tiempo correspondientes procedentes del PI Server

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

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

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para devolver valores para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la
función devuelve valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la
función devuelve valores.
Interval Cadena El intervalo entre valores devueltos. Introduzca un
valor y la unidad temporal que especifica la
duración del intervalo. Por ejemplo, introduzca
15m (15 minutos) para devolver un valor por cada
intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de
tiempo.

Manual del usuario de PI DataLink 2014 129

Referencia de función

Argumento Tipo Descripción

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

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

Recupera datos de muestra y las marcas de tiempo correspondientes para el PI point

sinusoid procedentes del PI Server predeterminado, desde la medianoche de ayer hasta la
medianoche de hoy, notificando valores en intervalos de 3 horas.

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

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de
PI AF para los que la función devuelve valores.
Especifique un rango de celdas que contengan
nombres de PI point o nombres de atributos de PI
AF para devolver valores para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la
función devuelve valores. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la
función devuelve valores.
Interval Cadena El intervalo entre valores devueltos. Introduzca un
valor y la unidad temporal que especifica la
duración del intervalo. Por ejemplo, introduzca
15m (15 minutos) para devolver un valor por cada
intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de
tiempo.

130 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

FiltExp Cadena Ecuación de rendimiento booleana que la función
utiliza para filtrar valores. Cuando la expresión se
evalúa como falsa, la función excluye los valores
correspondientes. Consulte Expresiones de filtro.
FiltCode Integer Código que indica si deben etiquetarse los valores
filtrados:
• 1
Insertar la etiqueta Filtered en lugar de un
valor o un bloque de valores que la función ha
filtrado de la salida en función de FiltExp.
• 0
No etiquetar valores filtrados.
OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1 y
2.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.

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

Recupera datos de muestra para el PI point sinusoid procedentes del PI Server

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

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

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

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

Manual del usuario de PI DataLink 2014 131

Referencia de función

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

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

función calcula un valor. Consulte Campos de
entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la
función calcula un valor.
Interval Cadena El intervalo entre valores devueltos. Introduzca un
valor y la unidad temporal que especifica la
duración del intervalo. Por ejemplo, introduzca
15m (15 minutos) para devolver un valor por cada
intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de
tiempo.
OutCode Integer Código de salida que determina los datos añadidos
que devuelve la función y la forma en que la
función orienta la salida. Consulte Códigos de
salida para obtener información sobre cómo
calcular el código. Esta función admite los bits 1 y
2.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.

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

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

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

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

Sintaxis
PITimeDat(DataItem, TimeStamps, RootPath, Mode)

132 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
los que la función devuelve valores. Especifique un rango de
celdas que contengan nombres de PI point o nombres de
atributos de PI AF para devolver valores para cada uno de
ellos.
TimeStamps Referencia Referencia a una o varias hojas de cálculo que contienen
marcas de tiempo para las que la función devuelve valores.
Consulte Campos de entrada de tiempo.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos de datos.
Mode Cadena Método que la función utiliza para obtener datos:
• interpolado
• hora exacta

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

Ejemplo
=PITimeDat("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 PI Server predeterminado.
Esta función requiere una matriz de salida horizontal de doce celdas; por ejemplo, C1:C12 o
B14:B25.

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

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

Sintaxis
PITimeExpDat(Expression, TimeStamps, RootPath)

Manual del usuario de PI DataLink 2014 133

Referencia de función

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

TimeStamps Referencia Referencia a una o varias hojas de cálculo que

contienen marcas de tiempo para las que la
función devuelve valores. Consulte Campos de
entrada de tiempo.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos
de datos.

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

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

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

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

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

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

134 Manual del usuario de PI DataLink 2014

 Referencia de función

• PIAdvCalcExpFilDat()
• PITimeFilter()
• PITimeFilterVal()

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
los que la función calcula un valor. Especifique un rango de
celdas que contengan nombres de PI point o de atributos de
PI AF para calcular un valor para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la función calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
un valor.
Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media
CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código. Esta función admite los bits 2,
3 y 9 (si Mode se establece en mínimo, máximo o rango).
RootPath Cadena La ruta del elemento de datos. Consulte Elementos de datos.

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

Manual del usuario de PI DataLink 2014 135

Referencia de función

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

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

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
los que la función calcula un valor. Especifique un rango de
celdas que contengan nombres de PI point o de atributos de
PI AF para calcular un valor para cada uno de ellos.
STime Cadena El inicio del periodo de tiempo para el que la función calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
un valor.
FiltExp Cadena Ecuación de rendimiento booleana que la función utiliza para
filtrar valores. Cuando la expresión se evalúa como falsa, la
función excluye los valores correspondientes. Consulte
Expresiones de filtro.
Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media
CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
SampMode Cadena Método de muestreo que la función utiliza para determinar
cuándo evaluar el argumento FiltExp:
• comprimido
• interpolado

136 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

SampFreq Cadena Frecuencia con que la función evalúa el argumento FiltExp
si SampMode se define como interpolado. Introduzca un
valor y una unidad de tiempo. Por ejemplo, defina 10m (10
minutos) para devolver un valor interpolado por cada
intervalo de 10 minutos. Consulte Especificación de
intervalos de tiempo
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código. Esta función admite los bits 2,
3 y 9 (si Mode se establece en mínimo, máximo o rango).
RootPath Cadena La ruta del elemento de datos. Consulte Elementos de datos.

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

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

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

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

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

Manual del usuario de PI DataLink 2014 137

Referencia de función

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

STime Cadena El inicio del periodo de tiempo para el que la función calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
un valor.
Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media
CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
SampMode Cadena Método de muestreo que la función utiliza para determinar
cuándo evaluar el argumento Expression:
• comprimido
• interpolado
SampFreq Cadena Frecuencia con que la función evalúa el argumento
Expression si SampMode se define como interpolado.
Introduzca un valor y una unidad de tiempo. Por ejemplo,
defina 10m (10 minutos) para devolver un valor interpolado
por cada intervalo de 10 minutos. Consulte Especificación de
intervalos de tiempo
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código.
Esta función admite los bits 2, 3 y 9 (si Mode se establece en
mínimo, máximo o rango).

RootPath Cadena Ruta al elemento de datos al que hace referencia la expresión.

Consulte Elementos de datos.

138 Manual del usuario de PI DataLink 2014

 Referencia de función

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

Devuelve el total de tiempo ponderado para la expresión 'cdf144'+'cdt158' calculado a

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

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

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

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

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

STime Cadena El inicio del periodo de tiempo para el que la función calcula
un valor. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
un valor.
FiltExp Cadena Ecuación de rendimiento booleana que la función utiliza para
filtrar valores. Cuando la expresión se evalúa como falsa, la
función excluye los valores correspondientes. Consulte
Expresiones de filtro.
Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media

Manual del usuario de PI DataLink 2014 139

Referencia de función

Argumento Tipo Descripción

CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
SampMode Cadena Método de muestreo que la función utiliza para determinar
cuándo evaluar los argumentos Expression y FiltExp:
• comprimido
• interpolado
SampFreq Cadena Frecuencia con que la función evalúa los argumentos
Expression y FiltExp si SampMode se define como
interpolado. Introduzca un valor y una unidad de tiempo.
Por ejemplo, defina 10m (10 minutos) para devolver un valor
interpolado por cada intervalo de 10 minutos. Consulte
Especificación de intervalos de tiempo.
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código.
Esta función admite los bits 2, 3 y 9 (si Mode se establece en
mínimo, máximo o rango).

RootPath Cadena Ruta al elemento de datos al que hace referencia la expresión.

Consulte Elementos de datos.

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

Devuelve el total de tiempo ponderado para la expresión 'cdf144'+'cdt158' calculado a

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

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

140 Manual del usuario de PI DataLink 2014

 Referencia de función

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
los que la función calcula valores. Especifique un rango de
celdas que contengan nombres de PI point o nombres de
atributos de PI AF para calcular valores para cada uno de
ellos.
STime Cadena El inicio del periodo de tiempo para el que la función calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
valores.
Interval Cadena El intervalo entre valores devueltos. Introduzca un valor y la
unidad temporal que especifica la duración del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para devolver un valor
por cada intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de tiempo.
Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media
CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código.
Esta función admite los bits 2, 3, 7, 8 y 9 (si Mode se establece
en mínimo, máximo o rango).

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

Manual del usuario de PI DataLink 2014 141

Referencia de función

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

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

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

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el nombre del atributo de PI AF para
los que la función calcula valores. Especifique un rango de
celdas que contengan nombres de PI point o nombres de
atributos de PI AF para calcular valores para cada uno de
ellos.
STime Cadena El inicio del periodo de tiempo para el que la función calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
valores.
Interval Cadena El intervalo entre valores devueltos. Introduzca un valor y la
unidad temporal que especifica la duración del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para devolver un valor
por cada intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de tiempo.
FiltExp Cadena Ecuación de rendimiento booleana que la función utiliza para
filtrar valores. Cuando la expresión se evalúa como falsa, la
función excluye los valores correspondientes. Consulte
Expresiones de filtro.

142 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media
CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
SampMode Cadena Método de muestreo que la función utiliza para determinar
cuándo evaluar el argumento FiltExp:
• comprimido
• interpolado
SampFreq Cadena Frecuencia con que la función evalúa el argumento FiltExp
si SampMode se define como interpolado. Introduzca un
valor y una unidad de tiempo. Por ejemplo, defina 10m (10
minutos) para devolver un valor interpolado por cada
intervalo de 10 minutos. Consulte Especificación de
intervalos de tiempo
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código.
Esta función admite los bits 2, 3, 7, 8 y 9 (si Mode se establece
en mínimo, máximo o rango).

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

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

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

Manual del usuario de PI DataLink 2014 143

Referencia de función

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

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

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

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

STime Cadena El inicio del periodo de tiempo para el que la función calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
valores.
Interval Cadena El intervalo entre valores devueltos. Introduzca un valor y la
unidad temporal que especifica la duración del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para devolver un valor
por cada intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de tiempo.
Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media
CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
SampMode Cadena Método de muestreo que la función utiliza para determinar
cuándo evaluar el argumento Expression:
• comprimido
• interpolado

144 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

SampFreq Cadena Frecuencia con que la función evalúa el argumento
Expression si SampMode se define como interpolado.
Introduzca un valor y una unidad de tiempo. Por ejemplo,
defina 10m (10 minutos) para devolver un valor interpolado
por cada intervalo de 10 minutos. Consulte Especificación de
intervalos de tiempo
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código.
Esta función admite los bits 2, 3, 7, 8 y 9 (si Mode se establece
en mínimo, máximo o rango).

RootPath Cadena Ruta al elemento de datos al que hace referencia la expresión.

Consulte Elementos de datos.

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

Calcula la expresión 'cdf144'+'cdt158' con cualquier marca de tiempo entre la medianoche

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

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

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

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

Manual del usuario de PI DataLink 2014 145

Referencia de función

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

STime Cadena El inicio del periodo de tiempo para el que la función calcula
valores. Consulte Campos de entrada de tiempo.
ETime Cadena El final del periodo de tiempo para el que la función calcula
valores.
Interval Cadena El intervalo entre valores devueltos. Introduzca un valor y la
unidad temporal que especifica la duración del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para devolver un valor
por cada intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de tiempo.
FiltExp Cadena Ecuación de rendimiento booleana que la función utiliza para
filtrar valores. Cuando la expresión se evalúa como falsa, la
función excluye los valores correspondientes. Consulte
Expresiones de filtro.
Mode Cadena Tipo de cálculo que realiza la función:
• total
• mínimo
• máximo
• desviación estándar
• intervalo
• promedio
• recuento
• media
CalcBasis Cadena El método de cálculo:
• ponderado a tiempo
• ponderado a evento
SampMode Cadena Método de muestreo que la función utiliza para determinar
cuándo evaluar los argumentos Expression y FiltExp:
• comprimido
• interpolado
SampFreq Cadena Frecuencia con que la función evalúa los argumentos
Expression y FiltExp si SampMode se define como
interpolado. Introduzca un valor y una unidad de tiempo.
Por ejemplo, defina 10m (10 minutos) para devolver un valor
interpolado por cada intervalo de 10 minutos. Consulte
Especificación de intervalos de tiempo.
MinPctGood Número Porcentaje mínimo de datos correctos necesarios durante el
periodo de tiempo para calcular y devolver un valor.
CFactor Número Factor que la función aplica al valor devuelto. Introduzca 1 si
el factor de conversión no es necesario. Para los cálculos de
totales ponderados en el tiempo, especifique un factor que
convierta los valores de velocidad registrados a la unidad de
tiempo predeterminada del servidor (unidades por día).

146 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

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

RootPath Cadena Ruta al elemento de datos al que hace referencia la expresión.

Consulte Elementos de datos.

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

Calcula un total de tiempo ponderado para la expresión 'cdf144'+'cdt158' cuando

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

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

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

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

Argumentos
Argumento Tipo Descripción
Expression Cadena Ecuación de rendimiento booleana que la función evalúa.
Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
devolver valores para cada una de ellas.

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

Manual del usuario de PI DataLink 2014 147

Referencia de función

Argumento Tipo Descripción

Interval Cadena El intervalo entre valores devueltos. Introduzca un valor y la
unidad temporal que especifica la duración del intervalo. Por
ejemplo, introduzca 15m (15 minutos) para devolver un valor
por cada intervalo de 15 minutos durante el periodo de
tiempo. Consulte Especificación de intervalos de tiempo.
TimeUnit Cadena Unidad de tiempo del resultado calculado:
• segundos
• minutos
• horas
• días
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código.
Esta función admite los bits 2, 3, 7 y 8.

RootPath Cadena Ruta al elemento de datos al que hace referencia la expresión.

Consulte Elementos de datos.

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

Devuelve el número de segundos durante los cuales la expresión de la celda A1 es verdadera en

el PI Server denominado thevax en intervalos de 1 hora, comenzando en la medianoche de
ayer hasta la medianoche de hoy.
La función muestra la marca de tiempo del inicio de cada intervalo de cálculo a la izquierda del
valor.

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

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

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

Argumentos
Argumento Tipo Descripción
Expression Cadena Ecuación de rendimiento booleana que la función evalúa.
Consulte Expresiones.
Incluya un rango de celdas que contenga expresiones para
devolver valores para cada una de ellas.

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

148 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

ETime Cadena El final del periodo de tiempo para el que la función calcula
un valor.
TimeUnit Cadena Unidad de tiempo del resultado calculado:
• segundos
• minutos
• horas
• días
OutCode Integer Código de salida que determina los datos añadidos que
devuelve la función y la forma en que la función orienta la
salida. Consulte Códigos de salida para obtener información
sobre cómo calcular el código.
Esta función admite los bits 2 y 3.

RootPath Cadena Ruta al elemento de datos al que hace referencia la expresión.

Consulte Elementos de datos.

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

Devuelve el número de segundos durante los cuales la expresión de la celda A1 es verdadera en

el PI Server denominado thevax desde la medianoche de ayer hasta la medianoche de hoy.

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

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

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

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

Sintaxis
PIPointIDToTag(PointID, PIServer)

Argumentos
Argumento Tipo Descripción
PointID Cadena ID de PI point, el cual es un ID interno exclusivo que no se ha
vuelto a utilizar tras eliminar un punto.

Manual del usuario de PI DataLink 2014 149

Referencia de función

Argumento Tipo Descripción

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

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

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

Consulte también
Función Apuntar ID al Tag

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

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

Argumentos
Argumento Tipo Descripción
TagName Cadena Nombre de los puntos devueltos.1
Descriptor Cadena Descriptor de los puntos devueltos.1
PointSource Cadena Origen de punto de los puntos devueltos.1
PointType Cadena Tipo de punto de los puntos devueltos.1
PointClass Cadena Clase de punto de los puntos devueltos.1
EngUnits Cadena Unidades de ingeniería de los puntos devueltos.1
OutCode Integer Código de salida que determina la forma en que la función
orienta la salida:
• 0
Escribir valores en una columna.
• 2
Escribir valores en una fila.
PIServer Cadena El PI Server cuyos datos devuelve la función. Si no selecciona
un servidor o deja este campo en blanco, la función buscará el
PI Server predeterminado.
1 Utilice el carácter comodín (*) para encontrar todas las coincidencias o las coincidencias limitadas a

determinados caracteres.

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

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

150 Manual del usuario de PI DataLink 2014

 Referencia de función

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

Funciones de Module Database

En esta sección
• PIAliasToTag()
• PIPropertyToValue()

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

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

Argumentos
Argumento Tipo Descripción
Alias Cadena El alias de la base de datos de módulo correspondiente al PI
point para devolver.
ModulePath Cadena Ruta de módulo completa del alias.
QueryDate Integer Fecha efectiva del alias. La función devuelve el nombre del
punto correspondiente al alias especificado en esa fecha.
OutCode Integer Código de salida que determina si se añadirá el nombre del
servidor al resultado:
• 0
Devuelve solo el nombre del punto.
• 1
Devuelve el PI Server que almacena el punto en la celda a
la derecha del nombre del punto.
• 2
Devuelve el PI Server que almacena el punto en la celda
debajo del nombre del punto.
PIServer Cadena El PI Server cuyos datos devuelve la función. Si no selecciona
un servidor o deja este campo en blanco, la función buscará el
PI Server predeterminado.

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

La siguiente función devuelve el PI point correspondiente al alias Temperature del módulo

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

Consulte también
Función Alias para tag

Manual del usuario de PI DataLink 2014 151

Referencia de función

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

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

Argumentos
Argumento Tipo Descripción
Propiedad Cadena La propiedad de base de datos de módulo correspondiente al
PI point para el que la función recupera valores.
ModulePath Cadena Ruta de módulo completa de la propiedad.
QueryDate Integer Fecha efectiva del valor de la propiedad de PI. la función
devuelve los valores correspondientes a la propiedad
especificada en esa fecha.
PIServer Cadena El PI Server cuyos datos devuelve la función. Si no selecciona
un servidor o deja este campo en blanco, la función buscará el
PI Server predeterminado.
OutCode Integer Código de salida que determina la forma en que se orientará
el resultado:
• 0
Devuelve valores en una columna.
• 2
Devuelve valores en una fila.

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

Devuelve el valor correspondiente a la propiedad Implementer del módulo Reactor1, que es

un submódulo de Unit1. Unit1 está en la raíz de la base de datos de módulo de un PI Server
denominado thevax. La base de datos de módulo se consulta a la hora actual.

Consulte también
Función Propiedad para valor

Funciones de entrada

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

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

Argumentos
Argumento Tipo Descripción
DataItem Cadena El nombre del PI point o el atributo de PI AF para que la
función escribe un valor.

152 Manual del usuario de PI DataLink 2014

 Referencia de función

Argumento Tipo Descripción

Valor Referencia Referencia a la celda que contiene el valor que se va a
escribir, ya sea una cadena o un número.
TimeStamp Cadena La marca de tiempo del valor. Consulte Campos de entrada de
tiempo.
RootPath Cadena La ruta del elemento de datos. Consulte Elementos de datos.
OutCell Referencia Referencia a la celda en la que PI DataLink escribe la cadena
que la función macro devuelve. La cadena devuelta varía:
• Si la escritura es correcta:
◦ La función PIPutVal devuelve xxx Written , donde
xxx es Real Value, Integer, Digital State o
Value, en función del tipo de valor escrito.
◦ La función PIPutValX devuelve Value Written.
• Si la escritura falla, la función devuelve un código de error,
como [-5] Tag not found por ejemplo.

Notas
Las funciones PIPutVal y PIPutValX no pueden escribir en atributos de PI AF que sean
atributos de configuración. Estas funciones sólo pueden escribir en un atributo PI AF para el
que no esté seleccionada la casilla Elemento de configuración. Puede comprobar el estado de la
casilla en la pestaña Atributos de PI System Explorer.
Las funciones PIPutVal y PIPutValX admiten todos los tipos de datos de PI Server. Las
funciones interpretan las marcas de tiempo utilizando la información de la zona horaria del
ordenador cliente de PI Server a menos que se haya activado la opción Utilizar zona horaria de
PI Server.
Las funciones no verifican el intervalo especificado por el usuario para un punto antes de
escribir el valor. El intervalo se define desde zero a zero + span, donde zero y span son atributos
de punto especificados durante la creación del punto. La función devuelve una cadena Value
Written aunque Over Range o Under Range estén almacenados en PI Server.

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

Escribe el valor localizado en la celda A5 del archivo de PI Server en el PI Server

predeterminado testtag con la marca de tiempo de la medianoche de hoy. La función escribe
el resultado de la función de macros en la celda E5 de la hoja de cálculo.

Manual del usuario de PI DataLink 2014 153

Referencia de función

154 Manual del usuario de PI DataLink 2014

Resolución de problemas
Consulte los temas incluidos en esta sección si tiene alguna dificultad con el uso de PIDataLink.
Si estos temas no explican o resuelven el problema, consulte Soporte técnico y otros recursos
para obtener más detalles sobre cómo ponerse en contacto con el Servicio de asistencia técnica.

En esta sección
• Archivos de registro
• La pestaña PI DataLink no está disponible
• Límites de matriz y de celda
• Límites de recuperación de datos
• Elemento de datos no admitido por función
• Existe un evento duplicado
• Seguridad
• Problemas de conexión de PI Server
• Eliminar error de excepción de tiempo de espera
• Los datos no se actualizan

Archivos de registro
PI DataLink no genera un archivo de registro genérico. Puede utilizar los mensajes de error de
las hojas de cálculo para diagnosticar problemas. Sin embargo, algunos procesos específicos no
generan archivos de registro:
• Instalación
El directorio ../pipc/dat contiene los archivos de registro de instalación
SetupPIDataLink_x64.log y SetupPIDataLink_x86.log.
• Conectividad de PI Server
Examine el archivo de registro de PI Server en PI SMT para detectar problemas de
conectividad de PI Server.

La pestaña PI DataLink no está disponible

Si la pestaña PI DataLink no aparece después de instalar PI DataLink, es posible que necesite
configurar de forma manual el complemento para Excel (consulte Configuración del
complemento para Microsoft Excel) o reducir los parámetros de seguridad para los
complementos (consulte Seguridad).
Algunas secuencias VBA escritas por el usuario en las hojas de cálculo (o complementos) de
Excel restablecen la cinta principal de Excel. En estos casos, la pestaña PI DataLink puede
desaparecer aunque el complemento de PI DataLink esté todavía cargado y las funciones de PI
DataLink integradas pueden funcionar aunque la pestaña PI DataLink no esté disponible.
Reiniciar Excel suele corregir este problema.

Manual del usuario de PI DataLink 2014 155

Resolución de problemas

Límites de matriz y de celda

PI DataLink está sujeto a una limitación de Excel en el número de elementos de la matriz de
cálculos. Una única función de PI DataLink puede devolver como máximo 1.048.576 valores por
recuperación.
El SDK de Excel utilizado por PI DataLink limita las cadenas a 255 caracteres de longitud. Las
cadenas de entrada para expresiones de PI DataLink en una celda referenciada no pueden
exceder este límite de 255 caracteres.
Del mismo modo, PI DataLink puede truncar la salida de cadena, como los nombres de los PI
points, a 255 caracteres.

Límites de recuperación de datos

El código de error -11091 indica que una consulta única iniciada por una función de PI
DataLink ha intentado recuperar más valores registrados de PI Server de los que permite el
parámetro de ajuste ArcMaxCollect.
Dado que este límite se aplica a los valores registrados recuperados del archivo de PI Server,
incluso las funciones que devuelven un número menor de valores pueden superar el límite
establecido por este parámetro de ajuste. Por ejemplo, el valor del PI point sinusoid varía
constantemente entre 0 y 100. Puede crear una función que devuelva valores de muestra de
sinusoid cada 30 segundos a lo largo de un año con un filtro para excluir los valores
inferiores a 95. Esta función podría devolver un número relativamente pequeño de valores,
pero recuperará muchos más valores registrados de los archivos para procesar la consulta.
Si recibe este error, plantéese modificar los criterios de búsqueda para reducir los datos
recuperados. Por ejemplo, podría reducir el periodo de tiempo a lo largo del cual la función
recuperará datos.

Elemento de datos no admitido por función

El mensaje Data item not supported by function puede indicar lo siguiente:
• Un atributo de PI AF utiliza una referencia de datos personalizada que no permite los
cálculos. Para utilizarlo en PI DataLink, modifique el código de referencia de datos
personalizado para que permita el uso de métodos de acceso a datos. Esta desactivado de
forma predeterminada.
• La función Datos calculados ha intentado realizar un cálculo de resumen en un atributo de
PI AF de tipo PI Point Array.

Existe un evento duplicado

El mensaje devuelto Duplicate event exists: specify index for EventName indica
que el evento principal de esta fila de la hoja de cálculo contiene más de un evento secundario
con el nombre EventName. Para resolverlo, cambie la especificación de la función Comparar
eventos para utilizar una versión indexada del evento para el atributo visualizado en esta
columna.
Cuando un evento principal tiene eventos secundarios con nombres duplicados, PI DataLink
añade automáticamente un índice al nombre del evento secundario en la ventana Añadir
atributos. Si otros eventos del mismo nivel no tienen nombres duplicados, no tendrán el índice.

156 Manual del usuario de PI DataLink 2014

 Resolución de problemas

Para obtener más información, consulte Añadir atributos de eventos secundarios como
columnas en el panel de tareas Comparar eventos.

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 parámetros
de seguridad proporcionan los medios para desactivar, activar bajo demanda o activar
completamente estos tipos de objetos.
Los parámetros de seguridad de Excel pueden entrar en conflicto con algunas funciones de PI
DataLink:
• PI DataLink es un complemento para Excel. La configuración 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
inicialización y requieren que se activen los controles ActiveX.
• Las hojas de cálculo que contienen una función PIPutVal() o PIPutValX () utilizan
macros y requieren que estén activadas (consulte PIPutVal() y PIPutValX()).
Si aplica con regularidad la seguridad de Excel a las hojas de cálculo, o encuentra problemas
utilizando estas funciones de PI DataLink, deberá reducir o eliminar la configuración de
seguridad de Excel dependiendo de cómo prevea utilizar PI DataLink.
Para más información sobre la seguridad de Excel, consulte los recursos y la ayuda en línea de
Microsoft Excel.

Problemas de conexión de PI Server

Esta versión de Problemas de conexión utiliza parámetros de seguridad más estrictos para
conectarse a PI Server. Esta nueva configuración reduce la exposición a problemas de
seguridad asociados con la autenticación de contraseñas en PI. Consulte el boletín de asistencia
técnica, Security Alert: PI Authentication Weakness ([Link]
Troubleshooting/Alerts/AL00206), para obtener más información.
Los nuevos parámetros de seguridad pueden producir errores si PI DataLink utiliza:
• Nombres de usuario y contraseñas de PI para conectarse a PI Server
• El usuario predeterminado para conectarse a PI Server
De manera específica, estos parámetros podrían generar el error -10407 "No Access -
Secure Object" con información sobre privilegios insuficientes para acceder a PI Server. La
configuración también podría generar un mensaje sobre una solicitud de inicio de sesión
explícita desactivada.
Para resolver estos errores, puede:
• Configurar PI mappings para usuarios que se conecten a PI Server.
OSIsoft recomienda este enfoque (disponible en la versión 3.4.380 de PI Server y
posteriores). Este es el método de conexión más seguro. Consulte el manual Configuring PI
Server Security para obtener información sobre la creación de PI mappings. Para utilizar PI
mappings, deberá activar también el protocolo de autenticación de Windows Security en
cada ordenador en el que se ejecute PI DataLink.
• Configurar PI trusts para usuarios que se conecten a PI Server.

Manual del usuario de PI DataLink 2014 157

Resolución de problemas

Este es el segundo mejor enfoque. Consulte el manual Configuring PI Server Security para
obtener información sobre la creación de PI trusts. Para utilizar PI trusts, deberá activar
también el protocolo de autenticación de PI Trust en cada ordenador en el que se ejecute PI
DataLink.
• Configurar cada ordenador para permitir una solicitud de inicio de sesión explícita cuando
no estén disponibles una PI mapping o un PI trust.
OSIsoft no recomienda este enfoque. Los inicios de sesión explícitos no son seguros.
Nota:
La introducción de una contraseña incorrecta en una solicitud de inicio de sesión puede
generar el mismo mensaje de error.

En esta sección
• Configurar un ordenador para permitir solicitudes de inicio de sesión explícitas
• Activar un protocolo de autenticación

Configurar un ordenador para permitir solicitudes de inicio de sesión

explícitas
Para conectarse a PI Server a través de un inicio de sesión como usuario de PI, utilice PI SDK
Utility para permitir solicitudes de inicio de sesión explícitas en su ordenador. Deberá
configurar cada ordenador desde el que se conecte a PI Server iniciando sesión como usuario
de PI.
PRECAUCIÓN:
OSIsoft recomienda utilizar un método alternativo más seguro para conectarse a PI
Server.

Procedimiento
1. 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 PI Servers disponibles y actualizar los
menús de utilidades.
3. Haga clic en Conexiones > Opciones para abrir la ventana Opciones de conexión.
4. Seleccione la casilla Solicitar inicio de sesión (si fallan protocolos configurados).
5. Haga clic en Aceptar.

Resultados
Se le solicitará el nombre de usuario y la contraseña cada vez que inicie una conexión nueva a
PI Server.

Activar un protocolo de autenticación

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

158 Manual del usuario de PI DataLink 2014

 Resolución de problemas

Procedimiento
1. 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 PI Servers disponibles y actualizar los
menús de utilidades.
3. Haga clic en Conexiones > Opciones para abrir la ventana Opciones de conexión.
4. En Especificar procedimiento de autenticación, utilice las teclas de fecha para mover y
ordenar los protocolos activados en Orden de protocolos. Liste los protocolos necesarios:
◦ Para utilizar PI mappings, Windows Security debe estar en la lista. Debe ser el primer
protocolo en la lista Orden de protocolos.
◦ Para utilizar PI trusts, PI Trust debe estar en la lista.
5. Haga clic en Aceptar.

Eliminar error de excepción de tiempo de espera

Las búsquedas de PI Servers con bases de datos de puntos grandes podría alcanzar el tiempo
de espera para datos antes de que PI Server haya devuelto todos los resultados. En este caso,
recibirá el siguiente error:
[Link]: [-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.

Procedimiento
1. En la pestaña PI DataLink, en el grupo Recursos, haga clic en Configuración para abrir el
cuadro de diálogo Configuración.
2. Haga clic en Gestor de conexiones para abrir el cuadro de diálogo Servidores.
3. Haga clic con el botón derecho en el PI Server que ha devuelto el error y, a continuación,
haga clic en Propiedades para abrir el cuadro de diálogo Propiedades de PI Server.
4. Incremente el valor del campo Tiempo de espera de datos y, a continuación, haga clic en
Aceptar.

Los datos no se actualizan

PI DataLink almacena en caché los datos de configuración de los PI points y los datos no
basados en el tiempo de PI AF (es decir, los datos que no son eventos y referencias de datos de
PI point). Como resultado, los datos insertados en hojas de cálculo podrían no actualizarse para
mostrar los valores modificados, aunque recalcule la función. Para ver los valores actualizados,
cierre Microsoft Excel y vuelva a abrirlo.

Manual del usuario de PI DataLink 2014 159

Resolución de problemas

160 Manual del usuario de PI DataLink 2014

Soporte técnico y otros recursos
Para obtener asistencia técnica, póngase en contacto con el soporte técnico de OSIsoft
llamando al +1 510-297-5828 o visitando el sitio web de asistencia técnica de OSIsoft (https://
[Link]). El sitio web ofrece opciones de contacto adicionales para los clientes
que están fuera de Estados Unidos.
Cuando se ponga en contacto con el soporte técnico de OSIsoft, tenga a mano la siguiente
información:

• Nombre del producto, versión y números de versión

• Detalles sobre la plataforma del equipo (tipo de CPU, sistema operativo y número de
versión)
• Hora a la que se inició el problema
• Archivos de registro en ese instante concreto
• 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
El sitio web de OSIsoft Virtual Campus (vCampus) ([Link] ofrece
recursos basados en suscripción para ayudarle en todo lo relativo a la programación e
integración de productos de OSIsoft.

Manual del usuario de PI DataLink 2014 161

Soporte técnico y otros recursos

162 Manual del usuario de PI DataLink 2014