Sperreinträge (SYS01)

Transaktion: SYS01 Sperreinträge
UI-Pfad: /systemBlockers

Business-Zweck

Sperreinträge zeigen aktive Domain-Locks (DomainLocker): Datensätze oder Hintergrundprozesse, die von einem User oder Server exklusiv gesperrt sind. reybex verhindert so parallele Bearbeitung desselben Belegs (z. B. SalesHead, PurHead) oder blockiert laufende Batch-Prozesse (isProcess = true).

Partner nutzen SYS01 bei Support-Fällen: hängende Integration, abgebrochene Mobile-Pickings, blockierte Bank-Imports.

Kernbegriffe

Begriff	Bedeutung
DomainLocker	Sperreintrag mit domain, domainId, user
isProcess	true = Prozesssperre (Import, Pickliste, …)
lockDate / unlockDate	Sperrzeitpunkt / geplante Freigabe
releaseDate	Automatische Freigabe nach Timeout
NOT_LOCKED_DOMAINS	Domänen ohne Lock (u. a. user, company, emailAccount)

Fachlicher Ablauf / Workflow

Sperre entsteht

1. User öffnet Beleg → DomainLockerService.lock(domain, domainId, …)
2. Anderer User erhält Fehler message.domain.locked.error
3. Eintrag erscheint in SYS01

Sperre aufheben

1. Ursprünglicher User schließt Beleg → automatisches Unlock
2. Admin/Support: POST /api/domainLocker/deleteDomainLockers mit IDs
3. Prozesssperren (createPickList, readBankTransactions): nur Admin darf löschen

API-Lock/Unlock (programmatisch)

• GET /api/domainLocker/lock?domain=…&domainId=…
• GET /api/domainLocker/unlock?domain=…&domainId=…
• GET /api/domainLocker/unlockAll – alle Locks des aktuellen Users

Partner-Szenarien

Szenario	Aktion
API-Integration „hängt"	SYS01 prüfen, ob alter Lock existiert
Parallele Updates auf Beleg	Erwartetes Verhalten – Retry nach Unlock
Pick-/Import-Prozess blockiert	Prozess-Lock in SYS01, Admin-Löschung

Voraussetzungen

• Admin sieht alle Locks; andere User nur eigene (außer custom.deleteDomainLocks)

Auswirkungen im ERP

Bereich	Auswirkung
SAL/PUR/FIN	Belegbearbeitung serialisiert
Mobile Picking	Prozesssperre createPickList
MRP/Import	DomainLockerUtil.withProcessLock

Typische Fehlerquellen

• Lock nach Absturz – manuell in SYS01 löschen
• Falscher domain-Name – Lock gilt pro Domänen-String (salesHead, …)
• Nur Admin darf Prozess-Lock löschen – only.admin.can.delete.this

Weiterlesen

• Hintergrundprozesse (SYS20)