Skip To Content

Widget Filtrar Grupo

O widget Filtrar Grupo permite a você aplicar um filtro no mapa baseado em uma ou mais camadas no mapa. Um conjunto de camadas que são agrupadas em um conjunto de filtro lógico. Cada conjunto pode ter um valor pré-definido para facilitar a interação do usuário. Este widget tem dois modos: normal, que permite a construção de filtros complexos durante o tempo de execução e simples, que permite somente que um critério de filtro seja aplicado.

Configurar o widget Filtrar Grupo

Este widget pode ser configurado para abrir automaticamente quando um aplicativo iniciar. Clique no botão Não abrir este widget quando o aplicativo iniciar Não abrir este widget quando o aplicativo iniciar no widget para ativar a opção de abrir o widget automaticamente. (Para os widgets que você precisa adicionar primeiro ao aplicativo, é possível criar esta configuração após configurar o widget.)

As seguintes etapas indicam como criar um conjunto de filtros. Repita estas etapas se você precisar definir conjuntos de filtros adicionais.

  1. Paire sobre o widget e clique no botão Configurar este widget Configurar este widget para abrir a janela de configuração.
    Anotação:

    Caso seja necessário adicionar o widget ao aplicativo primeiro, clique em um espaço reservado de widget na guia Widget . Na janela Escolher Widget que abre, selecione o widget e clique em OK.

  2. Opcionalmente clique em Alterar ícone do widget para substituir o ícone padrão deste widget.
    Uma janela do explorador de arquivo aparece permitindo a você escolher um arquivo de imagem local para utilizar como o ícone do widget.

    A configuração exibe um grupo que está pronto para modificar.

  3. Defina um Nome do Conjunto de Filtros.

    A opção do nome do conjunto de filtro, será o nome utilizado pelo usuário. Opcionalmente, você pode oferecer uma descrição para guiar usuários sobre o que será filtrado por este grupo.

  4. Opcionalmente, utilize Operador Pré-Configurado e Valor Pré-Configurado para definir um valor para este filtro de forma que durante o tempo de execução, os usuários não tenham que fornecer estes critérios. Para Valor Pré-Configurado, você tem a opção de digitar um valor ou clicar no botão de pesquisa para escolher um valor de uma camada existente.
  5. Se você desejar filtrar em campos diferentes na mesma camada, o parâmetro Quando uma camada é listada mais de uma vez, utilize o seguinte operador entre os campos que controla como ligar estes filtros utilizando OU ou E.
  6. A tabela que é fornecida, exibe as camadas para agrupar no filtro definido. Você deve visualizar uma camada já preenchida por um padrão com uma camada aleatória do seu mapa. Escolha a camada e o campo que deseja aplicar um filtro.
  7. Selecione o botão Utilizar Valor , isto permite que você escolha se um valor da lista suspensa aparece para o usuário localizar um valor. Se a opção não for selecionada, uma caixa de texto aparece ao invés.

    Anotação:

    Este botão é opcional.

  8. Para adicionar outra camada neste conjunto de filtros, clique no botão Adicionar Camada.
  9. Para adicionar outro conjunto de filtros, clique no botão Adicionar um Novo Grupo . Isto cria outro agrupamento do conjunto de filtros. Se necessário, repita as etapas 3 até 7.
  10. Especifique o texto do cabeçalho personalizado utilizando a caixa de texto Fornecer texto a ser exibido acima da seleção do filtro .
  11. As seguintes cinco caixas de seleção controlam o modo que o widget se comporta:
    • Iniciar em Visualização Simples determina como o widget parecerá para usuários finais. Marcar esta caixa removerá a lista suspensa do operador e o botão Adicionar Critérios da interface, dando uma aparência mais básica.
    • Ocultar Opções do Widget determina se mostrar um ícone para expor configurações de widget adicionais. Estas configurações incluem salvar e carregar os filtros definidos, acrescentar na definição do filtro existente no mapa se existir, e persistir no filtro mesmo após o widget ser fechado.
    • Se o mapa da web tiver um filtro pré-definido existente aplicado, Anexar Filtro para Filtro de Mapa da Web Existente Utilizando OU ou E permite a você decidir se deseja substituir este filtro ou anexar filtros criados neste widget no filtro de mapa da web existente. Por padrão, este widget substituirá o filtro de mapa da web. Adicionalmente, habilitar esta opção persistirá os filtros através de grupos múltiplos.
    • Zoom para determina se ampliar o mapa na extensão dos dados filtrados. Por padrão, o mapa mantém sua extensão atual.
    • Persistir Após Widget Ser Fechado permite a você persistir o filtro quando o widget for fechado.
    • Ocultar a seleção de cabeçalho e filtro se somente 1 grupo estiver configurado permite a você ocultar o cabeçalho e o menu suspenso quando somente um grupo estiver configurado.

Utilizar o widget Filtrar Grupo

  1. Clicar no widget Filtrar Grupo para exibir uma seleção de conjuntos de filtros pré-definidos.

    Aplicar um conjunto de filtros pré-definido

    Duas listas aparecem abaixo do divisor de linha: operadores e valores. No exemplo, o mapa é filtrado para mostrar somente reclamações de veículo motorizado abandonado.

    Anotação:

    Dependendo de como as camadas são configuradas no widget, você visualizará uma lista de valores (semelhante à deste exemplo), uma caixa de texto para entrada do usuário ou um seletor de datas.

  2. Clique em Aplicar para aplicar o filtro no mapa.

    Opcionalmente, você pode aplicar filtros adicionando parâmetros da URL na URL do aplicativo. A URL deve estar no seguinte formato—substitua as variáveis entre colchetes pelos valores descritos na lista abaixo:

    https://<your portal URL>/apps/webappviewer/index.html?id=<Item ID>&groupfilter={"<Filter Set Name>":["<value>","<value>",...]}
    • ID do Item—O ID único do aplicativo.
    • Nome Definido do Filtro—O nome definido para o grupo de filtros. Este valor diferencia letra maiúscula e minúscula.
    • Valor—O valor utilizado para executar o filtro. Para filtrar com base em domínios, utilize o código de domínio.

    Por exemplo, para aplicar o filtro mostrado na imagem anterior, você utilizaria uma URL semelhante ao seguinte exemplo:

    https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle"]}

    Anotação:

    Se o widget Filtro de Grupo não estiver configurado para abrir automaticamente quando o aplicativo iniciar, o filtro definido na URL não se aplicará até que você abra o widget.

  3. Clique em Redefinir para remover o filtro e restaurar o mapa para o estado inicial. (Por padrão, fechar o widget também removerá o filtro.)
  4. O widget permite a você adicionar critérios de filtro adicionais no runtime. Clique em Adicionar Critérios para adicionar outra cláusula. Note que os dois critérios são unidos com uma conjunção. Você pode escolher juntá-los utilizando OR ou AND.

    Adicionar critérios de filtro adicionais

    Para utilizar parâmetros da URL para aplicar o filtro mostrado neste exemplo, sua URL seria semelhante ao seguinte exemplo:

    https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle","Auto Theft"]}

  5. O widget tem uma opção de salvar para armazenar estas configurações de critérios definidas para uso futuro. Clique no botão de configurações para acessar o painel de opções.

    Opção Salvar

    1. Clique em Salvar para salvar os critérios definidos localmente como um arquivo de texto de JSON.
    2. Clique em Transferir um Arquivo Salvo , para carregar um arquivo salvo anteriormente para restaurar todos os critérios definidos no arquivo.
    3. Caso seja necessário utilizar o mapa filtrado em outros widgets, marque Persistir Após o Fechamento do Widget. Caso contrário, o fechamento do widget removerá os filtros e restaurará o estado inicial do mapa.