PI WebParts 2013
Guia do usuário
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 WebParts 2013
© 2005-2014 por 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 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 Web API, 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: 4.0.2
Introdução ao PI WebParts... 1
Visão geral do PI WebParts... 1
Servidor do PI AF... 2
PI Server... 2
Dados de série temporal...3
Dados calculados...3
Dados contextuais...3
Requisitos do sistema cliente... 3
Configurar as preferências de segurança do Internet Explorer... 5
Sobre este documento...5
Trabalhando no SharePoint... 7
Configure o idioma...7
Configure o idioma padrão de um site do SharePoint...8
Verificar o formato de data... 8
Configurar uma web part... 9
Painéis de ferramentas da web part... 9
Definir um intervalo de horas da web part... 10
Propriedades de dados selecionados... 11
Itens de dados... 12
Especificar parâmetros e marcadores de posição...17
Caminhos de contexto do PI AF e ERDs... 17
Propriedades das colunas da tabela...21
Valores do filtro...24
Conectar web parts...27
Estabelecer uma conexão do SharePoint... 28
Especificar parâmetros de conexão...28
Enviar valores de filtro ao Microsoft Excel Web Access...30
Remover conexões da web part...31
Parâmetros da string de consulta... 32
Extensões e aplicativos relacionados...33
Displays do PI ProcessBook no PI WebParts... 33
Salve um PDI do PI ProcessBook como um gráfico SVG...34
Recursos SVG do PI ProcessBook... 34
Armazenamento de arquivos do display do PI ProcessBook...37
Mostrar displays PDI e SVG no PI ProcessBook... 37
Ad hoc tendências... 37
Exibir tendências sob demanda... 38
Alterar a apresentação de dados... 39
Definir as opções de exibição da tendência...39
Tendências nas janelas do navegador...39
Exportar dados para o Excel... 40
Imprimir web parts...41
Web part do PI ActiveView... 43
Taxa de atualização do PI ActiveView... 44
ERDs nas web parts do PI ActiveView...44
Configurar as web parts do PI ActiveView... 44
Propriedade Configurações do PI ActiveView... 45
Conexões do PI ActiveView... 45
Web part do PI BatchTable...47
Pesquisas de bateladas... 48
Resultados da batelada...48
Parâmetros de batelada...49
Configurar as web parts do PI BatchTable... 50
Propriedades Opções de pesquisa do PI BatchTable...50
Propriedades Critérios de pesquisa do PI BatchTable... 50
Conexões do PI BatchTable... 51
Web part do PI Gauge... 53
Configurar as web parts do PI Gauge...54
Propriedades do PI Gauge... 54
Propriedades Formato do PI Gauge...54
Propriedades Legenda do PI Gauge...55
Propriedades Zona e Escala do PI Gauge... 56
Conexões do PI Gauge...57
Web part do PI Graphic... 59
ERDs nas web parts do PI Graphic... 59
Exibir um SVG ad hoc...60
Controles do display de gráfico vetorial (SVG)...60
Configurar as web parts do PI Graphic...61
Configuração do PI Graphic... 61
Conexões do PI Graphic... 62
Web part do PI Messenger... 63
Configurar as web parts do PI Messenger... 63
Propriedades Definir lista de contatos... 63
Propriedades Definir configurações do PI Messenger... 64
Conexões do PI Messenger...65
Web part do PI Table... 67
Configurar as web parts do PI Table... 67
Conexões do PI Table... 67
Web part do PI TimeRange... 69
Definir um intervalo de horas... 69
Conexões implícitas de intervalo de horas... 70
Configurar as web parts do PI TimeRange... 70
Propriedades do display...71
Conexões do PI TimeRange... 71
Conexões de web parts de terceiros...71
Web part do PI TimeSeries... 73
Configurar as web parts do PI TimeSeries... 73
Conexões do PI TimeSeries...73
Web part do PI TreeView...75
Configurar as web parts do PI TreeView... 76
Data da consulta...76
Árvore de elementos do PI AF... 76
Conexões do PI TreeView...80
Web parts do PI Trend... 83
Configurar as web parts do PI Trend...84
Propriedades Escala de valores do PI Trend...84
Escala de tempo e tag do PI Trend...85
Propriedades Legenda do PI Trend...86
Propriedades das opções do display do PI Trend... 86
Configurações de orientação do PI Trend... 87
Propriedades Formatação do PI Trend...87
Conexões do PI Trend... 88
Web part do PI Values... 89
Cálculos do PI Values... 89
Configurar as web parts do PI Values... 90
Parâmetros de resumo do PI Values... 90
Conexões do PI Values... 91
Web part do PI XYPlot... 93
Configurar as web parts do PI XYPlot... 94
Propriedades Recuperação de dados do PI XYPlot... 94
Propriedades Horário do gráfico do PI XYPlot... 95
Propriedades Escala de valores do PI XYPlot... 96
Propriedades Legenda de exibição do PI XYPlot... 97
Propriedades Opções de exibição do PI XYPlot...97
Propriedades Formatação do PI XYPlot...98
Conexões do PI XYPlot...98
Site Administração de PI WebParts... 99
Configurações da apresentação... 99
Gerenciar configurações da tabela...100
Gerenciar as configurações de PI Trend e PI XYPlot... 108
Gerenciar as configurações dos contatos do PI Messenger...111
Remover uma configuração do PI WebParts... 114
Fontes de dados... 114
Fontes de dados do PI Server...114
Fontes de dados relacionais... 117
Fontes de dados do serviço Web...128
Suporte do PI Asset Framework... 133
Conjuntos de dados... 133
Conjuntos de dados do cálculo de PI... 133
Conjuntos de dados relacionais...138
Conjuntos de dados do serviço Web...143
Excluir um conjunto de dados... 151
Informações suplementares...153
Horário PI... 153
Abreviaturas do horário PI... 153
Expressões de tempo do PI... 154
Especificação de timestamp... 155
Suporte a tipo de dados do PI... 155
Outros tipos de dados suportados... 156
Formatos de número... 157
Exibir dígitos... 158
Codificações de parâmetros da string da consulta... 158
Tipos de conexão do SharePoint...161
Suporte técnico e outros recursos... 163
Introdução ao PI WebParts
O PI WebParts é um produto do servidor Web que permite que os usuários criem, personalizem e implementem visualizações continuamente atualizadas de dados dos PI Systems e de outras fontes. Com o PI WebParts implementado no Microsoft SharePoint, um navegador da Web poderá ser usado para:
• Adicionar web parts a páginas
• Reorganizar web parts em uma página
• Modificar a aparência de uma web part e exibir dados • Vincular web parts ao PI e a outras fontes de dados • Conectar as web parts e transmitir dados entre elas
O PI WebParts é implementado no ambiente do Microsoft SharePoint, com dados do PI System fornecidos pelos PI WebParts Services.
Nesta seção
• Visão geral do PI WebParts
A infraestrutura do PI System fornece acesso a diferentes tipos e fontes de dados. • Requisitos do sistema cliente
Talvez alguns softwares adicionais precisem ser instalados para que as páginas do PI WebParts sejam visualizadas nos computadores cliente.
• Sobre este documento
O Guia do Usuário do PI WebParts descreve as funções de cada web part e como integrá-las nas páginas da web part que fornecem informações sobre a infraestrutura da planta.
Visão geral do PI WebParts
O PI WebParts contém serviços que recuperam e exibem dados do PI System e de outras fontes de dados. A infraestrutura do PI System e os sistemas relacionados têm suporte a diferentes funções e fornecem acesso a diversas informações.
No PI WebParts, os dados do PI System armazenados no PI Asset Framework (PI AF) e no PI Servers serão usados. Normalmente, os dados do PI System descrevem os ativos em produção, além do desempenho deles na operação ou o status dos processos. Para exibir dados do PI em web parts individuais, é necessário especificar elementos e atributos do PI AF ou tags do PI que representem dados do ponto do PI.
Outros tipos de dados que complementa essa imagem podem ser fornecidos por outras fontes de dados ou referenciados nos servidores do PI System.
Em uma visão geral, pode-se pensar nas funções realizadas por diferentes tipos de dados e como elas contribuem com o entendimento completo da planta e do processo. No PI WebParts, essas informações podem ser classificadas como dados de séries de tempo, dados calculados e dados contextuais.
Nesta seção
• Servidor do PI AF
O servidor do PI AF fornece acesso unificado aos dados do PI System e faz referência a outras fontes de dados complementares.
• PI Server
O PI Server captura o desempenho histórico da planta ou do processo. • Dados de série temporal
Os dados de série temporal descrevem as atividades com o passar do tempo de uma fonte definida.
• Dados calculados
Os dados calculados fornecem computações agregadas baseadas em outro fluxo de dados. • Dados contextuais
Os dados contextuais descrevem os usos comerciais dos dados.
Servidor do PI AF
Um servidor do PI AF é um repositório de referências a dados dentro e fora da infraestrutura do PI System. Ele inclui pelo menos um archive de dados do PI Server lógico.
O PI Asset Framework (PI AF) fornece uma referência de metadados rica para os dados do PI que usa elementos e atributos do PI AF para fazer referência às tags de um PI Server ou aos dados de outras fontes do PI. O PI AF substitui o PI Module Database (MDB) encontrado nas versões anteriores do PI Server.
Atributos do PI AF
Um atributo do PI AF é uma referência a uma fonte de dados ou fluxo de dados do ponto e está armazenado em um banco de dados do servidor do PI AF. Os atributos do PI AF são filhos dos elementos do PI AF de outros atributos do PI AF.
Um atributo do PI AF pode fazer referência uma tag ou a dados de um PI Server com base em um banco de dados relacional ou outra fonte de dados, incluindo dados que são sejam PI. Podem-se adicionar atributos do PI AF como dados selecionados a uma web part junto com tags, conjuntos de dados, conexões de web part ou parâmetros de consultas.
Uma web part trata um atributo do PI AF como um parâmetro e resolve o atributo como um valor apenas por meio de uma consulta contendo o caminho de contexto completo para o atributo. Um componente chave de um atributo do PI AF é o seu caminho de contexto. É possível alterar o caminho de um contexto para permitir que dados de diversos elementos sejam exibidos no mesmo contexto. Isso permite o uso do mesmo display visual para monitorar vários ativos paralelos na planta ou no processo.
Os nomes de atributos são exibidos na legenda de uma web part, enquanto as dicas de ferramentas contêm o caminho completo para o atributo e o banco de dados do PI AF.
PI Server
O archive de dados do PI Server captura valores de pontos da planta ou do processo para descrever o desempenho e o status deles com o passar do tempo.
Os fluxos de dados associados aos pontos do PI Server são chamados de tags. É possível referenciar os dados do ponto do PI diretamente do PI Server usando tags.
Os elementos e atributos do PI AF podem fazer referência a pontos do PI e a dados de outras fontes e serviços Web relacionais.
Pontos e tags do PI
Uma tag do PI Server é um nome de referência ao fluxo de dados do ponto do PI armazenado em um archive de dados do PI Server. Um ponto do PI representa uma única medição ou cálculo e consiste de pares valor/timestamp e atributos do ponto associados.
As tags podem ser adicionadas como dados selecionados a uma web part com atributos, colunas de conjuntos de dados, conexões de web parts e parâmetros de consultas do PI AF.
Dados de série temporal
Os dados do PI Server são coletados e armazenados em forma de pontos, sendo que cada um representa um fluxo de dados de série temporal de uma determinada fonte, como um sensor de temperatura ou de pressão. Uma tag é uma referência a um ponto do PI.
Outros dados de série temporal podem incluir cálculos dos dados do ponto do PI.
Dados calculados
Os cálculos estatísticos permitem a visualização de médias, valores altos e baixos, totais e medidas de variação, além de cálculos mais complexos. Todos esses cálculos fornecem informações críticas sobre os eventos de dados durante um período.
Dados contextuais
Os dados contextuais são metadados que descrevem os pontos do PI, suas propriedades e seu uso corporativo. Quando estiverem vinculadas a determinadas web parts do PI, essas
informações poderão tornar os dados e sua apresentação mais lógica e acessível para a comunidade de usuários. O nome de tag de um ponto do PI é um dado contextual.
Os pontos do PI também têm diversas propriedades que podem ser configuradas associadas ao fluxo de dados, chamados de atributos de ponto. Entretanto, essas informações são
apresentadas amplamente em uma linguagem relevante para o processamento de dados e não em termos de negócios padrão ou de medição que são acessados com facilidade por usuários fora do departamento de TI.
A maioria dos dados contextuais do PI residem em bancos de dados do PI AF, que podem fornecer uma representação de todos os dados do PI System. Os atributos do PI AF podem referenciar os atributos e pontos do PI ou os dados em outros sistemas.
Requisitos do sistema cliente
As páginas do PI WebParts foram projetadas para funcionar como thin clients em uma janela do navegador. A maioria do processamento ocorre no servidor da Web para permitir requisitos mínimos do sistema do cliente.
O único requisito absoluto para visualizar uma página do PI WebParts é um navegador da web compatível em execução no Microsoft Windows. Entre eles estão:
• O Microsoft Internet Explorer (IE) 8 ou posteriores com os service packs mais recentes, • a versão mais recente do Mozilla Firefox,
Nota:
As conexões do SharePoint sempre são executadas no servidor no Firefox e no Chrome. Determinadas web parts exigem a seguinte instalação adicional do software nos computadores clientes:
Web part Requisito Motivo
PI ActiveView Produto do PI
ActiveView • O PI ActiveView 2.2 ou posteriores são necessários pararenderizar todos os recursos dos arquivos do PI ProcessBook (PDI).
• O PI ActiveView 3.2 ou superiores são necessários para exibir os ERDs criados no PI ProcessBook 3.2
PI Gauge PI Graphic PI Trend PI XYPlot Adobe SVG Viewer, quando em execução nos navegadores Microsoft Internet Explorer (IE) nas instalações do SharePoint 2010
Adobe SVG Viewer versão 3.0 é necessário para renderizar o formato Scalable Vector Graphics (SVG) para exibir o conteúdo dessas web parts.
É necessário ser um administrador no servidor cliente para instalar o visualizador de forma bem-sucedida.
PI ActiveView PI Graphic
PI ProcessBook • O PI ProcessBook 3.2 é necessário para criar e salvar displays relativos ao elemento usando atributos do PI AF para todas as web parts.
• O PI ProcessBook 3.0 ou mais recentes são necessários para usar o comando Abrir no PI ProcessBook na web part do PI Graphic. PI ActiveView O PI Graphic (suporte limitado) PI Messenger O Microsoft Internet
Explorer IE é necessário, pois essas web parts usam controles doActiveX. No PI Graphic, o IE só é necessário na compatibilidade com o comando Abrir no PI ProcessBook
PI Messenger • Microsoft Office 2003 ou superiores • Microsoft Outlook XP ou Controle do Catálogo de endereços do Outlook 2003 • Microsoft Windows Messenger, Windows Live Messenger, MSN Messenger ou Microsoft Office Communicator
Os componentes do Office são necessários para acessar as informações presentes e selecionar contatos no Catálogo de endereços do Microsoft Outlook. O Outlook XP ou o Outlook 2003 Address Book Control instalado separadamente é exigido.
Um dos clientes IM especificado é necessário para permitir a troca de mensagens instantâneas usando o PI Messenger.
PI BatchTable PI Table PI TimeSeries PI Trend PI Values
Microsoft Excel O Microsoft Excel XP ou superior é necessário para que a função Exportar para Excel > Abrir, que é iniciada em um processo separado do Excel no cliente, seja executada. O Excel não é necessário para exportar os dados da web part nem salvá-los em um arquivo XML.
Configurar as preferências de segurança do Internet Explorer
As configurações de segurança do Internet Explorer impedem que o navegador acesse sites e applets potencialmente inseguros.
Procedimento
1. Selecione Ferramentas > Opções da Internet e clique na guia Segurança.
2. Se níveis de segurança específicos não forem obrigatórios na zona associada ao servidor do PI WebParts, selecione o nível de segurança desta zona e use a barra deslizante para definir
o nível de segurança.
A configuração de segurança Média do navegador é geralmente um bom ponto de partida.
Se necessário, clique em Nível personalizado para definir cada uma destas configurações
individuais como Ativado:
◦ Controles e plug-ins de execução do ActiveX
◦ Controles de script do ActiveX marcados como seguros para criação de scripts ◦ Criação de script ativa
◦ Comportamentos binário e de script
◦ Solicitação automática do download de arquivo ◦ Download de arquivo
◦ Permissão de janelas iniciadas por scripts sem limites de tamanho ou posição (Internet Explorer)
◦ Recursos de arrastar e soltar ou copiar e filtrar arquivos e as seguintes configurações como Desativado:
◦ Utilização do bloqueador de pop-ups ◦ Ativação do modo protegido.
O que Fazer Depois
Se necessário, o site do SharePoint pode ser adicionado à zona Sites confiáveis, portanto as
configurações de segurança personalizadas não são aplicadas a outros sites na mesma zona.
Sobre este documento
O PI WebParts User Guide está dividido em duas partes. As seções iniciais se concentram no ambiente usado para criar páginas de web part e funções gerais que se aplicam a todas as web parts, inclusive configuração da web part e conexões do SharePoint. As últimas seções
compreendem cada um do PI WebParts e descreve a funcionalidade e os recursos específicos à web part.
Os itens a seguir são seções-chave:
• "Visão geral do PI WebParts" fornece uma visão geral da infraestrutura e dos dados do PI System usados com o PI WebParts.
• "Requisitos do sistema cliente" descreve o software adicional que pode ser exigido nos sistemas cliente que usam o PI WebParts.
• "Configurar uma web part" explica como personalizar uma web part para ser usada em uma página.
• "Conectar web parts" explica como conectar web parts para compartilhar informações. • As seções da web part individual descrevem cada web part com detalhes.
• "Site de administração do PI WebParts" descreve as funções de configuração acessíveis por meio de páginas de administração do PI WebParts. Essas funções incluem fontes de dados de provisionamento e templates de apresentação de construção para web parts individuais.
Nota:
Este guia não inclui informações sobre a instalação do PI WebParts. Para obter informações de instalação e configuração, consulte o PI WebParts Administrator Guide, publicado separadamente.
Trabalhando no SharePoint
O PI WebParts usa a tecnologia do Microsoft SharePoint como um framework para elaborar sites de portal e páginas da Web com web parts integradas.
O SharePoint é uma arquitetura colaborativa baseada na Web que permite que os usuários criem sites e páginas personalizadas que incluam web parts, documentos, links, feeds e outros conteúdos relacionados.
Consulte as notas de versão de versões específicas suportadas do SharePoint.
Visite o site Produtos e Tecnologias do Microsoft SharePoint para obter mais informações sobre o SharePoint.
Nesta seção
• Configure o idioma
Estabeleça as configurações regionais corretas do SharePoint para que correspondam com o idioma.
• Configure o idioma padrão de um site do SharePoint
Configure um idioma padrão do PI WebParts para que corresponda ao idioma dos usuários. • Verificar o formato de data
Defina os formatos corretos de data e hora a serem exibidos nas web parts.
Configure o idioma
A configuração de idioma do SharePoint determina os formatos de Data e Hora Curtas do Windows usados nas páginas do SharePoint, incluindo páginas da web part. Por exemplo, os idiomas europeus geralmente usam os formatos de data curtos dd-mm-yy, e os idiomas
asiáticos usam yy-mm-dd, já os Estados Unidos usam o formato mm-dd-yy.
Em geral, pode-se aceitar e usar uma configuração de idioma padrão do SharePoint. Se necessário, pode-se determinar um código de idioma para sua própria conta de usuário. Sempre que fizer login e exibir páginas do SharePoint, o idioma pessoal será usado para determinar os formatos adequados.
Procedimento
1. No canto superior direito da página selecione Minhas Configurações no menu.
A página Informações do usuário é exibida.
2. Clique em Minhas configurações regionais para exibir a página Configurações regionais.
3. Apague a caixa de seleção Seguir configurações da Web checkbox.
Se a caixa de seleção permanecer assinalada, as configurações padrão herdadas do SharePoint serão usadas para determinar o código do idioma.
4. Ajuste o Código de idioma ou personalize o Fuso horário, o Formato de horário e outras
Nota:
Se as Configurações regionais do SharePoint entrarem em conflito com o servidor da Web ou com as configurações do cliente, os formatos do SharePoint sobrescreverão os outros formatos. A exceção é o PI ActiveView, que interpreta strings de horário (exibidas em símbolos de tendência ou entrada por meio do PI TimeRange) de acordo com a configuração do fuso horário do cliente. Se o fuso horário for diferente no computador cliente, o PI ActiveView exibirá um contexto de horário diferente com base nas outras web parts.
Configure o idioma padrão de um site do SharePoint
Procedimento
1. No SharePoint, selecione Ações do site > Configurações do site.
2. Em Administração do site, clique em Configurações regionais para verificar ou alterar as
configurações do código do idioma.
É possível alterar o Idioma ou personalizar o Fuso horário, o Formato de hora e outras
configurações nesta página, de acordo com o idioma selecionado.
Verificar o formato de data
As Configurações regionais do SharePoint não exibem o formato de data abreviada em uso, com base no código de idioma. Pode-se buscar o mesmo código de idioma nas Configurações regionais do Windows para ver o formato de Data abreviada.
Procedimento
1. Caso não esteja seguro quanto ao formato de Data abreviada que o SharePoint está usado, selecione Iniciar > Painel de Controle > Opções Regionais e de Idioma.
A caixa de diálogo Opções Regionais e de Idioma do Windows aparece. Nota:
No Windows Server 2008, o caminho de menu é Iniciar > Painel de ControleRelógio, Idioma e Região > Alterar formato de data, hora e número.
2. Selecione o código de idioma que corresponde ao servidor do SharePoint a partir do menu suspenso.
Os campos da amostra são atualizados para retratar os formatos usados pelo Windows para o código de idioma.
3. Anote os formatos de Horário e Data abreviada.
4. Clique em Cancelar para sair da caixa de diálogo sem alterar a configuração do código de
Configurar uma web part
Ao configurar PI WebParts, é necessário fornecer as informações usadas por cada web part para adquirir dados. Também é necessário determinar o intervalo de horas dos dados que deve ser exibido e como a web part se comporta e interage com outras web parts. Também é
possível especificar uma formatação personalizada para alterar a aparência de uma web part para melhor retratar suas necessidades e objetivos de negócios.
Procedimento
1. Na parte superior direita do web part, clique na seta para baixo e selecione Edite a web part.
O painel de ferramentas é aberto à direita da página da web part. 2. Salve as alterações:
a. Clique em Aplicar para aplicar quaisquer alterações e recarregar a página da web part,
deixando o painel de ferramentas aberto.
As alterações aplicadas permitem rever a aparência da web part na página e fazer alterações adicionais sem fechar o painel de ferramentas. As alterações serão salvas ao clicar em Aplicar, portanto, usar a opção Cancelar não as descarta.
b. Clique em OK para aplicar quaisquer alterações e recarregar a página da web part,
fechando o painel de ferramentas.
Nota:
Não será possível desfazer as alterações depois de elas serem aplicadas, a não ser ao retroceder para reverter cada alteração.
Nesta seção
• Painéis de ferramentas da web part
Configure as web parts usando os painéis de ferramentas da web part e suas seções de ferramentas associadas.
• Definir um intervalo de horas da web part
As web parts que exibem um fluxo de dados precisam de um intervalo de horas. • Propriedades de dados selecionados
Os dados selecionados indicam os itens de dados que alimentam o display da web part.
Painéis de ferramentas da web part
As web parts são configuradas usando o painel de ferramentas, que diferirá dependendo da web part. Um painel de ferramentas da web part está dividido em várias seções de
ferramentas, sendo que cada uma representa uma categoria de configurações de personalização referente à web part.
As seções de ferramentas padrão regulam as propriedades básicas de exibição da web part. Essas seções de ferramentas são as mesmas para todas as web parts, mesmo aquelas que não são PI WebParts:
• Aparência
Geralmente, a seção de ferramentas Aparência é usada para alterar o nome da barra de títulos da web part e ajustar a largura em relação a sua zona e a outras web parts na página.
• Layout
Use a seção de ferramentas Layout para alterar as opções de exibição geral ou mover a web part para uma nova zona.
• Avançado
As ferramentas avançadas geralmente dizem respeito às permissões e à segurança.
Nota:
Consulte a documentação do Microsoft SharePoint para obter mais informações sobre as seções de ferramentas padrão.
As seções de ferramentas Intervalo de horas, Dados selecionados e Colunas da tabela são geralmente as mesmas ou muito semelhantes a todos os PI WebParts que as usam:
Algumas web parts também têm seções de ferramentas específicas que não são usadas para outras web parts. Essas seções estão descritas nas definições de configuração referente a cada web part individual nos últimos capítulos.
A qualquer momento, é possível modificar com facilidade as definições de configuração referentes a uma web part e até salvar as alterações para serem reutilizadas nas páginas diferentes ao exportar as web parts.
Definir um intervalo de horas da web part
A seção de ferramentas Intervalo de horas é comum a maioria dos PI WebParts. Um conjunto
de intervalos de hora no painel de ferramentas da web part controla o intervalo de horas padrão e atualiza a frequência dos dados fornecidos à web part.
Pode-se definir um intervalo de horas independentemente para cada web part ou orientar várias web parts usando um intervalo de horas compartilhado em toda a página da web part. Se a web part do PI TimeRange for usada na mesma página da web part para definir intervalos de hora de forma implícita e explícita para várias web parts, as configurações implícitas substituirão todas as configurações da seção de ferramentas Intervalo de horas, que não são usadas.
Procedimento
• Defina um intervalo de horas para a web part usando os campos Hora inicial e final e clique
em Aplicar para salvar.
• Clique no botão Conexões ao lado de um campo de hora inicial ou final para mapear um parâmetro de conexão de uma web part fornecedora para a propriedade.
Quando uma conexão explícita for estabelecida, a web part consumidora não receberá mais alterações implícitas do intervalo de horas das web parts do PI TimeRange na página.
Somente a web part fornecedora que está conectada explicitamente afeta o intervalo de horas da web part consumidora.
• Selecione atualizar a cada ## segundos para a web part com os dados atualizados e insira
um valor para o número de segundos entre as solicitações por dados atualizados. O valor padrão é 15.
Nota:
Se definir ou percorrer um intervalo de horas usando o PI TimeRange, as atualizações dos dados poderão ser interrompidas. Somente web parts com uma Hora final efetiva de * ou *+n (em que n é um incremento de horário) recebem dados atualizados automaticamente.
Propriedades de dados selecionados
A seção de ferramentas Dados selecionados lista e permite escolher e configurar as fontes de
dados usadas por uma web part, normalmente os atributos do PI AF, as tags ou os conjuntos de dados do PI.
A seção de ferramentas Dados selecionados é comum para a maioria do PI WebParts, com as
seguintes exceções:
• As web parts do PI Table e do PI Messenger fornecem acesso aos conjuntos de dados, mas não às tags ou aos atributos do PI como dados selecionados.
• As web parts do PI ActiveView, PI Graphic, PI BatchTable, PI TimeRange e PI TreeView não têm as seções de ferramentas dos dados selecionados.
Outras seções de ferramentas aparecem junto com os Dados selecionados, dependendo das
fontes de dados adicionadas ou à web part configurada.
Nesta seção
• Itens de dados
O PI WebParts tem suporte a uma variedade de itens de dados, inclusivo a atributos do PI AF, tags do PI, conjuntos de dados do PI Calculation e parâmetros de web parts conectadas. • Especificar parâmetros e marcadores de posição
Forneça os caminhos de contexto e os valores do parâmetro para alterar ou resolver o display dos itens de dados selecionados.
• Caminhos de contexto do PI AF e ERDs
Um caminho de contexto vincula um elemento do PI AF a um atributo filho e é frequentemente usado para exibir dados em muitos ativos.
• Propriedades das colunas da tabela
As propriedades das colunas da tabela especificam a aparência dos dados nas web parts tabulares.
• Valores do filtro
Os valores do filtro viabilizam a transmissão de parâmetros entre web parts.
Itens de dados
Na maioria das web parts, é possível adicionar um ou mais itens de dados. Um item de dados pode ser um atributo do PI AF ou um ponto do PI Server, especificado pelo nome. Um item de dados também pode ser uma coluna do conjunto de dados relacional ou do serviço Web de um conjunto de dados definido para o PI WebParts por meio dos PI WebParts Services.
Uma web part também pode receber caminhos das tags do PI e dos atributos do PI AF dinamicamente por meio de uma conexão com o SharePoint (ou string de consulta). Uma vez que duas web parts estiverem conectadas, será possível adicionar parâmetros da web part fornecedora como itens de dados selecionados na web part consumidora.
Use os controles na parte superior da seção de ferramentas Dados selecionados para adicionar
um novo item de dados:
• Clique dentro de uma fileira na tabela Dados selecionados e digite o caminho de contexto e
o nome de um atributo do PI AF ou o nome de uma coluna de tags ou conjuntos de dados. Por exemplo, pode-se usar a seguinte sintaxe para especificar um atributo :
\\<AF Server Name>\<AF Database Name>\<Element1-n>|<Attribute1-n> uma tag :
\\<PI Server Name>\<Tag Name> (ou apenas <TagName>, se for originado no servidor padrão)
ou uma coluna do conjunto de dados : <DatasetName>.<ColumnName>
Pressione Enter ou Tab para validar e adicionar outras linhas. Se clicar em uma fileira e o
campo não for ativado para edição, clique no botão Selecionar Fileira correspondente para tornar a fileira editável. Ao selecionar uma fileira contendo um nome do atributo do PI AF, o caminho de contexto para o atributo é exibido na caixa de texto Caminho de contexto na seção
Parâmetros/marcadores de posição.
• Clique no botão Selecionar PI Data para pesquisar os atributos do PI AF ou as tags do PI.
• Clique no botão Pesquisa no conjunto de dados para pesquisar os conjuntos de dados disponíveis das fontes de serviço Web, relacional ou do PI Calculation.
• Clique no botão Conexões para desenhar um item de dados de uma web part conectada na página ou de uma string de consulta na URL.
As opções disponíveis para selecionar os itens de dados variam de acordo com a web part. Por exemplo, as web parts que não suportam dados PI não permitem que você procure tags. Se a opção do item de dados não for exibida na área Dados selecionados, ela não será aplicável para a web part.
Nota:
Pode-se usar um item de dados somente uma vez dentro de uma única web part, exceto para a web part do PI XYPlot, que permite que o mesmo item de dados sirva tanto como tag X e tag Y.
Pesquisar atributos ou tags do PI AF
A maioria dos PI WebParts pode exibir dados do PI Server ou outras fontes fazendo referência aos atributos do PI AF. Uma pesquisa de atributos permite escolher um servidor e um banco de dados do PI AF, pesquisar por atributos e adicionar os atributos necessários à lista Selecionar dados.
Procedimento
1. Na seção de ferramentas Dados selecionados, clique no botão Selecionar PI Data .
A caixa de diálogo Selecionar PI Data é aberta.
a. Clique nas listas de divisa para escolher entre os PI Servers ou os servidores e bancos de dados do PI AF disponíveis.
Também é possível selecionar determinado elemento dentro da hierarquia para restringir mais o escopo.
b. Clique em Home para remover o servidor selecionado do escopo.
c. Marque uma caixa de seleção para restringir o escopo da pesquisa das tags ou dos atributos. Observe que uma seleção do servidor pode alterar ou limitar o tipo de itens de dados disponível para pesquisa.
3. Se pesquisar um servidor do PI AF ou banco de dados especificado, será possível inserir um
Caminho relativo para restringir ainda m ais o escopo da pesquisa. Insira o caminho sem
uma barra invertida \.
4. Insira o texto da pesquisa no campo Buscar texto e clique em OK. Nota:
A não ser que a pesquisa já tenha sido restringida a um nível do elemento, pelo menos um caractere não curinga deverá ser inserido na string de pesquisa (por exemplo, não é possível pesquisar por *, mas é possível pesquisar por .).
Os resultados da pesquisa aparecem no painel de resultados imediatamente abaixo. 5. Selecione os atributos desejados ou as tags no painel de resultados e clique em Adicionar
selecionado para adicioná-los ao painel Itens selecionados.
6. Clique em OK para salvar os itens de dados selecionados na lista de dados selecionados.
Pesquisar conjuntos de dados do PI
Muitos PI WebParts também podem exibir dados de conjuntos de dados pré-configurados do PI. Os exemplos de um conjunto de dados são um conjunto de dados do PI Calculation, uma consulta a um banco de dados relacional, um método de serviço Web ou uma planilha do Microsoft Excel.
Em geral, uma única coluna do conjunto de dados é usada como um item de dados da web part. Uma coluna é análoga a valores do ponto do PI no sentido em que uma dimensão de dados é representada. Colunas extras podem ser adicionadas como itens de Dados selecionados. A web
part do PI Table é uma exceção na qual podem-se adicionar todas as colunas em um conjunto de dados de uma só vez.
Para usar um conjunto de dados com web parts que geralmente exibem dados do PI históricos ou atuais, o conjunto de dados deve incluir os dados e uma coluna de data ou timestamp que realiza séries de tempo. Os conjuntos de dados são os únicos tipos de item de dados disponíveis para as web parts do PI Messenger e do PI Table.
Procedimento
1. Na seção de ferramentas Dados selecionados, clique no botão Pesquisa no conjunto de dados .
A caixa de diálogo Conjunto de dados é aberta.
2. Clique para selecionar um conjunto de dados que deseja usar.
Uma lista de colunas disponíveis para o conjunto de dados é exibida no painel da coluna abaixo.
3. Selecione o símbolo a ser adicionado.
Pressione e segure a tecla CTRL ou SHIFT e clique para selecionar várias colunas. 4. Clique em OK para adicionar a(s) coluna(s) selecionada(s) à lista Dados selecionados.
5. Caso seja aplicável, digite os parâmetros e os marcadores de posição para configurar informações adicionais na coluna do conjunto de dados.
Pesquisa de conjunto de dados do PI Table e do PI Messenger
Nas web parts do PI Table e do PI Messenger, a caixa de diálogo da pesquisa do conjunto de dados não solicita que uma coluna associada a um conjunto de dados selecionado seja
escolhida. Em vez disso, pode-se escolher um conjunto de dados e configurar o PI Table ou o PI Messenger para exibir apenas as colunas que desejam-se exibir na tabela.
Cada web part do PI Table exibe colunas de um único conjunto de dados. Se outro conjunto de dados for adicionado, ele substituirá o primeiro. Adicione web parts do PI Table extras para mostrar as colunas de diferentes conjuntos de dados.
Gerenciar dados selecionados
A tabela Dados selecionados lista todos os itens de dados atribuídos à web part. É possível usar
a tabela para gerenciar os itens de dados.
Também é possível selecionar um item dos dados para formatar dados correspondentes na web part usando outras seções no painel de ferramentas.
Procedimento
• Clique no ícone Atributo à esquerda de um nome de atributo para selecioná-lo. Quando selecionado, o caminho para o atributo selecionado é exibido na caixa de texto
Caminho de Contexto na seção Parâmetros/marcadores de posição.
• Clique no ícone Tag à esquerda de uma tag para selecioná-la.
• Remova o item selecionado usando o botão Excluir .
• Remova todos os itens, incluindo as conexões da web part, usando o botão Limpar . • Os itens dos dados são exibidos na lista Dados selecionados na ordem em que são
adicionados e essa mesma ordem é preservada no display da web part. É possível alterar a posição do item selecionado na lista usando os botões Acima ou Abaixo .
Substituir traços
A caixa de seleção Substituir traços Ad Hoc é exibida nas web parts do PI Trend e do PI XYPlot.
Mantenha essa caixa de seleção marcada para impor o comportamento padrão substitutivo das conexões da web part, em que os dados enviados das web parts conectadas substituem os traços de dados enviados anteriormente para uma tendência ou gráfico XY. Um traço esboçado com base em um evento de nova conexão substitui o traço esboçado do evento de conexão anterior.
Quando a caixa de seleção for desmarcada, o comportamento se tornará cumulativo e novos traços serão adicionados aos que foram enviados pelos eventos de conexão anteriores da web part.
Os traços ad hoc serão perdidos se sair da página, entrar ou sair do modo Projetar ou fechar a janela do navegador.
Nota:
O comportamento suplementar funcionará somente quando a página da web part estiver totalmente no modo Executar. No modo Editar, os traços ad hoc são substituídos,
independentemente da configuração.
Especificar parâmetros e marcadores de posição
O grupo Parâmetros/marcadores de posição aparecerão como uma seção de ferramentas
separada quando itens de dados selecionados puderem ser resolvidos ou alterados com dados adicionais, normalmente fornecidos por meio de uma conexão com uma web part.
O parâmetro mais comum é um caminho de contexto para o item de dados do atributo do PI, o
Caminho de contexto do atributo aparece quando um atributo é adicionado aos dados
selecionados. Os valores de parâmetro solicitados pelo conjunto de dados aparecem como campos nomeados. Observe que os parâmetros e os marcadores de posição não estão disponíveis para itens de dados da tag do PI.
• Nos atributos do PI AF, o Caminho de contexto do atributo relata o atributo a um elemento
pai do PI AF no banco de dados do PI AF. O caminho pode ser usado para alterar o contexto do atributo e exibir os dados correspondentes a um diferente elemento do PI AF.
• Nos conjuntos de dados, um ou mais marcadores de posição na consulta ou parâmetros do SQL são transmitidos ao método do serviços Web que aparece. Se o nome de exibição tiver sido configurado pelo programador do conjunto de dados, o nome de exibição será mostrado, em vez do nome padrão.
Procedimento
• Clique no botão Conexões para aceitar valores do caminho de contexto, do parâmetro ou do marcador de posição de uma web part conectada na página.
• Insira um valor para um caminho de contexto do atributo ou parâmetro ou marcador de posição. Pode-se aceitar o caminho padrão ou o valor especificado pelo criador do conjunto de dados. O caminho de contexto padrão de um atributo aparece por padrão no campo
Attribute Context Path.
Caminhos de contexto do PI AF e ERDs
Um caminho de contexto é a relação hierárquica entre um elemento pai (ou ativo) em um banco de dados do PI AF e um de seus atributos filho. Os dados exibidos no atributo a qualquer momento dependem do caminho do contexto que vincula o atributo a um elemento pai. Quando elementos paralelos no PI AF tiverem atributos correspondentes, uma única web part ou display do PI ProcessBook poderá ajudar na visualização de dados de muitos elementos. Esses displays são relativos do elemento e usam conexões web part para usar um único display em muitos elementos, visualizando os dados de atributo de cada uma.
Qualquer web part que aceite um atributo do PI AF como dados selecionados também aceitará um caminho de contexto como parâmetro. Além disso, ambas as web parts do PI ActiveView e do PI Graphics dão suporte aos displays do PI ProcessBook nos formatos .pdi e .svg nativos, respectivamente. Os displays do PI ProcessBook que usam caminhos de contexto são geralmente chamados de displays relativos do elemento (ERDs).
Os caminhos de contexto são enviados à web part com mais frequência da web part do PI TreeView, que fornece navegação hierárquica para a estrutura de banco de dados do PI AF. O PI TreeView pode funcionar como uma ferramenta de seleção de caminho de contexto em uma página de web part. Ao clicar em uma máquina na árvore, o caminho correspondente será enviado para as web parts conectadas. Também é possível usar outras web parts, como o PI Table, para enviar caminhos de contexto, se corretamente configuradas.
Nota:
O PI TreeView envia caminhos de contexto do PI AF então contextos de módulo com base no PI Module Database. As páginas de web part existentes com web parts do PI TreeView usadas para fornecer caminhos de módulos não comandarão displays que dependem de contextos de módulos. Essas web parts são automaticamente convertidas para usar caminhos do PI AF. Pode-se continuar a usar outras web parts (como PI Table ou uma web part terceirizada) para enviar caminhos de módulo.
Nesta seção
• Exemplo de caminho de contexto
Um display pode mostrar dados de vários ativos usando caminhos de contexto. • Definir web parts para usar caminhos de contexto
Uma web part pode exibir dados de ativos relacionados nos caminhos de contexto do PI AF. • Configurar um ERD do PI ProcessBook para usar caminhos de contexto
Um display do PI ProcessBook no PI Graphic ou no PI ActiveView podem exibir dados de ativos relacionados nos caminhos de contexto do PI AF.
Exemplo de caminho de contexto
Os caminhos de contexto permitem a alteração dos dados exibidos no PI WebParts usando conexões com outras web parts.
Por exemplo, se um banco de dados do PI AF incluir elementos que representam vários ativos analógicos em uma planta, uma web part poderá exibir essas informações em uma única tendência, indicador ou display .pdi. Esse método permite apresentar dados de ativos paralelos em uma única planta ou de diferentes locais globais, dado que a estrutura do atributo e
elemento estejam no mesmo PI AF.
Por exemplo, assuma que os tanques de 1 a 5 em uma planta estão todos descritos pelos mesmos atributos de medição de temperatura e pressão. Cada tanque é representado como um elemento no banco de dados do PI AF com os atributos de temperatura e pressão
correspondentes.
Uma tendência do PI ProcessBook exibe (no PI ProcessBook ou no PI ActiveView) ou uma web part do PI Trend mostram o atributo de temperatura como uma linha. Essa tendência pode exibir os dados de cada tanque por vez permitindo que o usuário especifique o caminho de contexto para qualquer elemento de tanque em particular. Cada novo caminho enviado alteraria o display dos dados.
Na prática, isso é possível no PI WebParts tornando o caminho de contexto uma parâmetro transmitido de uma web part para outra por meio de uma conexão da web part, geralmente pelo PI TreeView.
Definir web parts para usar caminhos de contexto
Se atributos do PI AF forem adicionados como dados selecionados para suportar web parts, será possível usar uma conexão da web part para orientar o display e mostrar dados de diferentes elementos (ou ativos) do PI AF. As web parts que suportam caminhos de contexto incluem PI Gauge, PI Time Series, PI Trend, PI Values e PI XYPlot.
Procedimento
1. Adicione a web part desejada à página da web part para exibir os dados de atributo neste PI Gauge de exemplo.
2. Adicione outra web part para enviar caminhos de contexto à primeira.
Essa web part orientará o display dos dados. Esse exemplo usar o PI TreeView como a segunda web part e a fonte de caminhos de contexto.
3. Use o menu suspenso nas web parts para estabelecer uma conexão entre as duas. 4. Edite a web part do PI Gauge e exiba a seção de ferramentas Dados selecionados.
5. Clique no botão Selecionar PI Data para pesquisar e adicionar atributos do PI AF, então,
clique em OK.
6. Clique em Aplicar para registrar os dados selecionados e recarregue a web part.
7. Na seção de ferramentas Parâmetros/marcadores de posição, clique no botão Conexão
ao lado do campo Attribute Context Path para exibir as web parts conectadas. Nota:
O caminho de contexto só é definido para o atributo selecionado na seção de ferramentas Dados selecionados. Para aceitar os caminhos de contexto de vários
atributos, selecione um por vez para configurar uma conexão para cada atributo individual.
8. Selecione a web part do PI TreeView adicionada e selecione Element Path como o parâmetro do campo de conexão.
9. Clique em OK para fechar o painel de ferramentas Configure a web part do PI TreeView
abrindo o painel de ferramentas Configuração do PI TreeView.
10. Clique em Pesquisar para pesquisar os mesmos elementos do PI AF em um banco de dados
selecionado.
11. Localize o nó do elemento na árvore que é um pai comum a todos os atributos relevantes ao display e selecione-o como Nó raiz e clique em OK.
Por exemplo, para visualizar dados de uma série de tanques idênticos, é necessário definir o nó raiz como o pai hierárquico dos tanques, o nó do elemento acima deles na árvore. O caminho para esse elemento aparece no campo Nó raiz. Configurar o nó raiz restringe o
display do PI TreeView para apenas os nós necessários para orientar o ERD.
12. Clique em OK para fechar o painel de ferramentas e saia do modo de edição da página da
web part.
13. Teste a conexão da web part e o display dos dados clicando entre os nós do elemento no PI TreeView.
Resultados
O display, inclusive as linhas da tendência, os símbolos e os caminhos, devem ser atualizados para indicar os dados enviados por um caminho de contexto, cada vez um elemento diferente é selecionado na árvore.
Se necessário, pode-se iniciar uma tendência em um display para fazer mais testes.
Configurar um ERD do PI ProcessBook para usar caminhos de contexto
Se um display relativo ao elemento do PI ProcessBook for carregado nas web parts do PI ActiveView ou do PI Graphic, será possível usar uma conexão da web part para orientar o display e mostrar dados de diferentes elementos (ou ativos) do PI AF.
Antes de Iniciar
Tem-se um display relativo ao elemento (ERD) salvo e acessível ao PI WebParts. O display pode estar no formato .pdi (para PI ActiveView) ou .svg (para PI Graphic) do PI ProcessBook.
Procedimento
1. Adicione uma web part do PI ActiveView ou PI Graphic à página da web part. 2. Adicione outra web part para enviar caminhos de contexto à primeira.
Essa web part orientará o display do ERD. Esse exemplo usar o PI TreeView como a segunda web part e a fonte de caminhos de contexto.
3. Use o menu suspenso nas web parts para estabelecer uma conexão entre as duas. 4. Edite a web part do PI ActiveView ou do PI Graphic e exiba a seção de ferramentas
Configuração.
5. Clique em Procurar ao lado do campo Arquivo selecionado para localizar e adicionar o ERD a
ser exibido e clique em OK.
6. Clique em Aplicar para registrar a escolha do arquivo e recarregue a web part.
7. Na seção de ferramentas Caminho de contexto atual, clique no botão Conexão para exibir as web parts conectadas.
8. Selecione a web part do PI TreeView adicionada e selecione Element Path como o parâmetro do campo de conexão.
9. Clique em OK para fechar o painel de ferramentas Configure a web part do PI TreeView
abrindo o painel de ferramentas Configuração do PI TreeView.
10. Clique em Pesquisar para pesquisar os atributos do PI AF em um banco de dados
selecionado.
11. Localize o nó do elemento na árvore que é um pai comum a todos os elementos relevantes ao display e selecione-o como Nó raiz e clique em OK.
Por exemplo, para visualizar dados de uma série de tanques idênticos, é necessário definir o nó raiz como o pai hierárquico dos tanques, o nó do elemento acima deles na árvore. O caminho para esse elemento aparece no campo Nó raiz. Configurar o nó raiz restringe o
display do PI TreeView para apenas os nós necessários para orientar o ERD.
12. Clique em OK para fechar o painel de ferramentas e saia do modo de edição da página da
web part.
13. Teste a conexão da web part e o display do ERD clicando entre os nós do elemento no PI TreeView.
Resultados
O display, inclusive as linhas da tendência, os símbolos e os caminhos, devem ser atualizados para indicar os dados enviados por um caminho de contexto, cada vez um elemento diferente é selecionado na árvore.
Se necessário, pode-se iniciar uma tendência em um display ERD para fazer mais testes. Substituir um caminho de contexto padrão
O caminho de contexto para o elemento ativo quando o display foi salvo pela última vez é o caminho de contexto padrão de um display relativo do elemento. É possível substituir esse caminho de contexto na seção de ferramentas Caminho de contexto padrão.
Antes de Iniciar
A web part de destino do PI ActiveView ou PI Graphic deve fazer referência a um display .pdi ou .svg relativo ao elemento criado no PI ProcessBook.
Procedimento
1. Clique no botão Selecionar PI Data para pesquisar o elemento do PI AF para ser usado
como caminho de contexto padrão.
2. Navegue até o nó do elemento a ser configurado como o padrão.
O caminho de contexto para esse elemento será usado para substituir o caminho originalmente salvo no display.
3. Clique com o botão direito e selecione o contexto padrão, então, clique em OK.
Também é possível clicar no botão Conexões para substituir o caminho de contexto padrão usando uma conexão da web part, orientando o display da web part usando os caminhos de elemento enviados de outras web part.
Resultados
Quando carregada, a web part usará o caminho especificado para o nó selecionado, em vez do caminho padrão do arquivo.
Propriedades das colunas da tabela
A seção de ferramentas Colunas da tabela é usada para especificar os dados e a formatação
referente às web parts que usam um formato de exibição com tabelas, incluindo PI Table, PI TimeSeries e PI Values.
• Configurações de comportamento
Selecione e aplique as configurações de comportamento personalizadas às colunas da tabela.
• Controle da coluna
Use os botões de setas para mover as colunas disponíveis do conjunto de dados para o campo de colunas selecionadas. As colunas não selecionadas não aparecerão no display da web part.
Especificar os comportamentos de tabela e coluna
Embora a maioria dos valores da coluna do conjunto de dados possa ser exibida como pontos de dados simples, outros valores talvez forneçam recursos gráficos, descritivos ou de links. Por exemplo, é possível clicar em valores de dados com hiperlink para enviar dados por meio de uma conexão da web part, iniciar páginas em um navegador ou mostrar uma tendência. É possível formatar as colunas do PI Table, PI TimeSeries e PI Values usando as configurações do formato da tabela. Uma configuração determina a aparência e as ações de clicar dos dados das células ao mapear colunas de tags ou do conjunto de dados para comportamentos específicos.
Procedimento
• Selecione uma configuração da tabela da lista Configurações de comportamento.
As configurações são listadas em ordem alfabética, com a primeira configuração aplicável atribuída a um conjunto de dados do PI Table como padrão. Se nenhuma configuração estiver associada ao conjunto de dados selecionado, as Configurações de comportamento
serão definidas como Nenhum (que também pode ser selecionado para reverter para a
configuração padrão).
Há duas configurações da tabela incluídas no PI WebParts. A configuração Tabela do RtSnapshot é aplicada automaticamente às web parts do PI Values, e a Tabela do RtArchive
• Selecione as colunas e use os botões de setas suspensos para movê-las entre as
Colunas Disponíveis e Colunas selecionadas para especificar as colunas a serem exibidas na
tabela.
As colunas configuradas como Ocultas aparecem como disponíveis por padrão, todas as
outras colunas aparecem como selecionadas por padrão.
• Escolha Linhas a exibir para especificar o número máximo de linhas visíveis a qualquer
momento na tabela.
Se houver mais linhas de dados disponíveis, os botões de paginação permitirão que o usuário percorra linhas adicionais.
• Selecione Fornece a Primeira Linha Automaticamente para especificar que uma web part do
PI BatchTable fornece automaticamente a primeira linha do resultado exibido por uma pesquisa de bateladas para as web parts conectadas.
• Como Administrador do PI WebParts, clique no botão Configurar para editar ou adicionar novas configurações. Uma página de Configuração de PI Table WebParts é aberta em uma nova janela do navegador.
Consulte o PI WebParts Administrator Guide para obter mais informações sobre as configurações de tabela.
Comportamento da coluna de tendências
As colunas com o comportamento Tendência Ad hoc exibem dados da coluna como hiperlinks;
quando for clicado, cada link abrirá um gráfico de Tendência em uma janela separada do
navegador usando o nome da tag configurada para essa linha. Comportamento da coluna Estado atual
Uma coluna definida para o comportamento Estado atual compara o valor da coluna com
valores de referência com um indicador de desvio.
O indicador mostra em que medida o valor da coluna se encontra acima (à direita) ou abaixo (à esquerda) de um valor de referência típico. Se um valor da coluna exceder ou permanecer abaixo dos valores de referência máximo ou mínimo, o indicador piscará.
Valores mínimo, máximo e típico podem ser determinados pelos atributos de valor zero, zero + span e típico da tag subjacente, ou obtidos de outras colunas no dataset.
O comportamento Estado atual pode ser usado somente para pontos de dados do estado numérico ou digital com um status adequado. Um indicador não é exibido com relação a uma linha com status inadequado ou configuração incorreta, e a célula da tabela exibe um ícone de Advertência. Posicione o cursor sobre o ícone para visualizar uma mensagem breve de erro ou clique no ícone para obter informações completas sobre o problema.
Comportamento da coluna oculta
As colunas definidas como comportamento Oculto podem ser usadas para fornecer dados para
A configuração Oculta determina a posição padrão da coluna (dispondo-a na lista de colunas Disponíveis, em vez de Selecionadas). As colunas ocultas ainda podem ser exibidas, mas por padrão não são.
Comportamento da coluna do hiperlink
Uma coluna definida como comportamento Hiperlink é exibida como um hiperlink em uma
página da Web, arquivo de imagem da Web (por exemplo, GIF ou JPEG) ou outro arquivo (por exemplo, SVG ou PDI). A URL do hiperlink pode ser fixa ou ser composta no todo ou em parte pelo valor em outra coluna no conjunto de dados, independentemente da outra coluna ser ou não exibida.
As colunas com comportamento Hiperlink incluem um ícone no cabeçalho ou substituem os valores individuais da coluna por ícones, dependendo da configuração. Quando um ícone ou um link for clicado, a URL de destino poderá ser aberta na janela atual, em uma nova janela do navegador ou em uma janela da caixa de diálogo modal. Os dados das linhas também podem ser enviados para web parts conectadas, em vez de transmitidos para uma URL.
Quando um cursor for posicionado no hiperlink de uma coluna, a Dica de ferramentas será exibida para indicar o destino do link. O texto da Dica de ferramentas também pode ser configurado por um administrador nas definições da Configuração dos comportamentos do PI Table.
Formatação condicional
As tabelas também pode ter uma formatação padrão e condicional aplicada a células com base nos comportamentos do formato configurados por um administrador.
A formatação condicional destaca valores extremos ou suspeitos em uma relação condicional. Cada célula poderá ser avaliada individualmente e a nova formatação poderá ser aplicada se o valor satisfizer uma expressão de condição pré-definida. Diversos formatos condicionais podem ser especificados para cada coluna, e eles são avaliados na ordem em que são definidos.
Valores do filtro
Uma propriedade Valor do filtro especifica um elemento de dados associado a uma web part,
cujos valores de dados correspondentes podem ser enviados para outra web part para filtrar ou selecionar os resultados dos dados.
Por exemplo, um valor do filtro especificaria comumente um parâmetro ou uma coluna de dados em uma web part. Quando uma conexão da web part for estabelecida, os valores de dados correspondentes serão enviados para a web part consumidora. A consumidora pode receber um nome da tag do PI, uma Hora inicial, um contexto do módulo ou outro tipo de parâmetro usado para consultar ou delimitar um conjunto de dados.
No PI WebParts, os valores do filtro são usados principalmente para conexões com a web part do Microsoft Excel Web Access. Os valores resultantes podem ser usados para resolver funções do PI DataLink e obter dados do PI. Os valores do filtro também podem ser enviados para quaisquer web parts do SharePoint que suportem conexões de valores do filtro.
Valores de filtro do PI BatchTable
No PI BatchTable, use Valores de filtro para especificar uma coluna de tabela de batelada. Um
valor de dados da coluna especificada é enviado quando uma linha da tabela correspondente for selecionada.
Valores de filtro do PI Table
No PI Table, use Valores de filtro para especificar uma coluna de tabela. Um valor de dados da
coluna especificada é enviado quando uma linha da tabela correspondente é clicada. Os dados subjacentes da coluna serão enviados se a coluna exibir outra informação além do valor dos dados, como um link ou um gráfico.
Valores do filtro do PI TimeRange
No PI TimeRange, Valores do filtro indica o tipo e o formato de strings de horário enviadas por
meio de conexões da web part.
Por padrão, o PI TimeRange envia os parâmetros Intervalo de horas, Hora atual, Hora inicial e Hora final no formato do Horário do PI. Esses valores também podem ser enviados em dois
formatos alternativos por meio das conexões das web parts:
• As versões (localizadas) dos parâmetros de horário usam formatos padrão de Data e hora abreviadas especificados para o código de idioma do site do SharePoint.
• As versões UTF dos parâmetros de horário usam strings em Universal Time Format. Também é possível especificar o sinalizador Está atualizando como um valor do filtro para
indicar quando o cache das web parts está sendo atualizado com novos dados.
Esses formatos alternativos são úteis para conexões com web parts de terceiros que exigem strings de horário em formatos baseados no Windows e para aquelas que não funcionam com formatos localizados, como a web part do Excel Web Access.
Nota:
Eles afetam todas as conexões de web parts associadas a determinada instância do PI TimeRange, incluindo conexões implícitas.
Valores de filtro do PI TimeSeries
No PI TImeSeries, use Valores de filtro para especificar uma coluna de tabela de batelada. Um
valor de dados da coluna especificada é enviado quando uma linha da tabela correspondente é clicada.
É possível especificar os dados da coluna formatada de data e hora a serem enviadas ao formato do Horário do PI (padrão) ou usando as versões específicas do local (Localizado) e o
formato de hora universal (UTF), como nas web parts do PI TimeRange.
Valores do filtro do PI TreeView
No PI TreeView, use Valores do filtro para selecionar um elemento de árvore a ser enviado por
uma conexão da web part. É possível enviar qualquer uma destas opções como um valor do filtro:
• Lista de tags do PI
• Nome do elemento do PI AF
• Caminho do elemento do PI AF (caminho de contexto)
• Atributos do PI AF expostos pelos pais do atributo selecionado
Valores do filtro do PI Values
No PI Values, use Valores do filtro para especificar uma coluna na tabela. Um valor de dados da
É possível especificar os dados da coluna formatada de data e hora a serem enviadas ao formato do Horário do PI (padrão) ou usando as versões específicas do local (Localizado) e o
Conectar web parts
Quando duas web parts em uma página estiverem conectadas por meio de uma conexão do SharePoint, o conteúdo exibido em uma web part será atualizado com base em uma seleção ou no evento clicado dentro da outra. Um dos recursos mais úteis do PI WebParts é a
interoperabilidade que permite conectar web parts para criar exibições interativas. Por exemplo, pode-se selecionar um elemento do PI AF de uma web part do PI TreeView e enviar seus atributos filhos para serem usados e exibidos em uma linha correspondente em uma web part do PI Trend. Também é possível transmitir parâmetros de intervalo de horas de uma web part para outras.
Nota:
Os dados fornecidos por meio de uma conexão do web part serão conservados quando a página for atualizada, mas serão perdidos ao sair ou fechar a janela do navegador. Além disso, podem-se definir conexões não apenas entre PI WebParts, mas também entre PI WebParts e web parts terceirizadas do SharePoint. Por exemplo, é possível inserir dados para marcadores de posição da consulta SQL em uma web part Microsoft Form e usá-los para atualizar uma web part do PI Table. Podem-se enviar parâmetros de uma web part do PI TimeRange e usá-los para atualizar uma planilha na web part do Microsoft Excel Web Access. Conectar uma web part a outra é um processo que envolve duas etapas:
• Primeiro, estabeleça uma conexão do SharePoint entre as web parts fornecedora e consumidora na página.
• Em seguida, modifique a web part consumidora usando a caixa de diálogo Conexões para
configurar parâmetros para cada conexão.
Cada conexão da web part pode ser um dos três tipos a seguir e exige uma web part fornecedora e uma web part consumidora:
• As web parts que enviam informações para as outras são fornecedores. • As web parts que recebem informações das outras são consumidores.
• Algumas web parts podem ser fornecedoras e consumidoras ao mesmo tempo.
Com exceção de PI TimeRange, que pode ser conectado automaticamente a outras web parts em uma página, é necessário criar conexões do SharePoint de maneira explícita.
Nesta seção
• Estabelecer uma conexão do SharePoint
Podem-se criar vários tipos de conexões entre web parts para trocar dados entre elas. • Especificar parâmetros de conexão
Selecione um parâmetro a ser enviado à web part consumidora e finalize a conexão da web part.
• Enviar valores de filtro ao Microsoft Excel Web Access
Oriente os workbooks do Excel exibidos no SharePoint por meio de conexões da web part. • Remover conexões da web part
Como remover web parts não usadas da página da web part. • Parâmetros da string de consulta
Estabelecer uma conexão do SharePoint
Para conectar web parts, primeiro estabeleça uma conexão do SharePoint que defina uma fornecedora e uma consumidora para a troca de informações.
Procedimento
1. Crie e abra uma página do web part do SharePoint no navegador. A página deve ter duas ou mais web parts para suportar uma conexão.
2. Selecione Ações do site > Editar página ou clique no botão Editar página na barra de
ferramentas do SharePoint para entrar no modo de edição.
3. Em ambos os web parts participantes, clique na seta para baixo no canto superior direito e selecione Editar > Conexões > <connection type> > <target web part>.
4. Selecione um tipo de conexão do primeiro submenu:
Opção Descrição
Lado do cliente (parâmetro) Use quando estiver disponível para minimizar as transferências para os servidores (postbacks). Lado do servidor (fileira) Transmita os mesmos dados como conexões do
cliente, mas solicite a comunicação com o servidor.
Filtro Envie parâmetros específicos a outras web parts
ou à web part do Excel e do Access.
As opções disponíveis dependem das web parts consumidoras e fornecedoras, e mais de um tipo de conexão deve estar disponível.
Se a web part também puder transmitir valores de filtro, será necessário confirmar se está enviando um parâmetro de cliente ou servidor em vez de um valor de filtro.
Resultados
Para indicar que as duas web parts estão conectadas, uma marca de seleção será exibida no menu Conexões de cada web part.
O que Fazer Depois
Com a conexão do SharePoint estabelecida, você poderá definir quais informações deseja que a web part consumidora aceite da fornecedora.
Especificar parâmetros de conexão
Se uma web part funcionar como uma consumidora, o botão Conexões será exibido ao lado de quaisquer campos de dados no painel de ferramentas da Web que podem ser preenchidos por outra web part por meio de uma conexão do SharePoint. Quando as web parts estiverem conectadas, será possível escolher entre vários parâmetros de conexão.
Procedimento
1. Clique no botão Conexões ao lado do campo que deseja atualizar de uma web part fornecedora.
