PI DataLink Server 2014
Guia do Usuário
OSIsoft, LLC
777 Davis St., Suite 250 San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Site: http://www.osisoft.com
Guia do Usuário do PI DataLink Server 2014
© 1992-2014 by OSIsoft, LLC. Todos os direitos reservados.
Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema de recuperação ou transmitida, em qualquer forma ou por quaisquer meios, sejam mecânicos, de fotocópia, registro ou outro, sem a prévia autorização por escrito da OSIsoft, LLC.
OSIsoft, o logotipo e o logo OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI Web API, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são marcas comerciais da OSIsoft, LLC. Todas as outras marcas ou nomes comerciais usados neste documento são de propriedade de seus respectivos proprietários.
DIREITOS DO GOVERNO DOS EUA
O uso, a duplicação ou a divulgação pelo Governo dos EUA estão sujeitos às restrições definidas no contrato de licença da OSIsoft, LLC e conforme fornecido nas DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, conforme aplicável. OSIsoft, LLC.
Versão: 5.1
Conteúdo
Introdução do PI DataLink Server... 1
Papéis e funções... 1
Requisitos do sistema... 2
Exibição de pasta de trabalho com o Excel Services... 2
Referências e mais informações... 2
Instalação e configuração do PI DataLink Server...5
Instale o DataLink Server do PI...5
Configure a autenticação para o PI DataLink Server ... 6
Instale as notificações do PI... 6
Solucionar os problemas de instalação do PI DataLink Server... 7
Verifique a configuração do Excel Services para o PI DataLink Server... 7
Verifique se as reivindicações para o Windows Token Service estão em execução...8
Pastas e permissões de registro... 9
Configure as definições das funções do PI DataLink... 9
Configurar as limitações de fuso horário para o PI DataLink Server...11
Referências de segurança... 11
Preparação de pasta de trabalho para o PI DataLink Server... 13
Configure as pastas de trabalho para suportar a entrada de parâmetro a partir dos navegadores... 13
Crie células nomeadas para uso como parâmetros...13
Configure as pastas de trabalho para mostrar os parâmetros do SharePoint... 14
Publique as pastas de trabalho em um local confiável...15
Publique as pastas de trabalho do Excel...15
Publique as pastas de trabalho do SharePoint ... 16
Adicione pastas de trabalho à uma página web part... 16
Ative a web part do Excel Web Access... 17
Conexões web part do Excel Web Access...18
O uso de pastas de trabalho com o PI DataLink Server... 19
Veja as pastas de trabalho em um navegador da web...19
Recalcular uma pasta de trabalho...19
Parâmetros em pastas de trabalho...20
Pastas de trabalho abertas no Excel do SharePoint... 20
Proteção da pasta de trabalho... 21
Autenticação do Kerberos para o PI DataLink Server... 23
Configure a delegação do Kerberos para o SharePoint em uma configuração do farm... 23
Configure uma conta de computador para delegar...24
Encontre a identidade do pool do aplicativo do Excel Services... 24
Habilite a autenticação do Kerberos para as aplicações da web que processam as planilhas do PI DataLink Server... 25
Configure a delegação do Kerberos para o SharePoint em uma configuração independente do farm...26
Verifique a autenticação do Kerberos no PI Server... 26
Introdução do PI DataLink Server
O PI DataLink Server é uma versão de servidor do PI DataLink para o uso com o Microsoft SharePoint 2010 ou posterior. O PI DataLink Server suporta todas as funções do PI DataLink e as funções no PI BatchView para suplemento do Excel.
Com o PI DataLink Server, você pode usar um navegador da web para recuperar e visualizar os dados do PI System especificados em uma planilha do Microsoft Excel. Você pode fornecer muitos consumidores diferentes, independentemente de sua localização ou familiaridade com o Microsoft Excel ou o PI DataLink, o acesso aos dados do PI System em tempo real.
O PI DataLink Server usa tecnologias do SharePoint da Microsoft, incluindo o Excel Services e a web part do Excel Web Access. Juntos, esses componentes da Microsoft oferecem suporte à maioria dos recursos padrão de planilha. O PI DataLink Server aumenta esses componentes com suporte para funções do PI DataLink.
Você pode acessar planilhas do Excel em bibliotecas de documentos do SharePoint de forma independente, ou pode adicionar as pastas de trabalho para páginas web part. Com a web part do Excel Web Access, você pode trocar parâmetros entre uma pasta de trabalho e outras web parts. Por exemplo, com a web part do Excel Web Access, você pode integrar planilhas com funções do PI DataLink no PI WebParts.
Nesta seção
• Papéis e funções
• Requisitos do sistema
• Exibição de pasta de trabalho com o Excel Services
• Referências e mais informações
Papéis e funções
O PI DataLink Server é um suplemento para o Microsoft SharePoint Excel Services. O suplemento aumenta o Excel Services com funções que conectam e recuperam dados do PI System: o suplemento fornece uma funcionalidade com base em servidor do PI DataLink a usuários sem o Excel ou o PI DataLink no computador de seus clientes.
Os usuários do PI DataLink Server caem em uma ou mais, possivelmente sobrepostas, papéis: • Os administradores instalam e configuram o adicionar no servidor do SharePoint. Eles
garantem a operação e a rede de acesso correta em um ambiente do Microsoft SharePoint, e eles estabelecem bibliotecas de documentos e locais de arquivos confiáveis. Consulte a
Instalação e configuração do PI DataLink Server.
• Os editores têm o Excel com o DataLink PI ou o PI BatchView adicionados em seus desktops. Eles constroem e mantém as planilhas do Excel usando as funções do PI DataLink e do PI BatchView, criam relatórios e salvam os arquivos do Excel nas bibliotecas de documentos do SharePoint. Consulte a Preparação de pasta de trabalho para o PI DataLink Server. • Os designers criam sites e páginas do SharePoint que usam a web part do Excel Web Access
para exibir planilhas do Excel. Eles também podem criar páginas do PI WebParts que incorporam a web part do Excel Web Access. Consulte a Adicione pastas de trabalho à uma página web part.
• Os leitores podem ou não ter o Excel e o PI DataLink em seus desktops. Eles são
principalmente os usuários operacionais e de negócios dos dados do PI System contidos em pastas de trabalho. Eles acessam as pastas de trabalho através de um navegador da web e
atualizam os dados para revisão e análise. Consulte a O uso de pastas de trabalho com o PI DataLink Server.
Requisitos do sistema
Para obter os requisitos do sistema atualizados, acesse a página dos Produtos do Suporte Técnico da OSIsoft (https://techsupport.osisoft.com/Products/). Clique no link do produto para ver as informações sobre o produto, inclusive os requisitos do sistema atuais.
Exibição de pasta de trabalho com o Excel Services
O Excel Services é uma tecnologia do SharePoint, que estende o Excel e lhe permite acessar a uma pasta de trabalho a partir de um navegador. Para obter mais informações, consulte o artigo da Microsoft, Introdução ao Excel Services e ao Excel Web Access (http://
office.microsoft.com/en-us/sharepoint-server-help/getting-started-with-excel-services-and-excel-web-access-HA010377881.aspx).
Há duas maneiras de exibir uma pasta de trabalho com o Excel Services:
• Você pode abrir uma pasta de trabalho de uma biblioteca de documentos do SharePoint em um navegador. O SharePoint carrega automaticamente e exibe a pasta de trabalho em uma página da web completa.
• Você pode adicionar a web part do Excel Web Access a uma página web-part no SharePoint, e configurá-la para exibir uma pasta de trabalho particular. Neste caso, as funções da web part do Excel Web Access como uma web part do PI Graphic e aponta para uma pasta de trabalho específica armazenada em uma biblioteca do SharePoint.
Quando uma pasta de trabalho é carregada ou calculada, o PI DataLink Server se conecta ao PI Server apropriado ou ao servidor AF PI e atualiza a pasta de trabalho.
Recursos suportados
• Funções do PI DataLink
• PI BatchView para funções no Excel • Função de notificação de Pesquisa • Gráficos e tabelas do Excel
Recursos não suportados
• Controles ActiveX, incluindo controles de tendência PI DataLink
• Macros, incluindo a funçãoPIPutVal que grava dados em um PI Server ou em um servidor PI AF
• Reconheça hyperlinks e reconheça com hyperlinks de Comentário • VBA, incluindo quaisquer scripts personalizados em planilhas
Referências e mais informações
Para obter mais informações sobre o SharePoint, consulte os seguintes artigos da Microsoft: Introdução do PI DataLink Server
• Requisitos do sistema para o SharePoint 2013 (http://technet.microsoft.com/en-us/ library/cc262749(v=office.15).aspx)
• Instale e configure o SharePoint 2013 (http://technet.microsoft.com/en-us/library/ cc262957(v=office.15).aspx)
• Operações para o SharePoint 2013 (http://technet.microsoft.com/en-us/library/ cc262289(v=office.15).aspx)
• Visão geral dos Serviços do Excel no SharePoint Server 2013 (http:// technet.microsoft.com/en-us/library/ee424405(v=office.15).aspx)
Também consulte a seguinte documentação da OSIsoft, disponível no site do Suporte de Tecnologia ou no PI Live Library (http://livelibrary.osisoft.com):
• PI WebParts User Guide para obter informações sobre como trabalhar com o Microsoft SharePoint
• PI WebParts Administrator Guide para obter informações sobre a configuração do Microsoft SharePoint e as conexões com o PI Server e o servidor PI AF
• Documentação do PI Server para obter informações sobre as conexões de servidor seguro e o PI Notifications
• PI DataLink User Guidepara obter informações sobre o PI DataLink e o Excel, incluindo o PI Notifications do DataLink de suplemento para o Excel
• PI BatchView User Guide para obter informações sobre o PI BatchView de suplemento para o Excel
Instalação e configuração do PI DataLink Server
Para usar o PI DataLink Server em seu ambiente, você deve instalar o PI DataLink Server em cada servidor que hospeda o Excel Services e configurar o seu sistema para suportar à autenticação necessária. Dependendo de suas necessidades, você também pode instalar o PI Notifications e configurar as definições das funções do PI DataLink.Nesta seção
• Instale o DataLink Server do PI
Faça logon como administrador do sistema e execute o programa de instalação em cada servidor que hospeda o Excel Services.
• Configure a autenticação para o PI DataLink Server
Para fornecer acesso adequado à planilha de dados com o PI DataLink Server, você deve configurar o seu sistema para suportar a autenticação de identidade necessária.
• Instale as notificações do PI
Para usar a função de Notificação de Pesquisa, instale o PI Notifications em cada servidor no qual você instalou o PI DataLink Server.
• Solucionar os problemas de instalação do PI DataLink Server
Se o PI DataLink Server não funcionar após a instalação, verifique a configuração do Excel Services, a inicialização do serviço, e o acesso ao diretório.
• Configure as definições das funções do PI DataLink
Para usar configurações além da padrão, modifique o arquivo de configurações para cada instalação do PI DataLink Server.
• Referências de segurança
Vários artigos da Microsoft fornecem mais informações sobre segurança no SharePoint.
Instale o DataLink Server do PI
Inicie o programa de instalação para instalar o PI DataLink Server. Se você executar o
SharePoint em uma configuração de servidor farm, você deve instalar o PI DataLink Server em cada servidor que hospeda o Excel Services.
Dica:
O programa de instalação deve reiniciar o IIS para instalar o PI DataLink Server. Portanto, execute o programa de instalação em um momento conveniente para reiniciar o IIS.
Antes de Iniciar
Faça Logon como administrador do sistema para o servidor do SharePoint, onde você instalará o PI DataLink Server.
Procedimento
1. Faça o download do kit de instalação na página de Downloads do Suporte Técnico da OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/).
2. Execute o kit de instalação no servidor do SharePoint para iniciar o assistente de instalação. O assistente mostra uma lista dos componentes de software que o PI DataLink Server requer.
3. Reveja a lista de componentes de software e clique em OK para instalar o PI DataLink Server.
O programa de instalação instala ou atualiza os componentes de software necessários na ordem mostrada.
Configure a autenticação para o PI DataLink Server
Você deve configurar o seu sistema para fornecer acesso adequado aos dados da planilha que o PI DataLink Server apresenta. A configuração necessária depende de como você deseja
controlar o acesso a planilha de dados que o PI DataLink Server recupera.
Para obter detalhes sobre a concessão de acesso para o PI Server e o PI Asset Framework (PI AF), consulte os tópicos de configuração de segurança para o PI Server na PI Live Library (http://livelibrary.osisoft.com). Para obter detalhes sobre como configurar a delegação do Kerberos, consulte Autenticação do Kerberos para o PI DataLink Server.
Procedimento
• Para fornecer acesso aos dados da planilha com base na identidade da conta de login usando o navegador da web:
a. Configure a delegação do Kerberos do SharePoint e do Excel Services.
b. Conceda acesso à dados adequados do PI Server criando mapeamentos de PI adequados sobre o PI Server para as contas que possam usar o PI DataLink Server.
c. Conceda as contas que possam usar o acesso ao PI DataLink Server para o PI AF. • Para proporcionar a todos os usuários o mesmo nível de acesso a Planilha de dados
(possível apenas para acessar dados do PI Server), crie uma relação de confiança para o processoOSIsoft.PIDataLink.Service.exe no PI Server.
Nota:
OSIsoft recomenda que você forneça acesso à planilha de dados com base na identidade da conta de login usando o navegador da web. Este é mais seguro do que proporcionar a todos os usuários o mesmo nível de acesso, com uma confiança de PI. No entanto, em alguns casos, fornecer temporariamente todos os usuários do mesmo acesso pode ajudá-lo a verificar a instalação adequada do PI DataLink Server e a configuração correta dentro do SharePoint.
Instale as notificações do PI
O PI DataLink Server suporta o PI Notifications, mas para usar a função de Notificação de Pesquisa no PI DataLink Server, você deve instalar o PI Notifications separadamente.
Dica:
Este procedimento requer que você reinicie o IIS. Portanto, faça este procedimento em um horário conveniente para reiniciar o IIS.
Procedimento
1. Faça o download do kit de instalação do PI Notifications na página de Downloads do Suporte Técnico da OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/).
2. Em cada servidor do SharePoint onde você instalou o PI DataLink Server, execute o kit de instalação para instalar o PI Notifications.
Quando você instala o PI Notifications para usar a função de Notificação de Pesquisa no PI DataLink Server, o OSIsoft recomenda que você só instale o recurso do PI Notifications Client.
3. Ative a delegação do Kerberos no servidor onde o PI DataLink Server está instalado. Instalação e configuração do PI DataLink Server
Nota:
A delegação do Kerberos é necessária para qualquer tipo de instalação do PI DataLink Server que inclui o PI Notifications. Consulte a Autenticação do Kerberos para o PI DataLink Server.
4. Reinicie o IIS e o PI DataLink Service:
a. Para reiniciar o IIS, digite iisreset em um prompt de comando como um administrador.
b. Para reiniciar o PI DataLink Service, usar a ferramenta administrativa Serviços.
Solucionar os problemas de instalação do PI DataLink Server
O programa de configuração do PI DataLink Server inicia os serviços necessários e configura o SharePoint para reconhecer os conjuntos necessárias. Se o PI DataLink Server não funcionar corretamente, verifique se o Excel Services está configurado corretamente, se os serviços necessários estão em execução, e que os diretórios têm acesso adequado.Procedimento
• Verifique a configuração do Excel Services para o PI DataLink Server.
• Verifique se as reivindicações para o Windows Token Service estão em execução. • Verifique se as pastas e os registros têm as permissões corretas. Consulte a Pastas e
permissões de registro.
Verifique a configuração do Excel Services para o PI DataLink Server
Use a Administração Central do SharePoint para verificar a configuração do Excel Services para o PI DataLink Server. Para o PI DataLink Server trabalhar, os Serviços de Cálculo do Excel devem ser iniciados, o conjunto PI DataLink Server deve estar vinculado ao Excel Services, e o diretório onde você coloca as planilhas deve ser especificado.
Se necessário, altere a configuração e reinicie o IIS e o PI DataLink Service.
Procedimento
1. Verifique se os Serviços de Cálculo do Excel está em execução:
a. No painel de navegação Administração central da Administração Central do SharePoint, clique em Gerenciamento de aplicativos.
b. Na página Gerenciamento de Aplicativos, sob Service Applications, clique em Gerenciar serviços no servidor.
c. Na lista de serviços, verifique se o Serviços de Cálculo do Excel foi iniciado.
Se a coluna de Estado para o Serviços de Cálculo do Excel diz Parado, então clique em Iniciar na coluna Ação para iniciar o serviço.
2. Verifique se o conjunto do PI DataLink Server é especificado para o Excel Services: a. No painel de navegação Central de Administração clique em Gerenciar Aplicativo. b. Na página Gerenciamento de Aplicativos, sob Aplicativos de Serviço, clique em Gerenciar
aplicativos de serviço.
c. Na lista de aplicativos de serviço, clique em Aplicativo do Excel Services (para o tipo de Aplicativo de Serviço da Web do Aplicativo do Excel Services).
d. Na página Gerenciar Aplicativo do Excel Services, clique em Conjuntos de Funções Definidos pelo Usuário.
A página de funções definidas pelo usuário do Aplicativo do Excel Services deve listar o seguinte conjunto:
Coluna Entrada
Montagem C:\Program Files (x86)\PIPC\Excel
\OSIsoft.PIDataLink.Server.dll
Se você não usou o diretório de instalação padrão, seu caminho será diferente. Especifique o caminho correto para a montagem.
Local de montagem Caminho do arquivo Permitir montagem Sim
3. Verifique a especificação de diretórios do qual o Excel Services pode processar as planilhas: a. No painel do navegador Central de Administração clique em Gerenciar Aplicativo. b. Na página Gerenciamento de Aplicativos, sob Aplicativos de Serviço, clique em Gerenciar
aplicativos de serviço.
c. Na lista de aplicativos de serviço, clique em Aplicativo do Excel Services (para o tipo de Aplicativo de Serviço da Web do Aplicativo do Excel Services).
d. Na página Gerenciar Aplicativo do Excel Services , clique em Locais de Arquivos Confiáveis.
A página de Locais de Arquivos Confiáveis do Aplicativo do Excel Services deve listar o seguinte local:
Coluna Entrada
Montagem C:\Program Files (x86)\PIPC\Excel
\OSIsoft.PIDataLink.Server.dll
Se você não usou o diretório de instalação padrão, seu caminho será diferente. Especifique o caminho correto para a montagem.
Local de montagem Caminho do arquivo Permitir montagem Sim
Isso permitirá que o Excel Services (e o PI DataLink Server) processem as planilhas da biblioteca de documentos do SharePoint.
4. Se você alterou a configuração, reinicie o IIS e o PI DataLink Service:
a. Para reiniciar o IIS, digite iisreset em um prompt de comando como um administrador.
b. Para reiniciar o PI DataLink Service, usar a ferramenta administrativa Serviços.
Verifique se as reivindicações para o Windows Token Service estão em
execução
Para os servidores que executam o SharePoint em uma configuração de farm, o PI DataLink Server requer um serviço do Windows chamado Reivindicações para o Windows Token Service. Este serviço deve ser executado na ferramenta administrativa de Serviços no Windows e na Administração Central do SharePoint. Se o serviço não estiver em execução, o PI DataLink Server não pode se comunicar com o PI Server, e as funções retornam #VALUE! erros nas planilhas.
Procedimento
1. Use a ferramenta administrativa de serviços para verificar que as reivindicações para o Windows Token Service está sendo executado a partir do Windows.
Verifique se a linha Declarações para o Serviço de Token do Windows tem o Status de propriedade definido como Executando e o Tipo de Inicialização de propriedade definida como Automática.
2. Use a Administração Central do SharePoint para verificar se o serviço está sendo executado a partir do SharePoint:
a. No painel de navegação Administração central da Administração Central do SharePoint, clique em Gerenciamento de aplicativos.
b. Na página Gerenciamento de Aplicativos, sob Service Applications, clique em Gerenciar serviços no servidor.
c. Na lista de serviços, verifique que as reivindicações para Serviço de Token do Windows foram iniciadas.
Se a coluna Status para as Reivindicações do Windows Token Service diz Parado, então clique em Iniciar na coluna Ação para iniciar o serviço.
Pastas e permissões de registro
Usuários ou grupos finais e a identidade do pool do aplicativo requerem as seguintes permissões de registro e pasta no servidor web:
Localização Conta do usuário Permissões
Pasta e subpastas PIPC Usuário final Ler e executar, Ler Pasta e subpastas PIPC Identidade do pool
de aplicativos Controle completo Chave de registro e subchaves HKLM
\SOFTWARE\PISystem
Usuário final e identidade do pool de aplicativos
Controle completo
Para obter informações adicionais, consulte o artigo da Microsoft Permissões de conta e configurações de segurança do SharePoint 2013 (http://technet.microsoft.com/en-us/library/ cc678863(v=office.15).aspx).
Configure as definições das funções do PI DataLink
Você pode configurar as definições das funções do PI DataLink em planilhas que o PI DataLink Server apresenta editando um arquivo XML no computador do PI DataLink Server. Essas configurações controlam o fuso horário no qual o PI DataLink Server processa os dados, o local, e outros limites para certas operações.
Se o arquivo não existir, o programa de instalação cria esse arquivo XML durante a instalação. Você pode usar versões deste arquivo de instalações anteriores. No entanto, o PI DataLink Server 2014 apresenta novas configurações e novos valores aceitáveis. Para quaisquer ajustes não encontrados (tais como se você excluir o arquivo ou uma configuração no arquivo), o PI DataLink Server usa a configuração padrão.
Dica:
Este procedimento requer que você reinicie o IIS. Portanto, faça este procedimento em um horário conveniente para reiniciar o IIS.
Procedimento
1. Abra o arquivo OSIsoft.PIDataLink.xml no diretório C:\ProgramData\OSIsoft\DLES. Instalação e configuração do PI DataLink Server
Nota:
A pasta ProgramData está oculta por padrão. O texto a seguir mostra a versão padrão do arquivo:
<?xml version="1.0" encoding="utf-8"?> <Settings xmlns:xsi="http://www.w3.org/ 2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <UseServerTime>0</UseServerTime> <LocaleIndependent>0</LocaleIndependent> <MaxReceivedMessageSize>100000000</ MaxReceivedMessageSize> <OperationTimeout>60</OperationTimeout> <MaxEFCount>1000</MaxEFCount> <MaxAFSearchCount>10000</MaxAFSearchCount> </Settings>
2. Edite os valores no arquivo de modo a refletir as suas preferências e, em seguida, salve o arquivo.
Configuração Descrição
UseServerTime Indica como o PI DataLink Server interpreta horários de entrada e exibe horários de saída:
◦ 0
O PI DataLink Server usa o fuso horário do SharePoint Server. Esta é a configuração padrão.
◦ 1
O PI DataLink Server usa o fuso horário do PI Server do qual a função recupera dados.
Essa configuração só se aplica aos itens de dados ou expressões contendo um ponto do PI ou um atributo do PI AF que seja uma referência de dados do ponto do PI. Se o item de dados ou expressão contiver um atributo do PI AF que não seja uma referência de dados de um ponto do PI, o PI DataLink interpretará os timestamps de entrada e saída como sendo no fuso horário do SharePoint Server. ◦ 2
O PI DataLink Server usa o tempo universal coordenado (UTC). Algumas funções não suportam essa configuração. Para obter detalhes sobre essas exceções, consulte Configurar as limitações de fuso horário para o PI DataLink Server.
LocaleIndependent Indica como o PI DataLink Server interpreta as strings de tempo de entrada:
◦ 0
O PI DataLink Server usa a configuração regional no SharePoint Server para interpretar as strings de tempo de entrada. Esta é a configuração padrão.
◦ 1
O PI DataLink Server usa as regras de formato de tempo do PI, independentemente da configuração no SharePoint Server. O tempo do PI pressupões que todas as strings estão em inglês e usa o formato de data e hora dd-mmm-yyyy hh:mm:ss.
MaxReceivedMessageSize A quantidade máxima de dados que uma chamada de serviço pode recuperar para uma função do PI DataLink. Especificada em bytes. O valor padrão é 100MB. Somente altere este valor conforme recomendado pelo Suporte Técnico da OSIsoft.
OperationTimeout A quantidade máxima de tempo permitida para cada chamada de serviço por uma função do PI DataLink. Especificada em segundos. O valor padrão é 60 segundos. Somente altere este valor conforme recomendado pelo Suporte Técnico da OSIsoft.
Configuração Descrição
MaxEFCount O número máximo de eventos que as funções Explorar Eventos e Comparar Eventos retornam à planilha.
MaxAFSearchCount O número máximo de elementos que a função Pesquisa do Filtro de Ativos retorna para a planilha, exceto quando a função especifica um filtro de valor do atributo para um atributo com uma referência de dados. Nesse caso, insira o número total de elementos nos quais deseja-se pesquisar um atributo com uma referência de dados, observe que se esse número estiver configurado para muito baixo, a função poderá retornar menos resultados que o esperado.
3. Proporcione o acesso adequado ao arquivo:
a. Do Windows Explorer, clique com o botão direito no arquivo OSIsoft.PIDataLink.xml e, então clique em Propriedades.
b. Na guia Segurança, configure as permissões para fornecer acesso de leitura para usuários exigidos:
▪ A identidade do aplicativo de pool para o Excel Services, se o PI DataLink Server oferecer à todos o acesso aos mesmos dados.
▪ Cada usuário de domínio de conta que usa o PI DataLink Server, se o PI DataLink Server fornecer acesso aos dados com base na conta registrada.
4. Reinicie o IIS e o PI DataLink Service:
a. Para reiniciar o IIS, digite iisreset em um prompt de comando como um administrador.
b. Para reiniciar o PI DataLink Service, usar a ferramenta administrativa Serviços.
Configurar as limitações de fuso horário para o PI DataLink Server
Certas limitações aplicam-se a configuração de fuso horário no PI DataLink Server:
• A função de Pesquisa de Notificações atualmente não suporta a configuração de fuso horário UTC. A função de Pesquisa de Notificações sempre usa o fuso horário do SharePoint Server. • Se uma anotação contiver um timestamp, a função Dados compactados sempre exibirá esse
timestamp no fuso horário do PI Server.
• A função Propriedades sempre exibe valores dos atributos do ponto do PI contendo timestamps (por exemplo, datas de criação e modificação) no fuso horário do PI Server. • As funções do banco de dados do módulo do PI DataLink (Alias para a função Tag e a
propriedade para função de valor) não suportam a configuração de fuso horário UTC. Estas funções usam o fuso horário do SharePoint Server quando o fuso horário UTC é selecionado.
Referências de segurança
Para obter mais informações sobre segurança no SharePoint, consulte estes artigos da Microsoft:
• Planejar a autenticação no SharePoint 2013 (http://technet.microsoft.com/en-us/library/ ee794879(v=office.15).aspx)
• Plano de permissões de site no SharePoint 2013 (http://technet.microsoft.com/en-us/ library/cc262778(v=office.15).aspx)
• Melhores práticas para usar permissões refinadas no SharePoint Server 2013 (http:// technet.microsoft.com/en-us/library/gg128955(v=office.15).aspx)
• Gerenciar os locais de arquivos confiáveis no Excel Services (SharePoint Server 2013) (http://technet.microsoft.com/en-us/library/jj219699(v=office.15).aspx)
Preparação de pasta de trabalho para o PI DataLink
Server
Para o PI DataLink Server processar as planilhas, você deve fazer o upload das pastas de trabalho para um local do SharePoint confiável. Para melhorar a experiência do usuário, você pode configurar as pastas de trabalho para dar suporte a entrada de parâmetro a partir de navegadores e adicionar pastas de trabalho para páginas web part.
Nesta seção
• Configure as pastas de trabalho para suportar a entrada de parâmetro a partir dos navegadores
Crie células nomeadas para as células da planilha que contêm os parâmetros e configure a pasta de trabalho para mostrar os parâmetros no SharePoint.
• Publique as pastas de trabalho em um local confiável
Use o Excel ou o SharePoint para carregar as pastas de trabalho para um local confiável para que o PI DataLink Server possa processar as planilhas.
• Adicione pastas de trabalho à uma página web part
Para fornecer acesso conveniente para pastas de trabalho no SharePoint, adicione as pastas de trabalho a páginas da Web com a web part do Excel Web Access.
Configure as pastas de trabalho para suportar a entrada de
parâmetro a partir dos navegadores
Com as pastas de trabalho devidamente configuradas, os usuários podem inserir valores em células da planilha que você designou como parâmetros, e o PI DataLink Server mostrará os resultados da função atualizados para esses valores. Para oferecer suporte a entrada de parâmetro a partir dos navegadores, você deve criar células nomeadas para as células da planilha que contêm os parâmetros, e você deve configurar a pasta de trabalho para mostrar os parâmetros do SharePoint.
Por exemplo, em uma planilha, uma função PI DataLink pode referenciar uma célula nomeada que contém um nome ponto do PI. Quando a pasta de trabalho é aberta em um navegador, o SharePoint fornece um campo de parâmetro para inserir um nome ponto do PI diferente.
Procedimento
1. Crie células nomeadas para uso como parâmetros.
Abra uma planilha no Excel, selecione a célula, e defina o nome.
2. Configure as pastas de trabalho para mostrar os parâmetros do SharePoint.
Abra a pasta de trabalho no Excel, e configure as planilhas que você quer visível do SharePoint e as células nomeadas que você deseja usar como parâmetros.
Crie células nomeadas para uso como parâmetros
A célula nomeada é uma célula da planilha que você nomeia e referência. Você pode configurar a pasta de trabalho para usar células nomeadas como parâmetros; quando os utilizadores visualizarem a planilha do SharePoint, eles podem inserir valores para estes parâmetros. Você cria células nomeadas do Excel.
Por exemplo, em uma planilha, uma função do PI DataLink pode fazer referência a uma célula que contém um nome ponto do PI. Você pode inserir um nome para essa célula, e então essa célula pode ser usada como um parâmetro ao visualizar a planilha do SharePoint.
Procedimento
1. De Excel, selecione a célula que você deseja expor como um parâmetro.
2. Clique na Caixa de Nome à esquerda da barra de fórmula, digite o nome desejado, e pressione Enter.
Alternativamente, você pode clicar com o botão direito do mouse na célula e, em seguida, clicar em Definir Nome para abrir a janela Novo Nome , onde você pode especificar o nome da célula.
Configure as pastas de trabalho para mostrar os parâmetros do SharePoint
Para pastas de trabalho prestadas com o PI DataLink Server, você pode expor as células em uma planilha chamada como parâmetros para as quais os usuários podem inserir valores: abra a pasta de trabalho no Excel, e defina as planilhas que você quer visível a partir do navegador e as células nomeadas que deseja disponibilizar como parâmetros.
Procedimento
• Do Excel 2007:
a. Clique no botão do Microsoft Officee, em seguida clique em Publicar > Excel Services para abrir a janela Salvar como.
b. Clique no botão Opções do Excel Services para abrir a janela Opções do Excel Services. c. Na guia Exibir, selecione as planilhas que você deseja visível para aqueles visualizando a
pasta de trabalho com o PI DataLink Server.
d. Na guia Parâmetros, especifique as células nomeadas que você deseja expor como parâmetros a partir do navegador.
Clique em Adicionar para abrir a janela Adicionar Parâmetros onde você pode selecionar as células nomeadas para adicionar como parâmetros.
e. Clique em OK. • Do Excel 2010:
a. Clique na guia Arquivo e, então clique em Salvar & Enviar.
b. Clique em Salvar no SharePoint e, então clique em Opções de Publicação para abrir a janela Opções de Publicação.
c. Na guia Exibir, selecione as planilhas que você deseja visível para aqueles visualizando a pasta de trabalho com o PI DataLink Server.
d. Na guia Parâmetros, especifique as células nomeadas que você deseja expor como parâmetros a partir do navegador.
Clique em Adicionar para abrir a janela Adicionar Parâmetros onde você pode selecionar as células nomeadas para adicionar como parâmetros.
e. Clique em OK. • Do Excel 2013:
a. Clique na guia Arquivo, e então clique em Informações.
b. Na página Informações, clique em Opções de Exibição do Navegador para abrir a janela Opções de Exibição do Navegador.
c. Na guia Exibir, selecione as planilhas que você deseja visível para aqueles visualizando a pasta de trabalho com o PI DataLink Server.
d. Na guia Parâmetros, especifique as células nomeadas que você deseja expor como parâmetros a partir do navegador.
Clique em Adicionar para abrir a janela Adicionar Parâmetros onde você pode selecionar as células nomeadas para adicionar como parâmetros.
e. Clique em OK.
Publique as pastas de trabalho em um local confiável
Para o PI DataLink Server processar as folhas de cálculo, você deve armazenar a pasta de trabalho em um local de arquivo do SharePoint confiável. Os locais de arquivos confiáveis são especificados durante a instalação. Consulte a Verifique a configuração do Excel Services para o PI DataLink Server. Por padrão, o servidor do SharePoint é especificado como um local de arquivo confiável. Você pode fazer upload de pastas de trabalho para o local confiável do Excel ou do SharePoint.Procedimento
• Publique as pastas de trabalho do Excel. • Publique as pastas de trabalho do SharePoint.
Publique as pastas de trabalho do Excel
Do Microsoft Excel, você pode salvar as pastas de trabalho para um local de arquivo confiável. Para processar as pastas de trabalho em um navegador, o PI DataLink Server requer que as pastas de trabalho sejam armazenadas em um local de arquivo do SharePoint confiável.
Nota:
Você deve ter o Professional Plus Edition do Office 2007 SP3 ou posterior para salvar diretamente para um local do SharePoint confiável.
Procedimento
• Do Excel 2007:
a. Clique no botão do Microsoft Officee, em seguida clique em Publicar > Excel Services para abrir a janela Salvar como.
b. No campo Nome de Arquivo, especifique o caminho onde você deseja salvar a pasta de trabalho. Clique em OK.
c. Clique em Salvar.
O Excel salva o documento para a biblioteca de documentos do SharePoint especificado. O Excel retorna um erro de acesso negado se o local especificado não é um local
confiável. • Do Excel 2013:
a. Clique na guia Arquivo, e então clique em Salvar como.
b. Na página Salvar Como, clique em SharePoint, em seguida, clique na pasta em que deseja salva sua pasta de trabalho.
c. Na janela Salvar Como, especifique o nome do arquivo e clique em Salvar para salvar o documento na pasta especificada.
Publique as pastas de trabalho do SharePoint
Você pode adicionar pastas de trabalho para a biblioteca de documentos do SharePoint a partir do site do SharePoint. Para processar as pastas de trabalho em um navegador, o PI DataLink Server requer que as pastas de trabalho sejam armazenadas em um local de arquivo do SharePoint confiável.
Procedimento
1. De seu navegador, vá ao site do SharePoint e à biblioteca de documentos em que deseja armazenar a pasta de trabalho.
2. Clique em novo documento para abrir a janela Adicionar documento.
3. Clique no Navegador para abrir a janela Escolha o Arquivo para Carregar onde você pode navegar no seu computador e selecionar a pasta de trabalho que quer carregar para a biblioteca de documentos.
Nota:
A pasta de trabalho deve ser guardada no formato .xlsx ou .xlsb. 4. Clique em OK. A pasta de trabalho é exibida na lista da biblioteca de documentos.
Adicione pastas de trabalho à uma página web part
Qualquer pessoa com acesso a uma biblioteca de documentos do SharePoint pode exibir pastas de trabalho armazenadas nesta biblioteca através de um navegador da web. Você também pode fornecer acesso adicionando pastas de trabalho para as páginas da web com a web part do Excel Web Access. Para obter informações sobre como incluir esta web part no PI WebParts, consulte Conexões web part do Excel Web Access.
Procedimento
1. Crie ou navegue até uma página web part existente no SharePoint.
Para obter mais informações sobre o local e a criação da página web part, consulte a seção "Trabalhando no SharePoint" no PI WebParts User Guide, disponível na PI Live Library (http://livelibrary.osisoft.com).
2. Clique no botão Adicionar uma Web Part em um campo da página web part para abrir a janela Adicionar Web Parts.
3. Vá até a seção Dados Corporativos.
Você deve ver a web part do Excel Web Access nesta seção, mas pode aparecer em uma seção diferente. Se a web part não aparecer em nenhum lugar na janela, ela não pode estar ativada.
Consulte a Ative a web part do Excel Web Access.
4. Selecione a caixa de seleção próxima ao Excel Web Access e clique em Adicionar. A web part do Excel aparece no campo selecionado.
5. Clique no link Clique aqui para abrir o painel de ferramentas, ou clique em Editar > Modificar Web Part Compartilhada para abrir o painel de ferramentas.
O painel de ferramentas do Excel Web Access abre. Preparação de pasta de trabalho para o PI DataLink Server
6. Na área de Exibição da Pasta de Trabalho clique no botão Navegar próximo ao campo Pasta de Trabalho.
A janela Selecionar um Link se abre.
7. Navegue até o local onde suas pastas de trabalho estão armazenadas (por exemplo, uma biblioteca de Documentos Compartilhados).
Você também pode inserir um caminho relativo para o site do SharePoint no campo Local (URL) e clicar no botão de seta verde.
Uma lista dos itens armazenados no local aparece na janela. 8. Selecione a pasta de trabalho desejada e clique em OK.
9. Clique em Aplicar no painel de ferramentas para verificar se a pasta de trabalho carrega corretamente na web part do Excel.
10. Insira quaisquer outros parâmetros, tais como o número máximo de linhas e colunas a serem exibidos, ou um nome alternativo para a pasta de trabalho, e clique em OK para fechar o painel de ferramentas.
Você também pode adicionar comandos da barra de ferramentas e limite de interatividade com a pasta de trabalho utilizando várias opções do painel de ferramentas.
Consulte o artigo da Microsoft Propriedades personalizadas de Acesso à web part do Excel Web Access (http://office.microsoft.com/en-us/sharepointserver/HA101054551033.aspx)
para informações adicionais.
Ative a web part do Excel Web Access
A web part do Excel Web Access não está habilitada automaticamente em todos os modelos de site do SharePoint. Se o seu site do SharePoint foi atualizado a partir de uma versão anterior, ou você está usando um modelo diferente, a web part do Excel Web Access pode não aparecer na janela Adicionar Web Parts.
Procedimento
1. Clique em Ações do Site > Configurações do Site > Modificar Todas as Configurações do Site.
2. Sob Administração do Site, clique em Recursos do Site.
3. Clique em Ativar ao lado de Recursos do site do Office SharePoint Server Enterprise.
Conexões web part do Excel Web Access
A web part do Excel Web Access suporta conexões de consumo de fornecedores da web part, incluindo o PI WebParts. Com o PI WebParts, você pode ter uma visão mais abrangente do painel dentro de uma página web part.
Com conexões web part você pode usar o PI WebParts para exibir ou dirigir uma planilha com as funções do PI DataLink embutidas. Algumas interações comuns são:
• Receber uma URL da pasta de trabalho, um item nomeado, ou um contexto de módulo da web part do PI TreeView.
• Aceitar nomes de tag de um PI Graphic, PI Table, PI TimeSeries, ou PI Values web part. • ConsumirIniciar eFinalizarvalores de tempo enviados pela web part do PI TimeRange. Tenha em mente as seguintes diretrizes e limitações ao estabelecer conexões entre o PI WebParts e a web part do Excel Web Access:
• O PI Graphic, PI TimeRange, e a web part do PI TreeView, bem como qualquer tabela da web part do PI WebParts, pode fornecer dados para a web parts do Excel.
• Nomes da pasta de trabalho e itens nomeados são passados para Excel Web Access através de conexões IRowProvider.
• Os valores dos parâmetros celular são passados para o Excel Web Access através de uma conexão IFilterValues.
• O PI WebParts passa apenas um valor para o consumidor do Excel Web Access, que aceita não mais do que um valor a partir de uma conexão IFilterValues.
• Um parâmetro deve ser definido em uma planilha do Excel usando células nomeadas (consulte Crie células nomeadas para uso como parâmetros) para o Excel Web Access consumir os valores dos parâmetros de célula através de uma conexão IFilterValues. • A web part do PI TimeRange fornece um único parâmetro de tempo de intervalo para passar
o início e o fim do tempo em conjunto através de uma conexão IFilterValues. Esse parâmetro é uma cadeia concatenada delimitada por ponto e vírgula.
Use as funções de manipulação de string do Excel (por exemplo, ESQUERDA, DIREITA, MEIO, PESQUISAR) para analisar o parâmetro de tempo de intervalo em componentes separados de início de tempo e fim de tempo. Distribua os resultados para separar as células para o uso com as funções do PI DataLink.
Consulte as seções correspondentes no PI WebParts User Guide para informações adicionais sobre conexões web part.
O uso de pastas de trabalho com o PI DataLink
Server
Depois de instalar o PI DataLink Server e preparar suas planilhas do Excel, você pode acessar as pastas de trabalho diretamente de um navegador da web. Esta seção aborda as tarefas comuns que você pode completar ao processar as pastas de trabalho com PI DataLink Server.
Nesta seção
• Veja as pastas de trabalho em um navegador da web
• Recalcular uma pasta de trabalho
• Parâmetros em pastas de trabalho
No painel no navegador, é possível inserir parâmetros que atualizam funções na planilha. • Pastas de trabalho abertas no Excel do SharePoint
Veja as pastas de trabalho em um navegador da web
Você pode abrir os arquivos do Excel de bibliotecas do SharePoint diretamente em um navegador, sem o Microsoft Excel ou o PI DataLink instalado em sua estação de trabalho do computador.Procedimento
1. A partir do seu navegador, vá ao site do SharePoint e a biblioteca de documentos que armazena a pasta de trabalho.
2. Clique no menu suspenso para a pasta de trabalho e escolhaVer no Navegador da Web. A janela do navegador é aberta para exibir a pasta de trabalho.
Recalcular uma pasta de trabalho
As pastas de trabalho visualizadas em um navegador da web mostram uma fotografia de dados do PI System recuperados com as funções do PI DataLink. O fotografia data o último recálculo da pasta de trabalho do Excel Services. Quando o Excel Services recalcula uma pasta de trabalho, o PI DataLink Server consulta o PI Server e o servidor PI AF para valores atualizados. O Excel Services recalcula uma pasta de trabalho quando você abre a pasta de trabalho em uma página da web, atualiza a página da web após o cache expirar, ou força o recálculo.
Nota:
Começando com o PI DataLink Server 2014, o Excel Services trata todas as funções do PI DataLink como funções voláteis. As configurações para o local de arquivo confiável que armazena o controle da planilha, quanto tempo o Excel Services armazena em cache de saída de uma função do PI DataLink antes de atualizar a página após a atualização. Consulte a descrição do comportamento de cálculo na documentação da
MicrosoftGerenciar o Excel Services de arquivos confiáveis locais (http://
technet.microsoft.com/en-us/library/cc263009.aspx). Por padrão, o tempo de vida do cache é de 300 segundos.
Procedimento
• Abra uma pasta de trabalho em uma página da web.
• Atualize uma página da web após o cache do Excel Services expirar. • Clique em Dados > Calcular pasta de trabalho para forçar o novo cálculo.
Parâmetros em pastas de trabalho
Com pastas de trabalho configuradas de forma adequada, as planilhas que o SharePoint processa em um navegador tem um painel de Parâmetros, em que é possível inserir valores de parâmetros. Quando você clica em Aplicar, o SharePoint atualiza os valores da célula na planilha e, se quaisquer funções do PI DataLink fizer referência às células atualizadas, o PI DataLink Server recupera os valores da função atualizada.
As configurações para o local de arquivo confiável que armazena a planilha podem afetar o comportamento de cálculo e o modo de cálculo da pasta de trabalho. Para obter informações adicionais, consulte a documentação da Microsoft Gerenciar o Excel Services de arquivos confiáveis locais (http://technet.microsoft.com/en-us/library/cc263009.aspx).
Para pastas de trabalho em uma web part Excel Web Access (em vez do Excel Web App), é possível que uma conexão web part envie um parâmetro de pasta de trabalho, como um nome ponto do PI, componente de intervalo de tempo ou contexto de módulo. Os são os mesmo que os inseridos pelo painel Parâmetros (o valor é atualizado em uma célula correspondente e a pasta de trabalho é recalculada).
Pastas de trabalho abertas no Excel do SharePoint
Se você possuir o Excel instalado em sua estação de trabalho do cliente e você tem aspermissões do SharePoint apropriadas, é possível abrir uma pasta de trabalho do SharePoint no Excel, e, em seguida, editar ou visualizar a pasta de trabalho. Dependendo se você deseja editar as funções, você pode abrir a pasta de trabalho no Excel ou você pode abrir uma fotografia no Excel.
Para obter informações adicionais, consulte a documentação da Microsoft Abrir uma pasta de trabalho ou fotografia no Excel do Excel Services (http://office.microsoft.com/en-us/
sharepointserver/HA101054711033.aspx). O uso de pastas de trabalho com o PI DataLink Server
Procedimento
• Para abrir uma pasta de trabalho no Excel: Clique em Abrir > Abrir no Excel.
O Excel preserva todas as funções do PI DataLink. Você pode visualizar e editar a planilha. • Para abrir uma fotografia no Excel:
Clique em Abrir > Abrir uma Fotografia no Excel.
O Excel preserva apenas a camada de dados de exibição (os valores e formatação), removendo quaisquer funções do PI DataLink.
Proteção da pasta de trabalho
Muitas vezes, é necessário proteger a propriedade intelectual em pastas de trabalho, especialmente com algumas configurações de extranet. Para proteger as pastas de trabalho, você pode permitir que os usuários internos abram uma pasta de trabalho ou fotografia, mas permita que usuários externos para abram apenas uma fotografia. Tais permissões podem proteger a fonte (ou seja, conexões de dados, fórmulas, e assim por diante) da pasta de trabalho.
Autenticação do Kerberos para o PI DataLink
Server
A autenticação do Kerberos permite que o PI DataLink Server represente o usuário logado acessando o navegador da web. A autenticação do Kerberos é exigida para limitar o acesso à planilha de dados com base na identidade da conta de logon usando o navegador da web. Para dar suporte à autenticação do Kerberos, você deve configurar a delegação do Kerberos para passar as credenciais do cliente do PI DataLink Server para o PI Server e o servidor PI AF. O procedimento depende se você tem o SharePoint em uma configuração de farm ou em uma configuração autônoma. Para mais detalhes sobre a autenticação do Kerberos, consulte estes artigos da Microsoft:
• Planejar a autenticação do Kerberos no SharePoint 2013 (http://technet.microsoft.com/en-us/library/ee806870.aspx)
• Planeje a autenticação do Kerberos (SharePoint Foundation 2010) (http:// technet.microsoft.com/en-us/library/ff607695.aspx)
Nesta seção
• Configure a delegação do Kerberos para o SharePoint em uma configuração do farm
Quando o PI DataLink Server executa no SharePoint em uma configuração do farm, siga estes passos para passar as credenciais do cliente do Excel Services para o PI Server e o servidor PI AF.
• Configure a delegação do Kerberos para o SharePoint em uma configuração independente do farm
Quando o PI DataLink Server for executado no SharePoint em uma configuração
independente, siga estes passos para passar as credenciais do cliente do Excel Services para o PI Server e o servidor PI AF.
• Verifique a autenticação do Kerberos no PI Server
Para verificar a configuração adequada da delegação do Kerberos para o PI DataLink Server, configure um mapeamento do PI para um usuário de teste, acesse uma planilha usando o PI DataLink Server, e examine o registro de mensagens do PI.
Configure a delegação do Kerberos para o SharePoint em
uma configuração do farm
Para o PI DataLink Server representar o usuário logado acessando o navegador da web, você deve configurar a delegação do Kerberos para passar as credenciais do cliente do Excel
Services para o PI Server e o servidor PI AF. Quando o SharePoint está em uma configuração do farm, o Excel Services exige que as Reivindicações para o Serviço de Token do Windows estejam em execução.
Procedimento
1. Para cada computador que executa o Excel Services, configure a conta do computador para delegar o PI Server e o servidor PI AF. Consulte a Configure uma conta de computador para delegar.
2. Adicione a conta de domínio do aplicativo de identidade do grupo do Excel Services para o grupo WSS_WPG do Windows para cada computador que executa o Excel Services. (Consulte a Encontre a identidade do pool do aplicativo do Excel Services.)
O Excel Services precisa ler o acesso aos recursos do sistema usados pelo SharePoint. Em alguns casos, o SharePoint pode já ter adicionado a conta de domínio ao grupo WSS_WPG. 3. Verifique se as reivindicações para o Windows Token Service estão em execução
Este serviço converte pedidos com base em declarações a um token do Windows. O Excel Services precisa desse token para se autenticar com o PI Server e o servidor PI AF. Este serviço deve ser executado na ferramenta administrativa de Serviços no Windows e na Administração Central do SharePoint.
4. Habilite a autenticação do Kerberos para as aplicações da web que processam as planilhas do PI DataLink Server.
Use a Administração Central do SharePoint para habilitar a autenticação do Kerberos para cada aplicativo da web que processa planilhas com PI DataLink Server.
5. Se você não reiniciou o IIS na etapa anterior, então reinicie o IIS em cada servidor do SharePoint e reinicie o PI DataLink Service em cada servidor no qual você instalou PI DataLink Server:
a. Para reiniciar o IIS, digite iisreset em um prompt de comando como um administrador.
b. Para reiniciar o PI DataLink Service, usar a ferramenta administrativa Serviços.
Configure uma conta de computador para delegar
Para o PI DataLink Server usar a autenticação do Kerberos, a conta do computador em cada computador que executa o Excel Services deve permitir a delegação. Um administrador de domínio pode usar o Active Directory para configurar a conta de computador para permitir a delegação. Para oferecer suporte para o PI DataLink Server, a conta deve delegar o PI Server e o servidor PI AF.
Antes de Iniciar
Faça login como um administrador de domínio.
Procedimento
1. Em Usuários e Computadores do Active Directory, expanda o seu domínio e clique em Computadores.
2. Na lista da conta, clique com o botão direito do mouse na conta do computador e clique em Propriedades.
3. Na guia Delegação, habilite a delegação para o PI Server e o servidor PI AF:
a. Selecione Confiar neste usuário para delegação apenas a serviços especificados e Usar qualquer protocolo de autenticação.
b. Na tabela Serviços para os quais a conta pode apresentar credenciais delegadas, adicione o serviço PIServer para o computador PI Server e o serviço AFServer para o
computador de servidor PI AF.
Adicione o serviço para cada PI Server ou servidor PI AF que o PI DataLink Server se conecta.
4. Clique em OK.
Encontre a identidade do pool do aplicativo do Excel Services
Use a Administração Central do SharePoint para encontrar a identidade do pool do aplicativo do Excel Services.
Procedimento
1. No painel de navegação Administração Central da Administração Central do SharePoint, clique em Segurança.
2. Na página Segurança, sob General Security, clique em Configurar contas de serviço. 3. Na página Contas de Serviço, a partir da lista Gerenciamento de Credenciais selecione
Serviço de Pool de Aplicativos - Padrão do SharePoint Web Services.
A lista de contas impactadas deve conter o Aplicativo de Serviços do Excel (Aplicativo do Excel Services, Aplicação de Serviço da Web). A lista Selecionar uma conta para este componente mostra a identidade do pool de aplicativos do Excel Services.
Habilite a autenticação do Kerberos para as aplicações da web que
processam as planilhas do PI DataLink Server
Para usar a autenticação do Kerberos, cada aplicação da web deve ter a autenticação do Kerberos habilitada. Use a Administração Central do SharePoint para habilitar a autenticação do Kerberos para cada aplicativo da web que processa planilhas com PI DataLink Server.
Dica:
Este procedimento requer que você reinicie o IIS. Portanto, faça este procedimento em um horário conveniente para reiniciar o IIS.
Procedimento
1. No painel de navegação Administração central da Administração Central do SharePoint, clique em Gerenciamento de aplicativos.
2. Na página Gerenciamento de aplicativos em Aplicativos da Web, clique em Gerenciar aplicativos da Web.
3. Para cada aplicação da web que processa as planilhas com o PI DataLink Server, habilite a autenticação do Kerberos:
a. A partir da lista de aplicações da web, selecione o aplicativo.
b. Na guia Aplicativos da Web, no grupo Segurança clique em Provedores de Autenticação. c. Na janela Provedores de Autenticação, clique em Padrão.
d. Na janela Edit Authentication, na área Tipos de Autenticação de Declarações, selecione a caixa de seleção Ativar a Autenticação do Windows e a caixa de seleção Autenticação Integrada do Windows, e então configure o tipo de autenticação para Negociar (Kerberos).
e. Clique em Salvar.
4. Reinicie o IIS em cada servidor SharePoint, e reinicie o PI DataLink Service em cada servidor no qual você instalou o PI DataLink Server:
a. Para reiniciar o IIS, digite iisreset em um prompt de comando como um administrador.
b. Para reiniciar o PI DataLink Service, usar a ferramenta administrativa Serviços.
Configure a delegação do Kerberos para o SharePoint em
uma configuração independente do farm
Para o PI DataLink Server representar o usuário logado acessando o navegador da web, você deve configurar a delegação do Kerberos para passar as credenciais do cliente do Excel Services para o PI Server e o servidor PI AF. Quando o SharePoint está em uma configuração independente, a identidade do aplicativo de pool do Excel Services usa a conta local do Serviço de Rede, que pode usar a configuração padrão.
Procedimento
1. Para cada computador que executa o Excel Services, configure a conta do computador para delegar o PI Server e o servidor PI AF. Consulte a Configure uma conta de computador para delegar.
2. Habilite a autenticação do Kerberos para as aplicações da web que processam as planilhas do PI DataLink Server.
Use a Administração Central do SharePoint para habilitar a autenticação do Kerberos para cada aplicativo da web que processa planilhas com PI DataLink Server. O aplicativo da web padrão tem autenticação do Kerberos habilitado por padrão.
3. Se você não reiniciou o IIS na etapa anterior, então reinicie o IIS em cada servidor do SharePoint e reinicie o PI DataLink Service em cada servidor no qual você instalou PI DataLink Server:
a. Para reiniciar o IIS, digite iisreset em um prompt de comando como um administrador.
b. Para reiniciar o PI DataLink Service, usar a ferramenta administrativa Serviços.
Verifique a autenticação do Kerberos no PI Server
Para verificar a configuração adequada da delegação do Kerberos para o PI DataLink Server, verifique se a devida autenticação do PI Server ocorre: crie um mapeamento de PI para uma conta de teste, acesse uma planilha que torna os dados do PI System com PI DataLink Server e, em seguida, verifique se o registro de mensagens do PI mostra a devida autenticação.
Dica:
Este procedimento requer que você reinicie o IIS. Portanto, faça este procedimento em um horário conveniente para reiniciar o IIS.
Procedimento
1. Selecione uma conta de usuário do Windows para a autenticação de teste, tal como mydomain\testuser.
2. No PI Server, crie um mapeamento de PI da conta de usuário do Windows selecionada para uma identidade de PI, como pidemo.
3. Em cada servidor no qual você instalou o PI DataLink Server, reinicie o IIS e o PI DataLink Server:
a. Para reiniciar o IIS, digite iisreset em um prompt de comando como um administrador.
b. Para reiniciar o PI DataLink Service, usar a ferramenta administrativa Serviços. 4. Em uma estação de trabalho do cliente, abra uma planilha que usa o PI DataLink Server: Autenticação do Kerberos para o PI DataLink Server
a. Faça o login usando a conta de usuário selecionada.
b. A partir de um navegador, abra uma Web Part do Excel Access que contém uma função do PI DataLink, tal como a função atual Value.
A planilha mostra os dados do PI System.
5. Verifique se o log de mensagens do PI indica a autenticação do Kerberos para a conta de usuário do Windows selecionada:
a. Abra o PI System Management Tools (PI SMT).
b. No painel Coletivos e Servidores, selecione o PI Server de onde a planilha recuperou dados.
c. No painel Ferramentas de Gerenciamento de Sistema, expanda Operação e clique emLogs de Mensagem.
d. Procure pela mensagem que mostra que a autenticação do Kerberos ocorreu para a conta de usuário do Windows que o navegador foi utilizado.
Successful login ID: 29. Address: 192.168.8.135. Name:
OSIsoft.PIDataLink.Service.exe(1316):remote. Identity List: pidemo | piusers. Environment Username : mydomain\testuser. Method: Windows Login (SSPI,Kerberos)
Suporte técnico e outros recursos
Para obter assistência técnica, contate o suporte técnico OSIsoft em +1 510-297-5828 ou através da página de Suporte Técnico da OSIsoft (https://techsupport.osisoft.com/Contact-Us/). O site do Suporte Técnico da OSIsoft oferece outras opções de contato para clientes de fora dos Estados Unidos.
Ao contatar o Suporte Técnico da OSIsoft, tenha estas informações em mãos: • Nome do produto, números da versão e do build
• Detalhes sobre a plataforma do computador (tipo de CPU, sistema operacional e número da versão)
• Hora em que o problema iniciou • Arquivos de registro do momento
• Detalhes de quaisquer alterações do ambiente antes do início do problema
• Resumo do problema, inclusive todos os arquivos de log relevantes da hora em que o problema ocorreu
O site OSIsoft Virtual Campus (vCampus) (https://vcampus.osisoft.com) tem recursos baseados em assinatura para ajudar na programação e na integração dos produtos da OSIsoft.