GUID-funksjon

Artikkel
03/22/2024

Gjelder: Lerretsapper Skrivebordsflyt Modelldrevne apper Power Platform CLI

Konverterer en GUID-streng (Globally Unique Identifier) til en GUID-verdi, eller oppretter en ny GUID-verdi.

Beskrivelse

Bruk GUID-funksjonen til å konvertere en streng som inneholder den heksadesimale representasjonen av en GUID i en GUID-verdi, som kan sendes til en database. GUID-verdier brukes som nøkler av databasesystemer, for eksempel Microsoft Dataverse og SQL Server.

Strengen som sendes, kan inneholde små eller store bokstaver, men i disse formatene må den inneholde 32 heksadesimale tegn:

"123e4567-e89b-12d3-a456-426655440000" (bindestreker på standardsteder)
"123e4567e89b12d3a456426655440000" (ingen bindestreker)

Hvis du ikke angir et argument, oppretter denne funksjonen en ny GUID.

Hvis du vil konvertere en GUID-verdi til en streng, bruker du den bare i en strengkontekst. GUID-verdien konverteres til en heksadesimal representasjonsstreng med bindestreker og små bokstaver.

Når du genererer en ny GUID, bruker denne funksjonen pseudo-tilfeldige tall til å opprette en versjon 4 IETF RFC 4122-GUID. Når du konverterer en streng til en GUID, støtter denne funksjonen alle GUID-versjoner ved å godta alle strenger på 32 heksadesimale sifre.

Flyktige funksjoner

GUID er en flyktig funksjon når den brukes sammen med et argument. Hver gang en av disse funksjonene evalueres returnerer den en annen verdi.

En flyktig funksjon returnerer en annen verdi når den brukes i en formel for dataflyt, bare hvis formelen den viser, ser ut til å være evaluert på nytt. Hvis ingenting annet endres i formelen, vil den ha samme verdi i hele kjøringen av appen.

En etikettkontroll der Text-egenskapen er angitt til for eksempel GUID(), endrer ikke mens appen din er aktiv. Å bare lukke og åpne appen vil resultere i en forskjellig verdi.

Funksjonen vil evalueres på nytt hvis den er en del av en formel der noe annet er endret. Hvis vi angir Text-egenskapen for en Label til denne formelen, genereres for eksempel en GUID hver gang brukeren endrer verdien til Text input-kontrollen:

TextInput1.Text & " " & GUID()

Når den brukes i en virkemåteformel blir GUID evaluert hver gang formelen evalueres. Hvis du vil ha mer informasjon, ser du eksemplene senere i dette emnet.

Syntaks

GUID( [ GUIDString ] )

GUIDString – valgfritt. En tekststreng som inneholder den heksadesimale representasjonen av en GUID. Hvis ingen streng angis, opprettes det en ny GUID.

GUID( Untyped )

Untyped - v. Objekt uten type som representerer en GUID. Godkjente verdier er avhengig av leverandøren uten type. For JSON forventes det at objekt uten type skal være GUID representert som en JSON-streng.

Eksempler

Grunnleggende bruk

Hvis du vil returnere en GUID-verdi basert på den heksadesimale strengrepresentasjonen:

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

Du kan også oppgi GUID-verdi uten bindestreker. Denne formelen returnerer den samme GUID-verdien:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Brukes i kontekst til å angi Status-feltet i en ny databasepost til en godt etablert verdi:

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

Du ønsker sikkert ikke å vise GUID-verdiene til brukerne, men GUID-verdiene kan hjelpe deg med å feilsøke appen. Hvis du vil vise verdien til Status-feltet i posten du opprettet i forrige eksempel, angir du Text-egenskapen for en Label til denne formelen:

First( Products ).Status

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

Opprett en tabell med GUID-verdier

Angi OnSelect-egenskapen til Button-kontrollen som denne formelen:
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Denne formelen oppretter én kolonnetabell som brukes til å oppdatere fem ganger, noe som resulterer i fem GUID-verdier.
Legg til en Data table, angi Items-egenskapen til NewGUIDs, og vis deretter Verdi-feltet.
Velg knappen ved å klikke eller trykke på den mens du holder nede ALT.

Datatabellen viser en liste over GUID-verdiene:
Velg knappen igjen for å vise en annen liste med GUID-verdier:

Hvis du vil generere en enkelt GUID-verdi i stedet for en tabell, bruker du denne formelen:

Set( NewGUID, GUID() )

Del via