Usando a filtragem de condição

Os nós de solicitação do conector de descoberta fornecem um recurso de filtragem de condição, que pode ser usado durante as ações de recuperação ou atualização Se você incluir condições para recuperar ou atualizar ações, será possível, opcionalmente, usar a filtragem de condição para refinar as condições que são aplicadas. Este tópico descreve a configuração adicional necessária quando você deseja usar a filtragem de condições.

Antes de Começar

É necessário instalar o IBM® App Connect Enterprise 12.0.11.0 ou uma versão posterior para utilizar a filtragem por condições.

No Kit de Ferramentas do IBM App Connect Enterprise, crie um fluxo de mensagens contendo um nó de entrada e um nó de solicitação do conector de descoberta para o conector de descoberta que você deseja usar. Configure-o conforme descrito no tópico de configuração do conector escolhido (por exemplo, “Usando o Slack com IBM App Connect Enterprise ”). Por exemplo, o fluxo de mensagens a seguir contém um nó HTTPInput, um nó Slack Request e um nó HTTPReply.

1. Se o assistente Descoberta do Conector estiver em execução, feche-o clicando no X no canto superior direito da janela.
2. Na visualização Propriedades do nó de entrada para seu fluxo de mensagens, selecione a guia Básico . No campo Path suffix for URL , insira um valor para o sufixo do caminho, por exemplo /slack. (Neste exemplo, o nó de entrada é um nó HTTPInput .)
3. Na visualização Propriedades do nó de entrada para seu fluxo de mensagens, selecione a guia Análise da Mensagem de Entrada . No campo Message domain , selecione JSON: Para JavaScript Mensagens de notação de objeto no menu suspenso
4. Crie um esquema JSON em branco, conforme descrito em Criando um arquivo de esquema JSON Preencha o arquivo JSON com entradas relacionadas à ação que você está executando na Descoberta do Conector. Por exemplo, slack.schema.json:

   
   {
     "$schema": "http://json-schema.org/draft-04/schema#",
     "type": "object",
     "properties": {
       "ChannelName": {
         "type": "string"
       },
       "filterByChannelName": {
         "type": "boolean"
       }
     },
     "required": [
       "ChannelName",
       "filterByChannelName"
     ]
   }

   Para obter mais informações sobre como criar esquemas JSON, consulte json-schema.org.

5. Na visualização Propriedades do nó de solicitação, selecione a guia Solicitação . Clique em Incluir para abrir o assistente do Incluir entrada de entradas de Mapa
6. Conclua os campos a seguir:
   1. Input name: Escolha um nome exclusivo para a tabela de entradas de mapa, por exemplo, HTTP_Input.
   2. Input location: Clique Navegar e selecione $InputRoot/JSON/Data de Construtor de expressão XPath.
   3. Schema location: Clique em Procurar para abrir o assistente de Seleção de Esquema JSON , selecione o esquema criado na etapa 4 e clique em OK.
   4. Schema root: O local no arquivo de esquema que descreve a estrutura da mensagem.. Esse valor será necessário apenas se o esquema JSON não estiver na raiz do documento de esquema...
7. Clique em OK para salvar as entradas.
8. Clique em Ativar descoberta do conector para iniciar o assistente de descoberta do conector para o conector de descoberta.
9. Se você não tiver clicado em Incluir condição, clique agora e, em seguida, selecione a propriedade que deseja filtrar.
   A opção Ativar filtragem de condição torna-se visível no Menu de opções de mapa.
10. No assistente de Descoberta do Conector, clique em Menu de opções de mapa e selecione Ativar filtragem de condição.
    
    O texto "Modo de filtro" é exibido próximo ao controle Menu de opções de mapa .
    
11. Coloque o cursor no campo de entrada, exclua qualquer texto existente e clique em Inserir um mapeamento para abrir a tabela Mapeamentos disponíveis .
    Os mapeamentos na tabela Mapeamentos disponíveis são derivados do esquema JSON que você criou na etapa 4 e referenciados a partir do nó de solicitação na etapa 6.
12. No Mapeamentos disponíveis tabela, clique Entradas do mapa/HTTP_Input/Objeto /ChannelName

    O texto SampleChannelName é exibido no campo de entrada. (Esses são os dados associados ao mapeamento ChannelName e são derivados do esquema JSON criado na etapa 4.) O campo only if: será exibido. O menu suspenso tem as opções True, Falsee Custom.

    
13. No menu suspenso no campo apenas se: , selecione Customizado.
14. Exclua qualquer texto do campo somente se: e clique em Inserir um mapeamento.
15. No Mapeamentos disponíveis assistente, clique Entradas do mapa/HTTP_Input/Objeto /filterByChannelName .

    O texto True será exibido no campo somente se: . (Estes são os dados associados ao mapeamento filterByChannelName e é derivado do esquema JSON que você criou na etapa 4.)

16. Opcionalmente é possível preencher os campos manualmente digitando os valores necessários. Por exemplo, é possível digitar o valor mychannel em ChannelName
17. Opcionalmente, é possível editar os dados que estão associados a um mapeamento concluindo as etapas a seguir:
    1. Coloque o cursor no campo de entrada, exclua qualquer texto existente e clique em Inserir um mapeamento para abrir a tabela Mapeamentos disponíveis .
    2. Selecione um mapeamento na lista Mapeamentos disponíveis mesa, por exemplo Entradas do mapa/HTTP_Input/Objeto /ChannelName.
    3. Na seção "Recuperar canais", clique no ícone de lápis para visualizar mapeamentos disponíveis e editar seus dados de amostra.
       
       A tabela "Mapear entradas e dados de amostra" é exibida.
    4. Na tabela, selecione o mapeamento ChannelName e altere os dados SampleChannelName para meu canal.
       
       O texto "mychannel" será exibido após o campo selecionado.

       
18. Opcionalmente, é possível configurar propriedades que especificam o número máximo de registros a serem recuperados e a ação a ser executada se esse limite for excedido clicando em + ou - em Número máximo de itens a serem recuperados e selecionando o botão de opções Lança um erro ou Processar 10 itens da coleção.