Enumerar contenido del directorio
Este tutorial muestra cómo configurar un trabajo que enumere el contenido de un directorio y guarde la lista de contenido del directorio como archivo TXT. A grandes rasgos:
1.Crearemos un nuevo trabajo en el contenedor /public/Examples.
2.Después, agregaremos un paso de ejecución que ejecutará el comando de shell dir. Este comando enumera el contenido del directorio especificado.
3.En el siguiente paso, agregaremos otro paso de ejecución que utilizará el resultado del primer paso y guardará este resultado como archivo TXT, que se llamará FileList.txt.
4.También configuraremos un desencadenador del sistema de archivos que sondeará el directorio en busca de cambios cada 60 segundos y desencadenará el trabajo siempre que se añada un nuevo archivo al directorio especificado.
5.También seleccionaremos una credencial de contraseña existente, con la que se ejecutará el trabajo.
6.Después de que hayamos guardado la configuración del trabajo, cualquier archivo existente en el directorio especificado se considerará como recién creado, y el trabajo se ejecutará. Como resultado, se creará el archivo FileList.txt, que contendrá la lista de contenido del directorio.
Implementación
Este apartado ofrece instrucciones paso a paso para crear el trabajo que acabamos de describir. La implementación de esta situación también se muestra en el archivo GIF al final de este tema.
Paso 1: Crear un trabajo
Para crear un trabajo siga estos pasos:
1.Inicie sesión en FlowForce Server.
2.Navegue hasta un contenedor en el que tenga permiso para crear trabajos nuevos. Para las pruebas, utilizaremos el contenedor /public/Examples. Si este contenedor aún no existe, créelo utilizando el comando Crear | Crear contenedor.
3.En el contenedor /public/Examples, cree un trabajo nuevo haciendo clic en Crear | Crear trabajo.
4.Introduzca un nombre para el trabajo (por ejemplo, SampleJob) y, si quiere, una descripción del trabajo.
En nuestro ejemplo, el trabajo se llama ListFiles y contiene la siguiente descripción: «Enumera el contenido del directorio y guarda la lista como archivo TXT».
Paso 2: Agregar un paso de ejecución que enumere el contenido del directorio
Para agregar un paso de ejecución que enumere el contenido de un directorio, siga estos pasos:
1.Haga clic en Nuevo paso de ejecución en la sección Pasos de ejecución.
2.Escriba el nombre de la función integrada /system/shell/commandline en el campo Ejecutar función. Esta función del sistema puede ejecutar comandos shell y archivos por lotes.
3.En el campo Parámetros | Comando, escriba dir. Este comando se utiliza en varios sistemas operativos para enumerar el contenido de un directorio.
4.El siguiente paso es especificar el directorio de trabajo, cuyo contenido se va a enumerar. Haga clic en el icono + situado junto al parámetro Directorio de trabajo. Aparecerá un campo de texto. En nuestro ejemplo, el directorio de trabajo es C:\Test\FlowForceServer\ExampleFiles.
5.Para poder utilizar el resultado producido por este paso de ejecución, necesitamos asignar el resultado del paso a un valor de tipo result. En nuestro ejemplo, el nombre del valor es list. Puede seleccionar el nombre que quiera para el resultado del paso. Para más detalles sobre los resultados de los pasos, consulte Resultado de los pasos.
Paso 3: Agregar un paso de ejecución que guarde la lista de contenido del directorio en un archivo
Para agregar un paso de ejecución que guarde la lista de contenido del directorio en un archivo, siga estos pasos:
1.Agregue otro paso de ejecución en la sección Pasos de ejecución.
2.Escriba el nombre de la función integrada /system/create-file en el campo Ejecutar función.
3.Escriba el nombre del archivo de destino en el que se guardará la lista de contenido del directorio. En nuestro ejemplo, proporcionaremos la ruta completa al archivo de destino: C:\Test\FlowForceServer\ExampleFiles\FileList.txt.
4.El siguiente paso consiste en suministrar el resultado del primer paso de ejecución en el campo Secuencia de origen. Dado que el resultado del primer paso es de tipo result y que el campo Secuencia de origen espera una secuencia de datos, existe un desajuste entre los tipos de datos. Por tanto, para poder utilizar el resultado del primer paso en el segundo, los tipos de datos deben coincidir. De este modo, utilizaremos la función de expresión stdout que toma result como parámetro y produce una secuencia. En el campo Secuencia de origen, escriba esto: stdout(list), siendo list el nombre del resultado del paso que declaramos en el paso 2.4 anterior.
5.Habilite el parámetro Sobrescribir destino para permitir que FlowForce Server pueda sobrescribir los archivos que ya existen en la carpeta de destino.
Paso 4: Configurar un desencadenador del sistema de archivos que iniciará el trabajo
Para cualquier trabajo que configure, necesita especificar una condición o condiciones que iniciarán el trabajo. En este tutorial, estableceremos un desencadenador del sistema de archivos que sondeará el directorio (especificado en el paso 1) cada 60 segundos. Si se detectan nuevos archivos, el desencadenador iniciará el trabajo y escribirá la lista de contenido del directorio en el archivo de destino que especificamos en el paso 3.3. Para configurar un desencadenador del sistema de archivos, siga estos pasos:
1.Navegue hasta la sección Desencadenadores y haga clic en Desencadenador de archivos nuevo. Aparece el bloque del desencadenador con varios parámetros.
2.Seleccione Recién creados en la lista desplegable del parámetro Comprobar.
3.Proporcione la ruta al directorio que debe comprobarse: C:\Test\FlowForceServer\ExampleFiles.
Paso 5: Seleccionar una credencial
Cuando cree un trabajo en FlowForce Server, tiene que suministrar las credenciales de la cuenta de usuario con la que debe ejecutarse el trabajo.
En la sección Credenciales, seleccionaremos una credencial de contraseña que hemos creado antes de comenzar este tutorial. Se trata de un objeto de credencial independiente que puede utilizar en cualquier trabajo. Las credenciales independientes son prácticas porque se pueden cambiar en un solo lugar y este cambio afectará a todos los trabajos que utilicen esa referencia de credencial.
La otra opción es especificar una credencial local, introduciendo su nombre de usuario y contraseña.
Para más información sobre los tipos de credenciales y aprender a crearlas, consulte Credenciales.
Paso 6: Guardar y ejecutar el trabajo
Para guardar la configuración del trabajo, haga clic en Guardar en la parte inferior de la página de configuración. Para ejecutar el trabajo por primera vez, no necesita realizar ninguna acción. Cuando agregue un nuevo desencadenador y guarde la configuración del trabajo, todos los archivos existentes en el directorio especificado se entenderá como recién creados y se ejecutará el trabajo.
Para desencadenar de nuevo la ejecución del trabajo, debe cumplir las condiciones del desencadenador. Esto significa que debe añadir al menos un archivo a C:\Test\FlowForceServer\ExampleFiles o cambiar el nombre de un archivo existente en este directorio.
Resultado del trabajo
Tras la correcta ejecución del trabajo, el archivo FileList.txt muestra el contenido del directorio. A continuación puede ver un extracto de este archivo de texto:
Directorio de C:\Test\FlowForceServer\ExampleFiles
05/24/2024 02:18 PM <DIR> .
05/24/2024 02:18 PM <DIR> ..
05/23/2023 12:01 PM 25,126 Authors.xml
05/05/2023 05:17 PM 2,280 Authors.xsd
05/22/2024 11:05 AM 515 BookListBiography.json
05/22/2024 11:05 AM 1,560 BookListChildren.json
05/22/2024 11:06 AM 2,433 BookListClassics.json
05/22/2024 11:07 AM 2,447 BookListCrimeMystery.json
05/22/2024 11:08 AM 5,036 BookListFantasy.json
05/22/2024 11:08 AM 1,121 BookListHorror.json
05/22/2024 11:08 AM 477 BookListHumor.json
05/22/2024 11:09 AM 963 BookListSciFi.json
01/19/2024 07:22 PM 3,197 BookOrder.xml
12/06/2023 06:44 PM 1,663 BookOrder.xsd
09/11/2023 11:22 AM 17,905 Books.json
05/22/2024 11:02 AM 993 Books.schema.json
05/24/2024 02:18 PM 1,224 FileList.txt
05/24/2024 01:47 PM 368 Notes.txt
16 File(s) 67,308 bytes
2 Dir(s) 725,686,542,336 bytes free
GIF de demostración
Para ver una demostración rápida de los pasos descritos en este tutorial, haga clic en el archivo GIF que aparece a continuación. Tenga en cuenta que el GIF solo ilustra los pasos 2-4 y 6. Para ver una ilustración de los pasos 1 y 5, consulte el tutorial Hello World.
