次の方法で共有


イメージ属性

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

イメージ データを含むエンティティ レコードにより、アプリケーションで独特なエクスペリエンスを提供します。 開発者は、イメージ データの使用方法について理解する必要があります。

特定のシステム エンティティとユーザー定義エンティティだけがイメージをサポートしています。 イメージをサポートしているシステム エンティティの詳細については、「エンティティ イメージ」を参照してください。

このトピックの内容

属性のサポート

イメージ データの取得

イメージ データのアップロード

属性のサポート

イメージ属性をサポートするエンティティでは、エンティティ イメージ属性のSchemaNameは常に EntityImageです。 イメージ属性がエンティティに追加されると、一部の追加の属性は、次の表に示すようにそれをサポートするために作成されます。

スキーマ名

属性の種類名

説明

EntityImage_Timestamp

BigIntType

値は、イメージが最後に更新されときに表され、イメージの最新版がクライアントでダウンロードされ、キャッシュされることが確実にできるように使用されます。

EntityImage_URL

StringType

クライアントでエンティティ イメージを表示する絶対 URL。

この URL はこのように構成されます:

{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}
  • 0 : 組織 URL

  • 1 : エンティティの論理名

  • 2 : 属性の論理名

  • 3: EntityImageId の値。

  • 4: EntityImage_Timestamp の値

例:
https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444

EntityImageId

UniqueIdentifierType

イメージの一意の識別子

注意

現在の .NET アセンブリを使用しないクライアントに、"6.0.0.0"以上の値の SdkClientVersion を含める必要があるのは、ImageAttributeMetadata 属性を受け取るためです。詳細:SdkClientVersion

イメージ データの取得

RetrieveMultiple または Retrieve を使用すると EntityImage が含まれないのはColumnSetAllColumns プロパティが true に設定される場合です。 この属性のデータの潜在的なサイズのために、この属性を返すためには、明示的に要求する必要があります。

イメージを表すバイナリ データは、削除済みの ExecuteFetchRequest クラスを使用しては返されません。 代わりに、RetrieveMultipleRequest を使用する必要があります。

詳細:サンプル: エンティティ イメージを設定および取得する

イメージ データのアップロード

イメージを更新するには、ファイルのコンテンツを含むbyte[]EntityImage の値を設定します。 すべての画像は 144x144 ピクセルの正方形で表示されます。 イメージは、保存する前にデータのサイズを減らすため切り取られ、サイズ変更されます。

  • 少なくとも 1 つの側面が 144 ピクセルより大きいイメージは中心で 144x144 に切り取られます。

  • 両側が144未満のイメージは最小のサイドに正方形に切り取られます。

次の表に2つの例を示します。

サイズ変更前の画像

300x428

サイズ変更後の画像

144x144

2 番目のイメージ サイズ変更の例

91x130

2 番目のサイズ変更の例

91x91

詳細:サンプル: エンティティ イメージを設定および取得する

関連項目

Microsoft Dynamics 365 のエンティティの概要
Microsoft Dynamics 365 のエンティティ属性の概要
サンプル: エンティティ イメージを設定および取得する

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権