変更インポートコマンド
エクスポートされた ZIP ファイルをターゲットシステムにコピーした後で、ターゲットシステムで import コマンドを実行できます。
|
オプション
|
必須
|
説明
|
||
|---|---|---|---|---|
|
-f
--filepath
|
はい
|
インポートするパッケージ ZIP ファイルの場所または絶対パス。
|
||
|
-o
--outputDirectory
|
いいえ
|
インポートログファイルが保存される場所。このオプションが指定されていない場合、ファイルはカレントディレクトリに保存されます。
インポートログのデフォルトの場所は <WT_HOME>/${wt.temp}/bac/reports です。wt.properties 内の com.ptc.windchill.bac.import.report.location プロパティを設定して、インポートログファイルのデフォルトの場所を修正できます。
|
||
|
-d
--defaultResolutions
|
いいえ
|
|||
|
-s
--saveResolutions
|
いいえ
|
|||
|
-c
--conflictResolutionFile
|
いいえ
|
インポート時に使用するコンフリクト解決 XML ファイルへのパスを指定します。コンフリクト解決 XML ファイルには、各タイプのコンフリクトとその解決策が指定されています。--defaultResolutions、--saveResolutions、--reuseResolutions、またはそのすべてとともにこのオプションを指定した場合、XML ロードファイルで指定されている解決が先に実装されます。XML ファイルで解決策が指定されていない場合、保存済みの解決策が適用されます。
|
||
|
-b
--useBundledConflictResolutionFile
|
いいえ
|
パッケージ ZIP ファイルに含まれているバンドルされたコンフリクト解決ファイルを使用して、インポート中にコンフリクトを解決します。--defaultResolutions、--saveResolutions、--reuseResolutions、またはそのすべてとともにこのオプションを指定した場合、バンドルされたコンフリクト解決ファイルで指定されている解決策が先に実装されます。このファイルで解決策が指定されていない場合、保存済みの解決策が適用されます。
|
||
|
-n
--useBundledMapFile
|
いいえ
|
パッケージ ZIP ファイルに含まれているマッピングファイルを使用して、インポート中にソースの属性をターゲットの属性にマッピングします。
|
||
|
-i
--ignoreTargetCheckforGUID
|
いいえ
|
ターゲットシステムでのチェックをバイパスするソースシステムの GUID を指定します。
インポート処理中、ソースシステムの GUID を使用して、ソースシステムがターゲットシステムに登録されているかどうかがチェックされます。このオプションを設定すると、このチェックが省略され、未登録のソースシステムから管理変更をインポートできます。
ターゲットシステムの wt.properties 内の com.ptc.windchill.bac.ignoreGUIDList プロパティを設定して、ソースシステムの GUID を指定することもできます。これにより、インポートプロセス中に指定されたソースシステム ID のリストをチェックする処理が省略されます。--ignoreTargetCheckforGUID と com.ptc.windchill.bac.ignoreGUIDList に異なる GUID 値を指定した場合、--ignoreTargetCheckforGUID に指定した GUID が優先されます。
|
||
|
-v
--ValidateTarget
|
いいえ
|
ターゲットシステムの GUID を検証するコマンド。これは開発モードでのみ有効です。デフォルトでは、ターゲットシステムの GUID の検証は行われません。
|
||
|
-r
--reuseResolutions
|
いいえ
|
--defaultResolutions オプションとともにこのオプションを指定した場合、保存済みの解決が適用されます。コンフリクトに使用可能な保存済みの解決がない場合、デフォルトの解決が適用されます。
|
||
|
-m
--mapFile
|
いいえ
|
マッピング情報を含む XSL ファイルが保存されている場所。たとえば、マッピングファイルによって、ソースシステム上の参加者とターゲットシステム上の参加者の識別名が異なる場合に、ソースシステムからターゲットシステムに同じ参加者をマッピングする方法を指定できます。
詳細については、ビジネス管理変更属性のマッピングを参照してください。
|
||
|
-u
--user
|
いいえ
|
このコマンドを実行する Windchill ユーザーのユーザー名。コマンドを実行するユーザーは、すべての必須オブジェクトにアクセスできる組織管理者アクセス許可を持つ有効な Windchill ユーザーであり、かつサイト管理者であることが必要です。
|
||
|
-p
--password
|
いいえ
|
このコマンドを実行する Windchill ユーザーのパスワード。
|
||
|
-h
--help
|
いいえ
|
ユーティリティのヘルプテキストを表示するには、このオプションを使用します。ヘルプテキストには、各オプションの完全な説明と、ユーティリティを実行するための構文が表示されます。
|
Windchill シェルでこのユーティリティを実行するには、実行する操作の表にリストされている適切なオプションを追加して次のコマンドを指定してください。windchill wt.scm.client.SCMCMD import
たとえば、デフォルトのコンフリクト解決策を使用して一連の管理変更をインポートし、コンフリクトとその解決策をログファイルに書き込むには、次のコマンドを使用します: windchill wt.scm.client.SCMCMD import -u "<ユーザー名>" -p "<パスワード>" -f "<ZIP ファイルへのファイルパス>" -d -o "<出力ディレクトリへのファイルパス>"
ビジネス管理変更インポートログ
インポートが成功したかどうかにかかわらず、インポートコマンドの実行時にインポートログファイルが生成されます。インポートログファイルの内容から、インポートトランザクション全体についてさらに詳しい情報を得ることができます。
インポートログには、次の情報が表示されます。
• ログファイルヘッダー: BAC 受信送信物 ID、パッケージ名、パッケージバージョン、ソースリポジトリ
• サマリー
• オブジェクトタイプ
• アイデンティティ
• インポートステータス
• サーチメカニズム
• コンフリクト
インポートに失敗した場合、ヘッダー情報およびインポートに失敗した理由がインポートログに表示されます。
インポートログレポートの例を以下に示します。
