GUID fonksiyon

Şunlar için geçerlidir: Tuval uygulamaları Copilot Studio Desktop akışları Model temelli uygulamalar Power Platform CLI Dataverse işlevleri

Bir GUID (genel olarak benzersiz tanımlayıcı) dizesini bir GUID değere dönüştürün veya yeni GUID bir değer oluşturun.

Açıklama

GUID onaltılık gösterimine GUID sahip bir dizeyi veritabanına geçirebileceğiniz bir GUID değere dönüştürmek için işlevini kullanın. Microsoft Dataverse ve SQL Server gibi veritabanı sistemleri değerleri anahtar olarak kullanır GUID .

Dizenin büyük veya küçük harfleri olabilir, ancak şu biçimlerden birinde 32 onaltılık basamak olmalıdır:

• "123e4567-e89b-12d3-a456-426655440000"( standart konumlardaki kısa çizgiler)
• "123E4567E89B12D3A456426655440000" (tire yok)

Bağımsız değişken belirtmezseniz işlev yeni GUIDbir oluşturur.

Bir değeri dizeye GUID dönüştürmek için dize bağlamında kullanın. GUID Değer, kısa çizgili ve küçük harfli onaltılık bir dizeye dönüştürülür.

yeni GUIDbir oluştururken işlev, sürüm 4 IETF RFC 4122GUID oluşturmak için sahte rastgele sayılar kullanır. Bir dizeyi öğesine GUIDdönüştürürken işlev, 32 onaltılık basamak içeren herhangi bir dizeyi kabul ederek herhangi bir sürümü destekler GUID .

Geçici işlevler

GUID bağımsız değişken olmadan kullanıldığında geçici bir işlevdir. İşlev her değerlendirildiğinde farklı bir değer döndürür.

Veri akışı formülünde geçici bir işlev kullandığınızda, yalnızca formül yeniden değerlendirilirse farklı bir değer döndürür. Formülde başka hiçbir değişiklik olmazsa, uygulamanız açıkken aynı değeri korur.

Örneğin, bir etiket denetiminin GUIDText özelliğini () olarak ayarlarsanız, uygulamanız etkinken değişmez. Yalnızca uygulamayı kapatıp yeniden açtığınızda farklı bir değer alırsınız.

İşlev, başka bir şeyin değiştiği bir formülün parçasıysa yeniden değerlendirilir. Örneğin, etiket denetiminin Text özelliğini bu formül olarak ayarlarsanız, kullanıcı Metin girişi denetiminin değerini her değiştirişinde bir GUID oluşturulur:

TextInput1.Text & " " & GUID()

Davranış formülünde kullandığınızdaGUID, formül her değerlendirildiğinde değerlendirilir. Daha fazla bilgi için bu konunun ilerleyen bölümlerindeki örneklere bakın.

Sözdizimi

GUID( [ GUIDString ] )

• GUIDString – İsteğe bağlı. onaltılık gösterimine sahip bir GUIDmetin dizesi. Dize sağlamazsanız işlev yeni GUIDbir oluşturur.

GUID( Dinamik )

• Dinamik – Gerekli. Bir öğesini temsil GUIDeden dinamik değer. Kabul edilebilir değerler, yazılmamış sağlayıcıya bağlıdır. JSON için dinamik değerin JSON dizesi olarak temsil edilmesi beklenirGUID.

Örnekler

Temel kullanım

Onaltılık dize gösterimine dayalı bir GUID değer döndürmek için:

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

Dizeyi GUID kısa çizgi olmadan da sağlayabilirsiniz. Bu formül aynı GUID değeri döndürür:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Yeni bir veritabanı kaydının Status alanını iyi bilinen bir değere ayarlamak için bağlam içinde kullanılır:

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

Büyük olasılıkla GUID'leri kullanıcılara göstermek istemezsiniz, ancak GUID'ler uygulamanızda hata ayıklamanıza yardımcı olabilir. Önceki örnekte oluşturduğunuz kayıtta Durum alanının değerini göstermek için Etiket denetiminin Text özelliğini şu formül olarak ayarlayın:

First( Products ).Status

Etiket denetimi f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4 değerini gösterir.

GUID tablosu oluşturma

1. Bir Button denetiminin OnSelect özelliğini şu formül olarak ayarlayın:

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

   Bu formül, beş kez yinelemek için kullanılan ve sonuçta beş GUID veren tek sütunlu bir tablo oluşturur.

2. Bir Data table denetimi ekleyin, denetimin Items özelliğini NewGUIDs olarak ayarlayın ve Value alanını gösterin.

3. Alt tuşunu basılı tutun ve düğmeyi seçin.

   Veri tablosu GUID'lerin listesini gösterir:

   

4. Yeni GUID listesini göstermek için düğmeyi yeniden seçin:

   

Tablo yerine tek GUID bir formül oluşturmak için şu formülü kullanın:

Set( NewGUID, GUID() )