Configurar fontes de dados configure-data-sources
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:
- Habilite a rede avançada por meio da API do Cloud Manager, já que as portas são desativadas por padrão.
- Adicionar dependências de driver JDBC no Maven.
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:
-
Ir para Experience Manager console da web em
https://server:host/system/console/configMgr
. -
Localizar Pools de Conexões JDBC do Day Commons configuração. Selecione 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 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. -
-
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.
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:
-
Ir para Ferramentas > Geral > Navegador de configuração.
- Consulte a Navegador de configuração para obter mais informações.
-
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.
-
No Navegador de configuração, selecione o
global
e selecione Propriedades. -
No Propriedades de configuração caixa de diálogo, ativar Configurações da nuvem.
-
Selecionar Salvar e fechar para salvar a configuração e sair do diálogo.
-
-
No Navegador de configuração, selecione Criar.
-
No Criar configuração , especifique um título para a pasta e habilite Configurações da nuvem.
-
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
-
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.
-
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.
-
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.
-
-
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
-
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.
-
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.
-
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.
-
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 modelo de dados de formulário 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
propriedade para definir o número máximo de conexões permitidas entre o modelo de dados de formulário 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"
}
-
Selecionar Configuração do cliente HTTP do modelo de dados de formulário para fonte de dados REST.
-
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 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:
-
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.
-
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.
-
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.
-
-
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:
Para obter um guia passo a passo para configurar o Microsoft®® Dynamics 365on-line ou no local, consulte Microsoft® Dynamics Configuração OData.
-
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.
-
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.
-
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. -
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ê pode 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, poderá associá-lo às fontes de dados configuradas. Consulte Criar modelo de dados de formulário para obter detalhes.