プロジェクト履歴
Altium Designer は、connected Workspace と連携することで、高度にグラフィカルな Project History タイムラインを表示し、操作できます。専用の History ビューでは、PCB、マルチボード またはハーネス プロジェクトに関連する主要イベント――作成、コミット、リリース、コピー、MCAD 交換――を時系列で確認でき、該当する場合は各種アクションも実行できます。
プロジェクト履歴へのアクセス
Altium Designer 内から Workspace プロジェクトの History ビューにアクセスするには、Projects パネル内の対象エントリを右クリックし、コンテキスト メニューから History & Version Contol » Show Project History コマンドを選択します。あるいは、Projects メイン メニューから History & Version Control » Show Project History コマンドを選択して、アクティブな 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: プロジェクトの作成、既存プロジェクトをオンラインで利用可能にする
プロジェクトが作成されると、Project Created イベント タイルがタイムラインに追加されます。このイベントは、そのプロジェクトの履歴タイムラインの開始を示します。そのため、常にタイムラインの最下部のエントリとして表示されます。このイベントのタイルは、次の 2 つの異なる形式で表示されます。
- Workspace 内で新規にプロジェクトが作成された場合。プロジェクト作成者の名前(および画像)と、プロジェクトの作成日時が表示されます。作成時に説明が入力されていれば、その説明もタイル内に表示されます。
- 既存プロジェクトのコピーとして作成された場合。コピーされたプロジェクトを作成した人の名前と、プロジェクトの作成日時が表示されます。コピー時に説明が入力されていれば、その説明もタイル内に表示されます。元のプロジェクトへのリンクも提供され、これをクリックすると Workspace のブラウザー インターフェースを通じてそのプロジェクトの詳細管理ページにアクセスできます。
Project Commit
プロジェクトを Workspace にコミットするたびに(プロジェクトが Workspace 内部の Versioned Storage Git リポジトリで管理されている場合)、Project Committed イベント タイルがタイムラインに追加されます。コミット(Save to Server)を実行した人の名前(および画像)と日時が表示されます。コミット時にコメントが追加され、Commit to Version Control dialog を使用してプッシュされていれば、そのコメントもタイル内に表示されます。
初期 Project Committed イベント タイルの例。
このタイルは設計差分情報にも対応しており、現在のコミットと前回のコミットの間で何が変更されたかをより詳細に表示します。サポートされる要素には、ファイル、コンポーネント、ネット、バリアント、PCB 構造が含まれます。タイルの差分セクションでは、コミット イベントの影響を受けた各種要素が、次の状態ごとにグループ化されて要約表示されます。
– 要素が追加された。
– 要素が削除された。
– 要素が変更された。
タイル内の
コントロールをクリックすると、この差分セクションが展開され、影響を受けた要素が名前付きで表示されます。
タイル右上の
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。
-
Download Sources - uPCB またはハーネス プロジェクトのその特定リビジョンをダウンロードして Projects パネルで開くために使用します。プロジェクト名には、そのリビジョンがコミットされた日時が含まれます。このリビジョンは読み取り専用であり、表示はできますが編集はできません。

プロジェクトの任意の特定リビジョンを、そのリビジョンに対応する Project Committed イベント タイルから直接開くことができます(表示専用)。 -
Compare: Schematic to、PCB to、BOM to – このコミットにおける PCB プロジェクトの Schematic、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 を通じて – リリースノートが追加されていれば、それもタイル内に表示されます。リリースに含まれる各データセットも一覧表示されます。
Project Released イベントタイルの例。
タイル右上の
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます:
- Download Sources – このコマンドを使用すると、このリリースパッケージの生成元となった特定リビジョンのプロジェクトをダウンロードして開くことができます(Projects パネル内)。プロジェクト名にはリリースバージョンが含まれます。このリビジョンは読み取り専用であり、表示はできますが、いかなる編集もできない点に注意してください。
- Compare: Schematic to、PCB to、Gerber to、 BOM to – このリリースの Schematic、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 はその両者をつなぐ橋渡し役となり、direct ECAD-MCAD codesign を実現します。プロジェクトの PCB 設計に変更が加えられ、それらの変更が関連する CoDesigner パネルを通じて Workspace にプッシュされるたびに、MCAD Changes Suggested イベントタイルがタイムラインに追加されます。プッシュを実行した人の名前(および写真)と、日付と時刻が表示されます。プッシュ時に – MCAD CoDesigner パネル(Altium Designer)または Altium CoDesigner パネル(supported MCAD software 内)を通じて – メッセージが投稿されていれば、それもタイル内に表示されます。
例 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 – このコミット内でローカル保存された回路図、PCB、または BOM データを、コミットイベントまたはリリースイベントのデータと比較できます。サブメニューを使用して、前回のリリースのソースデータ、前回のコミットのソースデータと比較するか、利用可能なすべてのリリースおよびコミットから選択できます。比較対象のデータを選択すると、比較結果は関連する差分ビューに表示され、新しいタブとして既定のブラウザーで開きます。詳細については、Design Data Comparisons(Altium 365 Workspace、Enterprise Server Workspace)を参照してください。
フィルター検索
ビュー右上の
コントロールをクリックすると検索フィールドが表示され、タイムライン上で目的のイベントをすばやく見つけることができます。検索機能はプロジェクト履歴の基本検索をサポートしており、検索文字列を入力するにつれて動的にフィルタリングが適用され、その検索に関連するイベントのみがページに表示されます。イベントタイル内の一致テキストはハイライト表示されます。
プロジェクト履歴の検索例。大文字小文字を区別しない検索語を入力すると、タイムラインが動的にフィルタリングされ、各関連イベントタイル内の一致項目がハイライト表示されます。
検索機能は次の情報を対象に動作します。
- イベントタイルのタイトル。
- イベントを実行した人の名前。
- 説明テキスト(該当イベント発生時のコメント/メモ/説明に由来するテキスト)。
- 差分データのテキスト – Project Committed イベントタイル内。
- データセット名 – Project Released イベントタイル内。
- プロジェクト名 – Project Copied イベントタイル内、および Project Created イベントタイル内(コピーによって作成された場合)。
新しいイベントによる更新
プロジェクトに関連して対応イベントが発生すると、そのイベントは検出され、自動的に History ビューで利用可能になります。イベント発生後まもなく、ビューの下部に通知が表示されます。
コントロールをクリックすると、新しいイベントでタイムラインが更新されます。
プロジェクト履歴レポートの作成
Workspace プロジェクト用に PDF 形式の Project History レポートを作成できます。このレポートには、作成、コミット、リリースを含むプロジェクト履歴に関するすべての情報に加え、前のイベントからの変更内容の説明が表示されます。また、レポートの期間(以下で説明)を設定できるため、必要な確定版レポートを取得できます。
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, をクリックします。必要に応じて、project release プロセスの一部としてプロジェクト履歴レポートを生成することもできます。
をクリックすると、Choose Folder ダイアログ(Explorer パネルの簡易版)が開き、必要に応じてフォルダーを変更できます。Local Storage は、既定では Preferences ダイアログの