列印      開啟 PDF 版的線上說明


上一個主題

下一個主題

JoinFieldValue

記錄類型可以透過外部索引鍵來參考其他記錄類型。當記錄類型的某欄位使用外部索引鍵參考其他記錄類型的欄位時,前者即稱為聯結欄位 (Joined Field)。例如,大部分記錄類型的 OwnerId 欄位就是外部索引鍵,用以參考「使用者」記錄類型。而多數記錄的「負責人」欄位則是聯結欄位,以使用 OwnerId 外部索引鍵來參考「使用者」記錄類型的「別名」欄位。

在 Expression Builder 中,JoinFieldValue 函數若已指定參考記錄類型和相關外部索引鍵欄位,此函數將傳回聯結欄位的值。JoinFieldValue 函數也能擷取參考記錄類型未直接聯結至參考方物件的其他欄位,讓您可透過相關記錄類型來查閱多種記錄類型的欄位。

如果參考記錄類型的 ID 欄位在您設定工作流程規則的記錄類型呈現為外部索引鍵,則您可以使用 JoinFieldValue 函數來擷取參考記錄類型的欄位值。

此外,您可以使用所有記錄類型都可使用的下列外部索引鍵欄位,來擷取「使用者」記錄類型的欄位值:

  • CreatedById
  • ModifiedById

附註: JoinFieldValue 函數無法傳回「活動」記錄類型的下列欄位值:支付交易數、詳述產品數量、促銷項目發送數量及樣品發送數量。此限制是因 Oracle CRM On Demand 計算這些欄位值的方式所致。

語法

JoinFieldValue (ref_record_type, foreign_key, field_name)

結果類型

字串。

如果發生錯誤或所要求的欄位值是空的,將傳回長度為零的字串。

引數

下表說明函數的引數。

引數

描述

ref_record_type

與語言無關的參考記錄類型名稱(與語言無關的名稱 不會隨著使用者語言變更而改變)。

這個引數必須以欄位字串識別碼括住,例如:

'<Account>'

foreign_key

常值或運算式,傳回參考記錄類型 (由 ref_record_type 引數指定) 的有效資料列 ID。如果資料列 ID 無效,函數將傳回長度為零的字串。直接欄位參考必須以欄位識別碼括住,例如:

[<AccountId>]

field_name

參考記錄類型 (由 ref_record_type 引數指定) 與語言無關的欄位名稱。如果參考記錄類型沒有該欄位,將會傳回錯誤。欄位名稱必須以欄位字串識別碼括住,例如:

'<Type>'

備註:在此主題的範例運算式中所使用的欄位名稱及欄位名稱語法與語言無關,是在 Expression Builder 第 29 版 Service Pack 1 較早的版次中使用的欄位名稱與欄位名稱語法。這些範例仍然有效。然而,若您從 Expression Builder 第 29 版 Service Pack 1 或更新版本的欄位清單中選取運算式的對應欄位,則欄位名稱與欄位名稱語法將會與範例中所顯示的不同。建議您一律從 Expression Builder 的欄位清單中選取運算式的欄位,以讓欄位名稱與欄位名稱語法隨時保持正確。如需有關運算式中欄位名稱與欄位名稱語法的詳細資訊,請參閱關於運算式

範例

範例 1:商務程序需要依賴工作流程規則,在記錄的負責人變更時查閱新負責人的名稱。當記錄的負責人變更時,記錄只會更新 OwnerId 外部索引鍵欄位。因此,工作流程規則使用下列條件將無法查閱記錄的新負責人:

PRE('<Owner>') <> [<Owner>]

不過,藉由使用下列條件,工作流程規則便能查閱記錄的新負責人:

PRE('<Owner>') <> JoinFieldValue('<User>',[<OwnerId>],'<Alias>')

範例 2:使用下列運算式,可取得記錄原先負責人的電子郵件地址:

JoinFieldValue('<User>',PRE('<OwnerId>'),'<EMailAddr>')

範例 3:使用下列運算式,可取得記錄目前負責人的電子郵件地址:

JoinFieldValue('<User>',[<OwnerId>],'<EMailAddr>')

範例 4:商務程序需要傳送服務要求電子郵件給聯絡人。在送出電子郵件之前,將由工作流程規則檢查該聯絡人是否同意接收電子郵件。此一工作流程規則 (基於服務要求記錄類型) 具有下列條件:

JoinFieldValue('<Contact>',[<ContactId>],'<NeverEmail>')<> 'Y'

範例 5:使用下列運算式,可取得服務要求的主要客戶銷售地區:

JoinFieldValue('<Territory>', JoinFieldValue('<Account>', [<AccountId>], '<TerritoryId>'),'<TerritoryName>')

相關主題

如需Expression Builder的相關資訊,請參閱下列主題:


2016年10月 Copyright © 2005, 2016, Oracle 及/或其關係機構。版權所有. Legal Notices.