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

- Uma tarefa de orquestração é iniciada.
- A atividade HTTP Receber Solicitação 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 aquelas localizadas no lado direito da atividade HTTP Receber Solicitação).
Não é possível implementar duas atividades HTTP Receber Solicitação para o dispositivo com os mesmos detalhes de terminal, URL e método.
Para uma única atividade HTTP Receber Solicitação
Se você implementar apenas uma atividade HTTP Receber Solicitação para uma URL, a orquestração aceitará todas as solicitações para essas URLs começando com essa URL base. Por exemplo, se você implementar /customer, ela aceitará solicitações para /customer, /customer/21, /customer/21/dept, entre outros.
Se você implementar uma atividade HTTP Receber Solicitação para uma URL com parâmetros de caminho, a orquestração aceitará apenas as solicitações cujas URLs correspondem à URL configurada com valores para parâmetros de caminho. Por exemplo, se você implementar /customer/{custid}, ela aceitará solicitações como /customer/10, /customer/21, /customer/dept . As URLs a seguir não são aceitas: /customer, /customer/21/dept, entre outras.
Para várias atividades HTTP Receber Solicitação
Se você implementar duas atividades HTTP Receber Solicitação configuradas com a mesma URL base e uma com parâmetro de caminho, as atividades aceitarão solicitações cujas URLs correspondem rigorosamente à URL configurada. Por exemplo, se você implementar /customer e /customer/{path parameter} e se /customer for chamado, a solicitação irá para a atividade configurada com /customer. Se /customer/007 for chamado, a solicitação irá para a atividade configurada com /customer/{path parameter}. Além disso, se você chamar as seguintes URLs: /customer/dept/1 ou /customer/12/21, nenhuma das atividades aceitará as solicitações.
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.
- 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 Descrição URL (Caminho Após Nome do Host) Especifica o caminho de recurso no qual o Integration Appliance recebe solicitações de HTTP de entrada, 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 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 na qual o Integration Appliance recebe solicitações de HTTP for http://myAR:myPort/myPath, nesse campo, você só precisará especificar a sequência: /myPath. O caminho especificado deve ser exclusivo para as atividades Solicitação de Recebimento HTTP 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 Saída. Parâmetros de consulta são exibidos sob /httpheaders/queryParameters em Mapear Saída.
Nota: Na URL, nenhum valor designado a um parâmetro de consulta será passado para o mapeador. O valor vem do servidor baseado na solicitação recebida real.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.Método Especifica qual método de HTTP é aceito pelo servidor de recebimento. 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 essa caixa de seleção for selecionada, você deverá incluir e configurar uma atividade HTTP Enviar Resposta 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 é 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 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 Saída.
Especificando informações do Swagger
- Selecione a tarefa Swagger na Lista de verificação para configurar a mensagem de amostra.
- Especifique as informações de Amostra de solicitação (JSON) e Amostra de resposta (JSON). Se você não especificar nenhuma amostra de solicitação, a Saída do Swagger será exibida com objetos de amostra vazios.
- Clique no botão Gerar Swagger, que exibirá o código na caixa de texto Saída do Swagger. Também é possível clicar em Fazer download do Swagger para fazer download e compartilhar o arquivo, se necessário.
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:A tabela a seguir define os nós do parâmetro de saída httpheaders opcional.
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. 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. httpheaders/host Especifica o endereço IP ou o nome do host do cliente. 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/<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/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. - 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 . A URL especificada na URL do campo do conector de entrada deve conter a URL completa, por exemplo: http://myAR:myPort/myPath.