Adicionar uma ligação de dados utilizando definições numa biblioteca de ligações

Neste artigo

• Descrição Geral
• Antes de começar
• Adicionar uma ligação de dados de consulta
• Adicionar uma ligação de dados de submissão

Descrição Geral

Se estiver a estruturar vários modelos de formulário que utilizam ligações de dados semelhantes, considere utilizar um ficheiro de ligação de dados em vez de criar uma ligação de dados a uma origem de dados externa para cada modelo de formulário. Desta forma, tem de atualizar apenas um ficheiro de ligação de dados quando as informações de ligação de dados forem alteradas para um conjunto de modelos de formulário relacionados. Por exemplo, quando move os modelos de formulário de uma rede de teste para uma rede de produção, tem de atualizar as definições de ligação de dados apenas uma vez na biblioteca de ligação em vez de atualizar a ligação de dados em cada modelo de formulário. Quando um formulário baseado num modelo de formulário que utiliza um ficheiro de ligação de dados utiliza a ligação de dados, a ligação de dados é atualizada automaticamente com as novas definições.

Um ficheiro de ligação de dados é um ficheiro XML com uma extensão de ficheiro .xml ou .udcx que contém informações de ligação para uma única origem de dados externa. Este ficheiro é armazenado numa biblioteca de ligação de dados num servidor com o Microsoft Office SharePoint Server 2007. Um ficheiro de ligação de dados é criado por um programador ou ao converter uma ligação de dados num modelo de formulário existente num ficheiro de ligação de dados ao clicar no botão Converter na caixa de diálogo Ligações de Dados (menu Ferramentas ).

As vantagens da utilização de ficheiros de ligação de dados incluem:

• Vários formulários podem utilizar o mesmo ficheiro de ligação de dados, pelo que não é necessário criar a mesma ligação de dados do zero para cada modelo de formulário.
• Se as definições de localização ou ligação de uma origem de dados externa forem alteradas, terá de atualizar apenas o ficheiro de ligação de dados e não cada modelo de formulário.
• O ficheiro de ligação de dados pode conter informações de autenticação alternativas que podem ser utilizadas pelo servidor quando um utilizador preenche um formulário através de um browser.
• Os formulários baseados num modelo de formulário compatível com o browser que são preenchidos num browser podem ligar-se a servidores noutro domínio apenas com ligações de dados que utilizam ficheiros de ligação de dados.

Quando adiciona uma ligação de dados a um modelo de formulário através das definições numa biblioteca de ligação de dados, cria uma ligação de dados secundária nesse modelo de formulário. Esta ligação de dados é diferente da ligação de dados principal que é criada quando cria um modelo de formulário com base numa base de dados, num serviço Web ou em definições numa biblioteca de ligação de dados. Só adicionaria uma ligação de dados secundária se não conseguir obter ou enviar dados através da ligação de dados principal.

Início da Página

Antes de começar

Para adicionar uma ligação de dados ao modelo de formulário com as definições armazenadas numa biblioteca de ligação de dados, precisa das seguintes informações do administrador do site:

• A localização do servidor que está a executar o Microsoft Office SharePoint Server 2007, que contém o site que inclui a biblioteca de ligação de dados
• O nome do ficheiro de ligação de dados na biblioteca de ligação de dados que pretende utilizar
• Se o ficheiro de ligação de dados contém definições para uma ligação de dados de consulta ou uma ligação de dados de submissão
• Se pode configurar o modelo de formulário para armazenar em segurança os resultados da consulta no formulário para utilização offline se as definições forem para uma ligação de dados de consulta

Início da Página

Adicionar uma ligação de dados de consulta

Para adicionar uma ligação de dados ao modelo de formulário através das definições numa biblioteca de ligação, tem de concluir os seguintes procedimentos:

1. Adicione a ligação de dados secundária ao modelo de formulário.
2. Vincular controlos à consulta e aos campos de dados na origem de dados secundária.
3. Configure o modelo de formulário para utilizar a ligação de dados com uma regra ou botão.

Passo 1: Adicionar uma ligação de dados secundária

1. No menu Ferramentas , clique em Ligações de Dados.

2. Na caixa de diálogo Ligações de Dados , clique em Adicionar.

3. No Assistente de Ligação de Dados, clique em Procurar ligações num Microsoft Office SharePoint Server e, em seguida, clique em Seguinte.

4. Na página seguinte do assistente, na lista Site , clique no nome do site num servidor com o Office SharePoint Server 2007 com a biblioteca de ligação.
   O meu site não está na lista
   Para adicionar o seu site à lista, faça o seguinte:

   1. Clique em Gerir Sites.
   2. Na caixa de diálogo Gerir Sites , clique em Adicionar.
   3. Na caixa URL , escreva a localização da biblioteca de ligação de dados.
   4. Na caixa Nome a apresentar, escreva um nome para a biblioteca de ligação de dados. Este nome será apresentado na lista Site no Assistente de Ligação de Dados.
   5. Clique em OK.
   6. Clique em Fechar.

5. Clique no nome da biblioteca de ligação de dados para ver uma lista de ficheiros de ligação de dados, clique no nome do ficheiro de ligação de dados que pretende utilizar para esta ligação de dados e, em seguida, clique em Seguinte.

6. Consoante as definições de ligação no ficheiro de ligação de dados, a página seguinte do assistente poderá pedir-lhe para especificar valores de exemplo para cada parâmetro.
   Como especificar valores de exemplo?

   1. Selecione um parâmetro na tabela Parâmetros e, em seguida, clique em Definir Valor de Exemplo.
   2. Na caixa Valor de exemplo , escreva um valor que o utilizador possa utilizar para este campo e, em seguida, clique em OK.
   3. Repita estes passos para cada parâmetro na tabela Parâmetros e, em seguida, clique em Seguinte.

   Nota Técnica
   Quando configura uma ligação de dados a um serviço Web no Assistente de Ligação de Dados, o Microsoft Office InfoPath liga-se ao serviço Web e pede o ficheiro WSDL (Web Service Description Language). O ficheiro WSDL contém o esquema utilizado pelo serviço Web. O serviço Web responde ao pedido ao enviar este ficheiro para o InfoPath. O InfoPath utiliza as informações neste ficheiro para adicionar os campos e grupos adequados à origem de dados secundária no modelo de formulário. Se o InfoPath encontrar um tipo de elemento desconhecido no ficheiro WSDL, o InfoPath utiliza dados de exemplo para determinar a definição do tipo de elemento desconhecido e, em seguida, adiciona os campos e grupos adequados à origem de dados secundária.

7. Se quiser que os resultados da consulta estejam disponíveis quando o formulário não estiver ligado a uma rede, selecione a caixa de verificação Armazenar uma cópia dos dados no modelo de formulário .

   Nota

   Selecionar esta caixa de verificação armazena os resultados da consulta no modelo de formulário. Uma vez que os dados são armazenados no modelo de formulário, estão disponíveis nos formulários que os utilizadores preenchem, mesmo que os respetivos computadores não estejam ligados a uma rede. Se estiver a obter dados confidenciais desta ligação de dados, poderá querer desativar esta funcionalidade para ajudar a proteger os dados caso o computador seja perdido ou roubado.

8. Clique em Seguinte.
   A página seguinte do assistente apresentará um resumo das definições para esta ligação de dados.

9. Escreva um nome descritivo para a ligação de dados. Este nome será apresentado na lista Origem de Dados no painel de tarefas Origem de Dados .

10. Para ativar formulários baseados neste modelo de formulário para utilizar esta ligação de dados quando estes são abertos, selecione a caixa de verificação Obter dados automaticamente quando o formulário é aberto .

Início da Página

Passo 2: adicionar um controlo para apresentar os dados aos seus utilizadores

1. Se o painel de tarefas Controlos não estiver visível, clique em Mais Controlos no menu Inserir ou prima ALT+I, C
2. Arraste um controlo para o modelo de formulário.
3. Na caixa de diálogo Enlace de Controlo , selecione o campo ao qual pretende vincular o controlo e, em seguida, clique em OK.

Passo 3: Configurar o modelo de formulário para utilizar a ligação de dados

Se pretender que os utilizadores obtenham dados desta ligação de dados após a abertura do formulário, pode adicionar uma regra ao modelo de formulário que utiliza a ligação de dados sob uma determinada condição ou pode adicionar um botão ao modelo de formulário no qual os seus utilizadores podem clicar para utilizar a ligação de dados.

Adicionar uma regra

Pode adicionar uma regra ao modelo de formulário que executa a ligação de dados de consulta sempre que a condição da regra for cumprida. O procedimento seguinte pressupõe que criou uma ligação de dados de consulta para o modelo de formulário e que configurou um controlo no modelo de formulário para apresentar os dados da ligação de dados.

1. Se o modelo de formulário tiver múltiplas vistas, clique em Ver nome no menu Ver para aceder à vista com o controlo onde pretende apresentar os dados da origem de dados secundária.
2. Faça duplo clique no controlo ao qual pretende adicionar uma regra.
3. Clique no separador Dados.
4. Em Validação e Regras, clique em Regras.
5. Na caixa de diálogo Regras , clique em Adicionar.
6. Na caixa Nome , escreva um nome para a regra.
7. Para especificar uma condição quando a regra deve ser executada, clique em Definir Condição e, em seguida, introduza a condição. A regra será executada quando a condição ocorrer. Se não definir uma condição, a regra será executada sempre que o utilizador alterar o valor no controlo e, em seguida, afastar o cursor desse controlo.
8. Clique em Adicionar Ação.
9. Na lista Ação , clique em Consulta com uma ligação de dados.
10. Na lista Ligação de dados , clique na ligação de dados de consulta que pretende utilizar e, em seguida, clique em OK para fechar cada caixa de diálogo.
11. Para testar as suas alterações, clique em Pré-visualizar na barra de ferramentas Padrão ou prima CTRL+SHIFT+B.

Adicionar um botão para utilizar a ligação de dados de consulta

Pode adicionar um controlo de botão ao modelo de formulário no qual os seus utilizadores podem clicar quando preencherem um formulário com base no modelo de formulário. Quando clicado, este botão pode obter dados da ligação de dados de consulta.

1. Se o modelo de formulário tiver múltiplas vistas, clique em Ver nome no menu Ver para aceder à vista com o controlo onde pretende apresentar os dados da origem de dados secundária.
2. Se o painel de tarefas Controlos não estiver visível, clique em Mais Controlos no menu Inserir ou prima ALT+I, C
3. Arraste um controlo de botão para o modelo de formulário.
4. Faça duplo clique no controlo de botão que acabou de adicionar ao modelo de formulário.
5. Clique no separador Geral.
6. Na lista Ação , clique em Atualizar.
7. Na caixa Etiqueta , escreva o nome que pretende que seja apresentado no botão do modelo de formulário.
8. Clique em Definições.
9. Na caixa de diálogo Atualizar , clique em Uma origem de dados secundária.
10. Na lista Escolher a origem de dados secundária , clique na origem de dados secundária associada à ligação de dados de consulta.
11. Clique em OK para fechar cada caixa de diálogo aberta.
12. Para testar as suas alterações, clique em Pré-visualizar na barra de ferramentas Padrão ou prima CTRL+SHIFT+B.

Início da Página

Adicionar uma ligação de dados de submissão

Se o ficheiro de ligação de dados contiver definições para uma ligação de dados de submissão, pode configurar o modelo de formulário para permitir que os utilizadores submetam os respetivos dados de formulário através desta ligação de dados. Quando configura o modelo de formulário para permitir que os utilizadores submetam os respetivos dados de formulário, o InfoPath adiciona um botão Submeter na barra de ferramentas Padrão e um comando Submeter no menu Ficheiro . Pode configurar as opções de submissão para o modelo de formulário na caixa de diálogo Opções de Submissão (menu Ferramentas ). As opções de submissão são configuradas da mesma forma que se tiver adicionado uma ligação de dados secundária que seja uma ligação de dados de submissão. Encontre ligações para obter mais informações sobre como adicionar uma ligação de dados de submissão ao modelo de formulário na secção Consulte Também .

1. No menu Ferramentas , clique em Ligações de Dados.

2. Na caixa de diálogo Ligações de Dados , clique em Adicionar.

3. No Assistente de Ligação de Dados, clique em Procurar ligações num Microsoft Office SharePoint Server e, em seguida, clique em Seguinte.

4. Na página seguinte do assistente, na lista Site , clique no nome do site com a biblioteca de ligação.
   O meu site não está na lista
   Para adicionar o seu site à lista, faça o seguinte:

   1. Clique em Gerir Sites.
   2. Na caixa de diálogo Gerir Sites , clique em Adicionar.
   3. Na caixa URL , escreva a localização da biblioteca de ligação de dados.
   4. Na caixa Nome a apresentar, escreva um nome para a biblioteca de ligação de dados. Este nome será apresentado na lista Site no Assistente de Ligação de Dados.
   5. Clique em OK.
   6. Clique em Fechar.

5. Clique no nome da biblioteca de ligação de dados para ver uma lista de ficheiros de ligação de dados, clique no nome do ficheiro de ligação de dados que pretende utilizar para esta ligação de dados de submissão e, em seguida, clique em Seguinte.

6. Se as definições forem para submeter uma ligação de dados a um serviço Web, o InfoPath pode detetar que parâmetros no serviço Web podem receber dados. Pode configurar a ligação submeter dados para enviar todos os dados ou parte dos dados no modelo de formulário.
   Como posso fazê-lo?

   1. Na lista Parâmetros , clique num parâmetro que irá receber os dados do formulário.

   2. Para submeter todos os dados no formulário para este parâmetro, incluindo o elemento raiz e quaisquer instruções de processamento, faça o seguinte:

      1. Clique em Formulário completo (documento XML, incluindo instruções de processamento).
      2. Para submeter os dados como uma cadeia, selecione a caixa de verificação Submeter dados como uma cadeia . Normalmente, seleciona esta caixa de verificação para submeter dados assinados digitalmente. Na maioria dos casos, desmarque esta caixa de verificação.

   3. Para especificar um campo ou grupo para este parâmetro, faça o seguinte:

      1. Em Opções de parâmetros, clique em Campo ou grupo.
      2. Clique em Modificar .
      3. Na caixa de diálogo Selecionar um Campo ou Grupo , clique no campo ou grupo cujos dados pretende submeter e, em seguida, clique em OK.
      4. Na lista Incluir , clique em Texto e elementos subordinados apenas para submeter apenas o conteúdo do campo ou grupo ou clique em subárvore XML, incluindo o elemento selecionado para submeter o conteúdo e o grupo ou campo selecionado.

   4. Repita estes passos para cada parâmetro.

7. Clique em Seguinte.

8. Na página seguinte do assistente, na caixa Introduzir um nome para esta ligação de dados , escreva um nome descritivo para esta ligação de dados de submissão.

Início da Página