Configurar fontes de dados

Integração de dados

Experience Manager Forms A Integração de dados permite configurar e conectar-se a fontes de dados diferentes. Os seguintes tipos são suportados imediatamente:

  • Serviços Web RESTful
  • Serviços Web baseados em SOAP
  • Serviços OData (Versão 4.0)
  • Microsoft Dynamics
  • SalesForce
  • Armazenamento de blobs do Microsoft Azure

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. Enquanto os serviços RESTful, baseados em SOAP e OData são configurados em Experience Manager as a Cloud Service e conector para Experience Manager o perfil de usuário é configurado em Experience Manager console da Web.

OBSERVAÇÃO

Experience Manager Forms não suporta banco de dados relacional.

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

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 em nuvem em Experience Manager são consolidadas no /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 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 configurações do serviço de nuvem.

Para configurar a pasta das 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 do serviço de nuvem.

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

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

    3. Toque 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. No Criar configuração , especifique um título para a pasta e habilite Configurações da nuvem.

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

Configurar serviços Web RESTful

O serviço Web RESTful pode ser descrito 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 a variável Swagger file (Swagger versão 2.0) no sistema de arquivos ou no URL onde o arquivo está hospedado.

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

  1. Ir 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 cloud service.

  2. Toque Criar para abrir o Assistente para Criar Configuração da Fonte de Dados. Especificar um nome e, opcionalmente, um título para a configuração, selecione Serviço RESTful do Tipo de serviço como opçã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 o URL ou o arquivo do Origem do Swagger e especifique a variável Swagger URL para​ Swagger arquivo de definição ou upload do Swagger do seu sistema de arquivos local.

    • Com base na​ Swagger Entrada de origem, 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 variável Swagger fonte.

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

      • Caminho básico: O prefixo do URL para todos os caminhos da 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 ou Autenticação Personalizada — para acessar o serviço RESTful e, de acordo, fornecer detalhes para autenticação.

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

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

Modelo de dados de formulário Configuração do cliente HTTP para otimizar o desempenho

Experience Manager Forms O modelo de dados de formulário 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 Modelo de dados de formulário Configuração do cliente HTTP 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 e os serviços da Web RESTful. O valor padrão é 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 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 tempo para 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"
}

Para definir valores de uma configuração, Gerar configurações de OSGi usando o SDK AEMe implantar a configuração para a instância do Cloud Service.

Execute as seguintes etapas para configurar o cliente HTTP do modelo de dados de formulário:

  1. Faça logon em Experience Manager Forms Instância do autor como administrador e acesse Experience Manager pacotes do console da web. O URL padrão é https://localhost:4502/system/console/configMgr.

  2. Toque Modelo de dados de formulário Configuração do cliente HTTP para fonte de dados REST.

  3. No Modelo de dados de formulário Configuração do cliente HTTP para fonte de dados REST caixa de 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 no total campo. O valor padrão é 20 conexões.

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

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

    • Especifique a duração, para a qual a variável Experience Manager Forms O servidor aguarda que uma conexão seja estabelecida no Tempo limite da conexão campo. O valor padrão é de 10 segundos.

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

Configurar serviços Web SOAP

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

Para configurar o serviço da Web baseado em SOAP em Experience Manager as a Cloud Service, certifique-se de ter o URL WSDL para o serviço da Web e faça o seguinte:

  1. Ir 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 cloud service.

  2. Toque Criar para abrir o Assistente para Criar Configuração da Fonte de Dados. Especificar um nome e, opcionalmente, um título para a configuração, selecione Serviço Web SOAP do Tipo de serviço como opçã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 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 ou Autenticação Personalizada — para acessar o serviço SOAP e fornecer os detalhes para autenticação.

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

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

Você pode especificar uma expressão regular que serve como filtro para URLs absolutos permitidos como declarações de importação no WSDL de serviços da Web SOAP. Por padrão, não há valor neste 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 declarações de importação.

Defina as importAllowlistPattern da de Importação de Serviços 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 AEMe implantar a configuração para a instância do Cloud Service.

Configurar serviços OData

Um serviço OData é identificado por seu URL raiz do serviço. Para configurar um serviço OData em Experience Manager as a Cloud Service, certifique-se de ter o URL raiz do serviço e faça o seguinte:

OBSERVAÇÃO

Suporte ao modelo de dados de formulário OData versão 4.
Para obter o guia passo a passo da configuração do Microsoft Dynamics 365, em linha ou no local, consulte Microsoft Dynamics Configuração de OData.

  1. Ir 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 cloud service.

  2. Toque Criar para abrir o Assistente para Criar Configuração da Fonte de Dados. Especificar um nome e, opcionalmente, um título para a configuração, selecione Serviço OData do Tipo de serviço como opçã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 do serviço OData a ser configurado.
    • Selecione o tipo de autenticação — Nenhum, OAuth2.0, Autenticação Básica, Chave da API ou Autenticação Personalizada — para acessar o serviço OData e fornecer os detalhes para autenticação.

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

    OBSERVAÇÃO

    Você deve selecionar o tipo de autenticação OAuth 2.0 com o qual se conectar Microsoft Dynamics serviços que usam o ponto de extremidade OData como a raiz do serviço.

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

Próximas etapas

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.

Nesta página