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

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

Integração de dados

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 troca de dados; no entanto, você pode criar um Modelo de dados de formulário (FDM) com ou sem uma fonte de dados. Há duas abordagens para criar um a partir do modelo de dados, dependendo se você configurou as 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). Ele 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).

  • Sem fontes de dados: se você não tiver configurado fontes de dados para seu modelo de dados de formulário (FDM), ainda poderá criá-lo 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 estiverem disponíveis, você poderá vincular o Modelo de Dados de Formulário (FDM) às fontes de dados, o que refletirá automaticamente no Forms Adaptável associado.

NOTE
Você deve ser membro de ambos os grupos fdm-author e forms-user para poder criar e trabalhar com o modelo de dados de formulário (FDM). Contate o administrador do Experience Manager para se tornar um membro dos grupos.

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

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. 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 o título, a descrição e as 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. Ele restringe a lista de origens de dados disponíveis para seleção na próxima página às 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, se houver. 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.

    Vamos revisar os diferentes componentes da interface do editor do 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. 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 todas 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.

    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 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 trabalhar com ele para editar e configurar o modelo de dados de formulário (FDM), consulte Trabalhar com o modelo de dados de formulário.

Atualizar fontes de dados update

Faça o seguinte para adicionar ou atualizar fontes de dados a um modelo de dados de formulário (FDM) existente.

  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:

    • Selecione o ícone de procura no campo Configuração sensível ao contexto e selecione um nó de configuração em que esteja a configuração em nuvem da fonte de dados que você deseja adicionar. 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.

    • Para 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 o nó de configuração selecionado, se houver, são exibidos.

    • 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.

    • Para excluir uma fonte de dados existente, selecione o ícone Excluir para a fonte de dados. O ícone Excluir será desativado se um objeto de modelo de dados na fonte de dados for adicionado no modelo de dados de formulário (FDM).

      propriedades-fdm

  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.

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 configurações com reconhecimento de contexto do Sling para oferecer suporte a diferentes parâmetros de fonte de dados para conexão com fontes de dados para diferentes modos de execução Experience Manager.

Quando o Modelo de Dados de Formulário (FDM) usa configurações de nuvem para armazenar parâmetros, que, ao ser submetido a check-in e implantado por meio do controle do código-fonte (repositório GIT do Cloud-Manager), cria configurações de nuvem com os mesmos parâmetros para todos os modos de execução (Desenvolvimento, Preparo e Produção). No entanto, para casos de uso em que há necessidade de ter conjuntos de dados diferentes para ambientes de teste e produção, usamos parâmetros de fonte de dados (por exemplo, URL da fonte de dados) para diferentes modos de execução do Experience Manager.

Para fazer isso, você precisa criar uma configuração OSGi que contenha pares de parâmetros-valores da fonte de dados. Isso substitui o mesmo par da configuração de nuvem do Modelo de Dados de Formulário (FDM) em tempo de execução. Como as configurações do 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 valores diferentes com base no modo de execução.

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 Projeto AEM. Quando esse projeto de arquétipo é implantado por meio do pipeline 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.
      Crie 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. Para obter detalhes, consulte Configurar OSGi para Adobe Experience Manager.

    2. Defina o json de configuração OSGI. Para usar o provedor de substituição de configuração sensível ao 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 a descrição.
      3. Selecione habilitado.
      4. Em substituições, forneça 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".
        Várias substituições podem ser adicionadas 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 SDK do AEM.
      7. Coloque o JSON nos arquivos de configuração de fábrica OSGi criados na etapa anterior.
      8. Alterar o valor de newURL com base no ambiente (ou modo de execução).
      9. Para alterar o valor secreto com base no modo de execução, a variável secreta pode ser criada usando a API do Cloud Manager e posterior, e pode ser referenciada na Configuração OSGi.
        Quando esse projeto de arquétipo é implantado por meio do pipeline CM, a substituição fornecerá valores diferentes em ambientes diferentes (ou modo de execução).
      note note
      NOTE
      Adobe Managed Service usuários podem criptografar os valores secretos usando o suporte a 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 do FDM por meio da interface do FDM e obter a configuração mais recente.

Próximas etapas next-steps

Agora você tem um Modelo de dados de formulário (FDM) com fontes de dados adicionadas a ele. Em seguida, edite o Modelo de Dados de Formulário (FDM) para adicionar e configurar objetos e serviços de modelo de dados, adicionar associações entre objetos de modelo de dados, editar propriedades, adicionar objetos e propriedades de modelo de dados personalizados, gerar dados de amostra e assim por diante.

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab