Control Datos adjuntos en Power Apps
Un control que permite a los usuarios descargar archivos a su dispositivo, así como cargar y eliminar archivos de una lista creada con Listas de Microsoft, o una tabla de Microsoft Dataverse.
Descripción
Un control Datos adjuntos permite abrir, agregar y eliminar archivos de una lista o una tabla de Dataverse.
Limitaciones
El control Datos adjuntos presenta estas limitaciones:
El control Datos adjuntos solo admite listas y Dataverse tablas como origen de datos. No se admiten expresiones que transforman estas fuentes de datos en tablas, por ejemplo, con la función ForAll.
La carga y eliminación de una funcionalidad solo funcionan dentro de un formulario. El control Datos adjuntos está deshabilitado en modo de edición, pero no dentro de los formularios. Para guardar los archivos añadidos o eliminados, el usuario de la aplicación debe guardar el formulario. Debido a esta limitación, el control Attachment no está disponible desde la pestaña Insertar pero aparece en el formulario cuando el campo de formulario Datos adjuntos está habilitado en un formulario SharePoint o Dataverse.
El control Datos adjuntos en un navegador web le permite seleccionar varios archivos y permite el uso de la función de arrastrar y soltar. Sin embargo, al usar el control Datos adjuntos en Power Apps Mobile, solo puede agregar archivos de uno en uno.
Propiedades importantes
Artículos - La columna Attachment de la lista o Dataverse tabla. Colecciones y Tablas no son compatibles.
MaxAttachments: el número máximo de archivos que acepta el control.
MaxAttachmentSize: el tamaño de archivo máximo permitido, en MB, de cada elemento adjunto nuevo. 1 MB aquí es 1 000 000 bytes (106 B) o 1000 KB.
OnAddFile: acciones a realizar cuando el usuario agrega nuevos datos adjuntos.
OnRemoveFile: acciones a realizar cuando el usuario elimina datos adjuntos existentes.
OnUndoRemoveFile: acciones a realizar cuando el usuario restaura un archivo adjunto eliminado.
Propiedades adicionales
AccessibleLabel: etiqueta para lectores de pantalla. Debe describir el fin de los datos adjuntos.
AddAttachmentText: el texto de la etiqueta del vínculo que se usa para agregar nuevos datos adjuntos.
BorderColor: el color del borde de un control.
BorderStyle: si el borde del control es Solid, Dashed, Dotted o None.
BorderThickness: el grosor del borde de un control.
Color: el color del texto de un control.
DisabledBorderColor: el color del borde de un control si la propiedad DisplayMode del control está establecida en Deshabilitado.
DisabledColor: el color del texto en un control si su propiedad DisplayMode está establecida en Deshabilitado.
DisabledFill: el color de fondo de un control si su propiedad DisplayMode está establecida en Deshabilitado.
DisplayMode: indica si el control permite agregar y eliminar archivos (Editar), solo muestra datos (Ver) o si está deshabilitado (Deshabilitado).
[DropTargetBackgroundColor]: el color del fondo del destino de colocación del control.
[DropTargetBorderColor]: el color del borde del destino de colocación del control.
[DropTargetBorderStyle]: si el borde de destino del control es Sólido, Guiones, Puntos o Ninguno.
[DropTargetBorderThickness]: el grosor del borde del destino de colocación del control.
[DropTargetTextColor]: el color del texto del destino de colocación del control.
Fill: el color de fondo de un control.
FocusedBorderColor: el color del borde de un control cuando el control recibe el foco.
FocusedBorderThickness: el grosor del borde de un control cuando el control recibe el foco.
Height: la distancia entre los bordes superior e inferior de un control.
Font: el nombre de la familia de fuentes en la que aparece el texto.
FontWeight: el peso del texto en un control: Bold, Semibold, Normal o Lighter.
HoverBorderColor: el color del borde de un control cuando el usuario mantiene el puntero del ratón sobre ese control.
HoverColor: el color del texto de un control cuando el usuario mantiene el puntero del ratón sobre él.
HoverFill: el color de fondo de un control cuando el usuario mantiene el puntero del ratón sobre él.
Italic: indica si el texto de un control está en cursiva.
MaxAttachmentsText: el texto que reemplaza al vínculo de "Adjuntar archivo" cuando el control contiene el número máximo de archivos permitidos.
NoAttachmentsText: texto informativo que se muestra al usuario cuando no hay archivos adjuntos.
Padding: la distancia entre el texto de un botón Exportar o Importar y los bordes de ese botón.
PressedBorderColor: el color del borde de un control cuando el usuario selecciona ese control.
PressedColor: el color de texto de un control cuando el usuario selecciona ese control.
PressedFill: el color de fondo de un control cuando el usuario selecciona ese control.
Reset - Revierte todos los cambios en el control Datos adjuntos volviendo al estado guardado anteriormente.
Size: tamaño de la fuente del texto que aparece en un control.
Strikethrough: indica si aparece una línea sobre el texto de un control.
TabIndex: orden de navegación del teclado en relación con otros controles.
Tooltip: texto explicativo que aparece cuando el usuario mantiene el mouse sobre un control.
Underline: indica si aparece una línea debajo del texto de un control.
Visible: indica si un control está visible u oculto.
Width: la distancia entre los bordes derecho e izquierdo de un control.
X: la distancia entre el borde izquierdo de un control y el borde izquierdo de su contenedor primario (o la pantalla si no hay un contenedor primario).
Y: la distancia entre el borde superior de un control y el borde superior de su contenedor primario (o la pantalla si no hay un contenedor primario).
Ejemplo
Agregue un formulario a la aplicación y establezca una lista como su origen de datos.
Seleccione el control Mostrar formulario en la vista de árbol del lado izquierdo. También puede usar Editar formulario en su lugar.
Seleccione Data Source en la pestaña Propiedades en el panel de opciones a la derecha y luego seleccione la lista a la que se ha conectado.
Seleccione Editar campos en la sección Campos y seleccione Agregar campo.
Seleccione el campo Datos adjuntos y seleccione Agregar.
El campo de datos adjuntos asociado a la lista aparecerá en el formulario.
Aprender a agregar y configurar un control
Instrucciones para accesibilidad
Contraste de color
Debe haber un contraste de color adecuado entre:
- ItemColor y ItemFill
- ItemHoverColor y ItemHoverFill
- ItemPressedColor y ItemPressedFill
- AddedItemColor y AddedItemFill
- RemovedItemColor y RemovedItemFill
- ItemErrorColor y ItemErrorFill
- AddAttachmentColor y Fill
- MaxAttachmentsColor y Fill
- NoAttachmentsColor y Fill
Este requisito es adicional a los requisitos estándar de contraste de color.
Compatibilidad con el lector de pantalla
Las siguientes propiedades deben estar presentes:
- AccessibleLabel
- AddAttachmentsText
- MaxAttachmentsText
- NoAttachmentsText
Compatibilidad con el teclado
- TabIndex debe ser cero o superior para que los usuarios del teclado puedan desplazarse hasta él.
- Los indicadores de foco deben ser claramente visibles. Use FocusedBorderColor y FocusedBorderThickness para conseguir esta claridad.
Nota
¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)
La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).