Working with Items

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

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

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

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 にレイヤースタックを再リリースする際に、リリースメモを追加している例。

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 パネルからアクティブな（かつ該当する）ドキュメントへ直接ドラッグ＆ドロップできます。ドラッグ可能な対象は次のとおりです。

• A Component Item のリビジョンを、アクティブな回路図ドキュメント（または PCB ドキュメント）へドラッグします。選択したドメインに対応するモデルが、それに応じてカーソルに追従して表示されます。
• A Managed Schematic Sheet Item のリビジョンを、アクティブな回路図ドキュメントへドラッグします。そのシートを参照するシートシンボルがカーソルに付随して表示されます。
• A 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 の高いセキュリティを効果的に活用でき、ソースバイナリファイルを含むあらゆるものを 1 つのエンティティとして保存するのに Workspace が最適な場所であることを示しています。また、データファイルのスムーズな流れを実現するために、双方向のドラッグ＆ドロップ機能も提供されており、Workspace 内のフォルダーと Windows Explorer 内のフォルダーの間でファイルをすばやく移動できます。

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

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

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

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

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

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

それを含むバイナリファイルを介して、OutputJob を新規ドキュメントのデフォルトとして正常に使用できます。