Informes ZPL

Utiliza esta función para describir los informes que se van a imprimir en las impresoras ZPL.

Presentación

Impresoras ZPL

Las impresoras ZPL son impresoras de etiquetas que utilizan el lenguaje de programación Zebra (ZPL), un lenguaje basado en comandos desarrollado por Zebra Technologies. ZPL controla el formato, el diseño y la impresión de etiquetas a gran velocidad.

Estas impresoras están optimizadas para el rendimiento y son ideales para entornos de mucho volumen, como:

  • almacenes

  • instalaciones de producción

  • centros logísticos

  • operaciones de venta directa

A diferencia de las impresoras estándar, las impresoras ZPL procesan los comandos directamente en su firmware, reduciendo el procesamiento gráfico por parte del ordenador y acelerando significativamente los tiempos de impresión.

Lenguaje ZPL

ZPL utiliza comandos basados en texto para describir el diseño de la etiqueta, incluyendo:

  • comandos de formato: definición del tamaño de la etiqueta, la velocidad de impresión, la oscuridad, etc.

  • comandos de datos de campo: inserción de texto, códigos de barras o imágenes.

  • comandos de control: inicio y fin de etiquetas, cantidad por imprimir, etc.

Este enfoque minimiza la transferencia de datos y maximiza la velocidad de impresión.

Informes ZPL en Sage X3

En Sage X3, los informes ZPL están diseñados para trabajar con impresoras ZPL. Los informes ZPL:

  • están vinculados mediante una casilla y un enlace de conexión;

  • pueden compartir parámetros con las impresoras ZPL o Crystal Reports;

  • utilizan un modelo de datos y criterios de selección para definir los datos que alimentan el flujo de impresión;

  • se basan en un modelo de fichero (.PAT) que define el formato de la etiqueta;

  • incluyen expresiones calculadas que se pueden mostrar en la ficha y que están sujetas a condiciones.

Comportamiento de salida

  • Si el destino de salida es Vista previa, Impresora, Mensaje, Fichero o Archivado, el informe Crystal Reports se imprime con normalidad.

  • Si el tipo de salida es Impresora ZPL, el informe ZPL se genera y transmite directamente al puerto de la impresora.

Mejoras de rendimiento

A partir de la release 2025.R2/V12.0.38, las variables locales permiten evaluar las condiciones necesarias para generar el informe antes de ejecutar la instrucción Link. Este cambio mejora significativamente el rendimiento y acelera la ejecución de todo el proceso.

Estructura de ficheros ZPL

Un fichero ZPL suele incluir:

  • una cabecera:

    Copiar 
    ^XA
    ^DFR
    ^XZ

  • un cuerpo:

    Copiar 
    ^XA
    ^CF0,160
    ^FO220,50^FDSAGE^FS
    ^CFA,30
    ^FO50,300^FDEsta línea está codificada^FS
    ^FO50,340^FVX3E_1^FS
    ^FO50,380^FVX3E_2^FS
    ^FO50,420^FVX3E_3^FS
    ^XZ

  • un pie de página:

    Copiar 
    ^XA
    ^IDFR
    ^XZ

Puedes crear estos ficheros con un editor de texto sin formato y guardarlos con una extensión .PAT. A continuación, colócalos en el directorio del servidor: <dossier>/PAT/*.PAT.

Para más información, consulta la guía impresión Zebra (solo en inglés).

Requisitos previos

Consulta la documentación de implementación.

Gestión de pantalla

La pantalla se define en 3 secciones:

Pantalla de entrada

Cabecera

Cód. parametrización (CODPAR)

Este código identifica una parametrización de impresión ZPL. Este código está vinculado a un informe.
Descripción (INTIT)

Utiliza este campo para asignar una descripción a cada ficha.
Activo (ENAFLG)

Marca esta casilla para activar la ficha actual.

Las fichas inactivas conservan su contenido y parametrización, pero no se pueden utilizar al reintroducir su código en:

  • otros registros (como documentos y parámetros);
  • los procesos en masa.

Las habilitaciones en una función determinada pueden prevenir la creación de una ficha activa. En ese caso, la casilla se deshabilita por defecto. Solo se puede modificar por un usuario autorizado o mediante un workflow de firma.
Fichero modelo (PATNAM)

Selecciona el modelo que se va a utilizar para generar el fichero final de la impresión.

Si los ficheros se crean manualmente con la acción ARZ_REPORT, este campo es opcional.

Cuando se define, el modelo se almacena en la base de datos y se le asigna una versión. En ese caso, se puede utilizar un número de versión determinado.

Tienes que crear modelos en el directorio PAT de la aplicación actual con la extensión .PAT. Hay una función de zoom disponible para ver los ficheros, pero no se puede utilizar para filtrarlos.

Para crear un informe, debe haber un fichero modelo. Al crear una ficha, el sistema lee el fichero y almacena sus características como versión 1.

Para actualizar un modelo:

  1. Coloca la nueva versión en el directorio.

  2. Haz clic derecho en el código del modelo y selecciona Nueva versión.

  3. La nueva versión se almacena, el número de versión se incrementa y se convierte en el valor por defecto. Las versiones anteriores se pueden seguir seleccionando.

    Si la fecha de creación del fichero coincide con la versión anterior, se muestra el mensaje "Sin nueva versión".

El fichero modelo puede ser de tipo:

  • Pantalla. En la memoria del servidor de impresión se predefine y carga una máscara con variables. Los datos se envían y se fusionan con la máscara para producir etiquetas. Puedes ver la descripción de la máscara en la pestaña Máscara.
  • Estructurado. Incluye una cabecera, líneas y un pie de página. Puedes ver cada sección en su pestaña correspondiente.
Versión (VER)

Selecciona la versión del modelo utilizado en la impresión.

Por defecto, se utiliza la última versión.

Si se añade una parametrización llamada "versión" a la parametrización del infome, se sobrescribe el valor por defecto.
Envío de máscara (ENVMSK)

Marca esta casilla para evitar que los usuarios envíen la máscara a la impresora.

La transmisión de una máscara puede llevar mucho tiempo, especialmente con contenido gráfico.

Sección de datos

Modelo de datos (MODDON)

Selecciona el modelo de datos utilizado para generar el vínculo para leer datos y producir el fichero.

El vínculo se genera en el script WMZPL* después de crear o modificar una parametrización.

Selecciona Validación para forzar la generación.

Sección de expresión

Número (NUM)

Este número se utiliza para referenciar la expresión en las etiquetas (n = número):

  • X3E_n para los modelos de análisis

  • ^FNn para los modelos de máscaras

La etiqueta se reemplaza por el valor de la expresión evaluada en el fichero de salida.

Un número puede aparecer varias veces. La condición determina qué expresión se utiliza.
Condición (CND)

Utiliza este campo para gestionar varias líneas para el mismo número.

Cada campo calculado está identificado por un número.

Se conserva la primera expresión con una condición satisfecha.
Expresión (EXPLIG)

Esta expresión se evalúa durante el ciclo de lectura definido por el modelo de datos al generar el fichero de impresión.
Criterios (CONDIT)

Define los criterios de selección de la solicitud.

Las líneas se vinculan con un Y.

Los criterios se pasan directamente a la base de datos mediante cláusulas de instrucción Link, a menos que la fórmula contenga funciones especiales (por ejemplo, Func).

Si se utiliza una función especial, los criterios actúan como filtro al leer los datos.

La función func ARZIMP.PARAM("nombre") recupera la parametrización de informes y está optimizada en la solicitud al convertirse en una constante.

También puedes definir criterios de selección adicionales en el modelo de datos.

Botones específicos

Selecciona este botón para crear el procesamiento que permite generar el flujo para la transmisión a la impresora.

Mensajes de error

Además de los mensajes genéricos, se puede mostrar el siguiente mensaje durante la entrada:

Sin nueva versión

Se ha intentado guardar una nueva versión del modelo de impresión, pero el fichero proporcionado es más antiguo que el anterior.

Tablas utilizadas

Consulta la documentación de implementación.