Vue d'ensemble

Comment effectuer une impression Internet via les SDK .NET avec BarTender.

Applicable à

BarTender 2016 et versions ultérieures.

Informations

Exemple d'impression d'étiquettes Web

Dans la suite BarTender, nous avons inclus un exemple appelé Web Label Print. L'application exemple Web Label Print est une application web Windows ASP.net fonctionnelle qui montre comment utiliser le BarTender Print Server SDK pour imprimer via une connexion web Internet. Elle vous permet d'imprimer sur des imprimantes installées localement sur le serveur web où BarTender est en cours d'exécution, ainsi que sur des imprimantes distantes connectées à des ordinateurs clients distants.

Cet exemple est un bon point de départ pour développer votre propre application web intégrée à BarTender en utilisant notre SDK .NET.

L'application, qui inclut tout le code source, permet à l'utilisateur de :

• Imprimer des documents BarTender sur des imprimantes locales (connectées directement au serveur ou via un réseau LAN ou WAN) en utilisant l'impression Windows standard, ainsi que sur des imprimantes distantes accessibles via Internet.
• Choisir le type d'impression distante à utiliser : BarTender Web Print Service ou une applet Java.
• Explorer différents mécanismes de communication avec le Web Print Service (IFrame ou CORS).
• Afficher toutes les imprimantes installées sur le serveur web et sur les ordinateurs clients accessibles via Internet.

Prérequis

L'exécution de cet exemple nécessite l'installation des logiciels suivants sur le serveur :

• BarTender 2016 ou version ultérieure activé en édition Enterprise (ou Enterprise Automation).
• Visual Studio 2010 ou supérieur
• Microsoft .NET Framework 4.0
• Internet Information Services (IIS) 7.0 ou version ultérieure
• ASP.NET MVC 4.0

Prérequis système pour le Web Print Service (via IFrame). Les clients utilisant le Web Print Service (communication via IFrame) doivent répondre aux exigences suivantes :

• N'importe quel système d'exploitation Windows Desktop
• Microsoft .NET Framework 4.0
• Navigateurs : IE8+, Chrome, Firefox. C'est l'approche la plus compatible.

Prérequis système pour le Web Print Service (via CORS). Les clients utilisant le Web Print Service (communication via CORS) doivent répondre aux exigences suivantes :

• N'importe quel système d'exploitation Windows Desktop
• Microsoft .NET Framework 4.0
• Navigateurs : IE10+, Chrome, Firefox. C'est une méthode beaucoup plus simple et conforme aux standards pour communiquer avec des services web inter-domaines, mais elle n'est pas compatible avec les anciennes versions d'IE.

Prérequis système pour l'applet Java. Les clients utilisant l'applet Java doivent répondre aux exigences suivantes :

• N'importe quel système d'exploitation de bureau (Windows, Mac, Linux). Les systèmes d'exploitation mobiles ne peuvent pas exécuter l'applet Java.
• N'importe quel navigateur web capable d'exécuter des applets Java.
• C'est l'approche la plus largement compatible pour l'impression côté client, mais elle offre moins de fonctionnalités et de performances que le Web Printing Service.

Installation/Configuration

Installation du SDK .NET de BarTender

Pour accéder au SDK .NET de BarTender et aux fichiers sources de nos exemples, vous devez installer le composant SDK .NET de BarTender, sinon vous ne verrez pas la documentation d'aide ou les exemples du SDK .NET de BarTender.

Lors de l'installation de BarTender, assurez-vous de sélectionner le composant SDK .NET de BarTender à installer. Si vous ne voyez pas la documentation d'aide ou les exemples du SDK .NET de BarTender, vous devrez modifier l'installation de BarTender pour installer le SDK .NET de BarTender. Pour cela, allez dans le Panneau de configuration Windows->Programmes et fonctionnalités->clic droit sur BarTender->cliquer sur modifier->l'assistant d'installation devrait apparaître pour vous permettre de modifier l'installation et d'installer le SDK .NET de BarTender.

Fichiers à utiliser

Les fichiers sources se trouvent dans le dossier SDK du répertoire principal d'installation de la suite BarTender.

Le chemin par défaut devrait être : C:\Program Files\Seagull\BarTender Suite\SDK\Print Server API Samples\WebLabelPrint ou C:\Program Files(x86)\Seagull\BarTender Suite\SDK\Print Server API Samples\WebLabelPrint selon que vous utilisez la version 32 bits ou 64 bits de BarTender.

Ce dossier contient des éléments nommés WebLabelPrint_CS pour les fichiers sources C# et WebLabelPrint_VB pour les fichiers sources Visual Basic .NET.

La majorité du code se trouve dans ces trois dossiers de l'Explorateur de solutions :

Dans le cadre de l'exemple, il contient le code source complet et les fichiers de solution en C# et Visual Basic .NET, qui peuvent être utilisés et modifiés avec Visual Studio.

Utilisation de l'exemple dans Visual Studio

Cet exemple est fourni avec le code source complet et le fichier de solution que vous pouvez ouvrir dans Visual Studio pour le modifier.

Dans le dossier où se trouvent les fichiers sources de l'exemple, vous pouvez voir le fichier de solution (.sln) que vous pouvez ouvrir dans Visual Studio.

Lorsque vous exécutez cet exemple dans Visual Studio, assurez-vous des points suivants :

• Si vous utilisez la version 64 bits de BarTender, assurez-vous que Visual Studio utilise la version 64 bits de IIS Express. Vous pouvez généralement régler cela en allant dans outils->options->projets et solutions->projets web->activez l'option “Utiliser la version 64 bits de IIS Express pour les sites web et projets” (cela peut varier selon la version de Visual Studio utilisée).
• Vous compilez votre application en version .NET Framework 4 et dans la version 32 bits ou 64 bits appropriée selon la version de BarTender que vous utilisez.

Configuration de l'exemple Web Label Print dans Internet Information Services (IIS)

1. Assurez-vous que Windows Internet Information Services (IIS) est installé. Vous pouvez l'installer via le Panneau de configuration Windows->Programmes et fonctionnalités->en cliquant sur l'option “Activer ou désactiver des fonctionnalités Windows”. Si vous utilisez un système d'exploitation Windows Server, vous devrez l'installer via le Gestionnaire de serveur.
2. Copiez le dossier source WebLabelPrint (WebLabelPrint_CS ou WebLabelPrint_VB) depuis l'emplacement de l'exemple Web Label Print vers le dossier où vos applications web IIS seront exécutées (le dossier par défaut est : C:\inetpub\wwwroot).
3. Ouvrez Internet Information Services (IIS).
   1. Créez un pool d'applications
      1. Dans le panneau de gauche, faites un clic droit sur “Pools d'applications”
      2. Cliquez sur ajouter un pool d'applications
      3. Donnez-lui un nom
      4. Assurez-vous de sélectionner la version .NET framework 4, le mode pipeline géré sur “Intégré”, “démarrer le pool d'applications immédiatement” est coché, puis cliquez sur OK.
      5. Faites un clic droit sur le pool d'applications que vous avez créé et allez dans les paramètres avancés.
         1. Vous devez vous assurer que le paramètre “Activer les applications 32 bits” est réglé sur la version correcte (32 ou 64 bits) de BarTender que vous utilisez.
         2. De plus, l'“Identité” doit être définie sur un compte utilisateur ayant les autorisations appropriées. Il s'agit généralement d'un compte administrateur local ayant accès à BarTender et aux ressources nécessaires comme les imprimantes et les emplacements de fichiers utilisés.
   2. Dans le panneau de gauche, développez sites et site web par défaut. Vous devriez voir apparaître un dossier correspondant au dossier WebLabelPrint copié à l'étape précédente.
   3. Faites un clic droit dessus et cliquez sur “Convertir en application”
   4. Assurez-vous que le pool d'applications est bien celui que vous avez créé. Sinon, cliquez sur le bouton sélectionner et choisissez le bon pool d'applications.
   5. L'application web devrait maintenant être configurée dans IIS. Pour lancer le site web, vous pouvez faire un clic droit sur l'application web dans le panneau de gauche->aller dans gérer l'application->parcourir.

Configuration des imprimantes et méthodes d'impression

Il existe deux principales méthodes d'impression web que nous appelons Impression Standard et Impression Internet. L'Impression Standard consiste à imprimer sur des imprimantes installées localement sur le serveur web, tandis que l'Impression Internet consiste à imprimer sur des imprimantes distantes connectées à des ordinateurs clients distants.

Pour l'Impression Standard, la configuration des imprimantes est simple. Il suffit d'installer les pilotes d'imprimante localement sur le serveur web où BarTender est en cours d'exécution. L'application web accède simplement aux imprimantes installées localement sur le serveur web pour imprimer.

Cependant, pour l'Impression Internet, il y a des exigences et une configuration supplémentaires

• L'Impression Internet repose sur l'utilisation soit du BarTender Web Print Service, soit du plugin Java Applet selon le système client, pour permettre la communication entre le serveur web et l'ordinateur client. Ils sont installés lors du premier accès du client au site web.
  • Le BarTender Web Print Service est simplement un service web Windows installé sur le client. Il est idéal pour les clients sous Windows. Pour d'autres systèmes d'exploitation clients (comme Mac OSX et Linux), le plugin navigateur Java Applet sera utilisé.
  • L'Impression Internet nécessite également qu'un pilote d'imprimante soit installé sur l'ordinateur client ainsi qu'un pilote d'imprimante compatible sur le serveur web où BarTender est en cours d'exécution.

Voici le processus général de fonctionnement de l'Impression Internet :

1. Depuis une application web sur un serveur, un utilisateur sélectionne l'option d'impression.
2. L'application web demande à l'utilisateur de sélectionner et/ou spécifier une imprimante distante.
3. L'application web obtient une licence d'impression depuis le client exécutant le BarTender Web Print Service ou le plugin navigateur Java Applet.
4. En utilisant la licence d'impression, l'application web imprime le document dans un fichier.
5. Le contenu du fichier de code d'impression est envoyé de l'application serveur à l'ordinateur client.
6. À l'aide de scripts côté client ou d'une application personnalisée, le client envoie le code d'impression au spouleur Windows local pour impression via le BarTender Web Print Service ou le plugin navigateur Java Applet.

Ces composants clients se trouvent dans le dossier Windows suivant (si vous avez installé le composant SDK .NET lors de l'installation de BarTender) :

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

Ainsi, vous pouvez soit installer une applet Java (BarTenderPrintClient.jar), soit un service Windows (BarTenderWebPrintService.exe). Lorsque vous travaillez sous Windows, la seconde approche est recommandée.