Leitfaden zur Fehlerbehebung: Integrationen
Überblick
Das Integrationssystem besteht aus beweglichen, automatisierten Komponenten. Die Fehlersuche bei Problemen, die nicht sofort sichtbar sind, kann zunächst einschüchternd wirken, aber wenn Sie Schritt für Schritt vorgehen, lassen sich Fehler meist schnell finden und beheben.
Dieser Leitfaden hilft Ihnen, die einzelnen Komponenten und den Integrationszyklus zu verstehen und zeigt, wie Sie diese aus einer übergeordneten Perspektive analysieren und Fehler beheben können. Es gibt viele verschiedene Arten von Integrationen, jede mit ihren eigenen Besonderheiten, aber alle nutzen denselben Ablauf und dieselben Komponenten, um zu funktionieren.
Gilt für
BarTender 2019 und neuer
Bestandteile des Integrationsprozesses
Mehrere Komponenten im Integrationsprozess arbeiten zusammen, um Ihre Druckaufträge zu automatisieren. Hier finden Sie eine kurze Beschreibung jeder Komponente und wie sie zu diesem Prozess beiträgt.
Dienste
- BarTender Integration Service: Dieser Dienst führt die Integrationen selbst aus, startet und stoppt sie und übernimmt die Erkennung und Verarbeitung von Auslösern (Triggern).
- BarTender Print Scheduler Service: Dieser Dienst verarbeitet die Etikettendateien, bereitet sie vor und sendet sie an die Druckerwarteschlange.
- BarTender System Service: Dieser Dienst protokolliert und kommuniziert zwischen den Diensten und der Systemdatenbank.
Druck-Engines
Eine Druck-Engine ist ein anderer Begriff für BarTender Designer, der als Dienst ausgeführt wird. Sie erscheint als bartend.exe in der Liste der laufenden Prozesse. Die Druck-Engines werden automatisch vom Print Scheduler Service gestartet und gestoppt und dienen dazu, das eigentliche Etikett zu drucken. Standardmäßig haben Druck-Engines folgende Eigenschaften:
- Der Print Scheduler Service startet sie bei Bedarf. Wenn die Integrationslast es erfordert, werden weitere Instanzen geöffnet.
- Sie sorgen dafür, dass die Druckreihenfolge eingehalten wird (damit Seriennummern und Datensätze auf Ihrem Etikettenbogen nicht durcheinander geraten).
- Sie können bis zu 5 Dokumente gleichzeitig verarbeiten und schließen diese, wenn sie nicht mehr benötigt werden.
- Sie werden automatisch vom Print Scheduler Service geschlossen, wenn sie 60 Minuten lang nicht genutzt wurden.
Druck-Engines arbeiten automatisch. Sie müssen diese nicht selbst öffnen oder schließen, da der Print Scheduler Service alles übernimmt. Die maximale Anzahl an Druck-Engines entspricht der Anzahl Ihrer CPU-Kerne x2.
Der Integrationszyklus
Integrationen sind von Natur aus zyklisch. Sie starten und warten darauf, dass etwas sie auslöst. Das kann eine Datei, ein Datensatz in einer Datenbank, eine E-Mail, etwas im Netzwerk, ein zeitbasierter Auslöser oder Ähnliches sein. Sobald der Auslöser erkannt wird, beginnt die Integration mit der Verarbeitung der Daten und sendet sie zum Druck. Alles außerhalb des lila Print Scheduler-Kastens wird vom Integration Service übernommen.
Im Allgemeinen kehrt die Integration, sobald der Auftrag an die Warteschlange gesendet und vom Print Scheduler an den Integration Service bestätigt wurde, in den Wartezustand zurück.
Die Integration kann aus verschiedenen Gründen in den Stopp-Zustand wechseln:
- Es handelt sich um eine zeitgesteuerte Integration, die nicht wiederholt wird.
- Die Integration wird im Integration Builder, in der Administrationskonsole oder durch das Herunterfahren des Dienstes gestoppt.
- Das Integrationssystem ist fehlerhaft und kann sich nicht erholen.
Angesichts der vielen beweglichen Teile des Integrationssystems sollten Sie bei der Fehlersuche Folgendes beachten:
- Führen Sie immer ein Update auf die neueste Service-Version durch. So stellen Sie sicher, dass Sie nicht auf einen bereits behobenen Fehler stoßen.
- Gehen Sie die einzelnen Schritte des Integrationszyklus der Reihe nach durch. So vermeiden Sie, dass Sie versuchen, etwas zu beheben, das bereits im vorherigen Schritt schiefgelaufen ist.
- Wenn Sie Hilfe benötigen oder auf etwas stoßen, das in diesem Leitfaden nicht behandelt wird, kontaktieren Sie den Support!
Für diesen Prozess benötigen Sie Zugriff auf die Integrationsdatei (.btin), Etikettendatei(en) (.btw), alle Datenbankdateien, Triggerdaten (sofern es sich nicht um eine zeitgesteuerte Integration handelt) und den Integration Builder.
Fehlersuche
Berechtigungen sind ein häufiges Problem bei vielen Integrationsschritten, insbesondere bei der Nutzung von Netzwerkressourcen. Sie können die Berechtigungen Ihrer Integration auf ein Domänenkonto erhöhen, indem Sie auf den Integrationskopf klicken und die Informationen im Abschnitt Benutzerkonto eingeben.
Legen Sie die Berechtigungen hier fest und stellen Sie das Konto für den Integration Service nur dann ein, wenn der technische Support Sie dazu auffordert. Alternativ können Sie ein Konto für den BarTender System Service festlegen; der Integration Service übernimmt dann diese Berechtigungen.
Das Konto muss folgende Eigenschaften haben, um die Integration ordnungsgemäß auszuführen:
- Mitglied der lokalen Administratorengruppe sein (erforderlich für Nachrichtenübermittlung, Zugriff auf temporäre Dateien und ungehinderten Zugriff auf die Dateistruktur, um Etiketten abzurufen usw.)
- Zugriff auf Domänenebene haben (um auf Netzwerkdrucker oder -laufwerke zugreifen zu können)
- Die Gruppenrichtlinie muss die lokale Anmeldung erlauben (ohne diese Berechtigung kann kein Dienst oder Task ausgeführt werden)
- Das Passwort darf sich nicht ändern (Sie möchten nicht, dass Ihre Integration ausfällt, wenn die Passwort-Richtlinie greift)
Um den Integrationsprozess zu überprüfen, klicken Sie auf einen Schritt, um den jeweiligen Abschnitt zu erweitern. Gehen Sie die Schritte einzeln durch, um das Problem einzugrenzen:
Integration starten
Warten auf den Auslöser
Sobald die Integration gestartet ist, heißt es warten, bis der Auslöser eintrifft. Das klingt nach einem Schritt, der keine Fehlersuche erfordert – aber was tun, wenn Sie ewig im Wartezustand bleiben? Was, wenn der Auslöser nie ankommt? Wenn "nichts passiert", kann die Fehlersuche in diesem Schritt helfen, die Ursache zu finden.
Alle Integrationsarten warten darauf, dass etwas passiert oder erscheint. Das kann eine Datei, Daten über einen Netzwerkport, ein Datensatz in einer Tabelle oder ein bestimmter Zeitpunkt sein. Alle Einstellungen zur Trigger-Erkennung finden Sie wie im vorherigen Schritt im ersten Unterabschnitt unter dem Integration-Header.
Hier einige Dinge, die Sie bei gängigen Integrationsarten prüfen können:
Datei-Integrationen
- Wird die Trigger-Datei im im Integrationseintrag angegebenen Überwachungsordner abgelegt?
- Entspricht die Trigger-Datei dem erwarteten Dateimuster? Wenn die Integration z. B. nach einer .csv sucht und Sie eine .css-Datei ablegen, passt das Muster nicht.
- Gibt es eine andere Integration, die die Dateien zuerst beansprucht?
Datenbank-Integrationen
- Werden die Daten in die richtige Tabelle eingefügt?
- Ist die Methode zur Datenerkennung korrekt? Wenn eine Integration auf einen inkrementierenden Wert wartet, Sie aber stattdessen einen Zeitstempel aktualisieren, passt die Methode nicht.
- Wird das überwachte Feld inkrementiert oder der Zeitstempel aktualisiert?
Socket- und Webservice-Integrationen
- Werden die Daten an die richtige Adresse gesendet?
- Blockiert eine Firewall den Port?
Wichtige Hinweise
- Stellen Sie sicher, dass der Auslöser am richtigen Ort ankommt.
- Überprüfen Sie, dass nichts den Auslöser blockiert oder vor der Erkennung abfängt.
Aktionen nach der Erkennung
Wie im vorherigen Schritt scheint auch hier alles einfach zu funktionieren. Manchmal erscheint eine Fehlermeldung, wenn in diesem Schritt etwas schiefgeht, manchmal wird das Problem aber erst deutlich, wenn der Integrationszyklus erneut durchlaufen wird.
In diesem Schritt geht es darum, was die Integration nach dem Empfang der Daten tut. Nur zwei Integrationsarten nutzen Aktionen nach der Erkennung. Alle anderen können diesen Schritt überspringen. Hier einige Hinweise zu gängigen Integrationen, bei denen es Aktionen nach der Erkennung gibt:
Datei-Integrationen
Von allen Integrationsarten sind diese in diesem Schritt am "lautesten". Wenn bei den Aktionen nach der Erkennung etwas schiefgeht, gibt die Integration eine Fehlermeldung aus und teilt mit, was nicht stimmt. Häufige Probleme sind fehlende Berechtigungen zum Ändern von Dateien oder Ordnern sowie falsche Dateipfade.
Die Aktionen nach der Erkennung für eine Datei-Integration sind hier aufgeführt:
Socket-Integrationen
In diesem Schritt sind Probleme bei einer Socket-Integration weniger offensichtlich als bei einer Datei-Integration. Wenn Sie eine eher ruhige Socket-Integration haben, treten hier möglicherweise keine Probleme auf. Bei einer stark genutzten Integration kann jedoch gelegentlich folgender Fehler auftreten: "Fehler: Zugriff auf freigegebenes Objekt nicht möglich."
Hier passiert Folgendes: Der Socket wird nach dem Empfang der Daten nicht geschlossen, sodass neue Daten direkt darauf treffen. Die Integration ist nicht bereit für neue Daten, weiß nicht, wie sie diese verarbeiten soll, und verwirft sie einfach, da sie sie für fehlerhafte Daten hält. Der Socket "leckt" Daten und Druckaufträge gehen verloren.
Wenn Sie dieses Verhalten bemerken, lesen Sie diesen Artikel, um das Problem zu beheben: Integrationsfehler beim Ausführen einer Socket-Integration.
Wichtige Hinweise
- Dieser Schritt betrifft zwei bestimmte Integrationsarten.
- Fehler in diesem Schritt sind nicht immer sofort erkennbar.
Verarbeitung der Integrationsaktionen
Integrationsaktionen sind alle Schritte, die Ihre Integration ausführt, um ein Etikett zu verarbeiten und zu drucken. Alle Aktionen werden unter der Aktionsüberschrift aufgelistet:
Dieses Beispiel ist recht einfach, da es nur eine Druckaktion enthält. Manche Integrationen können jedoch mehrere Schritte beinhalten, wie Schleifen, Datenanalyse, das Ausgeben von Nachrichten oder E-Mails oder bedingte Anweisungen. Hier ist ein größeres Beispiel, bei dem Daten aus einem Trigger mithilfe einer Reihe benannter Such- und Löschaktionen extrahiert und anschließend in einer Dokument drucken-Aktion verwendet werden:
Dadurch wird dieser Schritt komplexer und es gibt mehr Stellen, an denen etwas schiefgehen kann. Am besten ist es, zunächst so einfach wie möglich zu starten. Reduzieren Sie die Aktionen auf das absolute Minimum, um die Schritte so weit wie möglich zu verringern (in der Regel nur die Aktionen, die beim Erstellen einer neuen Integration über das Menü „Neu“ verwendet werden, plus das Nötigste zur Datenverarbeitung) und beginnen Sie von dort aus.
- Entfernen Sie zusätzliche Schritte. Starten Sie mit dem Minimum.
- Fügen Sie jeden Schritt einzeln hinzu und testen Sie, um sicherzustellen, dass das Problem nicht in dieser bestimmten Aktion liegt.
Die größte Herausforderung in diesem Schritt ist das Testen. Wenn das Problem in einem späteren Schritt des Integrationszyklus liegt, bleibt es während aller Tests bestehen. Trotzdem ist es wichtig, in diesem Schritt alles doppelt zu überprüfen. Hier sind häufige Probleme, die bei den Mindestschritten einer Integration auftreten können:
Dokumentenpfad
Um ein Etikett zu drucken, muss die Integration natürlich ein Dokument öffnen können. Ist der Speicherort oder Name des Dokuments ungültig, gibt die Integration wahrscheinlich einen Dokumentenfehler aus, der darauf hinweist, dass es ein Problem beim Öffnen des Dokuments gab. Den Dokumentnamen finden Sie an folgenden Stellen:
- Dokument drucken-Aktion: Im Bereich „Dokument“ auf der Registerkarte „Dokument“. Wenn das Dokument durch eine Variable bestimmt wird, verfolgen Sie, woher die Variable stammt (meist aus einem Datenbankfeldnamen, einer Variable setzen-Aktion oder einer der Suchaktionen) und stellen Sie sicher, dass die Daten in dieser Variable korrekt sind.
- Druckbefehl-Skript-Aktion: In den Triggerdaten im /AF-Parameter
- BTXML drucken-Aktion: In den Triggerdaten im <Format>-Tag
Wenn in einer Dokument drucken-Aktion kein Dokument angegeben ist, schlägt die Integration sofort mit einer Fehlermeldung über das fehlende Dokument fehl, sobald Sie sie starten.
Druckername
Genauso wie Sie ohne Dokument nicht drucken können, können Sie auch nicht ohne gültigen Drucker drucken. In den meisten Fällen gibt die Integration einen Fehler aus, meist einen ungültigen Druckerfehler oder Windows-Fehlercode 1801 (Windows hat ein Problem mit diesem Drucker). Letzterer liegt außerhalb des Umfangs dieses Troubleshooters, da er auf Windows-Ebene behoben werden muss. Ersterer kann an folgenden Stellen gefunden werden:
- Dokument drucken-Aktion: Im Feld „Drucker“ auf der Registerkarte „Druckoptionen“
- Druckbefehl-Skript-Aktion: In den Triggerdaten im /P-Parameter
- BTXML drucken-Aktion: In den Triggerdaten im <Printer>-Tag
Wenn kein Drucker angegeben ist, verwendet die Integration den Drucker, der mit dem Etikett gespeichert wurde. Wenn Ihre Integration keinen Drucker angibt, öffnen Sie das Etikett in BarTender Designer und gehen Sie zu Datei > Drucken. Das ist der Drucker, den Ihre Integration verwendet.
Manchmal landet ein Etikett bei einem anderen Drucker als erwartet oder verschwindet scheinbar spurlos. Das liegt am Drucker-Umleitungssystem, das den Druckauftrag an den ersten verfügbaren Drucker weiterleitet. Wenn Sie dieses seltsame Verhalten beobachten, lesen Sie bitte diesen Artikel, um das Problem zu beheben: Integration Prints Are Sent to Wrong or Random Printers.
Datenbanktyp oder Feldnamen stimmen nicht überein
Wenn Ihre Integration eine Datenbank verwendet und Daten von einer Integration erhält, müssen Sie sicherstellen, dass der Datenbanktyp übereinstimmt. Angenommen, Ihr Etikett ist mit einer durch Kommas getrennten (CSV) Datenbank verbunden, aber Ihre Integration sendet Daten, die durch Tabulatoren getrennt sind oder sogar ein ganz anderes Format wie XML haben. Das führt zu einem Konflikt zwischen den Datenbanktypen und das Dokument kann die gesendeten Daten nicht verarbeiten. Dies kann zu verschiedenen Integrationsfehlern führen, die auf Probleme mit der Datenbank, Feldern oder leeren Daten hinweisen.
Auch wenn die Datenbanktypen übereinstimmen, können unterschiedliche Feldnamen oder deren Reihenfolge ähnliche Integrationsfehler verursachen.
Um sicherzustellen, dass die Datenbanken korrekt übereinstimmen, können Sie Folgendes tun:
- Öffnen Sie die Etikettendatei in BarTender Designer. Gehen Sie zu Datei > Datenbankverbindung einrichten. In diesem Dialog können Sie die Feldnamen und den Typ der mit Ihrem Etikett verbundenen Datenbank überprüfen.
- Außerdem finden Sie in diesem Dialog den Namen der verbundenen Datenbank und können diese auf Ihrem Computer öffnen, um das Format (z. B. CSV vs. tab-getrennt) und die Feldnamen zu überprüfen.
- Vergleichen Sie die verbundene Datenbank mit den im Trigger enthaltenen Daten.
Wenn die Datenbank Ihres Etiketts keine Textdatei ist (oder ab BarTender 2019 R5 eine Excel-Datei), schlägt die Integration immer mit einem Datenbankkonflikt fehl. Ist Ihr Etikett mit einer nicht unterstützten Datenbank verbunden, müssen Sie die Verbindung auf eine unterstützte Datenbank ändern und Ihre Objekte auf dem Etikett so konfigurieren, dass sie auf das neue Feld zugreifen.
Etikett enthält nur Standarddaten
Das passiert, weil die Integration beim Drucken keine Daten an das Etikett übergibt. Der Grund ist meist, dass die Integration nicht entsprechend konfiguriert wurde (Standardverhalten) und tritt nur bei einer Dokument drucken-Aktion auf. Hier sind die beiden Szenarien mit diesem Problem und wie Sie sie beheben:
- Datenbankinformationen übergeben: Die Integration muss angewiesen werden, die Informationen zu überschreiben. Dies finden Sie im Bereich „Datenbanküberschreibungen“ der Dokument drucken-Aktion auf der Registerkarte „Druckoptionen“. Sie müssen die Datenbank mit Integrationsdaten oder EventData überschreiben, um die Triggerdaten an das Etikett zu übergeben.
- Benannte Datenquellen nicht definiert: Integrationen müssen wissen, wie Variablen mit benannten Datenquellen auf dem Etikett verknüpft werden. Wenn Sie feststellen, dass unter der Registerkarte „Benannte Datenquellen“ benannte Datenquellen mit gleichem Namen fehlen, klicken Sie auf die Schaltfläche „Dokumenteinstellungen importieren“ auf der Registerkarte „Dokumente“ und ordnen Sie dann die importierten benannten Datenquellen den Integrationsvariablen zu.
Wichtige Erkenntnisse
- Um diesen Schritt optimal zu überprüfen, reduzieren Sie die Anzahl der Aktionen auf das Minimum und fügen Sie sie dann einzeln hinzu, um zu sehen, wo das Problem liegen könnte.
- Daten sind in diesem Schritt eine häufige Fehlerquelle. Wenn Sie sie hier korrigieren, vermeiden Sie Probleme in den nächsten Schritten.
BTXML-Druckdatei erstellen
Der Druckteil des Integrationszyklus basiert auf einer formatierten XML-Version namens BTXML. Sie enthält Dokument- und Druckerinformationen sowie alle Daten aus der Triggerdatei, die Sie an das Etikett übergeben möchten.
Sie können zwar Ihr eigenes BTXML erstellen und es über eine Integration mit der Aktion „BTXML drucken“ senden, aber das müssen Sie nicht! Die Integration wandelt Ihre Daten und Einstellungen in der Druckaktion automatisch in BTXML um.
Wenn Sie alle vorherigen Schritte zur Fehlerbehebung durchlaufen haben, wird das BTXML korrekt konvertiert und Sie können mit dem nächsten Schritt fortfahren.
Automatischer Druck
Der letzte Schritt im Integrationszyklus, bevor er erneut beginnt, ist der eigentliche Druckvorgang. Dieser wird vollständig vom Print Scheduler-Dienst automatisch abgewickelt und folgt einem einfachen Ablauf. Hier ist ein Ausschnitt aus dem Flussdiagramm am Anfang dieses Artikels:
Sobald das BTXML-Skript aus dem vorherigen Schritt an den Print Scheduler gesendet wurde, beginnt dieser Schritt sofort. Der Dienst öffnet die Druck-Engine und interpretiert, welche Etikettendatei geöffnet werden muss (falls sie nicht bereits in einer Engine geöffnet ist). Sobald das Dokument geöffnet ist, werden die Daten – falls von der Integration übergeben – entweder per Datenbanküberschreibung oder benannten Datenquellen an die richtigen Stellen auf dem Etikett eingefügt. Nach der Datenverarbeitung wird das Etikett an den im BTXML angegebenen Drucker oder, falls keiner angegeben ist, an den mit dem Etikett verknüpften Drucker gesendet.
Da all dies automatisch im Dienst abläuft, was passiert, wenn etwas schiefgeht? Wie gehen Sie bei der Fehlersuche vor? Da Sie die meiste Arbeit bereits in den vorherigen Schritten erledigt haben, ist die Fehlersuche in diesem Schritt einfacher als gedacht.
Wie in der Einleitung dieses Leitfadens erwähnt, sind die von Print Scheduler verwendeten Druck-Engines eigentlich BarTender Designer, die als Dienst ausgeführt werden. Das bedeutet, dass Sie diesen Schritt direkt mit dem Designer selbst überprüfen können.
Grundlegende Fehlerbehebung
Beim Drucken druckt eine Druck-Engine automatisch eine Etikettendatei gemäß den Anweisungen des BTXML-Skripts. Wenn Sie dieses Skript nachahmen möchten, öffnen Sie ein Etikett, gehen zu Datei > Drucken, ändern den Druckernamen und drucken das Dokument. Es gibt noch ein paar zusätzliche Schritte, die ein BTXML-Skript ausführen kann, aber diese einfache Aktion verrät uns schon viel darüber, was in einer unsichtbaren Druck-Engine passiert.
Dokument öffnen und drucken
Das grundlegendste Verhalten einer Druck-Engine ist das Öffnen und Drucken von Dokumenten. Während in den vorherigen Schritten überprüft wurde, ob sich das Dokument am richtigen Ort befindet, wird beim Öffnen geprüft, ob die Druck-Engine das Dokument während des Druckvorgangs korrekt verwenden kann.
- Versuchen Sie, das Dokument zu öffnen. Lässt es sich öffnen oder erscheinen Fehler- oder Hinweismeldungen?
- Wenn Sie versuchen, das Dokument zu drucken, wird es gedruckt oder erscheinen Fehler- oder Warnmeldungen?
Wenn in einem der beiden Fälle ein Dialogfeld mit Warnungen oder Fehlern erscheint, könnten diese den automatischen Druckvorgang behindern. Der nächste Abschnitt hilft Ihnen bei der Behebung dieser Dialoge.
Fehler- und Warnmeldungen
Obwohl eine Druck-Engine die meisten Dialogfelder umgehen kann, führen einige dazu, dass der Druck übersprungen oder mit einem Fehler abgebrochen wird. Manchmal werden diese Informationen nicht korrekt im Integrationsprotokoll angezeigt, daher kann es helfen, gezielt auf solche Dialoge zu achten.
Hier einige Beispiele für Dialoge, die zwar umgangen werden können, aber dennoch Integrationsprobleme verursachen können:
- Seitenanpassungsdialog: Wenn ein Drucker ein etwas anderes Medium verwendet, passt BarTender das Etikett automatisch an. Sieht das Etikett seltsam aus, könnte dies an einem anderen Medium liegen. Passen Sie das Etikett an und speichern Sie es mit dem Integrationsdrucker, um diesen Dialog künftig zu vermeiden.
- Abschneidewarnung: In frühen Versionen von BarTender 2019 war diese Warnung ein Fehler, der den Druck stoppte. Falls der Druck hier stoppt, aktualisieren Sie bitte Ihre Software.
- TrueType-Schriftarten-Ersetzungsmeldung: Diese Meldung kann im Druckdialog deaktiviert werden. Sie konnte nicht umgangen werden, daher empfiehlt es sich, diesen Dialog auszuschalten.
Hier einige Dialoge, die den Druck stoppen und zu einem Fehler führen können. Diese erscheinen möglicherweise auch in den Integrationsmeldungen:
- Fehler im Seitengrößendialog: Diese Meldung kann erscheinen, wenn die Integration ein Dokument automatisch anpasst, die Vorlage aber auf eine feste Größe eingestellt ist oder die Größe die Spezifikationen des Druckerherstellers überschreitet. Öffnen Sie in diesem Fall den Seitendialog über Datei > Seite einrichten und überprüfen Sie die Details und Einstellungen auf der Registerkarte „Seite“. Prüfen Sie auch auf der Registerkarte „Layout“, ob nicht zu viele Spalten oder Zeilen eingestellt sind.
- Datenbankverbindungsfehler: Diese können auftreten, wenn eine Datenbankdatei verschoben wurde oder nicht mehr verfügbar ist. Stellen Sie die Verbindung über Datei > Datenbankverbindung einrichten wieder her und speichern Sie das Dokument.
- Vorlage verweist nicht auf Datenbankfelder: Siehe Fehler 3600: Vorlage verweist nicht auf Datenbankfelder.
- Bilder oder verknüpfte Objekte fehlen: Dieser Fehler kann auftreten, wenn verknüpfte Bilder oder Objekte verschoben wurden oder sich an einem nicht mehr verfügbaren Netzwerkstandort befinden. BarTender druckt erst, wenn die Objekte oder Bilder wieder verknüpft wurden.
- Ein Fehler mit Bezug auf TMP: Das Etikett oder eine verknüpfte Ressource ist vermutlich beschädigt. Es wird empfohlen, ein Backup des Etiketts wiederherzustellen oder es neu zu erstellen.
Dies ist keine vollständige Liste, aber sie deckt die häufigsten Probleme ab, die bei der Fehlersuche auftreten können.
Wichtige Erkenntnisse
- Diesen automatisierten Schritt können Sie mit BarTender Designer überprüfen.
- Dialoge geben oft Hinweise auf das Problem.
Weitere Fehlerbehebung
Manchmal lässt sich das Problem nicht direkt im Integrationszyklus finden. Hier sind einige zusätzliche Ressourcen, die dir bei verschiedenen Situationen helfen können, die im obigen Artikel nicht aufgeführt sind.
Allgemein
Die Integration stoppt plötzlich
Integrationen können aus vielen Gründen stoppen, von denen einige im obigen Artikel behandelt werden. Der häufigste Grund, der dort nicht genannt wird, ist, dass die Ressource plötzlich nicht mehr verfügbar ist. Das kommt besonders häufig bei Datenbankintegrationen und Datei-Integrationen mit Cloud-Speicherorten vor. BarTender 2021 versucht, die Integration neu zu starten, sobald die Ressource wieder verfügbar ist, aber frühere Versionen stoppen die Integration einfach.
Wenn deine Integration plötzlich stoppt, prüfe die Protokolle auf den letzten Fehler, um die Ursache zu ermitteln.
Datei-Integrationen
Integration läuft langsam
Viele Faktoren können dazu führen, dass eine Datei-Integration langsam läuft, aber diese Art der Integration ist besonders anfällig für bestimmte Faktoren. Die Größe des Scan-Ordners ist dabei wichtig. Da eine Datei-Integration darauf angewiesen ist, den Scan-Ordner nach neuen Dateien zu durchsuchen, dauert der Scan immer länger, je mehr Dateien in diesem Ordner landen.
Wenn deine Integration nicht so eingestellt ist, dass eine Trigger-Datei nach der Verarbeitung gelöscht oder verschoben wird, sammeln sich diese Trigger-Dateien mit der Zeit an. Wenn du bemerkst, dass deine Integration langsam läuft, entferne verarbeitete Trigger-Dateien aus dem Scan-Ordner, um zu sehen, ob sich die Geschwindigkeit verbessert.
Datenbank-Integrationen
Doppelte Datensätze oder mehrfacher Druck
Wenn eine Datenbank-Integration eine Tabelle durchsucht und das Etikett ebenfalls mit dieser Tabelle verbunden ist, erhältst du wahrscheinlich doppelte Etiketten. Sieh dir bitte diese Artikel an, um zu erfahren, wie du dieses Problem behebst und wie du deine Datenbank-Integration und Etiketten richtig einrichtest:
- Mehrfache Ausdrucke der ausgewählten Datensatzmenge aus einer Datenbank-Integration
- Dokument mit Datenbank-Triggern drucken (Video – 7:27)
Integration nimmt Datensätze nur langsam auf
Integrationen können aus vielen Gründen langsam laufen, aber es gibt eine spezielle Situation bei Datenbank-Integrationen. Eine Datenbank-Integration durchsucht eine komplette Tabelle, um nach neuen Datensätzen zu suchen, die den Vorgaben im Trigger-Bereich entsprechen. Wenn eine Datenbanktabelle sehr groß wird, verlangsamt sich dieser Prozess, da mit jedem neuen Datensatz die Abfrage länger dauert und der Datenbankserver stärker belastet wird.
Es wird empfohlen, nicht mehr benötigte Datensätze regelmäßig aus der Datenbank zu entfernen oder die Integration so einzustellen, dass Datensätze nach der Verarbeitung gelöscht werden, um die Belastung für Datenbank und Integration zu verringern.
Socket-Integrationen
Fehler: Auf freigegebenes Objekt kann nicht zugegriffen werden
Wenn du feststellst, dass deine Integration Etiketten überspringt, findest du möglicherweise den Fehler "Auf freigegebenes Objekt kann nicht zugegriffen werden" in den Protokollen. Das bedeutet, dass der Socket zwischen den Aufträgen nicht richtig geschlossen wird. Wie du dieses Problem behebst, erfährst du hier: Integrationsfehler beim Ausführen einer Socket-Integration.
Brauchst du noch Hilfe? Kontaktiere uns!
Auch wenn das Drücken des Start-Buttons oder das automatische Starten der Integrationen einfach erscheint, ist dies ein entscheidender erster Schritt im Integrationszyklus. Dieser Schritt weist die Integration an, nach dem Auslöser zu suchen. Wenn etwas schiefgelaufen ist oder der Trigger-Ort nicht mehr verfügbar ist, wartet die Integration entweder endlos oder es tritt ein Fehler auf.
Jede Integrationsart hat in Ihrer Integrationsdatei einen anderen Namen für diese Information und muss entsprechend konfiguriert werden. Für alle Integrationsarten sind die Einstellungen für Ihre Integration der erste Unterabschnitt im Abschnitt Integration und geben an, wonach gesucht wird. In diesem Screenshot handelt es sich um eine Dateiintegration, daher ist "Dateierkennung" als Unterabschnitt angegeben, da nach Dateien gesucht wird, die die Integration auslösen.
Häufige Probleme in diesem Schritt betreffen Berechtigungen, Dateinamen und Trigger-Einstellungen. Wenn Sie versuchen, die Integration im Integration Builder zu starten, erscheint möglicherweise sofort eine Fehlermeldung, die auf das Problem hinweist.
Hier einige Szenarien für die gängigsten Integrationsarten, die in diesem Schritt zu Problemen führen können:
Datei-Integrationen
Bei Datei-Integrationen sind Berechtigungen und Speicherorte entscheidend.
Wenn die Integration den Ordner nicht erreichen kann, tritt meist ein Berechtigungs- oder Zugriffsfehler auf. Es wird empfohlen, dass Überwachungsordner kein virtuelles Laufwerksbuchstaben (also kein physisches Laufwerk) verwenden und sich nicht in "Eigene Dokumente" oder auf dem Desktop befinden.
Es wird außerdem empfohlen, dass ein Überwachungsordner nur auf einem Windows-basierten System gehostet wird. Wenn Sie Unix, Linux oder ein anderes Betriebssystem für Ihr Scan-Verzeichnis nutzen möchten, sollten Sie einen Cloud-Speicher wie FTP in Betracht ziehen.
Handelt es sich um einen Netzwerkordner, erhöhen Sie die Berechtigungen Ihrer Integration, damit sie ordnungsgemäß darauf zugreifen kann.
Datenbank-Integrationen
Der Zugriff auf die Datenbank ist entscheidend. Prüfen Sie Folgendes:
Diese Einstellungen finden Sie alle im Dialogfeld für die Verbindungseinstellungen. Wie bei der Fehlersuche einer Datenbankverbindung auf einem Etikett können Sie dieses Dialogfeld über die Schaltfläche "Datenbankverbindung einrichten..." öffnen, um zu prüfen, ob die Verbindung zur Datenbank funktioniert. Falls nicht, wird eine Fehlermeldung angezeigt.
Socket-Integrationen
Netzwerkverbindungen sind hier besonders wichtig. Wenn Sie keine Verbindung herstellen können, prüfen Sie zunächst die Verbindung selbst.
Integrationen benötigen einen freien Port. Wenn auf dem Port bereits etwas anderes läuft, tritt meist ein Fehler auf und die Integration meldet, dass der Port nicht verfügbar ist. Wie bei anderen Integrationen gibt eine Fehlermeldung oft Hinweise auf das Problem und dessen Behebung.
Wichtige Hinweise
Auch wenn sich dieser Schritt je nach Integrationsart unterscheidet, gibt es einige zentrale Punkte für die Fehlersuche bei allen Typen: