> 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/es/analizar-y-exportar/advanced-search/advanced-search-syntax.md).

# Ejemplos de búsqueda avanzada

Consulta las reglas, los operadores y todas las columnas que se pueden buscar con sus alias para la Búsqueda avanzada en las tablas de Usuarios, Grupos, Dispositivos y Paquetes.

## Reglas de consulta

Una consulta consiste en términos de búsqueda simples y filtros de columna, separados por espacios. Las reglas:

* **Búsqueda tokenizada**:\
  Los términos de búsqueda se tokenizan automáticamente para mejorar la precisión de la coincidencia. Por ejemplo, al escribir `lu sk` coincidirá con nombres como **Luke Skywalker**. La búsqueda siempre usa un **enfoque de prefijo** en lugar de una búsqueda de texto completo o de "contiene". Esto significa que una búsqueda de `walk` devolvería **no** Skywalker **Skywalker**.
* **AND lógico**:\
  Todos los filtros se combinan usando **AND**. Todas las condiciones deben cumplirse.\
  Ejemplo: `Luke Skywalker country:france` busca Luke Skywalker donde el **país** empieza con "france".
* **Búsqueda específica por columna**:\
  Usa `column:` para buscar dentro de una columna específica.\
  Ejemplo: `country:france` busca entradas donde el **país** empieza con "france".
* **Operadores**:
  * `:` → **startsWith** búsqueda\
    Ejemplo: `name:jo` coincide con "John", "Joanna", etc.
  * `=` → **equals** búsqueda\
    Ejemplo: `city=Stuttgart` coincide exactamente con "Stuttgart"
  * `!=` o `!:` → **negación**\
    Ejemplo: `city!=Stuttgart` excluye exactamente "Stuttgart", `city!:Stutt` excluye todas las ciudades que empiezan con "Stutt". Ambas también excluyen las entradas en las que la columna está vacía.
* **Comportamiento especial**:
  * **Sustitución de diéresis**:\
    Las diéresis se normalizan en los términos de búsqueda simples (p. ej., **Björn** se puede encontrar buscando **Bjorn**). Las búsquedas específicas por columna no normalizan las diéresis, así que usa `city:München` en lugar de `city:Munchen`.
  * **Compatibilidad con Unicode**:\
    Se admiten caracteres Unicode en los términos de búsqueda.
  * **Los paréntesis () se ignoran** en búsquedas startsWith.
  * **Búsqueda de valor vacío**:
    * `zip:""` busca valores vacíos
    * `zip:` busca cualquier valor
* **Columnas admitidas**:\
  Consulta [Columnas admitidas](#supported-columns) para cada columna y alias que puedes buscar.

## Columnas admitidas

Cada tabla de abajo enumera las columnas que puedes usar en una búsqueda específica por columna (`column:value`). Puedes usar el nombre de la columna o uno de sus alias, y no importa si está en mayúsculas o minúsculas, así que `upn:`, `UPN:` y `userPrincipalName:` buscan todos la misma columna.

{% hint style="warning" %}
Si RealmJoin no reconoce un nombre de columna, esa parte de la consulta se ignora y los filtros restantes siguen aplicándose. Si tus resultados parecen sin filtrar, revisa si hay errores tipográficos en el nombre de la columna.
{% endhint %}

Los **Tipo** El tipo de columna te indica qué valores acepta una columna:

* **Texto**: `:` coincide con valores que empiezan con tu entrada, `=` coincide con el valor completo. No importa el uso de mayúsculas o minúsculas.
* **Sí/No**: usa `true` o `falso`, por ejemplo `enabled:false`. `:` y `=` se comportan igual aquí.
* **Número**: usa `=` para un valor exacto, por ejemplo `installFailedDeviceCount=0`. Con `:`, un número coincide con cualquier valor que empiece con los mismos dígitos, así que `installFailedDeviceCount:1` también coincide con 10 o 12.
* **Código**: el valor se almacena como un número. Los códigos se enumeran junto a la columna.
* **Fecha**: las fechas se almacenan en UTC como `YYYY-MM-DD hh:mm:ss`. Busca con el inicio de una fecha, por ejemplo `created:2025` para todo el año o `created:2025-03-14` para un día. No se admiten comparaciones como "antes" o "después" de una fecha.
* **ID**: un ID de objeto de Entra (GUID). Usa `:` con el inicio del ID, o pega un ID completo por sí solo (sin nombre de columna) para encontrar ese objeto directamente. En la tabla Devices, un ID pegado coincide con el ID del dispositivo.
* **Multivalor**: la columna contiene varios valores separados por espacios. Consulta [Columnas de varios valores](#multi-value-columns).

Un término de búsqueda simple sin nombre de columna solo busca en algunas de las columnas de texto. Se enumeran debajo de cada tabla.

### Usuarios

| Columna             | Alias                    | Tipo   | Descripción                                                       |
| ------------------- | ------------------------ | ------ | ----------------------------------------------------------------- |
| `id`                |                          | ID     | ID de objeto de Entra                                             |
| `displayName`       | `name`                   | Texto  | Nombre para mostrar                                               |
| `userPrincipalName` | `upn`                    | Texto  | Nombre principal de usuario                                       |
| `mail`              |                          | Texto  | Dirección de correo electrónico principal                         |
| `nombre`            | `firstName`, `first`     | Texto  | Nombre de pila                                                    |
| `apellido`          | `lastName`, `last`       | Texto  | Apellido                                                          |
| `jobTitle`          | `job`, `title`           | Texto  | Cargo                                                             |
| `departamento`      | `dept`                   | Texto  | Department                                                        |
| `city`              |                          | Texto  | City                                                              |
| `postalCode`        | `postcode`, `zip`, `plz` | Texto  | Código postal                                                     |
| `país`              |                          | Texto  | País, tal como se introdujo en Entra                              |
| `ubicación de uso`  | `location`               | Texto  | Ubicación de uso (código de país de dos letras, por ejemplo `DE`) |
| `preferredLanguage` | `language`, `lang`       | Texto  | Idioma preferido, por ejemplo `de-DE`                             |
| `accountEnabled`    | `activada`               | Sí/No  | Si la cuenta está habilitada                                      |
| `userType`          | `type`                   | Código | `1` = Miembro, `2` = Invitado, `0` = Desconocido                  |
| `createdDateTime`   | `created`                | Fecha  | Cuándo se creó la cuenta                                          |

Los términos de búsqueda simples coinciden con el nombre para mostrar, el correo electrónico, el UPN, el nombre, el apellido, el puesto, el departamento, la ciudad, el país y la ubicación de uso.

### Grupos

| Columna              | Alias                  | Tipo  | Descripción                                                                     |
| -------------------- | ---------------------- | ----- | ------------------------------------------------------------------------------- |
| `id`                 |                        | ID    | ID de objeto de Entra                                                           |
| `displayName`        | `name`                 | Texto | nombre de grupo                                                                 |
| `descripción`        | `desc`                 | Texto | Descripción                                                                     |
| `createdDateTime`    | `created`              | Fecha | Cuándo se creó el grupo                                                         |
| `expirationDateTime` | `expiration`           | Fecha | Cuándo expira el grupo (grupos de Microsoft 365 con una política de expiración) |
| `isTeamsEnabled`     | `teams`                | Sí/No | Si el grupo es un equipo                                                        |
| `isSecurity`         | `seguridad`            | Sí/No | Si el grupo es un grupo de seguridad                                            |
| `isStatic`           | `estático`             | Sí/No | `true` para membresía asignada, `falso` para membresía dinámica                 |
| `isRealmJoin`        | `realmJoin`, `rj`      | Sí/No | Si el grupo es un grupo RealmJoin                                               |
| `isOnPremises`       | `onPremises`, `onPrem` | Sí/No | Si el grupo está sincronizado desde local                                       |

Los términos de búsqueda simples coinciden con el nombre y la descripción del grupo.

### Dispositivos

| Columna                            | Alias                                          | Tipo       | Descripción                                                                                                                               |
| ---------------------------------- | ---------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                                                | ID         | ID de objeto de Entra                                                                                                                     |
| `deviceId`                         |                                                | ID         | ID del dispositivo                                                                                                                        |
| `displayName`                      | `name`                                         | Texto      | Nombre del dispositivo                                                                                                                    |
| `operatingSystem`                  | `os`                                           | Texto      | Sistema operativo tal como se muestra en la tabla, por ejemplo `Windows 11 (24H2)`                                                        |
| `operatingSystemFamily`            | `osFamily`, `family`, `osFam`, `fam`           | Código     | `1` = Windows, `2` = macOS, `3` = Linux, `4` = Android, `5` = iOS, `6` = iPadOS, `7` = Printer, `8` = Other, `0` = Desconocido            |
| `operatingSystemVersion`           | `osVersion`, `osVer`                           | Texto      | Número de versión del sistema operativo                                                                                                   |
| `fabricante`                       | `manu`                                         | Texto      | Fabricante                                                                                                                                |
| `model`                            |                                                | Texto      | Modelo                                                                                                                                    |
| `númeroDeSerie`                    | `serial`, `sn`                                 | Texto      | Número de serie                                                                                                                           |
| `accountEnabled`                   | `activada`                                     | Sí/No      | Si el dispositivo está habilitado en Entra                                                                                                |
| `isCompliant`                      | `en cumplimiento`, `compliance`                | Sí/No      | Si el dispositivo cumple con los requisitos                                                                                               |
| `createdDateTime`                  | `created`                                      | Fecha      | Cuándo se registró el dispositivo                                                                                                         |
| `lastSeen`                         | `last`                                         | Fecha      | Última actividad: informada por el agente RealmJoin si está instalado; de lo contrario, el último inicio de sesión aproximado desde Entra |
| `versión`                          | `rjVersion`, `ver`, `rj`                       | Texto      | Versión instalada del agente RealmJoin (vacío sin el agente)                                                                              |
| `intuneLastSyncDateTime`           | `intuneSync`, `intuneLastSync`, `lastSync`     | Fecha      | Última sincronización de Intune                                                                                                           |
| `registeredOwnerDisplayName`       | `ownerDisplayName`, `ownerName`, `propietario` | Texto      | Nombre para mostrar del propietario registrado                                                                                            |
| `registeredOwnerUserPrincipalName` | `ownerUserPrincipalName`                       | Texto      | UPN del propietario registrado                                                                                                            |
| `registeredOwnerId`                | `ownerId`                                      | ID         | ID de objeto del propietario registrado                                                                                                   |
| `ethernetMacAddress`               | `ethMac`, `ethernetMac`                        | Texto      | Dirección MAC de Ethernet informada por Intune                                                                                            |
| `wiFiMacAddress`                   | `wifiMac`, `wlanMac`                           | Texto      | Dirección MAC de Wi‑Fi informada por Intune                                                                                               |
| `macAddresses`                     | `mac`, `macAddress`                            | Multivalor | Todas las direcciones MAC conocidas: Ethernet y Wi‑Fi de Intune, más cada adaptador de red informado por el agente RealmJoin              |

Los términos de búsqueda simples coinciden con el nombre del dispositivo, el sistema operativo, la versión del SO, el fabricante, el modelo, el número de serie, el nombre del propietario, el UPN del propietario y las direcciones MAC.

Puedes introducir direcciones MAC con o sin separadores (`:`, `-` o `.`), por ejemplo `mac:E8-62-BE` o `mac:E862BE`.

### Paquetes

| Columna                            | Alias            | Tipo   | Descripción                                                                                                                                                                                                                                                                           |
| ---------------------------------- | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               |                  | Texto  | ID de aplicación o paquete                                                                                                                                                                                                                                                            |
| `displayName`                      | `name`           | Texto  | Nombre de la aplicación                                                                                                                                                                                                                                                               |
| `packageId`                        | `package`, `pkg` | Texto  | ID del paquete                                                                                                                                                                                                                                                                        |
| `type`                             |                  | Código | `1` = RealmJoin (heredado), `2` = Intune (sin administrar), `3` = Intune (básico), `5` = Intune (administrado), `6` = RealmJoin (básico), `7` = RealmJoin (administrado)                                                                                                              |
| `subtype`                          |                  | Texto  | Subtipo de la aplicación tal como se muestra en la tabla                                                                                                                                                                                                                              |
| `versión`                          |                  | Texto  | Versión                                                                                                                                                                                                                                                                               |
| `vista previa`                     |                  | Sí/No  | Si el paquete es un paquete de prelanzamiento (obsoleto)                                                                                                                                                                                                                              |
| `statusLatestVersion`              |                  | Texto  | Última versión disponible en la tienda de aplicaciones                                                                                                                                                                                                                                |
| `statusCurrentPreviewVersion`      |                  | Texto  | Versión actualmente en vista previa                                                                                                                                                                                                                                                   |
| `statusUpgradeAction`              |                  | Código | Acción de actualización disponible: `0` = ninguna, `1` = actualizar la aplicación principal, `2` = actualizar la aplicación de vista previa, `4` = crear aplicación de vista previa, `8` = aplicar la vista previa a la principal. Las acciones combinadas se suman; por ejemplo `3`. |
| `statusUpgradeActionPlanned`       |                  | Código | Acción de actualización planificada, mismos códigos que `statusUpgradeAction`                                                                                                                                                                                                         |
| `statusUpgradeActionSchedule`      |                  | Fecha  | Cuándo se ejecuta la acción de actualización planificada                                                                                                                                                                                                                              |
| `automationAutoDeployMain`         |                  | Sí/No  | Despliegue automático de la aplicación principal                                                                                                                                                                                                                                      |
| `automationAutoDeployPreview`      |                  | Sí/No  | Despliegue automático de la aplicación de vista previa                                                                                                                                                                                                                                |
| `notifyTechnicalApplicationOwners` |                  | Sí/No  | Si se notifica a los propietarios técnicos de la aplicación                                                                                                                                                                                                                           |
| `technicalApplicationOwners`       |                  | Texto  | Propietarios técnicos de la aplicación, separados por `;`                                                                                                                                                                                                                             |
| `installSource`                    |                  | Texto  | Origen de los números de instalación: `RealmJoin` o `Intune`                                                                                                                                                                                                                          |
| `installInstalledDeviceCount`      |                  | Número | Dispositivos con la aplicación instalada                                                                                                                                                                                                                                              |
| `installFailedDeviceCount`         |                  | Número | Dispositivos con una instalación fallida                                                                                                                                                                                                                                              |
| `installPendingDeviceCount`        |                  | Número | Dispositivos con una instalación pendiente (solo Intune)                                                                                                                                                                                                                              |
| `installNotInstalledDeviceCount`   |                  | Número | Dispositivos sin la aplicación (solo Intune)                                                                                                                                                                                                                                          |
| `installFailureScore`              |                  | Número | Puntuación de fallos de las instalaciones de la aplicación                                                                                                                                                                                                                            |
| `installSyncedAt`                  |                  | Fecha  | Cuándo se actualizaron por última vez los números de instalación                                                                                                                                                                                                                      |

Los términos de búsqueda simples coinciden con el nombre de la aplicación, el tipo, el subtipo y el ID del paquete.

Las columnas `versionParsed`, `statusLatestVersionParsed`, `statusCurrentPreviewVersionParsed`, `order` y `preReleasePartnerId` también se pueden buscar, pero contienen valores internos. Usa las columnas de arriba en su lugar.

### Columnas de varios valores

Una columna de varios valores contiene varios valores separados por espacios. Actualmente esto es `macAddresses` (`mac`) en la tabla Devices.

En estas columnas, los operadores `:`, `=`, `!:` y `!=` comprueban cada valor por separado, no la columna en su conjunto:

* `mac:E862` encuentra dispositivos en los que **algún** la dirección MAC empieza con `E862`.
* `mac=E862BE0A1B2C` encuentra dispositivos en los que **algún** la dirección MAC es exactamente `E862BE0A1B2C`.
* `mac!:E862` encuentra dispositivos en los que **no** la dirección MAC empieza con `E862`.
* `mac!=E862BE0A1B2C` encuentra dispositivos en los que **no** la dirección MAC es exactamente `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/es/analizar-y-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.
