Data patterns
Address inputs
Address inputs vary widely from country to country. Pega UX recommends the following pattern for the most inclusive workflow.
- If available and the user is online, use the Location Autocomplete component to capture user data.
- Otherwise, if a user's needs are exclusive to a single specific country, find and follow the country standards found on Wikipedia.
- However, a user's needs may span across multiple countries, in which case use the generic template below (source: Wikipedia)
- Country: Fields, labels, and languages may need to change based on this answer, so it must be first.
- Street
- City area / District
- City / Town / Village
- County
- Postal code
Finally, all address values should use the standard naming found in the semantic autocomplete attribute spec.
Last updated: Mar 2020
Numbers
At no time should a business user ever be confused about whether a figure is 100,000 or 1,000,000. Number separators (commas in the US, periods or spaces in most other parts of the world) are critical to the clear display of numbers.
Whenever numbers are displayed within a table cell or need to be tallied, they should be right-aligned and use the same decimal place consistently. (e.g. Row 1 may have 10.54, so row 2 must have 1.00 for the sake of comparison)
Last updated: Oct 2020
Date and time
Relative
Relative times give a general idea of a past or future event. This is the format most common in Pega applications. Examples of usage include conversations or object updates.
Show relative times in the user’s current time zone. The order of dates and months should be valid for that region. Use of 12 hour or 24 hour clock should also be valid for that region.
Time to display | Past | Future |
---|---|---|
Under a minute | Just now | Right now |
Under 1 hour | 11m ago | In 11m |
Today | 8:43am | 3:10pm |
This year | Jan 15 | Dec 23 |
Other years | Jan 15, 2017 | Dec 23, 2024 |
Exact
Exact timestamps are detailed and very technical. Reserve them for things such as audits and detailed histories. Exact times will always include a time, and almost always a date.
If the application will have an international audience, use the ISO-8601 standard (Y-M-D). If the application is for a specific region, use the region appropriate layout (M/D/Y for USA; D/M/Y for most others).If the application is for no particular region, use the American standard (shown) as a default.
Precision | Format |
---|---|
General usage | Dec 31, 2017 2:13pm |
Audits and logs | 2017-12-31 14:13:30 |
Exact timestamp | 2017-12-31T22:30+04 |
For internationalized guidance on month abbreviations, Princeton has a decent overview of the variations.
Last updated: Apr 2020