Función de GUID

Aplícase a: Aplicacións de lona Desktop flúe aplicacións Power Platform impulsadas por modelo CLI

Converte unha cadea GUID ( Identificador único global) nun valor GUID ou crea un novo valor GUID.

Descripción

Use a función GUID para converter unha cadea que conteña a representación hexadecimal dun GUID nun valor GUID que se poida pasar a unha base de datos. Os valores GUID son usados como claves por sistemas de bases de datos como Microsoft Dataverse e SQL Server.

A cadea pasada pode conter letras maiúsculas ou minúsculas, pero debe ter 32 díxitos hexadecimais en algún destes destes formatos:

• "123e4567-e89b-12d3-a456-426655440000" (guións en localizacións estándar)
• "123e4567e89b12d3a456426655440000" (sen guións)

Se non especifica un argumento, esta función crea un novo GUID.

Para converter un valor GUID nunha cadea, simplemente úseo nun contexto de cadea. O valor GUID converterase nunha cadea de representación hexadecimal con guións e letras en minúscula.

Cando se xera un novo GUID, esta función usa números pseudo-aleatorios para crear un GUID versión 4 IETF RFC 4122. Ao converter unha cadea nun GUID, esta función admite calquera versión de GUID ao aceptar calquera cadea de 32 díxitos hexadecimais.

Funcións volátiles

GUID é unha función volátil cando se usa sen argumento. Cada vez que se avalía a función, devólvese un valor diferente.

Cando se usa nunha fórmula de fluxo de datos, unha función volátil devolverá un valor diferente só se se reevalúa a fórmula na que aparece. Se nada cambia na fórmula, terá o mesmo valor durante toda a execución da súa aplicación.

Por exemplo, un control de etiqueta para o que a propiedade Texto estea definida en GUID() non cambiará mentres a aplicación estea activa. Só o peche e a reapertura da aplicación darán lugar a un valor diferente.

A función reevaluarase se forma parte dunha fórmula na que algo máis cambiou. Se fixamos a propiedade Texto dun control de Etiqueta nesta fórmula, por exemplo, xérase un GUID cada vez que o usuario cambia o valor do control de Entrada de texto:

TextInput1.Text & " " & GUID()

Cando se usa nunha fórmula de comportamento, GUID avaliarase cada vez que se avalíe a fórmula. Para obter máis información, consulte os exemplos máis adiante neste tema.

Sintaxe

GUID( [ GUIDString ] )

• GUIDString – Opcional. Cadea de texto que contén a representación hexadecimal dun GUID. Se non se proporciona ningunha cadea, créase un novo GUID.

GUID( Untyped )

• Untyped - Obrigatorio. Obxecto sen escribir que representa unha GUID. Os valores aceptables dependen do provedor non tipificado. Para JSON, espérase que o obxecto sen escribir estea representado como GUID como unha cadea JSON.

Exemplos

Uso básico

Para devolver un valor GUID baseado na representación da cadea hexadecimal:

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

Tamén pode fornecer a cadea GUID sen guións. Esta fórmula devolve o mesmo valor GUID:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Emprégase en contexto, para configurar o campo Estado dun novo rexistro de base de datos cun valor ben establecido:

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

Probablemente non queira mostrar os GUID aos seus usuarios, pero os GUID poden axudarlle a depurar a súa aplicación. Para amosar o valor do campo Estado no rexistro que creou no exemplo anterior, estableza a propiedade Texto dun control de Etiqueta nesta fórmula:

First( Products ).Status

O control de Etiqueta amosará f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Crear unha táboa de GUID

1. Axuste a propiedade OnSelect dun control de botón nesta fórmula:

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

   Esta fórmula crea unha táboa dunha única columna que se usa para repetir cinco veces, obtendo cinco GUID.

2. Engada un control de Táboa de datos, estableza a súa propiedade Elementos en NewGUIDs e mostra o campo Valor.

3. Mantendo premida a tecla Alt, seleccione o botón facendo clic ou tocándoo.

   A táboa de datos mostra unha lista de GUID:

   

4. Seleccione de novo o botón para mostrar unha lista diferente de GUID:

   

Para xerar un único GUID en lugar dunha táboa, use esta fórmula:

Set( NewGUID, GUID() )