Element: <resultnotification-message>
The
BlackBerry® Infrastructure sends the
<resultnotification-message> element to the
content provider. This notification message specifies the outcome of the push
submission for a set of
BlackBerry
devices after the final result is known. This notification message is sent only
if the original push request was accepted for delivery by the
BlackBerry Infrastructure.
On rare occasions, the
BlackBerry Infrastructure returns an
address of
* in the result notification. This happens when the
BlackBerry Infrastructure no longer has address information for the original push
message but does have the final status of the message. In that case, the
addresses are unknown, so the
BlackBerry Infrastructure substitutes
*.
The acknowledgment notification message includes a child
<quality-of-service> element if the element was
included in the push request.
Attributes
|
Attribute
|
Value(s)
|
Description
|
|
push-id
|
unique_id
|
This attribute specifies a string that uniquely identifies
the original push request.
|
|
sender-address
|
URL
|
This attribute specifies the URL of the server within the
BlackBerry Infrastructure. Optional.
|
|
sender-name
|
text_name
|
This attribute specifies the name of the server within the
BlackBerry Infrastructure. Optional.
|
|
received-time
|
time_stamp
|
This attribute specifies the date and time at which the
original push request sent from the content provider was received by the
BlackBerry Infrastructure. Optional.
The time stamp uses 24-hour UTC format, which is specified
using the following format:
YYYY-MM-DDThh:mm:ssZ
For example, a value of
2009-03-10T23:59:00Z specifies a reply time
and date of 11:59 on March 10, 2009.
|
|
event-time
|
time_stamp
|
This attribute specifies the date and time at which the push
request reached its final state (delivered or failed). Optional.
The time stamp uses 24-hour UTC format, specified using the
following format:
YYYY-MM-DDThh:mm:ssZ
For example, a value of
2009-03-10T23:59:00Z specifies a reply date
11:59 on March 10, 2009.
|
|
message-state
|
delivered
pending
rejected
undeliverable
expired
aborted
timeout
cancelled
unknown
|
This attribute specifies the final state of the push request
message. This attribute can have one of the following values:
- delivered: The
message was successfully delivered to the specified
BlackBerry device.
- pending: The message
was in the process of being sent to the specified device.
- undeliverable: The
message cannot be delivered to the specified device.
- expired: The message
reached its maximum age before it could be delivered to the specified device.
- cancelled: The
message was cancelled by the Push Initiator before being delivered to the
specified device.
- unknown: The
BlackBerry Infrastructure cannot determine the final state of the message for the
specified device.
|
|
code
|
status_code
|
This attribute specifies the code that indicates the outcome
of the push request.
|
|
desc
|
description
|
This attribute provides text describing the outcome of the
push request. Optional.
|
Was this information helpful? Send us your comments.
