Creating & Editing Content

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

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

Item の作成

必要なフォルダーを定義したら、Workspace 内にコンテンツを作成できます。Item を作成するには、適切なフォルダーを選択し、パネルの 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 の作成時に一意の識別子を定義する必要があります。重複した識別子を持つ Item の作成はシステムで許可されないため、識別子を手動で割り当てるには、どの識別子がすでに使用されているかを把握しておく必要があります。

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

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

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 ボードの 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 内のモデル、コンポーネント、あるいは管理されたシートを右クリックして Edit を選択できるということです。すると、編集可能な状態でファイルが Altium Designer に開かれます。これは一時エディターで開かれますが、編集が終わったらそのまま Workspace に保存するだけです。編集したファイル自体について心配する必要はありません。編集内容は安全に Workspace に保存されるため、そのファイルは不要となって破棄され、一時エディターのインスタンスも閉じられます。

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

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

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

• コンポーネント

• コンポーネントテンプレート

• Draftsman ドキュメントテンプレート

• Draftsman シートテンプレート

• フットプリント

• ハーネス配線

• レイヤースタック

• 管理された回路図シート

• Outputjob

• PCB スニペット

• プロジェクトテンプレート

• 再利用ブロック

• 回路図スニペット

• 回路図テンプレート

• シミュレーションモデル

• シンボル

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

Explorer panel から、サポート対象コンテンツタイプのいずれかの Item を作成すると、作成後にその Item の初期リビジョンへ関連データエンティティを編集してリリースすることができます。つまり、Workspace の外部でソースデータを作成してからリリースする代わりに、空の Item を作成した直後から Direct Editing によってソースの作業を開始できます。そして編集が完了すると、そのエンティティは親 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 のリビジョンから参照されているドメインモデル（symbols、footprints、simulation models、harness wiring models）の新しいリビジョンを作成する場合。

  • 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 の運用権限が割り当てられているユーザーが利用できます（詳細は 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 モードでコンポーネントを編集しているときは、リンクされたドメインモデルを直接編集の仕組みで編集できます。現在そのコンポーネントで使用中（参照中）のモデルを変更するには、そのプレビュー右上にある コントロールをクリックします。すると、そのモデルタイプに対応する一時エディタが開き、必要に応じてモデルを変更できます。準備ができたら、エディタを保存して閉じるだけで、変更されたモデルが Models 領域に再びリンクされた状態で表示されます。コンポーネントをリリースすると、変更されたモデルも自動的に Workspace にリリースされ、その親 Item の次のリビジョンに保存されます。

Component Editor の Single Component Editing モードを使用して直接編集されているコンポーネントから参照されている既存モデルを直接編集している例です。

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

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

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

Upload メニュー

ファイルは、Explorer panel で必要な 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 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、domain model、schematic sheet、または template を最初から作成する代わりに、単純にクローンを作成できます。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 を表示している場合）。