アイテムの操作

接続されたワークスペース内では、保存、管理、再利用が可能な各設計エンティティは、特定の種類のItemとして表されます。 アイテムを継続的に更新できるようにするため、ワークスペースには実際には、そのアイテムの個々のリビジョンである一連のアイテムリビジョンが保存されます。各リビジョンの名前は、選択したリビジョン命名スキームに基づいて付けられます。新しいアイテムはそれぞれフォルダー内に作成されます。ワークスペース内に必要なフォルダーを定義したら、Explorerパネルのアイテム領域で、選択したフォルダー内に新しいアイテムを作成できます。

サポートされているコンテンツタイプ

異なる種類のデータを保存し、表すために、それぞれ異なるアイテムが使用されます。あるアイテムは回路図シンボルを、別のアイテムはPCB部品モデルを表し、さらに別のアイテムにはリリース済みの基板設計から生成された製造データを格納できます。アイテム（より正確にはそのリビジョン）に格納するコンテンツの種類を指定するには、アイテムの作成時または編集時に、そのContent Typeプロパティを設定する必要があります。言い換えると、これは本質的にItem Typeを指定することになります。

次の表は、接続されたワークスペース内でユーザーが手動で作成できる各種コンテンツタイプ（アイテムタイプ）と、それぞれの以下の情報を示しています。

• Associated Folder Type – その種類のコンテンツを保存するための専用フォルダータイプ（用意されている場合）。これはフォルダーの内容に影響を与えるものではありません。フォルダーに何が保存されているかを視覚的に示す「手がかり」にすぎませんが、ワークスペース内で特定のコンテンツを探す際に役立ちます。コンテンツは、Generic Folderを含む任意の種類のフォルダーに保存できます。

• Content Type Code – そのコンテンツタイプのアイテムを作成して一意のIDを割り当てる際に、親フォルダーのアイテム命名スキームでエントリ$CONTENT_TYPE_CODEが使用されている場合に適用されるコード。

• Folder Type Code – そのコンテンツタイプのアイテムを作成して一意のIDを割り当てる際に、親フォルダーのアイテム命名スキームでエントリ$FOLDER_TYPE_CODEが使用されている場合に適用されるコード。

アイテムのリビジョン

アイテムには任意の数のリビジョンを持たせることができ、各リビジョンは、基本的にそのアイテムが時間とともに進化したものです。変更を加えると、新しいデータ内容は新しいリビジョンに保存、アップロード、またはリリースされます。これにより、既存のリビジョンが上書きされることはなく、最高レベルの整合性が確保されます。そのため、アイテムの各リビジョンに保存されるデータは通常、それぞれ異なります。アイテムの異なるリビジョンを識別するために、リビジョン識別子（ID）を使用します。これをアイテムIDと組み合わせることで、アイテムの各リリースを一意に識別できます。これがItem-Revisionです。

したがって、完全なアイテム-リビジョンIDは、親アイテムの特定のリビジョンを識別するものです。アイテムには常に少なくとも1つのリビジョン（最初のリリース）が存在しますが、そのアイテムのデータを保存、アップロード、またはリリースした回数によっては、多数のリビジョンが存在する場合もあります。ここで重要なのは、特定のアイテム-リビジョンにリリースできるのは一度だけという点です。変更がある場合は、新しいアイテム-リビジョンを作成する必要があります。同じリビジョンに再リリースしても、そのリビジョンに含まれるデータを上書きすることはできないため、最高レベルの整合性が確保されます。再度リリースするには、新しいアイテム-リビジョンを使用する必要があります。

アイテムとそのリビジョンの概念を最も簡単に理解するには、特定のアイテムの特定のリビジョンに関するすべてのデータを格納する「箱」をイメージしてください。アイテムをリリースすると、データが箱に入れられ、箱が閉じられます。アイテムIDとリビジョンIDは、その箱の側面に貼られたラベルとなり、箱の内容が何に使用されるものなのかを即座に識別できます。データを更新して再リリースする必要がある場合は、リビジョンIDが繰り上げられ、新しい箱が作成されます。

アイテムIDとリビジョンIDのラベルが付いた、アイテム-リビジョンの「箱」。中身は、そのアイテムの該当リビジョンを構築または表現するために必要なデータです。リリースすると箱が閉じられ、以後、そのリビジョンに別のデータをリリースすることはできなくなります。この場合、完全なアイテム-リビジョンIDはD-820-1001-01.A.1となります。

リビジョンIDの形式は、親アイテムに採用されている Revision Naming Scheme によって決まります。スキームで使用する具体的な形式は設定可能であり、各組織のニーズに応じて決まります。

状態変更メモとリリースノート

ワークスペース内のコンテンツの監査証跡を充実させるため、Altium Designerでは、アイテム-リビジョンのライフサイクル状態を変更する際にメモを入力できます。また、多くのコンテンツタイプでは、ワークスペース内の予定済みリビジョンにソースデータをリリースする際にもメモを入力できます。

状態変更メモ

ワークスペース内のアイテム-リビジョンのライフサイクル状態を変更する際は、続いて表示される状態変更ダイアログのState change note領域で、その変更に関するメモを入力します。

アイテム-リビジョンのライフサイクル状態の変更を説明するメモの追加。

リリースノート

ワークスペース内のアイテムの新しい予定済みリビジョンにソースデータをリリースする際は、続いて表示されるCreate RevisionダイアログのRelease notes領域で、そのリリースに関するメモを入力します。この機能は、直接編集方式に対応するすべてのアイテムタイプを再リリースする際に利用できます。

レイヤースタックを対象のワークスペースに再リリースする際に、リリースノートを追加する例。

アイテムのリビジョンに関連付けられたメモの表示

アイテムの各リビジョンに追加されたメモは、次の場所で確認できます。

• Detailed Item view – Timeline領域内のNote列で、関連するリリースノートとリビジョンの状態変更メモを確認できます。また、リビジョンのライフサイクルを示すグラフィカルビューでも、各状態に該当するメモ（追加されている場合）を確認できます。
• Explorer panel – 選択したアイテム-リビジョンのLifecycleアスペクトビュータブに切り替えます。リビジョンのライフサイクルを示すグラフィカル表示で、各状態に該当するメモ（追加されている場合）を確認できます。また、パネルのメインのItem領域内にあるNote列で、関連するリリースノートと最新のリビジョン状態変更メモを確認できます（この列の表示を有効にする必要がある場合があります）。

コンポーネントのリビジョンに関連付けられたメモの表示。

一般的なアイテムコマンド

Explorerパネルのオプション領域には、表示オプションに加えて、現在選択されているフォルダーのタイプに適用されるAdd <item>コマンドボタンもあります。

このコマンドは、選択したタイプの新しいWorkspaceアイテムを作成します。たとえば、パネルでコンポーネントフォルダータイプを選択すると、ボタンが表示されます。このボタンをクリックすると、そのタイプの新規コンポーネントがコンポーネントエディターで開きます。同様に、Output Jobタイプのフォルダーを選択すると、ボタンが表示されます。ボタンは、パネル上部のコンポーネントパスフィールドに入力したコンポーネント検索に対応し、検索結果で選択したコンポーネントを対象とする部品リクエストアクティビティを作成します。

ドラッグ＆ドロップによる配置

Altium DesignerのPCB設計プロジェクトへの特定のWorkspaceアイテムの配置は、Explorerパネルから直接、これらのアイテムタイプのリビジョンをアクティブな対応ドキュメントにドラッグ＆ドロップすることで簡単に行えます。次のドラッグ操作に対応しています。

• コンポーネントアイテムのリビジョンを、アクティブな回路図ドキュメント（またはPCBドキュメント）にドラッグします。選択した設計領域に対応するモデルが、カーソルに追従して表示されます。
• 管理された回路図シートアイテムのリビジョンを、アクティブな回路図ドキュメントにドラッグします。そのシートを参照するシートシンボルが、カーソルに追従して表示されます。
• 3DモデルアイテムのリビジョンをPCBまたはPCBライブラリドキュメントにドラッグすると、そのアイテムリビジョンを参照する3Dボディオブジェクトが作成されます。

Workspaceを参照して、配置するアイテムを探します。配置にはアイテムの特定のリビジョンを使用するため、アイテムのメインエントリを展開して、利用可能なすべてのリビジョンを表示してください（過去のすべてのリビジョンを表示するには、パネル右上のボタンをクリックし、Show only latestオプションを無効にします）。次に、必要なリビジョンをクリックし、そのインスタンスを設計ドキュメントにドラッグします。

また、Altium Designerでは、Componentsパネルからコンポーネントにアクセスして配置することもできます。

コンテンツデータのダウンロード

アイテムのリビジョンに保存されているデータをダウンロードするには、そのリビジョンを右クリックし、コンテキストメニューからOperations » Downloadコマンドを選択します。関連データは、選択したディレクトリ内に作成される、アイテムリビジョンIDを名前とするサブフォルダーにダウンロードされます。ファイルは、その中のReleasedフォルダーに格納されます。

バイナリファイルコンテンツタイプ

Altium Designerは、接続先の Workspaceと連携し、特殊なコンテンツタイプである Binary File アイテムに任意のファイルを保存できます。このアイテムには、形式を問わず1つ以上のファイルを格納できます。これにより、Workspaceの安全性を効果的に活用でき、ソースバイナリファイルを含むあらゆるファイルを1つのエンティティにまとめて保存する場所として、Workspaceを利用できます。また、データファイルをスムーズに移動できるよう、双方向のドラッグ＆ドロップ機能が用意されており、Workspace内のフォルダーとWindowsエクスプローラー内のフォルダー間でファイルをすばやく移動できます。

• Workspaceにバイナリファイルコンテンツタイプのアイテムを作成します。 対象のファイルをアップロードすると、バイナリファイルアイテムの新しいリビジョンを作成できます。これには複数の方法があります。詳細は、 アイテムの新しいリビジョンへのデータのアップロード を参照してください。
• バイナリファイルアイテムに保存されているファイルを変更する場合は、必要な新しいファイルをそのアイテムにアップロードします。新しいファイルは、そのアイテムの次のリビジョンに保存されます。
• バイナリファイルアイテムのリビジョンに保存されているファイルを開くには、そのリビジョンの Details アスペクトビュータブでファイルを選択し、右クリックしてコンテキストメニューから Open コマンドを選択します。対応するアプリケーション（またはAltium Designer自体）で開くことが可能な場合は、そのアプリケーションでファイルが表示されます。

テンプレートの環境設定でのバイナリファイルの使用

Altium Designerの環境設定では、特定のタイプの新規ドキュメントを作成する際に使用するデフォルトのテンプレートドキュメントを定義できます。これは、Preferencesダイアログの Data Management – Templatesページ にあるDefaultsタブで設定します。デフォルトのテンプレートドキュメントには、ファイルベースのもの、または接続先のWorkspace内のものを使用できます。

一部のドキュメントタイプ（ActiveBOM Document、Out Job File、Multi-board Schematic、Multi-board Assembly）では、Workspaceベースのデフォルトテンプレートドキュメントとして使用できるのは、バイナリファイルに格納されたものだけです。そのため、必要なテンプレートドキュメントをバイナリファイルのリビジョンにアップロードし、それを新規ドキュメントのデフォルトとして使用する必要があります。

必要なドキュメント（たとえばOutputJobファイル）を、新しいバイナリファイルの初期リビジョンにアップロードします。

これで、接続先のWorkspaceから新規ドキュメントのデフォルトを定義する際に、そのバイナリファイルを参照して選択できるようになり、環境設定のエントリに対応する内容が入力されます。

OutputJobを格納したバイナリファイルを使用して、そのOutputJobを新規ドキュメントのデフォルトとして設定した例。