Function: object.Browse

Returns the structure of the next lower level in the hierarchy. This function may return real Objects (similar to object.Query) or virtual structural Objects that do not have to correspond to a declared Object type (URL/type) in the Module XML. In the latter case, a ‘Name’ Property can be set to provide a display name. The URLs of returned Objects may be passed to object.Query in subsequent calls. This function only needs to be implemented when an Extension has discoverable Nodes or a Node is browsable.

Syntax

{
	"method": "ext.deviceadapter.object.Browse",
	"params": {
		"url": "...",
		"params": "...",
	},
	"id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}
AdvFuture<std::vector<StaticExtObject>> ObjectBrowse( AdvString url, AdvObject params );
public Task<IList<StaticExtObject>> ObjectBrowseAsync(string url,
		IDictionary<string,
		object?> @params,
		CancellationToken ct = default);
objectBrowse(url: string, params: Map<string, Object>): Promise<StaticExtObject[]>;

Parameters

url : string

The parameter value is AopUrl.

The URL of the parent Object to browse. Can be the URL of the whole Extension (e.g., ’ext[CODE]:’) or of the Object whose immediate children are requested. In the latter case, the parent Object should also be part of the result. The first case is only called for the extension URL of discoverable adapters as part of Automatic Data Supply (requires adapter skill version 0.1.2).

params : value{}

The parameter key is SymbolPath.

User-defined parameters for the query. These are declared in the Module XML and shown in the data supply dialog.

Result : StaticExtObject[]