property 要素

property ノードは、コンポーネントが Microsoft Dataverse から想定される特定の設定可能なデータを定義します。

以下に使用できます

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

プロパティ​​

件名	Description	タイプ	Required	使用可能な対象
default-value	コンポーネントに提供される既定の構成値。 モデル駆動型アプリでは、バインドされたパラメーターに列が関連付けられていることを想定しているため、このプロパティは入力でのみ許可されます。	string	オプション	モデル駆動型アプリ
description-key	プロパティの説明を説明するローカライズされた文字列としてカスタマイズ画面で使用します。	string	オプション	モデル駆動型アプリとキャンバス アプリ
display-name-key	プロパティ名を説明するローカライズされた文字列としてカスタマイズ画面で使用します。	string	はい	モデル駆動型アプリ
名称	プロパティ名	string	はい	モデル駆動型アプリとキャンバス アプリ
of-type-group	マニフェストで定義された種類グループ名	string	オプション	モデル駆動型アプリ
of-type	プロパティのデータの種類を定義します	of-type の使用 を参照してください	オプション	モデル駆動型アプリとキャンバス アプリ
pfx-default-value	コンポーネントに提供される既定の PFX 式の値。	pfx-default-value の使用 を参照してください	オプション	キャンバス アプリ
required	プロパティが必須かどうか	ブール値	オプション	モデル駆動型アプリ
使用状況	usage プロパティは、コンポーネントが変更可能な列 (bound)、読み取り専用 (input)、または出力値を表すためのプロパティであるかを識別します	bound、input または output	はい	モデル駆動型アプリ

注釈

このセクションには、Property 要素の属性の使用に関するガイダンスが含まれています。

of-type の使用

of-type プロパティの値は以下のひとつである必要があります:

値	説明
通貨	この列には、-922,337,203,685,477 から 922,337,203,685,477 の金額を入力することができます。
DateAndTime.DateAndTime	日付と時刻を表示します。
DateAndTime.DateOnly	日付のみを表示します。
小数	この列には、-100,000,000,000 から -100,000,000,000 の範囲の値に小数点 10 位まで使用できます。
列挙型	列挙体のデータ型。
FP	この列には、-100,000,000,000 から -100,000,000,000 までの値に、小数点 5 位まで使用できます。
Lookup.Simple	特定のテーブルに対して 1 つの参照が可能になります。 すべてのカスタム検索は、このタイプです。
複数の	この列は、最大 1,048,576 文字のテキストを入力することができます。
MultiSelectOptionSet	選択列を追加して、フォーム (メイン、簡易作成、簡易ビュー) と電子メールのテンプレートをカスタマイズできます。 選択列を追加するときは、ユーザーが選択できる複数の値を指定することができます。 ユーザーはフォームに記入する際、ドロップダウン リストに表示される値 1 つ、複数またはすべてを選択できます。
Object	オブジェクト データ型。 出力プロパティでのみ使用できます。
OptionSet	この列には、一連のオプションが提供されます。 各オプションには数値とラベルが含まれます。 フォームに追加すると、この列が 1 つのオプションのみを選択するユーザーのコントロールを表示します。
SingleLine.Email	これにより、文字列の時刻がメールに有効な形式で保存されます。 すぐに使用できる統一インターフェイス コントロールは、自動的にクリック可能なリンクにします。
SingleLine.Phone	これにより、文字列の時刻が電話に有効な形式で保存されます。 すぐに使用できる統一インターフェイス コントロールは、自動的にクリック可能なリンクにします。
SingleLine.Text	このオプションには、テキストが表示されます。
SingleLine.TextArea	この形式オプションには、複数行のテキストを表示することができます。 大量のテキストが予期される場合は、複数行テキスト列の文字制限は 4000 文字なので、このフィールドを選択することをお勧めします。
SingleLine.Ticker	これにより、文字列の時刻がティッカーに有効な形式で保存されます。 すぐに使用できる統一インターフェイス コントロールは、自動的にクリック可能なリンクにします。
SingleLine.URL	指定されたテキストを開くハイパーリンクを提供することが予想されるテキスト。 すぐに使用できる統一インターフェイス コントロールは、有効なプロトコルで始まらない入力値に自動的に "https://" を添付します。 この列に期待されるプロトコルは、HTTP、HTTPS、FTP、FTPS、OneNote および TEL のみです。
TwoOptions	この列には、2 つのオプションがあります。 各オプションには、false または true 値に対応する、0 または 1 の数値があります。 また、各オプションにはラベルがあり、true または false が「はい」と「いいえ」、「高」と「低」、「オン」と「オフ」、または表示するラベルのペアとして表すことができます。
Whole.None	このオプションでは、単に数字が表示されます。

警告

manifest.xml ファイルに少なくとも 1 つのデータセットが含まれる場合、Lookup.Simple タイプのプロパティもデータセット エレメントにラップする必要があります。

サポートされていない値要素

次の of-type プロパティ値は現在サポートされていません:

価値	Description
Lookup.Customer	取引先企業または取引先担当者のレコードに対する単一の参照を使用できます。 これらの検索は、営業案件、サポート案件、見積もり、受注、および請求書の各テーブルで利用できます。 これらのテーブルには、顧客の種類が常に 1 種類の場合に使用できる、別の取引先企業検索と取引先担当者検索も含まれています。 または、顧客検索を使用する代わりに、両方を含めることができます。
Lookup.Owner	チームまたはユーザーのレコードに対して単一の参照が可能になります。 すべてのチームまたはユーザー所有のテーブルには、次のうち 1 つがあります。
Lookup.PartyList	複数のテーブルに対する複数の参照を使用できます。 これらの検索は、E-mail テーブルの宛先および CC 列に見られます。 これらは、電話および予定テーブルでも使用されます。
Lookup.Regarding	複数のテーブルに対する単一の参照を使用できます。 これらの検索は、活動で使用する関連列にあります。
ステータスの理由	状態列の詳細を提供するオプションがあるシステム列。 各オプションは使用可能な状態オプションの 1 つに関連付けられます。 オプションを追加または編集できます。
Status	一般に、有効か無効のステータスに対応するオプションがあるシステム列。 一部のシステム列にはより多くのオプションがありますが、すべてのカスタム列にはアクティブと非アクティブのステータス オプションだけがあります。
Whole.Duration	この形式オプションは、期間オプションの一覧を表示に使用されます。 ただし、データベースに保存されるデータは、常に分の数です。 列はドロップダウン リストとして表示され、1 分、15 分、30 分、さらには 3 日などの候補のオプションを提供します。 ユーザーは、これらのオプションを選択できます。 ただし、分数を入力してその期間に解決することもできます。
Whole.Language	このオプションは、組織でプロビジョニングされた言語の一覧を表示します。 値は言語名のドロップダウン リストとして表示されますが、データはLCID コードを使用して数値として保存されます。 言語コードは 4 桁または 5 桁のロケール ID です。 有効なロケール ID 値は、ロケール ID (LCID) の一覧で確認できます。
Whole.TimeZone	このオプションでは (GMT-12: 00)国際日付変更線西側と (GMT-08: 00)太平洋標準時(米国 および カナダ) などのタイム ゾーンの一覧の選択が表示されます。 これらのゾーンのそれぞれは数値として保存されます。 たとえば、タイム ゾーン (GMT-08:00) 太平洋標準時 (米国およびカナダ)では、TimeZoneCode は 4 です。

注意

現時点では、ファイル列はサポートされていません。 詳細: ファイル列

pfx-default-value の使用

pfx-default-value プロパティ値を使用して、静的な既定値の代わりに Power Fx 式を使用してイベントとプロパティを評価します。 これを使用すると、次のことができます:

• コントロールを適切なサイズにする
• コネクタへのアクセス
• サンプル データを提供する
• テーマ プロパティを参照する
• カスタム イベント

注意

• 任意の Power Fx 式を使用できますが、コントロールをインポートするときに式が有効であることを確認する必要があります。
• 内側の引用符や、その他の特殊文字を使用する場合は、値を一重引用符で囲みます。例: pfx-default-value='"Test"'
• 他のコントロール (画面を含む) とそのプロパティを参照できます。 これらの参照を次のように記述します: %ControlName.ID%.ControlProperty。 例: pfx-default-value='SubmitForm(%MyFormName.ID%)'
• DisplayType や ScreenTransition などの列挙型を次のように記述します: %EnumName.RESERVED%.EnumValue。 例: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
• pfx-default-value が含まれている場合は、default-value よりも優先されます。

親要素

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

例

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

関連トピック

Power Apps component framework のマニフェスト スキーマ リファレンス
Power Apps Component Framework API の参照
Power Apps Component Framework の概要

注意

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

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