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.
- Öffnen Sie in Business Central die Seite BE-Code Setup.
- Hinterlegen Sie die Server-API-URL, z. B.
https://<fqdn>:1880/becode. - Tragen Sie die Basic-Authentication-Zugangsdaten ein.
- Aktivieren Sie bei Bedarf die Integration für Artikel-Identifikatoren, pflegen Sie den API-Pfad und den Standard-Identifikator-Parameter.
- 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.
- Legen Sie einen Artikel-Identifikator an oder ändern Sie einen bestehenden Eintrag.
- Öffnen Sie die Seite BE-Code Register. Für jeden Vorgang wird ein Datensatz erzeugt.
- 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.
Links