Warum fehlen zu exportierende Dokumente?

Wenn Dokumente nicht exportiert werden, müssen Sie folgende Stellen prüfen:

  1. Läuft der Export? Sie können einen groben Überblick in der Page ECM Aufgaben Status erhalten. Diese zeigt im Prinzip die folgenden Informationen an:

    1. Läuft die BC-Aufgabenwarteschlange und die ECM Codeunit 5125006?

    2. Läuft die ECM Aufgabenwarteschlange

  2. Prüfen Sie die ECM Warteschlange, dort finden Sie den

    1. Status,

    2. den letzten Nachrichtencode,

    3. “Anzahl Detaileinträge” (zum Anklicken) - dort finden Sie mehr Details auf etwaige Fehler.

  3. Ist die ECM Warteschlange leer, prüfen Sie ECM Dokumentdefinitionen, ob Sie für die gewünschten Dokumente eingerichtet sind.

Warum werden Dokumente nicht importiert?

Wenn Dokumente nicht importiert werden, müssen Sie folgende Stellen prüfen:

  1. Läuft der Import? Sie können einen groben Überblick in der Page ECM Aufgaben Status erhalten. Diese zeigt im Prinzip die folgenden Informationen an:

    1. Läuft die BC-Aufgabenwarteschlange und die ECM Codeunit 5125006?

    2. Läuft die ECM Aufgabenwarteschlange

  2. Prüfen Sie ECM Import-Dokumentdefinitionen, wann wurde dieser das letzte Mal ausgeführt:

    1. Feld “Letzter Import Start” prüfen

    2. Feld “Letzte Anzahl importierter Dokumente” prüfen

    3. Auf Feld “Anzahl Importdetails” klicken und die Logs prüfen

  3. Prüfen Sie die ECM Abwarten Buch.-Blätter, dort sehen Sie alle importierten, noch nicht abgeschlossenen Dokumente. Sind dort keine Dokumente, wurden Sie entweder nicht importiert oder noch nicht verarbeitet:

    1. Feld “Status” prüfen

    2. Feld “Nachrichtencode” anklicken, um Fehlerdetails zu erhalten.

  4. Prüfen Sie die ECM Dokumentposten, dort sehen Sie alle abgeschlossenen Dokumente. Im Feld “Datensatz ID” steht der BC-Datensatz, welchem die Dokumente zugeordnet sind.

Dokumente werden im Regelfall nur einmal importiert, prüfen Sie daher, ob die Dokumentenreferenz bereits in einem anderen ECM Buch.-Blatt oder ECM Dokumentposten/ECM Stornoposten existiert.

Falls Sie EQL verwenden, können mit Content Web Services Zeitabweichungen beim Abfragen des Archivs entstehen, bitte prüfen Sie daher die Einstellungen im ECM Server zur “Zeitverschiebung”. Das EQL kann alternativ in einer JSON-Struktur angegeben werden, dann sollte es nicht zu Zeitabweichungen kommen.

Es werden Aufträge/Bestellungen zu oft archiviert. Wie kann man das reduzieren?

In der Standardauslieferung werden flüchtige Belege meistens mit der Einstellung “Bericht in ECM Warteschlange” “immer” archiviert. Dies bedeutet, dass der Beleg beim Druck abgelegt, beim Buchen und auch bei der Standardarchivierung von Business Central nachgedruckt wird.

Diese Einstellung kann man in der zugehörigen Dokumentdefinition im Reiter “Verwendung” ändern.

Wie kann ich einen Bericht von der Archivierung ausschließen?

Öffnen Sie die Seite ECM Berichtsausschlussliste und tragen Sie dort die Berichts-ID, Verwendungszweck “ “ und “Bericht in ECM-Wartschlange” immer ein.

Warum funktioniert der integrierte Dateibetrachter nicht?

Es ist zu prüfen, ob der Dateibetrachter als separates Fenster geöffnet werden soll (ohne ECM File Viewer FactBox App) oder innerhalb der Dokumente-FactBox.

Prinzipiell ist zu prüfen, welche Einstellungen im Anzeige-ECM Benutzer hinterlegt sind in den Felder:

  1. Dokumente öffnen per: ECM Dateibetrachter / Download

  2. ECM Dateibetrachter Erweiterungen: Alle Datei-Erweiterungen (pdf, txt, html, …) die vom Browser unterstützt werden, können hier hinterlegt werden.

  3. Ist die App “ECM FileViewer FactBox” installiert, können zusätzlich Einstellungen im ECM FactBox Primärfilter und Ansicht (Dokumentposten Primärfilter) hinterlegt werden.

Wie kann ich in der “ECM Dokumente FactBox” den integrierten “Dateibetrachter” deaktivieren?

Öffnen Sie die Seite ECM FactBox Primärfilter und Ansicht (Dokumentposten Primärfilter) und tragen Sie im Feld “ECM Infobox-Benutzeroberfläche” die gewünschte Einstellung, z. B. “Drag And Drop + Datensätze (ohne integrierten Dateibetrachter)” ein.

Die Benutzer müssen kurz warten, bis Sie weiter arbeiten können, wenn der integrierte Dateibetrachter aktiv ist. Wie kann ich das verhindern?

Wenn die Benutzer nicht blockiert werden sollen, können Sie im zugehörigen ECM Benutzer das Feld “Async. Laden von Dateien in der Infobox” anhaken.

Bei OnPremises Systemen wird keine weitere Einrichtung benötigt, wenn die API+oData API Zugriffe in der Mittelschicht erlaubt sind.

Bei Cloud Umgebungen muss eine “Azure App Registrierung” angelegt und in der ECM Einrichtung hinterlegt werden.

Wie kann ich Dokumente aus dem ECM System in BC importieren?

Dokumente sollen immer einem einzelnen Datensatz in BC zugewiesen sein. Eine Beschreibung für einen Import mit automatischer Zuweisung finden Sie hier: Automatischer Import von Einkaufslieferscheinen aus DM, Dokumente zu Debitor importieren.

Wie kann ich bestimmte Dokumente vom Export ausschließen?

Wen Sie z. B. Dokumente für eine Kreditor oder Debitor nicht exportierten möchten, haben wir hierfür folgenden Beispielcode bereitgestellt: https://github.com/JulianGeissEasy/ECM-Examples/tree/main/SkipExportOfDocuments

Wie kann ich sofort die Metadaten und das Dokument anzeigen?

Dies ist nur möglich, wenn Sie die App “ECM File Viewer FactBox” installiert haben. Diese ist im Lieferumfang enthalten und kann BC Cloud aus der AppSource installiert werden.

  1. Variante

    1. Klicken Sie auf das Kontext-Menü (3 Punkte) in der FactBox.

    2. Wählen Sie “Dokument Detailansicht” aus.

  2. Variante

    1. Öffnen Sie die Seite ECM Benutzer und hinterlegen Sie für den jeweiligen “ECM Benutzer” im Feld Dokumentanzeige den Wert “Dokument Detailansicht”.

    2. Öffnen Sie die Seite ECM FactBox Primärfilter und Ansicht (Dokumentposten Primärfilter) und erstellen Sie dort die gewünschten Tabellen-ID(/Benutzer/Page-ID)-Kombinationen, z. B. Tabelle 39, Page “leer”, benutzer id “leer”, - für alle ungeb. Einkaufsbelege und hinterlegen Sie im Anschluss im Feld “ECM Infobox-Benutzeroberfläche” “Drag And Drop + Datensätze (ohne integrierten ECM Dateibetrachter)”.

image-20250821-083357.png

Welche Möglichkeiten habe ich, die Performance zu steigern?

Nummernserien auf Sequenz umstellen

ECM Warteschlange klein halten

Konfiguration prüfen

In der ECM Dokumentendefinition sollte der Haken “Sofort im ECM ablegen” nicht gesetzt sein. Das Ablegen im ECM läuft über die Warteschlange im Hintergrund.

Dokumente beim Buchen nicht in die Warteschlange schreiben

Alternativ kann man den Stapelbericht Belege im Nachhinein speichern oder neu zuweisen (ECM Belege nacharchivieren) “5125000” in der Aufgabenwarteschlange (BC oder ECM) hinterlegen. Diesen sollte man unbedingt auf bestimmte Dokumentendefinition filtern. Außerdem filtert der Job auf die “letzte Belegnr.” pro Dokumentendefinition und trägt fehlende, noch nicht archivierte BC Belege in die Warteschlange ein.

Unsupported App Only Token Fehler bei Sharepoint

Wenn Sie bei der Verwendung von Sharepoint den Fehler “Unsupported app only token” erhalten, liegt es evtl. daran, dass Sie keine OAuth. Zertifikat Anmeldung für den Dienst verwenden.

Dies können Sie anhand der Dokumentation im Archivserver-Konfigurationen einrichten.

Kann ich ein eigenes Logo in der Dropzone hinterlegen?

Ja, ein eigenes Logo kann in der https://easy-software.atlassian.net/wiki/spaces/EASYPM/pages/111971894 hinterlegt werden. Hierzu stehen Felder in der Karte bereit.

Wie können Dokumente zu einem Datensatz abgerufen werden?

Hierzu haben wir ein Beispiel vorbereitet, welche die Dokumentposten zum Datensatz abruft und im Anschluss alle Dateien abholt und in einer ZIP speichert: ECM-Examples/GetDocumentsForRecord at main · JulianGeissEasy/ECM-Examples