Change events - User Guide - Micetro - 25.2.0

Micetro Admin Guide
ft:locale
en-US
Product name
Micetro
Version
25.2.0

The system can be configured to run scripts when object properties are changed. The change event script is also run when an object is created, but not when an object is deleted.

Note: Scripts for the DNS record object type are handled a bit differently from other object tyeps. They are not run when the custom properties of a record are edited, but rather when the content of the zone changes (record added, modified, or deleted.) For more information, refer to Zone content change script interface.

Scripts associated with object types are often used to perform lookups in external data sources and return data from these sources. For examples of change event script interfaces, refer to Script interfaces.

Change events are displayed in the Change events section of the Event hooks data grid, which can be accessed from the Configuration tab of the Admin page.

Adding a change event

To add a change event:

  1. On the Admin page, select the Configuration tab.
  2. Select Event hooks in the left sidebar.
  3. In the Change events section, select + Add.
  4. In the dialog, select the Object type, e.g., zone, from the dropdown.
  5. Select the script in the Script name dropdown.

    It's assumed that the script is located in the scripts folder in Micetro Central’s data folder.

  6. If you want to pass a temporary ScriptRunner password to the script as a command line argument, check the Add ScriptRunner authentication paramaters checkbox. For more information, refer to Using the ScriptRunner.
  7. Select Add.

Editing and removing change events

Micetro enables you to manage change events as needed, e.g., if you need to modify or remove a change event.

Note: You cannot change the object type for a change event.

To edit a change event:

  1. Navigate to Admin > Configuration > Event hooks.
  2. In the Change events section, locate the change event you want to edit.
  3. Use the Row … menu to selectEdit.
  4. In the dialog, make the necessary changes to the event.
  5. Select Save

To remove a change event:

  1. Navigate to Admin > Configuration > Event hooks.
  2. In the Change events section, locate the change event.
  3. Use the Row … menu to select Remove.
  4. In the confirmation dialog, select Remove.