Übersicht

In diesem Beispiel erstellen wir eine Integration, bei der wir eine Bilddatei als Trigger-Datei verwenden und dieselbe Bilddatei auch beim Drucken auf dem Etikett nutzen. Solange das Bild, das Sie drucken möchten, denselben Namen wie in der Trigger-Datei trägt, können Sie das zu druckende Bild während des Druckvorgangs dynamisch ändern.

Beispieldateien

• ImageLabel.btw
• Picture.png
• ImageFileIntegration.btin

Umsetzung

Erstellen Sie einen Ordner namens Test auf Ihrem Laufwerk C:\. Wir verwenden diesen Ordner, um Ihre Dateien zu speichern und als Scan-Ordner für Ihre Integration zu nutzen. Legen Sie alle Beispieldateien in diesen Test-Ordner.

Erstellen Sie das BarTender-Dokument

Sie können die oben verlinkte Datei ImageLabel.btw verwenden oder ein neues BarTender-Dokument nach folgender Anleitung erstellen:

1. Öffnen Sie BarTender Designer
2. Erstellen Sie ein neues BarTender-Dokument
3. Wählen Sie die Bildauswahl-Option  oben aus und wählen Sie unter Externe Bilddatei die Option Dateinamen angeben...
4. Wechseln Sie in den Test-Ordner, klicken Sie auf die Datei Picture.png und dann auf Auswählen
5. Speichern Sie Ihr BarTender-Dokument und nennen Sie es ImageLabel.btw

Erstellen Sie die Integration

Sie können die oben verlinkte Datei ImageFileIntegration.btin verwenden oder eine neue Integration nach folgender Anleitung erstellen:

1. Öffnen Sie den Integration Builder
2. Wählen Sie Datei aus den verfügbaren Integrationsoptionen
   
3. Ändern Sie unter Dateierkennung das Dateimuster auf *.png
4. Stellen Sie im selben Fenster die Option Aktionen nach Erkennung auf Keine. Wir erklären gleich, warum das wichtig ist.
5. Gehen Sie zur Aktion Dokument drucken. Wählen Sie unter Dokument die Datei ImageLabel.btw als gewünschtes Etikett aus.
6. Fügen Sie eine Aktion mit dem blauen Plus-Button neben dem Aktionsbaum hinzu. Wir suchen hier speziell die Aktion Datei löschen:
   
7. Wählen Sie unter Datei die Bilddatei Picture.png aus, die gelöscht werden soll. Diese Aktion erfüllt zwei Zwecke:
   • Das Bild kann für die Aktion Dokument drucken verwendet werden, das heißt, das Etikett hat beim Drucken ein Bild als Referenz, und
   • So wird verhindert, dass die Integration in einer Endlosschleife läuft, was passieren würde, wenn Aktionen nach Erkennung auf Keine gesetzt ist.
8. Speichern Sie Ihre Integration.

Testen Sie die Integration

1. Klicken Sie im Home-Menü auf die Option Integration testen .
   
2. Klicken Sie oben rechts im Testfenster auf den Start -Button. Ihre Integration sollte nun starten.
3. Beobachten Sie die Ausgabemeldungen. Sie werden sehen, dass BarTender das Dokument druckt und anschließend das Bild löscht.
4. Sie können dies gerne erneut testen, indem Sie ein anderes Bild mit dem Namen Picture.png in den Test-Ordner legen (denken Sie daran, dass Sie jedes beliebige Bild verwenden können, solange Name und Endung Picture.png lauten, wenn es in den Trigger-Ordner gelegt wird)
   

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 der Einstellung Integrationsdatei IntegrationFile.btin (oder der von Ihnen gewählte Name) angezeigt wird.
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 Administration Console öffnet sich im Knoten Integrationen und zeigt Ihre Integration an.