Übersicht

So führen Sie Internet Printing über .NET SDKs mit BarTender durch.

Anwendbar für

BarTender 2016 und neuer.

Informationen

Web Label Print Beispiel

Als Teil der BarTender Suite haben wir ein Beispiel namens Web Label Print beigefügt. Die Web Label Print Beispielanwendung ist eine funktionierende Windows-ASP.net-Webanwendung, die zeigt, wie Sie das BarTender Print Server SDK nutzen können, um über eine Internetverbindung zu drucken. Damit können Sie auf Druckern drucken, die lokal auf dem Webserver installiert sind, auf dem BarTender läuft, sowie auf entfernten Druckern, die mit entfernten Client-Computern verbunden sind.

Dieses Beispiel ist ein guter Ausgangspunkt, um Ihre eigene Webanwendung zu entwickeln, die BarTender mithilfe unseres .NET SDK integriert.

Die Anwendung, die den vollständigen Quellcode enthält, ermöglicht dem Benutzer Folgendes:

• Drucken von BarTender-Dokumenten auf lokalen Druckern (direkt mit dem Server verbunden oder über LAN oder WAN) mit Standard-Windows-Druckfunktionen sowie auf entfernten Druckern, die über das Internet erreichbar sind.
• Auswahl, welche Art des Remote-Drucks verwendet werden soll: BarTender Web Print Service oder ein Java-Applet.
• Unterschiedliche Mechanismen zur Kommunikation mit dem Web Print Service ausprobieren (IFrame oder CORS).
• Alle auf dem Webserver und auf den über das Internet verbundenen Client-Computern installierten Drucker anzeigen.

Voraussetzungen

Um dieses Beispiel auszuführen, muss folgende Software auf dem Server installiert sein:

• BarTender 2016 oder neuer, aktiviert als Enterprise (oder Enterprise Automation) Edition.
• Visual Studio 2010 oder höher
• Microsoft .NET Framework 4.0
• Internet Information Services (IIS) 7.0 oder neuer
• ASP.NET MVC 4.0

Systemanforderungen für den Web Print Service (über IFrame). Clients, die den Web Print Service (Kommunikation über IFrame) nutzen, benötigen Folgendes:

• Jedes Windows Desktop-Betriebssystem
• Microsoft .NET Framework 4.0
• Browser: IE8+, Chrome, Firefox. Dies ist die kompatibelste Methode.

Systemanforderungen für den Web Print Service (über CORS). Clients, die den Web Print Service (Kommunikation über CORS) nutzen, benötigen Folgendes:

• Jedes Windows Desktop-Betriebssystem
• Microsoft .NET Framework 4.0
• Browser: IE10+, Chrome, Firefox. Dies ist eine deutlich einfachere und standardkonforme Methode zur Kommunikation mit domänenübergreifenden Webdiensten, ist jedoch nicht mit älteren IE-Versionen kompatibel.

Systemanforderungen für das Java-Applet. Clients, die das Java-Applet nutzen, benötigen folgende Systemvoraussetzungen:

• Jedes Desktop-Betriebssystem (Windows, Mac, Linux). Mobile Betriebssysteme können das Java-Applet nicht ausführen.
• Jeder Webbrowser, der Java-Applets ausführen kann.
• Dies ist die am weitesten kompatible Methode für das Client-Drucken, bietet jedoch im Vergleich zum Web Printing Service weniger Funktionen und Leistung.

Installation/Einrichtung

Installation des BarTender .NET SDK

Um auf das BarTender .NET SDK und die Quellcodedateien unserer Beispiele zugreifen zu können, müssen Sie die BarTender .NET SDK-Komponente installieren. Andernfalls werden Sie keine BarTender .NET SDK-Hilfedokumentation oder Beispiele sehen.

Stellen Sie während der Installation von BarTender sicher, dass Sie die BarTender .NET SDK-Komponente zur Installation auswählen. Falls Sie keine BarTender .NET SDK-Hilfedokumentation oder Beispiele sehen, müssen Sie die Installation von BarTender ändern, um das BarTender .NET SDK zu installieren. Gehen Sie dazu in die Windows-Systemsteuerung->Programme und Features->Rechtsklick auf BarTender->Ändern klicken->der Installationsassistent sollte erscheinen, damit Sie die Installation anpassen und das BarTender .NET SDK installieren können.

Zu verwendende Dateien

Die Quellcodedateien befinden sich im SDK-Ordner des Hauptinstallationsverzeichnisses der BarTender Suite.

Der Standardpfad sollte sein: C:\Program Files\Seagull\BarTender Suite\SDK\Print Server API Samples\WebLabelPrint oder C:\Program Files(x86)\Seagull\BarTender Suite\SDK\Print Server API Samples\WebLabelPrint, je nachdem, ob Sie die 32-Bit- oder 64-Bit-Version von BarTender verwenden.

In diesem Verzeichnis finden Sie die Ordner WebLabelPrint_CS für C# und WebLabelPrint_VB für Visual Basic .NET Quellcodedateien.

Der Großteil des Codes befindet sich in diesen drei Solution Explorer-Ordnern:

Das Beispiel enthält den vollständigen Quellcode und die Lösungsdateien in C# und Visual Basic .NET, die Sie mit Visual Studio verwenden und anpassen können.

Verwendung des Beispiels in Visual Studio

Dieses Beispiel enthält den vollständigen Quellcode und die Lösungsdatei, die Sie in Visual Studio öffnen und anpassen können.

Im Verzeichnis, in dem sich die Quellcodedateien des Beispiels befinden, finden Sie die Lösungsdatei (.sln), die Sie in Visual Studio öffnen können.

Wenn Sie dieses Beispiel in Visual Studio ausführen, sollten Sie Folgendes beachten:

• Wenn Sie die 64-Bit-Version von BarTender verwenden, stellen Sie sicher, dass Sie Visual Studio so einstellen, dass die 64-Bit-Version von IIS Express verwendet wird. Dies können Sie in der Regel unter Extras->Optionen->Projekte und Lösungen->Webprojekte->die Option „64-Bit-Version von IIS Express für Websites und Projekte verwenden“ aktivieren (dies kann je nach verwendeter Visual Studio-Version variieren).
• Kompilieren Sie Ihre Anwendung als .NET 4 Framework und in der passenden 32-Bit- oder 64-Bit-Version, je nachdem, welche Version von BarTender Sie verwenden.

Einrichtung des Web Label Print Beispiels in Internet Information Services (IIS)

1. Stellen Sie sicher, dass Windows Internet Information Services (IIS) installiert ist. Sie können dies über die Windows-Systemsteuerung->Programme und Features->Option „Windows-Features aktivieren oder deaktivieren“ installieren. Bei einem Windows Server-Betriebssystem müssen Sie dies über den Server-Manager installieren.
2. Kopieren Sie den WebLabelPrint-Quellordner (WebLabelPrint_CS oder WebLabelPrint_VB) von dem Ort, an dem sich das Web Label Print Beispiel befindet, in das Verzeichnis, aus dem Ihre IIS-Webanwendungen ausgeführt werden (Standardverzeichnis: C:\inetpub\wwwroot).
3. Öffnen Sie Internet Information Services (IIS).
   1. Erstellen Sie einen Anwendungspool
      1. Klicken Sie im linken Bereich mit der rechten Maustaste auf „Anwendungspools“
      2. Klicken Sie auf Anwendungspool hinzufügen
      3. Geben Sie einen Namen ein
      4. Stellen Sie sicher, dass Sie .NET Framework Version 4 auswählen, der Modus für die verwaltete Pipeline auf „Integriert“ steht, „Anwendungspool sofort starten“ aktiviert ist, und klicken Sie auf OK.
      5. Klicken Sie mit der rechten Maustaste auf den erstellten Anwendungspool und gehen Sie zu den erweiterten Einstellungen.
         1. Stellen Sie sicher, dass die Einstellung „32-Bit-Anwendungen aktivieren“ auf die richtige Bit-Version von BarTender eingestellt ist, die Sie verwenden.
         2. Außerdem sollte die „Identität“ auf ein Benutzerkonto mit den entsprechenden Berechtigungen gesetzt sein. Das Benutzerkonto ist in der Regel ein lokales Administratorkonto, das Zugriff auf BarTender und die benötigten Ressourcen wie Drucker und Dateipfade hat.
   2. Erweitern Sie im linken Bereich „Sites“ und „Standardwebsite“. Sie sollten einen Ordner sehen, der dem zuvor kopierten WebLabelPrint-Ordner entspricht.
   3. Klicken Sie mit der rechten Maustaste darauf und wählen Sie „In Anwendung konvertieren“
   4. Stellen Sie sicher, dass der Anwendungspool auf den von Ihnen erstellten gesetzt ist. Falls nicht, klicken Sie auf „Auswählen“ und wählen Sie den richtigen Anwendungspool aus.
   5. Die Webanwendung sollte nun in IIS eingerichtet sein. Um die Website zu starten, können Sie im linken Bereich mit der rechten Maustaste auf die Webanwendung klicken->zu Anwendung verwalten->Durchsuchen gehen.

Druckerkonfiguration und Druckmethoden

Es gibt zwei Hauptmethoden für das webbasierte Drucken, die wir Standarddruck und Internetdruck nennen. Standarddruck bezieht sich auf das Drucken auf Druckern, die lokal auf dem Webserver installiert sind, und Internetdruck bezieht sich auf das Drucken auf entfernten Druckern, die mit entfernten Client-Computern verbunden sind.

Für den Standarddruck ist die Konfiguration der Drucker einfach. Sie müssen lediglich die Druckertreiber lokal auf dem Webserver installieren, auf dem BarTender läuft. Die Webanwendung greift einfach auf die lokal installierten Drucker auf dem Webserver zu, um zu drucken.

Für den Internetdruck gibt es jedoch einige zusätzliche Anforderungen und Konfigurationen

• Internetdruck basiert auf der Verwendung des BarTender Web Print Service oder des Java-Applet-Plugins, je nach Client-System, um die Kommunikation zwischen Webserver und Client-Computer zu ermöglichen. Sie werden beim ersten Zugriff eines Clients auf die Website installiert.
  • Der BarTender Web Print Service ist ein Windows-Webdienst, der auf dem Client installiert wird. Die ideale Nutzung ist für Clients mit Windows-Betriebssystemen. Für andere Client-Betriebssysteme (wie Mac OSX und Linux) wird das Java-Applet-Webbrowser-Plugin verwendet.
  • Für den Internetdruck muss außerdem ein Druckertreiber auf dem Client-Computer installiert sein und ein kompatibler Druckertreiber auf dem Webserver, auf dem BarTender läuft.

Der allgemeine Ablauf des Internetdrucks ist folgender:

1. Ein Benutzer wählt in einer Webanwendung auf einem Server die Option zum Drucken aus.
2. Die Webanwendung fordert den Benutzer auf, einen entfernten Drucker auszuwählen und/oder anzugeben.
3. Die Webanwendung erhält eine Drucklizenz vom Client, auf dem der BarTender Web Print Service oder das Java-Applet-Webbrowser-Plugin läuft.
4. Mit der Drucklizenz druckt die Webanwendung das Dokument in eine Datei.
5. Der Inhalt der Druckcodedatei wird von der Serveranwendung an den Client-Computer gesendet.
6. Mithilfe von clientseitigen Skripten oder einer eigenen Anwendung sendet der Client den Druckcode an den lokalen Windows-Spooler zum Drucken, entweder über den BarTender Web Print Service oder das Java-Applet-Webbrowser-Plugin.

Diese Client-Komponenten finden Sie im folgenden Windows-Ordner (wenn Sie die .NET SDK-Komponente als Teil der BarTender-Installation installiert haben):

"C:\Program Files\Seagull\BarTender Suite\SDK\Print Server API Samples\WebLabelPrint\WebLabelPrint_VB\Content\ClientComponents"

Sie können also entweder ein Java-basiertes Applet (BarTenderPrintClient.jar) oder einen Windows-Dienst (BarTenderWebPrintService.exe) installieren. Bei Verwendung eines Windows-Betriebssystems wird die zweite Methode empfohlen.