Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
In questo articolo viene illustrato che cos'è una scheda dati, come modificare i dati immessi dagli utenti del controllo, quando sbloccare una scheda e come il modulo salva le modifiche in Dataverse.
Le schede dati sono i blocchi predefiniti dei moduli di Power Apps. Ogni scheda dati visualizza e raccoglie un valore per un singolo campo, ad esempio Nome, Titolo processo o Numero di telefono.
Lo screenshot seguente mostra un modulo con una scheda dati per Il nome account selezionato.
Una maschera Di visualizzazione mostra un record. Modificare i moduli consente agli utenti di aggiornare un record esistente o crearne uno nuovo. In entrambi i tipi di modulo, ogni scheda dati è connessa esattamente a un campo (una colonna) nell'origine dati, spesso una tabella Dataverse.
Una scheda dati è un contenitore che include l'etichetta del campo, il comportamento di convalida richiesto e il controllo con cui gli utenti interagiscono. Una scheda dati contiene quanto segue:
- Indicatore obbligatorio (asterisco o stella): indica che il campo deve avere un valore.
- Titolo: etichetta visualizzata agli utenti per il campo.
- Valore scheda dati: controllo di input (ad esempio, una casella di testo o un elenco a discesa) in cui gli utenti immettono o modificano il valore
- Messaggio di errore: visualizza gli errori di convalida, in genere dopo l'invio del modulo.
Prerequisiti
Se non si ha familiarità con i moduli, iniziare leggendo add-form.md e working-with-forms.md.
Personalizzare una scheda
Una scheda dati contiene i controlli visualizzati dagli utenti, in genere un'etichetta come il titolo, un controllo di input come input di testo o elenco a discesa e un'etichetta del messaggio di errore. Per personalizzare l'aspetto di un campo, selezionare il controllo all'interno della scheda, ad esempio l'input di testo e regolarne le dimensioni, la posizione o le proprietà.
Riordinare i campi in un modulo
Power Apps offre schede predefinite per stringhe, numeri e altri tipi di dati. È possibile modificare il modulo e ridisporre i campi consentendo di modificare il layout senza sbloccare le schede.
Aprire l'app per la modifica in Power Apps Studio.
Selezionare il modulo, poi selezionare Campi.
Selezionare Altre azioni e quindi selezionare Sposta su o Sposta giù. È anche possibile selezionare e trascinare i campi nell'ordine desiderato.
Modificare il tipo di controllo di una scheda
È possibile modificare facilmente il tipo di controllo di una scheda. Per exmaple è possibile modificare una scheda di testo a riga singola in una scheda di testo su più righe in modo che gli utenti abbiano più spazio per immettere le informazioni.
Aprire l'app per la modifica in Power Apps Studio.
Selezionare il modulo, poi selezionare Campi.
Selezionare Espandi dettagli campo , ovvero la freccia giù accanto al campo che si desidera modificare.
Selezionare l'elenco a discesa Tipo di controllo e quindi selezionare un tipo di controllo diverso. Ad esempio, passare da Modifica testo a Modifica testo su Modifica testo a più righe.
Ridimensionare una scheda
È possibile spostare e ridimensionare i controlli in una scheda bloccata.
È possibile modificare i controlli all'interno di una scheda senza modificare il campo a cui si connette la scheda.
Nel modulo selezionare la scheda dati da ridimensionare, ad esempio Nome account.
Trascinare per spostare il testo all'interno della scheda e usare le maniglie per ridimensionarlo. Ciò migliora la spaziatura e la leggibilità senza sbloccare la scheda.
Sbloccare una scheda
Per apportare modifiche come l'eliminazione di un controllo o l'aggiunta di un nuovo controllo, è necessario sbloccare la scheda.
Quando si aggiunge un campo a un modulo, Power Apps crea automaticamente una scheda dati e imposta le formule di base che connettono la scheda all'origine dati. Per impostazione predefinita, Power Apps blocca queste schede in modo da non interrompere accidentalmente tale connessione. Se è necessario un maggiore controllo, ad esempio un layout personalizzato, controlli aggiuntivi o formule diverse, è possibile sbloccare la scheda.
Lo screenshot seguente mostra un modulo con una scheda dati bloccata.
L'impostazione della chiave è DataField. Indica a Power Apps di quale campo (colonna) questa scheda è responsabile. Quando il modulo viene inviato, Power Apps utilizza il valore DataField della scheda per sapere quale campo aggiornare.
Per sbloccare una scheda, selezionare la scheda
Nel riquadro Proprietà selezionare Avanzate.
Selezionare l'icona di blocco o selezionare Sblocca per modificare le proprietà per sbloccare le proprietà, ad esempio DataField, DisplayName o Required.
Dopo aver sbloccato la scheda, modificare le formule generate e aggiungere o rimuovere controlli all'interno della scheda.
Proprietà bloccate Proprietà sbloccate
Ora si assume il controllo su questa scheda e può modificarla ulteriormente in base alle proprie esigenze. Ma si perde la possibilità di modificare la scheda da una rappresentazione a un'altra (ad esempio, testo a riga singola a testo su più righe) come in precedenza. Hai trasformato la scheda predefinita in una "scheda personalizzata" che ora controlli.
Important
Non è possibile ribloccare una scheda dopo averlo sbloccato. Per ripristinare uno stato bloccato della scheda, devi rimuoverla e reinserirla nel riquadro destro.
Interagire con un modulo
Dopo aver sbloccato una scheda, è possibile controllare il modo in cui i valori si spostano tra il modulo e i controlli all'interno della scheda.
Un modo utile per considerare un modulo di modifica è: i dati fluiscono dentro per visualizzare il record corrente (impostazioni predefinite) e i dati fluiscono fuori quando si inviano gli aggiornamenti del modulo. La scheda si trova al centro: le relative proprietà indicano al modulo quale campo rappresenta e quale valore deve essere salvato.
Proprietà DataField
La proprietà DataField della scheda è l'impostazione "questa scheda modifica questo campo". Consente di Power Apps decidere cosa convalidare, quale valore è necessario e quale campo deve essere aggiornato quando si invia il modulo.
Flusso di informazioni in entrata
Quando una maschera mostra un record, presenta tale record come ThisItem. Considera ThisItem come la riga corrente che stai modificando. Contiene ogni campo per tale record.
Nei moduli supportati da Dataverse, il campo dati della scheda corrisponde in genere al nome logico del campo. La formula Predefinita della scheda fa in genere riferimento al record corrente, ad esempio ThisItem.FieldName e il controllo di input all'interno della scheda legge in genere tale valore tramite Parent.Default. Questo modello mantiene il controllo di input indipendente dall'origine dati e consente alla scheda di incapsulare il modo in cui il valore del campo viene trasferito.
La maggior parte delle schede imposta la proprietà Default sul valore del record corrente, ad esempio ThisItem.FieldName. Facoltativamente, è possibile trasformare tale valore, ad esempio formattare il testo prima che venga visualizzato nell'input.
All'interno della scheda, il controllo di input usa in genere Parent.Default in modo che mostri sempre qualsiasi valore fornito dalla scheda. Questo approccio mantiene la scheda "autosufficiente". Se in seguito si modifica la formula predefinita della scheda, non è necessario riscrivere le formule all'interno della scheda.
Per impostazione predefinita, i metadati dell'origine dati impostano le proprietà DefaultValue e controls/control-card.md in base alla proprietà controls/control-card.md . È possibile eseguire l'override di queste formule con la propria logica usando la funzione functions/function-datasourceinfo.md per integrare i metadati dell'origine dati.
Flusso di informazioni in uscita
Quando l'utente seleziona Salva, in genere chiama SubmitForm. Il modulo raccoglie i valori da ogni scheda dati e li scrive nuovamente nell'origine dati. Usa datafield di ogni scheda per sapere quale campo aggiornare.
Per salvare le modifiche da un modulo Di modifica, attivare SubmitForm(FormName) (ad esempio, da un pulsante Salva ). Se si desidera cancellare gli input dopo l'invio, seguire ResetForm(FormName). Per creare un nuovo record invece di modificarne uno esistente, impostare la proprietà DefaultMode della maschera su FormMode.New prima che l'utente inizi a inserire i dati.
Il modulo legge anche la proprietà Update di ogni scheda. Si tratta del valore salvato per tale campo. Se è necessario pulire un valore prima di salvare, ad esempio rimuovendo spazi aggiuntivi, convertendo il testo in un numero o ripristinando una modifica di formattazione apportata in Default, Update è in genere il posto giusto per farlo.
Valid indica fondamentalmente se "questo campo è pronto per essere inviato?" Power Apps utilizza le regole dell'origine dati e l'impostazione Required della scheda per decidere. Se il valore non è valido, la proprietà Error della scheda contiene un messaggio che è possibile visualizzare all'utente, spesso tramite l'etichetta Messaggio di errore nella scheda.
Se il campo dati di una scheda è vuoto, la scheda non è associata ad alcun campo. Si tratta solo di un contenitore che è possibile usare per il layout. In tal caso, i valori Update e Valid non influiscono sugli elementi salvati quando si invia il modulo.
Analisi dettagliata di un esempio
Esaminare più in dettaglio ciò che si trova all'interno di una tipica scheda di immissione dati. Gli screenshot seguenti distribuiscono i controlli in modo da poter visualizzare chiaramente ogni pezzo.
Nell'immagine successiva, i controlli all'interno della scheda sono etichettati in modo che tu possa associare ciò che vedi nell'area di disegno a ciò che si trova nella visualizzazione ad albero.
Screenshot di controlli etichettati all'interno di una scheda dati in Power Apps.
Ecco i controlli principali visualizzati in genere all'interno di una scheda:
| Name | Type | Funzionamento |
|---|---|---|
| TextRequiredStar | Controllo Label | Mostra una stella o un asterisco quando il campo è obbligatorio. |
| TextFieldDisplayName | Controllo Label | Mostra il nome accessibile del campo che l'utente vede. Questo nome è spesso diverso dal nome dello schema interno. |
| InputText | Controllo input di testo | Mostra il valore corrente e consente all'utente di digitarne uno nuovo. |
| TextErrorMessage | Controllo Label | Visualizza un messaggio se il valore non può essere inviato, ad esempio i dati necessari mancanti. |
Questi controlli in genere non si connettono direttamente a Dataverse. Legge invece valori semplici dalla scheda padre usando Parent e la scheda gestisce la connessione all'origine dati. Le formule seguenti sono esempi comuni.
| Proprietà del controllo | Formula | Spiegazione per principianti |
|---|---|---|
| TextRequiredStar.Visible | Parent.Required | Mostra la stella solo quando il campo è obbligatorio. |