PI09863: IF REMOVING THE OPTIONAL FIELD "BADGE", AN ERROR IS RECEIVED: "MANDATORY FIELD 'BADGE' NOT FOUND."

Download for IBM Worklight V6.1.0 Fix Pack 1
Download the cumulative interim fix for IBM Worklight V6.0.0 Fix Pack 2 and IBM Mobile Foundation v6.0.0 Fix Pack 2
IBM Worklight Interim Fix README for 6.0.0.2

APAR status

• Closed as program error.

Error description

• The Information Center (5.0.6, 6.0.0, 6.1.0) topic for
  WL.Server.createDefaultNotification says this about the
  Badge parameter:
  "Optional. An integer value that is displayed in a badge
  on the application icon. On Windows Phone 8 the value is
  displayed as the application tile count."
  
  However, if you exclude this parameter an error is received:
  'Mandatory field 'badge' not found."
  
  So either the documentation is wrong or the implementation
  is wrong. I think it is the implementation that is
  at fault because also Apple themselves say it is optional.
  
  Search for "table 3-1" in the following link:
  https://developer.apple.com/library/ios/documentation/Networking
  Internet/Conceptual/RemoteNotificationsPG/Chapters/ApplePushServ
  ice.html
  
  The number to display as the badge of the application icon.
  If this property is absent, the badge is not changed.
  To remove the badge, set the value of this property to 0.
  
  The customer should be able to send a push notification
  without a badge.
  

Local fix

• 1.Remember the current value of the badge
     2.Use badge:0 when sending the push notification
     3.Use WL.Badge to re-apply the previous badge value from 1
  
  Note that Worklight does not provide any mechanism for updating
  Badges other than setting or removing (with the exclusion of
  the TabBar which allows updating as well). So if you send lots
  of updates you will need to write such a mechanism on your own
  in order to control the sorting, updating, etc.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All Worklight developers of v610,v600 will not be able to    *
  * send notifications without mentioning the badge value which  *
  * should be optional. Only iOS environment is affected.        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Not be able to send notifications without mentioning the     *
  * badge value which should be optional.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * use the badge value for every notification                   *
  ****************************************************************
  

Problem conclusion

• The badge value is now an optional value while sending
  notifications.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  WORKLIGHT CONSU

• Fixed component ID

  5725I4301

Applicable component levels

• R610 PSY

     UP