GUID funcționa

Se aplică la: Aplicații pânză Copilot Studio Desktop fluxuri model aplicații bazate pe platforma Power Platform CLI Dataverse

Efectuați conversia unui GUID șir (identificator unic global) la o GUID valoare sau creați o valoare nouă GUID .

Descriere

Utilizați funcția GUID pentru a efectua conversia unui șir cu reprezentarea hexazecimală a unei GUID valori pe care o puteți transfera într-o GUID bază de date. Sistemele de baze de date, cum ar fi Microsoft Dataverse și SQL Server, utilizează GUID valorile ca chei.

Șirul poate avea litere mari sau mici, dar trebuie să aibă 32 cifre hexazecimale într-unul dintre aceste formate:

• „123e4567-e89b-12d3-a456-426655440000” (cratime în locații standard)
• „123e4567e89b12d3a456426655440000” (fără cratime)

Dacă nu specificați un argument, funcția creează un nou GUID.

Pentru a efectua conversia unei GUID valori într-un șir, utilizați-o într-un context de șir. Valoarea GUID se transformă într-un șir hexazecimal cu cratime și litere mici.

Atunci când generați un nou GUID, funcția utilizează numere pseudoaleatoare pentru a crea o versiune 4 IETF RFC 4122GUID. Atunci când efectuați conversia unui șir într-un GUID, funcția acceptă orice GUID versiune, acceptând orice șir de 32 de cifre hexazecimale.

Funcții volatile

GUID este o funcție volatilă atunci când este utilizată fără argument. De fiecare dată când se evaluează funcția, se returnează o valoare diferită.

Atunci când utilizați o funcție volatilă într-o formulă de flux de date, ea returnează o altă valoare doar dacă formula este reevaluată. Dacă nu se modifică nimic în formulă, păstrează aceeași valoare în timp ce aplicația este deschisă.

De exemplu, dacă setați proprietatea Text a unui control etichetă la GUID(), aceasta nu se modifică în timp ce aplicația este activă. Primiți o altă valoare doar atunci când închideți și redeschideți aplicația.

Funcția este reevaluată dacă face parte dintr-o formulă în care se modifică altceva. De exemplu, dacă setați proprietatea Text a unui control Etichetă la această formulă, este generată de GUID fiecare dată când utilizatorul modifică valoarea controlului de intrare Text :

TextInput1.Text & " & GUID()

Atunci când utilizați GUID într-o formulă de comportament, aceasta este evaluată de fiecare dată când este evaluată formula. Pentru informații suplimentare, consultați exemplele mai târziu în acest subiect.

Sintaxă

GUID( [ GUIDString ] )

• GUIDString – Opțional. Un șir text care are reprezentarea hexazecimală a unui GUID. Dacă nu furnizați un șir, funcția creează un nou GUID.

GUID( Dinamic )

• Dinamic – Obligatoriu. Valoare dinamică care reprezintă un GUID. Valorile acceptabile depind de furnizorul netipat. Pentru JSON, se așteaptă ca valoarea dinamică să fie reprezentată GUID ca șir JSON.

Exemple

Utilizare de bază

Pentru a returna o GUID valoare pe baza reprezentării șirului hexazecimal:

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

De asemenea, puteți furniza GUID șirul fără cratime. Această formulă returnează aceeași GUID valoare:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Folosit în context, pentru a seta câmpul Stare al unei noi înregistrări a bazei de date la o valoare bine stabilită:

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

Probabil că nu doriți să afișați GUID-uri utilizatorilor, dar GUID-urile vă pot ajuta să depanați aplicația. Pentru a afișa valoarea câmpului Stare din înregistrarea pe care ați creat-o în exemplul anterior, setați proprietatea Text a unui control Etichetă la această formulă:

First( Products ).Status

Controlul Etichetă afișează f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Creați un tabel de GUID-uri

1. Setați proprietatea OnSelect a unui control Button la această formulă:

   ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
   

   Această formulă creează un tabel cu o singură coloană care este folosit pentru a itera de cinci ori, rezultând cinci GUID-uri.

2. Adăugați un control Data table, setați proprietatea Elemente la NewGUIDs și arătați câmpul Valoare.

3. Țineți apăsată tasta Alt și selectați butonul.

   Tabelul de date prezintă o listă de GUID-uri:

   

4. Selectați butonul din nou pentru a afișa o nouă listă de GUID-uri:

   

Pentru a genera un singur GUID tabel în loc de tabel, utilizați această formulă:

Set( NewGUID, GUID() )