This action is used in a solution on a PN-receiving mobile device. It registers a text string as the external PN key of that solution on that mobile device. Note that the device is registered with the specified external PN key for a particular solution. Multiple solutions on a device can each register a different external PN key.
When sending a PN, there are different ways to define a set of PN receivers. One way is to specify that the PN is sent to one or more external PN keys (see Send Push Notification). So, if a device has been registered using one of the targeted external PN keys, then the PN will be sent to that device—more specifically, to the receiving solution on that device that registered the target PN key.
|Note:||External PN keys can also be used in AppStore Apps.|
See also: The Receiving Solution
To register an external PN key, select Register, and specify a key via an XPath expression. The expression must resolve to a text string. In the screenshot below, for example, when a button is clicked, a string located in a page source node is registered as the external PN key of that device. Now, if a PN is sent to this key, then that mobile device will receive the PN.
If at some point the user wishes to not receive PNs that are addressed to a given external PN key, then the Unregister action can be used to cancel the registration. This could be done, for example, on a button tap.
To unregister a PN, add the action and select Unregister. Since only one external PN key exists for a solution at any given time, you do not need to specify the key.
MobileTogether provides a range of XPath extension functions that have been specifically created for use in MobileTogether designs. Some functions can be particularly useful with specific actions. For example, mt-available-languages() returns the languages in which the solution is available and could, for example, be used with the Message Box action. If a function is especially relevant to this action, it is listed below. For a full list of extension functions and their descriptions, see the topic MobileTogether Extension Functions.