Del via


GUID-funktion

Gælder for: Lærredapps Skrivebordsflow Modelbaserede apps Power Platform CLI

Konverterer en GUID-streng (Globally Unique Identifier) til en GUID-værdi eller opretter en ny GUID-værdi.

Beskrivelse

Brug funktionen GUID til at konvertere en streng, der indeholder den hexadecimale gengivelse af et GUID til en GUID-værdi, der kan overføres til en database. GUID-værdier bruges som nøgler af databasesystemer, f.eks. Microsoft Dataverse og SQL Server.

Den overførte streng kan indeholde store eller små bogstaver, men den skal være 32 hexadecimale cifre og have et af følgende formater:

  • "123e4567-e89b-12d3-a456-426655440000" (bindestreger på standardplaceringer)
  • "123e4567e89b12d3a456426655440000" (ingen bindestreger)

Hvis du ikke angiver et argument, opretter denne funktion et nyt GUID.

Hvis du vil konvertere en GUID-værdi til en streng, skal du blot bruge den i en strengkontekst. GUID-værdien konverteres til en streng, der indeholder en hexadecimal gengivelse af værdien med bindestreger og små bogstaver.

Når du opretter et nyt GUID, bruger denne funktion pseudo-tilfældige tal til at oprette version 4 IETF RFC 4122GUID. Når en streng konverteres til et GUID, understøtter denne funktion alle GUID-versioner ved at acceptere en streng på 32 hexadecimalcifre.

Flygtige funktioner

GUID er en flygtig funktion, når den bruges uden et argument. Hver gang funktionen evalueres, returnerer den en anden værdi.

Når en flygtig funktion bruges i en dataflowformel, returneres der kun en anden værdi, hvis den formel, som den bruges i, evalueres igen. Hvis intet andet ændres i formlen, har den samme værdi under hele udførelsen af din app.

Et Label-kontrolelementet, hvor egenskaben Text er indstillet til GUID(), ændres ikke, mens din app er aktiv. Der vises først en anden værdi, når du lukker og åbner appen igen.

Funktionen evalueres igen, hvis den er del af en formel, hvor der er blevet ændret noget andet. Hvis vi f.eks. angiver egenskaben Text af et Label-kontrolelement til denne formel, oprettes der et GUID, hver gang brugeren ændrer værdien for kontrolelementet Text input:

TextInput1.Text & " " & GUID()

Når GUID bruges i en formel for funktionsmåde, evalueres den, hver gang formlen evalueres. Se eksemplerne senere i dette emne for at få flere oplysninger.

Syntaks

GUID( [ GUIDString ] )

  • GUIDString – Valgfrit. En tekststreng, der indeholder den hexadecimale gengivelse af et GUID. Hvis strengen ikke er angivet, oprettes der et nyt GUID.

GUID ( Ikke indtastet )

  • Ikke indtastet - Påkrævet. objekt uden type , der repræsenterer et GUID. Acceptable værdier afhænger af udbyderen af objektet uden type. For JSON forventes objektet uden type at være GUID repræsenteret som en JSON-streng.

Eksempler

Grundlæggende brug

Returnere en GUID-værdi, der er baseret på den hexadecimale strengrepræsentation:

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

Du kan også angive GUID-strengen uden bindestreger. Denne formel returnerer den samme GUID-værdi:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Bruges i kontekst til at angive feltet Status for en ny databasepost til en veletableret værdi:

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

Du vil sandsynligvis ikke have, at GUID'er er synlige for dine brugere, men GUID'er kan hjælpe dig med fejlfinde din app. Hvis du vil have vist værdien af feltet Status i den post, du oprettede i det forrige eksempel, skal du indstille egenskaben Text for kontrolelementet Label til denne formel:

First( Products ).Status

Kontrolelementet Label viser f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Opret en tabel over GUID'er

  1. Indstil egenskaben OnSelect for et Button-kontrolelement til denne formel:

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

    Med denne formel oprettes der en tabel med én kolonne, som bruges til fem gentagelser, hvilket resulterer i fem GUID'er.

  2. Tilføj et Data table-kontrolelement, indstil dets Items-egenskab til NewGUIDs, og vis feltet Value.

  3. Vælg knappen ved at klikke eller trykke på den, mens du holder Alt-tasten nede.

    Datatabellen viser en liste over GUID'er:

    Et skærmbillede, der viser en datatabel med fem forskellige GUID-værdier.

  4. Vælg knappen igen for at få vist en anden liste over GUID'er:

    Det samme skærmbillede, der viser en datatabel med et nyt sæt med fem forskellige GUID-værdier.

Hvis du vil generere et enkelt GUID i stedet for en tabel, kan du bruge denne formel:

Set( NewGUID, GUID() )