Altium Designerでのプロジェクトとドキュメントの作成

Altium Designer で作成するあらゆる設計の出発点はプロジェクトです。Altium Designer のプロジェクトは、設計ドキュメント一式をまとめて管理し、その出力によって最終的に、作成したいものの単一の実装を定義します。たとえば PCB プロジェクトでは、回路図と PCB に、プリント基板を製造するために必要なファイル一式が含まれます。これに対して、ハーネスプロジェクトから出力するファイル一式はワイヤリングハーネスの購入および組み立てに使用され、マルチボードプロジェクトでは、論理回路図と物理アセンブリファイルから、複数の接続された PCB を含む完成品を製造・組み立てするためのファイル一式が出力されます。

プロジェクトの設計ドキュメント一式は、マシン上のローカルを含む任意のアクセス可能なソースから取りまとめることができ、プロジェクトファイルがそれらを統合設計として関連付けます。ソフトウェアは動的コンパイルを使用して、プロジェクトのコンポーネントとその接続性の統合データモデルを作成・管理します。このデータモデルは、設計ドメイン間で設計変更を伝播させるために使用できます。たとえば、回路図ドメインと PCB ドメインのドキュメント間の差異を解消するために同期を行う、といったことが可能です。

プロジェクトドキュメントは、Altium Workspace 内に作成して保存することも、バージョン管理システム内に保存することも、利用可能なネットワーク上のファイルとしてローカルに保存することもできます。

以下のセクションでは、新しいプロジェクトの作成方法と、既存プロジェクトへの設計ドキュメントの追加方法について説明します。

Create Project ダイアログを使用して新しいプロジェクトを作成する

新しいプロジェクトは、Altium Designer 内で Create Project ダイアログ（File » New » Project）を使用して作成できます。

1. Locations リストで Workspace のエントリ（定義されている名前で表示されます）を選択します。このオプションを一覧に表示するには、Workspace にアクティブに接続している必要があります。これが、新しい Workspace プロジェクトを保存するターゲットサーバーになります。

   要するに、プロジェクト管理は、設計プロセス全体を通じて変更を安全に保存・追跡し、最終的にはその設計成果を、最終製品で使用される実装物（たとえば実装済み PCB）へとつなげることに主眼があります。これらのニーズに応えるため、Altium Designer は、より高度な洗練度と機能を段階的に提供しつつ、設計者の視点ではプロセスを簡素化する、さまざまなプロジェクト管理アプローチを用意しています。ローカルのファイルベースの保存・管理から、ローカル／リモートの Version Control System (VCS) を用いた保存方式、そして推奨される高度な形態として、Workspace の機能を中心に設計データ管理を行う方式までをカバーします。

   接続された Workspace とその内部 VCS サービスは、Altium Designer プロジェクトをホストして管理し、簡素化された VCS 操作、設計コラボレーション機能、設計データの高度な共有、履歴追跡、ライフサイクル管理など、さらに多くの機能を提供します。Workspace と統合されたプロジェクトは、Projects パネルなどから Altium Designer で直接アクセスでき、また Workspace 自体のブラウザベースのインターフェースからもアクセスできます。

   Workspace が提供するサービスに組み込まれたインテリジェンスにより、VCS 操作などのタスクは簡素化・自動化され、ユーザーアクセス制御（共有）、コメント、履歴といった追加の設計コラボレーション機能も Altium Designer 内から直接利用できます。その結果、堅牢で安全なプロジェクト保存形式と保存場所が実現し、共同設計の中心点となり得ます。

   Project Creations プロセステーマに対して 1 つ以上のアクティブなプロセス定義がある Workspace に接続している場合、gh the Create Project ダイアログ を通じて新しいプロジェクトを作成できるのは、Local および VCS タイプのプロジェクトのみに制限されます。代わりに、Workspace ベースのプロジェクト作成は、アクティブなプロセス定義の管理下に置かれます。詳細は Process-based Project Creation を参照してください。

2. Project Type リストで作成したいプロジェクトの種類を選択し、必要に応じて利用可能なテンプレートから選択します。<Empty> エントリは、初期ソースドキュメントを含まない空の（シェル）プロジェクトを作成します。

   詳細は Creating a Project Template を参照してください。

3. Project Name を入力し、必要に応じてプロジェクト Description も入力します。

   プロジェクト名は で始まり、A-Z、a-z、0-9 を含めることができます。アンダースコア、ダッシュ、スペースも使用できますが、スペースは名前の途中にのみ使用でき（先頭および末尾のスペースは無視されます）、次の単語は使用できません：AUX、COM1-COM9、LPT1-LPT9、CON、NUL、PRN。さらに、名前には次の文字を含めることはできません：\ . / ? % * : | " < >。

Create Project ダイアログには、さらに次のオプションがあります：

• Version Control オプション（デフォルト）をオンにすると、履歴や高度な共有機能など、VCS のすべての機能がプロジェクトに適用されます。オフにすると、プロジェクトは Workspace に保存され、ローカルコピーと同期されます。これは Simple Sync 形式の「ミラー」プロジェクトです。

  Version Control オプションは、Altium 365 Workspace に接続している場合にのみ利用できます。Enterprise Server Workspace に接続している場合、このオプションは実質的にオンになります。

• PCB タイプのプロジェクトを作成する場合、Constraint Management オプション をオンにすると、このプロジェクトの設計制約を Constraint Manager で管理します。オプションが無効の場合、このプロジェクトでは design rules システムが使用されます。

  Constraint Management オプションは、System.ConstraintManager オプションが Advanced Settings ダイアログ で有効になっている場合、Create Project ダイアログでデフォルトで有効になります。

• Enterprise Server Workspace に接続している場合、Repository ドロップダウンメニュー（存在する場合）には、Workspace の Version Control Service を通じて管理され、かつ使用できるように共有されているすべての設計リポジトリが一覧表示されます。新しいプロジェクトとそのファイルを保存するリポジトリを選択してください。デフォルトでは、Git ベースの単一リポジトリ（Versioned Storage）が利用可能です。SVN タイプのリポジトリを選択した場合、リポジトリ内の代替ターゲットフォルダを指定または参照するための追加の Repository Folder オプションが利用できます。

  Repository ドロップダウンメニューは、SVN リポジトリの使用が有効なバージョンまたはサーバー製品から Enterprise Server をアップグレードした場合にのみ表示されます。別のケースとして、Enterprise Server がすべての Workspace 設計プロジェクトを収容する単一の Git ベース設計リポジトリを提供している場合は、Repository ドロップダウンメニューは表示されません。

  SVN は、バージョン 7.2 以降の Altium On-Prem Enterprise Server ではサポートされません。SVN プロジェクト管理の制限を回避するため、SVN プロジェクトは Enterprise Server Workspace の組み込み Git リポジトリへ移行することを推奨します。これは、here に記載のとおり、サーバーのアップグレード前に実施できます。

  Altium On-Prem Enterprise Server における SVN 廃止の詳細については、ナレッジベース記事 SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1 を参照してください。

• Advanced コントロールをクリックしてフォルダパスを指定します。

  • Folder フィールドを使用して、Workspace のフォルダ構造内でプロジェクト用フォルダを作成する場所を指定します。新規プロジェクトのデフォルトパスは、Workspace のブラウザインターフェースの Admin – Settings – Projects ページで指定されます（デフォルトでは Projects\<ProjectName>）。必要に応じて ボタンをクリックし、別の Workspace フォルダを参照して選択してください。

    接続中の Workspace でプロジェクトを作成するユーザーが、デフォルトのプロジェクトフォルダに対する書き込み権限を持っていない場合、システムは新しいプロジェクトを保存するためのユーザー固有の Personal Folder 構造を自動的に作成します。これは、メンバーのメールアドレス（Altium 365 Workspace の場合）またはユーザー名（Enterprise Server Workspace の場合）に基づくトップレベルフォルダとして表示され、その下にそのユーザーのプロジェクトを保存する My Projects サブフォルダが作成されます。このフォルダ構造／階層は、サインインしているユーザーと管理者のみが利用でき、他のユーザーには表示されません。詳細は Managing Project Creation Permissions （Altium 365 Workspace、Enterprise Server Workspace）を参照してください。

  • Local Storage フィールドを使用して、プロジェクトのローカル版をハードドライブ上のどこに保存するかを指定します。デフォルトの場所は、Preferences ダイアログの System – Default Locations ページで定義されています。必要に応じて ボタンをクリックし、別のフォルダ場所を参照して選択してください。ここはプロジェクトの「作業」フォルダであり、コミット先の local Git リポジトリでもあります。プロジェクトは最終的に、またはコミット時に、Workspace 内の集中設計リポジトリ（Versioned Storage）へプッシュされます。これが remote Git リポジトリです。

   

• プロジェクトに関連付けられ、Workspace に保存されるカスタムの Name/Value パラメータ・ペアを追加／削除するには、Parameters リスト領域を使用します。 ボタンで新しいパラメータの Name-Value ペアをリストに追加し、または ボタンで選択したペアを削除します。Name および Value フィールドは最大 255 文字まで入力できます。Workspace プロジェクトを作成すると、これらの Workspace プロジェクト・パラメータは、新しいプロジェクトとともに Workspace 側のプロジェクトレベル・パラメータとして Workspace に保存されます。

  ダイアログの Project Type リストでプロジェクトテンプレートを選択すると、Parameters リスト領域にそのテンプレートのパラメータが読み込まれます。必要に応じて、これらのパラメータ（名前および／または値）を変更したり、削除したりできます。Workspace プロジェクトを作成する際、選択したテンプレート由来のパラメータは、パラメータ名が変更されていない場合は設計側のプロジェクトレベル・パラメータとして保存されます。名前が変更されている場合は、Workspace 側のプロジェクトレベル・パラメータとして保存されます。

  Workspace 側のプロジェクトレベル・パラメータは Workspace 内で編集できます。一方、設計側パラメータはプロジェクトファイル（*.PrjPcb）に保存され、Altium Designer で編集できます。両タイプのプロジェクトレベル・パラメータは、Project Options ダイアログ（Project » Project Options）の Parameters タブで確認でき、Altium Designer では Special Strings として使用できます。

必要に応じてプロジェクトを定義したら、 ボタンをクリックします。指定したローカルおよび Workspace フォルダに新しいプロジェクト構造が作成されます。プロジェクトは Projects panel で開かれ、リモートの設計リポジトリ（Workspace 内）とローカル（作業コピー）リポジトリ間で完全に同期された状態が反映されます。これは関連する アイコンで示されます。Version Control オプションをオフにして作成した場合（Altium 365 Workspace のみで利用可能）、ミラーされたプロジェクトは Projects パネルに関連する アイコン付きで表示されます。

新規作成したプロジェクトは、Workspace の Versioned Storage 設計リポジトリにコミットされます。

または、新しいプロジェクトに構成ドキュメントを含むテンプレートが割り当てられている場合、プロジェクトファイル（*.PrjPcb）が作成され、したがってプロジェクトの構造のみが作成されます。その後、プロジェクトは Projects panel で開かれ、関連する アイコンで示される Scheduled for addition 状態として表示されます。この時点で、プロジェクトにドキュメントを追加することも、現在の空の状態（シェル状態）のまま構造を Workspace に保存することもできます。保存するには、Projects パネル内のプロジェクトエントリに関連付けられた Save to Server コントロールをクリックします（右クリックのコンテキストメニューおよびメインの File メニューからも利用可能）。続く Save to Server ダイアログ で、含めるファイルを選択／解除し、任意の Comment を追加してから、 ボタンで保存処理を確定します。プロジェクトがサーバに追加されると、Projects panel は、サーバリポジトリ内のファイルとローカル作業コピー間で完全に同期された状態を、 アイコンで示して反映します。

プロジェクトのコピー

Altium Designer 内から Workspace プロジェクトをコピーするには、Projects パネルでプロジェクトのエントリを右クリックし、コンテキストメニューから Make a copy command を選択します。Create Project Copy ダイアログで、Project Name（デフォルトでは元のプロジェクト名にサフィックス - Copy が付いたもの）、Description（事前入力されません）、Folder パス（Workspace 内）、および Local Storage パス（作業コピー先）を指定します。

Workspace Folder はデフォルトで、元のプロジェクトが保存されているのと同じフォルダになります。必要に応じてフォルダを変更するには をクリックし、Choose Folder ダイアログ（Explorer パネルの簡易版）を開きます。Local Storage はデフォルトで、Preferences ダイアログの System - Default Locations ページで定義された場所を使用するように設定されます。必要に応じてこの場所を変更するには をクリックし、標準の Windows ダイアログを開きます。

Altium Designer 内から Workspace プロジェクトをコピーします。

設計ドキュメントの追加と削除

プロジェクトが確立されると、設計ドキュメントをアクティブプロジェクトに追加、編集、または削除できます。新しい設計ドキュメントをプロジェクトに追加する最も簡単な方法は、Projects パネルでプロジェクト名を右クリックし、コンテキストメニューのオプションから Add New to Project を選択することです。別の方法として、メインメニューの Project » Add New to Project サブメニューから必要なドキュメントタイプを選択し、アクティブプロジェクトに新しいドキュメントを追加します。

特定または別タイプのドキュメントをプロジェクトに追加します。

テキストファイル、PDF、スプレッドシートなど、プロジェクトに関連する他の種類のドキュメントもプロジェクトに追加できます。その場合は Add Existing to Project オプション（またはアクティブドキュメントのエディタのメインメニューから Project » Add Existing to Project コマンド）を使用し、Choose Document to Add ブラウザダイアログの File Type ドロップダウンリストを All Files (*.*) に設定して、すべてのファイルタイプにアクセスできるようにします。

プロジェクト構造からドキュメントを削除するには、Projects パネルでその名前を右クリックして Remove from Project メニューオプションを選択するか、メインメニューから Project » Exclude from Project コマンドを選択します。次の選択を求められます。

• Delete File – ソースとなるドキュメントファイル自体を完全に削除します。

• Exclude from Project – プロジェクトからそのドキュメントへのリンクを解除します（ソースのドキュメントファイル自体は削除しません）。現在デザインエディタのウィンドウで開いている場合は、親プロジェクトからは削除されますが、パネル上ではフリードキュメントとして開いたまま残ります。一方、現在デザインスペースで開いていない場合は、削除によって実質的に閉じられます。

  

プロジェクトの削除

ローカルプロジェクトの場合、プロジェクトの削除はハードドライブ上のファイルを削除することを意味します。Windows Explorer でプロジェクトフォルダを開き、その内容を削除してください。

Workspace プロジェクト（およびコンポーネントやリリース済みデータなどの他の Workspace コンテンツ）については、Explorer panel から Altium Designer 内で直接削除できる柔軟な機能が用意されています。これは「ソフト削除」として動作し、削除の進行に伴って、より多くのオプションや情報（確認用としてソース項目への関連リンクなど）を提供します。Workspace では、削除されたコンテンツは専用の Trash location に移動され、Workspace のブラウザインターフェースの Trash page から復元するか、完全に削除できます。

Workspace プロジェクトをソフト削除するには、Explorer panel でプロジェクトフォルダに移動し、そのエントリを右クリックして、コンテキストメニューから Delete Folder コマンドを選択します。表示される Confirm Delete ダイアログで削除を確認してください。プロジェクトにリリース済みデータが含まれている場合は、別の確認ダイアログが開き、そのデータも削除されることが通知されます。続行するには Delete をクリックします。

ソフト削除の動作例。ここでは、プロジェクトが関連するリリースとともに削除されています（いずれかのリリースから製造用パッケージが作成されていた場合、それらも削除されます）。