property 要素
property ノードは、コンポーネントが Microsoft Dataverse から想定される特定の設定可能なデータを定義します。
以下に使用できます
モデル駆動型アプリとキャンバス アプリ
プロパティ
| 件名 | 内容 | タイプ | 必要 | 以下に使用できます |
|---|---|---|---|---|
| 名前 | プロパティ名 | 文字列 | 有効 | モデル駆動型アプリとキャンバス アプリ |
| display-name-key | プロパティ名を説明するローカライズされた文字列としてカスタマイズ画面で使用します。 | 文字列 | 有効 | モデル駆動型アプリ |
| of-type | プロパティのデータの種類を定義します | 備考 を参照してください | 任意出席者 | モデル駆動型アプリとキャンバス アプリ |
| 使用状況 | 使用プロパティはプロパティが、コンポーネントが値を変更 (バインド) または読み取り専用値 (入力) にできる列を表すことを意図しているか識別します | バインドまたは入力 | 有効 | モデル駆動型アプリ |
| 必須 | プロパティが必須かどうか | ブール値 | 任意出席者 | モデル駆動型アプリ |
| of-type-group | マニフェストで定義された種類グループ名 | 文字列 | 任意出席者 | モデル駆動型アプリ |
| description-key | プロパティの説明を説明するローカライズされた文字列としてカスタマイズ画面で使用します。 | 文字列 | 任意出席者 | モデル駆動型アプリとキャンバス アプリ |
| default-value | コンポーネントに提供される既定の構成値。 モデル駆動型アプリでは、バインドされたパラメーターに列が関連付けられていることを想定しているため、このプロパティは入力でのみ許可されます。 | 文字列 | 任意出席者 | モデル駆動型アプリ |
備考
of-type プロパティの値は以下のひとつである必要があります:
| 値 | 説明 |
|---|---|
| 通貨 | この列には、-922,337,203,685,477 から 922,337,203,685,477 の金額を入力することができます。 精度レベルを設定するか、組織で使用している特定通貨や1つの標準精度を基に選択します。 |
| 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 つ、複数またはすべてを選択できます。 |
| 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 プロパティ値は現在サポートされていません。
| 値 | 内容 |
|---|---|
| Whole.Duration | この形式オプションは、期間オプションの一覧を表示に使用されます。 ただし、データベースに保存されるデータは、常に分の数です。 列はドロップダウン リストとして表示され、1 分、15 分、30 分、さらには 3 日などの候補のオプションを提供します。 ユーザーは、これらのオプションを選択できます。 ただし、分数を入力してその期間に解決することもできます。 |
| Whole.TimeZone | このオプションでは (GMT-12: 00)国際日付変更線西側と (GMT-08: 00)太平洋標準時(米国 および カナダ) などのタイム ゾーンの一覧の選択が表示されます。 これらのゾーンのそれぞれは数値として保存されます。 たとえば、タイム ゾーン (GMT-08:00) 太平洋標準時 (米国およびカナダ)では、TimeZoneCode は 4 です。 詳細: TimeZoneCode Class (Sdk アセンブリ) |
| Whole.Language | このオプションは、組織でプロビジョニングされた言語の一覧を表示します。 値は言語名のドロップダウン リストとして表示されますが、データはLCID コードを使用して数値として保存されます。 言語コードは 4 桁または 5 桁のロケール ID です。 有効なロケール ID 値は、ロケール ID (LCID) の一覧のページで確認できます。 |
| Lookup.Customer | 取引先企業または取引先担当者のレコードに対する単一の参照を使用できます。 これらの検索は、営業案件、サポート案件、見積もり、受注、および請求書の各テーブルで利用できます。 これらのテーブルには、顧客の種類が常に 1 種類の場合に使用できる、別の取引先企業検索と取引先担当者検索も含まれています。 または、顧客検索を使用する代わりに、両方を含めることができます。 |
| Lookup.Owner | チームまたはユーザーのレコードに対して単一の参照が可能になります。 すべてのチームまたはユーザー所有のテーブルには、次のうち 1 つがあります。 |
| Lookup.PartyList | 複数のテーブルに対する複数の参照を使用できます。 これらの検索は、E-mail テーブルの 宛先 および CC 列に見られます。 これらは、電話および予定テーブルでも使用されます。 |
| Lookup.Regarding | 複数のテーブルに対する単一の参照を使用できます。 これらの検索は、活動で使用する関連列にあります。 |
| ステータス | 一般に、有効か無効のステータスに対応するオプションがあるシステム列。 いくつかのシステム列には追加オプションがありますが、すべてのユーザー列には有効と無効のステータス オプションだけがあります。 |
| ステータスの理由 | 状態列の詳細を提供するオプションがあるシステム列。 各オプションは使用可能な状態オプションの 1 つに関連付けられます。 オプションを追加または編集できます。 |
親要素
| 要素 | 内容 |
|---|---|
| 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 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
フィードバックの送信と表示