GUID funkcija

Attiecas uz: Audekla programmas Copilot Studio Desktop plūsmas Modeļa vadītas programmas Power Platform CLI Dataverse funkcijas

Konvertējiet (globāli unikālu identifikatoruGUID) virkni par GUID vērtību vai izveidojiet jaunu GUID vērtību.

Apraksts

Izmantojiet šo funkciju, GUID lai virkni ar heksadecimālo attēlojumu GUID pārvērstu par vērtību, GUID ko var nodot datu bāzei. Datu bāzu sistēmas, piemēram, Microsoft Dataverse un SQL Server, izmanto GUID vērtības kā atslēgas.

Virknē var būt lielie vai mazie burti, bet tai jābūt 32 heksadecimāliem cipariem vienā no šiem formātiem:

• "123e4567-e89b-12d3-a456-426655440000" (defises standarta atrašanās vietās)
• "123e4567e89b12d3a456426655440000" (bez defisēm)

Ja nenorādāt argumentu, funkcija izveido jaunu GUID.

Lai pārvērstu GUID vērtību par virkni, izmantojiet to virknes kontekstā. Vērtība GUID tiek konvertēta par heksadecimālu virkni ar defisēm un mazajiem burtiem.

Ģenerējot jaunu GUID, funkcija izmanto pseido-nejaušus skaitļus, lai izveidotu versiju 4 IETF RFC 4122GUID. Pārvēršot virkni par , GUIDfunkcija atbalsta jebkuru GUID versiju, akceptējot jebkuru 32 heksadecimālo ciparu virkni.

Gaistošas funkcijas

GUID ir gaistoša funkcija, ja to lieto bez argumenta. Katru reizi, kad funkcija tiek novērtēta, tā atgriež citu vērtību.

Lietojot gaistošo funkciju datu plūsmas formulā, tā atgriež citu vērtību tikai tad, ja formula tiek pārvērtēta. Ja formulā nekas cits nemainās, tā saglabā to pašu vērtību, kamēr programma ir atvērta.

Piemēram, ja iestatāt etiķetes vadīklas rekvizītu Teksts uz GUID(), tas nemainās, kamēr lietotne ir aktīva. Cita vērtība tiek iegūta tikai tad, kad aizverat un atkārtoti atverat programmu.

Funkcija tiek pārvērtēta, ja tā ir daļa no formulas, kurā mainās kaut kas cits. Piemēram, ja iestatāt vadīklas Label rekvizītu Text uz šo formulu, a GUID tiek ģenerēts katru reizi, kad lietotājs maina teksta ievades vadīklas vērtību:

TextInput1.Text & " " & GUID()

Lietojot GUIDuzvedības formulā, tā tiek novērtēta katru reizi, kad formula tiek novērtēta. Papildinformāciju skatiet piemēros tālāk šajā tēmā, sadaļā .

Sintakse

GUID( [ GUIDString ] )

• GUIDString - pēc izvēles. Teksta virkne, kuras heksadecimālais attēlojums GUIDir . Ja virkne netiek norādīta, funkcija izveido jaunu GUID.

GUID( Dinamisks )

• Dinamisks — obligāts. Dinamiskā vērtība, kas apzīmē .GUID Pieļaujamās vērtības ir atkarīgas no netipētā nodrošinātāja. JSON dinamiskā vērtība ir GUID jāattēlo kā JSON virkne.

Piemēri

Pamata lietojums

Lai atgrieztu vērtību, GUID kuras pamatā ir heksadecimālās virknes attēlojums, veiciet tālāk norādītās darbības.

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

Varat arī nodrošināt GUID virkni bez defisēm. Šī formula atgriež to pašu GUID vērtību:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Lietojot kontekstā, lai iestatītu jauna datu bāzes ieraksta lauku Statuss uz labi nostiprinātu vērtību:

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

Iespējams, nevēlaties rādīt GUID lietotājiem, taču GUID var palīdzēt atkļūdot lietotni. Lai parādītu lauka Statuss vērtību iepriekšējā piemērā izveidotajā ierakstā, iestatiet vadīklas Etiķete rekvizītu Teksts uz šo formulu:

First( Products ).Status

Etiķetes vadīkla rāda f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

GUID tabulas izveide

1. Iestatiet rekvizītu OnSelect no vadīklas Button uz šo formulu:

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

   Šī formula izveido vienas kolonnas tabulu, kas tiek izmantota, lai atkārtotu piecas reizes, rezultējoties piecos GUID.

2. Pievienojiet vadīklu Data table, iestatiet tās rekvizītu Elementi kā NewGUIDs un parādiet lauku Vērtība.

3. Turiet nospiestu taustiņu Alt un atlasiet pogu.

   Datu tabulā ir redzams GUID saraksts:

   

4. Vēlreiz atlasiet pogu, lai parādītu jaunu GUID sarakstu:

   

Lai tabulas vietā ģenerētu vienu GUID , izmantojiet šo formulu:

Set( NewGUID, GUID() )