fungsi GUID

Berlaku untuk: Aplikasi Canvas Copilot Studio Desktop mengalir aplikasi berbasis model Fungsi Power Platform CLI Dataverse

Konversi string GUID (pengidentifikasi unik global) menjadi GUID nilai, atau buat nilai baru GUID .

KETERANGAN

GUID Gunakan fungsi untuk mengonversi string dengan representasi heksadesimal menjadi GUID nilai yang GUID dapat Anda teruskan ke database. Sistem database seperti Microsoft Dataverse dan SQL Server menggunakan GUID nilai sebagai kunci.

String dapat memiliki huruf besar atau huruf kecil, tetapi harus 32 digit heksadesimal dalam salah satu format ini:

• "123e4567-e89b-12d3-a456-426655440000"( tanda hubung di lokasi standar)
• "123e4567e89b12d3a456426655440000" (tanpa tanda hubung)

Jika Anda tidak menentukan argumen, fungsi akan membuat baru GUID.

Untuk mengonversi GUID nilai menjadi string, gunakan dalam konteks string. Nilai GUID dikonversi menjadi string heksadesimal dengan tanda hubung dan huruf kecil.

Saat menghasilkan baru GUID, fungsi menggunakan angka pseudo-random untuk membuat versi 4 IETF RFC 4122GUID. Saat mengonversi string menjadi GUID, fungsi mendukung versi apa pun GUID dengan menerima string apa pun dari 32 digit heksadesimal.

Fungsi Volatile

GUID adalah fungsi volatil ketika digunakan tanpa argumen. Setiap kali fungsi ini dievaluasi, fungsi akan menghasilkan nilai yang berbeda.

Saat Anda menggunakan fungsi volatil dalam rumus aliran data, fungsi tersebut mengembalikan nilai yang berbeda hanya jika rumus dievaluasi ulang. Jika tidak ada perubahan lain dalam rumus, rumus menyimpan nilai yang sama saat aplikasi Anda terbuka.

Misalnya, jika Anda mengatur properti Teks kontrol label ke GUID(), properti tersebut tidak berubah saat aplikasi Anda aktif. Anda mendapatkan nilai yang berbeda hanya saat menutup dan membuka kembali aplikasi.

Fungsi ini dievaluasi ulang jika merupakan bagian dari rumus di mana sesuatu yang lain berubah. Misalnya, jika Anda mengatur properti Teks kontrol Label ke rumus ini, GUID dihasilkan setiap kali pengguna mengubah nilai kontrol input Teks :

TextInput1.Text & " " & GUID()

Saat Anda menggunakan GUID dalam rumus perilaku, rumus dievaluasi setiap kali rumus dievaluasi. Untuk informasi lebih lanjut, lihat contoh nanti dalam topik ini.

Sintaks

GUID( [ GUIDString ] )

• GUIDString – Opsional. String teks yang memiliki representasi heksadesimal dari GUID. Jika Anda tidak menyediakan string, fungsi akan membuat .GUID

GUID( Dinamis )

• Dinamis – Diperlukan. Nilai dinamis yang mewakili GUID. Nilai yang dapat diterima bergantung pada penyedia yang tidak dititik. Untuk JSON, nilai dinamis diharapkan menjadi GUID yang direpresentasikan sebagai string JSON.

Contoh

Penggunaan dasar

Untuk mengembalikan GUID nilai berdasarkan representasi string heksadesimal:

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

Anda juga dapat menyediakan GUID string tanpa tanda hubung. Rumus ini mengembalikan nilai yang sama GUID :

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 kepada pengguna, tetapi GUID dapat membantu Anda men-debug aplikasi Anda. Untuk memperlihatkan nilai bidang Status dalam rekaman yang Anda buat dalam contoh sebelumnya, atur properti Teks kontrol Label ke rumus ini:

First( Products ).Status

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

Membuat tabel GUID

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

2. Tambahkan kontrol Tabel data, atur properti Item ke NewGUIDs, dan Tampilkan bidang Nilai.

3. Tahan tombol Alt dan pilih tombol .

   Tabel data menampilkan daftar GUID:

   

4. Pilih lagi tombol untuk menampilkan daftar GUID baru:

   

Untuk menghasilkan satu GUID alih-alih tabel, gunakan rumus ini:

Set( NewGUID, GUID() )