GUID Função

Aplica-se a: Aplicativos do Canvas Fluxos do Copilot Studio Desktop Aplicativos orientados por modelos Funções do Power Platform CLI Dataverse

Converter uma GUID cadeia de caracteres (identificador global exclusivo) em um GUID valor ou criar um novo GUID valor.

Descrição

Use a GUID função para converter uma cadeia de caracteres com a representação hexadecimal de a GUID em um GUID valor que você pode passar para um banco de dados. Sistemas de banco de dados como Microsoft Dataverse e SQL Server usam GUID valores como chaves.

A cadeia de caracteres pode ter letras maiúsculas ou minúsculas, mas deve ter 32 dígitos hexadecimais em um destes formatos:

• "123e4567-e89b-12d3-a456-426655440000"( hífenes em locais padrão)
• "123e4567e89b12d3a456426655440000" (sem hífenes)

Se você não especificar um argumento, a função criará um novo GUID.

Para converter um GUID valor em uma cadeia de caracteres, use-o em um contexto de cadeia de caracteres. O GUID valor é convertido em uma cadeia hexadecimal com letras hífenes e minúsculas.

Ao gerar um novo GUID, a função usa números pseudoaleatórios para criar uma versão 4 IETF RFC 4122GUID. Ao converter uma cadeia de caracteres em um GUID, a função suporta qualquer GUID versão, aceitando qualquer cadeia de 32 dígitos hexadecimais.

Funções voláteis

GUID é uma função volátil quando usada sem um argumento. Sempre que a função é avaliada, devolve um valor diferente.

Quando você usa uma função volátil em uma fórmula de fluxo de dados, ela retorna um valor diferente somente se a fórmula for reavaliada. Se nada mais mudar na fórmula, ela manterá o mesmo valor enquanto seu aplicativo estiver aberto.

Por exemplo, se você definir a propriedade Text de um controle de rótulo como GUID(), ela não será alterada enquanto seu aplicativo estiver ativo. Você obtém um valor diferente somente quando fecha e reabre o aplicativo.

A função é reavaliada se faz parte de uma fórmula onde algo mais muda. Por exemplo, se você definir a propriedade Text de um controle Label para essa fórmula, um GUID será gerado sempre que o usuário alterar o valor do controle de entrada Text :

TextInput1.Text & " " & GUID()

Quando você usa GUID uma fórmula de comportamento, ela é avaliada cada vez que a fórmula é avaliada. Para obter mais informações, veja os exemplos apresentados neste tópico.

Sintaxe

GUID( [ GUIDString ] )

• GUIDString – Opcional. Uma cadeia de caracteres de texto que tem a representação hexadecimal de um GUIDarquivo . Se você não fornecer uma cadeia de caracteres, a função criará um novo GUIDarquivo .

GUID( Dinâmico )

• Dinâmico – Obrigatório. Valor dinâmico que representa um GUIDarquivo . Os valores aceitáveis dependem do provedor não tipado. Para JSON, espera-se que o valor dinâmico seja representado GUID como uma cadeia de caracteres JSON.

Exemplos

Utilização básica

Para retornar um GUID valor com base na representação de cadeia hexadecimal:

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

Você também pode fornecer a GUID cadeia de caracteres sem hífenes. Esta fórmula devolve o mesmo GUID valor:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Utilizada no contexto, para definir o campo Status de um novo registo de base de dados para um valor corretamente estabelecido:

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

Você provavelmente não quer mostrar GUIDs aos usuários, mas os GUIDs podem ajudá-lo a depurar seu aplicativo. Para mostrar o valor do campo Status no registro criado no exemplo anterior, defina a propriedade Text de um controle Label para esta fórmula:

First( Products ).Status

O controle Label mostra f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Criar uma tabela de GUIDs

1. Defina a propriedade OnSelect de um controlo Button para esta fórmula:

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

   Esta fórmula cria uma tabela com uma única coluna que é utilizada para iterar cinco vezes, o que resulta em cinco GUIDs.

2. Adicione um controlo Data table, defina a respetiva propriedade Items para NewGUIDs e apresente o campo Value.

3. Mantenha pressionada a tecla Alt e selecione o botão.

   A tabela de dados apresenta uma lista de GUIDs:

   

4. Selecione o botão novamente para mostrar uma nova lista de GUIDs:

   

Para gerar uma única GUID tabela em vez de uma tabela, use esta fórmula:

Set( NewGUID, GUID() )