Configurar pesquisas em aplicativos

Anotação:

ArcGIS Configurable Apps será descontinuado em 2025. Para saber mais sobre a descontinuidade do ArcGIS Configurable Apps e como migrar seus aplicativos configuráveis ​​para ArcGIS Instant Apps, consulte o artigo do ArcGIS Blog Roteiro para Aposentadoria do ArcGIS Configurable Apps .

A maioria dos modelos ArcGIS Configurable Apps suportam a habilidade de pesquisar locais e feições dentro do mapa. Um widget de pesquisa integrado na interface de usuário do aplicativo permite que um usuário insira termos de pesquisa. Se a pesquisa foi configurada no mapa da web, os aplicativos configuráveis utilizarão esta configuração após ela ser habilitada dentro do aplicativo.

Você também pode configurar a pesquisa em um aplicativo utilizando a guia Pesquisar do painel de configuração do aplicativo, independentemente de qualquer propriedade de pesquisa definida no nível de mapa da ewb. As seções abaixo descrevem como configurar a pesquisa em aplicativos.

Parâmetros de configuração

Configurable Apps suportam os mesmos tipos de fontes de pesquisa que são suportados em mapas da web—por exemplo, localizadores e camadas de feição pesquisáveis. Os aplicativos que suportam pesquisas tem uma guia Pesquisar no painel de configuração onde todas as fontes de pesquisa estão listadas. Cada fonte de pesquisa pode ser ativada ou desativada no aplicativo a partir desta lista. Você pode configurar os parâmetros para cada fonte de pesquisa clicando em Editar ao lado da fonte na lista.

Os seguintes parâmetros da fonte de pesquisa podem ser configurados:

  • Nome—Especifica um nome personalizado para a fonte de pesquisa.
  • Texto Reservado—Especifica o texto pré-definido mostrado na caixa de pesquisa antes de digitar um valor de pesquisa. Pense sobre isto como texto de sugestão.
  • Restringir pesquisa dentro do mapa—Marque esta caixa para encontrar somente feições que estejam dentro da extensão de mapa. Esta é a extensão salva no nível de mapa da web.
  • Habilitar Sugestões—Se você marcar esta caixa, potenciais correspondentes aparecerão em um menu suspenso à medida que um valor de pesquisa for inserido.
  • Máximo de Sugestões—Se as sugestões estiverem habilitadas, escolha o número máximo de sugestões que serão oferecidas por vez.
  • Exibir Sugestões—Para camadas pesquisáveis, você pode especificar como as sugestões são exibidas para usuários do aplicativo. Você pode exibir as sugestões, conforme aparecer um valor de campo especificado ou personalizo ao adicionar valores de texto e campo juntos.
  • Correspondente Exato—Marque esta caixa para limitar os resultados da pesquisa para somente resultados que correspondem exatamente ao valor digitado na caixa de pesquisa.

As seções a seguir descrevem como configurar fontes de pesquisa para personalizar a experiência de pesquisa para seu aplicativo.

Habilita um localizador como fonte de pesquisa

Todos os localizadores estabelecidos especificados nas configurações da organização aparecerão na lista de fontes de pesquisa e se comportarão no aplicativo, da mesma maneira que em um mapa da web no Map Viewer ou Map Viewer Classic.

Faça o seguinte para habilitar um localizador como uma fonte de pesquisa:

  1. Se necessário, marque a caixa Habilitar ferramenta de pesquisa na parte superior da guia Pesquisar.
  2. Marque a caixa ao lado do localizador que você deseja habilitar.
  3. Opcionalmente, clique em Editar ao lado do localizador para configurar parâmetros adicionais. Clique em Salvar ao finalizar.

Ativa uma camada de feição pesquisável como fonte de pesquisa

Se uma camada de feição pesquisável for detectada no mapa da web, ela aparecerá na lista de fontes de pesquisa identificada pelo nome.

Faça o seguinte para habilitar uma camada de feição pesquisável como fonte de pesquisa:

  1. Se necessário, marque a caixa Habilitar ferramenta de pesquisa na parte superior da guia Pesquisar.
  2. Marque a caixa ao lado da camada de feição pesquisável que você deseja habilitar.
  3. Clique em Editar ao lado do nome da camada e escolha um campo de pesquisa da lista Campos de Pesquisa.
    Anotação:

    Você deve declarar um campo de pesquisa para procura a camada de feição para trabalhar.

  4. Clique em Salvar.

Habilita múltiplas fontes de pesquisa

Talvez queira habilitar várias fontes de pesquisa em um aplicativo. Isso é útil quando os usuários do aplicativo podem precisar pesquisar em várias fontes de informação para usar o aplicativo. Lembre-se da finalidade do aplicativo e não habilite fontes de pesquisa não relacionadas a essa finalidade, pois podem causar confusão indesejada para o usuário final. Por exemplo, se a finalidade do aplicativo for localizar e atualizar os status do trabalho de manutenção da faixa de pedestre para uma cidade local, não será benéfico permitir um localizador mundial, pois isto poderia levar um usuário final longe da extensão da cidade local onde todos os recursos de manutenção da faixa de pedestre estão localizados.

Para habilitar múltiplas fontes de pesquisa, faça o seguinte:

  1. Se necessário, marque a caixa Habilitar ferramenta de pesquisa na parte superior da guia Pesquisar.
  2. Marque as caixas ao lado das fontes de pesquisa que deseja habilitar.
  3. Clique em Editar ao lado de cada fonte para confirmar ou configurar os parâmetros conforme necessários.
  4. Clique em Salvar.
  5. Na guia Pesquisar, faça um dos seguintes:
    • Se você tiver uma fonte de pesquisa padrão preferida, selecione-a no menu suspenso Selecionar fonte padrão. O usuário do aplicativo poderá escolher entre as outras fontes de pesquisa do aplicativo conforme necessárias.
    • Se você desejar que o comportamento padrão do aplicativo procure em todas as fontes de uma só vez, marque a caixa Pesuisar todas as fontes e selecione Todos no menu suspenso Selecionar fonte padrão.

    Todas as fontes que tiverem sugestões configuradas aparecerão no menu suspenso de sugestão se potenciais correspondentes forem encontradas com base no termo de pesquisa inserido.

Habilita pesquisa de múltiplos campos

Mais de um campo pode ser pesquisado dentro de uma fonte de pesquisa. Por exemplo, você pode permitir que os usuários do seu aplicativo encontrem um recurso com base em diferentes tipos de informações, como encontrar um feição de lote com base em seu número de identificação ou nome do proprietário.

Para habilitar múltiplas pesquisas de campo, faça o seguinte:

  1. Se necessário, marque a caixa Habilitar ferramenta de pesquisa na parte superior da guia Pesquisar.
  2. Clique em Editar ao lado da fonte de pesquisa na lista.
  3. Na lista Campos de Pesquisa, clique em um dos campos e pressione a tecla Ctrl enquanto clicar em outros campos que deseja habilitar para pesquisa.
  4. Clique em Salvar.

Ao configurar uma pesquisa de múltiplos campos, é recomendado que você também configure sugestões e personalize um modelo de sugestão, conforme descrito nas seções a seguir.

Configurar sugestões

Se você habilitar sugestões para o seu aplicativo, potenciais correspondentes aparecerão no menu suspenso da pesquisa para que os usuários escolham, pois eles inserem um valor de pesquisa. As sugestões são úteis quando um usuário conhece parte, mas não todo, um termo de pesquisa exato. Eles também são úteis para permitir que os usuários do aplicativo escolham mais rapidamente o correspondente correto de uma lista após digitarem alguns caracteres-chaves. As sugestões também são recomendadas quando vários campos de pesquisa foram configurados para uma fonte de pesquisa.

Para configurar sugestões, faça o seguinte:

  1. Se necessário, marque a caixa Habilitar ferramenta de pesquisa na parte superior da guia Pesquisar.
  2. Clique em Editar ao lado da fonte de pesquisa na lista.
  3. Marque a caixa de seleção Habilitar Sugestões.
  4. No menu suspenso Máximo de Sugestões, escolha o número máximo de sugestões desejado para exibir de uma só vez.
  5. Para camadas de feição pesquisáveis, faça o seguinte:
    1. Escolha Campo ou Modelo.
    2. Configure os parâmetros adicionais de acordo com suas necessidades.
  6. Clique em Salvar.

Criar modelos de sugestão

Ao configurar a pesquisa em uma camada pesquisável, você pode utilizar um modelo de sugestão para exibir vários campos em uma sugestão ou quando desejar a personalização de aparência das sugestões no menu suspenso Pesquisar do aplicativo.

Para configurar um modelo configurável, faça o seguinte:

  1. Se necessário, marque a caixa Habilitar ferramenta de pesquisa na parte superior da guia Pesquisar.
  2. Clique em Editar ao lado da camada pesquisável na lista.
  3. Marque a caixa de seleção Habilitar Sugestões.
  4. Clique em Modelo e digite seu modelo de sugestão.

    A sintaxe básica é ${fieldname}, onde você substitui o nome de campo pelo nome de campo cujo valor será exibido. Por exemplo, para criar uma string de sugestão que combina um valor de campo do tipo de árvore com um valor de campo do nome de parque, você pode utilizar a seguinte sintaxe:

    Tree Type: ${treeType}, Park: ${parkName}

    Esta string resultaria em uma sugestão como a seguinte exibida para usuários do aplicativo:

    Tree Type: Dogwood, Park: Eastland Community Park

  5. Clique em Salvar.