ColumnNamesودالات Column

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

استرداد أسماء الأعمدة والقيم من قيمة ديناميكية.

الوصف

ترجع ColumnNames الدالة أسماء كافة الأعمدة من سجل ديناميكي، مع إرجاع جدول بجميع الأسماء من هذا السجل.

ترجع Column الدالة قيمة خاصية من سجل ديناميكي باسم العمود المحدد. يتم إرجاع القيمة كقيمة ديناميكية.

ترجع ColumnNames الدالتين و Column أخطاء إذا كانت القيمة الديناميكية لا تمثل سجلا (أي إذا كانت تمثل جدولا أو قيمة عددية أو بدائية).

بناء الجملة

ColumnNames( DynamicRecord )

• DynamicRecord – مطلوب. قيمة ديناميكية تمثل سجلا.

Column( DynamicRecord, ColumnName )

• DynamicRecord – مطلوب. قيمة ديناميكية تمثل سجلا.
• اسم العمود- مطلوب. اسم العمود الذي سيتم استرداده من السجل المعين.

الأمثلة

الوصول إلى قيم الحقول

سلسلة JSON التالية في متغير يسمى JsonString

{ "name": "Seattle", "population": 737000 }

1. ترجع الصيغة التالية جدولاً من عمود واحد مع عمود Value يحتوي على القيم التالية: "الاسم" أو "السكان":

   ColumnNames( ParseJSON( JsonString ) )
   

2. تُرجع الصيغة التالية الرقم 737000:

   Value( Column( ParseJSON( JsonString ), "population" ) )
   

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

3. تُرجع الصيغة التالية القيمة النصية "name: Seattle, population: 737000":

   With(
       { untyped: ParseJSON( JsonString ) },
       Concat(
           ColumnNames( untyped ),
           $"{Value}: {Column( untyped, Value )}",
           ", "))
   

القيم الفارغة

سلسلة JSON التالية في متغير يسمى JsonString

{ "text": "text value" , "number": 567, "empty": null }

1. محاولة الوصول إلى حقول غير موجودة تُرجع Blank(). تُرجع الصيغة التالية true:

   IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
   

2. تعتبر قيم null JSON الفارغة (). تُرجع الصيغة التالية true:

   IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
   

Nonrecords

Column يؤدي استدعاء الدالات أو ColumnNames ذات القيم الديناميكية التي لا تمثل السجلات إلى إرجاع خطأ. كل هذه التعبيرات في القائمة التالية خاطئة:

الصيغة	سبب الخطأ
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	تمثل القيمة الديناميكية صفيفا
Column( ParseJSON ( "23.45" ), "Value" )	تمثل القيمة الديناميكية رقما
ColumnNames( ParseJSON ( ""hello"") )	تمثل القيمة الديناميكية نصا
Column( ParseJSON ( "{"a"":false}" ).a, "a" )	تمثل القيمة الديناميكية قيمة منطقية