イメージ属性

[アーティクル]
03/22/2023

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

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

属性のサポート

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

Note

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

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

イメージの一意の識別子

イメージデータの取得

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

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

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