GUID-functie
Van toepassing op:
Canvas-apps Bureaubladstromen Modelgestuurde apps Power Platform CLI
Hiermee wordt een GUID-tekenreeks (Globally Unique Identifier) naar een GUID-waarde geconverteerd of wordt een nieuwe GUID-waarde gemaakt.
Beschrijving
Gebruik de functie GUID om een tekenreeks die de hexadecimale waarde van een GUID bevat te converteren naar een GUID-waarde die kan worden doorgegeven aan een database. GUID-waarden worden door databasesystemen zoals Microsoft Dataverse en SQL Server gebruikt als sleutels.
De doorgegeven tekenreeks mag bestaan uit hoofdletters of kleine letters, maar moet 32 hexadecimale cijfers bevatten in een van deze indelingen:
- "123e4567-e89b-12d3-a456-426655440000" (koppeltekens op standaardlocaties)
- "123e4567e89b12d3a456426655440000" (geen streepjes)
Als u geen argument opgeeft, maakt deze functie een nieuwe GUID.
Als u een GUID-waarde wilt converteren naar een tekenreeks, gebruikt u deze eenvoudig in de context van een tekenreeks. De GUID-waarde wordt geconverteerd naar een hexadecimale weergavetekenreeks met afbreekstreepjes en kleine letters.
Bij het genereren van een nieuwe GUID gebruikt deze functie pseudo-willekeurige getallen om een GUID versie 4 IETF RFC 4122 te maken. Bij het converteren van een tekenreeks naar een GUID ondersteunt deze functie elke GUID-versie door elke tekenreeks van 32 hexadecimale cijfers te accepteren.
Vluchtige functies
GUID is een vluchtige functie wanneer deze zonder argument wordt gebruikt. Telkens wanneer de functie wordt geëvalueerd, retourneert deze een andere waarde.
Wanneer een vluchtige functie in een gegevensstroomformule wordt gebruikt, retourneert deze alleen een andere waarde als de formule waarin deze wordt weergegeven, opnieuw wordt geëvalueerd. Als er niets anders verandert in de formule, heeft deze dezelfde waarde gedurende de uitvoering van uw app.
Een besturingselement Label waarvoor bijvoorbeeld de eigenschap Text is ingesteld op GUID(), verandert niet wanneer uw app actief is. Alleen het sluiten en opnieuw openen van de app leidt tot een andere waarde.
De functie wordt opnieuw geëvalueerd als deze deel uitmaakt van een formule waarin iets anders is gewijzigd. Als we de eigenschap Text van een besturingselement Label bijvoorbeeld instellen op deze formule, wordt steeds een GUID gegenereerd wanneer de gebruiker de waarde van het besturingselement Text input wijzigt:
TextInput1.Text & " " & GUID()
Wanneer de functie wordt gebruikt in een gedragsformule, wordt GUID steeds geëvalueerd als de formule wordt geëvalueerd. Zie de voorbeelden verderop in dit onderwerp voor meer informatie.
Syntaxis
GUID( [ GUIDString ] )
- GUIDString: optioneel. Een tekenreeks die de hexadecimale waarde van een GUID bevat. Als er geen tekenreeks is opgegeven, wordt een nieuwe GUID gemaakt.
GUID( Untyped )
- Untyped: vereist. Niet-getypeerd object dat voor een GUID staat. Aanvaardbare waarden zijn afhankelijk van de niet-getypeerde provider. Voor JSON wordt verwacht dat het niet-getypeerde object GUID weergegeven als een JSON-tekenreeks is.
Voorbeelden
Basisgebruik
Een GUID-waarde retourneren op basis van de hexadecimale tekenreeksweergave:
GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )
U kunt de GUID-tekenreeks ook zonder afbreekstreepjes opgeven. Deze formule retourneert de dezelfde GUID-waarde:
GUID( "0f8fad5bd9cb469fa16570867728950e" )
Voor gebruik in context stelt u het veld Status van een nieuwe databaserecord in op een gevestigde waarde:
Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )
U wilt GUID’s waarschijnlijk niet tonen aan uw gebruikers, maar GUID's kunnen u helpen fouten in uw app op te sporen. Als u de waarde van het veld Status wilt weergeven in de record die u hebt gemaakt in het vorige voorbeeld, stelt u de eigenschap Text van een besturingselement Label in op deze formule:
First( Products ).Status
Het besturingselement Label zal f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4 weergeven.
Een tabel met GUID’s maken
Stel de eigenschap OnSelect van een besturingselement Button in op deze formule:
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )Deze formule maakt een tabel met één kolom die wordt gebruikt om vijf keer te herhalen, wat resulteert in vijf GUID’s.
Voeg een besturingselement Data table toe, stel de eigenschap Items in op NewGUIDs en geef het veld Waarde weer.
Houd de Alt-toets ingedrukt en selecteer de knop door erop te klikken of te tikken.
De gegevenstabel geeft een overzicht van GUID's weer:
Selecteer de knop opnieuw om een andere lijst met GUID’s weer te geven:
Als u een enkele GUID wilt genereren in plaats van een tabel, gebruikt u deze formule:
Set( NewGUID, GUID() )