Leer archivo

Origen

• Ubicación: Especifica el sistema de archivos donde se encuentra la carpeta de origen. Los sistemas o ubicaciones de archivos pueden incluir sistemas de archivos o recursos de red, Librarian, o una ubicación de almacenamiento en la nube compatible. Para obtener más información sobre las ubicaciones de almacenamiento en la nube compatibles, consulte la Cloud Storage Page de Administration Console.

• Nombre de archivo: Especifica el archivo desde el que leerá la acción. Puede introduzca la ubicación de la carpeta o el nombre del archivo, o hacer clic en Examinar para localizar y, después, seleccionar el archivo que quiera. Alternativamente, puede añadir una variable para especificar el archivo que quiera o añadir un carácter especial al valor que haya introducido.

Si ha hecho clic para marcar la casilla Esperar a que llegue el archivo dentro de Detección de archivos (a continuación), la opción Nombre de archivo se convierte en Carpeta a examinar.

• Carpeta a examinar: Especifica la ubicación de la carpeta en la que la acción tiene que buscar el archivo. Puede escribir la ubicación de la carpeta o hacer clic en Explorar para localizar y seleccionar la carpeta que quiera. Alternativamente, puede añadir una variable que especifique la carpeta a examinar, o añadir un carácter especial al valor que haya introducido. Disponibles solo al marcar la casilla Esperar a que llegue el archivo, dentro de Detección de archivo.

• Buscar carpetas secundarias: Especifica que la acción también analiza todas las subcarpetas de la carpeta especificada por la propiedad Carpeta a examinar.

• Codificación de archivos: Especifica el método que se utiliza para codificar el archivo que se está leyendo.

• Formato del contenido del archivo: Se utiliza para especificar el tipo de contenido de datos. La acción procesa los contenidos del archivo según este formato.

• Los datos se encuentran en un mensaje SOAP: Especifica que la acción busca los datos que contendrá un mensaje SOAP.

• Tiempo de espera de archivo bloqueado: Especifica cuántas veces se intentará abrir el archivo que se encuentre inicialmente bloqueado por otra aplicación.

Detección de archivos

• Esperar a que llegue el archivo: Especifica que la acción espera a que llegue el archivo si aún no existe dentro de la carpeta.

Las opciones de detección de archivos solo están disponibles cuando marca la casilla Esperar a que llegue el archivo.





• Opciones de detección

  • Método de búsqueda: Especifica el método que utiliza la acción para monitorizar la carpeta de búsqueda para la llegada del archivo especificado.

    • Notificación y sondeo: Especifica que la acción monitoriza la carpeta de búsqueda continuamente y a intervalos concretos. Esta opción es útil cuando tenga dudas sobre la fiabilidad de su sistema de archivos. Si una búsqueda continua pasa por alto un evento, una búsqueda agrupada garantiza que sea detectado. Al seleccionar esta opción, puede especificar el intervalo de sondeo en milisegundos, segundos, minutos u horas.

    • Solo notificaciones: Especifica que la acción monitoriza la carpeta de búsqueda continuamente.

    • Solo sondeo: Especifica que la acción busca en la carpeta de búsqueda a intervalos concretos. Al seleccionar esta opción, puede especificar el intervalo de sondeo en milisegundos, segundos, minutos u horas.

  • Intervalo de sondeo: Especifica la frecuencia con la que la acción busca el archivo. Disponible cuando se selecciona Notificación y Sondeo o Solo sondeo para el Método de búsqueda.

  • Patrón de archivo: Especifica el filtro que utiliza la acción para identificar el archivo en el que desea que se ejecute la acción. Este filtro puede incluir caracteres comodín (como ? y *) o expresiones regulares (como (?i)^.*\.csv$). Haga clic en para ver una lista de modificadores de expresión regular o comodín compatibles, y seleccione el modificador que desea añadir. También puede añadir una variable para especificar la plantilla del archivo o añadir un carácter especial al valor que haya introducido.

    • Utilizar expresión regular: Especifica que la acción utiliza expresiones regulares para identificar el patrón de archivo. Al seleccionar esta opción, puede añadir modificadores de expresiones regulares a la propiedad anterior para tener más control sobre los criterios de búsqueda.

  • Tamaño de archivo mínimo: Especifica el tamaño mínimo que debe tener el archivo para que la acción lo acepte como archivo de origen.

  • Tamaño de archivo máximo: Especifica el tamaño que el archivo no puede superar para que la acción lo acepte como archivo de origen.

  • Tiempo de espera del archivo: Especifica la antigüedad máxima que puede estar un archivo en la carpeta especificada para que la acción pueda seguir aceptándolo como archivo de origen. El tiempo de espera máximo puede especificarse en milisegundos, segundos, minutos u horas, y se compara con la propiedad "LastModifiedTime" del archivo.

• Orden de clasificación de múltiples archivos

  Define el orden en el que la acción procesa los archivos de la carpeta especificada, en la que más de un archivo coincide con el patrón de archivo indicado. Si no se especifica ningún orden de clasificación en la página de propiedades, el proceso de ordenación predeterminado es la fecha y hora de creación (ascendente) y después el nombre del archivo (ascendente). Puede especificar hasta cuatro criterios.

  • Ordenar: Muestra el orden en el que se aplican los criterios de clasificación con los archivos coincidentes de la carpeta especificada.

  • Ordenar campo: Especifica los criterios que se aplicarán a los archivos coincidentes.

  • Dirección: Especifica si se utiliza el orden ascendente o descendente cuando el criterio del campo de clasificación se aplica a los archivos coincidentes.

  • Añadir criterio de clasificación: Especifica criterios de clasificación adicionales.

Salida

• Guardar contenidos de archivo a variable: Especifica la variable en la que quiera guardar la variable del archivo. Introduzca la variable en el cuadro de entrada. Alternativamente, puede añadir una variable.

Acción

• Nombre: Especifica el nombre de la acción. Puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.

• Descripción: Especifica una descripción para la acción.

• Ejecutar acción: Especifica la frecuencia con la que quiere que la acción se ejecute.

  • Siempre: Especifica que la acción se ejecuta la acción cada vez que ocurre el evento.

  • Nunca: Especifica que la acción no se ejecuta cuando ocurre el evento.

  • Condicionalmente, en base a una variable: Especifica que la acción se ejecuta solo cuando una variable seleccionada cumple una condición específica. Utilice esta opción en situaciones en las que solo haya una condición que determine si la acción se ejecutará o no. Después de seleccionar esta opción, puede crear la instrucción condicional en el cuadro de entrada.

    Controles del cuadro de entrada

    • Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.

    • Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.

    • Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.

  • Condicionalmente, en base a una expresión: Especifica las condiciones en las que se ejecuta la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Cuando selecciona esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales que desee. Cree y edite su expresión condicional en la ficha Vista del árbol. Haga clic en la ficha Vista del texto para ver una vista del texto de solo lectura de la expresión condicional.

    Controles del cuadro de entrada (Ficha Vista del árbol)

    • [Unión condicional]: Especifica la unión condicional para las instrucciones condicionales del grupo. La unión condicional predeterminada es Y.

      Haga clic en la unión condicional existente para que se muestre un menú que le permitirá configurar su expresión condicional de una de las siguientes maneras:

      • And, Or, NotAnd, NotOr: Haga clic en la unión condicional de la lista que quiera utilizar como instrucción condicional. Para obtener más información sobre las uniones condicionales compatibles, consulte Uniones condicionales.

      • Añadir condición: Haga clic para añadir otra instrucción condicional para el grupo actual.

      • Añadir grupo: Haga clic para añadir un subgrupo de instrucciones condicionales para el grupo actual.

      • Eliminar grupo: Haga clic para eliminar el subgrupo. Disponible cuando se abre el menú desde un subgrupo.

      • Eliminarlo todo: Haga clic para eliminar todas las declaraciones condicionales (incluyendo subgrupos). Disponible cuando se abre el menú desde el grupo más alto.

    • : Añade una declaración condicional para el grupo asociado con dicha unión. Visible a la derecha de cada unión condicional de su expresión.

    • :  Elimina la declaración condicional. Visible a la derecha de una expresión condicional existente cuando se señala la expresión.

    • Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.

    • Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.

    • Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.

Gestión de errores y diagnósticos

• Ignorar errores y continuar ejecutando acciones: Especifica que en caso de que la acción falle, las demás acciones siguen ejecutándose. Cuando no se selecciona esta opción y la acción falle, el comportamiento resultante depende de varios factores, como son:

  La acción está dentro de una Acción de grupo

  • Si ha especificado Secuencialmente para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, no se ejecutan más acciones dentro de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.

  • Si ha especificado En paralelo para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, los errores se ignoran y se ejecutan las demás acciones de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.

  La acción no está dentro de una Acción de grupo

  • Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la ficha Ejecución, no se ejecutan más acciones del evento.

  • Si ha especificado En paralelo para la propiedad Ejecutar acciones de la ficha Ejecución, los errores se ignoran y se ejecutan las demás acciones del evento.

• Reintentar si falla: Especifica que si la acción falla, BarTender intenta ejecutarla de nuevo.

  • Máximo de reintentos: Especifica la cantidad máxima de veces que BarTender volverá a intentar ejecutar la acción. Disponible cuando se haya seleccionado la opción Reintentar si falla.

  • Reintentar intervalo: Especifica el tiempo que BarTender esperará después de que la acción haya fallado y antes de volver a ejecutarla. Disponible cuando se haya seleccionado la opción Reintentar si falla.