Funció GUID
S'aplica a:
Aplicacions de llenç Fluxos d'escriptori Aplicacions Power Platform basades en models CLI
Converteix una cadena GUID (identificador únic global) en un valor de GUID o crea un nou valor de GUID.
Descripció
Utilitzeu la funció GUID per convertir una cadena que conté la representació hexadecimal d'un GUID en un valor de GUID que es pot passar a una base de dades. Els sistemes de base de dades, com ara el Microsoft Dataverse i l'SQL Server, utilitzen els valors de GUID com a claus.
La cadena passada pot contenir lletres majúscules o minúscules, però ha de tenir 32 dígits hexadecimals en qualsevol d'aquests formats:
- "123e4567-e89b-12d3-a456-426655440000" (guions en ubicacions estàndard)
- "123e4567e89b12d3a456426655440000" (sense guions)
Si no especifiqueu cap argument, aquesta funció crea un GUID nou.
Per convertir un valor de GUID en una cadena, només heu d'utilitzar-lo en un context de cadena. El valor de GUID es convertirà en una cadena de representació hexadecimal amb guions i lletres en minúscules.
Quan es genera un nou GUID, aquesta funció utilitza números pseudo-aleatoris per crear una versió 4 del GUID IETF RFC 4122. Quan es converteix una cadena en un GUID, aquesta funció admet qualsevol versió del GUID, ja que accepta qualsevol cadena de 32 dígits hexadecimals.
Funcions volàtils
GUID és una funció volàtil que s'utilitza sense argument. Cada vegada que s'avalua la funció, torna un valor diferent.
Quan s'utilitza en una fórmula de flux de dades, una funció volàtil retornarà un valor diferent només si la fórmula en què apareix es torna a avaluar. Si no es canvia res més a la fórmula, tindrà el mateix valor durant l'execució de l'aplicació.
Per exemple, un control d'etiqueta per al qual la propietat Text està definida com a GUID() no canviarà mentre l'aplicació estigui activa. Només s'obtindrà un valor diferent si es tanca l'aplicació i es torna a obrir.
La funció es tornarà a avalua si forma part d'una fórmula on s'ha canviat una altra cosa. Si definim la propietat Text d'un control Etiqueta a aquesta fórmula, per exemple, un GUID es genera cada vegada que l'usuari canviï el valor del control Entrada de text:
TextInput1.Text & " " & GUID()
Quan s'utilitza en una fórmula de comportament, el GUID s'avaluarà cada vegada que s'avaluï la fórmula. Per obtenir més informació, vegeu els exemples que trobareu més endavant en aquest tema.
Sintaxi
GUID([GUIDString])
- GUIDString: opcional. Cadena de text que conté la representació hexadecimal d'un GUID. Si no es proporciona cap cadena, es crea un nou GUID.
GUID( sense tipus )
- Sense tipus: obligatori. Objecte sense tipus que representa un GUID. Els valors acceptables depenen del proveïdor sense tipus. Per a JSON, s'espera que l'objecte sense tipus estigui representat en GUID com a cadena JSON.
Exemples
Ús bàsic
Per retornar un valor de GUID basat en la representació de la cadena hexadecimal:
GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )
També podeu proporcionar la cadena GUID sense guions. Aquesta fórmula torna el mateix valor de GUID:
GUID( "0f8fad5bd9cb469fa16570867728950e" )
S'utilitza en el context, per definir el camp Estat d'un registre de base de dades nou en un valor ben definit:
Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )
Segurament no voleu que es mostrin els GUID als usuaris, però els GUID us poden ajudar a depurar l'aplicació. Per mostrar el valor del camp Estat al registre que heu creat en l'exemple anterior, definiu la propietat Text d'un control Etiqueta en aquesta fórmula:
First( Products ).Status
El control Etiqueta mostrarà f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.
Crear una taula de GUID
Definiu la propietat OnSelect d'un control Botó a aquesta fórmula:
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )Aquesta fórmula crea una taula d'una sola columna que s'utilitza per iterar cinc vegades i que resulta en cinc GUID.
Afegiu un control Taula de dades, definiu-ne la propietat Items com a NewGUIDs i mostreu el camp Valor.
Mentre manteniu premuda la tecla Alt, seleccioneu el botó fent-hi clic o tocant-lo.
La taula de dades mostra una llista de GUID:
Torneu a seleccionar el botó per mostrar una llista diferent de GUID:
Per generar un sol GUID en comptes d'una taula, utilitzeu aquesta fórmula:
Set( NewGUID, GUID() )