Notifications

powerJobs Client notifies the user about changes in the Vault Job Queue.

Following types of job notifications are displayed in the Action center:

Added Notification

../_images/added_notification.png

Duration: Volatile (Max. 5 seconds)

Submit Jobs to the Job Server

When the application (Vault, Inventor, AutoCAD) submits a new job to the Job Queue, the Added notification is displayed.
Jobs can be submitted through:

Submit Jobs automatically based on Lifecycle State Change

When the application (Vault, Inventor, AutoCAD) performs a lifecycle state change, and certain job types are configured to be triggered from the Vault-Server based on the lifecycle transition, the Added notification is displayed.

../_images/configure_job_on_lifecycle_transition.png

Via Vault Client it is possible to configure jobs only for Files, Folders, Items and Custom Objects.
It is possible to configure jobs to be submitted to the job server automatically on lifecycle state changes through:

Submit Jobs automatically based on custom logic

Note

The user gets notified either for jobs which are submitted by himself, or automatically from the Vault-Server (e.g. on a lifecycle state change).

Error Notification

../_images/error_notification.png

Duration: Persistent (Max. 3 days)

In case a job that was added by the user terminates with an error, the Error notification is displayed.
It this happens during the absence of the user and the Vault application was closed, the notification will be displayed right after the next Vault login.

Users will not be informed if their failed jobs were removed from the Job Queue or re-submitted in the meantime.

Action center

The notifications sent by powerJobs Client will appear in the Windows 10 Action Center (Info Center).
You’ll find the action center app under Windows 10 in the taskbar, look for the action center icon:

  • If you have no notifications: ../_images/action_center_icon_with_no_notification.png

  • If you got some notifications it will display the amount: ../_images/action_center_icon_with_one_notification.png

The look of the notifications and the action center could vary on Windows 10 with different updates.
You have the possibility to change the behavior of some or all notifications for your Windows 10 machine, see here.

Be sure notifications are enabled for powerJobs Client

../_images/actionceter_enable_notifications.png

How it works

The powerJobs Client waits until the user submits a new job to the Vault Job Queue.
After that, the Job Queue is constantly checked (every 5 seconds), in order to check the states of the desired jobs from the user.

To reduce the Vault API calls to a minimum, the polling mechanism runs only right after starting a Vault application and when a new job gets queued.
It retrieves only the required job information’s in an intelligent way so that not every time all jobs have to be retrieved.
Finally, depending on the job state, notifications will be displayed to the user and when all his jobs are done this functionality is paused.

Required User permissions

In order for powerJobs Client to work properly, the user requires the permissions to read and add a Job to the Vault Job Queue, e.g:

  • Document Editor (Level 1)

  • Document Editor (Level 2)

If one job changes its state multiple times within the above-mentioned polling interval, then only the notification for the last state will be displayed.
This means for instance if your job is submitted, processed and run on error in less then 5 seconds, you will receive only the notification of the error.

If multiple jobs change their state multiple times within the above-mentioned polling interval, then the error notification has the highest priority and will be displayed.
This means for instance if you submit 20 jobs, then all are getting processed and 10 run on an error and 10 runs on success (all happens in less then 5 seconds), then you will see the notification for the error and the other notifications will go in the Action Center.