The developer should pay attention to the following issues when using the Nokia Notifications API for developing the notifications service and the MIDlet, and switching between the Nokia Notification Server environments (developing and testing in the sandbox, and running in the production or Chinese production environment). There are some values that need to modified to run the notifications service successfully in each of the environments. The following table presents what is notifications service specific and what is not. It also considers what needs to be taken into account when developing the notifications service and the MIDlet, and switching between the different service environments (sandbox, production and Chinese production).
Term |
Environment specific |
Pay attention to this |
|---|---|---|
Application ID |
No |
An Application ID remains the same regardless of the environment. The MIDlet need not be changed in any way when switching between the environments. The Notification Enabler, however, needs to be pointed to the correct environment when switching between environments. |
Nokia Developer Console Sending Tool |
Yes |
The Nokia Developer Console sending tool can be used to send notifications to MIDlets in the sandbox environment, and cURL in the production or the Chinese production environments. |
Notification ID |
Yes |
The sandbox and the production environments make use of the common base of the Notification IDs. The Chinese production environment uses different Notification IDs. The developer needs to design the notifications service such that it stores the Notification IDs correctly and distinguishes the Notification IDs between the environments. This is to ensure that when sending a notification to a device in a selected environment, the Notification ID belongs to the target environment. |
Notification Enabler |
Yes |
The Notification Enabler can be configured to point to any one of the three Nokia Notification Server environments at a time. The developer needs to use the Environment Selector application on the device to set the Notification Enabler to point to the required environment. The user's device automatically gets configured to use the appropriate environment as per the following rules: |
Sandbox server address |
Yes |
The notifications service needs to connect to the address The Nokia Developer Console sending tool can also be used to send notifications to the Notification Enabler and the connected MIDlet when the Environment Selector application on the device is used to set the Notification Enabler to point to the sandbox environment. The notifications service and the Notification Enabler should use the same environment for notifications to work. The developer should ensure the Environment Selector application on the device is used to set the Notification Enabler to point to the correct environment. |
Production server address |
Yes |
The notifications service needs to connect to the address The notifications service and the Notification Enabler should use the same environment for notifications to work. The developer should ensure the Environment Selector application on the device is used to set the Notification Enabler to point to the correct environment. |
Chinese production server address |
Yes |
The notifications service needs to connect to the address The notifications service and the Notification Enabler should use the same environment for notifications to work. The developer should ensure the Environment Selector application on the device is used to set the Notification Enabler to point to the correct environment. |
Service ID |
No |
The Service ID for the notifications service is same for all the environments. |
Service Secret |
Yes |
The Service Secret for the notifications service is different for all the environments. |