Übersicht

Das Ziel dieses Beispiels ist es, mithilfe einer Webdienst-Integration ein BarTender-Dokument zu drucken. Ein Webdienst ist ein Softwaresystem, das für die interoperable Interaktion zwischen Maschinen über ein Netzwerk entwickelt wurde. Jede Anwendung, die eine Webdienst-Anfrage senden kann, kann die Integration auslösen.

In diesem Beispiel ermöglicht ein Webdienst das Senden einer GET-Anfrage an den BarTender Integration Service über eine Webdienst-Integration. Der Webdienst übermittelt Werte, die die Integration für benannte Datenquellen im BarTender-Dokument verwendet.

Szenario

Ein Unternehmen mit einem externen ERP-System muss ein Textfeld und einen Barcode-Wert in einem BarTender-Dokument per Webanfrage befüllen. Dazu werden die Webanfrage-Daten an eine Integration übergeben, die die Daten an die benannten Datenquellen des angegebenen BarTender-Dokuments weiterleitet. Die benannten Datenquellen füllen dann zur Druckzeit das Textobjekt und das Barcode-Objekt im Dokument aus.

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.
6. Klicken Sie auf Schließen, um den Drucken-Dialog zu schließen.
7. Wählen Sie im Menü Datei die Option Seite einrichten, um den Seite einrichten-Dialog 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 Option Text und dann Einzeilig.
10. Klicken Sie auf die Vorlage, um das Textobjekt zu platzieren.
11. Wählen Sie im Menü Erstellen die Option Barcode und dann Code 128.
12. Klicken Sie auf die Vorlage, um das Barcode-Objekt zu platzieren.
13. Doppelklicken Sie auf den Rahmen um das Textobjekt, um den Dialog Texteigenschaften zu öffnen.
14. Klicken Sie auf der Registerkarte Datenquelle rechts neben dem Feld Name auf , um den Assistenten zum Ändern des Datenquellennamens zu öffnen.
15. Geben Sie im Feld Name „Company“ (ohne Anführungszeichen) ein.
16. Klicken Sie auf OK, um den Assistenten zu schließen.
17. Belassen Sie den Typ auf Eingebettete Daten.
18. Geben Sie im Feld Eingebettete Daten Ihren Firmennamen ein.
19. Klicken Sie auf Schließen, um den Dialog Texteigenschaften zu schließen.
20. Doppelklicken Sie auf das Barcode-Objekt, um den Dialog Barcode-Eigenschaften zu öffnen.
21. Klicken Sie auf der Registerkarte Datenquelle rechts neben dem Feld Name auf , um den Assistenten zum Ändern des Datenquellennamens zu öffnen.
22. Wählen Sie Datenquelle benennen.
23. Geben Sie im Feld Name „IDNumber“ (ohne Anführungszeichen) ein.
24. Klicken Sie auf OK, um den Assistenten zu schließen.
25. Belassen Sie den Typ auf Eingebettete Daten.
26. Geben Sie im Feld Eingebettete Daten eine beliebige vierstellige Zahl ein.
27. Klicken Sie auf Schließen, um den Dialog Barcode-Eigenschaften zu schließen.
28. Speichern Sie die Datei als GETSampleDocument.btw.
29. Schließen Sie BarTender.

Integrationsdatei erstellen

1. Öffnen Sie den Integration Builder.
2. Klicken Sie auf Neue Integration erstellen, um den Dialog Neue Integration zu öffnen.
3. Klicken Sie auf Webdienst und dann auf OK.
4. Stellen Sie im Bereich Webdienst-Integration sicher, dass Dienst ausgewählt ist.
5. Wählen Sie im Bereich Webdienst-Integration Integration aus.
6. Geben Sie im Bereich Eigenschaften Ihrer Integration einen Namen und optional eine Beschreibung.
7. Wählen Sie im Dropdown-Menü Integration starten die Option Automatisch.
8. Wählen Sie im Bereich Webdienst-Integration Antwort aus.
9. Wählen Sie im Bereich Eigenschaften unter Antwort im Dropdown-Menü Content-type die Option application/json aus.
10. Wählen Sie im Dropdown-Menü Quelle die Option Aktionsübersicht, damit Sie nach der Ausführung der Integration eine Zusammenfassung erhalten.
8. Wählen Sie im Bereich Webdienst-Integration Variablen aus.
8. Scrollen Sie zum unteren Ende des Bereichs Eigenschaften und klicken Sie auf . Geben Sie im Feld Name „Company“ (ohne Anführungszeichen) ein.
8. Klicken Sie auf , um eine weitere neue Variable zu erstellen. Geben Sie im Feld Name „IDNumber“ (ohne Anführungszeichen) ein.
11. Wählen Sie im Bereich Webdienst-Integration unter Aktionen die Option Dokument drucken aus.
12. Geben Sie im Bereich Eigenschaften unter Dokument den Pfad und Dateinamen des zuvor erstellten BarTender-Dokuments, GETSampleDocument.btw, ein.
12. Klicken Sie auf , um die Benannten Datenquellen und Druckoptionen-Überschreibungen zur Integration hinzuzufügen.
13. Scrollen Sie zu Benannte Datenquellen. Falls noch nicht aktiviert, aktivieren Sie Werte für benannte Datenquellen angeben.
14. Löschen Sie in der Liste Benannte Datenquellen den aktuellen Wert für die benannte Datenquelle Company.
15. Klicken Sie rechts in der Spalte Wert auf und wählen Sie Variablen aus.
16. Wählen Sie im Dialog Variable einfügen die Option Company und klicken Sie auf OK. Dadurch wird der Wert der benannten Datenquelle Company auf %Company% gesetzt.
17. Löschen Sie in der Liste Benannte Datenquellen den aktuellen Wert für die benannte Datenquelle IDNumber.
18. Klicken Sie rechts in der Spalte Wert auf und wählen Sie Weitere Variablen aus.
19. Wählen Sie im Dialog Variable einfügen die Option IDNumber und klicken Sie auf OK. Dadurch wird der Wert der benannten Datenquelle IDNumber auf %IDNumber% gesetzt.
20. Klicken Sie oben links im Integration Builder auf , um die Integrationsdatei als WebRequestPrint.btin zu speichern.

Die Integration ist nun bereit zur Bereitstellung.

Integration bereitstellen

1. Klicken Sie in der Symbolleiste des Integration Builders auf Integration bereitstellen, um den Dialog Neue Bereitstellung zu öffnen.
2. Geben Sie im Dialog Neue Bereitstellung einen Namen und eine Beschreibung für Ihre Bereitstellung ein.
3. Stellen Sie sicher, dass bei Integrationsdatei WebRequestPrint.btin aufgeführt ist. Andernfalls klicken Sie auf Durchsuchen und wählen Sie WebRequestPrint.btin aus.
4. Fügen Sie unter Zielserver den oder die Server hinzu, auf denen Sie die Integrationsdatei bereitstellen möchten.
5. Legen Sie die gewünschten Einstellungen für die Fehlerbehandlung fest.
6. Klicken Sie auf OK, um den Dialog zu schließen und die Integrationsdatei bereitzustellen.
7. Die Verwaltungskonsole ö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 Webdienst. Senden Sie die Webanfrage über die URL mit Ihrer bevorzugten Methode. Die URL sieht etwa so aus: http://<host>/Integration/WebRequestPrint/Execute.

2. Der Integration Service liest die Webanfrage und übergibt die Werte an BarTender.
3. Die benannten Datenquellen des BarTender-Dokuments werden nun mit den Werten aus der Webanfrage befüllt.
4. Das BarTender-Dokument wird gedruckt.