Difference between revisions of "Collaborative Milestone Review Process"

From MediaWiki
Jump to navigation Jump to search
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
  
 
==[[#Communication & Outreach|Communication & Outreach]]==
 
==[[#Communication & Outreach|Communication & Outreach]]==
 +
The Development Guide has moved to a Sharepoint site.
  
−
===[[#Webinars|Webinars]]===
+
If you haven't visited the new site yet contact MDOT-EngineeringSupportTraining@michigan.gov to request access to the Development Guide.
−
Initial Real-Time Collaborative Milestone Review Webinar: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=b6fde66c-e51b-497d-af74-26bea62fa86f&fileName=%22RealTime%20Collaborative%20Milestone%20Review.mp4%22 Real-Time Collaborative Milestone Review]
 
−
 
 
−
{{top}}
 
−
 
 
−
==[[#Process Change Information|Process Change Information]]==
 
−
As part of MDOT’s goal for utilizing the concept of a “single source of truth” for documents and processes throughout design and construction, utilizing digital means to capture comments during project milestone reviews has been a priority. MDOT joined the AASHTO Innovation Initiative Project PS&E C-Rev in the fall of 2017 to further advance a real-time collaborative milestone review process.  In March of 2015, the Digital Pen process was officially started as part of the DA-2015-03 Process Improvement for internal milestone reviews as a transition tool to help users accustomed to pen and paper reviews switch to digital commenting. This process was intended to ensure that comments were being harvested digitally by users.  As a result, many users have begun switching from utilizing the Digital Pen to utilizing full digital commenting in Adobe. 
 
−
 
 
−
 
 
−
As users have become more familiar with utilizing full digital commenting for milestone reviews, it has allowed MDOT to investigate the process and determine if improvements can be made to allow for time savings for the Project Manager, Reviewers, and design team during the review process. Advantages of adding a real-time component to the milestone reviews include time savings by allowing multiple users to comment in a document at the same time, improving engagement between the design team and QA units, reducing the amount of time the Project Manager takes to clean up review comments, and allowing improved accuracy in addressing comments by consolidating responses in the files.
 
−
 
 
−
 
 
−
To add the real-time component to the milestone review process, new software was investigated. Based on this investigation, Bluebeam PDF software was selected to be piloted as a complimentary tool to the ProjectWise Milestone Review Process. With Bluebeam, milestone review documents can be temporarily loaded into a Studio Session with integration to ProjectWise which allows multiple users to access the files concurrently, comment and view any other user’s comments in real-time during the review session. While the software has a different user interface than Adobe, the commenting process is similar. 
 
−
 
 
−
 
 
−
<big>'''To improve the current milestone review process and discontinue the Digital Pen process, Bluebeam has been selected to implement the Real-Time Collaborative Milestone Review Process.'''</big>
 
−
{{top}}
 
−
 
 
−
==[[#Real-Time Collaborative Review Process Overview|Real-Time Collaborative Review Process Overview]]==
 
−
The new process will change how users review project documents during the milestone review period, but does not change development of plans, the milestone review meeting, or where documents are ultimately stored. All project files and comments will be stored in ProjectWise in their appropriate locations and will still be accessible after the review period, however, during the milestone review period all reviews must be done utilizing the Studio Session created by the Project Manager. An overview of the process is noted below:
 
−
 
 
−
# The design team will notify the Project Manager when the milestone plans have been placed in the appropriate folder in ProjectWise and are ready for review.
 
−
# The Project Manager will review the submitted files in ProjectWise.
 
−
# The Project Manager will notify QA and coordinate a review date.
 
−
# Once the date is selected and reviewers are ready to be notified, the Project Manager will create a Bluebeam Studio Session that links the ProjectWise files to the Bluebeam Studio cloud. The project files will remain checked out to the Project Manager for the duration of the review period.
 
−
# The Project Manager will fill out the standard ProjectWise generated milestone review meeting notification email and include a link to the Bluebeam Studio Session for the review.
 
−
# All reviewers will comment on the plans utilizing the Bluebeam Studio Session during the review period.
 
−
# The Project Manager and Design Team will monitor and review any comments during the review period.
 
−
# One to two days prior to the milestone review meeting, the Project Manager will finish the Bluebeam Studio Session, review comments as necessary, and load the review files back into ProjectWise.
 
−
# The project files that have been loaded back onto ProjectWise will be utilized during the milestone review meeting.
 
−
 
 
−
 
 
−
A flowchart that compares the digital pen process to the Bluebeam Studio process is shown in the following figure:
 
−
 
 
−
 
 
−
[[File:Collaborative Milestone Review.jpg|1000px|frameless|center]]
 
−
 
 
−
 
 
−
{{top}}
 
−
 
 
−
==[[#Milestone Review Comments|Milestone Review Comments]]==
 
−
The following procedures are suggested for review comment format and comment resolution.
 
−
===[[#Comment Format|Comment Format]]===
 
−
Significant design comments should be entered in following format:
 
−
# Identify the deficiency or incorrect application of policy, guidance, or procedures
 
−
# Basis for concern – Cite the appropriate standard that is not being followed
 
−
# Significance of concern – Indicate the importance of the concern with regard to its potential impact on plan selection, recommended plan components, efficiency (cost), effectiveness, implementation responsibilities, safety, Federal Interest, or public acceptability.
 
−
# Describe specific action needed to resolve the concern
 
−
 
 
−
 
 
−
[[File:GoodComment.png|1000px|frameless|center|Example design comment]]
 
−
 
 
−
 
 
−
Typos or CAD comments should be identified as follows:
 
−
# Highlight or delineate the deficiency
 
−
# Describe specific action needed to resolve concern
 
−
 
 
−
 
 
−
{{top}}
 
−
 
 
−
===[[#Comment Resolution|Comment Resolution]]===
 
−
# Project Manager reviews comments and sets status to 'accepted' or 'rejected'.
 
−
#* Project Manager assigns comment responsibility for all accepted comments.
 
−
#* Project Manager coordinates with reviewers and documents discussion for any rejected comment.
 
−
# Design team revises project documents based on the accepted comments.
 
−
# Design team sets status to 'completed' on each comment after the revisions are made to the project documents.
 
−
# Prior to the next milestone review, and after all comments are complete, Project Manager notifies reviewers to backcheck their comments.
 
−
{{top}}
 
−
 
 
−
 
 
−
 
 
−
==[[#Introduction to Bluebeam|Introduction to Bluebeam]]==
 
−
Bluebeam products provide powerful and easy to use features for marking up Engineering PDF documents and project collaboration. Through the use of Studio Sessions, users can collaboratively review a project from any location by integrating project documents from ProjectWise to the Bluebeam cloud service hosted by Amazon. By participating in a Studio Session, users are able to collaborate on one or more files and all markups are immediately viewable by other users participating in the session.
 
−
 
 
−
There are two roles within a Bluebeam Studio Session. That of an initiator, and that of a participant. To initiate a Studio Session, a user is required to have a licensed version of Bluebeam Revu. To be a participant in a Bluebeam Studio Session, the unlicensed version of Bluebeam Revu is required at a minimum.
 
−
{{top}}
 
−
 
 
−
==[[#Software Requirements|Software Requirements]]==
 
−
Bluebeam offers three editions of Revu: Revu Standard, Revu eXtreme and Revu CAD. Each edition comes with a View Mode which allows the program to function without a license while still allowing access to Bluebeam Studio Sessions. For MDOT users, consultants, or any other user that will be a participant in a collaborative milestone review but not required to create a session, the View Mode in any edition of Revu can be utilized to access the session. https://support.bluebeam.com/articles/revu-what-is-view-mode/
 
−
 
 
−
<big>'''External Users'''</big>
 
−
 
 
−
For users outside of MDOT that will be participating in a collaborative milestone review, Bluebeam Revu can be downloaded at the following link: <big>'''[https://support.bluebeam.com/updates/ Bluebeam Revu Download]'''</big>
 
−
:The version of Bluebeam Review currently used by MDOT is 2019.1.20. On the download page, scroll down to the "Need an Older Version" section of the website and select the button to "Download Revu 2019". Click "Use as Trial" when prompted to register your software. This will give you access to all of Revu’s features free for 30 days. Once the trial ends, you can continue using Revu, but only in View mode.
 
−
 
 
−
<big>'''MDOT Users'''</big>
 
−
 
 
−
Bluebeam Revu must be installed from the Software Center for MDOT employees.
 
−
 
 
−
{{top}}
 
−
 
 
−
==[[#MDOT Training Information|MDOT Training Information]]==
 
−
 
 
−
===[[#Setting Up Bluebeam (All Users)|Setting Up Bluebeam (All Users)]]===
 
−
:<big>'''Initial Setup: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=4a38c011-d3e1-4d30-a231-2589d88e07ca&fileName=%22Initial%20Setup.mp4%22 Video] | [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=de1a5064-f954-4271-8884-bb997ccf9745&fileName=%22Initial%20Setup.pdf%22 PDF]'''</big>
 
−
:This training steps through the initial setup of Bluebeam after it has been installed on your computer and includes the process for linking the program to ProjectWise and creating a Bluebeam Studio Account.
 
−
 
 
−
:<big>'''ProjectWise Integration: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=709b9261-838e-4e77-9916-cd05027e91a8&fileName=%22ProjectWise%20Integration.mp4%22 Video] | [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=0d88a4c9-8e56-46aa-a982-d92c4b9d09cd&fileName=%22ProjectWise%20Integration.pdf%22 PDF]'''</big>
 
−
:This training details how to integrate ProjectWise into Bluebeam if not done as part of the initial setup of the program.
 
−
 
 
−
:<big>'''MDOT Customizations: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=c21ad5e3-9055-4211-aaaf-69933d53d2a5&fileName=%22Adding%20MDOT%20Profile%20and%20Tool%20Sets.mp4%22 Video] | [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=fac661e1-bd92-4744-97c5-236ffa9182cf&fileName=%22Adding%20MDOT%20Profile%20and%20Tool%20Sets.pdf%22 PDF] '''</big>
 
−
:Custom tool sets have been created for this process to standardize the tools that reviewers utilize to better track comments during the milestone review. The training steps through the importing process for these customizations. The profile and a toolset overview document can be downloaded below:
 
−
 
 
−
:<big>'''MDOT Custom Profile: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=9d59ba00-875f-4e81-b533-02b19c6c7b21&fileName=%22MDOT%20BlueBeam%20Review.bpx%22 MDOT Bluebeam Review.bpx]'''</big>
 
−
:<big>'''Toolset overview Document: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=2c0d407f-8609-42e1-b2df-c1f629d45b02&fileName=%22MDOT%20Bluebeam%20Review%20Toolset%20Overview.pdf%22 Custom Toolset Overview]'''</big>
 
−
 
 
−
===[[#Reviewing a Project (All Users)|Reviewing a Project (All Users)]]===
 
−
:<big>'''Joining a Studio Session: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=6d5c86b9-cb52-4759-a07e-a8a4c5e767fc&fileName=%22Joining%20a%20Studio%20Session.mp4%22 Video] | [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=71a073d8-848d-4389-b446-fea43b1e9b5f&fileName=%22Joining%20a%20Studio%20Session.pdf%22 PDF]'''</big>
 
−
:This training steps through the process of joining a Bluebeam Studio Session as part of a Collaborative Milestone Review utilizing a link of Session ID provided by the Initiator of the Review.
 
−
 
 
−
:<big>'''Commenting in a Studio Session: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=90445c0d-5e0f-45ed-b4c3-04fdeca6ce10&fileName=%22Commenting%20in%20a%20Studio%20Session.mp4%22 Video] | [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=07fcf888-383e-47d8-8362-8b920c6a97c6&fileName=%22Commenting%20in%20a%20Studio%20Session.pdf%22 PDF]'''</big>
 
−
:This training provides instructions on how to comment in a Bluebeam Studio Session. Ensure that you have downloaded and installed the MDOT custom profile as noted in the Setting Up Bluebeam section prior to commenting.
 
−
 
 
−
:<big>'''View Setup: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=742dad39-4174-457e-9a97-46af11b7a15f&fileName=%22Views.mp4%22 Video]'''</big>
 
−
:This training provides instructions on how set up views.
 
−
 
 
−
===[[#Setting up a Milestone Review (Project Managers or Review Initiators)|Setting up a Milestone Review (Project Managers or Review Initiators)]]===
 
−
:<big>'''Starting a Session and Inviting Users: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=78ddfd06-35f5-48dc-b510-1165e3d3be72&fileName=%22Starting%20a%20Session%20and%20Inviting%20users.mp4%22 Video] | [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=e1eca4e4-2af3-4135-9be0-87db8059e2ad&fileName=%22Starting%20a%20Session%20and%20Inviting%20Users.pdf%22 PDF]'''</big>
 
−
:This training steps through the process of initiating a Bluebeam Studio Session as part of a Collaborative Milestone Review. A software license is required to create a Studio Session. To acquire a license: Select Revu>Markup Mode, File>Open select any PDF, add a markup to the PDF, File>Save. After saving the PDF, a license activation dialog box will appear. Once this process is completed, it should not have to be repeated unless the software is reinstalled or upgraded. If the create session process fails, switch to View mode (Revu>View), and back to markup mode (Review>Markup). This will trigger license acquisition, then select Create Session again.
 
−
 
−
:<big>'''Delegating Studio Session Control: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=2fac02a9-bcf0-4c04-99d4-c72e172a8d51&fileName=%22Delegating%20Studio%20Session%20Control.mp4%22 Video]'''</big>
 
−
:This training steps through the process of providing another user full control of a studio session. This can be utilized if someone other than the Project Manager starts the session and wants to allow the PM to have the ability to add documents or finish the session or if the user that starts the session will be unavailable to finish the session at the end of the review period.
 
−
 
 
−
:<big>'''Finishing a Studio Session: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=a5ec1d36-559f-4f57-a81e-64bcaf21da81&fileName=%22Finishing%20a%20Studio%20Session.mp4%22 Video] | [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=1b56abed-e101-4033-a8cd-e574576785b3&fileName=%22Finishing%20a%20Studio%20Session.pdf%22 PDF]'''</big>
 
−
:This training steps through the process of finishing a session and loading the comments into ProjectWise. Only the Initiator of the session has the ability to finish the session. If the Finish Session process fails, switch to View mode (Revu>View), and back to markup mode (Review>Markup). This will trigger license acquisition, then select Finish Session again.
 
−
 
 
−
===[[#Preparing Documents for Milestone Review (Design team or Project Manager )|Preparing Documents for Milestone Review (Design team or Project Manager)]]===
 
−
:<big>'''Page Numbers: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=74613fc0-46ca-481c-8b80-70c53bb6d156&fileName=%22PageNumbers.mp4%22 Video]'''</big>
 
−
:This training shows how to add page numbers to plan set.
 
−
 
 
−
:<big>'''Plan Set Bookmarks: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=0b111ee9-339f-4718-8227-b478464fa878&fileName=%22Plan%20Set%20Bookmarks.mp4%22 Video]'''</big>
 
−
:This training shows how to create and set bookmarks in a plan set in Bluebeam.
 
−
 
 
−
===[[#Responding to review comments)|Responding to review comments (Design team or Project Manager)]]===
 
−
:<big>'''Comment Response: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=bb5cc9f5-cb3e-4e21-be83-4f4f1edc6d3a&fileName=%22CommentResponse.mp4%22 Video]'''</big>
 
−
:This training shows how to respond to milestone review comments in Bluebeam. Note that the video shows responding to comments after the Studio Session has been finished. The review documents are opened from ProjectWise. If multiple team members will be responding to comments, a new Studio Session can be initiated.
 
−
 
 
−
===[[#Supplemental Topics|Supplemental Topics]]===
 
−
:<big>'''Calibrate Measurement Tools: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=b0c18845-78f5-4446-96fd-12680f6f1fb0&fileName=%22CalibrateMeasurementTools.mp4%22 Video]'''</big>
 
−
:This training shows how to calibrate Bluebeam measurement tools.
 
−
 
 
−
:<big>'''Count: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=62620ab9-4311-46ac-8c34-da81b7ca190c&fileName=%22Count.mp4%22 Video]'''</big>
 
−
:This training shows how use Bluebeam measurement tools to count items.
 
−
 
 
−
:<big>'''Dynamic Fill: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=34919c15-80d4-40e5-996b-fc4218030db3&fileName=%22DynamicFill.mp4%22 Video]'''</big>
 
−
:This training shows how use Bluebeam measurement tools to measure areas.
 
−
 
 
−
:<big>'''Import Markups: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=e2f9001e-a123-4ec1-a69f-f24225ca1d4a&fileName=%22BluebeamImportComments.mp4%22 Video]'''</big>
 
−
:This training shows how to export markups and import them into another PDF. This might be necessary when a local partner provides comments in a PDF software other than Bluebeam. If this process is used, the Project Manager must provide the local partner with exact copies of the documents that are in the Studio Session.
 
−
 
 
−
:<big>'''Overlay: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=5fbf9701-e5b8-4915-ba0a-8eb40a0ce8bb&fileName=%22Overlay.mp4%22 Video]'''</big>
 
−
:This training shows how to Overlay two PDF documents to see what is different. This could be used to compare Clean Sheets vs As-Let Plans when preparing an addendum.
 
−
 
 
−
:<big>'''Recovering a Finished Studio Session: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=50a6cb63-54a2-46cc-b524-098d4ea2d33d&fileName=%22Recovering%20a%20Studio%20Session.mp4%22 Video]'''</big>
 
−
:This training walks through the steps to recover and reactivate a Studio Session that has been finished. Session data is stored in the cloud for '''30 days''' after the session has been initially finished. This allows the user to re-download the files in case an error occurs or comment information is not saved correctly.
 
−
 
 
−
:<big>'''Search: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=3742f12a-40c6-492e-87aa-f72262820e61&fileName=%22Search.mp4%22 Video]'''</big>
 
−
:This training shows how use the search tools in Bluebeam.
 
−
 
 
−
:<big>'''Toolset Management: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=bb68d41a-a1ce-4d34-99f0-3bc2cf78bc97&fileName=%22Toolset%20managment.mp4%22 Video]'''</big>
 
−
:This training shows how to edit tool properties and add additional tools to the default tool sets in Bluebeam.
 
−
 
 
−
:<big>'''Slip Sheet: [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=b7829e28-97ad-4479-af08-e16560c74eda&fileName=%22SlipSheet.mp4%22 Video]'''</big>
 
−
:This training shows how to replace individual sheets in a plan set PDF with revised sheets using the Slip Sheet tool. The example shows swapping the miscellaneous quantity sheet with a revised version. The tool can replace multiple sheets at once. It is recommended to place the page numbers on the revised sheets prior to inserting into the plan set PDF.
 
−
 
 
−
==[[#Bluebeam Resources|Bluebeam Resources]]==
 
−
A wide range of introductory and in-depth instructional videos are available for viewing on Bluebeam's website as well as an interactive user manual. It is recommended that users utilize this resource for basic understanding of the program. Additional information as well as MDOT Specific training videos on the use of Bluebeam for collaborative milestone reviews are located on the Support Services website.
 
−
 
 
−
:<big>'''Bluebeam Online User Manual: [http://support.bluebeam.com/online-help/revu2018/Content/RevuHelp/Dashboard.htm User Manual]'''</big>
 
−
:<big>'''Bluebeam Training Videos: [https://support.bluebeam.com/training-videos/ Training Videos]'''</big>
 
−
{{top}}
 
−
 
 
−
==[[#FAQs|FAQs]]==
 
−
Q: When finishing a Studio Session I get an error message. <br/>
 
−
A: Switch from Markup Mode to View Mode, and back to Markup Mode. Revu > View, Revu > Markup. This will trigger license activation.
 
−
[https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=8508e995-3d4c-48ec-8c59-98e3a04ef11b&fileName=%22Bluebeam%20Finish%20Session.mp4%22 Video - Create or Finish Session Dialog missing]
 
−
 
 
−
Q: When creating a new studio session, I click the + box but nothing comes up. <br/>
 
−
A: Switch from Markup Mode to View Mode, and back to Markup Mode. Revu > View, Revu > Markup. This will trigger license activation.
 
−
[https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=8508e995-3d4c-48ec-8c59-98e3a04ef11b&fileName=%22Bluebeam%20Finish%20Session.mp4%22 Video - Create or Finish Session Dialog missing]
 
−
 
 
−
Q: My markups tools are all red and don't look the same as the other reviewers. <br/>
 
−
A: Download the MDOT Bluebeam Review Toolset. [https://mdotjboss.state.mi.us/SpecProv/getDocumentById.htm?docGuid=6a0dd47e-7fc0-4dae-8d41-37f63a076f12&fileName=%22MDOT%20BlueBeam%20Review.bpx%22 Download Toolset]
 
−
 
 
−
Q: The patterns on the plans are not displaying transparency correctly. <br/>
 
−
A: This is a known issue with the first release of 2019. This is fixed in release 2. After user testing is completed, the download will be available in software center.
 
−
 
 
−
Q: I'm trying to setup the ProjectWise integration in Bluebeam Revu 2019.1.20 and it does not have the option for ProjectWise DMS. <br/>
 
−
A: This is a compatibility issue with ProjectWise V8i and Bluebeam Revu 2019.1.20. Upgrading to ProjectWise Connect solves this issue. ProjectWise Connect will be available in software center soon (mid September 2020?).
 
−
 
 
−
{{top}}
 
−
 
 
−
[[Category:Bluebeam]]
 

Latest revision as of 12:03, 24 January 2025

Communication & Outreach

The Development Guide has moved to a Sharepoint site.

If you haven't visited the new site yet contact [email protected] to request access to the Development Guide.

Retrieved from "https://mdotwiki.state.mi.us/design/index.php?title=Collaborative_Milestone_Review_Process&oldid=4101"