Events

Caution

The Events API is only accessible from plugins and cannot be accessed from the developer console.

Qatium notifies plugins of events in the app through class methods that can be overridden as required. Depending on the data changing inside Qatium’s core, plugins can subscribe to specific events.

init()

Method signature

TypeScript

init(): void

Optional

Qatium calls a plugin’s init method only once. You can think about it as the entry point for your plugin.

• Use it to initialize things in your plugin. Examples of this include getting the bounds or the units of the network, exposing your plugin commands, or registering icons in the map.

Example

TypeScript

import { Bounds } from '@qatium/sdk';

class MyPlugin implements Plugin {
  private bounds: Bounds;
  init() {
    this.bounds = sdk.network.getBounds();
  }
}

run()

Method signature

TypeScript

run(): void

Optional

Qatium calls a plugin’s run method whenever the plugin needs to be re-rendered. It will be called multiple times, with a variable frequency. This means:

• Don’t use the run event for any timing code. It may be called multiple times per second, or not at all.
• Be mindful of resources and try not to perform heavy calculations continuously.
• Try to avoid side effects, as they might be called multiple times.

Use this method to perform any computations using the SDK.

Example

TypeScript

class MyPlugin implements Plugin {
  run() {
    sdk.network.getAsset('MyAssetId')
  }
}

onNetworkChanged()

Method signature

TypeScript

onNetworkChanged(): void

Optional

Notified every time the network changes (due to scenarios initiated by the user, new SCADA readings being received, the user changing the current network date, etc.).

Example

TypeScript

class MyPlugin implements Plugin {
  onNetworkChanged() {
    const x = sdk.network.getPipes()
  }
}

onZoomChanged()

Method signature

TypeScript

onZoomChanged(): void

Optional

Notified every time the zoom changes due to user interaction.

Example

TypeScript

class MyPlugin implements Plugin {
  onZoomChanged() {
    const x = sdk.map.getCamera()
  }
}

reset()

Method signature

TypeScript

reset(): void

Optional

Notified every time the scenario gets deleted, causing all previous user-made changes to be reset to the initial live model.

Example

TypeScript

class MyPlugin implements Plugin {
  reset() {
    // ...
  }
}

cleanUp()

Method signature

TypeScript

cleanUp(): void

Optional

Notified when the plugin is getting cleaned up. This happens when the user is exiting the network view or disabling the plugin.

You can use this method, for example, to abort in-progress operations.

Example

TypeScript

class MyPlugin implements Plugin {
  cleanUp() {
    // ...
  }
}

onMessage()

Method signature

TypeScript

onMessage(message: any): void

Optional

Notified every time the plugin receives a message from the plugin UI panel.

It receives the message sent from the UI.

Example

TypeScript

class MyPlugin implements Plugin {
  onMessage(message: MessageType) {
    // ...
  }
}

onElementSelected()

Method signature

TypeScript

onElementSelected(element?: ElementIdentifier): void;

Optional

Notified every time the user selects an asset in the map.

Example

TypeScript

class MyPlugin implements Plugin {
  onElementSelected(element?: ElementIdentifier) {
    sdk.ui.sendMessage<MessageToUI>({
      event: "selected-element-changed",
      id: element?.id
    });
  }
}