Altium Designerでのプロジェクト文書の管理
Projectsパネル
Projectsパネルは、現在開いているすべてのプロジェクトとそれらの構成ドキュメント、構造を表示します。パネルの右クリックコンテキストメニューは、設計ドキュメントを操作するために必要なほとんどのコマンドを提供します。
Projectsパネルにおけるドキュメントの表示は、ハードドライブやその他の場所にどのように保存されているかを反映しているわけではありません。パネルの内容はプロジェクトの論理的な表現と考えることができますが、ドキュメントファイルの保存場所や組織(およびそのタイプ)は、ユーザー次第です。ドキュメントはローカルマシンのフォルダやLANに保存されているかもしれませんし、もちろん、基本的なGit/SVN VCSシステムや、Workspaceのような完全に管理されたシステムによって提供されるバージョン管理リポジトリにホストされている可能性もあります。
ワークスペースに接続されると、ワークスペースのアイコン( / )がこのワークスペースの最上位エントリの隣に表示されます。ワークスペースプロジェクトが開かれると、そのエントリはPCBプロジェクトの場合のような指示的なアイコン()で表示されます。プロジェクトのローカル作業コピーが開かれているが、そのプロジェクトが存在するワークスペースに接続されていない場合、グレーアウトされたワークスペースアイコン( / )が表示され、プロジェクトアイコンが変更されます(例えば、PCBプロジェクトの場合はとして表示されます)。
ワークスペースのプロジェクトは、そのプロジェクトが存在するワークスペースのチームにあなたを招待せずに共有することもできます。共有アクセスから開かれたプロジェクトは、それに隣接するShared with meラベルとアイコンによって示されます。
プロジェクトがあなたと共有された場合、それを閲覧のみ可能である場合、パネル内のプロジェクトエントリの隣にView Onlyラベルが表示され、これを示します。
ローカルプロジェクトは、プロジェクトグループ ( *.DsnWrk
)のエントリーの下にリストされています- デフォルト(Project Group 1.DsnWrk
)、またはあなたが作成または開いたものです。
現在接続しているワークスペースに関するコンテキストメニューにアクセスするには、ワークスペース名を右クリックするか、またはその右端にあるコントロールをクリックします。これらのコマンドには以下が含まれます:
- Open Project – プロジェクトを開くダイアログを開きます。
- Create Project – プロジェクト作成ダイアログを開きます。
- Show in Explorer – エクスプローラーパネルを開きます。
- Show in Web Browser – デフォルトのブラウザでワークスペースのブラウザインターフェースのProjectsページを開きます。
- Sign out – ワークスペースからサインアウトします。
- Sign in – ワークスペースにサインインします。このコマンドは、Projectsパネルで少なくとも1つのワークスペース項目(例えば、プロジェクト)を開いており、かつその項目が存在するワークスペースから現在切断されている場合に利用可能です。
これらのコマンドにアクセスするには、ワークスペースに接続している必要があります。ワークスペースからサインアウトしている場合は、接続したいワークスペースを右クリックして、Sign inコマンドをクリックしてください。
プロジェクト文書ツリー
既存のプロジェクトを開いたり、新しいプロジェクトを作成したりすると、そのエントリーがProjectsパネルに表示されます。プロジェクトの一部である既存の文書(および追加された新しい文書)は、目的および/またはタイプに応じてサブフォルダーの下に表示されます。たとえば、以下の一般的なフォルダーとコンテンツドキュメントタイプがプロジェクトの下に表示されることがあります:
- Source Documents – 回路図、PCBなどの基本設計ドキュメント。
- Settings – プロジェクト内で使用される各種ファイルを提供します。これには、出力ジョブファイル、ハーネス定義ファイル、注釈ドキュメントなど、関連するファイルが含まれます。
- Libraries – ローカルソースライブラリドキュメント。ドキュメントはライブラリタイプに基づいてさらに細分化されます(例:回路図ライブラリ、PCBライブラリなど)。
- Documentation – プロジェクトに追加された追加のドキュメントで、Altium Designerが認識するタイプのもの(例:テキスト、PDFなど)。
- Other Documents – Altium Designerが認識しないタイプのプロジェクトに追加された追加のドキュメント。所有アプリケーションがWindowsによって認識されている場合、Altium Designerで開くことができます(例:Wordドキュメント、Excelスプレッドシートなど)。
- Generated – 出力として生成されたドキュメント。ドキュメントはタイプに基づいてさらに細分化されます(例:BOMドキュメント、テキストドキュメントなど)。プロジェクトの出力が生成されると、メインツリーの対応するサブフォルダが作成され、データが追加されます。
- Components – このフォルダは、各コンポーネントと各グループ内のコンポーネント数をリストします。このフォルダが表示されない場合はプロジェクトを検証してください(Project » Validate)。コンポーネントはデフォルトでデザイネータの最初の文字によってグループ化されます - コンポーネント(またはコンポーネントグループフォルダ)のエントリを右クリックし、コンテキストメニューからComponent Groupingコマンドを選択して、ProjectsパネルのComponent Groupingコントロールにすばやくアクセスし、グルーピングのスタイルを変更するか、必要に応じてグルーピングを無効にします。詳細については、回路の接続性を回路図に作成するページのプロジェクト構造内のコンポーネントとネットの検索セクションを参照してください。
- Nets – このフォルダは、プロジェクトで使用される各ネットをリストします。このフォルダが表示されない場合はプロジェクトを検証してください(プロジェクト » 検証)。詳細については、回路の接続性を回路図に作成するページのプロジェクト構造内のコンポーネントとネットの検索セクションを参照してください。
プロジェクトフォルダまたはプロジェクトフォルダのサブフォルダに保存されているドキュメントは、プロジェクトファイル内で相対参照を使用して関連付けられます。異なるフォルダパスに保存されているドキュメントは、プロジェクトファイル内で絶対参照を使用して関連付けられます。これらのドキュメントには、上の画像のファイル に示されているように、プロジェクトにリンクされていることを示すために、下隅に小さな矢印が含まれています。
ドキュメントツリーでの作業に関する注意点:
- プロジェクトに依存しないドキュメントはフリードキュメントとして表示され、対応するサブフォルダーの下に表示されます。フリードキュメントを右クリックしてコンテキストメニューからAdd to Project <ActiveProjectName>コマンドを選択することで、現在開いているフリードキュメントをアクティブなプロジェクトに追加できます。また、Projectsパネルで必要なプロジェクト名にドラッグアンドドロップすることもできます。
- 複数のドキュメントを編集用に開くことを許可するだけでなく、環境は同時に複数のプロジェクトを開くこともサポートしています。これらは関連するプロジェクトでも無関係なプロジェクトでもかまいません。
- Projectsパネルのドキュメントは、ソースドキュメント(スキーマティック、PCBなど)、設定ドキュメント(ハーネス、Outjobなど)および、階層型設計の場合はトップレベルのスキーマティックドキュメントなど、論理的なグループまたは「フォルダー」に自動的に整理されます。各フォルダーグループ内のドキュメントは、デフォルトで追加された順序で表示されますが、グループ内で新しい順序位置にドラッグアンドドロップできます。
- 新しい階層型設計の場合、パネルにはドキュメント間の親子関係が表示されます。シートシンボルとポート定義によって実際に定義されるシート間の接続と設計階層であるため、スキーマティックドキュメントをドラッグアンドドロップして接続関係を定義することはできません。
- プロジェクトドキュメントサブフォルダーを右クリックすると、展開されているか閉じているかにかかわらず、開く、閉じる、またはフォーカスされたプロジェクトドキュメントサブフォルダー内のすべてのドキュメントを保存するなど、追加のドキュメント管理コマンドにアクセスできます。
- パネル内のプロジェクト間でドキュメントを転送するには、クリックしてドラッグします。ドキュメントを正しいサブフォルダーにドラッグする必要はなく、自動的にプロジェクト構造内の正しい位置に配置されます。
- キーボードショートカット上矢印、Home、End、下矢印を使用して、それぞれパネル内の前の、最初の、最後の、次のエントリを表示できます。トップレベルのエントリまたはそのサブフォルダーを展開または折りたたむには、右矢印キーと左矢印キーを使用します。
- Projectsパネルで選択されたコンポーネントまたはネットエントリから、親PCB設計プロジェクトのスキーマティックまたはPCBドキュメントにクロスプローブするには、エントリを右クリックしてコンテキストメニューからCross Probe to SchematicまたはCross Probe to PCBコマンドを選択します。
- プロジェクトドキュメントが保存されている場所でWindowsエクスプローラーのインスタンスを開くには、Projectsパネルでそのエントリを右クリックし、Exploreコマンドを選択します。Projectsパネルでフォーカスされたドキュメントの場合、パネルの上部にある コントロールをクリックすることで行うことができます。
プロジェクトオプション
既存のプロジェクトまたは新しく作成されたプロジェクトは、そのプロジェクトに特有のオプション設定と関連付けられています。これらはプロジェクトファイル(例:*.PrjPcb
)に保存され、プロジェクトの種類によって異なります。
オプション設定は、メインメニューのProject » Project Optionsから、またはProjectsパネルでプロジェクト名を右クリックしてコンテキストメニューからProject Optionsを選択することでアクセスできるProject Optionsダイアログで設定されます。Projectsパネルでフォーカスされているプロジェクトの場合、パネルの上部にある コントロールをクリックすることでダイアログにアクセスできます。
プロジェクトファイルに保存される他のプロジェクト設定には、他のダイアログで定群される設定が含まれます:
- 回路図の注釈設定。
- レポート、印刷、ガーバーなどの出力設定。これらは回路図やPCBエディタのメニューからアクセスされる出力設定であり、OutJobドキュメントで定義された出力設定とは異なることに注意してください。
ドキュメントの状態表示
Altium Designerでプロジェクトドキュメントを扱う際、Projectsパネルは、各設計ドキュメントとメインプロジェクトファイルに関連付けられたステータスアイコンを通じて、どのドキュメントファイルが変更されたか、または保存されたかの視覚的な要約を提供します。これにより、ドキュメントが変更されたか、保存されたか、ワークスペース上にあるのかローカル上にあるのか、およびバージョン管理の状態について、迅速に視覚的な要約を得ることができます。ドキュメントアイコンとその意味は以下の通りです。
開いている/変更されたステータスアイコン
[空白] | ドキュメントは閉じられています。 |
オープン - ドキュメントがデザインエディターウィンドウのタブ付きドキュメントとして開かれています。 | |
オープン/修正済み - ドキュメントが開かれ、修正されています(まだ保存されていません)。 |
|
ドキュメントファイルは開かれており、このインスタンスのAltium Designerによってロックされています。 | |
ドキュメントファイルは開かれており、別のインスタンスのAltium Designerによってロックされています。 | |
ドキュメントは別のユーザーによって編集されています。このステータス条件は共同作業者の可視化と競合の防止機能によって有効になります。 | |
別のユーザーによって編集されているドキュメントがエディターで現在開かれています。このステータス条件は共同作業者の可視化と競合の防止機能によって有効になります。 | |
ドキュメントが見つかりません (見つからないドキュメントについての詳細を学ぶ)。 |
バージョン管理ステータスアイコン
バージョン管理システムは、基本的に作業フォルダ内のファイルとデザインリポジトリ内の対応するファイルを監視し、比較します。Altium Designerは、そのVCSインターフェースを介してバージョン管理システムと情報を要求し、交換し、比較されたファイルの状態に応じて応答します。実際には、これはプロジェクトファイルアイコンを通じて、一連のVCSアラート、および利用可能なファイル管理コマンドの適切な変更によって表されます。
- パネルの右クリックメニューからHistory & Version Control » Refreshを選択するか、メインメニューからProject » History & Version Control » Refreshコマンドを選択(またはF5を押す)ことで、各ファイルエントリの現在のVCSステータスを更新できます。これにより、作業フォルダ内のファイルとデザインリポジトリ内の対応するファイルを比較し、各ドキュメントのステータスを更新します。
- VCSアイコンにマウスを合わせると、その意味が表示されます。
- VCSアイコンをクリックすると、ドキュメントのVCSステータスに関する詳細情報が表示され、関連するアクションを実行するオプションにアクセスできます。
アイコンとその意味は以下の通りです:
[空白] | N/A | ファイルはバージョン管理システム(VCS)リポジトリで管理されていません。 |
変更なし | ローカルコピーのファイルはリポジトリのファイルと一致しており、最新の状態です。 | |
追加予定 | ファイルはバージョン管理に追加されましたが、まだVCSリポジトリにコミット(チェックイン)されていません。 | |
変更済み | ローカルコピーのファイルが変更され、作業フォルダに保存されました。リポジトリにファイルをコミットして、新しいリビジョンを作成してください。 | |
古い | ローカルコピーのファイル(作業フォルダ内)はリポジトリの対応するファイルよりも古く、したがって古い状態です。履歴 & バージョン管理の右クリックメニューから更新またはプロジェクト全体を更新コマンドを使用するか、ファイルを保存してリポジトリから最新のファイルを取得するか、ファイルを保存して競合状態を作成してください。 プロジェクトに古い状態と変更なし状態のドキュメントのみが含まれている場合は、Projectsパネルのプロジェクト名の隣に表示されるサーバーから更新コントロールを使用して、ワークスペースから古いファイルの最新ドキュメントを取得することもできます – 画像を表示。 |
|
競合の予防 | 他のユーザーがあなたが編集してローカルに保存したバージョンのファイルをコミットする前にファイルをコミットしました。ローカル変更を元に戻すコマンドを使用して、プロジェクトファイルのローカル変更を破棄してください。PCBファイルの場合は、PCB CoDesign機能を使用して変更を比較およびマージすることもできます。 | |
競合検出 | プロジェクトをワークスペースに保存しようとするときに、プロジェクトに競合の予防状態のファイルが含まれている場合、これらのファイルは競合検出状態になります。アクションが必要情報ダイアログが表示され、解決が必要な競合ファイルがリストされます。この状態のファイルのVCSコンテキストメニューを使用して、ワークスペースから最新のリビジョンでファイルを更新するか、ローカルドキュメントを使用して(または、PCBファイルの場合は、PCB CoDesign機能を使用して変更を比較およびマージすることで)競合を解決してください。 |
|
サーバーより先行(Git) | ローカル作業リポジトリのファイルは、リモートGitリポジトリの対応するファイルよりも新しいです。これは、ローカルファイルが変更され、保存され、ローカルリポジトリにコミットされたが、まだリモートリポジトリにプッシュされていない場合に発生します。 | |
削除予定 | プロジェクトファイルはバージョン管理から削除され、バージョン管理のコミットプロセス中にVCSリポジトリおよびデータベースから削除されます。このアイコンは、ファイルがローカル作業フォルダから欠落している場合(削除された、名前が変更された、または移動された)にも表示され、履歴 & バージョン管理 » 更新コマンドを使用してリポジトリからフォルダを再度埋めることで解決されます。 | |
マージ済み | <
プロジェクト文書の順序変更Projectsパネルの文書は、ソース文書(スキーマティック、PCBなど)、設定文書(ハーネス、Outjobなど)や、階層型設計の場合のトップレベルのスキーマティック文書など、論理的なグループまたは「フォルダ」に自動的に配置されます。各フォルダグループ内の文書は、デフォルトでは追加された順に表示されますが、グループ内で新しい順序位置にドラッグアンドドロップできます。 新しい階層型設計の場合、文書間の親子関係はProjectsパネルに表示されます。ただし、シートシンボルとポート定義によって実際に定義されるシート間の接続と設計階層のため、スキーマティック文書をドラッグアンドドロップして接続関係を定義することはできません。 ► プロジェクト階層に関する詳細は、接続性の作成と、プロジェクトオプションダイアログのオプションタブ内のネット識別子スコープセクションを参照してください。 ドキュメントの名前変更プロジェクト内の任意のPCBプロジェクト構成設計ファイル( Altium Designer プロジェクトは、保存されたドキュメントファイルへのリンクを定義して保存するため、同じドキュメントファイルへのリンクを作成する複数のプロジェクトを作成することができます。 これは、確立された設計ドキュメントを再利用する便利な方法かもしれません - 例えば、標準の電源回路図を複数のプロジェクトに含める場合 - しかし、ドキュメントの変更がリンクされているすべてのプロジェクトに影響を与えるため、推奨される方法ではありません。設計の再利用には、管理シートを確立して適用する方がはるかに良いアプローチです。 ► 設計ドキュメントの再利用と管理シートについての詳細は、管理シートのページをご覧ください。 不足しているドキュメントの管理プロジェクトファイル内で定義されたプロジェクトドキュメントがプロジェクトフォルダ内に見つからない場合(例えば、ドキュメントがWindowsエクスプローラー内で削除された場合)、それは見つからないとみなされます。見つからないファイルを含むプロジェクトを開くと、メッセージパネルに対応する通知が表示されます。ドキュメントエントリーは灰色で表示され、Projectsパネルで区別するアイコンと共に見つからないとマークされます。欠落しているドキュメントを扱うための完全な制御を提供する関連コマンドが利用可能です。Projectsパネルの欠落しているドキュメントを右クリックメニューから選択し、プロジェクトから選択されたファイルまたはすべての欠落ファイルを削除するか、ファイルへのパスを更新して(つまり、選択したファイルで欠落ファイルを置き換える)ことができます。プロジェクトがバージョン管理下にある場合、プロジェクトのVCSリポジトリから欠落ファイルを復元するためにローカル変更を元に戻すこともできます。 プロジェクトエントリの右クリックメニューからプロジェクトに既存を追加コマンドを使用して既存のファイルをプロジェクトに追加する際、追加されるファイルの名前とパスが不足しているファイルの名前とパスと同じ場合(例えば、プロジェクトをAltium Designerで開いた後に、不足しているファイルがプロジェクトフォルダに追加された場合など)、選択したファイルで不足しているファイルを置き換えるかどうかを尋ねる確認ダイアログが表示されます。 ![画像](/documentation/sites/default/files/wiki_attachments/322826/Pnl_Projects_MissingFile_ReplaceConfirmation_AD22_11.png)ローカルドキュメントをコミットまたはリリースデータと比較するワークスペースでホストされているプロジェクトの場合、ローカルに保存された回路図、PCB、およびBOMドキュメントを、このプロジェクトのコミットまたはリリースのデータと比較することができます。ローカルドキュメントを比較するために必要なデータセットを選択するコマンドは、以下の場所から選ぶことができます:
最新のコミットまたは最新のリリースコマンドが選択されると、プロジェクトデータの比較が最新のコミット/リリースエントリーのデータと開始されます。コミットまたはリリースを選択コマンドが選択されると、選択したプロジェクトのプロジェクト履歴ビューが開きます。コミットまたはリリースのタイルを選択して、ローカルに保存されたデータとこのコミット/リリースのデータを比較します。 完了すると、比較結果が新しいタブとしてデフォルトブラウザで開かれる比較ビューに表示されます。 クリップボードパネル複数のコピー/ペースト操作を可能にし、いつでもAltium Designerのドキュメントに追加(ペースト)できるように、コピーされたオブジェクトを保存して表示するために、クリップボードパネルを使用できます。 パネルにアクセスするには、詳細Preferencesダイアログの設定名であるUI.PanelClipboardの値フィールドを有効にする必要があります(デフォルトでは無効になっています)。詳細Preferencesダイアログは、Preferencesダイアログのシステム - 一般ページにある詳細ボタンをクリックすることでアクセスします。詳細Preferencesダイアログで変更が行われた場合、変更が有効になるようにソフトウェアを再起動する必要があります。 クリップボードパネルの内容と使用方法 パネルの内容 クリップボードパネルは、起源とオブジェクトのタイプに応じて、さまざまなデータ形式をサポートしています。Altium Designer環境内からコピーまたはカットされたオブジェクトのみを表示するか、またはWindowsクリップボード全体を表示するかを設定できます(この設定は、Preferencesダイアログのシステム - 一般ページの設定を通じてアクセスされます)。ただし、すべてのデータタイプが各設計エディタ(PCBエディタ、回路図エディタなど)でサポートされているわけではありません。 サポートされているデータタイプは以下の通りです: - 回路図ベース(回路図/回路図ライブラリ)またはPCBベース(PCB/PCBライブラリ)のドキュメントからコピーまたはカットされた任意の設計オブジェクト。 - 任意のテキストベースのドキュメント(例:テキストファイル、スクリプトファイル、制約ファイル、Microsoft Word/Excelドキュメントなど)からコピーまたはカットされたユニコードテキスト。 - 他のアプリケーションに貼り付けるために3Dビューモードから作成されたビットマップ画像。 - Windows拡張メタファイル画像形式(例:Microsoft Word/Excelドキュメントからカット/コピーされた単純なビットマップ画像/テキスト)。このデータタイプはPCBエディタでのみサポートされています。 パネルの使用 オブジェクトやテキストがコピー/カットされると、それに対応するエントリがパネルのメインリストエリアに、そのネイティブ形式(グラフィックまたはテキスト)で表示されます。 設計エディタウィンドウのアクティブドキュメントにアイテムを貼り付けるには、クリップボードパネルのアイテムをクリックします。貼り付けの性質は、貼り付けられるオブジェクトとターゲットドキュメントのタイプによって異なります: - 回路図ベースまたはPCBベースのオブジェクトをドキュメントに貼り付ける場合、オブジェクトはカーソルと共に浮かび上がります。ワークスペースで必要な位置にオブジェクトを配置し、クリックして配置します。 - テキストベースのドキュメントにテキストを貼り付ける場合、テキストはドキュメント内の現在のカーソル位置に配置されます。 パネルの上部にある「すべて貼り付け」ボタンを使用して、パネル内のすべてのオブジェクトをアクティブドキュメントに貼り付けます。再び、貼り付けの性質はターゲットドキュメントに依存します: - ターゲットドキュメントは、ドキュメントタイプに互換性のあるオブジェクトのみを貼り付けます。パネル内の各オブジェクトは、メインデザインワークスペースのカーソル上に順番に浮かび上がります。各オブジェクトを希望の位置に配置し、クリックして配置します。 - PCBドキュメントに貼り付ける場合、オブジェクトがサイズ変更可能であれば、ドラッグしてサイズを変更できるハンドルが表示されます。右クリックしてサイズ変更を有効にし、次の貼り付けオブジェクトに進みます。 - ターゲットドキュメントがテキストベースの場合、テキストエントリのみが貼り付けられます。パネル内の各テキストエントリは、テキストカーソルの現在位置から順に貼り付けられます。 パネル内のエントリを右クリックすると、そのエントリを貼り付けるか削除するかを選択できるコンテキストメニューが開きます。 パネルからすべての現在のエントリを削除するには、「すべてクリア」ボタンをクリックします。 注意点 - パネルからオブジェクトを貼り付けることは、設計エディタウィンドウで開かれている(アクティブな)ドキュメントがサポートしている場合にのみ可能です。たとえば、回路図ベースのオブジェクトをテキストベースのドキュメントに貼り付けようとした場合、結果はありません、その逆も同様です。 - パネルにコピーされたテキストオブジェクトは、未フォーマットのように表示されます。しかし、貼り付けられると、コピーされる前に存在していた元のフォーマットで表示されます。 - テキストベースのドキュメントにパネルからテキストを貼り付ける前に、テキストカーソルを必要な位置に配置することをお勧めします。 - 「すべて貼り付け」を使用してテキストベースのドキュメントに複数のテキストエントリを貼り付ける場合、貼り付けられたテキストは、実質的に連結されます。つまり、次のテキストエントリは最後の直後に貼り付けられます。 - クリップボードパネルの内容は設計セッションを越えて持続しません。ソフトウェアが閉じられて再起動されると、すべての内容がクリアされます。 |