Para saber más sobre los filtros en general, consulte el tema Comprender los filtros.
Utilice el filtro JSON siempre que un desencadenador reciba los datos en código JSON. El filtro JSON le permite usar variables y valores de su archivo JSON. El filtro admite la extracción de datos de matrices JSON.
Nota
Automation le permite usar todos los tipos de datos JSON. Lea más sobre los tipos de datos JSON disponibles aquí.
Si bien puede definir la estructura de archivos JSON manualmente, NiceLabel recomienda importar la estructura de los archivos JSON recibidos.
Para importar la estructura de archivos JSON:
-
Vaya a Filtros de datos y Edite su filtro JSON.
-
Haga clic en Estructura > Importar estructura de datos. Navegue hasta su archivo JSON y haga clic Abrir.
Después de importar los archivos JSON, la sección Vista previa de datos muestra el contenido JSON. La Vista previa de datos también resalta los elementos que define como campos de salida.
Para ejemplos de datos JSON, consulte la sección Datos JSON.
Cuando define campos JSON, hace que los valores de los elementos seleccionados estén disponibles automáticamente. La definición de filtros hace que dichos filtros estén disponibles para asignación a variables en acciones. Esto le permite extraer los valores de los elementos.
Para definir campos JSON:
-
Seleccione el elemento y establezca su Uso en Valor de la variable.
-
El elemento se muestra en la lista de estructuras con letras en negrita, indicando que está en uso.
-
El elemento se utiliza como el nombre de campo de salida.
-
En la sección Vista previa de los datos se resaltan los valores del elemento seleccionado.
Si un elemento JSON aparece en datos JSON varias veces, es un elemento reiterativo. Generalmente, el elemento reiterativo tiene datos para una única plantilla de etiquetas. Los elementos reiterativos producen varias etiquetas con datos relevantes.
Para indicar que desea utilizar datos de todos los elementos reiterativos, y no solo del primero:
-
Seleccione el elemento y defínalo como un Bloque de datos.
-
Habilite la opción Elemento reiterativo.
Cuando el filtro contiene la definición de elementos definidos como bloque de datos / elemento reiterativo, la acción Usar filtro de datos mostrará elementos reiterativos con marcadores de posición anidados. Toda acción anidada debajo de dicho marcador de posición se ejecutará únicamente para los bloques de datos en este nivel.
Aviso
El filtro de datos JSON con bloque de datos anidado duplica los valores del área de asignación anterior si una variable está definida en el primer bloque pero no en el segundo. Por ejemplo, se imprimen dos etiquetas. En la primera área de asignación, define una variable "manufacturer_serial". En la segunda área de asignación, esta variable no está presente.
{
"jobs": [
{
"data": [
{
"manufacturer_serial": "706583012001",
"package_code": "AA792CY"
}
],
"label_filename": "serial_number_label.nlbl",
"print_quantity": 1,
"printer_name": "Warehouse_printer_09"
},
{
"data": [
{
"package_code": "BE273XS"
}
],
"label_filename": "serial_number_label.nlbl",
"print_quantity": 1,
"printer_name": "Warehouse_09"
}
]
}
El resultado esperado sería la segunda etiqueta sin los datos de "manufacturer_serial". Pero en la impresión real, la segunda etiqueta contendría el valor de "manufacturer_serial" de la primera etiqueta, que es 706583012001.
Hay tres soluciones posibles:
-
Evitar los bloques de datos anidados.
-
Definir los valores de las variables como valores vacíos ("") si las variables no se utilizan en los bloques de datos anidados.
"data": [ { "manufacturer_serial": "", "package_code": "AA792CY" } -
Utilizar condiciones en las acciones para establecer variables.
-
Utilizar la manipulación de cadenas cuando se detectan las variables faltantes.
El filtro JSON identifica automáticamente los campos y sus valores en los datos recibidos. Esto elimina la necesidad de asignación manual variable-a-campo.
Nota
Debido a que no hay atributos opcionales en JSON, Automation define los Nombres de las variables y los Valores de las variables automáticamente.