3V ROOMS docs – Jobmanager

3VROOMS: Jobliste

Mon, 01 Jan 0001 00:00:00 +0000

In der Jobliste werden Jobs angezeigt, die aus Lektionen mit gemeinsamer JobId zusammengefasst werden. Der Einstieg erfolgt über Listen > Jobmanager.

Suchmaske

Die Jobliste wird über das Sidepanel gefiltert. Das wichtigste Suchkriterium ist das Bildungszentrum bzw. der Standort, auf welchem der Jobmanager verwendet werden darf.

Folgende Felder sind in der Praxis relevant:

Feld	Funktion
Bildungszentrum	Definiert den Standort, für den Jobs angezeigt werden sollen. Ohne passenden Standort erscheinen keine Jobs.
Klasse / Veranstaltung	Zusätzlicher Filter für die Jobliste, verfügbar mit erweiterter Jobmanager-Funktionalität.
Zeitraum von / bis	Grenzt die angezeigten Jobs zeitlich ein.

Sidepanel und Einstieg in die Jobliste

Tabs und Status

Die Jobliste ist in mehrere Tabs unterteilt. Die Tabs bilden den aktuellen Verarbeitungsstand des Jobs ab:

Tab	Bedeutung
Offene Jobs	Jobs mit neuen, geänderten oder zu löschenden Lektionen, die noch bearbeitet werden müssen
Geplante Jobs	Bereits verarbeitete Jobs mit geplantem Workflow
Definitive Jobs	Bereits verarbeitete Jobs mit definitivem Workflow
Fehlerhafte Jobs	Jobs, die fachlich oder technisch nicht korrekt verarbeitet werden konnten
Automatische Verarbeitung fehlgeschlagen	Jobs, deren automatische Verarbeitung abgebrochen oder nicht abgeschlossen wurde

Spalten und Aktionen

Die Jobliste zeigt je nach Konfiguration zusätzliche Spalten. Die wichtigsten Standardspalten sind:

Spalte	Bedeutung
Job	Hauptaktion für den Job; je nach Status werden `Prüfen`, `Edit`, `Geplant`, `Definitiv`, `Reset` oder `Delete/Annullieren` angeboten
Start / Ende	Frühester Beginn und spätestes Ende der Lektionen im Job
Reservationsanfrage	Link zur Reservationsanfrage, sofern der Job aus einem Formular entstanden ist
Job-ID	Fachliche Kennung des Jobs
Organisator / Verantwortlicher	Personen, auf welche die Jobverarbeitung fachlich referenziert
Anzahl Personen	Personenanzahl aus den Lektionen
Kunde	Kunde bzw. Organisation aus dem Lektionenkontext
Bildungszentrum	Standortname aus der Lektion

Wichtige Aktionen:

Prüfen öffnet die Ressourcenwahl
Edit öffnet direkt die Detailprüfung eines bereits verarbeiteten Jobs
Geplant und Definitiv wechseln den Workflow bestehender Jobs
Reset setzt verarbeitete Jobs zurück, sofern dies für das Quellsystem erlaubt ist
Delete/Annullieren entfernt Jobs oder hebt bereits verarbeitete Buchungen auf

Ohne das globale Recht Darf erweiterte Jobmanager-Funktionalität verwenden erscheint Delete/Annullieren nur in den eingeschränkten Fällen, in denen ein Job vollständig als Löschfall verarbeitet werden kann.

Beispiel einer Jobliste mit offenen Jobs

Woher kommen Jobs?

Jobs erscheinen in der Liste nicht manuell, sondern weil passende Einträge in Lektion vorhanden sind. Typische Quellen sind:

Schulverwaltungs- oder Fremdsysteme
Reservierungsanfrageformulare mit Jobmanager-Bezug
REST-API-Importe über den JobManager-Batch-Flow

Für die technische Sicht auf API-Importe siehe JobManager REST API – Usage Guide.

3VROOMS: Ressourcenwahl

Mon, 01 Jan 0001 00:00:00 +0000

Nach dem Klick auf Prüfen zeigt der Jobmanager die Seite Verfügbarkeit der Ressourcen. Hier wird geprüft, welche Räume für die Lektionen des Jobs verfügbar sind.

Was wird angezeigt?

Die Liste zeigt pro Raum einen Prüfstatus und erlaubt zwei Wege:

Verarbeiten: den Job direkt auf einen Raum buchen, wenn der Job vollständig passt
Details: in die Detailprüfung wechseln, wenn einzelne Lektionen separat überprüft oder angepasst werden müssen

Standardmässig sind folgende Spalten relevant:

Spalte	Bedeutung
Job	Direkte Verarbeitung auf den gewählten Raum
Status	Ampel-Status und Prozentwert für die Verfügbarkeit
Ressource	Raumbezeichnung inklusive Markierungen für Wunsch- oder Sonderzimmer
Details	Öffnet die Detailprüfung für den Job
Job-ID	Kennung des aktuell geprüften Jobs
Standort	Standort des vorgeschlagenen Raums

Ressourcenwahl mit Verfügbarkeitsprüfung

Verfügbarkeitslogik

Die Prozent- und Farbprüfung basiert auf dem Job als Ganzem:

Grün / 100 %: alle Lektionen des Jobs können auf diesem Raum verarbeitet werden
Gelb: der konfigurierte Schwellwert wird erreicht, aber nicht alle Lektionen passen
Rot: der Raum unterschreitet den Schwellwert oder passt für den Job nicht ausreichend

Der Schwellenwert wird über den globalen Parameter Schwellwert Jobmanager gesteuert.

Wichtig für die fachliche Bedeutung:

Der Wert wird als Dezimalzahl gespeichert, zum Beispiel 0.7 für 70 %
Verglichen wird, für wie viele neue oder geänderte Lektionen eines Jobs der Raum gültig ist
Bei 0.7 wird ein Raum also gelb, sobald mindestens 70 % der Lektionen auf diesem Raum möglich sind, aber noch nicht alle
Unterhalb dieses Werts bleibt der Raum rot
Der Schwellwert steuert nur die Ampelbewertung zwischen gelb und rot
Die Aktion Verarbeiten bleibt weiterhin nur dann direkt möglich, wenn der Raum 100 % erreicht

Präferenzräume und weitere Räume

Standardmässig prüft der Jobmanager vor allem Räume, die fachlich bevorzugt sind. Je nach Datenlage werden folgende Raumarten berücksichtigt:

Präferenzräume der Firma oder Organisation
Wunschräume aus der Lektion
Sonderzimmer, wenn eine Lektion dies verlangt

Zusätzliche Optionen auf dieser Seite:

Funktion	Wirkung
Gewünschte Ressourcen bevorzugen	Bevorzugt Wunsch- oder Spezialräume bei der Auswahl und Verarbeitung
Ohne Präferenzen prüfen	Erweitert die Prüfung auf weitere Räume ausserhalb der Präferenzlogik
Zusätzliche Ressourcen	Fügt einen manuell ausgewählten Raum zusätzlich zur Prüfung hinzu
Standort	Schränkt die angezeigten Alternativräume weiter ein

Ressourcenwahl mit erweiterten Alternativen

Wann direkt verarbeiten, wann in die Details?

Direkte Verarbeitung ist sinnvoll, wenn:

ein Raum 100 % Verfügbarkeit erreicht
der Job ohne weitere manuelle Entscheidung verarbeitet werden soll

Details sind sinnvoll, wenn:

einzelne Lektionen auf andere Räume verteilt werden müssen
Überschneidungen innerhalb des Jobs bereinigt werden müssen
bestehende Jobs erneut geprüft und angepasst werden

Relevante Parameter

3VROOMS: Detailprüfung und Verarbeitung

Mon, 01 Jan 0001 00:00:00 +0000

Die Detailprüfung ist die eigentliche Arbeitsfläche des Jobmanagers. Hier werden alle Lektionen des Jobs einzeln dargestellt, inklusive Raumbezug, Änderungsstatus und Verarbeitungsfähigkeit.

Detailgrid

Die wichtigsten Spalten im aktuellen Detailgrid sind:

Spalte	Bedeutung
Status	Zeigt an, ob die aktuelle Raumwahl für diese Lektion verarbeitbar ist
Vorlaufbeginn / Beginn / Ende / Nachlaufende	Zeitfenster der Lektion inklusive Vor- und Nachlauf
Ausgewählter Raum	Raum, der aktuell für die Verarbeitung dieser Zeile ausgewählt ist
Änderung	Kennzeichnet `Neu` oder `Geändert` auf Basis der effektiven Lektion in der Datenbank
Gewünschter Raum	Fachlich gewünschter Raum aus der Lektion
Gebuchter Raum	Bereits verarbeiteter Raum aus `Lektion.RessourceId`, sofern die Lektion schon gebucht wurde
Standort	Standort des ausgewählten Raums

Wichtig:

Ausgewählter Raum ist die aktuelle Verarbeitungswahl
Gewünschter Raum ist die fachliche Vorgabe aus der Lektion
Gebuchter Raum zeigt den bereits persistierten Raum, wenn die Lektion früher schon verarbeitet wurde
Änderung wird aus dem effektiven Lektionenzustand abgeleitet, nicht nur aus der temporären Reservierung

Detailprüfung der einzelnen Lektionen

Filter in der Detailprüfung

Am unteren Rand der Seite stehen Filter zur Verfügung:

Filter	Wirkung
Nur neue/geänderte Buchungen	Zeigt nur Zeilen mit fachlicher Änderung
Nur fehlerhafte Buchungen	Zeigt nur Zeilen mit problematischer Verarbeitbarkeit
Vergangene Buchungen	Blendet vergangene Termine ein oder aus

Diese Filter helfen vor allem bei grösseren Jobs mit vielen bereits verarbeiteten oder unveränderten Lektionen.

Einzelne Lektionen anpassen

Über Ändern können selektierte Zeilen gemeinsam bearbeitet werden. Typische Anpassungen sind:

Raum wechseln
Status anpassen
Beginn, Dauer oder Wochentag verändern

Dialog zum Ändern des ausgewählten Raums

Zusätzliche Aktionen mit erweiterter Jobmanager-Funktionalität:

Annullieren von selektierten, bereits verarbeiteten Jobmanager-Zeilen
Löschen von selektierten, noch nicht verarbeiteten Jobmanager-Zeilen
Ergänzen neuer Lektionen zum aktuellen Job

Ohne das globale Recht Darf erweiterte Jobmanager-Funktionalität verwenden stehen diese Zusatzaktionen nicht zur Verfügung. Ebenfalls bleiben im Sammelbearbeitungsdialog die Felder Beginn, Dauer und Wochentag ausgeblendet.

Was passiert beim Speichern?

Beim Speichern wird der gesamte Job verarbeitet:

neue Lektionen werden als Buchungen erzeugt
geänderte Lektionen werden aktualisiert
zu löschende Lektionen werden annulliert oder entfernt
die resultierenden Buchungen werden unter einem Anlass zusammengeführt

Wenn die Verarbeitung fehlschlägt, bleibt der Job in der Detailprüfung sichtbar, damit die offenen Konflikte weiter bereinigt werden können.

Bei erfolgreicher Verarbeitung:

verschwindet der Job aus den offenen Jobs
der Job erscheint je nach Workflow unter Geplante oder Definitive Jobs

Typische Entscheidungssituationen

Die Detailprüfung wird vor allem in diesen Situationen benötigt:

zwei oder mehr Lektionen überschneiden sich auf demselben Raum
ein Wunschraum ist nicht vollständig verfügbar
ein bestehender Job wurde vom Quellsystem geändert
einzelne Termine sollen bewusst auf andere Räume verteilt werden