Zum Hauptinhalt springen

Escrow & Übergaben

Reale KNX-Installationen überdauern den Integrator, der sie in Betrieb genommen hat. Wenn ein Gebäudeeigentümer den Dienstleister wechselt oder ein Integrator ein Kundenportfolio an ein anderes Unternehmen verkauft, muss das Projekt sauber zwischen KNX-Clarity-Organisationen wandern — ohne Verlust der Historie und ohne Überraschungen für den Kunden.

KNX Clarity teilt das in zwei Abläufe:

  • Escrow — ein Projekt wird in einen neutralen Zustand geparkt. Solange es im Escrow ist, kann niemand etwas verändern. Nutzen Sie dies während der Übergabe-Verhandlung.
  • Übergaben — eine gerichtete, nachvollziehbare Verschiebung eines Projekts von einer Organisation zu einer anderen. Die Ziel- Organisation muss annehmen.

Wann was?​

In der Praxis: Projekt in Escrow setzen, dann das Übergabe- Formular mit der Ziel-Organisation ausfüllen. Lehnt die Ziel-Org ab, geht das Projekt in Ihrer Organisation zurück in den Escrow; Sie können es jederzeit wieder aus dem Escrow nehmen.

Escrow​

Projekt in den Escrow setzen​

Wählen Sie im Projektdetail oben rechts im Status-Dropdown Escrow. Ein Bestätigungsschritt erläutert, was passiert, bevor die Änderung wirksam wird:

  • Das Projekt wechselt auf Status Escrow.
  • Alle Schreibvorgänge sind für jedes Mitglied der aktuellen Organisation gesperrt (auch für Admins).
  • Offene Servicefälle werden pausiert; Techniker können sie noch sehen, aber keine Kommentare hinzufügen.
  • ETS-Downloads sind weiterhin erlaubt, damit die Quell-Org eine Kopie behalten kann.

Aus dem Escrow holen​

Scheitert die Übergabe-Verhandlung, klicken Sie erneut auf das Status-Dropdown und wählen Aktiv. Das Projekt kehrt in den Normalzustand zurück. Nichts ist verloren.

Die Escrow-Seite​

Der Seitenleisten-Eintrag Escrow listet jedes Projekt Ihrer Organisation, das aktuell im Escrow ist, plus jeden Escrow- Datensatz, der Ihre Organisation betrifft (z. B. ein Projekt, das jemand an Sie übergeben möchte). Nutzen Sie ihn als „Übergaben in Vorbereitung"-Posteingang.

Escrow-Seite mit einer Liste von Escrow-Projekten samt Gegenstück-Organisation, Escrow-Status sowie den Aktionen Freigeben / Streitfall melden pro Zeile.

Übergaben​

Übergabe einleiten​

Klicken Sie aus einem Projekt im Escrow auf ⋮ → Übergabe einleiten. Der Dialog fragt nach:

  • Ziel-Organisation — der Name der Organisation. Die Org muss nicht in Ihren Kontakten stehen; KNX Clarity sucht plattformweit nach dem Namen.
  • Kontakt-E-Mail — die E-Mail eines admins der Ziel- Organisation. Wird nur für die Benachrichtigung verwendet.
  • Grund / Notizen — Freitext, der der Ziel-Organisation gezeigt wird.
Dialog zum Einleiten einer Übergabe mit Suche nach Ziel-Organisation, Eingabe für Admin-E-Mail, einem Notizen-Textfeld und einer primären Einleiten-Schaltfläche.

Beim Absenden tut KNX Clarity:

  1. Erzeugt eine Zeile transferRequests mit fromOrgId, toOrgId, projectId und status = pending.
  2. Schickt jedem admin der Ziel-Org eine E-Mail.
  3. Setzt den Projektstatus von Escrow auf übergebend.

Annehmen oder Ablehnen​

Eine Admin-Person der Ziel-Org sieht die ausstehende Anfrage auf ihrer Übergaben-Seite. Sie kann:

  • Annehmen — die orgId des Projekts wird auf die Ziel-Org umgeschrieben, jeder Kind-Datensatz (rooms, devices, serviceCases, …) folgt mit. Die Quell-Org verliert den Zugriff.
  • Ablehnen — das Projekt geht in der Quell-Org zurück in den Escrow, mit einem Kommentar zur Begründung.

Beide Aktionen sind einseitig und werden in den Audit-Logs beider Organisationen festgehalten.

Übergaben-Seite mit zwei Abschnitten: eingehende Übergaben (mit Quell-Organisation, Projektname, Schaltflächen Annehmen / Ablehnen je Zeile) und ausgehende Übergaben (mit Ziel-Organisation, Status und einer Zurückziehen-Aktion). Die Schaltfläche „Neue Übergabe“ liegt oben rechts.

Was umzieht — und was nicht​

Wird eine Übergabe angenommen:

  • ✅ Projektzeile, Kundenverknüpfung (unverändert), Räume, Geräte, Gruppenadressen, ETS-Versionen, Servicefälle, Kommentare, Projektaktivitäten — alles wird auf die Ziel-Org umgeschrieben.
  • ❌ Mitglieder werden nicht mitübernommen. Die bestehenden Mitglieder der Ziel-Org erben den Zugriff über ihre vorhandenen Rollen.
  • ❌ Benachrichtigungen werden nicht migriert. Alte Benachrichtigungen in der Quell-Org verweisen weiterhin auf das Projekt, klicken darauf liefert nach Abschluss der Übergabe aber einen 404.

Warum Sie den Escrow nicht überspringen können​

Übergaben verlangen, dass ein Projekt vor dem Absenden des Übergabe-Formulars im Escrow ist. Das ist Absicht:

  • Beide Organisationen bekommen die Chance, den Zustand einzufrieren.
  • Die Absicht erscheint im Audit-Log der Quell-Org, damit auch der Kunde sieht, was passiert.
  • Niemand kann ein produktives Projekt per Fehlklick in eine Übergabe schieben.

Beta-Einschränkungen​

  • Eine abgeschlossene Übergabe rückgängig zu machen erfordert den Support; in der aktuellen Beta gibt es kein Self-Service-Undo.
  • Massen-Übergaben (10 Projekte auf einmal) werden nicht unterstützt.
  • Region-übergreifende Übergaben sind deaktiviert — beide Orgs müssen in derselben KNX-Clarity-Region liegen.