(no) Change Management Workflow
Translation needed
The content of this page was copied from another page tree and needs to be translated or updated.
When you finish translation, make sure to
-
Replace the label NEEDS-TRANSLATING with TRANSLATED
-
Remove this macro from the page
Since 3.8.0
Change Requests are optional functionality that requires separate activation per customer. To activate it please contact your Resseler.
Introduction
A user should be able to create a change request related to a specific drawing.
A change request is a set of graphical and textual notes associated with a drawing and objects on the drawing (spots that relate to objects). By using these tools as well as comments a user can express what changes are needed.
This request can be picked up by another staff member (Change Manager), processed and at the end Resolved.
Security (access and modification) to change request is controlled depending on request state (workflow step) as well as user role in the system.
Creating and Managing Requests
To create a new request, open desired drawing and select Manage Change Requests icon on the mode toolbar:
On the side, a panel listing all active Change Requests for this drawing is shown.
Depending on context security rights you will see different options available.
Select a New request button to create new request. Fill in label for the request, and select Add.
With a new request, a special request layer will be created and loaded automatically.
All changes made on the drawing will be strictly bound to this layer and request. You can use any redline tools to create a request markup.
Use the comments section to add additional notes or post a reply.
Another user with sufficient privileges will be able to reply to your comments.
Printing Change Request content
This functionality is supported both in Quick Print and Image View (while in Change request mode), or in Print Preview when accessed directly from Change Request mode.
Only currently selected change request content will be printed. First, open desired change request as shown below:
Now choose either Quick Print, Image View or Print Preview. Print Preview mode is shown in the image below:
Activation of Change Request print is confirmed by additional status message:
We have also added new parameter for HOPA called changeRequestId (crId) that allows to get printout with one selected Change Request.
Dashboard
Requests shown in the main interface next to a selected drawing, relate only to that drawing.
To manage, filter, assign or transition other requests, you can use configurable dashboard panels.
Use the add widget menu to add "Manage Change Requests" widget. You can use the widget configuration options to select what type of requests should be
displayed in this particular widget. Requests can be filtered by workflow state, reporter (owner) or assignee.
You can add more widgets of the same type and configure them to obtain view on different data, for example one widget can display requests reported by you,
and another widget can display all unassigned (open) requests.
Widget configuration is saved in your profile.
Possibility to view request details on Dashboard
User do not always want to navigate to the document to view Request details like comments or transition history. Now these details are available directly on the dashboard.
Use the "Info" button to open details panel:
Possibility to view resolved requests
Resolved requests are normally not displayed under document menu - only active requests are shown.
Now there is a possibility to view single request including resolved one. To view resolved request, we need a reference to it that can be found on Dashboard or in notifications.
First select a request in dashboard:
The Go to Request function now will take you to the desired document, it will automatically enter Change Request mode and load the single, selected request.
Please note that after such navigation, Viewer will be in "Single request mode". Other requests will not be visible. Please use "Show all" button to load all active requests.
Requests listing will also be reset on new document load.
Filter "Change Management" issues by parent object
When basic filters are not enough a user can now search for Change Requests withing a specified sub-tree. e.g. find request within a building, property or floor.
To activate this additional filter, use the sub-tree icon and select desired "root" object:
Now this widget will display request objects only in this sub-tree. To view all requests, please use "clear" button.
Workflow
Every request can be transitioned through workflow steps. Actions available to current user and in current Request state, will
be presented as action buttons as visible on the image below:
Workflow transitions can also be performed directly from the Dashboard. Additionally, Go to Request, Assign to me and Assign to operations are available:
Go to Request button will take you directly to the drawing that this request belongs to
Assign to me button will assign selected request to you
Assign to... button will open up user picker, so that you can assign this request to someone else. Please note that this user must have Change Manager role to be able to see assigned request.
Action buttons: at the end action buttons are presented. They depend on specific request state and your privileges. (Screenshot presents Submit and Discard action buttons)
You can check a history of transitions in the History tab. Every section presented there represents single transition
performed form a given state to a new resulting state. A user name and time of the transition is also shown.
Primary workflow steps available for Change Requests:
Request State | Description | User Rights | Available Transitions | System Events |
---|---|---|---|---|
New | A request is created by the user | Roles
Actions / State
| Operation: Submit Results in Open state Available to: Owner Operation: Discard Results in: Request id deleted Available to: Owner | (no events) |
Open | A request is submitted for processing | Actions / State
| Operation: Start Progress Results in In Progress state Available to: Change Manager Operation: Edit Results in New state Available to: Owner Operation: Resolve Results in Resolved state Available to: Owner, Change Manager | "Change Request Created" Event Owner: Request Owner Event Target: None |
In Progress | Request is being handled. | Actions / State
| Operation: Resolve Results in Resolved state Available to: Change Manager (Assignee?) | "Change Request Processing" Event Owner: Request processor Event Target: Request Owner |
Resolved | Request is resolved. | Actions / State
| Operation: none available | "Change Request Resolved" Event Owner: Request assignee Event Target: Request Owner |
Security
Actions available for a specific Change Request are dependent on both system roles and user relation to a given Change Request.
A user can be related to a given request and have dynamic roles by being an:
Owner - a user that has created that request
Assignee - a user that is assigned to this request
There are also general system roles
Change Manager - a user with this role will be able to manage all requests in the system (review, assign, transition etc)
Change Reporter - a user with this role will be able to create new requests (report changes)
User with this role alone will only be able to manage their own requests. Further limitations might apply depending on request state.
Notifications
Key actions related to Change Requests will trigger system notifications that can be managed in the Notifications area . (For more information see (no) Notifications)
Notifications relate to Change Requests:
Request Created
Request User Assigned
Request State Changed
Request New Comment
Create XLS report from Change Request list
Change request list from Dashboard can now be exported to XLS file.
Function should respect filter settings made so that only viewed rows in list are reported.
New button Export was added to Manage Change Request window in Dashboard.
This is a task that will be listed under Server task window as Change Request Export and the report can be downloaded after clicking on icon in Get Result column.
Rich text editing for change requests comments
Change request comments, now supports rich text editing capabilities for improved communication.
Due to limited space we only provide basic editing options like:
bulleted or numbered list
links support
text color and highlight
basic formatting (italic, bold etc)