設計レビューの実施

あらゆる設計プロセスにおいて不可欠な要素の1つは、共同で行うピアレビューであれ、厳格な承認メカニズムであれ、開発の主要な段階でその進捗と妥当性を確認することです。そのプロセスには、どのレベルであっても、本質的に、対象となるレビュアーが必要とする関連するすべてのプロジェクトデータ、ファイル、コメント、視覚的表現、およびフィードバックツールへのアクセスを提供することが含まれます。

Altium Designer では、この機能を非常に柔軟な形で提供しており、Process Workflowsレビュー 接続された Workspace でホストされ、Altium Designer 内からアクセスされる Process Workflows を適用することで実現しています。

プロセスとそのワークフローの詳細については、Creating & Managing ProcessesAltium 365 WorkspaceEnterprise Server Workspace)を参照してください。

プロセスワークフローには、ユーザーがプロセスフローの各ステップを進む際に表示される対話型フォームが組み込まれており、コメントの記入、ファイルの添付、設計ドキュメントの表示などを行うことができます。レビュー プロセスは、プロジェクトへのアクセス権を持つ任意の Altium Designer ユーザーが開始でき、他のユーザー(チームメンバー)またはユーザーグループ(チームロール)に割り当てられます。

 Workspace 側では、管理者はプロセスを図式ベースのフローとして扱い、フローに組み込まれるユーザーフォームとステップは完全にカスタマイズ可能です。これにより、たとえば既存の社内レビュー要件を対象とした非常に具体的なプロセスを、必要に応じて構築(および適用)できます。ワークフロープロセスは必要な数だけ作成できます。

詳細については、Defining a Process WorkflowAltium 365 WorkspaceEnterprise Server Workspace)を参照してください。

レビュー プロセス

 Workspace には、提供されたまま使用することも、より高度なカスタムプロセスの基礎として使用することもできる、3つのデフォルトのレビュー プロセスがあります。

  • Ad Hoc Review – 記録される結論を伴わない非公式なレビュー プロセス。
  • Handoff Review – レビューを終了する際に、レビューの開始者(提出者)が合格/不合格(Completed/Rejected)の結論を記録する、より正式なレビュー プロセス。Completed ステータスは、その設計が次の開発段階へ引き渡す準備が整っていることを示します。
  • Milestone Review – 提出者がレビュー フィードバックを使用して、ステータスを Completed、Rejected、または設計を修正すべきか(Reworked)を判断する、より精緻なクローズドループ型レビュー プロセス。後者の場合、修正された設計がその後検証され、Completed/Rejected/Rework の判断が繰り返されます。目標またはプロジェクトのマイルストーンが正常に達成された時点で、レビューは終了します。

上記のすべてのケースで、レビューの提出者/承認者(Initiator)とレビュアー(Assignees)の両方が、一連のユーザーインターフェースフォームによってプロセスフローを進めるよう案内されます。各プロセスフローステップの要件とオプションは、 Workspace 内の対応する Process エントリによって決定され、それはサーバー管理者によって管理されます。サーバー管理者はレビュー プロセスの開始とキャンセルの両方を行うこともできます。

レビューの開始者は、 Workspace の Web Viewer Activities ページ(Altium 365 WorkspaceEnterprise Server Workspace)からレビュー プロセスを呼び出すこともでき、割り当てられたレビュアーは Workspace の Tasks ページ(Altium 365 WorkspaceEnterprise Server Workspace)から自分の担当部分を完了できる点に注意してください。

レビューの実行

レビューは通常、次の3つの連続した段階で構成されます。

  1. レビューを開始するユーザー(提出者)が、何を誰がレビューするかを定義し、必要となるデータや情報を追加します。
  2. レビュアーがプロジェクトデータにアクセスして適切なフィードバックを提供し、必要に応じて関連するデータや情報を追加します。
  3. レビュー承認者(通常は開始者)が、レビュアーからのフィードバックを評価して要約し、プロセスを終了します。

レビューのすべての段階は、ソフトウェアの Tasklist パネル内の対応する Task(Altium 365 WorkspaceEnterprise Server Workspace)として表され、各ユーザーに対応が必要であることを通知し、完了済みタスクの情報も提供します。保留中の Task を選択すると、そのレビュー段階がアクティブになります。

レビューの開始と定義

Workspace プロジェクトのレビュー プロセスを開始するには、 Projects パネル内のそのエントリを右クリックし、コンテキストメニューの  Project Activities サブメニューからコマンドを選択します。あるいは、現在アクティブなプロジェクトのレビュー プロセスを開始するには、 Project メインメニュー内の  Project Activities サブメニューを使用します。

Ad Hoc Review プロセスを例に取ると、デフォルトの未変更形式では、最初のフォームダイアログで提出者(以下の例では Barry)が、レビュー対象のプロジェクトと、レビュー フィードバック段階を完了するよう割り当てるユーザーを指定できます。

Ad Hoc Review ダイアログの入力フィールドとメニューは次のとおりです。

  • Request title – デフォルトの AUTO モードでは、アクティブプロセス名(Activity タイトル)のベースとしてプロセス名が採用されます。代わりにカスタム名を入力することもできます。
  • Project – レビュー対象となるプロジェクトの名前。プロセス開始時にはアクティブなプロジェクトが設定されますが、入力に応じて候補が絞り込まれるドロップダウンメニューから利用可能な任意のプロジェクトを選択できます。
  • Description – レビュアーに追加情報を提供するためのテキスト。
  • Reviewers – レビュー フィードバック提出タスクを割り当てる、指定されたチームメンバーまたはロールグループ。入力を開始すると、利用可能なエントリが表示されます。

ボタンをクリックしてプロセスワークフローを開始し、データ定義フォームへ進みます。

続いて表示される Prepare review data フォームダイアログでは、特定の設計データリソースを指定し、添付ファイルを追加できます。青色で強調表示されたフォームテキストは、そのソースデータへのアクティブリンクである点に注意してください。このダイアログには、Diagram タブの下にプロセスの説明付きフローダイアグラムも含まれており、フローステップ内での現在位置も示されます。

このフォームダイアログの主なオプションは次のとおりです。

  • Data – ドロップダウンメニューを使用して特定のプロジェクトリリース データセット(日付別)を選択するか、関連する オプションを使用して参照し、特定のリリースデータセットを選択します。デフォルト状態でデータが選択されていない場合、レビュアーはプロジェクトのソースデータのみにアクセスできます。
  • Attachments – レビュー用データまたは情報ソースとして追加したいファイルを参照()するか、ドラッグアンドドロップします。
上記のレビュー提出段階では、Altium Designer の Tasklist パネルに、あなたに割り当てられたアクティブな Task(Prepare review data)として表示されます。この段階が中断され、現在のフォームダイアログが閉じられた場合は、その Task をクリックしてフォームを再度開き、続行してください。

すべてのレビュー データを指定またはフォームに追加したら、 ボタンをクリックしてプロセスを Review 段階へ進めます。

この時点で、レビュー提出段階は完了しているため、アクティブな Prepare review data Task は Tasklist パネルでクローズされます。なお、この時点での Altium Designer ユーザーはレビュー プロセスの提出者(Initiator)です。進行中のレビュー プロセスは、パネルの Activities 一覧にアクティブステータスで表示されます。最新の Activities ステータスを表示するには、 ボタンをクリックしてください。

アクティブなレビュー プロセスの進行状況を表示するには、Activities リストでそのエントリを選択し、現在のデータと注釈付きフローダイアグラム(Diagram タブ)を表示します。

レビュー フィードバックの提供

レビュー プロセスが Initiator によって構成および提出されると、そのアクティビティは、Reviewers として指定されたユーザーが完了すべき Task を自動的に生成します。その後、レビュアー(この例では Norm Smith)が Altium Designer にサインインすると、Tasks 領域に割り当て済みの Provide review feedback タスクが表示されます。

この Task を選択すると、レビュアー向けにプロセスフローの Review 段階がアクティブになります。続いて表示される Provide review feedback フォームダイアログでは、関連するプロジェクトデータ(レビュー提出者が指定したもの)が提供され、コメントやファイル添付を追加したり、Web Viewer()でプロジェクトを開いたりできるほか、フィードバック Vote の提出が求められます。

Provide Review feedback ダイアログの主なオプションは次のとおりです。

  • Open Project – 選択すると、Workspace Web Viewer でプロジェクト設計を開きます。これにより、豊富なプロジェクトデータと、完全にレンダリングされた設計ソースドキュメントの対話型ビューが提供され、強調表示付きコメントを追加したり、必要に応じて特定のユーザー(Workspace メンバー)に割り当てたりできます。

    詳細については、Web Viewer ページ(Altium 365 WorkspaceEnterprise Server Workspace)を参照してください。

  • Comment – ここに含めたコメントメモは、レビュー プロセスが確定した際に、そのレビュアー名に紐づけられます。

  • Vote – レビュー結論の適切な要約を選択します。

  • Reviewers attachments – レビュー フィードバックに含める、より詳細なメモや参照ドキュメントなどのファイルを参照()するか、ドラッグアンドドロップします。

青色で強調表示されたテキストは、そのソースデータへのアクティブリンクである点に注意してください。 ボタンを選択するとレビュー プロセスが完了します。これは Tasklist パネルで示され、そのアクティブタスクはクローズ(削除)されます。

ここで示されているフォームダイアログのオプションと要件は、レビュー プロセスがどのように動作し、どのように構築されるかの一例にすぎません。接続された Workspace で定義される Altium Designer のプロセスワークフローは非常に柔軟であり、Altium Designer で利用可能な、非常に精巧なプロセスアクティビティを作成するために使用できます。

レビューの要約と終了

指定されたすべてのレビュアーが、自分に割り当てられたレビュー フィードバックタスクを完了すると、アクティブな Review プロセスは要約/終了段階に進みます。レビュー アクティビティを評価するよう割り当てられたユーザー向けに Summarize review タスクが生成されます。この場合は、レビューを提出(開始)したのと同じユーザーである Barry です。このユーザーについては、レビュー プロセスが Tasklist パネルの Activities の下にアクティブ状態で表示される点に注意してください。レビュアーにとっては、自分の貢献タスクが完了しているため、そのアクティビティはこの時点でクローズされています。

レビュー プロセスは、要約/終了段階へ進む前にそのロール内の全ユーザーがタスクを完了することを要求する代わりに、ロールグループ(たとえば Engineers)の中で最初にフィードバックタスクを完了したレビュアーを受け入れるよう構成することもできます。

Summarize review タスクを Tasklist パネルで選択すると、レビュー フローは最終段階に進み、Summarize review フォームダイアログが表示されます。

このフォームの主な内容は次のとおりです。

  • Information provided by reviewers

    • Comment – レビュアーがレビュー Task を完了した際に提供したコメントの一覧。

    • Vote – 各レビュアーが選択したレビュー結論の評価。

    • Review attachments – レビュアーが Task に追加した関連ファイル。

  • Summary

    • Summary note – レビューを終了する際に記録される、レビュー プロセス評価者(この場合は提出者/開始者)が追加する結論メモ。

ダイアログの ボタンをクリックすると、アクティブな Design Review プロセスが終了します。より高度な Design Review processes では、評価段階において、完了/却下の結論を指定したり、設計の Rework タスクを開始したりする追加ステップが含まれる点に注意してください。

完了した Design Review を確認するには、Tasklist パネルの Activities エントリを更新し()、 メニューで Show Closed オプションをチェックして、一覧からクローズ済みタスクを選択します。続いて表示されるダイアログには、レビュー情報の要約(Data タブ)と、進行状態が強調表示されたプロセスフローダイアグラム(Diagram タブ)が含まれており、その状態は予想どおり Completed です。

カスタム レビュー プロセス

最終的に Altium Designer 内でユーザーに提示される Design Review プロセスは、接続された Workspace で指定された管理者によって開発および編集されます。Design Review プロセスワークフローを構成するフローステップ要素と UI フォームの柔軟性により、幅広い特定のニーズを満たすレビューを作成できます。

ステップやフォームに適用できる追加オプションには、次のようなものがあります。

  • フロー内の任意のステップを、レビュアーや評価者として指定されたユーザー以外の特定のユーザーまたはロールに割り当てる。

  • 特定のワークフローステップ(Exception)へのアクセスを特定のユーザーまたはロールに対して拒否し、そのユーザー/ロールについてはフロー内でそのステップをスキップさせる。

  • フォームダイアログを送信する前に、フォームフィールドへの入力を必須にする。

  • 追加のタスクやユーザーフォームを課す中間ワークフローステップを追加する。

  • 特定のアクションのみがそのループを終了できるようなワークフロー決定ループを形成する。

  • ワークフローステップの UI フォームで、特定のデータやイベント/エラーメッセージを表示または非表示にする。

  • Workspace の Web Viewer 機能を使用して、設計ソースドキュメントに直接アクセスできないレビュアーにも設計ドキュメントの確認とコメントを可能にする。

Workspace 管理者は、プロセスの開始、アクティブなプロセスの終了、アクティブおよびクローズ済みのユーザー Task の表示を行える点に注意してください。

前述のとおり、レビュー プロセスはいくつでも作成して Altium Designer で利用可能にでき、同僚からの非公式なフィードバック入力レベルから、他の社内システム(PLM など)へ連携する会社承認済みの正式なレビュー プロセスまで、さまざまなレビュー レベル向けに開発できます。

カスタムプロセスの作成に関する詳細情報については、Defining a Process Workflow (Altium 365 WorkspaceEnterprise Server Workspace)を参照してください。

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
機能の提供状況

ご利用可能な機能は、お使いのAltiumソリューション(Altium DevelopAltium Agile TeamsAltium Agile Enterprise、または有効な契約期間中のAltium Designer)によって異なります。

実際にお使いのソフトウェアに文書化されている機能が表示されない場合は、詳細についてAltium Sales までお問い合わせください。

従来のドキュメント

Altium Designer のドキュメントは、バージョンごとに掲載されなくなりました。Altium Designer の旧バージョンのドキュメントは、Other Installers ページの Legacy Documentation の項目をご覧ください。

Content