Para saber más sobre los filtros en general, consulte el tema Comprender los filtros.
Utilice este filtro cuando reciba un archivo de texto estructurado. Son archivos de texto en los que los campos se identifican mediante uno de los métodos:
-
Campos delimitados por un carácter: Los caracteres delimitadores comunes con la coma o el punto y coma. CSV (valores separados por comas) es un ejemplo típico de un archivo delimitado.
-
Archivos contienen número fijo de caracteres: En otras palabras, los campos están definidos por columnas de ancho fijo.
Para ver ejemplos de datos de texto estructurado, consulte la sección Base de datos de texto.
Definir estructuras
Para definir la estructura del archivo de texto, tiene las siguientes opciones:
-
Importar estructura usando el Asistente de archivos de texto: En este caso, haga clic en el botón Importar estructura de datos en la banda de opciones y siga las instrucciones en pantalla. Una vez que termina el asistente, se definirán el tipo de base de datos de texto y todos los campos. Si la primera línea de datos tiene los nombres de los campos, el Asistente puede importarlos. Este es el método recomendado, si el desencadenador siempre recibe datos cuya estructura no se modifica.
-
Definir los campos manualmente: En este caso, debe definir en forma manual el tipo de datos (campos delimitados o campos de ancho fijo) y luego definir los nombres de los campos. Para obtener más información, consulte el tema Definir campos.
-
Leer los campos en forma dinámica: En este caso, el desencadenador podría recibir datos estructurados de una forma diferente. Un ejemplo de esto son los nombres de campos - la estructura dinámica elimina la necesidad de actualizar el filtro para cada cambio estructural. El soporte de la estructura dinámica lee automáticamente todos los campos de datos, sin importar si existen nuevos campos o si faltan algunos de los campos anteriores. Los asigna automáticamente a las variables usando los mismos nombres. Para obtener más información, consulte el tema Habilitar estructura dinámica.
La sección Vista previa de los datos simplifica la configuración. En el panel de vista previa, el resultado de la regla del filtro definido se resalta en el área de vista previa con cada cambio de configuración. La Vista previa de datos le permite comprobar que datos se extraen con cada regla.
Para archivos de texto estructurados, la definición de los campos es muy sencilla. Existen dos opciones:
-
El delimitador define los campos: en este caso, tiene un carácter delimitador, como coma o punto y coma, que separa los campos. Solo debe definir los nombres de los campos en el mismo orden con el que aparecerán en los datos recibidos por un desencadenador.
-
Campos con ancho fijo: en este caso, debe definir los nombres de los campos en el mismo orden con el que aparecerán en los datos recibidos por un desencadenador y definir el número de caracteres que ocupará el campo. Esos caracteres serán leídos desde los datos para este campo.
Vista previa de los datos
Esta sección proporciona la vista previa de la definición del campo. Cuando se selecciona el elemento definido, se resalta su posición en los datos en vista previa.
-
Vista previa del nombre del archivo: especifica el archivo que contiene los datos de muestra que se analizarán a través del filtro. Se copia el archivo en vista previa de la definición del filtro. Si cambia el nombre del archivo en vista previa, se guarda el nuevo nombre.
-
Abrir: selecciona otro archivo sobre el cual ejecutar las reglas de filtro.
-
Actualizar: vuelve a ejecutar las reglas de filtro sobre el contenido del nombre del archivo en vista previa. Automation actualiza la sección Vista previa con el resultado.
Opciones de formato
Esta sección define las funciones de manipulación de cadenas que se aplicarán a las variables o campos seleccionados. Puede seleccionar una o varias funciones. Las funciones se aplican en el mismo orden seleccionado en la interfaz del usuario: de arriba a 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 el carácter de apertura y cierre: borra los caracteres de apertura y cierre seleccionados que aparecen por primera vez en la cadena.
Ejemplo 2. Ejemplo
Si utiliza "{" para el carácter de apertura y "}" para el 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. También puede usar expresiones comunes.
Nota
Existen varias implementaciones de expresiones comunes en uso. 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. utiliza una notación para codificar dichos caracteres en lenguaje natural, como <CR> para Retorno de carro y <LF> para Avance de línea. Para obtener más información, consulte el tema Introducción de caracteres especiales (Códigos de control).
Esta opción convierte caracteres especiales de la sintaxis en caracteres binarios reales.
Ejemplo 3. Ejemplo
Cuando reciba los datos "<CR><LF>", los usa 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 eliminar todo antes de: Busca la cadena provista y borra todos los caracteres desde el comienzo de los datos hasta la cadena. La cadena buscada también se puede borrar.
-
Buscar y eliminar todo después de: Busca la cadena provista y borra todos los caracteres desde la cadena hasta el fin de los datos. La cadena buscada también se puede borrar.
-
Cambiar grafía: Cambia todos los caracteres de las cadenas a mayúsculas o minúsculas.
El filtro de texto estructurado tiene la capacidad de identificar automáticamente los campos y sus valores dentro de los datos recibidos. Esto elimina la necesidad de asignación manual variable-a-campo.
La funcionalidad Estructura dinámica es útil si el desencadenador recibe datos con una estructura cambiante. En dichos casos, la estructura principal de los datos permanece sin cambios ( p.ej. los campos están delimitados por coma), o conserva la misma estructura, pero cambia el orden o el número de los campos. Podría haber campos nuevos, o algunos de los campos anteriores podrían ya no estar disponibles. Debido a la Estructura dinámica, habilitada, el filtro identifica automáticamente la estructura del archivo recibido. Al mismo tiempo, el filtro lee los nombres de campos y sus valores (pares name:value
) de los datos. Esto elimina la necesidad de asignación manual de campos a variables.
Usar filtro de datos la acción no ofrece posibilidades de asignación, debido a que realiza la asignación en forma dinámica. Incluso no tendrá que definir las variables de etiquetas en la configuración de los desencadenadores. La acción asignará valores de campo a las variables de las etiquetas del mismo nombre, sin tener que importar las variables de la etiqueta. No obstante, esta regla se aplica solamente a la acción Imprimir etiqueta. Si quiere usar los valores de campo en otra acción, deberá definir variables en el desencadenador, y mantener, al mismo tiempo, la asignación automática de variable a campo.
Nota
No se producirá ningún error si el campo disponible en los datos de entrada no tiene una variable de etiqueta correspondiente. ignora en silencio las variables faltantes.
Configurar la estructura dinámica
Para configurar la estructura dinámica, habilite la opción Estructura dinámica en las propiedades del filtro de texto estructurado.
-
La primera línea de los datos debe tener los nombres de los campos.
-
La línea que seleccione para Comenzar importación en la línea debe ser la línea con los nombres de los campos (generalmente, la primera línea en los datos).
-
La estructura de los datos debe delimitarse.
-
Si es necesario, puede aplicar formato a los datos.
Opciones de formato
Esta sección define las funciones de manipulación de cadenas que se aplicarán a las variables o campos seleccionados. Puede seleccionar una o varias funciones. Las funciones se aplican en el mismo orden seleccionado en la interfaz del usuario: de arriba a 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 el carácter de apertura y cierre: borra los caracteres de apertura y cierre seleccionados que aparecen por primera vez en la cadena.
Ejemplo 4. Ejemplo
Si utiliza "{" para el carácter de apertura y "}" para el 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. También puede usar expresiones comunes.
Nota
Existen varias implementaciones de expresiones comunes en uso. 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. utiliza una notación para codificar dichos caracteres en lenguaje natural, como <CR> para Retorno de carro y <LF> para Avance de línea. Para obtener más información, consulte el tema Introducción de caracteres especiales (Códigos de control).
Esta opción convierte caracteres especiales de la sintaxis en caracteres binarios reales.
Ejemplo 5. Ejemplo
Cuando reciba los datos "<CR><LF>", los usa 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 eliminar todo antes de: Busca la cadena provista y borra todos los caracteres desde el comienzo de los datos hasta la cadena. La cadena buscada también se puede borrar.
-
Buscar y eliminar todo después de: Busca la cadena provista y borra todos los caracteres desde la cadena hasta el fin de los datos. La cadena buscada también se puede borrar.
-
Cambiar grafía: Cambia todos los caracteres de las cadenas a mayúsculas o minúsculas.