中國電信qchat業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊.doc

中國中國電電信信 qchat 業(yè)務終業(yè)務終端參數(shù)配置接口技端參數(shù)配置接口技術(shù)術(shù)要求要求 群群組組數(shù)據(jù)分冊數(shù)據(jù)分冊 （征求意（征求意見見稿）稿） 中國中國電電信股份有限公司廣州研究院信股份有限公司廣州研究院 二零壹零年三月二零壹零年三月 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 2 頁 目錄目錄 目錄目錄2 1 1范圍范圍4 1.1文檔更改歷史4 2縮略語縮略語5 3群組管理服務器群組管理服務器 httphttp 服務服務6 3.1支持的 http 方法6 3.2支持的 http 頭6 3.2.1適用于所有操作的頭6 3.2.2put 和 post 必須攜帶的頭6 3.2.3get 多播群組 gsk 必須攜帶的頭：q-cnonce7 3.2.4用于條件操作 http 頭7 3.3群組管理服務器 xcap 請求 url.8 3.4群組管理服務器器后向兼容對客戶端 xml 解析的要求10 4群組管理服務器群組管理服務器 httphttp 接口規(guī)范接口規(guī)范11 4.1概述11 4.2正常響應11 4.2.1正常響應描述11 4.3錯誤響應12 4.3.1錯誤響應描述12 4.4操作共享群組（shared group）文檔16 4.4.1data schema.16 4.4.2使用場景24 4.5多播共享群組的多播信息（multicast information）管理51 4.5.1data schema.51 4.5.2使用場景53 4.6組關(guān)聯(lián)（group association） 管理.64 4.6.1data schema.64 4.6.2使用場景65 4.7組查詢接口68 4.7.1data schema.68 4.7.2使用場景69 5群組管理服務器短消息（群組管理服務器短消息（sms）接口規(guī)范）接口規(guī)范.73 5.1glms 不同類型通知的短消息負荷.73 5.1.1組關(guān)聯(lián)更新通知73 5.1.2給組主管理人的“自動退出”通知75 6典型的端到端用例典型的端到端用例76 6.1.1向共享群組里加組成員76 7群組服務器客戶端的配置信息群組服務器客戶端的配置信息79 7.1配置信息79 7.2主副地址切換建議79 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 3 頁 8對手機端和用戶管理平臺群組操作能力的建議對手機端和用戶管理平臺群組操作能力的建議80 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 4 頁 1 1范圍范圍 群組管理服務器(glms) 是基于 oma xdms 的體系要求實現(xiàn)的群組管理和 xml 文檔 管理服務器. 它提供對用戶的 xml 文檔如共享群組文檔的管理. 文檔的管理操作包 括讀取/增加/修改/刪除. 這些操作是通過 xcap 接口完成的。群組管理服務器 (glms) 還提供群組的搜索能力?？蛻舳丝梢蕴峁┲T如組主管理人，組成員等信息來搜索 對應的共享群組。 本文定義與群組管理服務器(glms)進行通信時的接口規(guī)范。 本文用 glms 表示群組管理服務器。 1.1文檔更改歷史文檔更改歷史 時間時間說明說明 2009.2.16以下為更改的主要內(nèi)容： 3.3 : 增加對 fqdn 使用的解釋 5.1 : 短消息負荷更改 5.1.1 : 終端獲取 xui 的方法更改 7.1 : 服務器故障轉(zhuǎn)移定時參數(shù)取值修改 7.2 : 增加了主副地址切換的方法建議 另外更改了一些拼寫錯誤。 200.3 : 定義 q-cnonce 攜帶的 cnonce 格式 3.2.3, , 6.1.1: 增加 glms 在響應消息中返回 q-cnonce 的內(nèi)容和示例，去掉 gsk time 需要加密的內(nèi)容 4.6.1, .2, 6.1.1, 組關(guān)聯(lián)中增加可選的 premium-flag 指示該 用戶是否為特別用戶 4.5.1 data schema 中 gsk-old, gsk-new 改為 256 bit，gsk-time 改為 32 bit. 并據(jù)此改動 , 6.1.1 中相應數(shù)據(jù)的格式 200.1 data schema 中的修改為 4.5.1 data schema 中的修改為 2009.7.14 5.1、5.1.1、5.1.2：修改 glms 采用 smgp 協(xié)議要求及流程說明。 2009.8.5 5.1、5.1.1、5.1.2：修改 glms 發(fā)送的為 ，以及針對的樣例“qchat”修改為 “ptt”。 2009.8.5 修改組關(guān)聯(lián)更新流程圖。 2009.8.5 修改組成員退出提示要求。 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 5 頁 時間時間說明說明 2009.8.31 1回退 2009.6.25 在 4.4.1 和 4.5.1 中做的對 schema 的修改。即 schema 中“conference-id”仍然保持為minoccurs=“0“ 24.6.1 中 group-association 的 data schema 中加入“conference- id”元素。 34.6.1 中 group-association 的 data schema 中加入“xs:any”元 素以備將來擴展別的元素 .2 和 6.1.1 中查詢用戶組關(guān)聯(lián)的返回消息示例中，加入 conference-id”元素。 5文檔 uri 示例中 改為 6. 文檔示例中用戶域名和群組域名改為 , 和 2009.11.18 更正圖 5-1 中的協(xié)議標識。 2009.11.23 修改文檔中所有“”為 “”。 2010.3.1 修改文檔中所有“”為“”。 2010.3.25 修改文檔中所有“”為 “sh.glms.vnet.mobi:9444”。 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 6 頁 2縮略語縮略語 縮略語縮略語定義定義 3gpp3rd generation partnership project auidapplication usage id fqdnfully qualified domain name glmsgroup and list management server httphypertext transfer protocol ietfinternet engineering task force omaopen mobile alliance smppshort message peer-to-peer protocol smscshort message service center uri uniform resource identifier urluniform resource locator xcapxml configuration access protocol xdmxml document management xdmcxml document management client xdmsxml document management server xmlextensible markup language xuixcap user identity 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 7 頁 3群組管理服務器群組管理服務器 httphttp 服務服務 3.1支持的支持的 httphttp 方法方法 glms 支持以下 http 操作: http get （獲取群組信息） http put (根據(jù)不同的上下文，put 操作支持增加或修改群組內(nèi)容) http delete （刪除群組信息） http post （搜索群組信息） 3.23.2支持的支持的 httphttp 頭頭 3.2.1適用于所有操作的頭 用于認證的頭: clientid “clientid” 在每個http請求中都必須攜帶. “clientid” 可以被 wap 網(wǎng)關(guān)或用戶群組管理平臺加入，并隨請求消息送到 glms。clientid 應該攜帶明文的用戶 id 信息。glms 信任“clientid”所包含的用戶 id 就是請求發(fā)起者的 用戶 id。 注意：運營商也可以選用其它的 http 頭作為用于認證的頭，如：3gpp-accerted- identify. 但所有的發(fā)送到 glms 的請求必須使用相同的頭。 用于識別客戶端協(xié)議版本的頭: glmsclientversion “glmsclientversion” 在每個http請求中都必須攜帶. glms 客戶端用“glmsclientversion”表示它所實現(xiàn)的 glms 協(xié)議版本。對應于本規(guī)范，版本號 應為“11.01” 注意：運營商也可以選用其它的 http 頭作為用于版本標識的頭，如：glms-group- version. 但所有的發(fā)送到 glms 的請求必須使用相同的頭。 3.2.2 put 和 post 必須攜帶的頭 對 xcap put 操作 , 下列 http 頭必須攜帶：“content type” 和 “content length”. content type content-type 頭域指定所包含的消息體的媒體類型。其格式為: content-type = “content-type“ “:“ media-type 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 8 頁 glms 中有效的 content type 為: content-type: text/plain content-type: application/xcap-error+xml content-type: application/vnd.oma.poc.groups+xml content-type: application/xcap-el+xml content-type: application/xcap-att+xml content-type: application/group-association+xml content-type: application/vnd.oma.search+xml 參見接口定義確定在何種情況下使用何種 content type. content length content-length 頭域指定消息體的長度 （8 位字節(jié)數(shù)）。其格式為： content-length = “content-length“ “:“ 1*digit 例如: content-length: 3495 3.2.3get 多播群組 gsk 必須攜帶的頭：q-cnonce 當客戶端想要發(fā)送 xcap get 請求來獲取多播群組的包括 gsk 在內(nèi)的多播信息時，必須攜帶 q- cnonce 頭。該 http 頭包含 ptt 客戶端產(chǎn)生的 cnonce 值。glms 會利用該 cnonce 產(chǎn)生用于加密 gsk 的密鑰：pek。返回的 gsk 是加密后的格式。 q-cnonce 中攜帶的 cnonce 必須是 128 bit, 以 16 進制格式傳送（0-9，a-e 為有效字符），如： q-cnonce: 102e3a4d516b7085910a1e2c3d40526a 在返回的響應消息中，glms 會將請求中攜帶的 cononce 用 q-cnonce 頭帶回，以備終端使用。 具體參見 。 3.2.4用于條件操作 http 頭 http 定義了幾個可以被客戶端用來做條件請求的頭域：if-none-match 和 if-match。 客戶 端可以根據(jù)所請求資源的實體標簽（entity tag）來做條件請求. 這些條件請求的頭域在請 求消息里是可選用的. 條件請求的頭域可以解決并發(fā)請求的沖突問題。 if-match 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 9 頁 if-match 請求頭域被 http 方法(put/delete)用來做有條件操作. 對一個或多個從 群組服務器獲得的實體，xds 客戶端可以在請求的if-match頭中包含某個實體的 entity tag 以確認它所具有的那個實體是最新的. if-match 頭可以被用在以下場景中: 條件 put xdm 客戶端想增加或修改服務器 xdm 文檔中的某個元素（element），并且希望服務器所 具有的文檔版本和客戶端當前所具有的那個文檔相同時才能修改。客戶端可以在請求中包 含 if-match 頭, 并將客戶端所具有的實體標簽（entity tag）值寫在里面. 如果文檔已經(jīng)改變，群組服務器會拒絕這個請求返回 412 （條件失?。? 在這種情況下， 客戶端需要重新用 get 請求從服務器獲取這個文檔并保存服務器在 200 ok 中返回的新的 實體標簽（entity tag）。 客戶端可以把新的實體標簽（entity tag）放在 if-matc 頭中重新請 求修改文檔。 如果操作成功， 響應消息的 etag 頭會包含剛被修改過的資源的新的實體標簽（entity tag）。 條件 delete xdm 客戶端也可以在 delete 請求中包含 if-match 頭來做條件刪除. delete 請求的 200 ok 響應會包含一個 etag 頭域, 帶有所刪除元素所在的整個文檔的實體標簽（entity tag） if-none-match if-none-match 請求頭域可以和 get 請求方法一起使用做條件請求. if-none-match 頭中可以 包含客戶端以前從服務器所獲取的資源實體的實體標簽（entity tag）。 if-none-match 頭可以被用在以下場景中: 條件 get 當 xdm 客戶端本地存有一個文檔的版本，它可以做條件 get 來判斷服務器對統(tǒng)一文檔是 否有更新。如果本地文檔仍然是最新的，客戶端就不會重新下載文檔，以此節(jié)省網(wǎng)絡的使 用。為了達到這個目的，客戶端在 get 請求中攜帶 if-none-match 頭域，其中包含客戶端當 前文檔的實體標簽（entity tag）. 群組服務器如果發(fā)現(xiàn)服務器文檔標簽和客戶端不同，會響 應 200 ok. 如果服務器文檔標簽和客戶端相同, 服務器會響應 304. 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 10 頁 3.33.3群組管理服務器群組管理服務器 xcap 請求請求 urlurl 1. xcap 根節(jié)點 （xcap root） xcap 根定義了所有可被請求的資源所在的位置. xcap 根用 http uri 表示, 被稱為 xcap 根 rui。對群組服務 xcap 根 被定義為/glms fqdn/glms-services. 注：在具體構(gòu)造 http 請求時，glms fqdn 應該為 glms 服務器的地址，并且在發(fā)出 http 請求時放在 host http 頭中，而不是在 request-uri 中。另外，由于 glms 有主 副地址，glms fqdn 可能是兩個。（關(guān)于主副地址，請參見第 7 章） 2. 文檔選擇器 （document selector） 在文檔根節(jié)點下的每一個 xml 文檔使用文檔選擇器唯一標識，文檔選擇器類似于由多個 路徑標識符組成的一個完整路徑，使用“/”作為路徑分隔符. 第一個路徑部分必須是 xcap auid。對群組服務器而言，有以下三種 xcap auid: org.openmobilealliance.groups: 用來進行群組的操作用來進行群組的操作 multicast-info: 用來操作群組的多播信息用來操作群組的多播信息 group-association：用來獲取個人所在的群組信息：用來獲取個人所在的群組信息 在每個 auid 下有兩個子 xcap 分支. 一個成為 “用戶樹”（“user”tree）, 保存某個用 戶的所有文檔。 另一個分支是“全局樹”（“global”tree）, 保存適用于所有用戶的文檔. auid 之后的路徑部分必須是“global“ 或 “users“. 在“用戶樹”下是零個或多個子樹，每個子 樹包含某個用戶的文檔。每個用戶對服務器而言都有一個用戶名，被稱為 xcap 用戶表示 （xcap user identifier: xui). 文檔選擇器余下的部分 (“global“ 或 xui 以后的路徑指向具體的文檔名. 3. 節(jié)點選擇器 （node selector） 節(jié)點選擇器指定 xml 文檔中具體被操作的節(jié)點. 節(jié)點選擇器指向 xml 元素或元素屬性. 4. 產(chǎn)生 glms 請求 url 訪問群組管理服務器的某個用戶的 xml 文檔, 使用以下的 url 格式: http:/fqdn of glms server/service name/auid/users/xui of user/group document name 訪問 glms 的全局的 xml 文檔, 使用以下的 url 格式: http:/fqdn of glms server/service name/auid/global/index 訪問 glms 文檔的 xml 元素，使用以下的 url 格式: document selector/node selector 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 11 頁 文檔選擇器（document selector） 部分可以是用戶特定的文檔或全局文檔。節(jié)點選擇器 （node selector ）部分是 xml 文檔中的元素. 更多詳情參見本規(guī)范的具體例子. 3.4群組管理服務器器后向兼容對客戶端群組管理服務器器后向兼容對客戶端 xmlxml 解析的要求解析的要求 這里的群組管理服務器客戶端指所有與 glms 進行 http/xcap 通信客戶端應用程序。 glms 會不斷加入新的功能. 群組管理的 xml schema 在將來可能會擴展。glms 升級到新 的版本而客戶端有可能仍然是舊的版本。為了使glms 后向兼容，glms 客戶端的實現(xiàn)必須 要遵循以下建議: oglms 客戶端必須忽略服務器返回的合法的 xml 文檔中不能識別的 xml 元素 或 屬性，而不是報錯退出對文檔的處理. 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 12 頁 4群組管理服務器群組管理服務器 httphttp 接口規(guī)范接口規(guī)范 4.1概述概述 glms 為客戶端應用提供 xcap 接口來管理服務器存儲的群組 xml 文檔. 客戶端應用可以 讀取/更新/刪除 xml 文檔及其 xml 元素和屬性. 本章給出群組管理服務器 xcap 接口規(guī)范。 4.2正常響應正常響應 如果客戶端的請求被成功處理，glms支持成功的 2xx 狀態(tài)碼： 狀態(tài)碼狀態(tài)碼描述描述 200ok 201created 202accepted 4.2.1正常響應描述正常響應描述 200 (ok) 響應 當 xcap get/put/delete 請求被成功處理時返回. 示例消息: http/1.1 200 ok etag: “bcbcbc“ content-length: 0 . . . 201 (created) 響應 當 xcap put 請求被執(zhí)行并其請求的 resrouce 已經(jīng)產(chǎn)生. 示例消息: http/1.1 201 created etag: “ababab“ . . . content-length: 0 202 (accepted) 響應 當 xcap put 請求正在執(zhí)行但處理并沒有全部完成 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 13 頁 示例消息: http/1.1 202 accepted . . . content-length: 0 4.3錯誤錯誤響應響應 xcap 使用與http協(xié)議相同定義的錯誤響應狀態(tài)碼。glms支持3類錯誤狀態(tài)碼：3xx, 4xx, 和 5xx. 3xx 是重定向狀態(tài)碼，指示客戶端為滿足請求去采取其它的行動。4xx 是客戶端錯 誤碼，指出客戶端請求可能包含的錯誤. 5xx 是服務器錯誤碼，指示服務器知道自己遇到問 題而不能處理當前的請求。 狀態(tài)碼狀態(tài)碼描述描述 304not modified 400bad request 403forbidden 404not found 405method not allowed 409conflict 412precondition failed 415unsupported media type 500internal server error 503service unavailable error 4.3.1錯誤響應描述錯誤響應描述 304 (not modified) 響應 在條件 get 中使用. 客戶端在 if-none-match 頭中包含的 etag 與服務器所具有的該文檔 etag 相同 響應消息示例: http/1.1 304 not modified content-type: text/plain; charset=iso-8859-1 content-length: 0 403 (forbidden) 響應 可以對 xcap get/put/delete 操作響應. glms 不能處理該請求，盡管理解該請求。 glms 可能攜帶請求被拒絕的原因在 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-1 content-length: 0 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 14 頁 400 (bad request) 響應 可以對 xcap get/put/delete 操作響應。由于語法錯誤 glms 不能理解該請求. 響應消息示例: http/1.1 400 bad request content-type: text/plain; charset=iso-8859-1 content-length: 0 404 (not found) 響應 可以對 xcap get/put/delete 操作響應. glms 不能找到被請求的資源。 響應消息示例: http/1.1 404 not found content-type: text/plain; charset=iso-8859-1 content-length: 0 405 (method not allowed) 響應 可以對 xcap get/put/delete 和 http post 操作響應. glms 理解請求的方法但是不 支持該操作 響應消息示例: http/1.1 405 method not allowed content-type: text/plain; charset=iso-8859-1 content-length: 0 409 (conflict) 響應 可以對 xcap get/put/delete 操作響應。請求因?qū)Ξ斍百Y源的沖突而不能完成。 409 響應可攜帶 xml 消息體來指定沖突的具體原因。 以下是 409 響應中所包含的“xcap-error” data schema. “xcap-error” 可以用來給出具體沖突原因。 客戶端應該支持以下 schema： 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 15 頁 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 16 頁 響應消息示例: http/1.1 409 conflict content-type: application/xcap-error+xml content-length: xxxxx 412 (precondition failed) 響應 可以對 xcap get/put/delete 操作響應。 客戶端可以攜帶 if-match 頭域來包含客戶端 所具有的 etag. 如果文檔在服務器中已改變，412 就會被返回. 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 17 頁 響應消息示例: http/1.1 412 precondition failed content-type: text/plain; charset=iso-8859-1 content-length: 0 415 (unsupported media type) 響應 可以對 xcap get/put/delete 操作響應。 群組服務器不接受請求消息中的內(nèi)容編碼。 響應消息示例: http/1.1 415 unsupported media type content-type: text/plain; charset=iso-8859-1 content-length: 0 500 (internal server error) 響應 可以對 xcap get/put/delete 操作響應. 群組服務器遇到不可預料的情況不能完成請求. 響應消息示例: http/1.1 500 internal server error content-type: text/plain; charset=iso-8859-1 content-length: 0 0503 (service unavailable) 響應 可以對 xcap get/put/delete 操作響應. 群組服務器因過載或維護等原因暫時不能處理 請求. 響應消息示例: http/1.1 503 service unavailable content-type: text/plain; charset=iso-8859-1 content-length: 0 4.4操作共享群組（操作共享群組（sharedshared groupgroup）文檔）文檔 4.4.1data schema glms 擴展了共享群組（shared group） schema 以支持 qchat 群組。 . 1. shared group schema 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 19 頁 2. shared-group-lucent.xsd 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 20 頁 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 21 頁 3. resource-lists.xsd 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 22 頁 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 23 頁 4. xml.xsd see /xml/1998/namespace.html and /tr/rec-xml for information about this namespace. this schema document describes the xml namespace, in a form suitable for import by other schema documents. note that local names in this namespace are intended to be defined only by the world wide web consortium or its subgroups. the following names are currently defined in this namespace and should not be used with conflicting semantics by any working group, specification, or document instance: base (as an attribute name): denotes an attribute whose value provides a uri to be used as the base for interpreting any relative uris in the scope of the element on which it appears; its value is inherited. this name is reserved by virtue of its definition in the xml base specification. id (as an attribute name): denotes an attribute whose value should be interpreted as if declared to be of type id. the xml:id specification is not yet a w3c recommendation, but this attribute is included here to facilitate experimentation with the mechanisms it proposes. note that it is _not_ included in the specialattrs attribute group. lang (as an attribute name): denotes an attribute whose value is a language code for the natural language of the content of any element; its value is inherited. this name is reserved by virtue of its definition in the xml specification. space (as an attribute name): denotes an attribute whose value is a keyword indicating what whitespace processing discipline is intended for the content of the element; its value is inherited. this name is reserved by virtue of its definition in the xml specification. father (in any context at all): denotes jon bosak, the chair of the original xml working group. this name is reserved by the following decision of the w3c xml plenary and xml coordination groups: 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 24 頁 in appreciation for his vision, leadership and dedication the w3c xml plenary on this 10th day of february, 2000 reserves for jon bosak in perpetuity the xml name xml:father this schema defines attributes and an attribute group suitable for use by schemas wishing to allow xml:base, xml:lang, xml:space or xml:id attributes on elements they define. to enable this, such a schema must import this schema for the xml namespace, e.g. as follows: schema . . . . . . import namespace=“/xml/1998/namespace“ schemalocation=“/2001/xml.xsd“/ subsequently, qualified reference to any of the attributes or the group defined below will have the desired effect, e.g. type . . . . . . attributegroup ref=“xml:specialattrs“/ will define a type which will schema-validate an instance element with any of those attributes in keeping with the xml schema wgs standard versioning policy, this schema document will persist at /2005/08/xml.xsd. at the date of issue it can also be found at /2001/xml.xsd. the schema document at that uri may however change in the future, in order to remain compatible with the latest version of xml schema itself, or with the xml namespace itself. in other words, if the xml schema or xml namespaces change, the version of this document at /2001/xml.xsd will change accordingly; the version at /2005/08/xml.xsd will not change. attempting to install the relevant iso 2- and 3-letter codes as the enumerated possible values is probably never going to be a realistic possibility. see 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 25 頁 rfc 3066 at /rfc/rfc3066.txt and the iana registry at /assignments/lang-tag-apps.htm for further information. the union allows for the un-declaration of xml:lang with the empty string. see /tr/xmlbase/ for information about this attribute. see /tr/xml-id/ for information about this attribute. 5. shared-group-oma.xsd 4.4.2使用場景使用場景 場景總結(jié) 創(chuàng)建多播共享群組文檔 從“用戶樹”下獲取共享群組文檔 從“全局樹”下獲取共享群組文檔 刪除共享群組文檔 添加/修改共享群組的顯示名稱 添加/修改共享群組的主題 添加/修改共享群組的主管理人 改變共享群組的 vocoder 類型 增加組成員 修改組成員信息 刪除組成員 添加/修改共享群組成員的顯示名稱 修改組成員的通話優(yōu)先級 修改組成員的成員狀態(tài) 組成員選擇退出共享群組 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 27 頁 創(chuàng)建多播共享群組文檔創(chuàng)建多播共享群組文檔 .1.概述 該操作用來創(chuàng)建用戶或企業(yè)的多播共享群組文檔. 用戶會被無條件加入到組中。 成功的 xcap put 操作會返回 201 created 響應. 失敗的操作會返回 403 (forbidden), 404 (not found) 或 409 (conflict). .2.用例 xdm clienta glms 1. xcap put 2.a 201 created 2.b 403/404/409 xdm clientb 3. group change notification 4. retrieve group association 圖 4-1 xdm client 創(chuàng)建一個共享群組 1.xdm 客戶端創(chuàng)建一個共享群組。它發(fā)起一個 xcap put 請求 request message specification: put http:/fqdn of glms server/service name/org.openmobilealliance.groups/users/xui of user or company/group document name http/1.1 . . . clientid: requestors xui content-type: application/vnd.oma.poc.groups+xml content-length: xxxxx group document content 請求消息示例: put http:/sh.glms.vnet.mobi:9444/glms- services/org.openmobilealliance.groups/users/4600013311111111111ptt.189.cn/myconferencegroup.p tt.189.cn http/1.1 . . . clientid: systemadmptt.189.cn 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 28 頁 content-type: application/vnd.oma.poc.groups+xml content-length: xxxxx friends forced-membership oe1 2 my conference group owner 2.a glms 接受請求返回 201 created. 2.b glms 拒絕請求返回 403/404/409 錯誤響應，并包含詳細的錯誤信息 response message specification: http/1.1 201 created . . . etag: etag number content-length: 0 響應消息示例: http/1.1 201 created . . . etag: “ababab“ content-length: 0 1.如果創(chuàng)建的群組中包含組成員，glms 通知成員他們被加入到新的群組中。 2.組成員的客戶端軟件從 glms 中獲取群組信息。這是通過對 group association 的 xcap get 請求獲得的. 中國電信 qchat 業(yè)務終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊 第 29 頁 從從“用戶樹用戶樹”下獲取共享群組文檔下獲取共享群組文檔 .1.概述 該操作用來從“用戶樹”下獲取用戶或企業(yè)的共享群組文檔. xcap get 請求的響應消息 包含詳細的共享群組信息. 不同的請求者根據(jù)不同的權(quán)限會得到不同的請求結(jié)果： 1.全部群組信息包括群組名，主題，狀態(tài)，成員，成員通話優(yōu)先級，組創(chuàng)建信息等 2.部分群組信息包括群組名，主題，成員（沒有通話優(yōu)先級）, 組狀態(tài) 3.部分群組信息包括群組名，主題，成員（有通話優(yōu)先級）, 組狀態(tài) 成功的 xcap get 操作會返回 200 ok 響應，并包含群組信息. 失敗的操作會返回 304 (not modified ), 403 (forbidden) 或 404 (not found)等。 .2.用例 xdm clientglms 1. xcap get 2.a 200 ok 2.b 304/403/404 圖 4-2 xdm client 得到某一群組文檔 1.xdm 客戶端要得到一個用戶或企業(yè)的某一群組文檔。它發(fā)起 xcap get 請求 request message specification: get http:/fqdn of glms server/service name/org.openmobilealliance.groups/users/xui of user or company/group document name http/1.1 . . . if-none-match: etag number clientid: requestor