qchat業(yè)務(wù)終端參數(shù)配置接口要求-系統(tǒng)和用戶數(shù)據(jù)分冊v1.6

1、中國電信中國電信 QchatQchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求系統(tǒng)和用戶數(shù)據(jù)分冊系統(tǒng)和用戶數(shù)據(jù)分冊（征求意見稿）（征求意見稿）中國電信股份有限公司廣州研究院中國電信股份有限公司廣州研究院中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 2頁二零零九年十一月二零零九年十一月目錄目錄1 1范圍范圍.3 31.1文檔更改歷史.32 2縮略語縮略語.4 43 3管理終端數(shù)據(jù)配置文檔的管理終端數(shù)據(jù)配置文檔的 XCAPXCAP 服務(wù)服務(wù).5 53.1終端數(shù)據(jù)配置文檔.53.2支持的 HTTP 方法.53.3支持的 HTTP 頭.53.3.1適用于所

2、有操作的頭.53.3.2PUT 必須攜帶的頭 .53.3.3用于條件操作 HTTP 頭.63.4終端數(shù)據(jù)配置服務(wù)器 XCAP 請求 URL .73.5終端數(shù)據(jù)配置服務(wù)器器后向兼容對(duì)客戶端 XML 解析的要求.84 4終端數(shù)據(jù)配置服務(wù)器終端數(shù)據(jù)配置服務(wù)器 XCAPXCAP 接口規(guī)范接口規(guī)范 .9 94.1概述.94.2正常響應(yīng).94.2.1正常響應(yīng)描述.94.3錯(cuò)誤響應(yīng).94.3.1錯(cuò)誤響應(yīng)描述.104.4操作終端數(shù)據(jù)配置文檔.144.4.1 Data Schema.144.4.2使用場景.175 5終端數(shù)據(jù)配置服務(wù)器短消息（終端數(shù)據(jù)配置服務(wù)器短消息（SMSSMS）接口規(guī)范）接口規(guī)范.26265

3、.1TDCS 通知的短消息負(fù)荷 .265.2收到通知后如何產(chǎn)生獲取用戶配置文檔更新的 URL .276 6終端數(shù)據(jù)配置服務(wù)器客戶端的配置信息終端數(shù)據(jù)配置服務(wù)器客戶端的配置信息.28286.1配置信息.286.2主副地址切換建議.287 7對(duì)手機(jī)終端和用戶管理平臺(tái)群組操作能力的建議對(duì)手機(jī)終端和用戶管理平臺(tái)群組操作能力的建議.2929中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 3頁1 1范圍范圍終端數(shù)據(jù)配置服務(wù)器(Terminal Data Configuraiton Server: TDCS) 是用戶終端配置數(shù)據(jù)管理和下發(fā)的 XML 文檔管理服務(wù)器.文檔的管理操作包

4、括新建/讀取/修改. 這些操作是通過 XCAP 接口完成的。終端數(shù)據(jù)配置服務(wù)器(TDCS) 還提供數(shù)據(jù)下發(fā)給終端的能力。下發(fā)通知是通過短信實(shí)現(xiàn)的。本文定義終端與終端數(shù)據(jù)配置服務(wù)器(TDCS)進(jìn)行通信時(shí)的接口規(guī)范。本文用 TDCS 表示終端數(shù)據(jù)配置服務(wù)器。1.11.1文檔更改歷史文檔更改歷史時(shí)間時(shí)間說明說明2009.2.12以下為更改的主要內(nèi)容：: 增加 content-type application/xcap-el+xml3.4 : 增加對(duì) FQDN 使用的解釋4.4.2: 修改示例消息中的幾處錯(cuò)誤。.2: 增加使用 CR order 的注意事項(xiàng).5.1 : 短消

5、息負(fù)荷更改5.2 : 終端獲取 XUI 的方法更改 6.1 : 服務(wù)器故障轉(zhuǎn)移定時(shí)參數(shù)取值修改6.2 : 增加了主副地址切換的方法建議7 : 增加了手機(jī) UIM 卡更換的考慮另外修改了一些文字錯(cuò)誤。200.2.4: 響應(yīng)消息改為 201 Created. 并在 .1 中加入對(duì)已有 Call Restriction 替換的注釋。200：修改 TDCS 采用 SMGP 協(xié)議要求及流程說明。200：修改 TDCS 發(fā)送的為，以及針對(duì)的樣例“QCHAT”修改為“PTT”。2009.8.5修改配置信息更新流程圖。2009.8.3114.4.

6、1 的 data schema 中加入 xs:any 元素以備將來擴(kuò)展2. 文檔 URI 示例中 改為3. 文檔示例中用戶域名改為 PTT2009.11.18更正圖 5-1 中的協(xié)議標(biāo)識(shí)。中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 4頁2 2縮略語縮略語Term/AcronymTerm/AcronymDefinitionDefinition3GPP3rd Generation Partnership ProjectAUIDApplication Usage IDFQDNFully Qualified Domain NameTDCSTerminal Data Con

7、figuration ServerHTTPHypertext Transfer ProtocolIETFInternet Engineering Task ForceOMAOpen Mobile AllianceSMPPShort Message Peer-to-peer ProtocolSMSCShort Message Service CenterURI Uniform Resource IdentifierURLUniform Resource LocatorXCAPXML Configuration Access ProtocolXDMXML Document ManagementXD

8、MCXML Document Management ClientXDMSXML Document Management ServerXMLExtensible Markup LanguageXUIXCAP User Identity中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 5頁3 3管理終端數(shù)據(jù)配置文檔管理終端數(shù)據(jù)配置文檔的的 XCAPXCAP 服務(wù)服務(wù)3.13.1終端數(shù)據(jù)配置文檔終端數(shù)據(jù)配置文檔在 TDCS 中，存在用戶終端配置文檔，即適用于某一用戶的終端配置文檔。該文檔包含該用戶的終端進(jìn)行 PTT 適用的配置信息。3.23.2支持的支持的 HTTPHTTP

9、方法方法TDCS 支持以下 HTTP/XCAP 操作:HTTP GET （獲取用戶配置文檔信息）HTTP PUT (新建或修改用戶配置文檔)HTTP DELETE （修改用戶配置文檔中某些信息）3.33.3支持的支持的 HTTPHTTP 頭頭3.3.1適用于所有操作的頭用于認(rèn)證的頭: ClientID“ClientID” 在每個(gè)HTTP請求中都必須攜帶. “ClientID” 可以被 WAP 網(wǎng)關(guān)或用戶群組管理平臺(tái)加入，并隨請求消息送到TDCS。ClientID 應(yīng)該攜帶明文的用戶 ID 信息。TDCS 信任“ClientID”所包含的用戶 ID就是請求發(fā)起者的用戶 ID。 注意

10、：運(yùn)營商也可以選用其它的 HTTP 頭作為用于認(rèn)證的頭，如：P-Asserted-Identity. 但所有的發(fā)送到 TDCS 的請求必須使用相同的頭。用于識(shí)別客戶端協(xié)議版本的頭: GLMSClientVersion“GLMSClientVersionGLMSClientVersion” 在每個(gè)HTTP請求中都必須攜帶. TDCS 客戶端用“GLMSClientVersionGLMSClientVersion”表示它所實(shí)現(xiàn)的 TDCS 協(xié)議版本。對(duì)應(yīng)于本規(guī)范，版本號(hào)應(yīng)為“11.01”注意：運(yùn)營商也可以選用其它的 HTTP 頭作為用于版本標(biāo)識(shí)的頭，如：GLMS-Group-Vers

11、ion. 但所有的發(fā)送到 TDCS 的請求必須使用相同的頭。3.3.2 PUT 必須攜帶的頭對(duì) XCAP PUT 操作 , 下列 HTTP 頭必須攜帶：“Content Type” 和 “Content Length”. 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 6頁Content TypeContent-Type 頭域指定所包含的消息體的媒體類型。其格式為:Content-Type = Content-Type : media-typeTDCS 中有效的 content type 為:Content-Type: application/user-

12、config+xmlContent-Type: application/xcap-el+xml在不同場景下的具體使用參見第 4 章。Content LengthContent-Length 頭域指定消息體的長度 （8 位字節(jié)數(shù)）。其格式為：Content-Length = Content-Length : 1*DIGIT例如: Content-Length: 34953.3.3用于條件操作 HTTP 頭HTTP 定義了幾個(gè)可以被客戶端用來做條件請求的頭域：If-None-Match 和 If-Match。 客戶端可以根據(jù)所請求資源的實(shí)體標(biāo)簽（entity tag）來做條件請求.

13、這些條件請求的頭域在請求消息里是可選用的. 條件請求的頭域可以解決并發(fā)請求的沖突問題。If-MatchIf-Match 請求頭域被 HTTP 方法(PUT/DELETE)用來做有條件操作. 對(duì)一個(gè)或多個(gè)從群組服務(wù)器獲得的實(shí)體，XDS 客戶端可以在請求的If-MatchIf-Match頭中包含某個(gè)實(shí)體的entity tag 以確認(rèn)它所具有的那個(gè)實(shí)體是最新的.If-Match 頭可以被用在以下場景中:條件 PUTXDM 客戶端想增加或修改服務(wù)器 XDM 文檔中的某個(gè)元素（element），并且希望服務(wù)器所具有的文檔版本和客戶端當(dāng)前所具有的那個(gè)文檔相同時(shí)才能修改?？蛻舳丝梢栽谡埱笾邪?/p>

14、If-Match 頭, 并將客戶端所具有的實(shí)體標(biāo)簽（entity tag）值寫在里面. 如果文檔已經(jīng)改變，群組服務(wù)器會(huì)拒絕這個(gè)請求返回 412 （條件失敗）. 在這種情況下，客戶端需要重新用 GET 請求從服務(wù)器獲取這個(gè)文檔并保存服務(wù)器在 200 OK 中返回的新的實(shí)體標(biāo)簽（entity tag）。 客戶端可以把新的實(shí)體標(biāo)簽（entity tag）放在 If-Matc 頭中重新請求修改文檔。 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 7頁如果操作成功， 響應(yīng)消息的 etag 頭會(huì)包含剛被修改過的資源的新的實(shí)體標(biāo)簽（entity tag）。 條件 DELETE X

15、DM 客戶端也可以在 DELETE 請求中包含 If-Match 頭來做條件刪除. DELETE 請求的 200 OK 響應(yīng)會(huì)包含一個(gè) etag 頭域, 帶有所刪除元素所在的整個(gè)文檔的實(shí)體標(biāo)簽（entity tag）If-None-MatchIf-None-Match 請求頭域可以和 GET 請求方法一起使用做條件請求. If-None-Match 頭中可以包含客戶端以前從服務(wù)器所獲取的資源實(shí)體的實(shí)體標(biāo)簽（entity tag）。If-None-Match 頭可以被用在以下場景中:條件 GET 當(dāng) XDM 客戶端本地存有一個(gè)文檔的版本，它可以做條件 GET 來判斷服務(wù)器對(duì)統(tǒng)一文檔

16、是否有更新。如果本地文檔仍然是最新的，客戶端就不會(huì)重新下載文檔，以此節(jié)省網(wǎng)絡(luò)的使用。為了達(dá)到這個(gè)目的，客戶端在 GET 請求中攜帶 If-None-Match 頭域，其中包含客戶端當(dāng)前文檔的實(shí)體標(biāo)簽（entity tag）. 終端數(shù)據(jù)配置服務(wù)器如果發(fā)現(xiàn)服務(wù)器文檔標(biāo)簽和客戶端不同，會(huì)響應(yīng) 200 OK. 如果服務(wù)器文檔標(biāo)簽和客戶端相同, 服務(wù)器會(huì)響應(yīng) 304 Not Modified.3.43.4終端數(shù)據(jù)配置服務(wù)器終端數(shù)據(jù)配置服務(wù)器 XCAPXCAP 請求請求 URLURL1. XCAP 根節(jié)點(diǎn) （XCAP root）XCAP 根定義了所有可被請求的資源所在的位置. XCAP 根用 HTTP U

17、RI 表示, 被稱為 XCAP根 RUI。對(duì)終端數(shù)據(jù)配置服務(wù)器 XCAP 根 被定義為/TDCS FQDN/tdcs-services/.注：在具體構(gòu)造 HTTP 請求時(shí)，TDCS FQDN 應(yīng)該為 TDCS 服務(wù)器的地址，并且在發(fā)出 HTTP請求時(shí)放在 HOST HTTP 頭中，而不是 Request-URI 中。另外，由于 TDCS 有主副地址，TDCS FQDN 可能是兩個(gè)。（關(guān)于主副地址，請參見第 6 章）2. 文檔選擇器 （Document Selector）中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 8頁在文檔根節(jié)點(diǎn)下的每一個(gè) XML 文檔使用文檔選擇

18、器作為唯一標(biāo)識(shí)，文檔選擇器類似于由多個(gè)路徑標(biāo)識(shí)符組成的一個(gè)完整路徑，使用“/”作為路徑分隔符. 第一個(gè)路徑部分必須是XCAP AUID。終端數(shù)據(jù)配置服務(wù)器支持以下 XCAP AUID:USER-CONFIG:USER-CONFIG: 用來進(jìn)行群組的操作用來進(jìn)行群組的操作在每個(gè) AUID 下有兩個(gè)子 XCAP 分支. 一個(gè)稱為 “用戶樹”（“user”tree）, 保存某個(gè)用戶的終端配置文檔“index”。 另一個(gè)分支是“全局樹”（“global”tree）, 保存適用于所有用戶的終端配置文檔“index”. AUID 之后的路徑部分必須是global 或 users. 每個(gè)用戶對(duì)服務(wù)器而言都有

19、一個(gè)用戶名，被稱為 XCAP 用戶標(biāo)識(shí)符（XCAP User Identifier: XUI). 文檔選擇器余下的部分 (global 或 XUI 以后的路徑)指向具體的文檔名. 終端數(shù)據(jù)配置文件名為“index”，并被保存在 users 樹下。3. 節(jié)點(diǎn)選擇器 （Node selector）節(jié)點(diǎn)選擇器指定 XML 文檔中具體被操作的節(jié)點(diǎn). 節(jié)點(diǎn)選擇器指向 XML 元素或元素屬性. 4. 產(chǎn)生 TDCS 請求 URL 訪問終端數(shù)據(jù)配置服務(wù)器的某個(gè)用戶的 XML 文檔, 使用以下的 URL 格式:http:/FQDN of TDCS server/service name/AUID/users/

20、XUI of user/index訪問 TDCS 文檔的 XML 元素，使用以下的 URL 格式:document selector/node selector3.53.5終端數(shù)據(jù)配置服務(wù)器器后向兼容對(duì)客戶端終端數(shù)據(jù)配置服務(wù)器器后向兼容對(duì)客戶端 XMLXML 解析的要求解析的要求這里的終端數(shù)據(jù)配置服務(wù)器客戶端指所有與 TDCS 進(jìn)行 HTTP/XCAP 通信客戶端應(yīng)用程序。TDCS 會(huì)不斷加入新的功能. 群組管理的 XML schema 在將來可能會(huì)被擴(kuò)展。TDCS 升級(jí)到新的版本而客戶端有可能仍然是舊的版本。為了使TDCS 后向兼容，TDCS 客戶端的實(shí)現(xiàn)必須要遵循以下建議:oTDCS 客戶

21、端必須忽略服務(wù)器返回的合法的 XML 文檔中不能識(shí)別的 XML 元素 或?qū)傩?，而不是?bào)錯(cuò)退出對(duì)文檔的處理. 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 9頁4 4終端數(shù)據(jù)配置服務(wù)器終端數(shù)據(jù)配置服務(wù)器 XCAPXCAP 接口規(guī)范接口規(guī)范4.14.1概述概述TDCS 為客戶端應(yīng)用提供 XCAP 接口來管理服務(wù)器存儲(chǔ)的終端配置 XML 文檔. 客戶端應(yīng)用可以 新建/讀取 XML 文檔及其 XML 元素和屬性. 本章給出終端數(shù)據(jù)配置服務(wù)器 XCAP 接口規(guī)范。4.24.2正常響應(yīng)正常響應(yīng)如果客戶端的請求被成功處理，TDCS支持成功的 2xx 狀態(tài)碼：狀態(tài)碼狀態(tài)碼描述描述2

22、00OK201Created4.2.1正常響應(yīng)描述正常響應(yīng)描述200 (OK) 響應(yīng)當(dāng) XCAP GET/PUT/DELETE 請求被成功處理時(shí)返回.示例消息:HTTP/1.1 200 OKetag: bcbcbcContent-Length: 0. . .201 (Created) 響應(yīng)當(dāng) XCAP PUT 請求被執(zhí)行并其請求的 resrouce 已經(jīng)產(chǎn)生.示例消息:HTTP/1.1 201 Createdetag: ababab. . .Content-Length: 0中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 10頁4.34.3

23、錯(cuò)誤錯(cuò)誤響應(yīng)響應(yīng)XCAP 使用與HTTP協(xié)議相同定義的錯(cuò)誤響應(yīng)狀態(tài)碼。TDCS支持3類錯(cuò)誤狀態(tài)碼：3xx, 4xx, 和 5xx. 3xx 是重定向狀態(tài)碼，指示客戶端為滿足請求去采取其它的行動(dòng)。4xx 是客戶端錯(cuò)誤碼，指出客戶端請求可能包含的錯(cuò)誤. 5xx 是服務(wù)器錯(cuò)誤碼，指示服務(wù)器知道自己遇到問題而不能處理當(dāng)前的請求。狀態(tài)碼狀態(tài)碼描述描述304Not Modified400Bad Request403Forbidden404Not Found405Method Not Allowed409Conflict412Precondition Failed415Unsupported Media T

24、ype500Internal Server Error503Service Unavailable Error.1錯(cuò)誤響應(yīng)描述錯(cuò)誤響應(yīng)描述304 (Not Modified) 響應(yīng)在條件 GET 中使用. 客戶端在 If-None-Match 頭中包含的 etag 與服務(wù)器所具有的該文檔etag 相同響應(yīng)消息示例:HTTP/1.1 304 Not ModifiedContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0403 (Forbidden) 響應(yīng)可以對(duì) XCAP GET/PUT

25、/DELETE 操作響應(yīng). TDCS 不能處理該請求，盡管理解該請求。 TDCS可能攜帶請求被拒絕的原因在 403 響應(yīng)的“reason-phrase”中。響應(yīng)消息示例:HTTP/1.1 403 Forbidden. The request is not allowed since the associated feature is locked.Content-Type: text/plain; charset=ISO-8859-1Content-Length: 0400 (Bad Request) 響應(yīng)可以對(duì) XCAP GET/PUT/DELETE 操作響應(yīng)。由于語法錯(cuò)誤 T

26、DCS 不能理解該請求.中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 11頁響應(yīng)消息示例:HTTP/1.1 400 Bad RequestContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0404 (Not Found) 響應(yīng)可以對(duì) XCAP GET/PUT/DELETE 操作響應(yīng). TDCS 不能找到被請求的資源。響應(yīng)消息示例:HTTP/1.1 404 Not FoundContent-Type: text/plain; charset=ISO-8859-1Content-Leng

27、th: 0405 (Method Not Allowed) 響應(yīng)可以對(duì) XCAP 請求響應(yīng). TDCS 理解請求的方法但是不支持該操作響應(yīng)消息示例:HTTP/1.1 405 Method Not AllowedContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0409 (Conflict) 響應(yīng)可以對(duì) XCAP GET/PUT/DELETE 操作響應(yīng)。請求因?qū)Ξ?dāng)前資源的沖突而不能完成。409 響應(yīng)可攜帶 XML 消息體來指定沖突的具體原因。以下是 409 響應(yīng)中所包含的“xcap-error” d

28、ata schema. “xcap-error” 可以用來給出具體沖突原因?？蛻舳藨?yīng)該支持以下 schema： 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 12頁 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 13頁 響應(yīng)消息示例:HTTP/1.1 409 ConflictContent-Type: application/xcap-error+xmlContent-Length: xxxxx中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 14頁412 (Precondition Failed)

29、響應(yīng)可以對(duì) XCAP GET/PUT/DELETE 操作響應(yīng)。 客戶端可以攜帶 If-Match 頭域來包含客戶端所具有的 etag. 如果文檔在服務(wù)器中已改變，412 就會(huì)被返回.響應(yīng)消息示例:HTTP/1.1 412 Precondition FailedContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0415 (Unsupported Media Type) 響應(yīng)可以對(duì) XCAP GET/PUT/DELETE 操作響應(yīng)。 終端數(shù)據(jù)配置服務(wù)器不接受請求消息中的內(nèi)容編碼。響應(yīng)消息示例:HTTP/1.1 41

30、5 Unsupported Media TypeContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0500 (Internal Server Error) 響應(yīng)可以對(duì) XCAP GET/PUT/DELETE 操作響應(yīng). 終端數(shù)據(jù)配置服務(wù)器遇到不可預(yù)料的情況不能完成請求.響應(yīng)消息示例:HTTP/1.1 500 Internal Server ErrorContent-Type: text/plain; charset=ISO-8859-1Content-Length: 00503 (Service

31、Unavailable) 響應(yīng)可以對(duì) XCAP GET/PUT/DELETE 操作響應(yīng). 終端數(shù)據(jù)配置服務(wù)器因過載或維護(hù)等原因暫時(shí)不能處理請求.響應(yīng)消息示例:HTTP/1.1 503 Service UnavailableContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 15頁4.44.4操作終端數(shù)據(jù)配置文檔操作終端數(shù)據(jù)配置文檔.1DataData SchemaSchemaTDCS 支持以下終端數(shù)據(jù)配置文檔 schema。 中國電信

32、qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 16頁 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 17頁 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 18頁.2使用場景使用場景場景總結(jié)創(chuàng)建/替換用戶終端數(shù)據(jù)配置文檔查詢用戶終端數(shù)據(jù)配置文檔增加 Call Restriction刪除 Call Restriction查詢和更新用戶其它配置參數(shù)創(chuàng)建創(chuàng)建/ /替換用戶終端數(shù)據(jù)配置文檔替換用戶終端數(shù)據(jù)配置文檔.1. 概述該操作用來創(chuàng)建/替換適用于某用戶的終端數(shù)據(jù)配置文檔

33、.只有系統(tǒng)管理員可以創(chuàng)建/替換用戶的終端配置文檔。成功的 XCAP PUT 操作會(huì)返回 201 Created 響應(yīng)（創(chuàng)建文檔）或 200 OK 響應(yīng) （替換文檔）. 失敗的操作會(huì)返回 403 (Forbidden), 404 (Not Found) , 409 (Conflict) 或 412 (Precondition Failed)。.2. 用例AdminTDCS1. XCAP PUT2.a 201 Created2.b 403/404/409/412圖 4-1 管理員創(chuàng)建用戶終端書記配置文檔1. 管理員創(chuàng)建一個(gè)用戶終端數(shù)據(jù)配置文檔。它發(fā)起一個(gè) XCAP PUT 請求中國電

34、信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 19頁請求消息:PUT http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index HTTP/1.1. . .ClientID: requestors XUIContent-Type: application/user-config+xmlContent-Length: xxxxxdocument content請求消息示例: 創(chuàng)建不含 Call Restrictions 的配置文件PUT http:/ HTTP/1.1. . .Clie

35、ntID: systemadmPTTContent-Type: application/user-config+xmlContent-Length: xxxxxTT 0280 true false 請求消息示例: 創(chuàng)建含 Call Restrictions 的配置文件PUT http:/ HTTP/1.1. . .ClientID: systemadmPTTContent-Type: application/user-config+xmlContent-Length: xxxxxTT 中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和

36、用戶數(shù)據(jù)分冊第 20頁TT 0 1 1 1 1 0 0280 true false 2.a TDCS 接受請求返回 201 Created. 2.b TDCS 拒絕請求返回 403/404/409/412 錯(cuò)誤響應(yīng)，并包含詳細(xì)的錯(cuò)誤信息響應(yīng)消息:HTTP/1.1 201 Created. . .etag: etag numberContent-Length: 0響應(yīng)消息示例:HTTP/1.1 201 Created. . .etag: abababContent-Length: 0查詢用戶終端數(shù)據(jù)配置文檔查詢用戶終端數(shù)據(jù)配置文檔.1. 概述

37、該操作用來從“用戶樹”下獲取用戶終端數(shù)據(jù)配置文檔. XCAP GET 請求的響應(yīng)消息包含詳細(xì)的文檔信息.某用戶可以獲取自己的用戶終端配置文檔。系統(tǒng)管理員可以獲取所有用戶的終端配置文檔。中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 21頁終端也要利用該操作獲取創(chuàng)建或更新的配置信息。成功的 XCAP GET 操作會(huì)返回 200 OK 響應(yīng)，并包含群組信息. 失敗的操作會(huì)返回 304 (Not Modified ), 403 (Forbidden) 或 404 (Not Found)等。.2. 用例AdminTDCS1. XCAP GET2.a 200 OK

38、2.b 304/403/404圖 4-2 管理員得到一個(gè)終端數(shù)據(jù)配置文檔1.管理員要得到一個(gè)用戶的終端配置文檔。它發(fā)起 XCAP GET 請求請求消息:GET http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index HTTP/1.1. . .If-None-Match: etag numberClientID: requestors XUIContent-Length: 0請求消息示例:GET http:/ HTTP/1.1. . .If-None-Match: abababClientID: sys

39、temadmPTTContent-Length: 02.a TDCS 接受 XCAP GET 請求返回 200 OK 響應(yīng)，并包含配置信息2.b TDCS 拒絕請求返回 304/403/404 錯(cuò)誤響應(yīng)，并包含詳細(xì)的錯(cuò)誤信息響應(yīng)消息:HTTP/1.1 200 OK中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 22頁etag: etag numberContent-Type: application/user-config+xmlContent-Length: xxxxx. . .document content響應(yīng)消息示例:HTTP/1.1 200 OKetag:

40、bcbcbcContent-Type: application/vnd.oma.poc.groups+xmlContent-Length: xxxxxTTTT 0 1 1 1 1 0 0280 true false 增加增加 CallCall RestrictionRestriction.1. 概述該操作可以用來修改終端數(shù)據(jù)配置文檔增加 Call Restriction。XCAP PUT 被使用。請求消息中攜帶新的 Call Restriction。中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)

41、分冊第 23頁只有系統(tǒng)管理員可以發(fā)起此操作。成功的 XCAP PUT 操作返回 201 Created 響應(yīng). 失敗的操作會(huì)返回 403 (forbidden), 404 (not found)，409 (conflict)和 412 (Precondition Failed)。注：增加的 Call Restriction 是由 cr-order 來唯一標(biāo)識(shí)的。如果新加的 Call Restriction 的 cr-order 在文檔中已經(jīng)存在，本操作會(huì)變成對(duì)已有 Call Restriction 的替換，如果成功會(huì)返回 200 OK..2. 用例AdminTDCS1. XCAP

42、 PUT2.a 2012.b 403/404/409/412圖 4-3 管理員增加某一用戶的 call restrictions 配置信息1.管理員想增加某一用戶的 Call Restriction 配置信息，發(fā)起一個(gè) XCAP PUT 請求注意：發(fā)起的請求 URI 中，必須指定新的 Call Restriction 的 CR-order. CR-order表示該 Call Restriction 的順序，它必須與已有 Call Restriction 的 CR-order 不同。否則，TDCS 認(rèn)為這是對(duì)已有 Call Restriction 的替換。請求消息：PUT http:/FQDN

43、of TDCS server/service name/user-config/users/XUI of user/index/user-config/carrier-level-call-restrictions/call-restrictioncr-order=”CR Order Attribute Value” HTTP/1.1. . .If-Match: etag numberClientID: requestors XUIContent-Type: application/xcap-el+xmlContent-Length: xxxxxdocument content中國電信 qch

44、at 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 24頁請求消息示例:PUT http:/ HTTP/1.1. . .If-Match: abcdeClientID: systemadmPTTContent-Type: application/xcap-el+xmlContent-Length: xxxxx * 1 1 0 2.a TDCS 接受請求返回 201 Created. 2.b TDCS 拒絕請求返回 403/404/409/412 錯(cuò)誤響應(yīng)，并包含詳細(xì)的錯(cuò)誤信息響應(yīng)消息：HTTP/1.1 201 Created. . .etag: etag numberContent-Le

45、ngth: 0響應(yīng)消息示例:HTTP/1.1 201 Created. . .etag: abababContent-Length: 0刪除刪除 CallCall RestrictionRestriction.1. 概述該操作可以用來修改終端數(shù)據(jù)配置文檔刪除 Call Restriction。XCAP DELETE 被使用。只有系統(tǒng)管理員可以發(fā)起此操作。成功的 XCAP DELETE 操作返回 200 OK 響應(yīng). 失敗的操作會(huì)返回 403 (forbidden), 404 (not found)或者 412(Precondition Failed)。中國電信 qc

46、hat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 25頁.2. 用例AdminTDCS1. XCAP DELETE2.a 2002.b 403/404/409/412圖 4-4 管理員刪除某一用戶的 call restriction 配置信息1.管理員想刪除某一用戶的 Call Restriction 配置信息，發(fā)起一個(gè) XCAP DELETE 請求請求消息：DELETE http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index/user-config/carrier-level

47、-call-restrictions/call-restrictioncr-order=”CR Order Attribute Value” HTTP/1.1. . .If-Match: etag numberClientID: requestors XUIContent-Length: 0請求消息示例:PUT http:/ HTTP/1.1. . .If-Match: abcdeClientID: systemadmPTTContent-Length: xxxxx2.a TDCS 接受請求返回 200 OK. 2.b TDCS 拒絕請求返回 403/404/409 錯(cuò)誤響應(yīng)，并包含詳細(xì)的錯(cuò)誤

48、信息響應(yīng)消息：HTTP/1.1 200 OK. . .etag: etag numberContent-Length: 0中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 26頁響應(yīng)消息示例:HTTP/1.1 200 OK. . .etag: abababContent-Length: 0查詢和更新用戶其它配置參數(shù)查詢和更新用戶其它配置參數(shù).1. 概述該操作可以用來修改終端數(shù)據(jù)配置文檔中 User Capability 所包含的參數(shù)。User Capability 包括 call-type-capability，add-mem-disable

49、-privilege，talk-group-permission 等參數(shù)。XCAP PUT 被使用。只有系統(tǒng)管理員可以發(fā)起此操作。成功的 XCAP PUT 操作返回 200 OK 響應(yīng). 失敗的操作會(huì)返回 403 (forbidden), 404 (not found)，409 (conflict) and 412 (Precondition Failed)。.2. 用例AdminTDCS3. XCAP PUT4.a 2004.b 403/404/409/4121. XCAP GET 2. 200圖 4-5 管理員更新某一用戶的 user capability 參數(shù) 1， 2：管

50、理員想更新某一用戶的 User Capability 中包含的某一參數(shù)，首先發(fā)起一個(gè)XCAP GET 請求獲取整個(gè)文檔中的已有參數(shù)詳細(xì)消息參見“查詢用戶終端數(shù)據(jù)配置文檔”3， 4：管理員更改該用戶的 User Capability 參數(shù)，發(fā)起一個(gè) XCAP PUT 請求放回更改過的文檔中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 27頁詳細(xì)消息參見“創(chuàng)建/替換用戶終端數(shù)據(jù)配置文檔”中國電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 28頁5 5終端數(shù)據(jù)配置服務(wù)器短消息（終端數(shù)據(jù)配置服務(wù)器短消息（SMSSMS）接口規(guī)范

51、）接口規(guī)范從 TDCS 的角度看，短消息是從 TDCS 服務(wù)器發(fā)送給 SMGW，而 SMSC 負(fù)責(zé)把短消息發(fā)送給手機(jī)。短信發(fā)送流程如下圖：圖 5-1短信發(fā)送流程步驟說明如下：1. TDCS 服務(wù)器與業(yè)務(wù)網(wǎng)關(guān)之間的連接采用 SMGP 協(xié)議，其 MServiceID=PTT；2. 業(yè)務(wù)網(wǎng)關(guān)收到 MServiceID 為“PTT”的短消息后，將 MServiceID=PTT 透傳到 SMPP 協(xié)議的 serviceType 字段，然后將 SMPP 消息發(fā)送到短信中心；3. 短信中心根據(jù) serviceType=PTT，將下發(fā)到手機(jī)的 teleserviceid 填為 65010。本章定義 TDCS 和短信中心發(fā)出的短消息負(fù)荷的格式。5.15.1TDCSTDCS 通知的短消息通知的短消息負(fù)荷負(fù)荷TDCS 短消息接口用來給用戶終端發(fā)送有關(guān)配置信息更新的通知。當(dāng)用戶的終端數(shù)據(jù)配置文檔被創(chuàng)建和修改時(shí)，TDCS 會(huì)發(fā)送配置信息更新通知給該用戶。用戶終端應(yīng)該在收到該通知時(shí)主動(dòng)到 TDCS 獲取