Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

(Difference between revisions)

Error Messaging

From Wiki
Jump to: navigation, search
marcelobarrosalmeida (Talk | contribs)
m (fixing link to error message design pattern)
hamishwillee (Talk | contribs)
m (Hamishwillee - Bot update - Fix metadata etc)
Line 1: Line 1:
{{ArticleMetaData <!-- v1.2 -->
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example]] -->
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
|translated-by= <!-- [[User:XXXX]] -->
|translated-from-title= <!-- Title only -->
|translated-from-id= <!-- Id of translated revision -->
|review-by= <!-- After re-review: [[User:username]] -->
|review-timestamp= <!-- After re-review: YYYYMMDD -->
|update-by= <!-- After significant update: [[User:username]]-->
|update-timestamp= <!-- After significant update: YYYYMMDD -->
|creationdate= 20091031
|author= [[User:Aadhar14b]]
'''Original article published at [  Little Spring Design]  under [ Attibuttion 3.0]'''
'''Original article published at [  Little Spring Design]  under [ Attibuttion 3.0]'''

Revision as of 05:21, 7 May 2012

Article Metadata
Created: User:Aadhar14b (31 Oct 2009)
Last edited: hamishwillee (07 May 2012)

Original article published at Little Spring Design under Attibuttion 3.0



Error messages should give the user the information needed to solve the problem. In many situations, this means the underlying code needs to better differentiate error conditions.

Design Guidelines

  • Put error codes at the end of the message. This allows any support personnel to get the relevant information without costing the user is time to read it ... or risk having the code push some of the words off the bottom of the screen/window.
  • Keep the message short.
  • Give clues regarding what the user can do to resolve the situation.
  • Be specific.
  • Log the critical errors
  • Consider using a dialog box rather than a full screen, if your platform and device supports it.
    Example of Error Message

  • If possible, categorize errors into based on whether the user can fix the problem, the user needs to retry later, or an unfix-able error has occurred. Of course, many unfix-able errors should be fixed by the developer.

Commands (softkeys, links, or buttons)

Frequently, the best commands are "Retry" and "Cancel." Provide the user the ability to do some set of:

  • Try the action again (Retry)... used to perform the same action again immediately or restart the process
  • Fix the user entry (Edit)
  • Abandon the task (Cancel)... returning the user to a logical starting point
  • Save the data (Save)... allowing the user to abandon the task without losing context

--Submitted by - Aadhar14b

Related articles

28 page views in the last 30 days.