File upload#

El bloque "File upload" carga un archivo al Almacenamiento y pasa su GUID a un parámetro de la tarea. El GUID es un identificador que permite utilizar el archivo posteriormente en el proceso. Se requieren una acción, una cola asociada con tareas y una carpeta de almacenamiento. El administrador debe conceder al usuario acceso a la acción, a la carpeta seleccionada y a la carga de archivos.

Configuración de la carga de archivos#

En el Diseñador de formularios, haga clic en "Agregar" y seleccione "File upload". La configuración del bloque determina la carpeta de destino, el nombre y las restricciones del archivo.

Campos obligatorios:

• Campo "Nombre del parámetro en la tarea (Task)" — especifica el parámetro que recibe el GUID del archivo cargado. Introduzca el nombre utilizado por el proceso que trata la tarea.
• Campo "Carpeta de almacenamiento" — determina el destino de la carga. Seleccione una carpeta disponible de la lista.
• Campo "Tamaño máximo del archivo, MB" — limita el tamaño de cada archivo. El mínimo es 0.01 y un bloque nuevo utiliza 10.

Parámetros adicionales:

• Casilla "Obligatorio" — al activarla, impide enviar el formulario sin el GUID de un archivo. Al desactivarla, permite un valor vacío. Está desactivada en un bloque nuevo.
• Campo "Título visible" — establece la etiqueta del bloque en el formulario. Un bloque nuevo utiliza File upload.
• Campo "Clase" — establece una clase CSS para el aspecto del bloque. No es necesario cambiarla si no se requiere un estilo específico.
• Campo "Ayuda" — establece un texto explicativo debajo del bloque. Está vacío en un bloque nuevo.
• Campo "Prefijo del nombre del archivo" — agrega texto antes del nombre original. Un valor vacío conserva el inicio del nombre.
• Campo "Sufijo del nombre del archivo" — agrega texto después del nombre y antes de la extensión. Un valor vacío conserva el final del nombre.
• Campo "Tipos de archivo permitidos" — acepta extensiones o tipos MIME separados por comas, como .txt, application/pdf, image/*. Un valor vacío no restringe el tipo de archivo en el bloque. Las comprobaciones del servidor siguen aplicándose.

Tras completar la configuración, haga clic en "OK" y luego en "Guardar" en el Diseñador de formularios.

Ejemplo: para recibir un informe de texto, active "Obligatorio". Introduzca Attachment en "Título visible", attachment_guid en "Nombre del parámetro en la tarea (Task)", seleccione la carpeta Вложения, introduzca in- en "Prefijo del nombre del archivo", -checked en "Sufijo del nombre del archivo", .txt en "Tipos de archivo permitidos" y 1 en "Tamaño máximo del archivo, MB". Deje vacíos "Clase" y "Ayuda". El archivo report.txt se cargará como in-report-checked.txt.

Carga y sustitución de un archivo#

Al ejecutar la acción, haga clic en "Elegir archivo" y seleccione un archivo de la computadora. Durante la carga, el bloque muestra el porcentaje completado e impide una nueva selección. Una carga correcta muestra un estado verde con el GUID. Para escribir el GUID en el parámetro de la tarea, haga clic en el botón de la acción configurado para guardar los cambios en la tarea actual.

Los archivos de un tipo no permitido o de tamaño excesivo no se envían al servidor. Un error del servidor produce un estado rojo y un mensaje. Compruebe el archivo, las restricciones y el acceso a la carpeta, y repita la selección.

Una nueva selección borra el GUID anterior del formulario. Si falla la carga del reemplazo, un bloque obligatorio impide guardar el formulario. Los archivos cargados anteriormente permanecen en el Almacenamiento. Vaciar el formulario restablece el estado del bloque, y cambiar a otra tarea cancela la carga actual en la interfaz.

Actualizar el formulario de la tarea actual restaura sus parámetros guardados y restablece el estado de la carga. Si se ha cargado un archivo nuevo pero la tarea todavía no se ha guardado, su GUID no sustituye el valor guardado después de actualizar el formulario.

Si un conflicto al guardar se resuelve aceptando el valor actual del parámetro con un GUID diferente, el bloque borra el estado y el nombre del archivo cargado anteriormente. Al guardar de nuevo, se utiliza el valor aceptado.

Ejemplo: después de cargar correctamente report.txt, seleccione archive.zip. Con la restricción .txt, el bloque muestra un error de tipo de archivo. Seleccione un archivo de texto adecuado y espere al estado verde antes de guardar la tarea.