Ir para o conteúdo

Fonte de dados REST no Jitterbit App Builder

Introdução

A fonte de dados REST permite conectar o App Builder a vários servidores REST (incluindo outras instâncias do App Builder) ou para uso com objetos REST. A configuração de um servidor de fonte de dados REST é utilizada em todos os endpoints REST.

Configurar uma fonte de dados REST envolve os seguintes passos:

  1. Criar um servidor de fonte de dados REST.

  2. Configurar cabeçalhos de requisição.

  3. Configurar parâmetros de string de consulta.

  4. Criar endpoints REST para cada método de API sendo chamado.

  5. Adicionar endpoints REST.

  6. (Opcional) Substituir tipos de conteúdo de requisição/resposta do endpoint.

  7. (Opcional) Configurar paginação de resposta.

Desde o App Builder 4.45, você também pode criar um endpoint REST a partir de um documento OpenAPI.

Criar um servidor de dados REST

Para criar um servidor de dados REST, siga estes passos:

  1. Selecione IDE > Servidores de Dados.

  2. Clique no botão + Servidor.

  3. Na seção Configurações do Servidor, defina os seguintes campos:

    • Nome do Servidor: Insira um nome para o servidor REST.

    • Tipo: Abra o menu, depois encontre e selecione REST API.

    • Url: Insira a URL do servidor ao qual se conectar.

      Nota

      Os endpoints são configurados na próxima seção.

    • Tipo de Conteúdo da Requisição e Tipo de Conteúdo da Resposta: Selecione os tipos de conteúdo da requisição e da resposta. (Normalmente, servidores REST se comunicam via JSON.)

  4. (Opcional) Expanda a seção Configurações de Segurança, depois defina o seguinte:

    • Provedor de Segurança: Abra o menu, depois encontre e selecione o provedor de segurança necessário.

    • Nome de Usuário: Insira o nome de usuário para o serviço do provedor de segurança.

    • Senha: Insira a senha para o serviço do provedor de segurança.

    Dica

    A maioria das APIs REST utiliza uma chave de API no cabeçalho (configurada em uma seção posterior).

  5. (Opcional) Descrição: Insira uma descrição para este servidor.

  6. Clique no botão Salvar e, em seguida, feche o diálogo.

Você deve ver seu Servidor de Dados REST na lista de Servidores de Dados.

Configurar cabeçalhos de solicitação

A maioria dos serviços REST exige que você passe uma chave de API usando o cabeçalho da solicitação.

Para configurar o cabeçalho da solicitação, siga estas etapas:

  1. Selecione IDE > Servidores de Dados.

  2. Clique no botão Detalhes para seu novo servidor de dados REST.

  3. No painel Parâmetros do Serviço Web, clique no botão + Parâmetro. Uma nova linha aparece no painel. Defina os valores da seguinte forma:

    • Tipo: Abra o menu e selecione Cabeçalho.

    • Nome: Insira o nome do parâmetro do cabeçalho. (Para servidores REST do App Builder, a chave da API é passada usando "X-API-Key".)

    • Valor: Insira o valor do parâmetro do cabeçalho.

    • Tipo de Uso: Abra o menu e selecione o tipo de uso para este parâmetro.

  4. Clique no ícone para salvar o parâmetro.

Configurar parâmetros de string de consulta

Se você tiver parâmetros de string de consulta comuns para usar em diferentes pontos finais, pode configurá-los seguindo estas etapas:

  1. Selecione IDE > Servidores de Dados.

  2. Clique no botão Detalhes para seu novo servidor de dados REST.

  3. No painel Parâmetros do Serviço Web, clique no botão + Parâmetro. Uma nova linha aparece no painel. Defina os valores na linha da seguinte forma:

    • Tipo: Consulta

    • Nome: Insira o nome do parâmetro da string de consulta.

    • Valor: Insira o valor do parâmetro da string de consulta.

    • Tipo de Uso: Abra o menu e selecione o tipo de uso para este parâmetro.

  4. Clique no ícone para salvar o parâmetro do servidor web.

Adicionar endpoints REST

Uma vez que seu Servidor de Dados REST tenha sido configurado, você pode adicionar endpoints de API.

Para adicionar um endpoint, siga estas etapas:

  1. Selecione IDE > Servidores de Dados.

  2. Clique no botão Detalhes para seu novo servidor de dados REST.

  3. No painel Endpoints, clique no botão + Endpoint. Uma nova linha aparece no painel. Defina os valores na linha da seguinte forma:

    • Nome: Insira o nome do endpoint.

    • Endpoint: Insira o endpoint. (Esse valor é anexado à URL do Servidor de Dados REST definida em uma seção anterior.)

    • Método: Selecione o método HTTP para o endpoint.

  4. Clique no ícone para salvar o endpoint.

Substituir tipos de conteúdo de solicitação/resposta do endpoint

O valor padrão para os tipos de conteúdo de Solicitação e Resposta é herdado do tipo de conteúdo do servidor. Os valores de tipo de conteúdo disponíveis são os seguintes:

  • Arquivo
  • Formulário
  • JSON
  • Multipart
  • Texto Simples
  • XML

Para substituir os tipos de conteúdo de solicitação ou resposta do endpoint, siga estas etapas:

  1. No painel Endpoints, selecione Mais > Caso de Bordas. A caixa de diálogo Caso de Bordas do Endpoint é aberta.

  2. Clique no botão Editar.

  3. Na seção Tipo de Conteúdo, defina os valores para o seguinte:

    • Solicitação: Abra o menu e selecione o tipo de conteúdo de solicitação que está substituindo.

    • Resposta: Abra o menu e selecione o tipo de conteúdo de resposta que está substituindo.

  4. Clique no botão Salvar e, em seguida, feche a caixa de diálogo.

  5. Para revisar a consulta proposta, clique no botão Descobrir. A caixa de diálogo Endpoint é aberta.

  6. Na caixa de diálogo Endpoint, clique no botão Descobrir para executar a consulta. Esta ação faz o seguinte:

    • Gera parâmetros de entrada para qualquer entrada de exemplo inserida.

    • Gera tabelas de saída para quaisquer dados retornados pelo endpoint.

  7. Feche a caixa de diálogo Endpoint.

  8. Na seção Endpoints, clique no botão Testar Conexão e, em seguida, clique no botão Prosseguir para chamar o endpoint. Se os parâmetros de entrada estiverem definidos, seus valores de teste serão enviados.

Configurar paginação de resposta

Para configurar a paginação de resposta, siga estas etapas:

  1. Selecione IDE > Servidores de Dados.

  2. Clique no botão Detalhes para seu novo servidor de dados REST.

  3. No painel Parâmetros do Serviço Web, clique no botão + Parâmetro. Uma nova linha aparece no painel. Defina os valores na linha da seguinte forma:

    • Tipo: Consulta

    • Nome: Insira a string esperada pelo serviço. (Exemplos incluem Limit, _limit.)

    • Valor: Insira o número de registros por página.

    • Tipo de Uso: Abra o menu e selecione Limite de Solicitação.

  4. Clique no ícone para salvar o parâmetro.

  5. Clique no botão + Parâmetro. Uma nova linha aparece no painel. Escolha um dos seguintes métodos de paginação e defina os valores de acordo da seguinte forma:

    • Deslocamento da Solicitação: Faça o serviço pular um número de registros. Defina os valores na linha da seguinte forma:

      • Tipo: Consulta

      • Nome: Deslocamento da Solicitação

      • (Opcional) Valor: Insira o número de registros a serem pulados.

      • Tipo de Uso: Abra o menu e selecione Deslocamento da Solicitação.

    • Número da Página da Solicitação: Busque um número de página específico. Defina os valores na linha da seguinte forma:

      • Tipo: Consulta

      • Nome: Número da Página da Solicitação

      • (Opcional) Valor: Insira o número da página a ser buscada.

      • Tipo de Uso: Abra o menu e selecione Número da página da solicitação.

    • Token Seguinte: Busque registros a partir de um ponto especificado. Defina os valores na linha da seguinte forma:

      • Tipo: Consulta

      • Nome: Token Seguinte

      • (Opcional) Valor: Insira a chave para o registro a partir do qual começar.

      • Tipo de Uso: Abra o menu e selecione Token Seguinte.

  6. Clique no ícone para salvar o parâmetro.