RelatedContentVO 是 WCM 內容服務中描述「關聯內容」的複合型別,定義在 https://busi.wcm.it.huawei.com 命名空間下。它的特色是欄位極多,且幾乎清一色是 nillable="true" 的 xsd:string——也就是說這是一個「鬆耦合、以字串承載一切」的資料載體。
<complexType name="RelatedContentVO">
<sequence>
<element name="url" nillable="true" type="xsd:string"/>
<element name="dislinkbyname" nillable="true" type="xsd:string"/>
<element name="dissystemlink" nillable="true" type="xsd:string"/>
<element name="dlinkclassid" nillable="true" type="xsd:string"/>
<element name="dlinkclassname" nillable="true" type="xsd:string"/>
<element name="DLinktypedestname" nillable="true" type="xsd:string"/>
<element name="dlinktypeid" nillable="true" type="xsd:string"/>
<element name="dlinktypename" nillable="true" type="xsd:string"/>
<element name="tactic" nillable="true" type="xsd:string"/>
<!-- ……其餘欄位依序排列 -->
</sequence>
</complexType>
1. 連結與關聯型定義(dlink* 系列)dlinktypeid、dlinktypename、DLinktypedestname、dlinkclassid、dlinkclassname、dislinkbyname、dissystemlink 這幾個欄位共同描述「這筆關聯是怎麼連過去的」——關聯型別、關聯分類、以及連結的顯示名稱與系統連結位址。這也是整份型別中語意最緊湊的一組。
2. 文件基本資訊(d* 系列)did、ddocname、ddoctitle、ddoctype、ddocauthor、ddocaccount、dcreatedate、dindate、doutdate、dextension 一類,對應內容庫中文書的識別碼、標題、類型、作者、帳號與各階段日期。這些欄位命名方式與 Oracle UCM/Stellent 的 metadata 慣例一致,前綴 d 代表文件層級屬性。
3. 發佈與流程狀態dpublishstate、dpublishtype、dreleasedate、dreleasestate、drevlabel、drevisionid、drevrank、drevclassid、dworkflowstate、dprocessingstate、dindexerstate、dcheckoutuser、ischeckedout、dsecuritygroup 等,用來表達審核、簽入簽出、修訂版本與索引狀態。
4. xhw_ 前綴的企業擴充欄位
數量最多的一組,涵蓋聯絡人資訊(xhw_contact_email、xhw_contact_tel、xhw_contact_city 等)、產品與方案分類(xhw_pbi1_lt 到 xhw_pbi7_lt、xhw_solution1_lt 到 xhw_solution3_lt)、多語系翻譯欄位(凡是以 _t、_lt 結尾者,通常對應某語言版本)、多媒體尺寸(xhw_media_width、xhw_media_height)以及保留欄位(xhw_reserved_field1_t 至 xhw_reserved_field10_d)。
5. 網站呈現與發佈控制xwebsites、xwebsitesection、xwebsiteobjecttype、xwebflag、xhidden、xdontshowinlistsforwebsites、xregiondefinition、xtemplatetype、xstoragerule、xtrashdelete* 等,決定這份內容會出現在哪些站點、用哪個樣板渲染、以及回收桶相關資訊。
把欄位名拆开看,尾碼其實是有意義的:_t 與 _lt 通常代表可翻譯的文字欄位,_d 代表日期,_m 代表多值欄位。知道這點之後,即使不查文件也能大致判斷某個保留欄位該塞什麼型式的值。
這份型別的另一個特色是幾乎沒有任何非同步欄位,全部以 optional 字串呈現。帶來的好處是版本擴充自由度極高,後端新增欄位不會弄壞既有客戶端;缺點則是型別安全幾乎為零:日期要用字串傳、數值要用字串傳、布林值也是字串,呼叫端必須自己做轉換與空值判斷。
因此實際接入時,建議不要直接把這個 VO 映射成你的領域物件,而是先轉成 dictionary 或 DTO,只取出當前情境用得到的少數欄位(多數場景其實只需要 url、ddoctitle、ddocname、dcreatedate 這幾個),其餘忽略即可。這樣後端欄位增減時,你的程式也不會跟著動。