Módulo 4: Serviço Web SOAP¶

Introdução¶

Módulo 4 na Introdução ao Harmony Cloud Studio demonstra como consultar um serviço da web SOAP 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 do Jitterbit.

Resumo¶

Neste módulo, você realizará uma chamada SOAP usando um WSDL fornecido para consultar um serviço meteorológico 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 estes mapeamentos de transformação de solicitação e resposta:

1. Configurar uma Conexão e Atividade SOAP¶

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

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

2. Na aba Conexões da paleta de componentes sob o filtro Conectores, clique no conector SOAP:

   

   Dica

   SOAP, ou Simple Object Access Protocol, é um protocolo baseado em padrões bem estabelecido para acessar serviços da web.

3. Configure a conexão SOAP:

   • Nome do Endpoint: "Código postal – SOAP"
   • Upload URL: Cole o URL neste arquivo Web Service Definition Language (WSDL): "https://trainingoptrial112860.jitterbit.net/TrainingOpsCloud/v1/SOAP_Service/?WSDL". Clique em Carregar.
   • Porta: Selecione "ZipCodeSoap".
   • Web Service URL: Isso é preenchido automaticamente a partir do WSDL carregado.
   • Selecionar Métodos: Selecione "ZipCode". Clique em Salvar alterações.

4. Na aba Connections da paleta de componentes sob o filtro Endpoints, clique na conexão "Zip Code – SOAP" que você acabou de criar. Isso mostra o tipo de atividade SOAP para o método selecionado durante a configuração da conexão SOAP:

   

5. Arraste o tipo de atividade SOAP para uma área de inserção de componentes na quadro de design para criar uma instância de uma atividade SOAP em uma nova operação.

6. Renomeie a operação "Zip Code – SOAP." Você não precisa abrir a atividade SOAP para configurá-la porque ela já está configurada automaticamente com todas as informações necessárias.

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

2. Configurar uma Atividade de FTP¶

Nesta etapa, você usa a mesma conexão com o servidor SFTP do Módulo 1, mas configura uma atividade separada de gravação de FTP:

1. Na aba Connections da paleta de componentes sob o filtro Endpoints, clique na conexão "SFTP" que você criou no Módulo 1 para mostrar os tipos de atividade da conexão:

   

2. Arraste uma atividade FTP Write para uma área de inserção de componentes à direita da atividade SOAP dentro da operação na quadro de design.

3. Clique duas vezes na atividade FTP Write dentro da operação para abrir sua configuração.

4. Configure a Atividade de gravação de FTP:

   • Nome: "Dados do CEP"
   • Nome(s) do(s) arquivo(s): "zipCode.txt"
   • Use FTP Rename: Desmarque esta seleção. Clique em Avançar.
   • Esquema de dados: Como você não forneceu um esquema, não há nada para revisar na segunda tela. Clique em Concluído.

3. Configurar uma Transformação de Solicitação¶

Em seguida, você cria uma transformação para a solicitação de serviço da Web SOAP:

1. Na quadro de design, passe o mouse sobre a área à esquerda da atividade SOAP 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 se abrirá para você configurar:
   • Nome da Transformação: "CEP - Solicitação SOAP "
   • Fonte: Deixe o esquema de origem indefinido (à esquerda).
   • Destino: Dentro do esquema de destino (à direita), passe o mouse sobre o ZipCode campo e clique no ícone adicionar . No menu, clique em Adicionar valor personalizado. Em seguida, insira um código postal na área de texto. Clique em Retornar ao Workflow.

A transformação da solicitação deve ser semelhante a esta:

4. Configurar uma Transformação de Resposta¶

Em seguida, você cria uma transformação para gravar a resposta do serviço da Web SOAP no destino FTP:

1. Na quadro de design, passe o mouse sobre a área entre a atividade SOAP 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 se abrirá para você configurar:
   • Nome da Transformação: "Código postal – Resposta SOAP "
   • Fonte: O esquema fonte já está fornecido (à esquerda).
   • Destino: Você precisa definir o esquema de destino (à direita). Clique em Define Schema e selecione Create Flat. Configure o esquema simples personalizado:
     • Nome do esquema: "Dados do CEP"
     • Opções: Altere o Delimitador de vírgula para aba digitando "\t".
     • Adicionar campo: Use este botão para adicionar estes campos: zip, tipo, estado, PrimaryCity, condado, timeZone, areaCodes, país e população. Após adicionar os campos, clique em Salvar alterações.
3. Arraste o zipCodeResponse nó de origem para o __flat__ nó de destino e selecione Automap. Em seguida, clique em Retornar ao Workflow.

A configuração do esquema plano personalizado deve ser semelhante a esta:

A transformação da solicitação deve ser semelhante a esta:

5. Implantar e Executar 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 Deploy and Run. O status da operação é exibido no canto inferior esquerdo da operação.
2. Depois que a operação for bem-sucedida, faça login no servidor SFTP de treinamento do Jitterbit e visualize o arquivo que você gerou.