Ir para o conteúdo

Atividades SOAP

Introdução

Uma atividade SOAP recupera dados de ou envia dados para um endpoint SOAP e se destina a ser usada como uma fonte para fornecer dados a uma operação ou um destino para consumir dados em uma operação. As atividades específicas que estão disponíveis dependem dos métodos SOAP selecionados durante a configuração da conexão SOAP. Você pode configurar quantas atividades SOAP desejar para cada conexão SOAP.

Se a atividade pode ser usada como uma fonte ou um destino em uma operação depende do serviço web específico e das estruturas de solicitação e resposta, se presentes. Para obter mais informações sobre o que determina se uma atividade pode ser usada como uma fonte ou um destino, consulte Partes de uma operação em Criação e configuração de operação.

Crie uma atividade SOAP

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade existente pode ser editada a partir destes locais:

Configurar uma atividade SOAP

Siga estas etapas para configurar uma atividade SOAP:

Etapa 1: Insira um nome

Atividade SOAP 1

  • Nome: Insira um nome a ser usado para identificar a atividade SOAP. Este campo é pré-preenchido com o nome do método. Você pode criar várias atividades usando o mesmo método, mas o nome deve ser exclusivo para cada atividade SOAP e não deve conter barras (/) ou dois pontos (:).
  • Salvar e sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.
  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revise os esquemas de dados

Atividade SOAP 2

  • Data Schema: Os esquemas de dados de solicitação e/ou resposta são exibidos. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o mapeamento de transformação, onde você pode mapear campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e muito mais.

  • Adicionar plugin(s): Os plugins são aplicativos fornecidos pelo Jitterbit ou pelo usuário que estendem os recursos nativos do Harmony. Para aplicar um plugin à atividade, clique para expandir esta seção e selecione a caixa de seleção ao lado do plugin a ser usado. Para obter instruções adicionais sobre o uso de plugins, incluindo detalhes sobre a configuração de quaisquer variáveis necessárias usadas pelo plugin, consulte Plugins adicionados a uma atividade.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração para todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme se deseja descartar as alterações.

Próximos passos

Após configurar uma atividade SOAP, você pode usá-la dentro de uma operação conforme descrito abaixo. Você também pode querer configurar o fragmentação de dados para dividir os dados em pedaços menores para processamento. Um caso de uso especial sobre como lidar com serviços SOAP que não exigem parâmetros de solicitação também é abordado abaixo.

Concluir a operação

Após configurar uma atividade SOAP, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade SOAP é criada, as ações de menu para essa atividade ficam acessíveis no painel do projeto nas guias Workflows ou Components e na quadro de design. Veja menu de ações de atividade para mais detalhes.

Operações que usam atividades SOAP também podem ter ações de operação configuradas para disparar em uma falha SOAP — um erro resultante de um formato de mensagem incorreto, processamento de cabeçalho ou incompatibilidade. Ações de operação podem ser configuradas para executar uma operação ou enviar um email após uma falha SOAP ocorrer. Para obter instruções sobre como disparar uma ação em uma falha SOAP, consulte Ações de operação.

As operações que contêm uma atividade SOAP podem ter apenas uma atividade SOAP e não podem conter nenhuma NetSuite, Salesforce, Salesforce Service Cloud, SAP, ou ServiceMax atividades.

Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando os logs de operação.

Usado como fonte

As atividades SOAP que são usadas como fonte podem ser usadas com estes padrões de operação:

Outros padrões não são válidos usando atividades SOAP que são usadas como fonte.

Usado como alvo

As atividades SOAP que são usadas como alvo podem ser usadas com estes padrões de operação:

Outros padrões não são válidos usando atividades SOAP que são usadas como alvo.

Normalmente, uma operação que chama um serviço web SOAP contém duas transformações: a primeira transforma dados em uma solicitação de serviço web, e a segunda transforma dados de uma resposta de serviço web para um sistema de destino. Este exemplo usa uma atividade SOAP no Padrão de duas transformações. Nesta operação, uma atividade de solicitação de API (Solicitação) cria uma estrutura de solicitação que é recebida pela primeira transformação (API para SOAP) e passada para uma atividade SOAP (Verificar cartão de crédito). A segunda transformação (SOAP para compartilhamento de arquivos) recebe a estrutura de resposta, que é então gravada em um compartilhamento de arquivos por uma atividade de gravação de compartilhamento de arquivos (Resposta de gravação):

operação de atividade SOAP 1

Usar fragmentação de dados

Muitas APIs de serviços da web têm limitações de tamanho. Se você estiver enfrentando limites de registro impostos pela API, talvez queira usar fragmentação de dados para dividir os dados de origem em vários chunks. A transformação é então realizada em cada chunk separadamente, com cada chunk de origem produzindo um chunk de destino. Os chunks de destino resultantes se combinam para produzir o destino final.

Para obter instruções e práticas recomendadas sobre o uso de fragmentação de dados, consulte Opções de operação.

Usando um serviço SOAP sem parâmetros de solicitação

Os serviços web SOAP são comumente usados como o primeiro destino no Padrão de Transformação de Dois Destinos: uma origem fornece a solicitação que o serviço web SOAP recebe como entrada, e o serviço então gera uma resposta que é gravada em outro destino.

Mas alguns serviços web SOAP podem não exigir que nada seja fornecido na solicitação além de apenas solicitar o serviço. Nesse caso, duas transformações ainda são necessárias pelo padrão, mas a estrutura da solicitação pode não ter campos que exijam mapeamento; em vez disso, a estrutura pode consistir apenas de nós sem campos.

Esta operação utiliza o GetHolidaysAvailable método (na atividade SOAP Get Holidays), que não requer parâmetros de solicitação:

operação de atividade SOAP 2

Na transformação FTP para SOAP, podemos ver que todos os nós são expandidos e não há campos presentes:

operação de atividade SOAP 3

O resultado é uma transformação vazia, sem nenhum mapeamento, o que é necessário para que a operação seja válida.