Voraussetzung zum Betrieb ist, dass die jeweilige Microsoft Dynamics 365 Business Central Version sich noch im regulären Support befindet. Der erweiterte Support (extended Support) wird ausgeschlossen.
# Unterstützte FREEZE Versionen Für den Anschluss von FREEZE an Microsoft Dynamics 365 Business Central und für den Betrieb wird ein lizensiertes FREEZE System benötigt. # Installation # Lizenzen ### Microsoft Informationen zu den [Microsoft Business Central Lizenzen](https://docs.squeeze.one/books/dexpro-business-central-apps/page/bc-lizenzen). ### FREEZE Das DEXPRO Freeze System welches an Business Central angeschlossen werden soll benötigt eine gültige Kunden-Lizenz. # Bezug der DEXPRO Module Detailliertere Informationen finden Sie [hier](https://docs.squeeze.one/books/dexpro-business-central-apps/page/bezug-der-dexpro-module). ### OnPrem Für OnPrem Installationen wird auf Anfrage eines registrierten Resellers / Partners ein Runtime Package mit den benötigten Apps zur Verfügung gestellt. Diese werden durch den Partner der Kundenlizenz hinzugefügt und im Anschluss in das Microsoft Dynamics Business Central eingespielt. ### Cloud Für Cloud Installationen benötigt man lediglich Zugriff auf den Microsoft [AppSource](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.72374%7CPAPPID.b9c8c9cc-8cd1-41cc-bf86-7da37ac74c71?exp=ubp8&tab=Overview). Hier werden die benötigten DEXPRO Apps heruntergeladen. [](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.72374%7CPAPPID.b9c8c9cc-8cd1-41cc-bf86-7da37ac74c71?exp=ubp8&tab=Overview) # Konfiguration & Administration # Berechtigungssätze Um die Module nutzen zu können, muss den jeweiligen Anwendern der passende Berechtigungssatz zugewiesen werden. Folgende werden mit ausgeliefert: - DXP Core Admin - DEXPRO Core Administrator - DXP Core User - DEXPRO Core Benutzer - DXP FREEZE Admin - DEXPRO FREEZE Administrator - DXP FREEZE User - DEXPRO FREEZE Benutzer #### Freeze Berechtigungssätze - **DXP Freeze Admin**: Vollzugriff (Lesen, Einfügen, Ändern, Löschen) auf alle Freeze-Tabellen und Ausführungsrechte auf alle Freeze-Seiten und Codeunits. Geeignet für Administratoren, die die Freeze-Einrichtung verwalten. - **DXP Freeze User**: Zugriff auf alle Freeze-Funktionen mit eingeschränkten Schreibrechten auf Einrichtungstabellen (Setup, Speicher, Benutzer-Einrichtung, Zusatzabfragen). Geeignet für Standardbenutzer, die Freeze im Alltag nutzen. # DEXPRO Core Der DEXPRO Core verwaltet die einzelnen DEXPRO Apps und deren Dokumente pro Mandant. Es werden alle Belege, welche über die unterschiedlichen DEXPRO Module in Microsoft Dynamics 365 Business Central eingelaufen und verarbeitet worden sind, angezeigt. Zur Nachvervollgung von einzelnen Belegen wird auf eine globale Nummernserie, welche über alle DEXPRO Apps genutzt wird, gesetzt. Dies bietet den Vorteil, dass die Anwender mit nur einer Nummernserie pro Beleg arbeiten. Weitere Informationen finden sie [hier](https://docs.squeeze.one/books/dexpro-business-central-apps/chapter/dexpro-core). # Freeze Einrichtung In der FREEZE Einrichtung wird sowohl die Anbindung an das Freeze Archiv System, als auch die Verarbeitung innerhalb der App eingerichtet. ## Menü ### Vorgang [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677250678099.png) #### Einrichtung kopieren Hiermit wird die Einrichtung in andere Mandanten kopiert. #### Platzhalter hochladen Über diese Funktion wird ein Platzhalter für Dateitypen hochgeladen, welche der PDF-Viewer nicht darstellen kann. ### Navigation [](https://docs.squeeze.one/uploads/images/gallery/2024-04/image-1713949637585.png) #### Dokumentenklassen Einrichtung Über diesen Menüpunkt erreichen Sie die Einrichtung für die [Dokumentenklassen](https://docs.squeeze.one/books/freeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung). #### OAuth 2.0-Einrichtung In diesem [Menüpunkt](https://docs.squeeze.one/books/freeze-for-dynamics-365-bc-de-de/page/oauth-20-einrichtung) werden die User und deren Access Token für die OAuth 2.0 Authentifizierung verwaltet. #### Benutzer Einrichtung Über diesen [Menüpunkt](https://docs.squeeze.one/books/freeze-for-dynamics-365-bc-de-de/page/benutzer-einrichtung) erreichen Sie die Benutzerzuordnung zu den OAuth Usern. #### Zusätzliche Suchabfragen Die [Einrichtung von zusätzlichen Suchabfragen](https://docs.squeeze.one/books/freeze-for-dynamics-365-bc-de-de/page/zusatzliche-suchabfragen "Zusätzliche Suchabfragen") ist vor allem dann praktisch, wenn Archivmappen angezeigt werden sollen, die nicht über Freeze in BC archiviert wurden. Es gibt aber auch weitere Anwendungsfälle. ## FastTabs ### Allgemein In diesem FastTab kann man die Nutzung dieser App aktivieren/deaktivieren. [](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729157655096.png) ### API In diesem Fasttab wird die URL des FREEZE Systems angegeben. Des Weiteren wird der Standard Archivspeicher und die Standardauthentifizierung hinterlegt. Zudem kann hier angegeben werden wie viele Archivdatensätze bei Suchen gleichzeitig angezeigt werden sollen. [](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1736751715321.png) ##### URL-Zusatz Der hier eingetragene Zusatz zur URL, kann für besondere Situationen, wie migrierte Archive, erforderlich sein. Beispiel: &analyzers=Rights:linebreak CreditorID:text Dieses Feld erhöht die Flexibilität in besonderen Archivumgebungen und hilft dabei, ggfs. notwendige Anpassungen an der Software zu vermeiden. Dieses Feld ist standardmäßig ausgeblendet. ### Archivierung Hier können Einstellungen vorgenommen werden, was automatisiert Archiviert werden soll. [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677251572326.png) Automatische Archivierung nach der Buchung eines Belegs. Drucken und archivieren in einem Schritt. Archivierung von Emails mit Anhängen, wenn der Versand durch das BC Emailmodul erfolgt. ## Feldbeschreibungen ### Allgemein - **Aktiviert**: Aktiviert oder deaktiviert die Freeze App für den aktuellen Mandanten. - **Anhänge sind obligatorisch**: Wenn aktiviert, müssen beim manuellen Archivieren eines Datensatzes zwingend Anhänge beigefügt werden. - **Dateigröße der Anhänge validieren**: Wenn aktiviert, wird beim manuellen Archivieren geprüft, ob ein Anhang eine Dateigröße von 0 hat. Fehlerhafte Dateien werden so erkannt und die Archivierung verhindert. - **Max. Anzahl Suchergebnisse**: Legt die maximale Anzahl der abgerufenen Suchergebnisse fest (topn-Parameter). - **Suchmodus**: Steuert, welche Versionen bei der Archivsuche angezeigt werden. Mögliche Werte: `Standard` (Speicherkonfiguration), `Alle Versionen`, `Nur neueste Version`. - **Max. Anzahl letzter Mappen**: Legt fest, wie viele der zuletzt archivierten Mappen pro Datensatz in der Infobox "Letzte Archivierungen" angezeigt werden (Standard: 5). ### API - **URL**: Die Basis-URL des angeschlossenen FREEZE-Archivsystems. - **Standardauthentifizierung**: Die OAuth 2.0 Authentifizierung, die standardmäßig für API-Zugriffe verwendet wird. - **Standard Archivspeicher**: Der Speicher, in dem standardmäßig gesucht und archiviert wird. - **Datensätze (Mappen) pro Seite**: Anzahl der Datensätze (Mappen), die pro Seite in den Suchergebnissen angezeigt werden (Standard: 15). - **Alternative PDF-Viewer-URL**: Für On-Premises-Umgebungen mit eingeschränkter Internetverbindung kann hier eine alternative URL zum PDF-Viewer angegeben werden. Dieses Feld ist standardmäßig ausgeblendet. ### Archivierung – Allgemein - **Anhänge archivieren**: Archiviert Anhänge, die in Business Central mit dem entsprechenden Datensatz verknüpft sind. - **Eingehende Belege archivieren**: Archiviert eingehende Belege, die mit dem Datensatz in Business Central verknüpft sind. - **Email & Anhänge archivieren**: Archiviert E-Mail-Anhänge, die über das BC-E-Mail-Modul versendet wurden, z.B. bei gebuchten Belegen, Angeboten oder Aufträgen. ### Archivierung – Einkauf - **Nach Buchung archivieren**: Aktiviert die automatische Archivierung von Einkaufsbelegen nach der Buchung. - **Ausgehende Belege archivieren**: Archiviert zusätzlich die ausgehenden Standardberichte nach der Buchung. Dabei wird die Anzahl der gedruckten Berichte erhöht. - **Einkaufsrechnung**: Archiviert ausgehende Einkaufsrechnungen nach der Buchung. - **Einkaufsgutschrift**: Archiviert ausgehende Einkaufsgutschriften nach der Buchung. - **Einkaufslieferung**: Archiviert ausgehende Einkaufslieferungen nach der Buchung. - **Einkaufs-Rücklieferung**: Archiviert ausgehende Einkaufs-Rücklieferungen nach der Buchung. ### Archivierung – Verkauf - **Nach Buchung archivieren**: Aktiviert die automatische Archivierung von Verkaufsbelegen nach der Buchung. - **Ausgehende Belege archivieren**: Archiviert zusätzlich die ausgehenden Standardberichte nach der Buchung von Verkaufsbelegen. ### Archivierung – Fibu Buch.-Blatt - **Nach Buchung archivieren**: Archiviert das resultierende Sachkontoregister nach der Buchung eines Fibu Buch.-Blattes. # Freeze Speicher Hier werden die Archivspeicher des angeschlossenen Freeze Systems verwaltet. [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677251838583.png) ### Felder - **Name**: Der eindeutige Name des Archivspeichers. - **Beschreibung**: Eine optionale Beschreibung des Archivspeichers. - **API Link**: Die API-URL des Archivspeichers. Diese wird automatisch aus dem FREEZE-System abgerufen. Die Archivspeicher werden automatisch beim Öffnen der Seite aus dem angeschlossenen FREEZE-System synchronisiert. Der als **Standard Archivspeicher** in der Freeze Einrichtung hinterlegte Speicher wird bei Suchen und Archivierungen bevorzugt verwendet. # Dokumentenklassen Einrichtung In der Dokumentenklassen Einrichtung wird die Zuordnung zwischen der jeweiligen Dokumentenklasse und Ihrer Exportschnittstelle vorgenommen. Des Weitern wird hier die Feldzuordnung jeder Dokumentenklasse heruntergeladen und so ein Set an Standard Feldern und deren Verwendung in Microsoft Dynamics 365 Business Central hergestellt. Die [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/dexpro-business-central-apps/page/dokumentenklassen-einrichtung) ist App übergreifend und wird über den DEXPRO Core verwaltet. ### Vorgang [](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646811835555.png) #### Feldzuordnung herunterladen Hiermit wird die Feldstruktur der SQUEEZE Dokumentenklasse heruntergeladen. Diese werden für die [Metadaten-Zuordnung](#bkmrk-metadaten-zuordnung) benötigt. ### Navigation [](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646811861396.png) #### Metadaten-Zuordnung Über diesen Menüpunkt erreichen Sie die [Metadaten-Zuordnung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-admin-handbuch/page/metadaten-zuordnung). In dieser wird definiert welche Felder wie an Microsoft Dynamics 365 Business Central übertragen werden sollen. ### Liste #### Dokumentenklassen In dieser Übersicht werden alle eingerichteten Dokumentenklassen aufgelistet. [](https://docs.squeeze.one/uploads/images/gallery/2022-12/image-1671447413471.png) ### Karte #### Dokumentenklasse Hier wird jede Dokumentenklasse individuell eingerichtet. ### Allgemein [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677144005353.png) In diesem Fastab wird der Name der Dokumentenklasse, der nächste Prozessschritt, sowie die automatische Anreicherung der Positionen eingerichtet. ### Freeze [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677144317341.png) Hier legt man die Standard Suchmaske fest. # Benutzer Einrichtung [](https://docs.squeeze.one/uploads/images/gallery/2024-04/image-1713950749222.png) **Alternative Authentifizierung:** Sollen Benutzer mit einer alternativen Authentifizierung auf das Archiv zugreifen, kann diese hier hinterlegt werden. **Alle Ergebnisse anzeigen:** Die zusätzlichen Suchabfragen (genauso wie die Volltextsuche) liefern nur für Benutzer Ergebnisse, die explizit dazu berechtigt wurden. Das ist notwendig, da bei Archivmappen, die nicht über BC archiviert wurden, mangels Tabellennummer keine Prüfung der effektiven Berechtigungen stattfinden kann. # OAuth 2.0 Einrichtung Hier werden die OAuth 2.0 / Open Id User und deren Access Token verwaltet. [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677251925318.png) # Zusätzliche Suchabfragen #### Erstellung von zusätzlichen Suchabfragen Im Folgenden habe ich eine Query erstellt, die an die Systemsuchabfrage angehängt wird, wenn man über einen Record (hier: Kreditorenposten - Tabelle 25) Freeze öffnet. *Suchabfragen mit der gleichen Tabellennr. werden ODER-verknüpft.* [](https://docs.squeeze.one/uploads/images/gallery/2024-04/image-1713949959929.png) #### Erstellung von Suchabfrage Zeilen Über **Zugehörig** gelangen Sie zu den Abfragezeilen: [](https://docs.squeeze.one/uploads/images/gallery/2024-04/image-1713950060135.png) [](https://docs.squeeze.one/uploads/images/gallery/2024-04/image-1713950065052.png) **Suche nach Feldname** - Gibt den Wert des Feldnamens an, der für die Suchabfrage verwendet werden soll. Das sind zum einen die nativen Felder der Archivsoftware, zum anderen aber auch in beliebiger Form gespeicherte Datensatzfelder: **Suchwert Quelle (Feldnr.)** - Gibt den Wert an, nach dem in Kombination mit dem Feldnamen gesucht werden soll. **Fester Suchwert** - Der feste Suchbegriff wird anstelle des Suchwertes benutzt. *Die Abfragezeilen sind UND-verknüpft.* #### Anzeige des Ergebnisses Öffne man im Anschluss aus den Kreditorenposten Freeze... [](https://docs.squeeze.one/uploads/images/gallery/2024-04/image-1713950593376.png) ...erhält man das gewünschte Suchergebnis: [](https://docs.squeeze.one/uploads/images/gallery/2024-04/image-1713950552409.png) Nicht vergessen: Die zusätzlichen Suchabfragen (genauso wie die Volltextsuche) liefern nur für Benutzer Ergebnisse, die in der [Einrichtung](https://docs.squeeze.one/books/freeze-for-dynamics-365-bc-de-de/page/benutzer-einrichtung "Benutzer Einrichtung") explizit dazu berechtigt wurden. Das ist notwendig, da bei Archivmappen, die nicht über BC archiviert wurden, mangels Tabellennummer keine Prüfung der effektiven Berechtigungen stattfinden kann. # Mappentypen Mappentypen (englisch: Record Types) definieren die Kategorisierung der Archivmappen in FREEZE. Jeder archivierte Datensatz bekommt einen Mappentyp zugewiesen, über den später gefiltert und gesucht werden kann. ### Verfügbare Mappentypen - **Verschiedenes** – Standardtyp für allgemeine Dokumente - **Angebote** - **Aufträge** - **Rahmenaufträge** - **Reklamationen** - **Rechnungen** - **Gutschriften** - **Zahlungen** - **Mahnungen (Zinsrechnungen)** - **Mahnungen** - **Erstattungen** - **Verträge** - **Ansprüche** ### Einrichtung In der Seite **Freeze Mappentyp** können Sie für jeden Mappentyp festlegen, ob er als **Standard** für bestimmte Belegtabellen verwendet wird. So wird beim automatischen Archivieren der passende Mappentyp automatisch zugewiesen. Beim manuellen Archivieren (Quick Freeze) wird dem Benutzer ein Dialog angezeigt, in dem er den Mappentyp, die Mappenbezeichnung und das Bezugsdatum festlegen kann. ### Infobox: Anzahl pro Mappentyp Auf der Suchergebnis-Seite zeigt die Infobox **Anzahl pro Mappe** an, wie viele Archivmappen pro Mappentyp für den aktuellen Datensatz vorhanden sind. # Anwendung / Nutzung # Archivsuche von Belegen ### Freeze Suchmaske Die Freeze Suchmaske ermöglich eine Volltextsuche sowie eine Suche auf Basis von Tabellenfeldern gemäß der [Apache Lucene-Syntax](#bkmrk-apache-lucene-syntax). Außerdem ist es möglich, Ergebnisse für bestimmte Zeiträume anzuzeigen. [](https://docs.squeeze.one/uploads/images/gallery/2024-03/image-1710160654346.png) ##### 1. Volltextsuche Eine freie Suche gemäß [Apache Lucene-Syntax](#bkmrk-apache-lucene-syntax). ##### 2. Mappentyp-Filter Sie können hier die Ergebnisse nach Mappentyp filtern (z.B. Rechnungen). Dieser Filter wird in Kombination mit den anderen Suchparametern angewendet. ##### 3. Datum-Filter Der Datum-Filter ermöglich die Eingrenzung der Ergebnisse nach Archivierungs- bzw. Bezugsdatum. ##### 4. Tabellensuchmaske Wählen Sie an dieser Stelle eine beliebige Tabelle, deren Struktur die als Suchmaske verwenden möchten. Die Tabellennummer ist anschließend Teil der Suche. ##### Apache Lucene-Syntax Eine Abfrage ist in Begriffe und Operatoren unterteilt. Es gibt zwei Arten von Begriffen: Einzelne Begriffe und Phrasen. Ein einzelner Begriff ist ein einzelnes Wort wie "test" oder "hallo". Eine Phrase ist eine Gruppe von Wörtern, die von doppelten Anführungszeichen umgeben sind, wie z. B. "hello dolly". Mehrere Begriffe können mit Booleschen Operatoren kombiniert werden, um eine komplexere Abfrage zu bilden. Die folgenden booleschen Operatoren werden unterstützt: AND, OR und NOT. Die Abfrage "hello AND world" gibt zum Beispiel Dokumente zurück, die sowohl die Wörter "hello" als auch "world" enthalten. Die folgenden Zeichen müssen in einer Abfrage mit Escapezeichen versehen werden: + - && || ! ( ) { } \[ \] ^ " ~ \* ? : \\ Um ein Zeichen zu umgehen, setzen Sie einfach einen Backslash (\\) vor das Zeichen. Wildcards können verwendet werden, um nach Wörtern zu suchen, die eine bestimmte Zeichenfolge enthalten. Das Sternchen (\*) steht für null oder mehr Zeichen, während das Fragezeichen (?) für genau ein Zeichen steht. Die Abfrage "te?t" zum Beispiel gibt Dokumente zurück, die Wörter wie "test", "text" und "tent" enthalten. ### Datensatzbasierte Suche Die datensatzbasierte Suche wird immer dann ausgeführt, wenn Sie Freeze über einen in BC gespeicherten Datensatz öffnen (Menüpunkt "DEXPRO Freeze" oder Tastenkombination STRG+ALT+F). Hier am Beispiel eines Kreditors: [](https://docs.squeeze.one/uploads/images/gallery/2024-03/image-1710161648319.png) Typische Absprungpunkte: - Debitoren - Kreditoren - Artikel - Einkaufsbelege - Verkaufsbelege - Gebuchte Belege - Fibu-Journale - Posten # Archivierung von Belegen Archiviert werden kann... ### Archivierung nach der Buchung Wenn in der **Freeze Einrichtung** die Option **Nach Buchung archivieren** im jeweiligen Bereich (Einkauf, Verkauf, Fibu Buch.-Blatt) aktiviert ist, werden die zugehörigen Belege automatisch nach der Buchung archiviert. Dies umfasst: - EK-Rechnungen, EK-Gutschriften, EK-Lieferungen, EK-Rücklieferungen - VK-Belege - Fibu Buch.-Blätter (das resultierende Sachkontoregister wird archiviert) ### Archivierung von ausgehenden Belegen Wenn **Ausgehende Belege archivieren** aktiviert ist, werden die Standardberichte (z.B. gedruckte Rechnungen) nach der Buchung archiviert. Die Anzahl der gedruckten Berichte wird dabei erhöht. ### Archivierung von E-Mails Wenn **Email & Anhänge archivieren** aktiviert ist, werden E-Mail-Anhänge, die über das BC-E-Mail-Modul versendet werden, automatisch archiviert. Dies gilt für gebuchte Belege sowie für Angebote und Aufträge. ### Archivierung von eingehenden Belegen Wenn **Eingehende Belege archivieren** aktiviert ist, werden eingehende Belege, die mit einem Datensatz in Business Central verknüpft sind, archiviert. ### Archivierung von verknüpften Anhängen Wenn **Anhänge archivieren** aktiviert ist, werden alle Anhänge innerhalb von Business Central, die mit dem Datensatz verknüpft sind, archiviert. ### Manuelle Archivierung (Quick Freeze) Auf den meisten Belegen und Stammdatenseiten steht die Aktion **Quick Freeze** als Infobox (FactBox) zur Verfügung. Damit können Benutzer Dateien per Drag-and-Drop oder über den Upload-Dialog manuell archivieren. Die Dateien werden direkt dem aktuellen Datensatz im Archiv zugeordnet. # Freeze Warteschlange und Job Hier werden alle Archivierungsvorgänge aufgelistet und durch die Codeunit "70954898 DXP Freeze Queue Processing" verarbeitet. Diese Codeunit muss regelmäßig als Aufgabewarteschlangenposten ausgeführt werden: [](https://docs.squeeze.one/uploads/images/gallery/2024-12/image-1733130684685.png) [](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677252089966.png) ### Felder der Warteschlange - **Lfd. Nr.**: Fortlaufende Nummer des Warteschlangeneintrags. - **Mappenbezeichnung**: Titel des zu archivierenden Datensatzes. - **Mappentyp**: Der Typ der Archivmappe (z.B. Rechnung, Gutschrift, Verschiedenes). - **Status**: Der aktuelle Status des Eintrags: - `Neu` – Eintrag wurde erstellt, aber noch nicht verarbeitet. - `In Bearbeitung` – Eintrag wird gerade verarbeitet. - `Abgeschlossen` – Archivierung war erfolgreich. - `Fehler` – Ein Fehler ist aufgetreten. - **Fehlerhinweis**: Kurze Fehlerbeschreibung bei fehlgeschlagener Archivierung. - **Letzter detaillierter Fehler**: Vollständige Fehlermeldung mit Details. - **Wiederholungsversuch**: Anzahl der bisherigen Wiederholungsversuche. - **Bezugsdatum**: Das Bezugsdatum, unter dem der Datensatz im Archiv gespeichert wird. - **Anzahl der Anhänge passt nicht**: Zeigt an, ob die Anzahl der lokalen Anhänge mit der Anzahl im Archiv übereinstimmt. ### Aufgabenwarteschlangenposten einrichten Die Codeunit `70954898 DXP Freeze Queue Processing` muss als Aufgabenwarteschlangenposten eingerichtet werden, um die Warteschlangeneinträge automatisch zu verarbeiten. Empfohlene Einstellungen: - **Objekttyp**: Codeunit - **Objekt-ID**: 70954898 - **Wiederholungsintervall**: 2 Minuten (empfohlen) # Schnellarchivierung (Quick Freeze) Die **Quick Freeze** Infobox (FactBox) ermöglicht das manuelle Archivieren von Dateien direkt aus Belegen und Stammdatenseiten heraus. ### Funktionsweise 1. Öffnen Sie einen Beleg oder eine Stammdatenseite (z.B. Einkaufsrechnung, Debitorenkarte, Kreditorenkarte). 2. Nutzen Sie die Infobox **Quick Freeze** auf der rechten Seite: - Ziehen Sie Dateien per **Drag-and-Drop** in den markierten Bereich, oder - Klicken Sie auf **Datei hochladen**, um Dateien über den Dateiauswahl-Dialog auszuwählen. 4. Es öffnet sich ein Dialog, in dem Sie folgende Angaben machen können: - **Mappentyp**: Typ der Archivmappe (z.B. Rechnung, Gutschrift). - **Mappenbezeichnung**: Ein optionaler benutzerdefinierter Titel. - **Bezugsdatum**: Datum, unter dem der Datensatz gespeichert wird (Standard: Arbeitsdatum). 6. Die Dateien werden in die Freeze-Warteschlange eingestellt und im Hintergrund archiviert. ### Verfügbarkeit Die Quick Freeze Infobox ist auf allen Seiten verfügbar, auf denen die Freeze Page Extensions aktiv sind. Dies umfasst: - Einkaufsbelege: Bestellungen, Rechnungen, Gutschriften, Reklamationen, Angebote - Verkaufsbelege: Aufträge, Rechnungen, Gutschriften, Reklamationen, Angebote - Gebuchte Belege: Geb. EK-Rechnungen, Geb. EK-Lieferungen, Geb. VK-Rechnungen, Geb. VK-Lieferungen, usw. - Stammdaten: Debitorkarte, Kreditorkarte, Artikelkarte - Posten: Debitorenposten, Kreditorenposten, Sachposten, Sachkontoregister - Fibu Buch.-Blätter # PDF-Viewer Der integrierte **PDF-Viewer** ermöglicht die Anzeige von PDF-Anhängen direkt in Business Central, ohne die Anwendung zu verlassen. ### Funktionen - **Infobox (FactBox)**: Der PDF-Viewer wird als Infobox auf der Suchergebnis-Seite angezeigt. Beim Auswählen eines Anhangs wird das PDF direkt in der Infobox dargestellt. - **Vollbild-Ansicht**: Über die Vollbild-Seite kann ein PDF in größerer Ansicht betrachtet werden. - **Alternative PDF-Viewer-URL**: Für On-Premises-Umgebungen mit eingeschränkter Internetverbindung kann in der Freeze Einrichtung eine alternative URL zum PDF-Viewer hinterlegt werden. ### Unterstützte Dateiformate Der PDF-Viewer zeigt PDF-Dateien direkt an. Für andere Dateiformate kann in der Freeze Einrichtung ein Platzhalter-PDF hochgeladen werden, das anstelle der nicht darstellbaren Datei angezeigt wird. # Letzte Archivierungen Die Infobox **Zuletzt archivierte Mappen** zeigt die letzten Archivierungen an, die für den aktuell geöffneten Datensatz durchgeführt wurden. ### Angezeigte Informationen - **Titel**: Die Mappenbezeichnung des archivierten Datensatzes. - **Art**: Der Mappentyp (z.B. Rechnung, Gutschrift). - **Version**: Die Versionsnummer des Archivdatensatzes. - **Erstellt am**: Datum und Uhrzeit der Archivierung. ### Konfiguration Die maximale Anzahl angezeigter Einträge kann über das Feld **Max. Anzahl letzter Mappen** in der **Freeze Einrichtung** gesteuert werden (Standard: 5). ### Navigation Durch Klicken auf einen Eintrag wird die Archivmappe direkt im Freeze-Suchergebnis geöffnet, sodass die zugehörigen Anhänge und Felder eingesehen werden können. # Seitenerweiterungen Freeze erweitert zahlreiche Standard-Seiten in Business Central um Archivfunktionen. Auf jeder erweiterten Seite stehen folgende Funktionen zur Verfügung: ### Verfügbare Aktionen - **Freeze öffnen**: Öffnet die Freeze-Archivsuche im Kontext des aktuellen Datensatzes. Die Suche verwendet automatisch die passenden Felder (z.B. Belegnummer, Kreditor, Debitor) als Suchkriterien. - **Freeze Historie**: Zeigt die Archivhistorie des Datensatzes an, inklusive aller Versionen. ### Verfügbare Infoboxen (FactBoxes) - **Quick Freeze**: Ermöglicht das manuelle Hochladen und Archivieren von Dateien per Drag-and-Drop. - **Zuletzt archivierte Mappen**: Zeigt die letzten Archivierungen für den aktuellen Datensatz. - **Anzahl pro Mappentyp**: Zeigt die Anzahl der Archivmappen pro Mappentyp. ### Erweiterte Seiten #### Einkauf - Einkaufsbestellung / Einkaufsbestellungen - Einkaufsrechnung / Einkaufsrechnungen - Einkaufsgutschrift / Einkaufsgutschriften - Einkaufsangebot / Einkaufsangebote - Einkaufsreklamation / Einkaufsreklamationen - Geb. Einkaufsrechnung / Geb. Einkaufsrechnungen - Geb. Einkaufslieferung / Geb. Einkaufslieferungen - Geb. Einkaufsgutschrift / Geb. Einkaufsgutschriften - Geb. Rücklieferung / Geb. Rücklieferungen #### Verkauf - Verkaufsauftrag / Verkaufsaufträge - Verkaufsrechnung / Verkaufsrechnungen - Verkaufsgutschrift / Verkaufsgutschriften - Verkaufsangebot / Verkaufsangebote - Verkaufsreklamation / Verkaufsreklamationen - Geb. Verkaufsrechnung / Geb. Verkaufsrechnungen - Geb. Verkaufslieferung / Geb. Verkaufslieferungen - Geb. Verkaufsgutschrift / Geb. Verkaufsgutschriften - Geb. Rücknahme / Geb. Rücknahmen #### Stammdaten - Debitorenkarte / Debitorenliste - Kreditorenkarte / Kreditorenliste - Artikelkarte / Artikelliste #### Posten & Register - Debitorenposten - Kreditorenposten - Sachposten - Sachkontoregister - Fibu Buch.-Blatt # Extension Entwicklung In diesem Kapitel werden Anwendungsfälle aufgeführt, die bei der Entwicklung einer Extension für Freeze for BC helfen. Dies sind in der Regel Beispiele, die einer Notwendigkeit im Produktivbetrieb eines Partners oder Kunden entwachsen sind. Wichtig: Anpassungen dürfen nur durch entsprechend geschulte Berater/Entwickler durchgeführt werden. Diese befinden sich außerdem immer außerhalb des Standard-Supports. # Archivieren von Dateien Freeze archiviert, abhängig von der Einrichtung, in verschiedenen Situationen automatisch (z.B. nach dem Buchen von Verkaufs- oder Einkaufsbelegen). Im Folgenden wird erläutert, welche Prozeduren ein Entwickler aufrufen kann, um das Archivieren einer Mappe inkl. Dateianhänge zu initiieren. Angenommen, Sie möchten eine neue Archivmappe mit einer oder mehreren Datei(en) archivieren. Zunächst fügen Sie dem temporären Record des Typs "DXP FRZ Attachment Buffer" die entsprechenden Werte hinzu, die ihren Dateien entsprechend. Zur Vereinfachung empfehlen wir die Nutzung der folgenden Prozedur: **codeunit 70954897 "DXP FRZ Attachment Mgt.":** ```PASCAL procedure AddFileFromStream(var TempFRZAttachmentBuffer: Record "DXP FRZ Attachment Buffer" temporary, var InStr: InStream, FileName: Text) ``` Anschließend rufen sie die folgende Prozedur auf, um einen Eintrag in der Freeze Verarbeitungswarteschlange zu erstellen, der Mappendetails und Anhänge enthält, die zur Erstellung des Archiveintrags verwendet werden.| Parameter | Typ | Beschreibung |
|---|---|---|
| `SearchQuery` | Text | Freeze-Suchanfrage-String. Wenn leer in vorab gefüllter Überladung, verwendet vorhandene Anfrage oder führt Suche erneut aus |
| `ZipArchive` | Codeunit “Data Compression” | ZIP-Archiv-Objekt, das die heruntergeladenen Dateien enthalten wird |
| `AttachmentCount` | Integer (var) | Gibt die Gesamtanzahl der heruntergeladenen Anhänge zurück |
| `FilenameFilter` | Text | Filter für Anhangsdateinamen (z.B. ‘*.pdf’, 'rechnung*’) |
| `FileExtensionFilter` | Text | Filter für Dateierweiterungen (z.B. ‘pdf’, ‘docx’) |
| `StoreApiLink` | Text | Optional spezifischer Store-API-Link |
| `RecordsPerPage` | Integer | Anzahl Datensätze pro Seite (Standard: 100) |
| `SuppressDialog` | Boolean | Ob Fortschrittsdialog unterdrückt werden soll |
| Parameter | Typ | Beschreibung |
|---|---|---|
| `SelectedRecord` | RecordRef (var) | RecordRef mit den ausgewählten Business Central Datensätzen |
| `ZipArchive` | Codeunit “Data Compression” | ZIP-Archiv-Objekt, das die heruntergeladenen Dateien enthalten wird |
| `FilenameFilter` | Text | Filter für Anhangsdateinamen |
| `FileExtensionFilter` | Text | Filter für Dateierweiterungen |
| Parameter | Typ | Beschreibung |
|---|---|---|
| `RecordHeaderID` | Guid | Eindeutige ID des Freeze-Datensatzes |
| `RecordHeaderFileLink` | Text\[2048\] | API-Link zum Datensatz (aus `DXP FRZ Record Result Header`."File Link") |
| `TempFrzAttachmentResult` | Record (temporary, var) | Temporärer Record, der mit Anhang-Metadaten gefüllt wird |
| `ClearAttachmentTable` | Boolean | `true` = Record vor Befüllung löschen; `false` = zu bestehenden Einträgen hinzufügen |
| Feld | Beschreibung |
|---|---|
| `ID` | Eindeutige Anhang-ID (Guid) |
| `Record Header Id` | Verknüpfung zum übergeordneten Datensatz |
| `Filename` | Dateiname mit Erweiterung |
| `File Extension` | Dateierweiterung (automatisch aus Filename extrahiert) |
| `Filesize` | Größe in Bytes |
| `Author` | Ersteller des Anhangs |
| `Archived at` | Archivierungszeitpunkt |
| `File Link` | API-Link zum Datensatz |
| Parameter | Typ | Beschreibung |
|---|---|---|
| `FileLink` | Text | API-Link zum Datensatz (aus `TempFrzAttachmentResult`."File Link") |
| `AttachmentID` | Guid | Eindeutige Anhang-ID (aus `TempFrzAttachmentResult`.ID) |
| `pFileName` | Text | Dateiname für Download (aus `TempFrzAttachmentResult`.Filename) |
| `DownloadFromStream` | Boolean | `true` = Sofortiger Browser-Download; `false` = Nur Base64 zurückgeben |