Exponenta Banner
exponenta event banner

readHistory

Считывание исторических данных с узлов на сервере OPC UA

свернуть все на странице

Синтаксис

UaData = readHistory (UaClient, список узлов, StartTime, EndTime)
UaData = readHistory (UaClient, список узлов, StartTime, EndTime, ReturnBounds)
UaData = readHistory (Список узлов, StartTime, EndTime)
UaData = readHistory (Список узлов, StartTime, EndTime, ReturnBounds)

Описание

UaData = readHistory(UaClient,NodeList,StartTime,EndTime) считывает сохраненные исторические данные из узлов, идентифицированных NodeList, на сервере, связанном с подключенным клиентом UaClient, с исходной меткой времени междуStartTime (включительно) и EndTime (эксклюзивно).NodeList является одним объектом узла OPC UA или массивом узлов. StartTime и EndTime могут быть значениями даты и времени MATLAB или номерами дат.

пример

UaData = readHistory(UaClient,NodeList,StartTime,EndTime,ReturnBounds) позволяет указать, что возвращаемые данные должны содержать ограничивающие значения. Ограничивающие значения - это значения, непосредственно выходящие за пределы запрошенного временного диапазона (первое значение непосредственно перед StartTimeили первое значение после EndTime), когда значение не существует точно на указанном пределе временного диапазона. Настройка ReturnBounds кому true возвращает ограничивающие значения; настройка ReturnBounds кому false (значение по умолчанию) возвращает значения строго в пределах указанного времени начала и окончания.

UaData = readHistory(NodeList,StartTime,EndTime) и UaData = readHistory(NodeList,StartTime,EndTime,ReturnBounds) считывать из узлов, идентифицированных NodeList. Все узлы должны быть одного и того же подключенного клиента.

Примеры

свернуть все

В этом примере показано, как получить историю текущего дня с локального сервера.

uaClnt = opcua('localhost',62550);
connect(uaClnt);
nodeId = '1:Quickstarts.HistoricalAccessServer.Data.Dynamic.Double.txt';
nodeList = opcuanode(2,nodeId,uaClnt);
dataObj = readHistory(uaClnt,nodeList,datetime('today'),datetime('now'));

Входные аргументы

свернуть все

Клиент OPC UA указан как объект клиента OPC UA. Клиент должен быть подключен.

Список узлов, указанный как массив узловых объектов или один узел. Объекты узла можно создавать с помощью getNamespace, browseNamespace, или opcuanode. Для получения информации о функциях и свойствах объекта узла введите:

help opc.ua.Node

Можно читать только из узлов переменного типа, а не из узлов объектного типа. Если указать считываемый узел объекта, возвращаемое значение будет пустым массивом, а для качества будет установлено значение Bad:AttributeIdInvalid.

Исходный интервал времени, указанный как значения даты и времени MATLAB или номера дат. Время источника падает между StartTime (включительно) и EndTime (эксклюзивно).

Запрос ограничивающих значений, указанных как true или false.

Выходные аргументы

свернуть все

Исторические данные, возвращаемые как вектор объектов OPC UA Data. Если readHistory не удалось получить историю для данного узла, этот узел не возвращается в объект OPC UA Data и выдается предупреждение. При сбое всех запрошенных узлов генерируется ошибка.

См. также

Функции

Представлен в R2015b

Документация по панели инструментов OPC

Поддержка