Configurar fontes de dados configure-data-sources

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 permite que você configure e se conecte a fontes de dados diferentes. Os seguintes tipos são prontos para uso:

  • Bancos de dados relacionais - MySQL, Microsoft® SQL Server, IBM® DB2®, postgreSQL e Oracle RDBMS
  • Serviços Web RESTful
  • Serviços da Web com base em SOAP
  • Serviços OData (Versão 4.0)
  • Microsoft® Dynamics
  • Força de vendas
  • Armazenamento Microsoft® Azure Blob

A integração de dados oferece suporte aos tipos de autenticação OAuth2.0(Código de Autorização, Credenciais de Cliente), Autenticação Básica e Chave de API prontos para uso, e permite a implementação de autenticação personalizada para acessar serviços Web. Enquanto os serviços RESTful, SOAP-based, e OData estão configurados no as a Cloud Service do Experience Manager, o JDBC para bancos de dados relacionais e o conector para o perfil de usuário do Experience Manager estão configurados no console Web do Experience Manager.

Configurar banco de dados relacional configure-relational-database

Pré-requisitos

Antes de configurar bancos de dados relacionais usando a Configuração do Console da Web Experience Manager, é obrigatório:

Etapas para configurar um banco de dados relacional

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

  1. Vá para o console Web Experience Manager em https://server:host/system/console/configMgr.

  2. Localize a configuração Pools de Conexões JDBC do Day Commons. Selecione para abrir a configuração no modo de edição.

    Pool do Conector JDBC

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

    • Nome da classe Java™ para o driver JDBC

    • URI da conexão JDBC

    • Nome de usuário e senha para estabelecer conexão com o driver JDBC

    • Especifique uma consulta SQL SELECT no campo Consulta de Validação para validar as conexões do pool. A consulta deve retornar pelo menos uma linha. Com base no seu banco de dados, especifique uma das seguintes opções:

      • SELECT 1 (MySQL e MS® SQL)
      • SELECIONE 1 no duplo (Oracle)
    • Nome da fonte de dados

    Exemplo de cadeias de caracteres para configurar um banco de dados relacional:

    code language-text
       "datasource.name": "sqldatasourcename-mysql",
       "jdbc.driver.class": "com.mysql.jdbc.Driver",
       "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
    
    note note
    NOTE
    Consulte Conexões SQL usando o JDBC DataSourcePool para obter informações mais detalhadas.
  4. Selecione Salvar para salvar a configuração.

Agora, você pode usar o banco de dados relacional configurado com seu Modelo de dados de formulário (FDM).

Configurar pasta para configurações do serviço em nuvem cloud-folder

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

Todas as configurações do serviço de nuvem em Experience Manager são consolidadas na pasta /conf no repositório Experience Manager. Por padrão, a pasta conf contém a pasta global, na qual você pode criar configurações do serviço de nuvem. No entanto, você deve habilitá-lo manualmente para configurações de nuvem. Você também pode criar pastas adicionais no conf para criar e organizar as configurações do serviço de nuvem.

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

  1. Vá para Ferramentas > Geral > Navegador de Configuração.

  2. 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 de serviço de nuvem.

    1. No Navegador de Configuração, selecione a pasta global e selecione Propriedades.

    2. Na caixa de diálogo Propriedades da Configuração, habilite as Configurações de Nuvem.

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

  3. No Navegador de Configuração, selecione Criar.

  4. Na caixa de diálogo Criar Configuração, especifique um título para a pasta e habilite as Configurações de Nuvem.

  5. Selecione Criar para criar a pasta habilitada para configurações do serviço de nuvem.

Configurar serviços Web RESTful configure-restful-web-services

Os serviços Web RESTful podem ser descritos usando especificações do Swagger no formato JSON ou YAML em um arquivo de definição Swagger. Para configurar o serviço Web RESTful em Experience Manager as a Cloud Service, verifique se você tem o arquivo Swagger (Swagger Versão 2.0) ou o arquivo Swagger (Swagger Versão 3.0) no seu sistema de arquivos ou na URL onde o arquivo está hospedado.

Configurar serviços RESTful para a Especificação de API aberta versão 2.0 configure-restful-services-open-api-2.0

  1. Acesse Ferramentas > Cloud Service > Fontes de dados. Selecione para selecionar a pasta na qual 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.

  2. Selecione Criar para abrir o Assistente de Criação de Configuração de Source 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, opcionalmente, procure e selecione uma imagem em miniatura para a configuração e selecione Próximo.

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

    • Selecione uma URL ou um Arquivo no menu suspenso Swagger Source e especifique o Swagger URL para o arquivo de definição ​ Swagger ou carregue o arquivo Swagger do seu sistema de arquivos local.

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

      • Esquema: os protocolos de transferência usados pela API REST. O número de tipos de esquema exibidos na lista suspensa depende dos esquemas definidos na origem Swagger.
      • Host: o nome do domínio ou endereço IP do host que serve a API REST. É um campo obrigatório.
      • Caminho base: o prefixo do URL para todos os caminhos da API. É um campo opcional.
        Se necessário, edite os valores pré-preenchidos nesses campos.
    • Selecione o tipo de autenticação — None, OAuth2.0(Código de Autorização, Credenciais do Cliente), Autenticação Básica, Chave de API ou Autenticação Personalizada — para acessar o serviço RESTful e fornecer os detalhes correspondentes para autenticação.

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

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

Configurar serviços RESTful para a Especificação de API aberta versão 3.0 configure-restful-services-open-api-3.0

  1. Acesse Ferramentas > Cloud Service > Fontes de dados. Selecione para selecionar a pasta na qual 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.

  2. Selecione Criar para abrir o Assistente de Criação de Configuração de Source 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, opcionalmente, procure e selecione uma imagem em miniatura para a configuração e selecione Próximo.

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

    • Selecione uma URL ou um Arquivo no menu suspenso Swagger Source e especifique o Swagger 3.0 URL para o arquivo de definição ​ Swagger ou carregue o arquivo Swagger do seu sistema de arquivos local.
    • Com base na entrada do Source ​ Swagger, as informações de conexão com o servidor de destino são exibidas.
    • Selecione o tipo de autenticação — None, OAuth2.0(Código de Autorização, Credenciais do Cliente), Autenticação Básica, Chave de API ou Autenticação Personalizada — para acessar o serviço RESTful e fornecer os detalhes correspondentes para autenticação.

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

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

Algumas das operações não suportadas pela Especificação da API aberta dos serviços RESTful versão 3.0 são:

  • Retornos de chamada
  • um/qualquer um
  • Referência remota
  • Links
  • Diferentes corpos de solicitação para diferentes tipos MIME para uma única operação

Consulte a Especificação da OpenAPI 3.0 para obter informações detalhadas.

Configuração do cliente HTTP do Form Data Model (FDM) para otimizar o desempenho fdm-http-client-configuration

O Experience Manager Forms forma um modelo de dados ao integrar com serviços Web RESTful como fonte de dados inclui configurações de cliente HTTP para otimização de desempenho.

Defina as seguintes propriedades da configuração do Configuração do Cliente HTTP do Modelo de Dados de Formulário para a fonte de dados REST para especificar a expressão regular:

  • Use a propriedade http.connection.max.per.route para definir o número máximo de conexões permitidas entre o modelo de dados de formulário (FDM) e os serviços Web RESTful. O valor padrão é de 20 conexões.

  • Use a propriedade http.connection.max para especificar o número máximo de conexões permitidas para cada rota. O valor padrão é 40 conexões.

  • Use a propriedade http.connection.keep.alive.duration para especificar a duração, para a qual uma conexão HTTP persistente é mantida ativa. O valor padrão é de 15 segundos.

  • Use a propriedade http.connection.timeout para especificar a duração pela qual o servidor Experience Manager Forms aguarda o estabelecimento de uma conexão. O valor padrão é de 10 segundos.

  • Use a propriedade http.socket.timeout para especificar o período máximo de inatividade entre dois pacotes de dados. O valor padrão é de 30 segundos.

O seguinte arquivo JSON exibe uma amostra:

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}
  1. Selecione Configuração do Cliente HTTP do Modelo de Dados de Formulário para a fonte de dados REST.

  2. Na caixa de diálogo Configuração do Cliente HTTP do Modelo de Dados de Formulário para a fonte de dados REST:

    • Especifique o número máximo de conexões permitidas entre o FDM (modelo de dados de formulário) e os serviços Web RESTful no campo Limite de conexão no total. O valor padrão é de 20 conexões.

    • Especifique o número máximo de conexões permitidas para cada rota no campo Limite de conexão por rota. O valor padrão é duas conexões.

    • Especifique a duração, para a qual uma conexão HTTP persistente é mantida ativa, no campo Keep alive. O valor padrão é de 15 segundos.

    • No campo Tempo limite de conexão, especifique a duração pela qual o servidor Experience Manager Forms aguarda o estabelecimento de uma conexão. O valor padrão é de 10 segundos.

    • Especifique o período máximo de inatividade entre dois pacotes de dados no campo Tempo limite do soquete. O valor padrão é de 30 segundos.

Configurar serviços Web SOAP configure-soap-web-services

Os serviços Web baseados em SOAP são descritos usando as especificações WSDL (Web Services Description Language). Experience Manager Forms não dá suporte ao modelo WSDL de estilo RPC.

Para configurar o serviço da Web com base em SOAP no Experience Manager as a Cloud Service, verifique se você tem a URL WSDL para o serviço da Web e faça o seguinte:

  1. Acesse Ferramentas > Cloud Service > Fontes de dados. Selecione para selecionar a pasta na qual 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.

  2. Selecione Criar para abrir o Assistente de Criação de Configuração de Source de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço Web SOAP no menu suspenso Tipo de Serviço, opcionalmente, procure e selecione uma imagem em miniatura para a configuração e selecione Próximo.

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

    • URL WSDL do serviço Web.

    • Ponto de Extremidade de Serviço. Especifique um valor neste campo para substituir o ponto final de serviço mencionado no WSDL.

    • Selecione o tipo de autenticação — None, OAuth2.0(Código de Autorização, Credenciais do Cliente), Autenticação Básica ou Autenticação Personalizada — para acessar o serviço SOAP e fornecer os detalhes de autenticação de acordo.

  4. Selecione Criar para criar a configuração de nuvem do serviço Web SOAP.

Ativar o uso de instruções de importação no WSDL de serviços Web SOAP enable-import-statements

Você pode especificar uma expressão regular que serve como filtro para URLs absolutos que são permitidos como declarações de importação no WSDL de serviços Web SOAP. Por padrão, não há nenhum valor nesse campo. Como resultado, Experience Manager bloqueia todas as instruções de importação disponíveis no WSDL. Se você especificar .* como o valor neste campo, Experience Manager permitirá todas as instruções de importação.

Defina a propriedade importAllowlistPattern da configuração Importação de serviços da Web SOAP Incluir na lista de permissões do modelo de dados de formulário para especificar a expressão regular. O seguinte arquivo JSON exibe uma amostra:

{
  "importAllowlistPattern": ".*"
}

Para definir valores de uma configuração, Gere Configurações OSGi usando o SDK do AEM e implante a configuração na instância do Cloud Service.

Configurar serviços OData config-odata

Um serviço OData é identificado por sua URL raiz de serviço. Para configurar um serviço OData em Experience Manager as a Cloud Service, verifique se você tem uma URL raiz de serviço para o serviço e faça o seguinte:

NOTE
O FDM (Modelo de Dados de Formulário) dá suporte à OData versão 4.
Para obter um guia passo a passo para configurar o Microsoft®® Dynamics 365, online ou no local, consulte Microsoft® Dynamics Configuração OData.
  1. Acesse Ferramentas > Cloud Service > Fontes de dados. Selecione para selecionar a pasta na qual 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.

  2. Selecione Criar para abrir o Assistente de Criação de Configuração de Source de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço OData na lista suspensa Tipo de Serviço, opcionalmente, procure e selecione uma imagem em miniatura para a configuração e selecione Próximo.

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

    • URL da Raiz de Serviço do serviço OData a ser configurado.
    • Selecione o tipo de autenticação — None, OAuth2.0(Código de Autorização, Credenciais do Cliente), Basic Authentication, API Key ou Custom Authentication — para acessar o serviço OData e fornecer os detalhes de autenticação de acordo.

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

    note note
    NOTE
    Selecione o tipo de autenticação OAuth 2.0 para se conectar com os serviços do Microsoft®® Dynamics usando o ponto de extremidade OData como raiz de serviço.
  4. Selecione Criar para criar a configuração de nuvem para o serviço OData.

Próximas etapas next-steps

Você configurou as fontes de dados. Em seguida, você poderá criar um Modelo de dados de formulário (FDM) ou, se já tiver criado um Modelo de dados de formulário (FDM) sem uma fonte de dados, poderá associá-lo às fontes de dados configuradas. Consulte Criar modelo de dados de formulário para obter detalhes.

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