コンポーネントデータをインポートするためのコマンドラインツール

<ns2:Attribute>
  <ns2:Key>DataSource</ns2:Key>
  <ns2:Value>Imported from PLM</ns2:Value>
</ns2:Attribute>

この場合、Workspace にインポートされるコンポーネントデータには、値が Imported from PLM に設定された DataSource パラメータが含まれます。

Additional features:

• 適用された設定ファイルは、関連する Workspace テンプレートとは独立して、パラメータマッピングを含むインポート処理のすべての設定を決定します。
• すべてのパラメータは、入力 CSV ファイルのパラメータに合わせてマップできます。これには、PLM Number にファイル内で使用されている名称や、部品メーカー情報（Part Choices）も含まれます。
• 複数の Entity 定義（それぞれの構成パラメータ Attributes を含む）を設定ファイルに含めることができます。たとえば Resistor の既存 Entity グループエントリをコピーし、貼り付けて編集することで、Capacitor 用の別定義を作成できます。コンポーネントテンプレートのパラメータにデフォルト値が設定されている場合、インポートされたコンポーネントに適用されます。ただし、インポートする CSV データに対応する属性がある場合は、ソース属性値が Workspace パラメータとしてインポートされます。CSVImport の 自動モード では、適用されるテンプレートは、ソース CSV のファイル名で定義されるコンポーネントタイプのものになります。設定モード では、テンプレートは設定ファイル内の <ComponentTemplate>[CMPT-xxxx]</ComponentTemplate> 行で設定されます。
• ソースパスとして withoutCSVファイル が指定されている場合、ツールはソースフォルダ内から、設定ファイル内のEntity定義に一致するCSVファイル名を検索します。したがって、Capacitor と Resistor に対する設定Entity参照が存在し、かつ一致するCSVファイルが見つかった場合、それらのコンポーネントのデータがWorkspaceにインポートされます。これは実質的に、ツールのバッチ動作モードです。

Part Choices handling

外部エンタープライズシステム（PLMなど）からWorkspaceへの、コンポーネントのメーカー Part Choice データの伝播は、データの重複や意図しない削除が起きないように構成されています。コンポーネントデータが 外部システムから直接 Workspaceに取り込まれる場合でも、CSVファイル経由で取り込まれる場合でも、Part Choiceエントリの作成／変更は、現在の状態とデータ履歴に基づいてインテリジェントに処理されます。

• インポート対象のコンポーネントPart Choiceエントリが、そのWorkspaceライブラリコンポーネントにすでに存在する場合、重複して作成されません。
• Workspace内で（インポートではなく）追加されたWorkspaceライブラリコンポーネントのPart Choiceエントリは、インポートされたPart Choiceデータによって置き換えられません。インポートされたPart Choiceは、そのコンポーネントに対する新しい追加のPart Choiceとして追加されます。
• コンポーネントに対して新しいPart Choiceデータがインポートされた場合、そのコンポーネントに対して以前にインポートされたPart Choiceエントリを置き換えます。

要約すると、コンポーネントに既存の non-importedPart Choiceデータ がある場合はそれを尊重しつつ、外部システムからインポートされたPart Choiceデータが、WorkspaceライブラリコンポーネントのPart Choiceエントリを決定します。

以下に示す例の画像では、入力CSVファイルにPLMエントリ CVS-RES-1001（10kResistor）のPart Choiceデータ（Manufacture Name および Manufacturer Part Number パラメータ）が含まれていないため、これはWorkspaceライブラリコンポーネントに追加されません。ただしこの例では、Part Choiceエントリ（Vishay）が、Altium Designer ExplorerパネルからそのWorkspaceライブラリコンポーネントに手動で追加されています。

そのコンポーネント（CVS-RES-1001）のPart Choiceデータが、後続のインポート／同期CSVファイルに含まれている場合（以下に示すとおり）、新しいPart Choiceエントリ（Rohm）はコンポーネントに added追加 されます。既存の「ネイティブ」Part Choiceエントリは、インポートされたPart Choiceデータで置き換えられないためです。

さらに後続のインポート／同期CSVファイルに、そのコンポーネントの新しいPart Choiceデータが含まれている場合（以下に示すとおり）、そのPart Choiceデータ（Yageo）は、以前にインポートされたPart Choiceエントリ（Rohm）を置き換えます。一方で、既存の「ネイティブ」Part Choiceエントリ（Vishay）は変更されません。あるいは、CSVのPart Choiceデータが削除されている（MFR_..エントリが空白）場合、インポート処理はWorkspace内の既存のインポート済みPart Choiceエントリ（Yageo）を削除します。

Multiple Manufacturer Part Choices

CSV Importerは、ソースCSVファイル内で繰り返し構造を用いることで、1つのコンポーネントに対して複数セットのメーカー部品データも扱えます。具体的には、メーカー部品データのバリエーションごとに追加のコンポーネントエントリを含めます。たとえば、ソースコンポーネント CSV-RES-1001 に関連する品番が3つある場合、そのコンポーネントに対するCSVエントリを3行用意し、それぞれで異なる MFR_NAME および MFR_PART_NUMBER 列データ（Vishay Daleから1つ、Yageoから2つ）を指定します。

このコンポーネントデータがWorkspaceにインポートされると、部品 CSV-RES-1001 に対して作成されるコンポーネントアイテムは1つですが、追加のCSVデータ参照から導出された複数のPart Choiceエントリが付与されます。

Parameter Unit and Value handling

CSVImportツールによって外部エンタープライズシステムからWorkspaceにコンポーネントデータをインポートする際、Workspaceの自動パラメータ単位処理が値データを解釈し、そのデータ内のエラーも処理します。

コンポーネントデータのインポートまたは同期処理中、該当する Component Template で単位対応の Typeパラメータ（Percent(%)、Watts(W) など）として指定されているコンポーネントパラメータは、それに従って解釈されます。インポートされるパラメータ値の書式は、外部システム（PLMなど）で定義されているため大きくばらつく可能性がありますが、Workspaceの単位対応の値処理は想定されるあらゆる書式に対応し、さらにエラーも正しく処理します。

以下の画像は、Workspaceライブラリコンポーネントのセットが、各コンポーネントエントリのPowerパラメータを含むCSVインポートファイルによって更新される例を示しています。ソースCSVファイル内のPowerパラメータ値はさまざまな書式で記述されており、CSV-RES-1001コンポーネントエントリには値のエラー（62500x）も含まれています。データインポート前、WorkspaceライブラリコンポーネントにはPowerパラメータデータが含まれておらず、初回リビジョン（Revision 1）の状態でした。これは上側の Explorerパネルに示されています。

CSVインポート処理の結果（上記の下側 Explorerパネル画像に表示）から、単位対応パラメータ解釈とエラー処理の影響が確認できます。

• CSVソースデータの書式エラーにより、コンポーネント CSV-RES-1001 にはPower値が追加されていません。
• コンポーネント CSV-RES-1001 では新しいリビジョンが作成されていません（Revision 1のままです）。
• 他のすべてのコンポーネントについては、Power値のソース書式がソースデータから正しく解釈されています。
• 正しく更新されたコンポーネントについては、新しいリビジョンが作成されています。

その後のコンポーネントデータのインポート処理で、コンポーネント CSV-RES-1001 のPower値が改訂（62500u）されている場合、その値は当該コンポーネントに対して正しく解釈されます（以下の画像に示すとおり）。Workspaceライブラリコンポーネントデータが更新され、新しいリビジョン（Revision 2）が作成されます。