다음을 통해 공유


control 요소

구성 요소의 네임스페이스, 버전 및 표시 정보를 정의합니다.

사용할 수 있는 대상

모델 기반 및 캔버스 앱

매개 변수

이름 Description 유형 필수 사용할 수 있는 대상
namespace 구성 요소의 개체 프로토타입을 정의합니다. 문자 또는 숫자만 Yes 모델 기반 및 캔버스 앱
constructor 개체를 초기화하는 메서드 문자 또는 숫자만 Yes 모델 기반 및 캔버스 앱
control-type 컨트롤이 표준 컨트롤인지 React 컨트롤인지 여부입니다. 값 virtual 은 플랫폼 React 라이브러리를 사용하는 React 컨트롤을 나타냅니다. 가상 컨트롤은 공개 미리 보기의 기능입니다. 추가 정보: React 컨트롤 및 플랫폼 라이브러리 standard|virtual 아니오 모델 기반 및 캔버스 앱
description-key UI에 표시되는 구성 요소에 대한 설명을 정의합니다. string 아니오 모델 기반 및 캔버스 앱
display-name-key UI에 표시되는 컨트롤의 이름을 정의합니다. string Yes 모델 기반 및 캔버스 앱
preview-image 구성 요소의 미리 보기를 표시하기 위해 사용자 지정 화면에서 사용되는 이미지입니다. string 아니오 모델 기반 앱
version 의미 체계 버전 관리에서 정의된 구성 요소의 버전을 정의합니다. string Yes 모델 기반 및 캔버스 앱

부모 요소

요소 Description
나타나다 매니페스트는 구성 요소를 정의하는 메타데이터 파일입니다. 다음을 XML 설명하는 파일입니다.
  • 구성 요소의 네임스페이스입니다.
  • 필드 또는 데이터 세트 중 하나를 구성할 수 있는 데이터의 종류입니다.
  • 구성 요소가 추가될 때 애플리케이션에서 구성할 수 있는 모든 속성입니다.
  • 구성 요소에 필요한 리소스 파일 목록입니다.
    • 그 중 하나는 TypeScript 웹 리소스여야 합니다. 이 TypeScript에는 개체를 인스턴스화하는 함수가 포함되어야 합니다. 구성 요소가 작동하는 데 필요한 메서드를 노출하는 인터페이스를 구현합니다. 이를 구성 요소 구현 라이브러리라고 부릅니다.
  • 필요한 구성 요소 인터페이스를 적용하는 개체를 반환하는 구성 요소 구현 라이브러리의 TypeScript 함수 이름입니다.
사용자가 캔버스 앱 또는 모델 기반 앱에서 사용자 지정 구성 요소를 구성할 때 매니페스트의 데이터는 사용 가능한 구성 요소를 필터링하여 컨텍스트에 대한 유효한 구성 요소만 구성에 사용할 수 있도록 합니다. 구성 요소의 매니페스트에 정의된 속성은 구성 요소를 구성하는 사용자가 값을 지정할 수 있도록 구성 필드로 렌더링됩니다. 그런 다음 이러한 속성 값을 런타임에 구성 요소 함수에 사용할 수 있습니다.

자식 요소

요소 Description 발생
데이터 세트 구성 요소 매니페스트의 데이터 세트 노드는 테이블 레코드 집합의 구성 가능한 특정 표현을 나타냅니다. 0 이상
external-service-usage 이 컨트롤이 외부 서비스를 사용하고 있는지 여부를 나타냅니다. 이 경우 활성화된 특성 플래그를 true로 설정하고 속성에 외부 서비스 도메인을 <domain> 추가합니다. 외부 서비스를 사용하는 컨트롤은 프리미엄 컨트롤이며 최종 사용자는 프리미엄 컨트롤을 사용하여 앱을 열려면 Power Apps 라이선스가 필요합니다. 추가 정보: 라이선스 0 또는 1
속성 속성 노드는 구성 요소가 Microsoft Dataverse에서 기대하는 구성 가능한 특정 데이터를 정의합니다. 0 이상
자원 구성 요소 매니페스트의 리소스 노드는 구성 요소에서 시각화를 구현하는 데 필요한 리소스 파일을 나타냅니다. 1
type-group 형식 그룹 노드는 단일 이름으로 식별되는 형식 집합을 정의합니다. 이 정보를 사용하여 특정 속성에서 지원하는 데이터 형식을 식별할 수 있습니다. 0 이상
property-dependencies 속성 종속성 그룹을 정의합니다. 0 이상
platform-action 컨트롤이 로드되는 시점 대신 요청 시 해당 컨트롤 종속성 로드를 지정하는 데 사용됩니다. 0 또는 1

Example

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Power Apps 구성 요소 프레임워크 매니페스트 스키마 참조
Power Apps 구성 요소 프레임워크 API 참조
Power Apps 구성 요소 프레임워크 개요