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™ Simulation Server и подключитесь к серверу:

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

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

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

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

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

См. также

|

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