Event mappings
To run VBA (Visual Basic for Applications) subroutines before or after particular phases of synchronisation, select the Events tab in the Project Settings window.
To handle an event, tick the respective check box and either select an existing VBA sub or press Create to generate an empty handler automatically.
The following events are supported.
| Event | When raised | Handler signature |
|---|---|---|
| Sync run: Before preparing | During synchronisation before comparing any tasks with issues and preparing changes. | Sub Xxx(Project As Project) |
| Sync run: Before applying | During synchronisation before applying any changes. | Sub Xxx(Project As Project) |
| Sync run: After applying | During synchronisation after applying all changes. | Sub Xxx(Project As Project) |
| Sync task: Before preparing | During synchronisation before comparing each task with an issue and preparing changes for that task. | Sub Xxx(Project As Project, Task As Task) |
| Sync task: Before updating | During synchronisation for each linked task before updating the task and/or issue. | Sub Xxx(Project As Project, Task As Task) |
| Sync task: After updating | During synchronisation for each linked task after updating the task and/or issue. | Sub Xxx(Project As Project, Task As Task) |
| Sync task: Before publishing | During synchronisation for each unlinked task before creating the issue. | Sub Xxx(Project As Project, Task As Task) |
| Sync task: After publishing | During synchronisation for each unlinked task after creating the issue. | Sub Xxx(Project As Project, Task As Task) |
| Sync task: Before deleting | During synchronisation before deleting each task where the linked issue does not exist anymore. | Sub Xxx(Project As Project, Task As Task) |
| Import run: Before preparing | During import before processing any issues. | Sub Xxx(Project As Project) |
| Import run: Before applying | During import before creating any tasks. | Sub Xxx(Project As Project) |
| Import run: After applying | During import after creating all tasks. | Sub Xxx(Project As Project) |
| Import task: After creating | During import after creating each task. | Sub Xxx(Project As Project, Task As Task) |