Plantillas y datos

Aplica a: BarcoderX Basic y Ultimate

Estado: Planificado. Todavía no hay nada publicado y no hay nada que descargar. Esta página explica las ideas a nivel de conceptos. Los nombres de propiedades y opciones son nombres provisionales hasta la primera versión.

Qué es una plantilla

Una plantilla de etiqueta es un documento que describe una etiqueta: su página, los elementos que contiene, los datos que espera y cómo se comporta. La misma plantilla controla la vista previa, los archivos exportados y la impresión. BarcoderX tiene su propio formato de plantilla. No copia el formato de ningún otro producto.

Una plantilla contiene:

• La página: ancho y alto, la unidad, la resolución, la orientación, el modo de color, el medio y la configuración de impresión.
• Los elementos de la etiqueta, en orden.
• Los campos que la etiqueta espera de sus datos, y las variables, los contadores y las máscaras que usa.
• Ajustes sobre cómo se comporta la etiqueta, por ejemplo qué hacer con un valor faltante o con datos de código de barras no válidos.

La página

• Unidades: pulgada, milímetro, centímetro, punto de impresora (dot), punto tipográfico (point), pica, mil, twip y micrómetro. BarcoderX guarda cada valor exactamente como usted lo escribe.
• Resolución: cualquier número entero de puntos por pulgada entre 96 y 1,200. Los valores estándar son 152, 203, 300 y 600.
• Posición y ángulo: el origen es la esquina superior izquierda de la etiqueta. Un valor hacia la derecha o hacia abajo es positivo. Un elemento gira en sentido horario alrededor de su centro, en cualquier ángulo.
• Orientación: 0, 90, 180 o 270 grados, aplicada a toda la página. Las posiciones de los elementos en la plantilla no cambian.
• Modo de color: blanco y negro, gris o color.
• Medio: continuo, con separación entre etiquetas o con marca negra.
• Disposición: columnas y filas de etiquetas en un rollo o en una hoja, con separaciones, márgenes y el orden en que se llenan las etiquetas.
• Cambio de resolución: puede llevar un diseño a otra resolución. BarcoderX lo reescala y le informa la dimensión X que obtiene realmente, si difiere de la que pidió.
• Guías: una página puede tener guías que no se imprimen y una imagen de fondo, además de márgenes de seguridad que le advierten cuando un elemento los cruza. Nada de esto llega a la salida.

Los elementos

Una plantilla puede contener diez tipos de elementos:

Cada elemento tiene un nombre, una posición, un tamaño y una rotación. También puede llevar una condición, llamada "imprimir cuando" (print when), que decide si aparece. Un elemento puede bloquearse y puede llevar un comentario. El orden de los elementos es el orden de apilamiento, y el primer elemento queda al fondo.

Casi cualquier propiedad de un elemento se puede definir mediante una expresión, como su posición, su color, el tamaño de fuente o la simbología.

JSON y XML

• JSON es el formato principal. BarcoderX lo lee y lo escribe en una forma fija y predecible, de modo que una misma plantilla siempre se guarda de la misma manera.
• XML es un equivalente exacto. Una plantilla convertida de JSON a XML y de nuevo a JSON queda idéntica. XML está previsto para la primera versión. Para cada formato se publica un esquema, de modo que usted puede verificar una plantilla antes de cargarla.
• Las plantillas tienen versiones. Cada plantilla lleva la versión del formato que usa. BarcoderX actualiza una plantilla antigua al cargarla. Toda versión del formato que se haya publicado sigue cargándose en todas las versiones posteriores. Una plantilla escrita para un formato más nuevo del que entiende su BarcoderX se rechaza con un mensaje claro, y nada se carga a medias.
• No se pierde nada. Las propiedades que BarcoderX no conoce se conservan y se vuelven a escribir, de modo que una plantilla más nueva no pierde datos cuando la edita una herramienta más antigua. Una aplicación anfitriona también puede guardar sus propios datos en miembros cuyos nombres comienzan con x- y un identificador del anfitrión.
• Los lectores están reforzados. XML no puede cargar archivos ni definiciones externos. La profundidad y el tamaño tienen límites, y una plantilla que supera un límite se rechaza rápidamente.

Esta es una ilustración breve. Es una etiqueta de envío GS1-128, con un nombre en mayúsculas, una línea y un código de barras construido a partir de un campo SSCC. La ilustración está abreviada, y los nombres de las propiedades son provisionales y pueden cambiar antes de la publicación.

{
  "schemaVersion": 1,
  "name": "shipping-sscc",
  "page": {
    "unit": "mm", "width": 101.6, "height": 152.4, "dpi": 203, "orientation": 0,
    "media": { "sensing": "gap", "gapLength": 3 },
    "layout": { "columns": 1, "rows": 1 }
  },
  "fields": [
    { "name": "ShipTo.Name", "type": "string" },
    { "name": "Sscc", "type": "string" }
  ],
  "counters": [ { "name": "box", "start": 1, "step": 1, "width": 3 } ],
  "elements": [
    { "type": "text", "id": "e1", "name": "shipTo", "x": 5, "y": 5, "width": 90, "height": 12,
      "content": { "expr": "Upper({ShipTo.Name})" },
      "font": { "family": "BX Core", "size": 14, "bold": true },
      "sizing": "shrinkToFit", "align": "start" },
    { "type": "line", "id": "e2", "x": 0, "y": 95, "x2": 101.6, "y2": 95, "stroke": 0.5 },
    { "type": "barcode", "id": "e3", "x": 8, "y": 100, "width": 85, "height": 32,
      "symbology": "gs1-128", "content": { "expr": "\"(00)\" & {Sscc}" },
      "xDimension": 0.375, "humanReadable": { "position": "below" }, "output": "auto" }
  ]
}

Datos

BarcoderX obtiene sus datos de una fuente de datos, los relaciona con los campos de la plantilla y crea una etiqueta por cada registro. Repite cada etiqueta según el número de copias que usted pida. El número de copias puede ser una constante, un campo o una expresión.

En el SDK, una fuente de datos puede ser:

• una lista de objetos .NET, leída sin búsquedas lentas fila por fila;
• un DataTable, o una tabla de un DataSet;
• un DataView o un lector de datos de solo avance, para conjuntos muy grandes, con memoria acotada;
• un archivo CSV, con fila de encabezado, cualquier delimitador y campos entrecomillados que contienen saltos de línea;
• un documento JSON, como una matriz de objetos o la parte que usted señale;
• un documento XML, donde usted nombra el elemento de fila y sus atributos y elementos secundarios se convierten en campos.

En la API web, usted envía los datos en la solicitud, o guarda una fuente de datos en su servidor y la referencia. El motor nunca obtiene datos de Internet.

• Los campos se encuentran por una ruta con puntos, como ShipTo.Name, sin distinguir entre mayúsculas y minúsculas.
• Campos declarados. Una plantilla puede declarar los campos que espera, de modo que el editor y el validador funcionan sin datos reales. Una referencia a un campo no declarado produce una advertencia. BarcoderX también puede deducir la lista de campos a partir de un archivo CSV, JSON o XML de muestra.
• Valores faltantes. Usted elige qué ocurre cuando falta un valor: texto vacío, un error o un marcador. Cada vez se genera un diagnóstico.
• Formato. Los números y las fechas siempre se formatean con una cultura explícita. El mismo número se escribe de manera distinta para español y para inglés, y nunca se usa la cultura del equipo.
• Texto de la etiqueta en varios idiomas. Una plantilla puede contener sus propios textos para varios idiomas y elegir uno por clave, según el idioma del trabajo. Esto es independiente del idioma del propio BarcoderX.
• Las imágenes provienen de un ID de recurso, un nombre de recurso o datos en base64 de un campo.
• Valores secretos. Una plantilla puede declarar una variable de tipo secreto, por ejemplo para una contraseña RFID. La plantilla nunca contiene su valor. Cada trabajo lo proporciona. No aparece en los registros, en las vistas previas ni en los registros de auditoría.

Contadores, máscaras y secuencias

• Un contador tiene un nombre, un inicio, un paso (positivo o negativo), un ancho con relleno, un alfabeto (decimal, hexadecimal, letras, letras y dígitos, o uno propio) y lo que ocurre al llegar al final (volver al inicio o detenerse con un error). Puede contar por etiqueta, por copia o cada cierto número de etiquetas. BarcoderX calcula los contadores por sí mismo, de modo que ejecutar dos veces el mismo trabajo da los mismos números. Cuando la impresora puede numerar las etiquetas por sí misma, BarcoderX puede encargarle la cuenta a la impresora si usted elige la intención NativePreferred.
• Una máscara da formato a un valor con un patrón como (##) ####-####, donde # representa un dígito, A una letra y * una letra o un dígito. Una máscara también puede indicar cómo avanza un número de serie, saltando los caracteres fijos.
• Una secuencia es un contador que vive en su servidor, dentro de la API web. Entrega bloques de números que nunca se superponen, incluso cuando muchas solicitudes los piden al mismo tiempo, y una solicitud repetida devuelve el mismo bloque. Las secuencias sirven para referencias seriales, como el SSCC.

Plantillas en la API web

La API web conserva cada versión guardada de una plantilla y no la modifica después. Usted trabaja en un borrador, lo publica y puede restaurar una versión anterior. Una plantilla con sus fuentes e imágenes se puede exportar como un solo archivo y se puede importar en otro servidor. Al importar una fuente, quien la importa debe confirmar de nuevo la licencia de la fuente.

Límites

BarcoderX limita el tamaño de una plantilla, su profundidad de anidamiento, el número de elementos y el tamaño de las fuentes de datos, y rechaza lo que supere un límite. La API web publica los límites vigentes.

BarcoderX es un producto de P4 Software.