Altium 365ワークスペースのプロジェクト履歴

親ページ： ワークスペースプロジェクト

プロジェクトの開発過程を簡単に振り返ることができないのは、デザイナーやプロダクトマネージャーにとってよくある不満の一つです。デザイナーは外部のVCS管理ツールを使いこなす必要があり、基本的なプロジェクト管理タスクを実行したい時に、それらのツールを運用するためのかなりの専門知識と時間が必要になることがよくあります。外部のVCSツールを使いこなせる場合でも、それらはプロジェクトの特定の側面、つまり開く、クローン作成、リバートなどのVCS関連のアクションのみを扱います。しかし、リリースやMCAD交換を含むプロジェクト管理の広範な範囲はどうでしょうか？また、これらのほとんどが通常、デスクトップに縛られることを要求されるという事実も忘れてはなりません。

そのような情報を一か所で見て、それを把握するという要求に対する解決策を提供するAltium 365 Workspaceは、プロジェクト履歴の概念を容易にします。Workspaceのブラウザインターフェース（親であるAltium 365 Platform Interfaceの一部）またはAltium Designer内からアクセスできる専用のHistoryビューは、プロジェクトに関連する主要なイベントの進行タイムライン – その作成、コミット、リリース、クローン、MCAD交換 – を提供し、適用される場合（設計ソースのスナップショットを見るなど）さまざまなアクションをサポートします。

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

プロジェクトのHistoryビューへのアクセスは、そのプロジェクトの詳細な管理ページから得られます。左側のペインでHistoryエントリをクリックします。

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

履歴タイムライン – 概要

Historyビューは、プロジェクトの進化の過程で発生した基本的なイベントのタイムラインを提示します。以下の画像に示され、その後詳述される3つの主要なセクションに分けることができます。

Historyビューの3つの主要な要素を特定する。

1. タイムラインの主幹。イベントの年代順は下から上へとなります。最初のイベントであるプロジェクトの作成はタイムラインの最下部に表示されます。その後のイベントは上に表示され、最新のイベント（最も現在のイベント）がタイムラインの最上部に表示されます。

2. イベント。プロジェクトに関連してサポートされているイベント（下記参照）が発生するたびに、そのイベントは専用のタイルとしてタイムラインに追加されます。各種イベントは異なる色のタイルで表示され、タイムラインの主幹に直接リンクされるか、またはそれに隣接して追加のアイコンが表示されます（MCAD Exchangeイベントの場合など）。

3. 検索。ビューの右上にある ​ コントロールをクリックして、プロジェクト履歴の基本的な検索を行う検索フィールドにアクセスします。検索文字列を入力すると、その検索に関連するイベントのみが表示されるようにタイムラインがフィルタリングされます。詳細については、フィルタリング検索を参照してください。

サポートされるイベント

タイムラインは、プロジェクトの遂行中に発生する一連のイベントの進行を示しています。これらのイベントは、専用の「イベントタイル」としてタイムラインに表示されます。以下のセクションでは、プロジェクトのタイムラインの一部として提示できる現在サポートされているイベントの範囲について説明します。

プロジェクトの作成

関連ページ： 新規マネージドプロジェクトの作成 (ブラウザインターフェース / Altium Designer)、既存のプロジェクトをオンラインで利用可能にする、プロジェクトの複製 (ブラウザインターフェース / Altium Designer)

プロジェクトが作成されると、Project Createdイベントタイルがタイムラインに追加されます。このイベントはプロジェクトのタイムラインの始まりを示しています。そのため、常にタイムラインの一番下のエントリとして見つけることができます。このイベントのタイルには2つの異なるバリエーションがあります：

• プロジェクトがワークスペース内で新しく作成された場合。プロジェクトの作成者は名前（および写真）で表示され、プロジェクトの作成日時も一緒に表示されます。作成時に入力された場合、プロジェクトの説明もタイル内に表示されます。

• プロジェクトが既存のプロジェクトのクローンである場合、クローンされたプロジェクトを作成した人が名前（および写真）で紹介され、プロジェクトの作成日時も表示されます。複製時に入力された場合、プロジェクトの説明もタイル内に表示されます。元のプロジェクトへのリンクが提供され、これをクリックすると、そのプロジェクトの詳細な管理ページがブラウザの別のタブで開きます。

プロジェクトコミット

プロジェクトをワークスペース（プロジェクトがワークスペースの内部のVersioned Storage Gitリポジトリの下で管理される場所）にCommit & Pushするたびに、Project Committedイベントタイルがタイムラインに追加されます。コミットとプッシュを行った人は、名前（および写真）で表示され、日付と時間も一緒に表示されます。コミットとプッシュの際にCommit to Version Controダイアログを通じてコメントが追加されていた場合、そのコメントもタイル内に表示されます。

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

このタイルは、デザインの差分情報もサポートしており、現在のコミットと前回のコミットの間で何が変更されたかについて、より詳細な情報を表示します。サポートされる要素には、ファイル、コンポーネント、ネット、バリアント、PCB構造が含まれます。差分セクションは、コミットイベントによって影響を受けたさまざまな要素を、以下の状態によってグループ化して要約します：

– 要素が追加されました。

– 要素が削除されました。

– 要素が変更されました。

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

タイルの右上隅にある コントロールをクリックすると、以下のコマンドが含まれるメニューにアクセスできます：

• View – 選択したコミットのソースデザインデータを、その時点でのデザインのスナップショットとしてWebビューアで開くためにこのコマンドを使用します。

• Create Tag – 現在選択されているコミットにVCSタグ名を追加します。コミットに添付されたタグは、その履歴ビュータイル、Webビューアのスナップショットビューのヘッダー、およびそのスナップショットビューに添付されたコメントに表示されます。タグがコミットに追加されると、タイルのメニューコマンドはTagに変わり、コミットのタグを変更（Edit）または削除（Remove）するサブオプションを提供します。

コミット履歴イベントにタグ名を追加するために「タグを作成」メニューオプションを選択します。

タグ名でラベル付けされた履歴コミットイベントのスナップショットビュー。

ライブWIPデザインでコメントが表示されるとき、タグ付けされたコミットのデザインスナップショットで作成されたものは、関連するタグ名を含むようになります。関連するコミットスナップショットを開くには、タグ名のリンクを選択します。Webビューアコメントにて、コメントの扱い方についての詳細をご覧ください。

タグ付けされたコミットイベントのスナップショットに追加されたコメントには、関連するタグ名が含まれます。

プロジェクトリリースに関連するコミットイベントは、Altium Designerのプロジェクトリリーザーによって作成され、自動的にリリースリビジョンIDでタグ付けされます。必要に応じて、結果として得られるリビジョンコミットタグは後から編集または削除することができます。ワークスペースへのリリースに関連する情報を参照してください。

リリースに関連付けられたコミットは、Altium Designerによって自動的にリリースIDでタグ付けされます。

• Schematic to – このコミットの回路図データを別のコミットやリリースイベントのデータと比較できます。サブメニューを使用して前のコミットのソースデータと比較するか、可能なすべてのコミットやリリースから選択します。比較対象のリリース/コミットが選択されると、比較結果が新しいタブとしてデフォルトのWebブラウザで開く「比較ビュー」に表示されます。詳細については、回路図比較を参照してください。

• PCB to – このコミットのPCBデータを別のコミットやリリースイベントのデータと比較できます。サブメニューを使用して前のコミットのソースデータと比較するか、可能なすべてのコミットやリリースから選択します。比較対象のリリース/コミットが選択されると、比較結果が新しいタブとしてデフォルトのWebブラウザで開く「比較ビュー」に表示されます。詳細については、PCB比較を参照してください。

• BOM to – このコミットのBOMデータを別のコミットやリリースイベントのデータと比較できます。関連するサブメニューを使用して前のコミットのBOMデータと比較するか、プロジェクトに対して行われたすべてのコミット/リリースから選択します。比較対象が選択されると、指定されたコミット/リリースイベント間で変更された項目を表す色分けされたBOMエントリのリストとして比較結果が表示されます。変更のまとめた要約が標準のCSV形式で生成され、ZIPアーカイブファイルでダウンロード可能になります。詳細については、BOM比較を参照してください。

• Clone – 特定のリビジョンのプロジェクトからクローンを作成するためにこのコマンドを使用します。プロジェクトのクローンウィンドウが表示され、プロジェクトのName、Description、およびParent Folder（ワークスペース内）を決定します。ウィンドウのバナーテキストは、どのリビジョンのプロジェクトからクローンが作成されているかを反映しています。必要な情報を定義したら、 ボタンをクリックします。プロジェクトが作成され、Project Clonedイベントタイルがタイムラインに追加されます。

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

• Download Sources – このコマンドを使用して、プロジェクトの特定のリビジョンのプロジェクトソースをZipアーカイブでダウンロードします。ZipファイルとPCBプロジェクトファイルの名前には、そのプロジェクトのリビジョンがコミットされ、ワークスペースにプッシュされた日時（UTC時間）が含まれます。

プロジェクトリリース

関連ページ： デザインプロジェクトリリース

プロジェクトのリリースを実行するたびに – Altium Designerのプロジェクトリリーザーを使用して – Project Releasedイベントタイルがタイムラインに追加されます。リリースを実行した人物は、名前（および写真）で表示され、日付と時間も一緒に表示されます。リリース時に生成されたデータをワークスペースにリリースする際にリリースノートが追加されていた場合 – Confirm Releaseダイアログを通じて – その内容もタイル内に表示されます。リリースに含まれる各データセットも、ライフサイクルの状態を示す表示と共にリストアップされます。

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

タイルの右上隅にある コントロールをクリックして、次のコマンドが含まれるメニューにアクセスします:

• View – 専用の製造ポータル（別のブラウザタブで開く）を開き、リリースされたデータをより詳細に検査できます。このポータルから、リリースされたファイルデータを表示・ナビゲートし、BOMを検査し、デザイン自体のスナップショットを表示してコメントすることができます。これは、リリースされたデータのソースです。また、全データセットから個々の生成された出力ファイルまで、さまざまな粒度で製造データをダウンロードするためのコントロールにもアクセスできます。選択したリリースは、製造パッケージとして直接製造業者に送ることもできます。詳細については、製造ポータルを通じてリリースパッケージを閲覧するを参照してください。

プロジェクトのリリースをより詳細に検査するために、専用のManufacturing Portalタブにアクセスする。

• Schematic to – このリリースの回路図データを他のリリースやコミットイベントと比較することができます。サブメニューを使用して前回のリリースのソースデータと比較するか、可能なすべてのリリースとコミットから選択します。比較リリース/コミットが選択されると、比較の結果は新しいタブとしてデフォルトのウェブブラウザで開く「比較ビュー」に表示されます。詳細については、回路図比較を参照してください。

デザインプロジェクトの2つのリリース間の回路図データの比較。

• PCB to – このリリースのPCBデータを他のリリースやコミットイベントと比較できます。サブメニューを使用して前回のリリースのソースデータと比較するか、可能なすべてのリリースとコミットから選択します。比較リリース/コミットが選択されると、比較の結果は「比較ビュー」で表示され、デフォルトのWebブラウザで新しいタブとして開きます。詳細については、PCB比較を参照してください。

デザインプロジェクトの2つのリリース間のPCBデータの比較。

• Gerber to – このリリースのために生成されたGerberデータを別のGerberデータセットと比較することができます。関連するサブメニューを使用して、前回のリリースの製造データと比較するか、プロジェクトに対して行われたすべてのリリースから選択します（タイムラインはProject Releasedイベントタイルのみを表示するようにフィルタリングされます）、または選択したローカルで生成（およびアップロード）されたファイルセットと比較します。比較の対象が選択されると、結果は別のブラウザタブで開くGerber Compareビューに表示されます。詳細については、Gerber比較を参照してください。

デザインプロジェクトの2つのリリース間で生成されたGerberデータの比較。

• BOM to – このリリースのBOMデータを別のコミットまたはリリースイベントのBOMデータと比較できます。関連するサブメニューを使用して、前のコミットのBOMデータと比較するか、プロジェクトに対して行われたすべてのコミット/リリースから選択します。比較の対象が選択されると、指定されたコミット/リリースイベント間で変更された項目を表す色分けされたBOMエントリのリストとして比較結果が表示されます。変更のまとめた要約が標準のCSV形式で生成され、ZIPアーカイブファイルでダウンロード可能になります。詳細については、BOM比較を参照してください。

設計プロジェクトの2つのイベント間で生成されたBOMデータの比較をダウンロードします。

• Download Outputs - 後続のウィンドウを通じて、リリースパッケージ内のどの出力データセットをダウンロードするかを選択できます。選択後、 ボタンをクリックします。選択したデータセットごとにフォルダが含まれる単一のZipアーカイブがダウンロードされます。

• Download Sources - そのリリースパッケージを作成するために使用された設計のバージョンのソースデータをZipアーカイブとしてダウンロードできます。

プロジェクトの複製

関連ページ： プロジェクトの複製 (ブラウザインターフェース / Altium Designer)

プロジェクトをクローンするたびに、ワークスペースのブラウザインターフェースを通じても、Altium Designer 内からでも、Project Cloned イベントタイルがタイムラインに追加されます。クローンを実行した人物は、名前（および写真）で表示され、日付と時間も一緒に表示されます。複製の際に説明が追加されていた場合 – ブラウザベースのClone Project ウィンドウや（Altium Designer の）Clone Project ダイアログを通じて – その説明もタイル内に表示されます。クローンされたプロジェクトへのリンクが提供され、このリンクをクリックすると、そのプロジェクトの詳細な管理ページがブラウザの別のタブで開きます。

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

MCAD 交換

関連ページ： ECAD-MCAD CoDesignについてもっと知る

電子設計と機械設計のドメイン間で作業する際、ワークスペースは二つを繋ぐ橋渡しとして機能し、直接のECAD-MCAD共同設計を容易にします。プロジェクトのPCB設計に変更が加えられ、それらの変更が関連するCoDesignerパネルを通じてワークスペースにプッシュされると、「MCAD Changes Suggested」イベントタイルがタイムラインに追加されます。プッシュを行った人物は、名前（および写真）と共に、日付と時間と共に表示されます。プッシュの際にメッセージが投稿されていた場合 – MCAD CoDesigner パネル（Altium Designer）または Altium CoDesigner パネル（対応するMCADソフトウェア内）を通じて – そのメッセージもタイル内に表示されます。

MCAD Changes Suggested イベントタイルの例。

MCADエンジニアがサポートされているMCADソフトウェアでPCBに変更を加え、それらの変更をワークスペースにプッシュすると、対応するプッシュイベントがプロジェクトの履歴タイムラインに自動的に表示されます。最新の変更を表示するには、履歴ページを更新する必要があるかもしれません。

MCAD関連イベントを示す例。タイムラインの幹の左側にはECAD側からのプッシュイベント、右側にはMCAD側からのプッシュイベントがあります。

フィルター検索

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

プロジェクトの履歴の検索例。検索語を入力するとタイムラインが動的にフィルタリングされ、各関連イベントタイル内で一致するエントリが強調表示されます。

検索機能は以下の情報で動作します：

• イベントタイトル。

• イベントを実行した人物の名前。

• 説明テキスト（関連するイベントが発生した際のコメント/ノート/説明からのテキスト）。

• Project Committedイベントタイル内の差分データテキスト。

• Project Releasedイベントタイル内のデータセット名。

• Project ClonedイベントタイルおよびProject Createdイベントタイル（複製を通じて作成された場合）内のプロジェクト名。

新しいイベントで更新する

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