コンテンツの作成と編集

アイテムは接続された Workspace 内に直接作成され、アイテムの製造や表現に必要なすべてのデータは、そのアイテム番号に関連付けられて Workspace に保存されます。コンテンツタイプに応じて、アイテムは手動で作成することも、保存、アップロード、リリースのプロセスの一環として自動的に作成することもできます。すべてのコンテンツタイプは、Altium Designer の Explorer パネルから作成できます。コンポーネントを扱う場合は、Components パネルからも作成できます。

アイテムは接続された Workspace 内に作成されます。Altium Designer の Explorer パネルには、Workspace を操作するためのすべてのインターフェースが用意されています。

アイテムの作成

必要なフォルダーを定義したら、Workspace 内にコンテンツを作成できます。アイテムを作成するには、適切なフォルダーを選択し、パネルのアイテムグリッド領域で右クリックして、Create Item サブメニューからいずれかのコマンドを選択します。また、フォルダーが空の場合は、領域の中央にある Add an item コントロールからメニューにアクセスできます。

Explorer パネルのアイテムグリッド領域内で右クリックすると、コンテンツの作成に関するコマンドにアクセスできます。

Create New Item ダイアログが表示され、アイテムを完全に定義するために必要なすべてのコントロールを使用できます。

新規アイテムの作成ダイアログで、新しいアイテムの詳細を指定します。

多くのコンテンツタイプでは、作成後に該当する設計ドキュメントを編集し、そのコンテンツの初期リビジョンにリリースできます。これを行うには、Create New Item ダイアログの下部にある Open for editing after creation オプションを有効にします（デフォルトで有効になっています）。アイテムが作成され、対応する一時エディターが開き、そのアイテムのデータを作成できる状態になります。特定のコンテンツタイプの操作について詳しくは、表にリンクが記載されている専用ページを参照してください。

アイテムIDについて

コンテンツを作成する親フォルダーの重要な設定の1つが、そのフォルダーに使用するItem Naming Schemeです。これは、そのフォルダー内に作成される各アイテムの一意のIDの形式を定義します。フォルダーレベルでアイテム命名体系を定義することで、正しいID命名体系に従いながら、そのフォルダー内にコンテンツをすばやく作成できます。これは、対象のWorkspace内に手動で事前作成した既存のアイテムにリリースするのではなく、アイテムをその場で自動作成する場合に特に有効です。

フォルダーの種類またはコンテンツの種類を表す短縮コードを使用した、いくつかのデフォルトの体系例が用意されています（コードの一覧については、このドキュメントの前半にある表を参照してください）。デフォルトの命名体系を使用すると、ソフトウェアはWorkspace全体と既存コンテンツの識別子をスキャンし、その体系に基づいて次に使用可能な一意のIDを自動的に割り当てます。

アイテムの命名をすべて手動で管理する必要がある場合は、[NO ITEM NAMING SCHEME]を選択します。この場合、アイテムの作成時に一意の識別子を定義する必要があります。システムでは識別子が重複するアイテムを作成できないため、識別子を手動で割り当てる際は、使用済みの識別子を把握しておく必要があります。

親フォルダーのアイテム命名体系は、そのフォルダー内に作成される各アイテムの一意のIDに適用されます。

フォルダーレベルのItem Naming Schemeの設定にかかわらず、自動的に決定されたIDはアイテムレベルで自由に上書きできます。必要に応じて、Create New ItemダイアログでIDを変更してください。

アイテムIDの体系の選択

アイテムに使用できる命名・採番体系は無数にあり、ドキュメント内の画像に示されているものは単なる例です。最適な採番体系については、多くの議論が公開されています。一般的に、専門家の間では、短く、意味を持たない、数字のみの採番体系が最適であるという見解が一致しています。「意味を持たない」とは、製品カテゴリー、サブカテゴリー、場所などの情報を採番体系に組み込まないということです。新しいアイテムには、単純に連番の次の番号を付与します。

識別子は長くなるほど、アイテムIDを記録したり思い出したりする際に人が間違える可能性が高くなるため、長さは重要です。経験や学術研究から、文字数が増えるほどデータ入力の誤りが増加することがわかっています。人が容易かつ確実に思い出せる桁数は、7桁と考えられています。一定の長さを超えると誤りは加速度的に増加し、15文字では誤りの確率がほぼ100%になります。

組織においてアイテムIDに識別のための意味を持たせることが重要な場合は、複合識別子が解決策となる可能性があります。この場合は、英数字によるシンプルな品目分類コードを接頭辞として使用することをお勧めします。たとえば、ID D-820-0001を考えてみましょう。ここで、コード内のDはDesignを表し、設計に使用するアイテムであることを意味します。続く3桁では、最初の1桁で周辺基板などの製品カテゴリーを示し、2桁目と3桁目でベアボード（1X）または実装済み基板（2X以上）を示すことができます。アイテムIDの最後の4桁は、意味を持たない単純な連番です。

Workspaceアイテムの初期リビジョンのIDの設定

ローカル設計からWorkspaceベースの設計へ移行するには、既存のデータをWorkspaceに移行する必要があります。このようなデータは、すでに何度も改訂され、組織全体で認識されているリビジョン番号が付与されている場合があります。たとえば、Magno-Synthetic Digitizer基板のrev.3がすでに出荷され、rev.4で改良を加える予定になっていることもあります。Workspaceへのリリース時に初期リビジョンが1に戻ってしまうと、控えめに言っても混乱を招きます。組織内だけでなく、さらに重要な顧客にとっても同様です（顧客は、現在使用しているrev.3よりも新しいバージョンを期待しているのです）。

このため、Altium Designerには、Workspaceに新しく作成するアイテムの初期リビジョンのIDを手動で設定する機能が用意されています。

初期リビジョンのIDの設定

通常どおり、Workspaceに必要な新しいアイテムを作成します。作成後、アイテムを右クリックしてPropertiesを選択し、Edit Itemダイアログを開きます。ダイアログのAdvanced領域を展開し、Revision IDフィールドの右側にあるボタンをクリックします。Set Initial revision Id valuesダイアログが表示され、要件に合わせてIDを設定できます。選択したリビジョン命名体系に従って、IDの各階層を変更するためのフィールドが必要に応じて表示されます。

Explorerパネルでプロジェクト関連のアイテム（PCB製造データ、PCB実装データ、PCBプロジェクト設計）にアクセスするには、プロジェクトをそのClassic Viewで表示していることを確認してください。Project Viewから手動で切り替える必要がある場合があります。切り替えコマンドは、パネル右上のボタンに関連付けられたメニューから利用できます。

IDの各階層を設定します（使用しているリビジョン命名方式に応じて設定してください）。

Workspaceを通じたコンテンツの直接作成と編集

接続先のWorkspaceは、Altium Designerで使用するあらゆる種類の設計データの保存と管理を一元化するための、柔軟で安全な方法を提供します。回路図モデルからコンポーネントまで、管理対象回路図シートから完成したPCB設計まで、Workspaceは電子設計データの保存と管理に最適な方法を提供します。

Workspaceの強力な特長の1つは、Direct Editingをサポートしていることです。「直接編集」とは、具体的に何を意味するのでしょうか。Workspace内のモデル、コンポーネント、さらには管理対象シートを右クリックして、Editを選択できるということです。するとAltium Designerの一時エディターでファイルが開き、編集できるようになります。編集が完了したら、Workspaceに保存するだけです。編集したファイル自体について気にする必要はありません。編集内容はWorkspaceに安全に保存されているため、そのファイルは不要となって削除され、一時エディターも閉じられます。

直接編集を使用すると、ソースデータを別途バージョン管理する手間から解放されます。Workspaceから直接取得した最新のソースを一時エディターに読み込み、サポートされている種類のアイテムを簡単に編集できます。編集が完了すると、編集対象は親アイテムの次の予定リビジョンにリリース（または再リリース）され、一時エディターが閉じられます。ハードドライブにファイルが残ることも、正しいソースや最新のソースを使用しているか迷うことも、別のバージョン管理ソフトウェアを維持する必要もありません。Workspaceがすべてを高い整合性で処理し、データの変更を大幅に効率化します。

直接編集に対応するコンテンツの種類

次のWorkspaceコンテンツの種類が直接編集に対応しています。

アイテムの初期リビジョンの編集

Explorerパネルから、サポートされているコンテンツの種類のアイテムを作成する際には、作成後に関連するデータエンティティを編集し、そのアイテムの初期リビジョンにリリースすることを選択できます。つまり、Workspaceの外部でソースデータを作成してからリリースする代わりに、直接編集によって、空のアイテムを作成した時点からソースの作業を開始できます。編集が完了すると、エンティティは親アイテムの初期予定リビジョンにリリースされ、一時エディターが閉じられます。

この機能を利用するには、Create Itemダイアログの下部にあるOpen for editing after creationオプションを有効にします。この機能の利便性を考慮して、このオプションはデフォルトで有効になっています。アイテムが作成され、対応する一時エディターが開き、メイン設計ウィンドウに該当ドキュメントがアクティブドキュメントとして表示されます。このドキュメントには、アイテムとリビジョンに基づき、<Item>-<Revision>.<DocumentExtension>の形式で名前が付けられます。

下の画像は、新しいシンボルアイテム（SYM-001-0031）を作成する際の、この機能の動作を示しています。一時的な回路図シンボルエディターが開き、必要に応じてシンボルを定義するためのドキュメントが表示されます。

Workspaceから直接、シンボルアイテムの初期リビジョンを編集する例。一時的な回路図シンボルエディターに、回路図シンボルを定義するためのドキュメントが表示されます。

直接編集の操作コントロール

直接編集時に使用する3つのコントロールは、クイックアクセスバー（メインアプリケーションウィンドウの左上）、またはアクティブな一時エディターの Standard ツールバー（利用可能な場合）から簡単にアクセスできます。

• ​ – Save Active Document。このボタンを使用して、ドキュメントに加えた変更を保存します。Workspaceに最終的にリリースする前に、後で戻ってさらに変更を加えたい場合は、現在の変更を 保存しておくことができます。

• / – Save to Server。このボタンを使用して、ドキュメントをWorkspaceにリリース（実質的には保存してリリース）し、対象アイテムの初期（計画済み）リビジョンまたは次の リビジョンに格納します。Create Revisionダイアログ（またはEdit Revisionダイアログ）が表示され、名前と説明を変更したり、必要に応じてリリースノートを追加したりできます。リリース後、ドキュメントとエディターは閉じられます。

   

   

   

   

   

  該当する場合は、必要に応じて、保存するアイテムの現在のリビジョンに関連する（参照している）親アイテムのリビジョンも更新できます。 これは、デフォルトで有効になっている Update items related to <ItemRevision> オプションで制御します。このオプションは、次の場合にのみ表示されます。

  • コンポーネントアイテムのリビジョンによって参照されているドメインモデル（シンボル、フットプリント、シミュレーションモデル、ハーネス配線モデル）の新しいリビジョンを作成する場合。

  • コンポーネントアイテムのリビジョンによって参照されているコンポーネントテンプレートの新しいリビジョンを作成する場合。

  • フットプリントモデルアイテムのリビジョンによって参照されている3Dモデルの新しいリビジョンを作成する場合。

  関連するすべての親アイテムで、アイテムの現在のリビジョンを引き続き使用する場合は、このオプションを無効にしてください。その場合、アイテム自体のみが保存されます。

  編集したコンポーネントをWorkspaceに保存する際に、その 現在のライフサイクル状態を維持できます。 再保存時にEdit Revision ダイアログ で使用できる Preserve lifecycle state (not recommended) オプションで制御します。このオプションを有効にすると、新しいリビジョンは自動的に前のリビジョンと同じライフサイクル状態に設定されます。

  また、編集したドメインモデル（シンボル、フットプリント、シミュレーションモデル、ハーネス配線モデル）をAltium Platform上のWorkspaceに保存する際に、そのモデルを参照する関連Workspaceコンポーネントの 現在のライフサイクル状態を維持できます。 再保存時にCreate Revision ダイアログ で使用できる Preserve lifecycle state (not recommended) オプションで制御します。モデル自体の現在のライフサイクル状態は維持されません。

  この機能は、Allow to skip lifecycle state change for new revisions 操作権限が割り当てられているユーザーが 利用できます（詳細は「Workspaceのグローバル操作権限の設定」を参照）。

  編集中のドキュメントをWorkspaceに保存するには、Projectsパネルのドキュメントエントリの横にある Save to Server コントロールも 使用できます。

• / – Discard Local Changes。編集をキャンセルする場合は、このボタンを使用します。一時ファイル（編集を行うためだけに使用）は削除され、 Projects パネルからそのエントリも削除されます。対象アイテムには何もリリースされません。

  直接編集セッションで使用する一時ファイルでは、1回の編集セッションで更新プロセスを完了する必要はありません。必要に応じて作業内容を保存し、ファイルを閉じることができます。Altium Designerはこれを特殊なファイルとして認識し、 Projects パネルの <SourceWorkspaceName> フォルダーに保持するため、準備ができたときに再度開いて、更新と再リリースのプロセスを完了できます。

これらのコントロールは、Projects パネルのドキュメントエントリを右クリックしたときのメニューからも、コマンドとして アクセスできます。また、多くのエディターでは、メインの File メニューから、Save（ショートカット：Ctrl+S）、Save to Server（ショートカット：Ctrl+Alt+S）、Discard Local Changes の各コマンドとしても使用できます。

アイテムの既存リビジョンの編集

どの段階でも、Workspace内のサポート対象コンテンツタイプのアイテムの任意のリビジョンに戻り（Explorerパネルから）、直接編集できます。リビジョンを右クリックし、コンテキストメニューからEditコマンドを選択します。一時エディターが再び開き、そのリビジョンに含まれるドキュメントが編集用に開かれます。必要な変更を加えたら、ドキュメントをアイテムの次のリビジョンとしてリリースします。

既存のDraftsmanドキュメントテンプレートの直接編集を開始するコマンドにアクセスする例。

一時ファイルの動作

Workspaceデータを編集するには、Altium Designerで編集できるファイルを作成する必要があります。このために一時ファイルが作成されます。たとえば、シンボルアイテムを右クリックしてEditを選択すると、一時的なSchLibファイルが作成され、Altium Designerで開かれます。編集を終えてSave to Serverを実行すると、Workspaceデータが更新された直後にこのファイルは削除されます。

ただし、リリースせずにファイルをSaveおよびCloseした場合、ファイルはProjectsパネルに残ります。これは、1回の編集セッションで更新作業を完了する必要がないようにするためです。必要に応じて作業内容を保存してファイルを閉じることができます。Altium Designerはこれが特別なファイルであることを認識し、Projectsパネルの<WorkspaceName>エントリ（例： /）の下に保持するため、準備ができた時点で再び開き、更新と再リリースの作業を完了できます。

一時ドキュメントには引き続きアクセスできるため、1回の編集セッションですべての変更を完了する必要はありません。

Componentsパネルからのコンポーネントの直接編集

日々のコンポーネント管理では、Componentsパネルから直接編集できます。このコンテンツタイプについては、Explorerパネルよりもこちらを使用することが多いでしょう。必要なコンポーネントを探して選択し、右クリックしてコンテキストメニューからEditコマンドを選択します。コンポーネントエディターの一時インスタンスがSingle Component Editingモードで開き、必要な変更を加えられる状態になります。

Componentsパネルからの直接編集の例。

コンポーネントエディターからのモデルの直接編集

コンポーネントエディターのSingle Component Editingモードでコンポーネントを編集する際は、直接編集の仕組みを使用して、リンクされたドメインモデルを編集できます。コンポーネントが現在使用（参照）しているモデルを変更するには、そのプレビューの右上にある コントロールをクリックします。そのモデルタイプに対応する一時エディターが開き、必要に応じてモデルを変更できる状態になります。変更が完了したら、保存してエディターを閉じるだけです。変更したモデルが、Models領域に再びリンクされた状態で表示されます。コンポーネントをリリースすると、変更したモデルも自動的にWorkspaceにリリースされ、その親アイテムの次のリビジョンになります。

コンポーネントエディターのSingle Component Editingモードを使用してコンポーネントを直接編集中に、そのコンポーネントが参照する既存のモデルを直接編集する例。

ドメインモデル保存時の親コンポーネントの更新

親コンポーネントを更新するためのオプションは、変更したWorkspaceモデルを対象のWorkspaceに保存し直す際に表示されるCreate Revisionダイアログにあります。このオプション（Update items related to <ModelItemRevision>）は、デフォルトで有効になっています。

再保存するWorkspaceモデル（この例ではシンボル）を参照しているWorkspaceコンポーネントを更新するオプションへのアクセス。

Create RevisionダイアログでOKをクリックすると、変更したモデルがWorkspaceに保存され、対応する一時エディターが閉じます。そのWorkspaceモデルを参照するすべてのWorkspaceコンポーネントは、新しいリビジョンを使用するように自動的に再保存されます（各コンポーネントの次のリビジョンが自動的に作成され、保存されます）。

アイテムの新しいリビジョンへのデータのアップロード

ほとんどのコンテンツタイプでは、該当するデータファイルをアップロードして新しいリビジョンを作成できます。

アイテムの新しいリビジョンへのデータのアップロードには、いくつかの方法があります。

アップロードメニュー

Explorerパネルで目的のアイテムを右クリックし、コンテキストメニューからUploadコマンドを選択すると、ファイルをアップロードできます。Create New Revisionダイアログが表示され、必要に応じて名前や説明を変更し、リリースノートを追加できます。ダイアログのSources領域を使用して、目的のファイルを読み込みます。Windowsエクスプローラーからこの領域にファイルをドラッグ＆ドロップできます。または、ボタンをクリックすると、Add Filesダイアログ（標準のWindowsの「開く」ダイアログ）が表示されます。このダイアログで目的のファイルを参照し、開きます。

アップロードの例。この例では、アップロードする3Dモデルファイルを手動で指定し、対象の3Dモデルアイテムにアップロードしています。

目的のファイルをドロップするか、ファイルを選択してOpenボタンをクリックすると、Sources領域にそのファイルのエントリーが表示されます。

バイナリファイルなど、1つのリビジョンへの複数ファイルのアップロードをサポートするコンテンツタイプでは、選択したファイルが追加され、ダイアログのSources領域に一覧表示されます。一覧の内容を調整するには、必要に応じてファイルを追加するか、ファイルを選択して削除します（ボタンをクリック）。Sources領域では、標準の複数選択操作（Ctrl+Click、Shift+Click、クリック＆ドラッグ）を使用して複数のファイルを選択できます。

OKボタンをクリックしてアップロードを実行します。コンテンツタイプに応じて、アップロードしたファイルに関する情報が、ExplorerパネルのアイテムリビジョンのDetailsおよび／またはPreview アスペクトビュータブに表示されます。

Explorerパネルに戻り、保存したアイテムのリビジョンを参照します（ここでは3Dモデルアイテムの例）。Previewアスペクトビュータブに切り替えると、グラフィカルな表示を確認できます（対応している場合）。

Windowsエクスプローラーからのドラッグ＆ドロップ

Windowsエクスプローラーのソースフォルダーで選択したデータファイルをドラッグし、Explorerパネルの目的のアイテムにドロップすることでも、該当するファイルをアップロードできます。Create New Revisionダイアログが表示され、ドラッグしたファイルがSources領域に一覧表示されます。必要に応じてRelease Notesを追加し、OKボタンをクリックします。

一部のコンテンツタイプでは、Name（拡張子を含むファイル名。複数ファイルの場合、各エントリーはセミコロンで区切られます）とDescription（Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate>形式。複数ファイルの場合、各エントリーはセミコロンで区切られます）を変更する必要があります。複数ファイルをサポートするコンテンツタイプでファイルを追加する必要がある場合は、ボタンをクリックしてファイルを参照するか、Sources領域にファイルをドラッグ＆ドロップします。ファイルを削除するには、一覧でファイルを選択し、ボタンをクリックします。

ドラッグ＆ドロップによるアップロード。ここでは3Dモデルの例を示しています。

Workspaceコンテンツの複製

Explorerパネルでは、さまざまなWorkspaceアイテムを複製できます。必要なコンポーネント、ドメインモデル、回路図シート、テンプレートを一から作成する代わりに、既存のものを簡単に複製できます。直接編集により、元のアイテムリビジョンのソースデータのコピーに必要な変更を効率よく加え、その結果を同じタイプの新しいアイテムの初期リビジョンとしてリリースできます。短時間で作業が完了するため、白紙の状態から始めることなく、Workspaceのコンテンツをすばやく拡充できます。

次のコンテンツタイプを複製できます：

• コンポーネント
• フットプリント
• シンボル
• シミュレーションモデル
• コンポーネントテンプレート
• 管理対象回路図シート
• 回路図テンプレート
• プロジェクトテンプレート
• Draftsmanドキュメントテンプレート
• Draftsmanシートテンプレート
• レイヤースタック
• OutputJob

対応するコンテンツタイプを複製するコマンドには、Explorerパネルから次の方法でアクセスできます。

• 複製元のアイテムリビジョンのエントリを右クリックし、コンテキストメニューからOperations » Cloneコマンドを選択します。
• 複製元のアイテムリビジョンのエントリを選択し、キーボードショートカットCtrl+Dを使用します。

Cloneコマンドは、Explorerパネル全体で、対象のアイテムリビジョンが表示される以下の場所などで使用できます。

• フォルダー内のメインアイテム一覧。
• Childrenアスペクトビュータブ（管理対象回路図シートアイテムを表示している場合）。
• Where-usedアスペクトビュータブ（コンポーネントアイテム、シンボルアイテム、フットプリントアイテム、シミュレーションモデルアイテム、コンポーネントテンプレートアイテム、または回路図テンプレートアイテムを表示している場合）。
• Previewアスペクトビュータブ（コンポーネントアイテム、管理対象回路図シートアイテム、または回路図テンプレートアイテムを表示している場合）。