Listeners Basic Configurations

Owned by
Jonathan Muse
Last updated: Jan 24, 2024
3 min read

The SIL Listener allows users to execute scripts after triggering specific events.

Manage Listeners

Go to Administration > Manage Apps > Power Apps Config > Advanced > Listeners to manage SIL listeners.

Field Descriptions

Column

Description

Column

Description

Script

The full path to the file. Click the path to access the file in the SIL Manager.

User

If no user is specified, it will run as the caller (the user who generated the event). Or, specify a specific user to run the script.

Events

The list of events the listener responds to. You may configure multiple events on the same script.

Filters

Determines which projects and/or issue types the listener should trigger for. This is optional and if left unset the listener will trigger for all projects and issue types.

Execution

Indicates whether the execution is synchronous or asynchronous as well as if the listener is enabled.

Operations

Edit and Delete buttons.

Add a Listener

Each SIL Listener entry represents a script that runs for an event. When a SIL Listener is added, define the following properties:

  • SIL Script - When the event is received, this script runs. This is a required field.

  • Events - The event to react to. This is a required field.

  • Run As - Define the Jira user to impersonate when running the script. If this field is blank, the script processes based on the user currently logged in. This setting might be necessary if specific scripts require elevated permissions.

  • Enabled - The field that controls if the listener is executing.

  • Asynchronous - When this field is deselected, the SIL Listener is defined as a regular listener. Otherwise, it will be scheduled for execution on a separate thread.

  • Projects and Issue type filter (only for issue-related events). When this field is configured, the events are filtered accordingly. For example, scripts are executed only for events matching the filter.

Press the “Add“ button to create the listener.

Notes:

  • Multiple listener entries can be configured for the same event and the order of execution may be defined only for synchronous listeners. However, this is not a recommended practice.

  • Multiple events can be mapped to the same listener.

Update a Listener

To update a listener, click the Edit icon in the Operations column on the SIL Listeners page and update the fields in the pop-up window.

Delete a Listener

To remove a SIL Listener, click the Delete icon in the Operations column on the SIL Listeners page.

Enable and Disable a Listener

  1. To enable/disable a listener, click the Edit icon in the operations column.

  2. Uncheck the Enabled setting from the edit screen.

  3. Click Save.

 

If a listener is disabled, a corresponding label displays in the Execution column.