Esta acción asigna un valor nuevo a la variable seleccionada.
Generalmente, las variables obtendrán los valores con la acción Usar filtro de datos (disponible en Automation Builder), la cual extraerá los campos de los datos recibidos y los asignará a las variables. Además, tal vez necesite configurar usted mismo los valores de las variables, en general, por motivos de resolución de problemas. En Automation Builder, los valores de las variables no se transmiten entre múltiples desencadenadores, pero sí se mantienen mientras el mismo desencadenador se está procesando.
El grupo Variable define el nombre de variable y su valor.
-
Nombre: nombre de la variable cuyo valor debería cambiar.
-
Valor: valor que se establecerá para una variable. Pueden definirse en forma manual o dinámica usando una variable existente o recientemente creada.
Esta acción almacena los valores de una sola o de múltiples variables en un archivo asociado.
En el módulo NiceLabel Automation, esta acción permite el intercambio de datos entre desencadenadores. Para leer datos nuevamente en el desencadenador, use la acción Cargar datos de variables.
Sugerencia
Los valores se guardan utilizando el formato CSV, y la primera línea contiene los nombres de las variables. Si las variables contienen múltiples valores, se codifican nuevos caracteres de línea (CR/LF) como \n\r.
El grupo Configuración define el nombre del archivo.
-
Nombre de archivo: archivo en el que se guardarán los datos de variable. Si el nombre está integrado como parte del código, los valores se guardan cada vez en el mismo archivo.
Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte la sección Acceso a recursos de red compartidos en la guía de usuario NiceLabel Automation.
El grupo Si el archivo existe ofrece opciones adicionales para guardar los valores.
-
Sobrescribir el archivo: sobrescribe los datos existentes con los datos de variable nuevos. El contenido anterior se pierde.
-
Anexar datos al archivo: anexa los valores de variable a los archivos de datos existentes.
El grupo Estructura del archivo define los parámetros del archivo de datos variables CSV:
-
Delimitador: especifica el tipo de delimitador (tabulación, punto y coma, coma o carácter personalizado). El delimitador es un carácter que separa los valores de variables almacenados.
-
Calificador de texto: especifica el carácter que califica el contenido almacenado como texto.
-
Codificación de archivos: especifica el tipo de codificación de caracteres que se utilizará en el archivo de datos. Automática define la codificación automáticamente. De ser necesario, el tipo de codificación preferida puede seleccionarse en la lista desplegable.
Sugerencia
UTF-8 es una buena selección predeterminada.
-
Agregar nombres de variable en la primera fila: coloca el nombre de la variable en la primera fila del archivo.
El grupo Variables define las variables que se leerán de los archivos de datos. Los valores de las variables existentes se sobrescribirán con valores del archivo.
-
Todas las variables: datos variables de todas las variables del archivo de datos que se lee.
-
Variables seleccionadas: los datos variables de las variables enumeradas se leen del archivo de datos.
Esta acción carga los valores de una o múltiples variables del archivo de datos asociado como se guardaron con la acción Guardar datos de variable . Use esta acción para intercambiar datos entre desencadenadores. Puede cargar una variable específica o todas las variables almacenadas en el archivo de datos.
El grupo Configuración define el nombre del archivo.
-
Nombre de archivo: especifica el archivo desde el que deben cargarse los datos de variable. Si el nombre está integrado como parte del código, los valores se cargan cada vez desde el mismo archivo.
Utilice la sintaxis UNC para los recursos de red. Para obtener más información, consulte la sección Acceso a recursos de red compartidos en la guía de usuario NiceLabel Automation.
La configuración del grupo Estructura del archivo debe reflejar la estructura del archivo guardado mediante la acción Guardar datos de variable.
-
Delimitador: especifica el tipo de delimitador (tabulación, punto y coma, coma o carácter personalizado). El delimitador es un carácter que separa los valores.
-
Calificador de texto: especifica el carácter que califica el contenido como texto.
-
Codificación de archivos: especifica el tipo de codificación de caracteres que se utiliza en el archivo de datos. Automática define la codificación automáticamente. De ser necesario, seleccione el tipo de codificación preferida en la lista desplegable.
Sugerencia
UTF-8 es una buena selección predeterminada.
El grupo Variables define las variables cuyos datos se leerán desde los archivos de datos.
-
Todas las variables: especifica todas las variables definidas en el archivo de datos que se leerá.
-
Variables seleccionadas: especifica la selección de variables específicas que se leerán desde el archivo de datos.
Esta acción define la forma en que deben formatearse los valores de las variables seleccionadas.
Las acciones de manipulación de cadenas más conocidas son: eliminar espacios iniciales y finales, buscar y reemplazar caracteres y eliminar comillas de apertura y de cierre.
Esta característica a menudo se requiere si un desencadenador recibe un archivo de datos no estructurados o datos heredados. En estos casos, los datos deben analizarse usando el filtro Datos no estructurados. La acción de manipulación de cadenas le permite ajustar el valor de los datos.
Nota
Si esta acción no proporciona suficiente poder de manipulación de cadenas en un caso en particular, use la acción Ejecutar secuencia de comandos para manipular los datos usando Visual Basic Script o Python scripts.
El grupo Variables define las variables cuyos valores deben formatearse.
-
Todas las variables: especifica todas las variables definidas en el archivo de datos al que se le aplicará el formato.
-
Variables seleccionadas: especifica la selección de variables a las que se aplicará el formato del archivo de datos.
El grupo Formato de texto define las funciones de manipulación de cadenas que se aplican a las variables o campos seleccionados. Se pueden utilizar varias funciones. Las funciones se aplican en el mismo orden del editor, de arriba abajo.
-
Borrar espacios en el comienzo: borra todos los caracteres de espacio (código 32 ASCII decimal) en el comienzo de la cadena.
-
Borrar espacios en el final: borra todos los caracteres de espacio (valor 32 ASCII decimal) en el final de una cadena.
-
Borrar caracteres de apertura y cierre: borra los caracteres de apertura y cierre seleccionados que aparecen por primera vez en la cadena.
Ejemplo 52. Ejemplo
Al utilizar "{" como carácter de apertura y "}" como carácter de cierre, la cadena de entrada
{{selección}}se convertirá en{selección}.
-
Buscar y reemplazar: ejecuta la función estándar de buscar y reemplazar a partir de los valores provistos para buscar qué y reemplazar con. Se admiten expresiones comunes.
Nota
Existen distintas implementaciones de expresiones comunes. NiceLabel 10 utiliza la sintaxis de .NET Framework para las expresiones comunes. Para obtener más información, consulte Artículo de base de conocimiento.
-
Reemplazar caracteres que no se pueden imprimir con espacios: reemplaza todos los caracteres de control en la cadena con espacios (código 32 ASCII decimal). Los caracteres que no se pueden imprimir son caracteres con valores ASCII decimales entre 0 y 31, y 127 y 159.
-
Borrar caracteres que no se pueden imprimir: borra todos los caracteres de control de la cadena. Los caracteres que no se pueden imprimir son caracteres con valores ASCII decimales entre 0 y 31, y 127 y 159.
-
Descodificar caracteres especiales: descodifica los caracteres (o códigos de control) que no están disponibles en el teclado, como Retorno de carro y Avance de línea. NiceLabel 10 utiliza una notación para codificar dichos caracteres en lenguaje natural, como <CR> para Retorno de carro y <LF> para Avance de línea. Esta opción convierte caracteres especiales de la sintaxis NiceLabel en caracteres binarios reales.
Ejemplo 53. Ejemplo
Cuando reciba los datos "<CR><LF>", Designer utilícelos como una cadena simple de 8 caracteres. Deberá habilitar esta opción para interpretar y usar los datos recibidos como dos caracteres binarios
CR(Retorno de carro – ASCII código 13) yLF(Avance de línea – ASCII código 10).
-
Buscar y borrar todo antes de: busca la cadena provista y borra todos los caracteres que preceden a la cadena definida. La cadena también se puede borrar.
-
Buscar y borrar todo después de: busca la cadena provista y borra todos los caracteres que están detrás de la cadena definida. La cadena también se puede borrar.
-
Cambiar grafía: Cambia todos los caracteres de las cadenas a mayúsculas o minúsculas.