...

The bulk format file is generated by adding values of different order fields into a single table. Filling out is performed according to the rules provided in the Bulk format reference.

...

Figure 1 – bulk format reference

 Highlighted are:

•  – required field;
•  – optional field;
•  – repeating block/end of the repeating block. Depending on the color of strings that it contains it may be required and optional;
•  – start/end of repeat, there can be multiple repeats;
•  – start/end of choice, there can be multiple choices;
•  – start/end of the thread, it is necessary to choose only one thread for filling out in the Choice block.

...

• field number – the number is specified only for rows that have values;

• field – field name;

• description – value explanation;
• min – the minimum number of field repeats. If the value is 0 – the field is not required, if 1 - required;
• max – the maximum number of field repeats. If more repeats are necessary than specified in the reference, please contact IT Global technical support;
  
• value type – the type of data that the field contains: date, string, code, etc.;
• ISDA Ref. – source of data for filling out, an active link;
• NSD Ref. – source of data for filling out, an active link;

• Ext. ref. attribute – additional conversion parameter, provided in informational purposes;

• xpath – additional conversion parameter, provided in informational purposes. 

...

Requirements for creating a bulk format file

In the buil-format file each string is a separate order, and each column is the format field number (Fig. 2). 

Image Added

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:

1.  CSV file name requirements: 
   1. filename must be formed based on a mask: [Product type]_v[Format version]_[any string].csv (for example: fxDigitalOption_v1_CsvBulkTest.csv);
2. CSV file content requirements:
   1. the ";" delimiter is used;
   2. file can start with string "sep=;" it is necessary for the correct display of the table in MS Excel, regardless of the MS Office localization settings.

3. file may contain only one type of transactions;

4. the recommended number of fills (strings in the file) is not more than 250;

5. 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). ;

   Info
   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

   ;

   .

   
   

6. to conveniently fill out the table above the string with column numbers, the user can optionally add a string with column names (Fig. 23). There are no requirements to the names, the user indicates then at his sole discretion;

   
   Figure 2 3 – CSV bulk file format, rules of generation
    

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

This creates a download file, in which each string is a separate order, and each column is the format field number (Fig. 3). The number of strings (orders) in the download file is unlimited. The file may contain only one type of transactions. 

...

Bulk format examples v.

11 on November 15, 2016

Bulk format examples v.

Image Removed

...

Bulk download of orders

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

...

<messageId messageIdScheme="http://repository.nsd.ru/coding-scheme/messageid(nsdrus)">WEBe33338edb7f947c49a61997553d7a4b5</messageId>
<sentBy>VR0ITGLOBAL1</sentBy>
<sendTo>NDC000000000</sendTo>
<creationTimestamp>2013-11-14T15:41:39</creationTimestamp> 

1

2

3

4

WEBe33338edb7f947c49a61997553d7a4b45

VR0ITGLOBAL1

NDC000000000

2013-11-14T15:41:39