> 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

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

{% hint style="success" %}
A experiência de Pesquisa Avançada está disponível para as tabelas Users-, Groups-, Devices- e Packages.\
Confira a subpágina de Casos de Uso para exemplos que ajudam você a obter mais valor dos dados do seu tenant.
{% endhint %}

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

{% hint style="info" %} <mark style="background-color:yellow;">**Todas as pesquisas precisam ser confirmadas usando o**</mark><mark style="background-color:yellow;">**&#x20;**</mark>*<mark style="background-color:yellow;">**símbolo da 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;">**.**</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. Ela também aparece durante o carregamento inicial da tabela em cache, permitindo que os usuários pesquisem imediatamente — mesmo antes de o cache estar totalmente criado.

### Pesquisa Avançada

O recurso de pesquisa avançada do RealmJoin usa cache e tokenização, tornando as pesquisas rápidas e confiáveis, e suporta caracteres Unicode como Ø. Essa tokenização permite pesquisas parciais de nomes, de modo que uma consulta como "Ma Mu" pode localizar um usuário chamado "Maren Müller".

Além disso, informações não exibidas na tabela também podem ser pesquisadas, 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 faltando informações adicionadas 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 os principais recursos 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 digitar `lu sk` corresponderá a nomes como **Luke Skywalker**. A pesquisa sempre usa uma **começa com** em vez de uma pesquisa de texto completo ou "contém". Isso significa que uma pesquisa por `walk` iria **não** retornar **Skywalker**.
* **E lógico**:\
  Todos os filtros são combinados usando o operador lógico **E**. Cada condição deve ser atendida.\
  Exemplo: `Luke Skywalker country:france` pesquisa Luke Skywalker em que o **país** começa com "france".
* **Pesquisa específica por coluna**:\
  Use `column:` para pesquisar dentro de uma coluna específica.\
  Exemplo: `country:france` pesquisa entradas em que o **país** 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 trema**:\
    Os caracteres com trema são normalizados (por exemplo, **Björn** pode ser encontrado pesquisando por **Bjorn**).
  * **Suporte a Unicode**:\
    Caracteres Unicode são suportados nos termos de pesquisa.
  * **Os parênteses () são ignorados** em pesquisas startsWith.
  * **Pesquisa por valor vazio**:
    * `zip:""` pesquisa valores vazios
    * `zip:` pesquisa qualquer valor
* **Colunas suportadas**:
  * Podem existir aliases para nomes de colunas e eles são listados entre parênteses
  * Tabela de usuários:
    * `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 é armazenada em cache conforme um agendamento, atualmente definido para 1 hora.

#### Posso atualizar os dados manualmente?

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

#### Outros usuários podem usar meus dados atualizados?

A tabela está disponível para todos os usuários na mesma instância do portal RealmJoin. Assim, uma reconstrução acionada também a fará para todos esses usuários.

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

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

#### Quanto tempo levará 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 é incomum que a reconstrução possa levar 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 os recursos 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
