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

Altium Training

Altium Essentials: Project Creation and Storage

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

概略

Altium Designerでの設計は、設計ドキュメントをまとめるプロジェクトの作成から始まります。この記事では、Altium Designerでプロジェクトを作成し、プロジェクトの種類とテンプレートを選択して、接続されたWorkspace、外部のバージョン管理リポジトリ、またはローカルフォルダーに保存先を設定する方法を説明します。また、バージョン管理、制約管理、フォルダーパス、プロジェクトパラメーターなどの設定項目も紹介します。次の設計に向けて確かな基盤を築くために、ぜひ読み進めてください。

- 利用可能なプロジェクトの保存先と、Workspaceベースの管理のメリットを理解します。
- [Create Project]ダイアログでテンプレートを選択し、プロジェクトを設定する方法を学びます。
- 新しいプロジェクトが[Projects]パネルにどのように表示されるか、また、どのような場合にプロジェクトが空の構造のみで構成されるかを確認します。
AIでさらに深掘り:

Altium Designerで作成するすべての設計は、プロジェクトから始まります。Altium Designerのプロジェクトは、作成しようとするものの具体的な実装を最終的に定義する出力を生成する、一連の設計ドキュメントをまとめたものです。たとえば、PCBプロジェクトの回路図とPCBには、プリント基板の製造に必要なファイル一式が含まれます。 一方、ハーネスプロジェクトから出力されるファイル一式は、ワイヤーハーネスの調達と組み立てに使用されます。また、マルチボードプロジェクトの論理回路図ファイルと物理アセンブリファイルからは、相互接続された複数のPCBで構成される製品全体の製造と組み立てに必要なファイル一式が出力されます。

プロジェクトの設計ドキュメント一式は、ローカルマシン上かどうかにかかわらず、アクセス可能な任意の場所から集めることができます。プロジェクトファイルがこれらを関連付け、統一された設計としてまとめます。ソフトウェアは動的コンパイルを使用して、プロジェクトのコンポーネントとその接続情報を統合したデータモデルを作成、管理します。このデータモデルを使用して、設計領域間で設計変更を反映できます。たとえば、回路図とPCBの各領域のドキュメントを同期して、相違点を解消できます。

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

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

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

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

Create Project ダイアログでは、接続中のWorkspaceでの新規プロジェクトの作成、既存の外部バージョン管理リポジトリへの新規プロジェクトの追加(作業コピーは任意の場所に配置)、ローカルハードドライブの指定フォルダーでの新規プロジェクトの作成が可能です。

  1. Locationsリストで、使用するWorkspaceの項目を選択します(設定された名前で表示されます)。この項目をリストに表示するには、Workspaceに接続している必要があります。このWorkspaceが、新しいWorkspaceプロジェクトの保存先サーバーになります。

    要するに、プロジェクト管理の主な目的は、設計プロセス全体を通してデータを安全に保存し、変更を追跡し、最終的には設計結果を、最終製品に使用する実装済みPCBなどの物理的な製品の作成につなげることです。こうしたニーズに対応するため、Altium Designerは、設計者にとっての作業を簡素化しながら、より高度で豊富な機能を提供するさまざまなプロジェクト管理方式を用意しています。これらには、ローカルのファイルベースの保存と管理、ローカル/リモートのバージョン管理システム(VCS)による保存、そしてWorkspaceの機能を中心に設計データを管理する、高度で推奨される方式があります。

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

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

    Project Creationsプロセステーマに対して1つ以上の有効なプロセス定義があるWorkspaceに接続している場合、Create Projectダイアログから作成できる新しいプロジェクトは、LocalタイプとVCSタイプに限定されます。Workspaceベースのプロジェクトの作成は、代わりに有効なプロセス定義によって制御されます。 詳細については、プロセスベースのプロジェクト作成を参照してください。

  2. Project Typeリストで、作成するプロジェクトのタイプを選択し、必要に応じて利用可能な対応テンプレートを選択します。<Empty>の項目を選択すると、初期ソースドキュメントのない空のプロジェクトが作成されます。

    詳細については、プロジェクトテンプレートの作成を参照してください。

  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を使用してこのプロジェクトの設計制約を管理できます。このオプションがオフの場合、プロジェクトには設計ルールシステムが使用されます。

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

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

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

    Altium On-Prem Enterprise Serverでは、バージョン7.2以降、SVNはサポートされていません。SVNプロジェクトの管理に伴う制限を回避するため、SVNプロジェクトをEnterprise Server Workspaceの組み込みGitリポジトリに移行することをお勧めします。この移行は、こちらの説明に従って、サーバーをアップグレードする前に実行できます。

    Altium On-Prem Enterprise ServerでのSVNサポート終了の詳細については、ナレッジベース記事「 Altium On-Prem Enterprise Server 7.2.1でのSVNの廃止 」を参照してください。

  • 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ダイアログのシステム – デフォルトの保存先ページで定義されています。必要に応じて、ボタンをクリックし、別のフォルダーを参照して選択します。これは、プロジェクトと、そのコミット先であるlocal Gitリポジトリの「作業」フォルダーです。プロジェクトは最終的に、またはコミット時に、Workspace内の集中管理された設計リポジトリ(Versioned Storage)、つまりremote Gitリポジトリにプッシュされます。

     

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

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

    Workspace側のプロジェクトレベルパラメーターは、Workspace内で編集できます。一方、設計側のパラメーターはプロジェクトファイル(*.PrjPcb)に保存され、Altium Designerで編集できます。どちらの種類のプロジェクトレベルパラメーターも、Project Optionsダイアログ(Project » Project Options)のパラメータータブで確認でき、Altium Designerで特殊文字列として使用できます。

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

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

一方、新規プロジェクトに構成ドキュメントを含むテンプレートがnot割り当てられていない場合は、プロジェクトファイル(*.PrjPcb)、つまりプロジェクトの構造のみが作成されます。その後、プロジェクトはProjectsパネルで開かれ、対応するアイコンによってScheduled for additionの状態であることが示されます。この時点でプロジェクトにドキュメントを追加することも、空の構造のままWorkspaceに保存することもできます。保存するには、Projectsパネルのプロジェクト項目に対応するSave to Serverコントロールをクリックします。この操作は、右クリックのコンテキストメニューおよびメインのFileメニューからも実行できます。続いて表示されるサーバーに保存ダイアログで、含めるファイルを選択または選択解除し、必要に応じてCommentを追加してから、ボタンで保存処理を確定します。プロジェクトがサーバーに追加されると、Projects パネルには、サーバーリポジトリ内のファイルとローカルの作業コピーが完全に同期された状態であることが、アイコンで示されます。

  • プロジェクトは、Projectsパネル内の対象Workspaceの項目の下に表示されます。この項目には、そのWorkspaceの名前が表示されます。

  • また、WorkspaceのブラウザーインターフェースのProjectsページにも、プロジェクトの項目が表示されます。

  • プロジェクトは最初に、作成した設計者(所有者)およびWorkspaceのすべての管理者に対して、読み取り/書き込みアクセス権付きで共有されます。

    プロジェクトのアクセス権の設定について詳しくは、設計の共有を参照してください。

  • 新規プロジェクトは、Workspaceのブラウザーインターフェースの設計ページから直接作成することもできます(Projectsを選択)。作成後、Altium Designerで開いて編集したり、ドキュメントを追加したりできます。

  • プロジェクトファイル(*.PrjPcb)とともに、プロジェクト構造ファイル(*.PrjPCBStructure)が作成されます。このファイルには、フラット構造か階層構造かを問わず、プロジェクトの階層に関する情報が含まれます。このファイルは、プロジェクトの動的コンパイル時(プロジェクトドキュメントを開いたとき)に再生成されます。

  • Create Projectダイアログには、 Projects パネル内のWorkspaceの項目を右クリックし、メニューから Create Project コマンドを選択してアクセスすることもできます。

プロジェクトのコピー

Altium Designer内からWorkspace プロジェクトをコピーするには、Projectsパネルでプロジェクトのエントリを右クリックし、コンテキストメニューからMake a copy コマンドを選択します。Create Project Copyダイアログで、Project Name(デフォルトでは元のプロジェクト名に接尾辞- Copyを付けた名前)、Description(初期値は入力されていません)、Folderパス(Workspace内)、およびLocal Storageパス(作業コピーの保存先)を指定します。

プロジェクトのコピーに特別な権限は必要ありません。コピーされたプロジェクトは元のWorkspace プロジェクトの完全なコピーであり、編集に関する属性も同じで、制限はありません。つまり、「読み取り専用」のプロジェクトを作成することはできません。また、コピーされたプロジェクトは元のプロジェクトと同じ設計リポジトリに作成されます。コピーの際にこのリポジトリを変更することはできません。

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

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

プロジェクトをコピーするたびに、コピーされたプロジェクトの履歴のタイムラインにProject Copiedイベントタイルが追加されます。また、コピーされたプロジェクトのProject Createdタイルには、元のプロジェクトへのリンクが含まれます。詳細については、プロジェクト履歴を参照してください。
既存のWorkspaceプロジェクトは、Open Projectダイアログからコピーできます。接続中のWorkspace内でプロジェクトを選択し、右側のInformation ペインの下部にあるOpen Project As Copyコントロールをクリックします。また、Altium DesignerのExplorerパネルでプロジェクトを参照している場合、パネルがClassic ViewではなくデフォルトのProject Viewに設定されていれば、パネル右上のCopy ボタンをクリックしてプロジェクトをコピーできます。
コピーできるのは、現在接続しているAltium Workspaceから開いたWorkspaceプロジェクトのみです。Altium Designerが現在そのプロジェクトのWorkspaceに接続されていない場合、またはプロジェクトがWorkspaceプロジェクトではない場合、右クリックメニューのMake a copy コマンドは使用できません。

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

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

  • 選択したドキュメントの種類について、PreferencesダイアログのData Management - Templatesでデフォルトを指定できる場合は、そのデフォルトをテンプレートとしてドキュメントが作成されます。
  • 作成直後のドキュメントは未保存です。

特定の種類やその他の種類のドキュメントをプロジェクトに追加します。
特定の種類やその他の種類のドキュメントをプロジェクトに追加します。

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

設計プロジェクトに含められるファイルは、Altium Designerで作成されたものだけに限りません。ほぼすべてのドキュメントをプロジェクトに含めることができます。Altium Designer内からドキュメントにアクセスすると、ファイルの拡張子とWindowsレジストリの設定に基づいて、対応する作成・閲覧ツールの特定が試みられます。対応するツールが見つかると、Altium Designerは関連付けられたエディターを、自身の編集環境内または別のアプリケーションとして起動します。つまり、テスト、文書化、背景情報、仕様に関するあらゆるドキュメントを設計プロジェクトに含めることができ、設計プロジェクトをどこに移しても、すべての関連ドキュメントを確実に一緒に持ち運べます。
Altium 365 Workspaceプロジェクトに既存のドキュメントを追加する場合、256 MBを超えるzip、7z、rarファイルには制限があることに注意してください。このようなファイルを含むプロジェクトはWorkspaceに保存できず、Gitエラーが発生します。この問題の解決方法については、ナレッジベース記事「ステータスコード471のGitエラー発生後にプロジェクトデータを修復する方法」を参照してください。

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

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

対象カテゴリのエントリを右クリックし、コンテキストメニューからRemove Allコマンドを選択することで、そのカテゴリ(サブフォルダー)内のすべてのドキュメントを親プロジェクトから削除することもできます。

プロジェクトの削除

ローカルプロジェクトを削除するには、ハードドライブからファイルを削除します。Windowsエクスプローラーでプロジェクトフォルダーを開き、その内容を削除してください。

プロジェクトが保存されている場所をWindowsエクスプローラーですばやく開くには、Projectsパネルでプロジェクトのエントリを右クリックし、Exploreコマンドを選択します。

Workspaceプロジェクト(およびコンポーネントやリリース済みデータなどのその他のWorkspaceコンテンツ)については、Altium Designer内のExplorerパネルから直接削除できる柔軟な機能が用意されています。この削除処理は「論理削除」として動作し、確認用のソースアイテムへの関連リンクなど、処理の途中でさまざまな選択肢や情報を提供します。Workspaceでは、削除されたコンテンツは専用のTrash の場所に移動され、WorkspaceのブラウザーインターフェースのTrashページから復元または完全に削除できます。

プロジェクトをTrashから完全に削除または復元できるのは、所有者または管理者のみです。

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

プロジェクトフォルダーを選択した状態でExplorerパネルをすばやく開くには、 Projectsパネルでプロジェクトのエントリを右クリックし、 Show in Explorerコマンドを選択します。

論理削除の実行例。ここでは、プロジェクトとその関連リリースを削除しています(いずれかのリリースから製造パッケージが作成されていた場合は、それらも削除されます)。
論理削除の実行例。ここでは、プロジェクトとその関連リリースを削除しています(いずれかのリリースから製造パッケージが作成されていた場合は、それらも削除されます)。

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
Nav
Contents
機能の提供状況

ご利用可能な機能は、お使いのAltiumソリューション(Altium Develop、Altium Agile Teams、Altium Agile Enterprise、または有効な契約期間中のAltium Designer)によって異なります。

実際にお使いのソフトウェアに文書化されている機能が表示されない場合は、詳細についてAltium Sales までお問い合わせください。

従来のドキュメント

Altium Designer のドキュメントは、バージョンごとに掲載されなくなりました。Altium Designer の旧バージョンのドキュメントは、Other Installers ページの Legacy Documentation の項目をご覧ください。

Contents