コマンドラインユーティリティの使用

エンタープライズ管理 > Windchill のエクスポートとインポート > PTC Windchill PLM Connector - Creo Packages Administrator's and User's Guide > Windchill PLM Connector – Creo Packages > パッケージのインポート > パッケージのインポート > コマンドラインユーティリティの使用

コマンドラインユーティリティの使用

コマンドラインユーティリティは、Creo Parametric および Creo Packages がインストールされている 1 つまたは複数のターゲット PLM システムとソース PLM システムとの間で共有される Creo Parametric ファイルのパッケージを作成するための、Creo Packages のコマンドおよび引数を管理します。

コマンドラインユーティリティは、引数と変数の組み合わせとして実装されます。これは、スクリプトに 1 つまたは複数のコマンドライン引数が含まれている自動インポートシナリオに使用できます。また、通常 Creo Parametric ユーザーがコマンドラインで特定の操作を実行する際にも使用できます。

次の表は、コマンドラインユーティリティの重要なコマンドを示しています。

コマンド名	説明
WPCImport	引数と値を受け入れるパッケージのインポートを開始します。
WPCView	パッケージビューアを起動し、1 つのパッケージ名を入力として受け入れます。
WPCDelete	WPCExport が失敗した場合に、Windchill に残っている一時的な Creo Packages ワークスペースを削除します。
WPCProEShutdown	Creo Parametric セッションを切断します。

規則

次の規則は、Creo Packages でのコマンドライン入力に関するものです。

• コマンドラインでは、場所を指定する場合を除き、大文字と小文字が区別されます。

• 文字列にスペースまたは特殊文字 (コンマなど) が含まれている場合は、文字列を引用符で囲みます。たとえば、フォルダ名が test folder である場合は、次のように指定します。

“test folder”

• すべてのディレクトリパスは、絶対パスか相対パスのいずれかです。

• 複数の値が許可されている場合は、コンマ (,) で区切ります。

Windchill ベースラインなどの一部のオブジェクトでは、名前にコンマを含めることができます。この場合、コンマと複数値のセパレータを区別するためにバックスラッシュエスケープ文字 (\) を使用します。

• wpc_preferences.txt ファイルに使用されるプレフィックスは次のとおりです。

◦ %o - 実行する操作を示します。export または import のどちらかの値を指定します。

◦ %u - Creo Packages のユーザー名。

• ディレクトリセパレータはプラットフォームに固有です。Windows では、レシピファイルの場所またはコマンドライン引数の場所のパスを指定する際のインジケータは、2 つのスラッシュ (\\) になります。${dir.sep} という構文をディレクトリセパレータとして使用することもできます。wpc_preferences.txt 内で ${dir.sep} が使用されている場合は、$ が \\ に置換されます。\\ および ${dir.sep} のセパレータは組み合わせて使用できます。次に例を示します。

#export.default.recipefile=c:\\ptc\\wpc${dir.sep}recipes\
\defaultRecipeFile.rcp

• コンフリクトの解決は次のように指定します。

conflict.<ConflictType>=<ResolutionType>

複数の解決タイプの値を指定できます。コンフリクトのタイプには、キーワードを割り当てることができます。

次の例では、OVERRIDE_FIRST_ITERATION がコンフリクトタイプを表し、INCLUDE が解決タイプを表しています。OVERRIDE_FIRST_ITERATION には INCLUDE、SKIP、USE_LATEST_ON-PREVIOUS の複数の値を指定できます。

## Possible resolutions for OVERRIDE_FIRST_ITERATIONS CONFLICT
ARE include, skip, use_latest_on_previous
# conflict.OVERRIDE_FIRST_ITERATION=INCLUDE

WPCDelete ユーティリティ

このユーティリティは、Windchill PDMLink ユーザーに適用されます。

Creo Packages は、WPCExport 操作中にユーザー用の一時ワークスペースを作成します。WPCExport が正常に完了した場合、または正常に完了しなかった場合、このユーティリティは Creo Packages が作成した一時ワークスペースをすべて削除します。

ほかのセッションで作成された Creo Packages ワークスペースも削除されるため、WPCDelete ユーティリティを実行する前に、ほかのセッションがマシンで実行されていないことを確認してください。

WPCDelete ユーティリティを実行するには、次の手順に従います。

1. コマンドプロンプトで、%WPC_HOME%\bin ディレクトリに移動します。

2. WPCDeleteWS.bat -<ユーザー> -<パスワード> を実行します。

3. 適切なユーザー操作とともに成功メッセージまたは警告メッセージが表示されます。

WPCProEShutdown ユーティリティ

Creo Packages では、Creo Parametric を共有モードで実行できます。Creo Parametric が共有されている場合、Creo Packages クライアントは新しいセッションを作成する代わりに、使用可能なセッションを使用します。共有接続は、同じクライアントの 2 人以上の Creo Parametric ユーザー間で使用できます。

共有接続を終了するには、次の手順を実行します。

1. コマンドプロンプトで、%WPC_HOME%\bin ディレクトリに移動します。

2. WPCProEShutdown.bat -<ユーザー> -<パスワード> を実行します。

3. 適切なユーザー操作とともに成功メッセージまたは警告メッセージが表示されます。

インポートのコマンドと引数

このセクションでは、ターゲット PLM システムにパッケージをインポートするときに使用する、一般的な Creo Packages のコマンドと引数を示します。

WPCImport コマンド

このセクションでは、完全パッケージ、増分パッケージ、および同期パッケージのインポートについて説明します。パッケージの詳細については、完全パッケージ、増分パッケージ、および同期パッケージを参照してください。

完全パッケージ、増分パッケージ、および同期パッケージのインポート

完全パッケージと増分パッケージのインポートでは、一般的に次のような WPCImport コマンドの引数が使用されます。

引数 (長いフォーマット)	引数 (短いフォーマット)	必須	値	説明
-baseline folder	-a	いいえ	デフォルト: プリファレンスで指定した値複数値の使用: 不可	インポートが成功したときに、ベースラインを作成する場所を指定します。値がプリファレンスに指定されていない場合は、ベースラインが作成されません。 -baseline folder “ORG1 /Library/PTC Library\baselines”
-preference	-e	いいえ	デフォルト: ロードポイントの wpc_preferences.txt から複数値の使用: 不可	デフォルトのパスを使用しない場合の、プリファレンスファイルの完全パスを指定します。(オプション) wpc_preferences.txt が存在しない場合は、システムのデフォルト値が使用されます。
-folder	-f	いいえ	デフォルト: プリファレンスで指定複数値の使用: 不可	オブジェクトがインポートされる場所を指定します。オブジェクトの元の位置は、インポートされる場所に影響しません。このオプションは、新規オブジェクトにのみ適用されます。既存のオブジェクトは、既存のオブジェクトの位置に従います。 -folder PTCORG\Product/Product1\Foreign
-package	-g	いいえ、できません。	デフォルト: プリファレンスで指定された場所 (ユーザーがオプション -preview を入力していない場合) 複数値の使用: 不可	パッケージをインポートする際の、パッケージの正確な場所とパッケージ名を指定します。パッケージ名には拡張子を含めても含まなくても構いません。 -package d:\cwp\packages\test
-preview	-v	いいえ	デフォルト: なし複数値の使用: 可	インポートされるオブジェクトのリストを事前に生成するために使用します。
-help	-h	いいえ	デフォルト: なし	コマンドラインのヘルプにアクセスするために使用します。
-mapping	-m	いいえ	デフォルト: プリファレンスからの読み取り複数値の使用: 不可	マッピングファイルが保存されているフォルダの場所を指定します。 -mappingdir d:\work\packages\mappings
-validate	-v	いいえ	デフォルト: なし複数値の使用: 不可	インポートを実行せずに、ターゲット PLM システムに対してパッケージを検証します。この引数は、-package 引数と一緒に使用します。 -package d:\work\packages\test.wpc -validate
-resolution	-s	番号	デフォルト: なし複数値の使用: 不可	入力として使用するコンフリクト解決ファイルの完全パスを指定します。 -resolution d:\data\conflicts\test.csv
-user	-u	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザー名。 -user <name> ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。
-password	-p	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザーパスワード。 -password <name> ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。パスワードの文字は画面に表示されません。
-output	-t	いいえ	デフォルト: 起動ディレクトリ (プリファレンスで指定されていない場合) 複数値の使用: 不可	HTML ページが保存されている場所を指定します。ディレクトリが存在しない場合は、作成します。出力の名前が Creo Packages により割り当てられます。 -output d:\work\packages

プロジェクトの完全パッケージ、増分パッケージ、および同期パッケージのインポート

プロジェクトの完全パッケージ、増分パッケージ、および同期パッケージのインポートでは、一般的に次のような WPCImport コマンドの引数が使用されます。

プロジェクトパッケージをインポートする -context 引数と、オブジェクトオーナーシップ転送の引数は同時に使用できません。

引数 (長いフォーマット)	引数 (短いフォーマット)	必須	値	説明
-context	-N	はい	デフォルト: なし複数値の使用: 不可	操作するコンテキストを指定します。値は、組織情報でサイトごとに一意である必要があります。 -context /PTC/Project/My_project
-baseline folder	-a	いいえ	デフォルト: プリファレンスで指定した値複数値の使用: 不可	インポートが成功したときに、ベースラインを作成する場所を指定します。値がプリファレンスに指定されていない場合は、ベースラインが作成されません。 -baselinefolder “ORG1/Library/PTC Library\baselines”
-preference	-e	いいえ	デフォルト: ロードポイントの wpc_preferences.txt から複数値の使用: 不可	デフォルトのパスを使用しない場合の、プリファレンスファイルの完全パスを指定します。(オプション) wpc_preferences.txt が存在しない場合は、システムのデフォルト値が使用されます。
-folder	-f	いいえ	デフォルト: プリファレンスで指定複数値の使用: 不可	オブジェクトがインポートされる場所を指定します。オブジェクトの元の位置は、インポートされる場所に影響しません。このオプションは、新規オブジェクトにのみ適用されます。既存のオブジェクトは、既存のオブジェクトの位置に従います。 -folder PTCORG\Product/Product1\Foreign
-package	-g	いいえ、できません。	デフォルト: ユーザーが引数 -preview を入力しないかぎり、プリファレンスに指定されている場所複数値の使用: 不可	パッケージをインポートする際の、パッケージの正確な場所とパッケージ名を指定します。パッケージ名には拡張子を含めても含まなくても構いません。 -package d:\cwp\packages\test
-preview	-v	いいえ	デフォルト: なし複数値の使用: 可	インポートされるオブジェクトのリストを事前に生成するために使用します。
-help	-h	いいえ	デフォルト: なし	コマンドラインのヘルプにアクセスするために使用します。
-mapping	-m	いいえ	デフォルト: プリファレンスからの読み取り複数値の使用: 不可	マッピングファイルが保存されているフォルダの場所を指定します。 -mappingdir d:\work\packages\mappings
-validate	-v	いいえ	デフォルト: なし複数値の使用: 不可	インポートを実行せずに、ターゲット PLM システムに対してパッケージを検証します。この引数は、-package 引数と一緒に使用します。 -package d:\work\packages\test.wpc -validate
-resolution	-s	番号	デフォルト: なし複数値の使用: 不可	入力として使用するコンフリクト解決ファイルの完全パスを指定します。 -resolution d:\data\conflicts\test.csv
-user	-u	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザー名。 -user <name> ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。
-password	-p	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザーパスワード。ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。パスワードは画面に表示されません。 -password <name>
-output	-t	いいえ	デフォルト: 起動ディレクトリ (プリファレンスで指定されていない場合) 複数値の使用: 不可	HTML ページが保存されている場所を指定します。ディレクトリが存在しない場合は、作成します。出力の名前が Creo Packages により割り当てられます。 -output d:\work\packages

オブジェクトオーナーシップ転送での完全パッケージのインポート

オブジェクトオーナーシップ転送の完全パッケージでは、一般的に次のような WPCImport コマンドの引数が使用されます。

引数 (長いフォーマット)	引数 (短いフォーマット)	必須	値	説明
-result Package	-y	いいえ	該当なし複数値の使用: 不可	結果のマスター同期パッケージを作成する場所を指定します。この引数を指定しない場合は、Startup ディレクトリに作成されます。 -resultPackage d:\data\WPC\ownership
-result Baseline Folder	-a	いいえ	デフォルト: プリファレンスで指定した値 (指定されている場合)。指定しない場合は、エクスポートが失敗します。複数値の使用: 不可	エクスポートの成功時にベースラインを作成する場所を指定します。 -resultbaselinefolder “ORG1/Library/PTC Library\baselines”
-noResult Baseline	-S	いいえ	該当なし複数値の使用: 不可	この引数を指定すると、オーナーシップ転送パッケージが作成された後に、結果のベースラインが無視されます。
-preference	-e	いいえ	デフォルト: ロードポイントの WPC_preferences.txt から複数値の使用: 不可	デフォルトのパスを使用しない場合の、プリファレンスファイルの完全パスを指定します。(オプション) デフォルト値は wpc_preferences.txt です。wpc_preferences.txt が存在しない場合は、システムのデフォルト値が使用されます。
-folder	-f	いいえ	デフォルト: プリファレンスで指定複数値の使用: 不可	オブジェクトがインポートされる場所を指定します。オブジェクトの元の位置は、インポートされる場所に影響しません。このオプションは、新規オブジェクトにのみ適用されます。既存のオブジェクトは、既存のオブジェクトの位置に従います。 -folder PTCORG\Product/Product1\Foreign
-package	-g	いいえ、できません。	デフォルト: プリファレンスで指定された場所 (ユーザーがオプション -preview を入力していない場合) 複数値の使用: 不可	パッケージをインポートする際の、パッケージの正確な場所とパッケージ名を指定します。パッケージ名には拡張子を含めても含まなくても構いません。 -package d:\cwp\packages\test
-preview	-v	いいえ	デフォルト: なし複数値の使用: 可	インポートされるオブジェクトのリストを事前に生成するために使用します。
-help	-h	いいえ	デフォルト: なし	コマンドラインのヘルプにアクセスするために使用します。
-mapping	-m	いいえ	デフォルト: プリファレンスからの読み取り複数値の使用: 不可	マッピングファイルが保存されているフォルダの場所を指定します。 -mappingdir d:\work\packages\mappings
-validate	-v	いいえ	デフォルト: なし複数値の使用: 不可	インポートを実行せずに、ターゲット PLM システムに対してパッケージを検証します。この引数は、-package 引数と一緒に使用します。 -package d:\work\packages\test.wpc -validate
-resolution	-s	番号	デフォルト: なし複数値の使用: 不可	入力として使用するコンフリクト解決ファイルの完全パスを指定します。 -resolution d:\data\conflicts\test.csv
-user	-u	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザー名。 -user <name> ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。
-password	-p	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザーパスワード。ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。パスワードは画面に表示されません。 -password <name>
-output	-t	いいえ	デフォルト: 起動ディレクトリ (プリファレンスで指定されていない場合) 複数値の使用: 不可	HTML ページが保存されている場所を指定します。出力の名前が Creo Packages により割り当てられます。 -output d:\work\packages ディレクトリが存在しない場合は、作成します。

オブジェクトオーナーシップ転送のマスター同期パッケージ

オブジェクトオーナーシップ転送のマスター同期パッケージでは、一般的に次のような WPCImport コマンドの引数が使用されます。

引数 (長いフォーマット)	引数 (短いフォーマット)	必須	値	説明
-resultPackage	-y	いいえ	該当なし複数値の使用: 不可	結果のマスター同期パッケージを作成する場所を指定します。この引数を指定しない場合は、起動ディレクトリに作成されます。 -resultPackage d:\data\WPC\ownership
-baselinefolder	-a	いいえ	デフォルト: プリファレンスで指定した値複数値の使用: 不可	インポートが成功したときに、ベースラインを作成する場所を指定します。値がプリファレンスに指定されていない場合は、ベースラインが作成されません。 -baselinefolder “ORG1/Library/PTC Library\baselines”
-resultBaselineFolder	-a	いいえ	デフォルト: プリファレンスで指定した値 (指定されている場合)。指定しない場合は、インポートが失敗します。複数値の使用: 不可	インポートの成功時にベースラインを作成する場所を指定します。 -resultbaselinefolder “ORG1/Library/PTC Library\baselines”
-noresultBaseline	-S	いいえ	該当なし複数値の使用: 不可	この引数を指定すると、オーナーシップ転送パッケージが作成された後に、結果のベースラインが無視されます。
-preference	-e	いいえ	デフォルト: ロードポイントの wpc_preferences.txt から複数値の使用: 不可	デフォルトのパスを使用しない場合の、プリファレンスファイルの完全パスを指定します。(オプション) wpc_preferences.txt. 存在しないデフォルト値は、システムのデフォルト値。
-folder	-f	いいえ	デフォルト: プリファレンスで指定複数値の使用: 不可	オブジェクトがインポートされる場所を指定します。オブジェクトの元の位置は、インポートされる場所に影響しません。このオプションは、新規オブジェクトのみで使用されます。既存のオブジェクトは、既存のオブジェクトの位置に従います。 -folder PTCORG\Product/Product1\Foreign
-package	-g	いいえ、できません。	デフォルト: プリファレンスで指定された場所 (ユーザーがオプション -preview を入力していない場合) 複数値の使用: 不可	パッケージをインポートする際の、パッケージの正確な場所とパッケージ名を指定します。パッケージ名には拡張子を含めても含まなくても構いません。 -package d:\cwp\packages\test
-preview	-v	いいえ	デフォルト: なし複数値の使用: 可	エクスポートされるオブジェクトのリストを事前生成するために使用します。
-help	-h	いいえ	デフォルト: なし	コマンドラインのヘルプにアクセスするために使用します。
-mapping	-m	いいえ	デフォルト: プリファレンスからの読み取り複数値の使用: 不可	マッピングファイルが保存されているフォルダの場所を指定します。 -mappingdir d:\work\packages\mappings
-validate	-v	いいえ	デフォルト: なし複数値の使用: 不可	インポートを実行せずに、ターゲット PLM システムに対してパッケージを検証します。この引数は、-package 引数と一緒に使用します。 -package d:\work\packages\test.wpc -validate
-resolution	-s	番号	デフォルト: なし複数値の使用: 不可	入力として使用するコンフリクト解決ファイルの完全パスを指定します。 -resolution d:\data\conflicts\test.csv
-user	-u	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザー名。 -user <name> ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。
-password	-p	はい	デフォルト: なし複数値の使用: 不可	接続先の PLM システムのユーザーパスワード。ユーザー名とパスワードの引数はオプションです。コマンドの実行時にこれらを入力しなかった場合は、システムのセキュリティを強化するために、ユーザー名とパスワードの入力を求めるプロンプトが Creo Packages に表示されます。パスワードは画面に表示されません。 -password <name>
-output	-t	いいえ	デフォルト: 起動ディレクトリ (プリファレンスで指定されていない場合) 複数値の使用: 不可	HTML ページが保存されている場所を指定します。ディレクトリが存在しない場合は、作成します。出力の名前が Creo Packages により割り当てられます。 -output d:\work\packages

WPCImport コマンドの構文と使用例

WPCImport.bat -user %user_name% -password %user_password% -package
d:\work\packages\test.wpc -validate

WPCView コマンド

次の表に、WPCView コマンドの一般的な引数を示します。

引数 (長いフォーマット)	引数 (短いフォーマット)	必須	値	説明
-package	-g	はい	デフォルト: なし複数値の使用: 不可	ユーザーが表示する必要のある、以前に作成したパッケージの名前と完全パスを指定します。 -package d:\work\packages\test.wpc
-output	-t	いいえ	デフォルト: 起動ディレクトリ (プリファレンスで指定されていない場合) 複数値の使用: 不可	HTML ページが保存されている場所を指定します。ディレクトリが存在しない場合は、作成します。出力の名前が Creo Packages により割り当てられます。 -output d:\work\packages

WPCView コマンドの構文と使用例

usage: WPCView -package(-g) [-output(-t) ] [-help(-h) ]

WPCView コマンドの例

WPCview.bat -package d:\cwp\packages\test.wpc