プロジェクト履歴

概略

Altium DesignerのProject Historyビューを使って、接続先のWorkspaceにあるプロジェクトの変遷を、作成、コミット、リリース、コピー、MCADデータ交換を示すグラフィカルなタイムラインで追跡する方法をご紹介します。この記事では、タイムラインへのアクセスと操作、イベントタイルの見方、コミット操作による変更内容の確認、過去のリビジョンの表示、設計データの比較、タグの管理について説明します。また、コミット履歴にアクセスするうえで、Workspaceネイティブのバージョン管理が重要な理由も解説します。プロジェクトの履歴をより有効に活用するために、ぜひお読みください。

- プロジェクトやファイルの履歴を開き、イベント間を移動し、検索でタイムラインを絞り込む方法を学びます。
- Project History拡張機能やWorkspaceネイティブのGitバージョン管理など、必要なセットアップ要件を確認します。
- コミットの変更内容の確認、読み取り専用でのリビジョンの表示、回路図・PCB・BOMデータの比較、コミットタグの管理方法をご紹介します。
AIでさらに深掘り:

Altium Designerでは、接続されたWorkspaceと連携することで、高度なグラフィカル表示のProject Historyタイムラインを表示し、操作できます。専用のHistoryビューには、PCB、マルチボード またはハーネスプロジェクトに関連する主要なイベント(作成、コミット、リリース、コピー、MCAD交換)が時系列で表示され、該当する場合はさまざまな操作を実行できます。

この機能を最大限に活用するには、プロジェクトをWorkspaceに組み込まれたVCS(Git)の管理下に置き、完全に管理された状態にする必要があります。

プロジェクトが外部のバージョン管理下にある場合は、WorkspaceのネイティブVCSに移行することで、Altium 365 Workspaceでホストされる完全に管理されたプロジェクトに変換できます。詳しい手順については、外部VCSからWorkspaceのネイティブVCSへの移行を参照してください。

WorkspaceのブラウザーインターフェースでプロジェクトのHistoryビューを使用する方法については、プロジェクト履歴を参照してください。

Altium Designerでプロジェクト履歴機能を利用するには、Project History ソフトウェア拡張機能がインストールされている必要があります。 この拡張機能は、デフォルトでAltium Designerとともにインストールされます。 手動でインストールまたは削除することもできます。

拡張機能の管理については、 Extending Your Installation ページ(Altium Designer Develop、Altium Designer Agile、Altium Designer)を参照してください。

プロジェクト履歴へのアクセス

Altium Designer内からWorkspaceプロジェクトのHistoryビューにアクセスするには、Projectsパネルでプロジェクトのエントリを右クリックし、コンテキストメニューからHistory & Version Contol » Show Project History コマンドを選択します。または、 Project メインメニューから History & Version Control » Show Project History コマンドを選択して、アクティブなWorkspaceプロジェクトの履歴ビューを開くこともできます。History ビューは、独立したタブ付きドキュメント(<ProjectName>.PrjPcb History)として表示されます。

プロジェクト履歴機能が導入される前からWorkspaceに存在していたプロジェクトでは、最初は履歴が完全には表示されません。そのプロジェクトのHistory ビューに初めてアクセスすると、イベントデータのインデックスが自動的に再作成されます。インデックスの再作成が完了すると、ビューの下部に通知が表示されます。コントロールをクリックすると、すべての過去のイベントデータがタイムラインに反映されます。
Workspaceプロジェクト内のファイルのHistoryビュー、つまりそのファイルに関連するプロジェクトの主要なイベントのタイムラインにアクセスするには、 Projects パネルでファイルを右クリックし、コンテキストメニューから History & Version Control » Show File History コマンドを選択します。

履歴タイムラインの概要

History ビューには、プロジェクトの進行中に発生した基本的なイベントがタイムラインで表示されます。このビューは、次の画像と説明に示すように、大きく3つの主要なセクションに分けられます。

History ビューの3つの主要な構成要素。History ビューの3つの主要な構成要素。

  1. Main trunk of the timeline。イベントは下から上へ時系列順に並びます。最初のイベントであるプロジェクトの作成は、タイムラインの最下部に表示されます。それ以降のイベントは上に追加され、最新のイベントがタイムラインの最上部に表示されます。
  2. Events。プロジェクトに関連してサポート対象のイベント(下記参照)が発生するたびに、そのイベントが専用のタイルとしてタイムラインに追加されます。イベントの種類ごとにタイルの色が異なり、タイムラインの主軸に直接接続されるか、タイルの横に追加のアイコンが表示されます(MCAD交換イベントの場合など)。
  3. Search。ビューの右上にあるコントロールをクリックすると、プロジェクト履歴を簡易検索できる検索フィールドが表示されます。検索文字列を入力すると、タイムラインにフィルターが適用され、検索に関連するイベントのみが表示されます。詳細については、フィルター検索を参照してください。

サポートされるイベント

タイムラインには、プロジェクトのライフサイクル中に発生するイベントが順に表示されます。各イベントは、専用の「イベントタイル」としてタイムライン上に表示されます。以下の折りたたみ可能なセクションでは、現在サポートされ、プロジェクトの履歴タイムラインに表示できる各種イベントについて説明します。

検索による絞り込み

ビューの右上にあるコントロールをクリックすると、検索フィールドが表示され、タイムライン上の目的のイベントをすばやく見つけることができます。検索機能ではプロジェクト履歴の基本的な検索が可能で、検索文字列を入力するたびに動的に絞り込まれ、検索に関連するイベントだけがページに表示されます。イベントタイル内の一致するテキストは強調表示されます。

検索では大文字と小文字は区別されません。

プロジェクト履歴の検索例。検索語句を入力すると(大文字と小文字は区別されません)、タイムラインが動的に絞り込まれ、該当する各イベントタイル内で一致する項目が強調表示されます。プロジェクト履歴の検索例。検索語句を入力すると(大文字と小文字は区別されません)、タイムラインが動的に絞り込まれ、該当する各イベントタイル内で一致する項目が強調表示されます。

絞り込まれたイベントの上には、現在表示されているイベント数をまとめたボックスが表示されます。このボックスには、フィルターや検索文字列をすばやく解除するためのコントロールもあります。

検索機能では、次の情報が検索対象になります。

  • イベントタイルのタイトル。
  • イベントを実行したユーザーの名前。
  • 説明文(該当するイベントの発生時に入力されたコメント、メモ、説明に由来するテキスト)。
  • 差分データのテキスト – Project Committedイベントタイル内。
  • データセット名 – Project Releasedイベントタイル内。
  • プロジェクト名 – Project CopiedイベントタイルおよびProject Createdイベントタイル内(コピーによって作成された場合)。
現在の絞り込みを解除してタイムライン全体の表示に戻すには、検索フィールドを空にします。現在のテキストを選択してBackspace キーを押すか、フィールドの右端にあるコントロールをクリックしてください。または、表示中のイベント数をまとめたボックス(ビューの上部)にあるClear Filterコントロールをクリックします。

新しいイベントの反映

プロジェクトに関連してサポート対象のイベントが発生すると、そのイベントが検出され、自動的にHistory ビューに反映できるようになります。イベントの発生からしばらくすると、ビューの下部に通知が表示されます。コントロールをクリックして、タイムラインに新しいイベントを反映してください。

ビューの右上にあるコントロールをクリックして、手動で更新することもできます。

プロジェクト履歴レポートの作成

Workspaceプロジェクトでは、PDF形式のプロジェクト履歴レポートを作成できます。レポートには、作成、コミット、リリースなど、プロジェクト履歴に関するすべての情報に加え、前のイベントからの変更内容の説明が表示されます。また、レポートの対象期間を設定することもできるため(後述)、必要な内容を網羅したレポートを取得できます。

OutJobからの作成

レポートを作成するには、OutputJobファイル(*.OutJob)で、Report Outputsエントリに対応する[Add New Report Output]を右クリックし、以下に示すようにProject Historyを選択します。

新しく作成したレポートをPDF出力コンテナーに接続します。レポートの対象期間を設定するには、作成した出力を右クリックし、Configureを選択します。目的の期間のPeriodを有効にします。For all time(プロジェクトの作成から現在まで)、またはSpecific releases(From/Toフィールドのドロップダウンを使用して、目的のリリースを設定)を選択してください。エクスポートされるレポートには、選択した期間の情報が含まれます。

レポートを作成し、PDF出力コンテナーに接続して設定を完了したら、PDFコンテナー領域でGenerate content,をクリックします。また、必要に応じて、プロジェクトのリリースプロセスの一部としてプロジェクト履歴レポートを生成することもできます。

Reportsメニューからの作成

メインメニューからReports » Project Historyを選択すると、プロジェクト履歴をPDFにエクスポートできます。Project History Report Configuration ダイアログが開き、レポートのエクスポート対象となるPeriodを設定できます。プロジェクト履歴全体、または特定の(もしくは最新の)プロジェクトリリースを開始点/終了点とする期間を指定します。Exportをクリックし、開いたExplorerウィンドウでエクスポートするPDFの名前を入力して、Saveをクリックします。PDFレポートがブラウザーで開きます。
AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
Nav
Contents
機能の提供状況

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

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

従来のドキュメント

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

Contents