Fungsi GUID
Berlaku untuk:
Aplikasi kanvas Alur desktop Aplikasi Power Platform berbasis model CLI
Mengonversi string GUID (Pengidentifikasi Unik Global) menjadi nilai GUID atau membuat nilai GUID baru.
KETERANGAN
Gunakan fungsi GUID untuk mengonversi string yang berisi representasi heksadesimal GUID ke nilai GUID yang dapat diteruskan ke database. Nilai GUID digunakan sebagai kunci dengan sistem database seperti Microsoft Dataverse dan SQL Server.
String yang diteruskan dapat berisi huruf besar atau kecil, namun harus 32 digit heksadesimal di salah satu dari format ini:
- "123e4567-e89b-12d3-a456-426655440000" (tanda hubung dalam lokasi standar)
- "123e4567e89b12d3a456426655440000" (tidak ada tanda hubung)
Jika Anda tidak menentukan argumen, fungsi ini membuat GUID baru.
Untuk mengonversi nilai GUID ke string, cukup gunakan dalam konteks string. Nilai GUID akan dikonversi ke string representasi heksadesimal dengan tanda hubung dan huruf kecil.
Saat membuat GUID baru, fungsi ini menggunakan nomor acak pseudo untuk membuat versi GUID 4 IETF RFC 4122. Saat mengonversi string ke GUID, fungsi ini mendukung versi GUID dengan menerima string 32 digit heksadesimal.
Fungsi Volatile
GUID adalah fungsi volatile yang mudah digunakan tanpa argumen. Setiap kali fungsi ini dievaluasi, fungsi akan menghasilkan nilai yang berbeda.
Bila digunakan dalam rumus aliran data, fungsi volatile akan menghasilkan nilai yang berbeda hanya jika rumus yang muncul dievaluasi ulang. Jika tidak ada perubahan lain dalam rumus maka akan memiliki nilai yang sama di seluruh eksekusi aplikasi Anda.
Misalnya, kontrol label untuk properti Teks yang diatur ke GUID() tidak akan berubah saat aplikasi aktif. Hanya menutup dan membuka kembali aplikasi akan menghasilkan nilai berbeda.
Fungsi akan dievaluasi ulang jika fungsi merupakan bagian dari rumus dengan sesuatu yang lain telah berubah. Jika kita mengatur properti Teks dari kontrol Label rumus ini, misalnya, GUID yang dihasilkan setiap kali pengguna mengubah nilai kontrol Input teks:
TextInput1.Text & " " & GUID()
Bila digunakan dalam rumus perilaku, fungsi GUID akan dievaluasi setiap kali rumus dievaluasi. Untuk informasi lebih lanjut, lihat contoh nanti dalam topik ini.
Sintaks
GUID( [ GUIDString ] )
- GUIDString – Opsional. String teks yang berisi representasi heksadesimal GUID. Jika tidak ada string yang disediakan, GUID baru dibuat.
GUID( Tidak Berjenis )
- Tidak Berjenis - Wajib. Objek tidak berjenis yang menunjukkan GUID. Nilai yang dapat diterima tergantung pada penyedia tak berjenis. Untuk JSON, objek yang tidak berjenis diharapkan GUID yang dinyatakan sebagai string JSON.
Contoh
Penggunaan dasar
Untuk menghasilkan nilai GUID berdasarkan representasi string heksadesimal:
GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )
Anda juga dapat menyediakan string GUID tanpa tanda hubung. Rumus ini menghasilkan nilai GUID yang sama:
GUID( "0f8fad5bd9cb469fa16570867728950e" )
Digunakan dalam konteks, untuk mengatur bidang Status rekaman database baru ke nilai yang benar:
Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )
Anda mungkin tidak ingin menampilkan GUID ke pengguna, namun GUID dapat membantu Anda melakukan debug aplikasi. Untuk menampilkan nilai bidang Status di rekaman yang Anda buat pada contoh sebelumnya, atur properti Teks dari kontrol Label ke rumus ini:
First( Products ).Status
Kontrol Label akan menampilkan f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.
Membuat tabel GUID
Atur properti OnSelect pada kontrol Tombol ke rumus ini:
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )Rumus ini membuat tabel satu kolom yang digunakan untuk berulang lima kali, sehingga menghasilkan lima GUID.
Tambahkan kontrol Tabel data, atur properti Item ke NewGUIDs, dan Tampilkan bidang Nilai.
Sambil menahan tombol Alt, pilih tombol dengan mengklik atau mengetuknya.
Tabel data menampilkan daftar GUID:
Pilih kembali tombol untuk menampilkan daftar GUID yang berbeda:
Untuk membuat satu GUID, bukan tabel, gunakan rumus ini:
Set( NewGUID, GUID() )