Überblick

Das Ziel dieses Beispiels ist es, eine Netzwerksocket-Integration zu erstellen, die ein BTXML-Skript in einer Aktion enthält. BarTender XML Script (BTXML Script) ermöglicht eine einfache Automatisierung von BarTender und bietet Drittentwicklern eine unkomplizierte Möglichkeit, BarTender in ihre Anwendungen zu integrieren.

Nach dem Ausführen eines BTXML-Skripts wird eine XML-Antwort erstellt. Diese XML-Antwort liefert Ihnen wertvolle Informationen zum Druckauftrag, wie z. B. den verwendeten Drucker, die BarTender-Einstellungen während des Druckvorgangs und vollständige Details zu den gedruckten Etiketten.

Szenario

Ein Unternehmen muss einen Druckauftrag mit 100 serialisierten Artikeln an Fach 1 seines HP LaserJet-Druckers senden. Der Druckauftrag wird ausgeführt, wenn Daten – in diesem Fall ein BTXML-Skript – über einen Netzwerksocket gesendet und vom BarTender Integration Service gelesen werden.

Implementierung

Die folgenden Schritte beschreiben, wie Sie die Integration für das oben beschriebene Szenario einrichten, bereitstellen und überprüfen.

BarTender-Dokument erstellen

1. Öffnen Sie BarTender.
2. Wählen Sie im Menü Datei die Option Neu, um den Assistenten für neues Dokument zu öffnen.
3. Wählen Sie Leere Vorlage und klicken Sie dann auf Fertig stellen, um den Assistenten zu schließen. Ein neues Dokument wird in BarTender angezeigt.
4. Wählen Sie im Menü Datei die Option Drucken, um den Drucken-Dialog zu öffnen.
5. Wählen Sie im Dropdown-Menü Name den gewünschten Drucker aus. Achten Sie darauf, den Druckernamen im BTXML-Skript an den hier ausgewählten Drucker anzupassen.
6. Klicken Sie auf Schließen, um den Drucken-Dialog zu beenden.
7. Wählen Sie im Menü Datei die Option Seite einrichten, um den Dialog Seite einrichten zu öffnen und konfigurieren Sie die Seite nach Bedarf.
8. Wenn Sie die Seiteneinstellungen abgeschlossen haben, klicken Sie auf OK, um den Dialog zu schließen.
9. Wählen Sie im Menü Erstellen die gewünschten Vorlagenobjekte aus und gestalten Sie Ihr BarTender-Dokument nach Wunsch.
10. Wählen Sie im Menü Datei die Option Speichern unter und speichern Sie das BarTender-Dokument unter dem Namen Scriptdoc.btw.
11. Schließen Sie BarTender.

BTXML-Skript-Triggerdokument erstellen

<?xml version="1.0" encoding="utf-8"?>		
<XMLScript Version="2.0">
	<Command Name="Job1">
		<Print>
			<Format>c:\BarTender\Scriptdoc.btw</Format>
			<PrintSetup>
			        <NumberSerializedLabels>100</NumberSerializedLabels>
				<Printer>HP LaserJet</Printer>
				<PaperTray>Tray 1</PaperTray>
			</PrintSetup>
		</Print>
	</Command>
</XMLScript>

<?xml version="1.0" encoding="utf-8"?> 

Kopieren Sie das BTXML-Skript in eine Textdatei und speichern Sie diese unter dem Namen BTXMLScript.txt.

Integrationsdatei erstellen: Netzwerksocket-Integration auswählen

1. Öffnen Sie den Integration Builder.
2. Klicken Sie auf Neue Integration erstellen, um den Dialog Neue Integration zu öffnen.
3. Klicken Sie auf Netzwerksocket und dann auf OK.
4. Wählen Sie im Bereich Netzwerksocket-Integration die Option Integration aus.
5. Geben Sie im Bereich Eigenschaften den Namen Ihrer Integration als "Print 100" ein.
6. Wählen Sie im Dropdown-Menü Integration starten die Option Automatisch.
7. Geben Sie unter Benutzerkonto die Benutzeranmeldedaten an. Weitere Informationen finden Sie unter Dokument mit einer leeren Datei drucken.
8. Wählen Sie im Bereich Netzwerksocket-Integration die Option Socket aus.
9. Legen Sie im Bereich Eigenschaften Ihr Protokoll und die Port-Informationen fest.
10. Wählen Sie unter Netzwerkadresse die Option Auf allen Netzwerkschnittstellen lauschen. Alternativ können Sie Auf bestimmter IP-Adresse lauschen auswählen und eine IP-Adresse aus der Liste wählen oder manuell eingeben.
11. Legen Sie Ihre Kommunikationseinstellungen und das Verbindungsprotokoll nach Wunsch fest.
12. Wählen Sie im Bereich Netzwerksocket-Integration die Option Eingabedaten aus.
13. Wählen Sie im Bereich Eigenschaften für die Eigenschaft Kodierung Unicode (UTF-8) aus.
14. Wählen Sie bei Lesen beenden, wenn die Option Zeichenfolge empfangen aus.
15. Geben Sie im Feld Zeichen </XMLScript> ein.
16. Aktivieren Sie Zeichenfolge in Eingabedateninhalt einbeziehen.
17. Wählen Sie bei Eingabedatenformat BTXML Script aus.
18. Wählen Sie im Bereich Netzwerksocket-Integration die Option Antwort aus.
19. Wählen Sie im Bereich Eigenschaften Ihre Antwortoptionen aus.

Integrationsdatei erstellen: Aktion zur Netzwerksocket-Integration hinzufügen

1. Wählen Sie im Bereich Netzwerksocket-Integration die Option Aktionen aus.
2. Wählen Sie im Bereich Eigenschaften bei Aktionen ausführen die Option Sequenziell aus.
3. Geben Sie bei Aktionen wiederholen "1" an.
4. Klicken Sie im Bereich Netzwerksocket-Integration unter Aktion auf  rechts neben Dokument drucken, um die Standardaktion zu entfernen.
5. Wählen Sie Aktion aus und klicken Sie auf  Hinzufügen, um den Dialog Neue Aktion zu öffnen.
6. Wählen Sie in der linken Navigationsleiste unter den Aktionstypen Drucken und dann BTXML Script drucken aus.
7. Klicken Sie auf OK, um den Dialog Neue Aktion zu schließen.
8. Die Aktion BTXML Script drucken erscheint im Bereich Netzwerksocket-Integration unter Aktionen.
9. Falls noch nicht ausgewählt, klicken Sie im Bereich Netzwerksocket-Integration auf BTXML Script drucken.
10. Geben Sie im Bereich Eigenschaften unter Aktion einen Namen und eine Beschreibung für die Aktion BTXML Script drucken ein.
11. Wählen Sie unter Skript im Dropdown-Menü Skriptquelle die Option Variable aus.
12. Falls noch nicht ausgewählt, wählen Sie im Dropdown-Menü Variablen EventData aus.
13. Klicken Sie oben links im Integration Builder auf , um die Integrationsdatei als BTXML_Integration.btin zu speichern.

Aktion "BTXML Script drucken" testen (nicht die gesamte Integration)

Um eine "BTXML Script drucken"-Aktion zu testen, müssen Sie einige Einstellungen für den Test ändern und diese anschließend wiederherstellen.

1. Wählen Sie im Bereich Netzwerksocket-Integration unter Aktionen die Option BTXML Script drucken aus.
2. Wählen Sie im Bereich Eigenschaften unter Skript im Dropdown-Menü Skriptquelle die Option Eingebettetes Skript aus.
3. Klicken Sie auf die Schaltfläche Importieren, um Ihre BTXML-Datei zu importieren, oder fügen Sie den Inhalt der Datei direkt in das bereitgestellte Fenster ein.
4. Klicken Sie auf die Schaltfläche Testen rechts im Skriptfenster.
5. Wenn Ihre Aktion "BTXML Script drucken" den Test besteht, wählen Sie im Bereich Netzwerksocket-Integration unter Aktionen erneut BTXML Script drucken aus.
6. Stellen Sie im Bereich Eigenschaften den Skript-Typ wieder auf Variable und den Variablen-Typ auf %EventData% zurück.

Integrationsdatei testen und bereitstellen

1. Klicken Sie in der Symbolleiste des Integration Builders auf  Integration testen.
2. Wenn Ihre Integration den Test besteht, klicken Sie auf  Integration bereitstellen, um den Dialog Neue Bereitstellung zu öffnen.
3. Geben Sie einen Namen und eine Beschreibung für die Bereitstellung ein.
4. Stellen Sie sicher, dass bei der Einstellung Integrationsdatei BTXML_Integration.btin aufgeführt ist. Andernfalls klicken Sie auf Durchsuchen und wählen Sie BTXML_Integration.btin aus.
5. Fügen Sie unter Zielserver den oder die Server hinzu, auf denen Sie die Integrationsdatei bereitstellen möchten.
6. Legen Sie die gewünschten Einstellungen für die Fehlerbehandlung fest.
7. Klicken Sie auf OK, um den Dialog zu schließen und die Integrationsdatei bereitzustellen.
8. Die Administration Console öffnet sich im Knoten Integrationen und zeigt Ihre Integration an.

Szenario ausführen und Integrationsverarbeitung anzeigen

1. Der BarTender Integration Service überwacht den ausgewählten Netzwerksocket. Senden Sie den Inhalt von BTXMLScript.txt über den Netzwerksocket mit Ihrer bevorzugten Methode.
2. Der Integration Service übergibt das BTXML-Skript an BarTender.
3. BarTender führt die im BTXML-Skript angegebenen Aktionen aus und druckt 100 Exemplare des Dokuments Scriptdoc.btw über Fach 1 des angegebenen Druckers.