### 6.1 Belegübertragungs-Aktivitäten (`KWG_DocumentTransferReference`)
Zentrale Protokoll-/Überwachungsseite **„Document Transfer References"** – ein Datensatz pro Übertragungsauftrag (Beleg oder Anhang) mit Quelltabelle, Belegnummer, Typ, **Status** (`new`/`queued`/`upload`/`error`), d.velop-Dokument-ID/-URL (klickbar → Vorschau in eingebettetem Webviewer) und Warteschlangen-ID/-Status.
Verfügbare Aktionen:
- **Beleg anzeigen** – öffnet den ursprünglichen BC-Beleg.
- **Fehlerdetails anzeigen** – nur bei Status „Error", zeigt die protokollierte Fehlerursache.
- **In Warteschlange stellen** – erzeugt/erneuert den Upload-Queue-Eintrag.
- **An d.velop hochladen** – stößt für ausgewählte, bereits eingereihte Zeilen den Upload direkt an.
- **Status zurücksetzen** – setzt eine fehlgeschlagene Übertragung (mit vorhandener Warteschlangen-ID) zurück auf „Queued", um einen erneuten Versuch auszulösen.
### 6.2 Rollencenter-Kacheln (Aktivitäten)
Auf dem **Business Manager Rollencenter** eingebettet (Page Extension `KWG_DocTransBusiMgrRoleCenter`, vormals `KWG_BusinessManagerRoleCenter` – reine Umbenennung, gleiche Objekt-ID 5740106): zwei CardParts, in dieser Reihenfolge:
- **„d.velop Drag & Drop"** (`KWG_FileDragDropActivities`, 5740078) – eigenständige Kachelgruppe mit der Aktionskachel **„d.velop Dropzone"**, öffnet direkt den Kategorisierungs-/Dropzone-Dialog (`KWG_DocAttachmentTempPayload`, siehe Abschnitt 7). Diese Kachel war zuvor Teil von `KWG_DocumentTransferActivities` (dort inzwischen als toter, auskommentierter Code vorhanden) und wurde in eine eigene Seite ausgelagert.
- **„d.velop Document Transfer Activities"** (`KWG_DocumentTransferActivities`) zeigt gruppierte Zähler je Belegart (Verkaufsbelege, Verkaufsbeleg-Anhänge, Einkaufsbelege, Einkaufsbeleg-Anhänge), gefiltert auf Status „Queued"/„Upload". Anklicken einer Kachel navigiert gefiltert in die Referenzenliste (6.1). Kacheln sind nur sichtbar, wenn der zugehörige Belegtyp in 4.1 aktiviert wurde.
- Kachelgruppe **„Errors"**: zwei Kacheln – „Failed Transfer" (fehlgeschlagene `KWG_DocumentTransferReference`-Einträge, wie bisher) und neu **„Error Protocol"** (Anzahl der Einträge im neuen App-eigenen Fehlerprotokoll, siehe 6.3) – beide navigieren gefiltert weiter.
- Neue Kachelgruppe **„Synchronization"**: sechs Kacheln mit den Änderungsprotokoll-Zählern (Einfügungen/Änderungen/Löschungen) für die Eigenschaften- und Wertelisten-Caches `KWG_DPPropertyPerCategory` und `KWG_DPPropertyValue` (siehe 4.2.1); Drilldown öffnet die Standard-Seite „Change Log Entries" gefiltert auf die jeweilige Tabelle/Änderungsart. Voraussetzung ist eine aktive Änderungsprotokollierung (siehe 4.2.1 und Abschnitt 17).
### 6.3 Fehlerprotokoll
Fehler beim Hochladen (REST-Aufrufe) oder beim Laden von d.velop-Metadaten (inkl. Eigenschaften-/Wertelisten-Sync, siehe 4.2.1) werden als `KWG_ErrorProtocol`-Eintrag (aus der Basis-App) gespeichert. Fehlgeschlagene Warteschlangen-Einträge bleiben erhalten (werden nicht gelöscht) und können über „Status zurücksetzen" erneut versucht werden.
Neben der bisherigen Sammelanzeige über die Standard-BC-Seite **„Error Messages"** (im Batch-Lauf) gibt es jetzt ein **App-eigenes Fehlerprotokoll**: Seite **„d.velop Error Protocol"** (`KWG_DocTransErrorProtocolList`, 5740074), gefiltert auf Einträge dieses App-Moduls (`module = App-ID`), sortiert nach Datum absteigend, mit FactBox `KWG_DocTransErrorProtFactBox` (5740075, extrahiert bei JSON-formatierten Fehlertexten die eigentliche Fehlermeldung aus dem `reason`-Feld). Erreichbar über die neue Rollencenter-Kachel „Error Protocol" (siehe 6.2). Ermöglicht durch eine Tabellenerweiterung `KWG_DocTransErrorProtocolt` (5740074, Namensfehler im Quellcode – überzähliges „t" am Ende, siehe 17) auf `KWG_ErrorProtocol`, die einen Sortierschlüssel auf `Date` ergänzt.
Für Diagnosezwecke steht zusätzlich eine Erweiterung der internen Warteschlangenseite `KWG_UploadQueue` (aus `dvelop base`) zur Verfügung: Felder/Aktionen zum Anzeigen/Herunterladen des gespeicherten PDF-Dokuments und des JSON-Payloads eines Warteschlangeneintrags.
---