Configurar fontes de dados

A Integração de dados da AEM Forms permite que você configure e conecte-se a fontes de dados diferentes. Os seguintes tipos são suportados prontamente. No entanto, com pouca personalização, também é possível integrar outras fontes de dados.

  • Bancos de dados relacionais - MySQL, Microsoft SQL Server, IBM DB2 e Oracle RDBMS
  • perfil do usuário AEM
  • Serviços Web RESTful
  • Serviços Web baseados em SOAP
  • Serviços OData

A integração de dados suporta os tipos de autenticação OAuth2.0, Autenticação básica e Chave de API 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 estejam configurados nos serviços da AEM Cloud, o JDBC para bancos de dados relacionais e o conector para AEM perfil de usuário são configurados AEM console da Web.

Configurar banco de dados relacional

Você pode configurar bancos de dados relacionais usando AEM Configuração do Console da Web. Faça o seguinte:

  1. Vá para AEM console da Web em https://server:host/system/console/configMgr.

  2. Procure a configuração Apache Sling Connection Pooling DataSource . Toque em para abrir a configuração no modo de edição.

  3. Na caixa de diálogo de configuração, especifique os detalhes do banco de dados que deseja configurar, como:

    • Nome da fonte de dados
    • Propriedade do serviço da fonte de dados que armazena o nome da fonte de dados
    • Nome da classe Java para o driver JDBC
    • URI de conexão JDBC
    • Nome de usuário e senha para estabelecer conexão com o driver JDBC
    Observação

    Certifique-se de criptografar informações confidenciais, como senhas, antes de configurar a fonte de dados. Para criptografar:

    1. Vá para https://'[server]:[port]'/system/console/crypto.
    2. No campo Texto ​simples, especifique a senha ou qualquer string para criptografar e tocar em Protect.

    O texto criptografado aparece no campo Texto protegido que você pode especificar na configuração.

  4. Ative Testar emprestado ou Testar ao Retornar para especificar que os objetos são validados antes de serem emprestados ou devolvidos de e para o pool, respectivamente.

  5. Especifique um query SELECT SQL no campo Query ​Validação para validar conexões do pool. O query deve retornar pelo menos uma linha. Com base no banco de dados, especifique um dos seguintes:

    • SELECT 1 (MySQL e MS SQL)
    • SELECT 1 from dual (Oracle)
  6. Toque em Salvar para salvar a configuração.

Configurar AEM perfil do usuário

Você pode configurar AEM perfil do usuário usando a configuração do Conector do Perfil do usuário no Console AEM Web. Faça o seguinte:

  1. Vá para AEM console da Web em https://'[server]:[port]'system/console/configMgr.

  2. Procure Integrações de dados AEM Forms - Configuração do conector do Perfil do usuário e toque para abrir a configuração no modo de edição.

  3. Na caixa de diálogo Configuração do conector do Perfil do usuário, você pode 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 do 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
    Observação

    O * no exemplo acima denota todos os nós sob o profile/empLocation/ nó AEM perfil do usuário na estrutura CRXDE. Isso significa que o modelo de dados de formulário pode acessar a city propriedade do tipo string presente em qualquer nó sob o profile/empLocation/ nó. No entanto, os nós que contêm a propriedade especificada devem seguir uma estrutura consistente.

  4. Toque em Salvar para salvar a configuração.

Configurar pasta para configurações do serviço de nuvem

Observação

A configuração da pasta de serviços em nuvem é necessária para configurar serviços em nuvem para os serviços RESTful, SOAP e OData.

Todas as configurações de serviço em nuvem no AEM são consolidadas na /conf pasta AEM repositório. Por padrão, a conf pasta contém a global pasta onde você pode criar configurações de serviço em 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 configurações de serviço em nuvem.

Para configurar a pasta das configurações do serviço de nuvem:

  1. Vá até Ferramentas > Geral > Navegador de configuração.

  2. Faça o seguinte para ativar a pasta global para configurações de nuvem ou ignore esta etapa para criar e configurar outra pasta para configurações de serviço de nuvem.

    1. No Navegador de configuração, selecione a global pasta e toque em Propriedades.

    2. Na caixa de diálogo Propriedades ​de configuração, ative Configurações da nuvem.

    3. Toque em Salvar e fechar para salvar a configuração e sair da caixa de diálogo.

  3. No Navegador ​de configuração, toque em Criar.

  4. Na caixa de diálogo Criar configuração , especifique um título para a pasta e ative Configurações da nuvem.

  5. Toque em Criar para criar a pasta ativada para configurações de serviço em nuvem.

Configurar serviços Web RESTful

O serviço Web RESTful pode ser descrito usando as especificações Swagger no formato JSON ou YAML em um arquivo de definição 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 no qual o arquivo está hospedado.

Faça o seguinte para configurar os serviços RESTful:

  1. Vá até Ferramentas > Cloud Services > Fontes de dados. Toque em para selecionar a pasta na qual deseja criar uma configuração de nuvem.

    Consulte Configurar pasta para configurações de serviço em nuvem para obter informações sobre como criar e configurar uma pasta para configurações de serviço em nuvem.

  2. Toque em Criar para abrir o assistente ​Criar configuração de fonte de dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço ​RESTful no menu suspenso Tipo de serviço, navegue e selecione uma imagem em miniatura para a configuração e toque em Próximo.

  3. Especifique os seguintes detalhes para o serviço RESTful:

    • Selecione URL ou Arquivo no menu suspenso Fonte do Swagger e especifique o URL do Swagger para o arquivo de definição do Swagger ou faça upload do arquivo Swagger do sistema de arquivos local.

    • Com base na entrada Origem do Swagger, os seguintes campos são pré-preenchidos com valores:

      • Regime: Os protocolos de transferência usados pela REST API. O número de tipos de esquema exibidos na lista suspensa depende dos esquemas definidos na origem do Swagger.

      • Host: O nome do domínio ou endereço IP do host que serve a REST API. É um campo obrigatório.

      • Caminho básico: O prefixo de URL para todos os caminhos de API. É um campo opcional.\

        Se necessário, edite os valores pré-preenchidos para esses campos.

    • Selecione o tipo de autenticação — Nenhum, OAuth2.0, Autenticação básica, Chave da API, Autenticação personalizada ou Autenticação mútua — para acessar o serviço RESTful e, portanto, fornecer detalhes para autenticação.

    Se você selecionar a chave da API como o tipo de autenticação, especifique o valor para a chave da API. A chave da API pode ser enviada como um cabeçalho de solicitação ou como um parâmetro de query. Selecione uma dessas opções na lista suspensa Local e especifique o nome do parâmetro header ou query no campo Nome do parâmetro de acordo.

    Se você selecionar Autenticação ​Mútua como o tipo de autenticação, consulte Autenticação mútua baseada em certificados para os serviçosda Web RESTful e SOAP.

  4. Toque em Criar para criar a configuração de nuvem para o serviço RESTful.

Configurar serviços Web SOAP

Os serviços Web baseados em SOAP são descritos usando as especificações WSDL (Web Services Description Language). 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:

  1. Vá até Ferramentas > Cloud Services > Fontes de dados. Toque em para selecionar a pasta na qual deseja criar uma configuração de nuvem.

    Consulte Configurar pasta para configurações de serviço em nuvem para obter informações sobre como criar e configurar uma pasta para configurações de serviço em nuvem.

  2. Toque em Criar para abrir o assistente ​Criar configuração de fonte de dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione SOAP Web Service no menu suspenso Tipo de serviço, navegue e selecione uma imagem em miniatura para a configuração e toque em Próximo.

  3. Especifique o seguinte para o serviço da Web SOAP:

    • URL WSDL para o serviço da Web.

    • Terminal de serviço. Especifique um valor neste campo para substituir o ponto de extremidade de serviço mencionado em WSDL.

    • Selecione o tipo de autenticação — Nenhum, OAuth2.0, Autenticação básica, Autenticação personalizada, Token X509 ou Autenticação mútua — para acessar o serviço SOAP e, portanto, fornecer os detalhes para autenticação.

      Se você selecionar Token ​X509 como o tipo de autenticação, configure o certificado X509. Para obter mais informações, consulte Configurar certificados.
      Especifique o alias KeyStore para o certificado X509 no campo Alias de chave. Especifique o tempo, em segundos, até que a solicitação de autenticação permaneça válida, no campo Tempo de ativação . Como opção, selecione para assinar o corpo da mensagem ou o cabeçalho do carimbo de data e hora ou ambos.

      Se você selecionar Autenticação ​Mútua como o tipo de autenticação, consulte Autenticação mútua baseada em certificados para os serviçosda Web RESTful e SOAP.

  4. Toque em Criar para criar a configuração de nuvem para o serviço Web SOAP.

Configurar serviços OData

Um serviço OData é identificado pelo URL raiz do serviço. Para configurar um serviço OData nos serviços de nuvem do AEM, verifique se você tem o URL raiz do serviço e execute este procedimento:

Observação

Para obter um guia passo a passo para configurar o Microsoft Dynamics 365, online ou no local, consulte Configuração doMicrosoft Dynamics OData.

  1. Vá até Ferramentas > Cloud Services > Fontes de dados. Toque em para selecionar a pasta na qual deseja criar uma configuração de nuvem.

    Consulte Configurar pasta para configurações de serviço em nuvem para obter informações sobre como criar e configurar uma pasta para configurações de serviço em nuvem.

  2. Toque em Criar para abrir o assistente ​Criar configuração de fonte de dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço ​OData no menu suspenso Tipo de serviço, navegue e selecione uma imagem em miniatura para a configuração e toque em Próximo.

  3. Especifique os seguintes detalhes para o serviço OData:

    • URL raiz do serviço para o serviço OData a ser configurado.
    • Selecione o tipo de autenticação — Nenhum, OAuth2.0, Autenticação básica ou Autenticação personalizada — para acessar o serviço OData e, portanto, fornecer os detalhes para autenticação.
    Observação

    Você deve selecionar o tipo de autenticação OAuth 2.0 para se conectar aos serviços do Microsoft Dynamics usando o terminal OData como a raiz do serviço.

  4. Toque em Criar para criar a configuração de nuvem para o serviço OData.

Autenticação mútua baseada em certificados para serviços Web RESTful e SOAP

Quando você habilita a autenticação mútua para o modelo de dados de formulário, a fonte de dados e o servidor AEM executando o modelo de dados de formulário autenticam a identidade uns dos outros antes de compartilhar quaisquer dados. Você pode usar autenticação mútua para conexões com base em REST e SOAP (fontes de dados). Para configurar a autenticação mútua para um modelo de dados de formulário no ambiente AEM Forms:

  1. Carregue a chave privada (certificado) no AEM Forms servidor. Para carregar a chave privada:
    1. Faça logon no seu AEM Forms servidor como administrador.
    2. Navegue até Ferramentas > Segurança > Usuários. Selecione o fd-cloudservice usuário e toque em Propriedades.
    3. Abra a guia Keystore , expanda a opção Adicionar chave privada do arquivo KeyStore, carregue o arquivo KeyStore, especifique os alias, as senhas e toque em Enviar. O Certificado é carregado. O alias da chave privada é mencionado no certificado e definido ao criar o certificado.
  2. Carregue o certificado de confiança no Arquivo de Confiança Global. Para carregar o certificado:
    1. Navegue até Ferramentas > Segurança > Armazenamento de confiança.
    2. Expanda a opção Adicionar certificado do arquivo CER, toque em Selecionar arquivo de certificado, carregue o certificado e toque em Enviar.
  3. Configure os serviços Web SOAP ou RESTful como a fonte de dados e selecione Autenticação ​mútua como o tipo de autenticação. Se você configurar vários certificados autoassinados para fd-cloudservice o usuário, especifique o nome do Alias da chave para o certificado.

Próximos passos

Você configurou as fontes de dados. Em seguida, é possível criar um modelo de dados de formulário ou, se você já tiver criado um modelo de dados de formulário sem uma fonte de dados, associá-lo às fontes de dados que acabou de configurar. Consulte Criar modelo de dados de formulário para obter detalhes.

Nesta página