Ir para o conteúdo

Atividade HTTP PUT

Introdução

Uma atividade HTTP PUT, utilizando sua conexão HTTP, substitui um recurso existente em um serviço acessível pelo protocolo HTTP ou HTTPS, e pode ser usada tanto como uma fonte (para fornecer dados em uma operação) quanto como um destino (para consumir dados em uma operação).

Importante

Com o lançamento do conector HTTP v2, recomendamos a conversão de conexões e atividades HTTP existentes para HTTP v2. Saiba mais sobre os benefícios do conector HTTP v2 em nosso post no blog sobre HTTP v2 ou veja uma comparação das funcionalidades dos conectores HTTP e HTTP v2.

A intenção de longo prazo da Jitterbit é descontinuar o conector HTTP, o que será anunciado de acordo com a política de fim de vida da Jitterbit. No momento, não há um cronograma para a descontinuação e o conector HTTP continua totalmente suportado. Recomendamos que você converta conexões e atividades HTTP existentes para HTTP v2 sempre que possível.

Criar uma atividade HTTP Put

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

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, veja Criar uma instância de atividade em Reutilização de componentes.

Uma atividade HTTP PUT existente pode ser editada a partir destes locais:

Configurar uma atividade HTTP Put

Siga estas etapas para configurar uma atividade HTTP PUT:

Etapa 1: Insira um nome e especifique as configurações

Nesta etapa, forneça um nome para a atividade e especifique a URL, os parâmetros da solicitação e os cabeçalhos da solicitação. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Configuração da atividade HTTP Put etapa 1

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

Importante

Campos nas tabelas exibem o ícone de variável apenas no modo de edição. Para que os valores das variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade HTTP v2 PUT e não deve conter barras normais / ou dois pontos :.

  • Verbo HTTP: O verbo HTTP não pode ser alterado.

  • Caminho: Insira um caminho e/ou parâmetros de consulta que devem ser adicionados à URL base especificada na configuração da conexão HTTP. Se fornecer parâmetros de consulta, especifique-os como faria em um navegador da web, como /queryrecord?id=10.

  • URL: A URL criada como uma concatenação da URL base e do caminho inserido acima é fornecida para referência. Para editar a URL, faça alterações na URL base na conexão HTTP ou no caminho inserido acima.

  • Parâmetros da Solicitação: Clique no botão Adicionar para adicionar uma linha e, em seguida, insira um Nome e um Valor específicos para os parâmetros solicitados. Clique no botão Remover para excluir uma linha existente. Os parâmetros de solicitação fornecidos serão automaticamente codificados em URL.

  • Cabeçalhos da Solicitação: Clique no botão Adicionar para adicionar uma linha e, em seguida, insira um Nome e um Valor específicos para as informações do cabeçalho solicitado. Clique no botão Remover para excluir uma linha existente.

  • 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 qualquer etapa. Uma mensagem pergunta se você deseja confirmar que deseja descartar as alterações.

Etapa 2: Fornecer o esquema da solicitação

Nesta etapa, você pode fornecer um esquema de solicitação personalizado (opcional).

Configuração da atividade HTTP Put etapa 2

  • Fornecer Esquema da Solicitação: O esquema da solicitação define a estrutura dos dados da solicitação que são usados pela atividade HTTP. Se um esquema de solicitação é necessário depende se a atividade é usada como o alvo de uma transformação e se o serviço da web espera dados de solicitação estruturados (veja Uso de Esquemas). Para instruções sobre como completar esta seção da configuração da atividade, consulte Esquemas definidos em uma atividade.

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

  • 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 3: Fornecer o esquema de resposta

Nesta etapa, você pode fornecer um esquema de resposta personalizado (opcional).

Configuração da atividade HTTP Put etapa 3

  • Fornecer Esquema de Resposta: O esquema de resposta define a estrutura dos dados de resposta que são usados pela atividade HTTP. Se um esquema de resposta é necessário depende se a atividade é usada como a fonte de uma transformação e se o serviço web retorna dados de resposta estruturados (veja Uso de Esquemas). Para instruções sobre como completar esta seção da configuração da atividade, consulte Esquemas definidos em uma atividade.

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

  • 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 4: Revisar os esquemas de dados

Os esquemas de solicitação e resposta configurados (se fornecidos) são exibidos.

Configuração da atividade HTTP Put etapa 4

  • Esquema de Dados: Se fornecido durante a configuração da atividade, 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 sã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. Você também pode definir esquemas diretamente em uma transformação.

  • Adicionar Plugin(s): Plugins são aplicativos fornecidos pela Jitterbit ou pelo usuário que estendem 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 de 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.

Variáveis Jitterbit que afetam a submissão HTTP

O sistema Harmony define certas variáveis globais que estão sempre disponíveis ao longo de um projeto, conhecidas como variáveis Jitterbit ou como variáveis globais pré-definidas. As variáveis Jitterbit listadas abaixo são particularmente úteis para atividades HTTP. Para mais informações sobre como usar variáveis Jitterbit, consulte Variáveis Jitterbit.

Essas variáveis Jitterbit afetam a forma como as submissões de origem HTTP são realizadas:

  • jitterbit.source.max_redirs
  • jitterbit.source.http.ssl_cert_id
  • jitterbit.source.http.transfer_timeout

Essas variáveis do Jitterbit afetam a forma como as submissões de destino HTTP são realizadas:

  • jitterbit.target.http.form_data
  • jitterbit.target.http.form_data.ContentType
  • jitterbit.target.http.form_data.filename
  • jitterbit.target.http.form_data.name
  • jitterbit.target.http.max_redirs
  • jitterbit.target.http.remove_trailing_linebreaks
  • jitterbit.target.http.ssl_cert_id
  • jitterbit.target.http.transfer_timeout

Próximas etapas

Após configurar uma atividade HTTP PUT, você pode usá-la dentro de uma operação ou script, conforme descrito abaixo. Você também pode querer configurar o particionamento para dividir os dados em partes menores para processamento.

Complete a operação

Após configurar uma atividade HTTP PUT, 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.

Uma vez que uma atividade HTTP PUT tenha sido criada, as ações do menu para essa atividade estão acessíveis no painel do projeto nas abas Workflows ou Components, e no canvas de design. Consulte o menu de ações da atividade para mais detalhes.

Os padrões de operação com os quais as atividades HTTP PUT podem ser usados dependem de se a atividade fornece dados (como fonte) ou recebe dados (como destino) em uma operação, conforme descrito abaixo em Usado como fonte e Usado como destino.

Embora seja típico que as atividades HTTP PUT sejam usadas como destino, é possível usar uma atividade HTTP PUT como fonte. Se o serviço web específico fornece esquemas de solicitação ou resposta para cada método determina se uma atividade pode ser usada como fonte ou destino, conforme descrito em Partes de uma operação em Criação e configuração de operações.

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

Usado como fonte

Atividades HTTP 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 HTTP que são usadas como fonte.

Usado como alvo

Atividades HTTP 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 HTTP que são utilizadas como um alvo.

Usando atividades HTTP em scripts

Atividades HTTP também podem ser referenciadas em um script para uso com funções de script que utilizam um sourceId ou targetId como parâmetro, incluindo estas:

Funções Jitterbit

Funções JavaScript Jitterbit

Para mais detalhes sobre como referenciar atividades em scripts, veja Endpoints em Jitterbit Script ou Endpoints em JavaScript.

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, veja Operation options.