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

Experience Manager Forms A Integração de dados permite configurar e conectar-se a diferentes fontes de dados. 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 é compatível com OAuth2.0(Código de autorização, Credenciais do cliente), Autenticação básica e Autenticação de chave de API tipos prontos para uso e permite a implementação de autenticação personalizada para acessar serviços da Web. Enquanto os serviços RESTful, baseados em SOAP e OData são configurados em Experience Manager as a Cloud Service, JDBC para bancos de dados relacionais e conector para Experience Manager O perfil do usuário está configurado em Experience Manager console da web.

Configurar banco de dados relacional configure-relational-database

Pré-requisitos

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

Etapas para configurar um banco de dados relacional

É possível configurar bancos de dados relacionais usando Experience Manager Configuração do console da Web. Faça o seguinte:

  1. Ir para Experience Manager console da web em https://server:host/system/console/configMgr.

  2. Localizar Pools de Conexões JDBC do Day Commons configuração. 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 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 DataSourcePool do JDBC para obter informações mais detalhadas.
  4. Selecionar 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 em nuvem no Experience Manager são consolidados na /conf pasta em Experience Manager repositório. Por padrão, a variável conf a pasta contém o global pasta onde você pode criar configurações do cloud service. 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 configurações do cloud service.

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

  1. Ir 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 o global e selecione Propriedades.

    2. No Propriedades de configuração caixa de diálogo, ativar Configurações da nuvem.

    3. Selecionar Salvar e fechar para salvar a configuração e sair do diálogo.

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

  4. No Criar configuração , especifique um título para a pasta e habilite Configurações da nuvem.

  5. Selecionar Criar para criar a pasta habilitada para configurações do cloud service.

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 Swagger arquivo de definição. Para configurar o serviço Web RESTful no Experience Manager as a Cloud Service, certifique-se de ter o Swagger arquivo (Versão 2.0 do Swaggerou Swagger arquivo (Versão 3.0 do Swagger) no sistema de arquivos ou no URL em que 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. Ir para 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 em nuvem para obter informações sobre como criar e configurar uma pasta para configurações do cloud service.

  2. Selecionar Criar para abrir o Assistente para Criar Configuração da Fonte de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço RESTful do Tipo de serviço opção, procure e selecione uma imagem em miniatura para a configuração e Próxima.

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

    • Selecione um URL ou arquivo na Origem do Swagger e especificar de acordo as Swagger URL para o​ Swagger arquivo de definição ou carregue o Swagger do seu sistema de arquivos local.

    • Com base no​ Swagger Entrada de origem. 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 variável Swagger origem.
      • 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, de acordo, fornecer detalhes 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 Localização e especifique o nome do cabeçalho ou do parâmetro de consulta na lista suspensa Nome do parâmetro em conformidade.

  4. Selecionar 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. Ir para 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 em nuvem para obter informações sobre como criar e configurar uma pasta para configurações do cloud service.

  2. Selecionar Criar para abrir o Assistente para Criar Configuração da Fonte de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço RESTful do Tipo de serviço opção, procure e selecione uma imagem em miniatura para a configuração e Próxima.

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

    • Selecione um URL ou arquivo na Origem do Swagger e especificar de acordo as Swagger 3.0 URL para o​ Swagger arquivo de definição ou carregue o Swagger do seu sistema de arquivos local.
    • Com base no​ Swagger Entrada de origem, 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, de acordo, fornecer detalhes 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 Localização e especifique o nome do cabeçalho ou do parâmetro de consulta na lista suspensa Nome do parâmetro em conformidade.

  4. Selecionar 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 Especificação do 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

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

Defina as seguintes propriedades da variável Configuração do cliente HTTP do modelo de dados de formulário para fonte de dados REST configuração para especificar a expressão regular:

  • Use o 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 o 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 o 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 o http.connection.timeout propriedade para especificar a duração, para a qual a variável Experience Manager Forms o servidor aguarda uma conexão ser estabelecida. O valor padrão é de 10 segundos.

  • Use o 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. Selecionar Configuração do cliente HTTP do modelo de dados de formulário para fonte de dados REST.

  2. No Configuração do cliente HTTP do modelo de dados de formulário para fonte de dados REST diálogo:

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

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

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

    • Especificar a duração, para a qual o Experience Manager Forms o servidor aguarda uma conexão ser estabelecida, no campo Tempo limite da conexão campo. O valor padrão é de 10 segundos.

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

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

Os serviços da Web baseados em SOAP são descritos usando Especificações da Web Services Description Language (WSDL). Experience Manager Forms não oferecem suporte ao modelo WSDL estilo RPC.

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

  1. Ir para 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 em nuvem para obter informações sobre como criar e configurar uma pasta para configurações do cloud service.

  2. Selecionar Criar para abrir o Assistente para Criar Configuração da Fonte de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço da Web SOAP do Tipo de serviço opção, procure e selecione uma imagem em miniatura para a configuração e Próxima.

  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. Selecionar Criar para criar a configuração de nuvem do serviço da Web SOAP.

Habilitar o uso de instruções de importação em 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 instruções de importação em 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 permite todas as instruções de importação.

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

{
  "importAllowlistPattern": ".*"
}

Para definir valores de uma configuração, Gerar configurações de OSGi usando o SDK do AEM, e implantar a configuração para a 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 no Experience Manager as a Cloud Service, verifique se você tem um URL raiz de serviço para o serviço e faça o seguinte:

NOTE
O modelo de dados de formulário (FDM) é compatível OData versão 4.
Para obter um guia passo a passo para configurar o Microsoft®® Dynamics 365on-line ou no local, consulte Microsoft® Dynamics Configuração OData.
  1. Ir para 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 em nuvem para obter informações sobre como criar e configurar uma pasta para configurações do cloud service.

  2. Selecionar Criar para abrir o Assistente para Criar Configuração da Fonte de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço OData do Tipo de serviço opção, procure e selecione uma imagem em miniatura para a configuração e Próxima.

  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), Autenticação Básica, Chave de API ou Autenticação Personalizada — para acessar o serviço OData e, de acordo, fornecer os detalhes 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 Localização e especifique o nome do cabeçalho ou do parâmetro de consulta na lista suspensa Nome do parâmetro em conformidade.

    note note
    NOTE
    Selecione o tipo de autenticação do OAuth 2.0 com o qual se conectar Microsoft®® Dynamics serviços usando o ponto de extremidade OData como a raiz do serviço.
  4. Selecionar 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