Criar modelo de dados do formulário

Integração de dados

Experience Manager Forms a integração de dados oferece uma interface de usuário intuitiva para criar e trabalhar com modelos de dados de formulário. Um modelo de dados de formulário depende de fontes de dados para o intercâmbio de dados; no entanto, é possível criar um Modelo de dados de formulário com ou sem uma fonte de dados. Existem duas abordagens para criar um a partir do modelo de dados, dependendo se você configurou as fontes de dados:

  • Uso de fontes de dados pré-configuradas: Se você configurou fontes de dados conforme descrito em Configurar fontes de dados, é possível selecioná-los ao criar um modelo de dados de formulário. 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.

  • Sem fontes de dados: Se você não tiver configurado fontes de dados para seu modelo de dados de formulário, ainda poderá criá-lo sem fontes de dados. Você pode usar o Modelo de dados de formulário para criar o Forms adaptável e testá-los usando dados de amostra. Quando as fontes de dados estão disponíveis, é possível vincular o Modelo de dados de formulário às fontes de dados, o que reflete automaticamente no Forms adaptável associado.

OBSERVAÇÃO

Você deve ser um membro de ambos fdm-author e usuário de formulários para criar e trabalhar com o modelo de dados de formulário. Entre em contato com seu Experience Manager administrador para se tornar membro dos grupos.

Criar modelo de dados do formulário

Verifique se você configurou as fontes de dados que pretende usar no Modelo de dados de formulário, conforme descrito em Configurar fontes de dados. Faça o seguinte para criar um Modelo de dados de formulário com base em fontes de dados configuradas:

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

  2. Toque 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.
    • (Opcional) Especifique o título, a descrição e as tags para o modelo de dados de formulário.
    • (Opcional e aplicável somente se as fontes de dados estiverem configuradas) Toque no ícone de marca de verificação ao lado do Configuração da Fonte de Dados e selecione o nó de configuração onde residem os serviços de nuvem das fontes de dados que você deseja usar. Ele restringe a lista de fontes de dados disponíveis para seleção na próxima página às disponíveis no nó de configuração selecionado. No entanto, qualquer banco de dados JDBC e Experience Manager as fontes de dados do perfil de usuário são listadas por padrão. Se você não selecionar um nó de configuração, as fontes de dados de todos os nós de configuração serão listadas.
  4. Toque Próximo.

  5. (Aplicável somente se as fontes de dados estiverem configuradas) Selecionar fonte de dados lista as fontes de dados disponíveis, se houver. Selecione fontes de dados que deseja usar no modelo de dados de formulário.

  6. Toque Criar e na caixa de diálogo de confirmação, toque em Abrir para abrir o editor de Modelo de dados de formulário.

    Vamos analisar os diferentes componentes da interface do usuário 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 do 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 e serviços do modelo de dados.

    B. Atualizar Definições da Fonte de Dados Busca todas as alterações nas definições da fonte de dados de fontes de dados configuradas e as atualiza na guia Fontes de dados do editor do Modelo de dados de formulário.

    C. Modelo Área de conteúdo na qual os objetos de modelo de dados adicionados são exibidos.

    D. Serviços Área de conteúdo onde são exibidas operações ou serviços de fonte de dados adicionados.

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

    F. Adicionar Selecionado 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 de Modelo de dados de formulário e como trabalhar com ele para editar e configurar o modelo de dados de formulário, consulte Trabalhar com o modelo de dados de formulário.

Atualizar fontes de dados

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

  1. Ir para Forms > Integrações de dados, selecione o Modelo de dados de formulário no qual deseja adicionar ou atualizar fontes de dados e toque em Propriedades.

  2. Nas propriedades do Modelo de dados de formulário, acesse Atualizar origem guia .

    No Atualizar origem guia :

    • Toque no ícone de navegação na Configuração sensível ao contexto e selecione um nó de configuração em que reside a configuração da nuvem para a fonte de dados que você deseja adicionar. Se você não selecionar um nó, as configurações de nuvem residentes somente na variável global são listados ao tocar Adicionar fontes.

    • Para adicionar uma nova fonte de dados, toque em Adicionar fontes e selecione as fontes de dados a serem adicionadas ao modelo de dados do formulário. Todas as fontes de dados configuradas em global e o nó de configuração selecionado, se houver, serão exibidos.

    • Para substituir uma fonte de dados existente por outra fonte de dados do mesmo tipo, toque no Editar ícone para a fonte de dados e selecione na lista de fontes de dados disponíveis.

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

      fdm-properties

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

OBSERVAÇÃO

Depois de adicionar novas fontes de dados ou atualizar as fontes de dados existentes em um modelo de dados de formulário, atualize as referências de vínculo, conforme apropriado, no Adaptive Forms que usam o modelo de dados de formulário atualizado.

Configurações sensíveis ao contexto para modos de execução específicos

Modelo de dados do formulário utiliza Sling configurações sensíveis ao contexto para oferecer suporte a diferentes parâmetros de fonte de dados para conexão com fontes de dados para diferentes Experience Manager modos de execução.

When Modelo de dados do formulário O usa configurações de nuvem para armazenar parâmetros, que, quando marcados e implantados por meio do controle de origem (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 Experience Manager modos de execução.

Para isso, é necessário criar uma configuração OSGi que contenha pares de valores-parâmetros da fonte de dados. Isso substitui o mesmo par de Modelo de dados do formulário configuração da nuvem em tempo de execução. Como as configurações OSGi suportam esses modos de execução por padrão, você pode substituir um parâmetro de fonte de dados por valores diferentes com base no modo de execução.

Para ativar configurações da nuvem específicas da implantação no Modelo de dados do formulário:

  1. Crie a configuração da 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. Usar o mesmo {foldername} como na etapa 1. E substituir fdm com azurestorage para configuração de armazenamento do Azure.
    2. Crie e baixe o pacote. Para obter detalhes, consulte ações do pacote.
  3. Integrar a configuração da nuvem no Experience Manager Projeto de Arquétipo.

    1. Descompacte o pacote baixado.
    2. Copiar jcr_root coloque-a na pasta ui.content > src > main > content.
    3. Atualizar ui.content > src > main > content > META-INF > vault > filter.xml para conter filtro /conf/{foldername}/settings/cloudconfigs/fdm. Para obter detalhes, consulte Módulo ui.content do AEM Project Archetype. 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 dos campos (como o URL) das configurações de nuvem com base no ambiente, use a configuração do OSGi discutida na etapa a seguir.
  4. Crie uma configuração com reconhecimento de contexto do Apache Sling. Para criar a configuração do OSGi:

    1. Configurar arquivos de configuração OSGi em Experience Manager Projeto de arquétipo.
      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. Para obter detalhes, consulte Configuração do OSGi para Adobe Experience Manager.

    2. Defina o json de configuração OSGI. 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 do Apache Sling: Configuração do OSGi.
      2. Forneça uma descrição.
      3. Selecionar ativado.
      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 sensível ao contexto do Apache Sling - Substituir. Por exemplo, cloudconfigs/fdm/{configName}/url="newURL".
        Várias substituições podem ser adicionadas ao selecionar +.
      5. Selecione Salvar.
      6. Para obter o JSON de configuração do OSGi, siga as etapas em Gerar configurações de OSGi usando o Início rápido do SDK AEM.
      7. Coloque JSON em Arquivos de configuração de fábrica OSGi criados na etapa anterior.
      8. Altere 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 API do gerenciador de nuvem e posterior pode ser referenciada no Configuração do OSGi.
        Quando esse projeto de arquétipo é implantado por meio do pipeline CM, a substituição fornecerá valores diferentes em ambientes diferentes (ou no modo de execução).
      OBSERVAÇÃO

      Adobe Managed Service os usuários podem criptografar os valores secretos usando o suporte à criptografia (para obter detalhes, consulte suporte de criptografia para propriedades de configuração e coloque o texto criptografado no valor após as configurações com reconhecimento de contexto estão disponíveis no service pack 6.5.13.0.

  5. Atualize as definições da fonte de dados usando a opção para atualizar as definições da fonte de dados no Editor do Modelo de dados de formulário para atualizar o cache do FDM por meio da interface do usuário do FDM e obter a configuração mais recente.

Próximas etapas

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

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

Nesta página