プロジェクト履歴
概略
- プロジェクトやファイルの履歴を開き、イベント間を移動し、検索でタイムラインを絞り込む方法を学びます。
- Project History拡張機能やWorkspaceネイティブのGitバージョン管理など、必要なセットアップ要件を確認します。
- コミットの変更内容の確認、読み取り専用でのリビジョンの表示、回路図・PCB・BOMデータの比較、コミットタグの管理方法をご紹介します。
Altium Designerでは、接続されたWorkspaceと連携することで、高度なグラフィカル表示のProject Historyタイムラインを表示し、操作できます。専用のHistoryビューには、PCB、マルチボード またはハーネスプロジェクトに関連する主要なイベント(作成、コミット、リリース、コピー、MCAD交換)が時系列で表示され、該当する場合はさまざまな操作を実行できます。
プロジェクト履歴へのアクセス
Altium Designer内からWorkspaceプロジェクトのHistoryビューにアクセスするには、Projectsパネルでプロジェクトのエントリを右クリックし、コンテキストメニューからHistory & Version Contol » Show Project History コマンドを選択します。または、 Project メインメニューから History & Version Control » Show Project History コマンドを選択して、アクティブなWorkspaceプロジェクトの履歴ビューを開くこともできます。History ビューは、独立したタブ付きドキュメント(<ProjectName>.PrjPcb History)として表示されます。
履歴タイムラインの概要
History ビューには、プロジェクトの進行中に発生した基本的なイベントがタイムラインで表示されます。このビューは、次の画像と説明に示すように、大きく3つの主要なセクションに分けられます。
- Main trunk of the timeline。イベントは下から上へ時系列順に並びます。最初のイベントであるプロジェクトの作成は、タイムラインの最下部に表示されます。それ以降のイベントは上に追加され、最新のイベントがタイムラインの最上部に表示されます。
- Events。プロジェクトに関連してサポート対象のイベント(下記参照)が発生するたびに、そのイベントが専用のタイルとしてタイムラインに追加されます。イベントの種類ごとにタイルの色が異なり、タイムラインの主軸に直接接続されるか、タイルの横に追加のアイコンが表示されます(MCAD交換イベントの場合など)。
-
Search。ビューの右上にある
コントロールをクリックすると、プロジェクト履歴を簡易検索できる検索フィールドが表示されます。検索文字列を入力すると、タイムラインにフィルターが適用され、検索に関連するイベントのみが表示されます。詳細については、フィルター検索を参照してください。
サポートされるイベント
タイムラインには、プロジェクトのライフサイクル中に発生するイベントが順に表示されます。各イベントは、専用の「イベントタイル」としてタイムライン上に表示されます。以下の折りたたみ可能なセクションでは、現在サポートされ、プロジェクトの履歴タイムラインに表示できる各種イベントについて説明します。
プロジェクトの作成
Refer to: プロジェクトの作成、既存のプロジェクトをオンラインで利用可能にする
プロジェクトが作成されると、Project Createdイベントタイルがタイムラインに追加されます。このイベントが、プロジェクトの履歴タイムラインの起点となります。そのため、常にタイムラインの最下部のエントリとして表示されます。このイベントのタイルには、次の2つの表示形式があります。
- Workspace内でプロジェクトが新規作成された場合。プロジェクトの作成者の名前(および写真)が、プロジェクトの作成日時とともに表示されます。作成時にプロジェクトの説明が入力されていた場合は、その説明もタイル内に表示されます。
- 既存のプロジェクトをコピーして作成した場合。コピーしたプロジェクトの作成者の名前が、プロジェクトの作成日時とともに表示されます。コピー時にプロジェクトの説明が入力されていた場合は、その説明もタイル内に表示されます。元のプロジェクトへのリンクも表示されます。このリンクをクリックすると、Workspaceのブラウザーインターフェースで元のプロジェクトの詳細管理ページが開きます。
プロジェクトのコミット
プロジェクトをWorkspaceにコミットするたびに(プロジェクトがWorkspace内部のVersioned Storage Gitリポジトリで管理されている場合)、Project Committedイベントタイルがタイムラインに追加されます。コミット(サーバーへの保存)を実行したユーザーの名前(および写真)が、日時とともに表示されます。Commit to Version Controlダイアログでコミット時にコメントを追加してプッシュした場合は、そのコメントもタイル内に表示されます。
最初のProject Committedイベントタイルの例。
タイルは設計の差分情報の表示にも対応しており、現在のコミットと前回のコミットの間で何が変更されたかを詳しく確認できます。対応する要素には、ファイル、コンポーネント、ネット、バリアント、PCB構造が含まれます。タイルの差分セクションには、コミットイベントの影響を受けた各要素が、次の状態別にまとめて表示されます。
– 追加された要素。
– 削除された要素。
– 変更された要素。
タイル内の
コントロールをクリックすると、この差分セクションが展開され、影響を受けた要素の名前が表示されます。
タイルの右上隅にある
コントロールをクリックすると、次のコマンドを含むメニューが表示されます。
-
Download Sources - uPCBプロジェクトまたはハーネスプロジェクトの該当リビジョンをダウンロードし、Projectsパネルで開きます。プロジェクト名には、そのリビジョンがコミットされた日時が含まれます。このリビジョンは読み取り専用であり、表示はできますが編集はできません。

プロジェクトの任意のリビジョンを、そのリビジョンに対応するProject Committedイベントタイルから直接開くことができます(表示のみ)。 -
Compare: Schematic to、PCB to、BOM to – このコミットに含まれるPCBプロジェクトの回路図、PCB またはBOM データを、別のコミットまたはリリースイベントのデータと比較できます。サブメニューを使用して前回のコミットと比較するか、すべてのリリースとコミットの候補から選択します。比較対象のデータを選択すると、既定のブラウザーの新しいタブで対応する差分ビューが開き、比較結果が表示されます。詳細については、Design Data Comparisons (Altium 365 Workspace、Enterprise Server Workspace)を参照してください。
-
Create Tag – 設計プロジェクトの任意のコミットに、任意の名前のタグを1つ追加します(プロジェクトがWorkspace内部のGit VCSシステムに保存されている場合のみ)。 タグを作成できるのは、Workspaceにすでに保存されているコミットのみです。 コマンドを実行すると、 Create Tag ダイアログが開きます。目的のタグを入力し、 Createをクリックします。
使用できない文字を含むタグを入力すると、Create Tagダイアログに
アイコンが表示されます。アイコンにカーソルを合わせると、使用可能な文字(英字、数字、ドット('.')、ハイフン('-')、番号記号('#')、アンダースコア('_'))のヒントが表示されます。必要に応じてタグを修正してください。
Project Releaser を使用してプロジェクトをリリースする際、最新のコミットにまだタグがない場合は、そのコミットにタグが自動的に割り当てられます。このタグの形式は RELEASE_<RevisionID>で、 <RevisionID> はリリースされたプロジェクトソースのリビジョン番号(A.1、 A.2など)です。たとえば、 RELEASE_A.3のようになります。
タグの名前を変更または削除するには、
をクリックし、Tag の項目にカーソルを合わせます。ダイアログが開き、タグの新しい名前を入力できます。Remove を選択すると、タグは直ちに削除されます。
- コピーを作成 – プロジェクトの該当リビジョンからコピーを作成します。Create Project Copy ダイアログが開くので、 Project Name (既定では、元のプロジェクト名に接尾辞「 - Copy」を付けた名前)、 Description (初期値なし)、 Folder パス(Workspace内)、および Local Storage パス(作業コピーの保存先)を入力します。プロジェクトが作成され、Project Copiedイベントタイルがタイムラインに追加されます。
-
Revert to – このコマンドを使用すると、プロジェクトの指定したリビジョンのデータに戻すことができます。そのリビジョンのプロジェクトソースドキュメントのデータによって、プロジェクトのローカル作業コピーのデータが上書きされます。実際には、プロジェクトが一時的に閉じられ、元に戻したデータで再び開かれます。復元を完了し、そのデータをヘッドリビジョン(現在のバージョン)にするには、プロジェクトをコミットして Workspace にプッシュする必要があります。
各リビジョンに対応する Project Committed イベントタイルから、プロジェクトの任意のリビジョンに直接戻すことができます。
プロジェクトのリリース
Related page: 設計プロジェクトのリリース
Altium Designer の Project Releaser を使用して PCB プロジェクトをリリースするたびに、Project Released イベントタイルがタイムラインに追加されます。リリースを実行したユーザーの名前(および写真)が、日時とともに表示されます。生成されたデータを Confirm Release ダイアログから Workspace にリリースする際にリリースノートを追加した場合は、その内容もタイル内に表示されます。また、リリースに含まれる各データセットも一覧表示されます。
タイルの右上隅にある
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。
- Download Sources – このコマンドを使用すると、このリリースパッケージの生成元となったプロジェクトの特定のリビジョンをダウンロードし、Projects パネルで開くことができます。プロジェクト名にはリリースバージョンが含まれます。このリビジョンは読み取り専用です。閲覧はできますが、編集することはできません。
- Compare: Schematic to, PCB to, Gerber to, BOM to – このリリースの回路図、PCB、または BOM データを、別のリリースまたはコミットイベントのデータと比較できます。生成された Gerber については、このリリースのデータを別のリリースのデータと比較できます。また、Altium 365 Workspace を使用している場合は、アップロードされた Gerber ファイルセットとも比較できます。サブメニューを使用して、比較対象のデータセットを選択します。 比較するデータを選択すると、デフォルトのブラウザーの新しいタブに対応する差分ビューが開き、比較結果が表示されます。詳細については、Design Data Comparisons (Altium 365 Workspace、Enterprise Server Workspace)を参照してください。
プロジェクトのコピー
Workspace のブラウザーインターフェースまたは Altium Designer からプロジェクトをコピーするたびに、Project Copied イベントタイルがタイムラインに追加されます。コピーを実行したユーザーの名前と写真、実行日時が表示されます。Clone Project ウィンドウ(ブラウザーベース)または Create Project Copy ダイアログ(Altium Designer)からコピーする際に説明を追加した場合は、その内容もタイル内に表示されます。コピー先のプロジェクトへのリンクも表示されます。このリンクをクリックすると、Workspace のブラウザーインターフェースから、そのプロジェクトの詳細管理ページにアクセスできます。
Project Copied イベントタイルの例。
MCAD とのデータ交換
Related page: Altium MCAD CoDesigner
電子設計と機械設計の領域をまたいで作業する際、Workspace は両者をつなぐ橋渡し役として機能し、ECAD と MCAD の直接的な協調設計を促進します。プロジェクトの PCB 設計に変更を加え、対応する CoDesigner パネルからその変更を Workspace にプッシュするたびに、MCAD Changes Suggested イベントタイルがタイムラインに追加されます。プッシュを実行したユーザーの名前(および写真)が、日時とともに表示されます。MCAD CoDesigner パネル(Altium Designer)または Altium CoDesigner パネル(対応する MCAD ソフトウェア内)からプッシュする際にメッセージを投稿した場合は、その内容もタイル内に表示されます。
MCAD Changes Suggested イベントタイルの例。
MCAD エンジニアが対応する MCAD ソフトウェアで PCB に変更を加え、Workspace にプッシュすると、Workspace から Altium Designer にその変更をプルした後、対応するプッシュイベントがプロジェクトの履歴タイムライン only に表示されます。
MCAD に関連する 2 つのイベントの表示例。タイムラインの主軸の左側には ECAD 側からのプッシュイベント、右側には MCAD 側からのプッシュイベントが表示されています。
ローカルの変更
ローカルには保存されているものの、Workspaceにはまだ保存されていないPCBプロジェクトドキュメントがある場合、タイムラインの一番上にLocal Changesイベントタイルが追加されます。ローカル保存を実行したユーザー(つまり現在のユーザー)の名前と画像が表示されます。

Local Changesイベントタイルの例。
タイルの右上隅にある
コントロールをクリックすると、次のコマンドを含むメニューが表示されます。
- Compare: Schematic to、PCB to、BOM to – このコミットでローカルに保存された回路図、PCB、またはBOMのデータを、コミットイベントまたはリリースイベントのデータと比較できます。サブメニューを使用して、前回のリリースのソースデータや前回のコミットのソースデータと比較するか、すべてのリリースとコミットから比較対象を選択します。比較するデータを選択すると、デフォルトのブラウザーの新しいタブで対応する差分ビューが開き、比較結果が表示されます。詳細については、Design Data Comparisons(Altium 365 Workspace、Enterprise Server Workspace)を参照してください。
検索による絞り込み
ビューの右上にある
コントロールをクリックすると、検索フィールドが表示され、タイムライン上の目的のイベントをすばやく見つけることができます。検索機能ではプロジェクト履歴の基本的な検索が可能で、検索文字列を入力するたびに動的に絞り込まれ、検索に関連するイベントだけがページに表示されます。イベントタイル内の一致するテキストは強調表示されます。
プロジェクト履歴の検索例。検索語句を入力すると(大文字と小文字は区別されません)、タイムラインが動的に絞り込まれ、該当する各イベントタイル内で一致する項目が強調表示されます。
検索機能では、次の情報が検索対象になります。
- イベントタイルのタイトル。
- イベントを実行したユーザーの名前。
- 説明文(該当するイベントの発生時に入力されたコメント、メモ、説明に由来するテキスト)。
- 差分データのテキスト – Project Committedイベントタイル内。
- データセット名 – Project Releasedイベントタイル内。
- プロジェクト名 – Project CopiedイベントタイルおよびProject Createdイベントタイル内(コピーによって作成された場合)。
新しいイベントの反映
プロジェクトに関連してサポート対象のイベントが発生すると、そのイベントが検出され、自動的に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,をクリックします。また、必要に応じて、プロジェクトのリリースプロセスの一部としてプロジェクト履歴レポートを生成することもできます。



をクリックして Choose Folder ダイアログ(Explorer パネルの簡易版)を開き、必要に応じてフォルダーを変更します。Local Storage は、デフォルトでは Preferences ダイアログの 


