El widget de carga de ficheros permite a los usuarios cargar uno o varios ficheros en un almacén ThingWorx. El widget se puede configurar para cargar ficheros de una de las siguientes maneras:

Además, se pueden configurar reglas de validación para aplicar restricciones en el tipo de fichero, el tamaño, la cantidad y más.

Arrastrar y soltar

Al arrastrar o seleccionar un fichero en este modo, los ficheros se cargan o enumeran inmediatamente, en función del valor de la propiedad DisableInstantUpload. Opcionalmente, se puede desactivar la propiedad AllowInstantUpload y cargar ficheros manualmente mediante un botón o el servicio Upload del widget. Además, se muestra un botón Reemplazar que permite reemplazar un fichero cargado en el almacén.

Solo botón Inspeccionar

Por defecto, los ficheros seleccionados se cargan automáticamente en el almacén. Se muestra una barra de progreso para indicar el progreso de carga de cada fichero.

Para permitir a los usuarios revisar los ficheros seleccionados antes de cargarlos, defina las propiedades del widget DisbaleInstantUpload y ShowUploadButton en verdadero. En tiempo de ejecución, los usuarios pueden iniciar la carga pulsando el botón Cargar. Opcionalmente, se puede enlazar un evento de mashup, función o widget al servicio Upload del widget para iniciar la carga basada en una condición específica.

Se puede añadir un botón Borrar para permitir a los usuarios detener la carga y quitar los ficheros seleccionados de la lista. Los ficheros cargados solo se quitan de la lista y no se borran del almacén de ThingWorx. Para borrar ficheros del almacén, utilice un servicio de datos personalizado.

Por defecto, los usuarios pueden utilizar los controles disponibles para seleccionar un almacén y una carpeta en los que cargar los ficheros. Para impedir que los usuarios elijan un almacén o una ruta de carpeta, defina las propiedades ShowRepositoryPath y ShowRepositorySelector en falso. Se puede especificar el nombre y la carpeta del almacén por defecto con las propiedades RepositoryName y Path del widget. Para obtener más información sobre los almacenes de la plataforma, consulte Gestión de almacenes de ficheros.

Por defecto, los usuarios pueden cargar ficheros de cualquier tamaño en tiempo de ejecución. Es posible limitar el tamaño máximo de fichero que está disponible para la carga mediante la propiedad MaxFileSize del widget del panel Validación. Para personalizar los mensajes de fallo cuando un fichero es mayor que el máximo permitido, configure las propiedades MaxFileSizeFailureMessage y MaxFileSizeFailureTitle.

La propiedad de validación MaxUploadSize se puede utilizar para restringir el tamaño de la carga total. Se muestra un mensaje de error cuando el tamaño total de carga supera el límite. Para personalizar el mensaje de error, utilice las propiedades MaxUploadSizeFailureMessage y MaxUploadSizeFailureTitle.

Se puede limitar el número máximo de ficheros que los usuarios pueden cargar mediante la propiedad MaxFileSize del widget del panel Validación. Cuando el número seleccionado de ficheros es superior al máximo, se muestra un mensaje de fallo. Para personalizar el mensaje de error, utilice la propiedad MaxNumberOfFilesFailureMessage.

El widget se puede configurar para que acepte formatos de fichero específicos mediante la propiedad AllowedFileTypes. Se pueden añadir varios tipos de fichero, separados por comas. Por ejemplo, escriba .pdf, .png para permitir solo ficheros PDF y PNG. Utilice las propiedades AllowedFileTypesMessage y AllowedFileTypesTitle para personalizar el mensaje de error que se muestra cuando se añade un tipo de fichero no soportado.

Se pueden arrastrar ficheros al área de la zona de descarga o pulsar en el rótulo para abrir un cuadro de diálogo de selección de ficheros. El color de la zona cambia automáticamente para indicar que se pueden soltar ficheros.

Se pueden utilizar las siguientes propiedades para configurar la zona de descarga:

En la siguiente tabla se enumeran las propiedades que están disponibles en el panel Propiedades.

A diferencia de otros widgets que soportan la validación, la carga de ficheros no soporta los mensajes de validación y criterios. Se puede definir un mensaje de criterios y activar ShowFailureMessage y mostrar un mensaje de error cuando ValidationState es Invalid.

Para obtener más información sobre el uso de las propiedades de validación comunes, consulte Widget de campo de texto (con temas).

En la siguiente tabla se enumeran las propiedades de validación que están disponibles en el panel Validación de ThingWorx 9.3.4 o versiones posteriores.