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

1、中國電信中國電信 QchatQchat 業(yè)務終端參數(shù)配置接口技術要求業(yè)務終端參數(shù)配置接口技術要求系統(tǒng)和用戶數(shù)據(jù)分冊系統(tǒng)和用戶數(shù)據(jù)分冊（征求意見稿）（征求意見稿）中國電信股份有限公司廣州研究院中國電信股份有限公司廣州研究院中國電信 qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 2頁二零零九年十一月二零零九年十一月目錄目錄1 1范圍范圍.3 31.1文檔更改歷史.32 2縮略語縮略語.4 43 3管理終端數(shù)據(jù)配置文檔的管理終端數(shù)據(jù)配置文檔的 XCAPXCAP 服務服務.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ù)配置服務器 XCAP 請求 URL .73.5終端數(shù)據(jù)配置服務器器后向兼容對客戶端 XML 解析的要求.84 4終端數(shù)據(jù)配置服務器終端數(shù)據(jù)配置服務器 XCAPXCAP 接口規(guī)范接口規(guī)范 .9 94.1概述.94.2正常響應.94.2.1正常響應描述.94.3錯誤響應.94.3.1錯誤響應描述.104.4操作終端數(shù)據(jù)配置文檔.144.4.1 Data Schema.144.4.2使用場景.175 5終端數(shù)據(jù)配置服務器短消息（終端數(shù)據(jù)配置服務器短消息（SMSSMS）接口規(guī)范）接口規(guī)范.26265

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

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

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

6、1 的 data schema 中加入 xs:any 元素以備將來擴展2. 文檔 URI 示例中 改為3. 文檔示例中用戶域名改為 PTT2009.11.18更正圖 5-1 中的協(xié)議標識。中國電信 qchat 業(yè)務終端參數(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è)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 5頁3 3管理終端數(shù)據(jù)配置文檔管理終端數(shù)據(jù)配置文檔的的 XCAPXCAP 服務服務3.13.1終端數(shù)據(jù)配置文檔終端數(shù)據(jù)配置文檔在 TDCS 中，存在用戶終端配置文檔，即適用于某一用戶的終端配置文檔。該文檔包含該用戶的終端進行 PTT 適用的配置信息。3.23.2支持的支持的 HTTPHTTP

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

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

11、ion. 但所有的發(fā)送到 TDCS 的請求必須使用相同的頭。3.3.2 PUT 必須攜帶的頭對 XCAP PUT 操作 , 下列 HTTP 頭必須攜帶：“Content Type” 和 “Content Length”. 中國電信 qchat 業(yè)務終端參數(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 定義了幾個可以被客戶端用來做條件請求的頭域：If-None-Match 和 If-Match。 客戶端可以根據(jù)所請求資源的實體標簽（entity tag）來做條件請求.

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

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

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

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

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

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

19、一個用戶名，被稱為 XCAP 用戶標識符（XCAP User Identifier: XUI). 文檔選擇器余下的部分 (global 或 XUI 以后的路徑)指向具體的文檔名. 終端數(shù)據(jù)配置文件名為“index”，并被保存在 users 樹下。3. 節(jié)點選擇器 （Node selector）節(jié)點選擇器指定 XML 文檔中具體被操作的節(jié)點. 節(jié)點選擇器指向 XML 元素或元素屬性. 4. 產生 TDCS 請求 URL 訪問終端數(shù)據(jù)配置服務器的某個用戶的 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ù)配置服務器器后向兼容對客戶端終端數(shù)據(jù)配置服務器器后向兼容對客戶端 XMLXML 解析的要求解析的要求這里的終端數(shù)據(jù)配置服務器客戶端指所有與 TDCS 進行 HTTP/XCAP 通信客戶端應用程序。TDCS 會不斷加入新的功能. 群組管理的 XML schema 在將來可能會被擴展。TDCS 升級到新的版本而客戶端有可能仍然是舊的版本。為了使TDCS 后向兼容，TDCS 客戶端的實現(xiàn)必須要遵循以下建議:oTDCS 客戶

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

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

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

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

25、/DELETE 操作響應. TDCS 不能處理該請求，盡管理解該請求。 TDCS可能攜帶請求被拒絕的原因在 403 響應的“reason-phrase”中。響應消息示例: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) 響應可以對 XCAP GET/PUT/DELETE 操作響應。由于語法錯誤 T

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

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

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

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

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

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

32、qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 16頁 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 17頁 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 18頁.2使用場景使用場景場景總結創(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 操作會返回 201 Created 響應（創(chuàng)建文檔）或 200 OK 響應 （替換文檔）. 失敗的操作會返回 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)建一個用戶終端數(shù)據(jù)配置文檔。它發(fā)起一個 XCAP PUT 請求中國電

34、信 qchat 業(yè)務終端參數(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è)務終端參數(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 錯誤響應，并包含詳細的錯誤信息響應消息:HTTP/1.1 201 Created. . .etag: etag numberContent-Length: 0響應消息示例:HTTP/1.1 201 Created. . .etag: abababContent-Length: 0查詢用戶終端數(shù)據(jù)配置文檔查詢用戶終端數(shù)據(jù)配置文檔.1. 概述

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

38、2.b 304/403/404圖 4-2 管理員得到一個終端數(shù)據(jù)配置文檔1.管理員要得到一個用戶的終端配置文檔。它發(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 響應，并包含配置信息2.b TDCS 拒絕請求返回 304/403/404 錯誤響應，并包含詳細的錯誤信息響應消息:HTTP/1.1 200 OK中國電信 qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 22頁etag: etag numberContent-Type: application/user-config+xmlContent-Length: xxxxx. . .document content響應消息示例: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è)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)

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

42、 PUT2.a 2012.b 403/404/409/412圖 4-3 管理員增加某一用戶的 call restrictions 配置信息1.管理員想增加某一用戶的 Call Restriction 配置信息，發(fā)起一個 XCAP PUT 請求注意：發(fā)起的請求 URI 中，必須指定新的 Call Restriction 的 CR-order. CR-order表示該 Call Restriction 的順序，它必須與已有 Call Restriction 的 CR-order 不同。否則，TDCS 認為這是對已有 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è)務終端參數(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 錯誤響應，并包含詳細的錯誤信息響應消息：HTTP/1.1 201 Created. . .etag: etag numberContent-Le

45、ngth: 0響應消息示例: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 響應. 失敗的操作會返回 403 (forbidden), 404 (not found)或者 412(Precondition Failed)。中國電信 qc

46、hat 業(yè)務終端參數(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ā)起一個 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 錯誤響應，并包含詳細的錯誤

48、信息響應消息：HTTP/1.1 200 OK. . .etag: etag numberContent-Length: 0中國電信 qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 26頁響應消息示例: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 響應. 失敗的操作會返回 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ā)起一個XCAP GET 請求獲取整個文檔中的已有參數(shù)詳細消息參見“查詢用戶終端數(shù)據(jù)配置文檔”3， 4：管理員更改該用戶的 User Capability 參數(shù)，發(fā)起一個 XCAP PUT 請求放回更改過的文檔中國電信 qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 27頁詳細消息參見“創(chuàng)建/替換用戶終端數(shù)據(jù)配置文檔”中國電信 qchat 業(yè)務終端參數(shù)配置接口技術要求-系統(tǒng)和用戶數(shù)據(jù)分冊第 28頁5 5終端數(shù)據(jù)配置服務器短消息（終端數(shù)據(jù)配置服務器短消息（SMSSMS）接口規(guī)范

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