Controllo Allegati in Power Apps

Controllo che gli utenti possono usare per scaricare i file nel dispositivo e caricare ed eliminare file da un elenco creato tramite Microsoft Lists o una tabella Microsoft Dataverse.

Description

Usando un controllo Allegati , è possibile aprire, aggiungere ed eliminare file da un elenco o da una tabella Dataverse.

Limitazioni

Il controllo allegato presenta queste limitazioni:

1. Il controllo allegati supporta solo elenchi e tabelle dataverse come origini dati. Non supporta espressioni che trasformano queste origini dati in tabelle, ad esempio con la funzione ForAll .

2. La funzionalità di caricamento ed eliminazione funziona solo all'interno di un modulo. Il controllo allegato viene disabilitato quando si usa la modalità Modifica e non all'interno di un modulo. Per salvare aggiunte ed eliminazioni dei file, l'utente dell'app deve salvare il modulo. A causa di questa limitazione, il controllo allegato non è disponibile nella scheda Inserisci , ma viene visualizzato nel modulo quando il campo modulo allegato è abilitato in un modulo di SharePoint o Dataverse.

3. Il controllo allegati in un Web browser consente di selezionare più file e usare la funzionalità di trascinamento della selezione. Tuttavia, quando si usa il controllo allegati in Power Apps Mobile, è possibile aggiungere solo file uno alla volta.

4. Potrebbe non essere possibile allegare file archiviati in OneDrive o in altre risorse di archiviazione cloud. Provare a scaricare questi file nel dispositivo prima di collegarli usando la selezione file del dispositivo.

5. L'app Power Apps per dispositivi mobili non supporta l'acquisizione di video direttamente dalla fotocamera o la selezione di video dalla raccolta foto quando si usa il controllo Allegati . Per aggiungere un video, gli utenti devono usare l'opzione Sfoglia .

   • In Android: l'opzione Sfoglia visualizza tutti i tipi di file, inclusi i video, in modo da poter selezionare e allegare i file video.
   • In iOS: l'opzione Sfoglia mostra solo i file archiviati nell'app File . Se il video non è già stato salvato, è necessario spostarlo nell'app File prima di allegarlo.

   Se un video non viene visualizzato come opzione per allegare, salvare prima il video nell'app File del dispositivo e quindi riprovare.

6. Il caricamento e la visualizzazione degli allegati non è supportato quando si eseguono app canvas in Microsoft Teams in dispositivi mobili Android o iOS.

Proprietà chiave

Items : colonna Attachment dell'elenco o della tabella Dataverse. Le raccolte e le tabelle non sono supportate.

MaxAttachments : numero massimo di file accettati dal controllo.

MaxAttachmentSize : dimensione massima consentita del file in MB per ogni nuovo allegato. 1 MB qui è 1.000.000 byte (10⁶ B) o 1.000 KB.

OnAddFile : azioni da eseguire quando l'utente aggiunge un nuovo allegato di file.

OnRemoveFile : azioni da eseguire quando l'utente elimina un allegato esistente.

OnUndoRemoveFile : azioni da eseguire quando l'utente ripristina un allegato eliminato.

Proprietà aggiuntive

AccessibleLabel: etichetta per le utilità per la lettura dello schermo. Deve descrivere lo scopo degli allegati.

AddAttachmentText : testo dell'etichetta per il collegamento usato per aggiungere un nuovo allegato.

BorderColor : colore del bordo di un controllo.

BorderStyle : indica se il bordo di un controllo è Solido, Tratteggiato, Tratteggiato o Nessuno.

BorderThickness : spessore del bordo di un controllo.

Color : colore del testo di un controllo.

DisabledBorderColor : colore del bordo di un controllo se la proprietà DisplayMode del controllo è impostata su Disabled.

DisabledColor : colore del testo in un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

DisabledFill : colore di sfondo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

DisplayMode : indica se il controllo consente l'aggiunta e l'eliminazione di file (Modifica), visualizza solo i dati (visualizzazione) o è disabilitato (disabilitato).

[DropTargetBackgroundColor] - Colore dello sfondo della destinazione di rilascio del controllo.

[DropTargetBorderColor] - Colore del bordo di destinazione del controllo.

[DropTargetBorderStyle] - Indica se il bordo di destinazione del controllo è Solid, Dashed, Dotted o None.

[DropTargetBorderThickness] - Spessore del bordo di destinazione del controllo.

[DropTargetTextColor] - Colore del testo di destinazione del controllo.

Riempimento : colore di sfondo di un controllo.

FocusedBorderColor : colore del bordo di un controllo quando il controllo è attivo.

FocusedBorderThickness : spessore del bordo di un controllo quando il controllo è attivo.

Altezza : distanza tra i bordi superiore e inferiore di un controllo.

Font : nome della famiglia di tipi di carattere in cui viene visualizzato il testo.

FontWeight : spessore del testo in un controllo: Grassetto, Semibold, Normale o Più chiaro.

HoverBorderColor : colore del bordo di un controllo quando l'utente mantiene il puntatore del mouse su tale controllo.

HoverColor : colore del testo in un controllo quando l'utente mantiene il puntatore del mouse su di esso.

HoverFill : colore di sfondo di un controllo quando l'utente mantiene il puntatore del mouse su di esso.

Corsivo : indica se il testo in un controllo è in corsivo.

MaxAttachmentsText : testo che sostituisce il collegamento "Allega file" quando il controllo contiene il numero massimo di file consentiti.

NoAttachmentsText : testo informativo visualizzato all'utente quando non sono presenti file allegati.

Riempimento : distanza tra il testo in un pulsante di importazione o esportazione e i bordi del pulsante.

PressedBorderColor : colore del bordo di un controllo quando l'utente seleziona tale controllo.

PressedColor : colore del testo in un controllo quando l'utente seleziona tale controllo.

PressedFill : colore di sfondo di un controllo quando l'utente seleziona tale controllo.

Reimposta : ripristina tutte le modifiche apportate al controllo allegati e torna allo stato salvato in precedenza.

Dimensioni : dimensioni del carattere del testo visualizzato in un controllo.

Barrato : indica se una riga viene visualizzata attraverso il testo visualizzato in un controllo .

TabIndex: ordine di spostamento tramite tastiera in relazione ad altri controlli.

Descrizione comando : testo esplicativo visualizzato quando l'utente passa il mouse su un controllo.

Sottolineatura : indica se una riga viene visualizzata sotto il testo visualizzato in un controllo .

Visible: indica se un controllo è visibile o nascosto.

Width : distanza tra i bordi sinistro e destro di un controllo.

X : distanza tra il bordo sinistro di un controllo e il bordo sinistro del contenitore padre (o schermo, se non è presente alcun contenitore padre).

Y : distanza tra il bordo superiore di un controllo e il bordo superiore del contenitore padre (o schermo, se non è presente alcun contenitore padre).

Esempio

1. Aggiungere un modulo all'app e impostare un elenco come origine dati.

2. Selezionare il controllo Visualizza modulo nella visualizzazione albero a sinistra. È anche possibile usare Modifica modulo .

3. Selezionare Origine dati nella scheda Proprietà nel pannello delle opzioni a destra e quindi selezionare l'elenco a cui ci si è connessi.

4. Selezionare Modifica campi nella sezione Campi e selezionare Aggiungi campo.

5. Selezionare il campo Allegati e selezionare Aggiungi.

   Il campo Allegati associato all'elenco viene visualizzato nel modulo.

Informazioni su come aggiungere e configurare un controllo

Linee guida per l'accessibilità

Contrasto dei colori

Assicurarsi che sia presente un contrasto di colore adeguato tra:

• ItemColor e ItemFill
• ItemHoverColor e ItemHoverFill
• ItemPressedColor e ItemPressedFill
• AddedItemColor e AddedItemFill
• RemovedItemColor e RemovedItemFill
• ItemErrorColor e ItemErrorFill
• AddAttachmentColor e Fill
• MaxAttachmentsColor e Fill
• NoAttachmentsColor e Fill

Questo requisito è oltre ai requisiti standard di contrasto dei colori.

Supporto dell'utilità per la lettura dello schermo

Includere le proprietà seguenti:

• AccessibleLabel
• AddAttachmentsText
• MaxAttachmentsText
• NoAttachmentsText

Supporto della tastiera

• Usa TabIndex con un valore pari o superiore a zero in modo che gli utenti della tastiera possano spostarsi su di esso.
• Gli indicatori di messa a fuoco devono essere chiaramente visibili. Usare FocusedBorderColor e FocusedBorderThickness per ottenere questa chiarezza.