Beispiel: Integration in Business Central

End-to-End-Beispiel für die Nutzung von BE-Code in Business Central: Setup und Nachverfolgung im BE-Code-Register.

Zweck

Dieses Beispiel zeigt, wie BE-Code in Business Central eingebunden wird und wie Sie die Ausführung über das BE-Code-Register nachvollziehen. Das Beispiel orientiert sich am ausgelieferten Beispiel-Szenario für Artikel-Identifikatoren.

Kontext

  • BE-Code wird als Middleware-Service betrieben. Die Einrichtung ist unter Einrichtung BE-Code beschrieben.
  • Beim Anlegen oder Ändern eines Artikel-Identifikators erzeugt der mitgelieferte Event-Subscriber automatisch einen Eintrag im BE-Code-Register und ruft den Service auf.

Voraussetzungen

  • BE-Code-Service ist verfügbar (On-Premises oder Azure Container Instance).
  • Zugangsdaten für die Basic-Authentication des Service liegen vor.
  • Die BE-Code-App ist in Business Central installiert.

Prozesskatalog

Process Schritt 1 – BE-Code-Setup pflegen Server-URL und Authentifizierung hinterlegen und die Verbindung testen.
  1. Öffnen Sie in Business Central die Seite BE-Code Setup.
  2. Hinterlegen Sie die Server-API-URL, z. B. https://<fqdn>:1880/becode.
  3. Tragen Sie die Basic-Authentication-Zugangsdaten ein.
  4. Aktivieren Sie bei Bedarf die Integration für Artikel-Identifikatoren, pflegen Sie den API-Pfad und den Standard-Identifikator-Parameter.
  5. Wählen Sie die Aktion Verbindung prüfen. Eine Erfolgsmeldung bestätigt, dass BE-Code erreichbar ist.
Process Schritt 2 – Ausführung im BE-Code-Register prüfen Die erzeugten Einträge und die gespeicherten Bilder nachvollziehen.
  1. Legen Sie einen Artikel-Identifikator an oder ändern Sie einen bestehenden Eintrag.
  2. Öffnen Sie die Seite BE-Code Register. Für jeden Vorgang wird ein Datensatz erzeugt.
  3. Prüfen Sie den Status und die erzeugten Bilder.

Das base64-kodierte Bild wird als Medienset gespeichert. Der dazugehörige GUID-Identifikator lässt sich in weiteren Tabellen wiederverwenden, ohne dass das Bild erneut angefordert werden muss.

Ergebnis

  • Das BE-Code-Setup ist gepflegt und die Verbindung verifiziert.
  • Jede Änderung eines Artikel-Identifikators wird automatisch verarbeitet.
  • Erzeugte Barcodes stehen als Medienset in Business Central zur Weiterverwendung bereit.