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

# Runbook-Ausgabedaten

Stellen Sie Runbook-Ergebnisse im RealmJoin-Portal als sortierbare, filterbare Tabellen dar und schreiben Sie Runbooks, die strukturierte Objekte ausgeben.

## Übersicht

**Ausgabedaten** ist das strukturierte Gegenstück zum **Konsole** Tab auf einer Runbook-Jobseite. Die Konsole behält den rohen, zeilenweisen Text-Feed eines Laufs bei; Output Data stellt die Objekte, die derselbe Lauf ausgegeben hat, als Tabellen dar. Lange Werte wie GUIDs werden vollständig angezeigt, statt `…` vom PowerShell-Konsolenformatierer gekürzt zu werden, und breite Ergebnismengen bleiben lesbar, statt umgebrochen zu werden.

Wesentliche Merkmale:

* **Keine Konfiguration, keine zusätzlichen Berechtigungen** — der Tab ist für jedes Runbook verfügbar, das Objekte ausgibt. Nichts muss aktiviert werden, und wer ein Runbook starten darf, bleibt unverändert.
* **Objekte statt vorformatiertem Text** — die Tabellen werden aus dem erstellt, was das Runbook in den Ausgabestrom schreibt. Ein Runbook, das seine Ergebnisse vorformatiert mit `Format-Table` erzeugt überhaupt keine Output Data.
* **Interaktive Tabellen** — jede Tabelle kann unabhängig von den anderen sortiert, gefiltert, seitenweise angezeigt und nach Excel oder CSV exportiert werden.
* **Verschachtelte Daten bleiben untersuchbar** — Objekte und Arrays innerhalb einer Zelle können aufgeklappt werden, statt zu einem unleserlichen String zusammengeflacht zu werden.
* **Die Console-Registerkarte bleibt unverändert** — die vollständige Textausgabe bleibt verfügbar und kopierbar, was ein Service- oder ITIL-Ticket normalerweise benötigt.

## Schnellstart

Das minimal funktionsfähige Runbook gibt ein Markerobjekt mit dem Tabellennamen aus, dann die Daten:

```powershell
[PSCustomObject]@{ RjTableTitle = 'Non-compliant devices' }
Write-Output $nonCompliantDevices
```

Dies erzeugt eine Tabelle mit dem Titel **Nicht-konforme Geräte** in der Registerkarte Output Data — eine Zeile pro Gerät, eine Spalte pro Eigenschaft — plus eine kompakte Zusammenfassungszeile in der Console-Registerkarte, die darauf verweist.

## Output Data im Portal lesen

Öffnen Sie einen Job von [Runbook-Protokolle](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-logs.md) und wechseln Sie zur **Ausgabedaten** Registerkarte [Runbook-Job-Details](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-logs/runbook-job-details.md) für die anderen Registerkarten dieser Seite.

### Tabellen und Navigation

Jede Menge von Objekten, die ein Runbook ausgibt, wird zu einer Tabelle. Eine Tabelle enthält:

* **Einen Titel** — entweder den Namen, den das Runbook gesetzt hat (siehe [Eine Tabelle benennen](#naming-a-table)) oder den Fallback `Tabelle 1`, `Tabelle 2` und so weiter.
* **Einen Eintrag in der Seitenleiste** — jede Tabelle wird links aufgelistet; ein Klick auf einen Titel springt dorthin.
* **Einen Zeilenzähler** — `12 / 340 Zeilen` zeigt an, wie viele Zeilen nach dem aktuellen Filter von der Gesamtzahl der Tabelle übrig sind.

### Filter

Die **Filtern…** Das Feld oberhalb einer Tabelle behält nur die Zeilen, die den eingegebenen Text enthalten. Der Filter ist ein groß-/kleinschreibungsunabhängiger Teilstring-Abgleich über alle Spalten dieser Tabelle. Jede Tabelle filtert unabhängig.

### Sortierung

Ein Klick auf die Spaltenüberschrift sortiert nach dieser Spalte; ein weiterer Klick kehrt die Richtung um. Ein Pfeil (`▲` / `▼`) markiert die aktive Spalte. Die Sortierung ist typabhängig:

| Spalteninhalt | Sortierreihenfolge                                             |
| ------------- | -------------------------------------------------------------- |
| Zahlen        | Numerisch — `2` bevor `10`.                                    |
| Datumsangaben | Chronologisch.                                                 |
| Alles andere  | Alphabetisch, ohne Berücksichtigung der Groß-/Kleinschreibung. |

Leere Zellen werden zuerst sortiert.

### Seitenweise Anzeige

Tabellen werden jeweils 50 Zeilen pro Seite angezeigt, mit einem Pager unter der Tabelle. Filter und Sortierung gelten immer für die gesamte Tabelle, nicht nur für die aktuell angezeigte Seite.

### Verschachtelte Objekte und Listen

Eine Zelle mit einem verschachtelten Objekt oder Array wird nicht in unleserlichen Text zerlegt:

* Die Zelle zeigt ein Caret (`▸`). Ein Klick darauf klappt dieses Objekt oder Array inline unterhalb der Zeile aus.
* Die Spaltenüberschrift trägt einen Ausklapppfeil. Ein Klick darauf klappt die gesamte Spalte in ihre eigene Tabelle aus: Der verschachtelte Wert jeder übergeordneten Zeile wird in Zeilen aufgelöst, und eine Referenzspalte verknüpft zurück zur Zeilennummer der übergeordneten Zeile. Die neue Tabelle wird unten auf der Seite und in der Seitenleiste angehängt und kann wie jede andere gefiltert, sortiert und exportiert werden.

### Export

Jede Tabelle hat ihre eigenen **Nach Excel exportieren** (`.xlsx`) und **Nach CSV exportieren** Schaltflächen. Exporte berücksichtigen den aktiven Filter — es werden nur passende Zeilen geschrieben — und verwenden den Tabellentitel als Dateiname. Der Excel-Export verwendet den Titel auch als Arbeitsblattnamen und schlägt bei Titeln mit mehr als 31 Zeichen fehl, siehe [Eine Tabelle benennen](#naming-a-table).

Der Export aus dem Portal deckt den Ad-hoc-Fall ab. Für Reportdateien, die ein Runbook selbst liefern soll — als E-Mail-Anhang oder als Downloadlink — erstellen Sie sie stattdessen im Runbook, mit [Export-RjRbXlsx](https://docs.realmjoin.com/de/dev-reference/report-functions/export-rjrbxlsx.md) und den Bereitstellungshilfen.

## Console-Registerkarte

Wenn ein Job Tabellen ausgegeben hat, zeigt die **Konsole** Registerkarte standardmäßig eine komprimierte Ansicht. Tabellen werden im PowerShell-Stil gezeichnet, aber gekürzt, damit Statuszeilen lesbar bleiben und ein Runbook, das Hunderte von Objekten ausgegeben hat, die Seite nicht überflutet. Anstelle jeder Tabelle zeigt die Konsole ein Zusammenfassungsfeld:

```plaintext
╭─ Tabelle ────────────────────────────────────────────╮
│ <Tabellenname> · <Zeilenanzahl> Zeilen                    │
╰───────────────────────────── → "Output Data"-Registerkarte ──╯
```

Aufeinanderfolgend ausgegebene Tabellen teilen sich ein Feld:

```plaintext
╭─ Tabelle ────────────────────────────────────────────╮
│ Geräte                 · 3123 Zeilen                │
│ Anwendungsanmeldeinformationen · 42 Zeilen                  │
│ Großes Exportbeispiel     · 987654 Zeilen              │
╰───────────────────────────── → "Output Data"-Registerkarte ──╯
```

`→ "Output Data"-Registerkarte` ist ein Link und wechselt zur entsprechenden Tabelle.

Zwei Schaltflächen steuern die Ansicht:

* **Gesamte Ausgabe anzeigen** — zur vollständigen, ungekürzten Textausgabe wechseln.
* **Komprimierte Tabellen anzeigen** — zurückwechseln.

**In die Zwischenablage kopieren** kopiert immer die vollständige Roh-Ausgabe, unabhängig davon, welche Ansicht angezeigt wird.

## Output Data aus einem Runbook ausgeben

Die Registerkarte basiert auf den Objekten, die ein Runbook ausgibt. Saubere Tabellen erfordern daher, dass das Runbook Objekte schreibt, statt sie vorab in Text zu formatieren.

### Objekte ausgeben, nicht formatierten Text

> **Leiten Sie die Ausgabe niemals durch `Format-Table` oder `Format-List`.** Diese Cmdlets geben Datensätze der Formatierungs-Engine aus, keine Daten. Das Portal erkennt sie und blendet sie aus und zeigt einen Hinweis an, dass die Ausgabe falsch formatiert war. Dasselbe gilt überall dort, wo PowerShell ein Ergebnis automatisch formatiert, weil es an den Host statt an den Ausgabestrom geschrieben wurde.

`Format-*` Cmdlets steuern nur die *Anzeige*. Wofür sie verwendet wurden, hat ein datenmäßiges Gegenstück, das Output Data darstellen kann — insbesondere das Auswählen von Spalten ist genau das, was `Select-Object` tut:

| Statt                                | Verwende                             |
| ------------------------------------ | ------------------------------------ |
| `$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` erzeugt dieselbe Spaltenauswahl, die `Format-Table Name, Id` angezeigt hätte — aber es gibt Objekte aus, sodass die Spalten in der Registerkarte Output Data erhalten bleiben, statt als Formatierungsdatensätze verworfen zu werden:

```powershell
# Gut — echte Objekte, Spalten mit Select-Object ausgewählt
$devices | Select-Object Name, Id, OperatingSystem, LastSeen

# Schlecht — Formatierungsdatensätze, in Output Data ausgeblendet
$devices | Format-Table Name, Id, OperatingSystem, LastSeen
```

Die ausgewählten Eigenschaften sind genau die Spalten der resultierenden Tabelle: `Name`, `Id`, `OperatingSystem` und `LastSeen`, eine Zeile pro Gerät.

### Wie Objekte zu Tabellen werden

| Ausgegeben                                                     | Gerendert als                                                                                                    |
| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Ein Objekt                                                     | Eine Zeile — seine Eigenschaften werden zu den Spalten.                                                          |
| Aufeinanderfolgende Objekte mit denselben Eigenschaften        | Eine Tabelle.                                                                                                    |
| Ein Objekt mit einer anderen Menge von Eigenschaften           | Eine neue Tabelle beginnt.                                                                                       |
| Ein einzelner einfacher Wert (String, Zahl)                    | Eine Textzeile in der Konsole, keine Tabelle.                                                                    |
| Eine Zeile, die mit `##` gefolgt von einem Leerzeichen beginnt | Eine Überschrift in der Konsolenansicht.                                                                         |
| Ein verschachteltes Objekt oder Array                          | JSON in der Zelle, im Raster ausklappbar — siehe [Verschachtelte Objekte und Listen](#nested-objects-and-lists). |

### Eine Tabelle benennen

Standardmäßig werden Tabellen mit `Tabelle 1`, `Tabelle 2` und so weiter beschriftet. Um einer Tabelle einen aussagekräftigen Namen zu geben, gibt das Runbook unmittelbar vor den Daten ein Markerobjekt aus. Der Marker ist ein Objekt mit einer Eigenschaft, dessen einzige Eigenschaft `RjTableTitle`:

```powershell
[PSCustomObject]@{ RjTableTitle = 'Non-compliant devices' }
Write-Output $nonCompliantDevices
```

ist. Die folgende Tabelle trägt dann den Titel **Nicht-konforme Geräte** — in der Überschrift, in der Seitenleiste und im Namen der Exportdatei.

* Der Marker selbst wird **verbraucht**. Er erscheint weder als Zeile noch als Konsolenzeile.
* Der Eigenschaftsname ist **nicht groß-/kleinschreibungsabhängig** — `RjTableTitle`, `rjtabletitle` und jede andere Schreibweise funktionieren.
* Eine **leerer** Titel wird ignoriert, sodass ein leeres Markerobjekt einen vorhandenen Namen nicht überschreiben kann.
* Der Name gilt für die **nächste** ausgegebene Tabelle, auch wenn dazwischen Statuszeilen erscheinen.

Wenn das Muster wiederholt wird, werden mehrere Tabellen in einem Lauf benannt:

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

[PSCustomObject]@{ RjTableTitle = 'Non-compliant devices' }
Write-Output $nonCompliant
```

{% hint style="warning" %}
**Halten Sie Tabellentitel auf höchstens 31 Zeichen.** **Nach Excel exportieren** verwendet den Tabellentitel als Arbeitsblattnamen, und Excel akzeptiert nur Namen mit 1 bis 31 Zeichen, die keines von `\ / ? * [ ] :` enthalten und nicht mit einem Apostroph beginnen oder enden. Ein längerer Titel wie `Deaktivierte Benutzer mit freigegebenem Postfach` (36 Zeichen) führt dazu, dass der Export fehlschlägt mit *"Beim Laden der Daten ist ein Fehler aufgetreten: sheetName 'Disabled users with a shared mailbox' ist ungültig - die Zeichenanzahl MUSS größer oder gleich 1 und kleiner oder gleich 31 sein"*.

Die Begrenzung umfasst zur Laufzeit eingefügte Werte, etwa einen Gruppennamen oder ein Datum. Wählen Sie kurze, aussagekräftige Titel, und wenn das Runbook auch eine Excel-Datei mit [Export-RjRbXlsx](https://docs.realmjoin.com/de/dev-reference/report-functions/export-rjrbxlsx.md#worksheet-names)schreibt, verwenden Sie denselben Namen für die Tabelle und das entsprechende Arbeitsblatt.
{% endhint %}

## Verhalten und Einschränkungen

### Archivierte Jobs

Output Data ist nur für laufende Ausführungen verfügbar. Ein archivierter Job zeigt *"Strukturierte Daten können aus einer archivierten Ausführung nicht abgerufen werden."* — diese Ergebnisse müssen aus der Console-Registerkarte gelesen werden. Siehe [Runbook-Protokolle](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-logs.md) für den Unterschied zwischen aktuellen und archivierten Jobprotokollen.

### Runbooks ohne strukturierten Output

*"Keine strukturierten Ausgabedaten aus diesem Runbook."* bedeutet, dass nichts in Tabellenform ausgegeben wurde. Wenn ein Informationssymbol die Meldung begleitet, hat das Runbook PowerShell-Formatierungsdatensätze statt Daten gesendet — siehe [Objekte ausgeben, nicht formatierten Text](#emit-objects-not-formatted-text).

### Einzelwerte

Ein Runbook, das einen einzelnen einfachen Wert ausgibt — einen Statusstring, einen Zähler — behält diesen Wert als Textzeile in der Console-Registerkarte. Nur Objekte werden zu Tabellen, daher werden Fortschritts- und Statusmeldungen nicht jeweils zu einer Ein-Zeilen-Tabelle.

## Siehe auch

* [Runbook-Job-Details](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-logs/runbook-job-details.md) — die Jobseite, die die Registerkarten Console und Output Data hostet.
* [Export-RjRbXlsx](https://docs.realmjoin.com/de/dev-reference/report-functions/export-rjrbxlsx.md) — dieselben Objekte in eine gestaltete Excel-Arbeitsmappe für die Bereitstellung außerhalb des Portals schreiben.
* [Send-RjRbReportEmail](https://docs.realmjoin.com/de/dev-reference/report-functions/send-rjrbreportemail.md) — Berichtsergebnisse per E-Mail an Administratoren liefern.
* [Mit Runbooks interagieren](https://docs.realmjoin.com/de/dev-reference/interacting-with-runbooks.md) — Jobausgaben programmgesteuert über die RealmJoin-API lesen.


---

# 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/de/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.
