שתף באמצעות

הפונקציות ColumnNames ו- Column

  • מאמר

חל על: יישומי בד ציור יישומים מונחי דגמים Power Platform CLI

מאחזר שמות של עמודות וערכים מאובייקט לא מסווג.

תיאור

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

הפונקציה Column מחזירה את הערך של מאפיין מרשומה לא מסווגת עם שם העמודה הנתון. הערך מוחזר כאובייקט לא מסווג.

הפונקציות ColumnNames ו- Column מחזירות שגיאות אם האובייקט הלא מסווג לא מייצג רשומה (כלומר, אם הוא מייצג טבלה או ערך סקלרי או פרימיטיבי).

תחביר

ColumnNames( UntypedRecord )

Column( UntypedRecord, ColumnName )

  • UntypedRecord – נדרש. אובייקט לא מסווג המייצג רשומה.
  • ColumnName - נדרש. שם העמודה שיש לאחזר מהרשומה הנתונה.

דוגמאות

גישה לשדות נתונים

בהינתן מחרוזת ה-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. ערכי JSONnull נחשבים Blank(). הנוסחה הבאה מחזירה 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" ) אובייקט לא מסווג מייצג ערך בוליאני