PI WebParts 2010 R2 Guia do usuário

Transcrição

1 PI WebParts 2010 R2 Guia do usuário

2 OSIsoft, LLC 777 Davis St., Suite 250 San Leandro, CA EUA Tel: (01) Fax: (01) Web: OSIsoft Australia Perth, Australia OSIsoft Europe GmbH Frankfurt, Alemanha OSIsoft Asia Pte Ltd. Cingapura OSIsoft Canada ULC Montreal & Calgary, Canadá OSIsoft, LLC Representative Office Xangai, República Popular da China OSIsoft Japan KK Tóquio, Japão OSIsoft Mexico S. De R.L. De C.V. Cidade do México, México OSIsoft do Brasil Sistemas Ltda. São Paulo, Brasil Manual do Usuário do PI Web Parts 2010 Copyright: OSIsoft, LLC. Todos os direitos reservados. Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema do qual possa ser recuperada, ou transmitida, de qualquer forma ou por qualquer meio, mecânico, por fotocópia, gravação ou qualquer outro meio, sem a autorização por escrito da OSIsoft, LLC. OSIsoft, a logomarca e o logotipo da 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 Data Services, PI Manual Logger, PI ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são marcas comerciais da OSIsoft, LLC. Todos os outros nomes ou marcas comerciais usados neste documento são de seus respectivos proprietários. DIREITOS DO GOVERNO DOS E.U.A. O uso, a duplicação ou divulgação pelo Governo dos E.U.A. estão sujeitos às restrições definidas no contrato de licença da OSIsoft, LLC e conforme fornecido nas DFARS , DFARS , FAR , FAR , conforme aplicável. OSIsoft, LLC. Versão: 3.1 Publicado em: 12/29/2010

3 Índice Capítulo 1 Introdução ao PI WebParts...1 Sobre o PI...1 Requisitos do sistema cliente...4 Sobre esse documento...5 Capítulo 2 Trabalhando no SharePoint...7 Configure seu código de idioma...7 Capítulo 3 Trabalhando com Web parts...9 Selecionar e adicionar uma Web part...9 Exportar e importar uma Web part...10 Minimizar ou remover uma Web part...10 Imprimir Web parts...11 Extensões e aplicativos relacionados...12 Capítulo 4 Configurar uma Web part...19 Painéis de ferramentas da Web part...19 Propriedades do intervalo de horário...20 Propriedades de dados selecionados...21 Capítulo 5 Conectar Web parts...37 Estabelecer uma conexão do SharePoint...38 Especificar parâmetros de conexão...38 Conexões do Excel Web Access...41 Remover conexões...43 Capítulo 6 A Web part PI ActiveView...45 Taxa de atualização do PI ActiveView...46 Configurar as Web parts PI ActiveView...46 Conexões do PI ActiveView...48 Capítulo 7 A Web part PI BatchTable...49 Pesquisas de bateladas...50 Resultados da batelada...51 Configurar Web parts PI BatchTable...51 Conexões PI BatchTable...54 Manual do Usuário do PI Web Parts 2010 iii

4 Índice Capítulo 8 A Web part PI Gauge...55 Configurar as Web parts PI Gauge...56 Conexões do PI Gauge...59 Capítulo 9 A Web part PI Graphic...61 Suporte da Tela do ProcessBook...62 Suporte do dataset...64 Crie um gráfico de tela do ProcessBook (.svg)...64 Configurar as Web parts PI Graphic...65 Exibições do SVG ad hoc...67 Controles de exibição do SVG...67 Conexões do PI Graphic...69 Capítulo 10 A Web part PI Table...71 Configurar as Web parts PI Table...71 Conexões do PI Table...71 Capítulo 11 A Web part PI TimeRange...73 Definir um intervalo de horário...73 Conexões de intervalo de horário implícitas...74 Configurar as Web parts PI TimeRange...74 Conexões do PI TimeRange...75 Capítulo 12 A Web part PI TimeSeries...77 Configurar as Web parts PI TimeSeries...77 Conexões do PI TimeSeries...78 Capítulo 13 A Web part PI Messenger...79 Configurar as Web parts PI Messenger...79 Conexões do PI Messenger...81 Capítulo 14 A Web part PI TreeView...83 Configurar as Web parts PI TreeView...83 Conexões do PI TreeView...86 Capítulo 15 A Web part PI Trend...89 Configurar as Web parts PI Trend...90 Conexões do PI Trend...94 Capítulo 16 A Web part PI Values...95 Exibição dos dados do PI Values...95 Configurar as Web parts PI Values...96 Conexões do PI Values...98 Capítulo 17 A Web part PI XYPlot...99 Configurar as Web parts PI XYPlot iv

5 Conexões do PI XYPlot Anexo A Informações adicionais Horário PI Suporte ao tipo de dados do PI Outros tipos de dados suportados Formato dos números Exibir dígitos Codificação de strings de consulta do URL Parâmetros de conexão Tipos de conexão do SharePoint Anexo B Suporte técnico e recursos Índice Manual do Usuário do PI Web Parts 2010 v

6

7 Capítulo 1 Introdução ao PI WebParts O PI WebParts é um produto de servidor baseado na Web que permite que os usuários criem, personalizem e implementem, de maneira contínua, exibições atualizadas de dados que pertençam ou não ao PI usando o navegador da Web Internet Explorer. O PI WebParts é formado por componentes visuais com finalidade única, que podem ser personalizados e adicionados às páginas da Web. Você pode: Adicionar e remover Web parts das páginas Redispor as Web parts em uma página Modificar a aparência das Web parts e a exibição dos dados Vincular Web parts ao PI e a outras fontes de dados Conectar Web parts e transmitir dados entre elas O PI WebParts é implementado em um framework que inclui o PI Data Services e o SharePoint. O PI Data Services fornece dados para Web parts a partir de uma série de fontes de dados, incluindo PI, databases relacionais e serviços da Web. As tecnologias Microsoft SharePoint (página 7) fornecem serviços ao usuário e aos diretórios, páginas da Web part e conectividade entre as Web parts. Sobre o PI O PI WebParts recupera e exibe os dados do PI Data Services, que suporta conexões com muitas fontes de dados diferentes. Essas fontes de dados irão incluir dados da sua infraestrutura do PI System e outros sistemas que suportem diferentes funções de negócios e forneçam acesso a diferentes informações. Você provavelmente trabalhará com os dados do PI armazenados em: Servidor AF Um AF Server é um repositório de dados do PI System. Ele inclui pelo menos um PI Server lógico ou coletivo. Um AF Server pode conter bancos de dados AF e do PI Notifications. O AF fornece uma referência de metadados cheia de recursos para os dados do PI Server que usam elementos AF e atributos AF, que podem fazer referência a tags de um PI Server ou dados de outras fontes que não sejam PI. Manual do Usuário do PI Web Parts

8 Introdução ao PI WebParts Os objetos do PI Module Database devem ser migrados para um banco de dados AF 2.0 ou superior para usar páginas de web part contendo referências a ativos. O PI WebParts converte módulos automaticamente, contextos de módulos, aliases e propriedades para seus elementos e atributos AF equivalentes. Nota: Desde a versão 3.0, o PI WebParts suporta bancos de dados e referências AF, mas não PI Notifications. PI Server O PI Server e superior apresentam um novo esquema de segurança e integração com os Servidores AF, que fornecem uma rica camada de metadados para dados do PI Server. Os elementos AF e atributos podem fazer referência a pontos PI bem como a dados de outras fontes e serviços web relacionais. Você pode fazer referência a dados de PI point diretamente do PI Server usando tags. Para que as web parts individuais exibam dados do PI, você provavelmente usará esses itens para especificar as informações que deseja visualizar: Atributos AF Um atributo AF é uma referência a uma fonte ou fluxo de dados armazenado em um banco de dados AF. Um atributo pode fazer referência uma tag ou dados de um PI Server a partir de um banco de dados relacional ou outra fonte de dados, incluindo dados que são sejam PI. Somente atributos AF definidos como valores constantes ou referências de pontos PI são atualmente suportados no PI WebParts. Conceitualmente, um AF Attribute substitui os PI Aliases e PI Properties anteriormente usados no PI Module Database. Você pode adicionar PI Attributes como Dados selecionados a uma web part juntamente com tags, datasets, conexões de web parts e parâmetros de consultas. Os AF Attributes são filhos dos AF Elements. Um componente chave de um atributo AF é o seu caminho de contexto. Você pode alterar um caminho de contexto para permitir que dados de vários elementos sejam visualizados dentro do mesmo contexto. Consulte o Manual do Usuário do AF 2010 para obter mais informações sobre o AF. Uma web part trata um atributo como um parâmetro. A web part resolve o atributo como um valor somente através de uma consulta contendo o contexto completo para o atributo. 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 AF. 2

9 Sobre o PI Tags PI Uma tag do PI Server é uma referência de nome a um fluxo de dados de ponto PI armazenado em um arquivo do PI Server. Um ponto PI representa uma única medição ou cálculo, e consiste de pares valor/carimbo de data e hora e atributos associados. As tags podem ser adicionadas como Dados selecionados a uma web part juntamente com atributos, colunas de dataset, conexões de web parts e parâmetros de consultas. No geral, você pode pensar nas funções que os diferentes tipos de dados executam. No PI WebParts, você trabalha com diferentes tipos de dados: Dados de série temporal Os dados do PI Server são coletados e armazenados no formato de pontos, sendo que cada um representa um fluxo de dados de série temporal a partir de uma determinada fonte, como um sensor de temperatura ou de pressão. Uma tag é uma referência a um ponto PI. Dados calculados Cálculos estatísticos fornecem outra maneira de exibir dados de série temporal. Médias, Valores altos e baixos, e medições de variação fornecem informações críticas sobre eventos de dados em um período. Dados contextuais Os dados contextuais são metadados que descrevem os PI points, suas propriedades e seu uso corporativo. Quando estiverem vinculadas a determinado PI WebParts, 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 PI point é um dado contextual. Os PI points 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 AF, que podem fornecer uma representação de todos os dados do seu PI System. Os atributos AF podem fazer referência a pontos e atributos PI em outros sistemas, incluindo bancos de dados relacionais e serviços web. Manual do Usuário do PI Web Parts

10 Introdução ao PI WebParts 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 a exibição de uma página do PI WebParts é o Microsoft Internet Explorer (IE) 6 ou mais recente com os Pacotes de serviços mais recentes. Entretanto, determinadas Web parts exigem a seguinte instalação adicional do software nos computadores clientes: Web Part Exige Motivo PI ActiveView PI ActiveView O PI ActiveView 2.2 ou mais recente é exigido para gerar todos os recursos dos arquivos (.pdi) de exibição do PI ProcessBook. A versão 3.2 ou superior é necessária para exibir os ERDs criados no PI ProcessBook 3.2 PI Gauge PI Graphic PI Trend PI XYPlot PI ActiveView PI Graphic PI Messenger PI BatchTable PI Table PI TimeSeries PI Trend PI Values Adobe SVG Viewer PI ProcessBook Microsoft Office 2003 ou mais recente Outlook XP ou 2003 Address Book Control Windows Messenger, Windows Live Messenger, MSN Messenger ou MS Office Communicator Microsoft Excel O Adobe SVG Viewer versão 3.0 é exigido para gerar conteúdo da Web part no formato Scalable Vector Graphics (SVG). Você pode fazer download do visualizador a partir do site Adobe SVG Viewer ( É necessário ser um Administrador no servidor cliente para instalar o visualizador de forma bem-sucedida. O PI ProcessBook 3.0 ou mais recente é exigido para usar o comando Iniciar no PI ProcessBook. O PI ProcessBook 3.2 é necessário para criar e salvar exibições relativas a elementos usando Atributos do PI. Os componentes do Office são exigidos para acessar informações de presença e selecionar contatos da Agenda de endereços do Outlook. O Outlook XP ou o Outlook 2003 Address Book Control instalado separadamente é exigido. Um dos clientes IM especificado é exigido para permitir a troca de mensagens instantâneas a partir do PI Messenger. O Microsoft Excel XP ou mais recente é exigido para a função Exportar para Excel > Abrir, que inicia um processo separado do Excel no cliente. Observe que o Excel não é necessário para exportar os dados da web part e salvar em um arquivo.xml. 4

11 Sobre esse documento Configurações 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. Para determinar um nível de segurança do navegador no Internet Explorer: Selecione Ferramentas > Opções da Internet e clique na guia Segurança. Em seguida, selecione uma Zona do conteúdo da Web e use o cursor para determinar um nível de segurança. Em geral, uma configuração de segurança do navegador Média aplicada à Zona associada ao servidor do PI WebParts é suficiente. Se a configuração Média não for permitida para a zona associada ao servidor do PI WebParts, você poderá clicar em Personalizar nível e definir cada uma das configurações individuais a seguir para Habilitado: Executar controles e plug-ins ActiveX Controles Script Active X marcados como seguros para script Script ativo Comportamentos binário e de script Prompt automático para downloads de arquivos Download de arquivos Permitir janelas iniciadas por script sem restrições de tamanho ou posição (Internet Explorer) Arrastar e soltar ou copiar e colar arquivos (Internet Explorer 7 e superior) e as configurações a seguir para Desabilitado: Usar bloqueador de pop-ups (Internet Explorer 7 e superior) Se necessário, o site do SharePoint pode ser adicionado à zona Sites confiáveis, portanto as configurações de segurança personalizadas não serão aplicadas a outros sites na mesma zona. Sobre esse documento O Guia do usuário do PI WebParts está estruturado em duas partes. Os capítulos iniciais se concentram no ambiente do Windows SharePoint usado para criar páginas da Web part e funções gerais que se aplicam a todas as Web parts, incluindo a configuração da Web part e as conexões do SharePoint. Os últimos capítulos compreendem cada um dos PI WebParts e descreve a funcionalidade individual e os recursos específicos para a Web part. Os itens a seguir são seções-chave: Sobre o PI (página 1) fornece uma visão geral da infraestrutura e os dados do PI System usados com as PI WebParts. Requisitos do PI WebParts (página 3) descreve o software adicional que pode ser exigido nos sistemas clientes que usam o PI WebParts. Manual do Usuário do PI Web Parts

12 Introdução ao PI WebParts Trabalhando no SharePoint (página 7) explica os conceitos básicos de criar e navegar nas páginas da Web part no Microsoft SharePoint. Trabalhando com Web parts (página 9) explica como adicionar Web parts às páginas. Configurar uma Web part (página 19) explica como personalizar uma Web part para usar em uma página. Conectar Web parts (página 37) explica como conectar Web parts para compartilhar informações. As seções da Web part individual descrevem cada Web part com detalhes. Nota: Esse guia não inclui informações sobre a instalação ou a administração do PI WebParts. Para obter informações sobre a instalação e administração, consulte o Guia do administrador do PI WebParts. Para obter informações sobre a configuração de fontes de dados do PI WebParts, consulte o Guia do Administrador do PI Data Services. 6

13 Capítulo 2 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 de Produtos e Tecnologias do Microsoft SharePoint ( para obter mais informações sobre o SharePoint. Configure seu código de idioma A configuração do código de idioma do SharePoint determina os formatos padrão de Data e hora abreviadas do Windows usados para as páginas do SharePoint, incluindo páginas da Web part. Por exemplo, os códigos de idiomas europeus normalmente usam formatos de data dd-mm-aa e os códigos de idioma asiáticos usam aa-mm-dd, enquanto os Estados Unidos usam o formato mm-dd-aa. Em geral, você pode aceitar e usar a configuração padrão Código de idioma do SharePoint (página 8). Se necessário, você pode determinar um código de idioma para sua própria conta de usuário. Sempre que efetuar logon e exibir páginas do SharePoint, o código de idioma pessoal será usado para determinar os formatos adequados. Para determinar ou verificar os formatos padrão de data e hora do SharePoint: 1. No canto superior direito da página selecione Minhas Configurações a partir do 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 configurações nessa página para corresponder ao seu código de idioma e clique em OK. Manual do Usuário do PI Web Parts

14 Trabalhando no SharePoint 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 diferir do computador cliente, o PI ActiveView exibirá um contexto de horário diferente a partir das outras Web parts. As Configurações regionais do SharePoint não exibem o formato Data abreviada em uso, com base no código de idioma. Você pode buscar o mesmo código de idioma nas Configurações regionais do Windows para ver o formato associado de Data abreviada: 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 é exibida. Nota: No Windows Server 2008, o caminho do menu é Iniciar > Painel de Controle > Relógio, Idioma e Região > Alterar o formato de data, hora ou 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 refletir 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 idioma. Configure o Código de Idioma de um Site do SharePoint Para configurar o código padrão referente ao Microsoft SharePoint: 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 Código do idioma ou personalizar o Fuso horário, o Formato do horário e outras configurações nessa página, dependendo do código de idioma selecionado. 8

15 Capítulo 3 Trabalhando com Web parts Essa seção aborda tarefas que são comuns à maioria dos PI WebParts. Por exemplo, o processo de adicionar uma Web part a uma página é o mesmo para todas as Web part, assim como a configuração de determinadas propriedades de formato e exibição. Da mesma forma, a ferramenta para selecionar dados da Web part e o processo para conectar as Web parts são os mesmos para todas as Web parts. Algumas tarefas e ferramentas necessárias ao trabalhar com PI WebParts são específicas para uma determinada Web part. As informações específicas da Web part são abordadas nas seções correspondentes da Web part. Selecionar e adicionar uma Web part Uma página da Web part é criada ao adicionar Web parts à zonas em uma página da Web part. Você pode buscar Web parts disponíveis, pesquisar uma Web part específica ou importar uma Web part existente salva ao adicionar Web parts a uma página. Para adicionar uma Web part a uma página: 1. Abra uma página da Web part no navegador da Web. 2. Clique em Ações do site > Editar página. 3. Clique em Adicionar uma Web part na zona da página onde deseja adicionar uma Web part. 4. Percorra a lista de Web parts disponíveis para localizar as Web parts que deseja adicionar à zona. 5. Selecione a web part desejada. 6. Clique em Adicionar para adicioná-la à página da web part. É possível adicionar somente uma instância de cada Web part por vez. Manual do Usuário do PI Web Parts

16 Trabalhando com Web parts Exportar e importar uma Web part Você pode exportar uma web part personalizada para reutilização. As Web parts exportadas são salvas no formato.dwp. Quando quiser usar uma Web part exportada em uma página, basta importar o arquivo.dwp salvo para a página. A Web part mantém qualquer personalização feita na página original e você pode fazer quaisquer alterações adicionais que desejar. Nota: Uma Web part pode se basear em conexões de outras Web parts que não estão presentes na nova instância da web part. Talvez seja necessário alterar ou reconectar esses itens antes que uma Web part importada seja executada de forma adequada. Para exportar uma Web part: 1. Clique em Ações do site > Editar página. 2. Na web part que deseja exportar, clique no botão Editar > Exportar... Uma caixa de diálogo Download do arquivo solicita que o arquivo da Web part exportada seja salvo. 3. Clique em Salvar, especifique um local do diretório e salve o arquivo. Minimizar ou remover uma Web part Você pode fechar ou remover uma Web part da página. Uma Web part fechada é removida da zona da página, mas permanece disponível conforme foi configurada. Uma Web part excluída é removida permanentemente da zona da página. Primeiro digite o modo de edição da página: Clique em Ações do site > Editar página. Para minimizar uma Web part: Clique no botão Editar > Minimizar. Repita o procedimento e selecione Restaurar para retornar à exibição em tamanho integral. Para fechar uma Web part: Clique no botão Editar > Fechar. Você pode adicionar a Web part configurada da caixa de diálogo Adicionar Web parts para retorná-la à exibição. Para remover uma Web part: Quando estiver no modo Editar, clique no botão Editar > Excluir. A Web part é removida da zona da página. Para restaurar a Web part na página, você deverá adicioná-la novamente. 10

17 Imprimir Web parts Imprimir Web parts Você pode imprimir o conteúdo das web parts PI Batch Table, PI Gauge, PI Graphic, PI Table, PI TimeSeries, PI Values, PI Trend e PI XYPlot sem imprimir outros conteúdos da página da web part. Para imprimir uma Web part: Clique na seta no canto direito superior da Web part e selecione Imprimir. A impressão em PI WebParts se baseia nas funções de impressão do Internet Explorer. Você pode imprimir uma página inteira ou o conteúdo selecionado dentro de uma Web part usando a função Intervalo de página > Selecionado na caixa de diálogo Imprimir do Explorer. Você pode imprimir tendências e exibições SVG com facilidade a partir das janelas usadas para mostrá-las. Os add-ins de impressão do Internet Explorer mencionados abaixo são úteis para ajustar essas imagens ao tamanho da página, mas você também pode redimensionar a janela de navegador para dimensões de página aproximadas para obter uma qualidade semelhante. Quando estiver preparado para imprimir, pressione Ctrl-P para configurar as opções de impressão (a opção paisagem é recomendada para tendências e exibições em SVG) e imprima a tendência ou SVG. Complementos Os add-ins ajustados/fixos de impressão da largura podem otimizar a funcionalidade de impressão do Internet Explorer ao dimensionar a imagem na janela do navegador para se ajustar à página impressa. Os add-ins estão disponíveis na Web e permitem que você imprima diretamente a partir da barra de ferramentas do Internet Explorer. Print Screen Outra opção é usar a função Print Screen no teclado para salvar a exibição da tela na área de transferência e, em seguida, colar a imagem da área de transferência em um programa de imagens que pode ser usado para editar, aparar ou redimensionar a imagem antes da impressão. Também é possível copiar uma exibição SVG ad hoc iniciada a partir de uma Web part da mesma maneira. Manual do Usuário do PI Web Parts

18 Trabalhando com Web parts Extensões e aplicativos relacionados Você pode exibir e transformar dados usando outras ferramentas e formatos suportados pelo PI WebParts. Tendências ad hoc As tendências o ajudam a visualizar e fornecer contexto para valores de dados individuais ao monitorar o comportamento do valor de uma tag em um período. Você pode criar tendências ad hoc de dados a partir da maioria das Web parts. As Tendências ad hoc são atualizadas em tempo real e suportam muitos dos mesmos recursos da Web part PI Trend (página 89). Você pode exibir tendências usando os comandos do menu, ao clicar em uma coluna com comportamento de Tendência ad hoc em uma Web part PI Table ou ao clicar em um elemento acionado por dados integrado em uma web part, como um valor, símbolo de barra ou tendência em uma exibição PI Graphic. Também é possível iniciar uma tendência em uma janela do navegador (página 14) usando parâmetros do URL. Use um dos dois métodos para exibir uma tendência: Clique no botão Editar > Tendência Ad hoc. Clique com o botão direito do mouse em uma Web part e, em seguida, selecionar Tendência ad hoc a partir do menu de contexto. Nota: As Tendências ad hoc podem ser geradas a qualquer momento, mas são temporárias e não podem ser salvas. Use a Web part PI Trend para criar uma tendência integrada em uma página da Web part. 12

19 Extensões e aplicativos relacionados A tendência é exibida em uma nova janela com controles que permitem que você percorra o intervalo de horário e dimensione o gráfico de tendências. O intervalo de horário da Web part pai é usado para determinar o intervalo de horário inicial do gráfico de tendências. Use os controles a seguir para personalizar a tendência: Controles de horário Use as ferramentas a seguir para definir ou ajustar o intervalo de horário: Digite um valor no campo Iniciar para especificar o início do intervalo de horário. O horário pode ser expresso no formato de horário PI ou no formato padrão Data e hora abreviadas do Windows configurado para SharePoint. Digite um valor no campo Final para especificar o final do intervalo de horário. O horário pode ser expresso no formato de horário PI ou no formato padrão Data e hora abreviadas do Windows configurado para SharePoint. Clique em Aplicar para aplicar valores de horário atualizados. Clique no botão Reverter para restaurar os valores padrão do horário inicial e final. Clique nos botões Retroceder/Avançar para ajustar os horários Inicial e Final para trás ou para frente de acordo com a quantidade da duração do intervalo atual. Se os valores Inicial e Final forem períodos relativos no formato PI, retroceder ou avançar converterá os valores para períodos absolutos. Manual do Usuário do PI Web Parts

20 Trabalhando com Web parts Controles de exibição Use as ferramentas a seguir para definir as opções de exibição: Você pode clicar e arrastar o mouse na exibição de tendências para ampliar uma área. Clique no ícone Reverter para restaurar a exibição original ou clique com o botão direito do mouse e selecione Desfazer zoom a partir do menu do contexto. Clique no ícone Marcadores de dados para adicionar marcadores de dados das tags do gráfico aos traços. Clique com o botão direito do mouse e selecione Adicionar cursor para adicionar um cursor da tendência ou clique no eixo Y e arraste o novo cursor na exibição. Selecione Remover todos os cursores para apagar os cursores da tendência. Use as teclas de seta para deslocar um cursor selecionado para a esquerda ou direita na exibição. Nota: As atualizações de dados serão suspensas enquanto os cursores estiverem sendo exibidos ou a exibição será ampliada. Controles de dados Use as ferramentas a seguir para controlar os dados usados e como eles são exibidos: Selecione um tag ou uma coluna do dataset a partir do menu Tags para aplicar opções de dimensionamento. Clique em Oculto para remover um traço selecionado na lista suspensa Tags da exibição, cursores, dicas de ferramentas e legenda. Restaure o traço ao apagar a caixa de seleção. Use as ferramentas Intervalo de escala mínimo e máximo para restringir a escala de valores. Selecione Múltiplas escalas para exibir escalas separadas de valor para cada traço. Clique em Aplicar dimensionamento para aplicar as alterações de dimensionamento à tendência. Abrir uma tendência em uma janela do navegador Você também pode abrir uma tendência ad hoc em uma janela do navegador usando um URL e parâmetros que especifiquem o Horário inicial, Horário final e um ou mais tags PI. Uma única tendência é exibida em uma janela separada com tags PI específicos. A tendência inclui os mesmos controles de horário, exibição e dados que são exibidos na Janela das tendências ad hoc (página 12). Um URL pré-definida é exigida para iniciar a janela do navegador de tendências: 14

21 Extensões e aplicativos relacionados Os parâmetros específicos da string de consulta suportados são: StartTime - o horário inicial da tendência. EndTime - o horário final da tendência. Dados - uma lista de um ou mais PI tags ou atributos AF concatenados na forma: \\<Nome do PI Server>\<Nome do Tag> ou \\<Nome do Servidor AF>\<Banco de dados AF>\<Elemento AF1-n> <Atributo AF1-n> Nota: Os Horários Inicial e Final podem estar no formato de segundos UTC ou em qualquer outro formato de horário suportado pelo PI WebParts. Um PI server deve ser especificado para cada tag (nomes de tag relativos não são aceitos). Um Servidor AF e um Banco de dados AF precisam ser especificados para cada atributo. Cada retrocesso duplo representa o início de uma nova string de tag ou de caminho de atributo. Todos os valores dos parâmetros devem ser codificados em URL para evitar ambigüidade quando caracteres especiais forem exibidos nos nomes do tag PI ou nos valores do timestamp. Alguns exemplos de strings de consulta com URL válido são: ime= &endtime= &data=\\piserver\cdt158\\pis erver\sinusoid ime=02/18/2007%2011:35:44am&endtime=02/18/2007%201:50pm&data=\\pis erver\test%23pound\\piserver2\sinusoid\\sea%20temperature ime=monday&endtime=monday%2b1d&data=\\piserver\test%23pound\\sinus oid\\piserverw\sea%20temperature Nos exemplos acima, os nomes reais dos dois Tags PI são \\piserver\test#pound e \\piserver2\sea Temperature. Os nomes de tag são codificados em URL para gerar valores de parâmetros test%23pound e Sea%20Temperature. Uma string do horário final que contenha um sinal de adição (+) também é codificado em URL, resultando em Monday%2B1d. Tendências baseadas no navegador são carregadas fora do contexto de um site do SharePoint e usam configurações do fuso horário do servidor da Web local, em vez do fuso horário do SharePoint ao interpretar e formatar valores do Horário Inicial e Final. Se valores inválidos dos parâmetros forem transmitidos na string de consulta (por exemplo, formatos de horário não suportados ou nomes de PI Server ou de Tag que não podem ser acessados no servidor da Web), uma mensagem de erro será exibida na tendência resultante. Se uma hora de término não é fornecida na string de consulta, a hora atual (*) é considerada. Manual do Usuário do PI Web Parts

22 Trabalhando com Web parts Telas do PI ProcessBook Você pode usar as Web parts PI ActiveView (página 45) ou PI Graphic (página 61) para adicionar telas do PI ProcessBook a uma página da Web part. Cada abordagem apresenta vantagens: As Web parts PI ActiveView suportam telas do ProcessBook no formato nativo (.pdi). As telas do ProcessBook são completamente funcionais no PI ActiveView, mas a instalação do PI ActiveView é exigida em todos os computadores clientes que exibem a página. As Web parts PI Graphic suportam telas do ProcessBook salvas no formato Scalable Vector Graphics como arquivos.svg. Esse método suporta todos os símbolos do ProcessBook, mas não suporta componentes ActiveX ou VBA, incluindo símbolos como PI BatchView ou o add-in PI SQC que pode ser usado em uma tela ativa do ProcessBook. O Adobe SVG viewer ( também deve estar instalado no cliente. De forma geral, a web part do PI ActiveView exige mais recursos em seu computador cliente, mas permite que você visualize controles ActiveX totalmente animados, símbolos de lote ou componentes de scripts em VBA. Nota: Você também poderá abrir os arquivos de tela (.pdi) ou de imagem (.svg) do ProcessBook diretamente no PI ProcessBook (página 16) se o aplicativo estiver instalado no computador cliente local. Armazenamento do PI ProcessBook Os arquivos do PI ProcessBook para PI Graphic e PI ActiveView podem ser armazenados em qualquer local da rede acessível para o SharePoint. Isso inclui uma biblioteca de documentos do SharePoint, um diretório de arquivos no servidor do SharePoint ou um compartilhamento de arquivo de rede que os usuários estão autorizados a acessar. Talvez você queira salvar as versões.pdi e.svg das telas do PI ProcessBook onde elas podem ser acessadas diretamente nas páginas da Web part, como uma Biblioteca de documentos no servidor do SharePoint. Certifique-se de copiar todos os arquivos gráficos associados a esses documentos no mesmo local. Consulte o site do Microsoft SharePoint para obter informações sobre a criação e o gerenciamento de Armazenamentos de arquivos colaborativos. Iniciar o PI ProcessBook Os arquivos do PI ProcessBook podem ser incorporados nas páginas da Web part usando as Web parts PI Graphic e PI ActiveView (página 15). Você também poderá abrir os arquivos de tela (.pdi) ou de imagem (.svg) do ProcessBook diretamente no PI ProcessBook se o ProcessBook estiver instalado no computador cliente local. Se o usuário tiver permissões para os diretórios do SharePoint (página 16), as edições poderão ser salvas diretamente no local onde os arquivos de exibição estão armazenados, como bibliotecas de documentos do SharePoint. 16

23 Extensões e aplicativos relacionados Para abrir uma exibição no ProcessBook: Ao visualizar uma exibição no PI ActiveView ou PI Graphic, clique no botão Editar > Iniciar no PI ProcessBook. Nota: Um arquivo de exibição já deve estar aberto na Web part para iniciá-lo no PI ProcessBook. Exportar dados para o Excel Use o comando Exportar para Excel para enviar dados de uma Web part para um arquivo que pode ser aberto no Microsoft Excel. Você pode exportar dados das web parts PI BatchTable, PI Table, PI TimeSeries, PI Trend e PI Values para o Microsoft Excel. Se o PI DataLinks estiver instalado no computador cliente, os resultados da exportação poderão ser usados com facilidade nas fórmulas do DataLink. Nota: O Microsoft Excel não é exigido no computador cliente para salvar dados no formato de arquivo do Excel, mas é necessário para abrir arquivos exportados no Excel. Para exportar dados para o Microsoft Excel: 1. Clique em Ações do site > Editar página. 2. Clique no botão Editar > Exportar para Excel, e selecione Abrir para abrir o Excel e exibir os dados, ou Salvar para salvar os dados para um arquivo.xml em seu computador. Manual do Usuário do PI Web Parts

24

25 Capítulo 4 Configurar uma Web part Ao configurar PI WebParts, você fornece informações usadas por cada Web part para adquirir dados. Você também determina o intervalo de horário de 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 refletir suas necessidades e objetivos de negócios. Para configurar uma Web part: 1. Clique em Ações do site > Editar página. 2. Clique no botão Editar > Editar Web Part. O painel de ferramentas é aberto à direita da página da Web part. Para salvar as alterações: 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 que você reveja a aparência da Web part na página e faça 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. Clique em OK para aplicar quaisquer alterações e recarregar a página da Web part, fechando o painel de ferramentas. Nota: Não é possível desfazer as alterações assim que elas forem aplicadas, a não ser ao retroceder para reverter cada alteração. 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 Layout Avançado Manual do Usuário do PI Web Parts

26 Configurar uma Web part Nota: Consulte a documentação do Microsoft SharePoint para obter mais informações sobre essas seções de ferramentas padrão. As seções de ferramentas a seguir normalmente são as mesmas ou bastante semelhantes para todos os PI WebParts que as utilizam: Intervalo de horário (página 20) Dados selecionados (página 21) Colunas da tabela (página 30) 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 (página 9) as Web parts. Propriedades do intervalo de horário A ferramenta Intervalo de horário é comum para a maioria dos PI WebParts e controla o intervalo de horário padrão e atualiza a freqüência dos dados fornecidos para a Web part. Se você usar o PI TimeRange (página 73) para determinar intervalos de horário de maneira implícita ou explícita para as web parts na página, as configurações da ferramenta de horário inicial e final referente à web part não terão efeito. Os horários podem ser expressos usando o horário PI ou os formatos de Data e hora abreviadas do Windows associados ao código de idioma do site do SharePoint. Use as ferramentas a seguir para definir o intervalo de horário: No campo Horário inicial, digite o início do intervalo de horário usado pela Web part, expresso no formato de horário PI ou no formato de Data e Hora abreviada do Windows associado ao código de idioma do site do SharePoint. O valor padrão é *-2h ou duas horas antes do horário atual. No campo Horário final, digite o final do intervalo de horário usado pela Web part, expresso no formato de horário PI ou no formato de Data e Hora abreviada do Windows associado ao código de idioma do site do SharePoint. O valor padrão é * ou o horário atual. 20

27 Propriedades de dados selecionados Clique no botão Conexões ao lado de um campo para criar uma conexão explícita (página 74) para outra Web part, como uma Web part PI TimeRange, para receber ou enviar valores de intervalo de horário. Quando uma conexão explícita for estabelecida, a Web part consumidora não receberá mais alterações implícitas do intervalo de horário das Web parts PI TimeRange na página. Somente a Web part fornecedora que está conectada explicitamente afeta o intervalo de horário da Web part consumidora. Selecione atualizar a cada ## segundos para fornecer dados atualizados para a Web part. Digite um valor para o número de segundos entre as solicitações de dados atualizados. O valor padrão é 15. Nota: Se você definir ou percorrer um intervalo de horário usando o PI TimeRange, as atualizações dos dados poderão ser interrompidas. Somente Web parts com um Horário final efetivo de * ou *+n (onde n é um incremento de horário) recebem dados atualizados automaticamente. Propriedades de dados selecionados A seção de ferramentas Dados selecionados permite que você selecione e configure as fontes de dados usadas por uma Web part, mais comumente Atributos AF, tags ou datasets PI. A seção de ferramentas Dados selecionados é comum para a maioria dos PI WebParts, com as seguintes exceções: As Web parts PI Table e PI Messenger fornecem acesso aos datasets, mas não aos tags ou atributos PI na seção de ferramentas Dados selecionados. As Web parts PI ActiveView, PI Graphic, PI BatchTable, PI TimeRange e PI TreeView não têm seções de ferramentas Dados selecionados. Você pode Adicionar itens de dados e especificar outras propriedades usando os elementos a seguir na seção de ferramentas Dados selecionados: Tabela Dados selecionados (página 27) Substituir traços ad hoc (página 27) Parâmetros e placeholders (página 28) Manual do Usuário do PI Web Parts

28 Configurar uma Web part Adicionar itens de dados Na maioria das Web parts, você pode adicionar um ou mais itens de dados. Um item de dados pode ser um AF Attribute ou PI point, especificado pelo nome. Um item de dados também pode ser uma coluna do dataset relacional de um dataset ou do Serviço da Web definido no PI Data Services. Uma web part pode também receber itens de dados de forma dinâmica através de uma Conexão do SharePoint (ou string de consulta (página 39)). Uma vez que duas web parts estão conectadas, você pode adicionar parâmetros de um provedor como itens de dados selecionados na web part de consumo. 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 (página 29) e o nome de um Atributo AF, ou o nome de uma coluna de tags ou datasets. Por exemplo, você pode usar a seguinte sintaxe para especificar um atributo : \\<Nome do Servidor AF>\<Nome do Banco de dados AF>\<Elemento1-n> <Atributo1-n> uma tag : \\<Nome do PI Server>\<Nome do Tag> (ou simplesmente <Nome do Tag>, se a partir do servidor padrão) ou uma coluna de datasets : <Nome do Dataset>.<Nome da Coluna> Pressione Enter ou Tab para validar e adicionar outra fileira. Se você 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 de Atributo AF, o caminho de contexto para o atributo é exibido na caixa de texto Caminho de Contexto na seção Parâmetros/Placeholders (página 28). Clique no botão Selecionar Dados do PI para pesquisar por Atributos AF (página 23) ou PI tags (página 24). Clique no botão Pesquisa do dataset (página 25) para pesquisar os datasets disponíveis a partir do cálculo do PI, fontes relacionais ou do serviço da Web. Clique no botão Conexões (página 38) para esboçar um item de dados a partir de uma Web part conectada na página, ou a partir de uma string de consulta (página 39) no 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: Você pode usar um item de dados somente uma vez dentro de uma única web part, exceto para a web part PI XYPlot, que permite que o mesmo item de dados sirva tanto como tag X e tag Y. 22

29 Propriedades de dados selecionados Pesquisa de Atributos A maiora das PI WebParts pode exibir dados do PI Server ou outras fontes fazendo referência a Atributos AF. Uma pesquisa de atributos permite que você escolha um Servidor e um banco de dados AF, pesquise por atributos e adicione aqueles que você precisa à lista Selecionar Dados. Para adicionar atributos a uma web part: 1. Na seção de ferramentas Dados selecionados, clique no botão Selecionar Dados de PI. A caixa de diálogo Selecionar Dados de PI é aberta. 2. Na guia Pesquisa de Atributos, escolha um Servidor AF a partir da lista de Servidores disponíveis. 3. Escolha um banco de dados AF a partir da lista de Bancos de dados dentro do Servidor AF selecionado. 4. Navegue através da árvore clicando para expandir os nós. Os nós de Elemento AF não são pais dos Atributos AF no servidor. Manual do Usuário do PI Web Parts

30 Configurar uma Web part 5. Selecione atributos para serem adicionados como fontes de Dados selecionados. Os caminhos e os nomes dos atributos selecionados são exibidos no painel Atributo abaixo da árvore. 6. Clique em OK para salvar a seleção de atributos na sua lista de Dados selecionados. Pesquisa de tags A maioria dos PI WebParts pode exibir dados do PI Server no formato de tags. Uma pesquisa de tags permite que você selecione um PI Server, pesquise sua lista de tags e adicione aqueles que são necessários à lista de Dados selecionados. Para adicionar tags a uma Web part: 1. Na seção de ferramentas Dados selecionados, clique no botão Selecionar Dados de PI. A caixa de diálogo Pesquisa de tags é aberta. 2. Na guia Pesquisa de tags, selecione um servidor da lista PI Server. 3. Digite o nome do tag no campo Máscara do nome. 4. Se você não souber o nome exato, pode usar um caractere curinga em uma máscara do nome. Use um asterisco (*) para múltiplos caracteres ou um ponto de interrogação (?) para um único caractere. Por exemplo, para localizar nomes de tag que começam com a letra "C", digite: C*. 24

31 Propriedades de dados selecionados 5. Clique no botão Pesquisar. A caixa de diálogo Pesquisa de tags consulta, no servidor especificado, os tags que correspondem à máscara do nome e os exibe em uma lista. 6. Clique em um tag para selecioná-lo na lista Resultados da pesquisa e clique em Adicionar para adicioná-lo ao painel de tags selecionados. Selecione e adicione múltiplos tags ao pressionar a tecla Ctrl ou Shift ao clicar para selecionar. Selecione um tag e clique em Remover para removê-lo do painel de tags selecionados. Clique em Apagar lista para remover todos os tags selecionados. 7. Clique em OK para adicionar os tags à lista Dados selecionados. Também é possível pesquisar tags com base em outros critérios além do nome do tag. Clique no link Mais na parte superior da caixa de diálogo Pesquisa de tags para pesquisar usando diferentes atributos do tag. Você pode especificar quantos critérios desejar, sendo que cada seleção restringe a pesquisa para a lista de tags que corresponde a todos os critérios de pesquisa. Use os botões de paginação na parte inferior para percorrer os resultados da pesquisa, Pesquisa no dataset Muitos PI WebParts também podem exibir dados de datasets configurados no PI Data Services. Os exemplos de um dataset são um dataset de cálculo do PI, uma consulta a um database relacional, um método de serviço da Web ou uma planilha do Microsoft Excel. Em geral, uma única coluna do dataset é usada como um item de dados da Web part. Uma coluna é análoga a valores de PI point no sentido em que uma dimensão de dados é representada. Colunas extras podem ser adicionadas como itens de Dados selecionados. A Web part PI Table é uma exceção (página 26) na qual você adiciona todas as colunas em um dataset de uma só vez. Caso queira usar um dataset com Web parts que normalmente exibem dados atuais ou históricos do PI, o dataset deve incluir uma coluna de dados e de data ou timestamp que compõe uma série temporal (página 109). Os datasets são o único tipo de item de dados disponíveis para as Web parts PI Messenger e PI Table. Para adicionar uma coluna do dataset a uma Web part: 1. Na seção de ferramentas Dados selecionados, clique no botão Pesquisa de dataset. A caixa de diálogo Datasets é aberta. 2. Clique para selecionar um dataset que deseja usar. Uma lista de colunas disponíveis para o dataset é exibida no painel da coluna abaixo. Manual do Usuário do PI Web Parts

32 Configurar uma Web part 3. Selecione a coluna que deseja adicionar. Pressione a tecla CTRL ou SHIFT ao clicar para selecionar múltiplas colunas. 4. Clique em OK para adicionar a(s) coluna(s) selecionada(s) à lista Dados selecionados. 5. Caso seja aplicável, digite parâmetros e placeholders (página 28) para configurar informações adicionais na coluna do dataset. Pesquisa de Dataset do PI Table e PI Messenger Nas web parts PI Table e PI Messenger, a caixa de diálogo da pesquisa de dataset não solicita que você escolha uma coluna associada a um dataset selecionado. Em vez disso, você pode selecionar um dataset e, em seguida, configurar o PI Table (página 71) ou configurar o PI Messenger (página 79) para exibir somente as colunas que deseja que sejam exibidas na tabela. 26

33 Propriedades de dados selecionados Cada Web part PI Table exibe colunas de um único dataset. Se você adicionar outro dataset, ele substituirá o primeiro. Adicione Web parts PI Table extras para mostrar as colunas de diferentes datasets. Tabela Dados selecionados A tabela Dados selecionados lista todos os itens dos dados atribuídos à Web part. Você pode usar a tabela para gerenciar os itens dos 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. Gerencie a lista dos itens de dados usando essas ferramentas: Clique no ícone de 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/Placeholders. Clique no ícone de 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 Apagar. Os itens dos dados são exibidos na lista Dados selecionados na ordem em que são adicionados e essa mesma ordem é preservada na exibição da Web part. Você pode alterar a posição do item selecionado na lista usando os botões Para cima ou Para baixo. Manual do Usuário do PI Web Parts

34 Configurar uma Web part Substituir traços ad hoc A caixa de seleção Substituir traços ad hoc é exibida nas Web parts PI Trend e PI XYPlot. Mantenha essa caixa de seleção assinalada para impor o comportamento padrão substitutivo das conexões da Web part, onde 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 a partir de 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 você 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. Parâmetros/Placeholders O grupo Parâmetros/Placeholders será exibido quando um AF Attribute ou um dataset relacional ou do serviço web com parâmetros ou placeholders for selecionado na lista Dados selecionados. Para Atributos AF, um parâmetro/placeholder é um caminho de contexto (página 29) que relaciona o atributo a um Elemento AF pai no banco de dados AF. Para datasets, um parâmetro/placeholder representa um placeholder em uma consulta SQL ou um parâmetro passado a um método de serviço web. Nota: Parâmetros e placeholders não estão disponíveis para itens de dados de PI tag. Cada item do parâmetro ou placeholder configurado para um dataset selecionado é exibido, atrelado a um campo de valor. Se o nome de exibição tiver sido configurado pelo programador do dataset, o nome de exibição será mostrado, em vez do nome padrão. 28

35 Propriedades de dados selecionados Para especificar valores do placeholder ou do parâmetro: O valor inicial para cada parâmetro ou placeholder é um valor padrão especificado pelo criador do data set. Você pode aceitar o valor padrão ou inserir um novo valor para qualquer item. Clique no botão Conexões para aceitar valores do parâmetro ou do placeholder a partir de uma Web part conectada na página. Caminhos de contexto Um caminho de contexto relaciona um Atributo AF a um elemento pai dentro de um banco de dados AF. Um Atributo AF adicionado como um item de dados de web part pode apontar para diferentes pontos PI de base dependendo de seu caminho de contexto. Os caminhos de contexto podem ser usados para gerar exibições criadas no PI WebParts e outros aplicativos clientes do PI. Exibições que utilizam caminhos de contexto desta forma são chamadas de relativas a elementos porque os dados exibidos para o atributo em qualquer momento dependem do caminho de contexto que vincula o atributo a um elemento pai. Exemplo de Caminho de Contexto Os caminhos de contexto são normalmente usados para alterar os dados exibidos por um web part com base na seleção do usuário. Por exemplo, com base na seleção de Elementos AF ou atributos que representam ativos em uma fábrica, uma tela pode apresentar dados de ativos em paralelo em uma única fábrica ou em diferentes locais. Uma Web part fornecedora pode transmitir um caminho do contexto para uma Web part consumidora por meio de uma conexão do SharePoint, permitindo que uma Web part dite os dados exibidos na outra. Por exemplo, assuma que os tanques de 1 a 5 em uma fábrica 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 AF com os atributos de temperatura e pressão correspondentes. Uma exibição de web part (ou outra exibição cliente do PI) que faz referência ao atributo de temperatura poderia exibir dados para cada tanque por vez permitindo que o usuário especifique o caminho de contexto para qualquer elemento de tanque em particular. No PI WebParts, os caminhos de contexto são enviados com mais frequência da web part PI TreeView, que fornece navegação hierárquica para o banco de dados 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. Os caminhos de contexto normalmente são enviados às web parts PI ActiveView e PI Graphic para sobrescrever um caminho de contexto padrão (página 66) armazenado em uma exibição. Para usar caminhos de contexto com Atributos PI selecionados como dados: 1. No modo Projetar, crie uma conexão do SharePoint (página 37) entre as Web parts fornecedora e consumidora. 2. Modifique (página 19) a Web part consumidora e exiba o painel de ferramentas. Manual do Usuário do PI Web Parts

36 Configurar uma Web part 3. Na seção de ferramentas Dados selecionados, use uma pesquisa de atributos (página 23) para encontrar e adicionar os atributos desejados como itens de dados. Quando um atributo for selecionado na tabela Dados selecionados, um campo Caminho de contexto será exibido na área Parâmetros/Placeholders (página 28). 4. Clique no botão Conexões ao lado do campo Caminho de contexto e selecione o campo de conexão (página 38) Caminho de contexto a partir da web part fornecedora para estabelecer uma conexão do SharePoint e, em seguida, clique em OK. Nota: Cada atributo selecionado possui seu próprio caminho de contexto configurado separadamente. O ícone Conexões é exibido em verde para indicar uma conexão ativa. A web part consumidora é atualizada para refletir os dados de atributos associados ao contexto selecionado. 5. Na web part fornecedora, selecione um novo elemento ou atributo para testar a conexão. A web part consumidora é atualizada com novos dados com base no caminho de contexto caso um atributo com o mesmo nome seja um item de dados selecionado. 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. Vários recursos na seção de ferramentas Colunas da tabela são usadas para formatar a exibição: 30

37 Propriedades de dados selecionados Colunas disponíveis Uma lista de colunas do dataset que pode ser adicionada à tabela. Selecione as colunas e use o botão de seta para baixo (direita) para movê-las para a caixa Colunas selecionadas para exibi-las na tabela. As colunas configuradas no dataset como Oculto são exibidas na lista de colunas disponíveis como padrão. Todas as outras colunas são exibidas na lista Colunas selecionadas como padrão. Colunas selecionadas Uma lista de colunas do dataset selecionadas para serem exibidas na tabela. Você pode remover as colunas selecionadas da tabela ao clicar no botão de seta para cima (esquerda) para movê-las para a lista Colunas disponíveis. Quaisquer colunas que não estejam configuradas como Oculto no dataset são selecionadas como padrão. As teclas de seta para cima e para baixo na parte inferior direita da lista de Colunas Selecionadas são usadas para controlar a ordem das colunas na lista. A ordem de cima para baixo na lista determina a ordem de exibição, da esquerda para a direita, na web part. Linhas a exibir 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 na tabela permitirão que o usuário percorra linhas adicionais. Fornecer automaticamente a primeira linha Selecione Fornecer primeira linha automaticamente para especificar que uma Web part PI BatchTable fornece automaticamente a primeira linha do resultado exibido por uma pesquisa de bateladas para as Web parts conectadas. Isso é exibido para web parts PI BatchView somente. Configurações de comportamento Embora a maioria dos valores da coluna do dataset possa ser exibida como pontos de dados simples, outros valores talvez forneçam recursos gráficos, descritivos ou de links. Por exemplo, você pode 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. Você pode formatar as colunas 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 dataset para comportamentos específicos. Aplicar configurações da tabela como configurações de comportamento: Selecione uma configuração da tabela a partir da lista Configurações de comportamento. Manual do Usuário do PI Web Parts

38 Configurar uma Web part Há duas configurações da tabela incluídas no PI WebParts. A configuração Tabela do RtSnapshot é aplicada automaticamente às Web parts PI Values e a Tabela do RtArchive às Web parts PI TimeSeries. As configurações são listadas em ordem alfabética, com a primeira configuração aplicável atribuída a um dataset do PI Table como padrão. Se nenhuma configuração estiver associada ao dataset 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). Se você for um Administrador do PI WebParts, clique no botão Configurar para editar ou adicionar novas configurações. Uma página de Configuração do PI WebParts é aberta em uma nova janela do navegador. Consulte o Guia do Adminstrador do PI WebParts para obter mais informações sobre as configurações de tabela. Os seguintes comportamentos da coluna podem ser exibidos nas configurações da tabela: Tendência 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 do tag configurado para essa linha. 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. Oculto As colunas definidas como comportamento Oculto podem ser usadas para fornecer dados para outras Web parts por meio de uma conexão, mas não são exibidas na tabela como padrão. 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, como padrão, não são. 32

39 Propriedades de dados selecionados 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). O URL do hiperlink pode ser fixo ou ser composto no todo ou em parte pelo valor em outra coluna no dataset, 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, o URL de destino poderá ser aberto 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 passar para um 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. Dados 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 de tag PI, um Horário inicial, um contexto do módulo ou outro tipo de parâmetro usado para consultar ou delimitar um dataset. Em PI WebParts, os valores do filtro são usados principalmente para conexões com a Web part Microsoft Excel Web Access (página 41). 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. A seção de ferramenta Valor do filtro é exibida no painel de ferramentas para as seguintes web parts: Manual do Usuário do PI Web Parts

40 Configurar uma Web part Valores do filtro do PI BatchTable Em PI BatchTable, use Valores do filtro para especificar uma coluna da tabela de batelada. Um valor de dados da coluna especificada é enviado quando uma linha da tabela correspondente for selecionada. Valores do filtro do PI Table Em PI Table, use Valores do filtro para especificar uma coluna da tabela. Um valor de dados da coluna especificada é enviado quando uma linha da tabela correspondente for 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 Em PI TimeRange, a propriedade Valore do filtro indica o tipo e o formato de strings de horário enviadas por meio de conexões da Web part. Como padrão, o PI TimeRange envia parâmetros de Intervalo de horário, Horário atual, Horário inicial e Horário final no formato Horário PI (página 107). Esses valores também podem ser enviados em dois formatos alternativos (página 75) 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 (página 7) do site do SharePoint. As versões UTF dos parâmetros de horário usam strings em Universal Time Format (página 75). Também é possível especificar o flag 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 Excel Web Access. Nota: Os valores do filtro referentes ao PI TimeRange não correspondem necessariamente a um evento clicado para enviar informações para outra Web part. Eles afetam todas as conexões de Web parts associadas a uma determinada instância de PI TimeRange, incluindo conexões implícitas. Valores do filtro do PI TimeSeries Em PI TimeSeries, use Valores do filtro para especificar uma coluna da tabela. Um valor de dados da coluna especificada é enviado quando uma linha da tabela correspondente for clicada. Você pode especificar os dados da coluna de data e hora formatada a ser enviados no formato Horário PI (página 107) (padrão) ou usar versões (Localizadas) e em Universal Time Format (UTF) específicas do código de idioma, como nas Web parts PI TimeRange. 34

41 Propriedades de dados selecionados Filtros do PI TreeView Em PI TreeView, use Valores do filtro para selecionar um elemento em árvore a ser enviado por meio de uma conexão da Web part. Você pode enviar qualquer uma das opções a seguir como um valor do filtro: ο ο ο ο ο Lista de PI tags Nome do Elemento AF Caminho do Elemento AF Caminho de contexto (página 29) relativo a um elemento Atributos AF especificados em quaisquer pais de atributo Filtros do PI Values Em PI Values, use Valores do filtro para especificar uma coluna da tabela. Um valor de dados da coluna especificada é enviado quando uma linha da tabela correspondente for clicada. Você pode especificar os dados da coluna de data e hora formatada a ser enviados no formato Horário PI (página 107) (padrão) ou usar versões (Localizadas) e em Universal Time Format (UTF) específicas do código de idioma, como nas Web parts PI TimeRange. Manual do Usuário do PI Web Parts

42

43 Capítulo 5 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 que você conecte Web parts para criar exibições interativas. Por exemplo, você pode selecionar um Atributo AF a partir da web part PI TreeView e adicionar os traços correspondentes à exibição em uma web part PI Trend. Também é possível transmitir parâmetros de intervalo de horário de uma Web part para outras. Nota: Os dados fornecidos por meio de uma conexão da Web part serão conservados quando a página for atualizada, mas se perderão se você sair da página ou fechar a janela do navegador. Além disso, você pode 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 placeholders da consulta SQL em uma Web part Microsoft Form e usá-los para atualizar uma Web part PI Table. Você pode enviar parâmetros de uma Web part PI TimeRange e usá-los para atualizar uma planilha na Web part Microsoft Excel Web Access. 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 (página 74) a outras Web parts em uma página, você deve criar conexões do SharePoint de maneira explícita. Conectar uma Web part a outra é um processo que envolve duas etapas: Primeiro, estabeleça uma conexão do SharePoint (página 37) 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 (página 38) para cada conexão. Manual do Usuário do PI Web Parts

44 Conectar Web parts 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. Para conectar Web parts: 1. Abra uma página da Web part no navegador da Web. A página deve ter duas ou mais web parts para suportar uma conexão. 2. Clique em Ações do site > Editar página. 3. Em qualquer uma das web parts participantes, clique em Editar > Conexões > tipo de conexão > web part. 4. Selecione um tipo de conexão do primeiro submenu. As opções disponíveis dependem das web parts consumidoras e fornecedoras, e mais de um tipo de conexão deve estar disponível. Conexões do lado do cliente (Parâmetro) e do lado do servidor (Fileira) passam os mesmos dados. Para minimizar idas e vindas ao servidor (retornos), use conexões do lado do cliente quando estiverem disponíveis. Algumas conexões, principalmente aquelas entre PI WebParts e a Web part Excel Web Access, usam conexões de filtro (página 41). Se a web part também pode transmitir valores de filtro (página 33), você deve confirmar que está enviando um parâmetro de cliente ou servidor em vez de um valor de filtro. 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. 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 puder 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. 1. Clique no botão Conexões ao lado do campo que deseja atualizar a partir de uma Web part fornecedora. A caixa de diálogo Conexões é aberta. 2. A lista Web parts conectadas exibe as Web parts conectadas como fornecedoras. Se nenhuma Web part for exibida na lista, não haverá Web parts conectadas como fornecedoras. Clique em cancelar e estabeleça uma conexão com o SharePoint (página 37) a partir da Web part fornecedora antes de prosseguir. 3. Selecione uma Web part fornecedora da lista Web parts conectadas. O campo Conexão exibe uma lista de todas as colunas de dados disponíveis a partir da fornecedora. 38

45 Especificar parâmetros de conexão 4. Selecione um item de dados e clique em OK para concluir a conexão. Você também pode selecionar Nenhum para remover um mapeamento de um determinado item de dados sem interromper a conexão da Web part. O botão Conexões será mostrado em verde quando a configuração estiver concluída, indicando que o campo dos dados foi preenchido por uma Web part fornecedora na página. Nota: Somente um item de dados pode ser transmitido por meio de uma conexão do SharePoint para um determinado campo. Se uma nova conexão for especificada, a conexão anterior será substituída. Assim que uma conexão for concluída, você poderá acionar a conexão da Web part fornecedora para exibir as atualizações dos dados na Web part consumidora. Por exemplo, clique em um Atributo na web part fornecedora PI TreeView para enviar informações para uma Web part PI Trend conectada estabelecida como consumidora. Manual do Usuário do PI Web Parts

46 Conectar Web parts Parâmetros da string de consulta Os parâmetros da string de consulta podem ser adicionados a um URL de uma página de web part para enviar valores de conexão de parâmetro aos campos da web part consumidora quando a página carregar pela primeira vez. Os parâmetros da string de consulta podem ser estabelecidos para qualquer campo da web part que aceite uma conexão do SharePoint como uma fonte de dados. Nota: Um parâmetro de string de consulta sobrescreve o valor padrão do campo que, por sua vez, é sobrescrito porque qualquer parâmetro de conexão enviado de outra web part. Por exemplo, considere uma página com o URL Documents/mypage.aspx que contenha uma web part PI Trend. Aos campos Hora inicial e Hora final são atribuídos os parâmetros de string de consulta início e fim, respectivamente. A tendência é algo configurado para mostrar o valor de um Atributo AF, que existe em vários contextos de elementos. O Caminho de contexto da web part é configurado para obter seu valor a partir de um parâmetro da string de consulta contextpath. Um usuário que deseja que a página exiba inicialmente um traço do Atributo AF residindo em \\PISystem\AFDatabase\MyElement nas últimas quatro horas adicionaria os parâmetros e valores da string de consulta ao URL da página da web part da seguinte forma: Documents/mypage.aspx?contextpath=\\PISystem\AFDataBase\<Element&s tart=*-4h&end=* onde os pares parâmetro-valor estão delimitados pelo caractere ampersand (&), ou sua codificação de URL. Para definir um parâmetro de string de consulta para uma web part consumidora: 1. Na seção de ferramenta Dados selecionados, clique no botão Conexões ao lado do campo que você deseja atualizar através de um parâmetro de string de consulta. A caixa de diálogo Conexões é aberta. 2. Insira o nome do parâmetro da string de consulta desejado no campo Parâmetro de string de consulta e clique em OK. 40

47 Conexões do Excel Web Access Conexões do Excel Web Access A Web part Microsoft Excel Web Access (EWA) está incluída na Enterprise Edition do Microsoft SharePoint Server 2007 (MOSS). Você pode adicionar essa Web part a uma página e conectá-la ao PI WebParts como consumidora. Normalmente, os workbooks do Excel publicados no SharePoint para ser usados com o PI WebParts incluem as funções PI DataLink ou PI BatchView, que são suportados pelo PI DataLink para Excel Services, uma versão do servidor do Add-in PI Data Link para Excel. Para obter mais informações sobre a Web part EWA, o PI DataLink para Excel e a integração com o PI WebParts, consulte o Guia do PI DataLink para Excel Services. Você pode enviar três tipos de dados do PI WebParts para EWA: Nomes workbooks, para exibir um determinado workbook em uma Web part EWA. Itens identificados, como um nome de intervalo, gráfico ou tabela de eixos, para exibir somente aquele elemento na Web part EWA. Parâmetros de células, para inserir um valor em uma célula da planilha que, por sua vez, pode ser mencionado por uma função do PI DataLink. Nota: Os nomes dos workbooks e os itens identificados são enviados por meio de conexões do lado do cliente ou do servidor (página 37). Os parâmetros de células são enviados por meio de uma conexão IFilterValues. Para enviar valores de filtro através de conexões de web part: 1. Configure a propriedade Valores do filtro (página 33) da web part fornecedora. 2. A partir de qualquer uma das web parts participantes, clique em Editar >Conexões > conexão de filtro > segunda webpart para conexão. As opções de conexão disponíveis dependem das Web parts consumidoras e fornecedoras e do fato de você ter iniciado a conexão a partir da fornecedora ou da consumidora. Um workbook com células identificadas já deve estar carregado na Web part EWA para concluir a conexão FilterValues. Entretanto, você pode enviar um nome do URL do workbook ou um Item identificado para uma Web part EWA vazia. 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. A caixa de diálogo Configurar conexão é exibida. 3. Se a conexão partiu da Web part fornecedora, especifique o Tipo de conexão na guia Selecionar conexão e, em seguida, clique em Configurar. Manual do Usuário do PI Web Parts

48 Conectar Web parts 4. Na guia Configurar conexão, selecione o item do parâmetro no menu Parâmetro filtrado que deseja especificar por meio da conexão da Web part. Para as conexões EWA, os valores do Parâmetro filtrado correspondem às células identificadas no workbook do Excel. 5. Clique em Concluir para finalizar a conexão. Se a Web part consumidora for uma Web part EWA, o workbook será recalculado automaticamente ao receber o parâmetro, permitindo que as funções do PI DataLink acessem o PI server e atualizem os valores das células na planilha. 42

49 Remover conexões Remover conexões Você pode separar as conexões entre as Web parts caso queira redirecioná-las para novas fornecedoras ou consumidoras. Para remover as conexões: 1. Clique em Ações do site > Editar página. 2. Em qualquer uma das web parts que deseja conectar, clique em Menu da Web Part > Conexões. Os tags de verificação serão exibidos ao lado das Web parts listadas para indicar conexões ativas com relação à Web part atual. 3. Selecione a Web part que deseja desconectar. Será solicitado que você confirme a remoção da conexão. 4. Clique em OK para desconectar as Web parts. Manual do Usuário do PI Web Parts

50

51 Capítulo 6 A Web part PI ActiveView A Web part PI ActiveView mostra as telas do PI ProcessBook em uma página da Web part. A web part PI ActiveView está estreitamente vinculada a outros dois aplicativos clientes PI: O PI ProcessBook é usado para criar arquivos de tela (.pdi) do ProcessBook exibidos em PI ActiveView. Todos os elementos gráficos em uma tela do ProcessBook são configurados no PI ProcessBook. As telas do ProcessBook são geradas no PI ActiveView usando o aplicativo PI ActiveView. O PI ActiveView compreende um executável do cliente, um controle ActiveX e outras ferramentas para desenvolver e implementar aplicativos das páginas da Web. A web part PI ActiveView suporta um conteúdo estático e dinâmico do ProcessBook. As exibições são apresentadas conforme aparecem no PI ProcessBook, mas são somente exibição. A web part PI ActiveView também suporta quaisquer dados configurados do PI, dataset de cálculo do PI e um dataset ODBC usado por uma tela do ProcessBook, desde que as configurações de conexão com relação aos dados que não são do PI estejam configuradas no computador cliente para mostrar dados atualizados. Manual do Usuário do PI Web Parts

52 A Web part PI ActiveView Taxa de atualização do PI ActiveView A web part do PI ActiveView usa o aplicativo PI ActiveView para gerenciar atualizações de dados referentes às telas do ProcessBook. Quando elementos de dados dinâmicos em uma exibição forem configurados para ser atualizados, o PI ActiveView consultará o PI server e receberá novos valores. Os novos dados serão usados para ampliar traços de tendências, atualizar valores de exibição e atualizar quaisquer outros símbolos que indiquem valores ou status atuais. O PI ActiveView tem uma taxa de verificação padrão de 5 segundos, significando que o PI ActiveView entra em contato com o PI server a cada 5 segundos em busca de novos dados para atualizar a exibição. Você pode configurar essa definição para alterar a taxa de verificação usando as configurações do PI ActiveView armazenadas no arquivo PIPC\dat\Acview.ini no computador cliente. Ajuste o valor do Temporizador na seção Gerenciador de Dados para redefinir a taxa de verificação. O valor padrão é 5 mil milésimos de segundos e o valor máximo é 60 mil milésimos de segundos. Configurar as Web parts PI ActiveView Você pode configurar uma Web part PI ActiveView usando o painel de ferramentas de Web parts e as seções de ferramentas de configuração padrão, incluindo Intervalo de horário (página 20), Aparência, Layout e Avançado. A web part do PI ActiveView também inclui três seções de ferramentas extras que permitem que você especifique como a tela do ProcessBook é mostrada na web part. Configuração do PI ActiveView A seção de ferramentas Configuração do ActiveView especifica o conteúdo de exibição referente à Web part. Use o campo Arquivo selecionado para indicar o arquivo.pdi que deseja exibir na web part PI ActiveView. Você pode digitar um caminho completo para um arquivo ou inserir um caminho parcial e clicar na seta para baixo para Navegar ou Pesquisar um arquivo. O caminho pode usar um caminho UNC com relação a um compartilhamento de arquivo, como \\servername\directory\file.pdi ou um URL absoluto, como Também é possível clicar no botão Conexões meio de uma conexão da Web part. para receber um caminho do arquivo por 46

53 Configurar as Web parts PI ActiveView Caminho de Contexto Atual A seção de ferramenta Caminho de contexto atual permite que você gerencie o contexto (página 29) das exibições do PI ProcessBook (.pdi ou.svg) nas web parts PI ActiveView e PI Graphic. Os caminhos de contexto funcionam como parâmetros que você pode usar para apresentar dinamicamente diferentes dados do PI na exibição do mesmo arquivo. Desde o PI WebParts 3.0, as ERDs substituem amplamente as MRDs (que suportam PI Aliases do PI Module Database) usadas em versões anteriores. A web part PI ActiveView carrega um.pdi do ProcessBook no controle do PI ActiveView em seu computador. Se o PI ActiveView 3.2 está instalado e o complemento da exibição relativa ao módulo (MRD) for removido, o PI ActiveView converte a MRD em uma ERD. Se o complemento da MRD permanecer instalado para o ActiveView, o.pdi não é convertido para uma ERD. O PI TreeView envia caminhos de contexto do AF e não contextos de módulos. As web parts do PI TreeView existentes usadas para fornecer caminhos de módulos não irão comandar exibições que dependem de contextos de módulos. Você pode continuar a usar outras web parts (como PI Table ou uma web part terceirizada) para enviar caminhos de módulo. O último caminho (ou módulo) de contexto selecionado quando o arquivo de exibição foi salvo no PI ProcessBook se torna o contexto padrão. Uma vez que o arquivo de exibição do PI ProcessBook for referenciado por uma web part, use o campo Sobrescrever Caminho de contexto padrão para definir um novo contexto padrão quando o arquivo for carregado na web part. Você também pode enviar caminhos de contexto para a web part a partir das web parts fornecedoras. Para sobrescrever um caminho de contexto padrão: No PI ActiveView, clique no botão Selecionar Contexto padrão para selecionar um novo caminho de contexto do banco de dados AF usando a caixa de diálogo Selecionar Contexto padrão. Também é possível usar o botão Conexões para direcionar o contexto do elemento para PI Graphic ou PI ActiveView por meio de outras Web parts na página. Por exemplo, para criar uma exibição que permita que você alterne entre atributos nos elementos da Unidade 1 e Unidade 2, e mostre dados correspondentes a cada um deles, é possível conectar uma web part PI TreeView a uma web part PI ActiveView. A web part de destino mostra uma exibição.pdi configurada para usar os mesmos atributos nomeados. Mapeie o parâmetro Caminho relativo a partir do PI TreeView para o Campo de contexto na web part PI ActiveView. Após a configuração, clique no módulo da Unidade 2 no PI TreeView quando quiser ver os dados da Unidade 2 em vez da Unidade 1 e vice-versa. Manual do Usuário do PI Web Parts

54 A Web part PI ActiveView Configurações do PI ActiveView A seção de ferramentas Configurações fornece uma maneira para fazer o download e a atualização automática do aplicativo PI ActiveView em computadores clientes usando o atributo do código-fonte HTML. Os clientes podem atualizar o apicativo PI ActiveView automaticamente quando novas versões forem inseridas no local do código-fonte e assegurar que o PI ActiveView esteja instalado para suportar o aplicativo PI ActiveView quando a Web part for usada. Para as versões 3.0 ou superior do PI ActiveView, digite o caminho completo para o kit de instalação (ActiveView_3.x.x.x_.exe) no campo ActiveViewcodebase. Para versões mais antigas, digite o caminho para o arquivo.cab do PI ActiveView (acviewinf.cab). O caminho pode ser um caminho UNC com relação a um compartilhamento de arquivo, como: \\servername\directory\acviewinf.cab ou um URL absoluto, como Conexões do PI ActiveView A Web part PI ActiveView suporta conexões do SharePoint (página 37) com relação a outros PI WebParts: Como uma consumidora Aceita as alterações do intervalo de horário da Web part PI TimeRange ou qualquer outra Web part que forneça timestamps Inicial e Final. Aceita nomes de arquivo.pdi de qualquer web part que possa fornecer um caminho de arquivo. Aceita que os valores iniciais sejam definidos pelos parâmetros da string de consulta. 48

55 Capítulo 7 A Web part PI BatchTable A Web part PI BatchTable apresenta uma forma de procurar por informações no PI Batch e trocar dados com outras Web parts. A pesquisa de Bateladas pode ser configurada para ser executada automaticamente ao carregar uma página ou com parâmetros fornecidos pela Web part PI BatchTable ou consumida de outras Web parts. Uma pesquisa de Bateladas bem-sucedida apresenta uma lista de bateladas que corresponde aos critérios de pesquisa. Se você selecionar uma batelada na tabela, poderá passar os dados da batelada às Web parts conectadas. Nota: A Web part PI BatchTable se baseia no provedor PI OLEDB para recuperar dados do PI Batch por meio dos PI Data Services. O PI OLEDB Provider deve ser usado somente com PI BatchTable e não está licenciado para nenhum outro fim. Manual do Usuário do PI Web Parts

56 A Web part PI BatchTable Pesquisas de bateladas Defina uma consulta de bateladas ao elaborar uma máscara de atributo dos critérios de pesquisa para descrever as bateladas que deseja visualizar. As bateladas que se adequarem aos critérios serão exibidos na tabela de bateladas assim que a pesquisa for executada. Para definir uma consulta de bateladas: 1. Selecione um Tipo de batelada para pesquisar o database PI Batch. Somente as bateladas do tipo especificado serão exibidas pela pesquisa. 2. Especifique o nome do PI Server que contém o PI Batch Database de destino. 3. Especifique o Status das bateladas a serem exibidas: ο ο ο Selecione Em execução para exibir somente as bateladas que estão sendo executadas no momento. Selecione Concluído para exibir somente as bateladas que têm um horário final. Selecione Ambos para exibir todas as bateladas correspondentes, em execução ou concluídas. 4. Digite os horários inicial e final para definir um intervalo de horário para a pesquisa. Você pode inserir horários PI relativos ou usar o botão de calendário para digitar horários fixos. 5. Especifique cada atributo de batelada que quiser definir para limiar a pesquisa na seção Máscaras do atributo. Somente as bateladas que corresponderem a todos os critérios de pesquisa (página 52) serão exibidos. Essa seção pode conter campos diferentes da máscara do atributo, dependendo do tipo de batelada. Você pode usar caracteres curingas nas máscaras, incluindo um asterisco (*) para múltiplos caracteres ou um ponto de interrogação (?) para um único caractere. Por exemplo, para localizar IDs de batelada que começam com a letra "C", digite: C*. 6. Clique em Pesquisar para pesquisar bateladas que correspondam às informações de batelada especificadas e às máscaras do atributo. Clique em Apagar para apagar todos os campos e redefinir as opções padrão. 50

57 Resultados da batelada Resultados da batelada As bateladas correspondentes aos critérios de pesquisa (página 52) serão apresentadas na forma de linhas da tabela de batelada. As colunas podem ser configuradas (página 30) para exibirem qualquer combinação disponível de parâmetros (página 52) para cada batelada. Você pode passar pelos resultados ou classificá-los por coluna: Clique na navegação Mover para a frente (>) ou Mover para trás (<) para se mover para frente ou para trás na lista de bateladas apresentadas. Clique nos botões Mover primeiro ( <) ou Mover por último (> ) para ir para o início ou para o fim da lista de bateladas apresentadas. Clique na coluna para classificar a lista de bateladas apresentadas por parâmetro. Se a conexão da Web part (página 54) for estabelecida, selecione uma linha individual da batelada para enviar parâmetros selecionados da batelada a uma Web part conectada. Configurar Web parts PI BatchTable Você pode configurar uma Web part PI BatchTable usando o painel de ferramentas de Web parts e as seções de ferramentas de configuração padrão, incluindo Intervalo de horário (página 20), Colunas da tabela (página 30), Valores do filtro (página 33), Aparência, Layout e Avançado. A web part PI BatchTable também inclui duas peças de ferramenta que lhe permitem exibir preferências e configurar pesquisas automáticas de lote. Opções de pesquisa Como padrão, todos os recursos da Web part PI BatchTable são exibidos, permitindo que o visualizador da página da Web part pesquise qualquer tipo de batelada e especifique quaisquer critérios de pesquisa. As opções de pesquisa fornecem maneiras para configurar ou reduzir as opções disponíveis: Selecione Habilitar pesquisa pré-configurada para definir os atributos de pesquisa padrão conforme configurados no painel de ferramentas. A pesquisa padrão será executada automaticamente quando a página que contém a Web part for carregada. Selecione Desabilitar interface de pesquisa para ocultar as propriedades de especificação da batelada e pesquisar atributos na exibição da Web part, mostrando somente os resultados da tabela de batelada de uma pesquisa. Quando essa opção for selecionada, os critérios de pesquisa deverão estar pré-configurados ou serem fornecidos externamente, por meio de uma conexão da Web part ou de parâmetros da string de consulta. Manual do Usuário do PI Web Parts

58 A Web part PI BatchTable Critérios de pesquisa A seção de ferramentas Critérios de pesquisa pode ser usada para especificar uma máscara padrão do atributo referente às pesquisas do PI BatchTable. Quaisquer valores fornecidos na seção de ferramentas são exibidos nos campos da Web part como valores de pesquisa padrão. Se uma pesquisa pré-configurada (página 51) for especificada, uma pesquisa de bateladas será executada automaticamente usando esses critérios quando a Web part PI BatchTable for carregada pela primeira vez na página. Os critérios de pesquisa padrão podem ser especificados para quaisquer especificações de batelada ou valores da máscara do atributo. Você pode usar caracteres curingas nas máscaras, incluindo um asterisco (*) para múltiplos caracteres ou um ponto de interrogação (?) para um único caractere. Por exemplo, para localizar IDs de batelada que começam com a letra "C", digite: C*. Parâmetros referentes a todos os valores, exceto Tipo de batelada também podem ser recebidos por meio de conexões da Web part. Os parâmetros de batelada (página 52) a seguir estão disponíveis como critérios de pesquisa, dependendo do tipo de batelada selecionada: Tipo de batelada Nome do servidor Status Horário inicial Horário final ID da batelada Produto Fórmula Procedimento Nome da unidade Título da unidade Além dos critérios inseridos diretamente na web part PI BatchTable, os parâmetros podem ser pré-configurados, ou recebidos através de parâmetros de string de consulta (página 39) ou conexões de web parts. Se os parâmetros são recebidos de diversas fontes, a ordem de execução é pré-configurada, string de consulta, conexões de web parts e inserção direta. Parâmetros de batelada O PI BatchTable usa as informações de batelada do PI para pesquisar bateladas em um servidor selecionado. Informações de batelada mais detalhadas são exibidas nas linhas das tabelas dos resultados, onde as linhas selecionadas podem enviar parâmetros de batelada para as Web parts conectadas. Nota: Todos os parâmetros, incluindo timestamps no formato UTC, são inseridos e enviados como strings. 52

59 Configurar Web parts PI BatchTable Os parâmetros de batelada a seguir são usados para pesquisas e são exibidos nos resultados de batelada: Parâmetro Tipo de batelada Servidor Status StartTime EndTime Produto Fórmula Procedimento Nome da unidade Título da unidade Definição O tipo de batelada: PIBatch, a opção padrão, uma entidade PIBatch. PIUnitBatch, uma entidade PIUnitBatch normalmente associada a uma parte do equipamento. Um PIUnitBatch está, por definição, associado a um PIModule que foi designado para representar a unidade (onde a propriedade IsPIUnit = True). PISubBatch, uma entidade que é um filho de um PIUnitBatch ou de outro PISubBatch em uma hierarquia sob um PIUnitBatch. Por exemplo, você pode ter tipos distintos de sub-batches abaixo de um PIUnitBatch (chamado Operações) que se chamam Fases. Observe que o PIUnitBatch substitui a entidade Batelada no PI Batch Subsystem. Se uma determinada Unidade tiver sido migrada para o Subsistema de batelada, suas bateladas filhas serão interpretadas como PIUnitBatches. O nome do PI Server que contém o PI Batch Database de destino. Observe que os dados de batelada são armazenados somente no servidor Primário de uma reunião de PI servers. Se o servidor Primário não estiver disponível, você não poderá recuperar os resultados de batelada. Execute a pesquisa mais uma vez, assim que o servidor Primário tiver sido reexibido on-line. O status atual de uma batelada, seja Em execução ou Concluída. As bateladas concluídas têm um valor Horário final; as bateladas em execução não têm. O horário no qual uma execução de batelada foi iniciada, em formato UTC. O horário no qual uma execução de batelada foi concluída, em formato UTC. Nenhum valor indica uma batelada que ainda esteja em execução. O nome de um produto associado a uma batelada. A Fórmula associada a uma batelada. O procedimento associado a um PIUnitBatch ou um PISubBatch. O nome da unidade à qual uma batelada está associada. O título da unidade do PI Module Database à qual um PIUnitBatch ou um PISubBatch pertence. Os seguintes parâmetros de batelada são exibidos somente nos resultados de pesquisa de bateladas: Parâmetro ID da batelada Duração Caminho de unidade ID exclusivo Definição Um ID da batelada atribuída ao usuário. O período total transcorrido durante a execução mais recente da batelada. Se a execução da batelada for concomitante a uma pesquisa, a duração será o período transcorrido do início da execução da pesquisa. O caminho completo do Elemento AF mapeado para o módulo no PI Module Database ao qual uma batelada pertence. Um caminho de unidade se aplica somente aos tipos PIUnitBatch ou PISubBatch. O ID exclusivo (GUID) de uma batelada conforme armazenada no PI Batch Database. Manual do Usuário do PI Web Parts

60 A Web part PI BatchTable Conexões PI BatchTable A Web part PI BatchTable suporta conexões do SharePoint (página 37) com relação a outros PI WebParts: Como uma consumidora Aceita as alterações do intervalo de horário da Web part PI TimeRange ou qualquer outra Web part que forneça timestamps Inicial e Final. Aceita parâmetros Servidor, Status e Máscara de atributo de quaisquer Web parts que possam fornecê-los, como PI TreeView e PI Table. Nota: Os parâmetros do Tipo de batelada não podem ser aceitos por meio de conexões de Web parts. Aceita que os valores iniciais sejam definidos pelos parâmetros da string de consulta. Como uma fornecedora Os valores das colunas para as linhas apresentadas como resultado de uma pesquisa de PI BatchTable podem ser enviados às Web parts de consumo usando as conexões do lado do cliente ou do servidor. Quando a linha é selecionada, os valores da coluna são enviados como parâmetros (página 52) às Web parts conectadas. Nota: Os valores nulos são fornecidos para parâmetros que não sejam aplicáveis ao tipo de batelada selecionado. Por exemplo: um valor nulo será enviado para o parâmetro UnitName quando a linha PIBatch for enviada. Você também pode enviar um valor de linha a partir de uma coluna de dados selecionada para qualquer Web part que possa consumi-la como um valor de filtro. Um uso típico é uma conexão para a Web part Excel Web Access (EWA) (página 41), onde o parâmetro do valor da coluna pode ser usado para resolver uma função do PI DataLink em uma célula da planilha. Quando a linha da batelada for selecionada para iniciar uma conexão da Web part, ela exibirá um ícone ativo de Conexão para indicar os dados enviados a uma Web part conectada. 54

61 Capítulo 8 A Web part PI Gauge A Web part PI Gauge fornece uma exibição gráfica de um PI ou outro valor atual de ponto de dados e permite que você monitore e determine, num relance, se esse valor está dentro de uma faixa aceitável. O aferidor em estilo analógico tem um ponteiro (semelhante a um relógio de pulso) que mostra o valor em tempo real com relação à escala em torno do perímetro. Um aferidor separado é exibido na Web part para cada item de dados configurado no painel de ferramentas do PI Gauge. Manual do Usuário do PI Web Parts

62 A Web part PI Gauge Nota: Essa Web part é gerada no formato Scalable Vector Graphic (SVG) e exige o Adobe SVG Viewer. Configurar as Web parts PI Gauge Você pode configurar uma Web part PI Gauge usando o painel de ferramentas de Web parts e as seções de ferramentas de configuração padrão, incluindo Intervalo de horário (página 20), Dados selecionados (página 21), Aparência, Layout e Avançado. O PI Gauge também inclui seções de ferramentas extras que permitem que você altere as medições e a aparência de cada aferidor. Propriedades de PI Gauge Nas Web parts PI Gauge, cada item na tabela Dados selecionados (página 21) é mapeado para um aferidor individual. Use a configuração Múltiplas orientações de aferição para especificar se os aferidores na Web part são exibidos em uma disposição horizontal ou vertical. O valor padrão é Horizontal. Propriedades do formato As propriedades do formato determinam a escala e a aparência de uma Web part PI Gauge. Nota: Essas configurações são aplicadas somente ao item de dados selecionado no momento. Selecione cada item na lista Dados selecionado e aplique as configurações individualmente para personalizar toda a exibição da Web part. A seção de ferramentas Formato inclui estas propriedades: Fator de escala O fator de escala pode ser usado para modificar os valores das tags de dados e a escala de aferição correspondente. Os valores das tags de dados são divididos pelo valor inserido nesse campo para determinar o local do ponteiro do aferidor e os valores de medição ao longo da parte externa do aferidor. O fator de escala será exibido na parte inferior do aferidor no final da legenda, se estiver ajustado para um valor diferente do valor padrão, que é 1. Esse campo aceita valores de tags flutuantes. Ângulo base Digite um inteiro para descrever o ângulo complementar à curva de leitura do aferidor, representado pelo espaço aberto na parte inferior da exibição. A curva de leitura do PI Gauge mais a curva do Ângulo base é igual a 360º. O valor padrão do ângulo base é 60 (graus), e pode ser qualquer valor entre 0 e

63 Configurar as Web parts PI Gauge Formato de número Um formato de número (página 110) é aplicado aos valores da legenda e da dica de ferramentas no PI Gauge. Selecione cada item na lista Dados selecionados e aplique as configurações individualmente. Quando o formato do Database for selecionado para dados de tag PI, o número das casas decimais usadas para os números dos tags flutuantes será determinado pelo atributo DisplayDigits (página 111). Esse formato está desabilitado para dados que não são do PI, que usam o formato de número Geral como padrão. Cor dos dados incorreta Uma cor aplicada à tag central do aferidor para indicar uma condição de erro, como um valor das tags dos dados questionável, inexistente ou corrompido. O valor padrão é Vermelho. Piscar A tag central do aferidor pode ser configurada para piscar para indicar uma condição de erro. Como padrão, a caixa de seleção permanece desmarcada. Cor do texto A cor usada para o texto na Web part. O valor padrão é Azul-escuro. Cor de face A cor aplicada ao anel externo do aferidor que contém valores de escala. O valor padrão é Cinza-claro. Cor do segundo plano A cor aplicada ao segundo plano do aferidor dentro do anel de escala e que é excluída das zonas pelo Ângulo base. O valor padrão é Cinza-claro. Propriedades da legenda As propriedades da legenda determinam o formato da legenda e das dicas de ferramenta do aferidor. Nota: Essas configurações são aplicadas somente ao item de dados selecionado no momento. Selecione cada item na lista Dados selecionado e aplique as configurações individualmente para personalizar toda a exibição da Web part. A seção de ferramentas Legenda inclui estas propriedades: Nome do dataset O nome da coluna do dataset, tag ou atributo conforme exibido na seção de ferramentas Dados selecionados. Manual do Usuário do PI Web Parts

64 A Web part PI Gauge Descrição Uma descrição da coluna do dataset, tag ou atributo selecionado, se disponível. Unidades O atributo engunits (unidades de engenharia) do tag PI representado no aferidor. Engunits indica as unidades de engenharia de medição referente aos dados do tag. Esse campo não é aplicável aos dados que não são do PI. Valor O valor numérico atual representado no aferidor. Timestamp O timestamp associado ao valor atual representado no aferidor. Título Assinale a caixa de seleção e insira um título para ser exibido diretamente acima do aferidor. Propriedades de zona e escala As propriedades de zona e escala determinam a escala e a aparência gerais de uma Web part PI Gauge. Nota: Essas configurações são aplicadas somente ao item de dados selecionado no momento. Selecione cada item na lista Dados selecionado e aplique as configurações individualmente para personalizar toda a exibição da Web part. A seção de ferramentas Zona e escala inclui estas propriedades: Escala máxima e mínima As propriedades Escala mínima e Escala máxima determinam o intervalo de uma escala de valores para cada item dos Dados selecionados: Para valores de PI point inteiros ou de ponto flutuante, o Banco de dados usa o atributo Zero como o valor mínimo da escala e Zero mais o atributo Span como o valor máximo da escala. Para tags do estado digital, o mínimo é sempre 0 e o máximo é sempre um inferior ao número total dos estados. Essa opção está desabilitada para as colunas dos datasets e outros dados que não sejam do PI. Selecione Personalizar para inserir valores máximo e mínimo nas caixas de texto suplementares. Clique no botão Conexões para mapear os parâmetros das conexões da Web part para os valores escala máxima e mínima. 58

65 Conexões do PI Gauge Número de zonas As opções restantes de Zona e escala são usadas para formatar zonas do indicador que são exibidas na parte dianteira do aferidor. Digite um valor no campo Número das zonas para especificar o número das zonas a serem usadas. A caixa da lista das zonas é atualizada para refletir o número correto. Você pode selecionar zonas a partir da lista para definir as seguintes informações para cada uma delas: Digite um texto de Identificação que é exibido na zona na parte dianteira do aferidor. Selecione uma Cor para a zona. Selecione uma Configuração da zona de porcentagem para determinar o tamanho de cada zona como uma porcentagem da escala total, conforme especificado pela Porcentagem da escala total. Desmarque a caixa de seleção para especificar os tamanhos de zona, usando um Valor alto (o Valor baixo é calculado automaticamente). Conexões do PI Gauge A Web part PI Gauge suporta conexões do SharePoint (página 37) com relação a outros PI WebParts: Como uma consumidora Aceita as alterações do intervalo de horário da Web part PI TimeRange ou qualquer outra Web part que forneça timestamps Inicial e Final. Aceita nomes do tag PI a partir de qualquer outra Web part e os adiciona aos Dados selecionados como aferidores adicionais. Aceita o valor escala máxima e mínima referente a um aferidor. Aceita que os valores iniciais sejam definidos pelos parâmetros da string de consulta. Manual do Usuário do PI Web Parts

66

67 Capítulo 9 A Web part PI Graphic A Web part PI Graphic mostra as exibições do PI ProcessBook salvos no formato Scalable Vector Graphic (SVG). As telas do ProcessBook permitem que você monitore uma área selecionada de uma seção praticamente em tempo real, usando diagramas, elementos gráficos dinâmicos, símbolos de múltiplos estados e gráficos de atualização contínua e valores das tags de dados. O PI Graphic suporta telas criadas no PI ProcessBook 2.35 ou mais recente, com o Add-in SVG versão 2.25 ou mais recente. Nota: Essa Web part é gerada no formato Scalable Vector Graphic (SVG) e exige o Adobe SVG Viewer. Manual do Usuário do PI Web Parts

68 A Web part PI Graphic Suporte da Tela do ProcessBook Os gráficos de tela do PI ProcessBook são exibições do PI ProcessBook salvas no formato Scalable Vector Graphic (SVG). As exibições em SVG preservam a maioria da funcionalidade das telas ProcessBook nativas, mas os usuários têm mais facilidade de implementá-las. O formato SVG suporta elementos de conteúdo estático e dinâmico usados no PI ProcessBook. Lembre-se do seguinte ao criar e salvar as exibições no formato SVG referente ao PI Graphic: O conteúdo estático pode incluir imagens rasterizadas, fotografias, desenhos em linha ou texto, desde que o formato dessas imagens possa ser exibido na Web. Por exemplo, as exibições que contêm imagens.jpg,.png ou.gif podem ser exibidas em uma Web part PI Graphic, mas os símbolos integrados no formato.bmp não. Os elementos dinâmicos incluem valores, barras, tendências, gráficos XY e símbolos de múltiplos estados que podem ser atualizados quando os dados em um PI Server ou outra fonte de dados for alterada. Os elementos dinâmicos variam na aparência, dependendo do tipo de dados exibidos da sua configuração. Os tags blob não são suportados com relação a símbolos dinâmicos. Os controles ActiveX usados para construir exibições do ProcessBook são omitidos quando a exibição é salva no formato SVG. Nenhum script em VBA escrito para suportar uma exibição do ProcessBook pode ser incluído quando a exibição estiver salva no formato SVG. Para obter informações sobre os elementos do ProcessBook, consulte o Guia do usuário do PI ProcessBook. Ícones do atributo de valor Os ícones de atributo de valor representam dados substituídos, anotados ou questionáveis. Por exemplo, nas tendências, os ícones são exibidos no eixo oposto à escala de tempo, no momento em que o atributo de valor for indicado. Os ícones do atributo de valor referentes ao último valor no gráfico são exibidos ao lado da legenda. Substituído indica que o valor foi alterado a partir do seu valor original. Esse valor será definido somente pelo PI Archive Subsystem quando um valor existente for alterado. Anotado indica que há um comentário sobre um valor. Questionável indica que há algum motivo para duvidar da precisão do valor. Quando mais de um atributo de valor for aplicado, o atributo de prioridade mais alta será gerado. As prioridades do atributo da mais alta para a mais baixa são: Erro, Questionável, Anotado e Substituído. Clique no ícone para exibir os dados do atributo de valor em uma caixa de diálogo. 62

69 Suporte da Tela do ProcessBook Nota: Embora a exibição dos ícones do atributo de valor possa ser desabilitada no PI ProcessBook como uma configuração que abrange todo o aplicativo, os ícones do atributo de valor mostrados na tela do ProcessBook original são exibidos automaticamente e não podem ser ativados e desativados nas Web parts PI Graphic. É possível que os ícones do atributo de valor não estejam presentes nos PI servers secundários em uma reunião. Símbolos de valor Um símbolo de valor (normalmente numérico) exibe um valor imediato referente a uma tag de dados determinada. Um valor pode incluir um nome de tag ou um timestamp. Para tags do estado digital, uma identificação do estado (em vez do número do índice) é exibida. Como padrão, o valor mais recente é recuperado da tabela de snapshots. Se o horário final do intervalo de horário for alterado para um valor diferente de *, o horário final será usado para recuperar um valor. Dados de inteiros e de tags flutuantes são exibidos usando os formatos de números padrão (página 110), com caracteres decimais e de separador do grupo especificado pelo código do idioma do SharePoint (página 7). Os dados que não são do PI serão mostrados conforme forem exibidos a partir da fonte de dados com formatos especificados pela Web part. Símbolos de tendências Os símbolos de tendência nas Web parts PI Graphic usam a mesma lógica da Web part PI Trend, com a exceção de que os recursos de interatividade, como zoom, cursores e dicas de ferramentas, não são suportados no PI Graphic. Símbolos XYPlot A Web part PI Graphic exibe quaisquer símbolos do Gráfico XY encontrados no arquivo.svg selecionado conforme eles foram configurados no PI ProcessBook. Os recursos de interatividade, como zoom, cursores e dicas de ferramentas, não são suportados no PI Graphic. Exibições vinculadas Se um arquivo de tela (.svg) do PI ProcessBook salvo tiver um botão ProcessBook com uma tela vinculada, você poderá usá-lo para iniciar o arquivo.svg diretamente no PI Graphic. A menos que um URL completo seja especificado, o PI Graphic considerará que um arquivo vinculado está localizado no mesmo caminho da exibição atual. Se o botão fizer referência a um arquivo.pdi, a Web part considerará que uma versão.svg é o destino pretendido e pesquisará a extensão.svg. Posicionar o mouse sobre a área do botão transforma o ponteiro do mouse em uma mão para indicar que um hiperlink está ativo. Os arquivos de imagem podem ser vinculados ou integrados. Os arquivos vinculados devem ser mencionados com caminhos relativos acessíveis para o servidor do SharePoint. Os arquivos integrados devem estar localizados na mesma pasta do arquivo.svg salvo. Para assegurar que os elementos de exibição sejam preservados no PI Graphic, mantenha os arquivos de imagem vinculados ou integrados na mesma pasta do arquivo.svg. Outros tipos do botão ProcessBook não são suportados, incluindo os links para outros tipos de arquivos (.piw e.pdi), macros (scripts VBA) ou comandos do sistema operacional. Manual do Usuário do PI Web Parts

70 A Web part PI Graphic Suporte do dataset O PI Graphic suporta gráficos de tela do PI ProcessBook elaborados com dados PI, datasets de cálculo do PI ou datasets ODBC. Qualquer fonte de dados usada na exibição deve ser acessível para o servidor do SharePoint para atualizar o conteúdo no PI Graphic. Para os datasets ODBC, deve haver uma Fonte de dados relacional correspondente com um System Data Source Name (DSN) idêntico no PI Data Services. Por exemplo, um usuário do PI ProcessBook se conecta a uma fonte de dados ODBC no computador por meio de um System DSN chamado MySQLData. O usuário elabora uma tela do ProcessBook com os dados ODBC e salva-a no formato.svg. Antes de usar o formato.svg no PI Graphic, o usuário deverá criar ou verificar a existência de uma Fonte de dados relacional correspondente chamada MySQLData referente ao servidor do PI WebParts por meio do PI Data Services. Crie um gráfico de tela do ProcessBook (.svg) As telas do ProcessBook podem ser salvas no formato.svg usando o comando do menu Arquivo > Salvar como no PI ProcessBook. Nota: As exibições no formato SVG são preservadas à medida que forem exibidas ao serem salvas no ProcessBook. Para obter informações sobre o redimensionamento de uma exibição, consulte o Guia do usuário do PI ProcessBook. Para salvar uma tela do PI ProcessBook em um documento SVG: 1. Abra uma exibição do PI ProcessBook no PI ProcessBook. 2. Faça quaisquer alterações na tela que deseja visualizar no PI Graphic. 3. Selecione o caminho do módulo ou contexto relativo a elemento padrão desejado. Exibições relativas a módulos são convertidas automaticamente para exibições relativas a elementos quando carregadas em web parts PI Graphic. O último caminho selecionado quando o documento foi salvo no formato.svg no PI ProcessBook se torna o contexto padrão usado quando a exibição é carregada na web part PI Graphic. 4. Verifique se há uma Fonte de dados correspondente ao DSN (página 64) no PI Data Services para suportar quaisquer datasets relacionais usados na exibição se os tags relacionados aos PI servers mencionados na exibição podem ser acessados a partir do servidor da Web. 5. Vá para o menu Arquivo e selecione Salvar como. 6. Selecione o tipo de arquivo Scalable Vector Graphics (SVG). 64

71 Configurar as Web parts PI Graphic 7. Vá para o local do diretório da rede (página 16) desejado. 8. Atribua um nome para o arquivo de forma adequada e clique em Salvar. 9. Se a exibição contiver gráficos vinculados ou integrados, certifique-se de localizar os arquivos de imagem corretps e copiá-los para o mesmo local do diretório da rede onde o SVG foi salvo: ο Em um gráfico vinculado, copie o arquivo de imagem vinculado real. ο Em um gráfico integrado, copie os gráficos salvos com o SVG. O ProcessBook cria uma nova imagem no mesmo diretório como o SVG salvo, usando uma variação do nome do arquivo SVG para cada gráfico integrado. 10. Feche o PI ProcessBook. Configurar as Web parts PI Graphic Você pode configurar uma Web part PI Graphic usando o painel de ferramentas da Web part e as seções de ferramentas padrão Intervalo de horário (página 20), Aparência, Layout e Avançado. O PI Graphic também inclui duas seções de ferramentas adicionais que permitem que você selecione os gráficos da tela do ProcessBook no formato SVG e um caminho de contexto referente à tela. Configuração do PI Graphic A seção de ferramentas Configuração do PI Graphic é usada para especificar o conteúdo de exibição referente à Web part. Use o campo Arquivo selecionado para indicar o arquivo.svg que deseja exibir em PI Graphic. Use o campo Arquivo de transformação XSL para fornecer um arquivo de transformação XSL (.xslt) opcional para alterar ou otimizar a aparência do gráfico SVG sem alterar seu conteúdo de forma permanente. A lógica de transformação pode incluir uma substituição baseada em modelos para alterar tags ou nomes do servidor, ajustar a representação visual de uma exibição ou anexar a lógica de JavaScript a elementos específicos, por exemplo. Em cada opção, você pode digitar um caminho completo para um arquivo ou inserir um caminho parcial e clicar na seta para baixo para Navegar ou Pesquisar um arquivo. Os caminhos podem usar um caminho UNC referente ao compartilhamento de um arquivo localizado no servidor da Web, como \\servername\directory\file.svg ou um URL absoluto ou relativo, por exemplo: Também é possível clicar no botão Conexões meio de uma conexão da Web part. para receber um caminho do arquivo por Manual do Usuário do PI Web Parts

72 A Web part PI Graphic Caminho de Contexto Atual A seção de ferramenta Caminho de contexto atual permite que você gerencie o contexto (página 29) das exibições do PI ProcessBook (.pdi ou.svg) nas web parts PI ActiveView e PI Graphic. Os caminhos de contexto funcionam como parâmetros que você pode usar para apresentar dinamicamente diferentes dados do PI na exibição do mesmo arquivo. A web part PI Graphic converte automaticamente exibições relativas a módulos em exibições relativas a elementos que podem ser alteradas de forma dinâmica usando caminhos de contexto AF, desde que seus dados de ativos tenham sido migrados para um servidor AF a partir do PI Module Database. O PI ProcessBook exibe um caminho de atributo relativo a elemento com o prefixo e.. O PI Graphic usa um prefixo. em vez de usar e.. Por exemplo, a especificação e. attribute é exibida como. attribute no PI Graphic. Se o atributo for definido usando a opção Caminho completo, o caminho é exibido com um prefixo.\. Por exemplo e..\element attribute no ProcessBook seria exibido como.\element attribute em uma web part do PI Graphic. O último caminho (ou módulo) de contexto selecionado quando o arquivo de exibição foi salvo no PI ProcessBook se torna o contexto padrão. Uma vez que o arquivo de exibição do PI ProcessBook for referenciado por uma web part, use o campo Sobrescrever Caminho de contexto padrão para definir um novo contexto padrão quando o arquivo for carregado na web part. Você também pode enviar caminhos de contexto para a web part a partir das web parts fornecedoras. Para sobrescrever um caminho de contexto padrão, use o botão Conexões para conduzir o contexto do módulo do PI Graphic através de outras web parts na página. Por exemplo, para criar uma exibição que permita que você alterne entre atributos nos elementos da Unidade 1 e Unidade 2, e mostre dados correspondentes a cada um deles, é possível conectar uma web part PI TreeView a uma web part PI Graphic. A web part de destino mostra uma exibição.svg (PI Graphic) configurada para usar os mesmos atributos nomeados. Mapeie o parâmetro Caminho relativo a partir do PI TreeView para o Campo de contexto na web part PI Graphic. Após a configuração, clique no módulo da Unidade 2 no PI TreeView quando quiser ver os dados da Unidade 2 em vez da Unidade 1 e vice-versa. 66

73 Exibições do SVG ad hoc Exibições do SVG ad hoc Quando um gráfico de tela do PI ProcessBook for exibido em uma Web part PI Graphic, você poderá abrir exibições adicionais do gráfico conforme necessário: No canto superior direito da Web part PI Graphic, clique na seta para baixo e, em seguida, clique em SVG ad hoc. A exibição do SVG é aberta em uma nova janela do navegador. Também é possível clicar com o botão direito do mouse na Web part PI Graphic e selecionar SVG ad hoc para exibir o gráfico em uma nova janela de exibição do SVG redimensionável. Se um item de dados for mostrado na exibição do SVG puder ser formado como uma tendência, você poderá clicar com o botão direito do mouse e selecionar Tendência ad hoc para exibir uma Tendência (página 12) correspondente. O intervalo de horário da Web part pai é usado para determiná-lo com relação à exibição do SVG quando for aberto pela primeira vez. As exibições do SVG são abertas em uma nova janela com controles que permitem que você avance e retroceda o horário, inicie uma tendência, aplique um zoom ou altere o intervalo de horário. Controles de exibição do SVG As exibições do PI Graphic e as exibições do SVG (página 66) suportam recursos Girar e Zoom fornecidos pelo Adobe SVG Viewer: Para girar, pressione a tecla ALT e, em seguida, clique e arraste a imagem. Para ampliar, pressione a tecla CTRL e clique na imagem para aplicar zoom ou clique com o botão direito do mouse e selecione Zoom. Para reduzir, pressione SHIFT e CTRL e, em seguida, clique na imagem ou clique com o botão direito do mouse para mostrar o menu do contexto e selecionar Reduzir ou Exibição original. Manual do Usuário do PI Web Parts

74 A Web part PI Graphic Controles de horário Use as ferramentas a seguir para definir ou ajustar o intervalo de horário: Digite um valor no campo Iniciar para especificar o início do intervalo de horário. O horário pode ser expresso no formato de horário PI ou no formato padrão Data e hora abreviadas do Windows configurado para SharePoint. Digite um valor no campo Final para especificar o final do intervalo de horário. O horário pode ser expresso no formato de horário PI ou no formato padrão Data e hora abreviadas do Windows configurado para SharePoint. Clique em Aplicar para aplicar valores de horário atualizados. Clique no botão Reverter para restaurar os valores padrão do horário inicial e final. Clique nos botões Retroceder/Avançar para ajustar os horários Inicial e Final para trás ou para frente de acordo com a quantidade da duração do intervalo atual. Se os valores Inicial e Final forem períodos relativos no formato PI, retroceder ou avançar converterá os valores para períodos absolutos. 68

75 Conexões do PI Graphic Conexões do PI Graphic A Web part PI Graphic suporta conexões do SharePoint (página 37) com relação a outros PI WebParts: Como uma consumidora Aceita as alterações do intervalo de horário da Web part PI TimeRange ou qualquer outra Web part que forneça timestamps Inicial e Final. Aceita caminhos de contexto relativos a elementos das Web parts PI Table e PI TreeView, por exemplo, para atualizar o conteúdo dinâmico associado a atributos PI. Aceita que os valores iniciais sejam definidos pelos parâmetros da string de consulta. Como uma fornecedora Fornece nomes de símbolos e fontes de dados (delimitadas por pontos e vírgulas) para outras Web parts. Manual do Usuário do PI Web Parts

76

77 Capítulo 10 A Web part PI Table A Web part PI Table exibe os dados das linhas e colunas no formato de tabela. O PI Table também suporta configurações de formatação que podem ser aplicadas para especificar a aparência e os atributos dos dados de célula da tabela. O PI Table é útil principalmente para exibir dados relacionais do ODBC, OLE DB e outras fontes e a partir dos datasets de cálculo do PI e dos serviços da Web. Nota: As fontes de dados e datasets do PI WebParts são configurados no PI Data Services por um administrador. Para obter mais informações, consulte o Guia do Administrador do PI Data Services. Configurar as Web parts PI Table Você pode configurar uma Web part PI Table usando o painel de ferramentas de Web parts e as seções de ferramentas de configuração padrão, incluindo Intervalo de horário (página 20), Colunas da tabela (página 30), Valores do filtro (página 33), Aparência, Layout e Avançado. A seção de ferramentas Dados selecionados (página 21) modificada fornece acesso somente aos datasets configurados relacionais, do serviço da Web e de cálculo do PI. Conexões do PI Table A Web part PI Table suporta conexões do SharePoint (página 37) com relação a outros PI WebParts: Como uma consumidora Aceita as alterações do intervalo de horário da Web part PI TimeRange ou qualquer outra Web part que forneça timestamps Inicial e Final. Aceita parâmetros de consulta SQL e valores de placeholder de quaisquer Web parts que possam fornecê-los, como PI TreeView e PI Table. Manual do Usuário do PI Web Parts

78 A Web part PI Table Aceita que os valores iniciais sejam definidos pelos parâmetros da string de consulta. Como uma fornecedora Os valores da coluna poderão ser enviados para as Web parts consumidoras como parâmetros quando uma linha for selecionada. Os exemplos incluem colunas dos nomes de tags, caminhos de contexto, carimbo de data e hora, valores numéricos usados para resolver placeholders numéricos ou nomes da Unidade PI utilizados para resolver placeholders de Texto. Os valores da coluna PI Table também podem ser formatados como hiperlinks usando os formatos de configuração da tabela. Esses hiperlinks podem ser configurados para ir para uma página diferente, abrir uma nova página ou iniciar uma conexão em linha. Você também pode enviar um valor de coluna a partir de uma linha selecionada para qualquer Web part que possa consumi-la como um valor de filtro. Um uso típico é uma conexão para a Web part Excel Web Access (EWA) (página 41), onde o parâmetro do valor da coluna pode ser usado para resolver uma função do PI DataLink em uma célula da planilha. As linhas do PI Table podem ser configuradas para fornecer o seguinte: Nomes de tag PI para as Web parts PI Trend, PI XYPlot e PI Gauge. Parâmetros de consulta SQL para as Web parts PI Trend, PI XYPlot e PI Gauge. URLs de arquivos para as Web parts PI Graphic e PI ActiveView. Dataset de informações de contato para as Web parts PI Messenger. Quando um valor da coluna for selecionado para iniciar uma conexão da Web part, uma linha exibirá um ícone ativo de Conexão conectada para indicar os dados enviados a uma Web part 72

79 Capítulo 11 A Web part PI TimeRange A Web part PI TimeRange permite que você determine intervalos de horário para todas as Web parts em uma página e retroceda ou avance no intervalo de horário por intervalo. Os recursos do PI TimeRange são idênticos às ferramentas de intervalo de horário disponíveis para a maioria das Web parts por meio do painel de ferramentas. Entretanto, o PI TimeRange permite que você insira intervalos de horário diretamente em na página de uma Web part em modo de execução, sem modificar os painéis de ferramentas individuais da Web part. Uma conexão implícita (página 74) é criada entre a web part PI TimeRange e todas as outras web parts OSI nesta página que pode consumir intervalos de tempo, quando a web part PI TimeRange for adicionada a uma página. Essa conexão permite que você determine ou altere intervalos de horário para as outras PI WebParts simultaneamente. Você pode sobrescrever esse comportamento ao mapear conexões explícitas de intervalo de horário entre as Web parts, para permitir configurações de horário individuais. Definir um intervalo de horário Use as ferramentas a seguir para definir ou ajustar o intervalo de horário: Digite um valor no campo Iniciar para especificar o início do intervalo de horário. O horário pode ser expresso no formato de horário PI ou no formato padrão Data e hora abreviadas do Windows configurado para SharePoint. Digite um valor no campo Final para especificar o final do intervalo de horário. O horário pode ser expresso no formato de horário PI ou no formato padrão Data e hora abreviadas do Windows configurado para SharePoint. Clique em Aplicar para aplicar valores de horário atualizados. Clique no botão Reverter para restaurar os valores padrão do horário inicial e final. Manual do Usuário do PI Web Parts

80 A Web part PI TimeRange Clique nos botões Retroceder/Avançar para ajustar os horários Inicial e Final para trás ou para frente de acordo com a quantidade da duração do intervalo atual. Se os valores Inicial e Final forem períodos relativos no formato PI, retroceder ou avançar converterá os valores para períodos absolutos. Clique no botão Calendário para exibir um seletor de calendário. Digite um horário e clique em uma data para determinar um horário Inicial ou Final. Percorra os meses usando os botões de seta localizados na parte superior. Conexões de intervalo de horário implícitas Uma Web part PI TimeRange pode fornecer Horários Inicial e Final para todos os outros PI WebParts em uma página que é projetada para consumir intervalos de tempo, sem estar conectada a eles de modo explícito. Essa conexão implícita permite que as Web parts em uma página exibam dados no mesmo intervalo de horário por meio de uma tag de controle única e sem configuração. Em ordem de precedência, uma Web part pode coletar parâmetros de intervalo de horário a partir de três fontes: Uma conexão explícita do SharePoint para outra Web part, onde o botão Conexões é exibido em verde na seção de ferramentas Intervalo de horário. Uma conexão implícita a uma instância de PI TimeRange. Valores do horário Inicial e Final especificados diretamente no Intervalo de horário de uma seção de ferramenta. As conexões implícitas serão criadas quando uma Web part PI TimeRange for adicionada a uma página. Todas as Web parts aplicáveis coletam automaticamente Horários Inicial e Final do PI TimeRange independentemente da sua configuração, a menos que estejam configurados especificamente para receber um intervalo de horário de outra Web part fornecedora. Se quiser usar intervalos de horário diferentes para as Web parts em uma página, você pode adicionar Web parts PI TimeRange extras e criar conexões explícitas para cada uma delas. Quaisquer Web parts restantes mantêm uma conexão implícita com relação à primeira instância do PI TimeRange adicionado à página e reagem automaticamente às alterações de horário feitas naquela Web part fornecedora. Configurar as Web parts PI TimeRange Você pode configurar uma Web part PI TimeRange usando o painel de ferramentas da Web part e as seções de ferramentas padrão, incluindo Intervalo de horário (página 20), Valores do filtro (página 33), Aparência, Layout e Avançado, e uma seção de ferramentas adicional Propriedades de exibição usada para alterar a orientação da Web part. A seção de ferramentas Intervalo de horário determina o intervalo de horário padrão referente à Web part PI TimeRange. As Web parts PI TimeRange podem ser exibidas na horizontal ou vertical. 74

81 Conexões do PI TimeRange Para alterar a orientação: Selecione Horizontal para exibir os controles do intervalo de horário como uma única linha através da largura da zona da página, com botões à direita. Selecione Vertical para exibir os controles do intervalo de horário centralizados e alinhados de cima para baixo, com botões centralizados na parte inferior. Conexões do PI TimeRange A Web part PI TimeRang suporta conexões do SharePoint (página 37) com relação a outras Web parts. Como uma consumidora Aceita que os valores iniciais sejam definidos pelos parâmetros da string de consulta. Como uma fornecedora Fornece um intervalo de horário inicial e é atualizada por meio de conexões implícitas ou explícitas. Fornece parâmetros de horário e status (página 75) para Web parts de terceiros. Fornece parâmetros como valores de filtro para as Web parts consumidoras, como a Web part Excel Web Access (EWA) (página 41). Na Web part EWA, o valor dos parâmetros pode ser usado para resolver uma função do PI DataLink em uma célula da planilha. Conexões de web parts de terceiros Você pode conectar o PI TimeRange às Web parts de terceiros para enviar informações de data e horário. Há dois formatos de horário alternativos disponíveis para facilitar as conexões do PI TimeRange às Web parts de terceiros. Os valores Hora inicial (localizada) Hora final (localizada) Hora atual (localizada) Intervalo de tempo (localizado) fornece valores expressos como carimbos de data e hora do Windows formatados de acordo com as configurações de locale (página 7) do site. O Intervalo de horário inclui o horário inicial e final, delimitados por um ponto e vírgula. Manual do Usuário do PI Web Parts

82 A Web part PI TimeRange Os valores Hora inicial (UTF) Hora final (UTF) Intervalo de tempo (UTF) fornece valores no Formato de Hora Universal (UTF) que corresponde ao formato de string especificado pela Seção da ISO-8601 (Data e Hora do Dia Formato estendido): YYYY-MM-DDThh:mm:ss Um parâmetro adicional, o flag IsUpdating, indica se um intervalo de horário é um intervalo de horário que está sendo atualizado. Os PI WebParts usam esse flag para determinar se precisam verificar o PI Data Services com relação às atualizações. 76

83 Capítulo 12 A Web part PI TimeSeries A Web part PI TimeSeries exibe dados de série temporal, normalmente a partir do PI Data Archive, em formato com tabelas junto com muitos outros atributos do tag PI. As Web parts PI TimeSeries também podem exibir datasets de cálculo do PI, relacionais e de serviço da Web no formato de série temporal. Para usar um dataset, selecione a coluna do dataset que contenha os valores que deseja exibir em PI TimeSeries. As colunas configuradas na Web part referentes aos tags PI e que não tenham nomes de coluna correspondentes no dataset exibem dados em branco. Os formatos de configuração do PI Table podem ser criados para datasets de série temporal e aplicados às Web parts PI TimeSeries para adicionar uma formatação personalizada. Configurar as Web parts PI TimeSeries Você pode configurar uma Web part PI TimeSeries usando o painel de ferramentas de Web parts e as seções de ferramentas de configuração padrão, incluindo Intervalo de horário (página 20), Dados selecionados (página 21), Colunas da tabela (página 30), Valores do filtro (página 33), Aparência, Layout e Avançado. Nota: O PI TimeSeries inclui automaticamente a primeira coluna em um dataset para fornecer dados do timestamp. Manual do Usuário do PI Web Parts