El propósito de las funciones es manipular los datos que se asignaron a los objetos de etiquetas. Las funciones procesan los valores de los orígenes de datos existentes y almacenan el resultado en los orígenes de datos generados por la función.
Cada función puede conectarse directamente con un objeto y utilizarse como parte de otra función.
Sugerencia
Todas las funciones de soluciones o etiquetas se incluyen en el Explorador de datos dinámicos y en el Administrador de datos dinámicos.
Para agregar una nueva función a un archivo de etiquetas o soluciones, haga clic en Agregar nueva función y seleccione la función apropiada de la lista. En cuanto agrega una nueva función, aparece un diálogo de configuración que le permite editar la función según sus necesidades. Las opciones de configuración se describen en las secciones dedicadas a cada tipo de función.
Desktop Designer incluye los siguientes tipos de funciones:
-
Subconjunto: extrae una parte específica de los datos según las reglas definidas por el usuario.
-
Concatenar: combina dos o más valores de orígenes de datos en un valor único.
-
Desplazamiento de fecha: desplaza la fecha presente.
-
Lineal: transforma el valor actual usando varios tipos de funciones lineales.
-
VBScript: permite realizar transformaciones de valores complejas.
-
Expresión VBScript: es una versión simplificada de la función VBScript.
-
Secuencia de comandos Python: permite realizar transformaciones de valores complejas.
-
HIBC: codifica los datos de acuerdo con el estándar de los códigos de barras de la industria de salud.
-
GS1-128: codifica los datos de acuerdo con el estándar de los códigos de barras GS-128.
-
ANSI MH10.8.2: codifica los datos de acuerdo con el estándar ANSI MH10.8.2-2006.
-
Transferir sintaxis de datos para medios ADC de alta capacidad: permite a los usuarios de ADC usar una utilidad de asignación simple, independientemente de qué medio ADC de alta capacidad se utilice.
-
Leer desde archivo: la función lee el contenido desde un archivo específico y lo muestra en un objeto.
-
Mensaje NDEF: esta función le permite definir un formato de encapsulación de mensajes para el intercambio de información en un vínculo de transmisión de datos en proximidad (NFC).
La función Subconjunto extrae una parte específica de los datos según las reglas definidas por el usuario.
El grupo Acerca de identifica la función.
El Origen de datos de entrada define el origen de datos de entrada existente o que se agregó recientemente (registro de base de datos, función o variable). El valor final (salida) se extrae desde el valor seleccionado del origen de datos de entrada.
El grupo Definición ofrece dos métodos para extraer los datos del origen de datos de entrada.
La Longitud fija extrae un número fijo de caracteres del origen de datos de entrada.
-
El Desplazamiento define el número de caracteres que se omitirán desde el principio del valor.
-
Longitud: longitud del valor extraído.
Ejemplo 34. Ejemplo:
Valor de entrada: ABCDE
Desplazamiento: 0
Longitud: 3
Valor de subconjunto: ABC
Ejemplo 35. Ejemplo:
Valor de entrada: ABCDE
Desplazamiento: 2
Longitud: 3
Valor de subconjunto: CDE
Delimitado se utiliza al extraer datos, separados por el delimitador establecido por el usuario.
-
Delimitador: carácter (coma en forma predeterminada) que separa los campos de valor de entrada.
-
Calificador de texto: carácter que encierra los valores dentro de los campos (comillas en forma predeterminada).
Sugerencia
Si se utiliza un calificador de texto, el delimitador dentro de los calificadores de texto también pertenece al valor de los datos. El calificador de texto puede dejarse vacío.
-
Número de campo: número de campo que se extrae del origen de datos de entrada.
Ejemplo 36. Ejemplo:
Valor de entrada: "A", "B", "C", "D"
Delimitador: ,
Calificadores de texto: "
Número de campo: 3
Valor de subconjunto: C
La función Concatenar combina dos o más valores de orígenes de datos en un valor único.
El grupo Acerca de identifica la función.
El grupo Origen de datos de entrada define el origen de datos de entrada existente o que se agregó recientemente (registro de base de datos, función o variable) o el texto fijo que se utilizará en la función.
El grupo Opciones de salida define el formato del valor de salida.
El carácter delimitador puede ingresarse manualmente o se puede seleccionar de una de las opciones adicionales: Línea nueva (CR/LF): carácter de línea nueva. El carácter delimitador puede ingresarse manualmente o puede seleccionarse de una de las opciones adicionales:
-
Línea nueva (CR/LF): carácter de línea nueva.
-
Insertar carácter especial: se ingresa el carácter especial.
Nota
El delimitador es un valor opcional. Si no se define un delimitador, los valores concatenados se combinan sin un carácter o espacio delimitador.
-
Ignorar valores vacíos: ignora los valores de orígenes de datos vacíos. Estos valores se excluyen de la concatenación.
Sugerencia
Esta opción es útil para evitar la duplicación de delimitadores si aparecen valores vacíos.
Ejemplo 37. Ejemplo:
Valor de origen de datos 1: A, B, C, D
Valor de origen de datos 2: <empty>
Valor de origen de datos 3: E, F, G
Delimitador: ,
Valor concatenado con o sin valores vacíos ignorados: A, B, C, D, E, F, G o A, B, C, D, E, F, G
Nota
La opción Ignorar valores vacíos entra en efecto únicamente después de que se ejecuta un comando de impresión. Al almacenar en modo de impresión almacenar/recuperar o exportar una etiqueta, los valores vacíos no se ignoran. Los delimitadores aparecen duplicados.
La función Desplazamiento de fecha define el número de días, meses o años que se agregarán o restarán de una fecha específica (puede ser la fecha actual o una fecha pasada/futura).
El grupo Acerca de identifica la función.
El Origen de datos de entrada define el origen de datos de entrada desde el cual se utilizarán los datos en la función.
Desplazamiento es el número de días, meses o años que se agregarán o restarán del origen de datos de entrada.
Ejemplo:
Fecha actual: 8 de marzo de 2016
Desplazamiento: Días +1; Meses +1; Años +1
Resultado: 7 de abril de 2017
El grupo Formato de salida define la salida de la función.
-
Formato de salida: define el formato de la fecha que se utilizará en el objeto conectado.
-
Muestra: fecha actual en el Formato de salida seleccionado.
La función Lineal multiplica o divide un valor de origen de datos de entrada por un Multiplicador definido. También se puede agregar un valor opcional (Adición).
El grupo Acerca de identifica la función.
El Origen de datos de entrada define el origen de datos de entrada desde el cual se utilizarán los datos en la función.
Los Parámetros de la función lineal son:
-
Modo: tipo de función lineal.
-
a: multiplicador de funciones.
-
b: adición de funciones.
El grupo Formato de resultados define el formato de salida de la función.
El Formato de resultados es el formato de un valor modificado. más... abre opciones de formato adicionales:
-
Separador decimal: carácter que marca el borde entre las partes entera y fraccionaria de un número decimal.
-
Posiciones decimales: número de lugares detrás del separador decimal.
-
Usar separador de 1000: millares separados o no separadores por un delimitador.
-
Delimitador: carácter que separa los millares del resto del numeral.
-
Muestra: vista previa del valor del resultado con formato.
La función VBScript permite leer, escribir y manipular los datos que pertenecen a cualquier origen de datos conectados.
El grupo Acerca de identifica la función.
-
Tipo de función: muestra qué tipo de secuencia de comandos está seleccionada.
El grupo VBScript permite definir la secuencia de comandos.
-
Insertar origen de datos: inserta un origen de datos existente o creado recientemente en la secuencia de comandos.
-
Verificar: valida la sintaxis de la secuencia de comandos ingresada.
-
Editor de Secuencias de comandos:abre el editor, que facilita la creación de secuencias de comandos y la hace más eficiente.
Nota
El resultado de la secuencia de comandos debe guardarse en el 'Resultado'. El valor del 'Resultado' se inserta en el nombre de la función. Dicha función está disponible como un origen de datos dinámicos para seguir utilizándola.
Ejemplo 39. Ejemplo:
La variable NAME proporciona el nombre y el apellido de una persona. La función VBScript debe separar los nombres y usar únicamente el nombre de pila como resultado de la función.
Valor inicial de la variable NAME: Gustavo Pérez
Dim Spc
Spc = InStr(NAME, " ")
if NAME <> "" then
Result = Mid(NAME, 1, Spc-1)
end if
Resultado de VBScript: Gustavo
Nota
Para verificar si una variable de fecha está vacía, use la sintaxis:
Datevariable.Value == None
La Expresión VBScript es una versión simplificada en línea de la función VBScript. Esta función Desktop Designer le permite:
-
manipular variables existentes
-
extraer subcadenas
-
realizar cálculos rápidos
La Expresión VBScript reduce la necesidad de escribir VBScripts dedicados. En lugar de escribir una cadena entera, ingrese una expresión de una línea en el campo de edición que se valida al momento de imprimir.
Sugerencia
A diferencia de los comandos de VBScript, una expresión VBScript no necesita que el valor final se almacene en Resultado.
Acerca de
Expresión VBScript
-
Insertar origen de datos: inserta un origen de datos existente o creado recientemente en la expresión.
-
Verificar: validación de la sintaxis de la secuencia de comandos ingresada.
-
Editor: campo para escribir y editar secuencias de comandos.
NiceLabel 10 proporciona un editor de secuencias de comandos que facilita la creación de secuencias de Python o VBScript, no presenta errores y es más rápido.
La selección de los idiomas de secuencias que deben usarse en el Editor de secuencias de comandos difiere entre NiceLabel Designer Pro y Automation Builder :
-
En Desktop Designer , haga doble clic en la superficie de diseño del formulario para abrir Propiedades del formulario > Configuración adicional > Idioma de secuencias de comandos.
-
En Automation Builder, vaya a Elementos de configuración > haga clic en Editar para abrir las propiedades del desencadenador > Configuración > Otras > Secuencia de comandos.
Sugerencia
NiceLabel 10 usa la variante .NET de Python llamada IronPython. Funciona como una implementación totalmente compatible del idioma de la secuencia de comandos de Python y también es compatible con los métodos .NET.
La banda de opciones Editor incluye los comandos utilizados comúnmente, que se distribuyen a múltiples grupos de funciones.
-
Grupo Portapapeles ofrece los comandos Cortar, Copiar, Pegar y Eliminar.
-
Grupo Deshacer permite deshacer y repetir acciones de edición de secuencias de comandos.
-
El grupo Archivo permite cargar y guardar secuencias de comando en un archivo.
-
Cargar desde archivo: carga una secuencia de comandos desde un archivo textual externo previamente guardado.
-
Guardar en el archivo: almacena una secuencia de comandos editada actualmente en un archivo de texto.
-
-
Grupo Edición: permite buscar y reemplazar cadenas en una secuencia de comandos.
-
Buscar: busca la cadena ingresada en la secuencia de comandos.
-
Reemplazar: reemplaza la cadena en la secuencia de comandos.
-
-
El grupo Insertar: el comando Origen de datos inserta orígenes de datos existentes o definidos recientemente en la secuencia de comandos.
-
Grupo Secuencia de comandos: el comando Validar secuencia de comandos valida la sintaxis de la secuencia de comandos ingresada.
Los Elementos de secuencias de comandos disponibles contienen todos los elementos de la secuencia de comandos disponibles que se pueden utilizar al crear una secuencia de comandos. Haga doble clic en el elemento o clic en el botón Insertar para insertar el elemento en la posición del cursor en la secuencia de comandos.
La Descripción de elementos brinda información básica sobre el elemento de la secuencia de comandos insertado.
La Lista de errores presenta los errores que se informaron después de ejecutar el comando Validar secuencia de comandos.
La función Secuencia de comandos Python admite incluso las manipulaciones de datos más complejas en una etiqueta o formulario.
Sugerencia
En comparación con VBScript, es una opción más adecuada para los sistemas de 64 bits. Además es una alternativa significativamente más rápida para las secuencias.
El grupo Acerca de identifica la función.
-
Tipo de función: muestra qué tipo de secuencia de comandos está seleccionada.
Secuencia de comandos Python
-
Insertar origen de datos: inserta un origen de datos existente o creado recientemente en la secuencia de comandos.
-
Verificar: valida la sintaxis de la secuencia de comandos ingresada.
-
Editor de Secuencias de comandos:abre el editor, que facilita la creación de secuencias de comandos y la hace más eficiente.
Ejemplo 40. Ejemplo:
La variable NAME proporciona el nombre y el apellido de una persona. La función Secuencia de comandos Python debe separar los nombres y usar únicamente el nombre de pila como resultado de la función.
Valor inicial de la variable NAME: Gustavo Pérez
name = NAME.Value
Spc = name.find(' ')
if name != '' and Spc != -1:
Result.Value = name[0:Spc]
else:
Result.Value = name
Resultado de secuencia de comandos Python: Gustavo
HIBC es un estándar de código de barras utilizado específicamente en el sector sanitario, según lo indicado por la organización HIBCC. Este estándar admite códigos de barras compuestos y permite el uso de varios elementos, como códigos de elementos, cantidad y número de lote en un solo código de barras.
Sugerencia
Visite el sitio web de HIBCC para obtener más información sobre el estándar.
El grupo Acerca de identifica la función.
El grupo Estructura selecciona la versión estándar y uno de los tres Tipos de códigos de barra HIBC disponibles:
-
Versión: selector de versión HIBC. Las etiquetas que incluyen codificación de datos HIBC heredados se abren usando la versión 2.5. Si se está creando una nueva etiqueta, la codificación funciona según la versión de HIBC seleccionada, 2.5 o 2.6.
-
Tipo: selector del tipo de estructura de datos.
-
Principal: estructura de datos fijos obligatoria que identifica el elemento y su proveedor.
-
Secundaria: estructura de datos opcional que se indica usando el delimitador "/". Puede tener una estructura variable (pero predefinida) para contener números de serie o lote, cantidades y fechas de caducidad.
-
Definición principal: elemento necesario para definir la estructura de datos Secundaria. Los tres campos de datos Principales de una función HIBC deben agregarse a la estructura de datos Secundaria. La Definición primaria selecciona la función HIBC existente adecuada.
-
-
Concatenadas: combina los dos primeros tipos de estructuras en una estructura de datos simple.
-
El grupo Definición define el contenido de campos de códigos de barras HIBC:
Campos de estructuras de datos Principales:
-
Código de Id de etiquetadora (LIC): campo asignado y mantenido por HIBCC. El primer carácter de este campo siempre es un carácter alfanumérico. El LIC puede identificar una etiquetadora hasta el punto de separar subsidiarias y divisiones dentro de una organización principal.
-
Producto o catálogo...: número de producto o catálogo comprimido.
-
Unidad de medida...: representación numérica del nivel de paquete (0 a 9) en la que el 0 representa el nivel más bajo o la "unidad de uso".
Ejemplo 41. Ejemplo:
La compañía puede empacar elementos de unidad de uso en una caja, en cajas en embalaje de cartón y en embalajes de cartón en un paquete. Una manera de etiquetar sería, unidad de uso = 0; Caja = 1; Embalaje de cartón = 3; y Paquete = 5.
Campos de estructuras de datos Secundarias:
-
Cantidad: campo de dos o cinco dígitos que describen el número de unidades de uso incluidas en el paquete identificado con la etiqueta del código de barras.
-
Formato de la fecha: formato de fecha preferido para utilizar con una etiqueta HIBC. Si no debe incluirse la fecha en una etiqueta, seleccione uno de los formatos que dicen "Sin fecha".
-
Fecha: muestra la fecha presente.
-
Lote: campo que puede ser alfanumérico y cuya longitud puede variar hasta un máximo de 18 caracteres. Si el campo no es necesario, debe dejarse vacío.
-
Número de serie: campo que puede ser alfanumérico y cuya longitud puede variar hasta un máximo de 18 caracteres. Si el campo no es necesario, debe dejarse vacío.
-
Fecha de producción: Identificador de datos con formato AAAAMMDD.
La función GS1-128 codifica datos de códigos de barras usando el estándar GS1-128. El estándar admite la codificación de datos de texto, números, funciones y el conjunto total de 128 caracteres ASCII.
GS1-128 codifica los datos y define su significado estableciendo una lista de Identificadores de aplicación (AI). Estos identificadores definen el contenido y la longitud de los datos que incluyen.
Los Al incluyen un campo de datos que cuenta con un número de caracteres fijo o variable.
Sugerencia
Para obtener más información sobre el estándar GS-128 y los principios de codificación, visite el sitio web de GS1.
La lista de Al disponibles se encuentra aquí.
Acerca de
El campo Identificadores de aplicación muestra los Al seleccionados.
El botón Editar definición de función abre un cuadro de diálogo para editar los identificadores. El cuadro de diálogo Definición de función permite al usuario Agregar, Borrar, Movery editar los identificadores seleccionados. Hay cuatro columnas con propiedades de identificadores:
-
Identificador: columna con número y descripción de IA de identificador.
-
Valor: columna con valor definido manual o dinámicamente como lo asigna el Origen de datos seleccionado.
Sugerencia
La columna Valor se asegura de que los valores cumplan con el estándar GS1-128. Los valores se vuelven a formatear automáticamente de acuerdo con el formato y la longitud de AI.
-
Opciones: columna con opciones de identificadores adicionales (si corresponde).
El grupo Delimitador define los caracteres delimitadores para separar los AI.
Un código de barras simple puede incluir varios AI. Estos campos se separan usando los Delimitadores de izquierda y derecha. En forma predeterminada, se utilizan los primeros dos dígitos del AI. Los delimitadores personalizados pueden definirse insertando caracteres alfanuméricos.
El grupo Resultados de funciones adicionales define una función subordinada.
-
Crear función de salida con contenido sin formato crea una función subordinada que utiliza los datos sin formato codificados por la función de GS1-128 principal.
-
Nombre de función: nombre de la última función subordinada creada.
La función ANSI MH10.8.2 (ASC) codifica datos de códigos de barras usando el estándar ANSI MH10.8.2-2006. Este estándar ofrece un rango de identificadores de datos de MH 10/SC 8 e identificadores de aplicación GS1. Permite la asignación de nuevos identificadores de datos y define la correlación, o asignación, de identificadores de datos e identificadores de aplicación.
Sugerencia
Para obtener más información sobre el estándar ANSI MH10.8.2 (ASC), visite el sitio web oficial. ANSI MH10.8.2 pertenece al estándar ISO/IEC 15418, al cual se puede acceder aquí.
El grupo Acerca de identifica la función.
Los Identificadores de aplicación permiten el uso estandarizado de la industria cruzado de identificadores de datos. Se utilizan con cualquier portador de datos alfanuméricos.
El botón Editar definición de función abre el cuadro de diálogo Definición de función. Permite al usuario Agregar, Borrar, Mover y editar los identificadores seleccionados.
Hay tres columnas con propiedades de identificadores:
-
Identificador: columna con Id de identificador.
-
Valor: columna con valor insertado manualmente o con valor definido automáticamente como lo asigna el Origen de datos seleccionado.
Nota
Cada columna de Valor permite un número limitado de caracteres. La limitación (formato) la define el estándar y varía según el identificador seleccionado.
Esta función admite el estándar internacional ISO/IEC FDIS 15434 para "Tecnología de la información – Técnicas de captura de datos e identificación automáticas – Sintaxis para medios ADC de alta capacidad".
El estándar define la manera en la que los datos se transfieren a medios de captura de datos automática (ADC) de alta capacidad del sistema de información del proveedor, y la manera en que los datos se transfieren al sistema de información del receptor.
El estándar utiliza tecnologías de alta capacidad, como símbolos de dos dimensiones, para codificar múltiples campos de datos. Estos campos generalmente los analiza el sistema de información del receptor y se asignan a campos de datos específicos en el sistema de información del receptor.
Esta función permite codificar datos en los objetos de etiquetas. Puede combinar diversos datos en un solo mensaje. Cada parte comienza con un encabezado, seguido del mensaje. Cada campo de datos puede tener un valor fijo ingresado manualmente o se puede conectar a una variable.
Nota
Asegúrese de que la variable tenga el mismo formato datos que requiere el identificador de datos. Los identificadores de datos generalmente tienen un formato estricto establecido por el estándar.
El grupo Acerca de identifica la función.
-
Identificadores de aplicación: configuración estandarizada de la industria cruzada de identificadores de datos.
Sugerencia
El propósito de los identificadores es brindar una identificación única de los elementos. Para administrar los identificadores, haga clic en Editar definición de función.
El cuadro de diálogo Definición de función permite al usuario Agregar, Borrar y editar los identificadores seleccionados.
-
Esquema del formato: columna que define las posiciones de comienzo y final para un elemento de datos con un Formato dado. Cada Esquema del formato contiene un Encabezado del formato, datos y un Finalizador del formato.
Ejemplo 42. Ejemplo:
-
El esquema del formato 02 representa los datos del mensaje/transacción EDI completos.
-
El esquema del formato 06 representa los datos que se codifican usando identificadores de datos ASC MH 101.
-
Elementos de datos: esta columna define el contenido del identificador. Inserte los datos que se codificarán manualmente o defina un origen de datos.
-
Datos de encabezado de formato: define dos elementos de encabezado de formato obligatorios.
-
Versión: organización que controla la estructura de datos.
Nota
Cada identificador permite agregar múltiples elementos.
-
Versión: número de versión de estándar de medios ADC.
-
La función Leer desde el archivo lee el contenido de un archivo específico. Puede accederse al archivo de forma local o remota a través de la conexión de la red.
El grupo Acerca de identifica la función.
El grupo de parámetros de Leer desde el archivo configura los detalles de conexión del archivo.
El Nombre de archivo establece la conexión del archivo.
La Codificación especifica el tipo de codificación para los datos enviados.
-
Automática: codificación definida automáticamente.
Sugerencia
De ser necesario, seleccione el tipo de codificación preferida en la lista desplegable.
Mensaje NDEF: esta función le permite definir un formato de encapsulación de mensajes para el intercambio de información en un vínculo de transmisión de datos en proximidad (NFC). El vínculo se establece entre dos dispositivos NFC, o entre un dispositivo NFC y una etiqueta.
Sugerencia
NFC es un conjunto de protocolos de comunicación que permite a dos dispositivos establecer comunicación al acercarlos a menos de 4 cm (2 pulgadas) entre sí.
El mensaje NDEF encapsula uno o más registros definidos por la aplicación, que aparecen en diversos tipos y tamaños. Estos registros se combinan en un solo mensaje.
Nota
El archivo de salida de esta función es en formato HEX.
El grupo Acerca de identifica la función.
El grupo Estructura de mensaje NDEF muestra los registros NDEF que se incluyen en el mensaje.
Haga clic en Editar definición de función para abrir el cuadro de diálogo Mensaje NDEF. Este cuadro de diálogo permite al usuario Agregar, Borrar, Mover y editar los registros NDEF. Hay dos columnas con propiedades de registros:
-
Tipo de registro NDEF: identifica el tipo de registro. Los tipos de registro estándar enumerados están disponibles en Desktop Designer:
-
Uri: contiene una cadena de caracteres que identifica un recurso web.
-
Texto: incluye contenido textual con información sobre la codificación de texto y el código de idioma.
-
Póster inteligente: incluye múltiples subregistros; URI, título, acciones recomendadas, ícono, tamaño y tipo.
Nota
El contenido del Póster inteligente se representa como contenido de un solo registro, aunque internamente la estructura se crea como múltiples (sub)registros dentro de un solo registro.
-
Selección de entrega por BlueTooth: conjunto de registros que incluye varios elementos; versión de entrega, cadena de direcciones de dispositivos, cadena local completa, clase de dispositivo y clase de servicio.
-
Personalizado: tipo de registro que permite la codificación de datos NFC no nativos.
Sugerencia
Arrastre y coloque los registros en el cuadro de diálogo Mensaje NDEF para cambiar rápidamente su posición.
Sugerencia
Las descripciones detalladas de los tipos de registros NDEF están disponibles en las Especificaciones técnicas del foro NFC.
-
-
Definición de registros: configuración definida por el estándar de NDEF. Las opciones disponibles dependen del tipo de registro seleccionado.
Incluir contenedor de capacidad agrega el contenedor de capacidad a los datos codificados. El contenedor de capacidad almacena datos de control para administrar los datos NFC en una etiqueta o un dispositivo. Indica al dispositivo NFC que los datos recibidos son un mensaje NFC. En los casos en los que el contenido NFC debe codificarse en una etiqueta RFID de alta frecuencia (HF) estándar, habilite la opción Incluir contenedor de capacidad. Esto indica al dispositivo lector que el contenido NFC se almacena en la etiqueta. Ciertas etiquetas compatibles con NFC ya incluyen el contenedor de capacidad, por lo cual no es necesario incluirlo como parte del contenido generado.