GUID funtzioa

Artikulua
10/16/2024

Hauei aplikatzen zaie: Canvas aplikazioak Mahaigaineko fluxuak Modeloetan oinarritutako aplikazioak Power Platform CLI

GUID (Globally Unique Identifier) katea GUID balio bihurtzen du edo GUID balio berria sortzen du.

Deskribapenak

Erabili GUID funtzioa GUID baten irudikapen hamaseitarra duen kate bat datu base batera pasatu daitekeen GUID balioa bihurtzeko. GUID balioak gako gisa erabiltzen dira datu-base sistemen bidez Microsoft Dataverse eta SQL Server.

Pasatutako kateak letra maiuskulak edo minuskulak izan ditzake, baina formatu hauetako 32 digitu hamaseitarrak izan behar ditu:

"123e4567-e89b-12d3-a456-426655440000" (marratxoak kokapen estandarretan)
"123e4567e89b12d3a456426655440000" (marratxorik gabe)

Ez baduzu argumenturik zehazten, funtzio honek GUID berria sortzen du.

GUID balioa kate bihurtzeko, besterik gabe erabili testu-kate batean. GUID balioa irudikapen kate hamaseitarra bihurtuko da marratxoz eta letra xehez.

GUID berria sortzerakoan, funtzio honek zenbaki sasi-ausazkoak erabiltzen ditu 4. bertsioa sortzeko IETF RFC 4122 GUID. Kate bat GUID batera bihurtzean, funtzio honek edozein GUID bertsio onartzen du 32 digitu hamaseitarren edozein kate onartuz.

Funtzio aldakorrak

GUID funtzio lurrunkorra da argumenturik gabe erabiltzen denean. Funtzioa ebaluatzen den bakoitzean beste balio bat itzultzen du.

Datu-fluxuaren formula batean erabiltzen denean, funtzio aldakorrak beste balio bat itzuliko du agertzen den formula berriro ebaluatzen bada. Formulan ezer aldatzen ez bada, aplikazioaren exekuzioan zehar balio bera izango du.

Adibidez, etiketa kontrol bat zeinetarako Testua propietatea finkatuta dago GUID() ez da aldatuko aplikazioa aktibatuta dagoen bitartean. Aplikazioa itxi eta berriro irekitzearekin batera, balio desberdin bat sortuko da.

Funtzioa baloratuko da beste zerbait aldatu den formula baten parte bada. Honako hau ezartzen badugu Testua kontrol baten propietatea Label kontrola, adibidez, GUID bat sortzen da erabiltzaileak balioa aldatzen duen bakoitzean Text input kontrolatzeko:

TextInput1.Testua & " " & GUID()

Portaera-formula batean erabiltzen denean, GUID funtzio aldakorrak portaeraren formula ebaluatzen den bakoitzean ebaluatuko dira. Informazio gehiago eskuratzeko, ikusi adibideak geroago gai honetan.

Sintaxia

GUID( [ GUIDString ] )

GUIDString – Aukerakoa. GUID baten irudikapen hamaseitarra duen testu-katea. Katerik hornitzen ez bada, GUID berria sortzen da.

GUID( Idatzi gabea )

Idatzi gabekoa - Beharrezkoa. motarik gabeko objektu GUID bat adierazten duena. Balio onargarriak idatzi gabeko hornitzailearen araberakoak dira. JSON-rako, idatzi gabeko objektua JSON kate gisa adierazitako GUID bat izatea espero da.

Adibideak

Oinarrizko erabilera

GUID balioa itzultzeko kate hamaseitarren irudikapenean oinarrituta:

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

GUID katea marratxorik gabe ere eman dezakezu. Formula honek GUID balio berdina itzultzen du:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Testuinguruan erabiltzen da Egoera eremua datu baseen erregistro berriaren eremua ongi finkatuta dagoen balioa du:

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

Seguruenik ez duzu erabiltzaileei GUIDak erakutsi nahi, baina GUIDek zure aplikazioa arazten lagun dezakete. Hitzaren balioa erakusteko Egoera eremuak aurreko adibidean sortu zenuen erregistroan, ezarri Testua propietate baten Label kontrola formula honetan:

First( Products ).Status

Label kontrola agertuko da f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Sortu GUID taula bat

Gehitu Button kontrola, eta ezarri horren OnSelect propietatea formula honetan:
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Formula hau zutabe bakarreko taula bat da, bost aldiz iterarazteko erabiltzen dena, eta ondorioz, bost GUIDak dira.
Gehitu a Data table kontrola, ezarri elementuak propietatea NewGUIDs eta erakutsi Balioa eremua.
Mantendu Alt tekla sakatuta eta hautatu botoia hura sakatuz edo bertan klik eginez.

Datu taulak GUIDen zerrenda erakusten du:
Hautatu berriro botoia GUIDen zerrenda desberdin bat erakusteko:

Taula baten ordez GUID bakarra sortzeko, erabili formula hau:

Set( NewGUID, GUID() )

Partekatu honen bidez: