venue.set

Kommando

venue.set

Bereich

Anzeige (venue)

Profil

freigestellt

Antwort

ok, mit dem errechneten nächsten Öffnungstag

Alles, was die Anzeige über die Bücherei wissen muss – und was nicht an eine einzelne Person gebunden ist. Die Angaben gelten, bis sie geändert werden: Ein Steuerprogramm sendet sie einmal beim Start und danach nur, wenn sich etwas ändert.

Damit weiß die Anzeige, was sie zeigen soll, wenn niemand davorsteht – und sie kann Sätze bilden, die ihr sonst niemand liefern müsste: „Heute noch bis 18 Uhr geöffnet", „Nächste Öffnung Dienstag, 18. August".

Auftrag#

{"v":1,"cmd":"venue.set",
 "name":"Bücherei St. Marien",
 "hours":[{"day":2,"from":"15:00","to":"18:00"},
          {"day":7,"from":"10:00","to":"12:00"}],
 "closures":[{"from":"2026-12-24","to":"2027-01-06","reason":"Weihnachtspause"}],
 "extras":[{"date":"2026-09-19","from":"10:00","to":"16:00","reason":"Pfarrfest"}],
 "events":[{"from":"2026-10-31T18:00:00+01:00","title":"Lesenacht",
            "note":"Eintritt frei, keine Anmeldung nötig."}]}

hours – die Öffnungszeiten#

Ein Wochentag darf mehrfach vorkommen – für die Mittagspause etwa 10:00–12:30 und 15:00–18:00.

closures und extras – die Ausnahmen#

closures sticht hours, extras sticht closures. Damit lässt sich der übliche Fall abbilden, dass über die Ferien geschlossen ist, an einem einzelnen Tag darin aber doch geöffnet wird.

events – Veranstaltungen#

Die Anzeige wählt aus, wie viele davon sie zeigt und ab wann. Vergangene Veranstaltungen blendet sie selbst aus – das Steuerprogramm muss die Liste deshalb nicht täglich nachführen.

Antwort#

{"v":1,"ok":true,"result":{"next_open":"2026-08-18"}}

next_open ist der Tag, den die Anzeige aus hours, closures und extras errechnet hat. Das ist die einfachste Probe, ob die hinterlegten Zeiten wirklich das ergeben, was die Bücherei meint.

Vollständig, nicht ergänzend#

Jeder Auftrag ersetzt die bisherigen Büchereidaten vollständig. Eine leere Liste löscht den jeweiligen Teil, ein fehlendes Feld lässt ihn unverändert.

Verhältnis zur Sitzung#

Büchereidaten und Sitzungsdaten unterscheiden sich in ihrer Lebensdauer:

Kennt die Anzeige die Büchereidaten, braucht session.close weder dates.next_open noch event: Sie weiß beides bereits. Ein Steuerprogramm, das venue.set nicht unterstützt oder auf eine Anzeige ohne venue trifft, sendet die Angaben weiterhin dort mit.