DOCBOX® Connector
Dokumentation

In Zusammenarbeit mit DOCBOX® ermöglicht Ihnen dieses offizielle Business Central Add-On von BIZZCORE einen einfachen Zugriff auf Ihre in Ihrer DOCBOX®-Umgebung gespeicherten Dokumente.

Der DOCBOX® Connector ist die Lösung für Business Central Kunden, die eine vollintegrierte DMS-Lösung für Business Central suchen und wertvolle Zeit sparen wollen.

Jeder Druckbericht kann für die automatische Archivierung in DOCBOX® konfiguriert werden. Eine Vorschau der verknüpften Dokumente wird direkt in Business Central angezeigt. Mit dem DOCBOX® Connector können Sie auch die Metadaten Ihrer DOCBOX® Dokumente automatisch mit den Dokumentendaten aus Business Central aktualisieren. Laden Sie Dokumente direkt aus Business Central in DOCBOX® hoch und durchsuchen Sie Ihre DOCBOX® Dokumente via Volltextsuche.

Belegintegration

Mit dem DOCBOX® Connector für Business Central werden verknüpfte DOCBOX® Dokumente in allen gebuchten und nicht gebuchten Verkaufs- und Einkaufsbelegen sowie Mahnungen angezeigt. Über eine Vorschau wird das verknüpfte Dokument zur Laufzeit aus der DOCBOX® geladen und direkt in Business Central angezeigt.

Über den in Business Central integrierten DOCBOX® Explorer können außerdem zusätzliche Dokumente verknüpft oder auch direkt hochgeladen werden. Die Belegarchivierung erfolgt automatisch auf Basis der generischen Einrichtung.

Metadaten

Je besser Sie Ihre Dokumente durch typisierte Metadaten anreichern, umso leistungsfähiger wird Ihr DMS-System.

Mit dem DOCBOX® Connector für Business Central haben Sie vielfältige Möglichkeiten sowohl eingehende Metadaten in Business Central Belege zu übernehmen als auch Metadaten nach der Buchung in der DOCBOX® zu aktualisieren. Jeder Beleg-Typ, welcher in Business Central seinen Ursprung hat (z.B. VK-Rechnungen oder andere kundenspezifische Belege) kann automatisch inkl. Metadaten in DOCBOX® archiviert werden.

In der DOCBOX® Basis-Umgebung stehen nur System-Metafelder zur Verfügung, um die ganze Bandbreite inkl. eigene Metafelder nutzen zu können, benötigen Sie das kostenpflichtige „Metadesigner“.

Volltextsuche

Das Auffinden von Dokumenten anhand von Schlagworten ist eines der zentralen Features eines Dokumenten Management Systems (DMS).

Wir haben hierfür den Standard-Schnellfilter von Business Central im DOCBOX® Explorer so leistungsstark angepasst, dass Dokumente spielend gefunden werden können. Hierbei werden die Schlagworte an die DOCBOX® API übergeben und die gefundenen Dokumente zurückgeliefert.

Durch diese leistungsstarke Integration ist ein Wechsel zwischen den Systemen nicht mehr notwendig.

Untitled-7.jpg

Installation

Zur Installation des DOCBOX® Connector in Business Central, öffnen Sie Ihre Business Central Umgebung, klicken Sie auf die Lupe oben rechts und suchen Sie bitte nach „Marketplace“.

Klicken Sie dann auf „Marketplace für Erweiterungen“!

Nun öffnet sich der Microsoft AppSource für Business Central.
Suchen Sie hier nach „DOCBOX Connector“!

Einrichtung

Um die Einrichtung zu starten, klicken Sie auf dem Dashboard im DOCBOX® Einrichtungs-Hinweisband unter dem Menü auf „Ja bitte einrichten“!

Basis URL

Die Basis URL wird vom DOCBOX® Hersteller vorgegeben, kann aber bei Bedarf auch angepasst werden. Ihre genaue Basis URL erfahren Sie von Ihrem DOCBOX® Partner.

API Basis URL

Die API Basis URL wird vom DOCBOX® Hersteller vorgegeben, kann aber bei Bedarf auch angepasst werden, zum Beispiel bei einem Versionswechsel. Ihre genaue API Basis URL erfahren Sie von Ihrem DOCBOX® Partner.

CLOUD-ID

Hier wird die individuelle Cloud-ID Ihrer DOCBOX® Umgebung eingetragen. Egal ob Sie eine On-Prem Installation benutzen oder die Software-as-a-Service (SaaS) Variante aus der Cloud. Ihre genaue Cloud-ID erfahren Sie von Ihrem DOCBOX® Partner.

Monitoring ab

Legt fest, ab welchem Datum die gebuchten Einkaufs- und Verkaufsbelege auf ihren Archivierungsstatus geprüft werden. Nicht archivierte Belege werden durch entsprechende DOCBOX®-Kacheln im Rollencenter hervorgehoben.

Lizenzierte Benutzer

Gibt die Anzahl der lizenzierten Benutzer an. Durch das Anlegen von API-SCHLÜSSEL-ZUORDNUNGEN (API-Schlüssel werden im DOCBOX® API-Modul erzeugt) werden zusätzliche Lizenzen erzeugt.

HINWEIS: Alle angezeigten Lizenzen sind kostenpflichtig, bei Fragen hierzu wenden Sie sich an ihren DOCBOX® Partner.

Lizenz gültig bis

Dieses Datum zeigt den letzten Tag der Gültigkeit Ihrer Lizenz. Bitte setzen Sie sich zur Verlängerung ca. 3 Monate vor Ablauf mit ihrem DOCBOX® Partner in Verbindung.

Untitled-7.jpg

Zuordnung API - Schlüssel

API-Schlüssel

Die hier benötigten API-Schlüssel werden in Ihrer DOCBOX® Umgebung* generiert und einem DOCBOX® Benutzer zugewiesen. Dadurch erbt der API-Schlüssel die Berechtigungen des DOCBOX® Benutzers.

*Zur Anlage von API-Schlüssel ist das Modul: REST-API erforderlich, dies muss separat dazugebucht werden. Wenden Sie sich dazu an Ihren DOCBOX® Partner.

Benutzer Name

In diesem Feld können Sie den Business Central Benutzer nachschlagen und ihn dem API-Schlüssel zuordnen. Nur durch diese Zuordnung hat der BC-Benutzer Zugriff auf die DOCBOX® Daten im Kontext der entsprechenden Berechtigungen.

Gültig

Das Häkchen zeigt an, ob ein API-Schlüssel grundsätzlich gültig ist, also in der DOCBOX® Umgebung existiert. Sollte dieses Häkchen NICHT gesetzt sein, prüfen Sie die korrekte Schreibweise des API-Schlüssels, wenden Sie sich an Ihren DOCBOX® Partner oder schreiben Sie eine Mail an DOCBOX@bizzcore.de.

Lizensiert

Dieses Häkchen zeigt an, ob der entsprechende API-Schlüssel auch bei DOCBOX® lizensiert ist. Sollte dieses Häkchen NICHT gesetzt sein, prüfen Sie die korrekte Schreibweise des API-Schlüssels, wenden Sie sich an Ihren DOCBOX® Partner oder schreiben Sie eine Mail an DOCBOX@bizzcore.de.

Um neue API-Schlüssel zu generieren bzw. zu lizensieren, wenden Sie sich an Ihren DOCBOX® Partner.

Eingehende Belege

Eingangsfach Verzeichnis ID

Die Auswahl der Verzeichnis-ID für das Eingangsfach, erfolgt über den DOCBOX® Explorer (Verzeichnis-Modus). Klicken Sie hierzu im Bearbeitungsmodus () auf die drei Punkte neben der ID. Hier können Sie nun Ihr gewünschtes Eingangsfach wählen. Die entsprechende Verzeichnis-ID wird bei der Auswahl mit angezeigt.

Eingangsfach Verzeichnis Name

Nach der Auswahl der Verzeichnis-ID für das Eingangsfach wird in diesem Feld der Name des Eingangsfachs angezeigt.

Archiv Verzeichnis ID

Die Auswahl der Verzeichnis-ID für das Archiv erfolgt über den DOCBOX® Explorer (Verzeichnis-Modus). Klicken Sie hierzu im Bearbeitungsmodus () auf die drei Punkte neben der ID. Hier können Sie nun Ihr gewünschtes Archiv wählen. Die entsprechende Verzeichnis-ID wird bei der Auswahl mit angezeigt.

Archiv Verzeichnis Name

Nach der Auswahl der Verzeichnis-ID für das Archiv wird in diesem Feld der Name des Archivs angezeigt.

Untitled-7.jpg

Mapping Metadaten


Quelle

Dieses Feld bezieht sich auf die Herkunft der Metadaten. Systemseitig steht Ihnen die Auswahl “DOCBOX”, “BC (EK-Rechnung)” und “BC (EK-Gutschrift)” zur Verfügung.

Metadaten Schlüssel

Das Feld Metadaten-Schlüssel bezieht sich immer auf die Metadaten-Felder aus der DOCBOX®. Neben den systemseitigen Metadaten-Feldern, können in der DOCBOX® auch eigene Metadaten-Felder angelegt werden. Weitere Informationen und Anleitungen hierzu finden Sie in der DOCBOX® Dokumentation.

Feld ID

Hier kann das entsprechende Feld aus der Business Central Tabelle ausgewählt und verlinkt werden. Die zur Auswahl stehenden Felder sind abhängig von der gewählten Quelle.

Feld Beschreibung

Dieses Feld zeigt eine benutzerfreundliche Beschreibung des gewählten Business Central Feldes an.

Ausgehende Belege

Die Neuanlage und die Bearbeitung von ausgehenden Belegen wird im Abschnitt „Druckbeleg Einrichtung“ beschrieben.

Berichts-ID

Bei der Berichts-ID handelt es sich um die Objekt-ID des Berichtes in BC, welcher für die Archivierung in die DOCBOX® konfiguriert werden soll.

Berichtsname

Anzeige des benutzerfreundlichen Berichts-Namen zur gewählten ID.

Dateiname

Der Dateiname für die ausgehenden Belege als PDF kann frei aus Freitext und %Metafeldern% aus der DOCBOX® definiert werden. Die Endung „.pdf“ wird hierbei automatisch angehangen und muss somit nicht mit eingegeben werden.

Wie neue Metafelder in der DOCBOX® angelegt werden können wird im DOCBOX® Handbuch (https://wiki.docbox.eu) beschrieben.

HINWEIS: Um eigene Metafelder nutzen zu können, benötigen Sie das kostenpflichtige DOCBOX® Modul „Metadesigner“. Wenden Sie sich hierfür an Ihren DOCBOX® Partner.

Archiv-Verzeichnis ID

Hier wird die Verzeichnis-ID des konfigurierten Archiv-Verzeichnisses innerhalb der DOCBOX® für den jeweiligen ausgehenden Beleg angezeigt.

Archiv-Verzeichnis Name

Hier wird der Verzeichnis-Name des konfigurierten Archiv-Verzeichnisses innerhalb der DOCBOX® für den jeweiligen ausgehenden Beleg angezeigt.

Untitled-7.jpg

Einrichtung Druckbelege

Berichts-ID

Hier bekommen Sie eine Auswahl aller in Business Central eingerichteten Berichte. Sie können durch alle Berichte scrollen oder die Berichts-ID direkt eingeben. In diesem Beispiel wurde ein eigener Rechnungs-Bericht gewählt.

Berichtsname

Anzeige des benutzerfreundlichen Berichts-Namen zur gewählten ID.

Berichtstitel

Anzeige des Berichtstitel zur gewählten Berichts-ID.

Tabellen-ID

Zeigt ID der zugrundeliegende Datentabelle in Business Central an.

Tabellenname

Zeigt den Namen der zugrundeliegende Datentabelle in Business Central an.

Tabellenbezeichnung

Zeigt die Bezeichnung der zugrundeliegende Datentabelle in Business Central an.


Metadaten Schlüssel

Das Feld Metadaten-Schlüssel bezieht sich immer auf die Metafelder aus der DOCBOX®. Neben den systemseitigen Metadaten-Feldern können in der DOCBOX® auch eigene Metafelder angelegt werden. Weitere Informationen und Anleitungen hierzu finden Sie im DOCBOX® Handbuch (https://wiki.docbox.eu).

HINWEIS: Um eigene Metafelder nutzen zu können, benötigen Sie das kostenpflichtige DOCBOX® Modul „Metadesigner“. Wenden Sie sich hierfür an Ihren DOCBOX® Partner.

Feld ID

Hier kann das entsprechende Feld aus der Business Central Tabelle ausgewählt und verlinkt werden.

Feld Beschreibung

Dieses Feld zeigt eine benutzerfreundliche Beschreibung des gewählten Business Central Feldes an.


Archiv-Verzeichnis-ID

Hier wird die Verzeichnis-ID des Archiv-Verzeichnisses innerhalb der DOCBOX® für den jeweiligen ausgehenden Beleg ausgewählt.

Archiv-Verzeichnis Name

Hier wird der Verzeichnis-Name des konfigurierten Archiv-Verzeichnisses innerhalb der DOCBOX® für den jeweiligen ausgehenden Beleg angezeigt.

Dateiname

Der Dateiname für den ausgehenden Beleg als PDF kann frei aus Freitext und %Metafeldern% aus der DOCBOX® definiert werden. Die Endung „.pdf“ wird hierbei automatisch angehangen und muss somit nicht mit eingegeben werden.

Wie neue Metafelder in der DOCBOX® angelegt werden können wird im DOCBOX® Handbuch (https://wiki.docbox.eu) beschrieben.

HINWEIS: Um eigene Metafelder nutzen zu können, benötigen Sie das kostenpflichtige DOCBOX® Modul „Metadesigner“. Wenden Sie sich hierfür an Ihren DOCBOX® Partner.

Archivieren bei

Grundsätzlich stehen bei jeder Funktion folgenden Optionen zur Verfügung.

Niemals:               die Archivierung wird nicht ausgeführt
Auf Nachfrage: die Archivierung findet nur nach Bestätigung eines Nachfrage-Fensters statt
Immer:                  die Archivierung findet ohne Nachfrage jedes Mal statt

Vorschau

Hier wird das Archivierungs-Verhalten bei der Anzeige des Vorschaufensters dieses Berichtes konfiguriert.

Drucken

Hier wird das Archivierungs-Verhalten beim Senden des Berichtes zu einem Drucker konfiguriert.

E-Mail

Hier wird das Archivierungs-Verhalten beim Senden des Berichtes via E-Mail konfiguriert.

Senden an

Hier wird das Archivierungs-Verhalten beim Klicken aus „Senden an“ konfiguriert.