PI Builder
Guia do usuário
No PI Asset Framework 2.9 incluído no PI Server 2017
OSIsoft, LLC.
1600 Alvarado Street San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Web: http://www.osisoft.com
Guia do usuário do PI Builder
© 2014-2017 OSIsoft, LLC. Todos os direitos reservados.
Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema de recuperação ou transmitida, em qualquer forma ou por quaisquer meios, sejam mecânicos, de fotocópia, registro ou outro, sem a prévia autorização por escrito da OSIsoft, LLC.
OSIsoft, o logotipo e a logomarca da OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services, OSIsoft Connected Services, PI ACE, PI Advanced Computing Engine, PI AF SDK, PI API, PI Asset Framework, PI Audit Viewer, PI Builder, PI Cloud Connect, PI Connectors, PI Data Archive, PI DataLink, PI DataLink Server, PI Developer’s Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC driver, PI Manual Logger, PI Notifications, PI ODBC, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI Vision, PI Visualization Suite, PI Web API, PI WebParts, PI Web Services, RLINK e RtReports são todos marcas comerciais da OSIsoft, LLC. Todas as outras marcas ou nomes comerciais usados neste documento são de propriedade de seus respectivos proprietários.
DIREITOS DO GOVERNO DOS EUA
O uso, a duplicação ou a divulgação pelo Governo dos EUA estão sujeitos às restrições definidas no contrato de licença da OSIsoft, LLC e conforme fornecido nas DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, conforme aplicável. OSIsoft, LLC.
Versão: 2.9
Conteúdo
Introdução ao PI Builder... 1
Visão geral do PI Builder...1
Processo de instalação do PI Builder...1
Visualizar o PI Builder em um idioma com suporte... 2
Configuração do PI Data Archive para o PI Builder...2
Desinstalar o PI Builder... 2
Configuração do suplemento do Microsoft Excel para o PI Builder... 3
Ver status do suplemento...3
Habilitar um suplemento desabilitado...4
Ativar um suplemento inativo... 4
Habilitar a função Publicar em planilhas protegidas... 4
Sugestões de recursos...5
Fundamentos do PI Builder... 7
Conexões... 7
Especificar um banco de dados...7
Especificar um servidor do PI Data Archive...8
Tarefas comuns... 8
Defina os cabeçalhos de colunas em uma planilha...9
Recuperar dados de objetos definidos... 12
Publicar objetos...12
Criar objetos PI AF... 13
Editar objetos PI AF...14
Excluir objetos PI AF... 15
Configurações... 16
Definir as configurações de recuperação... 16
Definir as configurações de construção... 20
Erros na recuperação ou publicação... 20
Tempo PI... 21
Abreviações de tempos relativos PI... 21
Expressões de tempo do PI...22
Especificação de timestamp...22
Especificação de período de tempo... 23
Pontos PI... 25
Criar pontos PI... 25
Recuperar todas as tags do PI... 26
Recuperar tags do PI por pesquisa...26
Sintaxe para pesquisas por tags do PI...29
Editar pontos PI...31
Excluir pontos PI...32
Usar as planilhas criadas com o PI Tag Configurator... 32
Estados digitais... 35
Criar estados digitais... 35
Recuperar todos os estados digitais... 36
Recuperar estados digitais selecionados... 36
Editar estados digitais... 37
Excluir estados digitais... 38
Elementos... 39
Criar vários elementos e gerar pontos PI referenciados automaticamente...41
Elementos filho... 43
Recuperar todos os elementos... 43
Recuperar elementos por pesquisa... 44
Configurar as condições para um valor de atributo... 47
Caracteres especiais nas pesquisas por nome... 48
Recuperar elementos por navegação... 48
Editar elementos com o PI Builder... 49
Redefinir regras de tempos para especificação de elementos...49
Atributos... 51
Exibição de atributos...51
Mostrar atributos em colunas ... 52
Mostrar atributos em linhas...53
Mostrar atributos em linhas e colunas... 55
Recuperar atributos por pesquisa... 55
Referências de dados...57
Mostrar valores das referências de dados... 58
Referências de dados nas colunas de atributos... 58
Colunas específicas de atributos para referências de dados... 59
Strings de configuração de atributo no PI Builder... 60
Criação de ponto PI durante a publicação... 63
Lista de parâmetros de substituição do PI AF... 63
Strings de formato para os parâmetros de substituição de tempo... 67
Atributos Filho... 68
Redefinir atributos para especificação de template...69
Modelos...71
Recuperar todos os modelos...71
Recuperar modelos selecionados...71
Estruturas de eventos... 73
Recuperar event frames usando a pesquisa... 73
Recuperar atributos da estrutura de eventos usando a pesquisa... 77
Recuperar estruturas de eventos de pesquisa salvas... 77
Transferências... 79
Recuperar transferências usando a pesquisa... 79
Recuperar atributos de transferência usando a pesquisa... 80
Recuperar transferências de pesquisas salvas...80
Segurança... 81
Recuperar todas as PI Identities...81
Recuperar as PI identities selecionadas... 81
Recuperar todos os mapeamentos de PI identities... 82
Recuperar os mapeamentos de PI identities selecionadas...82
Recuperar todas as identidades de segurança... 83
Recuperar as identidades de segurança selecionadas... 83
Recuperar todos os mapeamentos de segurança... 84
Recuperar os mapeamentos de segurança selecionados... 84
Categorias... 85
Recuperar todas as categorias...85
Recuperar as categorias selecionadas... 85
Recuperar todas as categorias de um tipo específico...86 Conteúdo
Templates... 87
Recuperar templates selecionados... 87
Recuperar todos os templates de um tipo específico...88
Conjuntos de enumerações... 89
Recuperar todos os conjuntos de enumerações...89
Recuperar conjuntos de enumerações selecionados...89
Tipos de referência... 91
Recuperar todos os tipos de referências... 91
Recuperar tipos de referências selecionados... 91
Unidades de medida... 93
Recuperar todas as unidades de medida...93
Recuperar unidades de medida das classes UDM selecionadas...93
Contatos... 95
Recuperar todos os contatos...95
Recuperar contatos selecionados... 95
Recupere todos os endpoints da notificação... 96
Recupere os endpoints da notificação selecionados... 96
Entrada de valor...99
Objetos que recebem valores...99
Tipos de valores... 99
Tipos de valores com suporte... 99
Tipos de valor com suporte parcial...100
Tipos de valores sem suporte...101
Formatos de valores... 101
Valores nulos... 103
Referência de coluna... 105
Colunas de templates de casos...106
Colunas de categorias... 109
Colunas de contato... 109
Colunas de conjuntos de estados digitais...110
Colunas de elementos...111
Colunas de templates de elementos... 115
Colunas de enumeration sets...119
Colunas de event frames... 120
Colunas de templates de event frames... 124
Colunas de modelos... 127
Colunas de templates de modelos... 131
Colunas de endpoint da notificação... 134
Colunas da tag do PI... 135
Colunas de tipo de referência... 139
Colunas de PI identity...140
Colunas de mapeamento de PI identity... 141
Colunas de identidade de segurança...141
Colunas de mapeamento de segurança... 142
Colunas de transferência... 142
Colunas de templates de transferências... 146
Colunas banco de dados de UOM... 149
Colunas de classe UDM... 150 Conteúdo
Tutorial do PI Builder... 151
Criar vários elementos vinculados a novos pontos PI...151
Criar os templates da bomba de calor... 151
Criar os elementos da bomba de calor... 153
Verificar a criação de elementos da bomba de calor...155
Criar vários elementos vinculados aos pontos PI existentes... 156
Criar pontos PI para reatores... 156
Criar os templates do reator... 158
Criar os elementos do reator...159
Configurar as referências de dados para o atributo de temperatura... 161
Editar elementos e atributos... 164
Editar o template do reator... 165
Editar os elementos do reator para especificar novos valores do atributo... 167
Recuperar um elemento com um número de série específico... 168
Recuperar elementos com datas de manutenção específicas...169
Suporte técnico e outros recursos... 171
ConteúdoIntrodução ao PI Builder
Bem-vindo(a) ao PI Builder. Esta seção fornece uma visão geral do PI Builder e discute sua instalação e configuração.
Alterações na terminologia
A OSIsoft está revisando sua terminologia para refletir o crescimento PI System em relação a sua arquitetura original de servidor único. Na terminologia revisada, PI Data Archive refere-se ao componente que armazena dados de séries temporais (anteriormente chamado de PI Server) e PI Server refere-se a PI Data Archive e PI Asset Framework. Este documento usa a terminologia revisada.
Nesta seção
• Visão geral do PI Builder
Com o PI Builder, é possível usar o Microsoft Excel para criar, visualizar e modificar objetos no banco de dados do PI AF ou dos pontos PI no PI Data Archive.
• Processo de instalação do PI Builder
Execute o kit de instalação para instalar o PI Builder e o pacote de idiomas para visualizar a interface em idiomas diferentes do inglês.
• Configuração do suplemento do Microsoft Excel para o PI Builder
Para usar o PI Builder, o suplemento de aplicativo PIAFBuilder deve estar ativo no Microsoft Excel.
• Habilitar a função Publicar em planilhas protegidas
• Sugestões de recursos
Visão geral do PI Builder
O PI Builder é um suplemento do Microsoft Excel que permite que o Excel seja usado para criar, visualizar e modificar objetos no banco de dados do PI Asset Framework (PI AF) ou pontos PI no PI Data Archive. Com o PI Builder, é possível fazer facilmente mudanças em lote e realizar estas tarefas:
• Criar, editar e excluir pontos PI no PI Data Archive ou editar os atributos desses pontos. • Criar várias cópias dos objetos PI AF (elementos e atributos, categorias, conjuntos de
enumerações, templates, classes de UOM, UOMs, tipos de referências, event frames, transferências, portas, valores de enumeração e propriedades estendidas).
• Copiar objetos existentes do PI AF. Se for necessário criar muitos objetos semelhantes na estrutura, será possível criar apenas um e usar o PI Builder para fazer cópias dessa configuração do template.
• Alterar as configurações de objetos existentes. Por exemplo, é possível alterar qual ponto PI está associado a um atributo do PI AF.
Processo de instalação do PI Builder
Para preparar o computador para usar o PI Builder, instale o PI Builder usando o kit de instalação PI AF Client baixado da OSIsoft. Feche o Microsoft Excel antes de instalar o PI Builder ou outros componentes no kit de instalação do PI AF Client. Consulte a documentação de instalação do PI AF para obter mais informações. Também é possível instalar pacotes de
idiomas para visualizar a interface de usuário em idiomas diferentes do inglês. Considere também a configuração do PI Data Archive para garantir que tenha acesso apropriado aos pontos PI.
Nesta seção
• Visualizar o PI Builder em um idioma com suporte
Instale o pacote de idiomas MUI do PI AF Client para visualizar a interface do usuário do PI Builder em um idioma diferente do inglês.
• Configuração do PI Data Archive para o PI Builder
Para ler e gravar dados do ponto PI, o PI Builder precisa de certas configurações no PI Data Archive.
• Desinstalar o PI Builder
Use o Windows para desinstalar o PI Builder.
Visualizar o PI Builder em um idioma com suporte
O PI Builder suporta vários idiomas. Instale o pacote de idiomas de MUI (Multilingual User Interface) do PI AF Client para visualizar a interface de usuário do PI Builder no mesmo idioma do Microsoft Excel. Se o PI Builder não tiver suporte ao idioma selecionado no Excel, a interface do usuário do PI Builder aparecerá em inglês.
Procedimento
1. Defina o idioma desejado no Microsoft Excel: a. Instale o pacote de idiomas do Microsoft Office.
b. Use a ferramenta de configuração do idioma do Microsoft Office para alterar o idioma do Microsoft Excel.
2. Baixe o pacote de idiomas MUI do PI AF Client no site de Suporte Técnico da OSIsoft (https://techsupport.osisoft.com).
3. Instale o pacote de idiomas MUI do PI AF Client.
Configuração do PI Data Archive para o PI Builder
O PI Builder pode recuperar e gravar dados no PI Data Archive. No entanto, o PI Builder deve se conectar ao PI Data Archive e ter acesso apropriado aos pontos. Isso pode exigir alterações de configuração de:
• Banco de dados do firewall. O banco de dados do firewall em cada computador do PI Data Archive deve ser configurado para permitir acesso dos computadores cliente que executam o PI Builder.
• Autenticação e autorização. Os usuários do PI Builder devem poder autenticar a identidade deles usando o PI Data Archive e ter acesso ao PI Data Archive. A OSIsoft recomenda usar PI mappings. Também é possível usar PI trusts ou autenticação por senha do PI. A OSIsoft não recomenda a autenticação por senha do PI por ser um método menos seguro.
• Definições de ponto. Os pontos devem ser definidos para dar aos usuários autorizados acesso de leitura e, se necessário, de escrita.
Para obter mais informações, consulte a documentação do PI Data Archive.
Desinstalar o PI Builder
Use o Windows para desinstalar o PI Builder. Introdução ao PI Builder
Procedimento
1. Feche o Microsoft Excel.
2. Abra o Painel de Controle e clique em Programas e Recursos (ou Adicionar/remover programas).
3. Na lista de aplicativos instalados, clique em Cliente do PI AF e escolha a opção apropriada
para remover o PI Builder:
◦ Clique em Desinstalar para remover o PI Builder, o PI System for OpenVMS e o PI AF SDK.
◦ Clique em Alterar e depois em Modificar para alterar a instalação para remover apenas o
PI Builder.
Nota:
Não mova nem exclua o PI Builder pelo Windows Explorer. Nunca exclua o diretório PIPC\AF sem antes desinstalar o PI Builder, o PI System for OpenVMS, o PI AF SDK e o servidor do PI AF.
Configuração do suplemento do Microsoft Excel para o PI
Builder
O PI Builder tem um suplemento de aplicativo para o Microsoft Excel.
Nome Localização Tipo
PIAFBuilder ..\PIPC\AF\PIAFBuilder.vsto Suplemento de COM
Para usar o PI Builder, esse suplemento de aplicativo deverá estar ativo. O programa de instalação instala e ativa o suplemento do PI Builder. Em casos raros, o Microsoft Excel pode desativar um suplemento. Para usar um suplemento desativado, habilite e depois ative o suplemento.
Nota:
Para ativar um suplemento de aplicativo você deve ter privilégios de administrador no computador. Se não tiver privilégios de administrador, clique com o botão direito em Excel.exe no Windows Explorer e clique em Executar como administrador para
executar o Microsoft Excel como administrador.
Nesta seção
• Ver status do suplemento
• Habilitar um suplemento desabilitado
• Ativar um suplemento inativo
Ver status do suplemento
Verifique o status de um suplemento para saber se ele está ativo, inativo ou desabilitado.
Procedimento
1. Clique na guia Arquivo e em Opções. (No Microsoft Excel 2007, clique no Botão do Microsoft Office e em Opções do Excel.)
2. Na janela Opções do Excel, clique em Suplementos.
3. Pesquise na lista de suplementos para encontrar o status atual de um suplemento. Cada suplemento estará listado em uma destas opções:
◦ Suplementos Ativos de Aplicativo
◦ Suplementos Inativos de Aplicativo
◦ Suplementos Desabilitados de Aplicativo
Habilitar um suplemento desabilitado
Se um suplemento estiver desabilitado, habilite-o antes de ativá-lo.
Procedimento
1. Clique na guia Arquivo e em Opções. (No Microsoft Excel 2007, clique no Botão do Microsoft Office e em Opções do Excel.)
2. Na janela Opções do Excel, clique em Suplementos.
3. Na lista Gerenciar, selecione Itens Desabilitados e clique em Ir.
4. Marque a caixa de seleção ao lado do suplemento. 5. Clique em Habilitar.
Ativar um suplemento inativo
Ative um suplemento inativo para disponibilizá-lo no Microsoft Excel.
Nota:
Para ativar um suplemento do aplicativo, é necessário ter privilégios de administrador no computador. Se não tiver privilégios de administrador, clique com o botão direito do mouse em Excel.exe no Windows Explorer e clique em Executar como administrador
para executar o Microsoft Excel como administrador.
Procedimento
1. Clique na guia Arquivo e em Opções. (No Microsoft Excel 2007, clique no Botão do Microsoft Office e em Opções do Excel.)
2. Na janela Opções do Excel, clique em Suplementos.
3. Na lista Gerenciar, selecione Suplementos de COM e clique em Ir.
4. Marque a caixa de seleção ao lado do suplemento. 5. Clique em OK.
Habilitar a função Publicar em planilhas protegidas
Não é possível publicar alterações em uma planilhaPI Builder protegida, exceto se você tiver permissão para formatar células.
Procedimento
1. Para publicar em planilhas protegidas, selecione Arquivo > Informações.
2. Na página Informações, clique em Proteger Workbook > Proteger Planilha Atual. 3. Na janela Proteger Planilha, selecione Formatar células e clique em OK.
Ao clicar em Publicar, a janela Opções de publicação é exibida. Para obter mais informações,
consulte Publicar objetos. Introdução ao PI Builder
Sugestões de recursos
Com o lançamento do PI Builder 2017, é possível fazer sugestões de recursos que você gostaria que fossem adicionados ao PI Builder. Também é possível ver as sugestões enviadas por outros usuários e votar naquelas que você aprova.
Para fornecer feedback, selecione Feedback e clique em Entrar. Você pode digitar seu feedback
no campo Insira sua ideia e fornecer mais detalhes conforme julgar necessário.
Fundamentos do PI Builder
Com o PI Builder, é possível trabalhar com pontos PI e objetos PI AF no Microsoft Excel. O Excel permite a criação, recuperação, edição e exclusão de pontos PI e objetos PI AF. Os tópicos desta seção descrevem tarefas comuns e informações úteis para trabalhar com o PI Builder. Consulte as próximas seções para ver os tópicos que descrevem tarefas mais específicas e informações sobre como trabalhar com pontos PI e determinados objetos PI AF.
Nesta seção
• Conexões
Para recuperar e publicar dados, o PI Builder requer conexões para um servidor e um banco de dados do PI AF ou um servidor do PI Data Archive.
• Tarefas comuns
As tarefas comuns dão suporte a muitos dos procedimentos que você deseja realizar com o PI Builder, como a configuração dos cabeçalhos de colunas da planilha ou a recuperação e edição dos objetos PI AF.
• Configurações
As configurações controlam o comportamento do PI Builder ao recuperar e publicar dados em uma planilha.
• Erros na recuperação ou publicação
O PI Builder gera erros para tentativas mal sucedidas para recuperar ou publicar objetos. Esses erros podem ser vistos em prompts durante a operação ou no relatório de erros após a operação.
• Tempo PI
Conexões
Para recuperar e publicar objetos PI AF, o PI Builder deve se conectar ao banco de dados do PI AF (em um servidor do PI AF); para recuperar e publicar Pontos PI, o PI Builder precisa se conectar a um servidor do PI Data Archive. Portanto, antes de recuperar ou publicar dados com o PI Builder, especifique o banco de dados do PI AF ou o servidor do PI Data Archive.
Nesta seção
• Especificar um banco de dados
Use o grupo Conexões para especificar o banco de dados do PI AF ao qual o PI Builder se
conecta ao recuperar e publicar objetos do PI AF. • Especificar um servidor do PI Data Archive
Use o grupo Conexões para especificar o servidor do PI Data Archive ao qual o PI Builder se
conecta ao recuperar e publicar pontos PI.
Especificar um banco de dados
Para recuperar e publicar objetos do PI AF, o PI Builder deve se conectar a um banco de dados do PI AF. Use o grupo Conexões para especificar o servidor do PI AF e o banco de dados. Depois
de especificar um banco de dados do PI AF, o PI Builder se conecta automaticamente ao servidor e ao banco de dados do PI AF para qualquer operação que precise de comunicação com o servidor ou banco de dados. É possível especificar um banco de dados diferente a qualquer momento.
Procedimento
1. Na guia PI Builder, no grupo Conexões, especifique o servidor e o banco de dados do PI AF:
a. Na lista Servidor de Ativos, selecione o servidor do PI AF que armazena o banco de
dados.
b. Na lista Banco de Dados, selecione o banco de dados.
Se a lista não mostrar o servidor ou banco de dados necessários, selecione Conexões do Banco de Dados/Servidor de Ativos de uma das listas para abrir a janela Selecionar Banco de
Dados. Nessa janela, é possível:
◦ Selecione um servidor do PI AF e um banco de dados.
◦ Clique em Novo Banco de Dados para adicionar um novo banco de dados.
◦ Clique em Mostrar Lista para abrir a janela Servidores do PI AF, na qual você pode adicionar e conectar-se a um servidor do PI AF.
Especificar um servidor do PI Data Archive
Para recuperar e publicar pontos PI, o PI Builder deve se conectar a um servidor do PI Data Archive. Use o grupo Conexões para especificar o servidor do PI Data Archive. Depois de
especificar um servidor do PI Data Archive, o PI Builder se conecta automaticamente ao servidor do PI Data Archive especificado para qualquer operação que precise de comunicação com o PI Data Archive. É possível especificar um servidor do PI Data Archive diferente a qualquer momento.
Procedimento
1. Na guia PI Builder, no grupo Conexões da lista Servidor de Dados, selecione o servidor do PI
Data Archive que armazena os seus pontos PI.
Se a lista não mostrar o servidor do PI Data Archive necessário, selecione Conexões de Servidor de Dados para abrir a janela PI Data Archives. Nessa janela, é possível:
◦ Selecionar um servidor do PI Data Archive ao qual se conectar.
◦ Clique em Adicionar Servidor de Dados para especificar informações de conexão com um
servidor do PI Data Archive não listado.
◦ Selecione um servidor e clique em Configurar como Padrão para que o PI Builder se
conecte a esse servidor quando o Microsoft Excel for aberto.
Tarefas comuns
As tarefas comuns descritas nesta seção serão usadas para realizar muitos procedimentos com o PI Builder. Por exemplo, ao recuperar dados do PI AF ou do PI Data Archive, é necessário sempre configurar os cabeçalhos de colunas na planilha. Da mesma forma, os procedimentos a serem recuperados, editados e excluídos são os mesmos para a maioria dos objetos PI AF.
Nesta seção
• Defina os cabeçalhos de colunas em uma planilha
Use a janela Selecionar Tipos de Objetos e Cabeçalhos de Colunas para especificar os cabeçalhos de colunas e organizá-los na planilha.
• Recuperar dados de objetos definidos
Use o comando Atualizar para recuperar ou atualizar dados de objetos definidos na planilha.
• Publicar objetos
Clique em Publicar, configure as opções do PI Builder na janela Publicar Objetos e clique em OK para publicar os dados da planilha em um servidor.
• Criar objetos PI AF
Use o PI Builder para especificar novos objetos no Microsoft Excel e crie esses objetos no PI AF.
• Editar objetos PI AF
Use o PI Builder para editar objetos PI AF no Microsoft Excel e publique as alterações no PI AF.
• Excluir objetos PI AF
Use o PI Builder para excluir os objetos PI AF localizados em uma planilha do Microsoft Excel do PI AF.
Defina os cabeçalhos de colunas em uma planilha
Use a janela Selecionar Tipos de Objetos e Cabeçalhos de Colunas para especificar os cabeçalhos de colunas e organizá-los na planilha. Quando configurada nas configurações de recuperação, essa janela abre automaticamente ao recuperar dados. Também é possível clicar em
Cabeçalhos para adicionar colunas à planilha antes de recuperar ou publicar dados ou de
reorganizar as colunas de uma planilha existente sem substituir a planilha.
Procedimento
1. Abra a janela Selecionar Tipos de Objetos e Cabeçalhos de Colunas. É possível: ◦ Na guia PI Builder, no grupo Recursos clique em Cabeçalhos.
◦ Recupere os dados. Com as configurações de recuperação padrão, a janela Selecionar Tipos de Objetos e Cabeçalhos de Colunas será aberta depois que os objetos a serem recuperados forem especificados.
2. Na lista Tipo de Objeto, selecione o tipo de objeto do PI System a ser recuperado na
planilha.
A lista Tipos de Objetos é atualizada para mostrar as colunas possíveis para o tipo de objeto
selecionado no PI System. As colunas selecionados e a organização são baseadas na planilha atual ou nas seleções anteriores. Para uma lista de colunas, consulte Referência de coluna. 3. Para restaurar a ordem padrão das colunas, clique em Redefinir.
4. Para apagar todas as seleções de colunas, clique em Apagar Tudo.
5. Marque as caixas de seleção ao lado das colunas que devem ser exibidas na planilha. A lista Tipos de Objetos não contém automaticamente todos os atributos que podem ser
mostrados em colunas. Para adicionar colunas de atributos à lista de colunas disponíveis, é possível:
◦ Na lista Template, selecione o template no qual os objetos recuperados estão baseados.
A lista Tipos de Objetos atualiza as colunas de atributos disponíveis para mostrá-las no
template selecionado.
◦ Clique em Mais Colunas de Atributos para abrir a janela Selecionar Atributos e especifique
os atributos a serem adicionados:
▪ Selecione os atributos de um template.
▪ Selecione os atributos de determinada instância de um objeto PI System, como atributos personalizados que não seja de um template.
▪ Digite o nome do atributo no campo Outros e clique em Adicionar.
Nota:
Inclua a coluna ObjectType, a menos que esteja usando uma planilha criada com o PI Tag Configurator.
6. Para alterar a ordem das colunas, selecione uma coluna e clique na seta para cima ou para baixo.
7. Clique em OK para aplicar as alterações na planilha.
O PI Builder atualiza o conteúdo da planilha existente para refletir as alterações:
◦ Se uma janela tiver sido aberta durante a recuperação dos dados, o PI Builder recupera os dados disponíveis nas colunas selecionadas.
◦ Se a janela tiver sido aberta de forma independente, o PI Builder não recupera os dados nas colunas, nem mesmo nas colunas recém-adicionadas. Clique em Atualizar para
atualizar e recuperar os dados nas colunas recém-adicionadas.
Strings de segurança
É possível usar o PI Builder para atribuir permissões de acesso a um objeto. Durante a recuperação, selecione as colunas de segurança apropriadas na janela Selecione Tipos de Objetos e Cabeçalhos de Colunas.
Tipo de objeto Coluna Descrição
Objeto PI AF SecurityString Use essa coluna para especificar a string de segurança que controla o acesso a objetos PI AF. Essa coluna pode ser encontrada no grupo do tipo de objeto, por exemplo, no grupo de objetos Elemento dos elementos PI AF.
Ponto PI datasecurity Use essa coluna para especificar a string de segurança para obter acesso a eventos e snapshots. Essa string controla quais usuários podem ler ou modificar os dados armazenados para um ponto PI.
Essa coluna pode ser encontrada no grupo de objetos Segurança.
ptsecurity Use essa coluna para especificar a string de segurança para obter acesso à configuração do ponto. Essa string controla quais usuários podem recuperar as informações de configuração, como valores do atributo do ponto, e quais usuários podem modificar ou excluir um ponto PI. Essa coluna pode ser encontrada no grupo de objetos Segurança.
A string de segurança tem este formato:
userid1:access_type1(rights1)|userid2:access_type2(rights2)|... useridN:access_typeN(rightsN)
no qual:
• useridX identifica um usuário. As entradas válidas dependem do tipo de objeto: Fundamentos do PI Builder
◦ Para objetos PI AF: usuários ou contas de grupo do Microsoft Windows ◦ Para pontos PI: um usuário PI, um grupo PI ou uma identidade PI • access_typeY indica o tipo de regra de acesso.
• rightsZ indica as permissões afetadas pela regra. Especifique as permissões entre parênteses e separe várias permissões com uma vírgula. Os pontos PI só são compatíveis com permissões de leitura e gravação.
Por exemplo, a string de segurança a seguir dá à conta Everyone permissões de leitura e leitura de dados e dá também à conta ACME\bob permissões de leitura, gravação, leitura de dados, gravação de dados e exclusão:
ACME\bob:A(r,w,rd,wd,d)|Everyone:A(r,rd)
A tabela a seguir lista as regras de acesso compatíveis e o valor correspondente a ser inserido na string de segurança:
Tipo de regra de acesso Valor da string de segurança
Permitir acesso A
Negar acesso D
A tabela a seguir lista as permissões compatíveis e o valor correspondente que deve ser inserido na string de segurança. Os pontos PI só são compatíveis com permissões de leitura e gravação.
Permissão Valor da string de segurança
Ler r Gravar w Excluir d Executar x Admin a Ler dados rd Gravar dados wd Inscrever-se s Inscrever outros so Anotar an Nota:
Caso uma string de segurança não seja especificada durante a publicação de um objeto, o PI Builder usará as configurações padrão.
IDs exclusivos
Pode-se recuperar um ID exclusivo do objeto no Microsoft Excel. Durante a recuperação, marque a caixa de seleção UniqueID na janela Selecione Tipos de Objetos e Cabeçalhos de
Colunas para listar os IDs localizados na coluna UniqueID da planilha.
Recupere os IDs exclusivos no Microsoft Excel apenas para fins informativos. Não se pode usar o PI Builder para atribuir ou alterar uma ID exclusiva do objeto.
Recuperar dados de objetos definidos
Use o comando Atualizar para recuperar ou atualizar dados de objetos definidos na planilha.
Por exemplo, se colunas e os dados mínimos para identificar objetos forem especificados, por exemplo, nome e tipo de objeto, será possível usar o comando Atualizar para recuperar os
dados desses objetos. Da mesma forma, se colunas forem adicionadas a uma planilha existente, será possível usar o comando Atualizar para recuperar os dados de algumas colunas novas.
Procedimento
1. Abra a planilha com objetos definidos.
2. Defina a coluna Selected(x) como X para qualquer objeto que desejam-se atualizar os dados ou recuperar os novos dados.
3. Na guia PI Builder, no grupo Recuperar, clique em Atualizar.
Nas linhas com x na coluna Selected(x), o PI Builder atualiza os dados e recuperar os novos dados apropriados.
Publicar objetos
Para publicar os dados do Microsoft Excel no PI AF ou no PI Data Archive, prepare a planilha, clique em Publicar e configure as opções para a publicação.
Procedimento
1. Prepare a planilha para publicação:
a. Coloque os novos objetos pai em linhas antes dos objetos filho que fazem referência a eles. Por exemplo, se novos elementos e atributos forem criados, coloque os elementos em linhas antes dos atributos.
b. Coloque notas e valores que não se deseja publicar em colunas sem cabeçalhos. c. Coloque as linhas e colunas vazias corretamente. O PI Builder publica dados por linha,
mas não processa nenhuma linha depois encontrar duas linhas totalmente vazias e não processa nenhuma coluna depois de encontrar duas colunas totalmente vazias.
d. Coloque um X na coluna Selected(x) em qualquer linha que você deseja que o PI Builder processe. O PI Builder ignora linhas sem um X nessa coluna.
2. Na guia PI Builder, clique em Publicar.
3. Na janela Opções de Publicação, insira as configurações para controlam as ações do PI Builder durante a publicação:
◦ Na lista Modo de Edição, selecione o método de processamento de linhas ao publicar
dados em um servidor: ▪ Criar e Editar
O PI Builder edita objetos que já existem e cria objetos que não existem. ▪ Criar Apenas
O PI Builder cria novos objetos e gera um erro se um objeto já existir. ▪ Editar Apenas
O PI Builder edita objetos existentes e gera um erro se um objeto ainda não existir. ◦ Marque a caixa de seleção Criar ou atualizar pontos PI para que o PI Builder crie
de dados do ponto PI. (Essa caixa de seleção não estará disponível após a publicação dos objetos do ponto PI no PI Data Archive.)
◦ Marque a caixa de seleção Criar automaticamente as categorias ausentes para que o PI
Builder crie as categorias ausentes. (Essa caixa de seleção não estará disponível após a publicação dos objetos do ponto PI no PI Data Archive.)
4. Clique em OK para começar a publicar.
A janela Publicar Objetos Selecionados mostra as operações concluídas. 5. Clique em Fechar.
O PI Builder verifica automaticamente todas as alterações feitas no banco de dados do PI AF durante a publicação.
Criar objetos PI AF
Com o PI Builder, é possível inserir as especificações de novos objetos PI AF em uma planilha do Microsoft Excel e publicar a planilha no PI AF para criá-los. Os recursos de preenchimento automático do Excel permitem a criação fácil de vários objetos com especificações
semelhantes. Siga este procedimento para criar: • Elementos • Atributos • Estruturas de eventos • Transferências • Templates • Modelos • Categorias • Conjuntos de enumerações • Tipos de referência • Unidades de medida • Contatos • Endpoints da notificação
• Identidades de segurança e mapeamentos
Antes de Iniciar
Especificar um banco de dados.
Procedimento
1. Na planilha, adicione os cabeçalhos de colunas dos valores que devem ser especificados para definir os novos objetos.
Consulte Defina os cabeçalhos de colunas em uma planilha. Nos objetos baseados em templates, inclua a coluna Template.
Dica:
Para criar novos objetos com base nos objetos existentes, recupere os objetos existentes na planilha e altere o nome e quaisquer outros atributos.
2. Em cada linha, especifique os valores que definem um novo objeto.
É necessário especificar um nome exclusivo para cada objeto. Se valores para outros atributos não forem especificados, o PI AF configurará esses atributos para seus valores padrão.
3. Defina a coluna Selected(x) como X para qualquer objeto que deseja se criar. 4. Publique em PI AF:
a. Clique em Publicar para abrir a janela Opções de publicação.
b. Na lista Modo de Edição, selecione Apenas Criar.
Com essa escolha, o PI Builder apenas criará objetos novos. Se já existir um objeto com o mesmo nome, o PI Builder gerará um erro. Também é possível selecionar Criar e Editar
para que o PI Builder modifique os objetos existentes e crie os objetos que ainda não existem. O PI Builder usa a coluna Nome para encontrar os objetos existentes com o mesmo nome.
c. Se for especificado um atributo que faz referência a uma tag do PI que ainda não existe, marque a caixa de seleção Criar ou Atualizar PI Points para solicitar que o PI Builder crie
automaticamente as tags do PI necessárias.
Se essa caixa de seleção não estiver marcada, será necessário usar o PI System Explorer ou o PI Builder para criar ou atualizar tags do PI depois que o PI Builder criar os objetos PI AF.
d. Se for especificado um atributo que faz referência a uma categoria que ainda não existe, marque a caixa de seleção Criar automaticamente categorias ausentes para solicitar que
o PI Builder crie automaticamente as categorias necessárias.
Se essa caixa de seleção não estiver marcada e uma ou mais categorias não existirem, o PI Builder gerará um erro durante a publicação.
e. Clique em OK para publicar os objetos no PI AF.
O PI Builder verifica automaticamente as alterações. A janela Objetos selecionados de publicação mostra as operações concluídas.
f. Clique em Fechar.
Editar objetos PI AF
É possível usar o PI Builder para editar objetos PI AF no Microsoft Excel e publicar as
alterações no PI AF. Através das edições, você pode renomear objetos, mover objetos ou alterar diversos valores de propriedade. Siga este procedimento para editar:
• Elementos • Atributos • Estruturas de eventos • Transferências • Templates • Modelos • Categorias • Conjuntos de enumerações • Tipos de referência • Unidades de medida • Contatos Fundamentos do PI Builder
• Endpoints da notificação
• Identidades de segurança e mapeamentos
Antes de Iniciar
Recupere os objetos PI AF no Microsoft Excel. Consulte os tópicos específicos do objeto para obter mais detalhes.
Procedimento
1. Se necessário, adicione mais colunas que correspondem às propriedades que deseja alterar e clique em Atualizar para recuperar os valores atuais.
Consulte Defina os cabeçalhos de colunas em uma planilha.
2. Opcional: apague todos os valores da coluna Selected(x) na planilha.
Marque apenas as linhas contendo edições com um X. Apagar as colunas antes de iniciar pode ajudar a monitorar quais linhas foram alteradas.
3. Edite os valores a serem alterados.
Para alterar o nome do objeto, inclua a coluna NewName e insira o nome do novo nome nessa coluna.
Para alterar o pai e mover o objeto na hierarquia, inclua a coluna NewParent e insira o novo pai nessa coluna.
Não é possível alterar todos os valores da propriedade. De forma específica, o PI Builder ignora as alterações feitas nas propriedades de somente leitura. Isso varia de acordo com o objeto. Consulte Referência de coluna para obter detalhes.
4. Na coluna Selected(x), defina o valor como X para qualquer linha na qual um valor foi editado e apague o valor de qualquer linha não alterada.
5. Publique as alterações no PI AF:
a. Na guia PI Builder, clique em Publicar para abrir a janela Opções de Publicação.
b. Na lista Modo de Edição, selecione Apenas Editar para se proteger contra a criação
incorreta de novos objetos.
c. Clique em OK para publicar as alterações no PI AF.
Se qualquer um dos objetos selecionados ainda não existir, o PI Builder gerará um erro.
Excluir objetos PI AF
Depois de recuperar os objetos PI AF no Microsoft Excel, será possível usar o PI Builder para excluir os objetos selecionados do PI AF. Siga este procedimento para excluir:
• Elementos • Atributos • Estruturas de eventos • Transferências • Templates • Modelos • Categorias • Conjuntos de enumerações Fundamentos do PI Builder
• Tipos de referência • Unidades de medida • Contatos
• Endpoints da notificação
• Identidades de segurança e mapeamentos
Antes de Iniciar
Ative o botão Excluir. Consulte Definir as configurações de construção.
Procedimento
1. Recupere os objetos PI AF no Microsoft Excel. (Consulte os tópicos específicos do objeto para obter mais detalhes.)
Dica:
Para excluir os atributos, mostre-os nas linhas. Consulte Mostrar atributos em linhas. 2. Nos objetos a serem excluídos, insira X na coluna Selected(x).
CUIDADO:
Apague a coluna dos objetos a serem mantidos. 3. Na guia PI Builder, no grupo Criar clique em Excluir.
4. No prompt de confirmação, clique em Sim.
O PI Builder exclui os objetos selecionados do PI AF. A janela Excluir objetos selecionados mostra as operações concluídas.
Configurações
Faça as configurações apropriadas para controlar o comportamento do PI Builder ao recuperar e publicar dados em uma planilha. Além disso, uma configuração de build ativa o botão Excluir.
Nesta seção
• Definir as configurações de recuperação
Use a guia Recuperar na janela Configurações para definir as configurações que afetam o
comportamento do PI Builder ao recuperar dados de uma planilha ou selecionar cabeçalhos de colunas da planilha.
• Definir as configurações de construção
Use a guia Construir da janela Configurações para definir as configurações que afetam as
opções padrão na janela Opções de Publicação e o comportamento do PI Builder ao publicar dados da planilha no PI AF ou no PI Data Archive.
Definir as configurações de recuperação
Use a guia Recuperar na janela Configurações para definir as configurações que afetam o
comportamento do PI Builder ao recuperar dados de uma planilha ou selecionar cabeçalhos de colunas da planilha.
Procedimento
1. Abra a janela Configurações: Fundamentos do PI Builder
◦ Na guia PI Builder, no grupo Recursos, clique em Configurações para abrir a janela
Configurações e clique na guia Recuperar.
◦ Na guia PI Builder, no grupo Recuperar, clique no inicializador da caixa de diálogo para
abrir a janela Configurações.
2. Defina as configurações corretamente. Consulte Configurações de recuperação. 3. Clique em OK.
Configurações de recuperação
A tabela a seguir descreve as configurações disponíveis na guia Recuperar da janela
Configurações.
Categoria Configuração Descrição
Planilha Solicitar para substituir o
conteúdo da planilha Se estiver selecionada (configuração padrão) e aplanilha atual tiver algum conteúdo, o PI Builder solicitará que o conteúdo seja substituído antes da recuperação dos dados.
Se não estiver selecionada, o PI Builder substituirá automaticamente o conteúdo da planilha existente ao recuperar os dados.
Apagar toda a planilha Se estiver selecionada durante a recuperação de dados na planilha, o PI Builder apagará todo o conteúdo existente na planilha.
Substituir e adicionar limite de
célula vazia Se estiver selecionada (configuração padrão), aorecuperar dados na planilha, o PI Builder substituirá as linhas e colunas existentes que sobrepõem os dados recuperados. O PI Builder apaga as duas colunas imediatamente à direita da última coluna recuperada e as duas linhas imediatamente abaixo da última linha recuperada; isso forma um limite de célula vazio das duas colunas e das duas linhas ao redor dos dados recém-recuperados.
Apagar para esvaziar o limite da
célula Se estiver selecionada quando os dados foremrecuperados na planilha, o PI Builder primeiro apaga todas as colunas contendo os dados até encontrar duas colunas vazias em sequência e apaga todas as linhas contendo dados até
encontrar duas linhas vazias em sequência. Depois, o PI Builder grava os dados recém-recuperados na planilha. Se a área apagada for menor que a necessária para os dados recém-recuperados, o comportamento será revertido para Substituir e adicionar limite de célula vazia.
Categoria Configuração Descrição Coluna Sempre solicitar seleções de
coluna Se selecionada (configuração padrão), o PI Builderabre a janela Selecionar Tipos de Objetos e Cabeçalhos de Colunas antes de recuperar os dados.
Se não estiver selecionada e a planilha atual não estiver vazia, o PI Builder usará os cabeçalhos das colunas existentes para estender possíveis dados e recuperar dados sem abrir a janela Selecionar Tipos de Objetos e Cabeçalhos de Colunas. Expandir colunas para ajustar ao
conteúdo Se selecionada (configuração padrão), o PI Builderexpande a largura da coluna para corresponder à largura do conteúdo recuperado (até 80 caracteres de comprimento).
Categoria Configuração Descrição Conteúdo da
Célula Sombrear células não aplicáveis Se estiver selecionada, ao recuperar dados o PIBuilder aplica um padrão de sombreamento de hachura cruzada nas células não aplicáveis para o tipo de objeto. Por exemplo, se dados de atributo e elemento forem recuperados do PI AF e essa caixa de seleção estiver marcada, o PI Builder sombreará as células na coluna AttributeValue nas linhas em que o ObjectType é Element, pois os elementos não têm valores de atributos.
Anexar unidades de medida às
células de valor Se estiver selecionada, o PI Builder anexará aunidade de medida padrão, se houver, aos valores do atributo recuperados na coluna AttributeValue. Mostrar sequências de
configuração simplificadas Se estiver selecionada (configuração padrão), o PIBuilder removerá o PI System e os identificadores de tag (GUIDs) das strings de configuração recuperadas do PI AF.
Mostrar milissegundos em
timestamps Se estiver selecionada, o PI Builder mostra osmilissegundos nos timestamps, como 2/9/2015 9:00:00.258 AM. Para manter a máxima precisão, marque essa caixa de seleção para editar e visualizar os milissegundos em timestamps. Se não estiver selecionada, o mostra os milissegundos nos timestampsPI Buildere truncará qualquer milissegundo em timestamps. Display de fuso horário Especifica como as datas e horas recuperadas do PI
System são exibidas em uma planilha. As opções a seguir estão disponíveis:
• Fuso horário local (configuração padrão) Especifica que as datas e as horas são exibidas no fuso horário local da máquina do cliente. • Fuso horário do servidor
Especifica que as datas e as horas são exibidas no fuso horário configurado para o servidor PI AF conectado (para objetos PI AF) ou para o PI Data Archive conectado (para pontos PI). Os formatos das datas e horas são: Date Time Time_Zone_Offset
em que Time_Zone_Offset é uma indicação do número da diferença de horas entre o fuso horário do servidor conectado e o Universal Coordinate Time (UTC). Por exemplo, se o fuso horário do servidor estiver na Hora do Leste dos E.U.A., a data e a hora podem ser exibidas da seguinte forma:
2/28/2016 08:11:34 -5:00 • UTC
Especifica que as datas e as horas são exibidas em Universal Coordinated Time. Isso inclui um indicador ao final da string de data e hora (Z).
Definir as configurações de construção
Use a guia Construir da janela Configurações para definir as opções padrão na janela Opções de
Publicação e ativar o botão Excluir. As opções na janela Opções de Publicação controlam como o PI Builder publica os dados da planilha no PI AF ou no PI Data Archive.
Procedimento
1. Abra a janela Configurações:
◦ Na guia PI Builder, no grupo Recursos, clique em Configurações para abrir a janela
Configurações e clique na guia Construir.
◦ Na guia PI Builder, no grupo Construir, clique no inicializador de caixa de diálogo para
abrir a janela Configurações.
2. Na área Publicar, defina as configurações padrão preferenciais para a janela Opções de
Publicação.
◦ Na lista Modo de Edição, selecione o método de processamento de linhas ao publicar
dados em um servidor: ▪ Criar e Editar
O PI Builder edita objetos que já existem e cria objetos que não existem. ▪ Criar Apenas
O PI Builder cria novos objetos e gera um erro se um objeto já existir. ▪ Editar Apenas
O PI Builder edita objetos existentes e gera um erro se um objeto ainda não existir. ◦ Marque a caixa de seleção Criar ou atualizar pontos PI para que o PI Builder crie
automaticamente pontos PI dos atributos originados em templates que usem referências de dados do ponto PI. (Essa caixa de seleção não estará disponível após a publicação dos objetos do ponto PI no PI Data Archive.)
◦ Marque a caixa de seleção Criar automaticamente as categorias ausentes para que o PI
Builder crie as categorias ausentes. (Essa caixa de seleção não estará disponível após a publicação dos objetos do ponto PI no PI Data Archive.)
3. Na área Excluir, marque a caixa de seleção Permitir exclusão para ativar o botão Excluir e
poder excluir os dados do PI AF ou do PI Data Archive com o PI Builder. Por padrão, o botão
Excluir na guia PI Builder no grupo Construir está desativado para reduzir exclusões
acidentais. 4. Clique em OK.
Erros na recuperação ou publicação
Quando o PI Builder recupera objetos, a janela Recuperar objetos selecionados mostra as operações concluídas. Quando o PI Builder publica objetos, a janela Publicar objetos selecionados mostra as operações concluídas.
Se um erro ocorre durante a operação, a janela Continuar mostra a mensagem de erro e solicita que continue. Para continuar a recuperação ou publicação, mas evitar solicitações futuras, marque a caixa de seleção Não mostrar esta caixa de diálogo novamente (continuar se erros ocorrerem) e clique em Continuar. Após a conclusão de todas as operações, a lista Operações Concluídas: mostrará as operações, inclusive os erros.
É possível usar o relatório de erros para identificar erros. Na guia PI Builder, no grupo
Recursos, clique em Erros para abrir uma janela que liste todas as mensagens de erros geradas
na última recuperação ou publicação dos dados. É possível:
• Selecionar uma linha individual no relatório de erros para destacar a linha na planilha correspondente ao erro.
• Editar a planilha com o relatório de erros aberto.
• Clique em Copiar Informações para copiar as mensagens para a área de transferência. Mais
tarde, é possível colar essas informações na sua ferramenta de edição preferida.
Nota:
O relatório de erros só estará disponível se o PI Builder tiver gerado erros durante a tentativa mais recente de recuperação ou publicação.
Tempo PI
Pode-se usar uma sintaxe especial, chamada tempo PI, para especificar entradas para timestamps e intervalos de tempo. O tempo PI usa abreviações específicas, que você combina para criar expressões de tempo.
Nesta seção
• Abreviações de tempos relativos PI
• Expressões de tempo do PI
• Especificação de timestamp
• Especificação de período de tempo
Abreviações de tempos relativos PI
Ao especificar o tempo PI, é possível usar abreviações específicas que representam unidades de tempo e tempos de referência.
Abreviaturas de unidade de tempo
Abreviatura Versão completa Versão pluralizada Unidade de tempo correspondente
s second seconds Segundo
m minute minutes Minuto
h hour hours Hora
d day days Dia
mo month months Mês
y year years Ano
w week weeks Semana
Para especificar unidades de tempo, podem-se utilizar a abreviatura, a versão completa ou a versão pluralizada da unidade de tempo, como s, second, ou seconds. Deve-se incluir um valor válido a qualquer unidade de tempo. Ao especificar segundos, minutos ou horas, pode-se
especificar um valor fracionado, como 1.25h. Você não pode especificar valores fracionados para outras unidades de tempo.
Abreviaturas de hora de referência
Abreviatura Versão completa Tempo de referência correspondente
* Hora atual
t today 00:00:00 (meia-noite) do dia atual
y yesterday 00:00:00 (meia-noite) do dia anterior sun1 sunday 00:00:00 (meia-moite) do último domingo
jun2 june 00:00:00 (meia-noite) no dia atual em junho do ano atual
dec DD december DD 00:00:00 (meia-noite) no DD dia de dezembro do ano atual YYYY 00:00:00 (meia-noite) no dia e mês atual no ano de YYYY
M-D ou M/D 00:00:00 (meia-noite) no Dº dia do mês M do ano atual
DD 00:00:00 (meia-noite) no DDº dia do mês atual
1: Use as três primeiras letras como abreviatura para qualquer dia da semana: sun, mon, tue, wed, thu,
fri, ou sat.
2: Use as três primeiras letras como abreviatura para qualquer mês do ano: jan, feb, mar, apr, may,
jun, jul, aug, sep, oct, nov ou dec.
Expressões de tempo do PI
As expressões de tempo do PI podem incluir tempos fixos, abreviaturas de tempo de referência e deslocamentos de tempo. Um deslocamento de horário indica a direção do deslocamento (+ ou -) e o tempo compensado (uma abreviatura de unidade de tempo com um valor).
Por exemplo, as expressões de tempo do PI podem ter a seguinte estrutura:
Estrutura Exemplo
Somente tempo fixo 24-aug-2012 09:50:00
Somente abreviatura da hora de referência t Somente deslocamento de horário +3h Abreviação da hora de referência com
deslocamento de horário t+3h
Inclui, no máximo, um deslocamento de horário em uma expressão; incluir múltiplos deslocamentos de horário pode levar a resultados inesperados.
Especificação de timestamp
Para especificar entradas para timestamps, é possível inserir expressões de tempo que contenham:
• Horas fixas
Uma hora fixa sempre representa o mesmo hora, independentemente da hora atual.
Entrada Significado
23-aug-12 15:00:00 15h de 23 de agosto de 2012
25-sep-12 00:00:00 (meia-noite) de 25 de setembro de 2012
• Abreviaturas de hora de referência Fundamentos do PI Builder
Uma abreviatura de hora de referência representa uma hora relativa à hora atual.
Entrada Significado
* Hora atual (agora)
3-1 ou 3/1 00:00:00 (meia-noite) de 01 de março do ano atual 2011 00:00:00 (meia-noite) no dia e mês atual no ano de 2011 25 00:00:00 (meia-noite) do dia 25 do mês atual
t 00:00:00 (meia-noite) no dia atual (hoje) y 00:00:00 (meia-noite) no dia anterior (ontem) tue 00:00:00 (meia-moite) da última terça-feira
• Abreviações de hora de referência com um deslocamento de tempo
Quando incluído com uma abreviatura de hora de referência, um deslocamento de tempo adiciona ou subtrai da hora especificada.
Entrada Significado
*-1h Uma hora atrás
t+8h 08:00:00 (08h) hoje
y-8h 16:00:00 (16h) de anteontem
mon+14.5h 14:30:00 (14h30) da última segunda-feira sat-1m 23:59:00 (23:59) da última sexta-feira
• Deslocamentos de tempo
Quando inseridos sozinhos, os deslocamentos de tempo especificam um tempo relativo a um tempo de referência implícito. O tempo de referência implícito pode ser a hora atual do relógio ou outra hora, dependendo de onde a expressão foi inserida.
Entrada Significado
-1d Um dia antes do horário atual +6h Seis horas depois da hora atual
Especificação de período de tempo
Entradas de período de tempo definem intervalos para coleta ou cálculo de valores durante um período de tempo. Por exemplo, você pode especificar um intervalo de 60 minutos para computar uma média de hora em um período de 12 horas. Para especificar as entradas do período de tempo, insira um valor válido e uma unidade de tempo:
• Valores positivos definem intervalos que começam em uma hora anterior no período e que terminam em ou antes de uma hora posterior no período.
Hora de início 2:00:00
Hora de término 3:15:00
Intervalo de tempo 30m
Intervalo retornado 2:00:00 a 2:30:00 02:30:00 a 03:00:00
• Valores negativos definem intervalos que terminam em uma hora posterior no período e que começam em ou depois de um hora anterior no período.
Hora de início 2:00:00
Hora de término 3:15:00
Intervalo de tempo -30m
Intervalo retornado 2:15:00 a 2:45:00 2:45:00 a 3:15:00
Pontos PI
É possível usar o PI Builder para criar, editar e excluir pontos PI de qualquer servidor PI Data Archive conectado. Com o PI Builder, é possível usar uma única planilha do Microsoft Excel para trabalhar com pontos de diferentes classes de ponto.
Nesta seção
• Criar pontos PI
Use o PI Builder para especificar os pontos PI no Microsoft Excel e crie os pontos no PI Data Archive.
• Recuperar todas as tags do PI
Use o PI Builder para recuperar todos os pontos PI do PI Data Archive para o Microsoft Excel.
• Recuperar tags do PI por pesquisa
Use o PI Builder para pesquisar pontos PI no PI Data Archive e recuperá-los no Microsoft Excel.
• Editar pontos PI
Use o PI Builder para editar atributos dos pontos PI no Microsoft Excel e publique as alterações no PI Data Archive.
• Excluir pontos PI
Use o PI Builder para excluir os pontos PI em uma planilha do Microsoft Excel no PI Data Archive.
• Usar as planilhas criadas com o PI Tag Configurator
Com o PI Builder, é possível criar, editar, excluir ou atualizar dados dos pontos PI usando as planilhas criadas com o PI Tag Configurator.
Criar pontos PI
Com o PI Builder, é possível inserir a especificação de novos pontos em uma planilha do Microsoft Excel e publicar a planilha no PI Data Archive para criar os pontos. Os recursos de preenchimento automático do Excel facilitam a criação de vários pontos com especificações semelhantes.
Antes de Iniciar
Especificar um servidor do PI Data Archive.
Procedimento
1. Adicione colunas à planilha para os atributos do ponto a serem especificados. Consulte Defina os cabeçalhos de colunas em uma planilha.
Dica:
Para basear esses novos pontos nos pontos existentes, recupere os pontos existentes na planilha e altere o nome e quaisquer outros atributos deles.
2. Especifique os valores dos atributos dos pontos dos novos pontos.
É necessário especificar um nome exclusivo para cada ponto. Se valores para outros atributos não forem especificados o PI Builder configurará o atributo para esse valor padrão.
O PI Builder ignora quaisquer entradas feitas nos atributos do sistema de somente leitura:
changedate, changer, creationdate, creator, pointid, ptclassname e srcptid.
3. Configure a coluna Selected(x) como X para qualquer ponto que deseja criar. 4. Publique os novos pontos no PI Data Archive:
a. Clique em Publicar para abrir a janela Opções de Publicação.
b. Na lista Modo de Edição, selecione Apenas Criar.
Com essa escolha, o PI Builder criará apenas novos pontos. Se já existir um ponto com o mesmo nome, o PI Builder gerará um erro. Também é possível selecionar Criar e Editar; o
PI Builder editará os pontos existentes e criará todos os pontos que ainda não existirem. O PI Builder usa a coluna Nome para encontrar os pontos existentes com o mesmo nome. c. Clique em OK.
O PI Builder cria os pontos no PI Data Archive. A janela Publicar Objetos Selecionados mostra as operações concluídas.
d. Clique em Fechar.
Recuperar todas as tags do PI
É possível usar o PI Builder para recuperar todos os pontos PI do PI Data Archive para o Microsoft Excel.
Nota:
Esta operação poderá ser demorada se o servidor do PI Data Archive especificado contiver um grande número de tags. As versões atuais do Microsoft Excel oferecem suporte a 1.048.576 linhas, então o PI Builder pode recuperar apenas 1.048.575 linhas (o cabeçalho da coluna ocupa a linha extra). Se você tentar recuperar um número maior de pontos junto com seus atributos, o PI Builder gera um erro.
Antes de Iniciar
Especificar um servidor do PI Data Archive.
Procedimento
1. Na guia PI Builder, clique em Pontos PI > Todos os Pontos PI.
2. Na janela Selecione Tipos de Objetos e Cabeçalhos de Colunas, selecione os objetos e os cabeçalhos de coluna a serem incluídos na planilha e clique em OK.
O PI Builder recupera todos os pontos na planilha e preenche as colunas selecionadas com os dados disponíveis.
Recuperar tags do PI por pesquisa
É possível usar o PI Builder para pesquisar tags do PI no PI Data Archive e recuperá-los no Microsoft Excel. No PI AF e PI Builder 2017 ou versões mais recentes, é possível criar uma consulta de pesquisa com base nos atributos da tag do PI e valor da tag do PI.
Antes de Iniciar
Especificar um servidor do PI Data Archive. Pontos PI
Procedimento
1. Na guia PI Builder, clique em Pontos PI > Encontrar pontos do PI para abrir a janela
Pesquisar por tag.
2. As consultas de pesquisa por tag do PI são criadas na caixa de texto ao lado do botão
Pesquisar. A consulta de pesquisa compreende um nome de filtro, que pode ser uma string
de texto, um atributo da tag do PI (padrão: tag) ou um valor da tag do PI (por exemplo,
Value), um operador (padrão: :=) e um filtro de consulta (padrão: * ou todas as tags do PI).
Para obter uma descrição completa da sintaxe de uma consulta de tag do PI, consulte a seção Sintaxe para pesquisas por tags do PI.
Exemplos de consultas de atributos: ◦ sin*
◦ tag:=sin*
◦ tag:<>sin* datatype:float
◦ step:0 AND pointsource:L
◦ tag:<>sin* AND PointType:Float64
Exemplos de consultas de valor (que podem ser combinadas a consultas de atributos): ◦ Value:>1000
◦ tag:<>sin* AND Value:>10 ◦ PointType:Int32 AND Value:>10
◦ PointSource:L AND Annotated:1 AND TimeStamp:t
◦ creationdate:>y-1d AND future:true AND timestamp:<*
Por padrão, o PI AF pesquisa nomes de tags que começam com a string da consulta e incluem a descrição da tag (o que significa que os filtros Começa com e Incluir descrição na pesquisa já estão selecionados).
Nota:
Em PI AF 2017, as consultas que contenham somente uma string de texto (como *sine*) e não contenham um nome de filtro de consulta pesquisam a tag e atributo "descriptor". Contudo, as consultas que contenham um nome de filtro de consulta (como name:*sine*), pesquisam somente atributos da tag. Em versões anteriores do PI AF, as consultas que continham um nome de filtro de consulta pesquisavam o atributo "descriptor" e o filtro da consulta, exceto se o atributo "descriptor" fosse especificado como parte do filtro da consulta.
Para criar uma consulta de pesquisa, escolha uma das ações a seguir.
Para... Faça o seguinte...
Limpar critérios selecionados anteriormente Clique em Redefinir.
Todas as consultas são limpas, além do filtro Incluir descrição na pesquisa.
Excluir descrições de tags de uma consulta a. Clique em .
b. Limpe Incluir descrição na pesquisa.
Digite uma consulta diretamente na caixa
Pesquisar texto a. Digite o primeiro caractere da consulta. b. Selecione na lista de atributos de tag e
valores correspondentes ou continue digitando um atributo da tag ou valor manualmente.
c. Insira os critérios a serem correspondidos. Incluir atributos da tag do PI comuns em uma
consulta a. Clique em .
b. Insira os critérios em um dos campos a seguir:
▪ Nome (alias para o atributo tag) ▪ Origem do ponto
▪ Tipo de dados (alias para o atributo pointtype)
▪ Classe da tag (alias para o atributo ptclassname)
c. Para inserir critérios para unidades de engenharia e descrição, clique em Adicionar critérios ou pressione ALT+C. Em seguida, clique em Unidades de engenharia e/ou Descrição.
Os critérios são anexados à string na caixa Pesquisar Texto, separados por um espaço.
Nota:
A consulta de pesquisa retorna somente tags do PI que correspondem a todos os critérios.
Incluir valores da tag do PI em uma consulta a. Clique em .
b. Clique em Adicionar critérios ou pressione ALT+C.
c. Clique em qualquer um dos critérios a seguir: ▪ Valor ▪ TimeStamp ▪ IsGood ▪ Anotado ▪ Substituído ▪ Questionável
d. Insira os critérios nos campos selecionados conforme solicitado.
Os critérios são anexados à string na caixa Pesquisar Texto da consulta, separados por um espaço.
Nota:
A consulta de pesquisa retorna somente tags do PI que correspondem a todos os critérios.
Limpar uma consulta existente ou remover um
critério da área de pesquisa expandida Clique em .
Usar consulta anterior a. Clique em .
b. Clique em Pesquisas Recentes.
Filtrar nomes de tags por conteúdo,
correspondente exato ou terminação a. Clique em .
b. Clique no filtro adequado: ▪ Contém
▪ Correspondente Exato ▪ Termina Com
3. Clique em Pesquisar para obter as tags correspondentes na tabela de resultados.
4. Opcional. Clique em e modifique as colunas que você deseja que sejam exibidas. 5. Selecione uma ou mais tags a serem recuperadas na planilha e clique em OK.
Dica:
Para recuperar cada tag da tabela de resultados para a planilha, não selecione nenhuma tag e clique em OK.
6. Na janela Selecione Tipos de Objetos e Cabeçalhos de Colunas, selecione os objetos e os cabeçalhos de coluna a serem incluídos na planilha e clique em OK.
O PI Builder recupera as tags selecionadas na planilha e preenche as colunas selecionadas com os dados disponíveis.
Sintaxe para pesquisas por tags do PI
Consulte as seções a seguir para obter detalhes sobre a sintaxe para construir consultas de tags do PI em PI AF e PI Builder. Para obter informações detalhadas sobre a sintaxe de consulta de tags do PI, consulte a seção “Visão geral da sintaxe de consulta de PIPoint” no PI System Explorer: Ajuda > Referência AF SDK > Visão geral, ou vá para a página de Suporte técnico
Visão geral da sintaxe de consulta de PIPoint (https://techsupport.osisoft.com/ Documentation/PI-AF-SDK/html/b8fbb6da-7a4b-4570-a09d-7f2b85ed204d.htm).
Filtros de condição
Para criar uma consulta de tags do PI, insira um ou mais filtros de condição do AND que também podem ser combinados com uma condição OR conforme necessário. Cada condição
AND contém uma ou mais consultas, separadas por espaço ou AND. A consulta consiste em um
nome do filtro de consulta, um operador e o filtro da consulta. Dessa forma, você pode
especificar diversas condições com uma única consulta, conforme exibido no exemplo a seguir:
(tag:<>sin* AND PointType:Float64) OR (tag:="*Tank*" AND DataType:=Int32)
Nota:
É possível usar parênteses somente entre condições OR.
É possível fazer referência a um nome de filtro uma vez por condição AND da sequência de consultas. Por exemplo, PointId:>5 AND PointId:<10 gera um erro, ao passo que PointType:=Int32 OR PointType:=Float32 é válido.
Para maior eficiência, crie sua consulta de forma a eliminar a maioria dos itens dos resultados recuperados com seus primeiros filtros de condição.
Nomes de filtros de consulta
Ao fazer uma consulta com base em atributos da tag do PI, o nome do filtro da consulta é um nome ou alias do atributo da tag do PI. Os aliases comuns são:
Nome do alias Nome do atributo
Nome Tag
DataType PointType
Descrição Descritor
