Ir para o conteúdo

Atividades SOAP

Introdução

Uma atividade SOAP, utilizando sua conexão SOAP, recupera dados de ou envia dados para um endpoint SOAP e é destinada a ser usada como uma fonte para fornecer dados a uma operação ou um alvo para consumir dados em uma operação. As atividades específicas 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 alvo em uma operação depende do serviço web específico e das estruturas de solicitação e resposta, se presentes. Para mais informações sobre o que determina se uma atividade pode ser usada como fonte ou alvo, consulte Partes de uma operação em Criação e configuração de operações.

Criar uma atividade SOAP

Uma instância de uma atividade SOAP é 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 tela de design ou copie o tipo de atividade e cole-o na tela de design. Para 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 para identificar a atividade SOAP. Este campo é preenchido automaticamente 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 desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta 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 qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revise os esquemas de dados

Atividade SOAP 2

  • Esquema de Dados: Os esquemas de dados da 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 processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais.

  • Adicionar plugin(s): Plugins são aplicativos fornecidos pela Jitterbit ou pelo usuário que ampliam as capacidades nativas 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 utilizado. Para instruções adicionais sobre como usar 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

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 particionamento para dividir os dados em partes menores para processamento.

Completar a operação

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

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja Menu de ações da atividade em Conceitos básicos do conector.

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

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

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

Usado como fonte

Atividades SOAP que são usadas como fonte podem ser utilizadas 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

Atividades SOAP que são usadas como alvo podem ser utilizadas 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.

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

Serviços web SOAP são comumente usados como o primeiro alvo no Padrão de Duas Transformações: uma fonte fornece a solicitação que o serviço web SOAP recebe como entrada, e o serviço então gera uma resposta que é escrita em outro alvo.

Mas alguns serviços web SOAP podem não exigir nada 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 em nós sem campos.

Use chunking

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

Para instruções e melhores práticas sobre como usar chunking, consulte Opções de operação.