Working with Items

接続された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の各改訂版に保存されるデータは通常異なります。これら異なる改訂版を識別するために改訂識別子（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 では、Workspace 内の Item-Revision のライフサイクル状態を変更する際にメモを入力でき、さらに多くのコンテンツ種別では、ソースデータを Workspace 内の計画済みリビジョンへリリースする際にもメモを入力できます。

State Change Notes

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

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

Release Notes

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

ターゲット Workspace へのレイヤースタック再リリース時にリリースノートを追加する例。

Viewing the Notes Associated with Revisions of an Item

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

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

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

General Item Commands

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

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

Drag & Drop Placement

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

• 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 からのコンポーネントへのアクセスおよび配置もサポートしています。

Downloading Content Data

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

Binary File Content Type

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

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

Using a Binary File with Template Preferences

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

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

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

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

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