Módulo 5: Serviço web RESTful para o curso de treinamento Introdução ao Jitterbit Integration Studio

Introdução

Módulo 5 em Introdução ao Jitterbit Integration Studio demonstra como consultar um serviço web REST e escrever a resposta em um servidor SFTP como um arquivo de texto.

Pré-requisitos

Esta página pressupõe que você concluiu o Módulo 1 - Banco de dados para texto, onde você configurou uma conexão com o servidor SFTP de treinamento da Jitterbit. Também requer a conclusão do Módulo 4 - Serviço web SOAP, pois reutiliza vários componentes de projeto deste módulo.

Resumo

Neste módulo, você consultar um serviço web RESTful sobre o clima com base no código postal e, em seguida, gravará esses dados no servidor SFTP de treinamento como um arquivo de texto.

A operação concluída ficará assim:

Esta operação usa este mapeamento de transformação:

1. Configurar uma conexão HTTP

Neste módulo, você continua trabalhando no mesmo projeto do Módulo 1 e cria uma nova conexão SOAP:

1. Dentro do mesmo projeto do Módulo 1, crie um novo workflow e nomeie-o "Módulo 5".

2. Na aba endpoints e conectores do projeto da paleta de componentes, no filtro Conectores, clique no conector HTTP.

3. Configure a conexão HTTP:

   • Nome do Endpoint: "CEP - REST"
   • URL base: Cole a URL base deste serviço: "https://trainingoptrial112860.jitterbit.net/TrainingOpsCloud/v1/REST_Service/".

4. Clique em Salvar alterações.

A conexão HTTP deve ter uma configuração semelhante a esta:

2. Configurar uma atividade HTTP

Em seguida, configure uma atividade associada à conexão HTTP para obter os dados do serviço web:

1. Na aba endpoints e conectores do projeto da paleta de componentes, no filtro Endpoints, clique na conexão "CEP - REST" que você acabou de criar:

   

2. Arraste um tipo de atividade HTTP GET para a área de inserção de componentes na quadro de design para criar uma instância de uma atividade HTTP GET em uma nova operação.

3. Renomeie a operação para "CEP - REST".

4. Clique duas vezes na atividade HTTP GET dentro da operação para abrir sua configuração.

5. Configure a atividade HTTP:

   • Nome: "Detalhes do Código Postal"

   • Verbo HTTP: "GET"

   • Caminho: "zip"

   • Parâmetros de solicitação: Clique em Adicionar para definir um parâmetro de consultar chamado "código" com um valor do seu CEP (por exemplo, "94501"). Clique em Avançar.

   • Fornecer esquema de solicitação: Como não há necessidade de fornecer um esquema de solicitação (uma solicitação GET padrão não contém um corpo), clique em Avançar novamente.

   • Fornecer esquema de resposta: Selecione Sim, fornecer novo esquema, forneça um nome de esquema de "Detalhes do código postal" e cole esta estrutura de resposta JSON esperada na caixa de texto inferior:

     {
       "zip": 12345,
       "type": "",
       "primaryCity": "",
       "state": "",
       "county": "",
       "timeZone": "",
       "areaCodes": "",
       "latitude": "",
       "longitude": "",
       "country": "",
       "population": 123456
     }
     

     Clique em Avançar.

   • Esquema de dados: Revise o esquema de dados e clique em Concluído para retornar à quadro de design.

A tela final da configuração da atividade deve ser semelhante a esta:

3. Configurar uma atividade FTP

Nesta etapa, você reutiliza a atividade FTP Write criada no Módulo 4:

1. Na aba Componentes do painel do projeto, expanda Endpoints > FTP Endpoints para localizar a conexão "SFTP" e a atividade de gravação "Dados do código postal" que você criou como parte do Módulo 4.
2. Arraste a atividade de gravação "Dados do CEP" para uma área de inserção à direita da atividade HTTP dentro da operação na quadro de design para reutilizá-la na operação.

4. Configurar uma transformação

Em seguida, você cria uma transformação para transformar dados da origem HTTP para o destino FTP:

1. Na quadro de design, passe o mouse sobre a área entre a atividade HTTP GET e a atividade FTP Write até que uma área de inserção de componentes apareça.
2. Clique na área de inserção e selecione Nova Transformação. Uma nova transformação será aberta para você configurar:
   • Nome da Transformação: "CEP - Resposta REST"
   • Fonte: O esquema de origem já foi fornecido (à esquerda) porque você o definiu na atividade GET.
   • Destino: Você precisa definir o esquema de destino (à direita). Clique em Definir Esquema e selecione Usar Arquivo de Exemplo. Configure o esquema do arquivo de exemplo:
     • Fornecer arquivo de esquema: Selecione Usar esquema salvo.
     • Esquemas salvos: Use o menu suspenso para selecionar o esquema "Dados do código postal" delimitado por tabulações que você definiu como parte do Módulo 4. Clique em Concluir.
3. No canto superior direito do esquema de destino, clique em Automapear Correspondências Exatas. Em seguida, clique em Retornar ao Workflow.

O mapeamento da transformação deve ser semelhante a este:

5. Implante e execute a operação

Por fim, com todas as etapas da operação configuradas, você implantar e executa a operação:

1. No canto superior direito da operação, clique no ícone do menu de ações e, no menu, clique em Implantar e Executar. O status da operação é exibido no canto inferior esquerdo da operação.
2. Assim que a operação for bem-sucedida, faça login no servidor SFTP de treinamento do Jitterbit e visualize o arquivo que você gerou.