control 要素

  • [アーティクル]

コンポーネントの名前空間、バージョン、表示情報を定義します。

以下に使用できます

モデル駆動型アプリとキャンバス アプリ

パラメーター

件名 内容 タイプ 必要 以下に使用できます
namespace コンポーネントのオブジェクト プロトタイプを定義します 文字または数字のみ はい モデル駆動型アプリとキャンバス アプリ
constructor オブジェクトを初期化するメソッド 文字または数字のみ はい モデル駆動型アプリとキャンバス アプリ
control-type このコントロールが、標準コントロールであるか、React コントロールであるか。 virtual の値は、プラットフォーム React ライブラリを使用している React コントロールを示します。 仮想コントロールはパブリック プレビュー状態の機能です。 詳細: React のコントロールとプラットフォーム ライブラリ (プレビュー) standard|virtual いいえ モデル駆動型アプリとキャンバス アプリ
description-key UI に表示されるコンポーネントの説明を定義します。 string いいえ モデル駆動型アプリとキャンバス アプリ
display-name-key UI に表示されるコントロールの名前を定義します。 string はい モデル駆動型アプリとキャンバス アプリ
preview-image コンポーネントのプレビューを表示するためにカスタマイズ画面で使用される画像。 string いいえ モデル駆動型アプリ
version セマンティック バージョン で定義されたコンポーネントのバージョンを定義します。 string はい モデル駆動型アプリとキャンバス アプリ

親要素

要素 内容
manifest マニフェストはコンポーネントを定義するメタデータ ファイルです。 説明する XML ファイルです:
  • コンポーネントの名前空間です。
  • 構成が可能なデータの種類、フィールドまたはデータセット。
  • コンポーネントが追加されたときにアプリケーションで構成できる任意のプロパティ。
  • コンポーネントが必要とするリソース ファイルの一覧。
    • そのうちひとつは TypeScript Web リソースである必要があります。 この TypeScript はオブジェクトをインスタンス化する関数を含む必要があります。 これはコンポーネントが動作するのに必要なメソッドを公開するインターフェースを実装します。 これはコンポーネント実装ライブラリと呼ばれます。
  • 必要なコンポーネント インタフェースを適用するオブジェクトを返す、コンポーネント実装ライブラリの TypeScript 関数名。
ユーザーがキャンバス アプリまたはモデル駆動型アプリのユーザー定義コンポーネントを設定する際に、マニフェストのデータは利用可能なコンポーネントを除外して、コンテキストに有効なコンポーネントのみ構成に使用できるようにします。 コンポーネントのマニフェストで定義されたプロパティは、コンポーネントを設定するユーザーが値を指定できるよう構成フィールドとして表示されます。 これらのプロパティ値は、実行時にコンポーネント関数で利用可能になります。

下位要素

要素 Description 発生回数
data-set コンポーネント マニフェストのデータセット ノードは、一連のテーブル レコードの特定の構成可能な表現を表します。 0 以上
外部サービスの使用 このコントロールが外部サービスを使用しているかどうかを示します。 そうである場合は、enabled 属性フラグを true に設定し、外部サービス ドメインを <domain> プロパティに追加します。 外部サービスを使用するコントロールはプレミアム コントロールであり、エンド ユーザーには Power Apps プレミアム コントロールでアプリを開くためのライセンス。 詳細情報 : ライセンス 0 または 1
property property ノードは、コンポーネントが Microsoft Dataverse から想定される特定の設定可能なデータを定義します。 0 以上
resources コンポーネント マニフェストの resources ノードは、コンポーネントのビジュアル化を実装するために必要なリソース ファイルを参照します。 6
type-group type-group ノードは単一の名前で識別される一連の種類を定義します。 この情報は、特定の property でサポートしているデータの種類を識別するために使用できます。 0 以上
property-dependencies property-dependencies のグループを定義します。 0 以上

例

<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 Component Framework Manifest Schema リファレンス
Power Apps Component Framework API の参照
Power Apps Component Framework の概要

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。