3. DISEÑO METODOLÓGICO
3.4. METODOLOGÍA MAGERIT ISO 27001
int SendMMS(strInSerialNo, strInSMSKey, strInTransactionID, strInRecipients, strInSubject, strInReplyEmail, strOutMessageIDs) Description
This method sends a MMS-notification message for the MMS message identified by the transaction ID in the parameter strInTransactionID, to the (possibly multiple) mobile destinations as specified in the parameter strInRecipients.
The MMS-notification message is just a notification to the destination handsets, upon receiving which will retrieve the actual MMS message (if the handset is setup to retrieve MMS message) from the redcoal MMS Gateway. The MMS message identified by strInTransactionID must be previously created using the method CreateMMS and have at least one content part added to it using the method AddMMSContent. If no content part is previously added to the MMS message, this method will not send any MMS message and will return error code 44 (empty MMS message content).
The type of MMS message depends on the contents previously added. If a SMIL document is added, then the MMS message is of type ‘multipart/related’. If no SMIL document is added before, then the MMS
message is oftype ‘multipart/mixed’.
An optional parameter strInSubject is used to give the MMS message a subject. The use of this parameter is just like the subject field of emails. If strInSubject is blank,then a defaultsubject“MMS”willbe substituted. By default, the email address of the user (from the user account) will be used as the sender of the MMS message. This is an account setting that can be disabled under the ‘Services’page ofthe login section.Ifdisabled,the sender of the MMS message will be anonymous.
A notification will be sent to the sender via email specified in the parameter strInReplyEmail when one of the situations outlined in section 2.4 occurs.
Each MMS-notification (not the actual MMS message which is identified by the transaction ID) deposited for each destination in strInRecipients will be assigned a unique message identifier, returned via the output parameter strOutMessageIDs. Call the method CheckMessageStatus to check the status of the message for a particular destination (delivered, processed etc.).
Parameters
Parameters Type In/Out Description
strInSerialNo String In User serial number
strInSMSKey String In User password (SMSKey) strInTransactionID String In The ID that uniquely identifies
the MMS message. strInRecipients String In Comma separated list of
recipients’mobile numbers, preferably in international format, e.g.
+4179123123,+6140123123 strInSubject String In The subject of the MMS
message.
strInReplyEmail String In Error notifications and message delivery confirmations (if
enabled) will be sent to this reply email address.
strOutMessageIDs String Out Comma separated list of message identifiers, each corresponds to the message sent to a destination in the same order specified in strInRecipients, e.g. +4179123123:123456, +6140123123:123457
Error Code
The error codes that may be returned by this method are (see Appendix A for the possible meanings of these error codes):
0,2,3,4,5,6,8,10,12,13,15,16,18,21,42,44
Example . .
Dim strInSerialNo As String = "my serial number" Dim strInSMSKey As String = "my SMS key"
Dim strInOutTransactionID As String .
.
'---CreateMMS must be called first to get the
'---returned transaction ID in strInOutTransactionID '---then various content parts should also be
'---added to the MMS message by AddMMSContent
. .
Dim strInRecipients As String = "+4179123123,+6140123123"
Dim strInSubject As String = "Some Subject"
Dim strInReplyEmail As String = "[email protected]" Dim strOutMessageIDs As String
. .
Dim Result As Integer
Result = ws.SendMMS(strInSerialNo, strInSMSKey, strInOutTransactionID, strInRecipients, strInSubject, strInReplyEmail, strOutMessageIDs) . .
3.14
SendMobileContent
Synopsis int SendMobileContent(strInSerialNo, strInSMSKey, strInRecipients, strInCodeID, strInExtraParam, strInReplyEmail, iInOptions, strOutMessageIDs) DescriptionThis method sends a mobile content hosted at redcoal to the (possibly multiple) mobile destinations as specified in the parameter strInRecipients. redcoal hosts a pool of mobile contents such as (mono and polyphonic) ring tones, operator logos, pictures (for picture messages), etc. for mobile handset customizations. Text SMS messages and picture messages can also be composed and customized to be sent. These contents are available for purchase at http://www.redcoal.com/ and can be previewed using the method GetMobileContentPreviewURL.
Each content has a unique code ID to identify it. The code ID of the mobile content to be sent is then specified in the parameter strInCodeID. The parameter strInExtraParam is, at the moment, mainly used for specifying the network ID (see SendBinarySMS and Appendix D) if the mobile content is an operator logo. This parameter will be ignored for other content types, but is preserved for future use.
The parameter iInOptions is similar to that of SendSMS2 without source types of the mobile content, since the source type is already determined by the mobile content identified in strInCodeID. Hence the parameter iInOptions only includes the following options (details can be found in SendSMS2):
Confirmation from SMSC (0x100 = 256).
Confirmation from handset (0x200 = 512).
Testing mode (0x1000 = 4096).
assigned a unique message identifier, returned via the output parameter strOutMessageIDs. Call the method CheckMessageStatus to check the status of the message for a particular destination (delivered, processed etc.).
Parameters
Parameters Type In/Out Description
strInSerialNo String In User serial number
strInSMSKey String In User password (SMSKey) strInRecipients String In Comma separated list of
recipients’mobile numbers, preferably in international format, e.g. +4179123123,+6140123123 strInCodeID String In The code ID of the mobile
content to be sent.
strInExtraParam String In At the moment, this parameter should contain the network ID if the mobile content is an operator logo. This parameter will be ignored for other content types and is reserved for future use. strInReplyEmail String In Error notifications and message
delivery confirmations (if
specified in iInOptions) will be sent to this reply email address. iInOptions Integer In This parameter specifies the
following options:
SMSC confirmation (256)
Handset confirmation
(512)
Testing mode (4096) strOutMessageIDs String Out Comma separated list of
message identifiers, each
corresponds to the message sent to a destination in the same order specified in strInRecipients, e.g. +4179123123:123456,
+6140123123:123457
Error Code
The error codes that may be returned by this method are (see Appendix A for the possible meanings of these error codes):
0,2,3,4,5,6,8,10,12,13,16,18,21,71
See also
CheckMessageStatus, SendSMS2, SendBinarySMS, GetMobileContentPreviewURL
Example . .
Dim strInSerialNo As String = "my serial number" Dim strInSMSKey As String = "my SMS key"
Dim strInRecipients As String = "+4179123123,+6140123123"
Dim strInCodeID As String = "12345"
'---suppose this is an operator logo
'---then the following contains the network ID
Dim strInExtraParam As String = "505 01"
Dim strInReplyEmail As String = "[email protected]"
'---request only confirmation from SMSC
Dim iInOptions As Integer = 256 Dim strOutMessageIDs As String .
.
Dim Result As Integer
Result = ws. SendMobileContent(strInSerialNo, strInSMSKey, strInRecipients, strInCodeID, strInExtraParam, strInReplyEmail, iInOptions, strOutMessageIDs) . .