--- substitutions: image_actioncenter: |- ```{image} img/action_center_icon_with_no_notification.png :width: 40px ``` image_actioncenter2: |- ```{image} img/action_center_icon_with_one_notification.png :width: 40px ``` --- # 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 ```{figure} img/added_notification.png :width: 320px *Duration:* Volatile *(Max. 5 seconds)* ``` ### Submit Jobs to the Job Server When the application (Vault, Inventor, AutoCAD) [submits a new job](https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/Help/ENU/Vault/files/GUID-3F78CC2F-D493-4382-B01E-6AEDA92038F4-htm.html) to the Job Queue, the *Added* notification is displayed.\ Jobs can be submitted through: - [Submit a single Visualization attachment Job with the Client](https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/Vault-General/files/GUID-1D17BDE9-C7DC-4BDE-97CA-1A89714E4883-htm.html) - [Submit multiple Visualization attachment Jobs with the Client](https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/Vault-General/files/GUID-7735B1FD-F4DA-4807-BB98-AD667F6C706A-htm.html) - [Submit a Visualization attachment Job During Check-In](https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/Vault-General/files/GUID-3F78CC2F-D493-4382-B01E-6AEDA92038F4-htm.html) - {ref}`Submit a Job with the powerJobs Settings Dialog ` ### 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. ```{image} img/configure_job_on_lifecycle_transition.png :width: 500px ``` 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: - [Synchronize properties in a lifecycle state transition](https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/Vault-Admin/files/GUID-B4443A39-A621-4E14-8A11-484EFBF3DB90-htm.html) - [Custom jobs in a lifecycle state transition](https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/Vault-Admin/files/GUID-DD071BFB-45AC-4157-9660-2370EFA9B844-htm.html) - Custom jobs fired for a lifecycle state transition on ChangeOrders ### Submit Jobs automatically based on custom logic - [Submit a job by registering to vault events via powerEvents](powerevents:event_scripts) ```{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 ```{figure} img/error_notification.png :width: 320px *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)](https://support.microsoft.com/en-us/help/4028116/windows-where-is-action-center-in-windows-10).\ You'll find the **action center app under Windows 10 in the taskbar**, look for the action center icon: - If you have no notifications: {{image_actioncenter}} - If you got some notifications it will display the amount: {{image_actioncenter2}} *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](https://support.microsoft.com/en-us/help/4028678/windows-change-notification-settings-in-action-center). ````{admonition} Be sure notifications are enabled for powerJobs Client :class: warning ```{image} img/actionceter_enable_notifications.png :width: 300px ``` ```` ## How it works The powerJobs Client waits until the user {ref}`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. ```{admonition} Required User permissions In order for powerJobs Client to work properly, the user requires the [permissions](https://knowledge.autodesk.com/support/vault-products/learn-explore/caas/CloudHelp/cloudhelp/Help/ENU/Vault/files/GUID-269FDA08-F0C0-47E8-92DA-D832E03F827A-htm.html) 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.