Cargador de archivos

General

• Tamaño máximo del archivo: el tamaño máximo del archivo que pueden cargar los usuarios. El tamaño máximo de archivo recomendado es de 10 MB.
• Tipos de archivos permitidos: los tipos de archivos que los usuarios pueden cargar. Utiliza "," para separar las extensiones de archivo. Por ejemplo, si se escribe .jpg, .png, .svg, solo se podrán cargar estos tipos de archivos. El símbolo . no es obligatorio al enumerar los tipos de archivo.
• Texto auxiliar: el texto de ayuda que se mostrará en el tiempo de ejecución.
• Información sobre las herramientas: el texto que se mostrará cuando un usuario de la aplicación pase el ratón por encima del control. Utilízalo para proporcionar información adicional sobre el control.
• Etiqueta: el texto de visualización del control.
• Obligatorio: si es verdadero, los usuarios de la aplicación deben proporcionar datos en el control. Para marcar el control como obligatorio en tiempo de ejecución, se añade un asterisco * después del texto de la etiqueta.
• Mensaje de error personalizado: texto que aparece si se establece la propiedad Requerida como verdadero y el control se deja vacío.
• Oculto: si es verdadero, oculta el control en tiempo de ejecución.
• Deshabilitado: si es verdadero, deshabilita el control en el tiempo de ejecución.

Nota: el cargador de archivos solo puede cargar un archivo a la vez.

Events

• Archivo agregado: configura lo que ocurre cuando se añade un archivo.
• Archivo eliminado: configura lo que sucede cuando se elimina un archivo.

Estilo

• Alineación de control: por defecto, hereda la alineación principal. Se puede establecer una alineación diferente a la principal. Para volver a la alineación principal, anula la selección de las opciones anuladas.

  Nota: la alineación depende del diseño seleccionado para el elemento principal (Vertical vs Horizontal).

• Colocación de la etiqueta: por defecto, la etiqueta está configurada para que se muestre en la parte superior del control, en el lado izquierdo. Puedes colocarlo a la izquierda del control, en la misma línea. La propiedad Ancho de la etiqueta configura el ancho de la etiqueta, y la propiedad Espacio entre establece la distancia entre la etiqueta y el control.

• Fuente: los atributos de fuente tanto para la etiqueta y el texto de entrada, como para la familia de fuentes, el tamaño, el color o el estilo (negrita, cursiva y subrayado). Por defecto, el control hereda la familia de fuentes del contenedor principal inmediato, que se indica con la palabra clave "heredada".

• Margen: el margen del control. De forma predeterminada, se establece un margen de 4px. Se combinan las propiedades de los márgenes superiores/inferiores e izquierdos/derechos. Estas propiedades se pueden separar utilizando el botón Enlace situado a la derecha de la sección Margen.
• Tamaño: el ancho y la altura del control. El tamaño está establecido como auto de forma predeterminada. Para establecer valores mínimos o máximos, haz clic en el icono de tres puntos (...).

Cómo utilizar el cargador de archivos

Este ejemplo muestra cómo puedes utilizar Cargador de archivos con un depósito de almacenamiento y con un campo de archivo de una entidad.

1. En tu aplicación, añade un depósito de almacenamiento y una entidad de Data Service que tenga campos de archivo.
2. Añade un Cargador de archivos y un control Botón.
3. Crea una variable de tipo AppsFile y nómbrala "SB_file_var'. Utiliza esta variable para almacenar el archivo descargado del depósito de almacenamiento.
4. Añade la regla Cargar archivo en depósito de almacenamiento al evento Al hacer clic del control del botón.
   1. En el campo Archivo a cargar, haz referencia al archivo cargado a través del control Cargador de archivos, como se indica a continuación:

      MainPage.FileUploader.Value

   2. En el campo Depósito de almacenamiento, haz referencia al depósito de almacenamiento de Orchestrator que añadiste previamente a tu aplicación.
   3. De forma opcional, en el campo Al completar, puedes añadir una regla Mostrar mensaje para informarte de la carga finalizada correctamente.
5. Añade la regla Descargar archivo del depósito de almacenamiento al evento Al hacer clic del control del botón.
   1. En el campo Depósito de almacenamiento, haz referencia al depósito de almacenamiento de Orchestrator que añadiste previamente a tu aplicación.
   2. En el campo Nombre del archivo (con extensión), escribe el nombre del archivo que deben descargar los usuarios.
   3. En la variable Asignar archivo a aplicación, haz referencia a la variable creada anteriormente "SB_file_var".
   4. De forma opcional, en el campo Al completar, puedes añadir una regla Mostrar mensaje para informarte de que la descarga se ha completado correctamente.
6. Añade un control Etiqueta a tu aplicación.
   1. En el campo Texto del control, haz referencia al nombre del archivo descargado, como se indica a continuación:

      SB_file_var.Name

      - donde "SB_file_var" es la variable utilizada para almacenar datos sobre el archivo descargado.

7. Ejecuta tu aplicación y carga un archivo utilizando el control Cargador de archivos. Haz clic en el botón.

Aparecerá un mensaje en la parte superior de la pantalla informándote de la carga/descarga que se ha completado correctamente. Ahora comprueba el depósito de almacenamiento en Orchestrator y deberías ver el archivo que cargaste utilizando el control Cargador de archivos.

Al mismo tiempo, haciendo clic en el botón se descarga el archivo indicado en la regla Descargar archivo del depósito de almacenamiento en tu dispositivo local y se almacenan sus datos en una variable. El control de Etiqueta muestra el nombre del archivo descargado.

Propiedades VB

Propiedad VB	Tipo de datos	Descripción
Información sobre herramientas	Cadena	Texto de información que aparece cuando el usuario pasa el ratón por encima del Cargador de archivos.
Etiqueta	Cadena	La etiqueta del cargador de archivos, normalmente el texto que se muestra antes del control.
Valor	AppsFile	Nombre del archivo cargado actualmente.
Obligatorio	Booleano	Especifica si la carga del archivo es obligatoria.
RequiredErrorMessage	Cadena	Mensaje que se muestra cuando se requiere la carga del archivo pero no se proporcionó.
Oculto	Booleano	Determina la visibilidad del control Cargador de archivos . Si se establece en verdadero, oculta el control en tiempo de ejecución.
Deshabilitada	Booleano	Determina si se puede interactuar con el control Cargador de archivos . Si se establece en verdadero, deshabilita la interacción con el cargador de archivos en tiempo de ejecución.
EsVálido	Booleano	Comprueba la validez del valor del cargador de archivos. Si es verdadero, indica que es válido.