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'

Задайте глубину пространства имен, которое вы хотите, возвратился. Значение 'Depth' 1 возвращает только узлы, содержавшиеся в стартовой позиции. Значение 'Depth' 2 возвращает узлы, содержавшиеся в стартовой позиции и всех их узлах. Значение '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*'):

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

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

Смотрите также

|

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