Metriken / KPI Widgets
Der folgende Artikel beschreibt die Anwendung von Metriken bei der Erstellung von Widgets für das CASABLANCA Dashboard. Sie erklärt die grundlegende Berechnungslogik sowie die Besonderheiten der einzelnen Metrik‑Typen, darunter Zimmer‑, Gäste‑, Aufgaben‑, Housekeeping‑ und Buchungs‑Metriken.
Alle Metriken im Dashboard basieren auf einer einheitlichen Struktur.
Aufbau einer Metrik
Jede Metrik enthält folgende Eigenschaften:
| Eigenschaft | Beschreibung |
|---|---|
| ID | Eindeutiger Bezeichner der Metrik |
| Label | Lokalisierter Anzeigename |
| Wert | Numerischer Wert (Ganzzahl-Format) |
| Wert-Label | Einheit des Wertes (z. B. Personen, Zimmer, Buchungen) |
| Zeitraum | Start- und Enddatum (entspricht dem Stichtag) |
| Dimension (optional) | Zusätzliche Gruppierung (z. B. nach Altersgruppe oder Housekeeping-Status) |
Zimmer-Metriken – Berechnungslogik
Alle Metriken berücksichtigen die über den Filter gewählten Daten. (Betriebe-Auswahl). Die Ergebnisse können gesamt oder auch nach Zimmerkategorie aufgeschlüsselt werden.
| Metrik | Beschreibung |
|---|---|
Zimmer gesamt (RoomsTotal) | Zählt die Gesamtanzahl der Zimmer. |
Anreisen (RoomsArrivals) | Zählt die Zimmer mit Anreise am Stichtag. |
Offene Anreisen (RoomsArrivals.Remaining) | Wie Anreisen, jedoch nur Zimmer, die noch nicht eingecheckt sind. |
Abreisen (RoomsDepartures) | Zählt die Zimmer mit Abreise am Stichtag. |
Offene Abreisen (RoomsDepartures.Remaining) | Wie Abreisen, jedoch nur Zimmer, die noch nicht ausgecheckt sind. |
Im Haus (RoomsInHouse) | Zählt die Zimmer, die am Stichtag belegt sind (Aufenthalt umfasst den Stichtag). |
Aktuell eingecheckt (RoomsInHouse.Current) | Aktuelle Buchungen, die den Stichtag berühren und den Status eingecheckt haben. |
Anreisen + Im Haus (RoomsInHouse.Expected) | Berechnet die erwartete Belegung am Stichtag. |
Zimmerwechsel (RoomsRoomChanges) | Zählt die Zimmerwechsel am Stichtag. |
Verfügbar (RoomsAvailable.Expected) | Berechnet die erwartete Verfügbarkeit. Verfügbar = Gesamt − Anreisen + Im Haus |
Überbucht (RoomsOverbooked.Expected) | Berechnet die Gesamtanzahl überbuchter Zimmer (kategorieübergreifend). Überbucht = max(0, Summe aller negativen Verfügbarkeiten) |
Ein Wert größer 0 bedeutet, dass mehr Zimmer erwartet belegt sind als insgesamt vorhanden.
Gäste-Metriken – Berechnungslogik
Alle Metriken berücksichtigen ausschließlich Aufenthalte mit gültigem Status, die mit gültigen Zimmern bzw. Zimmerkategorien verknüpft sind. Die Ergebnisse werden jeweils nach Altersgruppe aufgeschlüsselt.
| Metrik | Beschreibung |
|---|---|
Anreisen (GuestsArrivals) | Zählt die Gesamtanzahl der Gäste, deren Anreisedatum dem Stichtag entspricht. |
Offene Anreisen (GuestsArrivals.Remaining) | Wie Anreisen, jedoch werden nur Gäste gezählt, die noch nicht eingecheckt sind. |
Abreisen (GuestsDepartures) | Zählt die Gesamtanzahl der Gäste, deren Abreisedatum dem Stichtag entspricht. |
Offene Abreisen (GuestsDepartures.Remaining) | Wie Abreisen, jedoch werden nur Gäste gezählt, die noch nicht ausgecheckt sind. |
Im Haus (GuestsInHouse) | Zählt die Gesamtanzahl der Gäste, die am Stichtag im Haus sind (Aufenthalt umfasst den Stichtag). |
Aktuell eingecheckt (GuestsInHouse.Current) | Aktuelle Buchungen, die den Stichtag berühren und den Status eingecheckt haben. |
Anreisen + Im Haus (GuestsInHouse.Expected) | Berechnet die erwartete Gästeanzahl am Stichtag. Erwartet = Im Haus + Anreisen |
Abreisen werden in dieser Berechnung nicht abgezogen.
Aufgaben-Metrik – Berechnungslogik
Aufgaben werden nach dem angemeldeten Benutzer gefiltert. Berücksichtigt werden Aufgaben, die dem Benutzer direkt, über seine Abteilung oder allen zugewiesen sind.
Aufgaben (Tasks)
Zählt die Aufgaben für den Stichtag, aufgeteilt nach Status:
| Status | Beschreibung |
|---|---|
| Offen | Nicht erledigte Aufgaben |
| Erledigt | Abgeschlossene Aufgaben |
Housekeeping-Metrik – Berechnungslogik
Die Metrik berücksichtigt ausschließlich gültige physische Zimmer. (Keine virtuellen bzw. "nicht in der Statistik" Zimmer)
Housekeeping (Housekeeping)
Zählt die Anzahl der Zimmer gruppiert nach ihrem aktuellen Housekeeping-Status:
| Status | Beschreibung |
|---|---|
| Rein | Zimmer ist gereinigt |
| Unrein | Zimmer muss gereinigt werden |
| Kontrolliert | Zimmer wurde nach der Reinigung geprüft |
Buchungs-Metriken – Berechnungslogik
Alle Metriken berücksichtigen ausschließlich Reservierungen, die über den Filter gewählt wurden (Betriebe).
| Metrik | Beschreibung |
|---|---|
Neue Buchungen (BookingsNew) | Zählt alle am Stichtag erstellten Reservierungen mit sichtbarem Status. |
Stornos (BookingsCancellations) | Zählt Reservierungen, deren Status am Stichtag auf Storno geändert wurde (basierend auf dem Status‑Änderungsprotokoll). |
Abgelaufen (BookingsExpired) | Zählt abgelaufene Buchungen, bei denen das Ablaufdatum auf oder vor dem Stichtag liegt (ExpireDate ≤ Datum), die Reservierung mit Option verfällt markiert ist und der zugehörige Vorgangsstatus einem definierten Status der Liste "Abgelaufene Optionen" entspricht. |
Angebote (OffersNew) | Zählt alle am Stichtag erstellten Angebote. |
KPI Widget
| Metrik | Beschreibung |
|---|---|
| Check-In | Zeigt erledigte Anreisen zum Stichtag. |
| Check-Out | Zeigt erledigte Abreisen zum Stichtag. |
| Aktuelle Auslastung | Berechnet die aktuelle Auslastung zum Zeitpunkt des Stichtages: Auslastung (%) = (eingecheckte Zimmer / Gesamtzimmer) × 100. |
| Auslastung | Berechnet die erwartete Auslastung am Ende des Stichtages: Auslastung (%) = (Anreisen + Im Haus) / Gesamtzimmer × 100. |
FAQ / Troubleshooting
Für die Berechnung bestimmter Metriken werden die Statuseinstellungen unter Zimmerplan > Einstellungen > Zimmerplaneinstellungen > Status für Zimmerplanstatistik verwendet.
Treten Probleme bei der Anzeige oder Berechnung von Metriken auf, solltest Du diese Einstellungen überprüfen:
