To optimize the process of uploading a large number of orders the Web-client uses bulk format. This format also allows:
The bulk format file is generated according to the rules provided in the Bulk format reference.
Figure 1 – bulk format reference
Reference (see Fig. 1) includes a page with information on general fields contained in transactions for all types of products, and pages with information about the specific product fields. Indicated on each page are:
field number – the number is specified only for rows that have values;
field – field name;
Ext. ref. attribute – additional conversion parameter, provided in informational purposes;
xpath – additional conversion parameter, provided in informational purposes.
In the buil-format file each string is a separate order, and each column is the format field number (Fig. 2).
Figure 2 – CSV bulk file format
To correctly upload orders to Web-client in bulk format and convert them into FpML, the file shoud be generated in accordance with the following requirements:
file may contain only one type of transactions;
the recommended number of fills (strings in the file) is not more than 250;
order and numbers of columns in the file bulk format must match the field number specified in the CSV bulk format reference (see Fig. 1);
For example, if the field <specificCode> is indicated under number 33, and the field <code> under number 34, in the table they should go under the same number and in the same order. If the transaction does not contain information on the field, the column is left blank. If neither transaction contains a field, the corresponding column is not added to the file at all.
to conveniently fill out the table above the string with column numbers, the user can optionally add a string with column names (Fig. 3). There are no requirements to the names, the user indicates then at his sole discretion;
Figure 3 – CSV bulk file format, rules of generation
if the CSV bulk format reference specifies two sources of data for filling ISDA Ref. and NSD Ref., the priority is given to NSD Ref.
It is not recommended to edit the CSV file via MS Excel, because of the automatic data conversion while saving the file, such as date convertion, number convertion and so on. This might result in error while importing the file into the Web-client.
The bulf format file can be downloaded from Drafts. Detailed instructions on how to upload orders to the Web-client are provided in the Import section. At importing a bulk format is automatically converted into FpML. All orders contained in the table format, will be displayed in the Drafts form (Fig. 4).
Figure 4 – importing drafts
If one of the orders could not be converted, an error will be displayed in the Import draft window next to the order. This order will not be loaded to the Web-client.
Figure 5 – conversion error
The Web-client offers the following methods of converting bulk format files:
The result of the first conversion method is multiple files (Fig. 6), which can be downloaded, printed or transferred to Drafts.
Figure 6 – result of converting from CSV bulk to the FpML format
The result of reverse conversion is shown in Figure 7. The resulting file can be downloaded.
Figure 7 – conversion result
At opening the user will be displayed an excel table containing all orders (Fig. 8).
Figure 8 – excel table containing all orders
This way the original order data:
were converted into tabular data: