# SubmitJobsOnVaultMenuItemClick

This event script is intended to be used in combination with the [powerJobs Settings Dialog](<powerjobs_processor:job_configuration>) to configure the Vault Explorer to queue jobs directly from the Vault Context Menu for Files, Items and Change Orders.

:::{admonition} Requires powerJobs Processor
:class: warning

The **SubmitJobsOnVaultMenuItemClick** event script relies on the configuration from the Job Triggers section of the [powerJobs Settings Dialog](<powerjobs_processor:job_configuration/job_triggers_tab:trigger job manually by context menu item>) to work properly.
This requires minimum version of powerJobs Processor [23.0.3](<powerjobs_processor:change_logs/powerjobsprocessor_v23:v23.0.3>)
:::
The user that is logged in to Vault must have the `Vault Get Options` permission to access the context menus configured with the powerJobs Settings Dialog.

The script action gets executed on the [](</code_reference/objects/event_mappings/connection_events/loginvault>) event and makes use of the [](</code_reference/commandlets/add-vaultmenuitem>) cmdlet to add context menu items for each job that has a context menu trigger enabled in the [Job Triggers section](<powerjobs_processor:job_configuration/job_triggers_tab>) in the powerJobs Settings Dialog.


* When the user clicks the menu item, jobs are only queued when the selected entity matches all of the [filters](<powerjobs_processor:job_configuration/job_triggers_tab>) configured in the powerJobs Settings Dialog
* The _SubmitJobsOnVaultMenuItemClick_ script is only executed when used in the Vault Explorer.
* A dialog is displayed when none of the selected entities matches the filters and therefore no jobs were queued.
* If the powerJobs Processor *Sample.CreateDXF&STEPfromSheetmetal* job is configured to be queued, additional checks are performed. The Vault environment must be **[configured](<event_scripts:vault configuration>) correctly** for the event script be able to determine the document type.
* The script is only executed once, when the user logs in to Vault for the first time.


## Testing

The script can be tested by performing the following steps:

1. Open the Vault Client, open the powerJobs Settings Dialog and navigate to the Job Triggers tab of the dialog. Then navigate to the [*Context Menu Trigger*](<powerjobs_processor:job_configuration/job_triggers_tab:trigger job manually by context menu item>) section and enable it.
2. Restart the Vault Client for the changes to take effect
3. Navigate to an entity of the selected type (e.g. File)
4. Right-click the entity, expand the sub-menu "powerJobs Client" and click on the menu item to queue the job
5. To verify the job Job Queue can be opened and it should contain a job for the selected entity with the configured job type, description and priority

Out of the box the event script is **enabled**.\
When the script is not used it can by disabled by moving it to the *%PROGRAMDATA%\\coolOrange\\powerEvents\\Events\\Disabled* folder.