ColumnNames 및 Column 함수

적용 대상: Canvas 앱 Copilot Studio 모델 기반 앱 Power Platform CLI Dataverse 함수

동적 값에서 열 이름과 값을 검색합니다.

설명

이 함수는 ColumnNames동적 레코드에서 모든 열의 이름을 반환하고 해당 레코드의 모든 이름을 가진 테이블을 반환합니다.

함수는 Column 지정된 열 이름을 가진 동적 레코드 에서 속성 값을 반환합니다. 값은 동적 값으로 반환됩니다.

동적 값이 ColumnNames 레코드를 나타내지 않는 경우(즉, 테이블 또는 스칼라 또는 기본값을 나타내는 경우) 및 Column 함수는 오류를 반환합니다.

구문

ColumnNames( DynamicRecord )

• DynamicRecord – 필수입니다. 레코드를 나타내는 동적 값 입니다.

Column( DynamicRecord, ColumnName )

• DynamicRecord – 필수입니다. 레코드를 나타내는 동적 값 입니다.
• ColumnName - 필수. 주어진 레코드에서 검색할 열의 이름입니다.

예

필드 값 액세스

JsonString이라는 변수에 다음 JSON 문자열이 있는 경우

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

1. 다음 수식은 "name", "population" 값을 포함하는 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 )}",
           ", "))
   

공백

JsonString이라는 변수에 다음 JSON 문자열이 있는 경우

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

1. 존재하지 않는 필드에 액세스하려고 하면 Blank()가 반환됩니다. 다음 수식은 true를 반환합니다.

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

2. JSON null 값은 Blank()로 간주됩니다. 다음 수식은 true를 반환합니다.

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

Nonrecords

레코드를 Column 나타내지 않는 동적 값으로 또는 ColumnNames 함수를 호출하면 오류가 반환됩니다. 다음 목록에 있는 모든 식은 잘못되었습니다.