# Squeeze4NAV Installation & Administration

# Voraussetzungen



# Unterstütze Dynamics NAV / BC Versionen

Die Microsoft Dynamics NAV Integration ist auf Grund von technischen Mindestvoraussetzungen nur bei den folgenden Versionen möglich:

- Microsoft Dynamics NAV 2018
- Microsoft Business Central 14 on prem

Voraussetzung hierbei ist, dass die jeweilige Microsoft Dynamics NAV Version sich noch im regulären Support befindet. Der erweiterte Support (extended Support) wird ausgeschlossen.

Bei der aktuellen Lösung wird ausschließlich der Role Tailored Client (RTC) für die Integration unterstützt.   
Die Integration ist <span style="text-decoration: underline;">nicht</span> mit dem Web Client kompatibel.

Ältere Versionen sind auf Grund der in Dynamics NAV eingesetzten TLS Version nicht mehr möglich!

# Dynamics NAV AddIns

Es werden folgende AddIns mit ausgeliefert:

- DEXPRO\_Solutions.dll
- SOAPWebServiceConnector.dll

Die DEXPRO\_Solutions.dll muss sowohl Client-seitig als auch Server-seitig in das Add-Ins Verzeichnis von der installierten Dynamics NAV Version kopiert werden. Die andere muss lediglich server-seitig abgelegt werden.

# Dynamics NAV Instanz für den Web Service Zugriff

Damit Squeeze an Dynamics NAV angeschlossen werden kann, muss eine Dynamics NAV Instanz hierfür vorbereitet werden.

Die Schritte hierfür werden in den Kapiteln "Dynamics NAV Instanz Einrichtung" und "SOAP" der Web Services beschrieben: [Web Service Kapitel](https://docs.squeeze.one/books/web-services/page/voraussetzungen#bkmrk-dynamics-nav-instanz)

# Dynamics NAV Objekte

Es werden folgende Dynamics NAV Objekte mit ausgeliefert. Diese müssen über den Dynamics NAV Partner zusätzlich lizensiert werden. Die Standard Objekte werden lediglich um Felder erweitert.

<table id="bkmrk-type-id-name-%C3%84nderun" style="height: 1549px;" width="664"><tbody><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Type</td><td style="height: 29px; width: 80px;">ID</td><td style="height: 29px; width: 203px;">Name</td><td style="height: 29px; width: 301px;">Änderung</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">23</td><td style="height: 29px; width: 203px;">Vendor</td><td style="height: 29px; width: 301px;">Neue/s Feld(er)</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">288</td><td style="height: 29px; width: 203px;">Vendor Bank Account</td><td style="height: 29px; width: 301px;">Neue/s Feld(er)</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">9054</td><td style="height: 29px; width: 203px;">Finance Cue</td><td style="height: 29px; width: 301px;">Neue/s Feld(er)</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80650</td><td style="height: 29px; width: 203px;">DEXPRO Validation Header</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80651</td><td style="height: 29px; width: 203px;">DEXPRO Validation Position</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80652</td><td style="height: 29px; width: 203px;">Squeeze MasterData</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80653</td><td style="height: 29px; width: 203px;">Squeeze MD Field Mapping</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80654</td><td style="height: 29px; width: 203px;">DEX Table Link</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Table</td><td style="height: 45px; width: 80px;">80655</td><td style="height: 45px; width: 203px;">DEXPRO Line Comparison Head</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80656</td><td style="height: 29px; width: 203px;">Blob File Management</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80657</td><td style="height: 29px; width: 203px;">Invoice Fields Alternatives</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80658</td><td style="height: 29px; width: 203px;">DEXPRO Line Comparison Pos</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80659</td><td style="height: 29px; width: 203px;">Export File</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80660</td><td style="height: 29px; width: 203px;">Export File Field Mapping</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80661</td><td style="height: 29px; width: 203px;">File Pos Grid</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80662</td><td style="height: 29px; width: 203px;">Custom Field Translation</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Table</td><td style="height: 29px; width: 80px;">80670</td><td style="height: 29px; width: 203px;">DEXPRO Setup</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Report</td><td style="height: 29px; width: 80px;">80650</td><td style="height: 29px; width: 203px;">DEXPRO Background Job</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Report</td><td style="height: 29px; width: 80px;">80651</td><td style="height: 29px; width: 203px;">Squeeze Master Data Job</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Codeunit</td><td style="height: 45px; width: 80px;">80650</td><td style="height: 45px; width: 203px;">DEXPRO Squeeze Invoice Mgt.</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Codeunit</td><td style="height: 29px; width: 80px;">80651</td><td style="height: 29px; width: 203px;">Squeeze Management</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Codeunit</td><td style="height: 29px; width: 80px;">80652</td><td style="height: 29px; width: 203px;">File Handling Management</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Codeunit</td><td style="height: 45px; width: 80px;">80653</td><td style="height: 45px; width: 203px;">DEXPRO Mapping Management</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Codeunit</td><td style="height: 29px; width: 80px;">80654</td><td style="height: 29px; width: 203px;">DEXPRO Inv Master Data Sync</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">XMLPort</td><td style="height: 29px; width: 80px;">80650</td><td style="height: 29px; width: 203px;">DEXPRO Invoice Structure</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">9030</td><td style="height: 29px; width: 203px;">Account Manager Activities</td><td style="height: 29px; width: 301px;">Einbindung neuer Felder</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">9036</td><td style="height: 29px; width: 203px;">Bookkeeper Activities</td><td style="height: 29px; width: 301px;">Einbindung neuer Felder</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80650</td><td style="height: 29px; width: 203px;">DEXPRO Validation List</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80651</td><td style="height: 29px; width: 203px;">DEXPRO Validation Header</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80652</td><td style="height: 29px; width: 203px;">DEXPRO Validation Positions</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80653</td><td style="height: 29px; width: 203px;">DEX Line Comparison Header</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Page</td><td style="height: 45px; width: 80px;">80654</td><td style="height: 45px; width: 203px;">Squeeze Master Data Mapping</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80655</td><td style="height: 29px; width: 203px;">Squeeze MD Field Mapping</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Page</td><td style="height: 45px; width: 80px;">80656</td><td style="height: 45px; width: 203px;">Squeeze Master Data Overview</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80657</td><td style="height: 29px; width: 203px;">DEX Table Link</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Page</td><td style="height: 45px; width: 80px;">80658</td><td style="height: 45px; width: 203px;">DEX Line Comparison SQZ Pos</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80659</td><td style="height: 29px; width: 203px;">BrowserControl</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Page</td><td style="height: 45px; width: 80px;">80660</td><td style="height: 45px; width: 203px;">DEX Line Comparison Positions</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 45px;"><td style="height: 45px; width: 80px;">Page</td><td style="height: 45px; width: 80px;">80661</td><td style="height: 45px; width: 203px;">DEX Line Comparison Overview</td><td style="height: 45px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80662</td><td style="height: 29px; width: 203px;">Export File Overview</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80663</td><td style="height: 29px; width: 203px;">Export File Card</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80664</td><td style="height: 29px; width: 203px;">Export Mapping Fields</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80665</td><td style="height: 29px; width: 203px;">Export Position Grid</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80666</td><td style="height: 29px; width: 203px;">Alternative Values List</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80667</td><td style="height: 29px; width: 203px;">DEX Table Overview</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80668</td><td style="height: 29px; width: 203px;">DEX Field Overview</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80669</td><td style="height: 29px; width: 203px;">Custom Field Translations</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 80px;">Page</td><td style="height: 29px; width: 80px;">80670</td><td style="height: 29px; width: 203px;">DEXPRO Setup</td><td style="height: 29px; width: 301px;">Neues Objekt</td></tr></tbody></table>

### Anmeldung

Für das Einspielen und Bearbeiten der Objekte wird eine Anmeldung benötigt. Dieser User benötigt eine CRUD Berechtigung (Erstellen, Lesen, Modifizieren &amp; Löschen) in Dynamics NAV und der dazugehörigen SQL Datenbank.

# Einspielen / Anpassen der Dynamics NAV Objekte

Das Einspielen und Anpassen der Dynamics NAV Objekte erfordert einen Zugang zum Entwicklungssystem (Development Environment) und der genutze Account benötigt ausreichend Rechte um CRUD Funktionen auszuführen. Diese müssen sowohl SQL-seitig für die NAV Datanbank eingerichtet sein, als auch Software-seitig innerhalb Dynamics NAV.

# Einspielen der Squeeze4NAV Objekte

In der Entwicklungsumgebung wird die FOB-Datei mit den Squeeze4NAV Objekten über den Object Designer eingespielt. Bei der Auswahl der zu importierenden Objekte betrachten wir in diesem Abschnitt nur die neuen Squeeze4NAV Objekte (IDs zwischen 80650 - 80670) und nicht die Änderungen an den Standard Objekten.

Beim Import Worksheet werden alle Objekte aus der FOB-Datei aufgelistet. In der Spalte "Action" steht die vorgeschlagene Aktion für den Import. Dies muss bei den Squeeze4NAV Objekten (80650 - 80670) "Create" sein. Sollte dies nicht der Fall sein und dieser Objektbereich schon anderweitig belegt sein, so muss dies durch den NAV Partner des Kunden geklärt werden.

[![image-1618216705424.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618216705424.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618216705424.png)

Im ersten Schritt muss entweder die Action bei den NAV Standard Objekten manuell auf "Skip" oder ein Filter auf die Squeeze4NAV Objekte gesetzt werden. So wird sichergestellt, dass auch nur diese importiert werden.

Mit einem Klick auf "OK" wird der Importvorgang durchgeführt.

# Anpassen der Dynamics NAV Standard Objekte

Die Squeeze4NAV FOB-Datei beinhaltet auch Änderungen an Dynamics NAV Standard Objekten.

Diese müssen von einem Dynamics NAV Entwickler, vorzugsweise von dem Dynamics NAV Partner des Kunden, eingespielt werden.

Die Änderungen im Überblick:

<table border="1" id="bkmrk-type-id-name-%C3%84nderun" style="border-collapse: collapse; width: 100%; height: 238px;"><tbody><tr style="height: 29px;"><td style="width: 16.6667%; height: 29px;">Type</td><td style="width: 16.6667%; height: 29px;">ID</td><td style="width: 16.6667%; height: 29px;">Name</td><td style="width: 27.9268%; height: 29px;">Änderung</td><td style="width: 15.8624%; height: 29px;">optional</td></tr><tr style="height: 29px;"><td style="width: 16.6667%; height: 29px;">Table</td><td style="width: 16.6667%; height: 29px;">23</td><td style="width: 16.6667%; height: 29px;">Vendor</td><td style="width: 27.9268%; height: 29px;">neues Feld 80700 "Squeeze ID" vom Typ Integer</td><td style="width: 15.8624%; height: 29px;">nein</td></tr><tr style="height: 45px;"><td style="width: 16.6667%; height: 45px;">Table</td><td style="width: 16.6667%; height: 45px;">288</td><td style="width: 16.6667%; height: 45px;">Vendor Bank Account</td><td style="width: 27.9268%; height: 45px;">neues Feld 80700 "Squeeze ID" vom Typ Integer</td><td style="width: 15.8624%; height: 45px;">nein</td></tr><tr style="height: 29px;"><td style="width: 16.6667%; height: 29px;">Table</td><td style="width: 16.6667%; height: 29px;">9054</td><td style="width: 16.6667%; height: 29px;">Finance Cue</td><td style="width: 27.9268%; height: 29px;">neues Feld 80650 "Actual Docs for Validation" vom Typ Integer</td><td style="width: 15.8624%; height: 29px;">ja</td></tr><tr style="height: 61px;"><td style="width: 16.6667%; height: 61px;">Page</td><td style="width: 16.6667%; height: 61px;">9030</td><td style="width: 16.6667%; height: 61px;">Account Manager Activities</td><td style="width: 27.9268%; height: 61px;">neue CueGroup "Squeeze" + einbinden des neuen Feldes</td><td style="width: 15.8624%; height: 61px;">ja</td></tr><tr style="height: 45px;"><td style="width: 16.6667%; height: 45px;">Page</td><td style="width: 16.6667%; height: 45px;">9036</td><td style="width: 16.6667%; height: 45px;">Bookkeeper Activities</td><td style="width: 27.9268%; height: 45px;">neue CueGroup "Squeeze" + einbinden des neuen Feldes</td><td style="width: 15.8624%; height: 45px;">ja</td></tr></tbody></table>

Diese Änderungen können über das Import Worksheet mit "Merge: Existing -&gt; new" importiert werden. Hierbei werden allerdings die Versionsliste und der Dokumentationsbereich dieser Objekte ebenfalls überschrieben. Dieses darf bei vorhandenen kundenspezifischen Änderungen oder Branchenlösungen nicht durchgeführt werden!

[![image-1618218590226.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618218590226.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618218590226.png)

Besser ist ein manueller Merge der aufgelisteten Anpassungen. Dies darf aber nur von Fachpersonal ausgeführt werden.

# Einrichtung

Um die Einrichtung des Squeeze4NAV Moduls vorzunehmen wird ein Dynamics NAV Client mit berechtigtem User benötigt.

# DEXPRO Squeeze Einrichtung

[![image-1618220502899.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618220502899.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618220502899.png)

1. Die DEXPRO Einrichtung (Page 80670) ausführen und auf "Neu" klicken, um einen neuen Datensatz anzulegen.
2. "Squeeze verwenden" anklicken um die weiteren Felder einzublenden und das Modul grundsätzlich zu aktivieren.
3. Squeeze Host eintragen
4. Squeeze Benutzer und Passwort hinterlegen
5. Über die Schaltfläche "Verbindung testen" die Verbindung zum Squeeze System prüfen. Hierdurch wird auch die verwendete Squeeze Version ins Feld eingetragen.
6. Einen API Namen eintragen und auf die Schaltfläche "Squeeze Schlüssel holen" klicken. Hierdurch wird ein API Key generiert. Im Anschluss können die Felder "Squeeze Benutzer" und "Squeeze Passwort" geleert werden.
7. Schaltfläche "Squeeze Stammdaten Mapping" ausführen und einrichten. Dies wird [hier](https://docs.squeeze.one/books/squeeze4nav-installation/page/squeeze-stammdatenmapping) beschrieben.
8. Schaltfläche "Export Mapping" ausführen und einrichten. Dies wird [hier](https://docs.squeeze.one/books/squeeze4nav-installation/page/export-mapping) beschrieben.
9. Feld "Stammdaten synchronisieren" anhaken.
10. Schaltfläche "Kreditoren zu Squeeze übertragen" anklicken, um das erste mal die Kreditoren zu Squeeze zu übertragen. Diese Funktion darf nur am Anfang einmalig ausgeführt werden.

### Weitere Funktionen

- "Aktive Squeeze Mandanten auslesen": Hier werden alle Mandanten angezeigt, welche derzeit an Squeeze angeschlossen sind.
- "Einrichtung kopieren": Hiermit kann die DEXPRO Einrichtung, das Squeeze Stammdaten Mapping und das Export Mapping in einen anderen Mandanten kopiert werden.

### Weitere Felder

- "Zusammengefasste Ansicht verwenden": Dies aktiviert eine zusammengefasste Validierungsansicht.
- "Dokumente per Job aufräumen": Hierdurch wird das Aufräumen älterer gelöschter Belege aktiviert.
- "Entferne Dokumente älter als Monat(e)": Hier wird in Monaten angegeben wie alt ein Beleg sein muss, damit er automatisiert endgültig gelöscht werden darf.

# Squeeze Stammdatenmapping

Das Squeeze Stammdaten Mapping wird über die DEXPRO Einrichtung aufgerufen.

[![image-1618222160563.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618222160563.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618222160563.png)

Beim initialien Öffnen ist die Liste leer. Diese wird beim Klick auf die Schaltfläche "Stammdatenstruktur holen" gefüllt. Die Daten werden bei der Funktion direkt aus Squeeze ausgelesen und aufgelistet. Dies muss manuell erneut ausgeführt werden, sobald in Squeeze neue Stammdaten Tabellen angelegt worden sind.

Um Squeeze korrekt verwenden zu können, werden die Kreditoren aus NAV benötigt. Hierfür muss das Mapping für den Eintrag "creditors" bearbeitet werden.

### Standard Einrichtung

Die Felder sind im Standard wie folgt zu befüllen:

Referenz Tabelle 23 (Vendor)

[![image-1618222393590.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618222393590.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618222393590.png)

### Felder

<table border="1" id="bkmrk-id-leer-lassen.-dies" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 24.6914%;">id</td><td style="width: 75.3086%;">leer lassen. Dies wird im Hintergrund von Squeeze vergeben.</td></tr><tr><td style="width: 24.6914%;">CompanyId</td><td style="width: 75.3086%;">Hier wird der Dynamics NAV Mandant in der Spalte "Fester Wert" eingetragen.</td></tr><tr><td style="width: 24.6914%;">CreditorId</td><td style="width: 75.3086%;">Feld 1 "Nr."</td></tr><tr><td style="width: 24.6914%;">Name1</td><td style="width: 75.3086%;">Feld 2 "Name"</td></tr><tr><td style="width: 24.6914%;">Name2</td><td style="width: 75.3086%;">Feld 4 "Name 2"</td></tr><tr><td style="width: 24.6914%;">Street</td><td style="width: 75.3086%;">Feld 5 "Adresse"</td></tr><tr><td style="width: 24.6914%;">Zip</td><td style="width: 75.3086%;">Feld 91 "PLZ-Code"</td></tr><tr><td style="width: 24.6914%;">City</td><td style="width: 75.3086%;">Feld 7 "Ort"</td></tr><tr><td style="width: 24.6914%;">CountryCode</td><td style="width: 75.3086%;">Feld 35 "Länder-/Regionscode"</td></tr><tr><td style="width: 24.6914%;">Phone</td><td style="width: 75.3086%;">Feld 9 "Telefonnr."</td></tr><tr><td style="width: 24.6914%;">Fax</td><td style="width: 75.3086%;">Feld 84 "Faxnr."</td></tr><tr><td style="width: 24.6914%;">Email</td><td style="width: 75.3086%;">Feld 102 "E-Mail"</td></tr><tr><td style="width: 24.6914%;">Webpage</td><td style="width: 75.3086%;">Feld 103 "Homepage"</td></tr><tr><td style="width: 24.6914%;">IBAN</td><td style="width: 75.3086%;">leer lassen. Dies wird im Hintergrund mit übertragen.</td></tr><tr><td style="width: 24.6914%;">NationalTaxId</td><td style="width: 75.3086%;">Feld 11000 "Steuernummer". Dieses Feld gibt es nur bei deutschen NAV Installationen</td></tr><tr><td style="width: 24.6914%;">EUTaxId</td><td style="width: 75.3086%;">Feld 86 "USt-IdNr."</td></tr><tr><td style="width: 24.6914%;">Currency</td><td style="width: 75.3086%;">Feld 22 "Währungscode"</td></tr><tr><td style="width: 24.6914%;">PaymentTerm</td><td style="width: 75.3086%;">Feld 27 "Zlg.-Bedingungscode"</td></tr><tr><td style="width: 24.6914%;">BankCode</td><td style="width: 75.3086%;">leer lassen. Dies wird im Hintergrund mit übertragen.</td></tr><tr><td style="width: 24.6914%;">BankAccount</td><td style="width: 75.3086%;">leer lassen. Dies wird im Hintergrund mit übertragen.</td></tr></tbody></table>

### Synchronisation

Sobald in der DEXPRO Einrichtung der Haken im Feld "Stammdaten synchronisieren" gesetzt wurde, werden die Kreditoren und die Kreditoren Bankkonten im Hintergrund überwacht. Änderungen an Einträgen werden direkt an Squeeze über das Mapping übertragen.

Diese Überwachung ist ausschließlich für die Kreditoren und die Kreditoren Bankkonten vorgesehen.

Andere Stammdaten Tabellen können über den Hintergrundjob "Squeeze Master Data Job" (Report 80651) übertragen werden. Hierfür muss ein Haken im Feld "Automatisierte Synchronisierung" beim jeweiligen Eintrag gesetzt werden.

# Export Mapping

Das Export Mapping wird über die DEXPRO Einrichtung aufgerufen.

[![image-1618223914836.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618223914836.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618223914836.png)

Im oberen Bereich wird das Ziel über die Mappenart festgelegt. Die Referenz Tabelle und Positions Tabelle entsprechen dabei den Objekten Nummern der Squeeze4NAV Validierungstabellen.

Im mittleren Bereich werden die Kopffelder festgelegt, welche aus der Validierung in das Ziel übertragen werden sollen.

Im unteren Bereich werden die Positionsfelder festgelegt. Sollen keine Positionsfelder verwendet werden, so muss der Haken im oberen Bereich im Feld "Positions Grid nutzen" entfernt werden.

### Standard Einrichtung

1. Klick auf "Neu" um ein neues Export Mapping anzulegen
2. Über die Mappenart wird festgelegt wohin die Ergebnisse der Validierung exportiert werden sollen. Documents (Workflow) oder Einkaufsdokument (ungebuchter EK-Beleg in NAV). Durch die Auswahl wird ein Standard-Set an Feldern automatisiert gesetzt. Dieses kann bei Bedarf erweitert werden.
3. Mit Klick auf "OK" wird das Mapping dann geschlossen.

# Dynamics NAV Add-ins

Damit die Client-seitigen Squeeze4NAV Add-Ins genutzt werden können, müssen diese in der Steuerlement-Add-In Einrichtung in Dynamics NAV hinzugefügt werden.

Dies übernimmt im Standard schon die Anlage einer neuen DEXPRO Einrichtung im Hintergrund.

[![image-1618224498228.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618224498228.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618224498228.png)

Angelegt werden:

<table border="1" id="bkmrk-add-in-name-token-f%C3%BC" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 25%;">Add-In-Name</td><td style="width: 25%;">Token für öffentlichen Schlüssel</td><td style="width: 25%;">Kategorie</td><td style="width: 25%;">Beschreibung</td></tr><tr><td style="width: 25%;">DEXPRO\_Solutions.BrowserAddIn.BrowserClass</td><td style="width: 25%;">12c785ea6c2f6d36</td><td style="width: 25%;">Add-In für DotNet-Steuerelemente</td><td style="width: 25%;">DEXPRO Solutions Browser</td></tr><tr><td style="width: 25%;">DEXPRO\_Solutions.ControlAddIn.Popup</td><td style="width: 25%;">12c785ea6c2f6d36</td><td style="width: 25%;">Add-In für DotNet-Steuerelemente</td><td style="width: 25%;">Squeeze Functions</td></tr></tbody></table>

# Web Service für Squeeze

Damit Squeeze die Ausleseergebnisse an Dynamics NAV übergeben kann, muss zuvor ein Web Service hierfür angelegt werden.

Hierfür wird die Codeunit 80650 "DEXPRO Invoice Mgt." in der Web Service Einrichtung veröffentlicht.

<table class=" align-left" id="bkmrk-objektart-objekt-id-"><thead><tr><th>Objektart</th><th>Objekt-ID</th><th>Objektname</th><th>Servicename</th></tr></thead><tbody><tr><td>Codeunit</td><td>80650</td><td>DEXPRO Invoice Mgt.</td><td>DEXPROInvoiceService</td></tr></tbody></table>

Informationen zur Anlage und Nutzung von Web Service finden sie [hier](https://docs.squeeze.one/books/web-services).

# Hintergrundjobs

Für die automatisierte Verarbeitung stehen zwei Hintergrundjobs zur Verfügung. Diese müssen als Aufgabenwarteschlangenposten hinterlegt werden. Dies wird meist vom Kunden selber oder vom Dynamics NAV Partner übernommen, da diese die automatisierten Jobs verwalten.

##### Report 80650 "DEXPRO Background Job"

Dieser Job bereitet die von Squeeze übertragenen Ausleseergebnisse auf und führt neben einer Dublettenprüfung auch bei bestellbezogenen Belegen ein Abgleich gegen die Bestellungen und den bereits gelieferten Daten durch. Zudem werden je nach Einrichtung auch die zum Löschen markierten Einträge auf ihr Alter geprüft und endgültig gelöscht, wenn die Parameter stimmen. Solange dieser Job nicht gelaufen ist, werden neu übertragene Informationen dem Anwender auch nicht angezeigt.

Es wird empfohlen, dass dieser Job täglich sehr oft läuft, z.B. je Minute oder alle 5 Minuten.

##### Report 80651 "Squeeze Master Data Job"

Diser Job überträgt alle Stammdaten, welche im Squeeze Stammdatenmapping mit dem Kennzeichen "Automatische Synchronisierung" eingerichtet worden sind.

Es wird empfohlen, dass dieser Job nur 1-2 mal täglich läuft, je nachdem wie viele Daten in den zu übertragenden Tabellen vorhanden sind, da diese die Systemperformance unter umständen beeinflussen könnten.

# Einrichtungen auf der Squeeze Seite

### Export Interface

In Squeeze muss definiert werden wohin die Ausleseergebnisse übergeben werden sollen. Dies wird über die Export Interface gesteuert.

In der Dokumentenklasse unter "Export" werden diese angelegt:

[![image-1618230983264.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618230983264.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618230983264.png)

Als aktives Export Interface wird dann "Navision SOAP Interface" ausgewählt.

[![image-1618231007111.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618231007111.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618231007111.png)

Im Anschluss wird das Interface eingerichtet:

[![image-1618231140257.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618231140257.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618231140257.png)

Hier wird der in Dynamics NAV veröffentliche [Web Service](https://docs.squeeze.one/books/web-services) für die Codeunit 80650 genommen und die SOAP URL in ihre Einzelparts aufgeteilt.

[http://10.10.10.6:9147/DynamicsNAV2018DEMO/WS/DEXPRO/Codeunit/DEXPROInvoiceService](http://10.10.10.6:9147/DynamicsNAV2018DEMO/WS/DEXPRO/Codeunit/DEXPROInvoiceService)

Protocol // Host : Port / Instance ...

Da Squeeze eine Mandantenerkennung hat, wird der NAv Mandant über das Feld "Mandant" gefüllt. Um den Aufruf zu testen wird der Mandant, in diesem Beispiel "DEXPRO", in das Feld "Client Test Value" eingetragen. Der Benuter sollte ein Dynamics NAV Web Service User mit ausreichend Rechten sein.

Beim Klick auf "Speichern" wird der Zugriff mit dem eingetragenen User sofort getestet. Bei Fehlern empfiehlt sich ein genereller Test des NAV Web Services mit einem externen Tool, z.B. Postman. Weitere Punkte gibt es im [DEXPRO Forum](https://discuss.dexpro-solutions.de/) oder im [FAQ](https://docs.squeeze.one/books/web-services/page/faq).

### Export Felder

In der Dokumentenklasse wird in den Feldern über den "Namen (Zielsystem)" festgelegt welche exportiert werden sollen und wie das Feld in der Übergabe heißt.

Hier ist die Grundeinrichtung für die Anbindung an Dynamics NAV. Die Zielsystem-Namen entsprechen den XML Nodes des XMLPorts 80650 "DEXPRO Invoice Structure"

[![image-1618231194655.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618231194655.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618231194655.png)

[![image-1618231339477.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618231339477.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618231339477.png)

### Stapelklassen Eigenschaften

In der Stapelklasse "Invoices" müssen zwei Eigenschaften gesetzt werden, damit eine automatisierte Übertragung durchgeführt wird.

[![image-1618231377252.png](https://docs.squeeze.one/uploads/images/gallery/2021-04/scaled-1680-/image-1618231377252.png)](https://docs.squeeze.one/uploads/images/gallery/2021-04/image-1618231377252.png)

<table border="1" id="bkmrk-eigenschaft-wert-fun" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 33.3333%;">Eigenschaft</td><td style="width: 33.3333%;">Wert</td><td style="width: 33.3333%;">Funktion</td></tr><tr><td style="width: 33.3333%;">IgnoreMandatoryFieldCheckForExport</td><td style="width: 33.3333%;">1</td><td style="width: 33.3333%;">Squeeze-Pflichtfeldprüfung deaktivieren</td></tr><tr><td style="width: 33.3333%;">ExportAfterExtraction

</td><td style="width: 33.3333%;">1</td><td style="width: 33.3333%;">Automatisierter Export nach der Extraktion</td></tr></tbody></table>

# Übernahme in ein anderes NAV System

Hier wird beschrieben, welche Tätigkeiten bei einer Übernahme von einem in ein anderes NAV System anstehen.

# NAV Seite

Auf der NAV Seite müssen folgende Punkte berücksichtigt werden.

- NAV Lizenz überprüfen, ob die DEXPRO Objekte enthalten sind.
- Addins server-seitig und client-seitig ausrollen.
- Addins im NAV Client in den Steuerelement Addin Einrichtung hinterlegen.
- Übernahme der DEXPRO NAV Objekte (Filterung in der Versionsliste auf @\*dexpro\*). Exportieren und im neuen System importieren.
- Mergen der angepassten Standard Tabellen, wenn noch nicht geschehen.
- WebService für die Codeunit 80650 veröffentlichen.
- Aufgabenwarteschlagenposten für den Job 80650 einrichten.
- Zugriffsberechtigungen für die SQUEEZE4NAV Objekte anlegen und den Usern zuordnen.
- Die NAV Instanz welche für SOAP und ODATA Verbindungen zuständig ist korrekt einrichten. ([NAV Instanz Einrichtung](https://docs.squeeze.one/books/web-services/page/voraussetzungen))
- Rapidstart Paket für die DEXPRO Einrichtungstabellen erstellen und Paket pro Mandant exportieren. Im neuen System pro Mandant importieren und übernehmen.
- Einrichtung auf das produktive SQUEEZE umstellen, falls es ein anderes SQUEEZE System sein wird.
- Einrichtung auf das produktive Documents (Workflow) umstellen, falls es ein anderes Documents System sein wird.
- Verbindungstest.
- SQUEEZE Stammdaten Mapping prüfen.
- Export Mapping prüfen.
- Kreditoren neu an SQUEEZE übertragen. Beim ersten Export aus dem ersten Mandanten sollten auch die vorhandenen Einträge auf der SQUEEZE Seite mitgelöscht werden. Dies wird abgefragt, ob es durchgeführt werden soll. Ab dem zweiten Mandanten nur noch exportieren ohne vorheriges Löschen auf der SQUEEZE Seite.

# SQUEEZE Seite

Auf der SQUEEZE Seite sind folgende Tätigkeiten zu beachten:

- Wenn das SQUEEZE System das selbe bleibt, dann muss der Dokumentenklassen Export auf den Web Service des neuen NAV Systems eingerichtet werden.
- Wenn das SQUEEZE System wechselt muss der Dokumentenklassenexport an den WebService des neuen NAV Systems angelegt werden.
- Prüfen ob in dem SQUEEZE System die Dokumentenklassenfelder korrekt eingerichtet sind. (z.B. Name (Zielsystem) ).
- Emailabruf auf das neue Postfach umstellen (z.B. vom Testpostfach auf das Produktivpostfach).
- Sollte das SQUEEZE System das Selbe bleiben, so muss dies aufgeräumt werden (alte Belege löschen, etc.)

# Documents Seite

Auf der Documentsseite müssen folgende Tätigkeiten beachtet werden:

Sollte das Documents System das Selbe bleiben:

- Das neue NAV System anschließen (NAVCON-Json)
- Stammdaten ggf. neu ziehen
- Aufräumen (vorhandene Mappen löschen)