联通MM7彩信平台技术

 

下表12.21给出了当前所定义的状态码和状态文本。

表12.21：状态码和状态文本

状态码	状态文本	含义
1000	成功	此代码指示完全执行了请求。
1100	部分成功	此代码指示部分执行了请求，但部分请求无法完成。低阶位和可选“详细信息”单元可以指示未完成的请求部分。
2000	客户机错误	客户机发出的请求无效。
2001	操作受限	由于缺少执行命令的权限，请求被拒绝。
2002	地址错误	请求中所提供地址的格式无法识别或MMSRelay/ServerRelay/Server确认地址对于网络无效，因为此MMSRelay/ServerRelay/Server不会对其提供服务。如果该地址用于响应结果中，并且在相应的推式（push）提交中指定了多个接收方，则此状态码指示至少有一个地址不正确。
2003	找不到地址	MMSRelay/ServerRelay/Server找不到请求中提供的地址。如果在以前提交的消息中请求了操作但MMSRelay/ServerRelay/Server找不到指定地址的消息，则将返回此代码。
2004	多媒体内容被拒绝	服务器无法解析附加至SOAP消息并通过“内容”单元指示的MIME内容，或无法接受该内容大小或媒体类型。
2005	找不到消息ID	如果在以前提交的消息中请求了操作，但MMSRelay/ServerRelay/Server找不到指定消息ID的消息，或者VASP收到有关无法识别以前所提交消息和消息ID的报告，将返回此代码。
2006	找不到链接ID（LinkedID）	如果已提供LinkedID，但MMSRelay/ServerRelay/Server找不到相关消息，将返回此代码。
2007	消息格式破坏	信息单元值格式不合适或不正确。
3000	服务器错误	服务器未能实施明显有效的请求。
3001	不可接受	由于不可接受，而无法执行请求。此状态码通常在以下情况中使用：当对不能再被取消或状态查询的消息进行取消或状态查询操作时。MMSRelay/ServerRelay/Server已识别所述消息，但由于该消息已完成或其状态不再可用而无法实施。
3002	消息被拒绝	服务器无法完成请求的服务。
3003	不支持多个地址	MMSRelay/ServerRelay/Server不支持对多个接收方执行此操作。该操作可以作为多个单一的接收方操作重新提交。
4000	一般服务错误	无法实施请求的服务。
4001	标识不正确	请求的标识标题不能唯一标识客户机（VASP或MMSRelay/ServerRelay/Server）。
4002	版本不支持	不支持MM7版本单元所指示的版本。
4003	操作不支持	服务器不支持消息标题中“消息类型”单元所指示的请求。
4004	验证错误	无法解析SOAP和XML结构、缺少必备字段或消息格式与指定格式不兼容。“详细信息”字段可能会给出导致此状态的解析错误。
4005	服务错误	操作导致服务器（MMSRelay/ServerRelay/Server或VASP）失败，不应重新发送。
4006	无法提供服务	当服务器暂时不可用（例如，服务器忙）时，服务器可能会发送此指示。
4007	服务被拒绝	客户机无权执行所请求的操作。

 

12.9      将信息单元映射至SOAP单元

以下小节详细讲述摘要消息中的信息单元与SOAP单元之间的映射。此文档的“附录L”中提供了对MM7参考点完整的“XML模式”定义。SOAP单元取值格式的规范包含在该模式中。

12.9.1    MM7_submit.REQ映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”元单元
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0
VASP ID	SOAP正文	VASPID
VAS ID	SOAP正文	VASID
Sender Address	SOAP正文	SenderAddress
Recipient Address	SOAP正文	Recipients	将不同的地址格式指定为单元取值的一部分。
Service code	SOAP正文	ServiceCode	为计费提供的信息–具体格式取决于实现。
Linked ID	SOAP正文	LinkedID	已链接消息的消息ID
Message class	SOAP正文	MessageClass	枚举–可能值：信息、广告、自动
Date and time	SOAP正文	TimeStamp
Time of Expiry	SOAP正文	ExpiryDate
Earliest delivery time	SOAP正文	EarliestDeliveryTime
Delivery report	SOAP正文	DeliveryReport	布尔值：真或假
Read reply	SOAP正文	ReadReply	布尔值：真或假
Reply-Charging	SOAP正文	ReplyCharging	无值–存在时隐含为“真”！
Reply-Deadline	SOAP正文	replyDeadline	应答计费单元日期格式的属性–绝对或相对。
Reply-Charging-Size	SOAP正文	replyChargingSize	应答计费单元的属性。
Priority	SOAP正文	Priority	枚举–可能值：高、正常、低
Subject	SOAP正文	Subject
Adaptations	SOAP正文	allowAdaptations	内容单元的属性。 布尔值：真或假
Charged Party	SOAP正文	ChargedParty	枚举–可能值：发送方、接收方、双方付费、双方都不付费
Message Distribution Indicator	SOAP正文	DistributionIndicator	布尔值：真或假
Content type	MIME标题–附件	Content-Type
Content	SOAP正文	Content	href:cid属性链接至附件

 

12.9.2    MM7_submit.RES映射

 

消息提交实例：

POST/mms-rs/mm7HTTP/1.1
Host:mms.omms.com
Content-Type:multipart/related;boundary=”NextPart_000_0028_01C19839.84698430";type=text/xml;
       start=”</tnn-200102/mm7-submit>”
Content-Length:nnnn
SOAPAction:“”

--NextPart_000_0028_01C19839.84698430
Content-Type:text/xml;charset=”utf-8”
Content-ID:</tnn-200102/mm7-submit>

<?xmlversion=’1.0’?>
<env:Envelopexmlns:env="http://schemas.xmlsoap.org/soap/soap-envelope">
<env:Header>
      <mm7:TransactionIDxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”env:mustUnderstand=”1”>

                    vas00001-sub

             </mm7:TransactionID>
   </env:Header> 

       <env:Body>
       <mm7:SubmitReqxmlns:mm7="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”>
                    <MM7Version>5.3.0</MM7Version>

                    <SenderIdentification>

                           <VASPID>TNN</VASPID>
                           <VASID>News</VASID>

                    </SenderIdentification>
                    <Recipients>

                           <To>
                                 <Number>7255441234</Number>
                                 <RFC2822AddressdisplayOnly=”True”>[e-mail]</RFC2822Address>

                           </To>

                           <Cc>
                                 <Number>7255443333</Number>

                           </Cc>

                           <Bcc>
                                 <RFC2822Address>[e-mail]</RFC2822Address>

                           </Bcc>
                    </Recipients>
                    <ServiceCode>gold-sp33-im42</ServiceCode>
                    <LinkedID>mms00016666</LinkedID>
                    <MessageClass>Informational</MessageClass>
                    <TimeStamp>2002-01-02T09:30:47-05:00</Date>

                    <EarliestDeliveryTime>2002-01-02T09:30:47-05:00</EarliestDeliveryTime>

                    <ExpiryDate>P90D</ExpiryDate>

                    <DeliveryReport>True</DeliveryReport>
                    <Priority>Normal</Priority>

                    <ChargedParty>Sender</ChargedParty>

                    <DistributionIndicator>True</DistributionIndicator>
                    <Subject>Newsfortoday</Subject>
                    <Contenthref=”cid:[e-mail]”;allowAdaptations=”True”/>
             </mm7:SubmitReq>
   </env:Body>

</env:Envelope>

 

--NextPart_000_0028_01C19839.84698430
Content-Type:multipart/mixed;boundary=”StoryParts7452684322002-77645”

Content-ID:<[e-mail]>

 

--StoryParts7452684322002-77645

Content-Type:text/plain;charset="us-ascii"

 

Sciencenews,newSaturnpictures...

 

--StoryParts7452684322002-77645

Content-Type:image/gif;

Content-ID:<saturn.gif>

 

R0lGODdhZAAwAOMAAAAAAIGJjGltcDE0OOfWo6Ochbi1n1pmcbGojpKbnP/lpW54fBMTE1RYXEFO

…

 

--StoryParts7452684322002-77645--

--_NextPart_000_0028_01C19839.84698430--

 

对于HTTP响应消息中的VAS应用程序，MMSRelay/ServerRelay/Server会将响应消息发送回VASP。

HTTP/1.1200OK

Content-Type:text/xml;charset=”utf-8”

Content-Length:nnnn

 

<?xmlversion=’1.0’?>

<env:Envelopexmlns:env="http://schemas.xmlsoap.org/soap/soap-envelope">

<env:Header>

      <mm7:TransactionIDxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”env:mustUnderstand=”1”>

                    vas00001-sub

             </mm7:TransactionID>

   </env:Header>
       <env:Body>

       <MM7Version>5.3.0</MM7Version>

             <Status>

                    <StatusCode>1000</StatusCode>

                    <StatusText>Success</StatusText>

             </Status>

             <MessageID>041502073667</MessageID>

   </env:Body>
</env:Envelope>

12.9.3    MM7_deliver.REQ映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
MMS Relay/Server ID	SOAP正文	MMSRelayServerID
Linked ID	SOAP正文	LinkedID	已链接消息的消息ID。
Sender address	SOAP正文	Sender
Recipient address	SOAP正文	Recipients	如果未出现，则使用发送方地址。
Date and time	SOAP正文	TimeStamp
Reply-Charging-ID	SOAP正文	ReplyChargingID	应与以前MM7_submit.REQ中出现的ID相对应。
Priority	SOAP正文	Priority	枚举–可能值：高、正常、低。
Subject	SOAP正文	Subject
Content type	附件的MIME标题	Content-Type
Content	SOAP正文	Content	href:cid属性链接至附件

 

12.9.4    MM7_deliver.RES

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
Service code	SOAP正文	ServiceCode
Request status	SOAP正文	StatusCode	参见12.8.3.1节。
Request status text	SOAP正文	StatusText&Details	参见12.8.3.1节。

 

传送请求和响应实例

POST/mms/weather.xmlHTTP/1.1

Host:www.yahoo.com

Content-Type:multipart/related;boundary=”NextPart_000_0125_01C19839.7237929064";type=text/xml;

       start=”</cmvt256/mm7-deliver>”

Content-Length:nnnn

SOAPAction:“”

 

--NextPart_000_0125_01C19839.7237929064

Content-Type:text/xml;charset=”utf:8”

Content-ID:</cmvt256/mm7-submit>

 

<?xmlversion=’1.0’?>

<env:Envelopexmlns:env="http://schemas.xmlsoap.org/soap/soap-envelope">

<env:Header>

      <mm7:TransactionIDxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”env:mustUnderstand=”1”/>

                    vas00324-dlvr

             </mm7:TransactionID>

   </env:Header>

       <env:Body>

       <!--ExampleofMM7_deliverReq-->

             <mm7:DeliverReqxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”>

                    <MM7Version>5.3.0</MM7Version>

                    <MMSRelayServerID>240.110.75.34</MMSRelayServerID>

                    <Sender>[e-mail]</Sender>

                    <LinkedID>wthr8391</LinkedID>

                    <TimeStamp>2002-04-15T14:35:21-05:00</TimeStamp>

                    <Priority>Normal</Priority>

                    <Subject>WeatherForecast</Subject>

                    <Contenthref=cid:forecast-location200102-86453/>

             </mm7:DeliverReq>

   </env:Body>

</env:Envelope>

 

--NextPart_000_0125_01C19839.7237929064

Content-Type:text/plain;charset=”utf-8”

Content-ID:<forecast-location2000102-86453>

 

LosAngeles,Calif,USA
--_NextPart_000_0125_01C19839.7237929064--

 

 

传送响应消息可能如下（包含一个应用程序错误代码）：

HTTP/1.1200OK

Content-Type:text/xml;charset=”utf-8”

Content-Length:nnnn

 

<?xmlversion=’1.0’?>

<env:Envelopexmlns:env="http://schemas.xmlsoap.org/soap/soap-envelope">

<env:Header>

      <mm7:TransactionIDxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”env:mustUnderstand=”1”>

                    vas00324-dlvr

             </mm7:TransactionID>

   </env:Header>

       <env:Body>

       <mm7:DeliverRspxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”>

                    <MM7Version>5.3.0</MM7Version>

                    <ServiceCode>wthr-badl-6521</ServiceCode>

                    <Status>

                           <StatusCode>4006</StatusCode>

                           <StatusText>ServiceUnavailable</ServiceText>

                           <Detail>Locationnotcoveredinservice</Detail>

                    </Status>

             </mm7:DeliverRsp>

   </env:Body>

</env:Envelope>

 

 

12.9.5    MM7_cancel.REQ映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
VASP ID	SOAP正文	VASPID
VAS ID	SOAP正文	VASID
Sender Address	SOAP正文	SenderAddress
Message ID	SOAP正文	MessageID

 

12.9.6    MM7_cancel.RES映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
Request status	SOAP正文	StatusCode	参见12.8.3.1节。
Request status text	SOAP正文	StatusText&Details	参见12.8.3.1节。

 

以下为MM7_cancel.REQ和MM7_cancel.RES的消息交换，以此描述一个不包括多媒体内容部分的SOAP消息。

POST/mms-rs/mm7HTTP/1.1

Host:mms.omms.com

Content-Type:text/xml;charset=”utf-8”

Content-Length:nnnn

SOAPAction:“”

 

<env:Envelopexmlns:env="http://schemas.xmlsoap.org/soap/soap-envelope">

<env:Header>

      <mm7:TransactionIDxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”env:mustUnderstand=”1”>

                    vas0000—can

             </mm7:TransactionID>

   </env:Header>

       <env:Body>

       <mm7:CancelReqxmlns:mm7="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”>

                    <MM7Version>5.3.0</MM7Version>

                    <SenderIdentification>

                           <VASPID>TNN</VASPID>

                           <VASID>Reminder</VASID>

                    </SenderIdentification>

                    <MessageID>mms000222222</MessageID>

             </mm7:CancelReq>

   </env:Body>

</env:Envelope>

 

HTTP/1.1200OK

Content-Type:text/xml;charset=”utf-8”

Content-Length:nnnn

 

<env:Envelopexmlns:env="http://schemas.xmlsoap.org/soap/soap-envelope">

<env:Header>

      <mm7:TransactionIDxmlns:mm7=”http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”env:mustUnderstand=”1”>

                    vas0000—can

             </TransactionID>

   </env:Header>

       <env:Body>

       <mm7:CancelRspxmlns:mm7="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-0”>

                    <MM7Version>5.3.0</MM7Version>

                    <Status>

                           <StatusCode>1000</StatusCode>

                           <StatusText>Success</StatusText>

                    </Status>

             </mm7:CancelRsp>

   </env:Body>

</env:Envelope>

 

 

12.9.7    MM7_replace.REQ消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
VASP ID	SOAP正文	VASPID
VAS ID	SOAP正文	VASID
Sender address	SOAP正文	SenderAddress
Message ID	SOAP正文	MessageID
Service code	SOAP正文	ServiceCode	为计费提供的信息–具体格式取决于实现。
Date and time	SOAP正文	TimeStamp
Earliest delivery time	SOAP正文	EarliestDeliveryTime	日期格式–绝对或相对
Read reply	SOAP正文	ReadReply	布尔值–真或假
Adaptations	SOAP正文	allowAdaptations	内容单元的属性。 布尔值–真或假。
Content type	MIME部分标题	Content-Type
Content	SOAP正文	Content	href:cid属性链接至附件
Message Distribution Indicator	SOAP正文	DistributionIndicator	布尔值：真或假

 

12.9.8    MM7_replace.RES消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	Transaction-ID
Message-Type	SOAP正文	Message-Type	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7-Version	取值为此规范的编号，例如5.2.0。
Request status	SOAP正文	StatusCode	参见12.8.3.1节。
Request status text	SOAP正文	StatusText&Details	参见12.8.3.1节。

 

12.9.9    MM7_delivery_report.REQ消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
MMS Relay/Server ID	SOAP正文	MMSRelayServerID
Message ID	SOAP正文	MessageID
Recipient address	SOAP正文	Recipient
Sender address	SOAP正文	Sender
Date and time	SOAP正文	TimeStamp
MM Status	SOAP正文	MMStatus	枚举–可能值：已超时、已接收、已拒绝、不确定、已转发。
MMS Status Error Code	SOAP正文	MMS Status Error Code	具体的错误代码请参见设备规范
Status text	SOAP正文	StatusText

 

12.9.10  MM7_delivery_report.RES消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
Request Status	SOAP正文	StatusCode	参见12.8.3.1节
Request Status text	SOAP正文	StatusText&Details	参见12.8.3.1节。

 

12.9.11  MM7_read_reply.REQ消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
MMS Relay/Server ID	SOAP正文	MMSRelayServerID
Message ID	SOAP正文	MessageID
Recipient address	SOAP正文	Recipient
Sender address	SOAP正文	Sender
Date and time	SOAP正文	TimeStamp
Read Status	SOAP正文	MMStatus	枚举–可能值：不确定、未读取、未读取的情况下被删除。
Status text	SOAP正文	StatusText

 

12.9.12  MM7_read_reply.RES消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
Request status	SOAP正文	StatusCode	参见12.8.3.1节。
Request status text	SOAP正文	StatusText&Details	参见12.8.3.1节。

 

12.9.13  MM7_RS_error.RES消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	TransactionID
Message-Type	SOAP正文	MessageType	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7Version	取值为此规范的编号，例如5.2.0。
Error status	SOAP正文	StatusCode	参见12.8.3.1节。
Error status text	SOAP正文	StatusText&Details	参见12.8.3.1节。

 

12.9.14  MM7_VASP_error.RES消息的映射

信息单元	位置	单元名称	备注
Transaction ID	SOAP标题	Transaction-ID
Message-Type	SOAP正文	Message-Type	定义为SOAP正文的“根”单元。
MM7 Version	SOAP正文	MM7-Version	取值为此规范的编号，例如5.2.0。
Error status	SOAP正文	StatusCode	参见12.8.3.1节。
Error status text	SOAP正文	StatusText&Details	参见12.8.3.1节。