구성 요소의 입력 필드 매핑

구성 요소는 사용자 지정 입력 속성을 사용하여 데이터를 내보내거나 처리하기 위해 입력 값을 받을 수 있습니다. 이 문서에서는 주어진 테이블이나 레코드에 대한 특정 스키마가 있는 하나 이상의 입력 속성을 기대하는 이러한 구성 요소로 작업하는 방법과 구성 요소 입력 필드를 데이터 원본의 열에 매핑하는 방법을 배웁니다.

팁

구성 요소의 사용자 지정 입력 및 출력 속성이 무엇인지 알아보려면 구성 요소의 사용자 지정 속성을 참조하십시오.

열 매핑

RenameColumns() 함수를 사용하여 입력 열 선택을 위한 입력 속성 스키마와 일치하도록 테이블의 하나 이상의 열 이름을 바꿉니다.

예를 들어 다음 형식의 테이블 입력을 예상하는 구성 요소를 고려하십시오.

맛	UnitPrice	QuantitySold
딸기	1.99	20
초콜릿	2.99	45

입력 속성에는 테이블 데이터 유형이 필요합니다.

입력 속성의 스키마는 다음 수식과 같습니다.

Table({Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold:20})

이 구성 요소를 사용하는 앱에는 구성 요소 스키마와 일치하지 않는 다음 IceCreams 테이블이 있습니다.

FlavorName	가격	SaleNumber
딸기	1.99	20
초콜릿	2.99	45

올바른 필드를 매핑하려면 RenameColumn() 함수를 사용하여 예상되는 열의 이름을 바꿉니다.

RenameColumns(IceCreams,"cra56_flavorname","Flavor","cra56_price","UnitPrice","cra56_salenumber","QuantitySold")

구성 요소가 예상하는 입력 필드는 이제 데이터 원본의 일치하는 열과 매핑됩니다.

레코드 매핑

With() 함수를 사용하여 단일 레코드를 매핑합니다.

예를 들어 열 매핑에 대한 이전 예시에 이어 앱 내부 구성 요소의 사용자 지정 입력 속성은 다음 스키마의 레코드 유형을 예상합니다.

{Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold: 20}

IceCreams 데이터 원본은 열 이름을 FlavorName, Price 및 SaleNumber로 예상하기 때문에 컴포넌트가 앱에 추가되면 레코드의 매핑을 변경해야 합니다.

With() 함수를 사용하여 IceCreams 테이블의 열을 선택하고 구성 요소의 입력 필드에 매핑합니다.

With(Gallery3.Selected,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

다음 애니메이션은 갤러리(구성 요소 위)에서 선택한 레코드를 표시하는 앱에 추가된 구성 요소의 예를 보여줍니다.

테이블 매핑

ForAll() 함수를 사용하여 레코드 테이블을 앱에 추가된 구성 요소가 예상하는 레코드로 매핑합니다.

예를 들어, 열 매핑 예제의 끝에서 ForAll() 함수를 사용하여 전체 테이블을 특정 열로 매핑하여 각 행의 구성 요소에서 필드를 가리킬 수 있습니다.

ForAll(IceCreams,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

드롭다운을 사용한 매핑(더 이상 사용되지 않음)

테이블 또는 레코드 종류의 입력 속성을 예상하는 앱에 추가된 구성 요소에 대해 고급 탭을 사용하고 드롭다운 옵션을 사용하여 필드 매핑을 선택할 수 있습니다. 이 매핑은 기본적으로 할당되며 적절한 매핑 필드를 수동으로 선택하지 않으면 매핑이 예상한 결과를 생성하지 않을 수 있습니다.

예를 들어 다음 애니메이션은 열 이름을 변경하기 위해 업데이트되는 수식을 보여줍니다. 이 드롭다운을 사용하는 기본 필드 선택을 수동으로 업데이트해야 하므로 화면의 구성 요소는 필드 매핑을 변경하지 않습니다.

드롭다운을 사용하여 매핑을 선택하는 이 매서드는 더 이상 사용되지 않는 방법입니다. 대신 이 문서의 앞부분에서 설명한 대로 열, 레코드 또는 테이블 매핑 방법을 사용하십시오.

권장하지는 않지만 드롭다운 옵션을 사용하여 기존 앱에 대한 매핑을 선택할 수 있습니다. 새 앱의 경우 이 옵션은 기본적으로 사용할 수 없습니다. 더 이상 사용되지 않는 이 기능을 켜거나 끄려면 설정 > 향후 기능 > 사용 중지로 이동하고 구성 요소 입력에 대한 자동 필드 할당 허용을 선택합니다.

설정을 켤 때 앱을 저장하고 Power Apps Studio에서 다시 여십시오. 다시 열리면 입력 속성 수식을 업데이트하여 수식 유효성 검사를 트리거하여 고급 속성 창에 드롭다운 옵션이 나타나기 시작합니다.

참고 항목:

• 구성 요소의 동작 수식
• 더 이상 사용되지 않음: 드롭다운 옵션을 사용하여 구성 요소 필드 매핑
• 캔버스 구성 요소
• 구성 요소 라이브러리
• 구성 요소 라이브러리 애플리케이션 수명 주기 관리(ALM)
• 구성 요소에 멀티미디어 추가
• 구성 요소의 동작 수식
• Power Apps component framework
• 모델 기반 앱의 사용자 지정 페이지에 캔버스 구성 요소 추가