Postfachvorschau

Die Postfachvorschau zeigt den Ordnerbaum eines Quellpostfachs mit den Nachrichtenzahlen. Sie arbeitet ausschließlich lesend und dient dazu, die Ordnerauswahl zu treffen und den erwarteten Umfang einzuschätzen.

Ablauf

1. „Postfach prüfen und migrieren“ öffnen.
2. Quelle wählen: bei Microsoft 365 Tenant und Konto, bei IMAP den Quellserver plus Benutzername und Passwort.
3. Verbindung herstellen. Die Anwendung liest die Ordnerliste und fragt je Ordner die Nachrichtenzahl ab.
4. Die Vorschau erscheint als Baum mit Nachrichtenzahlen.
5. Ordner auswählen oder „Alle Ordner synchronisieren“ wählen.
6. Zielserver, Zieladresse und Zielpasswort festlegen.
7. „Nur anlegen“ speichert ohne Lauf; „Migration starten“ legt an und reiht sofort einen Lauf ein.

Bis zum letzten Schritt wird nichts übertragen und nichts gespeichert.

Was gelesen wird

Befehl	Zweck
LIST "" "*"	Ordnerliste mit Trennzeichen und Flags
STATUS "<ordner>" (MESSAGES)	Nachrichtenzahl je Ordner

Daraus entstehen der Ordnerbaum inklusive Unterordnern, die Nachrichtenzahl je Ordner, die Gesamtzahl der Ordner und Nachrichten sowie die Liste der Ordner, die nicht gelesen werden konnten.

Ordner mit dem Flag \Noselect oder \Nonexistent erscheinen im Baum, werden aber nicht abgefragt und sind nicht auswählbar.

Was nicht passiert

• Keine Nachricht wird kopiert, verschoben, markiert oder gelöscht.
• Es werden keine Flags verändert (\Seen bleibt, wie es ist).
• Es entstehen keine Jobs und keine Läufe.
• Es wird nichts am Zielserver angefasst; eine Zielverbindung findet nicht statt.
• Es werden keine Nachrichteninhalte, Anhänge oder Kopfzeilen gelesen — nur Zähler.

Die Antwort enthält read_only: true; die Oberfläche weist mit „nur lesend“ und einem Momentaufnahme-Hinweis darauf hin.

Momentaufnahme

Die Zahlen gelten für den Zeitpunkt der Abfrage („Momentaufnahme vom …“). Zwischen Vorschau und Migrationslauf können sich Nachrichtenzahlen ändern, etwa durch eingehende Mail oder Löschungen. Für die Migration zählt der Zustand zum Zeitpunkt des Laufs, nicht die angezeigte Zahl.

„Aktualisieren“ liest die Ordnerliste erneut ein. Die Auswahl bleibt erhalten, sofern die Ordnernamen unverändert sind.

Bedienung des Baums

• Aufklappen/Zuklappen über das Dreieck am Ordner.
• Mehrfachauswahl über die Kontrollkästchen; die Summe der ausgewählten Nachrichten wird laufend angezeigt.
• Alle auswählen bzw. Alle abwählen für die gesamte Liste.
• Nicht auswählbare Ordner (reine Container) haben kein Kontrollkästchen.

Fehler einzelner Ordner

Kann ein Ordner nicht gelesen werden — etwa eine gesperrte Freigabe oder ein Ordner ohne Zugriffsrecht —, bricht die Auswertung nicht ab. Die Meldungen erscheinen gesammelt über dem Baum:

Einzelne Ordner konnten nicht gelesen werden:
  Freigaben/Team: STATUS fehlgeschlagen

Der Rest des Baums bleibt nutzbar. Für die Migration bedeutet das: Der Ordner fehlt in der Auswahl und wird nicht übertragen. Schlägt die Verbindung insgesamt fehl, liefert die Anwendung folder_preview_failed mit der Ursache (Anmeldung, TLS, Host nicht erreichbar).

Ordnerauswahl für die Migration

Modus	Bedeutung
Alle Ordner	imapsync überträgt alle Ordner; neue Ordner kommen bei späteren Läufen automatisch hinzu
Nur ausgewählte	imapsync erhält je Ordner ein eigenes --folder; neue Ordner werden nicht übernommen

Im Modus „Nur ausgewählte“ muss mindestens ein Ordner gewählt sein, sonst lehnt die Anwendung das Speichern ab. Im Modus „Alle“ dürfen keine Ordner mitgegeben werden.

Die Entscheidung ist dauerhaft: Ein späterer Lauf verwendet dieselbe Auswahl. Änderungen erfordern ein Bearbeiten der Migration.

Grenzen

• Es werden nur Nachrichtenzahlen gelesen, keine Größen; eine Abschätzung des Datenvolumens ist nicht möglich.
• Die Vorschau garantiert nicht, dass alle Ordner übertragen werden; Rechte und serverseitige Limits können den Lauf beeinflussen.
• Bei sehr vielen Ordnern dauert die Abfrage entsprechend länger; das Zeitlimit je Verbindung beträgt 20 Sekunden.
• Microsoft-365-Postfächer benötigen ein verbundenes Konto. Ist die Anmeldung abgelaufen, meldet die Vorschau reauth_required.

Technische Entsprechung

Aktion	Endpunkt
Vorschau IMAP-Quelle	POST /api/v1/sources/{source_id}/folders
Vorschau Microsoft 365	POST /api/v1/sources/preview/microsoft365/{identity_id}

Beide Endpunkte sind authentifiziert und verlangen ein CSRF-Token. Die Antwort enthält folders, total_folders, total_messages, delimiter, errors, read_only und captured_at.