exponenta event banner

serveritems

Запрос сервера или пространства имен для полных идентификаторов элементов

Синтаксис

FQID = serveritems(DAObj,ItemID)
FQID = serveritems(DAObj)
FQID = serveritems(DAObj, 'Filter1',Val1,'Filter2',Val2, ...)
FQID = serveritems(NS)
FQID = serveritems(NS,ItemID)

Описание

FQID = serveritems(DAObj,ItemID) возвращает массив ячеек всех полностью определенных идентификаторов элементов, соответствующих ItemID которые находятся на сервере OPC, определенном DAObj. DAObj должен быть подключенным opcda объект. ItemID является частичным символьным вектором или строкой для поиска и может содержать подстановочный символ '*'. FQID является символьным вектором или массивом ячеек символьных векторов. Вы можете использовать FQID в вызове для additem построить daitem объекты.

FQID = serveritems(DAObj) возвращает все полные идентификаторы элементов на сервере OPC, связанном с DAObj.

FQID = serveritems(DAObj, 'Filter1',Val1,'Filter2',Val2, ...) позволяет фильтровать полученное пространство имен на основе нескольких доступных фильтров обзора. Доступные фильтры описаны в следующей таблице:

Просмотр фильтра

Описание

'StartItemID'

Укажите FullyQualifiedID узла ветви в виде символьного вектора или строки. Будут возвращены только узлы, содержащиеся в этом узле ветви. Некоторые OPC-серверы не поддерживают частичное извлечение пространства имен на основе этого параметра: При попытке использовать 'StartItemID' просмотр фильтра на таком сервере.

'Depth'

Укажите глубину возвращаемого пространства имен. A 'Depth' значение 1 возвращает только узлы, содержащиеся в начальной позиции. A 'Depth' значение 2 возвращает узлы, содержащиеся в начальной позиции, и все их узлы. A 'Depth' значение Inf возвращает все узлы.

'AccessRights'

Ограничивает поиск конечными узлами с определенными характеристиками прав доступа. Определить 'read' для возврата узлов, которые включают право доступа на чтение, и 'write' для возврата узлов, которые включают право доступа на запись. Пустой символьный вектор ('') возвращает узлы с любыми правами доступа.

'DataType'

Ограничивает поиск узлами с определенным каноническим типом данных. Допустимые типы данных: 'double', 'single', 'int8', 'int16', 'int32', 'uint8', 'uint16', 'uint32', 'logical', 'currency', и 'date'. Используйте 'DataType' фильтр для поиска элементов сервера с определенным типом данных, например, 'double' или 'date'.

FQID = serveritems(NS) и FQID = serveritems(NS,ItemID) поиск в структуре пространства имен, определенной NSвместо запроса сервера OPC. NS является результатом вызова getnamespace в иерархическом или плоском формате.

Обратите внимание, что некоторые серверы могут возвращать идентификаторы элементов, которые не могут быть созданы на этом сервере. Эти идентификаторы элементов обычно являются ветвями пространства имен сервера OPC.

Вы используете результаты вызова serveritems в вызове для serveritemprops для возврата сведений о свойствах элементов в пространстве имен сервера OPC. Свойства элементов в пространстве имен сервера включают канонический тип данных элемента сервера, ограничения, описание, текущее значение и т.д.

Примеры

Создайте клиент для сервера моделирования Matrikon™ и подключитесь к серверу:

da = opcda('localhost', 'Matrikon.OPC.Simulation');connect(da);

Найти все идентификаторы элементов на сервере Matrikon, содержащем слово 'Real':

realItmIDs = serveritems(da, '*Real*'):

Добавьте все элементы в узле Random в группу:

grp = addgroup(da, 'ServerItemsEx');
itm = additem(grp, serveritems(da, 'Random.*'));

См. также

|

Представлен до R2006a