Fungsi GUID

Artikel
10/16/2024

Digunakan untuk: Aplikasi kanvas Aliran desktop Aplikasi dipacu Power Platform model CLI

Menukar rentetan GUID (Pengecam Unik Sejagat) kepada nilai GUID atau mencipta nilai GUID baharu.

Penerangan

Gunakan fungsi GUID untuk menukar rentetan yang mengandungi perwakilan perenambelasan GUID menjadi nilai GUID yang boleh dihantar ke pangkalan data. Nilai GUID digunakan sebagai kunci oleh sistem pangkalan data seperti Microsoft Dataverse dan SQL Server.

Rentetan yang dihantar boleh mengandungi huruf besar atau huruf kecil tetapi mestilah 32 digit perenambelasan dalam salah satu daripada format ini:

"123e4567-e89b-12d3-a456-426655440000"( tanda sempang di lokasi standard)
"123e4567e89b12d3a456426655440000" (tiada tanda sempang)

Jika anda tidak menentukan argumen, fungsi ini akan mencipta GUID baharu.

Untuk menukar nilai GUID kepada rentetan, hanya gunakannya dalam konteks rentetan. Nilai GUID akan ditukar menjadi rentetan perwakilan perenambelasan dengan tanda sempang dan huruf kecil.

Semasa menjana GUID baharu, fungsi ini menggunakan nombor pseudo-rambang untuk mencipta versi 4 IETF RFC 4122 GUID. Semasa menukar rentetan kepada GUID, fungsi ini menyokong sebarang versi GUID dengan menerima sebarang rentetan 32 digit perenambelasan.

Fungsi Meruap

GUID ialah fungsi yang tidak menentu apabila digunakan tanpa hujah. Setiap kali fungsi dinilai, ia akan mengembalikan nilai yang berbeza.

Apabila digunakan dalam formula aliran data, fungsi meruap hanya akan mengembalikan nilai berbeza jika formulanya yang muncul dinilai semula. Jika tiada perubahan dalam formula, ia akan mempunyai nilai yang sama sepanjang pelaksanaan aplikasi anda.

Sebagai contoh, kawalan label yang sifat Teks adalah ditetapkan kepada GUID() tidak akan berubah semasa aplikasi anda aktif. Hanya menutup dan membuka semula aplikasi akan menghasilkan nilai berbeza.

Fungsi akan dinilai semula jika sebahagian formulanya berubah. Jika kami menetapkan sifat Teks bagi kawalan Label untuk formula ini, sebagai contoh, GUID yang dijana setiap kali pengguna mengubah nilai kawalan Input teks:

TextInput1.Text & " " & GUID()

Apabila digunakan dalam formula tingkah laku, GUID akan dinilai setiap kali formula tingkah laku dinilai. Untuk maklumat lanjut, lihat contoh kemudian dalam topik ini.

Sintaks

GUID( [ GUIDString ] )

GUIDString – Pilihan. Rentetan teks yang mengandungi perwakilan perenambelasan GUID. Jika tidak ada rentetan yang dibekalkan, GUID baharu akan dicipta.

GUID ( Tidak ditaip )

Tidak ditaip - Diperlukan. objek tanpa jenis yang mewakili GUID. Nilai yang boleh diterima bergantung pada penyedia tanpa jenis. Untuk JSON, objek tanpa jenis dijangka akan menjadi GUID diwakili sebagai rentetan JSON.

Contoh

Penggunaan asas

Untuk mengembalikan nilai GUID berdasarkan pada perwakilan rentetan perenambelasan:

GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )

Anda juga boleh memberikan rentetan GUID tanpa tanda sempang. Formula ini mengembalikan nilai GUID yang sama:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Digunakan dalam konteks untuk menetapkan medan Status rekod pangkalan data baharu dengan nilai yang mantap:

Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )

Anda mungkin tidak mahu menunjukkan GUID kepada pengguna anda tetapi GUID boleh membantu anda menyahpepijat aplikasi anda. Untuk menunjukkan nilai medan Status dalam rekod yang anda ciptakan dalam contoh sebelumnya, tetapkan sifat Teks bagi kawalan Label untuk formula ini:

First( Products ).Status

Kawalan Label akan menunjukkan f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Cipta jadual GUID

Tetapkan sifat OnSelect bagi kawalan Button untuk formula ini:
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Formula ini mencipta jadual lajur tunggal yang digunakan untuk mengulang lima kali, menghasilkan dalam lima GUID.
Tambah kawalan Data table, tetapkan sifat Item ke NewGUID dan tunjukkan medan Nilai.
Sambil menekan kekunci Alt, pilih butang dengan mengklik atau mengetiknya.

Jadual data menunjukkan senarai GUID:
Pilih semula butang untuk menunjukkan senarai GUID yang berbeza:

Untuk menjana GUID tunggal dan bukannya jadual, gunakan formula ini:

Set( NewGUID, GUID() )

Kongsi melalui