イメージ属性

[アーティクル]
03/04/2017

公開日: 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	イメージの一意の識別子

スキーマ名

属性の種類名

説明

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 が含まれないのはColumnSet。AllColumns プロパティが true に設定される場合です。この属性のデータの潜在的なサイズのために、この属性を返すためには、明示的に要求する必要があります。

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

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