FORTS
Клиентская библиотека расчета обеспечения FORTS (FO2LS)
Описание API
Техническая спецификация на Программное Обеспечение
2007
Оглавление
1. Назначение библиотеки 3
2. Архитектура библиотеки 3
3. Описание API 3
3.1. Интерфейс IOleForts 3
3.2. Интерфейс IOleOrder 8
3.3. Интерфейс IOleOrderCol 9
3.4. Интерфейс IOleBaseContract 9
3.5. Интерфейс IOleBaseContractCol 9
3.6. Интерфейс IOleFutures 10
3.7. Интерфейс IOleFuturesCol 10
3.8. Интерфейс IOleVirtFutures 10
3.9. Интерфейс IOleVirtFuturesCol 11
3.10. Интерфейс IOleOption 11
3.11. Интерфейс IOleOptionCol 12
3.12. Интерфейс IOleExtraRisk 12
3.13. Интерфейс IOleEdgeGO 12
3.14. Интерфейс IOleTrade 12
3.15. Интерфейс IOlePoint 12
3.16. IOlePointCol 13
3.17. Интерфейс IOleRisk 13
3.18. IOleRiskCol 13
3.19. Интерфейс IOleClientGO 13
3.20. Интерфейс IOleClientGOCol 14
3.21. Интерфейс IOleGroupGO 14
3.22. Интерфейс IOleGroupGOCol 14
3.23. Интерфейс IOlePart 15
3.24. Интерфейс IOlePartCol 15
3.25. Интерфейс IOleClientAsset 15
3.26. Интерфейс IOleGroupAsset 15
3.27. Интерфейс IOleFirmAsset 15
3.28. Интерфейс IOlePosition 15
3.29. Интерфейс IOlePositionCol 16
4. Использование библиотеки 16
4.1. Инициализация необходимых объектов 16
4.2. Вставка участников, позиций, заявок 17
4.3. Расчет обеспечения, получение результатов 18
4.4. Структура XML-документа, возвращаемого функцией GetTradeInfo 19
История изменений
Дата | Автор | Краткое описание |
06.06.2007 | Первая версия документа | |
26.09.2007 | Отражены изменения в библиотеке версии 1.1.17. | |
25.01.2008 | Отражены изменения в библиотеке на текущий момент. Добавлено описание полной версии | |
1. Назначение библиотеки
Библиотека реализует функции загрузки с сервера РТС списка инструментов и их параметров и предоставляет API задания позиционного состояния клиентов и вычисления обеспечения по клиентам и фирме в целом.
2. Архитектура библиотеки
Библиотека реализована в виде набора COM – объектов. Все объекты предоставляют дуальные интерфейсы. Все интерфейсы поддерживают IErrorInfo. В случае неудачи выполнения какой-нибудь операции всегда можно получить описание ошибки, вызвав системную функцию GetErrorInfo. Потоковая модель библиотеки – Apartment threaded.
Существует три версии библиотеки:
1) неограниченная - Fo2LS_DLL;
2) полная - Fo2LSF_DLL;
3) клиентская - Fo2LSC_DLL.
Версии библиотеки отличаются набором реализованных функций.
В данном документе описывается клиентский и полный варианты библиотеки.
3. Описание API
Клиентская версия позволяет менять некоторые параметры инструментов, модифицировать списки клиентов, а также позиции и заявки. Позволяет просматривать ГО клиентов. Полная версия позволяет изменять более широкий круг параметров инструментов, просматривать ГО клиентов и фирм, риски по группам инструментов.
3.1. Интерфейс IOleForts
Главным объектом системы является интерфейс IOleForts. Через этот интерфейс происходит доступ ко всем другим объектам.
Доступ: | |||
Метод | Описание | Client | Full |
Init | Инициализация, на вход метода подается путь к ини-файлу, имя пользователя на сервере расчета обеспечения и пароль на доступ к серверу. |
|
|
DeInit | Завершение работы. |
|
|
BeginTrans | Начать транзакцию в базу данных |
|
|
Commit | Подтвердить транзакцию в базу данных |
|
|
Rollback | Откатить транзакцию |
|
|
CalcGO | Вычислить обеспечение по клиенту и инструменту. На вход подаются код клиента и код инструмента. Предназначена для вызова при онлайн-пересчетах обеспечения. На выходе – ГО клиента в срезе базового контракта инструмента. |
|
|
CalcBC | Вычислить обеспечение по всей совокупности клиентов и инструментов, привязанных к переданному на вход коду базового контракта. |
|
|
FastCalcBCAll | Вычислить обеспечение по всей совокупности клиентов и инструментов, по всем базовым котрактам. |
|
|
PreCalcBC | Предрассчитать параметры вычисления обеспечения по инструментам, привязанным к указанному коду базового контракта. |
|
|
PreCalcBCAll | Предрассчитать параметры вычисления обеспечения по всем инструментам. |
|
|
GetClientID | Возвращает идентификатор клиента по его коду в системе ФОРТС1 |
|
|
GetClientGO | Получить обеспечение клиента. На выходе будет сформирована строка, содержимое которой – сумма обеспечения клиента, код которого был указан в последнем вызове CalcGO |
|
|
GetFirmGO | Получить обеспечение фирмы. На выходе будет сформирована строка, содержимое которой – сумма обеспечения фирмы, код клиента которой был указан в последнем вызове CalcGO |
|
|
Clear | Очищает содержимое указанной таблицы |
|
|
InsertOrder | Добавить Заявку в базу данных. На вход подается объект IOleOrder. |
|
|
UpdateOrder | Модифицировать Заявку в базе данных. На вход подается объект IOleOrder. |
|
|
DeleteOrder | Удалить Заявку из базы данных. На вход подается объект IOleOrder. |
|
|
GetOrdersAll | Запросить список Заявок, находящихся в данный момент в базе данных. На выходе, будет объект IOleOrderCol. |
|
|
GetOrders | Запросить список Заявок по фильтру. На вход передаются код инструмента, код фирмы, код клиента, направление (покупка / продажа). На выходе, будет объект IOleOrderCol. |
|
|
InsertBaseContract |
|
| |
UpdateBaseContract |
|
| |
DeleteBaseContract |
|
| |
GetBaseContracts | Запросить список Базовых Инструментов, находящихся в данный момент в базе данных. На выходе, будет объект IOleBaseContractCol. |
|
|
InsertFutures |
|
| |
UpdateFutures | Модифицировать Фьючерс в базе данных. На вход подается объект IOleFutures. |
|
|
DeleteFutures |
|
| |
GetFutures | Запросить список Фьючерсов, находящихся в данный момент в базе данных. На выходе, будет объект IOleFuturesCol. |
|
|
InsertVirtFutures |
|
| |
UpdateVirtFutures | Модифицировать Виртуальный Фьючерс в базе данных. На вход подается объект IOleVirtFutures. |
|
|
DeleteVirtFutures | |||
GetVirtFutures | Запросить список Виртуальных Фьючерсов, находящихся в данный момент в базе данных. На выходе, будет объект IOleVirtFuturesCol. |
|
|
InsertOption |
|
| |
UpdateOption | Модифицировать Опцион в базе данных. На вход подается объект IOleOption. |
|
|
DeleteOption |
|
| |
GetOptions | Запросить список Опционов, находящихся в данный момент в базе данных. На выходе, будет объект IOleOptionCol. |
|
|
InsertPart | Добавить Участника (фирму, группу клиентов или клиента) в базу данных. На вход подается объект IOlePart. |
|
|
UpdatePart | Модифицировать Участника (фирму, группу клиентов или клиента) в базе данных. На вход подается объект IOlePart. |
|
|
DeletePart | Удалить Участника (фирму, группу клиентов или клиента) из базы данных. На вход подается объект IOlePart. |
|
|
GetPartsAll | Запросить список всех Участников, находящихся в данный момент в базе данных. На выходе, будет объект IOlePartCol. |
|
|
GetParts | Запросить список Участников по фильтру. На вход подается код фирмы. На выходе, будет объект IOlePartCol. |
|
|
InsertPosition | Добавить Позицию в базу данных. На вход подается объект IOlePosition. |
|
|
UpdatePosition | Модифицировать Позицию в базе данных. На вход подается объект IOlePosition. |
|
|
DeletePosition | Удалить Позицию из базы данных. На вход подается объект IOlePosition. |
|
|
GetPositionsAll | Запросить список всех Позиций, находящихся в данный момент в базе данных. На выходе, будет объект IOlePositionCol. |
|
|
GetPositions | Запросить список Позиций по фильтру. На вход подается код клиента, код фирмы, код инструмента. На выходе, будет объект IOlePositionCol. |
|
|
InsertExtraRisk |
|
| |
UpdateExtraRisk |
|
| |
DeleteExtraRisk |
|
| |
GetExtraRisks |
|
| |
InsertEdgeGO |
|
| |
UpdateEdgeGO |
|
| |
DeleteEdgeGO |
|
| |
GetEdgeGOs |
|
| |
InsertTrade |
|
| |
UpdateTrade |
|
| |
DeleteTrade |
|
| |
GetTrades |
|
| |
InsertPoint |
|
| |
UpdatePoint |
|
| |
DeletePoint |
|
| |
GetPoints | Получить расчетную точку по инструменту и клиенту. |
|
|
GetPointsAll | Получить все расчетные точки. |
|
|
InsertRisk |
|
| |
UpdateRisk |
|
| |
DeleteRisk |
|
| |
GetRisks | Получить риски |
|
|
GetRisksAll | Получить все риски. |
|
|
InsertClientGO |
|
| |
UpdateClientGO |
|
| |
DeleteClientGO |
|
| |
GetClientGOsAll | Запросить список обеспечения Клиентов в разрезе инструментов, находящихся в данный момент в базе данных. На выходе, будет объект IOleClientGOCol. |
|
|
GetClientGOs | Запросить список обеспечения Клиентов в разрезе инструментов по фильтру. На вход подаются код фирмы и код клиента. На выходе, будет объект IOleClientGOCol. |
|
|
InsertGroupGO |
|
| |
UpdateGroupGO |
|
| |
DeleteGroupGO |
|
| |
GetGroupGOsAll | Запросить список обеспечения групп клиентов и фирм в разрезе инструментов, находящихся в данный момент в базе данных. На выходе, будет объект IOleClientGOCol. |
|
|
GetGroupGOs | Запросить список обеспечения групп клиентов и фирм в разрезе инструментов по фильтру. На вход подаются код фирмы и код группы (если необходимо получить ГО фирмы – то в это параметре также надо передать код фирмы). На выходе, будет объект IOleGroupGOCol. |
|
|
InsertClientAsset |
|
| |
UpdateClientAsset |
|
| |
DeleteClientAsset |
|
| |
GetClientAssets |
|
| |
InsertGroupAsset |
|
| |
UpdateGroupAsset |
|
| |
DeleteGroupAsset |
|
| |
GetGroupAssets |
|
| |
InsertFirmAsset |
|
| |
UpdateFirmAsset |
|
| |
DeleteFirmAsset |
|
| |
GetFirmAssets |
|
| |
GetInstrumentParameters | Выполняет запрос списка инструментов на текущий момент времени на сервер расчета обеспечения |
|
|
GetConnectionStatus | Возвращает состояние соединение с сервером расчета обеспечения. 0 – соединение разорвано, <>0 – соединение установлено. |
|
|
GetInstrumentParametersEx | Выполняет запрос списка инструментов на указанный момент времени на сервер расчета обеспечения |
|
|
GetTradeInfo | Выполняет запрос информации о ходе торгов на сервер расчета обеспечения. Метод возвращает строку, содержащую XML- документ с параметрами торговой сессии. Структуру XML-документа см. в разделе 4.4 |
|
|
3.2. Интерфейс IOleOrder
IOleOrder интерфейс описывает Заявку, свойства и методы его исполнения.
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 |
