Saiba como configurar diferentes tipos de fontes de dados e aproveitar para criar modelos de dados de formulário.
A Integração de dados do AEM Forms permite configurar e se conectar a fontes de dados diferentes. Os seguintes tipos são suportados prontos para uso. No entanto, com pouca personalização, também é possível integrar outras fontes de dados.
A integração de dados oferece suporte aos tipos de autenticação OAuth2.0, Basic Authentication e API Key prontos para uso e permite implementar autenticação personalizada para acessar serviços da Web. Embora os serviços RESTful, baseados em SOAP e OData sejam configurados nos Serviços da nuvem AEM, o JDBC para bancos de dados relacionais e o conector para AEM perfil de usuário são configurados AEM console da Web.
Você pode configurar bancos de dados relacionais usando AEM Configuração do Console da Web. Faça o seguinte:
Vá para AEM console da Web em https://[server]:[host]/system/console/configMgr
.
Procure a configuração Apache Sling Connection Pool DataSource. Toque em para abrir a configuração no modo de edição.
Na caixa de diálogo de configuração, especifique os detalhes do banco de dados que deseja configurar, como:
Certifique-se de criptografar informações confidenciais como senhas antes de configurar a fonte de dados. Para criptografar:
https://[server]:[port]/system/console/crypto
.O texto criptografado aparece no campo Texto protegido que pode ser especificado na configuração.
Habilite Testar em linha de crédito ou Testar em retorno para especificar que os objetos são validados antes de serem emprestados ou retornados de e para o pool, respectivamente.
Especifique uma consulta SQL SELECT no campo Validation Query para validar conexões do pool. A consulta deve retornar pelo menos uma linha. Com base no seu banco de dados, especifique um dos seguintes:
Toque em Salvar para salvar a configuração.
Você pode configurar AEM perfil de usuário usando a configuração do Conector de perfil de usuário AEM console da Web. Faça o seguinte:
Vá para AEM console da Web em https://[server]:[host]/system/console/configMgr
.
Procure por AEM Forms Data Integrations - User Profile Connector Configuration e toque para abrir a configuração no modo de edição.
Na caixa de diálogo Configuração do conector do perfil do usuário, é possível adicionar, remover ou atualizar as propriedades do perfil do usuário. As propriedades especificadas estarão disponíveis para uso no modelo de dados de formulário. Use o seguinte formato para especificar as propriedades do perfil de usuário:
name=[property_name_with_location_in_user_profile],type=[property_type]
Exemplos:
name=profile/phoneNumber,type=string
name=profile/empLocation/*/city,type=string
O * no exemplo acima denota todos os nós sob o nó profile/empLocation/
em AEM perfil de usuário na estrutura CRXDE. Isso significa que o modelo de dados de formulário pode acessar a propriedade city
do tipo string
presente em qualquer nó sob o nó profile/empLocation/
. No entanto, os nós que contêm a propriedade especificada devem seguir uma estrutura consistente.
Toque em Salvar para salvar a configuração.
A configuração da pasta de serviços em nuvem é necessária para configurar os serviços em nuvem para os serviços RESTful, SOAP e OData.
Todas as configurações do serviço de nuvem no AEM são consolidadas na pasta /conf
no repositório AEM. Por padrão, a pasta conf
contém a pasta global
onde você pode criar configurações do serviço de nuvem. No entanto, é necessário ativá-lo manualmente para configurações de nuvem. Você também pode criar pastas adicionais em conf
para criar e organizar as configurações do serviço de nuvem.
Para configurar a pasta das configurações do serviço de nuvem:
Vá para Tools > General > Configuration Browser.
Faça o seguinte para habilitar a pasta global para configurações de nuvem ou ignore esta etapa para criar e configurar outra pasta para configurações do serviço de nuvem.
global
e toque em Propriedades.No Navegador de configuração, toque em Criar.
Na caixa de diálogo Criar configuração, especifique um título para a pasta e habilite Configurações de nuvem.
Toque em Criar para criar a pasta ativada para as configurações do serviço de nuvem.
O serviço Web RESTful pode ser descrito usando Especificações do Swagger no formato JSON ou YAML em um arquivo de definição do Swagger. Para configurar o serviço Web RESTful nos serviços em nuvem do AEM, verifique se você tem o arquivo Swagger no sistema de arquivos ou o URL onde o arquivo está hospedado.
Faça o seguinte para configurar os serviços RESTful:
Vá para Ferramentas > Cloud Services > Fontes de dados. Toque para selecionar a pasta onde deseja criar uma configuração de nuvem.
Consulte Configurar pasta para configurações do serviço de nuvem para obter informações sobre como criar e configurar uma pasta para configurações do serviço de nuvem.
Toque em Criar para abrir a caixa de diálogo Criar configuração da fonte de dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione RESTful Service no menu suspenso Service Type, procure e selecione uma imagem em miniatura para a configuração e toque em Next.
Especifique os seguintes detalhes para o serviço RESTful:
Toque em Criar para criar a configuração de nuvem para o serviço RESTful.
Os serviços da Web baseados em SOAP são descritos usando Web Services Description Language (WSDL) Specification. Para configurar o serviço da Web baseado em SOAP nos serviços em nuvem do AEM, verifique se você tem o URL WSDL para o serviço da Web e faça o seguinte:
Vá para Ferramentas > Cloud Services > Fontes de dados. Toque para selecionar a pasta onde deseja criar uma configuração de nuvem.
Consulte Configurar pasta para configurações do serviço de nuvem para obter informações sobre como criar e configurar uma pasta para configurações do serviço de nuvem.
Toque em Criar para abrir a caixa de diálogo Criar configuração da fonte de dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione SOAP Web Service no menu suspenso Service Type, navegue e selecione uma imagem em miniatura para a configuração e toque em Next.
Especifique o seguinte para o serviço Web SOAP:
URL WSDL do serviço da Web.
Terminal de serviço. Especifique um valor nesse campo para substituir o ponto de extremidade de serviço mencionado no WSDL.
Selecione o tipo de autenticação — Nenhum, OAuth2.0, Autenticação Básica, Autenticação Personalizada ou Token X509 — para acessar o serviço SOAP e, portanto, forneça os detalhes para autenticação.
Se você selecionar X509 Token como o tipo de Autenticação, configure o certificado X509. Para obter mais informações, consulte Configurar certificados.
Especifique o alias do KeyStore para o certificado X509 no campo Key Alias. Especifique o tempo, em segundos, até que a solicitação de autenticação permaneça válida, no campo Time To Live. Como opção, selecione para assinar o corpo da mensagem ou o cabeçalho do carimbo de data e hora ou ambos.
Toque em Criar para criar a configuração de nuvem para o serviço Web SOAP.
Um serviço OData é identificado por seu URL raiz do serviço. Para configurar um serviço OData nos serviços em nuvem do AEM, verifique se você tem o URL raiz do serviço para o serviço e faça o seguinte:
Para obter o guia passo a passo para configurar o Microsoft Dynamics 365, online ou no local, consulte Configuração do Microsoft Dynamics OData.
Vá para Ferramentas > Cloud Services > Fontes de dados. Toque para selecionar a pasta onde deseja criar uma configuração de nuvem.
Consulte Configurar pasta para configurações do serviço de nuvem para obter informações sobre como criar e configurar uma pasta para configurações do serviço de nuvem.
Toque em Criar para abrir a caixa de diálogo Criar configuração da fonte de dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione OData Service no menu suspenso Service Type, navegue e selecione uma imagem em miniatura para a configuração e toque em Next.
Especifique os seguintes detalhes para o serviço OData:
Você deve selecionar o tipo de autenticação OAuth 2.0 para se conectar aos serviços do Microsoft Dynamics usando o ponto de extremidade OData como a raiz do serviço.
Toque em Criar para criar a configuração de nuvem para o serviço OData.
As fontes de dados foram configuradas. Em seguida, é possível criar um modelo de dados de formulário ou, se já tiver criado um modelo de dados de formulário sem uma fonte de dados, associá-lo às fontes de dados recém-configuradas. Consulte Criar modelo de dados de formulário para obter detalhes.