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 | 日付のみを表示します。 | モデル駆動型アプリとキャンバス アプリ |
| 10 進法 | この列には、-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よりも優先されます。
親要素
| 要素 | プロパティ |
|---|---|
| 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 Manifest Schema リファレンス
Power Apps Component Framework API リファレンス
Power Apps Component Framework の概要