> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/analisar-e-exportar/advanced-search.md).

# Pesquisa avançada

O RealmJoin apresenta um mecanismo de pesquisa renovado que permite acesso em tempo real aos dados do tenant. Este melhoramento garante um desempenho eficiente mesmo para tenants com um grande volume de objetos de utilizador, dispositivo e grupo.

{% hint style="success" %}
A experiência de Pesquisa Avançada está disponível para a tabela de Utilizadores, Grupos, Dispositivos e Pacotes.\
Consulte a subpágina Casos de Uso para exemplos que ajudam a tirar mais partido dos dados do seu tenant.
{% endhint %}

As tabelas podem ser pesquisadas usando a *básica* ou a *avançada* funcionalidade de pesquisa.

{% hint style="info" %} <mark style="background-color:yellow;">**Todas as pesquisas têm de ser confirmadas usando o**</mark><mark style="background-color:yellow;">**&#x20;**</mark>*<mark style="background-color:yellow;">**tecla Enter**</mark>*<mark style="background-color:yellow;">**&#x20;**</mark><mark style="background-color:yellow;">**ou a**</mark> <img src="/files/8c4652c9aa80931828210fb79a1ea88a2915132c" alt="" data-size="line"> <mark style="background-color:yellow;">**símbolo.**</mark>
{% endhint %}

### Pesquisa Básica

A Pesquisa Básica usa a Graph API para consultar diretamente os dados do tenant, fornecendo resultados em tempo real.

A Pesquisa Básica está sempre disponível como alternativa quando a Pesquisa Avançada não estiver disponível. Também aparece durante o carregamento inicial da tabela em cache, permitindo aos utilizadores pesquisar imediatamente — mesmo antes de a cache estar totalmente construída.

### Pesquisa Avançada

A funcionalidade de pesquisa avançada do RealmJoin usa cache e tokenização, tornando as pesquisas rápidas e fiáveis, e suporta caracteres Unicode como Ø. Esta tokenização permite pesquisas parciais de nomes, por isso uma consulta como "Ma Mu" pode localizar um utilizador chamado "Maren Müller".

Além disso, também é possível pesquisar informação não apresentada na tabela, como códigos postais ou UPN.

<figure><img src="/files/0f1fb431ae7a49f01e98b8134bcee15b6466eab3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Certifique-se de usar apenas o "Reload-Button" no canto superior direito se estiver a faltar informação adicionada muito recentemente do Entra / Intune.
{% endhint %}

### Visão geral da sintaxe da Pesquisa Avançada

A Pesquisa Avançada permite consultar os valores disponíveis da tabela usando uma sintaxe flexível e poderosa. Abaixo estão as principais funcionalidades e regras:

{% hint style="success" %}
Clique [aqui](/pt/analisar-e-exportar/advanced-search/advanced-search-syntax.md) para mais exemplos e casos de uso de exemplo
{% endhint %}

* **Pesquisa tokenizada**:\
  Os termos de pesquisa são automaticamente tokenizados para melhorar a precisão da correspondência. Por exemplo, ao escrever `lu sk` irá corresponder a nomes como **Luke Skywalker**. A pesquisa utiliza sempre uma abordagem starts-with em vez de uma pesquisa de texto integral ou "contains". Isto significa que uma pesquisa por **starts-with** iria `não` retornar **Skywalker** AND lógico \
  **Todos os filtros são combinados usando o operador lógico**.
* **AND lógico**:\
  Todos os filtros são combinados usando o operador lógico **AND**. Cada condição tem de ser cumprida.\
  Exemplo: `Luke Skywalker country:france` procura Luke Skywalker em que o **country** começa com "france".
* **Pesquisa específica por coluna**:\
  Use `column:` para pesquisar numa coluna específica.\
  Exemplo: `country:france` procura entradas em que o **country** começa com "france".
* **Operadores**:
  * `:` → **startsWith** pesquisa\
    Exemplo: `name:jo` corresponde a "John", "Joanna", etc.
  * `=` → **igual a** pesquisa\
    Exemplo: `city=Stuttgart` corresponde exatamente a "Stuttgart"
  * `!=` ou `!:` → **negação**\
    Exemplo: `city!=Stuttgart`ou `city!:Stuttgart` exclui "Suttgart"
* **Comportamento especial**:
  * **Substituição de umlauts**:\
    Os umlauts são normalizados (por exemplo, **Björn** pode ser encontrado pesquisando por **Bjorn**).
  * **Suporte a Unicode**:\
    Os caracteres Unicode são suportados nos termos de pesquisa.
  * **Os parênteses () são ignorados** nas pesquisas startsWith.
  * **Pesquisa de valor vazio**:
    * `zip:""` procura valores vazios
    * `zip:` procura qualquer valor
* **Colunas suportadas**:
  * Podem existir aliases para os nomes das colunas e são listados entre parênteses
  * Tabela de Utilizadores:
    * `name, upn, language (lang), jobtitle (job), city, country, zip (plz), enabled, department (dept)`
      * `enabled:` → aceita `verdadeiro` ou `false` (`enabled:true`)
  * Tabela de Grupos
    * `name`
  * Tabela de Dispositivos
    * `name, operatingsystem (os), manufacturer (manu), model`

### FAQ

#### Com que frequência os dados são armazenados em cache?

A tabela é colocada em cache segundo um agendamento, atualmente definido para 1 hora.

#### Posso atualizar os dados manualmente?

No canto superior direito de cada tabela, existe um botão para atualizar os dados em cache.

#### Outros utilizadores podem usar os meus dados atualizados?

A tabela está disponível para todos os utilizadores na mesma instância do portal RealmJoin. Assim, uma reconstrução acionada afetará todos esses utilizadores.

#### O que é uma instância do portal RealmJoin?

O portal RealmJoin tem três instâncias diferentes por motivos de balanceamento de carga e redundância.

#### Quanto tempo demorará uma reconstrução/atualização da pesquisa avançada?

O tempo de reconstrução depende do tamanho do tenant e do número de objetos. Não é invulgar que a reconstrução possa demorar vários minutos. Durante a reconstrução, apenas a pesquisa básica está disponível. Todos os dados são então consultados diretamente via Graph, reduzindo assim as capacidades de filtragem e a velocidade.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/pt/analisar-e-exportar/advanced-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
