Überblick

Der BarTender Print Connector für Dynamics 365 Business Central ist ein Plug-in für Business Central,
das eine dedizierte, benutzerkonfigurierbare Lösung bietet, um die erstklassige BarTender-Druckengine
direkt in Business Central zu integrieren.

In dieser Anleitung erfahren Sie, wie Sie den BarTender Print Connector für Dynamics 365 Business Central installieren, mit BarTender Cloud verbinden und alle notwendigen Einstellungen konfigurieren, damit Sie drucken können.

Gilt für

BarTender Cloud

Microsoft Dynamics 365 Business Central

Informationen

Um den BarTender Print Connector für Dynamics 365 Business Central zu verwenden, müssen Sie die folgenden Anwendungen nutzen:

• BarTender Cloud mit dem Automation-Abonnement
• Dynamics 365 Business Central Cloud

Installation des Plug-ins

Um den BarTender Print Connector für Dynamics 365 Business Central zu installieren, nutzen Sie eine der folgenden Methoden:

• Suchen Sie im Microsoft AppSource Store nach BarTender und klicken Sie dann, um das Plug-in
  herunterzuladen und zu installieren.
• Geben Sie in Business Central im Suchfeld BarTender ein, klicken Sie unter
  BarTender Connector auf
  Von Microsoft AppSource beziehen, und klicken Sie dann, um das Plug-in herunterzuladen und zu installieren.

Vorbereitung von BarTender Cloud

Bevor Sie den BarTender Print Connector verbinden, müssen Sie einige Schritte in BarTender Cloud durchführen:

• Erstellen Sie ein BarTender Cloud-Konto zur Verwendung mit dem BarTender Print Connector. Dies sollte kein bestehendes Benutzerkonto sein, sondern ein speziell für diesen Zweck erstelltes Konto.
• Konfigurieren Sie das erstellte Konto für den passwortbasierten Zugriff und registrieren Sie den BarTender Print Connector bei BarTender Cloud. Dadurch erhält Business Central Zugriff auf Ihren BarTender Cloud-Mandantenbereich. Anweisungen dazu finden Sie unter BarTender Cloud REST API-Authentifizierung mit passwortbasiertem OAuth.

Verbindung mit BarTender Cloud herstellen

Um Business Central mit BarTender Cloud zu verbinden und die Datenbibliotheken zu synchronisieren, gehen Sie wie folgt vor:

1. Klicken Sie in Business Central oben rechts auf das Suchsymbol und geben Sie BarTender in das Suchfeld ein.
2. Klicken Sie unter Seiten und Aufgaben aufrufen auf BarTender Setup.
3. Konfigurieren Sie auf der BarTender Setup-Seite die folgenden Einstellungen:
   • Root-URL: Geben Sie die Basis-URL Ihres BarTender Cloud-Mandanten ein, falls diese nicht bereits
     angegeben ist. Sie erhalten die URL, indem Sie sich bei BarTender Cloud anmelden und sie aus der Adressleiste Ihres Browsers kopieren. Die Basis-URL sieht wie folgt aus:
     

      https://YourOrganizationDomainID.Datacenter.bartendercloud.com

      Wenn Sie Hilfe beim Auffinden Ihrer Organization Domain ID oder Ihres Rechenzentrums benötigen, lesen Sie den Abschnitt Erste Schritte in So verwalten Sie Ihre Organisation in BarTender Cloud.
   • Anwendungs-ID und Client Secret: Geben Sie Ihre BarTender Cloud Application ID und das Client Secret in die entsprechenden Felder ein. Sie finden diese unter Cloud-Konto verwalten > BarTender Cloud API, indem Sie auf das vertikale Auslassungszeichen rechts neben dem registrierten BarTender Print Connector klicken und ID & Secret anzeigen auswählen.
   • Benutzername: Geben Sie Ihren BarTender Cloud-Benutzernamen ein.
   • Passwort: Geben Sie Ihr BarTender Cloud-Passwort ein.
   • Druck-Timeout: Optional können Sie die Anzahl der Sekunden festlegen, die vergehen sollen,
     bevor ein BarTender-Druckauftrag abbricht. Zum Beispiel können Sie die Timeout-Dauer verlängern, wenn Sie feststellen, dass einige Druckaufträge länger als erwartet benötigen.
4. Klicken Sie auf Verbindung testen, um zu überprüfen, ob die Verbindungsdaten korrekt sind. Wenn Sie Probleme bei der Verbindung mit BarTender Cloud haben, werfen Sie einen Blick auf diesen Artikel.
5. Klicken Sie auf Bibliotheken synchronisieren, um Ihre BarTender Cloud-Drucker, Etikettenvorlagen und Vorlagendatenfelder mit Business Central zu synchronisieren. Alle Etiketten, die Sie verwenden möchten, müssen bereits in BarTender Cloud vorhanden und konfiguriert sein, damit sie von Business Central importiert werden können. Weitere Informationen finden Sie unter Erstellen eines BarTender-Dokuments mit dem Template Assistant in BarTender Cloud.
6. Klicken Sie auf die Schaltfläche Zurück, um die BarTender Setup-Seite zu verlassen.

Fehlerbehebung bei der BarTender-Einrichtung

Wenn während der BarTender-Einrichtung ein Fehler auftritt oder das Feld Client Secret fehlt, müssen Sie möglicherweise die BarTender Print Connector-App für Dynamics 365 Business Central aktualisieren.

1. Klicken Sie zunächst oben rechts in Dynamics 365 auf das Einstellungen-Symbol und wählen Sie Admin Center aus.

2. Klicken Sie auf die Umgebung, die Sie aktualisieren möchten.

3. Klicken Sie oben auf der Seite auf Apps.

4. Wählen Sie rechts neben dem Eintrag BarTender Print Connector Update installieren aus.

Nach Abschluss des Updates müssen Sie Dynamics 365 möglicherweise neu starten.

Konfiguration der Vorlagenzuordnungen

Bevor Sie aus Business Central an BarTender Cloud drucken können, müssen Sie Vorlagenzuordnungen
konfigurieren, um die Quelltabellen und Datenbankfelder in Business Central mit den Zielfeldern Ihrer
BarTender-Etikettenvorlage zu verknüpfen.

Gehen Sie dazu wie folgt vor:

1. Klicken Sie in Business Central oben rechts auf das Suchsymbol und geben Sie BarTender in das Suchfeld ein.
2. Klicken Sie unter Seiten und Aufgaben aufrufen auf BarTender Template Mappings.
3. Klicken Sie auf Neu.
4. Konfigurieren Sie im Bereich Allgemein die folgenden Einstellungen:
   • Quelltabelle-ID: Wählen Sie im Dropdown-Menü die ID der gewünschten Business Central-Tabelle aus. Ihre Auswahl wird automatisch im Feld Quelltabelle Name angezeigt.
   • Vorlagenname: Wählen Sie den Namen der gewünschten BarTender-Dokumentvorlage aus.
   • Drucker: Wählen Sie den Drucker aus, an den der Druckauftrag gesendet werden soll. Wenn Sie PDF auswählen,
     müssen Sie die folgenden zusätzlichen Einstellungen vornehmen:
     
     • PDF-Dateiname: Geben Sie einen Namen für die gespeicherte PDF-Datei ein.
   • Beschreibung: Geben Sie eine Beschreibung für die Zuordnung ein. Beachten Sie, dass diese Beschreibung den Benutzern beim Drucken angezeigt wird.

Im Bereich Druckereinstellungen gibt es zusätzliche Optionen, die Sie aktivieren können. Beide sind selbsterklärend:

• Dokument nach dem Drucken schließen
• Nach dem Drucken speichern

Feldzuordnung

1. Im Bereich Feldzuordnung der Seite BarTender Template Mapping ordnen Sie Felder aus der
   ausgewählten Quelltabelle den BarTender-Vorlagenfeldern zu, indem Sie folgende Einstellungen vornehmen:
   • Quellfeld-Nr.: Geben Sie die ID des Quellfelds ein, das zugeordnet werden soll. Klicken Sie dazu auf die Auslassungspunkte,
     um die Feldsuche anzuzeigen, und wählen Sie dann das gewünschte Feld aus.
   • Ziel-Feldname: Wählen Sie den Namen des Zielfelds aus, dem zugeordnet werden soll.

Um weitere Zuordnungen hinzuzufügen, klicken Sie auf die nächste Zeile und wiederholen Sie diesen Schritt, um zusätzliche Quell- und Zielfelder zu konfigurieren.

2. Klicken Sie auf die Schaltfläche Zurück, um die Seite BarTender Template Mapping zu schließen. Ihre Vorlage wird nun in der Liste der druckbereiten Etiketten angezeigt.

Weitere Ressourcen

Drucken mit dem BarTender Print Connector für Dynamics 365 Business Central