アイテムの操作

接続された Workspace 内では、保存、管理、再利用が可能な各設計エンティティは、特定の種類の Item として表されます。 Item を時間の経過とともに更新できるようにする必要性に対応するため、実際に Workspace に保存されるのは、その Item の特定リビジョンである一連の Item Revision であり、その名前は選択した Revision Naming Scheme に基づきます。各新規 Item はフォルダー内に作成され、Workspace 内で必要なフォルダーを定義すると、Explorer パネルの Item 領域で、選択したフォルダー内に新しい Item を作成できます。

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

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

次の表は、接続された Workspace でユーザーが手動で作成できる各種コンテンツタイプ（Item タイプ）と、それぞれに対応する以下の情報を示しています。

• Associated Folder Type – 利用可能な場合、そのタイプのコンテンツを保存するために用意された専用フォルダータイプ。これはフォルダーの内容自体には影響しません。単に、そのフォルダーに何が保存されているかを視覚的に示す「手がかり」を提供するだけであり、特定のコンテンツを探して Workspace を参照する際に役立ちます。コンテンツは、Generic Folder を含む任意の種類のフォルダーに保存できます。

• Content Type Code – そのコンテンツタイプの Item を作成した際に一意の ID を割り当てるために使用されるコードで、親フォルダーの Item Naming Scheme が $CONTENT_TYPE_CODE エントリを使用する場合に適用されます。

• Folder Type Code – そのコンテンツタイプの Item を作成した際に一意の ID を割り当てるために使用されるコードで、親フォルダーの Item Naming Scheme が $FOLDER_TYPE_CODE エントリを使用する場合に適用されます。

Item Revisions

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

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

Item とそのリビジョンの概念を最も簡単に理解するには、特定の Item の特定のリビジョンに関するすべてのデータが格納される「箱」をイメージするとよいでしょう。Item がリリースされると、データはその箱に入れられ、箱は閉じられます。Item ID と Revision ID はその箱の側面に貼られたラベルとなり、箱の中身が何のためのものかを即座に識別できます。データを更新して再リリースする必要がある場合は、Revision ID がインクリメントされ、新しい箱が作成されます。

Item-Revision の「箱」— Item ID と Revision ID のラベルが付けられています。中身は、その Item のそのリビジョンを構築または表現するために必要なデータです。リリースという操作によって箱は閉じられ、将来そのリビジョンへ他のデータがリリースされることを防ぎます。この場合、完全な Item-Revision ID は次のようになります: D-820-1001-01.A.1。

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

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

Workspace 内のコンテンツに対する監査証跡を強化するために、Altium Designer では Item-Revision のライフサイクル状態を変更する際、および多くのコンテンツタイプで Workspace 内の予定リビジョンにソースデータをリリースする際に、メモを入力できます。

状態変更メモ

Workspace 内で Item-Revision のライフサイクル状態を変更する際は、その後に表示される状態変更ダイアログの State change note 領域を使用して、その変更に関する適切なメモを入力します。

Item-Revision のライフサイクル状態の変更を説明するメモを追加している例。

リリースメモ

Workspace 内の Item の新しい予定リビジョンにソースデータをリリースする際は、その後に表示される Create Revision ダイアログの Release notes 領域を使用して、そのリリースに関する適切なメモを入力します。この機能は、Direct Editing パラダイムをサポートする任意の Item タイプを再リリースする際に利用できます。

対象 Workspace へ layerstack を再リリースする際にリリースメモを追加している例。

Item のリビジョンに関連付けられたメモの表示

Item の任意のリビジョンに追加されたメモは、次の場所で確認できます。

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

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

一般的な Item コマンド

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

このコマンドは、選択したタイプの新しい Workspace Item の作成を実行します。たとえば、パネルでコンポーネントフォルダータイプが選択されている場合は、 ボタンが表示されます。これにより、そのタイプの新しく作成されたコンポーネントが Component Editor で開きます。同様に、Output Job タイプのフォルダーが選択されている場合は ボタンが表示されます。 ボタンは、パネル上部のコンポーネントパスフィールドに入力されたコンポーネント検索の後に表示され、検索結果で選択したコンポーネントに適用される Part Request アクティビティを作成します。

ドラッグ＆ドロップ配置

Altium Designer では、特定の Workspace Item を PCB 設計プロジェクトへ配置する操作が効率化されており、これらの Item タイプのリビジョンを Explorer パネルからアクティブな（かつ適用可能な）ドキュメントへ直接ドラッグ＆ドロップできます。ドラッグ可能な対象は次のとおりです。

• Component Item のリビジョンをアクティブな回路図ドキュメント（または PCB ドキュメント）へドラッグします。選択したドメインに適したモデルが、それに応じてカーソルに追従して表示されます。
• Managed Schematic Sheet Item のリビジョンをアクティブな回路図ドキュメントへドラッグします。そのシートを参照するシートシンボルがカーソルに付随して表示されます。
• 3D Model Item のリビジョンを PCB または PCB Library ドキュメントへドラッグすると、その Item Revision を参照する 3D Body オブジェクトが作成されます。

配置する必要のある Item を Workspace で参照します。配置対象はその Item の特定のリビジョンであるため、メインの Item エントリを展開して利用可能なすべてのリビジョンを一覧表示してください（パネル右上の ボタンをクリックし、Show only latest オプションを無効にすると、以前のすべてのリビジョンを表示できます）。その後、必要なリビジョンをクリックし、そのインスタンスを設計ドキュメントへドラッグします。

さらに、Altium Designer は Components panel からのコンポーネントへのアクセスおよび配置もサポートしています。

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

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

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

Altium Designer は、接続された Workspace と連携して、特別なコンテンツタイプである Binary File Item に自由なファイルを保存する機能を提供します。このような Item は、任意の形式の 1 つ以上のファイルを格納できるように作成できます。これにより、Workspace の高い安全性を効果的に活用でき、ソースのバイナリファイルを含むあらゆるものを単一のエンティティとして保存するのに Workspace が最適な場所であることが明確になります。また、データファイルのスムーズな流れを支援するため、双方向のドラッグ＆ドロップ機能が提供されており、Workspace 内のフォルダーと Windows Explorer 内のフォルダーの間でファイルをすばやく移動できます。

• Workspace に Binary File コンテンツタイプの Item を作成します。 Binary File Item の新しいリビジョンは、該当する ファイルをアップロードすることで作成できます。これは 2 つの方法で実行できます。詳細は  Item の新しいリビジョンへのデータのアップロード を参照してください。
• Binary File Item に保存されているファイルを変更する必要がある場合は、その Item に必要な新しいファイルをアップロードしてください。新しいファイルはその Item の次のリビジョンに保存されます。
• Binary File Item のリビジョンに保存されているファイルを開くには、そのファイルを選択し（そのリビジョンの Details アスペクトビュータブ上）、右クリックしてコンテキストメニューから Open コマンドを選択します。該当する場合は、関連アプリケーション（または Altium Designer 自身）を使用してそのファイルが表示されます。

テンプレート設定での Binary File の使用

Altium Designer の Preferences の一部として、特定タイプの新しいドキュメントを作成するときに使用するデフォルトのテンプレートドキュメントを定義できます。これは、Preferences ダイアログの Data Management – Templates ページ の Defaults タブから実行します。デフォルトのテンプレートドキュメントは、ファイルベースにすることも、接続された Workspace から取得することもできます。

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

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

これで、接続されている Workspace から新規ドキュメントのデフォルトを定義しようとすると、バイナリファイルを参照でき、環境設定エントリにもそれに応じた内容が設定されます。

OutputJob を含むバイナリファイルを通じて、それを新規ドキュメントのデフォルトとして正常に使用した例。