Atividade HTTP Solicitação Invoke
A atividade HTTP Solicitação Invoke envia uma solicitação de HTTP para o local especificado, o terminal HTTP, e recebe uma resposta HTTP de volta desse local.
Incluindo uma Atividade HTTP Solicitação Invoke na Orquestração
- Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta HTTP.
- Arraste a atividade Solicitação Invoke para a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal HTTP
- Clique na tarefa Selecionar Terminal na Lista de Verificação e
escolha a partir de uma das seguintes ações:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK. Vá para o procedimento "Configurar a Atividade".
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK.
- Clique em Editar. A área de janela Editar Terminal é exibida.
- Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
- Selecione um terminal existente:
- Crie ou edite um terminal HTTP, consulte Criando ou Editando um Terminal HTTP.
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
- 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 Invoke envia solicitação, por exemplo: /mypath. A sequência que você especificar nesse campo deverá 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, 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 Invoke 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 Invoke 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}", é recomendado que cada parâmetro tenha 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. Parâmetros de consulta sã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 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 Solicitação Invoke e as atividades após a atividade Solicitação Invoke 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 Invoke 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
- 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.
- 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.
- 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 Entrada.
Especificando os Cabeçalhos de Resposta
- 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.
- 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.
- 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
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
- 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 Solicitação Invoke, 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 informações adicionais sobre tempos limites de conexão, consulte Criando ou Editando um Terminal HTTP.
Mapeando a Entrada para a Atividade
- 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 é obrigatório e pelo menos uma variável deve ser mapeada para ele. O parâmetro de entrada body contém o corpo da mensagem de solicitação de HTTP enviada ao Servidor HTTP.
- Para visualizar os parâmetros de entrada
opcionais na área de janela Atividade de Destino da área de janela Mapear
Entradas, selecione
Mostrar Parâmetros Opcionais.
Se a opção 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. Se nenhum valor for mapeado, o método padrão será POST. 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/queryParameters 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. 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. 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. 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 4. 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ó 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.
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 - 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
- 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 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/<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 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. - 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
- No menu da barra de ferramentas do Microsoft Internet Explorer, selecione . A área de janela Opções da Internet é exibida.
- Clique na guia Conteúdo.
- Na seção Certificados, clique em Limpar Estado SSL. A caixa de diálogo Cache SSL Limpo com Êxito é exibida.
- Clique em OK e clique em OK.