GUID دالة

ينطبق على: تعمل تطبيقات Canvas Copilot Studio Desktop على تدفقات التطبيقات المستندة إلى النموذج لوظائف Power Platform CLI Dataverse

تحويل سلسلة GUID (معرف فريد عمومي) إلى GUID قيمة، أو إنشاء قيمة جديدة GUID .

‏‏الوصف

استخدم الدالة GUID لتحويل سلسلة بتمثيل GUID سداسي عشري ل إلى GUID قيمة يمكنك تمريرها إلى قاعدة بيانات. تستخدم GUID أنظمة قواعد البيانات مثل Microsoft Dataverse وSQL Server القيم كمفاتيح.

يمكن أن تحتوي السلسلة على أحرف كبيرة أو صغيرة، ولكن يجب أن تكون 32 رقما سداسيا عشريا بأحد هذه التنسيقات:

• "123e4567-e89b-12d3-a456-426655440000"( واصلات في المواقع القياسية)
• "123e4567e89b12d3a456426655440000"( بدون واصلات)

إذا لم تحدد وسيطة، تنشئ الدالة وسيطة جديدة GUID.

لتحويل GUID قيمة إلى سلسلة، استخدمها في سياق سلسلة. GUID تتحول القيمة إلى سلسلة سداسية عشرية مع واصلات وأحرف صغيرة.

عند إنشاء جديد GUID، تستخدم الدالة أرقاما عشوائية غير صحيحة لإنشاء إصدار 4 IETF RFC 4122GUID. عند تحويل سلسلة إلى GUID، تدعم الدالة أي GUID إصدار عن طريق قبول أي سلسلة مكونة من 32 رقما سداسيا عشريا.

وظائف متغيرة

GUID هي دالة متقلبة عند استخدامها دون وسيطة. في كل مرة يتم تقييم الوظيفة ، فإنها ترجع قيمة مختلفة.

عند استخدام دالة متقلبة في صيغة تدفق البيانات، فإنها ترجع قيمة مختلفة فقط إذا تمت إعادة تقييم الصيغة. إذا لم يتغير أي شيء آخر في الصيغة، فإنه يحتفظ بنفس القيمة أثناء فتح التطبيق.

على سبيل المثال، إذا قمت بتعيين الخاصية Text لعنصر تحكم التسمية إلى GUID()، فلن تتغير أثناء تنشيط تطبيقك. تحصل على قيمة مختلفة فقط عند إغلاق التطبيق وإعادة فتحه.

تتم إعادة تقييم الدالة إذا كانت جزءا من صيغة يتغير فيها شيء آخر. على سبيل المثال، إذا قمت بتعيين الخاصية Text لعنصر تحكم Label إلى هذه الصيغة، يتم إنشاء في GUID كل مرة يغير فيها المستخدم قيمة عنصر تحكم إدخال النص :

TextInput1.Text &" " () GUID

عند استخدام GUIDصيغة سلوك، يتم تقييمها في كل مرة يتم فيها تقييم الصيغة. لمزيد من المعلومات، راجع الأمثلة المذكور لاحقًا في هذا الموضوع.

بناء الجملة

GUID( [ GUIDString ] )

• GUIDString - اختياري. سلسلة نصية تحتوي على تمثيل سداسي عشري ل GUID. إذا لم تقم بتوفير سلسلة، تقوم الدالة بإنشاء جديد GUID.

GUID( ديناميكي )

• ديناميكي – مطلوب. القيمة الديناميكيةGUIDالتي تمثل . تعتمد القيم المقبولة على الموفر غير المصمم. بالنسبة إلى JSON، من المتوقع أن يتم تمثيل القيمة الديناميكية GUID كسلسلة JSON.

الأمثلة

الاستخدام الأساسي

لإرجاع GUID قيمة استنادا إلى تمثيل السلسلة السداسية العشرية:

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

يمكنك أيضا توفير GUID السلسلة بدون واصلات. ترجع هذه الصيغة نفس GUID القيمة:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

يتم استخدامه في السياق، لتعيين حقل الحالة لسجل قاعدة بيانات جديد إلى قيمة محددة:

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

ربما لا تريد إظهار معرفات المستخدم الرسومية (GUIDs) للمستخدمين، ولكن يمكن أن تساعدك معرفات الرسومات (GUIDs) في تصحيح أخطاء تطبيقك. لإظهار قيمة حقل الحالة في السجل الذي أنشأته في المثال السابق، قم بتعيين الخاصية Text لعنصر تحكم Label إلى هذه الصيغة:

First( Products ).Status

يظهر عنصر تحكم التسميةf9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

إنشاء جدول من معرفات GUID

1. قم بتعيين خاصية OnSelect لعنصر تحكم Button إلى هذه الصيغة:

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

   تنشئ هذه الصيغة جدولاً أحادي العمود يُستخدم للتكرار خمس مرات، مما ينتج عنه خمسة معرّفات GUID.

2. أضف عنصر تحكم Data table، قم بتعيين خاصية Items الخاصة به إلى NewGUIDs، وأظهر قيمة الحقل.

3. اضغط باستمرار على المفتاح Alt وحدد الزر.

   يعرض جدول البيانات قائمة بمعرفات GUID:

   

4. حدد الزر مرة أخرى لإظهار قائمة جديدة ب GUIDs:

   

لإنشاء جدول واحد GUID بدلا من جدول، استخدم هذه الصيغة:

Set( NewGUID, GUID() )