アイテムの操作

接続された Workspace 内では、保存、管理、再利用が可能な各設計エンティティは、特定の種類の Item として表されます。 Item を時間の経過とともに更新できるようにする必要性に対応するため、Workspace に実際に保存されるのは Item そのものではなく、選択した Revision Naming Scheme に基づく名前を持つ、その Item の特定リビジョンである一連の Item Revision です。各新規 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 Revision

Item には任意の数のリビジョンを持たせることができ、これは本質的にその Item が時間とともに変化していく履歴を表します。変更が加えられると、新しいデータコンテンツが新しいリビジョンに保存／アップロード／リリースされ、既存のリビジョンが上書きされることは決してなく、最高レベルの整合性が確保されます。したがって、Item の各リビジョンに保存されるデータは通常それぞれ異なります。こうした Item の異なるリビジョンを識別するために revision identifier（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 aspect view タブに切り替えます。リビジョンのライフサイクル内の各状態について、該当するメモ（追加されている場合）を、リビジョンのライフサイクルのグラフィカル表示内で確認できます。さらに、パネルのメイン Item 領域内にある Note 列で、関連するリリースメモおよび最新のリビジョン状態変更メモを表示できます（この列の表示を有効にする必要がある場合があります）。

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

一般的な Item コマンド

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

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

ドラッグ＆ドロップ配置

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

• A revision of a Component Item onto the active schematic document (or PCB document). The applicable model for the chosen domain will appear floating on the cursor accordingly.
• A revision of a Managed Schematic Sheet Item onto the active schematic document. A sheet symbol that references the sheet will float attached to the cursor.
• A revision of a 3D Model Item onto a PCB or PCB Library document, creating a 3D Body object that references that Item Revision.

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

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

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

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

Binary File コンテンツタイプ

Altium Designer は、接続された Workspace と連携して、特別なコンテンツタイプである Binary File Item に自由形式のファイルを保存する機能を提供します。このような Item は、任意の形式の 1 つ以上のファイルを格納できるように作成できます。これにより、Workspace の安全性を効果的に活用でき、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 aspect view タブで右クリックして、コンテキストメニューから 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 から新しいドキュメントのデフォルトを定義しようとすると、そのバイナリファイルを参照でき、設定項目がそれに応じて入力されます。

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