影像屬性

發行項
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 組件的用戶端需要包含 SdkClientVersion，其值為 '6.0.0.0' 或更高，以便接收 ImageAttributeMetadata 屬性。其他資訊：SdkClientVersion。