Hochladen einer PST-Datei

Laden Sie historische E-Mails aus einer aus Exchange exportierten PST-Datei in Communications Mining hoch, mit den Exportanforderungen, bekannten Einschränkungen und Lösungen für Upload-Fehler.

Wichtig:

Eine PST-Datei ist ein einmaliger Snapshot und kein Live-Feed. Verwenden Sie einen PST-Upload, um das Modelltraining freizugeben oder historische E-Mails abzugleichen, während eine dauerhafte Integration eingerichtet wird. Verwenden Sie für die laufende E-Mail-Erfassung stattdessen die Exchange-Integration .

Sie laden eine PST-Datei mit der Communications Mining™-CLI hoch, die die E-Mails in der Datei analysiert und in einen Bucket schreibt. Anschließend erstellen Sie eine Quelle aus diesem Bucket und fügen die Quelle einem Dataset hinzu.

Wann eine PST-Datei verwendet werden sollte

Verwenden Sie eine PST-Datei, wenn	Verwenden Sie keine PST-Datei, wenn
Sie müssen die Blockierung des Modelltrainings aufheben, bevor eine Live-Integration verfügbar ist.	Sie wechseln zur Produktion. Richten Sie stattdessen die Exchange-Integration ein.
Sie benötigen einen historischen Abgleich von E-Mails, die die Live-Integration nicht erreichen kann, z. B. weil das Postfach ein In-Place-Archiv verwendet.	Sie eine Erfassung in Echtzeit oder einer laufenden Erfassung benötigen. Eine PST-Datei erfasst das Postfach zu einem einzigen Zeitpunkt.
Ihre Umgebung blockiert die Exchange-Integration und Sie benötigen schnell Daten auf der Plattform.	Sie benötigen vollständige Konversationsverlaufe. Bei einem PST-Export können Nachrichten aus einer Konversation weggelassen werden.

Tipp:

Lassen Sie für einen historischen Abgleich die Exchange-Integration für neue E-Mails aktiviert und verwenden Sie die PST-Datei nur für die älteren Daten. Wenn Sie die Synchronisierung während des Trainings laufen lassen, erhält Active Learning mehr Daten, die er nutzen kann.

Bekannte Einschränkungen

Ein PST-Upload ist keine zuverlässige Möglichkeit, Daten auf die Plattform zu übertragen, und er ist kein Ersatz für eine Live-Integration. Bei jedem PST-Upload gehen einige Daten verloren. Erwarten Sie also nicht, dass jede E-Mail in der Datei die Plattform erreicht. Wenn Ihre Umgebung dies zulässt, verwenden Sie stattdessen die Exchange-Integration.

Es gelten folgende Einschränkungen:

• Aus Outlook exportierte PST-Dateien werden nicht unterstützt. Ein Outlook-Client-Export verwirft die Transportheader, die Communications Mining benötigt, und lässt den Ordner Gesendete Elemente weg. Die CLI kann eine solche Datei möglicherweise nicht vollständig analysieren. Dies ist die häufigste Ursache für große Datenverluste.
• E-Mails, deren einziger Text RTF ist, werden nicht hochgeladen. Die CLI verwendet den HTML-Textkörper, wenn einer vorhanden ist, und greift auf den Nur-Text-Textkörper zurück. Eine E-Mail wird nur verworfen, wenn beide fehlen. Die meisten RTF-geschriebenen Outlook-E-Mails bieten auch eine Klartext-Alternative und werden problemlos hochgeladen. Es gibt keine Möglichkeit, reine RTF-E-Mails in einer PST-Datei zu erkennen, bevor Sie den Upload ausführen.
• Anhangsinhalt wird nicht hochgeladen. Nur die Anhangsmetadaten werden hochgeladen: Name, Größe und Inhaltstyp. Der Inhaltstyp wird aus der Dateierweiterung abgeleitet, anstatt aus der PST-Datei gelesen zu werden. Anhänge, die selbst E-Mails sind, werden übersprungen, sodass eine E-Mail, deren einziger Anhang eine weitergeleitete Nachricht ist, keine Anhänge meldet.
• Ein Datenverlust ist zu erwarten. Als Daumenregel gilt Ihr Budget für etwa 1 % der fehlgeschlagenen E-Mails. Die tatsächlichen Ergebnisse variieren in beide Richtungen, also führen Sie den Upload zuerst mit --dry-run aus und überprüfen Sie die Zähler emails failed to parse und failed to upload, die die CLI am Ende jeder Ausführung ausgibt.
• Elemente, die keine E-Mails sind, werden als Fehler gezählt. Die CLI durchläuft jeden Ordner in der PST-Datei und erfordert, dass jedes Element sowohl einen Message-ID - als auch einen Date -Header hat. Entwürfe, Kalenderelemente, Kontakte und Aufgaben haben keines von beiden, daher werden sie als Analysefehler gemeldet. Eine Fehleranzahl ungleich Null wird erwartet.
• Threads können unvollständig sein. Eine PST-Datei enthält nicht unbedingt jede Nachricht in einer Konversation.
• Andere Zeichensätze als UTF-8 können fehlerhaft sein. Japanisch (ISO-2022-JP) und chinesische E-Mails sind am häufigsten betroffen. Das Verhalten hängt vom Textkörpertyp ab:
  • Nur-Text-Textkörper werden mithilfe der Codeseite der Nachricht konvertiert. Wenn die Konvertierung fehlschlägt, wird die E-Mail verworfen und als Analysefehler gezählt, den --dry-run meldet.
  • HTML-Textkörper werden auf UTF-8 umgestellt, sodass Bytes, die nicht decodiert werden können, zu Ersatzzeichen werden. Es wird kein Fehler ausgelöst, kein Zähler wird erhöht und --dry-run meldet es nicht. Überprüfen Sie nach dem Hochladen ein Beispiel für HTML-E-Mails auf der Plattform.

Wichtig:

Um ein Postfach auszufüllen, bevor Sie es exportieren, verschieben, kopieren oder leiten Sie die E-Mails um, indem Sie sie z. B. zwischen den Postfächern in Outlook ziehen. Leiten Sie sie nicht weiter. Eine weitergeleitete Nachricht wird mit der vorherigen Konversation entfernt, die aus dem Textkörper entfernt wurde, wodurch nur Header und Adressen übrig bleiben und für das Training nicht nützlich ist.

Exportieren der PST-Datei

Exportieren Sie die PST-Datei aus Exchange, nicht aus Outlook. Eine PST-Datei, die aus dem Outlook-Client über Datei > Öffnen und Exportieren > Importieren/Export exportiert wird, lässt den Ordner Gesendete Elemente und andere Ordner weg und kann eine Datei erstellen, die die CLI nicht analysieren kann.

Eine Übersicht über die unterstützten Exportpfade finden Sie unter Exportverfahren für Postfach.

Microsoft 365 und Exchange Online

Verwenden Sie Microsoft Purchase eDiscovery für Cloud-Postfächer. Weitere Informationen finden Sie unter Exportieren von Suchergebnissen in eDiscovery.

Voraussetzungen:

• Der Administrator, der den Export ausführt, verfügt über die eDiscovery Manager- Rolle im Microsoft Purchase-Portal. Diese Rolle ist standardmäßig nicht zugewiesen.
• Die Organisation verfügt über eine E3- oder E5-Lizenz.

Steps:

1. Erstellen oder öffnen Sie im Microsoft Purchase Portal einen eDiscovery-Fall.
2. Führen Sie eine Suche mit Scope auf die Zielpostfächer aus. Lassen Sie die Schlüsselwörter leer, um alles im Datumsbereich zurückzugeben.
3. Wählen Sie bei der Suche Exportieren aus.
4. Wählen Sie unter Exportformat die Option PSTs für Nachrichten erstellen aus.
5. Schließen Sie das Archivpostfach und die wiederherstellbaren Elemente ein, um den vollständigen Verlauf zu exportieren. Die primären und Archivpostfächer werden in einer einzigen PST-Datei zusammengeführt.
6. Legen Sie die maximale PST-Paketgröße auf 1, 2, 5 oder 10 GB fest. Kleinere Pakete sind einfacher zu übertragen.
7. Laden Sie das Paket von Process Manager herunter.

Wichtig:

Exportpakete laufen nach 14 Tagen ab. Extrahieren Sie das Paket mit einem Archivierungstool eines Drittanbieters anstelle der integrierten Windows-Extraktion und überprüfen Sie die Dateigrößen nach Abschluss des Downloads.

Lokaler Exchange-Server

Dieses Verfahren gilt für Exchange Server 2016, 2019 und die Abonnement-Edition. Weitere Informationen finden Sie unter eDiscovery-Suchergebnisse in eine PST-Datei exportieren.

Voraussetzungen:

• Auf der Exportmaschine sind .NET Framework 4.7 und das ClickOce-Add-In in Chrome oder Firefox installiert.
• Das Konto, das den Export ausführt, verwendet keine Multi-Faktor-Authentifizierung (MFA). Das eDiscovery-PST-Exporttool funktioniert nicht mit MFA-Konten, daher erstellen Sie zuerst ein App-Kennwort für das Konto.

Steps:

1. Wechseln Sie im Exchange-Administratorzentrum zu Compliance-Verwaltung > In-Place eDiscovery & Halten.
2. Wählen Sie die Suche und dann In eine PST-Datei exportieren aus.
3. Wählen Sie im eDiscovery PST-Exporttool einen Speicherort für den Download aus.
4. Wählen Sie optional Deduplizierung aktivieren aus, um alle Ergebnisse in eine einzelne PST-Datei zu schreiben, und Nicht durchsuchbare Elemente einschließen.
5. Wählen Sie Start aus.

Hinweis:

Unternehmensproxys und Firewalls können den Exportdownload blockieren oder drosseln. Die beteiligten Microsoft-Endpunkte müssen möglicherweise auf Ihre Netzwerkzulassungsliste hinzugefügt werden.

Die PST-Datei wird hochgeladen

Voraussetzungen

• Die Communications Mining-CLI wird installiert. Weitere Informationen finden Sie unter CLI.
• Ein Kontext wird für Ihren Communications Mining-Endpunkt konfiguriert. Weitere Informationen finden Sie unter Konfigurieren der CLI.
• Die PST-Datei wird aus Exchange exportiert, wie im vorherigen Abschnitt beschrieben.
• Sie verfügen über Berechtigungen zum Erstellen von Buckets und Quellen im Zielprojekt.

Wichtig:

Das Hochladen von E-Mails verbraucht AI Units oder Platform Units, deshalb werden Sie von der CLI aufgefordert, der Gebühr zuzustimmen, bevor der Upload beginnt. Ein Schreibtischtest verbraucht nichts, zeigt aber trotzdem die Eingabeaufforderung an. Fügen Sie --yes hinzu, um die Eingabeaufforderung in einer Unattended- oder Skriptausführung zu unterdrücken.

Schritte

1. Erstellen Sie einen Bucket für die E-Mails. Projekt- und Bucket-Namen akzeptieren nur Buchstaben, Ziffern, Bindestriche und Unterstriche.

   re -c <context> create bucket <ProjectName>/<BucketName>
   

2. Prüfen Sie, ob die PST-Datei analysiert wird, bevor Sie Einheiten verbrauchen.

   re -c <context> parse pst --bucket <ProjectName>/<BucketName> --file <PathToPst> --dry-run
   

   Der Befehl liest die gesamte Datei und meldet Analysefehler, ohne etwas hochzuladen. Es gibt entweder No parse errors found oder eine Aufschlüsselung der einzelnen Fehler und die Anzahl der betroffenen E-Mails aus.

3. Laden Sie die PST-Datei in den Bucket hoch.

   re -c <context> parse pst --bucket <ProjectName>/<BucketName> --file <PathToPst> --resume-on-error
   

   Das Flag --resume-on-error überspringt und zählt E-Mails, die nicht verarbeitet werden können. Ohne diese bricht die erste E-Mail, die fehlschlägt, die gesamte Ausführung ab.

Die E-Mails befinden sich jetzt im Bucket. Um sie für das Training verfügbar zu machen, erstellen Sie eine Quelle aus dem Bucket und fügen Sie diese Quelle einem Dataset hinzu.

Upload-Optionen und -Verhalten

• Eine PST-Datei pro Befehl. Das Flag --file verwendet einen einzelnen Pfad. Durchlaufen Sie Ihre Shell, um mehrere PST-Dateien hochzuladen.
• Der Postfachname in der Plattform ist der Dateiname der PST-Datei, einschließlich der Erweiterung. Eine Datei mit dem Namen export (1).pst erzeugt ein Postfach mit dem Namen export (1).pst, das für Ihre Benutzer sichtbar ist. Benennen Sie die Datei in etwas aussagekräftiges um, bevor Sie sie hochladen.
• Eine große PST-Datei wird langsam gestartet. Die CLI zählt jedes Element in der Datei, bevor das Hochladen beginnt, sodass die Datei zweimal gelesen wird und der Fortschrittsbalken einige Zeit dauert, bis er angezeigt wird. Die Ausführung nicht anhalten.
• --num-threads hat keine Auswirkungen. Der Befehl re parse pst ist von Natur aus mit einem einzigen Thread versehen.
• Das erneute Ausführen derselben PST-Datei im selben Bucket ist idempotent. Jede E-Mail ist in ihrem Message-ID -Header enthalten und der Upload ist ein Upsert, sodass er nach einem fehlgeschlagenen oder unterbrochenen Upload sicher erneut ausgeführt wird.
• Legen Sie --resume-on-error fest, wenn Sie Fehler diagnostizieren. Die CLI hält dann beim ersten Fehler an und meldet den Grund.

Buckets, Quellen und Datasets

Wenn Sie verstehen, wie sich E-Mails durch die Plattform bewegen, wird die häufigste Ursache für doppelte Kommentare verhindert:

• Ein Bucket speichert unformatierte E-Mails. Hier landen PST- und Exchange-E-Mails.
• Eine Quelle wird aus einem Bucket erstellt. Die E-Mails werden vom Bucket mit der Quelle synchronisiert, wo sie in Kommentare umgewandelt werden.
• Ein Dataset ist das, mit dem Sie trainieren. Es enthält eine oder mehrere Quellen.

Als bewährte Methode empfiehlt es sich, einen Bucket an eine Quelle anzuhängen und jede Quelle nur über eine Methode auszufüllen, entweder über einen Bucket oder die API. Wenn Sie denselben Bucket an vier Quellen anhängen, wird jede E-Mail in allen vier Quellen dupliziert.

Weitere Informationen zum Erstellen der Quelle finden Sie unter Erstellen oder Löschen einer Datenquelle in der GUI.

Doppelte E-Mails, wenn Sie auch die Exchange-Integration verwenden

Communications Mining dedupliziert E-Mails im Message-ID -Header und der Upload ist ein Upsert. Das Abgleichen mit einer PST-Datei und das anschließende Aktivieren der Exchange-Integration erzeugt daher keine doppelten Kommentare. Zwei PST-Dateien, die E-Mails freigeben, werden ebenfalls nicht verdoppelt, sofern beide dieselbe Message-ID haben. Wenn Sie Duplikate sehen, überprüfen Sie, mit wie vielen Quellen der Bucket verbunden ist.

Fehlersuche und ‑behebung

Symptome	Ursache und Lösung
Jede E-Mail kann nicht analysiert werden, z. B. Total emails: 304 / failed to parse: 304 / uploaded: 0.	Die PST-Datei wurde aus Outlook exportiert, was nicht unterstützt wird. Exportieren Sie die Datei erneut aus Exchange.
Einige E-Mails schlagen fehl, und der Grund ist nicht klar.	Führen Sie den Upload ohne --resume-on-error erneut aus, sodass die CLI beim ersten Fehler anhält und den Grund ausgibt. Ein --dry-run meldet die gleichen Fehler für die gesamte Datei ohne Upload.
Sie müssen wissen, ob eine PST-Datei beschädigt ist.	Wenn die CLI die Datei öffnen und ihre Elemente iterieren kann, suchen Sie stattdessen nach einer Ursache auf Parse-Ebene. Wenn die Datei überhaupt nicht gelesen werden kann, laden Sie sie erneut herunter und überprüfen Sie, ob die lokale Dateigröße mit der Quelle übereinstimmt. Ein teilweiser Download ähnelt einer beschädigten Datei.
Die CLI meldet mehr E-Mails, als das Dataset enthält.	Die PST-Dateien enthalten doppelte Message-ID -Werte, die die Plattform beim Hochladen dedupliziert. Es ist kein Bericht darüber verfügbar, was dedupliziert wurde. Zählen Sie zur Bestätigung die eindeutigen Message-ID -Werte in der Datei.
Sie müssen die reinen RTF-E-Mails finden, bevor Sie den Upload ausführen.	Dies ist im Voraus nicht erkennbar. Führen Sie den Upload mit --dry-run aus und lesen Sie die gemeldeten Fehler.
Der Upload scheint angehalten zu sein.	Bei einer großen PST-Datei zählt die CLI alle Elemente, bevor sie hochgeladen wird, sodass es zuerst eine lange Ruhephase gibt. Wenn die Ausführung wirklich hängen bleibt, stellen Sie sicher, dass die Maschine nicht ressourcenbeschränkt ist, und kopieren Sie die PST-Datei in einen lokalen Pfad außerhalb eines synchronisierten Cloud-Speicherordners.
E-Mails zeigen verfälschten Text an.	Bekannte Einschränkung für Zeichensätze als UTF-8, z. B. japanische ISO-2022-JP und Chinesisch. HTML-Textkörper werden im Hintergrund beschädigt, sodass --dry-run sie nicht meldet. Es ist keine Problemumgehung verfügbar.
re create bucket oder re parse pst gibt Unknown context zurück oder zielt auf den falschen Mandanten ab.	Jeder Befehl benötigt einen Kontext: re -c <context>. Das Flag -c nimmt den Namen eines Kontexts an, den Sie bereits gespeichert haben, nicht eine Organisations- und Mandantenzeichenfolge. Ein mit re config parse-from-url erstellter Kontext heißt <organization>/<tenant>, und ein mit re config add --name production erstellter Kontext heißt production. Listen Sie die gespeicherten Kontexte mit re config ls auf.
Der Upload fordert zur Bestätigung auf und blockiert eine skriptbasierte Ausführung.	Der Prompt ist die Zustimmung zur Gebühr für die AI Unit oder Platform Unit. Fügen Sie --yes hinzu.
Die CLI kann die Plattform nicht erreichen.	Ihr Netzwerk filtert ausgehenden Fortschritt. Fügen Sie die Plattform- und CLI-Endpunkte zu Ihrer Zulassungsliste hinzu oder führen Sie die CLI von einer Maschine aus, die Zugriff hat.
Nicht alle E-Mails wurden hochgeladen.	Bis zu einem Grad erwartet. Bestätigen Sie, dass der Export von Exchange stammt, dass --resume-on-error verwendet wurde, und überprüfen Sie die Fehlerzähler. Entwürfe, Kalenderelemente und Kontakte werden als Fehler gezählt.

Wenn Ihr Problem nicht aufgeführt ist, reichen Sie ein UiPath®-Support-Ticket ein.