エンティティ属性メタデータのカスタマイズ
公開日: 2017年1月
対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
既存の属性を取得するには、AttributeMetadata クラスを使用します。 このクラスは、RetrieveAttributeRequest メッセージによって返されます。AttributeMetadata クラスは、抽象 MetadataBase クラスから継承されます。
属性を更新、またはユーザー定義属性を作成するには、属性の種類ごとに固有のクラスを CreateAttributeRequest メッセージで使用します。
注意
作成したユーザー定義属性はプログラムによってアクセスできますが、表示するにはその属性をエンティティ フォームに追加して公開する必要があります。
属性の種類
次の表は、で操作できるの各種類の Attribute を示します。 各属性は、AttributeMetadata クラスから継承されます。
クラス |
アプリケーション ラベル |
説明 |
|---|---|---|
2 つのオプション |
ブール値属性です。 両方のオプションのテキストを指定できます。 フォームに追加すると、属性を 2 つのラジオ ボタンとして表示するか、チェック ボックスとして表示するか、リストとして表示するかがフィールド プロパティによって制御されます。 |
|
日付と時間 |
日付と時間の属性です。 タイム ゾーン情報付きまたは付かない日付と時刻の値と、それらの値の表示形式を定義する形式を格納するための動作を指定できます。 詳細: 日時属性の動作と形式 注意 Microsoft Dynamics CRM Online 2015 更新プログラム 1 または Microsoft Dynamics 365 (設置型) を使用している場合、すべての日付および時刻の属性では、1753 年 1 月 1 日午前 12:00 以降の値がサポートされます。 |
|
10 進数 |
10 進数属性です。 小数点第 10 位までの精度と、-100,000,000,000 ～ 100,000,000,000 の最小値および最大値を指定できます。 |
|
浮動小数点数 |
倍精度浮動小数点属性です。 小数点第 5 位までの精度と、-100,000,000,000 ～ 100,000,000,000 の最小値および最大値を指定できます。 注意 DoubleAttributeMetadata は、Microsoft Dynamics CRM 4.0 で使用されていた FloatAttributeMetadata に代わるものです。 |
|
イメージ |
イメージ属性。 各エンティティでは 1 だけイメージ属性を設定できます。 特定のシステム エンティティにはイメージ属性があり、新しいイメージの属性は、それを所持しないシステム エンティティに追加できません。 イメージ属性をカスタム エンティティに追加することができる すべてのイメージ属性には SchemaName ‘EntityImage’および LogicalName‘entityimage’があります。 ユーザー定義のイメージ属性は名前でソリューション発行者のカスタマイズ接頭辞を使用しません。詳細:エンティティ イメージ。 |
|
整数 |
整数属性です。 -2,147,483,648 ～ 2,147,483,647 の最大値および最小値を指定できます。 この属性は、IntegerFormat列挙を使用して次の種類のフィールドを作成するために書式設定することができます。
|
|
ルックアップ |
CreateOneToManyRequest メッセージを使用してエンティティの関連付けを作成した際に作成される属性です。 |
|
複数行テキスト |
メモ属性です。 フォームにテキスト ボックス フィールドとして表示されます。 最大長は 1048576 文字です。 |
|
[通貨] |
通貨属性です。 -922,337,203,685,477 ～ 922,337,203,685,477 の間で最大値および最小値を指定できます。 PrecisionSource プロパティを使用して、精度を設定できます。
|
|
オプション セット |
候補リスト属性です。 この属性は、ドロップダウン リストに表示される一連のオプションを提供します。 候補属性を作成して、独自のオプションを含めることも、グローバル オプション セットを使用することもできます。 |
|
ステータス |
エンティティの作成時に状態属性が自動的に作成されます。 注意 この属性に使用できるオプションは読み取り専用です。 |
|
ステータス |
エンティティの作成時にステータス属性が自動的に作成されます。 各オプションは、エンティティの StateAttributeMetadata 属性に関連付ける必要があります。 この属性に使用できるオプションを更新するには、InsertStatusValueRequest メッセージを使用します。 注意 ステータス値は特定の状態値に依存するので、各 StatusOption は特定の状態属性値を参照する必要があります。 |
|
1 行テキスト |
「StringAttributeMetadata 形式」を参照してください。 |
StringAttributeMetadata 形式
文字列属性は、Skype または Lync を使用して、リンクで電話の発信ができるように設定することができます。 この変更では、新しいFormatName プロパティのStringAttributeMetadata クラスへの追加と、Format プロパティの削除が要求されます。
注意
Lync は Skype for Business に名称変更されました。 現在、Microsoft Dynamics 365 にはまだ "Lync" という表記が残っていますが、Dynamics 365 で Skype for Business を使用することができます。
StringAttributeMetadataの書式を定義する StringFormat 列挙体を使用します。Format は非推奨です。 その代わり、StringFormatName クラスを使用して、StringAttributeMetadata.FormatNameの値を設定します。
これは PhoneNumberの形式の値の設定を有効にし、それはStringFormat 列挙体には存在しません。
下位互換性については、Format または FormatName プロパティのいずれかを使用して、属性のフォーマット方法をコントロールするために値を設定できます。 既存のコードは Formatのみを使用する場合に機能し続けますが、FormatNameを使用することなく電話番号として属性をフォーマットすることはできなくなります。 両方のプロパティが設定されている場合、FormatName を使用して設定した値は適用されるものです。
StringFormatName クラスには次のメンバーが含まれます; 各メンバーは、メンバー名と同じ値の文字列を返します:
メンバーの名前および値 |
説明 |
|---|---|
フォーム フィールドはテキスト値を電子メール アドレスとして検証し、フィールドに mailto リンクを作成します。 |
|
PhoneNumber |
フォーム フィールドには Skype または Lync を使用して、電話の発信ためのリンクも含まれています。 |
PhoneticGuide |
内部のみで使用します。 |
Text |
フォームにテキスト ボックスが表示されます。 |
TextArea |
フォームにテキスト領域フィールドが表示されます。 |
TickerSymbol |
株式銘柄コードの見積もりを表示するためのリンクがフォームに表示されます。 |
URL |
URL をオープンするためのリンクがフォームに表示されます。 |
VersionNumber |
内部のみで使用します。 |
関連項目
Dynamics 365 メタデータと共に組織サービスを使用する
属性メタデータに関する作業
日時属性の動作と形式
エンティティ属性のメタデータのメッセージ
サンプル: 属性メタデータに関する作業
技術記事: Using Option Set Options with the REST Endpoint - JScript (REST エンドポイントでのオプション セットのオプションの使用 - JScript)
サンプル: 属性メタデータのファイルへのダンプ
サンプル: 属性候補リストのメタデータをファイルにダンプする
サンプル: 日時の動作の変換
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 著作権