Creating & Editing Content

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

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

アイテムの作成

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

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

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

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

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

Item IDについて...

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

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

また、アイテムの命名を完全に手動で制御する必要がある場合は、[NO ITEM NAMING SCHEME] エントリを選択します。その場合、アイテム作成の一部として一意の識別子（Identifier）を定義する必要があります。なお、システムは重複した識別子を持つアイテムの作成を許可しないため、識別子を手動で割り当てるには、どの識別子が使用済みかを把握している必要があります。

親フォルダのアイテム命名スキームは、そのフォルダ内で作成される各アイテムのユニークIDに適用されます。

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

アイテムIDのスキームを選択する

アイテムに使用できる名前／番号付けスキームは無数に存在し、ドキュメント内の画像に示されているものは単なる例です。最適な番号付けスキームについては多くの議論がありますが、一般的に専門家は「短く、意味を持たない、数字のみ」の番号付けスキームが最良だとしています。「意味を持たない」とは、製品カテゴリ、サブカテゴリ、場所などの情報を番号付けスキームに埋め込まないことを指し、新しいアイテムには単にシーケンスの次の番号を発行する方式です。

長さは重要です。識別子が長いほど、人がアイテムIDを記録・想起する際に誤りを起こす可能性が高くなります。経験および学術研究により、文字数が増えるほどデータ入力エラーが増加することが示されています。人が容易かつ確実に覚えられる桁数としては7桁が「マジックナンバー」だと考えられています。一定の長さを超えるとエラーは加速度的に増え、15文字ではエラー確率がほぼ100%に近づきます。

組織としてアイテムIDに識別性（意味）を持たせることが重要であれば、複合識別子が解決策になり得ます。この場合、シンプルな英数字のコモディティ（分類）プレフィックスコードを推奨します。たとえばID D-820-0001 を考えてみてください。このコード中の D は Design を表し、設計用のアイテムであることを示す、といった具合です。次の3桁では、1桁目が Peripheral Boards などの製品カテゴリを示し、3桁ブロックの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を設定できます。選択した Revision Naming Scheme に従い、IDの各レベルを変更するためのフィールドが（該当する場合に）提供されます。

Explorer パネルでプロジェクト関連アイテム（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に安全に保存されるため、そのファイルは不要となって破棄され、テンポラリエディタのインスタンスも閉じられます。

直接編集により、バージョン管理されたソースデータを別途保持するという制約から解放されます。Workspace自身から最新ソースを直接読み込んだテンポラリエディタを使って、サポートされるアイテムタイプをそのまま編集できます。編集が完了すると、そのエンティティは親アイテムの次の計画リビジョンへリリース（または再リリース）され、テンポラリエディタは閉じられます。ハードドライブ上にファイルは残らず、正しい／最新のソースで作業しているかを疑う必要もなく、別のバージョン管理ソフトウェアを維持する必要もありません。Workspaceが高い整合性をもってすべてを処理し、データ変更を大幅に迅速化します。

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

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

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

Explorer panelから、サポートされているコンテンツタイプのいずれかの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エディタが、回路図シンボルを定義するためのドキュメントを提供します。

Direct Editing Controls

ダイレクト編集時に関連するコントロールは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自体のみが保存されます。

  編集したコンポーネントまたはドメインモデル（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としても利用できます。

Editing an Existing Revision of an Item

いつでも、Workspace内（Explorer panel経由）のサポート対象コンテンツタイプのItemの任意のリビジョンに戻り、直接編集できます。リビジョンを右クリックし、コンテキストメニューからEditコマンドを選択します。再びテンポラリエディタが開き、リビジョンに含まれるドキュメントが編集用に開かれます。必要な変更を行い、そのドキュメントをItemの次のリビジョンへリリースすることを確定します。

既存のDraftsman Document Templateのダイレクト編集を起動するコマンドにアクセスする例。

The Behavior of the Temporary Files

Workspaceデータを編集できるようにするには、Altium Designerで編集するための何かが作成される必要があります。そこで作成されるのがテンポラリファイルです。たとえばSymbol Itemを右クリックしてEditを選択すると、テンポラリのSchLibファイルが作成され、Altium Designerで開かれます。作業を終えてSave to Serverを実行すると、Workspaceデータが更新された時点でこのファイルは破棄されます。

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

テンポラリドキュメントは、変更を1回の編集セッションで完了しなくてもよいように、アクセス可能な状態で保持されます。

Direct Editing of Components from the Components Panel

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

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

Direct Editing of Models from the Component Editor

Component EditorをSingle Component Editingモードで使用してコンポーネントを編集しているとき、ダイレクト編集の考え方に従ってリンクされたドメインモデルを編集できます。コンポーネントが現在使用（参照）しているモデルを変更するには、プレビュー右上のコントロールをクリックします。該当するモデルタイプのテンポラリエディタが開き、必要に応じてモデルを変更できる状態になります。準備ができたら、エディタを保存して閉じるだけで、変更されたモデルがModels領域にリンクされて表示されます。コンポーネントをリリースすると、変更されたモデルも自動的にWorkspaceへリリースされ、親Itemの次のリビジョンに格納されます。

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

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

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

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

Uploadメニュー

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

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

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

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

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

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

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

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

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

ドラッグ＆ドロップ方式によるアップロード（ここでは3D Modelの例）。

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

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

次のコンテンツタイプはクローン作成できます：

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

サポートされているコンテンツタイプのいずれかをクローンするコマンドは、Explorerパネルから次の方法でアクセスします：

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

Cloneコマンドは、該当するアイテムリビジョンが表示される場所であれば、Explorerパネル全体で利用できます。例：

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