コンテンツの作成と編集

Item は接続された Workspace 内で直接作成され、Item を製造/表現するために必要なすべてのデータは、その後、その Item 番号に対して Workspace に保存されます。コンテンツタイプに応じて、Item は手動で作成することも、保存/アップロード/リリース処理の一環として自動で作成することもできます。すべてのコンテンツタイプは、Altium Designer の Explorer panel から作成できます。コンポーネントを扱う場合は、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 dialog から必要に応じて変更してください。

Item ID のスキーム選択

Item に使用できる名前/番号付けスキームの可能性は無数にあり、ドキュメント内の画像に示されているものは単なる例にすぎません。どの番号付けスキームが最適かについては、多くの議論があります。一般に、専門家は、短く、非意味的で、数字のみの番号付けスキームが最適であるという点で一致しています。非意味的とは、製品カテゴリ、サブカテゴリ、場所などの情報を番号付けスキームに埋め込まないことを意味し、新しい Item には単にシーケンス内の次の番号が付与されます。

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

組織内で Item ID に識別性を持たせることが重要であれば、複合識別子が解決策になる場合があります。この場合は、シンプルな英数字の品目プレフィックスコードを推奨します。たとえば、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 board の rev.3 はすでに顧客に提供済みで、改良版が rev.4 で提供される予定かもしれません。Workspace にリリースする際、初期リビジョンが 1 から始まってしまうと、組織内だけでなく、より重要なことに顧客ベースにとっても非常に混乱を招きます（顧客は現在の rev.3 より後のバージョンを期待しているためです）。

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

初期リビジョン ID の設定

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

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

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 がこれらすべてを高い整合性で処理し、データ変更を大幅に迅速化します。

直接編集でサポートされるコンテンツタイプ

以下の Workspace コンテンツタイプが Direct Editing をサポートしています。

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 の初期リビジョンを編集する例です。一時的な 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 のリビジョンから参照されているドメインモデル（symbol、footprint、simulation model、harness wiring model）の新しいリビジョンを作成する場合。

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

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

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

  編集した component またはドメインモデル（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 operational permission が割り当てられているユーザーのみ利用できます（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 からの Component のダイレクト編集

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

Components パネルからのダイレクト編集の例。

Component Editor からの Model のダイレクト編集

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

Component Editor の Single Component Editing モードを使用し、ダイレクト編集中の component から参照されている既存 model をダイレクト編集する例。

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

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

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

Upload メニュー

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

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

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

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

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

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

Windows Explorer からのドラッグ＆ドロップ

対象のデータファイルは、Windows Explorer のソースフォルダーから選択したファイルをドラッグし、Explorer panel 内の目的のターゲット 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 をクローンできます。そのため、必要な component、ドメインモデル、回路図シート、またはテンプレートを最初から作成するのではなく、単純にクローンすることができます。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 を表示している場合）。