Introdução às fontes de dados

Neste artigo

• Visão geral das fontes de dados
• Fonte de dados principal
• Fontes de dados secundárias
• Noções básicas sobre o relacionamento entre uma fonte de dados e um esquema XML

Visão geral das fontes de dados

Todos os dados que aparecem em um formulário, sejam dados que um usuário pode selecionar em uma caixa de listagem, caixa de listagem suspensa ou caixa de combinação, ou os dados que um usuário adiciona a um formulário, são armazenados nas fontes de dados do formulário. Uma fonte de dados é composta de campos e grupos. Da mesma forma que as pastas no disco rígido contêm e organizam os arquivos, os campos contêm os dados que os usuários inserem em formulários com base em seu modelo de formulário e os grupos contêm e organizam esses campos. O usuário adiciona dados aos controles em um formulário e esses controles são associados a esses campos. Por exemplo, imagine que você está criando um modelo de formulário para um relatório de despesas. Quando os usuários abrem um formulário com base em seu modelo de formulário, eles podem colocar seu nome, nome do meio e sobrenome em três controles de caixa de texto — cada caixa de texto é associada a um campo para o nome, um campo para o nome do meio e um campo para o sobrenome. Esses campos de nome estão contidos em um grupo chamado "nome".

Você pode ver e trabalhar com os campos e grupos na fonte de dados do modelo de formulário no painel de tarefas Fonte de Dados .

1. Campo

2. Grupo

Embora a estrutura da fonte de dados nem sempre corresponda ao layout do seu modelo de formulário, as semelhanças são comuns, especialmente para grupos e campos associados a tabelas de repetição, seções, seções de repetição e seções opcionais. Por exemplo, uma tabela ou seção é associada a um grupo na fonte de dados, e todos os controles na tabela ou seção são associados a campos que fazem parte desse grupo. Na ilustração a seguir, a tabela de repetição Despesas Detalhadas no formulário relatório de despesas consiste em três colunas que contêm um seletor de data Data, uma caixa de texto Descrição e uma caixa de texto Custo. Esses controles são associados a um campo de data, um campo de descrição e um campo de valor, respectivamente. A tabela em si é associada ao grupo de itens.

Um modelo de formulário pode ter dois tipos de fontes de dados: uma única fonte de dados principal e, opcionalmente, uma ou mais fontes de dados secundárias.

Início da Página

Fonte de dados principal

A fonte de dados principal contém o seguinte:

• Os dados que os usuários adicionam ao preencher um formulário com base no modelo de formulário, como os dados que inserem em uma caixa de texto. Por exemplo, o usuário digita seu nome, nome do meio e sobrenome em caixas de texto que são associadas a campos na fonte de dados principal.
• Os dados de uma conexão de dados com um banco de dados ou serviço Web, que é usado para definir a fonte de dados do modelo de formulário.

Os dados na fonte de dados principal são os que os usuários salvam ou enviam quando preenchem o formulário. Quando os usuários salvam o formulário para poder enviá-lo mais tarde, eles salvam os dados na fonte de dados principal.

Criando a fonte de dados principal

Quando você cria um modelo de formulário, o Microsoft Office InfoPath cria automaticamente a fonte de dados principal para você. Todos os modelos de formulário do InfoPath contêm uma única fonte de dados principal. Campos e grupos podem ser adicionados à fonte de dados principal, dependendo do tipo de modelo de formulário criado:

Modelo de formulário em branco Você adiciona campos e grupos à fonte de dados principal usando o painel de tarefas Fonte de Dados ou arrastando um controle do painel de tarefas Controles para um modo de exibição no modelo de formulário. Quando você arrasta um controle para um modo de exibição, o InfoPath adiciona campos e grupos à fonte de dados principal de acordo com o tipo de controle que você está adicionando. Por exemplo, se você arrastar um controle de caixa de texto para o modelo de formulário, o InfoPath adicionará um campo à fonte de dados principal. Se você arrastar um controle de seção de repetição para o modelo de formulário, o InfoPath adicionará um grupo à fonte de dados principal. Se você arrastar um controle de tabela de repetição para o modelo de formulário, o InfoPath adicionará dois grupos à fonte de dados principal da tabela de repetição e adicionará um campo à fonte de dados principal para cada coluna da tabela.

Modelo de formulário com base em um documento XML O InfoPath adiciona campos e grupos que são mapeados para os elementos definidos no esquema ou para os elementos no documento.

Modelo de formulário baseado em um banco de dados do Microsoft Office Access ou de um banco de dados do Microsoft SQL Server O InfoPath adiciona campos e grupos à fonte de dados principal, com base na maneira como o banco de dados armazena dados.

Modelo de formulário baseado em um Serviço Web O InfoPath adiciona campos e grupos que são mapeados para o esquema fornecido pelo serviço Web.

Se a fonte de dados — por exemplo, um serviço Web ou banco de dados — não estiver contida no modelo de formulário, ela será chamada de fonte de dados externa. Os formulários do InfoPath se conectam a essas fontes de dados externas por meio de uma conexão de dados.

Modificação da fonte de dados principal

Você pode adicionar campos e grupos adicionais à fonte de dados principal, dependendo dos campos ou grupos existentes na fonte de dados principal. A tabela a seguir descreve o que você pode adicionar a campos ou grupos existentes, com base nos ícones que aparecem no painel de tarefas Fonte de Dados .

Ícone	O que você pode adicionar
	Ícone do grupo Você pode adicionar grupos ou campos a esse grupo. Esse ícone representa um grupo que foi adicionado à fonte de dados principal usando o painel de tarefas Fonte de Dados ou um controle associado a esse grupo que foi arrastado do painel de tarefas Controles para um modo de exibição em um modelo de formulário em branco.
	Ícone de campo Você pode adicionar apenas campos a esse campo. Esse ícone representa um campo que foi adicionado à fonte de dados principal usando o painel de tarefas Fonte de Dados ou um controle associado a esse campo que foi arrastado do painel de tarefas Controles para um modo de exibição em um modelo de formulário em branco.
	Ícone de grupo bloqueado Não é possível adicionar campos ou grupos a esse grupo. Esse grupo é baseado em uma conexão de dados com uma fonte de dados externa.
	Ícone de campo bloqueado Não é possível adicionar campos a esse campo. Este campo é baseado em uma conexão de dados com uma fonte de dados externa.

Se você arrastar um controle para um modo de exibição em um modelo de formulário e esse modelo de formulário contiver campos e grupos baseados em uma conexão de dados, vincule esse controle aos campos e grupos existentes na fonte de dados principal. O InfoPath não adiciona automaticamente campos e grupos a um modelo de formulário que contenha campos e grupos baseados em fontes de dados externas. Encontre links para obter mais informações sobre como adicionar campos e grupos na seção Consulte também .

• Mover, excluir ou renomear um campo ou grupo
• Alterar um campo ou grupo de repetição para um campo ou grupo não repetido
• Alteração de um tipo de dados Rich Text para outro tipo de dados

Para campos e grupos que podem ser modificados, você pode alterar as seguintes propriedades:

Nome O nome do campo ou grupo.

Requisitos de nome

• Cada nome na fonte de dados principal deve ser exclusivo. Se você precisar usar o mesmo nome para mais de um campo ou grupo, crie uma referência para esse campo ou grupo. Quando você cria uma referência a um campo ou grupo, o InfoPath cria um novo campo ou grupo idêntico cujas propriedades estão vinculadas às propriedades do primeiro campo ou grupo. Qualquer alteração em um campo ou grupo atualiza automaticamente o outro campo ou grupo referenciado. Os grupos de referência, assim como os campos de referência, contêm os mesmos campos e grupos e compartilham as mesmas propriedades.
• Nomes não podem conter espaços.
• Os nomes devem começar com um caractere alfabético ou sublinhado (_) e podem conter apenas caracteres alfanuméricos, sublinhados, hifens (-) e pontos (.).

Além desses requisitos, é recomendável usar um nome que descreva o conteúdo do campo ou grupo. Por exemplo, se você tiver um grupo que contenha os detalhes detalhados das despesas, nomeie o grupo como ItemizedExpense. Para um campo em um grupo que contém o valor da despesa, nomeie o campo como despesa.

Tipo Define se um item na fonte de dados principal é um campo ou um grupo. Um campo tem um valor exclusivo e um grupo contém outros campos.

Tipos de campos e grupos

Tipo	Quando usar
Campo (atributo)	Use esse tipo para um campo se uma ou mais das seguintes opções se aplicarem: O campo não pode conter outros grupos ou campos. O campo deve estar em um campo de elemento. O campo não é repetido. O campo deve sempre conter um valor. O campo é qualquer tipo de dado que não seja Rich Text (XHTML). O banco de dados ou o serviço Web requer um campo de atributo.
Campo (elemento)	Use esse tipo para um campo se uma ou mais das seguintes opções se aplicarem: O campo pode conter outros campos de atributo. O campo faz parte de um grupo. O campo é repetido em um grupo. O banco de dados ou serviço Web requer um campo de elemento. Os campos de elemento podem ser qualquer tipo de dados e podem ou não ter um valor padrão.
Grupo	Use esse tipo para um grupo que pode conter outros campos ou grupos.
Grupo (escolha)	Use esse tipo se o grupo puder conter apenas um dos vários tipos diferentes de campos ou grupos de campos. Por exemplo, imagine que você está criando um modelo de formulário que será usado por fornecedores nos Estados Unidos e em países e regiões da União Europeia, e seu modelo de formulário contém um grupo de opções de endereço. O grupo de escolha de endereço contém um grupo com campos para um endereço nos Estados Unidos ou um grupo com campos para um endereço em um país ou região da União Europeia. Quando o usuário abre o formulário baseado nesse modelo de formulário, ele pode optar por inserir um endereço nos Estados Unidos ou um endereço em outro país ou região. Os controles associados aos campos do grupo apropriado aparecem no formulário.
Esquema XML completo ou documento XML	Use este tipo de elemento se quiser adicionar um esquema XML ou documento XML adicional a um local especificado na fonte de dados.

Tipo de dados Define o tipo de dados que um campo pode armazenar.

Lista de tipos de dados disponíveis

Tipo de dados	Quando usar
Texto	Use esse tipo de dados para um campo de elemento ou atributo que contenha texto não formatado.
Rich Text	Use este tipo de dados para um campo de elemento que contenha texto formatado. Não é possível usar esse tipo de dados para campos de atributo.
Número inteiro	Use esse tipo de dados para um campo de elemento ou atributo que contenha números sem valores decimais.
Decimal	Use esse tipo de dados para um elemento ou campo de atributo que contenha valores monetários ou números com valores decimais.
Verdadeiro/Falso	Use este tipo de dados para um campo de elemento ou atributo que contém dados que podem ser apenas um de dois valores.
Hiperlink	Use esse tipo de dados para um campo de elemento ou atributo que contenha um URI (Uniform Resource Identifier), como um hiperlink ou um namespace.
Data	Use esse tipo de dados para um campo de elemento ou atributo que contenha uma data de calendário.
Horários	Use esse tipo de dados para um campo de elemento ou atributo que contenha um tempo de 24 horas.
Data e Hora	Use esse tipo de dados para um elemento ou campo de atributo que contenha uma data de calendário e um horário de 24 horas.
Anexo de imagem ou arquivo	Use esse tipo de dados para um campo de elemento ou atributo que contenha dados binários, como uma imagem ou uma imagem.
Personalizada	Use esse tipo de dados para um campo de elemento ou atributo com tipos de dados personalizados definidos por um namespace. Esse tipo de dados costuma ser usado para um campo ou grupo associado a um controle personalizado. A caixa Namespace de dados é habilitada quando você escolhe este tipo de dados.

Namespace de Dados Define o URI (Uniform Resource Identifier) para adicionar um namespace para um tipo de dados personalizado. Esta propriedade está disponível para campos de elemento ou atributo com uma propriedade de tipo de dados Personalizado . Quando você adiciona um controle personalizado a um modelo de formulário, essa propriedade geralmente contém um valor definido pelo autor do controle personalizado associado ao campo.

Valor padrão Define o valor inicial de um campo de elemento ou atributo quando o formulário é aberto pela primeira vez por um usuário. Você também pode adicionar fórmulas a valores padrão, como a data atual, um cálculo matemático ou uma referência a outro campo.

Repetindo Define se o campo de elemento, campo de atributo ou grupo pode ocorrer mais de uma vez em um formulário. Controles de lista, seções de repetição, tabelas de repetição e controles que fazem parte de uma seção ou tabela de repetição são associados a campos e grupos de repetição.

Não pode ficar em branco Define se o campo de elemento ou atributo deve conter um valor. Se o campo não tiver um valor, o controle associado a esse campo será marcado com um asterisco vermelho ou, para alguns tipos de controles, uma borda vermelha tracejada. Esta propriedade está disponível somente para campos. Não está disponível para grupos.

Início da Página

Fontes de dados secundárias

Fontes de dados secundárias são fontes de dados no formato que contêm dados fornecidos por meio de outras conexões de dados com fontes de dados externas. Por exemplo, imagine que você está criando um modelo de formulário para um relatório de despesas e que deseja que formulários baseados nesse modelo aceitem despesas em outras moedas. No entanto, os dados de moeda são armazenados em um banco de dados. Para exibir os dados de moeda, adicione uma conexão de dados a esse banco de dados. Os dados de moeda são armazenados em uma fonte de dados secundária e exibidos em um controle de caixa de listagem no seu modelo de formulário.

Os dados de conexões de dados adicionais são armazenados em fontes de dados secundárias e, em seguida, exibidos como opções em controles, como caixa de listagem, caixa de combinação ou controle de caixa de listagem suspensa, para o usuário selecionar ao preencher um formulário. Quando o usuário seleciona um item em uma fonte de dados secundária, a seleção é copiada para um campo na fonte de dados principal.

As fontes de dados secundárias diferem da fonte de dados principal das seguintes maneiras:

• Fontes de dados secundárias são opcionais em um modelo de formulário. Todos os modelos de formulário devem ter uma fonte de dados principal.
• Um modelo de formulário pode ter uma ou mais fontes de dados secundárias, mas apenas uma única fonte de dados principal.
• Campos e grupos em uma fonte de dados secundária são baseados na maneira como os dados são armazenados na fonte de dados externa, que é conectada ao formulário usando uma conexão de dados. Esses campos e grupos não podem ser modificados usando o InfoPath.
• Ao contrário da fonte de dados principal, as fontes de dados secundárias não são salvas com o formulário.
• Os dados em fontes de dados secundárias normalmente não são enviados quando o usuário envia um formulário preenchido. No entanto, você pode configurar o modelo de formulário para enviar os dados da fonte de dados secundária para um serviço Web usando regras ou para um destinatário de email usando código personalizado.

Criando fontes de dados secundárias

Quando você adiciona uma conexão de dados a uma fonte de dados externa que retorna dados ao formulário, o InfoPath cria uma fonte de dados secundária automaticamente. Cada conexão de dados que você adiciona ao seu modelo de formulário cria uma fonte de dados secundária correspondente. Da mesma forma que campos e grupos são adicionados à fonte de dados principal, o InfoPath adiciona campos e grupos à fonte de dados secundária. Os campos e grupos são adicionados à fonte de dados secundária para que eles sejam mapeados para a maneira como a fonte de dados externa armazena os dados. Você pode criar uma conexão de dados secundária para o seguinte:

• Registro de Certificado
• Arquivo XML
• Banco de dados do Microsoft Office Access ou banco de dados do Microsoft SQL Server
• Lista em um site executando o Microsoft Windows SharePoint Services

Ao adicionar uma conexão de dados ao seu modelo de formulário e criar uma fonte de dados secundária, você pode ver os campos e grupos na fonte de dados secundária no painel de tarefas Fonte de Dados . Cada fonte de dados secundária é mostrada neste painel de tarefas com o nome da conexão de dados seguido por Secundária entre parênteses.

Modificação de fontes de dados secundárias

Como os campos e grupos nas fontes de dados secundárias são baseados em conexões de dados com fontes de dados externas, você não pode modificar os campos e grupos em uma fonte de dados secundária. Quando você exibe uma fonte de dados secundária no painel de tarefas Fonte de Dados , os campos têm o ícone de campo bloqueado e os grupos têm o ícone de grupo bloqueado para indicar que você não pode modificá-los.

Início da Página

Noções básicas sobre o relacionamento entre uma fonte de dados e um esquema XML

Quando um usuário preenche um formulário baseado em um modelo de formulário, as fontes de dados principais e secundárias do formulário são armazenadas como documentos XML no computador do usuário. A estrutura do documento XML é definida por um esquema XML. Um esquema XML é um arquivo baseado em XML que define a estrutura e os elementos do documento XML, neste caso, o formulário e os dados que os elementos podem conter.

Quando você cria um modelo de formulário, o InfoPath cria automaticamente o esquema XML usado para definir a estrutura dos formulários que os usuários preencherão. Cada campo ou grupo na fonte de dados corresponde a um elemento no esquema XML. As propriedades de cada campo e grupo na fonte de dados definem a estrutura dos elementos correspondentes e os dados que cada elemento pode conter no documento XML resultante. Você pode exibir detalhes adicionais do esquema na guia Detalhes na caixa de diálogo Propriedades do Campo ou do Grupo , que pode ser aberta clicando duas vezes em um campo ou grupo no painel de tarefas Fonte de Dados .

Início da Página