Este tutorial é uma etapa da Criar O Primeiro Formulário Adaptável série. A Adobe recomenda que você siga a série em sequência cronológica para entender, executar e demonstrar o caso de uso tutorial completo.
AEM Forms o módulo de integração de dados permite criar um modelo de dados de formulário a partir de diferentes fontes de dados de back-end, como perfil de usuário AEM, serviços Web RESTful, serviços Web baseados em SOAP, serviços OData e bancos de dados relacionais. Você pode configurar serviços e objetos de modelo de dados em um modelo de dados de formulário e associá-lo a um formulário adaptável. Os campos de formulário adaptável são vinculados às propriedades do objeto de modelo de dados. Os serviços permitem preencher previamente o formulário adaptável e gravar dados do formulário enviado de volta no objeto de modelo de dados.
Para obter mais informações sobre a integração de dados de formulário e o modelo de dados de formulário, consulte Integração de dados do AEM Forms.
Este tutorial percorre as etapas para preparar, criar, configurar e associar um modelo de dados de formulário a um formulário adaptável. Ao final deste tutorial, você será capaz de:
O modelo de dados de formulário será semelhante ao seguinte:
A. Fontes de dados configuradas B. Esquemas de fonte de dados C Serviços disponíveis D. Objetos do modelo de dados E Serviços configurados
Antes de começar, verifique se você tem o seguinte:
É possível configurar diferentes tipos de fontes de dados para criar um modelo de dados de formulário. Para este tutorial, você configura o banco de dados MySQL que configurou e preencheu com dados de amostra. Para obter informações sobre outras fontes de dados compatíveis e como configurá-las, consulte Integração de dados do AEM Forms.
Faça o seguinte para configurar suas MySQL banco de dados:
Instale o driver JDBC para MySQL o banco de dados como um osGi pacote:
Baixe MySQL o pacote JDBC Driver OSGi em http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.html
.
Fazer logon no AEM Forms Instância do autor como administrador e acesse pacotes de console da Web AEM. O URL padrão é https://localhost:4502/system/console/bundles.
Selecionar Instalar/Atualizar. Um Carregar/instalar pacotes será exibida.
Selecionar Escolher arquivo para procurar e selecionar a variável MySQL Pacote OSGi do driver JDBC. Selecionar Iniciar pacote e Atualizar pacotes e selecione Instalar ou atualizar. Certifique-se de que o Oracle Corporation’s Driver MySQL JDBC esteja ativo. O motorista está instalado.
Configure MySQL o banco de dados como um fonte de dados:
Acesse AEM console da Web no https://localhost:4502/system/console/configMgr.
Localize a configuração do DataSource com conexão Apache Sling. Selecione para abrir a configuração no modo de edição.
Na caixa de diálogo de configuração, especifique os seguintes detalhes:
weretail
, a URL é: jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
Quando o banco de dados está atrás de um firewall, o MySQL nome do host do banco de dados não é um DNS público. O endereço IP do banco de dados deve ser adicionado ao arquivo /etc/hosts da máquina AEM host.
O AEM Forms não oferece suporte à autenticação NT para MySQL. Vá para AEM console da Web no https://localhost:4502/system/console/configMgr e pesquisa "Apache Sling Connection Pooled Datasource". Para "URI de conexão JDBC" propriedade, defina o valor de "Segurança integrada" como Falso e use o nome de usuário e o senha criados para conexão com MySQL o banco de dados.
Testar em Emprestar: ative a opção Testar em Emprestar .
Teste no retorno: ative a opção Testar no retorno .
Consulta de validação: Especifique uma consulta SQL SELECT para validar as conexões do pool. A consulta deve retornar pelo menos uma linha. Por exemplo, selecionar * dos detalhes do cliente.
Isolamento de transação: Defina o valor como READ_COMMITTED.
Deixar outras propriedades com o padrão valores e selecione Salvar.
Uma configuração semelhante à seguinte é criada.
AEM Forms O oferece uma interface intuitiva para criar um modelo de dados de formulário de fontes de dados configuradas. É possível usar várias fontes de dados em um modelo de dados de formulário. Para esse caso de uso, é possível usar o configurado MySQL fonte de dados.
Faça o seguinte para criar o modelo de dados de formulário:
Na instância do autor AEM, navegue até Forms > Integrações de dados.
Selecionar Criar > Modelo de dados do formulário.
Na caixa de diálogo Criar modelo de dados de formulário, especifique uma name para o modelo de dados do formulário. Por exemplo, customer-shipping-billing-details. Selecione Próximo.
A tela selecionar fonte de dados lista todas as fontes de dados configuradas. Selecionar WeRetailMySQL fonte de dados e selecione Criar.
A variável customer-shipping-billing-details modelo de dados de formulário é criado.
A configuração do modelo de dados de formulário envolve:
Faça o seguinte para configurar o modelo de dados de formulário:
Na instância do autor AEM, navegue até Forms > Integrações de dados. O URL padrão é https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.
A variável customer-shipping-billing-details o modelo de dados de formulário criado anteriormente está listado aqui. Abra-o no modo de edição.
A fonte de dados selecionada WeRetailMySQL está configurado no modelo de dados de formulário.
Expanda a árvore da fonte de dados WeRailMySQL. Selecione os seguintes serviços e objetos de modelo de dados em weretail > customerdetails para que você possa formar o modelo de dados:
Objetos do modelo de dados:
Serviços:
Selecionar Adicionar selecionado para adicionar objetos de modelo de dados e serviços selecionados ao modelo de dados de formulário.
Os serviços padrão de obtenção, atualização e inserção para fontes de dados JDBC são fornecidos com o modelo de dados de formulário pronto para uso.
Configure serviços de leitura e gravação para o objeto de modelo de dados.
Selecione o customerdetails objeto de modelo de dados e selecione Editar propriedades.
Selecionar obter no menu suspenso Serviço de leitura. A variável id O argumento, que é a chave primária no objeto de modelo de dados customerdetails, é adicionado automaticamente. Selecionar e configure o argumento da seguinte maneira.
Da mesma forma, selecione atualizar como o Serviço de gravação. A variável customerdetails objeto é adicionado automaticamente como argumento. O argumento é configurado da seguinte maneira.
Adicione e configure o argumento da ID da seguinte maneira.
Selecione Concluído para salvar as propriedades de objetos de modelo de dados. Em seguida, selecione Salvar para salvar o modelo de dados do formulário.
A variável obter e atualizar serviços são adicionados como serviços padrão para o objeto de modelo de dados.
Vá para a Serviços guia e configurar obter e atualizar serviços.
Selecione o obter e selecione Editar propriedades. A caixa de diálogo de propriedades é aberta.
Especifique o seguinte na caixa de diálogo Editar Propriedades:
Título: especifique o título do serviço. Por exemplo: Recuperar endereço de envio.
Descrição: especifique a descrição que contém o funcionamento detalhado do serviço. Por exemplo:
Este serviço recupera o endereço de entrega e outros detalhes do cliente do MySQL banco de dados
Objeto de modelo de saída: Selecione o schema que contém dados do cliente. Por exemplo:
esquema customerdetail
Retornar matriz: Desative a variável Retornar matriz opção.
Argumentos: selecione o argumento chamado ID.
Selecionar Concluído. O serviço para recuperar os detalhes do cliente do banco de dados MySQL está configurado.
Selecione o atualizar e selecione Editar propriedades. A caixa de diálogo de propriedades é aberta.
Especifique o seguinte no Editar propriedades diálogo:
Título: especifique o título do serviço. Por exemplo, Atualizar endereço de entrega.
Descrição: especifique a descrição que contém o funcionamento detalhado do serviço. Por exemplo:
Este serviço atualiza o endereço de entrega e campos relacionados no banco de dados MySQL
Objeto de modelo de entrada: Selecione o schema que contém dados do cliente. Por exemplo:
esquema customerdetail
Tipo de saída: Selecionar BOOLEANO.
Argumentos: selecione o nome do argumento ID e customerdetails.
Selecionar Concluído. A variável atualizar serviço para atualizar os detalhes do cliente na MySQL banco de dados está configurado.
O objeto de modelo de dados e os serviços no modelo de dados de formulário são configurados. Agora você pode testar o modelo de dados do formulário.
Você pode testar o objeto de modelo de dados e os serviços para verificar se o modelo de dados de formulário está configurado corretamente.
Faça o seguinte para executar o teste:
Vá para a Modelo , selecione a customerdetails objeto de modelo de dados e selecione Testar objeto de modelo.
No Modelo de teste/serviço selecione Ler objeto de modelo do Selecionar modelo/serviço menu suspenso.
No customerdetails especifique um valor para a variável id argumento que existe na variável MySQL banco de dados e selecione Teste.
Os detalhes do cliente associados à ID especificada são obtidos e exibidos no Output conforme mostrado abaixo.
Da mesma forma, você pode testar o objeto e os serviços do modelo Gravar.
No exemplo a seguir, o serviço de atualização atualiza com êxito os detalhes de endereço da id 7102715 no banco de dados.
Agora, se você testar o serviço do modelo de leitura novamente para a id 7107215, ele buscará e exibirá os detalhes do cliente atualizados, como mostrado abaixo.
Você pode criar e usar a configuração da Lista do SharePoint usando o Modelo de dados de formulário em um Formulário adaptável para salvar dados ou o Documento de registro gerado em uma Lista do SharePoint. Consulte Conectar um formulário adaptável à lista Microsoft® SharePoint, para obter etapas detalhadas.