Guia do usuário do PI DataLink. Versão 2010

Transcrição

1 Guia do usuário do PI DataLink Versão 2010

2 OSIsoft, LLC 777 Davis St., Suite 250 San Leandro, CA EUA Tel: (01) Fax: (01) Web: OSIsoft Australia Perth, Austrália OSIsoft Europe GmbH Frankfurt, Alemanha OSIsoft Asia Pte Ltd. Cingapura OSIsoft Canada ULC Montreal & Calgary, Canadá Escritório de Representação da OSIsoft, LLC Xangai, República Popular da China OSIsoft Japan KK Tóquio, Japão OSIsoft Mexico S. De R.L. De C.V. Cidade do México, México OSIsoft do Brasil Sistemas Ltda. São Paulo, Brasil Copyright: OSIsoft, LLC. Todos os direitos reservados. Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema de onde possa ser recuperada, ou transmistida, de qualquer forma ou por qualquer meio, mecânico, por fotocópia, gravação, ou qualquer outro tipo, sem a autorização prévia por escrito da OSIsoft, LLC. OSIsoft, o logotipo e a logomarca da OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, Sigmafine, Analysis Framework, IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Data Services, PI Manual Logger, PI ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são marcas comerciais da OSIsoft, LLC. Todas as outras marcas comerciais ou nomes comerciais usados neste documento pertencem a seus respectivos proprietários. DIREITOS DO GOVERNO DOS E.U.A. O uso, duplicação ou divulgação pelo Governo dos E.U.A. está sujeito às restrições apresentadas no contrato de licença da OSIsoft, LLC e conforme fornecido na DFARS , DFARS , FAR , FAR , conforme aplicável. OSIsoft, LLC. Publicado: 19/5/2010

3 Índice Capítulo 1 Introdução...1 Edições do PI DataLink...1 Requisitos do sistema...4 Instalação e atualização...4 Configuração...5 Sobre este documento...6 Capítulo 2 Noções básicas...7 Interface do usuário...7 Conexões do PI Server...12 Componentes de função gráfica...13 Configurações de preferência...22 Construção de planilhas...25 Capítulo 3 Funções do PI...27 Valor atual...27 Valor do arquivo...28 Dados compactados...29 Dados de amostragem...32 Dados com marcação de tempo...34 Dados calculados...35 Hora filtrada...40 Capítulo 4 PI Tags e atributos...43 Pesquisa de tags...43 Funções de tag...45 Capítulo 5 Objetos do banco de dados do módulo...49 Procurar banco de dados do módulo...49 Funções do banco de dados do módulo...51 Capítulo 6 Planilhas...53 Frequência de cálculo...53 Funções e valores de array...55 Gerenciamento de arrays...56 Compartilhar planilhas...58 Capítulo 7 Exibições de tendência...59 Criar uma tendência...59 Guia do usuário do PI DataLink iii

4 Índice Especificar o intervalo de tempo...62 Título e posicionamento...63 Menu de contexto...64 Capítulo 8 Notificações...67 Pesquisar e exibir notificações...68 Exibir notificações...70 Inserir notificações...71 Anexo A Informações suplementares...75 Instalação...75 Horário PI...77 Suporte a tipo de dados do PI...80 Expressões do PI...80 Entrada manual de funções...88 Gravar dados no PI...91 Solução de problemas...91 Anexo B Referência de funções do PI DataLink...95 Funções de valor único...95 Funções de múltiplos valores...98 Funções de cálculo Funções de tag Funções do banco de dados do módulo Funções de entrada Anexo C Suporte técnico e recursos Índice iv

5 Capítulo 1 Introdução O PI DataLink é um suplemento do Microsoft Excel que permite recuperar informações do PI Server diretamente para uma planilha. Com o PI DataLink é possível: recuperar valores de ponto de um PI server recuperar metadados do sistema para criar uma exibição estruturada de dados do PI: ο atributos e nomes de PI tag ο caminhos, aliases e propriedades do PI Module Database referenciar esses itens usando funções do PI DataLink para calcular e filtrar dados manter valores atualizados quando a planilha recalcular recuperar Notificações do PI que você assinou a partir de um PI System estabelecer tendência de dados a partir da planilha ou de pontos PI selecionados O PI DataLink fornece uma interface gráfica para recuperar dados e criar funções e cálculos. As funções do DataLink são inseridas em células da planilha e podem fornecer atualizações ativas de dados em tempo real a partir do PI server. Também é possível usar os ricos recursos de cálculo e formatação do Excel para organizar e apresentar dados do PI system a fim de ajustar à sua meta ou da audiência. Em combinação com os recursos computacionais, gráficos e de formatação do Microsoft Excel, o PI DataLink oferece poderosas ferramentas para coletar, monitorar, analisar e relatar dados do PI. Edições do PI DataLink Observação: Por todo este livro, as referências ao Microsoft Excel 2007 aplicam-se ao Microsoft Excel 2007 e posteriores. As referências ao Microsoft Office 2007 aplicam-se ao Microsoft Office 2007 e posteriores. Duas edições do PI DataLink são instaladas no sistema: Um suplemento é instalado para o Microsoft Excel Esse suplemento não pode ser executado em versões anteriores do Excel. Essa edição será configurada automaticamente se o Excel 2007 estiver instalado no sistema. Um suplemento é instalado para o Microsoft Excel XP ou Esse suplemento assemelha-se a versões anteriores do PI DataLink e deve ser configurado manualmente (página 4). Guia do usuário do PI DataLink 1

6 Introdução As diferenças entre os suplementos residem principalmente em alterações de design e interface do usuário (página 7) para o Office 2007 e posteriores. PI SDK O PI SDK é instalado com o PI DataLink e conecta o PI DataLink ao PI server para recuperar dados de ponto PI. O PI DataLink usa o PI SDK e o Microsoft Excel SDK. Quando ocorre um erro no nível do PI SDK, o PI DataLink exibe o erro na célula. Por exemplo, se uma função tentar recuperar o valor atual de uma tag que não exista, a célula de saída exibirá a mensagem "PIPoint não encontrado". O PI SDK também permite que usuários com experiência em VBA (Microsoft Visual Basic for Applications) desenvolvam rotinas do Excel que chamem funções do PI SDK. Usuários que planejem desenvolver programas fora do Excel deverão adquirir uma licença separada do PI SDK ou da PI API. Entre em contato com o representante de vendas da OSIsoft para obter informações adicionais. 2

7 Edições do PI DataLink PI DataLink for Excel Services (DLES) O PI DataLink for Excel Services (PI DLES) é uma versão de servidor do PI DataLink que pode ser usada com o Microsoft Office SharePoint Server 2007 (MOSS). O PI DLES oferece suporte a todas as funções do PI BatchView e DataLink fornecidas por Suplementos do Excel em uma configuração de cliente típica do PI. O PI DLES permite recuperar e exibir dados de PI Servers em formato de planilha do Microsoft Excel usando apenas um navegador da Web. O acesso a dados do PI em tempo real pode ser expandido para vários consumidores diferentes, independentemente do local ou de familiaridade com funções do Microsoft Excel ou do PI DataLink. Essa versão de servidor do PI DataLink usa tecnologias do MOSS, incluindo os Serviços do Excel e a web part Excel Web Access. Juntos, esses componentes da Microsoft oferecem suporte à maioria dos recursos padrão de planilha. O PI DataLink for Excel Services aumenta esses serviços, adicionando conectividade e suporte a funções do PI. As pastas de trabalho do Excel publicadas em bibliotecas de documentos do SharePoint podem ser acessadas independentemente ou adicionadas a páginas de web part. A web part Excel Web Access oferece suporte a conexões que permitem a troca de parâmetros entre uma pasta de trabalho e outras web parts, integrando planilhas a funções do PI DataLink no ambiente do PI WebParts. Entre em contato com o representante de vendas da OSIsoft para obter informações adicionais sobre o PI DLES. Suporte a idiomas do PI DataLink Este release do PI DataLink fornece suporte a vários idiomas. A interface do usuário do suplemento aparece no mesmo idioma que o Microsoft Excel em que ele é executado, se o idioma for suportado pelo PI DataLink. Caso contrário, o suplemento aparecerá em inglês. Para exibir o suplemento em um idioma diferente, use a ferramenta de configuração de idioma do Microsoft Office para alterar o idioma do Microsoft Excel. Para obter o suporte a vários idiomas, é necessário instalar o pacote de idiomas separado. Guia do usuário do PI DataLink 3

8 Introdução Requisitos do sistema Nos requisitos do sistema, consulte o site de Suporte técnico da OSIsoft: ( Instalação e atualização Instalação Para instalar, baixe o kit de instalação de e execute o kit de instalação do PI DataLink. O programa de instalação instala o PI DataLink no diretório raiz PIPC, normalmente em: C:\Arquivos de programas\pipc\excel A instalação também inclui arquivos de ajuda online e notas sobre o release, também disponíveis para download em Atualização Se houver uma versão anterior do PI DataLink instalada no computador, o instalador atualizará automaticamente a instalação. As configurações de preferência de versões anteriores são mantidas. Os seguintes pontos podem ser úteis ao atualizar de versões anteriores do PI DataLink: O PI DataLink é compatível com versões anteriores. As pastas de trabalho criadas em versões anteriores podem ser lidas pela versão atual sem nenhuma conversão. Entretanto, o contrário não é necessariamente verdadeiro. Depois de modificar uma planilha na versão atual, ela poderá não funcionar em versões anteriores do PI DataLink. As versões atuais do PI DataLink usam o PI SDK, enquanto as versões 2.x e anteriores usavam a PI API. ο As mensagens de erro retornadas podem ser diferentes; portanto, se as planilhas procurarem por determinadas strings (por exemplo, no código VBA do Excel ou em macros) o texto poderá não ser o mesmo. ο As versões 3.x e 4.x não criam uma conexão de API com o PI Server; portanto, o código VBA em pastas de trabalho que dependa de uma conexão de API existente deverá ser editado para criar uma nova conexão explícita com a PI API. 4

9 Configuração Configuração Após a instalação, poderá ser necessário configurar o suplemento PI DataLink no Excel. Microsoft Excel 2007 O programa de instalação do PI DataLink instala automaticamente o suplemento DataLink para Microsoft Excel 2007 se essa versão for encontrada no sistema. Nenhuma configuração será necessária. A instalação torna o PI DataLink disponível para todos os usuários do computador cliente. Se um usuário individual desativar o PI DataLink ou um suplemento relacionado, as atualizações não reativam o suplemento; ele deverá ser restaurado manualmente. Para restaurar suplementos: 1. Clique no Botão Microsoft Office e selecione Opções do Excel. 2. Clique em Suplementos > Gerenciar Itens Desabilitados > Ir e habilite PIDatlink.UI.dll.manifest. 3. Vá para Suplementos > Gerenciar Suplementos de COM > Ir e habilite PI DataLink ou PI Notifications. 4. Clique em OK. Microsoft Excel XP-2003 Se instalar o PI DataLink for Excel XP-2003, precisará configurar o suplemento para Excel após a instalação. Este procedimento também pode ser usado para restaurar o suplemento se o menu PI não aparecer na barra de menus do Excel. Para adicionar o PI DataLink ao Excel versões XP-2003: 1. No Excel, escolha Ferramentas > Suplementos. O diálogo Suplementos será exibido. Guia do usuário do PI DataLink 5

10 Introdução 2. Se o suplemento PI DataLink não estiver listado, clique em Procurar para localizar o arquivo PIPC32.XLL no disco rígido local. O caminho padrão do PI DataLink é PIPC\EXCEL. 3. Clique na caixa de seleção ao lado de PI DataLink e clique em OK. Sobre este documento O Guia do usuário do PI DataLink fornece uma descrição detalhada dos recursos do produto e uma referência completa para funções do PI DataLink. O conteúdo das versões impressa e online do guia é idêntico. Os objetos de controle de tendência também iniciam um arquivo de ajuda separado que inclui informações sobre controles programáticos para tendências. As versões impressas do Guia do usuário do PI DataLink incluem exercícios de tutorial usados pela OSIsoft para cursos de treinamento em PI DataLink. Esses exercícios também estão disponíveis em formato PDF (juntamente com arquivos de exercícios de treinamento associados) no website de suporte da OSIsoft em techsupport.osisoft.com. Este guia não duplica ou distingue entre os suplementos PI DataLink for Excel 2007 e Excel XP-2003 ao discutir funcionalidades comuns, a menos que existam diferenças funcionais significativas. Referências específicas ao PI DataLink for Excel XP-2003 estão rotuladas (2003), e as específicas ao PI DataLink for Excel 2007 estão rotuladas (2007), quando necessário. 6

11 Capítulo 2 Noções básicas As seções a seguir introduzem conceitos e recursos básicos do PI DataLink. É necessário familiarizar-se com essas seções antes de usar o PI DataLink para criar uma planilha e recuperar dados do PI, especialmente se você não tiver experiência com o PI DataLink ou com o Office Essas seções descrevem: Componentes de interface comuns e como eles diferem entre os suplementos PI DataLink for Excel XP-2003 e Excel 2007 Principais recursos necessários para começar a trabalhar com o PI DataLink Abordagens diferentes para a criação de uma planilha do PI DataLink, dependendo de suas metas, necessidades e recursos Interface do usuário O PI DataLink é um aplicativo de suplemento para o Microsoft Excel e aparece na interface do usuário do Microsoft Excel na forma de menus, caixas de diálogo e painéis de tarefas específicos ao PI DataLink. Embora a funcionalidade básica do PI DataLink seja a mesma para o Excel XP-2003 e o 2007, a interface do usuário e as ferramentas usadas para criar e gerenciar planilhas do PI DataLink diferem levemente para refletir o design e os objetos disponíveis na versão correspondente do Microsoft Excel. Dependendo da versão do Excel, será possível trabalhar com um dos seguintes grupos de componentes do PI DataLink: PI DataLink for Excel XP-2003 PI DataLink for Excel 2007 Menu PI caixas de diálogo de função menu de contexto que se clica com o botão direito do mouse Assistente Controle de tendências caixa de diálogo Notificações do PI Faixa de opções do PI painéis de tarefas de função menu de contexto que se clica com o botão direito do mouse Assistente Controle de tendências caixa de diálogo Notificações do PI A seção a seguir descreve as diferenças visuais e operacionais entre os suplementos PI DataLink. Guia do usuário do PI DataLink 7

12 Noções básicas PI DataLink for Excel 2007 O PI DataLink for Excel 2007 inclui elementos de design introduzidos no Microsoft Office Se estiver atualizando de uma versão anterior do PI DataLink, familiarize-se com os novos elementos de design antes de começar a trabalhar com o PI DataLink. Faixa de opções do PI O suplemento PI DataLink for Microsoft Excel 2007 usa um menu de faixa de opções. O menu de faixa de opções é um menu gráfico que combina recursos de um menu padrão e uma barra de ferramentas. Clique em PI na barra de menus do Excel para selecionar a guia do menu de faixa de opções do PI DataLink. Clique em um item na faixa de opções PI para abrir um painel de tarefas ou uma caixa de diálogo correspondente. Coloque o cursor sobre um item para exibir uma dica de ferramenta descritiva. Painéis de tarefas de funções O PI DataLink for Microsoft Excel 2007 fornece painéis de tarefas personalizados para definir funções do PI DataLink. Um painel de tarefas é um painel de controles móvel e encaixável que funciona quase como uma caixa de diálogo, exceto que é possível continuar a trabalhar em uma planilha enquanto um painel de tarefas está aberto. 8

13 Interface do usuário O PI DataLink abre um painel de tarefas quando você adiciona uma função ou seleciona uma célula em um array de funções para edição. Para abrir um painel de tarefas de função: Clique na célula de saída desejada e então clique em uma função na faixa de opções PI para adicionar uma função. Clique em uma célula em um array de funções existente para exibir um painel de tarefas correspondente e editar argumentos da função. Clique com o botão direito do mouse em uma célula de array de funções e escolha o nome da função para exibir manualmente o painel de tarefas. Observação: É possível desligar a exibição automática (página 22) de painéis de tarefas, se preferir. Depois que um painel de tarefas de função estiver aberto: Insira ou altere valores e então clique em OK para salvar as alterações e fechar o painel de tarefas. Clique em Aplicar para salvar alterações sem fechar o painel de tarefas. Clique no botão X na barra de título do painel de tarefas para fechar o painel de tarefas sem salvar alterações. Clique no botão de seta na barra de título do painel de tarefas para desanexar e Mover ou Redimensionar o painel de tarefas. Também é possível clicar na barra de título para arrastar e encaixar um painel de tarefas, ou colocar o cursor sobre a borda e arrastar para redimensionar o painel. Observação: As caixas de diálogo são usadas para outras tarefas, incluindo Pesquisa de tags, Preferências e Conexões no suplemento para Excel Guia do usuário do PI DataLink 9

14 Noções básicas PI DataLink for Excel XP-2003 O PI DataLink for Excel XP-2003 aparece no Microsoft Excel como um menu padrão e controles de caixa de diálogo relacionados. Se você usava versões anteriores do PI DataLink, o suplemento para Excel XP-2003 mantém a mesma aparência. Menu PI O PI DataLink for Excel XP-2003 adiciona um menu PI à barra de menus do Excel quando o suplemento PI DataLink é carregado. Se o menu PI não for exibido, poderá ser necessário configurar (página 4) o suplemento PI DataLink for Excel. O PI DataLink for Excel XP-2003 usa uma configuração de menu padrão: Escolha um item no menu PI para abrir uma caixa de diálogo correspondente. 10

15 Interface do usuário Caixas de diálogo de funções O PI DataLink for Microsoft Excel XP-2003 fornece caixas de diálogo para definir funções do PI DataLink. O PI DataLink abre uma caixa de diálogo de função correspondente quando você adiciona ou edita uma função. Para abrir uma caixa de diálogo de função: Clique em uma célula e então escolha uma função no menu PI para adicionar uma função. Clique com o botão direito do mouse em uma célula de um array de funções existente para exibir o menu de contexto e então escolha o nome da função no menu para editar argumentos da função. Depois que uma caixa de diálogo de função estiver aberta: Insira ou altere valores e então clique em OK para salvar as alterações e fechar a caixa de diálogo. O PI DataLink recupera valores automaticamente do PI e popula o array de funções na planilha quando você clica em OK. Clique em Cancelar ou X para fechar a caixa de diálogo sem salvar alterações. Menu de contexto O PI DataLink adiciona diversos comandos ao menu de contexto padrão do Microsoft Excel. É possível usar esses comandos para gerenciar arrays de funções que já estejam inseridos em uma planilha. Observação: Os menus de contexto são os mesmos para ambas as versões de suplementos do PI DataLink. Guia do usuário do PI DataLink 11

16 Noções básicas Para exibir um menu de contexto: Clique com o botão direito do mouse em qualquer local de uma célula ou grupo de células que contenha um array de funções do PI DataLink. Um array de funções é o cluster de células que contém a saída de uma única função do PI DataLink. Também é possível clicar com o botão direito do mouse em um controle de tendência inserido para ver um menu de contexto relacionado (página 64). Os seguintes itens aparecem no menu de contexto: Escolha Selecionar função do DataLink para selecionar o array de funções inteiro. Você deve selecionar um array antes de tentar copiar, recortar ou arrastá-lo para um novo local da planilha. Escolha Recalcular (Redimensionar) função para recalcular (página 54) o array, recuperando novos valores do PI. Para algumas funções, um número diferente de valores poderá estar disponível a cada recálculo, causando o redimensionamento do array. Escolha <nome da função> para abrir uma caixa de diálogo de função (página 10) correspondente e atualizar argumentos para coletar dados diferentes. Conexões do PI Server Use a caixa de diálogo Conexões para gerenciar conexões a PI servers no ambiente computacional. Para conectar a um PI server: Clique no ícone Conexões na barra da faixa de opções (2007) ou escolha PI > Conexões (2003) para exibir a caixa de diálogo Conexões. Cada PI server configurado disponível para o PI DataLink aparece no painel Servidor à esquerda. Se o servidor desejado não for exibido, será possível adicionar uma conexão. Para adicionar conexões de PI server adicionais: Escolha Servidor > Adicionar servidor ou clique com o botão direito do mouse no painel do servidor e escolha Adicionar servidor no menu de contexto para exibir a caixa de diálogo Adicionar servidor e configurar uma nova conexão de PI server. Uma caixa de seleção marcada próxima de um nome de servidor na caixa de diálogo Conexões indica uma conexão aberta com o PI Server. 12

17 Componentes de função gráfica Para gerenciar configurações de conexão: Clique para marcar a caixa de seleção e abra uma conexão com o PI Server na lista. Desmarque a caixa de seleção para fechar uma conexão. Selecione um PI Server no painel do servidor para acessar configurações de conexão Uma conexão aberta com um PI server é requerida para adicionar funções do DataLink a uma planilha e recuperar valores do PI. Observação: O nome do PI server padrão aparece no canto inferior direito da caixa de diálogo. É possível manter conexões a mais de um PI server ao mesmo tempo, embora possa ser necessário especificar o servidor de destino ao definir uma função do PI DataLink. Componentes de função gráfica O PI DataLink fornece uma interface gráfica do usuário para criar funções no Excel. Os recursos comuns de caixa de diálogo facilitam o fornecimento de argumentos para definir a função. A ferramenta usada para criar uma função depende da versão instalada do PI DataLink: O suplemento para Excel XP-2003 fornece caixas de diálogo (página 10) para definir funções. O suplemento para Excel 2007 fornece painéis de tarefas (página 8) para definir funções. Usuários avançados familiarizados com o PI DataLink e o PI Server podem inserir sintaxe de função (página 88) diretamente na barra de fórmulas do Excel. As seções a seguir descrevem recursos comuns nas caixas de diálogo e nos painéis de tarefas de funções do PI DataLink, como os dados em tempo real são obtidos e apresentados e como as funções do PI DataLink podem ser usadas em uma planilha. Guia do usuário do PI DataLink 13

18 Noções básicas Campos de entrada Campos de entrada rotulados aceitam o uso de argumentos específicos para definir uma função. A maioria dos argumentos pode ser inserida diretamente ou referenciada em células de planilha. Embora as opções difiram por argumento, todos os campos de entrada permitem uma ou mais das seguintes opções: Inserir texto diretamente em um campo de edição, como um nome de tag ou o endereço de uma célula de saída. Selecionar um item entre opções em uma lista, como um cálculo ou um método de amostragem. Referenciar células de planilha que contêm argumentos, como um nome de tag, local de célula de saída ou carimbo de data e hora. Observação: Certifique-se de inserir strings em células que possam ser referenciadas com um apóstrofo (') à esquerda. Isso força o Excel a interpretar o conteúdo como uma string. Selecione valores de um PI server ou outras fontes por meio de uma tag ou pesquisa de banco de dados do módulo. Por exemplo, é possível inserir uma string de nome de tag no campo Nome de tag ou clicar no botão ao lado do campo para exibir a caixa de diálogo Pesquisa de tag e pesquisar o PI server por tags. Também é possível fornecer manualmente uma referência para uma célula de planilha que contém um nome de tag: Clique primeiro no campo de edição e depois clique na célula (ou clique na célula e arraste para uma célula adjacente para selecionar um intervalo) na planilha. O DataLink insere automaticamente a referência de célula no campo de edição. Observação: Alguns campos de entrada exibem uma entrada padrão quando a caixa de diálogo ou o painel é aberto. Campos marcados como Opcional são opcionais e um valor não é necessário. 14

19 Componentes de função gráfica Argumentos padrão Alguns argumentos são comuns à maioria das funções do PI DataLink em caixas de diálogo ou em painéis de tarefas, e normalmente são requeridos para definir a função: Nome(s) de tag ou expressão O campo Nome(s) de tag ou Expressão é requerido pela maioria das funções para avaliar dados de ponto PI (tag) ou os resultados de uma expressão de PI (página 81). Um ou mais nomes de tag, ou a sintaxe de uma expressão podem ser: Inseridos diretamente em um campo. Por exemplo, sinusoid. Inseridos em uma ou mais células de planilha, que são então referenciadas no campo. Por exemplo, uma referência ao array Sheet1!$B$3:Sheet1!$B$4, que por sua vez contém as strings de nome de tag 'sinusoid e 'cdt158. Observe que as referências de célula permitem que vários nomes de tag sejam especificados para uma função, enquanto não é possível especificar diretamente vários nomes de tag, a menos que o campo esteja rotulado Nome(s) de tag. Observação: Note que aspas simples são adicionadas a cada nome de tag para denotar valores string no Excel. As strings e as expressões de tempo referenciadas em células devem ser incluídas entre aspas simples. Por exemplo: TimeEq('CD:M158','y','t', "Manual") Selecionados no diálogo Pesquisa de tags (página 43), com base em uma pesquisa de tags por nome, alias ou atributo. Hora inicial O início de um intervalo de tempo (página 16) durante o qual a função é avaliada, da Hora inicial até a Hora final. Todos os valores de eventos correspondentes ao intervalo de tempo são recuperados do arquivo do PI ou calculados para criar o array de funções resultante. Hora final O final do intervalo de tempo, frequentemente expresso como a hora atual, em que a Hora inicial é a hora atual menos um intervalo de tempo especificado. As horas iniciais e finais podem ser expressas em termos absolutos ou relativos para estabelecer um intervalo de tempo no passado ou até e incluindo a hora atual. Guia do usuário do PI DataLink 15

20 Noções básicas PI Server Uma instância de uma função do PI DataLink é executada em relação a apenas um PI server. O PI Server especifica um PI server de destino a partir de uma lista de servidores conhecidos. Se você não selecionar um servidor ou deixar o campo em branco, o PI server padrão (página 12) será usado. Os servidores que aparecem acima da linha pontilhada na lista de servidores estão atualmente conectados; aqueles abaixo dela estão desconectados. Célula de saída Especifique se deseja colocar o array de funções resultante usando o campo Célula de saída. Caso selecione uma célula antes que o painel de tarefas ou a caixa de diálogo da função seja exibido, a célula atualmente selecionada será usada como o valor padrão de Célula de saída. O valor da célula de saída sempre especifica o canto superior esquerdo do array de funções. Se você acrescentar (página 17) carimbos de data e hora e outros dados, lembre-se de que a coluna de dados pode ser deslocada para baixo ou para a direita do local da célula de saída, substituindo dados nessas células adjacentes. Se você clicar no campo Célula de saída e depois selecionar um array de múltiplas células na planilha, poderá substituir a exibição padrão de todos os resultados de função. Em vez disso, somente os resultados que caibam nas dimensões do array especificado serão exibidos. Argumentos de tempo Muitas funções do PI DataLink requerem que os argumentos Hora inicial e Hora final recuperem um array de valores de evento em um intervalo de tempo específico. Siga estas diretrizes ao especificar argumentos de tempo: As strings de tempo podem ser inseridas diretamente em campos de edição em formatos hora do PI (página 77) absolutos ou relativos (por exemplo, 10-Dec-99 19:12 ou - 3h). Se a hora inicial for mais recente que a hora final, os resultados serão exibidos em ordem cronológica inversa. Os carimbos de data e hora referenciados em células da planilha também podem usar formatos hora do PI fixos ou relativos, e devem ser precedidos por um apóstrofo para indicar uma string (por exemplo, '10-Dec-99 19:12 ou '-3h). As referências de célula também podem usar o formato de tempo absoluto do Excel (como , equivalente a 8/5/2007 2:45:00 PM). O Excel armazena carimbos de data e hora nesse formato, que representa o número cumulativo de dias desde O Excel pode exibir os mesmos carimbos de data e hora usando qualquer formato data-hora atribuído à célula. 16

21 Componentes de função gráfica Alguns argumentos necessitam de um intervalo ou duração de tempo, representados por um único valor em vez de horas iniciais e finais. Sejam referenciados ou inseridos diretamente, os valores de intervalo devem usar as strings de hora relativas do PI, como um número seguido por uma variável de tempo (por exemplo, 1d ou 30m), e não podem especificar ou referir-se a um carimbo de data e hora fixo do PI ou do Excel. Por exemplo, para especificar um intervalo de 32 minutos, insira ou referencie uma célula que contenha a string 32m. Para inserir intervalos em termos de frequência, converta a frequência em segundos equivalentes. Por exemplo, a frequência 25 Hz deve ser inserida como um intervalo 0.04s (=1/25 de um segundo). Ao usar formatos relativos (por exemplo, -2h), a hora de referência usada para traduzir o formato de hora é diferente para horas iniciais e finais de funções. A hora atual do relógio de parede é a referência para uma hora inicial relativa, mas a hora inicial será então usada como a referência para uma hora final relativa. Observação: O PI DataLink oferece suporte apenas ao sistema de datas 1900 padrão suportado pelo Excel. O PI DataLink não oferece suporte ao sistema de datas 1904 do Excel, e retorna carimbos de data e hora incorretos se esse sistema for usado. Dados acrescentados Os carimbos de data e hora são especialmente relevantes aos eventos de ponto PI. Cada valor de evento é acompanhado por um carimbo de data e hora que lhe fornece contexto. A maioria das funções do PI DataLink pode retornar valores de carimbo de data e hora correspondentes e outros dados de ponto com valores de expressão calculados ou de evento do PI. Esses dados podem ser acrescentados aos valores retornados em um array de funções do PI, e incluem: carimbos de data e hora de eventos carimbos de data e hora que indicam as horas inicial e final de um intervalo carimbos de data e hora que indicam a ocorrência de valores mínimos e máximos o percentual de valores válidos em um intervalo de amostragem atributos de valores anotações de evento inseridas manualmente nomes de PI server de origem Quando especificados, os dados acrescentados aparecem em colunas (ou fileiras) adjacentes aos valores primários retornados por uma função, de acordo com as seguintes regras: Dados de tempo são adicionados em colunas à esquerda (ou fileiras acima) dos valores primários. Outros dados relacionados são adicionados em colunas à direita (ou fileiras abaixo) dos valores primários. Guia do usuário do PI DataLink 17

22 Noções básicas Array de dados acrescentados A tabela a seguir ilustra como os dados são acrescentados por função. Para funções que podem exibir saída em fileiras ou colunas (página 20), substitua as colunas 1-5 pelas fileiras 1-5. Função/modo Qualquer função sem dados acrescentados Valor atual e do arquivo, Dados de amostragem Dados compactados Célula de saída valor carimbo de data e hora carimbo de data e hora Colunas de array de funções Coluna 2 Coluna 3 Coluna 4 Coluna 5 valor valor anotações Hora filtrada hora inicial hora final valor percentual válido Calculado (mínimo) hora inicial hora final hora mínima valor mínimo Calculado (máximo) hora inicial hora final hora máxima valor máximo Calculado (intervalo) hora inicial hora final hora mínima hora máxima valor Calculado (outro) hora inicial hora final valor percentual válido Alias servidor valor Observação: A tabela assume que todos os dados acrescentados sejam especificados para exibição e que alguns arrays de funções podem ser expandidos para cinco colunas se todos os dados relacionados forem acrescentados. Mostrar carimbos de data e hora Uma caixa se seleção mostrar carimbos de data e hora aparece quando uma função retorna um array de valores de PI com o passar do tempo. Se for selecionada, essa opção retornará um carimbo de data e hora correspondente a cada valor de evento de PI. Para funções que retornam múltiplos valores de evento (por exemplo, Dados de amostragem), os controles de orientação (página 20) determinam como os carimbos de data e hora são exibidos em relação a cada valor. Para algumas funções que retornam um único valor (por exemplo, Valor atual), são fornecidos botões de rádio para fornecer opções equivalentes: Selecione sem carimbo de data e hora para suprimir a exibição do carimbo de data e hora. Selecione tempo à esquerda para retornar um carimbo de data e hora em uma célula à esquerda do valor de evento. 18

23 Componentes de função gráfica Selecione tempo na parte superior para exibir o carimbo de data e hora em uma célula acima do valor de evento recuperado. Quando uma referência a um array de nomes de tag em células for especificada no campo Nome de tag, essas preferências serão ignoradas. Em vez disso, os valores de evento e carimbo de data e hora serão posicionados a fim de corresponder à orientação do array de tags de entrada. Para nomes de tag em uma única coluna, os carimbos de data e hora aparecem à esquerda dos valores. Para nomes de tag em uma única fileira, os carimbos de data e hora aparecem na parte superior dos valores. Carimbos de data e hora de intervalo As funções que retornam valores a intervalos de tempo específicos (por exemplo, Dados calculados) fornecem opções para exibir carimbos de data e hora diferentes: Escolha mostrar hora inicial para exibir a hora inicial de cada intervalo. Escolha mostrar hora final para exibir a hora final de cada intervalo. Para valores de intervalo, mínimo e máximo calculados: Escolha mostrar hora mín/máx para exibir carimbos de data e hora para valores mínimos e máximos em cada intervalo. Os carimbos de data e hora são exibidos de forma a corresponder à orientação de fileira ou coluna especificada. Se todos os carimbos de data e hora forem mostrados, a ordem da coluna da esquerda para a direita ou fileira superior para inferior será hora inicial, hora final, tempo de valor mínimo, tempo de valor máximo, valor do evento. Mostrar percentual válido Selecione mostrar percentual válido para exibir o percentual de tempo para o qual valores válidos são retornados durante o intervalo de tempo total do array. Valores percentuais válidos normalmente são adicionados a uma coluna à direita ou a uma fileira abaixo dos valores recuperados. Valores válidos são valores de evento determinados como válidos pelo PI server, e não em um estado de erro. O percentual de valores válidos ajuda na avaliação da confiabilidade de cálculos efetuados em valores de ponto PI, especialmente se os valores calculados devem ser usados em cálculos adicionais. Por exemplo, totais ainda podem ser calculados durante um intervalo de tempo, mesmo que alguns dos dados sejam inválidos. O valor total com peso de tempo resultante é igual ao total dividido pela fração do interval em que os dados válidos estão disponíveis. Entretanto, essa normalização assume que a média durante o intervalo de tempo com dados inválidos seja equivalente ao valor médio durante o intervalo de tempo inteiro, o que se torna menos confiável se uma grande fração do intervalo de tempo contiver dados inválidos. Guia do usuário do PI DataLink 19

24 Noções básicas Mostrar atributos do valor Selecione mostrar atributos do valor para exibir bits de status estendidos associados aos valores de evento retornados. Os bits retornados correspondem aos atributos de valor armazenados no PI, e podem ser um dos seguintes: A = anotado, indicando que um comentário foi adicionado ao evento S = substituído, indicando que o valor do evento foi alterado de seu valor original Q = questionável, indicando que há alguma razão para duvidar da exatidão do valor Os atributos de valor são exibidos em uma coluna à direita dos valores do evento. Mostrar anotações Selecione mostrar anotações para exibir quaisquer anotações associadas aos valores de evento retornados em uma coluna à direita. As anotações são observações ou comentários acrescentados a um valor de dados no PI com finalidade descritiva. Controles de orientação Para funções que retornam um array de valores de PI, use os botões coluna e fileira para determinar a orientação dos dados retornados. Escolha coluna para exibir dados em colunas. Escolha fileira para exibir os dados em fileiras. Fileiras ou colunas adicionais (página 17) são adicionadas para carimbos de data e hora e dados relacionados se eles forem selecionados para exibição. O campo Saída da função sempre indica o canto superior esquerdo do intervalo inteiro usado para o array. Observação: Para funções que retornam um intervalo de valores, a orientação do array de tags de entrada substitui a seleção de fileira e coluna para determinar a orientação dos dados de saída. 20

25 Componentes de função gráfica Formatos de exibição É possível alterar os formatos padrão de hora e número usados pelo PI DataLink para formatar dados em arrays de funções. Os formatos padrão são especificados na caixa de diálogo Configurações (página 22), onde estão disponíveis duas configurações para formatos: O formato de número padrão Geral formata números (e todos os dados que não sejam carimbo de data e hora) de maneira que correspondam à formatação Categoria Geral na caixa de diálogo Formatar células do Excel. O formato de hora padrão dd-mmm-yy hh:mm:ss corresponde ao formato padrão de carimbo de data e hora do PI. É possível adicionar.000 ao final da string (dd-mmm-yy hh:mm:000) para exibir carimbos de data e hora com frações de segundo. Observe que o Excel não oferece suporte a formatos de precisão com microssegundos. É possível personalizar strings de formato padrão usando quaisquer códigos de formato válidos do Excel na caixa de diálogo Formatar células do Excel. Por exemplo, o equivalente em alemão para Geral e dd-mmm-yyyy hh:mm são Padrão e TT-MM-JJJJ hh:mm, respectivamente. Também é possível aplicar formatação individual de data e hora a qualquer célula da planilha, incluindo aquelas que contenham funções do PI DataLink, escolhendo Formatar > Células > Número. Consulte a documentação do Excel para obter informações adicionais sobre a formatação de datas e horas. Guia do usuário do PI DataLink 21

26 Noções básicas Configurações de preferência Use a caixa de diálogo Configurações para especificar preferências globais e formatação padrão para a saída de funções do PI DataLink. Para acessar configurações: 1. Clique em Configurações na faixa de opções PI (2007) ou escolha PI > Configurações (2003). 2. Defina as preferências desejadas e clique em OK. 22

27 Configurações de preferência Copiar itens para planilha Escolha Em uma fileira ou Em uma coluna para copiar os nomes de várias tags selecionadas em uma Pesquisa de tags (ou itens em uma pesquisa Procurar módulo) para a planilha em uma fileira ou coluna de valores, respectivamente. A configuração padrão é Em uma coluna. Esse comando também está disponível como um atalho para o item Pesquisa de tags da faixa de opções (2007). Copiar nome do PI Server Marque a caixa de seleção para copiar o nome da origem de dados do PI server para uma célula de planilha adjacente quando nomes de tag forem copiados para uma planilha. Usar fuso horário do PI Server Marque a caixa de seleção para forçar que o PI DataLink use o fuso horário do PI Server como um valor de referência para interpretar funções. Se estiver desmarcada, o PI DataLink usará a configuração de fuso horário da máquina cliente. Essa opção é relevante apenas se um PI server tiver uma configuração de fuso horário diferente do computador cliente. Exibir #N/A em vez de campos em branco Marque a caixa de seleção para substituir #N/A (Não Aplicável) para células em branco quando houver menos pontos de dados que células em um array de funções. As funções adicionadas a uma planilha mantêm seu tamanho de array original, mesmo se a variância em um determinado período de tempo produzir menos valores de dados, resultando em uma ou mais células vazias. Esse recurso é especialmente útil quando resultados de função são plotados com o pacote de gráficos do Excel. Locale Independente Marque a caixa de seleção para forçar o PI DataLink a interpretar strings de tempo de entrada de acordo com as regras de formato de tempo do PI, independentemente das configurações de locale do computador cliente. O tempo do PI assume que todas as strings estejam no formato inglês e usem a ordem data-hora dd-mmm-yyyy hh:mm:ss. Desmarque a caixa de seleção para analisar formatos data-hora de acordo com configurações regionais no computador cliente, retornando para regras de formato de tempo do PI somente quando necessário. Desabilitar exibição de painel de tarefa automática ao clicar Apenas para o Excel 2007, marque essa caixa de seleção para impedir a exibição automática do painel de tarefas de função ao clicar em uma célula de função. Clique com o botão direito do mouse no menu de contexto e escolha o nome da função para exibir o painel manualmente. Guia do usuário do PI DataLink 23

28 Noções básicas Desabilitar mensagem "Redimensionar para mostrar todos os valores" Marque essa caixa de seleção para não exibir uma mensagem de aviso quando o número de valores recuperados por um array recalculado exceder o número que pode ser exibido. Formato de número Insira um formato de número para indicar como a saída de função numérica deve ser exibida por padrão. A string de formato pode ser qualquer código de formato de número válido da caixa de diálogo Formato do Excel (página 20). Durante a instalação, o PI DataLink atribui o formato de número padrão do Excel a esse campo, a menos que você tenha definido sua própria preferência de formato anteriormente no DataLink. Se a versão do Excel for executada em um locale diferente, esse formato incluirá a sintaxe correta para refletir o locale. Por exemplo: apareceria como 35,03 no Excel francês. Formato de hora Insira um formato de carimbo de data e hora para a saída da função. A string de formato de hora pode ser qualquer código de formato data-hora (página 16) válido da caixa de diálogo Formato do Excel. Durante a instalação, o DataLink atribui o formato de carimbo de data e hora padrão do PI a esse campo, a menos que você tenha definido sua própria preferência de formato anteriormente no DataLink. Se a versão do Excel for executada em um locale diferente, esse formato incluirá a sintaxe correta para refletir o locale. Por exemplo: dd-mm-yy ( ) apareceria como jj-mm-aa ( ) no Excel francês. Atualização automática Use esta seção para definir preferências para Atualização automática (página 53) quando esse recurso estiver habilitado: Escolha um método de cálculo: Calcular (F9) força que todas as funções voláteis (e quaisquer funções que as referenciem) sejam recalculadas. Calcular por inteiro (Ctrl+Alt+Shift+F9) força que todas as funções inseridas, independentemente da volatilidade, sejam recalculadas. Em seguida, insira um intervalo de cálculo em segundos. O valor mínimo é 5 segundos. Insira 0 para aceitar o intervalo automático selecionado pelo PI DataLink com base na duração de tempos de cálculo anteriores. 24

29 Construção de planilhas Construção de planilhas Quando estiver familiarizado com as ferramentas e conceitos básicos do PI DataLink, e estiver pronto para criar uma planilha e usar as funções do PI DataLink, onde você começa? Suas metas Considere primeiramente suas metas. Quais dados deseja exibir em uma planilha a fim de monitorar o desempenho ou responder a uma questão comercial? Em qual PI server os dados residem? Como é possível exibir as informações mais efetivamente, tanto para comunicar pontos essenciais como para fornecer o contexto de segundo plano necessário? As respostas ajudarão a determinar quais funções do PI DataLink podem retornar os dados mais relevantes à tarefa. Funcional Uma maneira de criar uma planilha é simplesmente adicionar funções (página 27), construindo a exibição em torno delas conforme necessário. Posteriormente, será possível adicionar informações de tag para ajudar a esclarecer o que os dados representam. Essa pode ser a melhor abordagem se você ainda estiver explorando seus requisitos ou aprendendo como o PI DataLink funciona. Estruturado Outra forma de criar uma planilha é adicionar estrutura desde o início. Use funções de tag e pesquisa de tags (página 43) para adicionar tags e outros atributos como metadados para enquadrar seu assunto; em seguida, adicione funções para recuperar os dados de ponto PI correspondentes. Isso requer um pouco mais de planejamento e familiaridade com o PI DataLink, mas uma vez que as informações de tag estejam presentes na planilha, será possível usá-la para criar funções mais facilmente entre referências de célula. As planilhas criadas dessa maneira também são mais flexíveis para reuso. Baseado em módulos Se configurou o PI Module Database para seu PI server, poderá criar flexibilidade máxima na planilha pela incorporação de objetos do banco de dados do módulo (página 49). Da mesma forma que os dados de tag, os objetos de banco de dados do módulo podem ser referenciados em funções. Também é possível adicionar recursos de contexto do módulo para maximizar o reuso potencial da planilha entre assuntos paralelos ou redundantes. Relatórios direcionados Caso seja um administrador do sistema ou um construtor de planilhas para outros usuários, poderá desejar colocar as funções do PI DataLink em uma segunda planilha em uma pasta de trabalho e copiar/colar os resultados na primeira planilha para exibição. A sintaxe da função e a lógica comercial podem ser ocultadas e protegidas usando o Excel para proteger a segunda planilha. Essa estratégia também funciona bem para documentos distribuídos com o PI DLES (página 3). Guia do usuário do PI DataLink 25

30

31 Capítulo 3 Funções do PI As funções do PI DataLink permitem consultar, calcular e retornar atributos e valores de ponto PI para células de planilha. Como outras funções do Excel, os resultados de funções do PI DataLink são exibidos em arrays que podem ser recalculados para exibir valores de eventos atualizados, conforme necessário. Para acessar as funções do PI: Clique na célula de saída desejada e escolha PI > (nome da função) para abrir um diálogo de função (XP-2003), ou clique em uma função na faixa de opções do PI para abrir um novo painel de tarefa de função (2007). As descrições de funções nesta seção mostram argumentos específicos a cada função em termos desses recursos comuns. Valor atual Recupera o valor atual ou mais recente (instantâneo) de um ponto PI, com base no nome da tag. ARGUMENTOS OBRIGATÓRIOS Nome da tag OBSERVAÇÕES ESPECIAIS Referencie um intervalo de células que contenha nomes de tag para exibir valores de instantâneos atuais para cada um. É atualizado sempre que o Excel calcula ou recalcula qualquer célula na planilha. Para forçar um recálculo imediato, pressione F9. EXEMPLO Para consultar o valor atual da tag sinusoid, os seguintes argumentos são definidos para a função Valor atual: Tagname (Nome da tag) = sinusoid time at left (tempo à esquerda) e o array de funções resultante aparece como: Guia do usuário do PI DataLink 27

32 Funções do PI TÓPICOS RELACIONADOS PICurrVal() (página 95) Valor do arquivo Recupera um valor de ponto PI ou avalia uma expressão correspondente a um carimbo de data e hora especificado. ARGUMENTOS OBRIGATÓRIOS Nome de tag ou expressão Carimbo de data e hora CARIMBO DE DATA E HORA A referência de tempo usada para recuperar o valor de arquivo do PI, que pode ser um valor de hora (página 16) fixo ou expresso relativo à hora atual. MODO DE RECUPERAÇÃO É possível selecionar um entre cinco modos para produzir um valor de arquivo: Anterior - recupera o valor exatamente correspondente ou que precede o carimbo de data e hora especificado. Somente anterior - recupera o valor que precede o carimbo de data e hora especificado. Interpolado - interpola o valor no horário especificado ou segue o comportamento de Somente anterior. Auto - interpola o valor no horário especificado ou segue o comportamento de Anterior. Próximo - recupera o valor exatamente correspondente ou que sucede o carimbo de data e hora especificado. Somente próximo - recupera o valor que sucede o carimbo de data e hora especificado. Tempo exato - recupera somente um valor exatamente correspondente ao carimbo de data e hora, ou retorna Nenhum evento encontrado se nenhum valor existir. OBSERVAÇÕES ESPECIAIS Referencie um intervalo de células que contenha nomes de tag para exibir valores arquivados para cada um. Para tags com atributos de etapas, os modos Anterior e Somente anterior são substituídos pelos modos de cálculo Auto e Interpolado, respectivamente. PIExpVal() será usada se uma expressão for substituída por uma tag; caso contrário, PIArcVal() será usada. 28

33 Dados compactados EXEMPLO Para consultar o valor da tag sinusoid correspondente a uma hora específica, os seguintes argumentos são definidos para a função Valor do arquivo: Tagname (Nome da tag) = sinusoid Timestamp (Carimbo de data e hora) = 30-Sep-07 15:13 Retrieval Mode (Modo de recuperação) = previous time at left (tempo à esquerda) e o array de funções resultante aparece como: TÓPICOS RELACIONADOS PIArcVal() (página 96) PIExpVal() (página 97) Dados compactados Retorna todos os valores de um ponto PI ocorridos em um intervalo de tempo especificado ou um número de valores de ponto iniciando em um determinado horário. Valores compactados são dados registrados pelo PI server após um algoritmo de compactação ter removido todos os valores que representam a mesma inclinação. Observação: Caixas de diálogo separadas são fornecidas para Dados compactados (Hora inicial/hora final) e Dados compactados (Hora inicial/número) no PI DataLink for Excel XP Para o 2007, é possível selecionar um cálculo por Intervalo de tempo ou Número de valores no painel de tarefas. ARGUMENTOS OBRIGATÓRIOS Nome da tag Hora inicial Hora final ou Número de valores, dependendo do tipo de função EXPRESSÃO DE FILTRO Adicione uma expressão de filtro a fim de filtrar valores de evento usando uma expressão matemática, eliminando dados para os quais a expressão é avaliada como falsa. A expressão de filtro é aplicada aos dados brutos do PI (e não a valores resultantes do próprio cálculo). Guia do usuário do PI DataLink 29

34 Funções do PI Por exemplo, a expressão de filtro simples: sinusoid < 70 removeria do cálculo todos os valores acima de 70. Também é possível usar qualquer equação de desempenho válida do PI na expressão de filtro para criar expressões mais complexas a fim de remover picos atípicos nos valores de dados, por exemplo. Selecione marcar como filtrado para substituir Filtrado como um espaço reservado para cada valor ou bloco de valores filtrados do array com base na expressão (página 81) do filtro. TIPO DE LIMITE Especifique um tipo de limite para determinar como as pesquisas do Editor de arquivo por valores de dados são tratadas próximas às horas inicial e final do intervalo de valores: Dentro (padrão): Retorna valores ocorridos nas horas inicial e final, se existirem, ou os valores mais próximos dentro do intervalo. Fora: Retorna os valores mais próximos ocorridos imediatamente fora do intervalo. Interpolado: Retorna valores interpolados nas horas inicial e final. Auto: Interpolado, mas usando o comportamento de Dentro para tags com atributos de nível definidos em PI Servers com base no Windows. CONTAGEM DE VALORES Normalmente, a primeira fileira ou coluna do array inclui a contagem de valores recuperados para o intervalo de tempo. Selecione ocultar contagem para ocultar a contagem de valores e mostrar apenas os valores recuperados no array. MOSTRAR ATRIBUTOS DO VALOR Selecione mostrar atributos do valor para exibir bits de status estendidos associados aos valores de evento retornados. Os bits retornados correspondem aos atributos de valor armazenados no PI, e podem ser um dos seguintes: A = anotado, indicando que um comentário foi adicionado ao evento S = substituído, indicando que o valor do evento foi alterado de seu valor original Q = questionável, indicando que há alguma razão para duvidar da exatidão do valor Os atributos de valor são exibidos em uma coluna à direita dos valores do evento. MOSTRAR ANOTAÇÕES Selecione mostrar anotações para exibir quaisquer anotações associadas aos valores de evento retornados em uma coluna à direita. As anotações são observações ou comentários acrescentados a um valor de dados no PI com finalidade descritiva. 30

35 Dados compactados OBSERVAÇÕES ESPECIAIS Referencie um intervalo de nomes de tag para exibir valores compactados para cada um. Observe que, por padrão, os valores são exibidos em fileiras para uma coluna de tags referenciadas, e em colunas para uma fileira de tags referenciadas. Se a Hora inicial ou final for a hora atual (*), o primeiro (ou o último) valor será na realidade o valor instantâneo atual, e não um valor de arquivo. Depois que o valor do instantâneo passar pelo algoritmo de compactação do PI Server, ele poderá não ser realmente registrado no PI. A função PICompFilDat() será usada para funções de Hora final se uma expressão de filtro for especificada; caso contrário, a função PICompDat() será usada. A função PINCompFilDat() será usada para funções Número de valores se uma expressão de filtro for especificada; caso contrário, a função PINCompDat() será usada. EXEMPLO Para consultar os dez valores mais recentes da tag sinusoid, os seguintes argumentos são definidos para a função Dados compactados: Number of Values (Número de valores) Tagname (Nome da tag) = sinusoid Start Time (Hora inicial) = <referência de célula para a hora atual> Number of Values (Número de valores) = 10 backwards in time (voltar no tempo) Boundary Type (Tipo de limite) = inside show timestamps (mostrar carimbos de data e hora) column (coluna) e o array de funções resultante aparece como: Observe que todos os eventos entre duas horas especificadas também poderiam ser recuperados pela mesma função usando o argumento Intervalo de horas. Guia do usuário do PI DataLink 31

36 Funções do PI TÓPICOS RELACIONADOS Expressões de filtro (página 81) PICompDat() (página 99) PICompFilDat() (página 100) PINCompDat() (página 98) PINCompFilDat() (página 98) Dados de amostragem Retorna valores de amostragem interpolados com espaçamento uniforme para um ponto PI ou expressão em um intervalo regular. ARGUMENTOS OBRIGATÓRIOS Nome de tag ou expressão Hora inicial Hora final Intervalo de tempo INTERVALO DE TEMPO Insira um intervalo de tempo como uma expressão de tempo do PI (página 77). O intervalo é a frequência de amostragem usada para coletar ou calcular valores durante o intervalo de tempo. Por exemplo, o intervalo 15m (15 minutos) retorna um valor a cada intervalo de 15 minutos. EXPRESSÃO DE FILTRO Adicione uma expressão de filtro a fim de filtrar valores de evento usando uma expressão matemática, eliminando dados para os quais a expressão é avaliada como falsa. A expressão de filtro é aplicada aos dados brutos do PI (e não a valores resultantes do próprio cálculo). Por exemplo, a expressão de filtro simples: sinusoid < 70 removeria do cálculo todos os valores acima de 70. Também é possível usar qualquer equação de desempenho válida do PI na expressão de filtro para criar expressões mais complexas a fim de remover picos atípicos nos valores de dados, por exemplo. Selecione marcar como filtrado para substituir Filtrado como um espaço reservado para cada valor ou bloco de valores filtrados do array com base na expressão (página 81) do filtro. 32

37 Dados de amostragem OBSERVAÇÕES ESPECIAIS É possível usar uma Expressão do PI (página 81) em vez do nome de uma tag para essa função. Referencie um intervalo de nomes de tag para exibir valores de amostragem para cada um. Observe que, por padrão, os valores são exibidos em fileiras para uma coluna de tags referenciadas, e em colunas para uma fileira de tags referenciadas. A função PISampFilDat() será usada se uma expressão de filtro for especificada; caso contrário, a função PISampDat() será usada. PIExpDat() será usada se uma Expressão do PI for substituída para uma tag. EXEMPLO Para consultar valores interpolados periódicos durante as 24 horas anteriores da tag sinusoid, os seguintes argumentos são definidos para a função Dados de amostragem: Tagname (Nome da tag) = sinusoid Start Time (Hora inicial) = -1d End Time (Hora final) = <referência de célula para a hora atual> Time Interval (Intervalo de tempo)= 3h show timestamps (mostrar carimbos de data e hora) column (coluna) e o array de funções resultante aparece como: onde um valor é exibido para cada intervalo de três horas. TÓPICOS RELACIONADOS PISampDat() (página 101) PISampFilDat() (página 102) PIExpDat() (página 104) Guia do usuário do PI DataLink 33

38 Funções do PI Dados com marcação de tempo Retorna valores de amostragem interpolados ou reais para um ponto PI, de forma a corresponder a um array de carimbos de data e hora especificados. ARGUMENTOS OBRIGATÓRIOS Nome da tag Carimbo de data e hora CARIMBO DE DATA E HORA Uma referência a uma ou mais células de planilha que contenham valores de carimbo de data e hora. MODO DE RECUPERAÇÃO Há dois modos disponíveis para seleção: Interpolado - interpola valores correspondentes a carimbos de data e hora especificados. Tempo exato - recupera somente valores exatamente correspondentes a carimbos de data e hora especificados, ou retorna Nenhum evento encontrado se nenhum valor existir. OBSERVAÇÕES ESPECIAIS É possível usar uma Expressão do PI (página 81) em vez do nome de uma tag para essa função. Referencie um intervalo de nomes de tag para exibir valores com marcação de tempo para cada um. Observe que, por padrão, os valores são exibidos em fileiras para uma coluna de tags referenciadas, e em colunas para uma fileira de tags referenciadas. Para tags com atributos de nível, o valor que precede um carimbo de data e hora especificado será substituído por um valor interpolado quando o modo de cálculo for Interpolado. EXEMPLO Para consultar valores correspondentes a um array de carimbos de data e hora para a tag sinusoidu, os seguintes argumentos são definidos para a função Dados com marcação de tempo: Tagname (Nome da tag) = sinusoidu Timestamps (Carimbos de data e hora) = <referência de célula para array existente de dados compactados para a tag sinusoid > Retrieval Mode (Modo de recuperação) = interpolated 34

39 Dados calculados e o array de funções resultante aparece como: onde a coluna de dados com marcação de tempo aparece na coluna à direita, com base nos carimbos de data e hora recuperados para uma tag diferente nas primeiras duas colunas à esquerda. TÓPICOS RELACIONADOS PITimeDat() (página 104) PITimeExpDat() (página 105) Dados calculados Retorna um ou mais valores calculados com espaçamento uniforme com base em valores de ponto PI ou expressões avaliadas. São fornecidos um intervalo de cálculo diferente e preferências de amostragem. Observação: São fornecidas caixas de diálogo separadas para Dados calculados e Dados calculados avançados no PI DataLink for Excel XP Para a versão do Excel 2007, clique no sinal + sign ao lado de Avançado para acessar todas as opções da função em um único painel de tarefas Dados calculados. ARGUMENTOS OBRIGATÓRIOS Nome de tag ou expressão Hora inicial Hora final Fator de conversão Guia do usuário do PI DataLink 35

40 Funções do PI EXPRESSÃO DE FILTRO Adicione uma expressão de filtro a fim de filtrar valores de evento usando uma expressão matemática, eliminando dados para os quais a expressão é avaliada como falsa. A expressão de filtro é aplicada aos dados brutos do PI (e não a valores resultantes do próprio cálculo). Por exemplo, a expressão de filtro simples: sinusoid < 70 removeria do cálculo todos os valores acima de 70. Também é possível usar qualquer equação de desempenho válida do PI na expressão de filtro para criar expressões mais complexas a fim de remover picos atípicos nos valores de dados, por exemplo. Selecione marcar como filtrado para substituir Filtrado como um espaço reservado para cada valor ou bloco de valores filtrados do array com base na expressão (página 81) do filtro. INTERVALO DE TEMPO Insira um intervalo de tempo como uma expressão de tempo do PI (página 77). O intervalo é a frequência de amostragem usada para coletar ou calcular valores durante o intervalo de tempo. Por exemplo, o intervalo 15m (15 minutos) retorna um valor a cada intervalo de 15 minutos. MODO DE CÁLCULO Os seguintes cálculos são fornecidos: Total Mínimo Máximo Desvio padrão Intervalo Média Contagem Mediana Todos os modos de cálculo possuem peso de tempo, exceto a função Mediana, que é uma versão com peso de evento da função Média. BASE DE CÁLCULO Selecione uma base com peso de tempo ou de evento para o cálculo: Os cálculos possuem peso de tempo por padrão. Cada valor de evento é ponderado com finalidade de cálculo pela duração de tempo ao qual o evento é aplicado. Os cálculos com peso de evento ponderam cada valor de evento igualmente. Deve haver pelo menos um evento (dois para cálculos de desvio padrão) em um intervalo de tempo para que o cálculo tenha êxito. 36

41 Dados calculados FATOR DE CONVERSÃO O fator de conversão é usado para cálculos de Total em que a unidade de tempo do ponto calculado não é a mesma que a unidade de tempo padrão do servidor. Um fator de conversão poderá ser necessário para converter nas unidades desejadas para o cálculo a partir do padrão do servidor para unidades por dia. A tabela a seguir ilustra o uso de fatores de conversão para pontos usando diferentes unidades de fluxo. Observe que o fator de conversão igual a um significa que ele não é necessário, e que as unidades não podem ser especificadas. Unidade de fluxo Fator de conversão necessário para corresponder ao padrão do servidor (unidades/dia) Unidades/dia 1.0 Unidades/hora 24 Unidades/minuto 1440 Unidades/segundo MODO DA AMOSTRAGEM DE EXPRESSÃO Diferentes modos de amostragem estão disponíveis para funções que incluem expressões: Para cálculos de PI tag, selecione um dos três modos de amostragem. ο O modo Ponto compactado é o padrão usado para cálculos de PI tag. Esse modo considera os carimbos de data e hora da PI tag para a qual o cálculo está sendo executado. Ele não considera carimbos de data e hora para outras PI tags usadas na expressão do filtro. Esse modo executa o cálculo usando os intervalos de tempo entre carimbos de data e hora em que a expressão de filtro é avaliada como verdadeira. Ponto compactado é menos caro computacionalmente que o modo Expressão compactada; entretanto, o modo Expressão compactada gera resultados mais exatos. ο O modo Expressão compactada considera os carimbos de data e hora de PI tags usadas na expressão de filtro. Ele não considera os carimbos de data e hora da PI tag para a qual o cálculo está sendo executado, a menos que a PI Tag seja usada na expressão de filtro. Esse modo determina os intervalos para os quais a expressão de filtro é verdadeira e depois executa o cálculo usando o valor interpolado das extremidades do intervalo. O modo Expressão compactada produz resultados mais exatos ao custo do desempenho. ο O modo Interpolado avalia a expressão em intervalos de amostragem com espaçamento uniforme determinados pela Frequência da amostragem de expressão. Para cálculos de expressão do PI, selecione um dos dois modos de amostragem: ο O modo Compactado avalia a expressão para cada valor de evento nos carimbos de data e hora correspondentes. ο O modo Interpolado avalia a expressão em intervalos de amostragem com espaçamento uniforme determinados pela Frequência da amostragem de expressão. Guia do usuário do PI DataLink 37

42 Funções do PI FREQUÊNCIA DA AMOSTRAGEM DE EXPRESSÃO Especifique a frequência na qual um cálculo ou expressão de filtro é avaliada quando o Modo da amostragem de expressão estiver definido como Interpolado. Por exemplo, a frequência 10m (10 minutos) retorna um valor interpolado a cada intervalo de 10 minutos enquanto a expressão de filtro for avaliada como verdadeira. PERCENTUAL MÍNIMO VÁLIDO Especifique o percentual de dados válidos (página 19) mínimo requerido em cada intervalo de tempo a fim de calcular e retornar um valor. Dados válidos insuficientes é substituído como um espaço reservado quando um valor não é retornado. CARIMBOS DE DATA E HORA Selecione mostrar hora inicial para exibir a Hora inicial de cada intervalo usado para calcular um valor. As horas iniciais são adicionadas a uma coluna à esquerda ou a uma fileira acima dos valores calculados. Selecione mostrar hora final para exibir a Hora final de cada intervalo usado para calcular um valor. As horas finais são adicionadas a uma coluna à esquerda ou a uma fileira acima dos valores calculados. Para cálculos de Máximo, Mínimo e Intervalo, selecione mostrar hora mín/máx para exibir carimbos de data e hora correspondentes a mínimos e/ou máximos em cada intervalo usado para calcular um valor: ο Para cálculos de Mínimo e Máximo, o carimbo de data e hora do valor correspondente é exibido. ο Para funções de Intervalo, os dois carimbos de data e hora são exibidos. PERCENTUAL VÁLIDO Selecione mostrar percentual válido para exibir o percentual de tempo para o qual valores válidos são retornados durante o intervalo de tempo total do array. Valores percentuais válidos normalmente são adicionados a uma coluna à direita ou a uma fileira abaixo dos valores recuperados. Valores válidos são valores de evento determinados como válidos pelo PI server, e não em um estado de erro. O percentual de valores válidos ajuda na avaliação da confiabilidade de cálculos efetuados em valores de ponto PI, especialmente se os valores calculados devem ser usados em cálculos adicionais. OBSERVAÇÕES ESPECIAIS É possível usar uma Expressão do PI (página 81) em vez do nome de uma tag para essa função. Referencie um intervalo de nomes de tag para exibir valores calculados para cada um. Observe que, por padrão, os valores são exibidos em fileiras para uma coluna de tags referenciadas, e em colunas para uma fileira de tags referenciadas. Para cálculos de Máximo ou Mínimo com intervalos especificados, os carimbos de data e hora indicam a hora inicial de cada intervalo de cálculo. 38

43 Dados calculados Os carimbos de data e hora não podem ser exibidos para os cálculos Total, Desvio Padrão, Média, Contagem ou Mediana quando o intervalo não for especificado. A função PIAdvCalcVal() será usada para recuperar um único valor se não for especificado um intervalo; caso contrário, a função PIAdvCalcDat() será usada para recuperar múltiplos valores de intervalo. Os nomes de função, incluindo 'Exp' e 'Fil' são usados para cálculos que incluem Expressões do PI e Expressões de filtro, respectivamente. EXEMPLO Para consultar o intervalo de valores por hora que começam no mesmo dia à meia-noite até a hora atual para a tag sinusoid, os seguintes argumentos são definidos para a função Dados calculados: PI Tag Tagname (Nome da tag) = sinusoid Start Time (Hora inicial) = t End Time (Hora final) = * Time Interval (Intervalo de tempo) = 1h Calculation Mode (Modo de cálculo) = range Calculation Basis (Base de cálculo) = time-weighted show start time (mostrar hora inicial) show end time (mostrar hora final) column (coluna) e o array de funções resultante aparece como: onde o intervalo é calculado para cada intervalo de uma hora. Observe que qualquer cálculo disponível poderia ser especificado para qualquer intervalo. Guia do usuário do PI DataLink 39

44 Funções do PI TÓPICOS RELACIONADOS Expressões de cálculo (página 81) PIAdvCalcVal() (página 108) PIAdvCalcFilVal() (página 109) PIAdvCalcExpVal() (página 111) PIAdvCalcExpFilVal() (página 112) PIAdvCalcDat() (página 114) PIAdvCalcFilDat() (página 114) PIAdvCalcExpDat() (página 116) PIAdvCalcExpFilDat() (página 117) Hora filtrada Retorna a quantidade de tempo durante a qual uma expressão do PI é avaliada como verdadeira para um intervalo de tempo especificado. Observação: Os resultados de Hora filtrada variam um pouco dependendo da versão do PI Server. ARGUMENTOS OBRIGATÓRIOS Expressão Hora inicial Hora final Unidades de tempo INTERVALO DE TEMPO Insira um intervalo de tempo como uma expressão de tempo do PI (página 77). O intervalo é a frequência de amostragem usada para coletar ou calcular valores durante o intervalo de tempo. Por exemplo, o intervalo 15m (15 minutos) retorna um valor a cada intervalo de 15 minutos. UNIDADES DE TEMPO Especifique as unidades de tempo usadas para exibir o resultado da expressão calculada. OBSERVAÇÕES ESPECIAIS É possível inserir a expressão em uma célula de planilha e referenciar o nome da célula na função. Inicie as expressões com uma aspa simples se desejar que o Excel interprete a expressão como uma string. 40

45 Hora filtrada EXEMPLO Para consultar a quantidade de tempo para a qual o valor da tag sinusoid estava acima de 75 durante um período de sete dias, os seguintes argumentos são definidos para a função Hora filtrada: Expression (Expressão) = sgn('sinusoid'-75)=1 Start Time (Hora inicial) = -7d End Time (Hora final) = * Time Units (Unidades de tempo) = h show percent good (mostrar percentual válido) column (coluna) e o array de funções resultante aparece como: onde os resultados mostram que o valor da tag estava acima de 75 por 7,85 horas durante os sete dias anteriores. TÓPICOS RELACIONADOS Expressões de cálculo (página 81) PITimeFilterVal() (página 119) PITimeFilter() (página 118) Guia do usuário do PI DataLink 41

46

47 Capítulo 4 PI Tags e atributos Um ponto PI é um fluxo de dados em tempo real de uma origem definida, descrito por um nome de tag correspondente e outros atributos. No PI DataLink e neste guia, os pontos PI são frequentemente referidos como PI tags e os termos são usados de maneira um pouco intercambiável. Entretanto, uma tag é simplesmente um nome para um ponto PI. Ao recuperar dados do PI para uma planilha do Excel, o nome da tag é o atributo do PI mais comumente usado para referir-se a dados de um ponto PI. Os nomes de PI tag podem ajudar a identificar dados de pontos, descrever a origem dos arrays e valores de dados da função, e serem referenciados como atributos para recuperar dados. Esta seção descreve o uso de tags e outros atributos de ponto na criação de uma planilha do PI DataLink, incluindo os seguintes: recuperação direta de tags para células da planilha, e funções usadas para resolver nomes de tag de outros atributos de ponto, ou recuperar atributos com base em um nome de tag. Pesquisa de tags Use a caixa de diálogo Pesquisa de tags para consultar diretamente o PI server por nomes de PI tag a serem copiadas para funções e planilhas. As tags selecionadas são copiadas para a planilha ou adicionadas a um campo de edição Nome de tag como um argumento de função. Para acessar a pesquisa de tags: Clique em Pesquisa de tags na faixa de opções do PI (2007), ou escolha PI > Pesquisa de tags (2003), ou clique em Pesquisa de tags ao lado de um campo Nome de tag. A caixa de diálogo Pesquisar marca fornece três tipos de pesquisas: Pesquisa básica permite que você crie uma máscara da marca especificando atributos da tag do PI. A máscara é usada para encontrar uma lista de marcas no servidor com atributos correspondentes. Pesquisa avançada fornece uma interface de criação de consulta com acesso a mais atributos da tag para pesquisas complexas. Pesquisa de alias fornece uma exibição de árvore lógica de um PI Server por meio do Banco de dados do módulo do PI, que você pode usar para selecionar marcas por seus aliases descritivos. Guia do usuário do PI DataLink 43

48 PI Tags e atributos Para procurar marcas: 1. Clique em uma guia para escolher uma pesquisa Básica, Avançada ou Alias. 2. Insira os critérios de pesquisa necessários e clique em Pesquisar. Use '*' ou '?' como caracteres curingas para procurar nomes e atributos de marca. Por exemplo, a máscara da marca Tem* retorna todos os nomes de ponto que começam com Tem enquanto Tem? retorna apenas os pontos que começam com Tem e terminam com outro caractere único. Todos os campos da máscara do ponto diferem letras maiúsculas e minúsculas. Você também pode clicar em Favoritos para acessar pesquisas anteriores. 3. As marcas retornadas de uma pesquisa aparecem listadas em um painel de resultado da pesquisa. Selecione as marcas desejadas no painel de resultados e clique em OK. Clique nos cabeçalhos da coluna no painel de resultados da pesquisa para classificar os resultados. Tecla Ctrl ou Tecla Shift para selecionar várias marcas. 44

49 Funções de tag Dicas de pesquisa de tags Se várias tags forem selecionadas, o primeiro nome de tag selecionado na lista será copiado para o campo Nome de tag de uma referência de função. A célula atual será adotada como o ponto inicial para uma lista de tags copiadas para uma planilha ao longo de uma única coluna ou fileira, dependendo da configuração de Copiar itens para planilha. Escolha Em uma fileira ou Em uma coluna nos atalhos da Pesquisa de tags no menu da faixa de opções do PI (2007) para copiar os nomes de várias tags para a planilha em uma fileira ou coluna de valores, respectivamente. O nome do PI Server correspondente a uma tag será acrescentado ao nome da tag se a configuração Copiar nome do PI Server estiver habilitada. Funções de tag A seção a seguir descreve as funções de tag do PI DataLink. Essas funções podem ser usadas para resolver IDs de ponto PI ou outros atributos de ponto em um nome de tag correspondente. Também é possível recuperar outros valores de atributo do ponto com base em um nome de tag. Para acessar as funções de tag: Clique na célula de saída desejada e escolha PI > (nome da função) para abrir um diálogo de função (XP-2003), ou clique em uma função na faixa de opções do PI para abrir um novo painel de tarefa de função (2007). As funções de tag usam componentes de função (página 13) comuns. ID de ponto para tag Retorna o nome da tag que corresponde a uma ID de ponto PI específica. CAMPOS OBRIGATÓRIOS ID do ponto EXEMPLO Para recuperar o nome de uma tag correspondente a uma ID de ponto PI, os seguintes argumentos são definidos para a função ID de ponto para tag: Point ID (ID de ponto) = (referência para uma célula que contém o valor de uma ID de ponto) e o array de funções resultante aparece como: Guia do usuário do PI DataLink 45

50 PI Tags e atributos onde o nome da tag é exibido na coluna à direita, com base em uma referência para a célula que contém a ID de ponto à esquerda. TÓPICOS RELACIONADOS PIPointIDToTag() (página 120) Máscara de atributo para tag Retorna uma lista de nomes de tag no PI que correspondem a um ou mais valores de atributo de tag especificados. CAMPOS OBRIGATÓRIOS Um ou mais dos seguintes campos são requeridos para recuperar valores correspondentes: Nome da tag Descritor Origem do ponto Tipo de ponto Classe ponto Unidades de engenharia EXEMPLO Para recuperar os nomes de tags correspondentes a um ou mais atributos de ponto especificados, os seguintes argumentos são definidos para a função Máscara de atributo para tag: Tagname (Nome da tag) = BA* Point Type (Tipo de ponto) = Float32 e o array de funções resultante aparece como: 46

51 Funções de tag Observe que strings de atributos devem corresponder a valores de atributo no PI, e curingas podem ser usados. A função opera da mesma forma que uma pesquisa de tags (página 43). TÓPICOS RELACIONADOS PIAttributeMaskToTag () (página 120) Atributos de tag Recupera um atributo associado a um nome de PI tag especificado. CAMPOS OBRIGATÓRIOS Nome da tag Atributo ATRIBUTO Especifique o atributo de tag a ser recuperado do PI. OBSERVAÇÕES ESPECIAIS Referencie um intervalo de nomes de tag para exibir atributos para cada um. A lista de atributos de tag disponíveis depende da classe de ponto associada à tag. EXEMPLO Para recuperar atributos de um ponto PI com base no nome da tag, os seguintes argumentos são definidos para a função Atributos da tag: Tagname (Nome da tag) = (referência para um array de células que contém nomes de tag) Attributes (Atributos) = pointid (coluna 2), pointsource (coluna 3), pointtype (coluna 4), descriptor (coluna 5) e os arrays de funções resultantes aparecem como: onde os nomes de tag são referenciados na coluna à esquerda, e uma função Atributos da tag separada é usada para cada coluna de atributo. TÓPICOS RELACIONADOS PITagAtt() (página 121) Guia do usuário do PI DataLink 47

52

53 Capítulo 5 Objetos do banco de dados do módulo O PI Module Database fornece uma maneira totalmente diferente de criar a infraestrutura de uma planilha. Se o banco de dados do módulo do PI server estiver configurado e incluir objetos que representem as tags que você deseja usar, as planilhas poderão ser mais facilmente criadas e fornecer mais flexibilidade e potencial de reuso. O PI Module Database normalmente é configurado pelo administrador do sistema ou do PI, e armazena aliases e propriedades que referem-se a pontos PI e seus atributos, respectivamente. A estrutura hierárquica desses objetos fornece um contexto relacional entre pontos. Por exemplo, você pode ter cinco pontos PI que representam os níveis de cinco tanques individuais idênticos. Cada ponto tem um nome de tag diferente e representa um objeto físico diferente, mas seus requisitos de uso e monitoramento são os mesmos. Ao recuperar objetos do banco de dados do módulo, é possível criar uma única planilha construída com base nos aliases e propriedades que representam os cinco tanques. As funções do banco de dados do módulo resolvem esses objetos em nomes de tag e valores de atributos. Os caminhos de módulo paralelo para cada tanque fornecem um contexto diferente para as referências do alias. Com esse tipo de estrutura, é possível usar a mesma planilha para alternar entre exibições de múltiplos ativos. Por exemplo, ao selecionar o nome de qualquer um dos cinco tanques em uma célula da planilha, o mapeamento do alias para o ponto PI correspondente permite que as funções do DataLink recuperem valores do tanque apropriado. Os tópicos a seguir descrevem as ferramentas fornecidas pelo PI DataLink para acessar objetos do PI Module Database. Consulte a documentação do PI Server para obter informações adicionais sobre bancos de dados de módulo e a configuração. Procurar banco de dados do módulo A caixa de diálogo Procurar banco de dados do módulo permite procurar por aliases de PI, propriedades e caminhos de módulo no PI Module Database, uma estrutura em árvore hierárquica com base no conteúdo de um PI Server. É possível selecionar esses itens e copiálos diretamente para uma planilha. Observação: Aliases e propriedades correspondentes a pontos PI devem ser configurados no PI server Module Database para usar as funções de procura e do Module Database. Guia do usuário do PI DataLink 49

54 Objetos do banco de dados do módulo Para procurar e selecionar no PI Module Database: 1. Selecione uma célula e clique em Procurar módulo na faixa de opções do PI ou escolha PI > Procurar módulo. A caixa de diálogo Procurar banco de dados do módulo será exibida. 2. Em Tipos, selecione o tipo de objeto que está procurando: ο ο ο Alias Propriedade Módulo Use a lista suspensa PI Server para exibir bancos de dados de módulo para diferentes PI servers conectados. 3. Especifique uma Data da consulta e horário para fornecer um contexto temporal para objetos exibidos no banco de dados do módulo, se necessário, para selecionar a versão correta do objeto. 50

55 Funções do banco de dados do módulo 4. Navegue no controle da árvore para localizar o item desejado e adicionar o item ou um objeto de coleção pai à planilha ο ο Selecione um item para copiá-lo para a planilha. Selecione os Aliases ou as Propriedades pai de um módulo para copiar todos os aliases ou as propriedades associados para a planilha. 5. Selecione Copiar caminho do módulo para copiar o caminho completo do módulo do alias ou da propriedade para uma célula de planilha adjacente, juntamente com o objeto selecionado. O caminho do módulo fornece o contexto para o objeto selecionado Se a configuração Copiar nome do PI Server estiver ativada, o nome do PI server correspondente também será copiado. 6. Clique em OK para fechar a caixa de diálogo e copiar os itens selecionados. Funções do banco de dados do módulo A seção a seguir descreve as funções do banco de dados do módulo do PI DataLink. As funções do Banco de dados do módulo resolvem aliases e propriedades da árvore de um banco de dados do módulo em nomes de tag por meio de um caminho de módulo. É possível inserir um caminho de módulo como um argumento de função ou referenciá-lo a partir de uma célula da planilha. Para acessar as funções do banco de dados do módulo: Clique na célula de saída desejada e escolha PI > (nome da função) para abrir um diálogo de função (XP-2003), ou clique em uma função na faixa de opções do PI para abrir um novo painel de tarefa de função (2007). Observação: Não é possível resolver um alias ou um objeto de propriedade para um nome de tag sem um caminho de módulo. O caminho fornece um contexto para o alias que o mapeia para um ponto PI específico. As funções do Banco de dados do módulo usam componentes de função (página 13) comuns. Alias para tag Retorna um nome de tag do PI correspondente a um alias do PI especificado. ARGUMENTOS OBRIGATÓRIOS Alias Caminho do módulo Data da consulta Guia do usuário do PI DataLink 51

56 Objetos do banco de dados do módulo ALIAS Especifique um nome de alias do PI. Um alias pode ser inserido diretamente ou referenciado em uma célula. Também é possível navegar até um alias no PI Module Database. CAMINHO DO MÓDULO Insira o caminho do módulo do PI Module Database onde o alias especificado pode ser encontrado. O caminho do módulo será inserido automaticamente se o argumento alias for selecionado navegando-se no Module Database. DATA DA CONSULTA Especifique uma data para recuperar uma versão específica do alias. TÓPICOS RELACIONADOS PIAliasToTag() (página 123) Propriedade para valor Retorna um ou mais valores correspondentes a uma propriedade especificada do PI. O DataLink pode retornar valores para tipos de propriedade Boolean, Date, Double, Integer, Long, Null, Single e String, ou tipos de propriedade de array Double, Integer, Long e Single. ARGUMENTOS OBRIGATÓRIOS Propriedade Caminho do módulo Data da consulta PROPRIEDADE Especifique um nome de propriedade do PI. Uma propriedade pode ser inserida diretamente ou referenciada em uma célula. Também é possível navegar até uma propriedade no PI Module Database. CAMINHO DO MÓDULO Insira o caminho do módulo do PI Module Database onde a propriedade especificada pode ser encontrada. O caminho do módulo será inserido automaticamente se o argumento propriedade for selecionado navegando-se no Module Database. DATA DA CONSULTA Especifique uma data para recuperar uma versão específica da propriedade. TÓPICOS RELACIONADOS PIPropertyToValue() (página 123) 52

57 Capítulo 6 Planilhas Quando você adiciona uma função a uma planilha, o PI DataLink recupera os dados solicitados do PI Server para um array. O tamanho do array pode variar dependendo da função, quantos valores de arquivo correspondentes estão disponíveis no PI, o número de valores solicitados ou o número de referências de entrada. Os tópicos a seguir fornecem uma visão geral de como as funções do PI DataLink funcionam em uma planilha e como gerenciar e manter a planilha com o passar do tempo. Frequência de cálculo É possível escolher um intervalo de atualização automática para manter os dados da função atualizados nas planilhas, ou usar métodos de recálculo manual e disparados por funções, usados nas versões anteriores do PI DataLink. Para obter informações detalhadas sobre como o Excel gerencia cálculos, consulte o tópico Recálculo do Excel ( na biblioteca do MSDN. Atualização automática A Atualização automática força o Excel a recalcular funções e tendências em planilhas abertas em um intervalo especificado. Para ativar a Atualização automática: Clique no botão de alternância Atualizar na Faixa de opções do PI (2007) ou escolha Atualizar no menu PI (2003). Todas as pastas de trabalho abertas na sessão atual do Excel serão calculadas imediatamente, e depois em intervalos especificados com base nas configurações de preferência da Atualização automática. A Atualização automática permanecerá ativada (com uma mensagem indicativa na barra de status do Excel) até que seja desativada. Durante um evento de recálculo, a barra de status também exibe o intervalo de cálculo. Observação: A Atualização automática não pode atualizar pastas de trabalho protegidas, que são somente leitura. Guia do usuário do PI DataLink 53

58 Planilhas Intervalo de cálculo O intervalo de cálculo é uma configuração de preferência (página 22) medida em segundos, que deve ser maior que 5 segundos. O valor 0 representa um intervalo automático no qual o Datalink ajusta o tempo entre ciclos de cálculo para duas vezes o tempo da duração do cálculo, com um intervalo mínimo de 5 segundos. O intervalo automático é recomendado para assegurar que o Excel permaneça respondendo em 50% do tempo. É possível ajustar manualmente o intervalo da Atualização automática para permitir mais tempo entre as atualizações. Se o recálculo demorar mais que o intervalo especificado, uma mensagem solicitará a alternância para a configuração de intervalo automático ou o desligamento total da Atualização automática. Observe que as atualizações são pausadas quando um menu, painel de tarefas ou caixa de diálogo é aberta, ou quando a planilha atual está no modo de edição. Cancelamento Pressione Esc para cancelar um recálculo em andamento. O DataLink encerra o cálculo da função atualmente em processamento e Cálculo abortado aparece nas células não processadas do array de funções. Se você cancelar durante uma atualização enquanto a Atualização automática estiver ativada, o DataLink desligará a Atualização automática. Recálculo disparado No Excel, as funções são recalculadas com base em um evento de disparo. Se a funcionalidade Atualização automática não for usada, será possível maximizar a frequência de atualização e manter os arrays de funções atualizados referenciando-se funções de tempo voláteis dentro de funções não voláteis do PI DataLink. As funções de tempo voláteis do Excel, como now() e today(), recalculam com a maior frequência. Sempre que um usuário editar uma célula da planilha ou pressionar F9, o Excel atualizará todas as funções de tempo voláteis na planilha. Por sua vez, a atualização dispara quaisquer funções que referenciem um carimbo de data e hora com base em uma função de tempo volátil. Para basear uma função do PI DataLink em uma função volátil do Excel: 1. Use a barra de funções do Excel para inserir uma função volátil em uma célula da planilha. Por exemplo, é possível usar (today()+1/3) para representar 8h do mesmo dia, ou now() como uma referência de célula para substituir a hora atual do PI *. Para criar um carimbo de data e hora absoluto que ao mesmo tempo seja atualizado, use 2-feb-97 00:30:30 + now() - now(). 2. Referencie a célula ao definir os argumentos Hora inicial ou Hora final de uma função do DataLink. 54

59 Funções e valores de array Observação: Para maximizar a frequência das atualizações quando a Atualização automática não estiver em uso, verifique as preferências de cálculo do Excel para assegurar que tanto a planilha quanto o aplicativo estejam definidos como cálculo Automático em vez de Manual. Lembre-se de que isso pode impactar o desempenho e tornar planilhas grandes de difícil utilização. Recálculo manual A maioria das funções do PI DataLink são não voláteis, mas a função Valor atual (página 27) é uma exceção. Valor atual é uma função volátil, atualizada sempre que uma planilha for recalculada. Os valores de função não voláteis não são alterados a menos que um argumento seja alterado, e devem ser atualizados manualmente, por meio de atualização automática usando o modo Calcular por inteiro ou por meio de uma referência a um valor de função volátil. O recálculo manual é o melhor método parar arrays de tamanho variável (página 57), em que o número de valores retornados pode diferir. Se estiverem disponíveis mais valores que o tamanho atual do array, um array não expande para exibir os valores adicionais durante o recálculo, a menos que ele seja recalculado manualmente. Para recalcular manualmente uma única função: Clique com o botão direito do mouse em qualquer parte de um array e escolha Recalcular (Redimensionar) função no menu de contexto. Atualize argumentos de função em qualquer versão do PI DataLink. Os valores do array são atualizados ao clicar em OK ou Aplicar para fechar a caixa de diálogo ou o painel de tarefas, mesmo se nenhuma alteração foi feita nos argumentos da função. As combinações de tecla do Excel também podem ser usadas para recalcular todas as planilhas em uma pasta de trabalho, essencialmente uma versão manual sob demanda da Atualização automática. Para recalcular todas as funções da planilha: Pressione F9 para forçar que todas as funções voláteis (e quaisquer funções que as referenciem) sejam recalculadas. Pressione Ctrl+Alt+Shift+F9 para forçar o recálculo de todas as funções. Funções e valores de array Quando você adiciona uma função a uma planilha, o PI DataLink insere a sintaxe da função ativa na célula de destino. Depois de definida, uma função consulta o PI server e retorna valores, que aparecem na mesma célula usada para inserir a função. A diferença entre o conteúdo real das células e a exibição exposta de valores de dados recuperados por uma função deve ser familiar aos usuários do Microsoft Excel. Para novos usuários do Excel, isso ajuda a manter essa distinção clara, e lembrar que o conteúdo real de uma célula da planilha sempre aparece na barra de fórmulas do Excel e não necessariamente em células individuais da planilha. Guia do usuário do PI DataLink 55

60 Planilhas Por exemplo, ao selecionar uma célula e adicionar uma função Valor atual, você especifica o nome da PI tag cujo valor atual deseja ver no campo Nome de tag. Se inserir a tag sinusoid, o PI DataLink colará a seguinte função na célula de destino: =PICurrVal("sinusoid",0,) O Excel avalia essa função, recupera o valor mais recente de sinusoid do PI e o exibe na célula. Se a célula for selecionada, a sintaxe de função acima aparecerá na barra de fórmulas do Excel. Gerenciamento de arrays Os arrays de funções podem ser movidos internamente, copiados ou removidos de uma planilha. Para selecionar um array, siga um destes passos: Clique e arraste para selecionar cada célula no array. Lembre-se de que o array pode ter valores vazios, que também devem ser selecionados. Clique com o botão direito do mouse em qualquer parte do array e escolha Selecionar função do DataLink no menu de contexto para selecionar todas as células no array. Depois de selecionado, é possível gerenciar facilmente o array: Clique com o botão direito do mouse em qualquer célula no array e escolha a operação Recortar, Copiar, Excluir, Limpar ou Formatar desejada no menu de contexto. Remova manualmente os caracteres $ iniciais da barra de fórmulas para tornar as referências de células relativas. Clique com o botão direito do mouse em uma nova célula e escolha Colar para reinserir um array recortado ou copiado. Coloque o cursor sobre a borda do array selecionado até que um cursor de cruz apareça e, então, clique e arraste o array para uma nova célula a fim de movê-lo. Abra o painel de tarefas ou a caixa de diálogo da função e atualize a Célula de saída (página 57) para colocar o array em um novo local. Observação: É necessário mover ou limpar um array inteiro do Excel, incluindo todas as células, ou o DataLink exibirá uma mensagem de erro: Você não pode alterar parte de um array. Também é possível copiar os valores de um array de funções caso deseje utilizá-los em algum outro lugar em uma planilha. Depois de copiar e colar os valores, eles não mais farão parte de um array de funções; serão simplesmente valores de célula e não estarão atualizados. Para copiar valores de array: Selecione os valores de função desejados, copie-os e use Colar especial para colá-los no local desejado. Não é necessário selecionar a coluna ou a fileira inteira do array para copiar valores. 56

61 Gerenciamento de arrays Argumentos de atualização É possível atualizar um array de funções com novos valores de argumentos: 1. Clique com o botão direito do mouse e selecione o nome da função no menu de contexto (2003 ou 2007), ou exiba o painel de tarefas ou a caixa de diálogo da função. A caixa de diálogo da função correspondente aparecerá e exibirá os argumentos atuais nos campos de edição apropriados. 2. Altere quaisquer parâmetros conforme desejado para atualizar o array com novos argumentos e clique em OK ou Aplicar. Se o argumento Célula de saída for alterado, os resultados dependerão do local da nova referência de célula: ο ο Se a nova referência de célula fizer parte do array original, o array inteiro será movido de maneira que a célula superior mais à esquerda do array seja colocada na célula recém-referenciada. Se a nova referência de célula não fizer parte do array original, este será copiado e colado com a célula superior mais à esquerda localizada na célula recémreferenciada. O array original permanecerá em seu local original. Observe que também é possível editar a sintaxe da função diretamente, pressionando-se F2 para editar na barra de fórmulas do Excel. Pressione Ctrl+Shift+Enter para salvar as edições ao concluir. Redimensionar arrays Quando uma planilha for chamada em momentos diferentes, um número diferente de valores poderá estar disponível para uma função definida. Se o número de valores exceder o tamanho atual do array, este não será expandido para exibir os valores adicionais, a menos que você recalcule manualmente (página 55) a função. Se existirem menos valores que o número original de valores recuperados, valores vazios serão retornados para preencher o array calculado, e serão marcados como #N/A se especificado, ou deixados em branco. Se existirem valores adicionais que não possam ser exibidos, o texto Redimensionar para mostrar todos os valores aparecerá na parte inferior do array de funções, a menos que seja definida uma preferência para desabilitar (página 22) essa mensagem. Para redimensionar o array a fim de ajustar-se aos dados disponíveis: Clique com o botão direito do mouse em qualquer parte de um array e escolha Recalcular (Redimensionar) função no menu de contexto. Normalmente são adicionados valores vazios quando uma função referencia um intervalo que tempo que extrapola a hora atual, usando horas inicial e final relativas. Quando a função for recalculada, o intervalo de tempo abrangerá um novo intervalo, que poderá incluir mais variância de dados e, portanto, um número diferente de eventos registrados no arquivo. Guia do usuário do PI DataLink 57

62 Planilhas Por exemplo, considere uma função de dados compactados criada para solicitar 40 valores, iniciando à meia-noite do dia anterior. Quando a função for recalculada uma semana depois e apenas 35 valores de eventos (incluindo eventos filtrados) estiverem registrados, as cinco células finais do array original serão preenchidas com strings em branco para preservar o tamanho do array. Valores vazios podem alterar a aparência de uma planilha, mas ajudam a assegurar que variâncias em dados registrados sejam incorporadas sem atualizar a função. A fim de manter um tamanho constante para funções Dados compactados (página 29), especifique o número de valores a serem recuperados, em vez de um intervalo de tempo. Ou para exibir apenas uma porção predeterminada dos resultados, especifique um intervalo de células de saída (página 14) limitado. Compartilhar planilhas Se deseja compartilhar dados do PI e tornar as planilhas acessíveis a outros usuários, lembrese das seguintes considerações: É possível enviar uma planilha do PI DataLink para outro usuário do Microsoft Excel. O usuário deve ter o PI DataLink instalado e uma conexão ativa com o mesmo PI server a fim de recalcular funções e ver valores de ponto PI dinamicamente atualizados. Se os usuários não tiverem o PI DataLink instalado, ainda poderão ver os últimos dados salvos na planilha, desde que as Opções de cálculo do Excel estejam definidas como Manual antes da abertura da planilha no Excel. No Excel 2007, clique no botão Office 2007 e clique em Opções do Excel > Fórmulas para acessar essas opções. No Excel XP- 2003, a configuração manual está disponível em Ferramentas > Opções na guia Cálculo. Também é possível salvar em formato HTML ou PDF no Excel 2007 a fim de compartilhar uma planilha estática. É possível copiar e colar (página 56) valores de arrays de funções para novos locais em uma planilha, usando Colar especial. Embora os dados da planilha não mais possam ser recalculados depois de copiados, esse método permite distribuir um instantâneo personalizado dos dados para qualquer pessoa que tenha uma cópia do Excel. Se tiver o Microsoft Office SharePoint Server (MOSS) no ambiente computacional, será possível publicar uma planilha do DataLink em um site do SharePoint e usar o PI DataLink for Excel Services (página 3) para exibir e recalcular dados de função do PI. 58

63 Capítulo 7 Exibições de tendência O PI DataLink inclui um objeto ActiveX de controle de tendência que pode ser inserido em qualquer planilha do excel para exibir a tendência de valores de evento com o passar do tempo. Objetos de tendência inseridos podem exibir dados da planilha e dos pontos PI selecionados. Criar uma tendência Um assistente facilita a inserção e a configuração de tendências. Para inserir uma tendência: 1. Clique na célula em que deseja colocar o canto superior esquerdo do objeto de tendência, clique em PI > Inserir tendência (XP-2003), ou clique em Inserir tendência na faixa de opções PI (2007) para exibir o Assistente de complementos de audiência. Ao selecionar a célula de entrada, considere que o tamanho padrão do objeto de tendência requer aproximadamente 14 x 8 células padrão. Guia do usuário do PI DataLink 59

64 Exibições de tendência 2. Escolha a origem dos nomes de tag: ο ο Selecione Dados na planilha para basear a tendência em valores do array (página 60) que já apareçam em células da planilha. Selecione Dados do PI para basear a tendência em dados de ponto específicos recuperados diretamente do PI (página 61). 3. Conclua as etapas restantes do assistente de tendência. Dados da planilha Se escolher Dados na planilha, o assistente de tendência solicitará que você selecione o intervalo de células que contém os dados para o qual deseja gerar a tendência. Para especificar dados da planilha para a tendência: 1. Clique no campo Intervalo de células contendo dados e depois clique e arraste para selecionar um intervalo de células na planilha. A menos que desmarque Incluir todas as células em um array, será necessário selecionar apenas uma célula de um array de funções. O resto do array é adicionado automaticamente à referência do intervalo de células ao clicar em Adicionar. Para pontos de dados discretos que não façam parte de um array, ainda será necessário selecionar cada célula desejada. 60

65 Criar uma tendência 2. Selecione Primeiro elemento é o nome do traço para usar o valor de uma célula adjacente para nomear o traço na tendência. O primeiro elemento será a célula acima do primeiro valor do intervalo selecionado se os dados estiverem organizados em formato de coluna, e a primeira célula à esquerda do primeiro valor do intervalo para dados em formato de fileira. 3. Selecione Nível para plotar uma tendência em nível em vez de um traço contínuo. Essa opção normalmente é especificada para tags discretas. 4. Clique em Adicionar para adicionar o intervalo de células selecionado à tendência. 5. Adicione referências de célula conforme necessário ou clique em Avançar ou Concluir para continuar. Dados do PI Caso escolha Dados do PI, o assistente de tendência solicita que você referencie ou pesquise por nomes de PI tag. Para especificar dados do PI para a tendência: 1. Clique no campo Nome de tag e depois clique e arraste para selecionar um intervalo de células na planilha. Também é possível inserir diretamente uma referência de célula ou usar o botão de referência para exibir um diálogo de referência usado para procurar e adicionar referências de células. Guia do usuário do PI DataLink 61

66 Exibições de tendência Você também pode clicar no botão de seleção para pesquisar por tags (página 43) no PI. As tags selecionadas por meio de uma pesquisa de tags são adicionadas automaticamente à lista de traços. 2. Altere o nome do servidor padrão (se necessário) no campo Nome do servidor e clique em Adicionar para adicionar as referências de nome de tag selecionadas à tendência. É possível usar o botão de referência para exibir um diálogo de referência usado para procurar e adicionar referências de células. 3. Adicione nomes de tags conforme necessário ou clique em Avançar ou Concluir para continuar. Gerenciar traços Ao construir uma tendência a partir da planilha ou de dados do PI, você acumula traços no painel de traços à direita da tela do assistente. Vários controles são fornecidos para gerenciar os traços que aparecem na tendência: Marque a caixa de seleção Marcadores ao lado do nome de um traço para exibir marcadores no traço a fim de indicar o local dos pontos de dados arquivados. Observação: Os traços são desenhados em cores diferentes. Por padrão, uma tendência também inclui marcadores de cor oculta para diferenciar traços em telas monocromáticas. Os marcadores de cor oculta têm espaçamento uniforme ao longo de um traço e não indicam pontos de dados arquivados. Clique nos botões de seta acima do painel de traços para mover traços para cima e para baixo na exibição da legenda de traços. Clique nos botões X e X tudo para remover traços selecionados e todos, respectivamente. Clique no botão Renomear para renomear um traço selecionado na legenda de traços. Especificar o intervalo de tempo Quando os traços de tendência forem determinados, o assistente solicitará que você especifique um intervalo de tempo para a tendência se algum dos traços for desenhado diretamente do PI. Para especificar um intervalo de tempo: 1. Clique nos campos Hora inicial e Hora final e depois clique para selecionar uma célula de carimbo de data e hora na planilha. Também é possível inserir diretamente uma string de tempo ou usar o botão de referência para exibir um diálogo de referência usado para procurar e adicionar referências de células. 62

67 Título e posicionamento Observação: Caso insira uma string de tempo combinada ou absoluta (página 77), certifique-se de usar o formato correto de carimbo de data e hora. 2. Selecione Habilitar atualizações para atualizar a tendência com novos dados do PI se o intervalo de tempo for alterado ou estender-se até o presente. 3. Escolha Avançar ou Concluir para continuar. Título e posicionamento Completar a tendência e determinar seu local na tela final. Para completar a tendência: 1. Insira o Título da tendência. 2. Desmarque Mostrar atributos do valor se não deseja que os atributos de valor apareçam ao longo dos traços de tendência. Os ícones aparecerão quando o intervalo de dados contiver eventos que tenham definidos os bits Questionável, Substituído ou Anotado. 3. Selecione um local diferente para a tendência, se desejado, colocando-a em uma planilha separada ou alterando a célula de posicionamento padrão. Se Nova planilha for selecionado, a tendência será colocada em uma planilha em branco no canto superior esquerdo. Guia do usuário do PI DataLink 63

68 Exibições de tendência Se Planilha existente for selecionado, a célula (ou intervalo usado para dimensionar a tendência) em que a tendência será colocada deverá ser especificada ou referenciada no campo associado. Se alterar a célula de posicionamento padrão, certifique-se de que a nova célula não contenha dados (que serão convertidos pela exibição de tendência). Menu de contexto Depois que uma tendência for inserida em uma planilha, será possível atualizar, editar ou gerenciá-la usando o menu de contexto. Para acessar as opções do menu de contexto: Clique com o botão direito do mouse na exibição de tendência e escolha uma opção no menu: ο Escolha Alterar escala para alterar a escala do eixo y e o intervalo de tempo. ο Escolha Reverter para desfazer quaisquer alterações e reverter às configurações de tendência originais definidas no Assistente de complementos de audiência. ο Escolha Barra de rolagem para habilitar uma barra de rolagem na parte inferior da tendência a fim de rolar a exibição pelos intervalos de tempo adjacentes. ο Escolha Formato para editar a exibição de traços individuais ou as tendências como um todo usando o diálogo Propriedades do controle de tendências. É possível alterar a cor ou a espessura da linha de um traço, ou ainda adicionar itens de legenda à tendência. 64

69 Menu de contexto ο ο ο Escolha Definir tendência para exibir a tela de definição de traço do assistente de tendência para atualizar ou alterar as origens de traço. Escolha Definir Tendência e Intervalo de horas para exibir a tela de definição do intervalo de tempo do assistente de tendência a fim de atualizar o intervalo de tempo. Escolha Excluir tendência para remover a tendência da planilha. Observação: Uma tendência excluída não pode ser restaurada e deverá ser recriada. ο ο ο Escolha Exportar dados para colar os valores usados para plotar a tendência em células da planilha. É possível especificar formato de fileira ou coluna e também exportar nomes de tendências como cabeçalhos. Escolha Mover/Redimensionar e insira um local de célula para mover o canto superior esquerdo da tendência para a célula especificada. Insira um intervalo de células para redimensionar a tendência. Escolha Copiar/Colar para copiar a exibição de tendência inteira para a área de transferência e solicitar uma célula de destino para colar o controle. Guia do usuário do PI DataLink 65

70

71 Capítulo 8 Notificações O PI DataLink inclui um suplemento Pesquisa de notificações do PI que pode ser usado para recuperar notificações assinadas a partir do PI System e inseri-las diretamente em planilhas. O suplemento do Excel PI Notifications é instalado com o PI DataLink 4.0, executado nos sistemas operacionais Windows XP e posteriores, e requer o Excel XP ou versões posteriores. Observação: Você deve ter uma conta em pelo menos um PI System que execute um servidor PI AF 2.0 com o PI Notifications 1.0, e ter assinado pelo menos uma regra de notificação para receber notificações. Para obter informações sobre o PI Notifications, consulte o Guia do usuário do PI Notifications. Para iniciar o visualizador PI Notifications: Clique no ícone Notificações na faixa de opções do PI (2007) ou escolha PI > Pesquisa de notificações (2003). Guia do usuário do PI DataLink 67

72 Notificações Pesquisar e exibir notificações É possível usar o visualizador PI Notifications para pesquisar e recuperar notificações que você tenha assinado em um PI System acessível. Um PI System é um banco de dados de elementos estruturais e eventos de notificação que o ajudam a trabalhar com dados no PI server. Para pesquisar notificações: 1. Na guia Pesquisar, selecione um PI System a fim de pesquisar notificações: ο Escolha um sistema no menu PI System e clique em Conectar para conectar-se ao PI System selecionado. Clique no botão de reticências Systems (página 69) ao menu. para acessar a Lista de sistemas e adicionar PI ο Clique em Referência para referenciar o nome de um PI System em uma célula da planilha. Clique novamente no botão para exibir o menu PI System. 2. Escolha uma opção no menu Exibir notificações para filtrar a lista de notificações retornadas. ο ο ο Escolha Ativo para exibir todas as notificações atualmente ativas. Escolha Intervalo de tempo e insira valores de Hora inicial e Hora final para retornar notificações que ocorram durante um intervalo de tempo específico. Escolha Recente e insira um número e um intervalo de tempo para retornar as notificações mais recentes durante um período de tempo específico. 3. Altere a Célula de saída para colocar a lista de notificações em uma célula diferente da planilha, se desejado. 68

73 Pesquisar e exibir notificações 4. Clique em Pesquisar. As notificações retornadas pela pesquisa aparecerão no visualizador Histórico de notificações (página 70). 5. Clique em OK para inserir o conteúdo do visualizador Histórico de notificações na planilha (página 71) e fechar a caixa de diálogo. A consulta de notificações será inserida na planilha no local designado como uma função. Como outras funções do PI, os dados de notificação serão atualizados quando a planilha recalcular (página 54). Clique em Cancelar para fechar a caixa de diálogo, descartando os resultados da pesquisa. Adicionar PI Systems Pode haver vários PI Systems no ambiente, cada um dos quais pode ter o PI Notifications instalado, e ser uma origem de notificações relevantes para você. Por exemplo, você pode assinar notificações de PI systems em execução em diferentes instalações, ou representando diferentes unidades de negócio. Para receber essas notificações, é necessário assinar ou solicitar que o administrador o inscreva para receber notificações de cada PI system, usando o aplicativo PI System Explorer e adicionar cada PI System ao visualizador PI Notifications. Para adicionar sistemas ao menu PI System: 1. Clique em Lista de sistemas. A caixa de diálogo Sistemas será exibida. 2. Clique com o botão direito do mouse no painel de sistemas e escolha Novo PI System. Clique com o botão direito do mouse em uma entrada de PI system existente para alterar propriedades ou especificar um sistema padrão. Guia do usuário do PI DataLink 69