Módulo 4: Serviço Web SOAP¶

Introdução¶

Módulo 4 da Introdução ao Harmony Cloud Studio demonstra a consulta de um serviço web SOAP e a gravação da 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.

Resumo¶

Neste módulo, você executará uma chamada SOAP usando um WSDL fornecido para consultar um serviço meteorológico com base no CEP 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. Configure 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 como "Módulo 4".

2. Na aba endpoints e conectores do projeto da paleta de componentes no 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"
   • URL de upload: 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".
   • URL do serviço da Web: É preenchido automaticamente a partir do WSDL carregado.
   • Selecionar métodos: Selecione "CEP". Clique em Salvar alterações.

4. Na aba endpoints e conectores do projeto da paleta de componentes no filtro Endpoints, clique na conexão "Código postal – SOAP" que você acabou de criar. Isso mostra o tipo de atividade SOAP para o método selecionado ao configurar a 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 “Código Postal – 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. Configure uma Atividade FTP¶

Nesta etapa, você usa a mesma conexão com o servidor SFTP que no Módulo 1, mas configura uma atividade FTP Write separada:

1. Na aba endpoints e conectores do projeto da paleta de componentes no 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 FTP Write:

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

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

A seguir, você cria uma transformação para a solicitação de serviço 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 será aberta para você configurar:
   • Nome da Transformação: "Código Postal – Solicitação SOAP "
   • Fonte: Deixe o esquema de origem indefinido (à esquerda).
   • Alvo: 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. Configure uma Transformação de Resposta¶

Em seguida, você cria uma transformação para gravar a resposta do serviço 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 será aberta para você configurar:
   • Nome da Transformação: "Código Postal – Resposta SOAP "
   • Fonte: O esquema de origem já foi fornecido (à esquerda).
   • Alvo: Você precisa definir o esquema de destino (à direita). Clique em Definir esquema e selecione Criar plano. 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, cidade primária, condado, fuso horário, códigos de área, país e população. Depois que os campos forem adicionados, 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 simples personalizado deve ser semelhante a esta:

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

5. Implante e Execute a Operação¶

Finalmente, 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 da Jitterbit e visualize o arquivo que você gerou.