Descripción general

Cómo realizar impresión por Internet mediante los SDK de .NET con BarTender.

Aplicable a

BarTender 2016 y versiones posteriores.

Información

Ejemplo de impresión de etiquetas web

Como parte de la suite de BarTender, hemos incluido un ejemplo llamado Web Label Print. La aplicación de ejemplo Web Label Print es una aplicación web de Windows ASP.net que muestra cómo usar el SDK de BarTender Print Server para imprimir a través de una conexión web por Internet. Permite imprimir en impresoras instaladas localmente en el servidor web donde se ejecuta BarTender y también en impresoras remotas conectadas a computadoras cliente remotas.

Este ejemplo es un buen punto de partida para desarrollar tu propia aplicación web que se integre con BarTender usando nuestro SDK de .NET.

La aplicación, que incluye todo el código fuente, permite al usuario:

• Imprimir documentos de BarTender en impresoras locales (conectadas directamente al servidor o a través de una LAN o WAN) usando la impresión estándar de Windows y en impresoras remotas a través de Internet.
• Seleccionar qué tipo de impresión remota utilizar: BarTender Web Print Service o un applet de Java.
• Explorar diferentes mecanismos de comunicación con el Web Print Service (IFrame o CORS).
• Mostrar todas las impresoras instaladas en el servidor web y en las computadoras cliente a través de Internet.

Requisitos

Para ejecutar este ejemplo se requiere tener instalado en el servidor el siguiente software:

• BarTender 2016 o posterior activado como edición Enterprise (o Enterprise Automation).
• Visual Studio 2010 o superior
• Microsoft .NET Framework 4.0
• Internet Information Services (IIS) 7.0 o posterior
• ASP.NET MVC 4.0

Requisitos del sistema para Web Print Service (vía IFrame). Los clientes que ejecutan el Web Print Service (comunicación por IFrame) necesitan lo siguiente:

• Cualquier sistema operativo de escritorio Windows
• Microsoft .NET Framework 4.0
• Navegadores: IE8+, Chrome, Firefox. Este es el método más compatible.

Requisitos del sistema para Web Print Service (vía CORS). Los clientes que ejecutan el Web Print Service (comunicación por CORS) necesitan lo siguiente:

• Cualquier sistema operativo de escritorio Windows
• Microsoft .NET Framework 4.0
• Navegadores: IE10+, Chrome, Firefox. Esta es una forma mucho más sencilla y compatible con los estándares para comunicarse con servicios web entre dominios, pero no es compatible con versiones antiguas de IE.

Requisitos del sistema para el applet de Java. Los clientes que ejecutan el applet de Java necesitan lo siguiente:

• Cualquier sistema operativo de escritorio (Windows, Mac, Linux). Los sistemas operativos móviles no pueden ejecutar el applet de Java.
• Cualquier navegador web capaz de ejecutar applets de Java.
• Este es el método más ampliamente compatible para la impresión en el cliente, pero carece de muchas funciones y rendimiento en comparación con el Web Printing Service.

Instalación/Configuración

Instalación del SDK de .NET de BarTender

Para acceder al SDK de .NET de BarTender y a los archivos fuente de nuestros ejemplos, necesitas instalar el componente BarTender .NET SDK; de lo contrario, no verás la documentación de ayuda ni los ejemplos del SDK de BarTender .NET.

Durante la instalación de BarTender, asegúrate de seleccionar el componente BarTender .NET SDK para instalarlo. Si no ves la documentación de ayuda ni los ejemplos del SDK de BarTender .NET, deberás modificar la instalación de BarTender para agregar el SDK de .NET. Para hacerlo, ve al Panel de control de Windows->Programas y características->haz clic derecho en BarTender->haz clic en cambiar->el asistente de instalación debería aparecer para permitirte modificar la instalación e instalar el SDK de .NET de BarTender.

Archivos a utilizar

Los archivos fuente se encuentran en la carpeta SDK del directorio principal de instalación de BarTender Suite.

La ruta predeterminada debería ser: C:\Program Files\Seagull\BarTender Suite\SDK\Print Server API Samples\WebLabelPrint o C:\Program Files(x86)\Seagull\BarTender Suite\SDK\Print Server API Samples\WebLabelPrint dependiendo si usas BarTender de 32 o 64 bits.

Este directorio contiene los elementos llamados WebLabelPrint_CS para archivos fuente en C# y WebLabelPrint_VB para archivos fuente en Visual Basic .NET.

La mayor parte del código se puede encontrar en estas tres carpetas del Explorador de soluciones:

Como parte del ejemplo, se incluye el código fuente completo y los archivos de solución en C# y Visual Basic .NET que puedes usar y modificar con Visual Studio.

Uso del ejemplo en Visual Studio

Este ejemplo incluye el código fuente completo y el archivo de solución que puedes abrir en Visual Studio para modificarlo.

En el directorio donde se encuentran los archivos fuente del ejemplo, puedes ver el archivo de solución (.sln) que puedes abrir en Visual Studio.

Cuando ejecutes este ejemplo en Visual Studio, asegúrate de lo siguiente:

• Si usas la versión de 64 bits de BarTender, asegúrate de configurar Visual Studio para usar la versión de 64 bits de IIS Express. Normalmente puedes configurarlo yendo a herramientas->opciones->proyectos y soluciones->proyectos web->habilita la opción “Usar la versión de 64 bits de IIS Express para sitios web y proyectos” (esto puede variar según la versión de Visual Studio que utilices).
• Compila tu aplicación como versión .NET Framework 4 y como la versión de 32 o 64 bits correspondiente según la versión de BarTender que estés usando.

Configuración del ejemplo Web Label Print en Internet Information Services (IIS)

1. Asegúrate de tener instalado Windows Internet Information Services (IIS). Puedes instalarlo desde el Panel de control de Windows->Programas y características->haciendo clic en la opción “Activar o desactivar características de Windows”. Si usas un sistema operativo Windows Server, deberás instalarlo desde el Administrador del servidor.
2. Copia la carpeta de origen WebLabelPrint (WebLabelPrint_CS o WebLabelPrint_VB) desde donde se encuentra el ejemplo Web Label Print al directorio donde se ejecutarán tus aplicaciones web en IIS (el directorio predeterminado es: C:\inetpub\wwwroot).
3. Abre Internet Information Services (IIS).
   1. Crea un grupo de aplicaciones
      1. En el panel izquierdo, haz clic derecho en “Grupos de aplicaciones”
      2. Haz clic en agregar grupo de aplicaciones
      3. Asígnale un nombre
      4. Asegúrate de seleccionar la versión 4 de .NET framework, el modo de canalización administrada en “Integrado”, que la opción “iniciar grupo de aplicaciones inmediatamente” esté marcada y haz clic en aceptar.
      5. Haz clic derecho en el grupo de aplicaciones que creaste y ve a configuración avanzada.
         1. Asegúrate de que la opción “Habilitar aplicación de 32 bits” esté configurada según la versión de BarTender que estés usando.
         2. También verifica que la “Identidad” esté configurada con una cuenta de usuario con los permisos adecuados. Normalmente es una cuenta de administrador local que tiene acceso para ejecutar BarTender y recursos relacionados como impresoras y ubicaciones de archivos a las que se accede.
   2. En el panel izquierdo, expande sitios y sitio web predeterminado. Deberías ver una carpeta en la lista correspondiente a la carpeta WebLabelPrint copiada en el paso anterior.
   3. Haz clic derecho sobre ella y selecciona “Convertir en aplicación”
   4. Asegúrate de que el grupo de aplicaciones sea el que creaste. Si no es así, haz clic en el botón seleccionar y elige el grupo de aplicaciones correcto.
   5. La aplicación web ya debería estar configurada en IIS. Para abrir el sitio web, puedes hacer clic derecho en la aplicación web desde el panel izquierdo->ir a administrar aplicación->explorar.

Configuración de impresoras y métodos de impresión

Existen dos métodos principales para la impresión web que llamamos Impresión estándar e Impresión por Internet. La impresión estándar se refiere a imprimir en impresoras instaladas localmente en el servidor web y la impresión por Internet se refiere a imprimir en impresoras remotas conectadas a computadoras cliente remotas.

Para la impresión estándar, la configuración de las impresoras es sencilla. Solo necesitas instalar los controladores de impresora localmente en el servidor web donde se ejecuta BarTender. La aplicación web simplemente accede a las impresoras instaladas localmente en el servidor para imprimir.

Sin embargo, para la impresión por Internet, hay algunos requisitos y configuraciones adicionales

• La impresión por Internet depende del uso del BarTender Web Print Service o del complemento Java Applet, según el sistema del cliente, para permitir la comunicación entre el servidor web y la computadora cliente. Se instalan inicialmente cuando un cliente accede por primera vez al sitio web.
  • El BarTender Web Print Service es simplemente un servicio web de Windows que se instala en el cliente. El uso ideal es para clientes que ejecutan sistemas operativos Windows. Para otros tipos de sistemas operativos cliente (como Mac OSX y Linux), se utilizará el complemento de navegador Java Applet.
  • La impresión por Internet también requiere que se instale un controlador de impresora en la computadora cliente y también un controlador de impresora compatible en el servidor web donde se ejecuta BarTender.

El siguiente es el proceso general de cómo funciona la impresión por Internet:

1. Desde una aplicación web en un servidor, un usuario selecciona la opción de imprimir.
2. La aplicación web solicita al usuario seleccionar y/o especificar una impresora remota.
3. La aplicación web obtiene una licencia de impresión del cliente que ejecuta el BarTender Web Print Service o el complemento de navegador Java Applet.
4. Usando la licencia de impresión, la aplicación web imprime el documento en un archivo.
5. El contenido del archivo de código de impresión se envía desde la aplicación del servidor a la computadora cliente.
6. Mediante scripts del lado del cliente o una aplicación personalizada, el cliente envía el código de impresión al spooler local de Windows para imprimir usando el BarTender Web Print Service o el complemento de navegador Java Applet.

Estos componentes del cliente se pueden encontrar en la siguiente carpeta de Windows (si has instalado el componente SDK de .NET como parte de la instalación de BarTender):

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

Así que puedes instalar un applet basado en Java (BarTenderPrintClient.jar) o un servicio de Windows (BarTenderWebPrintService.exe). Cuando trabajes en un sistema operativo Windows, se recomienda el segundo método.