Exponenta Banner

readHistory

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

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

Синтаксис

UaData = readHistory(UaClient,NodeList,StartTime,EndTime)
UaData = readHistory(UaClient,NodeList,StartTime,EndTime,ReturnBounds)
UaData = readHistory(NodeList,StartTime,EndTime)
UaData = readHistory(NodeList,StartTime,EndTime,ReturnBounds)

Описание

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

пример

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 datetime или номера дат. Исходное время падает между StartTime (включительно) и EndTime (эксклюзивно).

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

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

свернуть все

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

См. также

Функции

Введенный в R2015b

Документация OPC Toolbox

Поддержка