ColumnNames และ Column ฟังก์ชัน

นําไปใช้กับ: แอปพื้นที่ทํางานแอปที่ขับเคลื่อนด้วยแบบจําลอง Copilot Studio ฟังก์ชัน Power Platform CLI Dataverse

ดึงข้อมูลชื่อคอลัมน์และค่าจากค่าไดนามิก

คำอธิบาย

ฟังก์ชัน ColumnNames จะส่งกลับชื่อของคอลัมน์ทั้งหมดจาก เรกคอร์ดแบบไดนามิก ซึ่งส่งกลับตารางที่มีชื่อทั้งหมดจากเรกคอร์ดนั้น

ฟังก์ชัน Column จะส่งกลับค่าของคุณสมบัติจาก ระเบียนแบบไดนามิก ที่มีชื่อคอลัมน์ที่กําหนด ค่าจะถูกส่งกลับเป็นค่าไดนามิก

ฟังก์ชัน ColumnNames และ Column จะส่งกลับข้อผิดพลาด ถ้า ค่าไดนามิก ไม่แสดงระเบียน (นั่นคือ ถ้าแสดงเป็นตารางหรือค่าสเกลาหรือค่าดั้งเดิม)

ไวยากรณ์

ColumnNames( DynamicRecord )

• DynamicRecord – จําเป็นต้องมี ค่าไดนามิกที่แสดงเรกคอร์ด

Column( DynamicRecord, ColumnName )

• DynamicRecord – จําเป็นต้องมี ค่าไดนามิกที่แสดงเรกคอร์ด
• ColumnName - จำเป็น ชื่อของคอลัมน์ที่จะดึงข้อมูลจากเรกคอร์ดที่กำหนด

ตัวอย่าง

การเข้าถึงค่าฟิลด์

รับสตริง 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 ถือว่าเป็น Blank() สูตรต่อไปนี้ส่งคืน true:

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

Nonrecords

การ Column เรียกใช้ฟังก์ชัน หรือ ColumnNames ด้วยค่าไดนามิกที่ไม่แสดงระเบียนส่งกลับข้อผิดพลาด นิพจน์เหล่านั้นทั้งหมดในรายการต่อไปนี้มีข้อผิดพลาด: