コンテンツの作成と編集

Item は接続された Workspace 内に直接作成され、Item を製造/表現するために必要なすべてのデータは、その Item 番号に紐づけられて Workspace に保存されます。コンテンツ タイプによっては、Item は手動で作成することも、保存/アップロード/リリース処理の一部として自動的に作成することもできます。すべてのコンテンツ タイプは、Explorer panel から Altium Designer 内で作成できます。コンポーネントを扱う場合は、Components panel から作成することも可能です。

Item は接続された Workspace 内に作成されます。Altium Designer では、Explorer panel が Workspace への完全なインターフェースを提供します。

Item の作成

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

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

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

Create New Item ダイアログで、新しい Item の詳細を指定します。

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

Item ID について

コンテンツが作成される親フォルダーの重要な要素の 1 つが、そのフォルダーに使用される Item Naming Scheme です。これにより、その特定フォルダー内に作成される各 Item の一意 ID の形式が定義されます。フォルダー レベルで Item Naming Scheme を定義しておくことで、正しい ID 命名スキームに従いながら、そのフォルダー内にすばやくコンテンツを作成できます。これは、ターゲット Workspace 内で手動作成された既存 Item にリリースするのではなく、Item が自動的に「その場で」作成される場合に特に当てはまります。

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

一方で、Item の命名を完全に手動で管理する必要がある場合は、[NO ITEM NAMING SCHEME] エントリーを選択します。その場合、Item の作成時に一意の Identifier を定義する必要があります。なお、システムでは重複した identifier を持つ Item の作成は許可されないため、identifier を手動で割り当てるには、どの identifier がすでに使用されているかを把握しておく必要があります。

親フォルダーの Item Naming Scheme は、そのフォルダー内で作成される各 Item の Unique ID に適用されます。

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

Item ID のスキームを選択する

Item に使用できる名前付け／採番スキームは無数にあります。ドキュメント内の画像に示されているものは、あくまで例にすぎません。どの採番スキームが最適かについては、さまざまな議論がありますが、一般的には、短く、非意味的で、数字のみの採番スキームが最適であると専門家の多くが考えています。非意味的とは、製品カテゴリ、サブカテゴリ、場所などの情報を採番スキーム自体に埋め込まないことを意味し、新しい Item には単純に連番の次の番号を割り当てる方式です。

長さが重要なのは、identifier が長くなるほど、人が Item ID を記録したり思い出したりする際にミスをする可能性が高くなるためです。実務経験や学術研究でも、文字数が増えるほどデータ入力ミスが増加することが示されています。人が容易かつ確実に記憶できる桁数としては、7 桁が理想的だと考えられています。ある長さを超えると、エラーは加速度的に増加し、15 文字ではエラー発生確率がほぼ 100% に近づきます。

組織内で Item ID に識別性を持たせることが重要であれば、複合 identifier が解決策になる場合があります。この場合、シンプルな英数字の commodity prefix code を推奨します。たとえば、ID D-820-0001 を考えてみましょう。ここでコード中の D は Design を示し、これは設計用の Item であることを意味します。続く 3 桁では、最初の 1 桁で Peripheral Boards などの製品カテゴリを示し、その後の 2 桁でベアボード（1X）またはアセンブリ（2X 以上）を表すことができます。Item ID の最後の 4 桁は、単純で非意味的な順番待ち型の連番です。

Workspace Item の初期リビジョンの ID を設定する

ローカル設計パラダイムから Workspace ベースの運用へ移行するには、既存データを Workspace に移行する必要があります。こうしたデータはすでに複数回の改版を経ていて、組織内で認識されているリビジョン番号が付与されていることが少なくありません。たとえば、ある Magno-Synthetic Digitizer ボードの rev.3 はすでに出荷済みであり、改良版が rev.4 として提供予定であるかもしれません。この状態で Workspace にリリースした際、初期リビジョンが 1 に戻ってしまうと、控えめに言っても混乱を招きます。組織内だけでなく、さらに重要なことに、その顧客にとっても混乱の原因になります（顧客は現行の rev.3 より新しい版を期待しているためです）。

このため、Altium Designer では、Workspace 内で新規作成した Item の初期リビジョンの ID を手動で設定できる機能を提供しています。

初期リビジョンの ID を設定する

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

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

ID の各レベルを設定します（使用している Revision Naming Scheme に応じて該当する場合）。

Workspace から直接コンテンツを作成・編集する

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

Workspace の強力な特長の 1 つが、Direct Editing のサポートです。では「Direct Editing」とは何でしょうか。これは、Workspace 内のモデル、コンポーネント、さらには managed sheet を右クリックして Edit を選択できるということです。すると確かに編集可能なファイルが Altium Designer で開かれますが、それは一時エディターで開かれています。編集が完了したら、そのまま Workspace に保存するだけです。編集したファイル自体について心配する必要はありません。編集内容は安全に Workspace に保存されるため、そのファイルは不要になって破棄され、一時エディターのインスタンスも閉じられます。

Direct editing により、個別にバージョン管理されたソースデータの制約から解放されます。Workspace 自体から直接取得した最新ソースを読み込んだ一時エディターを使って、サポート対象の Item タイプをそのまま編集できます。編集が完了すると、そのエンティティは親 Item の次の予定リビジョンとしてリリース（または再リリース）され、一時エディターは閉じられます。ハードドライブ上にファイルは残らず、正しいソースや最新ソースを使っているか悩む必要もなく、別個のバージョン管理ソフトウェアを維持する必要もありません。Workspace がそれらすべてを高い整合性で処理し、データ変更作業を大幅に効率化します。

Direct Editing でサポートされるコンテンツタイプ

Direct Editing に関してサポートされる Workspace コンテンツタイプは次のとおりです。

Item の初期リビジョンを編集する

Explorer panel から、サポートされているコンテンツタイプの Item を作成する際、作成後に、その Item に関連付けられたデータエンティティを編集し、その Item の初期リビジョンとしてリリースすることができます。つまり、Workspace の外部でソースデータを作成してからリリースする代わりに、空の Item が作成されたその時点から、ダイレクト編集によってソースを直接扱い始めることができます。そして編集が完了すると、そのエンティティは親 Item の初期計画リビジョンにリリースされ、一時エディターは閉じられます。

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

以下の画像は、新しい Symbol Item（SYM-001-0031）の作成時の動作を示しています。一時的な Schematic Symbol エディターが開き、必要に応じてシンボルを定義するためのドキュメントが表示されます。

Workspace から直接 Symbol Item の初期リビジョンを編集している例です。Temporary Schematic Symbol エディターにより、回路図シンボルを定義するためのドキュメントが提供されます。

ダイレクト編集コントロール

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

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

• / – Save to Server。このボタンは、ドキュメントを Workspace にリリースする（実質的には保存してリリースする）ために使用します。これにより、対象 Item の初期（計画済み）または次のリビジョンに保存されます。Create Revision dialog（または Edit Revision dialog）が表示され、必要に応じて Name と Description を変更したり、リリースノートを追加したりできます。リリース後、ドキュメントとエディターは閉じられます。

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

  • component item のリビジョンから参照されている domain model（symbols、footprints、simulation models、harness wiring models）の新しいリビジョンを作成する場合。

  • component item のリビジョンから参照されている component template の新しいリビジョンを作成する場合。

  • footprint model item のリビジョンから参照されている 3D model の新しいリビジョンを作成する場合。

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

  編集した component または domain model（symbol、footprint、simulation model、harness wiring model）を Workspace に保存するとき、その現在のライフサイクル状態を保持できます。これは、再保存時に Edit Revision / Create Revision ダイアログで使用可能な Preserve lifecycle state (not recommended) オプションによって制御されます。このオプションを有効にすると、新しいリビジョンには前のリビジョンのライフサイクル状態が自動的に設定されます。 この機能は、Allow to skip lifecycle state change for new revisions 操作権限が割り当てられているユーザーが利用できます（Setting Global Operation Permissions for a Workspace を参照）。

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

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

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

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

既存の Item リビジョンの編集

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

既存の Draftsman Document Template のダイレクト編集を開始するコマンドにアクセスしている例です。

一時ファイルの動作

Workspace のデータを編集できるようにするには、Altium Designer 上で編集対象となるものを生成する必要があります。その際、一時ファイルが作成されます。たとえば、Symbol Item を右クリックして Edit を選択すると、一時的な SchLib ファイルが作成されて Altium Designer で開かれます。作業を終えて Save to Server を実行すると、Workspace データが更新され次第、このファイルは削除されます。

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

一時ドキュメントは、変更作業を 1 回の編集セッションで完了しなくてもよいよう、引き続きアクセス可能な状態で保持されます。

Components Panel からのコンポーネントのダイレクト編集

日常的なコンポーネント管理においては、Components panel からダイレクト編集を利用できます。このコンテンツタイプに関しては、通常 Explorer パネルよりもこちらを使うことが多いでしょう。必要なコンポーネントを参照して選択し、右クリックしてコンテキストメニューから Edit コマンドを選択します。すると、Component Editor の一時インスタンスが Single Component Editing モードで開き、必要に応じて変更を加えられる状態になります。

Components パネルからダイレクト編集を行っている例です。

Component Editor からのモデルのダイレクト編集

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

Component Editor の Single Component Editing モードを使用して、ダイレクト編集中のコンポーネント自身から参照されている既存モデルをダイレクト編集している例です。

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

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

Item の新しいリビジョンへのデータのアップロードは、いくつかの方法で実行できます。

Upload メニュー

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

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

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

Binary File のように、1 つのリビジョンに複数ファイルのアップロードをサポートするコンテンツタイプでは、選択したファイルが追加され、ダイアログの Sources 領域に一覧表示されます。リスト内容を調整する必要がある場合は、追加ファイルを加えるか、ファイルを選択して削除（ ボタンをクリック）してください。Sources 領域では、標準的な複数選択操作（Ctrl+Click、Shift+Click、およびクリック＆ドラッグ）によって複数ファイルを選択できます。

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

保存された Item のリビジョン（ここでは 3D Model Item の例）を Explorer パネルで参照します。必要に応じて、Preview アスペクトビュータブに切り替えると、そのグラフィカル表示を確認できます。

Windows Explorer からのドラッグアンドドロップ

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

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

ドラッグアンドドロップ方式によるアップロード。ここでは 3D Model の例を示しています。

Workspace コンテンツのクローン作成

Explorer パネルでは、さまざまな Workspace Item をクローン作成できます。そのため、必要なコンポーネント、ドメインモデル、回路図シート、またはテンプレートを最初から作成する代わりに、単純にクローンできます。Direct Editing により、元の Item Revision のソースデータのコピーに対して必要な変更をスムーズに行え、その結果の変更は同じタイプの新しい Item の初期リビジョンとしてリリースされます。短時間で完了できるため、白紙の状態から始めることなく、Workspace のコンテンツをすばやく拡張できます。

次のコンテンツタイプをクローンできます:

• Component
• Footprint
• Symbol
• Simulation Model
• Component Template
• Managed Schematic Sheet
• Schematic Template
• Project Template
• Draftsman Document Template
• Draftsman Sheet Template
• Layerstack
• OutputJob

サポートされるコンテンツタイプのクローン作成コマンドには、Explorer パネルから次の方法でアクセスできます:

• ソース Item-Revision のエントリを右クリックし、コンテキストメニューから Operations » Clone コマンドを選択する。
• ソース Item-Revision のエントリを選択し、Ctrl+D キーボードショートカットを使用する。

Clone コマンドは、該当する Item-Revision が表示される Explorer パネル内のあらゆる場所で利用できます。たとえば次の場所です:

• フォルダー内のメイン Item 一覧。
• Children アスペクトビュータブ（Managed Schematic Sheet Item を表示している場合）。
• Where-used アスペクトビュータブ（Component Item、Symbol Item、Footprint Item、Simulation Model Item、Component Template Item、または Schematic Template Item を表示している場合）。
• Preview アスペクトビュータブ（Component Item、Managed Schematic Sheet Item、または Schematic Template Item を表示している場合）。