本文件提供 Salesforce 實體關係圖表 (ERD) 標記法和慣例的概觀,以協助您清楚解讀可在 資料模型圖庫中使用的產品資料模型。

ERD 又稱為資料模型,是資訊系統的圖形表示。它會顯示該系統中人員、物件、位置、概念和事件之間的關係。這是一種邏輯模型,可傳達資料的功能結構。在 Salesforce ERD 中,實體通常會對應至 Salesforce 資料庫中的物件。

實體是一種有意義的事物或物件,無論是實際或概念性的資訊都需要知道或保留。

實體在圖表中以圓角的方塊表示。每個實體方塊通常會提供兩個標籤 (若適用):

• 實體的邏輯名稱 (例如:此處所示範例中的「Salesforce 實體」。這可能與所代表 Salesforce 物件的單數標籤對應,但不一定。
• 您 Salesforce 組織中物件的「實體」API 名稱或開發人員名稱 (例如:範例中的「API 名稱」)。針對受管理封裝物件,圖表中列出的 API 名稱通常不會包含受管理封裝命名空間 (例如 vlocity_ins**),除非 Salesforce 或 Industry Cloud 使用多個受管理封裝。受管理封裝物件的 API 名稱結尾表示使用的自訂物件類型:「**c」用於一般自訂物件和自訂設定,「**mdt」用於自訂中繼資料,「**x」用於外部物件。

實體方塊也可以列出代表該實體屬性的一或多個屬性。屬性前面會加上「#」或「-」字元。

• “#” 表示屬於實體邏輯唯一索引鍵的一部分。在範例圖中,「使用者金鑰屬性」視為實體的使用者主要金鑰。
• “•” 表示非金鑰屬性。

每個實體關係圖都會從指定的雲端 (例如 Sales Cloud、Service Cloud 或 Marketing Cloud) 的觀點說明 Salesforce 資料模型。圖表的色彩主題會反映焦點中的雲。所有產業雲端 (例如 Financial Service Cloud、Health Cloud 和 Media Cloud) 都使用相同的「產業」色彩主題。

圖表上指定實體的色彩也具有特定意義。焦點雲端色彩使用其 Salesforce 品牌色彩來表示,包括以下一些範例。

下一節將檢閱參照下方 Sales Cloud 範例圖例的不同實體格式:

具有焦點雲端色彩的實體代表隨附該雲端授權的物件。

具有白色填補和黑色框線的實體代表一個物件,其授權與焦點雲端不同,且未由焦點雲端授權擴充。例如,在 Sales 或 Service Cloud ERD 上顯示的「帳戶」與「連絡人」實體將會顯示為白色且有黑色框線,因為這些物件適用於平台授權。

具有淺灰色填補及黑色框線的實體代表一個物件,其授權與焦點雲端不同,但焦點雲端會擴充該物件。例如,Commerce Cloud 會以其他欄位擴充基本 Product2 物件。擴充功能包含其他欄位、關係和記錄類型。

沒有框線的實體是虛擬的。在圖表中使用時,這些方塊會確認實體存在於網域的邏輯模型中,但實體不會在 Salesforce 中實作為實體物件。此實體的資料預期會透過已部署解決方案中的外部 API 呼叫或 Salesforce Connect 存取。

具有虛線框線的實體會在 Salesforce 中建模為記錄類型。在此處顯示的範例中,「公司帳戶」、「帳單帳戶」、「消費者帳戶」和「服務帳戶」子類型具有虛線框線,因為其會對應至透過 Communications Cloud 受管理封裝傳送的記錄類型。

具有虛線框線的實體是虛擬的。記錄類型或個別物件都不會用來區分 Salesforce 解決方案中的這些子類型。這些子類型會邏輯地描述網域中的概念,其有助於說明資料模型的功能。

實體的子類型是其發生次數的子集定義。在超類型實體內新增一組子類型時,超類型實體會描述共同屬性和關係,而子類型實體會顯示子類型特有的屬性和關係。在圖表標記法中,子類型互斥,這表示任何單一記錄都必須是單一子類型。

子類型可以有巢狀子類型來進一步區分發生次數。圖表中的子類型是邏輯的,但可透過三種方式之一對應至實體表示。子類型實體框線的穩定性會定義子類型在 Salesforce 資料模型中實作的方式。

具有實線的子類型實體具有實際物件,可追蹤該子類型的發生次數。在此處顯示的範例中,「連絡人」的「外部使用者」子類型具有固定的框線,因為註冊為「外部使用者」的連絡人會在「使用者」物件中使用記錄進行追蹤。

關係是兩個實體之間具名的明顯關聯。

行上或行周圍的標記和文字描述關係的基數、選用性和意義。

基數表示關係各側的相對次數。在標記法中,關係線的結尾表示該結尾的關係基數。結尾的冠子頁尾表示該結尾的許多實體事件可能與相反結尾的每個事件相關。端端缺少克勞的頁尾表示該端最多有一個實體發生的狀況可能與另一端的指定事件相關。

Salesforce 支援兩種關係欄位:對應欄位和父系-子系 (也稱為主要-詳細資料) 欄位。「父系子系」欄位類似於必要對應,但會套用相關實體之間的其他配對。刪除父系記錄時,關係的多側記錄會串聯刪除。此外,詳細資料記錄的可視性也由父系記錄的可視性所控制。

為了說明子系-父系關係與對應關係之間的差異,Salesforce ERD 會從 UML 借用鑽石標記法。關係單一端的鑽石表示該端的實體在關係中扮演主要角色。此類關係中多邊的實體是詳細資料或子系實體,可視為包含在父系實體內。

選擇性表示每個結尾的事件是否需要關係。作為概念,選擇性與基數密切相關,標記法會反映此近似度。透過關係另一端的線條之間的圓形或長條來表示選擇性。為什麼位於關係的另一端?將選擇性標記包含在行與基數相同的側邊。

在關係的多邊 (亦即克勞的腳) 上,線條上幾乎一律有圓形。這表示對於關係單一端的每個事件,關係的多邊可以有零對多個事件。

在關係的單數端,圓形和長條表示關係的冠子頁尾上實體的選擇性關係。圓形及長條平均值可在關係的單數端有零或一個次數,對於多重端的每個次數。

或者,在關係的單數端,雙長條表示關係的多側實體所需的關係。雙長條表示對於多邊的每個事件,關係的單數端必須有一個且只有一個事件。

即使 Salesforce 中的基本實體關係是選擇性的,關係的選擇性仍會顯示為必要。例如,「連絡人」上的 AccountId 欄位實際上是選擇性關係,但如果您忽略「私人連絡人」,則邏輯上需要「連絡人與帳戶」的直接關係。使用選用性指標很謹慎。在大多數的情況下,在 ERD 中顯示的選擇性會反映關係的基本選擇性。

除了基數與選擇性之外,兩個實體之間的每個關係都會表達某種意義,以區分該關係與相同兩個實體之間的其他關係。關係結束名稱 (如上圖中的「部分」和「組成」) 會定義關係的性質。

當您結合關係的基數、選用性和結束名稱時,這些名稱可以用來形成描述關係的句子。

從左到右:每個 (可能/必須) 為 <end name 1> (一且只有一/一或多個) 。

由右至左:每個 (可能/必須) 為 <end name 2> (一且只有一/一或多個) 。

例如,

從左到右:「每個連絡人必須主要是只有一個帳戶的連絡人。」由右至左:「每個帳戶主要代表一個或多個連絡人。」

關係線條以色彩編碼。由雲端在圖表焦點中新增的關係會以色彩繪製。黑色線條代表與焦點雲端不同授權的關係。

關係可在相同實體的兩個事件之間。這稱為遞迴關係。彎曲關係線用來表示遞迴關係。

Salesforce ERD 通常會排除大多數業務規則,以專注於資料模型的結構,但相互排除的關係是一個對結構具有資訊性的業務規則,因此請注意。互斥關係表示只有一個包含在弧度中的多個關係會用於任何指定的事件。請注意,兩個、三個或更多關係可以參與相同的相互排除關係。描述在此處顯示互斥關係的句子可能是:「每個實體都可以是只有一個「第一個其他實體」的例項,或是一個僅有一個「第二個其他實體」的例項。」

請注意,在 Salesforce ERD 中,通過弧度的中斷關係條列並非互斥關係的一部分。

正式 Salesforce 產品 ERD 遵循版面配置慣例來改善可讀性。這些版面配置慣例包括下列內容:

• 關係線條應一律為直線。
• 關係線條應垂直或水平繪製。在極少數情況下,如果無法這麼做,請在對角線上使用直線。
• 為了讓關係線條保持直接,實體方塊可以調整大小 (較高或較寬),以提供兩個實體之間關係的登陸位置。更重要的實體 (其關係較多) 會顯示在圖表上,以加強其重要性。
• 在整個單一 ERD 中,關係上的角色的腳應該一直位於關係條列的左側和/或頂端 (向上下版面配置),或一直位於關係條列的右側和/或底部 (向上右側版面配置)。此慣例提供清晰度,因為其會在圖表的相同區域收集類似實體,這對瞭解實體很有幫助。使用向上向下版面配置會導致圖表向上向下顯示,且子系實體位於父系實體的上方或左側 – 不過,這可確保圖表中最具體的實體位於圖表的左上角,進而使圖表更可彼此區分並可辨識。使用右上方版面配置慣例會導致相同的通用實體位於每個圖表左上方,但子系實體會位於父系實體的下方或右側。

嚴格遵循這些版面配置慣例會產生簡潔且易讀的圖表。

請務必檢查符合此標準的最新 Salesforce 資料模型 資料模型圖庫。