Performing Design Reviews of a Specific Project in an Altium 365 Workspace

The project  Design Reviews page is the central location for all project stakeholders to perform and manage structured reviews of a Workspace design project. The interface allows the creation, access and management of Design Review instances by any Workspace member, which in turn can be assigned to other Workspace members as Reviewers. The Design Review creator (the ‘Initiator) can add attachments and formalized Checklist items, and has full control over the Design Review completion/approval process.

As a multi-CAD environment, Altium 365 enables Design Review to support a range of ECAD project formats – see the Altium Multi-CAD page for more information.

Create, configure, manage and conclude Project Design Reviews assessed by specified Workspace Members.Create, configure, manage and conclude Project Design Reviews assessed by specified Workspace Members.

Completed project Design Reviews help to identify design issues, provide a traceable compliance record, and ensure that the design meets company requirements and standards. Design projects support multiple Design Reviews, which can be created at any time through the project’s development such as prior to its Release, or when passing the design to another team or contractor/manufacturer.

If your organization requires an advanced enterprise-level approach to design reviews, Altium 365’s Workspace Processes offer highly configurable, formalized Workflows that tightly control user activities such as design reviews, project creation and interaction with PLM systems.

See Processes & Workflows for more information.

Creating Reviews

In the Workspace Web Viewer, project Design Review instances are created and accessed from the project's Design Reviews page. The review will apply to the currently open project (in its current state) and be available to all Workspace members who have access to the project itself.

Select the button on the Design Review page to create a Design Review instance that applies to the currently open design project.

The created Design Review opens in its Overview summary mode and applies to a snapshot of the current design, as available for viewing and commenting through the Design Snapshot option in the navigation tree.

Edit the review’s title and description to best identify the Design Review to other Workspace members. Note that the current committed version of the design can be opened by selecting the version tile immediately below the title/description entry. This is the latest commit by default, and the name will include its Tag if available.

In the version tile, click on the commit name entry to set the Design Review to another/previous project commit from the drop-down options.

Use the Reviewers options to add Workspace members who are required to action the review. Choose from the Suggested names, or begin typing an email/name in the field to select from matching Workspace members.

Click the button to confirm your selections. If an added Reviewer does not have access to the design, the Share window will open automatically with that user preselected for sharing – the minimum requirement completing a Design Review is View (read only) access.

Optional: Add a pre-configured list of review check items from the available Checklist Templates. Multiple templates can be added to the review's Checklist, which can include your own custom templates.

The selected template will add its check items to the review instance. Use an entry's control to remove a check item from the list (a number have been removed in this example), or the upper control to remove the entire list.

Select the control if you wish to add another Checklist template to the current Design Review.

Choose from the available Checklist templates in the Add Templates to Checklist window. These include sample templates and any custom templates you have created – see Checklists view for more information. Here, the custom Parts Acceptance template is selected.

The Parts Acceptance template has added three check items to the current review Checklist. During the review process, Reviewers can confirm any check items as completed, not completed, or not applicable.

A further custom check item (or an item list) can be added manually at any time through the upper ‘Add item' field, which will be appended to any existing list of check items.

Note that the current list of check items can be saved as a new Checklist Template () – for related information, see the Checklists view on the Admin – Settings page. Hover over a Checklist entry to access its Delete option(), click on the entry to edit its text, or drag the entry to a new position in the Checklist order. GIF

Optional: Use the Attach Files option to add (upload) files that relate to the project Design Review and will assist in the review and sign-off process.

See the Admin Checklists page for information on managing Design Review Checklists.

A new Design Review instance also can be invoked from:

  • the menu in the Workspace project’s Design view.

  • Altium Designer’s project Share dialog when Design Review is selected and the project has no active (In Progress) reviews. Otherwise, the dialog will present a tiled list of the project’s active Design Reviews.

    See Support for Design Reviews for information related to Altium Designer.

Design Reviews also include the direct ability to open a comparison of the snapshot’s Schematic, PCB and BOM documents with those of previous project Commit events. Select a SCH/PCB/BOM document tab entry to see a comparison summary of its changes since the most recent Commit event, and click the Open Compare command to access that design data comparison. Use the Compare to Commit <date> menu options to select another Commit event for the comparisons. View a representative BOM comparison and Schematic comparison for this example.

Javascript ID: A
The ability to compare the Design Review's BOM, Schematic and PCB snapshot documents with their previously committed version is directly available though the Design Review interface.

See the Design Data Comparisons page for information on performing design document comparisons.

Review Design Snapshot

The Design Snapshot view corresponds to the state of the project design when the Design Review instance was created and offers the features available in the normal WIP design view, including full document navigation, net highlighting, cross-probing, and commenting.

Along with the ability to inspect the design in its review state, the snapshot view also provides a dedicated Design Review pane that summarizes the current review status, provides access to the comparisons (see above), and allows the actioning of the review’s Checklist items.

The Design Snapshot's Design Review pane includes review status information and provides access to the Checklist items. The Design Snapshot's Design Review pane includes review status information and provides access to the Checklist items.

In the Design Snapshot view, placed Comments and their assignment to user Tasks are directly associated with the Design Review. The review will include only those Comments and Tasks, and not show any existing Comments/Tasks from the source WIP design. A placed Design Review Comment will include a From: <design review> entry that links to the review Overview.

Design Snapshot Comments and any associated Tasks directly apply to the Design Review.Design Snapshot Comments and any associated Tasks directly apply to the Design Review.

Review Comment Tasks

The Design Review Tasks view includes task requests that have been created from Comments placed in the Design Snapshot view - other Tasks associated with the source WIP design are not included. Review Tasks, which are associated with a specific project (snapshot) document, can be managed and progressed by all Workspace members who have access to the project.

See Working with Tasks for more information.

Tasks associated with the Design Review appear in the review's own Tasks view but also show in the main Project Tasks view.Tasks associated with the Design Review appear in the review's own Tasks view but also show in the main Project Tasks view.

Completing Reviews

Workspace members that have been assigned as Reviewers are requested to evaluate the design within the stated review scope, complete any Checklist items, and finally accept or reject the results via the option. During this process Reviewers can inspect changes through BOM/Schematic/PCB comparisons, add/save/complete Checklist items, and place review Comments and associated Tasks.

A Reviewers contribution to the Design Review is completed when their assessment is registered as Approved or Rejected in the Review pane, where their name (under Reviewers in the Overview) will be highlighted in green and marked accordingly.

Javascript ID: Complete

An example of a Design Review instance as seen by a Reviewer. Note that most items (name/description, attached files, assigned reviewers, etc) cannot be edited.

Completing Checklists is not mandatory to successfully submit the review. Any Checklist items that have been completed are effectively 'resolved' by the Reviewer.

When the Reviewer has completed their assessment, it can be confirmed in the Review pane by choosing to Approve or Reject the review and adding any relevant notes.

The Reviewer then uses the button to finalize their review process and feedback by submitting the results.

On completion of the process, the review state associated with the Reviewer's name entry (under Reviewers) will change from Pending to Approved or Rejected (depending on the Reviewer's assessment). This is visible to all Design Review stakeholders including Reviewers and the review Initiator (creator).

Finalizing Reviews

A Design Review is finalized and moved to a closed read-only state by the review Initiator by selecting a Completed, Rejected or Cancelled state from the button menu. Only the review’s Initiator or a Workspace Administrator can finalize a Design Review. This is not dependent on the assigned Reviewers having completed their review process, and therefore can occur at any time.

The expected course of events would be for design Reviewers to have completed the review Checklist, dealt with any review Comments/Tasks, and submitted their review assessment as Accepted or Rejected (see above). The Design Review Initiator then moves the review to a finalized closed state.

Javascript ID: C

An example of a Design Review instance as seen by the review Initiator when the assigned Reviewers have completed their review process. An entry's highlight color and icon indicate the Reviewer's Approved or Rejected assessment – use the entry’s drop-down menu to view any associated Notes.

You can hover over a Checklist entry to see which Reviewer completed the item and when this occurred. Note that Checklist items can be edited, removed, or reordered at any time until the Review is closed.

The Design Review Initiator concludes the review process by specifying the closed state of the review as Completed, Rejected or Cancelled from the menu.

The finalized Design Review is marked as the selected state (such as Completed) and closed as a read-only review instance. It remains accessible for review auditing and assessment purposes.

Back on the project’s Design Reviews page, the finalized review will be found under the tab item that represents its concluded state – Completed, Rejected or Cancelled – or under the view All tab option.

Design Reviews also are represented in a WIP project’s Tasks view as individual tasks for both the review’s Initiator and its nominated Reviewers, and can in fact be completed by resolving these tasks. See more information in the below collapsible section.

 

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

Source URL: https://www.altium365.com/documentation/project-design-reviews