Atividade Receber Solicitação de HTTP

Use a atividade Receber Solicitação de HTTP para configurar o Integration Appliance para agir como um listener HTTP

A figura a seguir mostrar o Integration Appliance agindo como um listener HTTP.
Figura 1.
A atividade Receber Solicitação de HTTP é uma atividade iniciadora.  Quando uma orquestração que inicia com uma atividade Receber Solicitação de HTTP é implementada no Integration Appliance, o Integration Appliance age como um listener HTTP aguardando solicitações de HTTP. Quando uma solicitação de HTTP é recebida, as ações a seguir ocorrem:
  1. Uma tarefa de orquestração é iniciada.
  2. A atividade Receber Solicitação de HTTP processa a solicitação de HTTP recebida e mapeia a solicitação de HTTP para os parâmetros de saída da atividade.
  3. Os parâmetros de saída são mapeados para as variáveis de orquestração especificadas. Durante o tempo de design na tarefa Mapear Saídas da Lista de Verificação, o mapeamento entre os parâmetro de saída e as variáveis de orquestração é definido.
  4. As atividades restantes na orquestração são processadas. (Na representação gráfica da orquestração, as atividades restantes são as atividades localizadas no lado direito da atividade Receber Solicitação de HTTP).
Por padrão, a descompactação é ativada para a atividade Receber Solicitação de HTTP. Para obter informações adicionais, consulte Descompactação com a Atividade Receber Solicitação de HTTP.

Incluindo uma Atividade Receber Solicitação de HTTP na Orquestração

  1. Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta HTTP.
  3. Arraste a atividade Receber Solicitação para a orquestração.
  4. Selecione a atividade. A Lista de Verificação é exibida com a tarefa Resumo ativa na área de janela de propriedades. A área de janela Propriedades está localizada sob a representação gráfica da orquestração na Área de Trabalho.

Criando, Selecionando ou Editando um Terminal HTTP

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e escolha a partir de uma das seguintes ações:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK. Vá para o procedimento "Configurar a Atividade".
    • Selecione um terminal existente e edite o terminal:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK.
      3. Clique em Editar. A área de janela Editar Terminal é exibida.
    • Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
  2. Crie ou edite um terminal HTTP, consulte Criando ou Editando um Terminal HTTP.

Configurando a Atividade

  1. Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
  2. Configure todos os campos e caixas de seleção nesta área de janela, conforme descrito na tabela a seguir:
    Tabela 1.
    Campo Descrição
    URL (Caminho Após Nome do Host) Especifica o caminho de recurso no qual o Integration Appliance atende solicitações de HTTP de entrada, por exemplo: /mypath. A sequência especificada neste campo deve excluir a sequência: http://, o nome do host e o número da porta do Integration Appliance. A URL completa que o Integration Appliance usa para atender solicitações de HTTP de entrada é construída automaticamente a partir do nome do host do Integration Appliance, do número da porta especificado no terminal HTTP e do caminho especificado neste campo. Por exemplo, se a URL completa em que o Integration Appliance atende solicitações de HTTP for http://myAR:myPort/myPath, neste campo você precisará apenas especificar a sequência: /myPath. O caminho especificado deve ser exclusivo para as atividades Receber Solicitação de HTTP que são implementadas ao mesmo tempo no mesmo Integration Appliance usando a mesma porta.
    Nota: O caminho em que o Integration Appliance atende solicitações de HTTP de entrada é uma sequência de caminhos de recurso especificados e não corresponde ao caminho do diretório real no Integration Appliance.
    De Tipo Especifica o tipo de mensagem esperado da solicitação de HTTP - Texto ou Binário.
    Requer uma Resposta Especifica se uma resposta deve ser enviada ao emissor da solicitação.
    Nota: Se esta caixa de seleção for selecionada, você deverá incluir e configurar uma atividade Enviar Resposta de HTTP em sua orquestração.
    Usar Compactação/Descompactação Especifica se a compactação/descompactação é ativada ou desativada no nível de atividade. Por padrão, a caixa de seleção Usar Compactação/Descompactação está selecionada. Limpe a caixa de seleção Usar Compactação/Descompactação para desativar a descompactação para esta atividade. Para obter informações adicionais, consulte Compactação/Descompactação com a Atividade Enviar Resposta HTTP.

Mapeando a Saída da Atividade

  1. Selecione a tarefa Mapear Saídas na Lista de Verificação. Os parâmetros de saída da atividade são exibidos na área de janela Da Atividade da tarefa Mapear Saídas, conforme descrito na tabela a seguir:
    Tabela 2.
    Parâmetro de Saída Descrição
    httpheaders Especifica o cabeçalho da solicitação de HTTP.
    body Especifica o corpo da mensagem de solicitação de HTTP.
    A tabela a seguir define os nós do parâmetro de saída httpheaders opcional.  
    Tabela 3.
    Nós do Parâmetro de Saída httpheaders Descrição
    httpheaders/uri Especifica o caminho de recurso da solicitação recebida, por exemplo: /myPath.
    httpheaders/method Especifica o tipo de pedido de HTTP. Para esta atividade, POST é o tipo de solicitação de HTTP.
    httpheaders/otherHeaders/headerItem Especifica um elemento que contém um conjunto de parâmetros de cabeçalho HTTP como pares nome/valor. Múltiplos parâmetros de cabeçalho HTTP podem ser especificados no pedido de HTTP, portanto, este é um nó recorrente.
    httpheaders/otherHeaders/headerItem/name Especifica o nome do parâmetro de cabeçalho HTTP.
    ttpheaders/otherHeaders/headerItem/value Especifica o valor do parâmetro de cabeçalho HTTP.
  2. Crie um mapa entre o parâmetro ou parâmetros de saída da atividade e a variável ou variáveis de orquestração. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.
    Nota: Para testar sua orquestração que inicia com a atividade Receber Solicitação de HTTP, é possível usar o HTTP Post Utility incluído com a instalação do Studio, para enviar solicitações de HTTP ao Integration Appliance de atendimento durante o tempo de execução. É possível acessar o HTTP Post Utility a partir do menu iniciar, selecione a opção Programas > IBM > Cast Iron Studio > HTTP Post Utility. A URL especificada na URL do campo do conector de entrada deve conter a URL completa, por exemplo: http://myAR:myPort/myPath.



Feedback | notices