Serviço web RESTful para o curso de treinamento Introdução ao Jitterbit Integration Studio

Introdução

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

Pré-requisitos

Esta página assume que você completou 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 é necessário ter completado o Módulo 4 - Serviço web SOAP, pois reutiliza vários componentes do projeto deste módulo.

Resumo

Neste módulo, você consultará um serviço web RESTful para obter informações 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 terá a seguinte aparência:

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

1. Configurar uma conexão HTTP

Para este módulo, você continuará trabalhando dentro do mesmo projeto que no Módulo 1 e criará uma nova conexão SOAP:

1. Dentro do mesmo projeto que o Módulo 1, crie um novo fluxo de trabalho e nomeie-o como "Módulo 5."

2. Na aba Endpoints e conectores do projeto do painel de componentes, sob o filtro Conectores, clique no conector HTTP.

3. Configure a conexão HTTP:

   • Nome do Endpoint: "Código Postal – REST"
   • URL Base: Cole a URL base para este 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. Configure 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 painel de componentes, sob o filtro Endpoints, clique na conexão "Código Postal – REST" que você acabou de criar:

   

2. Arraste um tipo de atividade HTTP GET para a zona de drop do componente na tela de design para criar uma instância de uma atividade HTTP GET em uma nova operação.

3. Renomeie a operação para "Código Postal – 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 da Solicitação: Clique em Adicionar para definir um parâmetro de consulta chamado "code" com um valor do seu código postal (por exemplo, "94501"). Clique em Próximo.

   • 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 Próximo novamente.

   • Fornecer Esquema de Resposta: Selecione Sim, Fornecer Novo Esquema, forneça um nome de esquema de "Detalhe do Código Postal" e, em seguida, 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 Próximo.

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

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

3. Configure uma atividade FTP

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

1. No painel do projeto, na aba Componentes, expanda Endpoints > Endpoints FTP para localizar a conexão "SFTP" e a atividade de escrita "Zip Code Data" que você criou como parte do Módulo 4.
2. Arraste a atividade de escrita "Zip Code Data" para uma zona de drop à direita da atividade HTTP dentro da operação no canvas de design para reutilizá-la na operação.

4. Configure uma transformação

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

1. No canvas de design, passe o mouse sobre a área entre a atividade HTTP GET e a atividade FTP Write até que uma zona de drop de componente apareça.
2. Clique na zona de drop e selecione Nova Transformação. Uma nova transformação será aberta para você configurar:
   • Nome da Transformação: "Zip Code – REST Response"
   • Fonte: O esquema de origem já está fornecido (à esquerda) porque você o definiu na atividade GET.
   • Destino: Você precisa definir o esquema de destino (à direita). Clique em Definir Esquema, em seguida, 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 "Zip Code Data" delimitado por tabulação que você definiu como parte do Módulo 4. Clique em Concluir.
3. Na parte superior direita do esquema de destino, clique em Automapear Correspondências Exatas. Em seguida, clique em Retornar ao Fluxo de Trabalho.

O mapeamento da transformação deve se parecer com isto:

5. Implantar e executar a operação

Finalmente, com todas as etapas da operação configuradas, você implanta 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. Uma vez que a operação seja bem-sucedida, faça login no servidor SFTP de treinamento da Jitterbit e visualize o arquivo que você gerou.