browseNameSpace

Graphically browse OPC HDA server name space

Syntax

ItmList = browseNameSpace(HdaObj)

ItmList = browseNameSpace(HdaObj,ItmListInit)

ItmList = browseNameSpace(HdaObj,ItmListInit,true)

Description

ItmList = browseNameSpace(HdaObj) opens a graphical name space browser for the OPC HDA client object HdaObj. Use the graphical interface to construct a list of items and return a list of those fully qualified item IDs in ItmList. Use ItmList to retrieve data for those items with function readRaw, readProcessed, readAtTime, or readModified.

The name space is retrieved from the server incrementally, as needed.

ItmList = browseNameSpace(HdaObj,ItmListInit) lets you specify an initial list of item IDs to be augmented.

ItmList = browseNameSpace(HdaObj,ItmListInit,true) loads the entire name space into the dialog.

Examples

Browse Local Matrikon Server for OPC HDA Items

Connect to the local Matrikon Simulation server and browse for items.

HdaObj = opchda('localhost','Matrikon.OPC.Simulation');
connect(HdaObj);
ItmList = browseNameSpace(HdaObj);

Input Arguments

HdaObj — OPC HDA client

OPC HDA client object

OPC HDA client, specified as an OPC HDA client object.

ItmListInit — Initial list of OPC HDA items

character vector, string, or cell array of character vectors

Initial list of OPC HDA items, specified as a character vector, string, or cell array that identifies the item IDs. When the browser opens, these items are already included in the selected list.

Data Types: char | string | cell

true — Indicator to load entire name space

true

Indicator to load the entire name space, specified as true. Use this option only if your server does not support partial name space browsing.

Data Types: logical

Output Arguments

ItmList — List of OPC HDA item IDs

char vector or cell array of char vectors

List of OPC HDA item IDs, returned as a character vector or cell array of character vectors. Each character vector indicates a selected OPC HDA item ID.

Version History

Introduced in R2013a