For the complete documentation index, see llms.txt. This page is also available as Markdown.

Buchung

Die Booking-App ermöglicht es Benutzern, Ressourcen in BuildingPro Suites zu buchen. Sie bietet außerdem eine Schnittstelle für andere Apps, um Buchungen mit externen Diensten zu synchronisieren.

Installation

Installieren Sie die App im BuildingPro Suites Store.

Konfiguration [optional]

Nach der Installation können Sie die Konfiguration im generischen Frontend ändern: Es gibt eine Standardkonfiguration, die über GET /config. Sie können diese Konfiguration ändern und sie per POST an den /config Endpunkt senden. Hier ist ein Beispiel für eine Konfiguration:

{
    "dayStartHours": 8,
    "dayStartMinutes": 0,
    "middayStartHours": 12,
    "middayStartMinutes": 0,
    "middayEndHours": 13,
    "middayEndMinutes": 0,
    "dayEndHours": 17,
    "dayEndMinutes": 0,
    "noShowMins": 15,
    "adHocBookAfterMins": 15,
    "adHocBookForMins": 30,
    "presenceAttributeName": "presence"
}

Diese Konfiguration wird verwendet, um die Grenzen der Schnellbuchung festzulegen — zum Beispiel führt die Buchung einer Ressource für den Morgen zu einer Buchung von 8:00 bis 12:00 Uhr.

noShowMins legt die Zeit fest, nach der die Buchung automatisch storniert wird. Eine negative Zahl deaktiviert diese Funktion. (weitere Details im Abschnitt „No Show")

Beachten Sie, dass beim Abrufen der Konfiguration Felder mit Null-Werten ausgelassen werden.

Einrichten buchbarer Ressourcen

Wenn Sie eine Synchronisierungs-App für externe Dienste mit CAC (z. B. EWS-App) verwenden, überspringen Sie diesen Schritt. Die Ressourcentypen und Ressourcen werden automatisch erstellt.

Damit eine Ressource buchbar ist, muss sie sowohl im Ressourcentyp als auch in der konkreten Ressource definiert sein.

Der Ressourcentyp muss das Attribut „bookable“ vom Untertyp „property“ haben, und die Ressource muss diese Eigenschaft auf „1“ setzen.

Darüber hinaus sollte der Ressourcentyp das Eingabeattribut „occupancy“ haben, in das Informationen über den aktuellen Buchungsstatus geschrieben werden.

Diese Ressourcen müssen dann auf einer Etage entweder als Polygon (z. B. Räume) oder als Punkt von Interesse platziert werden. Setzen Sie „Occupied“ als Attribut, verwenden Sie eine wertbasierte Farbe (0 für frei, 1 für belegt) und setzen Sie die Eigenschaft „Resource can be booked“.

Unter Dashboard -> Widgets erstellen Sie einen neuen Widget-Typ und fügen einen „Booking“-Block hinzu.

Nachdem Sie den Widget-Typ erstellt haben, erstellen Sie ein neues Dashboard und verwenden diesen Widget-Typ. Konfigurieren Sie die gewünschte Etage und die einzuschließenden Ressourcen.

In diesem Dashboard können Benutzer die Ressourcen buchen.

Buchung

Klicken Sie auf die Ressource, die Sie buchen möchten, und folgen Sie dem Formular, um die Ressource für die gewünschte Zeit zu buchen.

Das Formular ermöglicht Buchungen auf zwei Arten: Schnellbuchung und erweiterte Buchung. Mit der Schnellbuchung kann der Benutzer die Ressource schnell für einen in der Konfiguration festgelegten Teil des Tages buchen, während die erweiterte Buchung es dem Benutzer ermöglicht, die genaue Uhrzeit für die Buchung anzugeben.

Die Ressourcen werden für einen bestimmten Benutzer gebucht, und Benutzer können ihre Buchungen an derselben Stelle verwalten, an der sie die Ressourcen buchen können.

Wenn ein externer Dienst verbunden ist und die Ressource damit verknüpft ist, wird diese Buchung an den externen Dienst weitergeleitet. Umgekehrt werden in diesem externen Dienst erstellte Buchungen ebenfalls mit BuildingPro Suites synchronisiert.

Nichterscheinen

Die App kann Buchungen automatisch stornieren, wenn keine Person im Raum erscheint. Diese Funktion wird durch den noShowMins Parameter in der Konfiguration.

Der Raum oder seine untergeordneten Orte müssen genau ein Attribut haben, das so benannt ist wie in presenceAttributeName. Dies bedeutet, dass der Raum ein virtuelles Attribut haben könnte, das auf Informationen anderer Sensoren verweist, oder dass ein Personen- oder Präsenzsensor installiert werden könnte, der die Anwesenheitsinformationen bereitstellt.

Sobald die App Informationen über die Anwesenheit hat und noShowMins >= 0, überwacht sie die kürzlich gestarteten Buchungen auf Anwesenheit. Wenn innerhalb der ersten noShowMins der Buchung keine Anwesenheit erkannt wird, wird die Buchung storniert.

Wenn der Raum keinen Präsenzsensor hat, wird nichts unternommen.

Ad-hoc-Buchung

Die App kann Räume, die belegt sind, automatisch für eine bestimmte Zeit buchen. Die Anforderungen sind dieselben wie für Nichterscheinen.

Ad-hoc-Buchungen werden automatisch für Räume aktiviert, die jemals gebucht wurden. Sie kann vollständig deaktiviert werden, indem adHocBookAfterMins < 0.

Wenn sich jemand durchgehend im Raum befindet für adHocBookAfterMins und der Raum in dieser Zeit keine Buchung hat (oder seit adHocBookForMins seit Beginn), wird der Raum für adHocBookForMins seit Beginn.

Externe Dienste

Die Booking-App kann mit externen Buchungsdiensten verbunden werden. Derzeit bieten wir eine Verbindung mit Microsoft Exchange / Outlook Calendar über die Exchange-App. Bitte kontaktieren Sie uns für Informationen zu weiteren Integrationen.

Zuletzt aktualisiert

War das hilfreich?