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'единственныйint8int16int32uint8uint16uint32логический, '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