GUID Fungsi

Terpakai kepada: Apl kanvas Aliran Desktop Copilot Studio Apl dipacu model Power Platform CLI Fungsi Dataverse

Tukar GUID rentetan (pengecam unik global) kepada GUID nilai atau cipta nilai baharu GUID .

Penerangan

Gunakan GUID fungsi untuk menukar rentetan dengan perwakilan heksadesimal a GUID kepada GUID nilai yang boleh anda hantar ke pangkalan data. Sistem pangkalan data seperti Microsoft Dataverse dan SQL Server menggunakan GUID nilai sebagai kunci.

Rentetan boleh mempunyai huruf besar atau huruf kecil, tetapi ia mestilah 32 digit heksadesimal dalam salah satu format ini:

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

Jika anda tidak menentukan hujah, fungsi GUIDmencipta .

Untuk menukar GUID nilai kepada rentetan, gunakannya dalam konteks rentetan. Nilai bertukar GUID kepada rentetan heksadesimal dengan tanda sempang dan huruf kecil.

Apabila menjana baharu GUID, fungsi ini menggunakan nombor pseudo-rawak untuk mencipta versi 4 IETF RFC 4122GUID. Apabila menukar rentetan kepada GUID, fungsi ini menyokong mana-mana GUID versi dengan menerima mana-mana rentetan 32 digit heksadesimal.

Fungsi Meruap

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

Apabila anda menggunakan fungsi tidak menentu dalam formula aliran data, ia mengembalikan nilai yang berbeza hanya jika formula dinilai semula. Jika tiada perubahan lain dalam formula, ia mengekalkan nilai yang sama semasa apl anda dibuka.

Contohnya, jika anda mengesetkan sifat Teks kawalan label kepada GUID(), ia tidak berubah semasa apl anda aktif. Anda mendapat nilai yang berbeza hanya apabila anda menutup dan membuka semula apl.

Fungsi ini dinilai semula jika ia adalah sebahagian daripada formula di mana sesuatu yang lain berubah. Contohnya, jika anda mengesetkan sifat Teks kawalan Label kepada formula ini, a GUID dijana setiap kali pengguna mengubah nilai kawalan input Teks :

TeksInput1.Teks & " " & GUID()

Apabila anda menggunakan GUIDdalam formula tingkah laku, ia dinilai setiap kali formula dinilai. Untuk maklumat lanjut, lihat contoh kemudian dalam topik ini.

Sintaks

GUID( [ GUIDString ] )

• GUIDString – Pilihan. Rentetan teks yang mempunyai perwakilan heksadesimal .GUID Jika anda tidak membekalkan rentetan, fungsi ini mencipta GUID.

GUID( Dinamik )

• Dinamik – Diperlukan. Nilai dinamik yang mewakili GUID. Nilai yang boleh diterima bergantung pada pembekal yang tidak ditaip. Untuk JSON, nilai dinamik dijangka diwakili GUID sebagai rentetan JSON.

Contoh

Penggunaan asas

Untuk mengembalikan GUID nilai berdasarkan perwakilan rentetan heksadesimal:

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

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

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, tetapi GUID boleh membantu anda menyahpepijat apl anda. Untuk menunjukkan nilai medan Status dalam rekod yang anda cipta dalam contoh sebelumnya, setkan sifat Teks kawalan Label kepada formula ini:

First( Products ).Status

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

Cipta jadual GUID

1. 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.

2. Tambah kawalan Data table, tetapkan sifat Item ke NewGUID dan tunjukkan medan Nilai.

3. Tahan kekunci Alt dan pilih butang.

   Jadual data menunjukkan senarai GUID:

   

4. Pilih butang sekali lagi untuk menunjukkan senarai GUID baharu:

   

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

Set( NewGUID, GUID() )