Atividade Postar Solicitação de HTTP

A atividade Postar Solicitação de HTTP envia uma solicitação de HTTP ao local especificado, o terminal HTTP, e recebe uma resposta de HTTP de volta desse local.

A figura a seguir mostra a atividade Postar Solicitação de HTTP enviando uma solicitação de HTTP ao local especificado, o terminal HTTP, e recebendo uma resposta de HTTP de volta:

Figura 1.

Incluindo uma Atividade Postar 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 Postar Solicitação para a orquestração.
  4. Selecione a atividade. A Lista de Verificação é exibida.

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 ou Caixa de Seleção Descrição
    URL (Caminho Após Nome do Host) Especifica o caminho de recurso no qual a atividade Postar Solicitação posta a solicitação, 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 é construída automaticamente a partir do nome do host do Integration Appliance, o número da porta especificado no terminal HTTP e o caminho especificado neste campo. Por exemplo, se a URL completa na qual a atividade Postar Solicitação posta a solicitação for http://myAR:myPort/myPath, neste campo você precisará apenas especificar a sequência: /myPath. O caminho especificado deve ser exclusivo para as atividades Postar Solicitação que são implementadas ao mesmo tempo no mesmo Integration Appliance usando a mesma porta.  
    Onde a Mensagem de Solicitação é Do Tipo Especifica o tipo de mensagem esperado da solicitação de HTTP - Texto ou Binário.  
    Onde a Mensagem de Resposta é Do Tipo Especifica o tipo de mensagem da resposta de HTTP - Texto ou Binário.
    Parar Processamento da Tarefa de Orquestração

    ou

    Continuar Processando e Retornar o Código de Erro HTTP

    Especifica o comportamento de tempo de execução da atividade se uma resposta de erro é retornada do Servidor HTTP:
    • Parar processamento da Tarefa de Orquestração - Selecione esta opção se a tarefa de orquestração precisar parar o processamento quando uma resposta de erro for recebida do Servidor HTTP durante o tempo de execução. A orquestração para o processamento na atividade Postar Solicitação de HTTP e as atividades após a atividade Postar Solicitação de HTTP na orquestração não são processadas e uma exceção com falha é lançada.
    • Continuar Processamento e Retornar o Código de Erro HTTP - Selecione esta opção se a tarefa de orquestração precisar continuar processando quando uma resposta de erro for recebida do Servidor HTTP durante o tempo de execução. A tarefa de orquestração deve continuar processando atividades após a atividade Postar Solicitação de HTTP na orquestração e o código de resposta de erro e a mensagem de resposta de erro forem retornados nos parâmetros de saída responsecode e responsemessage, respectivamente.
    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 é desmarcada e a compactação/descompactação é desativada para esta atividade. Selecione a caixa de seleção Usar Compactação/Descompactação para ativar a compactação/descompactação para esta atividade. Para obter informações adicionais, consulte Compactação/Descompactação com a Atividade Postar Solicitação de HTTP.

Especificando as Opções de Nova Tentativa

  1. Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
  2. Configure as opções de nova tentativa para se conectar a um servidor HTTP. A tabela a seguir define as opções de nova tentativa para uma conexão com um Servidor HTTP:
    Tabela 2.
    Campos Descrição
    Tentar novamente  
    1) Aguardar __ segundos entre cada nova tentativa. O número de segundos que o Integration Appliance aguarda antes de tentar estabelecer uma conexão com o Servidor HTTP.
    2) Tentar se conectar __ vezes antes de falhar. Especifica a contagem de novas tentativas - o número máximo de vezes que o Integration Appliance tenta estabelecer uma conexão com o Servidor HTTP antes de emitir um erro e parar o processamento da tarefa de orquestração atual.

    Se você implementar uma orquestração que contém uma atividade Postar Solicitação de HTTP e o Integration Appliance não puder se conectar ao Servidor HTTP especificado, o Integration Appliance registrará os erros de conexão como Avisos nos logs do sistema e de orquestração até o valor de contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro nos logs do sistema e da orquestração e para o processamento da tarefa de orquestração atual.

    Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, segundo e terceiro erros de conexão aparecem no log do sistema como avisos. O Integration Appliance registra o quarto erro de conexão como um erro e para o processamento da tarefa de orquestração atual.

    Tempo Limite da Atividade  
    3) Expirar após ___ segundos quando o Terminal não responder a uma solicitação. Especifica a quantidade de tempo em segundos antes de ocorrer um tempo limite entre a atividade que faz uma solicitação em um Terminal e o tempo que demora para o Terminal responder. Para a atividade Postar Solicitação de HTTP, o tempo limite da atividade é a quantidade de tempo que o Integration Appliance aguarda uma resposta do Servidor HTTP após enviar uma solicitação de HTTP, antes do Integration Appliance emitir um erro de tempo limite. Um tempo limite de atividade é diferente de um tempo limite de conexão porque um tempo limite de atividade ocorre após a conexão com o terminal ter sido estabelecida. Um tempo limite de conexão especifica a quantidade de tempo em segundos antes de um tempo limite ocorrer entre o Integration Appliance tentar estabelecer uma conexão com o terminal e o tempo que demora para o terminal responder à solicitação de conexão. Configure o tempo limite de conexão na guia Terminal HTTP. Para obter informações adicionais sobre tempos limites de conexão, consulte Criando ou Editando um Terminal HTTP.

Mapeando a Entrada para a Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação. O parâmetro de entrada body é exibido na área de janela Para Atividade da tarefa Mapear Entradas. Pelo menos uma variável deve ser mapeada para o parâmetro de entrada body - ele é um parâmetro obrigatório. O parâmetro de entrada body contém o corpo da mensagem de solicitação de HTTP enviada ao Servidor HTTP.
  2. Para visualizar os parâmetros de entrada opcionais na área de janela Para Atividade da área de janela Mapear Entradas, selecione Mapear > Mostrar Parâmetros Opcionais no menu da barra de ferramentas ou clique com o botão direito do mouse na área de janela Para Atividade e selecione a opção Mostrar Parâmetros Opcionais. Se a opção Mapear > Mostrar Parâmetros Opcionais não for selecionável no menu da barra de ferramentas, clique em um nó na área de janela Mapear Entradas para tornar essa opção ativa. Os parâmetros de entrada httpheaders e httpConnParameter são exibidos.
    A tabela a seguir define os nós do parâmetro de entrada httpheaders opcional:
    Tabela 3.
    Nós do Parâmetro de Entrada httpheaders Descrição
    httpheaders/uri Especifica o caminho do recurso, por exemplo: /myPath.
    httpheaders/method Especifica o tipo de pedido 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.
    ttpheaders/otherHeaders/headerItem/name Especifica o nome do parâmetro de cabeçalho HTTP.
    httpheaders/otherHeaders/headerItem/value Especifica o valor do parâmetro de cabeçalho HTTP.
    Nota: Se o cabeçalho Content-Length for configurado explicitamente usando httpheaders/otherHeaders/headerItem/name e httpheaders/otherHeaders/headerItem/value, durante o tempo de execução este valor será ignorado. Esta atividade configura automaticamente o cabeçalho Content-Length com o tamanho do corpo.
    A tabela a seguir define os nós do parâmetro de entrada httpConnParameter opcional. É possível, opcionalmente, substituir as configurações especificadas na tarefa Selecionar Terminal da Lista de Verificação dinamicamente durante o tempo de execução transmitindo valores de variáveis para os nós especificados na tabela a seguir. Por exemplo, durante o tempo de execução, é possível substituir o Nome do Host especificado no terminal, mapeando uma variável para o nó do host do parâmetro de entrada httpConnParameter. Durante o tempo de execução, o valor da variável é o nome do host usado para se conectar ao servidor HTTP.
    Tabela 4.
    Nós do Parâmetro de Entrada httpConnParameter Descrição Substitui quais configurações no terminal HTTP?
    timeout    
    host Especifica o nome do host ou endereço de IP do servidor HTTP remoto.   O nó host do parâmetro de entrada httpConnParameter substitui o campo Nome do Host do terminal HTTP.
    port Especifica o número da porta do servidor HTTP remoto.   O nó port do parâmetro de entrada httpConnParameter substitui o campo Porta do terminal HTTP.
    isSecure Configure este booleano igual a true para ativar o HTTPS - HTTP seguro sobre SSL. Configure este booleano igual a false para desativar a segurança. O nó isSecure do parâmetro de entrada httpConnParameter substitui a opção Segurança no terminal HTTP.
    username Especifica o nome de usuário para a conta usada para se conectar ao servidor HTTP. O nó username do parâmetro de entrada httpConnParameter substitui o campo Nome de Usuário no terminal HTTP.
    senha Especifica a senha para a conta usada para se conectar ao Servidor HTTP. O nó password do parâmetro de entrada httpConnParameter substitui o campo Senha no terminal HTTP.
  3. Crie um mapa entre a variável ou as variáveis de orquestração e o parâmetro ou parâmetros de entrada. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.

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 5.
    Parâmetro de Saída Descrição
    httpheaders Especifica o cabeçalho da resposta de HTTP.
    body Especifica o corpo da mensagem de resposta de HTTP.
    responsecode Especifica o Código de Resposta de HTTP que é retornado do Servidor HTTP durante o tempo de execução.  
    responsemessage Especifica a mensagem associada ao Código de Resposta de HTTP.
    A tabela a seguir define os nós do parâmetro de saída httpheaders:
    Tabela 6.
    Nós do Parâmetro de Saída httpheaders Descrição
    httpheaders/uri Especifica o caminho do recurso, por exemplo: /myPath.
    httpheaders/method Especifica o tipo de resposta de HTTP.
    httpheaders/otherHeaders/headerItem Especifica um conjunto de pares nome/valor que contêm os parâmetros HTTP da resposta de HTTP. Diversos parâmetros HTTP podem ser especificados na resposta de HTTP, portanto, headerItem é um nó recorrente.
    httpheaders/otherHeaders/headerItem/name Especifica o nome do parâmetro HTTP.
    httpheaders/otherHeaders/headerItem/value Especifica o valor do parâmetro 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.

Usando Certificados com o Microsoft Internet Explorer

Se você tiver selecionado a opção de segurança HTTPS no terminal HTTP, observe que o Microsoft Internet Explorer não reconhece um certificado modificado e armazena em cache o estado SSL. Se você modificar certificados, deverá limpar o estado SSL. Para limpar o estado SSL no Microsoft Internet Explorer:
  1. No menu da barra de ferramentas do Microsoft Internet Explorer, selecione Ferramentas > Opções da Internet.... A área de janela Opções da Internet é exibida.
  2. Clique na guia Conteúdo.
  3. Na seção Certificados, clique em Limpar Estado SSL. A caixa de diálogo Cache SSL Limpo com Êxito é exibida.
  4. Clique em OK e clique em OK.