مشاركة عبر

الدالة GUID

  • مقالة

ينطبق على: تطبيقات اللوحة تدفقات سطح المكتب التطبيقات المستندة إلى النموذج Power Platform CLI

تحويل سلسلة 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 4122 GUID. عند تحويل سلسلة إلى GUID ، تدعم هذه الوظيفة أي إصدار GUID عن طريق قبول أي سلسلة من 32 رقمًا سداسيًا عشريًا.

وظائف متغيرة

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

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

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

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

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) مساعدتك في تصحيح تطبيقك. لإظهار قيمة حقل الحالة في السجل الذي قمت بإنشائه في المثال السابق، قم بتعيين خاصية Text لعنصر تحكم Label إلى هذه الصيغة:

First( Products ).Status

سيقوم عنصر تحكم Label بعرض f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

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

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

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

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

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

  3. أثناء الضغط باستمرار على مفتاح Alt، حدد الزر بالنقر فوقه أو الضغط عليه.

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

    شاشة تعرض جدول بيانات يحتوي على خمس قيم GUID مختلفة.

  4. حدد الزر مرة أخرى لإظهار قائمة مختلفة من معرفات GUID:

    تُظهر نفس الشاشة جدول بيانات مع مجموعة جديدة من خمس قيم GUID مختلفة.

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

Set( NewGUID, GUID() )