Notificações - PI DataLink 2013 Guia do Usuário

Pesquisar e inserir notificações

Use a janela Pesquisar Notificação para pesquisar notificações que você subscreveu em um determinado PI AF Server e então inseri-la na planilha. O PI AF Server contém um banco de dados de elementos estruturais e eventos de notificação que ajudam você a trabalhar com dados no seu PI Server.

Procedimento

1. Na guia PI DataLink, no grupo Notificações, clique em Pesquisar Notificação para abrir a janela Pesquisar Notificação.

2. na guia Pesquisar, selecione o PI AF Server onde você pesquisará notificações:

ο Da list PI Systems, selecione um PI AF Server e clique em Conectar para conectar a esse servidor.

Se necessário clique em Mostrar Lista para abrir a janela AF Servers, onde você pode adicionar um PI AF Server (página 91) à lista.

ο Clique e então clique em uma célula de planilha que contenha o nome de um PI AF Server.

Clique novamente no botão para mostrar a lista de PI Systems.

3. Na lista Ver Notificações, selecione a opção para filtrar as notificações retornadas:

ο Selecione Ativa para retornar todas as notificações que estão atualmente ativas.

ο Selecione Intervalo de Tempo e entre valores de Hora Inicial e Hora Final para retornar notificações que ocorreram em um intervalo específico de tempo.

ο Selecione Recente e entre um valor e um intervalo de tempo para retornar a notificação mais recente em um intervalo de tempo específico.

Pesquisar e inserir notificações

PI DataLink 2013 Guia do Usuário 91

4. No campo Célula de Sáida, especifique a célula de planilha onde você deseja inserir as notificações.

5. Clique em Pesquisar para recuperar as notificações que correspondem aos critérios especificados na área de resultados na parte de baixo da guia.

6. Examine as notificações recuperadas. Você pode:

ο Ajustar a exibição das notificações recuperadas (página 92) ο Gerenciar as notificações recuperadas (página 92)

7. Clique OK para inserir os itens exibidos na planilha e fechar a janela.

O PI DataLink insere a consulta de notificação na planilha como uma matriz de funções no local indicado. Assim como outras funções do PI DataLink, a função Perquisar Notificação atualiza os dados quando a planilha recalcula (página 58).

Adiionar um PI AF Server à função Pesquisar Notificação

Seu PI System pode ter múltiplos PI AF Servers, cada um dos quais pode ter instalado o PI Notifications e ser uma fonte de notificações relevantes. por exemplo, você pode subscrever notificações dos PI AF Server que são executados em diferentes fábricas ou representam diferentes unidades de negócio.

Antes que você possa ver as notificações de um determinado PI AF Server no Excel, você deve adicionar esse PI AF Server à lista de PI Systems que a função Pesquisar Notificação mantém.

Antes de iniciar

Subscreva notificações no PI System Explorer.

Procedimento

1. Na guia Pesquisar da janela Pesquisar Notificação, clique em Mostrar Lista próximo da lista PI Systems para abrir a janela AF Servers.

3. Entre as informações de rede relevantes para localizar o PI AF Server e autenticar seu computador naquele servidor.

ο No campo Nome, entre o nome que irá identificar o PI AF Server na função Perquisar Notificações.

ο Clique Configurar Active Directory para configurar o acesso ao Active Directory para coletar informações de login.

4. Clique OK para salvar as propriedades e adicionar à lista de PI AF Servers. 5. Clique em OK para fechar a janela AF Servers.

O PI AF Server aparecerá na lista PI Systems.

Para informações adicionais sobre PI AF Servers, consulte a documentação do PI AF.

Ajustar a exibição das notificações recuperadas

Na janela Pesquisar Notificação, a área de resultados na parte inferior da guia Pesquisar mostra as notificações que correspondem ao critério de pesquisa especificado. Você pode ajustar a exibição dessas notificações.

Procedimento

• Clique em um cabeçalho de coluna para classificar as notificações por um atributo particular.

• Clique com o botão da direita nos resultados para mostrar e esconder colunas.

ο Clique em Expandir Tudo ou em Recolher Tudo para expandir ou recolher um agrupamento de notificações.

ο Clique em Mostrar Eventos de Contato para alternar a exibição de eventos de contato para cada notificação.

Gerenciar as notificações recuperadas

Na janela Pesquisar Notificação, a área de resultados na parte inferior da guia Pesquisar mostra as notificações que correspondem ao critério de pesquisa especificado. Antes de inserir as notificações recuperadas na sua planilha, você pode avaliar, gerenciar e responder a essas notificações.

Procedimento

Clique com o botão direito em uma notificação e escolha um comando:

• Reconhecer Instância

Reconhece que uma ação foi tomada em relação à notificação e que não é necessário escalamento adicional. Se desejado, entre um comentário e clique em OK.

Notificações inseridas

PI DataLink 2013 Guia do Usuário 93

• Reconhecer Subscrição

Reconheça o recebimento de uma notificação que você subscreveu. Se desejado, entre um comentário e clique em OK.

• Adicionar Comentário Comente uma notificação.

• Ver Sumário da Regra de Notificação

Exibe as propriedades da regra de notificação que disparou a notificação selecionada.

Notificações inseridas

As funções do PI DataLink podem referenciar dados de notificações em células de planilhas. Por exemplo, você pode usar o valor da Hora Inicial de uma notificação recuperada para recuperar dados amostrados que indicam o progresso de um processo em lotes.

Se suas notificações estão configuradas para exibir reconhecimentos, essas colunas incluem atalhos para páginas web PI Notifications onde você pode reconhecer ou comentar a respeito de uma notificação.

Para informações adicionais sobre notificações, subscrições e reconhecimentos, veja o PI Notifications User Guide.

Configurações de exibição de notificações

Use a guia Formato de Exibição na janela Pesquisar Notificação para especificar a

aparência das notificações inseridas nas células da planilha. Você pode selecionar as colunas a serem exibidas e mudas sua organização e formato.

Colunas

• Selecione colunas na lista Colunas disponíveis e clique em Adicionar para movê-las para a lista Ordem das colunas, que especifica os dados inseridos na planilha.

Observação: Inclua a coluna Reconhecimento para adicionar um atalho na

planilha para reconhecer o recebimento de uma notificação, e inclua a coluna

Reconhecimento com comentários para adicionar um atalho na planilha

para comentar uma notificação.

• Clique Adicionar Tudo para mover todas as colunas para a lista Ordem das colunas.

• Selecione colunas da lista Ordem das colunas e clique os botões de seta acima da lista para mudar a ordem das colunas.

• Selecione coluas da lista Ordem das colunas e clique Remover para remover as colunas selecionadas da lista.

Configurações de exibição de notificações

PI DataLink 2013 Guia do Usuário 95

Eventos de contato

• Selecione a caixa de verificação Exibir eventos de contato para incluir eventos de contato relacionados com cada notificação, como enviando para cada recebedor, comentários e reconhecimentos.

• Selecione a caixa de verificação Deslocar contatos para deslocar os eventos de contato na planilha. Isso ajudará você a identificá-los.

ο Selecione Usando colunas separadas para adicionar uma segunda coluna para os eventos de contato.

ο Selecione Formatando células para deslocar os eventos de contato na mesma coluna dos eventos de notificação.

• Selecione a caixa de verificação Agrupar notificações com o agrupamento do Excel para usar o recurso de agrupamento do Excel para aninhar eventos de contato abaixo da notificação-pai individual que os causou.

Observação: O PI DataLink Server (página 2) não suporta o agrupamento do Excel.

Exibição e orientação

• Selecione a caixa de verificação Exibir cabeçalhos de colunas para adicionar cabeçalhos aos dados de notificações.

• Selecione a caixa de verificação Exibir contagem para adicionar uma linha ou coluna que contenha a contagem de notificações antes dos dados das notificações.

• Abaixo de Orientar resultados em, selecione Colunas para exibir os dados de notificações em colunas ou selecione Linhas para exibir os dados de notificações em linhas.

PI DataLink 2013 Guia do Usuário 97

Você pode gerar funções PI DataLink a partir dos painéis de tarefas (página 13) do PI DataLink. A matriz de funções resultante dependerá das entradas. Você pode também entrar com essas funções diretamente (página 68) na barra de fórmulas do Excel.

Essa seção contém uma referência para as funções suportadas pelo PI DataLink. Cada topico descreve a sintaxe e os argumentos da função; a maioria dos tópicos também inclui um exemplo. As seções a seguir agrupam as funções por tipo.

Funções de valores únicos

Funções de valores únicos recuperam o valor de um item de dados em um horário estabelecido. Elas retornam exatamente um valor por item de dados.

PICurrVal()

Retorna o valor atual de um ponto do PI de um instantâneo ou um atributo PI AF de um banco de dados.

SINTAXE

PICurrVal(DataItem, OutCode, RootPath)

ARGUMENTOS

Argumento Descrição

DataItem

(string) O nome do ponto do PI ou do atributo do PI AF para o qual a função _{retorna um valor. Referencie um intervalo de células que contém nomes} de pontos do PI ou de atributos do PI AF para os quais serão

retornados valores. OutCode

(integer) Um código de saída que determina que dados adicionais a função _{retornará e como a função orienta a saída. Veja Códigos de Saída} (página 69) para informações sobre como calcular o código. Essa função suporta bits 1 e 2.

RootPath

(string) O caminho para o item de dados Veja Itens de dados (página 14).

Anexo A

A função seguinte retorna o valor atual e horário correspondente para o ponto do PI let439 do PI Server chamado holden e coloca o horário na coluna à esquerda do valor:

=PICurrVal("let439",1,"holden") TÓPICOS RELACIONADOS

• Função Valor Atual (página 31)

• Definir funções manualmente (página 68)

• Orientações para entrada manual de argumentos (página 68)

PIArcVal()

Retorna o valor de um ponto do PI ou atributo do PI AF em um horário especificado.

SINTAXE

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

ARGUMENTOS

Argumento Descrição

DataItem (string) O nome do ponto do PI ou do atributo do PI AF para o qual a função retorna um valor. Referencie um intervalo de células que contém nomes de pontos do PI ou de atributos do PI AF para os quais serão retornados valores.

TimeStamp (string) O horário para o qual a função retorna valores. Veja Entrada de

tempo (página 16).

OutCode (integer) Um código de saída que determina que dados adicionais a função retornará e como a função orienta a saída. Veja Códigos de Saída (página 69) para informações sobre como calcular o código. Essa função suporta bits 1 e 2.

RootPath (string) O caminho para o item de dados Veja Itens de dados (página 14). Mode (string) O método usado pela função para recuperar os valores:

previous somente anterior interpolado auto próximo somente próximo horário exato EXEMPLO

A função seguinte retorna o valor interpolado do ponto do PI cdep158 às 19:20 de 11 de Dezembro de 1992 do PI Server chamado casaba:

Funções de valores únicos

PI DataLink 2013 Guia do Usuário 99

TÓPICOS RELACIONADOS

• Função Valor de Arquivo (página 32) • Definir funções manualmente (página 68)

• Orientações para entrada manual de argumentos (página 68)

PIExpVal()

Retorna o valor calculado de uma Performance Equation em um horário especificado.

SINTAXE

PIExpVal(Expression, TimeStamp, OutCode, RootPath)

ARGUMENTOS

Argumento Descrição

Expression (string) Uma ou mais Performance Equations para as quais a função calcula um valor. Veja Expressões (página 65).

Referencie um intervalo de células que contém expressões para as quais serão retornados valores.

TimeStamp (string) O horário para o qual a função retorna valores. Veja Entrada de

tempo (página 16).

OutCode (string) Um código de saída que determina que dados adicionais a função retornará e como a função orienta a saída. Veja Códigos

de Saída (página 69) para informações sobre como calcular o

código. Essa função suporta bits 1 e 2.

RootPath (string) O caminho para o item de dados referenciado pela expressão. Veja Itens de dados (página 14).

EXEMPLO

A função seguinte calcula a raiz quadrada do valor do ponto do PI sinusoid de um PI Server chamado thevax à meia-noite de ontem:

=PIExpVal("sqr('sinusoid')","y",0,"thevax") TÓPICOS RELACIONADOS

• Função Valor de Arquivo (página 32) • Definir funções manualmente (página 68)

100

PITagAtt()

Retorna o valor de uma propriedade associada com um item de dados especificado.

SINTAXE

PITagAtt(DataItem, Property, RootPath)

ARGUMENTOS

Argumento Descrição

Property (string) O nome do ponto do PI ou do atributo do PI AF para o qual a função retorna um valor.

RootPath (string) O caminho para o item de dados Veja Itens de dados (página 14). EXEMPLO

A função seguinte retorna as unidades de engenharia para o ponto do PI especificado na célula D1 do PI Server padrão:

=PITagAtt(d1,"uom",) TÓPICOS RELACIONADOS

• Função Propriedades (página 51)

Funções de valores múltiplos

Funções de valores múltiplos associam um ponto do PI ou atributo do PI AF com um período de tempo durante o qual podem haver um ou mais valores correspondentes.

Funções de valores múltiplos

PI DataLink 2013 Guia do Usuário 101

PINCompDat()

Retorna um número específico de valores de pontos do PI ou valores de atributos do PI AF começando em um horário determinado.

SINTAXE

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

ARGUMENTOS

Argumento Descrição

DataItem (string) O nome do ponto do PI ou do atributo do PI AF para o qual a função retorna valores. Referencie um intervalo de células que contém nomes de pontos do PI ou de atributos do PI AF para os quais serão retornados valores.

STime (string) O início do período de tempo para o qual a função retorna valores. Veja Entrada de tempo (página 16).

NumVals (integer) O número de valores que a função retorna, começando em STime (especifique um número negativo para recuperar valores

anteriores no tempo).

RootPath (string) O caminho para o item de dados Veja Itens de dados (página 14). Mode (string) O método usado pela função para determinar quais valores serão

recuperados próximo da hora inicial (tipo de limite): inside

fora

interpolado auto

EXEMPLO

A função seguinte retorna dez valores e horários correspondentes do PI Server padrão para o ponto do PI cdf144 começando à 01:00 hora dessa manhã, usando o tipo de limite "inside":

=PINCompDat("cdf144","1:00:00",10,1,,"inside") TÓPICOS RELACIONADOS

• Função Dados Compactados (página 35) • Definir funções manualmente (página 68)

102

Retorna um número específico de valores de pontos do PI ou valores de atributos do PI AF, filtrados, começando em um horário determinado.

SINTAXE

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

ARGUMENTOS

Argumento Descrição

STime (string) O início do período de tempo para o qual a função retorna valores. Veja Entrada de tempo (página 16).

NumVals (integer) O número de valores que a função retorna, começando em STime (especifique um número negativo para recuperar valores anteriores no tempo).

FiltExp (string) Uma Performance Equation lógica usada pela função para filtrar valores. Quando o resultado da expressão é falso, a função exclui os valores correspondentes. Veja Expressões de filtro (página 67). FiltCode (integer) Um código que indica como rotular os valores filtrados:

Insere o rótulo Filtrado em lugar de um valor ou um bloco de valores que a função filtrou da saída com base em FiltExp. 0

Não rotule os valores filtrados.

RootPath (string) O caminho para o item de dados Veja Itens de dados (página 14). Mode (string) O método usado pela função para determinar quais valores serão

recuperados próximo da hora inicial (tipo de limite): inside

fora

interpolado auto

Funções de valores múltiplos

PI DataLink 2013 Guia do Usuário 103

Exemplo

A função seguinte retorna dez valores e horários correspondentes do PI Server padrão para o ponto do PI cdf144 começando às 02:00 dessa manhã, quando o tag cdep158 for maior que 38, usando o tipo de limite "inside":

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

A saída conterá o rótulo Filtrado entre os valores onde a condição de filtragem for falsa.

TÓPICOS RELACIONADOS

• Função Dados Compactados (página 35) • Expressões de Filtro (página 67)

• Definir funções manualmente (página 68)

• Orientações para entrada manual de argumentos (página 68)

PICompDat()

Retorna valores de pontos do PI ou atributos do PI AF armazenados durante um período especificado de tempo.

SINTAXE

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

ARGUMENTOS

Argumento Descrição

STime (string) O início do período de tempo para o qual a função retorna valores. Veja Entrada de tempo (página 16).

ETime (string) O final do período de tempo para o qual a função retorna valores.

OutCode (integer) Um código de saída que determina que dados adicionais a função retornará e como a função orienta a saída. Veja Códigos

de Saída (página 69) para informações sobre como calcular o

código. Essa função suporta bits 1, 2, 4, 5 e 6.

RootPath (string) O caminho para o item de dados Veja Itens de dados (página 14).

Mode (string) O método que a função usa para determinar quais valores serão recuperados próximo do STime ou ETime (tipo de limite): inside

fora

interpolado auto

104

A função seguinte retorna valores e horários correspondentes do PI Server padrão para o ponto do PI cdf144 de 01:00 às 03:00 dessa manhã usando o tipo de limite "inside":

=PICompDat("cdf144","1:00:00","3:00:00",1,,"inside") TÓPICOS RELACIONADOS

• Função Dados Compactados (página 35) • Definir funções manualmente (página 68)

• Orientações para entrada manual de argumentos (página 68)

PICompFilDat()

Retorna valores de pontos do PI ou atributos do PI AF, filtrados, armazenados durante um período especificado de tempo.

SINTAXE

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

ARGUMENTOS

Argumento Descrição

STime (string) O início do período de tempo para o qual a função retorna valores. Veja Entrada de tempo (página 16).

ETime (string) O final do período de tempo para o qual a função retorna valores. FiltExp (string) Uma Performance Equation lógica usada pela função para filtrar

valores. Quando o resultado da expressão é falso, a função exclui os valores correspondentes. Veja Expressões de filtro (página 67). FiltCode

(integer) Um código que indica como rotular os valores filtrados: 1

Insere o rótulo Filtrado em lugar de um valor ou um bloco de valores que a função filtrou da saída com base em FiltExp. 0

Não rotule os valores filtrados.

Funções de valores múltiplos

PI DataLink 2013 Guia do Usuário 105

Argumento Descrição

Mode (string) O método que a função usa para determinar quais valores serão recuperados próximo do STime ou ETime (tipo de limite): inside

fora

interpolado auto

EXEMPLO

A função seguinte retorna valores e horários correspondentes do PI Server padrão para o ponto do PI cdf144 começando às 02:00 e terminando às 10:00 dessa manhã, quando o tag cdep158 for maior que 38, usando o tipo de limite "inside":

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

A saída conterá o rótulo Filtrado entre os valores onde a condição de filtragem for falsa.

TÓPICOS RELACIONADOS

• Função Dados Compactados (página 35) • Expressões de Filtro (página 67)

• Definir funções manualmente (página 68)

• Orientações para entrada manual de argumentos (página 68)

PISampDat()

Retorna valores interpolados, espaçados regularmente, para um ponto do PI ou atributo do PI

No documento PI DataLink 2013 Guia do Usuário (páginas 93-146)