Überblick

Beim Versenden von Daten über eine Socket-Verbindung oder in einer Webservice-Integration haben Sie die Möglichkeit, mehr als einen Datensatz zu senden – ähnlich wie bei einer Tabellenstruktur in einer Datei-Integration. So können Sie mehr Informationen in einer einzigen Trigger-Datei übertragen.

Wenn Sie eine neue Integration erstellen, wird standardmäßig nur ein Datensatz gelesen und verarbeitet. Mit einigen zusätzlichen Aktionen können Sie die Integration jedoch so einrichten, dass mehrere Datensätze verarbeitet werden.

Gilt für

BarTender 2019 und neuer

Automation Edition und höher

Informationen

Es ist möglich, Daten über TCP oder per POST zu senden, die bereits eine „tabellenähnliche“ Struktur haben, wie im folgenden Beispiel:

Um die Inhalte von „flachen“ Dateien als Variablen nutzen zu können, sind zunächst zwei zusätzliche Aktionen erforderlich: „Für jeden Datenbankdatensatz“ und „Text in Datensatzmenge umwandeln“:

Diese beiden Aktionen können „unabhängig vom Integrationstyp“ verwendet werden, da sie auf den Werten der Variablen %EventData% basieren. Diese Variable speichert alle eingehenden Daten für die Integration.

Die Aktion „Text in Datensatzmenge umwandeln“ kann nur textbasierte Datenbanken wie CSV, tab-getrennte oder ähnlich strukturierte Datenbanken verarbeiten. Komplexere textbasierte Datenbanken wie XML oder JSON funktionieren damit nicht richtig.

Einrichten der Aktion „Text in Datensatzmenge umwandeln“

Die erste Aktion, die definiert werden muss, ist die Aktion „Text in Datensatzmenge umwandeln“ (diese Aktion wandelt die Daten in eine datenbankähnliche Struktur um):

1. Zuerst benötigen Sie eine „Beispiel“-Datei, mit der die Struktur der eingehenden Daten definiert wird. Verwenden Sie zum Beispiel ein Beispieldokument mit derselben Struktur, die später für die zu sendenden Daten per TCP oder POST verwendet wird.
   
2. Klicken Sie auf die Schaltfläche „Datenbankverbindung einrichten...“ und verwenden Sie den Assistenten, um die „Beispiel“-Datenbankdatei mit der Integration zu verknüpfen. Nachdem Sie die Datenbank verbunden haben, schließen Sie den Dialog.
   
   
   
3. Stellen Sie bei der Option „Textquelle“ sicher, dass die „Variable“ auf „%EventData%“ gesetzt ist und dass auch die Ausgabe „%EventData%“ ist.
   

Das bedeutet, dass die Aktion die Daten aus der Variablen „%EventData%“ verwendet – das ist die Variable, in der die Integration automatisch alle eingehenden Daten speichert.

Einrichten der Aktion „Für jeden Datenbankdatensatz“

Nachdem die Daten in einzelne Datensätze aufgeteilt wurden, muss die Integration wissen, wie sie mit diesen Datensätzen umgehen soll. Die Aktion „Für jeden Datenbankdatensatz“ mit einer untergeordneten „Dokument drucken“-Aktion sorgt dafür, dass jeder Datensatz beim Drucken einzeln verarbeitet wird:
​​
Für die Aktion „Für jeden Datenbankdatensatz“ ist keine weitere Einrichtung erforderlich. Sie müssen jedoch festlegen, wie die Daten auf das Etikett übertragen werden. Dies geschieht in der Aktion „Dokument drucken“.

1. Richten Sie zunächst alle Werte auf Ihrem Etikett als Benannte Datenquellen ein.
2. Klicken Sie auf die Schaltfläche „Dokumenteinstellungen importieren“, um die Namen der Benannten Datenquellen zu importieren und auszufüllen.
3. Ordnen Sie anschließend die Benannten Datenquellen des Etiketts den Feldnamen aus der Beispieldatenbank zu. Falls Sie keine Feldnamen vergeben haben, werden automatisch Namen wie Feld1, Feld2 usw. verwendet.
4. Wählen Sie das Variablensymbol in der Tabelle der Benannten Datenquellen, um den Namen des Feldes aus dem Dialog einzufügen. Die Feldnamen finden Sie im Abschnitt Aktion, wie unten gezeigt:

Wenn Sie die Feldnamen kennen, können Sie diese auch manuell im Format %FELDNAME% eingeben.
​