Plantillas de etiqueta
Un archivo de comandos de impresora de la biblioteca Etiquetas: su nombre y su codificación, el editor de comandos de impresora y la importación de archivos, la gramática de los marcadores, la cola de Windows instalada y el envío de prueba.
Una plantilla de etiqueta es una fila de la biblioteca Etiquetas (Process > Plantillas >
Etiquetas): un archivo de comandos de impresora (ZPL, EPL, CPCL o cualquier otro lenguaje de comandos
RAW) con marcadores {{NAME}} allí donde corresponde un valor del ensayo. Ganter Lab envía los bytes a
una cola RAW de Windows y sustituye los marcadores; nunca analiza, dibuja ni previsualiza el lenguaje de
impresora, así que el diseño en sí se hace en la herramienta del fabricante de la impresora. Editar
exige Gestionar Process; la página entera queda inerte mientras una unidad está en marcha, y un
envío de prueba se rechaza mientras el runtime está detenido. Una plantilla nueva nace vacía, llamada
"Etiqueta" ("Etiqueta 2", y así sucesivamente), y no imprime nada hasta que contiene comandos: toda vía
que componga o envíe rechaza una plantilla vacía.
La página son cinco tarjetas, en el orden en el que se hace el trabajo: la identidad y la codificación, los comandos, los marcadores encontrados en ellos, cómo preparar un archivo en un diseñador, y el envío de prueba.
Plantilla
| Campo | Qué es | Valores / valor por defecto | Efecto |
|---|---|---|---|
| Nombre | El nombre que muestran la biblioteca y todos los comandos de etiqueta. | Texto; se confirma al salir del campo. | Un nombre vacío se rechaza ("Una plantilla de etiqueta necesita un nombre.") y se queda el nombre anterior. |
| Codificación | Cómo se vuelven a leer como texto los bytes guardados, y cómo se codifica cada valor sustituido. | UTF-8 (por defecto), Latin-1, ASCII. | Cambiarla reescribe en la codificación nueva los comandos editables; un carácter que la codificación nueva no puede representar se rechaza ("Los comandos se quedan en UTF-8. La línea 3 contiene 'é', que ASCII no puede representar.") y la codificación se queda como estaba. Los comandos opacos conservan sus bytes y simplemente se vuelven a leer bajo la declaración nueva. |
Comandos de impresora
| Control | Qué hace |
|---|---|
| El editor | Un campo de texto monoespaciado con los comandos, con una forma ZPL como marcador de posición. Escribir valida sobre la marcha (la lista de marcadores y cualquier rechazo siguen al texto); salir del campo guarda. Un borrador rechazado se queda en pantalla con su motivo y no se guarda; abrir otra plantilla lo descarta. Guardar un texto idéntico a los bytes guardados no cambia nada. |
| Importar un archivo… / Sustituir el archivo… | Trae un archivo de comandos de impresora (.zpl, .epl, .epl2, .cpcl, .prn, .lbl, .txt). Los bytes se copian a la configuración y el nombre del archivo se conserva para la trazabilidad: mover o eliminar el original no afecta a la plantilla. Un archivo vacío y un archivo de más de 2 MiB se rechazan, y también un archivo cuyos marcadores estén mal formados. |
Los comandos se pueden editar como texto solo mientras sobreviven byte a byte al viaje de ida y vuelta: se decodifican bajo la codificación declarada, se vuelven a codificar en los mismos bytes, terminan todas las líneas igual (todas con LF o todas con CR LF; un estilo CR LF importado se repone en cada guardado) y no llevan ningún carácter de control más allá del tabulador y el final de línea. Los comandos que fallan cualquiera de esas pruebas se quedan opacos: el editor se sustituye por el motivo ("El byte 0x1B en el desplazamiento 12 no es texto UTF-8.", "Los finales de línea están mezclados: unas líneas terminan con CR LF y otras solo con LF.") y los bytes cambian solo sustituyendo el archivo. Una línea bajo la tarjeta dice qué hay guardado: "Todavía no hay nada guardado.", "Importado desde labels.zpl · 1,2 KiB · se conservan los finales de línea CR LF" o "Escrito aquí · 240 B".
Marcadores detectados
Los marcadores encontrados en los comandos guardados, en orden de primera aparición. Un marcador es un
{{NAME}} ASCII estricto: el nombre empieza por A a Z, continúa con A a Z, 0 a 9 o guion bajo, tiene 64
caracteres como máximo y cierra con }}. Cualquier cosa que abra con {{ y no siga la gramática se
rechaza con su desplazamiento en bytes y la regla que rompió ("Marcador de etiqueta mal formado en el
desplazamiento 40: el nombre solo puede contener A-Z, 0-9 o guion bajo."). Todos los bytes que hay fuera
de un marcador se conservan, y la sustitución ocurre una sola vez y nunca de forma recursiva.
Una plantilla sin comandos dice "Todavía sin comandos. Escriba arriba los comandos de impresora, o importe un archivo exportado desde un diseñador de etiquetas. Hasta entonces esta plantilla no imprime nada."; una plantilla con comandos y sin marcadores dice "No se ha encontrado ningún marcador: esta etiqueta fija envía siempre los mismos bytes y no usa datos del ensayo." y es una plantilla válida. Cada marcador distinto necesita una fuente en cada comando de etiqueta que use la plantilla; un marcador repetido recibe el mismo valor. La tarjeta cierra con la regla permanente: Ganter Lab valida la sintaxis de los marcadores, no los comandos del fabricante. Guarde solo comandos en los que confíe; pueden cambiar el comportamiento de la impresora.
Preparar una plantilla en un diseñador de etiquetas
Un recordatorio plegado del flujo de trabajo:
- Cree el diseño de la etiqueta en la herramienta del fabricante de la impresora, como ZebraDesigner.
- Ponga marcadores de Ganter Lab como
{{SERIAL}}o{{RESULT}}dentro del texto o del contenido de un código de barras. - Exporte el archivo de comandos listo para la impresora, por ejemplo ZPL. No importe el archivo de proyecto del diseñador.
- Importe aquí ese archivo (o pegue su contenido en el campo de comandos) y compruebe los marcadores detectados.
- Escriba abajo valores representativos y haga una prueba contra una cola de Windows instalada.
El mismo flujo vale para EPL, CPCL y otros lenguajes de comandos de impresora.
Envío de prueba
| Control | Qué hace |
|---|---|
| Actualizar colas | Vuelve a leer las colas de impresión instaladas para el usuario interactivo de Windows. Si no se pueden leer, se dice al lado del selector. |
| Una casilla de valor por marcador | El texto de ejemplo que se sustituye en ese marcador solo en este envío. Una plantilla fija dice "Esta plantilla fija no necesita valores de ejemplo."; una vacía, "No hay nada que enviar hasta que esta plantilla tenga comandos de impresora." |
| Cola de Windows instalada | La cola a la que va la prueba ("(elija una cola)" o "(sin colas instaladas)"). |
| Enviar la prueba | Compone los comandos guardados con los valores de ejemplo y los envía como documento RAW llamado Ganter Lab test · <plantilla>. No se crea ningún ensayo ni ningún artefacto. El resultado aterriza en el registro de acciones ("Etiqueta de prueba enviada a 'Q'." o "El envío de prueba ha fallado: motivo"). |
Enviar la prueba se atenúa sin comandos guardados, sin cola elegida, mientras se envía, y mientras la página está inerte. Un valor que un marcador no puede llevar en la codificación declarada lo rechaza el compositor. Que salga bien significa que la cola de Windows aceptó el documento RAW; no confirma que se haya impreso una etiqueta física.
De dónde salen los valores
Los valores de ejemplo de arriba son solo para la prueba. En un ensayo, cada marcador distinto de la
plantilla se asigna a una fuente finita en el comando de etiqueta que la usa
(Acciones): los metadatos congelados, el nombre y la revisión del modelo, el nombre y
el código de la unidad, el nombre y el código del procedimiento, el identificador del ensayo, el
instante de inicio, el estado del ensayo, y en la Finalización también el instante de fin, la duración,
el veredicto, el motivo de la terminación y el resultado de un criterio con nombre y un ciclo explícito.
Las fuentes de fecha y hora admiten un formato (fecha y hora de la estación, fecha de la estación, hora
de la estación, formato ISO 8601) y las fuentes numéricas un número fijo opcional de decimales (de 0 a
9). Un número se escribe para la máquina que lo lee y no como la estación muestra los números en
pantalla: nunca un separador de grupos, que dentro de un código de barras rompe el sistema receptor,
siempre el punto decimal invariante, y un número entero, como un recuento o una duración en segundos,
escrito entero. Un valor que lleva un carácter de control, un salto de línea incluido, o un carácter que
inicia un comando de impresora (^, ~) se rechaza nombrando su marcador: partiría la línea en la que
está, o imprimiría otra etiqueta. Qué ofrece cada límite, cómo se congela el artefacto y cómo se
registra un envío está en Emitir etiquetas e
informes; asignar una plantilla a mano contra un ensayo registrado es Etiquetas
e informes.
Qué no hace esta página
No dibuja ninguna vista previa de la etiqueta y no valida nada del lenguaje de impresora. No asigna ningún marcador a un valor: eso es cosa del comando de etiqueta. No imprime una etiqueta de un ensayo: los artefactos de un ensayo se imprimen desde su registro en Históricos. Y eliminar la plantilla (el verbo Eliminar la plantilla de etiqueta de la barra) deja intacto cada artefacto registrado; solo los comandos que todavía la nombran dejan de generar.