Gerenciar arquivos de conexão de dados para o InfoPath Forms Services (SharePoint Server 2010)

  • Artigo

 

Aplica-se a: SharePoint Server 2010

Tópico modificado em: 2016-11-30

Os formulários que usam o InfoPath Forms Services no Microsoft SharePoint Server 2010 podem usar arquivos de conexão de dados para especificar configurações para a conexão com fontes de dados. Os arquivos de conexão de dados são criados e publicados em bibliotecas de conexão de dados pelo designer de formulários usando o Microsoft InfoPath 2010.

Uma conexão de dados é um link dinâmico entre um modelo de formulário e uma fonte de dados que armazena ou fornece dados para o modelo de formulário. A conexão de dados principal, se houver, define a fonte de dados principal do formulário, que é o esquema XML que determina como os dados são armazenados. A conexão de dados principal é criada automaticamente quando você cria um modelo de formulário de um banco de dados, serviço Web ou ao personalizar o formulário de uma lista do SharePoint. Opcionalmente, o formulário pode ter uma ou mais conexões de dados secundária. Você pode criar quantas conexões de dados secundários desejar ao projetar um modelo de formulário.

Um arquivo de conexão de dados é um arquivo XML com uma extensão de nome de arquivo .xml ou .udcx e que contém informações de conexão para uma única conexão de dados externa. Esse arquivo é armazenado em uma biblioteca de conexão de dados em um servidor que esteja executando o Microsoft SharePoint Server 2010. Um arquivo de conexão de dados é criado por um desenvolvedor usando um programa de edição de XML ou por um designer de formulários do InfoPath ao converter uma conexão de dados em um modelo de formulário existente para um arquivo de conexão de dados no Microsoft InfoPath Designer 2010.

Os arquivos de conexão de dados oferecem uma forma para que administradores gerenciem conexões de dados e definam configurações de conexão sem modificar e republicar modelos de formulário. Os arquivos de conexão de dados também são usados para especificar credenciais de autenticação específicas do servidor usando o serviço de Repositório Seguro.

Os arquivos de conexão de dados podem ser armazenados no mesmo conjunto de sites do modelo de formulário ou em uma biblioteca de conexões de dados gerenciadas no site da Administração Central. Os arquivos de conexão de dados armazenados em conjuntos de sites individuais podem ser usados por formulários nesse conjunto de sites. Os arquivos de conexão de dados para modelos de formulário aprovados pelo administrador são armazenados em uma biblioteca de conexões de dados gerenciada de forma centralizada na Administração Central. É possível gerenciar essa biblioteca da página Gerenciar Arquivos de Conexão de Dados ou usando o Windows PowerShell. Os arquivos de conexão de dados dessa biblioteca podem ser usados por modelos de formulários aprovados pelo administrador. Por padrão, os arquivos de conexão de dados dessa biblioteca só poderão ser usados por formulários de navegador da Web, embora os administradores do farm possam optar por permitir o acesso HTTP a clientes como o Microsoft InfoPath Filler 2010.

Os arquivos de conexão de dados podem permitir conexões entre servidores ou fora do farm. Isso pode incluir configurações para que o serviço de Repositório Seguro ofereça credenciais alternativas para a conexão.

Neste artigo:

  • Tipos de conexões de dados

  • Criar um arquivo de conexão de dados

  • Gerenciar arquivos de conexão de dados na Administração Central

Tipos de conexões de dados

O InfoPath Forms Services no SharePoint Server 2010 oferece vários tipos diferentes de conexões de dados. As conexões de dados podem ser usadas para consultar ou enviar dados.

Conexões de dados de consulta

As conexões de dados de consulta são usadas para consultar dados de sistemas externos a serem usados no preenchimento de um formulário. Elas incluem o seguinte:

  • Banco de dados

  • Lista do SharePoint

  • Serviço Web SOAP

  • Serviço Web REST (Representational State Transfer)

  • Arquivo XML

Conexão de dados Banco de Dados

A conexão de dados Banco de Dados pesquisa as informações de um banco de dados para preencher campos do formulário. É possível usar essa conexão para pesquisar dados no Microsoft SQL Server. Para se conectar a um banco de dados que não seja um banco de dados do SQL Server, use uma conexão de serviço Web. A conexão de dados Banco de Dados só pode ser usada para consulta e não pode ser usada para enviar dados para um banco de dados. Se quiser usar um formulário para enviar dados a um banco de dados, use a conexão de dados do serviço Web SOAP.

Conexão de dados Lista do SharePoint

A conexão de dados de lista do SharePoint é uma conexão somente consulta usada para preencher campos de formulário do InfoPath de uma biblioteca ou lista do SharePoint existente.

Conexão de dados do serviço Web SOAP

A conexão de dados do serviço Web SOAP pode consultar dados de um serviço Web SOAP 1.1 e usar os dados retornados para atualizar campos do formulário de origem. Para consultar dados usando um serviço Web REST, use a conexão de dados do serviço Web REST.

Conexão de dados do serviço Web REST

A conexão de dados do serviço Web REST é uma novidade do InfoPath 2010 e do InfoPath Forms Services no SharePoint Server 2010. Os designers de formulários podem usar uma regra para adicionar parâmetros dinâmicos à URL REST quando o formulário é preenchido.

Conexão de dados de arquivo XML

A conexão de dados de arquivo XML consulta um arquivo XML e usa seus dados para preencher campos do formulário. Esse tipo de conexão pode ser usado para consumo de dados de qualquer URL que retorne dados em formato XML. Os designers de modelos de formulário também podem optar por incluir o arquivo XML no próprio modelo de formulário, reduzindo os problemas de gerenciamento de recursos associados à conexão com um recurso externo.

Conexões de dados de envio

As conexões de dados de envio enviam dados de formulário como XML para sistemas externos. Elas incluem o seguinte:

  • Enviar para biblioteca do SharePoint

  • Enviar para email

  • Enviar para serviço Web SOAP

  • Enviar usando POST HTTP

  • Enviar para ambiente de hospedagem

Conexão de dados Enviar para biblioteca do SharePoint

A conexão de dados Enviar para biblioteca do SharePoint permite que formulários sejam publicados diretamente em uma biblioteca de documentos do SharePoint. Essa conexão envia o formulário inteiro para a biblioteca como um documento XML.

Conexão de dados Enviar para email

A conexão de dados Enviar para email usa o adaptador de email SMTP para enviar dados de formulário para um endereço de email. As configurações da conexão de dados especificam se todo o conteúdo do formulário será enviado como um anexo ou se o modo de exibição de formulário atual será enviado como o corpo da mensagem de email.

Conexão de dados Enviar para serviço Web SOAP

A conexão de dados Enviar para serviço Web SOAP pode enviar dados XML de um formulário para um serviço Web SOAP. O formulário ignora quaisquer dados retornados de um envio de serviço Web que não sejam códigos de erro.

Essa conexão pode ser usada para enviar todos os dados do formulário ou parte deles como uma mensagem SOAP.

Conexão de dados Enviar usando POST HTTP

A conexão de dados Enviar usando POST HTTP permite que um formulário do InfoPath publique dados em um servidor de aplicativos usando um POST HTTP. Essa conexão envia o formulário inteiro como um documento XML.

Conexão de dados Enviar para ambiente de hospedagem

A conexão de dados Enviar para ambiente de hospedagem envia um evento de envio para o host. Assim, o host fica responsável pela manipulação desse evento e pela recuperação dos dados do formulário.

Criar um arquivo de conexão de dados

Os designers de formulários criam conexões de dados ao projetar modelos de formulário. As configurações de conexão de dados podem ser armazenadas separadamente do modelo de formulário em arquivos de conexão de dados em uma biblioteca de conexões de dados.

Os arquivos de conexão de dados são usados para os seguintes cenários:

  • Reutilização de configurações de conexão de dados para vários modelos de formulário

  • Modificação de configurações de conexão de dados após a publicação de modelos de formulário publicados sem a necessidade de republicar cada modelo de formulário.

  • Oferecimento de credenciais de autenticação específicas do servidor.

Para criar conexões de dados entre domínios de um um formulário de navegador da Web, as configurações de conexão de dados deverão ser armazenadas em um arquivo de conexão de dados em uma biblioteca de conexões de dados. Por padrão, os arquivos em uma biblioteca de conexões de dados devem ser aprovados antes que possam ser usados, por meio do recurso de aprovação de conteúdo do SharePoint Server 2010.

Para criar um arquivo de conexões de dados, execute os seguintes procedimentos:

  1. Criar uma biblioteca de conexões de dados para armazenar conexões de dados.

  2. Criar um modelo de formulário.

  3. Adicionar a conexão de dados pretendida ao modelo de formulário.

  4. Converter a conexão de dados em um arquivo de conexão de dados.

Para obter mais informações sobre como criar uma biblioteca de conexões de dados, consulte o artigo sobre como criar e usar uma biblioteca de conexões de dados (https://go.microsoft.com/fwlink/?linkid=188117&clcid=0x416).

Para obter informações sobre como criar um modelo de formulário e como adicionar uma conexão de dados a um modelo de formulário, consulte a Ajuda e artigos explicativos do InfoPath (https://go.microsoft.com/fwlink/?linkid=188118&clcid=0x416).

Para converter uma conexão de dados em um arquivo de conexão de dados

  1. Verifique se a conta de usuário que está executando este procedimento é membro do grupo Membros do Site do SharePoint ou de qualquer outro grupo com a permissão Adicionar Itens.

  2. No InfoPath Designer 2010, abra o modelo de formulário com a conexão de dados que você deseja converter.

  3. Na guia Dados, no grupo Obter Dados Externos, clique em Conexões de Dados.

  4. Na caixa de diálogo Conexões de Dados, em Conexões de dados para o modelo de formulário, clique na conexão de dados que deseja converter.

  5. Clique em Converter para Arquivo de Conexão.

  6. Na caixa de diálogo Converter Conexão de Dados, em Especifique a URL do novo arquivo de conexão de dados, digite a URL que especifica o local da biblioteca de conexões de dados e o nome do arquivo da conexão de dados

    Observação

    A URL deve ter o formato http://servidor/nomedabibliotecadeconexõesdedados/nomedoarquivo.udcx. Você também pode navegar até a biblioteca e o nome do arquivo será sugerido com base no nome da conexão de dados.

  7. Em Tipo de link da conexão, selecione uma das seguintes opções:

    • Para vincular a um arquivo de conexão de dados no mesmo conjunto de sites, clique em Relativo a um conjunto de sites.

      Observação

      Essa é a opção recomendada para a maioria dos casos. A segunda opção é para conexões de dados usadas por modelos aprovados pelo administrador que não são publicadas diretamente mas carregadas por um administrador do farm.

    • Para carregar o arquivo de conexão de dados para a biblioteca na Administração Central, clique em Biblioteca de conexões gerenciada centralmente.

      Observação

      Essa opção só será usada em cenários avançados que usam modelos de formulário aprovados pelo administrador. Para que funcione, o administrador do farm deverá copiar e carregar o arquivo de conexão de dados na biblioteca de conexões de dados gerenciada de forma centralizada na Administração Central. Para obter mais informações, consulte a seção "Gerenciar arquivos de conexão de dados na Administração Central" posteriormente neste artigo.

  8. Clique em OK.

  9. Na caixa de diálogo Conexões de Dados , clique em Fechar.

Gerenciar arquivos de conexão de dados na Administração Central

Os administradores do farm carregam arquivos de conexão de dados na biblioteca Gerenciar arquivos de conexão de dados na Administração Central. Esses arquivos de conexão de dados podem ser usados por qualquer modelo de formulário carregado na página Gerenciar Modelos de Formulário da Administração Central. Os administradores do farm também podem executar as seguintes tarefas para arquivos de conexão de dados:

  • Organizar arquivos de conexão de dados em categorias.

  • Permitir o acesso HTTP a clientes como o InfoPath Filler.

  • Alterar o nome para exibição e a descrição.

  • Excluir arquivos de conexão de dados que não sejam mais necessários.

Verifique se a conta de usuário que está executando os procedimentos a seguir é membro do grupo Administradores de Farm do SharePoint.

Para carregar um arquivo de conexão de dados

  1. No site da Administração Central, no Início Rápido, clique em Configurações Gerais de Aplicativos.

  2. Na página Configurações Gerais de Aplicativos, na seção InfoPath Forms Services, clique em Gerenciar arquivos de conexão de dados.

  3. Na página Gerenciar Arquivos de Conexão de Dados, clique em Carregar.

  4. Na página Carregar Arquivo de Conexão de Dados, na seção Selecionar Arquivo, digite um local na caixa de texto Nome do arquivo.

    Você também pode navegar até o local.

    Para carregar uma cópia de um arquivo de conexão de dados armazenado em uma biblioteca de conexões de dados, navegue até a biblioteca de conexões de dados, clique no nome do arquivo de conexão de dados nessa biblioteca e clique em Salvar na caixa de diálogo Escolher Arquivo a Carregar.

  5. Na seção Categoria, especifique uma categoria para o arquivo.

    O nome da categoria é arbitrário e não precisa corresponder a qualquer esquema formal. Os arquivos com o mesmo nome de categoria serão agrupados.

  6. Na seção Acessibilidade da Web, você pode clicar em Permitir acesso HTTP a este arquivo para permitir que clientes como o InfoPath Filler acessem o arquivo de conexão de dados por HTTP.

  7. Clique em Carregar .

Para especificar uma categoria para um arquivo de conexão de dados

  1. Na página Gerenciar Arquivos de Conexão de Dados, clique no nome do arquivo de conexão de dados e clique em Editar Propriedades.

  2. Na seção Categoria, digite um nome de categoria para o arquivo de conexão de dados.

  3. Para exibir os arquivos de conexão de dados agrupados por categoria, em Modos de Exibição de Lista, clique em Por categoria.

Por padrão, os arquivos armazenados na biblioteca de conexões de dados gerenciada de forma centralizada só poderão ser acessados por administradores do farm e só poderão ser usados por modelos de formulário aprovados pelo administrador. Os outros usuários não poderão ler ou baixar esses arquivos. Para permitir que esses arquivos sejam baixados para computadores cliente, eles devem poder ser acessados por HTTP. Se essa configuração estiver habilitada, qualquer usuário com permissão para exibir um formulário que use um desses arquivos poderá baixar e exibir o conteúdo do arquivo.

Para permitir acesso HTTP a um arquivo de conexão de dados

  1. Na página Gerenciar Arquivos de Conexão de Dados, clique no nome do arquivo de conexão de dados e clique em Editar Propriedades.

  2. na seção Acessibilidade da Web, clique em Permitir acesso HTTP a este arquivo para permitir que clientes como o InfoPath Filler acessem o arquivo de conexão de dados por HTTP.

Para excluir uma biblioteca de conexões de dados

  1. Na página Gerenciar Arquivos de Conexão de Dados, clique no nome do arquivo de conexão de dados e clique em Excluir.

  2. Na página Excluir Arquivo de Conexão de Dados, clique em Excluir.