Zeitpläne: CLI-Befehle

Zeigen Sie den Playlist-Zeitplan eines Bildschirms und die aktuell ausgewählte Playlist an.

screen schedule show <id>

screenrig screen schedule show scr_CAFE

data enthält entries (leer, wenn der Bildschirm keinen Zeitplan hat), updated_at und effective_playlist. Die JSON-Ausgabe kann direkt an screen schedule set --file zurückgegeben werden.

Den Playlist-Zeitplan auf einem Bildschirm oder einer Flotte ersetzen.

screen schedule set (<id>... | --tag TAG | --folder ID) --file FILE [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule set scr_CAFE --file dayparts.json
screenrig screen schedule set --tag Cafe --file dayparts.json
screenrig screen schedule set --folder sfd_01EXAMPLEFOLDER000000000 --file dayparts.json

Jede Playlist, die ein Zeitplan benennt, wird als Zuweisung validiert, und der Bildschirm benötigt eine zugewiesene Standard-Playlist. Die Zeiten der Einträge werden in der eigenen Zeitzone des Bildschirms gelesen. Gilt kein Eintrag, wird die zugewiesene Playlist abgespielt. Wenn eine geplante Playlist später nicht angezeigt werden kann, werden ihre Einträge übersprungen und screen.playlist_unavailable wird protokolliert.

Den Playlist-Zeitplan von einem Bildschirm oder einer Flotte entfernen.

screen schedule clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule clear --tag Cafe

Danach läuft die Übernahme, sonst eine Kampagne, die gilt, sonst die zugewiesene Playlist. Ein Bildschirm ohne Zeitplan antwortet unverändert.

Zeigen, was das Ersetzen des Playlist-Zeitplans eines Bildschirms ändern würde, ohne es auszuführen.

screen schedule preview <id> --file FILE [--calendar-from INSTANT] [--calendar-to INSTANT]

screenrig screen schedule preview scr_LOBBY --file dayparts.json
screenrig screen schedule preview scr_LOBBY --file dayparts.json --calendar-from 2026-12-01T00:00:00Z --calendar-to 2027-01-01T00:00:00Z

Es wird nichts geschrieben. Die Einträge werden so geprüft, wie screen schedule set sie prüft, daher verweigert eine Vorschau, was das Setzen verweigert. data.gained und data.lost, jeweils {count, screen_ids}, sagen, ob der Bildschirm Ebenen seines Zeitplans gewinnen oder verlieren würde; ein Eintrag mit "paused": true liegt auf keinem Bildschirm, daher gewinnt man ihn mit seiner Veröffentlichung. data.calendar.before und data.calendar.after sind der Kalender des Bildschirms, wie er ist und wie er von --calendar-from bis --calendar-to wäre.

Die Revisionen des Playlist-Zeitplans eines Bildschirms auflisten, die neueste zuerst.

screen schedule revisions <id> [--after CURSOR]

screenrig screen schedule revisions scr_LOBBY
screenrig screen schedule revisions scr_LOBBY --after CURSOR

data.items enthält höchstens 50 Revisionen, jeweils mit revision (die Revision des Bildschirms beim Schreiben, daher haben die Nummern Lücken, wo sich der Bildschirm anders geändert hat), created_at, change, current, author, wenn bekannt, und entries, dem gesamten Zeitplan nach diesem Schreibvorgang (none bedeutet, dass der Bildschirm keinen Zeitplan hatte). change ist edited (ein Setzen, ein Löschen oder ein Zeitplanimport), restored (eine Kopie der früheren Revision, die restored_from nennt) oder baseline (der Zeitplan, den der Bildschirm zu Beginn seines Verlaufs hatte). Solange data.next_cursor ein String ist, gibt es ältere Revisionen: Führen Sie den Befehl erneut aus, mit --after darauf gesetzt. Revisionen verschwinden mit dem Löschen des Bildschirms. Lesezugriff genügt.

Den Zeitplan einer früheren Revision auf einem Bildschirm wiederherstellen, indem er nach vorn kopiert wird.

screen schedule restore <id> --revision N [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule restore scr_LOBBY --revision 4
screenrig screen schedule restore scr_LOBBY --revision 4 --expect-rev 9

Die Einträge der Revision N werden zum Zeitplan des Bildschirms, derselbe Schreibvorgang wie screen schedule set mit diesen Einträgen (oder screen schedule clear, wenn diese Revision keine hatte), so geprüft, wie sie jetzt geprüft werden: Eine inzwischen gelöschte Playlist verweigert ihn. Unter Propose-Zugriff oder in einem Projekt, das Überprüfung für Agentenänderungen verlangt, wartet die Wiederherstellung wie das Setzen auf eine Person, und auf dem Bildschirm ändert sich nichts, bis sie sie genehmigt. Frühere Revisionen bleiben, wie sie waren.

Zeigen Sie eine Playlist auf einem Bildschirm oder einer Flotte vor Kampagnen, dem Zeitplan und der Zuweisung an.

screen takeover [set] (<id>... | --tag TAG | --folder ID) --playlist-id ID [--until TIME | --for DURATION] [--reason TEXT] [--expect-rev REVISION] [--note TEXT]

screenrig screen takeover scr_LOBBY --playlist-id pl_DRILL --for 30m --reason "Fire drill"
screenrig screen takeover --tag Lobby --playlist-id pl_LAUNCH --for 2h
screenrig screen takeover --folder sfd_01EXAMPLEFOLDER000000000 --playlist-id pl_LAUNCH --for 2h
screenrig screen takeover scr_A scr_B --playlist-id pl_NOTICE --until none

screen takeover ID ist die Kurzform von screen takeover set ID. Eine neue Übernahme ersetzt die vorherige, außer wenn dieselbe Playlist erneut gesendet wird, während ihre Übernahme gilt, und zwar ohne --reason oder mit demselben: Dann bleibt diese Übernahme erhalten und nur ihr Ende wird verschoben. Wenn sie endet, kehrt der Bildschirm eigenständig zu einer geltenden Kampagne, seinem Zeitplan oder seiner zugewiesenen Playlist zurück. Eine Übernahme, deren Playlist nicht angezeigt werden kann, endet. Ein erneuter --for-Lauf nach einem unklaren Fehler berechnet ein neues Ende und wird als neue Anfrage gesendet.

Übernahme auf einem Bildschirm oder einer Flotte beenden.

screen takeover clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION] [--note TEXT]

screenrig screen takeover clear --tag Lobby

Danach läuft eine Kampagne, die gilt, sonst der Zeitplan, sonst die zugewiesene Playlist. Ein Bildschirm ohne Übernahme antwortet unverändert.

Prüft eine Tabelle mit Zeitplanzeilen und zeigt eine Vorschau, was sie bewirkt; --commit wendet sie an.

schedule import <file> [--name NAME] [--timezone ZONE] [--code-field FIELD] [--commit]

screenrig schedule import schedule.csv
screenrig schedule import schedule.xlsx --name "Spring promos" --timezone America/Los_Angeles
screenrig schedule import schedule.csv --name "Spring promos" --commit
screenrig schedule import rows.json --code-field room_id
screenrig schedule import - --name "Spring promos" --commit

Ohne --commit wird nichts geschrieben. data ist die Vorschau: valid, fingerprint, summary (rows, rows_with_errors, levels, creates, updates, unchanged, removes, screens, playlists), rows, levels, removals und calendar, ignored_columns für eine Spalte, die nichts liest, und next, der Befehl, der committet. Zeilen, die in Inhalt, Zeiten, Priorität und Name übereinstimmen, werden zu einer Ebene: Ein Bildschirm ist ein Eintrag im eigenen Zeitplan dieses Bildschirms, und mehrere Bildschirme, ein Ordner oder ein Tag sind eine gemeinsame Ebene, eine Kampagne, die die eigenen Ebenen eines Bildschirms übertrifft.

Eine gültige Tabelle endet mit 0. Zeilen mit Fehlern enden mit 8 und data.valid false: data.rows[].errors nennt Spalte und Code jeder Zelle, nichts wird geschrieben, --commit committet nichts, und derselbe Befehl läuft erneut, sobald die Zeilen korrigiert sind.

Mit --commit sendet der Lauf den fingerprint der Vorschau und einen aus Name und Fingerprint abgeleiteten Idempotenzschlüssel, sodass ein erneuter Lauf eines unterbrochenen identischen Befehls sicher ist. data ist dann die Vorschau plus data.applied (creates, updates, unchanged, removes, screens, playlists) und data.committed true, und die Ein-Datei-Playlists, die die Dateien der Tabelle brauchen, werden zuerst angelegt. Alle Zeilen werden angewendet oder keine. Ein Projekt, das sich seit der Vorschau geändert hat, oder Zeilen, die anders gelesen werden, ergeben schedule_import_stale (Exit 5): Nichts wurde geschrieben, und derselbe Befehl zeigt erneut die Vorschau. Ein Commit, der einen Bildschirm in einem geschützten Ordner erreicht, wird vollständig mit protected_target (Exit 5) abgelehnt, und einer, der eine reservierte Kampagne aktualisiert oder löscht, antwortet mit reserved_item (Exit 3), sofern ihn nicht eine Person committet, die genehmigen darf. Die Vorschau braucht Lesezugriff, und --commit braucht Manage-Zugriff. Eine Datei, die die CLI nicht lesen kann, ist ein usage_error (Exit 2).

Speichert eine Tabelle mit den Spalten, die ein Zeitplan-Import liest, und drei Beispielzeilen.

schedule template [--format csv|xlsx] [--output FILE] [--overwrite]

screenrig schedule template
screenrig schedule template --output schedule.csv
screenrig schedule template --format xlsx --output schedule.xlsx --overwrite

Die Beispielzeilen sind ein Bildschirmcode, ein Bildschirmordner und ein Tag. Mit --output enthält data format, output, bytes und next, den Befehl schedule import für die gespeicherte Datei. Eine vorhandene, nicht leere --output-Datei schlägt mit usage_error fehl (Exit 2) und bleibt unverändert, sofern nicht --overwrite übergeben wird. Füllen Sie pro Bildschirm und Datei eine Zeile aus und führen Sie dann schedule import FILE aus, um die Vorschau zu sehen.