bpipe

Описание

Функция bpipe создает объект bpipe. Объект bpipe представляет связь Bloomberg® B-PIPE®.

Другие функции соединяются с различными сервисами Bloomberg: Рабочий стол Bloomberg (blp), Сервер Bloomberg (blpsrv) и Лицензия Данных Bloomberg (bdl). Для получения дополнительной информации об этих сервисах, смотрите Сравнение Связей Bloomberg.

Для получения дополнительной информации о требованиях связи Bloomberg, смотрите Требования Связи Сервера данных. Чтобы гарантировать успешную связь Bloomberg, выполните необходимые шаги прежде, чем выполнить bpipe. Для получения дополнительной информации смотрите Установку Bloomberg и Конфигурирование Связей.

Создание

Синтаксис

c = bpipe(authtype,appname,ipaddress,port)
c = bpipe(authtype,appname,ipaddress,port,timeout)
c = bpipe(authtype,appname,ipaddress,port,timeout,tlscred,tlspassword,tlstrust)

Описание

пример

c = bpipe(authtype,appname,ipaddress,port) создает объект c связи B-PIPE Bloomberg и устанавливает эти свойства:

пример

c = bpipe(authtype,appname,ipaddress,port,timeout) также устанавливает Свойство Timeout.

пример

c = bpipe(authtype,appname,ipaddress,port,timeout,tlscred,tlspassword,tlstrust) подключения к облачному решению нулевого места B-PIPE с помощью заданного файла учетных данных, пароля и доверительного файла.

Внимание:

Чтобы относиться к связи Bloomberg в других функциях, используйте объект связи, созданный функцией bpipe. В противном случае с помощью bpipe, когда входной параметр открывает несколько связей Bloomberg, вызывая неожиданное поведение и исчерпывая ресурсы памяти.

Входные параметры

развернуть все

Файл учетных данных, заданный как вектор символов или скаляр строки, который содержит полный путь к файлу учетных данных с дополнительным pk12. Для получения дополнительной информации о файле учетных данных, свяжитесь с Bloomberg.

Типы данных: char | string

Пароль B-PIPE, заданный как вектор символов или скаляр строки. Чтобы получить ваш пароль B-PIPE, свяжитесь с Bloomberg.

Типы данных: char | string

Доверительный файл, заданный как вектор символов или скаляр строки, который содержит полный путь к доверительному файлу с дополнительным pk7. Для получения дополнительной информации о доверительном файле, свяжитесь с Bloomberg.

Типы данных: char | string

Свойства

развернуть все

Это свойство доступно только для чтения.

Тип аутентификации приложения, заданный как одно из этих значений:

  • "" — Bloomberg связь B-PIPE с аутентификацией Windows®

  • "APPNAME_AND_KEY" — Bloomberg связь B-PIPE с аутентификацией приложения

Тип аутентификации пользователя Bloomberg, заданный как одно из этих значений:

  • "OS_LOGON" — Bloomberg связь B-PIPE с аутентификацией Windows

  • "APPLICATION_ONLY" — Bloomberg связь B-PIPE с аутентификацией приложения

Для получения дополнительной информации см. Руководство разработчика API B-PIPE Bloomberg с помощью опции WAPI <GO> от терминала Bloomberg.

Имя приложения, заданное как вектор символов или строка, которая идентифицирует приложение, которое вы используете, чтобы соединить с Bloomberg B-PIPE.

Пример: 'appname'

Типы данных: char | string

Это свойство доступно только для чтения.

Пользователь Bloomberg, заданный как пользовательский единичный объект Bloomberg.

Пример: [1x1 com.bloomberglp.blpapi.impl.aT]

Это свойство доступно только для чтения.

Сеанс Bloomberg V3, заданный как объект Bloomberg V3 API Session.

Пример: [1x1 com.bloomberglp.blpapi.Session]

IP-адрес машины, запускающей процесс B-PIPE Bloomberg, заданный как вектор символов, массив ячеек из символьных векторов, строка или массив строк. Вектор символов или строка идентифицируют машину, запускающую процесс B-PIPE Bloomberg, тогда как массив ячеек из символьных векторов или массив строк задают несколько машин.

Пример: {'111.11.11.112'}

Типы данных: char | cell | string

Номер порта машины, запускающей процесс B-PIPE Bloomberg, заданный в виде числа.

Пример: 8194

Типы данных: double

Тайм-аут, задающий время в миллисекундах, которые MATLAB® пытается соединить с машиной, запускающей процесс B-PIPE Bloomberg перед таймаутом, заданным в виде числа.

Пример: 1000

Типы данных: double

Тип данных даты и времени, заданный как одно из этих значений.

ЗначениеОписание
'' (значение по умолчанию)Дата возвращения и временные стоимости как числа даты MATLAB.
'datetime'Дата возвращения и временные стоимости как массив datetime.

Можно задать эти значения с помощью вектора символов или строки (например, "datetime").

Когда вы создаете объект bpipe, функция bpipe оставляет этот сброс свойства. Чтобы получить данные, необходимо установить это значение свойства вручную в командной строке или в скрипте с помощью записи через точку, например:

c.DatetimeType = 'datetime';
Затем можно использовать эти поддерживаемые функции:

  • getbulkdata

  • getdata

  • history

  • tahistory

  • timeseries

    Примечание

    Если значением свойства DataReturnFormat является 'table', и значением свойства DatetimeType является 'datetime', то возвращенные данные являются таблицей, которая содержит значения даты и времени как массив datetime. Если значение свойства DataReturnFormat является пустым символьным вектором, то установка свойства DatetimeType к 'datetime' возвращает значения даты и времени для агрегированных меток деления и исторических запросов как числа даты MATLAB.

Данные возвращают формат, заданный как одно из этих значений, которые определяют тип данных возвращенных данных.

ЗначениеТип данных возвращенных данных
'cell'cell array
'table'table
'timetable'timetable
'structure'structure

Примечание

Тип данных по умолчанию возвращенных данных зависит от выполняемой функции. Чтобы задать тип данных по умолчанию, установите свойство DataReturnFormat на ''. Для типов данных по умолчанию см. поддерживаемый функциональный список.

Можно задать эти значения с помощью вектора символов или строки (например, "table").

Когда вы создаете объект bpipe, функция bpipe оставляет этот сброс свойства. Чтобы получить данные, необходимо установить это значение свойства вручную в командной строке или в скрипте с помощью записи через точку, например:

c.DataReturnFormat = 'structure';
Затем можно использовать эти поддерживаемые функции.

Поддерживаемая функцияДопустимые типы данных для возвращенных данных
category
  • cell array (значение по умолчанию)

  • structure

  • table

eqs
  • cell array (значение по умолчанию)

  • structure

  • table

fieldinfo
  • cell array (значение по умолчанию)

  • structure

  • table

fieldsearch
  • cell array (значение по умолчанию)

  • structure

  • table

lookup
  • structure (значение по умолчанию)

  • table

portfolio
  • structure (значение по умолчанию)

  • table

getbulkdata
  • structure (значение по умолчанию)

  • table

  • timetable

getdata
  • structure (значение по умолчанию)

  • table

  • timetable

history
  • числовой массив (значение по умолчанию)

  • table

  • timetable

tahistory
  • structure (значение по умолчанию)

  • table

  • timetable

timeseries
  • cell array (значение по умолчанию для необработанных тиковых данных)

  • числовой массив (значение по умолчанию для тиковых данных интервала)

  • table

  • timetable

Примечание

Независимо от значения свойства DatetimeType, если значением свойства DataReturnFormat является 'timetable', то getdata и функции getbulkdata возвращают таблицу, которая содержит значения даты и времени как массивы datetime.

Функции объекта

развернуть все

closeЗакройте связь Bloomberg V3
getСвойства связи Bloomberg V3
isconnectionОпределите связь Bloomberg V3
eqsДанные об экранировании акции для связи Bloomberg V3
getbulkdataОбъемные данные с информацией о заголовке для связи Bloomberg V3
getdataТекущие данные для связи Bloomberg V3
historyИсторические данные для связи Bloomberg V3
portfolioТекущие данные о портфеле для связи Bloomberg V3
realtimeДанные реального времени для связи Bloomberg V3
stopОтпишите запросы в реальном времени о связи Bloomberg V3
tahistoryИсторический технический анализ для связи Bloomberg V3
timeseriesСуточные тиковые данные для связи Bloomberg V3
categoryПолевая категория ищет связь Bloomberg V3
fieldinfoИнформация о поле для связи Bloomberg V3
fieldsearchПолевой поиск связи Bloomberg V3
lookupНайдите информацию о ценных бумагах для связи Bloomberg V3

Примеры

свернуть все

Создайте связь B-PIPE Bloomberg с помощью IP-адреса машины, запускающей процесс B-PIPE Bloomberg. Этот пример принимает следующее:

  • Аутентификация является аутентификацией Windows, когда вы устанавливаете authtype на 'OS_LOGON'.

  • Имя приложения является пробелом, потому что вы не соединяете с Bloomberg B-PIPE с помощью приложения.

  • IP-адресом для машины, запускающей процесс B-PIPE Bloomberg, является '111.11.11.112'.

  • Номером порта машины, запускающей процесс B-PIPE Bloomberg, является 8194.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bpipe(authtype,appname,ipaddress,port)
c = 

  bpipe with properties:

         AppAuthType: ''
            AuthType: 'OS_LOGON'
             AppName: []
                User: [1x1 com.bloomberglp.blpapi.impl.aT]
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: {'111.11.11.112'}
                Port: 8194.00
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

bpipe соединяет с выполнением машины Bloomberg B-PIPE в номере порта 8194. bpipe создает объект c связи B-PIPE Bloomberg с этими свойствами:

  • Тип аутентификации приложения

  • Тип аутентификации пользователя Bloomberg

  • Имя приложения

  • Пользовательский единичный объект Bloomberg

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, запускающей процесс B-PIPE Bloomberg

  • Номер порта машины, запускающей процесс B-PIPE Bloomberg

  • Номер (в миллисекундах) задающий, сколько времени MATLAB пытается соединиться с машиной перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft®.

format bank  % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = 
    LAST_PRICE: 33.34
          OPEN: 33.60

sec = 
    'MSFT US Equity'

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь B-PIPE Bloomberg.

close(c)

Создайте связь B-PIPE Bloomberg с помощью IP-адреса машины, запускающей процесс B-PIPE Bloomberg. Этот пример принимает следующее:

  • Аутентификация является аутентификацией Windows, когда вы устанавливаете authtype на 'OS_LOGON'.

  • Имя приложения является пробелом, потому что вы не соединяете с Bloomberg B-PIPE с помощью приложения.

  • IP-адресом для машины, запускающей процесс B-PIPE Bloomberg, является '111.11.11.112'.

  • Номером порта машины, запускающей процесс B-PIPE Bloomberg, является 8194.

  • Значение тайм-аута является 1 000 миллисекунд.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;
timeout = 1000;

c = bpipe(authtype,appname,ipaddress,port,timeout)
c = 

  bpipe with properties:

         AppAuthType: ''
            AuthType: 'OS_LOGON'
             AppName: []
                User: [1x1 com.bloomberglp.blpapi.impl.aT]
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: {'172.28.17.118'}
                Port: 8194.00
             TimeOut: 1000.00
        DatetimeType: ''
    DataReturnFormat: ''

bpipe соединяет с выполнением машины Bloomberg B-PIPE в номере порта 8194. bpipe создает объект c связи B-PIPE Bloomberg с этими свойствами:

  • Тип аутентификации приложения

  • Тип аутентификации пользователя Bloomberg

  • Имя приложения

  • Пользовательский единичный объект Bloomberg

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, запускающей процесс B-PIPE Bloomberg

  • Номер порта машины, запускающей процесс B-PIPE Bloomberg

  • Номер (в миллисекундах) задающий, сколько времени MATLAB пытается соединиться с машиной перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft.

format bank  % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = 
    LAST_PRICE: 33.34
          OPEN: 33.60

sec = 
    'MSFT US Equity'

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь B-PIPE Bloomberg.

close(c)

Создайте связь нулевого места B-PIPE Bloomberg с помощью IP-адреса машины, запускающей процесс B-PIPE Bloomberg. Этот пример принимает следующее:

  • Аутентификация основана на имени приложения, когда вы устанавливаете authtype на 'APPLICATION_ONLY'.

  • Именем приложения является 'APP'.

  • IP-адресом для машины, запускающей процесс B-PIPE Bloomberg, является '111.11.11.112'.

  • Номером порта машины, запускающей процесс B-PIPE Bloomberg, является 8194.

  • Номер (в миллисекундах) задающий, сколько времени MATLAB пытается соединиться с машиной перед таймаутом, 1000.

  • Полным путем файла учетных данных является C:\ABCDEFG.pk12.

  • Паролем B-PIPE является 12345.

  • Полным путем доверительного файла является C:\HIJKLM.pk7.

authtype = 'APPLICATION_ONLY';
appname = 'APP';
ipaddress = {'111.11.11.112'};
port = 8194;
timeout = 1000;
tlscred = 'C:\ABCDEFG.pk12';
tlspassword = '12345';
tlstrust = 'C:\HIJKLM.pk7';

c = bpipe(authtype,appname,ipaddress,port,timeout,tlscred,tlspassword,tlstrust)
c = 

  bpipe with properties:

         AppAuthType: 'APPNAME_AND_KEY'
            AuthType: 'APPLICATION_ONLY'
             AppName: 'APP'
                User: [1x1 com.bloomberglp.blpapi.impl.by]
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: {'111.11.11.112'}
                Port: 8194.00
             TimeOut: 1000.00
        DatetimeType: ''
    DataReturnFormat: ''

bpipe соединяет с выполнением машины Bloomberg B-PIPE в номере порта 8194. Функция bpipe создает объект c связи B-PIPE Bloomberg с этими свойствами:

  • Тип аутентификации приложения

  • Тип аутентификации пользователя Bloomberg

  • Имя приложения

  • Пользовательский единичный объект Bloomberg

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, запускающей процесс B-PIPE Bloomberg

  • Номер порта машины, запускающей процесс B-PIPE Bloomberg

  • Номер (в миллисекундах) задающий, сколько времени MATLAB пытается соединиться с машиной перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft.

format bank  % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = 
    LAST_PRICE: 33.34
          OPEN: 33.60

sec = 
    'MSFT US Equity'

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь B-PIPE Bloomberg.

close(c)

Введенный в R2014b