> 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/advanced-search-syntax.md).

# Exemplos de pesquisa avançada

Consulte as regras de consulta, os operadores e todas as colunas pesquisáveis com os seus aliases para a Pesquisa Avançada nas tabelas de Utilizadores, Grupos, Dispositivos e Pacotes.

## Regras da consulta

Uma consulta consiste em termos de pesquisa simples e filtros de coluna, separados por espaços. As regras:

* **Pesquisa tokenizada**:\
  Os termos de pesquisa são tokenizados automaticamente 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 abordagem de **começa com** em vez de uma pesquisa de texto completo ou de "contém". Isso significa que uma pesquisa por `walk` iria **não** retornar **Skywalker**.
* **AND lógico**:\
  Todos os filtros são combinados usando AND lógico **AND**. Todas as condições devem ser atendidas.\
  Exemplo: `Luke Skywalker country:france` faz uma pesquisa por Luke Skywalker em que o **country** começa com "france".
* **Pesquisa específica de coluna**:\
  Use `column:` para pesquisar em uma coluna específica.\
  Exemplo: `country:france` faz uma pesquisa por entradas em que o **country** começa com "france".
* **Operadores**:
  * `:` → **startsWith** pesquisa\
    Exemplo: `name:jo` corresponde a "John", "Joanna", etc.
  * `=` → **equals** pesquisa\
    Exemplo: `city=Stuttgart` corresponde exatamente a "Stuttgart"
  * `!=` ou `!:` → **negação**\
    Exemplo: `city!=Stuttgart` exclui exatamente "Stuttgart", `city!:Stutt` exclui todas as cidades que começam com "Stutt". Ambas também excluem entradas em que a coluna está vazia.
* **Comportamento especial**:
  * **Substituição de trema**:\
    Os tremas são normalizados em termos de pesquisa simples (por exemplo, **Björn** pode ser encontrado pesquisando por **Bjorn**). Pesquisas específicas de coluna não normalizam tremas, então use `city:München` em vez de `city:Munchen`.
  * **Suporte a Unicode**:\
    Caracteres Unicode são suportados em termos de pesquisa.
  * **Os parênteses () são ignorados** em pesquisas startsWith.
  * **Pesquisa de valor vazio**:
    * `zip:""` faz uma pesquisa por valores vazios
    * `zip:` faz uma pesquisa por qualquer valor
* **Colunas suportadas**:\
  Veja [Colunas suportadas](#supported-columns) para cada coluna e alias que você pode pesquisar.

## Colunas suportadas

A tabela abaixo lista as colunas que você pode usar em uma pesquisa específica de coluna (`column:value`). Você pode usar o nome da coluna ou um de seus apelidos, e maiúsculas e minúsculas não importam, então `upn:`, `UPN:` e `userPrincipalName:` pesquisam a mesma coluna.

{% hint style="warning" %}
Se o RealmJoin não reconhecer um nome de coluna, essa parte da consulta é ignorada e os filtros restantes ainda se aplicam. Se seus resultados parecerem sem filtro, verifique se há erros de digitação no nome da coluna.
{% endhint %}

O **Tipo** A coluna informa quais valores ela aceita:

* **Texto**: `:` corresponde a valores que começam com sua entrada, `=` corresponde ao valor inteiro. A diferenciação entre maiúsculas e minúsculas não importa.
* **Sim/Não**: use `true` ou `false`, por exemplo `enabled:false`. `:` e `=` comportam-se da mesma forma aqui.
* **Número**: use `=` para um valor exato, por exemplo `installFailedDeviceCount=0`. Com `:`, um número corresponde a todos os valores que começam com os mesmos dígitos, então `installFailedDeviceCount:1` também corresponde a 10 ou 12.
* **Código**: o valor é armazenado como um número. Os códigos são listados ao lado da coluna.
* **Data**: as datas são armazenadas em UTC como `YYYY-MM-DD hh:mm:ss`. Pesquise com o início de uma data, por exemplo `created:2025` para o ano inteiro ou `created:2025-03-14` para um dia. Comparações como "antes" ou "depois" de uma data não são suportadas.
* **ID**: um ID de objeto do Entra (GUID). Use `:` com o início do ID, ou cole um ID completo por conta própria (sem nome de coluna) para localizar esse objeto diretamente. Na tabela Devices, um ID colado é comparado ao ID do dispositivo.
* **Múltiplos valores**: a coluna contém vários valores separados por espaços. Veja [Colunas de múltiplos valores](#multi-value-columns).

Um termo de pesquisa simples sem nome de coluna pesquisa apenas algumas colunas de texto. Elas estão listadas em cada tabela.

### Utilizadores

| Coluna              | Apelidos                 | Tipo    | Descrição                                                      |
| ------------------- | ------------------------ | ------- | -------------------------------------------------------------- |
| `id`                |                          | ID      | ID de objeto do Entra                                          |
| `displayName`       | `nome`                   | Texto   | Nome de exibição                                               |
| `userPrincipalName` | `upn`                    | Texto   | Nome principal do usuário                                      |
| `mail`              |                          | Texto   | Endereço de e-mail principal                                   |
| `givenName`         | `firstName`, `first`     | Texto   | Nome                                                           |
| `surname`           | `lastName`, `last`       | Texto   | Sobrenome                                                      |
| `jobTitle`          | `job`, `title`           | Texto   | Cargo                                                          |
| `department`        | `dept`                   | Texto   | Departamento                                                   |
| `city`              |                          | Texto   | Cidade                                                         |
| `postalCode`        | `postcode`, `zip`, `plz` | Texto   | Código postal                                                  |
| `country`           |                          | Texto   | País, conforme inserido no Entra                               |
| `usageLocation`     | `location`               | Texto   | Local de uso (código de país de duas letras, por exemplo `DE`) |
| `preferredLanguage` | `language`, `lang`       | Texto   | Idioma preferido, por exemplo `de-DE`                          |
| `accountEnabled`    | `enabled`                | Sim/Não | Se a conta está habilitada                                     |
| `userType`          | `type`                   | Código  | `1` = Membro, `2` = Convidado, `0` = Desconhecido              |
| `createdDateTime`   | `created`                | Data    | Quando a conta foi criada                                      |

Termos de pesquisa simples correspondem ao nome de exibição, mail, UPN, nome, sobrenome, cargo, departamento, cidade, país e local de uso.

### Grupos

| Coluna               | Apelidos               | Tipo    | Descrição                                                                  |
| -------------------- | ---------------------- | ------- | -------------------------------------------------------------------------- |
| `id`                 |                        | ID      | ID de objeto do Entra                                                      |
| `displayName`        | `nome`                 | Texto   | Nome do grupo                                                              |
| `description`        | `desc`                 | Texto   | Descrição                                                                  |
| `createdDateTime`    | `created`              | Data    | Quando o grupo foi criado                                                  |
| `expirationDateTime` | `expiration`           | Data    | Quando o grupo expira (grupos Microsoft 365 com uma política de expiração) |
| `isTeamsEnabled`     | `teams`                | Sim/Não | Se o grupo é uma equipe                                                    |
| `isSecurity`         | `security`             | Sim/Não | Se o grupo é um grupo de segurança                                         |
| `isStatic`           | `static`               | Sim/Não | `true` para associação atribuída, `false` para associação dinâmica         |
| `isRealmJoin`        | `realmJoin`, `rj`      | Sim/Não | Se o grupo é um grupo RealmJoin                                            |
| `isOnPremises`       | `onPremises`, `onPrem` | Sim/Não | Se o grupo está sincronizado a partir de ambientes locais                  |

Termos de pesquisa simples correspondem ao nome e à descrição do grupo.

### Dispositivos

| Coluna                             | Apelidos                                   | Tipo              | Descrição                                                                                                                          |
| ---------------------------------- | ------------------------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                                            | ID                | ID de objeto do Entra                                                                                                              |
| `deviceId`                         |                                            | ID                | ID do dispositivo                                                                                                                  |
| `displayName`                      | `nome`                                     | Texto             | Nome do dispositivo                                                                                                                |
| `operatingSystem`                  | `os`                                       | Texto             | Sistema operacional conforme mostrado na tabela, por exemplo `Windows 11 (24H2)`                                                   |
| `operatingSystemFamily`            | `osFamily`, `family`, `osFam`, `fam`       | Código            | `1` = Windows, `2` = macOS, `3` = Linux, `4` = Android, `5` = iOS, `6` = iPadOS, `7` = Impressora, `8` = Outro, `0` = Desconhecido |
| `operatingSystemVersion`           | `osVersion`, `osVer`                       | Texto             | Número da versão do sistema operacional                                                                                            |
| `manufacturer`                     | `manu`                                     | Texto             | Fabricante                                                                                                                         |
| `model`                            |                                            | Texto             | Modelo                                                                                                                             |
| `serialNumber`                     | `serial`, `sn`                             | Texto             | Número de série                                                                                                                    |
| `accountEnabled`                   | `enabled`                                  | Sim/Não           | Se o dispositivo está habilitado no Entra                                                                                          |
| `isCompliant`                      | `em conformidade`, `compliance`            | Sim/Não           | Se o dispositivo está em conformidade                                                                                              |
| `createdDateTime`                  | `created`                                  | Data              | Quando o dispositivo foi registrado                                                                                                |
| `lastSeen`                         | `last`                                     | Data              | Última atividade: relatada pelo agente RealmJoin, se instalado; caso contrário, o último início de sessão aproximado do Entra      |
| `version`                          | `rjVersion`, `ver`, `rj`                   | Texto             | Versão instalada do agente RealmJoin (vazio sem o agente)                                                                          |
| `intuneLastSyncDateTime`           | `intuneSync`, `intuneLastSync`, `lastSync` | Data              | Última sincronização do Intune                                                                                                     |
| `registeredOwnerDisplayName`       | `ownerDisplayName`, `ownerName`, `owner`   | Texto             | Nome de exibição do proprietário registrado                                                                                        |
| `registeredOwnerUserPrincipalName` | `ownerUserPrincipalName`                   | Texto             | UPN do proprietário registrado                                                                                                     |
| `registeredOwnerId`                | `ownerId`                                  | ID                | ID de objeto do proprietário registrado                                                                                            |
| `ethernetMacAddress`               | `ethMac`, `ethernetMac`                    | Texto             | Endereço MAC Ethernet relatado pelo Intune                                                                                         |
| `wiFiMacAddress`                   | `wifiMac`, `wlanMac`                       | Texto             | Endereço MAC Wi-Fi relatado pelo Intune                                                                                            |
| `macAddresses`                     | `mac`, `macAddress`                        | Múltiplos valores | Todos os endereços MAC conhecidos: Ethernet e Wi-Fi do Intune, além de cada adaptador de rede relatado pelo agente RealmJoin       |

Termos de pesquisa simples correspondem ao nome do dispositivo, sistema operacional, versão do SO, fabricante, modelo, número de série, nome do proprietário, UPN do proprietário e endereços MAC.

Você pode inserir endereços MAC com ou sem separadores (`:`, `-` ou `.`), por exemplo `mac:E8-62-BE` ou `mac:E862BE`.

### Pacotes

| Coluna                             | Apelidos         | Tipo    | Descrição                                                                                                                                                                                                                                      |
| ---------------------------------- | ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                  | Texto   | ID do aplicativo ou do pacote                                                                                                                                                                                                                  |
| `displayName`                      | `nome`           | Texto   | Nome do aplicativo                                                                                                                                                                                                                             |
| `packageId`                        | `package`, `pkg` | Texto   | ID do pacote                                                                                                                                                                                                                                   |
| `type`                             |                  | Código  | `1` = RealmJoin (legado), `2` = Intune (não gerenciado), `3` = Intune (básico), `5` = Intune (gerenciado), `6` = RealmJoin (básico), `7` = RealmJoin (gerenciado)                                                                              |
| `subtype`                          |                  | Texto   | Subtipo do aplicativo conforme mostrado na tabela                                                                                                                                                                                              |
| `version`                          |                  | Texto   | Versão                                                                                                                                                                                                                                         |
| `pré-visualização`                 |                  | Sim/Não | Se o pacote é um pacote de pré-lançamento (obsoleto)                                                                                                                                                                                           |
| `statusLatestVersion`              |                  | Texto   | Versão mais recente disponível na loja de aplicativos                                                                                                                                                                                          |
| `statusCurrentPreviewVersion`      |                  | Texto   | Versão atualmente em prévia                                                                                                                                                                                                                    |
| `statusUpgradeAction`              |                  | Código  | Ação de atualização disponível: `0` = nenhuma, `1` = atualizar aplicativo principal, `2` = atualizar aplicativo de prévia, `4` = criar aplicativo de prévia, `8` = aplicar prévia ao principal. As ações combinadas se somam, por exemplo `3`. |
| `statusUpgradeActionPlanned`       |                  | Código  | Ação de atualização planejada, mesmos códigos que `statusUpgradeAction`                                                                                                                                                                        |
| `statusUpgradeActionSchedule`      |                  | Data    | Quando a ação de atualização planejada é executada                                                                                                                                                                                             |
| `automationAutoDeployMain`         |                  | Sim/Não | Implantação automática do aplicativo principal                                                                                                                                                                                                 |
| `automationAutoDeployPreview`      |                  | Sim/Não | Implantação automática do aplicativo de prévia                                                                                                                                                                                                 |
| `notifyTechnicalApplicationOwners` |                  | Sim/Não | Se os proprietários técnicos do aplicativo são notificados                                                                                                                                                                                     |
| `technicalApplicationOwners`       |                  | Texto   | Proprietários técnicos do aplicativo, separados por `;`                                                                                                                                                                                        |
| `installSource`                    |                  | Texto   | Origem dos números de instalação: `RealmJoin` ou `Intune`                                                                                                                                                                                      |
| `installInstalledDeviceCount`      |                  | Número  | Dispositivos com a app instalada                                                                                                                                                                                                               |
| `installFailedDeviceCount`         |                  | Número  | Dispositivos com instalação falhada                                                                                                                                                                                                            |
| `installPendingDeviceCount`        |                  | Número  | Dispositivos com instalação pendente (apenas Intune)                                                                                                                                                                                           |
| `installNotInstalledDeviceCount`   |                  | Número  | Dispositivos sem a app (apenas Intune)                                                                                                                                                                                                         |
| `installFailureScore`              |                  | Número  | Pontuação de falha das instalações da app                                                                                                                                                                                                      |
| `installSyncedAt`                  |                  | Data    | Quando os números de instalação foram atualizados pela última vez                                                                                                                                                                              |

Os termos de pesquisa simples correspondem ao nome, tipo, subtipo e ID do pacote da app.

As colunas `versionParsed`, `statusLatestVersionParsed`, `statusCurrentPreviewVersionParsed`, `order` e `preReleasePartnerId` também são pesquisáveis, mas contêm valores internos. Em vez disso, use as colunas acima.

### Colunas de múltiplos valores

Uma coluna de vários valores contém vários valores separados por espaços. Atualmente, esta é `macAddresses` (`mac`) na tabela Devices.

Nestas colunas, os operadores `:`, `=`, `!:` e `!=` verificam cada valor individualmente, e não a coluna como um todo:

* `mac:E862` encontra dispositivos onde **qualquer** o endereço MAC começa por `E862`.
* `mac=E862BE0A1B2C` encontra dispositivos onde **qualquer** o endereço MAC é exatamente `E862BE0A1B2C`.
* `mac!:E862` encontra dispositivos onde **não** o endereço MAC começa por `E862`.
* `mac!=E862BE0A1B2C` encontra dispositivos onde **não** o endereço MAC é exatamente `E862BE0A1B2C`.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
