Nó HTTPReply

Este tópico contém as seguintes seções:

Finalidade

Utilize o nó HTTPReply para retornar uma resposta do fluxo de mensagens para o cliente de serviços da Web. Esse nó gera a resposta para o cliente de serviços da Web a partir do qual a mensagem de entrada foi recebida pelo nó HTTPInput e aguarda pela confirmação de que foi enviada.

Se você incluir um nó HTTPReply em um fluxo de mensagens, deverá incluir um nó HTTPInput no mesmo fluxo ou receber a mensagem de outro fluxo iniciado com um nó HTTPReply. A resposta é associada à resposta por um identificador de pedidos, armazenado no Ambiente Local pelo nó HTTPInput.

Esse nó constrói uma mensagem de resposta para o cliente de serviços da Web a partir de toda a árvore de mensagens de entrada e retorna-a ao solicitante.

O nó HTTPReply é representado no workbench pelo seguinte ícone:

 Ícone do nó HTTPReply

Utilizando este nó em um fluxo de mensagens

Consulte o nó HTTPInput para obter exemplos de como você pode utilizar esse nó.

Configurando o Nó HTTPReply

Quando tiver colocado uma instância do nó HTTPReply em um fluxo de mensagens, você poderá configurá-lo. Clique com o botão direito do mouse na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.

Configure o nó HTTPReply da seguinte forma:

  1. Selecione a caixa de opções Ignorar Defeitos de Transporte se desejar que os defeitos relacionados ao transporte sejam ignorados (por exemplo, se o cliente estiver desconectado). Se você limpar a caixa de opções e ocorrer um erro relacionado ao transporte, a mensagem de entrada será propagada para o terminal failure. Se limpar a caixa de opções, deverá fornecer um valor para o Tempo Limite de Envio de Resposta.
  2. Defina o valor de Tempo Limite de Envio de Resposta se não estiver ignorando defeitos de transporte. Esse é o período de tempo que o nó aguarda por uma confirmação de que o cliente recebeu a resposta. Se a confirmação for recebida nesse período de tempo, a mensagem de entrada será propagada do terminal de saída para o restante do fluxo de mensagens, se ele estiver conectado. Se a confirmação não for recebida nesse período, a mensagem de entrada será propagada através do terminal failure, se ele estiver conectado. Se o terminal failure não estiver conectado e uma confirmação não for recebida no período, será gerada uma exceção.
  3. Certifique-se de que a caixa de opções Gerar cabeçalhos HTTP padrão a partir de responder ou de resposta esteja selecionada, se desejar que os cabeçalhos de serviço da Web padrão sejam criados utilizando valores de HTTPReplyHeader ou de HTTPResponseHeader. Se o cabeçalho apropriado não estiver presente na mensagem de entrada, serão utilizados os valores padrão.

    O nó sempre inclui um cabeçalho de Comprimento de Conteúdo, definido para o valor correto calculado, no HTTPReplyHeader, mesmo que não tenha sido incluído no pedido original.

  4. Selecione Validação no navegador do diálogo de propriedades se desejar que o analisador MRM valide o corpo de mensagens no dicionário gerado a partir do conjunto de mensagens. (Se uma mensagem for propagada para o terminal failure do nó, ela não será validada).

    Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.

  5. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa ou ambas.
  6. Clique em Aplicar para fazer as alterações no nó HTTPReply sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Conectando os Terminais de Saída a Outro nó

Conecte o terminal out ou failure deste nó a outro nó desse fluxo de mensagens se deseja que processe mais a mensagem, processe os erros ou envie a mensagem para um destino adicional.

Terminais e Propriedades

Os terminais do nó HTTPReply são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem será roteada se for detectado um defeito quando a mensagem for propagada.
Saída O terminal de saída para o qual a mensagem será roteada se for propagada com êxito e se for requerido processamento adicional neste fluxo de mensagens.

As tabelas a seguir descrevem as propriedades do nó; a coluna com cabeçalho M indica se a propriedade é obrigatória (marcado com um asterisco no diálogo de propriedades caso seja necessário digitar um valor quando nenhum padrão for definido), a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens no arquivo bar para implementá-lo).

As propriedades Básicas do nó HTTPReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Ignorar Defeitos de Transporte Sim Não Selecionada Define se as falhas relacionadas ao transporte serão ignorados. Se você selecionar a caixa de opções, esta ação é executada.
Tempo Limite de Envio de Resposta Sim Não 120 O tempo em segundos no qual o nó de resposta aguarda antes de assumir que a resposta falhou para chegar ao cliente. O intervalo válido é de zero (o que significa uma espera indefinida) a (231)-1. Válido apenas se Ignorar Defeitos de Transporte for desmarcado.
Gerar cabeçalhos HTTP padrão a partir de responder ou de resposta Sim Não Selecionada A caixa de opções será selecionada se os cabeçalhos de serviço da Web padrão forem criados utilizando valores de HTTPReplyHeader ou de HTTPResponseHeader.

As propriedades de Validação do nó HTTPReply são descritas na tabela a seguir.

Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa destas propriedades.

Propriedade M C Padrão Descrição
Validar Sim Sim Herdar Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar.
Ação de Defeito Sim Não Exceção O que acontece se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceção.
Incluir Todas as Limitações do Valor Sim Não Selecionada Essa propriedade não pode ser editada. A ação padrão, indicada pela seleção da caixa de opções, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor.
Corrigir Sim Não Nenhum Essa propriedade não pode ser editada.

As propriedades de Descrição do nó HTTPReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.
Referências relacionadas
Nó HTTPInput
Nó HTTPRequest
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04585_