Informazioni sulle schede datiUnderstand data cards

I controlli scheda sono i blocchi predefiniti dei controlli Modifica modulo e Visualizza modulo.Card controls are the building blocks of the Edit form and Display form controls. Il modulo rappresenta l'intero record e ogni scheda rappresenta un singolo campo di tale record.The form represents the entire record, and each card represents a single field of that record.

È possibile interagire con le schede più agevolmente nel riquadro destro dopo aver selezionato un modulo nell'area di lavoro di progettazione.You can interact with cards most easily in the right-hand pane after you select a form control in the design workspace. In questo riquadro è possibile scegliere i campi da visualizzare, come deve essere visualizzato ogni campo e in che ordine.In that pane, you can choose which fields to show, how to show each field, and in what order to show them. Questo esempio illustra un controllo Modulo di modifica in un'app compilata da un elenco di SharePoint che è denominato Assets.This example shows an Edit form control in an app built from a SharePoint list that's named Assets.

Per un'introduzione sulle schede, vedere aggiungere un modulo e informazioni sui moduli dati.To get started with cards, see add a form and understand data forms. La parte restante di questo argomento descrive in dettaglio come funzionano le schede e come è possibile personalizzarle o persino crearne di proprie.The remainder of this topic goes into more detail about how cards work and how you can customize or even create your own.

Schede predefinitePredefined cards

PowerApps offre un set predefinito di schede per stringhe, numeri e altri tipi di dati.PowerApps offers a predefined set of cards for strings, numbers, and other data types. Nel riquadro destro è possibile vedere le variazioni disponibili e modificare la scheda usata per un campo:In the right-hand pane, you can see the variations available and change the card used for a field:

In questo esempio viene selezionata una scheda di testo a riga singola, ma il testo dell'URL è più lungo dello spazio visualizzabile in una singola riga.In this example, a single-line text card is selected, but the URL's text is longer than can be shown on a single line. Verrà modificato in una scheda di testo su più righe per offrire più spazio modificabile agli utenti:Let's change this to a multi-line text card to give our users more room to edit:

Non sono visualizzati diversi campi di questa origine dati, ma è possibile visualizzare o nascondere un campo selezionando la relativa casella di controllo.Several fields of this data source aren't being shown, but you can show or hide a field by selecting its checkbox. Questo esempio illustra come visualizzare il campo SecurityCode.This example illustrates how to show the SecurityCode field.

Personalizzare una schedaCustomize a card

Le schede comprendono altri controlli.Cards comprise other controls. In un controllo Modulo di modifica l'utente immette i dati in un controllo Input di testo standard aggiunto dalla scheda Inserisci.In an Edit form control, the user enters data in a standard Text input control that you add from the Insert tab.

Verrà ora esaminato un esempio di come cambiare l'aspetto di una scheda modificandone i controlli.Let's walk through an example of how to change a card's appearance by manipulating controls in it.

  1. In primo luogo tornare alla scheda inserita più di recente, per il campo SecurityCode.First, let's return to the card that we inserted most recently, for the SecurityCode field. Selezionare la scheda facendo clic o toccando una volta:Select this card by clicking or tapping it once:

  2. Selezionare il controllo Input di testo nella scheda facendo clic o toccando il controllo stesso.Select the Text input control inside the card by clicking or tapping the input control itself.

  3. Spostare il controllo nella scheda trascinando la casella di selezione e ridimensionarlo trascinando i punti di controllo lungo il bordo della casella di selezione:Move this control within the card by dragging the selection box, and resize the control by dragging the handles along the edge of the selection box:

È possibile ridimensionare, spostare e apportare altre modifiche ai controlli in una scheda, ma non è possibile eliminarli senza prima averli sbloccati.You can resize, move, and make other modifications to controls within a card, but you can't delete it without unlocking it first.

Sbloccare una schedaUnlock a card

Oltre a contenere i controlli, le schede stesse sono controlli che hanno proprietà e formule esattamente come qualsiasi altro controllo.In addition to containing controls, cards themselves are controls that have properties and formulas just like any other control. Quando si sceglie di visualizzare un campo in un modulo, nel riquadro destro viene creata automaticamente la scheda e vengono generate le formule necessarie.When you choose to display a field on a form, the right-hand pane automatically creates the card for you and generates the needed formulas. Queste formule sono visibili nella scheda Avanzate del riquadro di destra:We can see these formulas in the Advanced tab of the right-hand pane:

Si noti una delle proprietà più importanti della scheda: la proprietà DataField.We immediately see one of the most important properties of the card: the DataField property. Questa proprietà indica quale campo dell'origine dati l'utente può visualizzare e modificare in questa scheda.This property indicates which field of the data source the user sees and can edit in this card.

Nella scheda Avanzate l'intestazione nella parte superiore indica che le proprietà della scheda sono bloccate.On the Advanced tab, the banner at the top indicates that the properties of this card are locked. Viene visualizzata anche un'icona a forma di lucchetto accanto alle proprietà DataField, DisplayName, e Required.A lock icon also appears next to the DataField, DisplayName, and Required properties. Le formule sono state create nel riquadro destro e il blocco impedisce modifiche accidentali a tali proprietà.The right-hand pane created these formulas, and the lock prevents accidental changes to these properties.

Fare clic sull'intestazione in alto o toccarla per sbloccare le schede in modo che sia possibile modificare le proprietà:Click or tap the banner at the top to unlock the card so that you can modify these properties:

Verrà modificata le proprietà DisplayName per inserire uno spazio tra Asset e ID.Let's modify the DisplayName to put a space between Asset and ID. Apportando questa modifica, l'utente sta modificando ciò che è stato creato dal sistema.By making this change, we're altering what was generated for us. Nel riquadro destro la scheda ha un'etichetta diversa:In the right-hand pane, this card has a different label:

L'utente ha assunto il controllo della scheda e può modificarla ancora in base alle proprie esigenze.We've now taken control over this card and can modify it further to fit our need. Ma è stata persa la possibilità di modificare la scheda da una rappresentazione all'altra. Ad esempio, da una sola riga di testo a più righe di testo, come fatto in precedenza.But we've lost the ability to change the card from one representation to another (for example, single-line text to multi-line text) as we did before. La scheda predefinita è stata trasformata in una "scheda personalizzata" che ora l'utente può controllare.We've transformed the predefined card into a "custom card" that we now control.

Importante

Non è possibile bloccare nuovamente una scheda dopo che è stata sbloccata.You can't relock a card if you unlock it. Per ripristinare uno stato bloccato della scheda, rimuoverla e reinserirla nel riquadro destro.To get a card back to a locked state, remove it, and reinsert it in the right-hand pane.

È possibile modificare l'aspetto e il comportamento di una scheda sbloccata in diversi modi, ad esempio aggiungendo ed eliminando i controlli in essa contenuti.You can change the appearance and behavior of an unlocked card in a variety of ways, such as adding and deleting controls within it. Ad esempio, è possibile aggiungere una forma di stella dal menu Icone nella scheda Inserisci.For example, you can add a star shape from the Icons menu on the Insert tab.

La stella fa ora parte della scheda e ne seguirà i movimenti se, ad esempio, le schede verranno riordinate all'interno del modulo.The star is now a part of the card and will travel with it if, for example, you reorder the cards within the form.

Come altro esempio, è possibile sbloccare la scheda ImageURL e quindi aggiungere un controllo Immagine dalla scheda Inserisci:As another example, unlock the ImageURL card, and then add an Image control to it from the Insert tab:

Nella barra della formula impostare la proprietà Image del controllo su TextBox.Text, dove TextBox è il nome del controllo Input di testo che contiene l'URL:In the formula bar, set the Image property of this control to TextBox.Text, where TextBox is the name of the Text input control that holds the URL:

Suggerimento

Per visualizzare il nome di ogni controllo, premere il tasto ALT.Press the Alt key to show the name of each control.

Ora è possibile visualizzare le immagini e modificarne gli URL.And now we can see the images and edit their URLs. Si noti che si sarebbe potuto usare Parent.Default come proprietà Image, ma non sarebbe stata aggiornata nel momento in cui l'utente avesse modificato l'URL.Note that we could have used Parent.Default as the Image property, but it wouldn't have updated if the user changed the URL.

È possibile eseguire la stessa operazione nella seconda schermata dell'applicazione, in cui viene usato un controllo Modulo di visualizzazione per mostrare i dettagli di un record.We can do the same thing on the second screen of this app, where we use a Display form control to display the details of a record. In questo caso potrebbe essere necessario nascondere l'etichetta perché l'utente non modifica l'URL in questa schermata. Quindi, impostare la proprietà Visible dell'etichetta, non della scheda, su false:In this case, we may want to hide the label (set the Visible property of the label, not the card, to false) because the user won't edit the URL on that screen:

Interagire con un moduloInteract with a form

Dopo aver sbloccato una scheda, è possibile modificare le modalità di interazione con il modulo che la contiene.After you unlock a card, you can change how it interacts with the form that contains it.

Di seguito sono riportate alcune linee guida su come i controlli dovrebbero funzionare con la scheda e su come le schede dovrebbero funzionare con il modulo.Below are some guidelines for how controls should work with their card and how the cards should work with the form. Si tratta solo di linee guida.These are only guidelines. Come con qualsiasi controllo in PowerApps, è possibile creare formule che facciano riferimento a qualsiasi altro controllo in PowerApps, e ciò vale anche per le schede e i controlli in esse contenuti.As with any control in PowerApps, you can create formulas that reference any other control in PowerApps, and that's no less true for cards and controls within cards. In PowerApps si può essere creativi: è possibile creare un'app in molti modi.Be creative: you can create an app in many ways.

Proprietà DataFieldDataField property

La proprietà più importante della scheda è la proprietà DataField.The most important property on the card is the DataField property. Questa proprietà attiva la convalida, determina il campo che viene aggiornato e altri aspetti della scheda.This property drives validation, what field is updated, and other aspects of the card.

Flusso di informazioni in entrataInformation flowing in

Come un contenitore, il modulo rende disponibile ThisItem a tutte le schede che contiene.As a container, the form makes ThisItem available to all cards within it. Questo record contiene tutti i campi per il record di interesse corrente.This record contains all of the fields for the current record of interest.

La proprietà Default di ogni scheda deve essere impostata su ThisItem.FieldName.The Default property of every card should be set to ThisItem.FieldName. In determinate circostanze può essere opportuno trasformare il valore.Under certain circumstances, you might want to transform this value on the way in. Ad esempio, è possibile che sia necessario formattare una stringa o tradurre il valore da una lingua a un'altra.For example, you might want to format a string or translate the value from one language to another.

Tutti i controlli della scheda devono fare riferimento a Parent.Default per ottenere il valore del campo.Each control within the card should reference Parent.Default to get at the field's value. Questa strategia offre un livello di incapsulamento per la scheda così che la proprietà Default della scheda possa essere modificata senza modificare le formule interne della scheda.This strategy provides a level of encapsulation for the card so that the card's Default property can change without changing the internal formulas of the card.

Per impostazione predefinita, le proprietà DefaultValue e Required provengono dai metadati dell'origine dati in base alla proprietà DataField.By default, DefaultValue and Required properties are taken from the data source's metadata based on the DataField property. È possibile eseguire l'override di queste formule con la propria logica, integrando i metadati dell'origine dati usando la funzione DataSourceInfo.You can override these formulas with your own logic, integrating the data source's metadata by using the DataSourceInfo function.

Flusso di informazioni in uscitaInformation flowing out

Dopo che l'utente modifica un record usando i controlli nelle schede, la funzione SubmitForm salva le modifiche apportate all'origine dati.After the user modifies a record by using controls in the cards, the SubmitForm function saves those changes to the data source. Quando tale funzione viene eseguita, il controllo del modulo legge i valori della proprietà DataField di ogni scheda per sapere quale campo modificare.When that function runs, the form control reads the values of each card's DataField property to know what field to change.

Il controllo del modulo legge anche il valore della proprietà Update di ogni scheda.The form control also reads the value of each card's Update property. Questo valore viene archiviato nell'origine dati per il campo.This value will be stored in the data source for this field. Questo è il punto in cui applicare un'altra trasformazione, ad esempio per invertire la trasformazione che è stata applicata alla proprietà Default della scheda.This is the place to apply another transform, perhaps to reverse the transform that was applied in the card's Default formula.

La proprietà Valid viene attivata dai metadati dell'origine dati, in base alla proprietà DataField.The Valid property is driven from the metadata of the data source, based on the DataField property. Si basa anche sulla proprietà Required e sulla presenza o meno di un valore nella proprietà Update.It's also based on the Required property and whether the Update property contains a value. Se il valore della proprietà Update non è valido, la proprietà Error visualizza un messaggio di errore descrittivo.If the value on the Update property isn't valid, the Error property provides a user-friendly error message.

Se la proprietà DataField di una scheda è vuota, la scheda è semplicemente un contenitore di controlli.If the DataField property of a card is blank, the card is just a container of controls. Le relative proprietà Valid e Update non vengono inoltrate insieme con il modulo.Its Valid and Update properties don't participate when the form is submitted.

Analisi dettagliata di un esempioDissecting an example

Verranno analizzati i controlli che costituiscono una scheda di immissione di dati base.Let's look at the controls that make up a basic data-entry card. Lo spazio tra i controlli è stato aumentato per visualizzare ogni controllo più chiaramente:The space between controls has been increased to show each more clearly:

Tenere premuto ALT per visualizzare i nomi dei controlli che costituiscono la scheda:Hold down the Alt key to show the names of the controls that make up this card:

Sono quattro i controlli che fanno funzionare la scheda:Four controls make this card work:

NomeName TipoType DescrizioneDescription
TextRequiredStarTextRequiredStar Controllo EtichettaLabel control Visualizza una stella, che viene comunemente usata nei moduli di immissione di dati per indicare che un campo è obbligatorio.Displays a star, which is commonly used on data-entry forms to indicate that a field is required.
TextFieldDisplayNameTextFieldDisplayName Controllo EtichettaLabel control Visualizza il nome descrittivo del campo.Displays the user-friendly name of this field. Questo nome può non corrispondere a ciò che è presente nello schema dell'origine dati.This name can differ from what is in the data source's schema.
InputTextInputText Controllo Testo di inputInput text control Visualizza il valore iniziale del campo e consente all'utente di modificarlo.Displays the initial value of the field and allows the user to change that value.
TextErrorMessageTextErrorMessage Controllo EtichettaLabel control Visualizza un messaggio di errore descrittivo per l'utente se si verifica un problema con la convalida.Displays a user-friendly error message to the user if a problem occurs with validation. Verifica anche che il campo contenga un valore se necessario.Also ensures that the field has a value if one is required.

Per popolare questi controlli con i dati, è possibile attivarne le proprietà dalle proprietà della scheda, tramite queste formule chiave.To populate these controls with data, their properties can be driven from the properties of the card, through these key formulas. Si noti che nessuna di queste formule fa riferimento a un campo specifico.Note that none of these formulas refers to a specific field. Al contrario, tutte le informazioni provengono dalla scheda.Instead, all information comes from the card.

Proprietà del controlloControl property FormulaFormula DescrizioneDescription
TextRequiredStar.VisibleTextRequiredStar.Visible Parent.RequiredParent.Required La stella viene visualizzata solo se il campo è obbligatorio.The star appears only if the field is required. L'obbligatorietà deriva da una formula che viene attivata dall'utente o dai metadati dell'origine dati.Required is a formula that's driven by you or the metadata of the data source.
TextFieldDisplayName.TextTextFieldDisplayName.Text Parent.DisplayNameParent.DisplayName Il controllo casella di testo visualizza il nome descrittivo, specificato dall'utente o dai metadati dell'origine dati, e che viene impostato nella proprietà DisplayName della scheda.The text-box control shows the user-friendly name, which you or the data source's metadata provides, and which is set on the card's DisplayName property.
InputText.DefaultInputText.Default Parent.DefaultParent.Default Il controllo di input di testo inizialmente visualizza il valore del campo dall'origine dati, come specificato dal valore predefinito della scheda.The text-input control initially shows the value of the field from the data source, as provided by the card's default value.
TextErrorMessage.TextTextErrorMessage.Text Parent.ErrorParent.Error Se si verifica un problema di convalida, la proprietà Error della scheda specifica un messaggio di errore appropriato.If a validation problem occurs, the card's Error property provides an appropriate error message.

Per estrarre informazioni da questi controlli e inserirle nell'origine dati, sono disponibili le formule chiave seguenti:To pull information out of these controls and push it back into the data source, we have the following key formulas:

Nome del controlloControl name FormulaFormula DescrizioneDescription
DataCard.DataFieldDataCard.DataField "ApproverEmail""ApproverEmail" Il nome del campo che l'utente può visualizzare e modificare in questa scheda.The name of the field that the user can display and edit in this card.
DataCard.UpdateDataCard.Update InputText.TextInputText.Text Il valore per convalidare e reinserire i dati nell'origine dati quando viene eseguita la funzione SubmitForm.The value to validate and push back into the data source when SubmitForm runs.