> 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/dev-reference/runbook-output-data.md).

# Datos de salida de Runbook

Presenta los resultados de runbook como tablas ordenables y filtrables en el RealmJoin Portal, y escribe runbooks que emitan objetos estructurados.

## Resumen

**Datos de salida** es la contraparte estructurada de la **Consola** pestaña de una página de trabajo de runbook. La consola conserva el flujo de texto sin procesar, línea por línea, de una ejecución; Datos de salida representa como tablas los objetos emitidos por esa misma ejecución. Los valores largos, como los GUID, se muestran completos en lugar de truncarse a `…` por el formateador de consola de PowerShell, y los conjuntos de resultados amplios siguen siendo legibles en lugar de ajustarse.

Características clave:

* **Sin configuración ni permisos adicionales** — la pestaña está disponible para cada runbook que emite objetos. No hay que habilitar nada, y no se ve afectado quién puede iniciar un runbook.
* **Objetos en lugar de texto preformateado** — las tablas se crean a partir de lo que el runbook escribe en el flujo de salida. Un runbook que preformatea sus resultados con `Format-Table` no produce Datos de salida en absoluto.
* **Tablas interactivas** — cada tabla se puede ordenar, filtrar, paginar y exportar a Excel o CSV independientemente de las demás.
* **Los datos anidados siguen siendo inspeccionables** — los objetos y las matrices dentro de una celda se pueden expandir en lugar de aplanarse en una cadena ilegible.
* **La pestaña Consola no cambia** — la salida de texto completa sigue estando disponible y se puede copiar, que es lo que normalmente necesita un ticket de servicio o ITIL.

## Inicio rápido

El runbook mínimo viable emite un objeto marcador con el nombre de la tabla y, a continuación, los datos:

```powershell
[PSCustomObject]@{ RjTableTitle = 'Dispositivos no conformes' }
Write-Output $nonCompliantDevices
```

Esto produce una tabla titulada **Dispositivos no conformes** en la pestaña Datos de salida: una fila por dispositivo, una columna por propiedad, además de una línea de resumen compacta en la pestaña Consola que enlaza con ella.

## Lectura de Datos de salida en el portal

Abra un trabajo desde [Runbook Logs](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-logs.md) y cambie a la pestaña **Datos de salida** . Consulte [Detalles del trabajo de runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-logs/runbook-job-details.md) para ver las demás pestañas de esa página.

### Tablas y navegación

Cada conjunto de objetos que emite un runbook se convierte en una tabla. Una tabla incluye:

* **Un título** — el nombre que estableció el runbook (consulte [Asignar nombre a una tabla](#naming-a-table)) o el nombre alternativo `Tabla 1`, `Tabla 2` y así sucesivamente.
* **Una entrada en la barra lateral** — todas las tablas se enumeran a la izquierda; al hacer clic en un título se salta a ella.
* **Un contador de filas** — `12 / 340 filas` muestra cuántas filas coinciden con el filtro actual del total de la tabla.

### Filtrar

Los **Filtrar…** El cuadro situado encima de una tabla conserva solo las filas que contienen el texto introducido. El filtro es una coincidencia de subcadena sin distinción entre mayúsculas y minúsculas en todas las columnas de esa tabla. Cada tabla se filtra de forma independiente.

### Ordenar

Al hacer clic en un encabezado de columna, se ordena por esa columna; al volver a hacer clic se invierte la dirección. Una flecha (`▲` / `▼`) indica la columna activa. La ordenación reconoce los tipos:

| Contenido de la columna | Orden de clasificación                                    |
| ----------------------- | --------------------------------------------------------- |
| Números                 | Numérico — `2` antes de `10`.                             |
| Fechas                  | Cronológico.                                              |
| Todo lo demás           | Alfabético, sin distinción entre mayúsculas y minúsculas. |

Las celdas vacías se ordenan primero.

### Paginación

Las tablas se paginan en 50 filas, con un paginador debajo de la tabla. El filtro y la ordenación siempre se aplican a toda la tabla, no solo a la página mostrada actualmente.

### Objetos y listas anidados

Una celda que contiene un objeto o una matriz anidados no se aplana en texto ilegible:

* La celda muestra un cursor (`▸`). Al hacer clic en él, ese objeto o matriz se expande en línea debajo de la fila.
* El encabezado de columna muestra una flecha de expansión. Al hacer clic en ella, se expande toda la columna en su propia tabla: el valor anidado de cada fila principal se desglosa en filas, y una columna de referencia enlaza con el número de fila principal. La nueva tabla se añade al final de la página y a la barra lateral, y se puede filtrar, ordenar y exportar como cualquier otra.

### Exportar

Cada tabla tiene sus propios botones **Exportar a Excel** (`.xlsx`) y **Exportar a CSV** . Las exportaciones respetan el filtro activo: solo se escriben las filas coincidentes, y usan el título de la tabla como nombre de archivo. Exportar a Excel también usa el título como nombre de hoja de cálculo y falla si los títulos superan los 31 caracteres; consulte [Asignar nombre a una tabla](#naming-a-table).

La exportación desde el portal cubre el caso ad hoc. Para los archivos de informes que un runbook debe entregar por sí solo, como adjunto de correo o como enlace de descarga, créelos en el runbook en su lugar, con [Export-RjRbXlsx](https://docs.realmjoin.com/es/dev-reference/report-functions/export-rjrbxlsx.md) y los asistentes de entrega.

## Pestaña Consola

Cuando un trabajo emitió tablas, la pestaña **Consola** muestra de forma predeterminada una vista comprimida. Las tablas se dibujan al estilo PowerShell, pero truncadas, para que las líneas de estado sigan siendo legibles y un runbook que emitió cientos de objetos no inunde la página. En lugar de cada tabla, la consola muestra un cuadro de resumen:

```plaintext
╭─ Tabla ────────────────────────────────────────────╮
│ <nombre de tabla> · <número de filas> filas        │
╰──────────────────────────── → pestaña "Datos de salida" ──╯
```

Las tablas emitidas en sucesión directa comparten un cuadro:

```plaintext
╭─ Tabla ────────────────────────────────────────────╮
│ Dispositivos              · 3123 filas             │
│ Credenciales de aplicación · 42 filas               │
│ Muestra de exportación grande · 987654 filas        │
╰──────────────────────────── → pestaña "Datos de salida" ──╯
```

`→ pestaña "Datos de salida"` es un enlace y cambia a la tabla correspondiente.

Dos botones controlan la vista:

* **Mostrar salida completa** — cambia al texto completo, sin truncar.
* **Mostrar tablas comprimidas** — vuelve a cambiar.

**Copiar al portapapeles** siempre copia la salida sin procesar completa, independientemente de la vista mostrada.

## Emisión de Datos de salida desde un runbook

La pestaña se crea a partir de los objetos que emite un runbook. Por tanto, las tablas limpias requieren que el runbook escriba objetos en lugar de preformatearlos como texto.

### Emita objetos, no texto formateado

> **Nunca canalice la salida a través de `Format-Table` o `Format-List`.** Esos cmdlets emiten registros del motor de formato, no datos. El portal los detecta y oculta, y muestra una pista de que la salida se formateó incorrectamente. Lo mismo se aplica cuando PowerShell formatea automáticamente un resultado porque se escribió en el host en lugar de en el flujo de salida.

`Format-*` Los cmdlets solo controlan la *visualización*. Todo aquello para lo que se usaron tiene un equivalente de datos que Datos de salida puede representar; en particular, seleccionar columnas es lo que hace `Select-Object` :

| En lugar de                          | Utilice                              |
| ------------------------------------ | ------------------------------------ |
| `$devices \| Format-Table Name, Id`  | `$devices \| Select-Object Name, Id` |
| `$devices \| Format-Table -AutoSize` | `Write-Output $devices`              |
| `$devices \| Format-List`            | `Write-Output $devices`              |

`Select-Object Name, Id` produce la misma selección de columnas que `Format-Table Name, Id` habría mostrado, pero emite objetos, por lo que las columnas llegan a la pestaña Datos de salida en lugar de descartarse como registros de formato:

```powershell
# Correcto — objetos reales, columnas elegidas con Select-Object
$devices | Select-Object Name, Id, OperatingSystem, LastSeen

# Incorrecto — registros de formato, ocultos de Datos de salida
$devices | Format-Table Name, Id, OperatingSystem, LastSeen
```

Las propiedades seleccionadas son exactamente las columnas de la tabla resultante: `Nombre`, `Id`, `OperatingSystem` y `LastSeen`, una fila por dispositivo.

### Cómo los objetos se convierten en tablas

| Emitido                                               | Se renderiza como                                                                                               |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Un objeto                                             | Una fila: sus propiedades se convierten en las columnas.                                                        |
| Objetos consecutivos con las mismas propiedades       | Una tabla.                                                                                                      |
| Un objeto con un conjunto de propiedades diferente    | Se inicia una tabla nueva.                                                                                      |
| Un único valor simple (cadena, número)                | Una línea de texto en la consola, no una tabla.                                                                 |
| Una línea que comienza con `##` seguido de un espacio | Un encabezado en la vista de consola.                                                                           |
| Un objeto o matriz anidados                           | JSON en la celda, expandible en la cuadrícula; consulte [Objetos y listas anidados](#nested-objects-and-lists). |

### Asignar nombre a una tabla

De forma predeterminada, las tablas se etiquetan como `Tabla 1`, `Tabla 2` y así sucesivamente. Para dar a una tabla un nombre significativo, el runbook emite un objeto marcador inmediatamente antes de los datos. El marcador es un objeto de una sola propiedad cuya única propiedad es `RjTableTitle`:

```powershell
[PSCustomObject]@{ RjTableTitle = 'Dispositivos no conformes' }
Write-Output $nonCompliantDevices
```

La siguiente tabla se titula entonces **Dispositivos no conformes** — en el encabezado, en la barra lateral y en el nombre del archivo de exportación.

* El propio marcador se **consume**. No aparece ni como fila ni como línea de consola.
* El nombre de la propiedad no distingue entre **mayúsculas y minúsculas** — `RjTableTitle`, `rjtabletitle` y cualquier otra combinación de mayúsculas y minúsculas funciona.
* Una **vacío** se ignora, por lo que un marcador vacío no puede borrar un nombre existente.
* El nombre se aplica a la **siguiente** tabla emitida, incluso cuando aparecen líneas de estado entre medias.

Al repetir el patrón se nombran varias tablas en una ejecución:

```powershell
[PSCustomObject]@{ RjTableTitle = 'Dispositivos conformes' }
Write-Output $compliant

[PSCustomObject]@{ RjTableTitle = 'Dispositivos no conformes' }
Write-Output $nonCompliant
```

{% hint style="warning" %}
**Mantenga los títulos de tabla en un máximo de 31 caracteres.** **Exportar a Excel** usa el título de la tabla como nombre de hoja de cálculo, y Excel solo acepta nombres de 1 a 31 caracteres que no contengan ninguno de `\ / ? * [ ] :` y que no comiencen ni terminen con un apóstrofo. Un título más largo como `Usuarios deshabilitados con un buzón compartido` (36 caracteres) hace que la exportación falle con *"Se produjo un error al cargar los datos: sheetName 'Usuarios deshabilitados con un buzón compartido' no es válido: el recuento de caracteres DEBE ser mayor o igual que 1 y menor o igual que 31"*.

El límite incluye valores insertados en tiempo de ejecución, como un nombre de grupo o una fecha. Elija títulos cortos y significativos y, cuando el runbook también escriba un archivo de Excel con [Export-RjRbXlsx](https://docs.realmjoin.com/es/dev-reference/report-functions/export-rjrbxlsx.md#worksheet-names), use el mismo nombre para la tabla y la hoja de cálculo correspondiente.
{% endhint %}

## Comportamiento y limitaciones

### Trabajos archivados

Datos de salida solo está disponible para ejecuciones activas. Un trabajo archivado muestra *"No se pueden recuperar datos estructurados de una ejecución archivada."* — esos resultados deben leerse desde la pestaña Consola. Consulte [Runbook Logs](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-logs.md) para conocer la diferencia entre los registros de trabajos recientes y archivados.

### Runbooks sin salida estructurada

*"No hay datos de salida estructurados de este runbook."* significa que no se emitió nada con forma de tabla. Si un icono de información acompaña al mensaje, el runbook envió registros de formato de PowerShell en lugar de datos; consulte [Emita objetos, no texto formateado](#emit-objects-not-formatted-text).

### Valores únicos

Un runbook que emite un único valor simple, una cadena de estado o un recuento, conserva ese valor como una línea de texto en la pestaña Consola. Solo los objetos se convierten en tablas, por lo que los mensajes de progreso y estado no se convierten cada uno en una tabla de una fila.

## Véase también

* [Detalles del trabajo de runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-logs/runbook-job-details.md) — la página de trabajo que aloja las pestañas Consola y Datos de salida.
* [Export-RjRbXlsx](https://docs.realmjoin.com/es/dev-reference/report-functions/export-rjrbxlsx.md) — escriba los mismos objetos en un libro de Excel con estilo para entregarlo fuera del portal.
* [Send-RjRbReportEmail](https://docs.realmjoin.com/es/dev-reference/report-functions/send-rjrbreportemail.md) — entregue los resultados de informes a los administradores por correo electrónico.
* [Interacción con runbooks](https://docs.realmjoin.com/es/dev-reference/interacting-with-runbooks.md) — lea la salida del trabajo mediante programación a través de la API de RealmJoin.


---

# 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/dev-reference/runbook-output-data.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.
