Section 3 - Validation and Error messages
In this section we will cover validation rules for FX Tiles.
Validation
When setting up an FX tile, any data entered by users is checked for validation. Entering non-numerical amounts or using invalid date formats will trigger error messages that prompt the user to make amendments:
In both of the above error cases the FX Tile will remain in a disabled state until a valid amount or settlement date is entered. When the tile is disabled in such a way, it prevents the user from viewing rates or attempting to trade.
Field validation rules
This section lists validation rules for the following fields:
-
Trade amount
-
Settlement date
Trade amount
Data type: Currency
Range: >0.01 to GFA for the particular currency pair.
| GFA is the 'Good for Amount' limit which represents the maximum volume that can be traded on a particular currency pair (see Section 1 for more details). This limit will appear within the Trade amount field e.g. 1M, 50M etc. |
Amounts must be stated using numerical characters or a notational shortcut that is supported by the FX Tile e.g. 1K (this means 1000), 5M (this means 5,000,000).
If the amount is invalid, an error message is displayed "Please supply a valid amount"
If input exceeds the GFA for the currency, then the user can longer view streaming rates or trade.
| Format | Example |
|---|---|
## |
10 |
#.# |
8.5 |
#[KMkm] |
1K |
#.#[KMkm] |
10.5M |
Settlement date
Data type: Date
Range: N/A
The field accepts user input and also provides visual controls for selecting dates using a date picker utility. Shortcut notations for picking Tenor dates are also supported e.g. 1W (one week from Spot), 2M (two months from Spot).
If the date is invalid, an error message will be displayed indicating the correct format to be used when inputting a date: "Invalid date [user input]. Date must be in YYYY-MM-DD or YYYYMMDD format."
| Format | Example |
|---|---|
YYYY-MM-DD |
2015-06-15 |
YYYY/MM/DD |
2015/06/15 |
DD-MM-YYYY |
15-06-2015 |
DD/MM/YYYY |
15/06/2015 |
DDMMYYYY |
15062015 |
YYYYMMDD |
20150615 |
DDMMYY |
150615 |
DD/MM/YY |
15/06/15 |
#[WMYwmy] |
2M |
TOD|TOM|SPOT |
SPOT |
FX Tiles Documentation: