Web API を使用してプロジェクトをインポートする
このセクションでは、コマンドラインと Web API を使用してプロジェクトをインポートする方法とインポートをキャンセルする方法について説明します。
Project admin と Projects root admin ロールでアクセスできます。newProjectName パラメーターを使用してターゲットサーバー上のプロジェクトに新しい名前を指定する必要があります)。cURLを使用して特定のプロジェクトをインポートするには、次のコマンドを実行します。projectは、インポートするプロジェクトの名前です。sourceURLは、インポート元の既存の Klocwork サーバーの URL です。sourceAdminは、インポート元の Klocwork サーバー管理者 (Projects root adminアクセス権を持っている必要があります) のユーザー ID です。sourcePasswordは管理者のパスワードです。-
キューに登録されている、または進行中のインポートをキャンセルするには、次のコマンドを実行します。
-
インポートまたはキャンセルのステータスを確認するには、次のコマンドを実行します:
-
ソースの
projects_rootにあるすべてのプロジェクトリストを取得するには、次のコマンドを実行します: -
サーバー構成設定をインポートするには、次のコマンドを実行します:
curl --data "action=import_project&user=myself&project=my_project&sourceURL= http://oldserver:8080&sourceAdmin=user&sourcePassword=pwd" http://localhost.mycompany.com:8080/review/api
フィールド
インポートを開始すると、レスポンスでターゲットプロジェクト ID が返されます。インポートの追跡やキャンセルに備えて、この値を保存してください。
{ "projectId": "<targetId>" }
curl --data "action=import_project_cancel&user=myself&project=<targetId>" http://localhost.mycompany.com:8080/review/api
キューに登録されているインポートが開始されていない場合、サーバーがインポートをキューから削除します。インポートが進行中の場合、次の安全なチェックポイントで停止し、インポートされたプロジェクトのデータベース、ファイル、および予約済みのプロジェクト名をロールバックします。インポートされたサーバー構成設定はロールバックされません。インポートがすでに完了している場合、またはプロジェクト ID が不明な場合は、呼び出しがエラーを返します。キャンセルがすでに進行中の場合、キャンセルリクエストを再度送信しても結果は変わりません。
curl --data "action=import_status&user=myself&" http://localhost.mycompany.com:8080/review/api
キャンセルが進行中の場合、import_status の cancelling が true を返します。キャンセルが完了すると、cancelled が true を返します。cancelled のステータスは、failed とは区別されます。
{ "<targetId>": { "stage": "...", "cancelling": false, "cancelled": true, "failed": false } }
curl --data "action=projects&user=myself&" http://localhost.mycompany.com:8080/review/api
curl --data "action=import_server_configuration&user=myself&sourceURL= http://oldserver:8080&sourceAdmin=user&sourcePassword=pwd" http://localhost.mycompany.com:8080/review/api
cURL 呼び出しの記述例については、Klocwork Web API クックブックを参照してください。