Atividade HTTP Solicitação Head

A atividade HTTP Solicitação Head envia uma Solicitação Head para o local especificado (terminal HTTP) e recebe uma resposta HTTP de volta desse local.

Incluindo uma Atividade HTTP Solicitação Head 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 Solicitação Head 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 do recurso para o qual a atividade Solicitação Head envia solicitação, por exemplo: /mypath. A sequência que você especificar nesse campo deverá excluir a sequência: http://, the hostname e o número da porta do Integration Appliance. A URL completa é 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 nesse campo. Por exemplo, se a URL completa para a qual a atividade Solicitação Head envia a solicitação for http://myAR:myPort/myPath, nesse campo, você só precisa especificar a sequência: /myPath. O caminho especificado deve ser exclusivo para as atividades Solicitação Head que são implementadas ao mesmo tempo no mesmo Integration Appliance usando a mesma porta.

    Para fazer uso dos parâmetros de caminho e parâmetros de consulta, insira uma URL neste formato: url/{path}?name1=value1&name2=value2. Isso permite mapear um valor de sequência para o parâmetro "{path}" e especificar nomes de parâmetro de consulta: name1 e name2 nesse exemplo. Se você escolher declarar vários parâmetros "{path}", cada parâmetro deverá ter um nome exclusivo. Parâmetros com o mesmo nome são representados por apenas um nó no mapa. Os parâmetros de caminho são exibidos sob /httpheaders/pathParameters em Mapear Entrada. E os parâmetros de consulta serão exibidos sob /httpheaders/queryParameters em Mapear Entrada.

    Nota: Na URL, nenhum valor que você designar a um parâmetro de consulta será passado para o mapeador. Para designar um valor ao parâmetro de consulta, mapeie explicitamente um valor para o parâmetro de consulta no mapeador ou defina um valor padrão.
    Onde a Mensagem de Solicitação é Do Tipo Especifica o tipo de mensagem esperado da resposta HTTP - ou 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 Solicitação Head e as atividades após a atividade Solicitação Head 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 Solicitação Head na orquestração e o código de resposta de erro e a mensagem de resposta de erro serem 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 HTTP Solicitação Invoke/Get/Post/Head/Put/Delete.

Especificando os Cabeçalhos de Solicitação

  1. Selecione a tarefa Cabeçalhos da Solicitação na Lista de Verificação. A área de janela Cabeçalhos da Solicitação é exibida. Uma tabela Cabeçalhos Customizados é exibida na parte superior, uma caixa de seleção Incluir Cabeçalhos Padrão Predefinidos é exibida na parte do meio e uma tabela Cabeçalhos Padrão é exibida na parte inferior.
  2. Clique no botão Incluir para incluir um cabeçalho na tabela Cabeçalhos Customizados. Clique na nova entrada para inserir um nome de cabeçalho ou selecione um nome de cabeçalho na lista suspensa. Se o nome do cabeçalho for um nome predefinido, uma descrição será exibida na coluna Descrição; caso contrário, insira sua própria descrição para os cabeçalhos.
  3. Para usar os cabeçalhos padrão predefinidos, marque a caixa de seleção Incluir Cabeçalhos Padrão Predefinidos. Observe que nomes de cabeçalho duplicados não são permitidos (ignorando a diferença de maiúsculas e minúsculas) e pode ser solicitada a remoção de todos os cabeçalhos duplicados na tabela Cabeçalhos Customizados. Os cabeçalhos de HTTP selecionados são exibidos sob /httpheaders em Mapear Entrada.

Especificando os Cabeçalhos de Resposta

  1. Selecione a tarefa Cabeçalhos de Resposta na Lista de Verificação. A área de janela Cabeçalhos de Resposta é exibida. Uma tabela Cabeçalhos Customizados é exibida na parte superior, uma caixa de seleção Incluir Cabeçalhos Padrão Predefinidos é exibida na parte do meio e uma tabela Cabeçalhos Padrão é exibida na parte inferior.
  2. Clique no botão Incluir para incluir um cabeçalho na tabela Cabeçalhos Customizados. Clique na nova entrada para inserir um nome de cabeçalho ou selecione um nome de cabeçalho na lista suspensa. Se o nome do cabeçalho for um nome predefinido, uma descrição será exibida na coluna Descrição; caso contrário, insira sua própria descrição para os cabeçalhos.
  3. Para usar os cabeçalhos padrão predefinidos, marque a caixa de seleção Incluir Cabeçalhos Padrão Predefinidos. Observe que nomes de cabeçalho duplicados não são permitidos (ignorando a diferença de maiúsculas e minúsculas) e é solicitada a remoção de todos os cabeçalhos duplicados na tabela Cabeçalhos Customizados. Os cabeçalhos de HTTP selecionados são exibidos sob /httpheaders em Mapear Saída.

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 conexão com um servidor HTTP:
    Campo Descrição
    Tentar novamente  
    1) Aguardar ___ segundos entre cada nova tentativa. Especifica a quantidade de tempo (em segundos) que o Integration Appliance espera 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 HTTP Solicitação Head e o Integration Appliance não puder se conectar ao servidor HTTP especificado, o Integration Appliance registrará os erros de conexão como Avisos no sistema e os logs de orquestração até o valor da 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.
    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 HTTP Solicitação Head, o tempo limite da atividade é a quantidade de tempo que o Integration Appliance espera por uma resposta do servidor HTTP após enviar uma solicitação de HTTP antes de o Integration Appliance lançar 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 mais informações sobre tempos limite de conexão, consulte Criando ou Editando um Terminal da Web em Serviço.

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 Atividade de Destino da tarefa Mapear Entradas. O parâmetro de entrada body é opcional. O parâmetro de entrada body contém o corpo da mensagem de resposta HTTP enviada de volta para o servidor HTTP.
  2. Para visualizar o parâmetro de entrada opcional na área de janela Atividade de Destino 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 Atividade de Destino 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 2.
    Nós do Parâmetro de Entrada httpheaders Descrição
    httpheaders/uri Especifica o caminho do recurso, por exemplo: /myPath.
    httpheaders/<configured_header_name> Se você configurou pelo menos um cabeçalho de solicitação na etapa Cabeçalhos da Solicitação, cada um será exibido aqui. <configured_header_name> é substituído pelos nomes de cabeçalho reais que você selecionou ou inseriu.
    httpheaders/pathParameters Se você configurou parâmetros de caminho na URL na etapa Configurar, cada um será exibido aqui. Se nenhum parâmetro de caminho for especificado, esse nó não será exibido.
    httpheaders/query Parameters Se você configurou parâmetros de consulta na URL na etapa Configurar, cada um será exibido aqui. Se nenhum parâmetro de consulta for especificado, esse nó não será exibido.
    httpheaders/otherHeaders/headerItem Especifica um elemento que contém um conjunto de parâmetros de cabeçalho HTTP como pares nome/valor para a resposta de HTTP. Diversos parâmetros HTTP podem ser especificados na resposta de HTTP, portanto, este é 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.
    Nota: Se o cabeçalho Content-Length for configurado explicitamente usando o 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. Opcionalmente, é possível substituir as configurações especificadas na tarefa Selecionar Terminal da Lista de Verificação dinamicamente durante o tempo de execução passando os valores das variáveis nos 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 3.
    Nós do Parâmetro de Entrada httpConnParameter Descrição Substitui quais configurações no terminal HTTP?
    timeout Especifica o período de tempo, em segundos, antes que ocorra o tempo limite.  
    host Especifica o nome do host ou endereço IP do servidor HTTP remoto. O nó de 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.
    password 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(s) variável(is) de orquestração e o(s) parâmetro(s) de entrada. Consulte Criando um Mapa para obter instruções gerais sobre o 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 Atividade de Partida da tarefa Mapear Saídas, conforme descrito na tabela a seguir:
    Tabela 4.
    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.
    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 opcional.
    Tabela 5.
    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/<configured_header_name> Se você configurou pelo menos um cabeçalho de resposta na etapa Cabeçalhos de Resposta, cada um será exibido aqui. <configured_header_name> é substituído pelos nomes de cabeçalho reais que você selecionou ou inseriu.
    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.
    httpheaders/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.

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.