الدالتان ColumnNames وColumn

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

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

الوصف

ترجع الدالة ColumnNams أسماء جميع الأعمدة من سجل غير مصنف، مما يؤدي إلى إرجاع جدول يتضمن جميع الأسماء من ذلك السجل.

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

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

بناء الجملة

أسماء الأعمدة ( سجل غير مكتوب )

• سجل غير مكتوب - مطلوب. كائن غير مصنف يمثل رقمًا.

العمود ( سجل غير مكتوب ، اسم العمود)

• سجل غير مكتوب - مطلوب. كائن غير مصنف يمثل رقمًا.
• اسم العمود- مطلوب. اسم العمود الذي سيتم استرداده من السجل المعين.

الأمثلة

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

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

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

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

   ColumnNames( ParseJSON( JsonString ) )
   

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

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

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

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 مع كائنات غير مصنفة لا تمثل السجلات إلى إرجاع خطأ. كل هذه التعبيرات أدناه خاطئة:

الصيغة	سبب الخطأ
أسماء الأعمدة (ParseJSON ( "[1 ، 2 ، 3]")	يمثل الكائن غير المصنف صفيفًا
العمود ( ParseJSON ( "23.45") ، "القيمة")	يمثل الكائن غير المصنف رقمًا
أسماء الأعمدة ( ParseJSON ( ""مرحبا"")	يمثل الكائن غير المصنف نصًا
العمود ( ParseJSON ( "{""a"": false}" ) .a ، "a")	يمثل الكائن غير المصنف قيمة منطقية