Device Adapter

Methods that should be provided by a device adapter module

Functions

Result	Name / Params			Comment
StaticExtObject[]	object.Query			Returns the Objects available in the third-party system. Should return all existing child Objects of the specified parent. The strategy of determining these depends on the third-party system (e.g., query via active connection to the system, importing a config file, etc). The function is called from the data supply dialog.
		url	string	(Value: AopUrl) The URL of the parent Object to query. Can be the URL of the whole Extension (e.g., 'ext[CODE]:') or of the Object whose children are requested. In the latter case, the parent Object should also be part of the result.
		params	value{}	(Key: SymbolPath) User-defined parameters for the query. These are declared in the Module XML and shown in the data supply dialog.
StaticExtObject[]	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.
		url	string	(Value: 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 Extensions with skill ≥adapter 0.1.2
		params	value{}	(Key: SymbolPath) User-defined parameters for the query. These are declared in the Module XML and shown in the data supply dialog.
ExtActivityResult	activity.Start			Starts a new Activity.
		url	string	(Value: AopUrl) URL of the new Activity.
		type	string	(Value: SymbolPath) Type of the Activity to start.
		members	ExtActivityMember[]	List of members which are part of the Activity.
		props	value{}	(Key: Symbol) Properties required to create the Activity.
ExtActivityResult	activity.End			Ends an Activity.
ExtActivityResult		url	string	(Value: AopUrl) URL of the Activity to end.
ExtIncidentResult	incident.Create			Requests creation of a new Incident.
		props	value{}	(Key: Symbol) Properties required to create the Incident. These are the Properties of the Incident Create Request declared in the Module XML.
		events	IncidentEventRef[]	Information about the Event(s) for which this Incident is being created.
OperationResult	operation.Execute			Executes the given Operation. The return value is either a result, an error, or a token to signal a long-running Operation.
OperationResult		operation	Operation	Operation to execute.
void	operation.Cancel			Cancels a long-running Operation.
void		token	int	Token from the OperationResult of the object.Execute call.
ResourceResult	resource.Get			Gets a resource from the Extension.
		url	string	(Value: AopUrl) The resource URL.
		props	value{}	(Key: Symbol) Additional Properties required to get the resource.
MonitorDef[]	monitor.Query			Returns a list of available monitor definitions and their corresponding data streams.
void	monitor.Start			Starts recording data for the indicated monitor.
void		url	string	(Value: AopUrl) The monitor URL.
void	monitor.Stop			Stops recording data for the indicated monitor.
void		url	string	(Value: AopUrl) The monitor URL.
bool	Exit			Requests a graceful shutdown of the Extension. Returns true if the Extension handled the request successfully.

Notifications

Name / Params			Comment
operation.Progress			Progress message for one or more long-running Operations.
	progress	OperationProgress[]	List of progress reports.
operation.Result			Result message for one or more long-running Operations.
	result	OperationResult[]	List of result reports.
monitor.Data			Transmits recorded monitor data of active monitors.
	data	MonitorData[]	List of monitor data reports.

Last modified September 25, 2026