DocumentaçãoAEMGuia do usuário

[AEM Forms]{class="badge positive" title="Aplicável ao AEM Forms)."}

Criar modelo de dados de formulário (FDM) create-form-data-model

Última atualização: 25 de setembro de 2026
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Beginner
  • Intermediate
  • User
  • Developer
Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

Integração de dados

Um Modelo de Dados de Formulário (FDM) em Experience Manager Forms define como os dados são estruturados e trocados entre formulários e sistemas back-end. A integração de dados do Experience Manager Forms fornece uma interface de usuário intuitiva para criar e trabalhar com modelos de dados de formulário. Um modelo de dados de formulário (FDM) depende de fontes de dados para a troca de dados; no entanto, você pode criar um modelo de dados de formulário (FDM) com ou sem uma fonte de dados. Essa flexibilidade permite que você comece a projetar e testar formulários mesmo antes que a conectividade de back-end esteja disponível e, em seguida, vincule fontes de dados posteriormente sem reconstruir o modelo.

Há duas abordagens para criar um Modelo de dados de formulário (FDM), dependendo se você configurou fontes de dados:

  • Usando fontes de dados pré-configuradas: se você tiver configurado as fontes de dados conforme descrito em Configurar fontes de dados, poderá selecioná-las ao criar um Modelo de Dados de Formulário (FDM). A seleção de fontes de dados configuradas traz todos os objetos, propriedades e serviços do modelo de dados das fontes de dados selecionadas disponíveis para uso no Modelo de dados de formulário (FDM). Essa abordagem é ideal quando os endpoints de integração já estão estabelecidos e você deseja que o FDM reflita o esquema ativo, as operações e os serviços desses sistemas.

  • Sem fontes de dados: se você não tiver configurado fontes de dados para seu Modelo de Dados de Formulário (FDM), ainda será possível criar o Modelo de Dados de Formulário (FDM) sem fontes de dados. Você pode usar o Modelo de dados de formulário (FDM) para criar o Forms adaptável e testá-los usando dados de amostra. Quando as fontes de dados se tornam disponíveis, é possível vincular o Modelo de dados de formulário (FDM) às fontes de dados, e essa vinculação se propaga automaticamente para o Adaptive Forms associado — para que os formulários criados com base em dados de amostra continuem a funcionar assim que a conectividade de back-end real for adicionada.

NOTE
Pré-requisito: Você deve ser membro dos grupos fdm-author e forms-user para criar e trabalhar com um Modelo de Dados de Formulário (FDM). Sem a associação em ambos os grupos, os recursos de criação do FDM não estão disponíveis. Contate o administrador do Experience Manager para se tornar membro dos grupos fdm-author e forms-user.

Criar modelo de dados de formulário (FDM) data-sources

Antes de criar um modelo de dados de formulário (FDM), verifique se você configurou as fontes de dados que pretende usar no modelo de dados de formulário (FDM) conforme descrito em Configurar fontes de dados. Um Modelo de Dados de Formulário (FDM) fornece uma camada unificada que conecta o Forms do Adobe Experience Manager a uma ou mais fontes de dados configuradas, permitindo vincular campos de formulário a dados de back-end e chamar serviços de fonte de dados. Faça o seguinte para criar um Modelo de dados de formulário (FDM) com base nas fontes de dados configuradas:

  1. Na instância do autor Experience Manager, navegue até Forms > Integrações de dados.

  2. Selecione Criar > Modelo de dados de formulário.

  3. Na caixa de diálogo Criar modelo de dados de formulário:

    • Especifique um nome para o modelo de dados de formulário (FDM).
    • (Opcional) Especifique um título, uma descrição e marcas para o modelo de dados de formulário (FDM).
    • (Opcional e aplicável somente se as fontes de dados estiverem configuradas) Selecione o ícone de marca de verificação ao lado do campo Configuração do Data Source e selecione o nó de configuração onde residem os serviços em nuvem para as fontes de dados que você deseja usar. Como resultado, a lista de fontes de dados disponíveis para seleção na próxima página é restrita àquelas disponíveis no nó de configuração selecionado. No entanto, todas as fontes de dados de perfil de usuário do Experience Manager são listadas por padrão. Se você não selecionar um nó de configuração, as origens de dados de todos os nós de configuração serão listadas.

  4. Selecione Próximo.

  5. (Aplicável somente se as fontes de dados estiverem configuradas) A tela Selecionar Fonte de Dados lista as fontes de dados disponíveis. Selecione as fontes de dados que deseja usar no modelo de dados do formulário.

  6. Selecione Criar e, na caixa de diálogo de confirmação, selecione Abrir para abrir o editor de Modelo de Dados de Formulário.

    Um Modelo de Dados de Formulário com três fontes de dados - um serviço RESTful, Experience Manager perfil de usuário e um RDBMS

    A interface do editor do modelo de dados de formulário inclui os seguintes componentes:

    A. Fontes de dados Lista as fontes de dados em um modelo de dados de formulário. Expanda uma fonte de dados para exibir seus objetos de modelo de dados e serviços.

    B. Atualizar Definições do Data Source Busca as alterações nas definições de fonte de dados das fontes de dados configuradas e as atualiza na guia Fontes de Dados do editor de Modelo de Dados de Formulário. Isso garante que o modelo reflita o estado atual das fontes de dados conectadas.

    C. Modelo Área de conteúdo na qual os objetos de modelo de dados adicionados aparecem.

    D. Serviços Área de conteúdo em que aparecem as operações ou os serviços da fonte de dados adicionados.

    E. Barra de ferramentas Ferramentas para trabalhar com o modelo de dados de formulário (FDM). A barra de ferramentas mostra mais opções dependendo do objeto selecionado no modelo de dados de formulário (FDM).

    F. Adicionar Selecionados Adiciona os objetos e serviços de modelo de dados selecionados ao modelo de dados de formulário.

Para obter mais informações sobre o editor do Modelo de Dados de Formulário e como você pode trabalhar com ele para editar e configurar um modelo de dados de formulário (FDM), consulte Trabalhar com o modelo de dados de formulário.

Atualizar fontes de dados update

Siga estas etapas para adicionar, substituir ou excluir fontes de dados em um Modelo de Dados de Formulário (FDM) existente no Adobe Experience Manager Forms. Manter as fontes de dados atualizadas garante que o Adaptive Forms integrado ao modelo continue a ler e gravar nos sistemas corretos.

  1. Vá para Forms > Integrações de Dados, selecione o Modelo de Dados de Formulário (FDM) no qual deseja adicionar ou atualizar fontes de dados e selecione Propriedades.

  2. Nas propriedades do modelo de dados de formulário, vá para a guia Atualizar Source.

    Na guia Atualizar Source, você pode selecionar um contexto de configuração e adicionar, substituir ou excluir fontes de dados:

    • Selecione um contexto de configuração: selecione o ícone de navegação no campo Configuração com Reconhecimento de Contexto e selecione um nó de configuração em que reside a configuração de nuvem da fonte de dados que você deseja adicionar. Isso determina quais configurações de nuvem estão visíveis. Se você não selecionar um nó, as configurações de nuvem que residem somente no nó global serão listadas quando você selecionar Adicionar Fontes.

    • Adicionar uma nova fonte de dados: Selecione Adicionar Fontes e selecione as fontes de dados a serem adicionadas ao Modelo de Dados de Formulário (FDM). Todas as fontes de dados configuradas em global e no nó de configuração selecionado, se houver, serão exibidas. Isso adiciona as fontes de dados selecionadas para que seus objetos de modelo de dados fiquem disponíveis para associação no modelo.

    • Substituir uma fonte de dados existente: Para substituir uma fonte de dados existente por outra fonte de dados do mesmo tipo, selecione o ícone Editar para a fonte de dados e selecione na lista de fontes de dados disponíveis. Substituir por uma origem do mesmo tipo preserva a estrutura do modelo de dados existente para que as associações dependentes permaneçam válidas.
      propriedades-fdm

    • Excluir uma fonte de dados existente: Para excluir uma fonte de dados existente, selecione o ícone Excluir para a fonte de dados. O ícone Excluir está desabilitado porque um objeto de modelo de dados dessa fonte de dados já foi adicionado e está em uso no Modelo de Dados de Formulário (FDM), o que impede a remoção de dependências que ainda são referenciadas.

  3. Selecione Salvar e fechar para salvar as atualizações.

NOTE
Depois de adicionar novas fontes de dados ou atualizar fontes de dados existentes em um Modelo de Dados de Formulário (FDM), atualize as referências de associação, conforme apropriado, no Forms Adaptável que usa o Modelo de Dados de Formulário (FDM) atualizado. Isso garante que os campos continuem a ser mapeados corretamente e que os dados do formulário sejam lidos e gravados nas fontes desejadas.

Configurações sensíveis ao contexto para modos de execução específicos runmode-specific-context-aware-config

O Modelo de Dados de Formulário (FDM) usa as configurações com reconhecimento de contexto do Sling para fornecer parâmetros de fonte de dados diferentes, habilitando conexões com fontes de dados que variam entre os modos de execução Experience Manager. Este recurso permite que uma única implantação direcione pontos de extremidade distintos dependendo se ela é executada no Desenvolvimento, Preparo ou Produção.

Quando o Form Data Model (FDM) usa configurações de nuvem para armazenar parâmetros, esses parâmetros, quando verificados e implantados por meio do controle do código-fonte (repositório GIT do Cloud-Manager), criam uma única configuração de nuvem com parâmetros idênticos em todos os modos de execução (Desenvolvimento, Preparo e Produção). Quando seu caso de uso exigir conjuntos de dados diferentes para ambientes de teste e produção, use parâmetros de fonte de dados (por exemplo, uma URL de fonte de dados) que sejam específicos para cada modo de execução do Experience Manager.

Para fazer isso, crie uma configuração OSGi que contenha pares de valor-parâmetro da fonte de dados. Isso garante que os valores OSGi tenham prioridade, substituindo o mesmo par da configuração de nuvem do Modelo de Dados de Formulário (FDM) no tempo de execução. Como as configurações de OSGi são compatíveis com esses modos de execução por padrão, é possível substituir um parâmetro de fonte de dados por um valor diferente com base no modo de execução, permitindo que cada ambiente resolva para seu próprio endpoint.

Para habilitar configurações de nuvem específicas da implantação no Modelo de Dados de Formulário (FDM):

  1. Criar configuração de nuvem na instância de desenvolvimento local. Para obter etapas detalhadas, consulte Como configurar fontes de dados.

  2. Armazene a configuração da nuvem no sistema de arquivos.

    1. Criar pacote com filtro /conf/{foldername}/settings/cloudconfigs/fdm. Use o mesmo {foldername} da etapa 1. E substitua fdm por azurestorage para configuração de armazenamento do Azure.
    2. Criar e baixar pacote. Para obter detalhes, consulte ações do pacote.

  3. Integrar configuração de nuvem no Projeto do Arquétipo Experience Manager.

    1. Descompacte o pacote baixado.
    2. Copie a pasta jcr_root e coloque-a como ui.content > src > main > content.
    3. Atualize ui.content > src > main > content > META-INF > vault > filter.xml para conter o filtro /conf/{foldername}/settings/cloudconfigs/fdm. Para obter detalhes, consulte o módulo ui.content do Arquétipo de Projetos AEM. Quando esse projeto de arquétipo é implantado por meio do pipeline do Cloud Manager (CM), a mesma configuração de nuvem é instalada em todos os ambientes (ou modos de execução). Para alterar o valor de campos (como URL) das configurações de nuvem com base no ambiente, use a configuração OSGi discutida na etapa a seguir.

  4. Crie uma configuração com reconhecimento de contexto do Apache Sling. Para criar a configuração OSGi:

    1. Configure os arquivos de configuração OSGi no projeto do Arquétipo Experience Manager.
      Criar arquivos de Configuração de Fábrica OSGi com PID org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider. Crie um arquivo com o mesmo nome em cada pasta de modo de execução, onde os valores precisam ser alterados por modo de execução. Isso garante que cada modo de execução aplique seus próprios valores de substituição. Para obter detalhes, consulte Configurar OSGi para Adobe Experience Manager.

    2. Definir a configuração JSON do OSGi. Configure o Provedor de substituição de configuração com reconhecimento de contexto do Apache Sling para que os valores específicos do ambiente sejam aplicados automaticamente na implantação. Para usar o provedor de substituição de configuração com reconhecimento de contexto do Apache Sling:

      1. Na instância de desenvolvimento local /system/console/configMgr, selecione a configuração OSGi de fábrica com o nome Provedor de Substituição de Configuração com Reconhecimento de Contexto Apache Sling: configuração OSGi.
      2. Forneça uma descrição.
      3. Selecione habilitado.
      4. Em substituições, forneça os campos que precisam ser alterados com base no ambiente na sintaxe de substituição do Sling. Para obter detalhes, consulte Configuração com reconhecimento de contexto do Apache Sling - Substituição. Por exemplo, cloudconfigs/fdm/{configName}/url="newURL".
        Adicione várias substituições selecionando +.
      5. Selecione Salvar.
      6. Para obter o JSON de Configuração OSGi, siga as etapas em Geração de Configurações OSGi usando o Quickstart do AEM SDK.
      7. Coloque o JSON nos arquivos de configuração de fábrica OSGi criados na etapa anterior.
      8. Altere o valor de newURL na configuração de substituição para o valor de destino correto para cada ambiente (ou modo de execução), para que cada ambiente resolva para sua própria URL.
      9. Para alterar um valor secreto com base no modo de execução, crie uma variável secreta usando a API do Cloud Manager (CM) e depois faça referência a ela na Configuração OSGi.
        Quando esse projeto de arquétipo é implantado por meio do pipeline do Cloud Manager (CM), a substituição fornece valores diferentes em ambientes diferentes (ou modos de execução). Como resultado, uma única base de código resolve a configuração específica do ambiente no tempo de execução. Isso garante que as instâncias de desenvolvimento, preparo e produção recebam a URL e os valores secretos corretos, sem alterações manuais de código.
      note
      NOTE
      Adobe Managed Service usuários podem criptografar os valores secretos usando o suporte de criptografia. Para obter detalhes, consulte suporte a criptografia para propriedades de configuração e coloque o texto criptografado no valor após configurações com reconhecimento de contexto estarem disponíveis no service pack 6.5.13.0.

  5. Atualize as definições de fonte de dados usando a opção para atualizar as definições de fonte de dados no editor de Modelo de Dados de Formulário para atualizar o cache de Modelo de Dados de Formulário (FDM) por meio da interface do usuário (UI) do FDM e obter a configuração mais recente. Isso garante que o cache do FDM reflita os valores de substituição recém-aplicados.

Próximas etapas next-steps

Agora você tem um Modelo de Dados de Formulário (FDM) com fontes de dados adicionadas a ele. Com as fontes de dados conectadas, o próximo estágio é refinar e estender o Modelo de Dados de Formulário (FDM) para que ele represente com precisão os dados que seu formulário precisa capturar e processar.

Edite o Modelo de Dados de Formulário (FDM) para executar as seguintes tarefas:

  • Adicione e configure objetos e serviços de modelo de dados.
  • Adicione associações entre objetos do modelo de dados para definir como os dados relacionados se conectam.
  • Editar propriedades de objetos de modelo de dados existentes.
  • Adicione objetos e propriedades de modelo de dados personalizados a dados de modelo que não estejam disponíveis nas fontes de dados conectadas.
  • Gere dados de amostra para testar e visualizar como o modelo de dados de formulário se comporta.

Essas etapas de configuração permitem adaptar o Modelo de Dados de Formulário (FDM) aos seus requisitos comerciais específicos antes de vinculá-lo a um formulário.

Para obter mais informações, consulte Trabalhar com o modelo de dados de formulário.

recommendation-more-help
experience-manager-cloud-service-help-main-toc