プロジェクト履歴

現在、バージョン 6.0. をご覧頂いています。最新情報については、バージョン プロジェクト履歴 の 8.0 をご覧ください。
 

Parent page: ワークスペース・プロジェクト

Enterprise Server Workspace は、プロジェクト活動の履歴を専用のインタラクティブな Historyビューとして提供し、プロジェクトの履歴概要を把握したいというニーズに対して洗練されたソリューションを提供します。このプロジェクト History ビューは、ワークスペースのブラウザインターフェースから、または Altium Designer内からアクセスでき、プロジェクトに関連する主要イベントの進行タイムラインを表示します。イベントには、プロジェクトの作成、コミット、リリース、クローン、MCAD 交換が含まれ、該当する場合はイベントのアクションコマンドも提供されます。

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

プロジェクトの History ビューへのアクセスは、そのプロジェクトの詳細な CAD 中心の管理ページ、すなわち Projects Managementページから行います。左側ペインの Historyオプションをクリックしてください。

Projects Managementページ自体は、メインの Projectsページでプロジェクトのエントリをダブルクリックする、タイトルをクリックする、または メニューから Openオプションを選択することで開けます。詳細は 特定プロジェクトの管理を参照してください。

プロジェクトの詳細管理ページから、そのプロジェクトの履歴にアクセスします。プロジェクトの詳細管理ページから、そのプロジェクトの履歴にアクセスします。

Workspace によって生成されるプロジェクト Historyビューは、Altium Designer でも利用できます。Altium Designer でビューを読み込むには、Projects パネルでプロジェクト名を右クリックして表示されるコンテキストメニューから History & Version Control » Show Project Historyオプションを選択します。また、このビューは Explorer パネルの開いているプロジェクトビューにある Historyメニューオプションからも開けます。

なお、Altium Designer 側で利用できる History イベントのアクションは、ブラウザインターフェース側のものとは異なります。具体的には、Altium Designer 側ではプロジェクトを過去にコミットされたスナップショットへ戻す(Revert to)ことや、リリースを編集環境で開く(Open Snapshot)ことができます。

詳細は Altium Designer における Project Historyを参照してください。

履歴タイムライン – 概要

History ビューは、プロジェクトの進化の過程で発生した基本イベントのタイムラインを提示します。以下の画像と説明に示すように、概ね 3 つの主要要素に分けられます。

History ビューの 3 つの主要コンポーネントを識別。History ビューの 3 つの主要コンポーネントを識別。

  1. Main trunk of the timeline。イベントの時系列は下から上へ進みます。最初のイベント(プロジェクトの作成)はタイムラインの最下部に表示されます。以降のイベントはその上に表示され、最新(最も現在のイベント)がタイムラインの最上部に表示されます。
  2. Events。プロジェクトに関連してサポート対象のイベント(下記参照)が発生するたびに、専用タイルとしてタイムラインに追加されます。イベントの種類ごとにタイルの色が異なり、タイムラインの主幹に直接リンクされるか、または隣に関連付けアイコンが表示されます(MCAD Exchange イベントの場合など。)。
  3. Search。ビュー右上の コントロールをクリックすると検索フィールドにアクセスでき、プロジェクト履歴の基本検索が行えます。検索文字列を入力すると、その検索に関連するイベントのみが表示されるようタイムラインがフィルタリングされます。詳細は フィルタ検索を参照してください。

サポートされるイベント

タイムラインは、プロジェクトのライフサイクル中に発生するイベントの推移を示します。各イベントはタイムライン上に専用の「イベントタイル」として表示されます。以下のセクションでは、現在サポートされ、プロジェクトの履歴タイムラインの一部として表示可能なイベントの範囲を確認します。

プロジェクト作成

Related pages:新しいワークスペース・プロジェクトの作成(ブラウザインターフェース / Altium Designer)、既存プロジェクトをオンラインで利用可能にする、プロジェクトのクローン(ブラウザインターフェース / Altium Designer

プロジェクトが作成されると、Project Createdイベントタイルがタイムラインに追加されます。このイベントはプロジェクトの履歴タイムラインの開始点を示します。そのため、常にタイムライン最下部のエントリとして見つかります。このイベントのタイルは、次の 2 つのバリエーションで表示されます。

  • Workspace 内で新規にプロジェクトが作成された場合。作成者の名前(および写真/シンボル)と、プロジェクト作成時刻が表示されます。作成時にプロジェクトの説明が入力されていれば、その説明もタイル内に表示されます。

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

Project Createdイベントタイルは、青の実線の接続ラインとノードでタイムラインの主幹に物理的に接続されます:

プロジェクト・コミット

プロジェクトを Worskpace に保存するたび(プロジェクトは Worskpace 内部の Versioned StorageGit リポジトリで管理されます)、Project Committedイベントタイルがタイムラインに追加されます。コミットおよびプッシュを実行した人物の名前(および写真)と、日時が表示されます。コミットおよびプッシュ時に Save to Server dialogを通じてコメントが追加されていれば、それもタイル内に表示されます。

プロジェクトがローカルプロジェクトで、その後オンラインで利用可能にされた場合、Make Available Online dialogで入力した説明が、Project Createdイベントタイルと初期の Project Committedイベントタイルの両方に使用されます。これは、プロジェクトをオンラインで利用可能にする処理の一部としてコミットとプッシュが実行されるためです(もちろん、Enable Formal Version Controlのオプションが有効になっている場合に限ります)。

初期の Project Committedイベントタイルの例。初期の Project Committedイベントタイルの例。

このタイルは設計差分(design diff)情報の表示にも対応しており、現在のコミットと直前のコミットの間で何が変更されたかをより詳細に示します。サポートされる要素には、ファイル、コンポーネント、ネット、バリアント、PCB 構造が含まれます。タイルの差分セクションは、コミットイベントによって影響を受けた各要素を、次の状態でグループ化して要約します。

– 要素が追加された。

– 要素が削除された。

– 要素が変更された。

タイル内の コントロールをクリックすると、この差分セクションが展開され、影響を受けた要素が名前付きで表示されます。

利用可能な Show More および Show Less コントロールを使用して、各要素タイプの全リストを確認できます。タイル内の コントロールをクリックすると要約表示に戻ります。

タイル右上の コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。

  • View – このコマンドを使用すると、選択したコミットのソース設計データを Web Viewerで、その時点の設計スナップショットとして開きます。
  • Create Tag – 現在選択しているコミットに VCS タグ名を追加します。コミットに付与されたタグは、History ビューのタイル、Web Viewer のスナップショットビューのヘッダー、およびそのスナップショットビューに付随するコメントに表示されます。タグをコミットに追加すると、タイルのメニューコマンドは Tagに変わり、コミットのタグを変更(Edit)または削除(Remove)するサブオプションが提供されます。

Create Tag メニューオプションを選択して、コミットの History イベントにタグ名を追加します。Create Tag メニューオプションを選択して、コミットの History イベントにタグ名を追加します。

  • VCS タグには使用できない文字がいくつかあります。不正な文字を含むタグを作成しようとすると、ヒント情報で通知されます(例を参照)。
  • Commit イベントに適用できるタグは 1 つのみで、複数タグはサポートされません。

タグ付けされた 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 ウィンドウが表示され、プロジェクトの NameDescription、および Advanced オプションの下で、ターゲット Server FolderRepository を指定します。ウィンドウのバナーテキストには、どのプロジェクト・リビジョンからクローンが作成されるかが反映される点に注意してください。必要な情報を定義したら、 ボタンをクリックします。プロジェクトが作成され、タイムラインに Project Cloned イベントタイルが追加されます。

アクティブなプロジェクトの任意の特定リビジョンから、対応するそのリビジョンの Project Committed イベントタイルから直接クローンを作成できます。アクティブなプロジェクトの任意の特定リビジョンから、対応するそのリビジョンの Project Committed イベントタイルから直接クローンを作成できます。

  • Download Sources – このコマンドを使用して、プロジェクトのその特定リビジョンのプロジェクトソースを Zip アーカイブとしてダウンロードします。Zip ファイル名および PCB プロジェクトファイルには、そのプロジェクトのリビジョンが Workspace にコミットおよびプッシュされた日時(UTC)が含まれます。
Project Committed イベントタイルは、タイムラインのメイントランクに、青色の実線の接続ラインとノードで物理的に接続されています: 。プロジェクトの最新リビジョン(つまり最後のコミット)は、ノードが白塗りであることで区別されます:

Project Release

Related page: Design Project Release

プロジェクトのリリースを実行するたびに(Altium Designer の Project Releaser を使用)、タイムラインに Project Released イベントタイルが追加されます。リリースを実行した人物が、名前(および画像)と日時とともに表示されます。生成データを Workspace にリリースする際に Confirm Release dialog を通じてリリースノートを追加した場合、それもタイル内に表示されます。リリースに含まれる各データセットも一覧表示されます。

Project Released イベントタイルの例。Project Released イベントタイルの例。

タイル右上の コントロールをクリックすると、次のコマンドを含むメニューにアクセスできます。

  • View– 専用の製造ポータル(別のブラウザタブ)を開き、リリース済みデータをより詳細に確認できます。このポータルから、リリースされたファイルデータの表示とナビゲーション、BOM の確認、設計そのもののスナップショット(そのリリースデータのソース)の表示およびコメントが可能です。また、製造データをさまざまな粒度(完全なデータセットから個別の生成出力ファイルまで)でダウンロードするためのコントロールにもアクセスできます。選択したリリースは、Manufacturing Package としてメーカーへ直接送信することもできます。詳細は、Manufacturing Portal の「Release Package の参照」を参照してください。

プロジェクトのリリースをより詳細に確認するための専用 Manufacturing Portal タブにアクセスします。プロジェクトのリリースをより詳細に確認するための専用 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 Outputssubsequent window を通じて、リリースパッケージ内のどのデータセットをダウンロードするかを選択できます。選択後、 ボタンをクリックします。選択した各データセット用のフォルダを含む単一の Zip アーカイブがダウンロードされます。
  • Download Sources– そのリリースパッケージの作成に使用された設計バージョンのスナップショットを、Zip アーカイブとしてダウンロードできます。
プロジェクトのリリースは非常に重要なイベントであるため、Project Released イベントタイルはより目立つように表示されます。単なる「接続された」イベントではなく、「主要」イベントとしてタイムラインをまたぐ形で表示されます。

Project Cloning

Related page: プロジェクトのクローン作成(browser interface / Altium Designer

Workspace のブラウザインターフェース、または Altium Designer 内のいずれかでプロジェクトをクローンするたびに、タイムラインに Project Cloned イベントタイルが追加されます。クローンを実行した人物が、名前(および画像)と日時とともに表示されます。クローン作成時に生成された説明がタイルに追加されますが、新しい説明を入力して上書きできます。クローンされたプロジェクトへのリンクが提供され、これをクリックすると、そのプロジェクトの詳細管理ページが別タブで開きます。

Project Cloned イベントタイルの例。Project Cloned イベントタイルの例。

主な Clone コマンドは、Workspace のブラウザインターフェースの Projects ページにある メニューオプション、または Project Committed イベントタイル内の メニューから Clone オプションを選択して History ビューから利用できます。後者のオプションでは、プロジェクトの最新(Head)リビジョンではなく、その特定リビジョンがクローンされます。

Altium Designer からは、Projects パネル内のプロジェクトエントリを右クリックして Clone オプションを選択するか、プロジェクトを表示しているときに Explorer パネルで メニューから Clone オプションを選択します。

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 内)を通じてメッセージが投稿された場合、それもタイル内に表示されます。

現在サポートされているのは Push イベントのみです。

MCAD エンジニアが対応 MCAD ソフトウェアで PCB に変更を加え、それを Workspace にプッシュバックした場合、対応するプッシュイベントは、Workspace から Altium Designer に変更をプルした後に、プロジェクトの履歴タイムライン only 上で利用可能になります。

MCAD 関連イベントが 2 つある例。タイムラインのトランク下側のイベントは ECAD 側からのプッシュイベントを表し、上側のイベントは MCAD 側からのプッシュバックを表します。MCAD 関連イベントが 2 つある例。タイムラインのトランク下側のイベントは ECAD 側からのプッシュイベントを表し、上側のイベントは MCAD 側からのプッシュバックを表します。

MCAD Changes Suggested イベントタイルは、タイムラインのメイントランクに物理的に接続されません。代わりに、トランク方向を指す方向矢印シンボルが使用されます。

Filtered Search

ビュー右上の コントロールをクリックすると検索フィールドにアクセスでき、タイムライン上の関心のあるイベントをすばやく見つけられます。検索機能はプロジェクト履歴の基本検索をサポートし、検索文字列を入力するにつれて動的にフィルタリングが適用され、検索に関連するイベントのみがページに表示されます。イベントタイル内の一致テキストはハイライト表示されます。

検索機能は大文字/小文字を区別しません。

プロジェクト履歴の検索例。大文字/小文字を区別しない検索語を入力するにつれてタイムラインが動的にフィルタリングされ、該当する各イベントタイル内で一致エントリがハイライト表示されます。プロジェクト履歴の検索例。大文字/小文字を区別しない検索語を入力するにつれてタイムラインが動的にフィルタリングされ、該当する各イベントタイル内で一致エントリがハイライト表示されます。

フィルタされた選択の上にはボックスが用意されており、現在表示されているイベント数の要約と、フィルタ/検索文字列をすばやく削除するためのコントロールが表示されます。

検索機能は次の情報に対して動作します。

  • イベントタイルのタイトル。
  • イベントを実行した人物の名前。
  • 説明テキスト(該当イベント発生時のコメント/ノート/説明に由来するテキスト)。
  • 差分データのテキスト(Project Committed イベントタイル内)。
  • データセット名(Project Released イベントタイル内)。
  • プロジェクト名(Project Cloned イベントタイルおよび Project Created イベントタイル(クローン作成によって作成された場合)内)。
現在のフィルタリングを解除して完全なタイムラインに戻すには、検索フィールドをクリアします。現在のテキストを選択して Backspace key を押すか、フィールド右端の コントロールをクリックします。あるいは、表示されているイベント数を要約するボックス(ビュー上部)内の Clear Filter コントロールをクリックします。

Updating with New Events

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

また、手動更新も用意されており、ビュー右上のコントロールをクリックして実行します。
AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
Content