自訂實體屬性中繼資料

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

使用 AttributeMetadata 類別擷取現有屬性。 此類別是由 RetrieveAttributeRequest 訊息傳回。AttributeMetadata 類別繼承自抽象 MetadataBase 類別。

針對每個屬性類型使用特定類別搭配 CreateAttributeRequest 訊息來更新屬性或建立自訂屬性。

注意

您可以在建立後透過程式設計的方式存取自訂屬性，但是您必須將它們新增至實體表單並發行，使用者才能看見它們。

屬性類型

下表列出您可以使用的每種類型的 Attribute。 每個屬性都是繼承自 AttributeMetadata 類別。

類別	應用程式標籤	描述
BooleanAttributeMetadata	兩個選項	布林值屬性。 您可以指定這兩個選項的文字。 新增至表單時，欄位屬性 (Property) 會控制要將屬性 (Attribute) 顯示為兩個選項按鈕、一個核取方塊或一份清單。
DateTimeAttributeMetadata	日期及時間	日期和時間屬性。 您可以指定行為來儲存有或沒有時區資訊的日期和時間值，以及指定格式來定義值的顯示格式。 其他資訊：日期和時間屬性的行為與格式 注意 如果您使用 Microsoft Dynamics CRM Online 2015 更新 1 或 Microsoft Dynamics 365 (內部部署)，則所有日期和時間屬性現在都支援 1/1/1753 上午 12:00 以前的值。
DecimalAttributeMetadata	十進位數	decimal 屬性。 您可以指定有效位數等級，最多 10 個小數位數，以及從 -100,000,000,000 到 100,000,000,000 的最小值和最大值。
DoubleAttributeMetadata	浮點數	double 屬性。 您可以指定有效位數等級，最多 5 個小數位數，以及從 -100,000,000,000 到 100,000,000,000 的最小值和最大值。 注意 DoubleAttributeMetadata 會取代 Microsoft Dynamics CRM 4.0 中使用的 FloatAttributeMetadata。
ImageAttributeMetadata	影像	影像屬性。 每個實體可以有一個影像屬性。 某些系統實體擁有影像屬性，而新的影像屬性不可新增至沒有影像屬性的系統實體。 您可以將影像屬性新增至自訂實體。 所有影像屬性都有 SchemaName 'EntityImage' 和 LogicalName 'entityimage'。 自訂影像屬性的名稱中將不會使用解決方案發行者自訂首碼。其他資訊：實體影像。
IntegerAttributeMetadata	整數	整數屬性。 您可以指定從 -2,147,483,648 到 2,147,483,647 的最大值和最小值。 此屬性可以格式化，以使用 IntegerFormat 列舉建立下列類型的欄位： Duration：顯示包含時間間隔的下拉式清單。 使用者可以從清單中選取值，或是輸入代表分鐘數的整數值。 TimeZone：顯示包含時區清單的下拉式清單。 Language：顯示包含已針對組織啟用的語言清單的下拉式清單。 如果未啟用其他語言，則基礎語言將會是唯一選項。 儲存的值是語言的 LCID 值。
LookupAttributeMetadata	查詢	使用 CreateOneToManyRequest 訊息建立實體關聯時所建立的屬性。
MemoAttributeMetadata	多行文字	備忘屬性。 顯示為表單中的文字方塊欄位。 長度上限為 1048576 個字元。
MoneyAttributeMetadata	貨幣	金額屬性。 您可以指定介於 -922,337,203,685,477 和 922,337,203,685,477 之間的最大值和最小值。 有效位數等級可以使用 PrecisionSource 屬性設定： 當有效位數設為零 (0) 時，會使用 MoneyAttributeMetadata.Precision 值。 當有效位數設為一 (1) 時，會使用 Organization.PricingDecimalPrecision 值。 當有效位數設為二 (2) 時，會使用 TransactionCurrency.CurrencyPrecision 值。
PicklistAttributeMetadata	選項集	挑選清單屬性。 此屬性提供一組選項，會在下拉式清單中顯示。 您可以建立挑選清單屬性，其中可包含它自己的選項或使用全域選項組。
StateAttributeMetadata	狀態	狀態屬性是在實體建立時自動建立。 注意 此屬性可用的選項為唯讀。
StatusAttributeMetadata	狀態原因	狀態屬性是在實體建立時自動建立。 每個選項都必須與實體的 StateAttributeMetadata 屬性相關聯。 使用 InsertStatusValueRequest 訊息更新此屬性可用的選項。 注意 每個 StatusOption 都必須參考特定狀態屬性值，因為狀態值取決於特定狀態值。
StringAttributeMetadata	單行文字	請參閱StringAttributeMetadata 格式。

StringAttributeMetadata 格式

字串屬性可以格式化，允許使用 Lync 或 Skype 起始通話的連結。 這類變更需要將新的 FormatName 屬性新增至 StringAttributeMetadata 類別，並且取代 Format 屬性。

注意

Lync 已經更名為「商務用 Skype」。 目前，您還是會看到 Microsoft Dynamics 365 中提及 "Lync"，但 Dynamics 365 實際上會搭配商務用 Skype 運作。

使用 StringFormat 列舉定義 StringAttributeMetadata.Format 的格式的方式已被取代。 請改用 StringFormatName 類別設定 StringAttributeMetadata.FormatName 的值。

這樣就可以設定 PhoneNumber 的格式值，它不存在 StringFormat 列舉中。

為提供回溯相容性，您可以使用 Format 或 FormatName 屬性設定一個值來控制格式化屬性的方式。 您現有的程式碼會持續運作，如果您只有使用 Format，但是在未使用 FormatName 的情況下，您無法將屬性格式化為電話號碼。 如果這兩個屬性都設定，則使用 FormatName 設定的值會是套用的值。

StringFormatName 類別包含下列成員；每個成員都會傳回一個字串，其中包含與成員名稱相同的值：

成員名稱和值	描述
Email	表單欄位會將文字值驗證為電子郵件地址，並且在欄位中建立 mailto 連結。
PhoneNumber	表單欄位包含使用 Lync 或 Skype 起始通話的連結。
PhoneticGuide	僅供內部使用。
Text	表單會顯示文字方塊。
TextArea	表單會顯示文字區域欄位。
TickerSymbol	表單會顯示一個連結，該連結會開啟並顯示股票看板代號的報價。
URL	表單會顯示開啟 URL 的連結。
VersionNumber	僅供內部使用。

另請參閱

搭配使用組織服務與 Dynamics 365 中繼資料
使用屬性中繼資料
日期和時間屬性的行為與格式
實體屬性中繼資料訊息
範例：使用屬性中繼資料
技術文章：使用選項組選項與 REST 端點 - JScript
範例：將屬性中繼資料傾印至檔案
範例：將屬性挑選清單中繼資料加入檔案
範例：轉換日期和時間行為

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權