Barcode-Service in SaaS und Universal Code
Zweck
Diese Seite beschreibt die servicebasierte Barcode-Erzeugung in SaaS- und Universal-Code-Szenarien. Sie zeigt, welche Felder in der BE-Code-Einrichtung relevant sind und wie Sie die Verbindung so prüfen, dass Etiketten und Berichte später zuverlässig Barcodes erzeugen.
Warum diese Einrichtung nötig ist
In einer SaaS-Umgebung gibt es keine lokale Barcode-Font-Installation und keinen klassischen DLL-Aufruf. Damit Barcodes trotzdem erzeugt werden können, wird eine Web-API-basierte Serviceanbindung benötigt.
Zusätzlich ist diese Art der Einrichtung im Rahmen von Microsofts Universal-Code-Ausrichtung auch für aktuelle On-Prem-Szenarien relevant geworden. Das bedeutet praktisch:
- SaaS nutzt den Serviceweg zwingend,
- moderne Produktstände sollten nicht mehr auf lokale Altmechanismen allein geplant werden,
- Barcode-Erzeugung ist eine echte Integration und kein bloßer Layoutparameter.
Die Seite BE-Code Einrichtung
Die zentrale Arbeitsseite für diese Konfiguration ist die BE-Code Einrichtung. Dort pflegen Sie die Verbindungsparameter und prüfen, ob das System den Barcode-Service tatsächlich erreichen kann.
| Feld | Bedeutung im Tagesbetrieb | Prüffrage |
|---|---|---|
| Verbindungsstatus | zeigt, ob die Server-API aktuell erreichbar ist | Ist die Verbindung stabil oder nur kurzzeitig erfolgreich? |
| Service URL | Zieladresse des Barcode-Service | Ist Test- oder Live-URL korrekt gepflegt? |
| Basic Authentication verwenden | aktuell vorgesehener Betriebsmodus | Ist die Authentifizierungsart mit dem Projektsetup abgestimmt? |
| Benutzername | technischer Servicebenutzer | Stimmt der Benutzer zur Zielumgebung? |
| Passwort | zugehörige Authentifizierung | Wurden aktuelle Projektzugänge hinterlegt? |
| API Token | derzeit Reservefeld für Erweiterungen | Wird aktuell bewusst leer gelassen oder projektseitig genutzt? |
| Zeitüberschreitung | maximale Wartezeit auf den Service | Ist der Wert für Netzqualität und Drucklast sinnvoll? |
| Legacy Barcode Erzeugung aktiv | aktiviert in Alt-/On-Prem-Szenarien den historischen Weg | Ist das Feld im aktuellen Betriebsmodell bewusst gesetzt oder bewusst deaktiviert? |
Sichere Projektnutzung
Die Alt-Wiki-Dokumentation enthielt Testzugänge. In der neuen Produktdokumentation sollten konkrete Zugangsdaten nicht als allgemeine Arbeitsanweisung übernommen werden. Nutzen Sie stattdessen immer:
- projektspezifische Test-URL,
- projektspezifischen Servicebenutzer,
- projektspezifisches Kennwort oder Authentifizierungsverfahren,
- eine getrennte Dokumentation für Test- und Produktivbetrieb.
So vermeiden Sie, dass veraltete oder unpassende Zugangsdaten unkritisch weiterverwendet werden.
Empfohlener Einrichtungsablauf
- Öffnen Sie die BE-Code Einrichtung.
- Pflegen Sie die zur Umgebung passende Service URL.
- Aktivieren Sie den vorgesehenen Authentifizierungsmodus.
- Hinterlegen Sie Benutzer und Kennwort aus dem Projektkontext.
- Prüfen Sie die Zeitüberschreitung auf einen realistischen Wert.
- Führen Sie die Verbindungsprüfung bewusst aus.
- Testen Sie anschließend einen echten Bericht oder ein echtes Etikett mit Barcode.
Wichtig ist dabei: Eine grüne Verbindung allein reicht nicht. Erst ein echter Belegtest zeigt, ob auch Format, Datenübergabe und Antwortzeit im Gesamtprozess passen.
Typische Fehlerbilder
| Situation | Mögliche Ursache | Prüfschritt |
|---|---|---|
| Verbindungsstatus bleibt negativ | URL, Authentifizierung oder Netzwerkpfad stimmt nicht | Service URL und Projektzugangsdaten prüfen |
| Verbindung funktioniert, aber kein Barcode erscheint | Service ist erreichbar, Datenübergabe oder Belegtest ist aber nicht korrekt | echten Bericht oder Etikettendruck testen |
| Zeitüberschreitung tritt regelmäßig auf | Timeout zu niedrig oder Service reagiert zu langsam | Timeout und Serviceverfügbarkeit prüfen |
| On-Prem verhält sich anders als erwartet | Legacy-Barcodeweg ist unbeabsichtigt aktiv oder inaktiv | Feld Legacy Barcode Erzeugung aktiv prüfen |
Ergebnis
- Sie verstehen, warum Barcode-Erzeugung in SaaS und Universal Code als Serviceintegration behandelt werden muss.
- Sie können die BE-Code-Einrichtung sicher konfigurieren und prüfen.
- Sie vermeiden typische Fehler durch falsche Ziel-URLs, unklare Betriebsmodi oder ungeprüfte Altmechanismen.
Links