SubmitJobsOnVaultMenuItemClick

This event script is intended to be used in combination with the powerJobs Settings Dialog to configure the Vault Explorer to queue jobs directly from the Vault Context Menu for Files, Items and Change Orders.

Requires powerJobs Processor

The SubmitJobsOnVaultMenuItemClick event script relies on the configuration from the Job Triggers section of the powerJobs Settings Dialog to work properly.
This requires minimum version of powerJobs Processor 23.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 makes use of the Add-VaultMenuItem cmdlet to add context menu items for each job that has a context menu trigger enabled in the Job Triggers section 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 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 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 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

This event script does not rely on VaultEvents as the menu items are only added once to the Vault Client. To disable the script completely a return statement can be placed at the beginning of the file.