Abierto de navegación

The Read File action directs the Integration Service to look in a specified folder for a defined file type, read the data that is contained in that file, and then save the data to a variable.

You can configure the following properties for the Read File action:

Acción

• Nombre: Especifica el nombre de la acción. Si lo desea, puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.

• Descripción: Permite guardar una descripción para la acción.

• Ejecutar acción: Permite especificar la frecuencia con la que quiera ejecutar la acción.

  • Siempre: Especifica que Integration Service ejecutará la acción cada vez que ejecute la integración.

  • Nunca: Especifica que Integration Service no ejecutará la acción cuando ejecute la integración.

  • Condicionalmente, en base a una variable: especifica que Integration Service ejecutará la acción 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. Una vez que haya activado esta opción, puede crear la instrucción condicional en el cuadro de entrada.

    Controles del cuadro de entrada

    • Variable: Introduzca la variable que quiera utilizar como instrucción condicional. Alternativamente, puede añadir una variable para el valor de la instrucción condicional.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para abrir 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 el/los valor(es) que se utilizará(n) para la instrucción condicional. Algunos operadores, como Is null y Is not null, 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.

       

  • Con condiciones, en base a la expresión: Especifica las condiciones bajo las que Integration Service ejecutará la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Una vez que haya activado esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales deseadas. 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. The default conditional joiner is And.

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

      • Seleccione una unión condicional diferente: Las opciones del menú incluyen una lista de uniones condicionales. Seleccione la unión condicional 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: Disponible en el menú cuando el menú se haya abierto desde un subgrupo. Haga clic para eliminar el subgrupo.

      • Eliminarlo todo: Disponible en el menú cuando el menú se haya abierto desde el grupo de mayor nivel. Haga clic para eliminar todas las instrucciones condicionales (incluyendo subgrupos).

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

    • : Visible cuando posiciona el cursor sobre una instrucción condicional existente. Haga clic para eliminar la declaración condicional.

    • Variable: Introduzca la variable que quiera utilizar como instrucción condicional. Alternativamente, puede añadir una variable para la instrucción condicional.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para abrir 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 el/los valor(es) que se utilizará(n) para la instrucción condicional. Algunos operadores, como Is null y Is not null, no requieren que se especifique ningún valor. En estas situaciones, se ocultará el campo Valor.

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

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. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

• Nombre de archivo: Specifies the file that the Integration Service will read from. Puede escribir la ubicación de la carpeta y el nombre del archivo, o hacer clic en Explorar para localizar y seleccionar el archivo deseado. Alternativamente, puede añadir una variable para especificar el archivo deseado, o añadir un carácter especial al valor que haya introducido.

If you have clicked to select the Wait for file to arrive check box under File Detection (as follows), the File Name option changes to the Folder to Scan option.

• Carpeta a examinar: Especifica la ubicación de la carpeta en la que Integration Service tiene que buscar el archivo. Puede escribir la ubicación de la carpeta o hacer clic en Explorar para localizar y seleccionar la carpeta deseada. Alternativamente, puede añadir una variable que especifique la carpeta a examinar, o añadir un carácter especial al valor que haya introducido.

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

• Formato del contenido del archivo: Specifies the data contents type. The Integration Service processes the contents of the file according to this format.

• Los datos se encuentran en un mensaje SOAP: Al activarla, Integration Service espera que los datos estén dentro de 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: When this option is selected, the Integration Service waits for the file to arrive if it does not already exist in the folder.

File detection options are available only when you have clicked to select the Wait for file to arrive check box.





• Opciones de detección

  • Método de búsqueda: Especifica el método que utilizará Integration Service para monitorizar la carpeta de búsqueda para la llegada del archivo especificado.

    • Notificación y sondeo: Especifica que Integration Service monitorizará la carpeta de búsqueda tanto continuamente como a intervalos concretos. Esta opción se puede utilizar cuando tenga dudas sobre la fiabilidad de su sistema de archivos. En el supuesto de que un evento pasara inadvertido durante la búsqueda continua, un sondeo garantizaría su detección. Al seleccionarlo, puede especificar el intervalo de sondeo en milisegundos, segundos, minutos u horas.

    • Solo notificaciones: Especifica que Integration Service monitorizará la carpeta de búsqueda continuamente.

    • Solo sondeo: Especifica que Integration Service buscará en la carpeta de búsqueda a intervalos concretos. Al seleccionarlo, puede especificar el intervalo de sondeo en milisegundos, segundos, minutos u horas.

  • Intervalo de sondeo: Especifica la frecuencia con la que Integration Service busca el archivo, Disponible cuando se seleccione Notificación y sondeo o Solo sondeo como Método de búsqueda.

  • Patrón de archivo: Especifica el filtro para buscar archivos. El predeterminado es *.dat. Si lo desea puede utilizar una extensión de archivo distinta. Alternativamente, puede añadir una variable que especifique el patrón de archivo, o añadir un carácter especial al valor que haya introducido.

    • Utilizar expresión regular: Specifies that the Integration Service will use regular expressions to identify the file pattern. Once this option is enabled, you can add regular expression modifiers to the previous property for more control over the search criteria.

  • Tamaño de archivo mínimo: Especifica el tamaño mínimo que debe tener el archivo para que Integration Service lo acepte como archivo de origen.

  • Tamaño de archivo máximo: Especifica el tamaño que el archivo no puede superar para que Integration Service lo acepte como archivo de origen.

  • Tiempo de espera del archivo: Specifies the maximum time a file can be idle in the specified folder for the Integration Service to still accept it as the source file. The maximum idle time can be specified in milliseconds, seconds, minutes or hours, and is compared against the file's "LastModifiedTime".

• Orden de clasificación de múltiples archivos

  Define el orden en el que Integration Service procesará los archivos de la carpeta especificada, en la que más de un archivo coinciden con el patrón de archivo indicado. Si no se especifica ningún orden de clasificación en la página de propiedades, el orden predeterminado es la fecha y hora de creación (ascendente) y después el nombre del archivo (ascendente). Puede especificar entre cero y 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: Permite añadir criterios de clasificación adicionales.

Salida

• Guardar contenidos de archivo a variable: Especifica la variable en la que quiera guardar la variable del archivo. Enter the variable in the input box. Alternativamente, puede añadir una variable.

Probar Leer archivo

• Prueba: Ejecuta la acción. El panel Mensaje indica si la acción se ha realizado con éxito o si ha fallado.

  Al hacer clic en el botón Prueba se ejecuta la acción, pero no la integración. Por lo tanto, la acción se ejecutará sin ningún dato de la integración que haya podido configurar para utilizarla conjuntamente con la acción. Para más información sobre cómo probar su integración, consulte Utilizar el panel Prueba.

Cuenta de usuario

• Heredar de la acción principal: Al activarla, la acción hereda las credenciales de la cuenta de usuario especificada en la página de propiedades Acciones. Alternativamente, si la acción es parte de una acción Agrupar, heredará las credenciales de la cuenta de usuario especificadas en la página de propiedades de la acción Agrupar inmediatamente superior.

• Especificar credenciales de usuario: Al activarla, la acción se ejecuta utilizando las credenciales especificadas.

Gestión de errores y diagnósticos

• Ignorar errores y continuar ejecutando acciones: Al activarla, especifica que en caso de que la acción falle, las demás acciones seguirán ejecutándose.

  Cuando esta propiedad no esté activada y la acción falle, el comportamiento resultante depende de los siguientes factores: Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la página Acciones o Agrupar jerárquica de la acción seleccionada, no se ejecutarán más acciones dentro del grupo. Si ha indicado En paralelo en la propiedad Ejecutar acciones de la página Acciones o Agrupar jerárquica de la acción seleccionada, las acciones del mismo grupo no se verán afectadas; los errores se ignoran y el resto de acciones del grupo se ejecutan con normalidad. Si la acción seleccionada está dentro de una acción Agrupar, no afectará a ninguna otra acción externa a dicha acción Agrupar.

• Reintentar si falla: Al activarla, especifica que en caso de que la acción falle, Integration Service intentará ejecutarlo de nuevo.

• Máximo reintentos: Especifica la cantidad máxima de veces que Integration Service volverá a intentar ejecutar la acción. Disponible al activar Reintentar si falla.

• Reintentar intervalo: Especifica el tiempo que Integration Service esperará después de que la acción haya fallado y antes de volver a ejecutarla. Disponible al activar Reintentar si falla.