Funcție GUID

Se aplică pentru: planșă de lucru aplicații Fluxuri desktop Aplicații bazate pe model Power Platform CLI

Convertește un șir GUID (Identificator unic global) la o valoare GUID sau creează o nouă valoare GUID.

Descriere

Folosește funcția GUID pentru a converti un șir care conține reprezentarea hexazecimală a unui GUID într-o valoare GUID care poate fi transmisă unei baze de date. Valorile GUID sunt utilizate drept chei de sisteme de baze de date, cum ar fi Microsoft Dataverse și SQL Server.

Șirul transmis poate conține litere mari sau mici, dar trebuie să aibă 32 de cifre hexazecimale în oricare dintre aceste formate:

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

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

Pentru a converti o valoare GUID într-un șir pur și simplu folosiți-o într-un context șir. Valoarea GUID va fi convertită într-o șir de reprezentare hexazecimală cu cratime și litere mici.

La generarea unui nou GUID, această funcție utilizează numere pseudo-aleatorii pentru a crea o versiune GUID 4 IETF RFC 4122. Când convertiți un șir într-un GUID, această funcție acceptă orice versiune GUID, acceptând orice șir de 32 de cifre hexazecimale.

Funcții volatile

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

Când este utilizată într-o formulă de flux de date, o funcție volatilă va returna o valoare diferită numai dacă formula în care apare este reevaluată. Dacă nu se schimbă nimic în formulă, aceasta va avea aceeași valoare pe toată durata execuției aplicației.

De exemplu, un control de etichetă pentru care proprietatea Text este setată la GUID() nu se va schimba în timp ce aplicația dvs. este activă. Doar închiderea și redeschiderea aplicației va avea ca rezultat o valoare diferită.

Funcția va fi reevaluată dacă face parte dintr-o formulă în care s-a schimbat altceva. Dacă setăm proprietatea Text a unui control Label la această formulă, de exemplu, un GUID este generat de fiecare dată când utilizatorul schimbă valoarea controlului Intrare text:

TextInput1.Text & " " & GUID()

Când este utilizat într-o formulă comportamentală, GUID va fi evaluată de fiecare dată când formula este evaluată. Pentru informații suplimentare, consultați exemplele mai târziu în acest subiect.

Sintaxă

GUID( [ GUIDString ] )

• GUIDString – Opțional. Un șir de text care conține reprezentarea hexazecimală a unui GUID. Dacă nu este furnizat niciun șir, se creează un nou GUID.

GUID( Untyped )

• Untyped - Obligatoriu. Obiect netipizat care reprezintă un GUID. Valorile acceptabile depind de furnizorul netipificat. Pentru JSON, obiectul netipizat este de așteptat să fie reprezentat GUID ca șir JSON.

Exemple

Utilizare de bază

Pentru a returna o valoare GUID bazată pe reprezentarea șirului hexazecimal:

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

Puteți furniza șirul GUID fără cratime. Această formulă returnează aceeași valoare GUID:

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 nu doriți să afișați GUID-urile utilizatorilor dvs., dar GUID-urile vă pot ajuta să depanați aplicația. Pentru a arăta valoarea câmpului Stare din înregistrarea pe care ați creat-o în exemplul anterior, setați proprietatea Text a unui control Label la această formulă:

First( Products ).Status

Controlul Label va arăta 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. +În timp ce țineți apăsată tasta Alt, selectați butonul făcând clic pe el sau apăsând pe el.

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

   

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

   

Pentru a genera un singur GUID în locul unui tabel, utilizați următoarea formulă:

Set( NewGUID, GUID() )