Condividi tramite


elemento property

Il nodo della proprietà definisce una parte di dati specifica e configurabile prevista dal componente da Microsoft Dataverse.

Disponibile per

App basate su modello e canvas

Proprietà

Nome Description TIPO Obbligatorio Disponibile per
valore predefinito Valore di configurazione predefinito fornito al componente. Nelle app basate su modello questa proprietà è consentita solo per gli input, perché i parametri associati prevedono l'associazione di una colonna. corda Opzionale App basate su modello
description-key Utilizzato nelle schermate di personalizzazione come stringhe localizzate che descrivono la descrizione della proprietà. corda Opzionale App basate su modello e canvas
display-name-key Utilizzato nelle schermate di personalizzazione come stringhe localizzate che descrivono il nome della proprietà. corda Yes App basate su modello
nome Nome della proprietà corda Yes App basate su modello e canvas
of-type-group Nome del gruppo di tipi definito nel manifesto corda Opzionale App basate su modello
di tipo Definisce il tipo di dati della proprietà Vedere Uso di tipo Opzionale App basate su modello e canvas
pfx-default-value Valore predefinito dell'espressione PFX fornito al componente. Vedere Uso di pfx-default-value Opzionale App canvas
required Indica se la proprietà è obbligatoria o meno boolean Opzionale App basate su modello
usage La proprietà usage identifica se la proprietà è destinata a rappresentare una colonna che il componente può modificare (associato), di sola lettura (input) o valori di output associato, input o output Yes App basate su modello

Osservazioni:

Questa sezione contiene indicazioni sull'uso degli attributi dell'elemento Property.

Uso di tipo

Il of-type valore della proprietà deve essere uno dei seguenti:

Value Description Disponibile per
Valuta I valori monetari compresi tra -922.337.203.685.477 e 922.337.203.685.477 possono trovarsi in questa colonna. App basate su modello e canvas
DateAndTime.DateAndTime Visualizza data e ora. App basate su modello e canvas
DateAndTime.DateOnly Visualizza solo la data. App basate su modello e canvas
Decimal È possibile usare fino a 10 punti decimali di precisione per i valori compresi tra -100.000.000.000 e -100.000.000.000 in questa colonna. App basate su modello e canvas
Enum Tipo di dati enumerato. App basate su modello e canvas
FP È possibile usare fino a cinque punti decimali di precisione per i valori compresi tra -100.000.000.000 e -100.000.000.000 in questa colonna. App basate su modello e canvas
Lookup.Simple Consente di specificare un singolo riferimento a una tabella specifica. Tutte le ricerche personalizzate sono questo tipo. App basate su modello
Multiple Questa colonna può contenere fino a 1.048.576 caratteri di testo. App basate su modello e canvas
MultiSelectOptionSet È possibile personalizzare i moduli (principale, creazione rapida e visualizzazione rapida) e modelli di posta elettronica aggiungendo colonne scelte. Quando si aggiungono colonne scelte, è possibile specificare più valori disponibili per la selezione degli utenti. Quando gli utenti compilano il modulo, possono selezionarne uno, più o tutti i valori visualizzati in un elenco a discesa. App basate su modello e canvas
Oggetto Tipo di dati dell'oggetto. Può essere usato solo con le proprietà di output. App basate su modello e canvas
OptionSet Questa colonna fornisce un set di opzioni. Ogni opzione ha un valore numerale e un'etichetta. Quando viene aggiunto a un modulo, in questa colonna viene visualizzato un controllo che consente agli utenti di selezionare una sola opzione. App basate su modello e canvas
SingleLine.Email In questo modo viene archiviata l'ora della stringa nel formato valido per i messaggi di posta elettronica. I controlli Unified Interface predefiniti rendono automaticamente selezionabili i collegamenti. App basate su modello e canvas
SingleLine.Phone Archivia l'ora della stringa nel formato valido per Phone. I controlli Unified Interface predefiniti rendono automaticamente selezionabili i collegamenti. App basate su modello e canvas
SingleLine.Text Questa opzione visualizza semplicemente il testo. App basate su modello e canvas
SingleLine.TextArea Questa opzione di formato può essere usata per visualizzare più righe di testo. Tuttavia, con un limite di 4000 caratteri, la colonna Più righe di testo è una scelta migliore se sono previste grandi quantità di testo. App basate su modello e canvas
SingleLine.Ticker Archivia l'ora della stringa nel formato valido per Ticker. I controlli Unified Interface predefiniti rendono automaticamente selezionabili i collegamenti. App basate su modello e canvas
SingleLine.URL Testo previsto per fornire un collegamento ipertestuale per aprire la pagina specificata. I controlli Unified Interface predefiniti anteponevano automaticamente "https://" ai valori di input che non iniziano con un protocollo valido. In questa colonna sono previsti solo protocolli HTTP, HTTPS, FTP, FTPS, OneNote e TEL. App basate su modello e canvas
TwoOptions Questa colonna offre due opzioni. Ogni opzione ha un valore numerico pari a 0 o 1 corrispondente a un valore false o true. Ogni opzione include anche un'etichetta in modo che i valori true o false possano essere rappresentati come "Sì" e "No", "Hot" e "Cold", "On" e "Off" o qualsiasi coppia di etichette che si desidera visualizzare. App basate su modello e canvas
Whole.None Questa opzione visualizza semplicemente un numero. App basate su modello e canvas

Avvertimento

Se il manifest.xml file contiene almeno un set di dati, anche le proprietà di tipo Lookup.Simple devono essere incluse nell'elemento del set di dati .

Elementi valore non supportati

I valori delle proprietà seguenti of-type non sono attualmente supportati:

Value Description
Lookup.Customer Consente un singolo riferimento a un account o a un record del contatto. Queste ricerche sono disponibili per le tabelle Opportunità, Caso, Offerta, Ordine e Fattura. Queste tabelle includono anche ricerche di account e contatti separate che è possibile usare se i clienti sono sempre di tipo. In alternativa, è possibile includere entrambi anziché usare la ricerca del cliente.
Lookup.Owner Consente un singolo riferimento a un team o a un record utente. Tutte le tabelle di proprietà del team o dell'utente dispongono di una di queste tabelle.
Lookup.PartyList Consente più riferimenti a più tabelle. Queste ricerche sono disponibili nelle colonne A e Cc della tabella Email. Vengono usati anche nelle tabelle Telefono e Appuntamento.
Lookup.Regarding Consente un singolo riferimento a più tabelle. Queste ricerche sono disponibili nella colonna relativa alle attività usate.
Motivo dello stato Colonna di sistema con opzioni che forniscono maggiori dettagli sulla colonna Stato. Ogni opzione è associata a una delle opzioni di stato disponibili. È possibile aggiungere e modificare le opzioni.
stato Colonna di sistema con opzioni che in genere corrispondono allo stato attivo e inattivo. Alcune colonne di sistema hanno più opzioni, ma tutte le colonne personalizzate hanno solo opzioni di stato Attivo e Inattivo.
Whole.Duration Questa opzione di formato può essere usata per visualizzare un elenco di opzioni di durata. Tuttavia, i dati archiviati nel database sono sempre un numero di minuti. La colonna è simile a un elenco a discesa e offre opzioni suggerite come 1 minuto, 15 minuti, 30 minuti fino a tre giorni. Le persone possono scegliere queste opzioni. Tuttavia, le persone possono anche digitare solo in un numero di minuti e si risolve in quel periodo di tempo.
Whole.Language Questa opzione visualizza un elenco delle lingue di cui è stato effettuato il provisioning per l'organizzazione. I valori vengono visualizzati come elenco a discesa di nomi di lingua, ma i dati vengono archiviati come numero usando codici LCID. I codici delle lingue sono ID delle impostazioni locali a quattro o cinque cifre. I valori degli ID delle impostazioni locali validi sono disponibili nella pagina che riporta il grafico degli ID delle impostazioni locali (LCID).
Whole.TimeZone Questa opzione visualizza un elenco selezionato di fusi orari, ad esempio (GMT-12.00) International Date Line West e (GMT-08:00) Pacific Time (US & Canada). Ognuna di queste zone viene archiviata come numero. Ad esempio, per il fuso orario (GMT-08:00) Pacific Time (US & Canada), TimeZoneCode è 4.

Annotazioni

Al momento le colonne file non sono supportate. Altre informazioni: Colonne di file

Uso di pfx-default-value

Usare il valore della pfx-default-value proprietà per valutare eventi e proprietà usando espressioni Power Fx anziché valori predefiniti statici. È possibile usarlo per:

  • Ridimensionare in modo reattivo il controllo
  • Accedere ai connettori
  • Fornire dati di esempio
  • Proprietà del tema di riferimento
  • Eventi personalizzati

Annotazioni

  • È possibile usare qualsiasi espressione Power Fx, ma è necessario assicurarsi che l'espressione sia valida durante l'importazione del controllo.
  • Se si usano virgolette interne o altri caratteri speciali, racchiudere il valore tra virgolette singole, ad esempio: pfx-default-value='"Test"'
  • È possibile fare riferimento ad altri controlli (incluse le schermate) e alle relative proprietà. Scrivere questi riferimenti come: %ControlName.ID%.ControlProperty. Ad esempio: pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Scrivere enumerazioni, ad esempio DisplayType e ScreenTransition come: %EnumName.RESERVED%.EnumValue. Ad esempio: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Se pfx-default-value è incluso, avrà la precedenza su default-value.

Elementi padre

Elemento Description
controllo Definisce lo spazio dei nomi, la versione e le informazioni di visualizzazione del componente.

Example

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

Informazioni di riferimento sullo schema del manifesto del framework dei componenti di Power Apps
Informazioni di riferimento sulle API del framework dei componenti di Power Apps
Panoramica del framework dei componenti di Power Apps