Описание Справочника bulk-формата

Создание файл bulk-формата производится по правилам, приведенными в Справочнике bulk-формата. 

Рисунок 1 – справочник bulk-формата

В справочнике цветом выделены:

•  – поле, обязательное для заполнения;
•  – поле, не обязательное для заполнения;
•  – повторяющийся блок/конец блока. В зависимости от цвета строк, которые он содержит, может быть обязательным и необязательным для заполнения;
•  – начало/конец повтора, повторов может быть несколько;
•  – начало/конец выбора, выборов может быть несколько;
•  – начало/конец ветки, в блоке Выбор необходимо выбрать для заполнения только одну ветку.

Справочник (см. рис. 1) включает страницу с описанием общих полей для всех сделок , и страницы по конкретным продуктам. Таблица содержит:

• номер поля – номер указан только для строк, имеющих значения;

• поле – название поля (элемента для заполнения);
• описание – пояснение к значению;
• min – минимальное количество повторений элемента. При значении 0 – поле необязательное для заполнения, при значении 1 – обязательное;

• max – количество повторений элементов. В случае, если требуется большее количество повторений, чем указано в справочнике, обратитесь в службу технической поддержки IT Global (см. Контакты);
  
• тип значения – тип данных, которые содержит поле: дата, строка, код и т.д.;
• Справ. ISDA – ссылка на справочник для заполнения данных;
• Справ. NSD – ссылка на справочник для заполнения данных;

• Атрибут внеш. спр. – дополнительный параметр для конвертации, приводится для информации;

• xpath– дополнительный параметр для конвертации, приводится для информации. 

Требования к файлу bulk-формата

Файл bulk-формата представляет собой таблицу, каждая строка которой – это отдельное сообщение, столбец – номер поля в Справочнике формата (рис. 2). 

Рисунок 2 – файл формата CSV-bulk

 Для корректной загрузки файла и конвертации сообщений в FpML предъявляются следующие требования к формированию файла:

1.  требования к имени CSV-файла: 
   1. Маска названия файла: [Тип продукта]_v[Версия формата]_[Комментарий пользователя].csv
      Пример: fxDigitalOption_v1_CsvBulkTest.csv;
2. требования к содержанию CSV-файла:
   1. используется разделитель точка с запятой ;
   2. файл может начинаться со строки "sep=;" — это необходимо для корректного отображения таблицы в MS Excel, независимо от настроек локализации MS Office.

3. один файл должен содержать сделки только одного типа;

4. рекомендуемое кол-во сделок (строчек в файле) не больше 250;

5. порядок и номер столбца в файле должны соответствовать номеру поля, указанного в Справочнике формата CSV-bulk (см. рис. 1). 

   Например, если поле <specificCode> указано под номером 33, а поле <code> под номером 34, то в таблице они должны идти под тем же номером, в том же порядке. Если одна сделка не содержит информацию по данному полю, а другая содержит, то столбец вносится, но остается незаполненным. Если ни одна сделка не содержит какое-либо поле, то соответствующую колонку можно не добавлять в файл;

6. над номерами столбцов для удобства можно добавить строку с собственными именами (пример показан на рис. 3). К именам не предъявляется никаких требований;

   
   

   Рисунок 3 – файл формата CSV-bulk, правила формирования
    

7. если в справочнике указано два источника данных Справ. ISDA и Справ. NSD, приоритет отдается Справ. NSD.

Импорт bulk-формата

Для загрузки файла bulk-формата нужно перейти в форму Черновики. Общая инструкция по импорту сообщений представлена в разделе Импорт. 

При импорте формат bulk автоматически конвертируется в формат FpML. Все сообщения отобразятся в экранной форме Черновики (рис. 4). 

Рисунок 4 – импортирование черновиков

Если одно из сообщений не удалось конвертировать, появится ошибка (рис. 5). Невалидное сообщение не будет загружено в Web-кабинет. 

Рисунок 5 – ошибка при конвертации

Конвертация

В Web-кабинете доступна конвертация:

1. из формата bulk в FpML;
2. из формата FpML в bulk.

Конвертер может быть использован для отладки процесса создания csv-файла. Во время конвертации производится автоматическая проверка полученного файла на корректность заполненных данных. Если обнаружены недочеты, в экранной форме отобразится информационное сообщение с подробным описанием ошибки. Данная возможность позволит быстрее найти причину и внести исправления.

Результатом конвертации из формата bulk в FpML является несколько файлов (рис. 6), которые можно скачать, распечатать или сохранить в разделе Черновики.

Рисунок 6 – результат конвертации из формата CSV-bulk в FpML

Результат обратной конвертации показан на рисунке 7. 

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

1

2

3

4

WEBe30038edb7f947c49a666199755377a4b4

VR0ITGLOBAL1

NDC000000000

2013-11-14T15:41:39