您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

RelatedContentVO 欄位全解析:一個關聯內容物件的兩百個屬性怎麼讀

編輯:iOS 開發綜合

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 這幾個),其餘忽略即可。這樣後端欄位增減時,你的程式也不會跟著動。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved