Section 3 - Validation and Error messages

In this section we will cover validation rules for FX Tiles.

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.

Validation rules for FX Tiles

Field label

Description

Data Type

Range Format Example

Validation

Trade amount

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)
Currency >0.01 to GFA for the particular currency pair.

##
#.#
#[KMkm]
 
#.#[KMkm]
 

10
8.5
1K
2M
15.5k
10.5m

If the amount is invalid, a visual error prompt should appear. By default an FX Tile will display: 

“Please supply a valid amount”
 
If input exceeds the GFA for the currency, then the user can longer view streaming rates or trade.

Settlement date

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 (this means one week from Spot)

2M (this means two months from Spot)

Date N/A

YYYY-MM-DD
YYYY/MM/DD
DD-MM-YYYY
DD/MM/YYYY
DDMMYYYY
YYYYMMDD
DDMMYY
DD/MM/YY

#[WMYwmy]
 

 

String

2015-06-15
2015/06/15
15-06-2015
15/06/2015
15062015
20150615
150615
15/06/15

1D
1W
2M
2Y

TODAY
TOM (as in Tomorrow)

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.”

GFA* - this 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.


FX Tiles Documentation: