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.
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:
- Uma tarefa de orquestração é iniciada.
- 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.
- 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.
- 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
- 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 Receber Solicitação para a orquestração.
- 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
- 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.
- 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 |
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 com a Atividade Enviar Resposta de HTTP. |
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 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. |
- 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 no menu Iniciar, selecione a opção
. A URL especificada na URL do campo do
conector de entrada deve conter a URL completa, por exemplo:
http://myAR:myPort/myPath.