9.8 npexportコマンド(業務コンテンツのエクスポート)
機能
保存された業務コンテンツ,およびアクセス権の設定情報(アクセス権グループまたはJP1資源グループ)をエクスポートします。
このコマンドは,過去に公開した版も含め,業務コンテンツのすべての版をエクスポートします。公開版だけをエクスポートしたい場合は,nppubexportコマンド(公開版業務コンテンツのエクスポート)を使用してください。詳細は,「9.12 nppubexportコマンド(公開版業務コンテンツのエクスポート)」を参照してください。
このコマンドは,セットアップ完了後,システムが起動している状態で実行する必要があります。コマンドプロンプトは管理者として開いてください。
なお,業務コンテンツが作成されていない状態でこのコマンドを実行した場合,業務コンテンツ数が0のファイルがエクスポートされます。
- 参考
-
ディレクトリサーバによるユーザ認証を利用している場合は,アクセス権グループおよび標準アクセス権限によって業務コンテンツのアクセス権が決まります。一方,JP1/Baseによるユーザ認証を利用している場合は,JP1資源グループの設定によって業務コンテンツのアクセス権が決まります。ただし,このコマンドでエクスポートできるJP1資源グループの情報は,JP1資源グループ名だけです。JP1資源グループの設定をインポート時に変更するための情報はエクスポートされないため,注意してください。
形式
npexport△[-c△エクスポートしたい業務コンテンツID|-i△業務コンテンツID一覧ファイルのパス]△[-x]△[-l△エクスポート一覧ファイルのパス]△エクスポート先のファイルのパス
エクスポート先のファイルのパスは,200文字以内の絶対パスまたは相対パスで指定します。出力されるファイルの形式はZIP形式です。
また,区切り文字には「\」を使用します。パスに半角スペースが含まれる場合は,パス全体を「"」で囲んでください。ディレクトリのパスで使用できる記号は,これら以外には半角のコロン(:)と相対パスを表す半角ピリオド(.)だけです。
- ポイント
-
業務コンテンツが1件も登録されていない場合にこのコマンドを実行すると,業務コンテンツ数が0のファイルが作成されます。このファイルをnpimportコマンド(業務コンテンツのインポート)に-dオプションを指定してインポートすると,登録されているすべての業務コンテンツが削除されます。多数の業務コンテンツを一括で削除したい場合に便利です。
オプション
- -c エクスポートしたい業務コンテンツID
-
特定の業務コンテンツだけエクスポートしたい場合に,エクスポートしたい業務コンテンツの業務コンテンツIDを指定します。
- -i 業務コンテンツID一覧ファイルのパス
-
業務コンテンツID一覧ファイルのパスを絶対パスまたは相対パスで指定します。
なお,-cオプションおよび-iオプションを省略した場合は,すべての業務コンテンツをエクスポートします。
-iオプションに指定した業務コンテンツID一覧ファイルに,存在しない業務コンテンツIDが含まれている場合は,存在する業務コンテンツとアクセス権の設定情報だけがエクスポートされます。その際,対応する業務コンテンツがないことを示す警告メッセージが出力されます。
- -x
-
業務コンテンツだけを出力する場合に指定します。
なお,JP1/Baseによるユーザ認証を利用している場合は,このオプションを指定しても無視されます。
- -l エクスポート一覧ファイルのパス
-
エクスポート一覧ファイルのパスを絶対パスまたは相対パスで指定します。
このオプションを指定すると,エクスポートされた業務コンテンツの一覧がテキストファイルとして出力されます。
業務コンテンツID一覧ファイルの形式
改行区切りで業務コンテンツIDを指定します。業務コンテンツID一覧ファイルはテキストファイルで作成してください。テキストファイル以外の場合は,コマンド実行時にエラーメッセージ(KDCZ10147-E)が表示されます。
各行の前後の空白(半角スペース,または全角スペース)を削除した文字列を業務コンテンツIDとして読み込みます。各行の前後の空白を削除した結果,業務コンテンツIDが空文字になる行は読み込みません。
行の途中でEOFになっている場合,EOFまでの文字列を業務コンテンツIDとして読み込みます。
なお,「#」などの記号でコメント行を追加することはできません。
エクスポート一覧ファイルの形式
ファイルの先頭にヘッダ情報が出力され,続いて,次の形式でメッセージが出力されます。
[結果種別]<T>[業務コンテンツID]<T>[業務コンテンツバージョンID]<T>[更新日時([タイムゾーン])]<T>[公開日時([タイムゾーン])]<T>[公開状態]<T>[業務コンテンツ名称]<T>[グループ名]<T>[アクセス権グループ名またはJP1資源グループ名1]<T> … [アクセス権グループ名またはJP1資源グループ名10]<CR><LF> [結果種別]<T>[アクセス権グループ名1]<T>[アクセス権グループID1]<CR><LF> … [結果種別]<T>[アクセス権グループ名10]<T>[アクセス権グループID10]<CR><LF>
<T>:タブ文字
<CR><LF>:終端文字(0x0D,0x0A)
メッセージの詳細を次の表に示します。
項目 |
説明 |
---|---|
結果種別 |
npexportコマンド(業務コンテンツのエクスポート)の実行結果の種別が出力されます。
|
業務コンテンツID |
エクスポートした業務コンテンツIDが出力されます。 |
業務コンテンツバージョンID |
エクスポートした業務コンテンツの版のIDが出力されます。 |
更新日時 |
エクスポートした業務コンテンツの版を最後に更新した日時が出力されます。 形式:YYYY/MM/DD hh:mm:ss.SSS 業務編集画面で,業務コンテンツの保存または編集完了の操作をした日時が出力されます。 |
公開日時 |
エクスポートした業務コンテンツの版を最後に公開した日時が出力されます。 形式:YYYY/MM/DD hh:mm:ss.SSS なお,エクスポート時には非公開となっている業務コンテンツでも,最後に公開した日時が出力されます。一度も公開されていない業務コンテンツの場合は,「----/--/--△--:--:--.---」と出力されます。 |
公開状態 |
エクスポートした業務コンテンツの公開状態が出力されます。公開状態には次の2種類があります。
|
業務コンテンツ名称 |
エクスポートした業務コンテンツの名称が出力されます。 |
グループ名 |
エクスポートした業務コンテンツのグループ名が出力されます。 |
アクセス権グループ名 |
業務コンテンツ名称と同じ行には,エクスポートした業務コンテンツに設定されているアクセス権グループ名が出力されます。それ以外の行には,エクスポートしたアクセス権グループ名が出力されます。 アクセス権グループは,はじめに標準アクセス権限が出力されたあと,名称の昇順で出力されます。 |
JP1資源グループ名 |
業務コンテンツ名称と同じ行には,エクスポートした業務コンテンツに設定されているJP1資源グループ名が出力されます。 |
アクセス権グループID |
エクスポートしたアクセス権グループのIDが出力されます。 |
エクスポート一覧ファイルの出力例を次に示します。
結果種別 業務コンテンツID 業務コンテンツバージョンID 更新日時(JST) 公開日時(JST) 公開状態 業務コンテンツ名称 グループ名 exported 268e3592-0133-1000-8002-00000ad23cbb-0 fe6dcb35-0145-1000-8000-0000ac11510b 2014/05/15 14:49:39.524 ----/--/-- --:--:--.--- [sample01]Webアプリバージョンアップ サンプルコンテンツ exported 268e3592-0133-1000-8002-00000ad23cbb-0 fe6db084-0145-1000-8000-0000ac11510b 2014/05/15 14:49:37.793 ----/--/-- --:--:--.--- [sample01]Webアプリバージョンアップ サンプルコンテンツ exported 268e3592-0133-1000-8002-00000ad23cbb-0 fe6cfabc-0145-1000-8000-0000ac11510b 2014/05/15 14:48:48.979 2014/05/15 14:49:26.935 公開中 [sample01]Webアプリバージョンアップ サンプルコンテンツ exported 268e3592-0133-1000-8002-00000ad23cbb-0 fa07860b-0145-1000-8000-0000ac11510b 2012/08/21 14:15:56.940 2014/05/14 18:19:28.283 [sample01]Webアプリバージョンアップ サンプルコンテンツ exported 357a2f3a-0133-1000-8001-00000ad23cbb-0 fe6cbed5-0145-1000-8000-0000ac11510b 2014/05/15 14:48:36.094 ----/--/-- --:--:--.--- [sample01解説]Webアプリバージョンアップ サンプルコンテンツ exported 357a2f3a-0133-1000-8001-00000ad23cbb-0 fa078688-0145-1000-8000-0000ac11510b 2012/08/21 14:16:02.550 2014/05/14 18:19:28.408 公開中 [sample01解説]Webアプリバージョンアップ サンプルコンテンツ exported fe6eb084-0145-1000-8000-0000ac11510b-0 fe6eb0c2-0145-1000-8000-0000ac11510b 2014/05/15 14:50:38.227 ----/--/-- --:--:--.--- 新規入会 新規手順
注意事項
-
業務コンテンツで使用している画像やHTMLなどの静的ファイルは,このコマンドではエクスポートされません。静的ファイルは手動でコピーし,移動させてください。静的ファイルの取り扱いの詳細は,「6.9 業務コンテンツで使用する静的ファイルの管理」を参照してください。
-
出力先として指定したファイルと同じ名前のファイルがすでにそのディレクトリに存在している場合はエラーとなり,エクスポートできません。存在していないファイルを指定してください。
-
ファイルのパスには,ネットワークドライブを指定しないでください。
-
エクスポートする業務コンテンツの容量に対して,エクスポート先のディスクの空き容量が不十分だった場合,このコマンドは異常終了します。
また,コマンド実行中は作業フォルダとして環境変数TMPまたはTEMPのフォルダを使用します。このため,環境変数TMPおよびTEMPのフォルダのディスク容量に余裕を持たせてからコマンドを実行するようにしてください。
-
出力したファイルの内容を変更しないでください。出力したファイルの内容を変更してインポートした場合,動作は保証されません。
戻り値
戻り値 |
説明 |
---|---|
0 |
コマンドが正常終了した。または警告終了した。 |
1 |
コマンドが異常終了した。 |
2 |
コマンドの排他エラーが発生した。 |
9 |
実行権限のエラーが発生した。 |
使用例
- 例1
-
次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。
-
エクスポート先のファイルのパスが「C:\work\repository.zip」である。
-
業務コンテンツとアクセス権の設定情報をエクスポートする。
> ナビゲーション プラットフォームインストールディレクトリ\bin\npexport C:\work\repository.zip
-
- 例2
-
次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。
-
エクスポート先のファイルのパスが「C:\work\repository.zip」である。
-
エクスポート後に出力するエクスポート一覧ファイルのパスを「C:\work\list.csv」とする。
-
業務コンテンツとアクセス権の設定情報をエクスポートする。
> ナビゲーション プラットフォームインストールディレクトリ\bin\npexport -l C:\work\list.csv C:\work\repository.zip
-
- 例3
-
次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。
-
エクスポート先のファイルのパスが「C:\work\repository.zip」である。
-
指定した業務コンテンツID(85D412B4-BB5D-4a14-A331-B0D31B7E1297-1)の業務コンテンツとアクセス権の設定情報をエクスポートする。
-
JP1/Baseによるユーザ認証を利用していない。
> ナビゲーション プラットフォームインストールディレクトリ\bin\npexport -c 85D412B4-BB5D-4a14-A331-B0D31B7E1297-1 C:\work\repository.zip
-
- 例4
-
次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。
-
エクスポート先のファイルのパスが「C:\work\repository.zip」である。
-
業務コンテンツID一覧ファイルのパスが「C:\work\contentsId.txt」である。
-
業務コンテンツとアクセス権の設定情報をエクスポートする。
> ナビゲーション プラットフォームインストールディレクトリ\bin\npexport -i C:\work\contentsId.txt C:\work\repository.zip
-
- 例5
-
次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。
-
エクスポート先のファイルのパスが「C:\work\repository.zip」である。
-
すべての業務コンテンツだけをエクスポートする。
> ナビゲーション プラットフォームインストールディレクトリ\bin\npexport -x C:\work\repository.zip
-