Pushing data to a BlackBerry user group
BlackBerry user groups represent multiple recipients that use the same address. Groups are controlled on the BlackBerry Device Service, so users can be added or removed without changing the address of the group. This reduces the complexity of adding many individual addresses to a push request, and minimizes the size of the push request.
When you send a push request to a group, the BlackBerry MDS Connection Service considers the group to be a single entity, which can the inhibit flexibility of a push application. For example, if you submit a reliable push request for a group, you do not receive a result notification for each member of the group. Instead, the BlackBerry MDS Connection Service returns a single result notification for the entire group. If you use the PAP push format, you cannot cancel or query the status of the push request for a particular group member.
The BlackBerry MDS Simulator does not support pushing data to groups, so you cannot test pushing data to groups in a simulated environment.
To push data to a group
Using the PAP push format: Include a single <address> element for the group. The address-value attribute specifies the group name.
To identify the value as a BlackBerry user group, you must prefix the group name with a URL encoded $ character (%24). The following XML indicates that the push request should be sent to a single group called Marketing:
<address address-value="WAPPUSH=%24Marketing/TYPE=USER@blackberry.com"/>Note: All non-alphanumeric characters in the device email portion of the address-value attribute, other than "+", "-", ".", or "_" must be URL encoded as hexadecimal values in the PAP control entity.
Using the BlackBerry push format: Add a DESTINATION parameter for the group to the request.
To identify the value as a BlackBerry user group, you must prefix the group name with a $ character. The following URL indicates that the push request should be sent to a single group called Marketing:
http://mds_server:8080/push?DESTINATION=$Marketing&PORT=7874&REQUESTURI=/Note: For RIM push, the application ID can be passed in the PORT parameter.
Was this information helpful? Send us your comments.