Überblick

In diesem Beispiel erstellen Sie eine Integration, die ein bestimmtes BarTender-Dokument druckt, nachdem eine Trigger-Datei erkannt wurde. Die Trigger-Datei selbst enthält dabei die Daten, mit denen die Platzhalter im Dokument ausgefüllt werden. Die hier verwendeten Techniken lassen sich auch auf die späteren Beispiele anwenden.

Szenario

Ein Versandhandelsunternehmen muss bei jeder verpackten Bestellung einen Artikel mit Daten aus dem Verkaufsdatensatz drucken. Die Verkaufsanwendung erzeugt dazu eine durch Kommas getrennte Textdatei und speichert sie in einem Verzeichnis, das vom Integration Service überwacht wird. Sobald die Datei erkannt wird, löscht der Integration Service die Trigger-Datei, übergibt den Inhalt an BarTender, um die Platzhalter im Dokument zu füllen, und druckt das Dokument.

Umsetzung

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

Daten-Datei einrichten

1. Erstellen Sie den Netzwerkordner, in dem die Datendateien gespeichert werden sollen. Dies ist der Ordner, den der Integration Service überwacht. In diesem Beispiel heißt er \\ShippingServer\NewOrders.
2. Erstellen Sie eine Textdatei mit den durch Kommas getrennten Daten (siehe unten). Sie können die Daten einfach kopieren und in die Textdatei einfügen.

3. BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Atlanta,GA,31002,USA,(706) 555-7788,(706) 555-6750

2. Speichern Sie die Textdatei im im ersten Schritt erstellten Verzeichnis \\ShippingServer\NewOrders und nennen Sie sie "order.txt".

BarTender-Dokument erstellen

1. Öffnen Sie BarTender.
2. Wählen Sie im Menü Datei die Option Neu, um den Neues Dokument-Assistenten zu öffnen.
3. Wählen Sie Leere Vorlage und klicken Sie dann auf Fertigstellen, um den Assistenten zu schließen.
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 und klicken Sie dann auf Schließen, um den Dialog zu beenden.
6. Wählen Sie im Menü Datei die Option Seite einrichten, um den Seite einrichten-Dialog zu öffnen und konfigurieren Sie die Seite nach Bedarf.
7. Wenn Sie die Seiteneinstellungen abgeschlossen haben, klicken Sie auf OK, um den Dialog zu schließen.
8. Wählen Sie im Menü Datei die Option Datenbankverbindung einrichten, um den Datenbank-Assistenten zu öffnen.
9. Klicken Sie auf Textdatei, um den gewünschten Datenbanktyp auszuwählen, und klicken Sie auf Weiter.
10. Auf der Seite Datei auswählen des Assistenten klicken Sie auf die Schaltfläche Datei auswählen.
11. Wechseln Sie zu \\ShippingServer\NewOrders und doppelklicken Sie auf order.txt, um die Datei auszuwählen.
12. Klicken Sie auf Weiter auf der Seite Datei auswählen des Assistenten.
13. Auf der Seite Dateiformat des Assistenten stellen Sie sicher, dass im Dropdown-Menü Feldtrennung Komma ausgewählt ist, und klicken Sie auf Weiter.
14. Auf der Seite Feldnamen des Assistenten stellen Sie sicher, dass Automatisch fortlaufende Feldnamen zuweisen ausgewählt ist, und klicken Sie auf Fertigstellen.
15. Klicken Sie auf OK, um den Datenbank einrichten-Dialog zu schließen.
16. Wählen Sie im Menü Erstellen die Option Text.
17. Wählen Sie im Dropdown-Menü Textobjekte die Option Einzeilig.
18. Klicken Sie irgendwo auf die Vorlage, um das Textobjekt hinzuzufügen.
19. Klicken Sie mit der rechten Maustaste auf das Textobjekt und wählen Sie Eigenschaften aus dem Kontextmenü, um den Dialog Texteigenschaften zu öffnen.
20. Klicken Sie im linken Navigationsbereich auf die Datenquelle des Textobjekts.
21. Auf der Registerkarte Datenquelle klicken Sie auf  rechts neben dem Feld Typ, um den Assistenten zum Ändern des Datenquellentyps zu öffnen.
22. Wählen Sie im Dropdown-Menü Datenbankfeld aus und klicken Sie auf Weiter.
23. Wählen Sie im Dropdown-Menü Feldname Feld 2 aus (im Textfile enthält das zweite Feld den Namen des Käufers).
24. Geben Sie im Feld Beispieldaten für Feld als Beispiel "Käufername" ein.
25. Klicken Sie auf Fertigstellen, um den Assistenten zu schließen.
26. Klicken Sie auf Schließen, um den Dialog Texteigenschaften zu beenden.
27. Wenn Sie weitere Datenbankfelder auf Ihrer Vorlage einfügen möchten, wiederholen Sie Schritt 16 und ordnen Sie jeweils ein Textobjekt dem passenden Feld zu. Andernfalls fahren Sie mit Schritt 28 fort.
28. Wählen Sie im Menü Datei die Option Speichern, um das BarTender-Dokument unter dem Namen NewOrderAddress.btw zu speichern.
29. Verschieben Sie die Beispieldatenbankdatei order.txt aus dem Ordner, den der Integration Service überwacht, in einen anderen Ordner.
30. Schließen Sie BarTender.

Integrationsdatei erstellen und bereitstellen

1. Öffnen Sie den Integration Builder.
2. Klicken Sie auf Neue Integration erstellen, um den Dialog Neue Integration zu öffnen.
3. Klicken Sie auf Datei und dann auf OK.
4. Wählen Sie im Bereich Datei-Integration die Option Integration.
5. Geben Sie im Bereich Eigenschaften den Namen Ihrer Integration als "Jede Bestellung" ein.
6. Wählen Sie im Dropdown-Menü Integration starten die Option Automatisch.
7. Unter Benutzerkonto geben Sie die Benutzeranmeldedaten an. Weitere Informationen finden Sie unter Dokument mit einer leeren Datei drucken.
8. Wählen Sie im Bereich Datei-Integration die Option Dateierkennung.
9. Wählen Sie im Bereich Eigenschaften unter Erkennungsoptionen im Dropdown-Menü Speicherort "Computer/Netzwerk" aus.
10. Geben Sie bei der Option Zu überwachender Ordner den Pfad ein oder navigieren Sie zu dem Ordner, den der Integration Service überwachen soll. In diesem Fall geben Sie den im Abschnitt Daten-Datei einrichten erstellten Ordner \\ShippingServer\NewOrders an.
11. Geben Sie im Feld Dateimuster "*.txt" ein. (Ohne Anführungszeichen.)
12. Scrollen Sie nach unten zum Abschnitt Aktionen nach Erkennung. Wählen Sie im Dropdown-Menü Aktion die Option Datei löschen aus. Wenn der Integration Service die Datei erkennt, liest er automatisch alle Daten aus der Datei und speichert sie in einer Variablen; danach wird die Datei nicht mehr benötigt.
13. Klicken Sie im Bereich Datei-Integration auf Dokument drucken. (Dies ist die Standardaktion.)
14. Klicken Sie im Bereich Eigenschaften unter Dokument auf die Schaltfläche Durchsuchen, um das zuvor erstellte BarTender-Dokument NewOrderAddress.btw auszuwählen. Klicken Sie auf Öffnen.
15. Scrollen Sie nach unten zu Datenbank-Überschreibungen. Wählen Sie im Dropdown-Menü Datenquelle die Option Integrations-Eingabedaten aus.
16. Klicken Sie auf  oben links im Integration Builder, um die Integrationsdatei als NewOrderAddress.btin zu speichern.
17. Klicken Sie auf  Integration bereitstellen, um den Dialog Neue Bereitstellung zu öffnen.
18. Geben Sie einen Namen und eine Beschreibung für die Bereitstellung ein.
19. Stellen Sie sicher, dass bei Integrationsdatei NewOrderAddress.btin ausgewählt ist. Andernfalls klicken Sie auf Durchsuchen und wählen Sie NewOrderAddress.btin aus.
20. Fügen Sie unter Zielserver den oder die Server hinzu, auf denen Sie die Integrationsdatei bereitstellen möchten.
21. Wählen Sie bei Zeitplan die Option Sofort aus.
22. Legen Sie die gewünschten Einstellungen für Fehlerbehandlung fest.
23. Klicken Sie auf OK, um den Dialog zu schließen und die Integrationsdatei bereitzustellen.
24. Die Administration Console öffnet sich im Knoten Integrationen und zeigt Ihre Integration an.

Szenario ausführen und Integrationsverarbeitung anzeigen

1. Klicken Sie in der Administration Console auf den Integrationsnamen "Jede Bestellung", um eine Detailansicht der Integration zu öffnen.
2. Während Sie das Beispiel-Szenario im nächsten Schritt ausführen, können Sie die einzelnen Verarbeitungsschritte der Integration im Bereich Ausgabe dieser Ansicht beobachten.
3. Kopieren Sie mit dem Windows Explorer die Textdatei order.txt in den Ordner \\ShippingServer\NewOrders.
4. Die Integration startet fast sofort, löscht die Textdatei aus dem NewOrders-Ordner und sendet das BarTender-Dokument zum Druck.