elemen properti

Simpul properti mendefinisikan bagian data tertentu yang dapat dikonfigurasi yang diharapkan komponen dari Microsoft Dataverse.

Tersedia untuk

Aplikasi berbasis model dan kanvas

Karakteristik

Nama Description Tipe Diperlukan Tersedia untuk
nilai default Nilai konfigurasi default yang disediakan untuk komponen. Di aplikasi berbasis model, properti ini hanya diizinkan pada input karena parameter terikat berharap memiliki kolom yang terkait. string Fakultatif Aplikasi yang diarahkan model
description-key Digunakan dalam layar kustomisasi sebagai string yang dilokalkan yang menjelaskan deskripsi properti. string Fakultatif Aplikasi berbasis model dan kanvas
display-name-key Digunakan dalam layar kustomisasi sebagai string yang dilokalkan yang menjelaskan nama properti. string Yes Aplikasi yang diarahkan model
Nama Nama properti string Yes Aplikasi berbasis model dan kanvas
grup tipe Nama grup jenis seperti yang didefinisikan dalam manifes string Fakultatif Aplikasi yang diarahkan model
berjenis Menentukan jenis data properti Lihat Menggunakan jenis Fakultatif Aplikasi berbasis model dan kanvas
pfx-default-value Nilai ekspresi PFX default yang disediakan untuk komponen. Lihat Menggunakan pfx-default-value Fakultatif Aplikasi kanvas
required Apakah properti diperlukan atau tidak Boolean Fakultatif Aplikasi yang diarahkan model
usage Properti penggunaan mengidentifikasi apakah properti dimaksudkan untuk mewakili kolom yang dapat diubah komponen (terikat), baca-saja (input) atau nilai output terikat, input, atau output Yes Aplikasi yang diarahkan model

Komentar

Bagian ini berisi panduan tentang menggunakan atribut elemen Properti.

Menggunakan jenis

Nilai of-type properti harus salah satu dari yang berikut ini:

Nilai Description Tersedia untuk
Mata Uang Nilai moneter antara -922.337.203.685.477 dan 922.337.203.685.477 dapat berada di kolom ini. Aplikasi berbasis model dan kanvas
DateAndTime.DateAndTime Menampilkan tanggal dan waktu. Aplikasi berbasis model dan kanvas
DateAndTime.DateOnly Menampilkan tanggal saja. Aplikasi berbasis model dan kanvas
Decimal Hingga 10 titik desimal presisi dapat digunakan untuk nilai antara -100.000.000.000 dan -100.000.000.000 dapat berada di kolom ini. Aplikasi berbasis model dan kanvas
Enum Jenis data enumerasi. Aplikasi berbasis model dan kanvas
FP Hingga lima titik desimal presisi dapat digunakan untuk nilai antara -100.000.000.000 dan -100.000.000.000 dapat berada di kolom ini. Aplikasi berbasis model dan kanvas
Lookup.Simple Memungkinkan referensi tunggal ke tabel tertentu. Semua pencarian kustom adalah jenis ini. Aplikasi yang diarahkan model
Beberapa Kolom ini dapat berisi hingga 1.048.576 karakter teks. Aplikasi berbasis model dan kanvas
MultiSelectOptionSet Anda dapat mengkustomisasi formulir (templat utama, buat cepat, dan tampilan cepat) dan email dengan menambahkan kolom pilihan. Saat menambahkan kolom pilihan, Anda bisa menentukan beberapa nilai yang tersedia untuk dipilih pengguna. Saat pengguna mengisi formulir, mereka dapat memilih satu, beberapa, atau semua nilai yang ditampilkan dalam daftar drop-down. Aplikasi berbasis model dan kanvas
Objek Jenis data objek. Hanya dapat digunakan dengan properti output. Aplikasi berbasis model dan kanvas
Opsi Set Kolom ini menyediakan sekumpulan opsi. Setiap opsi memiliki nilai angka dan label. Saat ditambahkan ke formulir, kolom ini menampilkan kontrol bagi pengguna untuk memilih hanya satu opsi. Aplikasi berbasis model dan kanvas
SingleLine.Email Ini menyimpan waktu string dalam format yang valid untuk Email. Kontrol Antarmuka Terpadu out-of-the-box secara otomatis menjadikannya tautan yang dapat diklik. Aplikasi berbasis model dan kanvas
SingleLine.Phone Ini menyimpan waktu string dalam format yang valid untuk Telepon. Kontrol Antarmuka Terpadu out-of-the-box secara otomatis menjadikannya tautan yang dapat diklik. Aplikasi berbasis model dan kanvas
SingleLine.Text Opsi ini hanya menampilkan teks. Aplikasi berbasis model dan kanvas
SingleLine.TextArea Opsi format ini dapat digunakan untuk menampilkan beberapa baris teks. Tetapi dengan batas 4000 karakter, kolom Beberapa Baris Teks adalah pilihan yang lebih baik jika teks dalam jumlah besar diharapkan. Aplikasi berbasis model dan kanvas
SingleLine.Ticker Ini menyimpan waktu string dalam format yang valid untuk Ticker. Kontrol Antarmuka Terpadu out-of-the-box secara otomatis menjadikannya tautan yang dapat diklik. Aplikasi berbasis model dan kanvas
SingleLine.URL Teks yang diharapkan menyediakan hyperlink untuk membuka halaman yang ditentukan. Kontrol Antarmuka Terpadu out-of-the-box secara otomatis menambahkan "https://" ke nilai input yang tidak dimulai dengan protokol yang valid. Hanya protokol HTTP, HTTPS, FTP, FTPS, OneNote, dan TEL yang diharapkan di kolom ini. Aplikasi berbasis model dan kanvas
TwoOptions Kolom ini menyediakan dua opsi. Setiap opsi memiliki nilai angka 0 atau 1 yang sesuai dengan nilai false atau true. Setiap opsi juga memiliki label sehingga nilai benar atau salah dapat direpresentasikan sebagai "Ya" dan "Tidak", "Panas" dan "Dingin", "Hidup" dan "Nonaktif" atau sepasang label apa pun yang ingin Anda tampilkan. Aplikasi berbasis model dan kanvas
Whole.None Opsi ini hanya menampilkan angka. Aplikasi berbasis model dan kanvas

Peringatan

manifest.xml Jika file berisi setidaknya satu himpunan data, maka properti jenis Lookup.Simple juga harus dibungkus ke dalam elemen himpunan data.

Elemen nilai yang tidak didukung

Nilai properti berikut of-type tidak didukung saat ini:

Nilai Description
Lookup.Customer Mengizinkan satu referensi ke akun atau rekaman kontak. Pencarian ini tersedia untuk tabel Peluang, Kasus, Kuotasi, Pesanan, dan Faktur. Tabel ini juga memiliki pencarian Akun dan Kontak terpisah yang dapat Anda gunakan jika pelanggan Anda selalu satu jenis. Atau Anda dapat menyertakan keduanya alih-alih menggunakan pencarian Pelanggan.
Lookup.Owner Memungkinkan satu referensi ke tim atau catatan pengguna. Semua tim atau tabel milik pengguna memiliki salah satu dari ini.
Lookup.PartyList Memungkinkan beberapa referensi ke beberapa tabel. Pencarian ini ditemukan di tabel Email ke dan kolom Cc . Mereka juga digunakan dalam tabel Telepon dan Janji Temu.
Lookup.Mengenai Memungkinkan referensi tunggal ke beberapa tabel. Pencarian ini ditemukan di kolom mengenai yang digunakan dalam aktivitas.
Alasan Status Kolom sistem yang memiliki opsi yang menyediakan detail selengkapnya tentang kolom Status. Setiap opsi dikaitkan dengan salah satu opsi Status yang tersedia. Anda dapat menambahkan dan mengedit opsi.
Kedudukan Kolom sistem yang memiliki opsi yang umumnya sesuai dengan status aktif dan tidak aktif. Beberapa kolom sistem memiliki lebih banyak opsi, tetapi semua kolom kustom hanya memiliki opsi status Aktif dan Tidak Aktif.
Whole.Duration Opsi format ini dapat digunakan untuk menampilkan daftar opsi durasi. Tetapi data yang disimpan dalam database selalu sejumlah menit. Kolom terlihat seperti daftar drop-down dan menyediakan opsi yang disarankan seperti 1 menit, 15 menit, 30 menit hingga tiga hari. Orang dapat memilih opsi ini. Namun, orang juga dapat mengetik dalam beberapa menit dan menyelesaikan periode waktu tersebut.
Whole.Language Opsi ini menampilkan daftar bahasa yang disediakan untuk organisasi Anda. Nilai ditampilkan sebagai daftar drop-down nama bahasa, tetapi data disimpan sebagai angka menggunakan kode LCID. Kode bahasa adalah ID lokal empat digit atau lima digit. Nilai ID lokal yang valid dapat ditemukan di Bagan ID Lokal (LCID)).
Whole.TimeZone Opsi ini menampilkan daftar zona waktu tertentu seperti (GMT-12:00) International Date Line West dan (GMT-08:00) Pacific Time (AS & Kanada). Masing-masing zona ini disimpan sebagai angka. Misalnya, untuk zona waktu (GMT-08:00) Waktu Pasifik (AS & Kanada), TimeZoneCode adalah 4.

Nota

Saat ini kolom File tidak didukung. Informasi selengkapnya: Kolom file

Menggunakan pfx-default-value

pfx-default-value Gunakan nilai properti untuk mengevaluasi peristiwa dan properti menggunakan ekspresi Power Fx alih-alih nilai default statis. Anda dapat menggunakan ini untuk:

  • Ukuran kontrol secara responsif
  • Konektor akses
  • Menyediakan data sampel
  • Properti tema referensi
  • Peristiwa khusus

Nota

  • Anda dapat menggunakan ekspresi Power Fx apa pun, tetapi Anda harus memastikan ekspresi valid saat mengimpor kontrol.
  • Jika Anda menggunakan tanda kutip dalam atau karakter khusus lainnya, bungkus nilai dalam tanda kutip tunggal, Misalnya: pfx-default-value='"Test"'
  • Anda dapat mereferensikan kontrol lain (termasuk layar) dan propertinya. Tulis referensi ini sebagai: %ControlName.ID%.ControlProperty. Misalnya: pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Tulis enum, seperti DisplayType dan ScreenTransition sebagai: %EnumName.RESERVED%.EnumValue. Misalnya: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Jika pfx-default-value disertakan, maka itu lebih diutamakan daripada default-value.

Elemen Induk

Elemen Description
menguasai Menentukan namespace, versi, dan informasi tampilan komponen.

Example

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

Referensi skema manifes kerangka kerja komponen Power Apps
Referensi API kerangka kerja komponen Power Apps
Gambaran umum kerangka kerja komponen Power Apps