PI Builder. Guia do Usuário. Para o PI Asset Framework incluído no PI Server 2014 R2

(1)

PI Builder

Guia do Usuário

Para o PI Asset Framework 2.6.1 incluído no PI Server 2014 R2

(2)

OSIsoft, LLC

777 Davis St., Suite 250 San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Site: http://www.osisoft.com

Guia do Usuário do PI Builder

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 o logo OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI

WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são 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.6.1

(3)

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 Server para o PI Builder...2

Desinstalar o PI Builder... 2

Configuração do suplemento do Microsoft Excel do PI Builder... 3

Ver status do suplemento...3

Habilitar um suplemento desabilitado... 3

Ativar um suplemento inativo... 4

Tutorial do PI Builder...5

Criar vários elementos vinculados com novos pontos PI... 5

Criar os templates da bomba de calor...5

Criar os elementos da bomba de calor... 7

Verificar a criação de elementos da bomba de calor... 9

Criar vários elementos vinculados aos pontos PI existentes...9

Criar pontos PI para reatores... 10

Criar os templates do reator... 11

Criar os elementos do reator... 12

Configurar as referências de dados para o atributo de temperatura... 15

Editar elementos e atributos... 18

Editar o template do reator... 18

Editar os elementos do reator para especificar novos valores do atributo...20

Recuperar um elemento com um número de série específico... 22

Recuperar elementos com datas de manutenção específicas...23

Fundamentos do PI Builder... 25

Conexões... 25

Especificar um banco de dados...25

Especificar um PI Server... 26

Tarefas comuns... 26

Defina os cabeçalhos de colunas em uma planilha... 27

Recuperar dados de objetos definidos...29

Publicar objetos...30

Criar objetos PI AF... 31

Editar objetos PI AF...32

Excluir objetos PI AF... 33

Configurações... 34

Definir as configurações de recuperação... 34

Definir as configurações de construção... 36

Erros na recuperação ou publicação...37

Pontos PI... 39

Criar pontos PI... 39

Recuperar todos os pontos PI...40

Recuperar pontos PI por pesquisa... 40

Editar pontos PI...41

Excluir pontos PI... 42

Usar as planilhas criadas com o PI Tag Configurator...42

(4)

Criar vários elementos e gerar pontos PI referenciados automaticamente...47

Elementos filho...49

Recuperar todos os elementos...49

Recuperar elementos por pesquisa...50

Configurar uma condição de valor do atributo... 52

Caracteres especiais nas pesquisas por nome... 52

Recuperar elementos por navegação...53

Editar elementos com o PI Builder...54

Redefinir regras de tempos para especificação de elementos...54

Atributos... 57

Exibição de atributos... 57

Mostrar atributos em colunas ... 58

Mostrar atributos em linhas...59

Mostrar atributos em linhas e colunas... 60

Recuperar atributos por pesquisa... 61

Referências de dados... 62

Mostrar valores das referências de dados... 63

Referências de dados nas colunas de atributos...64

Colunas específicas do atributo para referências de dados... 65

Strings de configuração do atributo... 65

Criação de ponto PI durante a publicação... 67

Lista de parâmetros de substituição do PI AF... 68

Atributos Filho... 69

Redefinir atributos para especificação de template...69

Modelos...71

Recuperar todos os modelos...71

Recuperar modelos selecionados...71

Estrutura de eventos...73

Recuperar estruturas de eventos por pesquisa...73

Recuperar atributos da estrutura de eventos por pesquisa...75

Recuperar estruturas de eventos de pesquisa salvas...76

Transferências...77

Recuperar transferências por pesquisa...77

Recuperar atributos de transferência por pesquisa... 77

Recuperar transferências de pesquisas salvas... 78

Categorias... 79

Recuperar todas as categorias...79

Recuperar as categorias selecionadas...79

Recuperar todas as categorias de um tipo específico...80

Templates... 81

Recuperar templates selecionados... 81

Recuperar todos os templates de um tipo específico...82

Conjuntos de enumerações... 83

Recuperar todos os conjuntos de enumerações...83

Recuperar conjuntos de enumerações selecionados...83

Tipos de referência... 85

Conteúdo

(5)

Unidades de medida... 87

Recuperar todas as unidades de medida...87

Recuperar unidades de medida das classes UDM selecionadas...87

Entrada de valor... 89

Objetos que recebem valores...89

Tipos de valores... 89

Tipos de valores com suporte... 89

Tipos de valor com suporte parcial... 90

Tipos de valores sem suporte... 91

Formatos de valores... 91

Valores nulos...93

Referência de coluna... 95

Colunas Templates de caso...96

Colunas Categoria... 97

Colunas Elemento... 97

Colunas Template de elemento... 99

Colunas Conjunto de enumeração... 101

Colunas Estrutura de eventos... 101

Colunas Modelo da estrutura de eventos... 103

Colunas Modelo... 104

Colunas Template de modelos... 106

Colunas do ponto PI...107

Colunas Tipo de referência... 110

Coluna Transferir... 111

Colunas Transferir templates... 113

Colunas Banco de dados UOM...114

Suporte técnico e outros recursos... 115

Conteúdo

(6)

(7)

Introdução ao PI Builder

Bem-vindo ao PI Builder! Esta seção fornece uma visão geral do PI Builder e discute a instalação e a configuração do aplicativo.

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

• Processo de instalação do PI Builder

Execute o kit de instalação para instalar o PI Builder e o pacote de idiomas para ver a interfaces em idiomas diferentes do inglês.

• Configuração do suplemento do Microsoft Excel do PI Builder

Para usar o PI Builder, o suplemento de aplicativo PIAFBuilder deve estar ativo no Microsoft Excel.

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 dos pontos PI no PI Server. Com o PI Builder, é possível fazer facilmente alterações em massa e realizar estas tarefas:

• Criar, editar e excluir pontos PI no PI Server 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 UDM, UDMs, tipos de referências, estruturas de eventos, transferências, portas, valores de enumeração e propriedades estendidas).

• Copiar os objetos PI AF existentes. 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 PI AF.

Processo de instalação do PI Builder

Para preparar o computador para usar o PI Builder, instale o software usando o kit de instalação Cliente PI AF baixado da OSIsoft. Feche o Microsoft Excel antes de instalar o PI Builder ou outros componentes no kit de configuração do cliente PI AF. 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 Server 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 cliente PI Asset Framework para visualizar a interface do usuário do PI Builder em um idioma diferente do inglês.

(8)

• Configuração do PI Server para o PI Builder

Para ler e gravar dados do ponto PI, o PI Builder precisa de certas configurações no PI Server.

• Desinstalar o PI Builder

Use o Windows para desinstalar o PI Builder.

Visualizar o PI Builder em um idioma com suporte

O PI Builder tem suporte a vários idiomas. Instale o pacote de idiomas MUI (interface do usuário em vários idiomas) do cliente PI Asset Framework (PI AF) 2014 para visualizar a interface do usuário do PI Builder no mesmo idioma do Microsoft Excel. Se o PI Builder não tiver suporte ao idioma selecionado no Excel, sua interface do usuário aparecerá em inglês.

Procedimento

1. Configure 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 cliente PI AF 2014 no site do Suporte Técnico da OSIsoft (http://techsupport.osisoft.com).

3. Instale o pacote de idiomas MUI do cliente PI AF 2014.

Configuração do PI Server para o PI Builder

O PI Builder pode recuperar e gravar dados no PI Server. No entanto, o PI Builder deve se conectar ao PI Server e ter acesso apropriado aos pontos. Essa ação pode exigir alterações na configuração para:

• Banco de dados do firewall. O banco de dados do firewall em cada computador PI Server 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 Server e ter acesso ao PI Server. A OSIsoft recomenda usar PI mappings. Também é possível usar o PI trust ou a autenticação por senha do PI. A OSIsoft não recomenda usar a autenticação por senha do PI por ser um método menos seguro. • Definições de pontos. Os pontos devem ser definidos para dar aos usuários autorizados

acesso de leitura e de gravação, se necessário.

Para obter mais informações, consulte a documentação do PI Server.

Desinstalar o PI Builder

Use o Windows para desinstalar o PI Builder.

Procedimento

1. Feche o Microsoft Excel.

2. Abra o Painel de Controle e clique em Programas e Recursos (ou em Adicionar/Remover Programas).

3. Na lista de aplicativos instalados, clique em Cliente PI AF e escolha a opção apropriada para

(9)

◦ Clique em Desinstalar para remover o PI Builder, o PI System Explorer e o PI AF SDK.

◦ Clique em Alterar e 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 antes de desinstalar o PI Builder, o PI System Explorer, o PI AF SDK e o PI AF Server.

Configuração do suplemento do Microsoft Excel do PI Builder

O PI Builder tem um suplemento de aplicativo para o Microsoft Excel.

Nome Local Tipo

PIAFBuilder ..\PIPC\AF\PIAFBuilder.vsto Suplemento de COM

Para usar o PI Builder, esse suplemento de aplicativo deve estar ativado. O programa de configuração instala e ativa o suplemento do PI Builder. Em casos raros, o Microsoft Excel pode desativar um suplemento. Para usar um suplemento desabilitado, habilite-o e ative o

suplemento.

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.

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.

(10)

Procedimento

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

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.

(11)

Tutorial do PI Builder

Este tutorial contém três exercícios que apresentam o PI Builder. Os exercícios demonstram os recursos e casos de uso mais comuns. Após a conclusão dos exercícios, os fundamentos do PI Builder serão compreendidos.

Nesta seção

• Criar vários elementos vinculados com novos pontos PI

Neste exercício, vários elementos vinculados com novos pontos PI são criados. • Criar vários elementos vinculados aos pontos PI existentes

Neste exercício, vários elementos vinculados aos pontos PI existentes são criados. • Editar elementos e atributos

Neste exercício, edite os elementos existentes no PI AF, criados nos exercícios de tutoriais anteriores, e pesquise os elementos com valores de atributos específicos.

Criar vários elementos vinculados com novos pontos PI

Siga este exercício para criar vários elementos vinculados com novos pontos PI. Neste exercício, o PI System Explorer será usado para criar templates para bombas de calor, e o PI Builder, para criar elementos da bomba de calor e pontos PI para esses templates. Por fim, verifique os resultados no PI System Explorer.

Procedimento

1. Criar os templates da bomba de calor.

Use o PI System Explorer para criar um template de elemento para uma bomba de calor e um template do atributo para armazenar a velocidade das bombas.

2. Criar os elementos da bomba de calor.

Crie um elemento pai e dez elementos filhos contendo informações sobre bombas, além de pontos PI para armazenar a velocidade das bombas.

3. Verificar a criação de elementos da bomba de calor.

Use o PI System Explorer para verificar se o PI Builder criou elementos da bomba.

Criar os templates da bomba de calor

No PI AF, os templates fornecem uma estrutura que pode ser usada para criar objetos. Pode-se usar o PI System Explorer para criar templates. Siga este procedimento para usar o PI System Explorer para criar um padrão de elemento para uma bomba de calor e um padrão do atributo para armazenar a velocidade das bombas. O padrão do atributo consulta um ponto na interface do PI Random Simulator.

Antes de Iniciar

Escolha qual PI AF Server e qual banco de dados do PI AF armazenarão os templates.

Procedimento

1. Abra o PI System Explorer. (Clique em Iniciar > Todos os Programas > PI System > PI System Explorer.)

2. Selecione um banco de dados para ser usado neste tutorial:

(12)

c. Na lista Bancos de Dados, selecione o banco de dados.

d. Clique em OK.

3. Crie um novo padrão de elemento:

a. No painel de navegação, clique em Biblioteca.

b. Na árvore do banco de dados, expanda Templates, clique com o botão direito do mouse

em Padrões de Elemento e clique em Novo Template.

c. Na guia Geral, no campo Nome, insira Template da Bomba de Calor.

4. Crie um novo padrão do atributo:

a. Na guia Padrões do Atributo, na tabela vazia de templates, clique em Novo Padrão do Atributo.

b. No campo Nome, insira PumpSpeed.

5. Configure uma referência de dados para o template de atributo: a. Na lista Referência de Dados, selecione Ponto PI.

b. Clique em Configurações para abrir a janela Referência de Dados do Ponto PI.

c. Na lista PI Server, mantenha o valor padrão: %Server%.

O valor %Server% é um parâmetro de substituição. Ao criar um atributo com base nesse template, o PI AF configura o PI Server para o PI Server padrão do banco de dados do PI AF dos elementos.

d. No campo Nome da Tag, mantenha o nome padrão da tag: %Element%.%Attribute%.

Os valores %Element% e %Attribute% são parâmetros de substituição. Ao criar um atributo com base nesse template, o PI AF configura a referência de dados para um ponto PI chamado ElementName.AttributeName.

e. Marque a caixa de seleção Criação de Tag e clique na imagem ao lado do campo

Criação de Tag.

A janela Configurações de criação de tag é aberta. f. Na lista Classe de Ponto, selecione clássica.

g. Na lista Tipo de Ponto, selecione Float32.

h. Insira os seguintes valores do atributo do ponto:

Atributo Valor zero 1100 span 200 pointsource R location4 1 location5 2

Nos outros atributos, deixe os valores padrão.

Nota:

Estas configurações criam um ponto que faz referência à interface PI Random Simulator padrão. Se essa interface não estiver instalada no sistema, esse ponto não terá nenhum valor.

(13)

i. Clique em OK.

j. Na janela Referência de Dados do Ponto PI, clique em OK. 6. Verifique os templates.

a. Clique em Arquivo > Fazer Check-in.

b. Na janela Fazer Check-in, clique em Fazer Check-in. O PI AF verifica o novo template e o disponibiliza para uso.

Criar os elementos da bomba de calor

Os elementos PI AF são objetos que representam ativos. Siga este procedimento para criar um elemento pai, Heat Pumps, e dez elementos filhos, de Pump1 a Pump10, com o PI Builder. O elemento pai é um elemento de contêiner que fornece a estrutura na estrutura geral, e os elementos filho contêm informações sobre bombas individuais. O padrão do elemento criado será usado no procedimento anterior.

Antes de Iniciar

Criar os templates da bomba de calor.

Procedimento

1. Abra uma nova planilha do Microsoft Excel e clique na guia PI Builder.

2. No grupo Conexões, abra o banco de dados no qual o template foi criado:

a. Na lista Servidor AF, selecione o PI AF Server que contém o banco de dados.

b. Na lista Banco de Dados, selecione o banco de dados.

3. Adicione os cabeçalhos de colunas necessários à planilha:

a. No grupo Recursos, clique em Cabeçalhos para abrir a janela Selecione Tipos de Objetos e

Cabeçalhos de Colunas.

b. Na lista Tipo de Objeto, selecione Elemento.

c. Clique em Apagar Tudo para apagar os tipos de objetos selecionados, exceto aqueles no

grupo Colunas Obrigatórias (não é possível apagar essas colunas).

d. Na lista Tipos de Objetos, expanda o grupo Elemento e marque a caixa de seleção Template.

(14)

4. Defina o elemento pai e seus elementos filho na planilha:

a. Na segunda linha da planilha, na coluna Nome, digite Template das Bombas. b. Na terceira linha, insira estes valores em um novo elemento:

Coluna Valor

Selected x

Parent Heat Pumps

Name Pump1

ObjectType Element

Template Heat Pump Template

A planilha deve ser semelhante a esta:

Nota:

O elemento Heat Pumps é o elemento pai de outros elementos. O PI Builder cria os elementos na ordem em que eles aparecem na planilha, por isso, é necessário inserir os elementos pai acima dos elementos filhos deles.

c. Selecione as células de A3 a E3 e arraste a alça de preenchimento para a célula E12. O Excel copia as células selecionadas e preenche o nome da bomba com valores sequenciais. A planilha deve ser semelhante a esta:

5. Publique os objetos para criar os elementos no 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 (também é possível selecionar Criar e

(15)

c. Marque a caixa de seleção Criar ou Atualizar PI Points para criar automaticamente o

ponto PI consultado pelo atributo de cada elemento.

Se essa caixa de seleção não for marcada, será necessário criar os pontos PI correspondentes no PI System Explorer.

O PI Builder cria os elementos no banco de dados. A janela Objetos selecionados de publicação mostra as operações concluídas. O PI Builder verifica automaticamente as alterações.

e. Clique em Fechar.

Verificar a criação de elementos da bomba de calor

Pode-se usar o PI System Explorer para verificar se o PI Builder criou os elementos e atributos esperados. Siga este procedimento para verificar se o PI Builder criou os elementos da bomba de calor e os atributos correspondentes com pontos PI gerados automaticamente.

Antes de Iniciar

Criar os elementos da bomba de calor.

Procedimento

1. Abra o PI System Explorer. (Clique em Iniciar > Todos os Programas > PI System > PI System Explorer.)

2. Selecione o banco de dados que será usado neste exercício:

a. Na barra de ferramentas do PI System Explorer, clique em Banco de Dados.

b. Na lista Servidor AF, selecione o PI AF Server que armazena o banco de dados.

c. Na lista Bancos de Dados, selecione o banco de dados.

3. No painel de navegação, clique em Elementos.

4. Expanda Bombas de Calor para ver os elementos criados da bomba.

(Se o PI System Explorer já estiver aberto, talvez seja necessário clicar em Atualizar para ver

as alterações.)

5. Clique em um elemento filho, como Pump4, para ver os seus detalhes.

6. Clique na guia Atributos e verifique se a referência dos dados está correta.

◦ Em Configurações, a string de configuração deverá mostrar o PI Server padrão e o nome

do ponto, como: \\MyServer\Pump4.PumpSpeed. ◦ No campo Valor, um valor deverá aparecer.

Nota:

Depois de o PI Builder criar um ponto PI, talvez demore um pouco para que a interface especificada grave os valores no PI Server. Até lá, o valor Pt. Created será exibido.

Criar vários elementos vinculados aos pontos PI existentes

Siga este exercício para criar vários elementos vinculados aos pontos PI existentes. Usando o PI Builder, crie pontos PI para dez reatores, templates para os reatores e elementos para os

(16)

templates; os atributos criados serão configurados para fazer referência aos pontos PI já criados.

Procedimento

1. Criar pontos PI para reatores.

Use o PI Builder para criar pontos PI para dez reatores. Esses pontos armazenam os dados gerados pela interface PI Random Simulator.

2. Criar os templates do reator.

Crie um template de elemento para um reator e um template do atributo para armazenar o template do reator.

3. Criar os elementos do reator.

Use os templates para criar um elemento pai e dez elementos filhos que podem conter informações sobre reatores.

4. Configurar as referências de dados para o atributo de temperatura.

Configure o atributo de temperatura dos elementos do reator recém-criado para fazer referência aos pontos PI.

Criar pontos PI para reatores

Pode-se usar o PI Builder para criar pontos PI. Siga este procedimento para criar pontos PI que coletam dados para dez reatores diferentes. Esses pontos armazenam os dados da interface PI Random Simulator.

Procedimento

2. No grupo Conexões, na lista PI Server, selecione o PI Server no qual deseja-se criar os

pontos.

3. Adicione os cabeçalhos de colunas apropriados à planilha:

b. Na lista Tipo de Objeto, selecione Ponto PI.

d. No grupo Geral, marque as caixas de seleção pointsource e pointtype.

e. No grupo Clássico, marque as caixas de seleção location2, location4 e userint1.

f. Clique em OK para adicionar os cabeçalhos de colunas à planilha.

4. Na segunda linha, preencha os seguintes valores para especificar o ponto do primeiro reator: Coluna Valor Selected(x) x Nome Data_React1 ObjectType PIPoint pointsource R pointtype Float32 location2 2 Tutorial do PI Builder

(17)

userint1 7200

5. Prepare a planilha para definir dez pontos com base nos valores inseridos: a. Selecione as primeiras quatro colunas na segunda linha a arraste a alça de

preenchimento pelas próximas nove linhas para criar dez linhas com pontos com nomes sequenciais.

b. Copie os valores das últimas quatro colunas na segunda linha para as próximas nove linhas.

6. Publique os novos pontos no PI Server selecionado.

b. Na lista Modo de Edição, selecione Apenas Criar.

Com essa escolha, o PI Builder só cria novos pontos. O PI Builder gerará um erro se quaisquer pontos existentes tiverem os mesmos nomes.

c. Clique em OK.

O PI Builder cria os pontos no PI Server. A janela Objetos selecionados de publicação mostra as operações concluídas.

d. Clique em Fechar.

Criar os templates do reator

No PI AF, os templates fornecem uma estrutura que pode ser usada para criar objetos. Pode-se usar o PI Builder para criar templates. Siga este procedimento para criar um template de elemento para um reator e um template do atributo para armazenar a temperatura dos reatores.

Antes de Iniciar

Escolha qual PI AF Server e qual banco de dados do PI AF armazenarão os templates.

Procedimento

2. No grupo Conexões, selecione um banco de dados:

a. Na lista Servidor AF, selecione o PI AF Server que armazena o banco de dados.

(18)

b. Na lista Tipo de Objeto, selecione Padrão de Elemento.

d. No tipo de objeto Padrão do Atributo, marque as caixas de seleção DefaultUOM e DataReference.

e. Clique em OK para adicionar os cabeçalhos de colunas à planilha.

4. Na segunda linha da planilha, na coluna Name, digite Template do Reator.

5. Na terceira linha, preencha os seguintes valores para especificar um padrão do atributo:

Selected(x) x

Parent Reactor Template

Name Temperature Attribute

Object Type AttributeTemplate

AttributeDefaultUOM degC

AttributeDataReference PI Point

Os cabeçalhos de colunas AttributeDefaultUOM e AttributeDataReference talvez não estejam nas mesmas colunas da planilha, como mostrado na figura.

6. Publique os dados no PI AF:

b. Na lista Modo de Edição, selecione Apenas Criar (também é possível selecionar Criar e Editar).

O PI Builder cria o template no banco de dados. A janela Objetos selecionados de publicação mostra as operações concluídas. O PI Builder verifica automaticamente as alterações.

Também é possível ver o template no PI System Explorer.

Criar os elementos do reator

Os elementos PI AF são objetos que representam ativos. Siga este procedimento para criar um elemento pai, Reactors, e dez elementos filho, de React1 a React10, com o PI Builder. O elemento pai é um elemento de contêiner que fornece a estrutura na estrutura geral, e os elementos filho contêm informações sobre reatores individuais. O template do reator criado no procedimento anterior será usado.

(19)

Antes de Iniciar

Criar os templates do reator.

Procedimento

1. Adicionar cabeçalhos de colunas necessários à planilha.

Adicione cabeçalhos de colunas à planilha de que o PI Builder precisa para criar os elementos do reator.

2. Definir elementos na planilha.

Defina um elemento pai que agrupe reatores e elementos para dez reatores. 3. Publicar os objetos para criar os elementos no PI AF.

Use o comando Publicar no PI Builder para criar elementos no PI AF com base nos objetos

definidos na planilha.

Adicionar cabeçalhos de colunas necessários à planilha

Para criar elementos, o PI Builder precisar de cabeçalhos específicos de colunas. Siga este procedimento para adicionar cabeçalhos de colunas à planilha de que o PI Builder precisa para criar os elementos do reator.

Antes de Iniciar

Procedimento

2. No grupo Recursos, clique em Cabeçalhos para abrir a janela Selecione Tipos de Objetos e

3. Na lista Tipo de Objeto, selecione Elemento.

4. Clique em Apagar Tudo para apagar os tipos de objetos selecionados, exceto aqueles no

5. Na lista Tipos de Objetos, expanda o grupo Elemento e marque a caixa de seleção Template.

6. Insira Temperature Attribute como uma coluna de atributos disponível: a. Na lista Template, selecione Template do Reator.

b. Na lista Tipos de Objetos, expanda o grupo Colunas de Atributos (do Template do Reator) e marque a caixa de seleção Atributo de Temperatura.

7. Clique em OK.

O PI Builder adiciona cabeçalhos de colunas selecionados à planilha, incluindo a coluna Temperature Attribute.

(20)

Definir elementos na planilha

Para criar elementos com o PI Builder, defina os valores dos elementos na planilha. Siga este procedimento para definir os elementos e um elemento pai de organização para dez reatores.

Antes de Iniciar

Adicionar cabeçalhos de colunas necessários à planilha.

Procedimento

1. Defina o elemento pai:

a. Na segunda linha da planilha, na coluna Name, digite Reatores.

b. Verifique se um X aparece na coluna Selected(x) e Element aparece na coluna ObjectType. Esse elemento pai não precisa de um template.

Nota:

O PI Builder cria os elementos na ordem em que eles aparecem na planilha, por isso, é necessário inserir os elementos pai acima dos elementos filhos deles.

2. Defina os dez reatores como elementos filho:

a. Nas linhas de 3 a 12 da planilha, insira estes valores:

Selected(x) x

Parent Reactors

Object Type Element

Template Reactor Template

b. Na linha três, na coluna Name, insira React1.

c. Selecione a célula React1 e arraste a alça de preenchimento para as células remanescentes na coluna para nomear os outros elementos sequencialmente.

Publicar os objetos para criar os elementos no PI AF

Depois de definir os elementos na planilha, publique-os para criar os elementos no PI AF.

Antes de Iniciar

(21)

Procedimento

1. Na guia PI Builder, clique em Publicar para abrir a janela Opções de Publicação.

2. Na lista Editar Modo, selecione Criar e Editar.

O PI Builder cria os elementos no banco de dados. A janela Objetos selecionados de publicação mostra as operações concluídas. O PI Builder verifica automaticamente as alterações.

4. Clique em Fechar.

Também é possível ver os elementos no PI System Explorer. Se o PI System Explorer já estiver aberto, clique em Atualizar para ver as alterações.

Configurar as referências de dados para o atributo de temperatura

No PI AF, as referências de dados vinculam um atributo PI AF a um ponto PI. Siga este procedimento para configurar as referências de dados para o atributo de temperatura dos elementos do reator criado anteriormente. O procedimento usa os pontos do reator criados. Como alternativa, é possível usar pontos de amostra ou outros pontos existentes no servidor.

Procedimento

1. Recuperar os elementos do reator.

Recupere os elementos do reator (aqueles que usam o template Reactor Template) em uma planilha.

2. Definir as referências de dados para o atributo de temperatura.

Crie referências de dados do ponto PI para o atributo de temperatura dos elementos do reator recuperados.

3. Publicar os objetos para criar as referências de dados no PI AF.

Publique a planilha contendo as configurações de referências de dados para criar as referências de dados dos atributos de temperatura no PI AF.

Recuperar os elementos do reator

Para editar elementos PI AF com o PI Builder, recupere esses elementos na planilha. Siga este procedimento para recuperar os elementos do reator em uma planilha.

Antes de Iniciar

Criar os elementos do reator.

Procedimento

2. No grupo Referências de Dados do Atributo, desmarque a caixa de seleção Mostrar valores em colunas.

Porque as referências de dados do ponto PI ainda não foram definidos para o atributo de temperatura, não se deseja que o PI Builder recupere valores para essas referências de dados.

3. Clique em Elementos > Encontrar Elementos para abrir a janela Pesquisar Elemento.

4. Encontre os elementos que usem o template do reator chamado Reactor Template: Tutorial do PI Builder

(22)

a. Na lista Template, selecione Template do Reator.

b. Na lista Todos Descendentes, selecione Verdadeiro.

c. Clique em Pesquisar.

O PI Builder recupera os elementos que usam o template chamado Reactor Template na tabela Resultados.

5. Selecione todos os elementos na tabela Resultados e clique em OK.

6. Na janela Selecione Tipos de Objetos e Cabeçalhos de Colunas, selecione os objetos e os cabeçalhos da coluna a serem exibidos na planilha:

a. Clique em Apagar Tudo para apagar todas as colunas já selecionadas.

b. No grupo Colunas de Atributos (do Template do Reator), marque a caixa de seleção Temperatura do Atributo.

7. Clique em OK para recuperar os elementos na planilha.

A janela Objetos selecionados de recuperação mostra as operações concluídas. 8. Clique em Fechar.

A planilha deve conter 10 linhas, mostrando de React1 a React10.

Definir as referências de dados para o atributo de temperatura

Para criar uma referência de dados do ponto PI com o PI Builder, é necessário definir uma configuração do atributo que faz referência ao ponto PI. Siga este procedimento para definir a configuração de referência de dados do atributo de temperatura dos elementos no template do reator. Será feita referência dos pontos PI criados anteriormente para os reatores.

Antes de Iniciar

• Criar pontos PI para reatores. • Recuperar os elementos do reator.

Procedimento

1. Na planilha, recupere os pontos PI criados para os reatores e organize os pontos pelo nome: a. Clique em Pontos PI > Encontrar Pontos PI para abrir a janela Pesquisa por Tag.

b. Na caixa de texto, digite Data_React* e clique em Pesquisar para recuperar os pontos

na tabela de resultados.

c. Selecione os dez pontos a serem criados e clique em OK.

d. Na janela Selecione Tipos de Objetos e Cabeçalhos de Colunas, clique em Apagar Tudo para apagar todas as colunas que não sejam as solicitadas e clique em OK para recuperar

os pontos na planilha.

e. Organize a coluna Name pelos valores crescentes. f. Copie a célula contendo os nomes.

2. Na planilha com os elementos do reator recuperados, adicione os pontos PI ao lado das colunas recuperadas:

a. Nas linhas de 2 a 11 da coluna G, cole os nomes dos pontos PI criados para os reatores. b. Deixe o cabeçalho de coluna em branco.

(23)

3. Para o primeiro elemento, defina a string de configuração do atributo de temperatura e vincule-a ao ponto:

a. Na guia Início, verifique se o formato da célula E2 está definida como Geral. (O PI Builder

reformata muitas células como texto.)

b. Na célula E2 (a coluna |Temperature Attribute do elemento React1), digite a string de configuração ="=\\%Server%\"& e clique na célula G2 para vinculá-la ao ponto.

Nota:

%Server% é um parâmetro de substituição que o PI Builder substituirá pelo nome do PI Server padrão do banco de dados do PI AF no qual o atributo está localizado. Consulte Strings de configuração do atributo para obter mais informações. c. Pressione Enter.

A fórmula completa deve ser: ="=\\%Server%\"&G2

4. Clique na célula E2 e arraste a alça de preenchimento pelas células remanescentes na coluna para copiar a configuração do primeiro elemento com a referência do ponto relativo à linha. A planilha mostrará o ponto apropriado em cada configuração do atributo de temperatura.

Para obter mais informações sobre o formato das referências de dados nas colunas dos atributos, consulte Referências de dados nas colunas de atributos.

(24)

Publicar os objetos para criar as referências de dados no PI AF

Depois de definir as configurações de referências de dados na planilha, publique a planilha para criar as referências de dados para os atributos de temperatura no PI AF.

Antes de Iniciar

Definir as referências de dados para o atributo de temperatura.

Procedimento

1. Na guia PI Builder, clique em Publicar para abrir a janela Opções de Publicação.

2. Na lista Editar Modo, selecione Criar e Editar.

O PI Builder edita os atributos de temperatura dos elementos do reator no banco de dados. O PI Builder ignora os pontos PI na coluna G, pois ela não tem cabeçalho. A janela Objetos selecionados de publicação mostra as operações concluídas. O PI Builder verifica

automaticamente as alterações. 4. Clique em Fechar.

Também é possível ver os atributos de temperatura no PI System Explorer. Se o PI System Explorer já estiver aberto, clique em Atualizar para ver as alterações.

Editar elementos e atributos

Siga este exercício para editar os elementos existentes no PI AF. Usando o PI Builder, modifique o template do reator para incluir novos atributos e edite os elementos que usam o template para definir valores para esses atributos. Por fim, use o PI Builder para pesquisar elementos com valores de atributos específicos.

Antes de Iniciar

Criar vários elementos vinculados aos pontos PI existentes.

Procedimento

1. Editar o template do reator.

Edite o template do reator criado no exercício anterior para dar suporte a atributos adicionais.

2. Editar os elementos do reator para especificar novos valores do atributo.

Use o PI Builder para editar os elementos do reator e definir novos valores para os atributos.

3. Recuperar um elemento com um número de série específico.

Recupere um elemento do reator com um número de série específico na planilha. 4. Recuperar elementos com datas de manutenção específicas.

Recupere os elementos do reator cujas datas da última manutenção sejam anteriores à data especificada na planilha.

Editar o template do reator

Pode-se usar o PI Builder para editar os templates já criados. Siga este procedimento para editar o template do reator criado no exercício anterior. Edite o template para adicionar novos Tutorial do PI Builder

(25)

Antes de Iniciar

Procedimento

2. No grupo Conexões, abra o banco de dados no qual o template do reator foi criado:

3. Recupere o template do reator:

a. Clique em Biblioteca > Templates > Encontrar Templates para abrir a janela Seleção de

Templates.

b. Na tabela de templates, selecione Template do Reator e clique em OK.

c. Na janela Selecione Tipos de Objetos e Cabeçalhos de Colunas, clique em Apagar Tudo. d. No grupo Padrão do Atributo, marque a caixa de seleção Tipo.

e. Clique em OK.

O PI Builder recupera o template do PI AF e grava os dados nas colunas selecionadas na planilha. A janela Objetos selecionados de recuperação mostra as operações concluídas. f. Clique em Fechar.

Nota:

Se não houver um template do reator, crie a planilha mostrada acima e publique-a no PI AF.

4. Crie o novo padrão do atributo:

a. Copie e cole a terceira linha nas próximas três linhas. b. Na quarta linha, especifique um atributo do fabricante:

Name Manufacturer

AttributeType String

c. Na linha cinco, especifique um atributo de número de série, que é um atributo filho do atributo do fabricante:

Name Manufacturer | Serial Number

AttributeType String

(26)

Nota:

Porque este é um atributo, a coluna Parent ainda deve especificar Reactor Template. Um caminho relativo do atributo no nome indica a hierarquia.

d. Na linha seis, especifique um atributo de data de manutenção, que é um atributo filho do atributo do fabricante:

Name Manufacturer | Last Maintained

AttributeType DateTime

5. Publique o template modificado:

b. Na lista Modo de Edição, selecione Criar e Editar.

O PI Builder cria os templates no banco de dados. A janela Objetos selecionados de publicação mostra as operações concluídas. O PI Builder verifica automaticamente as alterações.

Também é possível ver os templates no PI System Explorer. Se o PI System Explorer já estiver aberto, clique em Atualizar para ver as alterações.

Editar os elementos do reator para especificar novos valores do atributo

Pode-se usar o PI Builder para editar elementos existentes. Siga este procedimento para editar os elementos do reator para definir os valores dos novos atributos adicionados no

procedimento anterior. Os elementos serão recuperados em uma planilha e os valores, editados e publicados no PI AF.

Antes de Iniciar

Editar o template do reator.

Procedimento

2. Encontre os elementos que usem o template do reator:

a. Clique Elementos > Encontrar Elementos para abrir a janela Pesquisar Elemento.

b. Na lista Template, selecione Template do Reator.

c. Na lista Todos Descendentes, selecione Verdadeiro.

d. Clique em Pesquisar.

(27)

O PI Builder recupera os elementos que usam o template chamado Reactor Template na tabela Resultados.

e. Selecione todos os elementos na tabela Resultados e clique em OK.

3. Na janela Selecione Tipos de Objetos e Cabeçalhos de Colunas, especifique as colunas a serem mostradas na planilha:

a. Clique em Apagar Tudo para apagar todas as configurações existentes.

b. No grupo Colunas de Atributos (do Template do "Template do Reator"), marque três

caixas de seleção: ▪ Fabricante

▪ Fabricante|Última Manutenção

▪ Fabricante|Número de Série

4. Recupere os elementos selecionados nas colunas especificadas: a. Clique em OK.

O PI Builder adiciona as colunas selecionadas à planilha e recupera os elementos selecionados. A janela Objetos selecionados de recuperação mostra as operações concluídas.

b. Clique em Fechar.

5. Edite os elementos para especificar os valores do atributo do fabricante, número de série e data da última manutenção:

a. Na linha dois, insira os seguintes valores:

|Manufacturer ACME

|Manufacturer | Last Maintained 15 june 2010 10:00:00 |Manufacturer | Serial Number A123456

É possível inserir valores de data e hora em diversos formatos, inclusive o formato de Horário PI. Consulte Formatos de valores para obter mais informações.

b. Selecione as células de E2 a G2 e arraste a alça de preenchimento para a célula G11. O Excel copia as células selecionadas e preenche as colunas de número de série e última manutenção com valores sequenciais. As células para os novos atributos devem ser semelhantes a esta (o formato da data depende da sua configuração do computador local):

(28)

6. Publique os elementos no PI AF:

b. Na lista Modo de Edição, selecione Criar e Editar.

O PI Builder altera os valores do atributo no banco de dados. A janela Objetos selecionados de publicação mostra as operações concluídas. O PI Builder verifica automaticamente as alterações.

Também é possível ver os templates no PI System Explorer. Se o PI System Explorer já estiver aberto, clique em Atualizar para ver as alterações.

Recuperar um elemento com um número de série específico

Pode-se usar o PI Builder para recuperar elementos com valores de atributos específicos em uma planilha. Siga este procedimento para recuperar um elemento do reator com um número de série específico.

Antes de Iniciar

Editar os elementos do reator para especificar novos valores do atributo.

Procedimento

3. Se o campo ao lado do botão Pesquisar não estiver em branco, clique em para pagar o texto.

4. Em Critérios, configure os campos para encontrar o elemento desejado:

c. Clique em Adicionar Critérios e em Valor do Atributo para adicionar um conjunto de

campos que podem ser usados para pesquisar o valor do atributo.

5. No conjunto de campos Valor do Atributo, configure a consulta para encontrar elementos

(29)

a. Clique em Exibir opções de atributos e em Outros Atributos > Fabricante | Número de Série.

b. Defina o campo do operador como igual (=).

c. No campo do valor (marcado <Null>), digite A123462.

6. Clique em Pesquisar.

O PI Builder retorna o elemento React6 na tabela Resultados.

7. Selecione o elemento e clique em OK.

b. No grupo Colunas de Atributos (do Template do "Template do Reator"), marque a caixa

de seleção Fabricante | Número de Série.

9. Clique em OK para recuperar o elemento na planilha.

O elemento React6 aparece na planilha. Na coluna Fabricante | Número de Série, o valor deve ser A123462.

Recuperar elementos com datas de manutenção específicas

Pode-se usar o PI Builder para recuperar elementos com valores de atributos específicos em uma planilha. Siga este procedimento para recuperar elementos do reator cujas datas da última manutenção sejam anteriores a 19 de junho de 2010.

Antes de Iniciar

Editar os elementos do reator para especificar novos valores do atributo.

Procedimento

3. Se o campo ao lado do botão Pesquisar não estiver em branco, clique em para pagar o texto.

4. Em Critérios, configure os campos para encontrar o elemento desejado:

c. Clique em Adicionar Critérios e em Valor do Atributo para adicionar um conjunto de

campos que podem ser usados para pesquisar o valor do atributo.

5. No conjunto de campos Valor do Atributo, configure a consulta para encontrar elementos

com valores específicos no atributo da data de manutenção:

(30)

a. Clique em Exibir opções de atributos e em Outros Atributos > Fabricante | Última Manutenção.

b. Configure o campo do operador para o sinal de menor que (<).

c. No campo do valor (marcado <Null>), digite 19 de junho de 2010. 6. Clique em Pesquisar.

O PI Builder retorna quatro elementos na tabela Resultados.

7. Selecione todos os elementos retornados e clique em OK.

b. No grupo Colunas de Atributos (do Template do Reator), marque a caixa de seleção Fabricante | Última Manutenção.

9. Clique em OK para recuperar os elementos na planilha.

A planilha mostra todos os reatores cuja data da última manutenção foi anterior a 19 de junho de 2010.

(31)

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 PI AF Server e um banco e dados do PI AF ou um PI Server.

• Tarefas comuns

As tarefas comuns dão suporte a muitos dos procedimentos que desejam-se 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.

Conexões

Para recuperar e publicar objetos PI AF, o PI Builder deve se conectar ao banco de dados do PI AF (no PI AF Server). Para recuperar e publicar pontos PI, o PI Builder precisa se conectar a um PI Server. Portanto, antes de recuperar ou publicar dados com o PI Builder, especifique o banco de dados do PI AF ou o PI Server.

Nesta seção

• Especificar um banco de dados

Use o grupo Conexões para especificar banco de dados do PI AF ao qual o PI Builder ser

conectar ao recuperar e publicar objetos PI AF. • Especificar um PI Server

Use o grupo Conexões para especificar o PI Server ao qual o PI Builder ser conectar ao

recuperar e publicar pontos PI.

Especificar um banco de dados

Para recuperar e publicar objetos PI, o PI Builder deve se conectar a um banco de dados do PI AF. Use o grupo Conexões para especificar o PI AF Server e o banco de dados do PI AF. Depois

de especificar um banco de dados do PI AF, o PI Builder se conecta automaticamente ao PI AF Server e ao banco de dados do PI AF para qualquer operação que precise de comunicação com o servidor ou banco de dados. Pode-se especificar um banco de dados diferente a qualquer momento.

(32)

Procedimento

1. Na guia PI Builder, no grupo Conexões, especifique o PI AF Server e o banco de dados do PI

AF:

Se a lista não mostrar o servidor ou banco de dados necessários, selecione Conexões do banco de dados/servidor do AF de ambas as listas para abrir a janela Selecionar Banco de

Dados. Nessa janela, é possível:

◦ Selecionar um PI AF Server ou um banco de dados do PI AF.

◦ Clicar em Novo Banco de Dados para adicionar um novo banco de dados.

◦ Clicar em Mostrar Lista para abrir a janela Servidor AF na qual é possível adicionar e se conectar a um PI AF Server.

Especificar um PI Server

Para recuperar e publicar pontos PI, o PI Builder deve se conectar a um PI Server. Use o grupo

Conexões para especificar o PI Server. Depois de especificar um PI Server, o PI Builder se

conecta automaticamente ao PI Server especificado para qualquer operação que precise de comunicação com um PI Server. Pode-se especificar um PI Server diferente a qualquer momento.

Procedimento

1. Na guia PI Builder, no grupo Conexões, na lista PI Server, selecione o PI Server que

armazena os pontos PI.

Se a lista não mostrar o PI Server ou o banco de dados necessários, selecione Conexões do PI Server para abrir a janela PI Servers. Nessa janela, é possível:

◦ Selecionar um PI Server ao qual se conectar.

◦ Clicar em Adicionar PI Server para especificar as informações de conexão não listadas

para o PI Server.

◦ Selecionar um servidor e clicar 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 Server, é necessário sempre configurar os cabeçalhos de colunas na planilha. Da mesma forma, os procedimentos para recuperar, editar e excluir 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 Selecione Tipos de Objetos e Cabeçalhos de Colunaspara 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.

(33)

• 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 publicar as alterações no PI Server.

• Excluir objetos PI AF

Use o PI Builder para excluir objetos PI AF encontrados em uma planilha do Microsoft Excel pelo PI AF.

Defina os cabeçalhos de colunas em uma planilha

Use a janela Selecione 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 Objetos, selecione o tipo de objeto do PI System a ser recuperado na

planilha.

A lista Tipo de Objeto é atualizada para mostrar as colunas possíveis para o tipo de objetos

selecionado do PI System. As colunas selecionados e a organização são baseadas na planilha atual ou nas seleções anteriores. Para obter 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, selecionar 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 especificar

os atributos a serem adicionados:

(34)

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

▪ Insira o nome do atributo no campo Outros e clique em Adicionar.

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

Pode-se 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 esta coluna para especificar a string de segurança que controla o acesso aos 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 esta coluna para especificar a string de segurança para obter acesso a eventos e instantâneos. 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 esta coluna para especificar a srting de segurança da configuração do ponto. Essa string controla quais usuários podem recuperar as informações de configuração, por exemplo, 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)

em que:

• useridX identifica um usuário. As entradas válidas dependem do tipo de objeto: Fundamentos do PI Builder

(35)

◦ Para objetos PI AF, contas de usuários ou grupos do Microsoft Windows ◦ Para pontos PI, um PI user, PI group ou PI identity

• 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ó têm suporte às permissões de leitura e gravação.

Por exemplo, a seguinte string de segurança dá permissão de conta a Everyone para ler e ler dados e a ACME\bob ler, gravar, ler dados, gravar dados e excluir:

ACME\bob:A(r,w,rd,wd,d)|Everyone:A(r,rd)

A seguinte tabela lista as regras de acesso com suporte 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 seguinte tabela lista as permissões com suporte e o valor correspondente a ser inserido na string de segurança. Os pontos PI só têm suporte às permissões de leitura e gravação.

Permissão Valor da string de segurança

Leitura r Gravação w Exclusão d Execução x Administração a Leitura de dados rd Gravação de dados wd Substituição s Substituição de outros so Nota:

Se uma string de segurança não for 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

(36)

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 Server, prepare a planilha, clique em Publicar e configure as opções para 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 e coluna depois encontrar duas linhas e duas colunas totalmente vazias.

d. Coloque um X na coluna Selected(x) de qualquer linha que deseja-se que seja processada pelo PI Builder. 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 outros. ▪ Apenas Criar

O PI Builder cria novos objetos e gera um erro se o objeto já existe. ▪ Apenas Editar

O PI Builder edita objetos existentes e gera um erro se o objeto ainda não existe. ◦ Marque a caixa de seleção Criar ou Atualizar PI Points 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 Server.)

◦ Marque a caixa de seleção Criar Automaticamente Categorias Não Encontradas para que

o PI Builder crie as categorias não encontradas. (Essa caixa de seleção não estará Fundamentos do PI Builder

(37)

4. Clique em OK para iniciar a publicação.

A janela Objetos selecionados de publicação 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 criar os objetos. 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ências • Unidades de medida 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 no PI AF:

b. Na lista Modo de Edição, selecione Apenas Criar.

Com essa escolha, o PI Builder só cria novos objetos. Se já existir um objeto com o mesmo Fundamentos do PI Builder