プロジェクト履歴
Altium Designer は、接続された Workspace と連携することで、高度にグラフィカルな Project Historyタイムライン を表示し、操作できます。専用の Historyビューでは、PCB、マルチボード、またはハーネス プロジェクトに関連する主要イベント(作成、コミット、リリース、コピー、MCAD 交換)の時系列が段階的に表示され、該当する場合にはさまざまな操作もサポートされます。
Project History へのアクセス
Altium Designer 内から Workspace プロジェクトの Historyビューにアクセスするには、Projectsパネル内の対象プロジェクトのエントリを右クリックし、コンテキスト メニューから History & Version Contol » Show Project History コマンドを選択します。あるいは、History & Version Control » Show Project History コマンドを Project メイン メニューから選択して、アクティブな Workspace プロジェクトの History ビューを開くこともできます。History ビューは独立したタブ付きドキュメントとして表示されます(<ProjectName>.PrjPcb History)。
履歴タイムライン – 概要
History ビューには、プロジェクトの進展の中で発生した基本的なイベントのタイムラインが表示されます。基本的には次の画像と説明に示す 3 つの主要セクションに分けられます。
History ビューを構成する 3 つの主要コンポーネント。
- Main trunk of the timeline。イベントの時系列は下から上の方向です。最初のイベント、つまりプロジェクトの作成はタイムラインの最下部に表示されます。その後のイベントはその上に表示され、最新のイベント(現在の最新イベント)がタイムラインの最上部に表示されます。
- Events。サポート対象イベント(後述)がプロジェクトに関連して発生するたびに、そのイベントは専用のタイルとしてタイムラインに追加されます。イベントの種類ごとにタイルの色が異なり、タイムラインのメイン幹線に直接接続されるか、またはその横に追加アイコンが表示されます(MCAD Exchange イベントの場合など)。
-
Search。ビュー右上の
コントロールをクリックすると、プロジェクト履歴の基本検索を行うための検索フィールドにアクセスできます。検索文字列を入力すると、それに関連するイベントのみが表示されるようタイムラインにフィルタリングが適用されます。詳細は Filtered Searching を参照してください。
サポートされるイベント
タイムラインには、プロジェクトのライフサイクルの中で発生するイベントの推移が表示されます。各イベントは、タイムライン上で専用の「イベント タイル」として表示されます。以下の展開可能セクションでは、現在サポートされており、プロジェクトの履歴タイムラインの一部として表示可能なイベントの種類について説明します。
Project Creation
Refer to: Creating a Project、Making an Existing Project Available Online
プロジェクトが作成されると、Project Createdイベント タイルがタイムラインに追加されます。このイベントは、そのプロジェクトの履歴タイムラインの開始を示します。そのため、常にタイムラインの最下部のエントリとして表示されます。このイベントのタイルは、次の 2 つのパターンで表示されます。
- Workspace 内で新規にプロジェクトが作成された場合。プロジェクト作成者の名前(および画像)と、プロジェクトの作成日時が表示されます。作成時に説明が入力されていれば、その説明もタイル内に表示されます。
- 既存プロジェクトのコピーとして作成された場合。コピーされたプロジェクトを作成した人の名前と、プロジェクトの作成日時が表示されます。コピー時に説明が入力されていれば、その説明もタイル内に表示されます。元のプロジェクトへのリンクも表示され、それをクリックすると Workspace のブラウザー インターフェースでそのプロジェクトの詳細管理ページにアクセスできます。
Project Commit
プロジェクトを Workspace に Commit するたびに(プロジェクトが Workspace 内部の Versioned Storage Git リポジトリで管理されている場合)、Project Committedイベント タイルがタイムラインに追加されます。コミット(Save to Server)を実行した人の名前(および画像)と日時が表示されます。コミット時にコメントが追加され、Commit to Version Control dialog を使用してプッシュされた場合は、そのコメントもタイル内に表示されます。
初期 Project Committedイベント タイルの例。
このタイルは設計差分情報にも対応しており、現在のコミットと前回のコミットの間で何が変更されたかをより詳細に表示します。サポートされる要素には、ファイル、コンポーネント、ネット、バリアント、PCB 構造が含まれます。タイルの差分セクションでは、コミット イベントの影響を受けた各要素が、次の状態ごとにグループ化されて要約表示されます。
– 要素が追加された。
– 要素が削除された。
– 要素が変更された。
タイル内の
コントロールをクリックすると、この差分セクションが展開され、影響を受けた要素が名前付きで表示されます。
タイル右上の
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。
-
Download Sources - u特定の PCB またはハーネス プロジェクト リビジョンをダウンロードして Projects パネルで開くために使用します。プロジェクト名には、そのリビジョンがコミットされた日時が含まれます。このリビジョンは読み取り専用であり、表示はできますが編集はできません。

プロジェクトの任意の特定リビジョンを、対応するそのリビジョンの Project Committedイベント タイルから直接開くことができます(表示専用)。 -
Compare: Schematic to、PCB to、BOM to – このコミット内の PCB プロジェクトの回路図、PCB、または BOM データを、別のコミットまたはリリース イベントのデータと比較できます。サブメニューを使用して前回のコミットと比較するか、利用可能なすべてのリリースおよびコミットから選択します。比較対象のデータを選択すると、比較結果が関連する差分ビューに表示され、そのビューは既定のブラウザーで新しいタブとして開きます。詳細は Design Data Comparisons (Altium 365 Workspace、Enterprise Server Workspace)を参照してください。
-
Create Tag – 設計プロジェクトの任意のコミットに、カスタム名を持つ単一のタグを追加します(この機能は、そのプロジェクトが 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 – このコマンドを使用して、その特定リビジョンのプロジェクト データに戻します。その特定リビジョンのプロジェクト ソース ドキュメントのデータが、ローカル作業コピー内のデータを上書きします。実質的には、プロジェクトは一時的に閉じられ、その後、そのロールバックされたデータで再度開かれます。ロールバックを確定し、そのデータを Head Revision(現行バージョン)にしたい場合は、プロジェクトをコミットして Workspace に再度プッシュする必要があります。
プロジェクトの任意の特定リビジョンに、対応するそのリビジョンの Project Committedイベント タイルから直接戻すことができます。
Project Release
Related page: Design Project Release
PCB プロジェクトのリリースを Altium Designer の Project Releaser を使用して実行するたびに、Project Releasedイベント タイルがタイムラインに追加されます。リリースを実行した人の名前(および画像)と日時が表示されます。生成データを Workspace にリリースする際、Confirm Release dialog を通じてリリース ノートが追加されていた場合は、それもタイル内に表示されます。リリースに含まれる各データ セットも一覧表示されます。
タイル右上の
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。
- 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)を参照してください。
Copying a Project
Workspace のブラウザー インターフェース経由、または Altium Designer 内からプロジェクトをコピーするたびに、Project Copiedイベント タイルがタイムラインに追加されます。コピーを実行した人の名前、画像、日時が表示されます。Clone Projectウィンドウ(ブラウザーベース)または Create Project Copy ダイアログ(Altium Designer)でコピー時に説明が追加されていた場合は、それもタイル内に表示されます。コピー先プロジェクトへのリンクも表示され、それをクリックすると Workspace のブラウザー インターフェースでそのプロジェクトの詳細管理ページにアクセスできます。
Project Copiedイベント タイルの例。
MCAD Exchanges
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で利用可能になります。
2つのMCAD関連イベントを示す例です。タイムラインの幹の左側がECAD側からのプッシュイベント、右側がMCAD側からのプッシュイベントです。
Local Changes
PCBプロジェクトドキュメントがローカルには保存されているものの、まだWorkspaceには保存されていない場合、タイムラインの最上部にLocal Changesイベントタイルが追加されます。ローカル保存を実行した人物(つまり現在のユーザー)が名前(および画像)付きで表示されます。

Local Changesイベントタイルの例。
タイル右上の
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます:
- Compare: Schematic to, PCB to, BOM to – このコミット内でローカル保存されたSchematic、PCB、またはBOMデータを、コミットイベントまたはリリースイベントのデータと比較できます。サブメニューを使用して、前回のリリースのソースデータ、前回のコミットのソースデータ、または利用可能なすべてのリリースとコミットから選択して比較します。比較対象のデータを選択すると、比較結果は関連する差分ビューに表示され、そのビューはデフォルトのブラウザで新しいタブとして開きます。詳細はDesign Data Comparisonsをご覧ください(Altium 365 Workspace、Enterprise Server Workspace)。
絞り込み検索
ビュー右上の
コントロールをクリックすると検索フィールドが表示され、タイムライン上で目的のイベントをすばやく見つけることができます。この検索機能はプロジェクト履歴の基本検索に対応しており、検索文字列を入力するたびに動的にフィルタリングが適用され、検索に関連するイベントのみがページ上に表示されます。イベントタイル内の一致テキストは強調表示されます。
プロジェクト履歴の検索例です。検索語(大文字小文字を区別しない)を入力するとタイムラインが動的にフィルタリングされ、該当する各イベントタイル内で一致エントリが強調表示されます。
検索機能は次の情報を対象に動作します:
- イベントタイルのタイトル。
- イベントを実行した人物の名前。
- 説明テキスト(関連イベント発生時のコメント/メモ/説明に由来するテキスト)。
- 差分データのテキスト – Project Committedイベントタイル内。
- データセット名 – Project Releasedイベントタイル内。
- プロジェクト名 – Project CopiedイベントタイルおよびProject Createdイベントタイル内(コピーによって作成された場合)。
新しいイベントで更新
プロジェクトに関連してサポート対象のイベントが発生すると、そのイベントは自動的に検出され、History ビューで利用できるようになります。イベント発生直後にビュー下部へ通知が表示されるので、
コントロールをクリックしてタイムラインを新しいイベントで更新します。
プロジェクト履歴レポートの作成
WorkspaceプロジェクトのProject HistoryレポートをPDF形式で作成できます。このレポートには、作成、コミット、リリースを含むプロジェクト履歴に関するすべての情報に加え、前回イベントからの変更内容の説明も表示されます。また、レポートの期間(以下で説明)を設定できるため、必要な確定版レポートを取得できます。
OutJobから
レポートを作成するには、OutputJobファイル(*.OutJob)で、[Add New Report Output]に関連付けられたReport Outputsエントリを右クリックし、Project Historyを選択します。以下に示すとおりです。
新しく作成したレポートをPDF出力コンテナに接続します。作成した出力を右クリックしてConfigureを選択し、レポートの期間を設定します。必要な時間Periodを有効にします: For all time(プロジェクト作成時から現在まで)またはSpecific releases(From/Toフィールドのドロップダウンを使用して目的のリリースを設定)。エクスポートされたレポートには、選択した期間の情報が含まれます。
レポートを作成し、PDF出力コンテナにリンクして設定したら、PDFコンテナ領域でGenerate content,をクリックします。必要に応じて、project releaseプロセスの一部としてプロジェクト履歴レポートを生成することもできます。


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


