プロジェクト履歴
Parent page: ワークスペース・プロジェクト
Enterprise Server Workspace は、プロジェクト活動の履歴を専用のインタラクティブな Historyビューとして提供し、プロジェクトの履歴概要を把握したいというニーズに対して洗練されたソリューションを提供します。このプロジェクト History ビューは、ワークスペースのブラウザインターフェースから、または Altium Designer内からアクセスでき、プロジェクトに関連する主要イベントの進行タイムラインを表示します。イベントには、プロジェクトの作成、コミット、リリース、クローン、MCAD 交換が含まれ、該当する場合はイベントのアクションコマンドも提供されます。
プロジェクト履歴へのアクセス
プロジェクトの History ビューへのアクセスは、そのプロジェクトの詳細な CAD 中心の管理ページ、すなわち Projects Managementページから行います。左側ペインの Historyオプションをクリックしてください。
プロジェクトの詳細管理ページから、そのプロジェクトの履歴にアクセスします。
履歴タイムライン – 概要
History ビューは、プロジェクトの進化の過程で発生した基本イベントのタイムラインを提示します。以下の画像と説明に示すように、概ね 3 つの主要要素に分けられます。
History ビューの 3 つの主要コンポーネントを識別。
- Main trunk of the timeline。イベントの時系列は下から上へ進みます。最初のイベント(プロジェクトの作成)はタイムラインの最下部に表示されます。以降のイベントはその上に表示され、最新(最も現在のイベント)がタイムラインの最上部に表示されます。
- Events。プロジェクトに関連してサポート対象のイベント(下記参照)が発生するたびに、専用タイルとしてタイムラインに追加されます。イベントの種類ごとにタイルの色が異なり、タイムラインの主幹に直接リンクされるか、または隣に関連付けアイコンが表示されます(MCAD Exchange イベントの場合など。
)。 - Search。ビュー右上の
コントロールをクリックすると検索フィールドにアクセスでき、プロジェクト履歴の基本検索が行えます。検索文字列を入力すると、その検索に関連するイベントのみが表示されるようタイムラインがフィルタリングされます。詳細は フィルタ検索を参照してください。
サポートされるイベント
タイムラインは、プロジェクトのライフサイクル中に発生するイベントの推移を示します。各イベントはタイムライン上に専用の「イベントタイル」として表示されます。以下のセクションでは、現在サポートされ、プロジェクトの履歴タイムラインの一部として表示可能なイベントの範囲を確認します。
プロジェクト作成
Related pages:新しいワークスペース・プロジェクトの作成(ブラウザインターフェース / Altium Designer)、既存プロジェクトをオンラインで利用可能にする、プロジェクトのクローン(ブラウザインターフェース / Altium Designer)
プロジェクトが作成されると、Project Createdイベントタイルがタイムラインに追加されます。このイベントはプロジェクトの履歴タイムラインの開始点を示します。そのため、常にタイムライン最下部のエントリとして見つかります。このイベントのタイルは、次の 2 つのバリエーションで表示されます。
- Workspace 内で新規にプロジェクトが作成された場合。作成者の名前(および写真/シンボル)と、プロジェクト作成時刻が表示されます。作成時にプロジェクトの説明が入力されていれば、その説明もタイル内に表示されます。

- プロジェクトが既存プロジェクトのクローンである場合。クローンされたプロジェクトを作成した人物の名前(および写真/シンボル)と、プロジェクト作成時刻が表示されます。クローン時にプロジェクトの説明が入力されていれば、その説明もタイル内に表示されます。元のソースプロジェクトへのリンクが提供され、クリックするとそのプロジェクトの詳細管理ページにアクセスします(ブラウザの別タブで開きます)。

プロジェクト・コミット
プロジェクトを Worskpace に保存するたび(プロジェクトは Worskpace 内部の Versioned StorageGit リポジトリで管理されます)、Project Committedイベントタイルがタイムラインに追加されます。コミットおよびプッシュを実行した人物の名前(および写真)と、日時が表示されます。コミットおよびプッシュ時に Save to Server dialogを通じてコメントが追加されていれば、それもタイル内に表示されます。
初期の Project Committedイベントタイルの例。
このタイルは設計差分(design diff)情報の表示にも対応しており、現在のコミットと直前のコミットの間で何が変更されたかをより詳細に示します。サポートされる要素には、ファイル、コンポーネント、ネット、バリアント、PCB 構造が含まれます。タイルの差分セクションは、コミットイベントによって影響を受けた各要素を、次の状態でグループ化して要約します。
– 要素が追加された。
– 要素が削除された。
– 要素が変更された。
タイル内の
コントロールをクリックすると、この差分セクションが展開され、影響を受けた要素が名前付きで表示されます。
タイル右上の
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。
- View – このコマンドを使用すると、選択したコミットのソース設計データを Web Viewerで、その時点の設計スナップショットとして開きます。
- Create Tag – 現在選択しているコミットに VCS タグ名を追加します。コミットに付与されたタグは、History ビューのタイル、Web Viewer のスナップショットビューのヘッダー、およびそのスナップショットビューに付随するコメントに表示されます。タグをコミットに追加すると、タイルのメニューコマンドは Tagに変わり、コミットのタグを変更(Edit)または削除(Remove)するサブオプションが提供されます。
Create Tag メニューオプションを選択して、コミットの History イベントにタグ名を追加します。
タグ付けされた History のコミットイベントのスナップショットビューには、タグ名がラベルとして表示されます。
ライブの WIP 設計でコメントを表示する際、タグ付けされたコミットの設計スナップショットで作成されたコメントには、関連するタグ名が含まれます。タグ名リンクを選択すると、関連するコミットのスナップショットが開きます。コメントの扱いについては Web Viewer Commentsを参照してください。
タグ付けされたコミットイベントのスナップショットに追加されたコメントには、関連するタグ名が含まれます。
- Schematic to – このコミットの回路図データを、別のコミットまたはリリースイベントのものと比較できます。サブメニューを使用して直前のコミットのソースデータと比較するか、可能なすべてのコミット/リリースから選択します。比較対象のリリース/コミットを選択すると、比較結果は Compare ビューに表示され、既定の Web ブラウザで新しいタブとして開きます。詳細は Schematic Comparisonを参照してください。
- BOM to – このコミットの BOM データを、別のコミットまたはリリースイベントのものと比較できます。関連するサブメニューを使用して直前のコミットの BOM データと比較するか、プロジェクトで作成されたすべてのコミット/リリースから選択します。比較対象を選択すると、比較結果は色分けされた BOM エントリのリストとして提示され、指定した Commit/Release イベント間で変更された項目を表します。変更点の集約サマリが標準 CSV 形式で生成され、ZIP アーカイブファイルとしてダウンロード可能になります。詳細は BOM Comparisonを参照してください。
- Clone– このコマンドを使用して、プロジェクトのその特定リビジョンからクローンを作成します。Clone Project ウィンドウが表示され、プロジェクトの Name、Description、および Advanced オプションの下で、ターゲット Server Folder と Repository を指定します。ウィンドウのバナーテキストには、どのプロジェクト・リビジョンからクローンが作成されるかが反映される点に注意してください。必要な情報を定義したら、
ボタンをクリックします。プロジェクトが作成され、タイムラインに Project Cloned イベントタイルが追加されます。
アクティブなプロジェクトの任意の特定リビジョンから、対応するそのリビジョンの Project Committed イベントタイルから直接クローンを作成できます。
- Download Sources – このコマンドを使用して、プロジェクトのその特定リビジョンのプロジェクトソースを Zip アーカイブとしてダウンロードします。Zip ファイル名および PCB プロジェクトファイルには、そのプロジェクトのリビジョンが Workspace にコミットおよびプッシュされた日時(UTC)が含まれます。
Project Release
Related page: Design Project Release
プロジェクトのリリースを実行するたびに(Altium Designer の Project Releaser を使用)、タイムラインに Project Released イベントタイルが追加されます。リリースを実行した人物が、名前(および画像)と日時とともに表示されます。生成データを Workspace にリリースする際に Confirm Release dialog を通じてリリースノートを追加した場合、それもタイル内に表示されます。リリースに含まれる各データセットも一覧表示されます。
タイル右上の
コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。
- View– 専用の製造ポータル(別のブラウザタブ)を開き、リリース済みデータをより詳細に確認できます。このポータルから、リリースされたファイルデータの表示とナビゲーション、BOM の確認、設計そのもののスナップショット(そのリリースデータのソース)の表示およびコメントが可能です。また、製造データをさまざまな粒度(完全なデータセットから個別の生成出力ファイルまで)でダウンロードするためのコントロールにもアクセスできます。選択したリリースは、Manufacturing Package としてメーカーへ直接送信することもできます。詳細は、Manufacturing Portal の「Release Package の参照」を参照してください。
プロジェクトのリリースをより詳細に確認するための専用 Manufacturing Portal タブにアクセスします。
- Schematic to– このリリースの回路図データを、別のリリースまたはコミットイベントのものと比較できます。サブメニューを使用して前回リリースのソースデータと比較するか、可能なすべてのリリースおよびコミットから選択します。比較対象のリリース/コミットを選択すると、比較結果が Compare ビューに表示され、既定の Web ブラウザで新しいタブとして開きます。詳細は Schematic Comparison を参照してください。
- Gerber to– このリリースで生成された Gerber データを、別の Gerber データセットと比較できます。関連するサブメニューを使用して前回リリースの製造データと比較するか、プロジェクトで作成されたすべてのリリースから選択(タイムラインは Project Released イベントタイルのみが表示されるようにフィルタリングされます)するか、ローカルで生成(およびアップロード)したファイルセットと比較します。比較対象を選択すると、結果は Gerber Compare view に表示され、別のブラウザタブで開きます。詳細は Gerber Comparison を参照してください。
- BOM To– このリリースの部品表(BoM)データを、別のリリースのものと比較できます。関連するサブメニューを使用して前回リリースの BOM データと比較するか、プロジェクトで作成されたすべてのリリースから選択します。比較対象を選択すると、指定した Commit/Release イベント間で変更された項目を表す、色分けされた BOM エントリのリストとして比較結果が表示されます。変更点の集約サマリが標準 CSV 形式で生成され、ZIP アーカイブファイルとしてダウンロード可能になります。詳細は BOM Comparison を参照してください。
- Download Outputs– subsequent window を通じて、リリースパッケージ内のどのデータセットをダウンロードするかを選択できます。選択後、
ボタンをクリックします。選択した各データセット用のフォルダを含む単一の Zip アーカイブがダウンロードされます。 - Download Sources– そのリリースパッケージの作成に使用された設計バージョンのスナップショットを、Zip アーカイブとしてダウンロードできます。
Project Cloning
Related page: プロジェクトのクローン作成(browser interface / Altium Designer)
Workspace のブラウザインターフェース、または Altium Designer 内のいずれかでプロジェクトをクローンするたびに、タイムラインに Project Cloned イベントタイルが追加されます。クローンを実行した人物が、名前(および画像)と日時とともに表示されます。クローン作成時に生成された説明がタイルに追加されますが、新しい説明を入力して上書きできます。クローンされたプロジェクトへのリンクが提供され、これをクリックすると、そのプロジェクトの詳細管理ページが別タブで開きます。
Project Cloned イベントタイルの例。
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 エンジニアが対応 MCAD ソフトウェアで PCB に変更を加え、それを Workspace にプッシュバックした場合、対応するプッシュイベントは、Workspace から Altium Designer に変更をプルした後に、プロジェクトの履歴タイムライン only 上で利用可能になります。
MCAD 関連イベントが 2 つある例。タイムラインのトランク下側のイベントは ECAD 側からのプッシュイベントを表し、上側のイベントは MCAD 側からのプッシュバックを表します。
Filtered Search
ビュー右上の
コントロールをクリックすると検索フィールドにアクセスでき、タイムライン上の関心のあるイベントをすばやく見つけられます。検索機能はプロジェクト履歴の基本検索をサポートし、検索文字列を入力するにつれて動的にフィルタリングが適用され、検索に関連するイベントのみがページに表示されます。イベントタイル内の一致テキストはハイライト表示されます。
プロジェクト履歴の検索例。大文字/小文字を区別しない検索語を入力するにつれてタイムラインが動的にフィルタリングされ、該当する各イベントタイル内で一致エントリがハイライト表示されます。
検索機能は次の情報に対して動作します。
- イベントタイルのタイトル。
- イベントを実行した人物の名前。
- 説明テキスト(該当イベント発生時のコメント/ノート/説明に由来するテキスト)。
- 差分データのテキスト(Project Committed イベントタイル内)。
- データセット名(Project Released イベントタイル内)。
- プロジェクト名(Project Cloned イベントタイルおよび Project Created イベントタイル(クローン作成によって作成された場合)内)。
Updating with New Events
プロジェクトに関連してサポート対象のイベントが発生すると、そのイベントが検出され、History ビューに自動的に表示されます。イベント発生後まもなく、ビューの下部に通知が表示されます。
コントロールをクリックして、新しいイベントでタイムラインを更新してください。


