ColumnNamesופונקציות Column

חל על: אפליקציות Canvas אפליקציות 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. ערכי JSONnull נחשבים Blank(). הנוסחה הבאה מחזירה true:

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

Nonrecords

קריאה לפונקציות ColumnColumnNames או עם ערכים דינאמיים שאינם מייצגים רשומות מחזירה שגיאה. כל הביטויים ברשימה הבאה שגויים:

נוסחה	הסיבה לשגיאה
ColumnNames( ParseJSON ( "[1, 2, 3]" )	ערך דינאמי מייצג מערך
Column( ParseJSON ( "23.45" ), "Value" )	ערך דינאמי מייצג מספר
ColumnNames( ParseJSON ( """hello""" )	ערך דינאמי מייצג טקסט
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	ערך דינאמי מייצג ערך בוליאני