Cómo encajan las piezas

Aplica a: BarcoderX Basic y Ultimate

Estado: Planificado. Todavía no hay nada publicado y no hay nada que descargar. Esta página describe cómo se diseñó el trabajo conjunto de las partes.

BarcoderX es software que sus propios desarrolladores ejecutan en su propia infraestructura. No se aloja nada por usted. BarcoderX conserva solamente su cuenta de desarrollador, sus claves de licencia, la lista de versiones que usted tiene derecho a descargar y un registro de sus activaciones (el ID de la licencia, una huella digital con hash de la máquina, la versión y la hora). Ninguna etiqueta, plantilla, trabajo de impresión ni otro dato de clientes llega jamás a BarcoderX. Tiene cuatro partes, y todas usan el mismo motor, de modo que una etiqueta se ve igual y se imprime igual sin importar qué parte utilice.

Las partes

El SDK. Un conjunto de paquetes NuGet para .NET 10. Su aplicación carga una plantilla de etiqueta, le vincula sus datos y genera, exporta o imprime el resultado dentro de su propio proceso. Con el SDK puede imprimir directamente en una impresora, sin el servidor de API ni el agente de impresión. El SDK no necesita ningún servidor ni conexión de red.

El servidor de API. Un servidor que usted instala y ejecuta. Ofrece una API REST bajo /api/v1, descrita por un documento OpenAPI. Hace lo mismo que el SDK, por HTTPS, para programas escritos en cualquier lenguaje. También guarda sus plantillas, fuentes, imágenes e impresoras, en su propia base de datos SQL Server. Consulte API web.

El editor de etiquetas. El lugar donde las personas diseñan etiquetas en un navegador. Se entrega como paquetes de JavaScript para React, Angular y Vue, y como un envoltorio (wrapper) de .NET para Blazor y otras aplicaciones .NET. Habla únicamente con la API. No contiene código propio de códigos de barras ni de diseño, de modo que cada vista previa proviene del mismo motor que imprime. Consulte El editor de etiquetas.

El agente de impresión. Un programa pequeño que usted instala en una computadora de la misma red que sus impresoras. Se conecta hacia afuera con su servidor, recibe los trabajos de impresión y los envía a sus impresoras. Nada se conecta hacia él. Hace falta cuando un trabajo de impresión nace en la API o en el editor y debe llegar a una impresora de su red. Consulte El agente de impresión.

Hay además dos elementos menores:

• Un host de generación sin estado (stateless): una imagen de contenedor que ofrece las partes de códigos de barras y de generación de la API sin base de datos. Recibe plantillas completas en cada solicitud y no guarda nada. Necesita una clave de API en su configuración y no arranca sin ella.
• Dos paquetes para mostrar códigos de barras en aplicaciones web: uno para ASP.NET Core y otro para Blazor. Muestran la imagen de un código de barras en una página. Están previstos para una versión posterior a la primera.

¿Qué partes necesito?

Cómo viaja un trabajo de impresión

Cuando usted imprime mediante el servidor de API, el trabajo sigue esta ruta:

1. Su aplicación, o el editor, le pide a la API que imprima una plantilla con ciertos datos.
2. El servidor genera los comandos de impresora a partir de la plantilla, en el lenguaje que habla su impresora, y guarda el trabajo.
3. El agente de impresión de su red recibe el trabajo por su conexión saliente.
4. El agente verifica el trabajo y lo envía a su impresora.
5. El agente informa el resultado y la API muestra el estado del trabajo.

El servidor nunca abre por sí mismo una conexión hacia una impresora, y un navegador nunca imprime en un puerto de su computadora. El agente es la única ruta del servidor hacia sus impresoras.

Dónde se verifica la licencia

El SDK y el servidor verifican la licencia en su propia máquina, sin conexión de red. El editor y el agente de impresión no guardan ninguna clave de licencia. Un problema de licencia nunca impide que una etiqueta se imprima. En el peor caso, la salida lleva una marca de evaluación visible. Consulte Ediciones y licencias.

BarcoderX es un producto de P4 Software.