> 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. Esta melhoria 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 Users-, Groups-, Devices- e Packages.\
Consulte a subpágina de Casos de Uso para exemplos que o ajudam a obter mais valor dos seus dados do Tenant.
{% endhint %}

As tabelas podem ser pesquisadas usando o *básica* ou o *avançada* recurso 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;">**símbolo da tecla Enter**</mark>*<mark style="background-color:yellow;">**&#x20;**</mark><mark style="background-color:yellow;">**ou o**</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 está. Também aparece durante o carregamento inicial da tabela em cache, permitindo que os utilizadores pesquisem 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 de nomes parciais, de modo que uma consulta como "Ma Mu" pode localizar um utilizador chamado "Maren Müller".

Além disso, informações não apresentadas 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 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
{% 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` corresponderá a nomes como **Luke Skywalker**. A pesquisa usa sempre uma **starts-with** abordagem em vez de uma pesquisa de texto completo ou "contains". Isto significa que uma pesquisa por `walk` iria **não** retornaria **Skywalker**.
* **E lógico**:\
  Todos os filtros são combinados usando o lógico **AND**. Todas as condições têm de ser cumpridas.\
  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 trema**:\
    Os tremas 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** nas pesquisas startsWith.
  * **Pesquisa por valor vazio**:
    * `zip:""` procura valores vazios
    * `zip:` procura qualquer valor
* **Colunas Suportadas**:
  * Podem existir aliases para nomes de colunas e são listados entre parênteses
  * Tabela de utilizadores:
    * `nome, upn, idioma (lang), cargo (job), cidade, país, código postal (plz), enabled, departamento (dept)`
      * `enabled:` → aceita `true` ou `false` (`enabled:true`)
  * Tabela de grupos
    * `nome`
  * Tabela de dispositivos
    * `nome, sistema operativo (os), fabricante (manu), modelo`

### FAQ

#### Com que frequência são os dados colocados 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 será feita para todos esses utilizadores.

#### 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 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, 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.
