中国电信qchat业务终端参数配置接口技术要求-群组数据分册.doc

中国中国电电信信 qchat 业务终业务终端参数配置接口技端参数配置接口技术术要求要求 群群组组数据分册数据分册 （征求意（征求意见见稿）稿） 中国中国电电信股份有限公司广州研究院信股份有限公司广州研究院 二零壹零年三月二零壹零年三月 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 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 接口规范接口规范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组关联（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）接口规范）接口规范.73 5.1glms 不同类型通知的短消息负荷.73 5.1.1组关联更新通知73 5.1.2给组主管理人的“自动退出”通知75 6典型的端到端用例典型的端到端用例76 6.1.1向共享群组里加组成员76 7群组服务器客户端的配置信息群组服务器客户端的配置信息79 7.1配置信息79 7.2主副地址切换建议79 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 3 页 8对手机端和用户管理平台群组操作能力的建议对手机端和用户管理平台群组操作能力的建议80 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 4 页 1 1范围范围 群组管理服务器(glms) 是基于 oma xdms 的体系要求实现的群组管理和 xml 文档 管理服务器. 它提供对用户的 xml 文档如共享群组文档的管理. 文档的管理操作包 括读取/增加/修改/删除. 这些操作是通过 xcap 接口完成的。群组管理服务器 (glms) 还提供群组的搜索能力。客户端可以提供诸如组主管理人，组成员等信息来搜索 对应的共享群组。 本文定义与群组管理服务器(glms)进行通信时的接口规范。 本文用 glms 表示群组管理服务器。 1.1文档更改历史文档更改历史 时间时间说明说明 2009.2.16以下为更改的主要内容： 3.3 : 增加对 fqdn 使用的解释 5.1 : 短消息负荷更改 5.1.1 : 终端获取 xui 的方法更改 7.1 : 服务器故障转移定时参数取值修改 7.2 : 增加了主副地址切换的方法建议 另外更改了一些拼写错误。 200.3 : 定义 q-cnonce 携带的 cnonce 格式 3.2.3, , 6.1.1: 增加 glms 在响应消息中返回 q-cnonce 的内容和示例，去掉 gsk time 需要加密的内容 4.6.1, .2, 6.1.1, 组关联中增加可选的 premium-flag 指示该 用户是否为特别用户 4.5.1 data schema 中 gsk-old, gsk-new 改为 256 bit，gsk-time 改为 32 bit. 并据此改动 , 6.1.1 中相应数据的格式 200.1 data schema 中的修改为 4.5.1 data schema 中的修改为 2009.7.14 5.1、5.1.1、5.1.2：修改 glms 采用 smgp 协议要求及流程说明。 2009.8.5 5.1、5.1.1、5.1.2：修改 glms 发送的为 ，以及针对的样例“qchat”修改为 “ptt”。 2009.8.5 修改组关联更新流程图。 2009.8.5 修改组成员退出提示要求。 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 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 中查询用户组关联的返回消息示例中，加入 conference-id”元素。 5文档 uri 示例中 改为 6. 文档示例中用户域名和群组域名改为 , 和 2009.11.18 更正图 5-1 中的协议标识。 2009.11.23 修改文档中所有“”为 “”。 2010.3.1 修改文档中所有“”为“”。 2010.3.25 修改文档中所有“”为 “sh.glms.vnet.mobi:9444”。 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 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 业务终端参数配置接口技术要求-群组数据分册 第 7 页 3群组管理服务器群组管理服务器 httphttp 服务服务 3.1支持的支持的 httphttp 方法方法 glms 支持以下 http 操作: http get （获取群组信息） http put (根据不同的上下文，put 操作支持增加或修改群组内容) http delete （删除群组信息） http post （搜索群组信息） 3.23.2支持的支持的 httphttp 头头 3.2.1适用于所有操作的头 用于认证的头: clientid “clientid” 在每个http请求中都必须携带. “clientid” 可以被 wap 网关或用户群组管理平台加入，并随请求消息送到 glms。clientid 应该携带明文的用户 id 信息。glms 信任“clientid”所包含的用户 id 就是请求发起者的 用户 id。 注意：运营商也可以选用其它的 http 头作为用于认证的头，如：3gpp-accerted- identify. 但所有的发送到 glms 的请求必须使用相同的头。 用于识别客户端协议版本的头: glmsclientversion “glmsclientversion” 在每个http请求中都必须携带. glms 客户端用“glmsclientversion”表示它所实现的 glms 协议版本。对应于本规范，版本号 应为“11.01” 注意：运营商也可以选用其它的 http 头作为用于版本标识的头，如：glms-group- version. 但所有的发送到 glms 的请求必须使用相同的头。 3.2.2 put 和 post 必须携带的头 对 xcap put 操作 , 下列 http 头必须携带：“content type” 和 “content length”. content type content-type 头域指定所包含的消息体的媒体类型。其格式为: content-type = “content-type“ “:“ media-type 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 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 位字节数）。其格式为： content-length = “content-length“ “:“ 1*digit 例如: content-length: 3495 3.2.3get 多播群组 gsk 必须携带的头：q-cnonce 当客户端想要发送 xcap get 请求来获取多播群组的包括 gsk 在内的多播信息时，必须携带 q- cnonce 头。该 http 头包含 ptt 客户端产生的 cnonce 值。glms 会利用该 cnonce 产生用于加密 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。 客户 端可以根据所请求资源的实体标签（entity tag）来做条件请求. 这些条件请求的头域在请 求消息里是可选用的. 条件请求的头域可以解决并发请求的冲突问题。 if-match 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 9 页 if-match 请求头域被 http 方法(put/delete)用来做有条件操作. 对一个或多个从 群组服务器获得的实体，xds 客户端可以在请求的if-match头中包含某个实体的 entity tag 以确认它所具有的那个实体是最新的. if-match 头可以被用在以下场景中: 条件 put xdm 客户端想增加或修改服务器 xdm 文档中的某个元素（element），并且希望服务器所 具有的文档版本和客户端当前所具有的那个文档相同时才能修改。客户端可以在请求中包 含 if-match 头, 并将客户端所具有的实体标签（entity tag）值写在里面. 如果文档已经改变，群组服务器会拒绝这个请求返回 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 来判断服务器对统一文档是 否有更新。如果本地文档仍然是最新的，客户端就不会重新下载文档，以此节省网络的使 用。为了达到这个目的，客户端在 get 请求中携带 if-none-match 头域，其中包含客户端当 前文档的实体标签（entity tag）. 群组服务器如果发现服务器文档标签和客户端不同，会响 应 200 ok. 如果服务器文档标签和客户端相同, 服务器会响应 304. 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 10 页 3.33.3群组管理服务器群组管理服务器 xcap 请求请求 urlurl 1. xcap 根节点 （xcap root） xcap 根定义了所有可被请求的资源所在的位置. xcap 根用 http uri 表示, 被称为 xcap 根 rui。对群组服务 xcap 根 被定义为/glms fqdn/glms-services. 注：在具体构造 http 请求时，glms fqdn 应该为 glms 服务器的地址，并且在发出 http 请求时放在 host http 头中，而不是在 request-uri 中。另外，由于 glms 有主 副地址，glms fqdn 可能是两个。（关于主副地址，请参见第 7 章） 2. 文档选择器 （document selector） 在文档根节点下的每一个 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. 节点选择器 （node selector） 节点选择器指定 xml 文档中具体被操作的节点. 节点选择器指向 xml 元素或元素属性. 4. 产生 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 业务终端参数配置接口技术要求-群组数据分册 第 11 页 文档选择器（document selector） 部分可以是用户特定的文档或全局文档。节点选择器 （node selector ）部分是 xml 文档中的元素. 更多详情参见本规范的具体例子. 3.4群组管理服务器器后向兼容对客户端群组管理服务器器后向兼容对客户端 xmlxml 解析的要求解析的要求 这里的群组管理服务器客户端指所有与 glms 进行 http/xcap 通信客户端应用程序。 glms 会不断加入新的功能. 群组管理的 xml schema 在将来可能会扩展。glms 升级到新 的版本而客户端有可能仍然是旧的版本。为了使glms 后向兼容，glms 客户端的实现必须 要遵循以下建议: oglms 客户端必须忽略服务器返回的合法的 xml 文档中不能识别的 xml 元素 或 属性，而不是报错退出对文档的处理. 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 12 页 4群组管理服务器群组管理服务器 httphttp 接口规范接口规范 4.1概述概述 glms 为客户端应用提供 xcap 接口来管理服务器存储的群组 xml 文档. 客户端应用可以 读取/更新/删除 xml 文档及其 xml 元素和属性. 本章给出群组管理服务器 xcap 接口规范。 4.2正常响应正常响应 如果客户端的请求被成功处理，glms支持成功的 2xx 状态码： 状态码状态码描述描述 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 请求被执行并其请求的 resrouce 已经产生. 示例消息: http/1.1 201 created etag: “ababab“ . . . content-length: 0 202 (accepted) 响应 当 xcap put 请求正在执行但处理并没有全部完成 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 13 页 示例消息: http/1.1 202 accepted . . . content-length: 0 4.3错误错误响应响应 xcap 使用与http协议相同定义的错误响应状态码。glms支持3类错误状态码：3xx, 4xx, 和 5xx. 3xx 是重定向状态码，指示客户端为满足请求去采取其它的行动。4xx 是客户端错 误码，指出客户端请求可能包含的错误. 5xx 是服务器错误码，指示服务器知道自己遇到问 题而不能处理当前的请求。 状态码状态码描述描述 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 业务终端参数配置接口技术要求-群组数据分册 第 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 操作响应。请求因对当前资源的冲突而不能完成。 409 响应可携带 xml 消息体来指定冲突的具体原因。 以下是 409 响应中所包含的“xcap-error” data schema. “xcap-error” 可以用来给出具体冲突原因。 客户端应该支持以下 schema： 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 15 页 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 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 业务终端参数配置接口技术要求-群组数据分册 第 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 操作响应。 群组服务器不接受请求消息中的内容编码。 响应消息示例: 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 业务终端参数配置接口技术要求-群组数据分册 第 19 页 2. shared-group-lucent.xsd 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 20 页 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 21 页 3. resource-lists.xsd 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 22 页 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 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 业务终端参数配置接口技术要求-群组数据分册 第 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 业务终端参数配置接口技术要求-群组数据分册 第 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使用场景使用场景 场景总结 创建多播共享群组文档 从“用户树”下获取共享群组文档 从“全局树”下获取共享群组文档 删除共享群组文档 添加/修改共享群组的显示名称 添加/修改共享群组的主题 添加/修改共享群组的主管理人 改变共享群组的 vocoder 类型 增加组成员 修改组成员信息 删除组成员 添加/修改共享群组成员的显示名称 修改组成员的通话优先级 修改组成员的成员状态 组成员选择退出共享群组 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 27 页 创建多播共享群组文档创建多播共享群组文档 .1.概述 该操作用来创建用户或企业的多播共享群组文档. 用户会被无条件加入到组中。 成功的 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 创建一个共享群组 1.xdm 客户端创建一个共享群组。它发起一个 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 业务终端参数配置接口技术要求-群组数据分册 第 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.如果创建的群组中包含组成员，glms 通知成员他们被加入到新的群组中。 2.组成员的客户端软件从 glms 中获取群组信息。这是通过对 group association 的 xcap get 请求获得的. 中国电信 qchat 业务终端参数配置接口技术要求-群组数据分册 第 29 页 从从“用户树用户树”下获取共享群组文档下获取共享群组文档 .1.概述 该操作用来从“用户树”下获取用户或企业的共享群组文档. xcap get 请求的响应消息 包含详细的共享群组信息. 不同的请求者根据不同的权限会得到不同的请求结果： 1.全部群组信息包括群组名，主题，状态，成员，成员通话优先级，组创建信息等 2.部分群组信息包括群组名，主题，成员（没有通话优先级）, 组状态 3.部分群组信息包括群组名，主题，成员（有通话优先级）, 组状态 成功的 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 客户端要得到一个用户或企业的某一群组文档。它发起 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