インポート・エクスポート

最終更新日: 2022年6月23日

インポート・エクスポート画面

インポートとエクスポートの画面では、アプリケーションが利用しているモデル名が一覧表示されます。

対象モデル一覧
開発者が作成したモデルです。
システムによって提供されるモデル一覧
Wagby が内部で用意するモデルです。

日本語のモデル名の辞書昇順の並びで表示されます。

インポートエクスポート画面(初期状態)

エクスポート

エクスポートは、データベースに格納されたデータをファイルとして出力する処理です。 次の手順で行います。

  1. 画面でエクスポートを行いたいモデルを選択します。すべてを選択したい時は「すべてを選択する」ボタンを押下します。
    エクスポートの操作
  2. モデルを選択後、「エクスポート」ボタンを押下することでエクスポート処理を開始します。この処理はデータベースに格納されているデータ量に比例して時間がかかります。

    ワンポイント

    「Zip形式で扱う」が有効になっている(標準)とき、エクスポートされたデータは一つのZip形式ファイルにまとめられます。
    この方が高速かつ使用するディスク容量も削減でき、おすすめです。

  3. 正常に処理が完了すると完了メッセージが表示されます。完了メッセージの下に表示されているメッセージはエクスポートしたデータが格納されているフォルダの名称になります。
    エクスポートの完了
  4. エクスポートフォルダ名は次のルールで自動的に決定されます。
    data_YYYYMMDDHHMMSS
    ここで YYYYMMDD は年月日を、HHMMSS は時分秒を示します。

インポート

インポートはエクスポートされたフォルダ(またはzipファイル)を読み込み、データを復元する処理です。

  1. インポートフォルダ名を選択します。インポートフォルダ名の欄にはこれまでにエクスポートしたフォルダ名称(または Zip ファイル)が一覧形式で表示されます。インポートフォルダの名称にはエクスポートした年月日と時間が14桁の数字として含まれています。
    インポート先の選択

    ワンポイント

    モデル名の欄にインポートフォルダ内のデータ件数が赤字で表示されます。 「(0)」はデータが 0 件、「(X)」はモデルのデータフォルダがないことを示します。

    ワンポイント

    表示されるファイル名は "data_" で始まるものに限ります。

  2. インポートを行う対象のモデルを選択します。すべてのモデルを選択したい時は「すべて選択する」ボタンをクリックします。
  3. 「インポート」ボタンをクリックすると、次のようなダイアログが表示されます。「OK」ボタンをクリックすると、処理が開始されます。
    確認ダイアログ
  4. 正常に処理が完了すると完了メッセージが表示されます。完了メッセージの下に表示されているメッセージはインポートしたデータが格納されているフォルダの名称になります。
    インポート終了

ワンポイント

標準では「インポート時にテーブルを初期化する」がチェックされています。このチェックが入ったままでインポートを行うと、登録されているデータがすべてクリアされ、インポートフォルダのデータをインポートします。

注意

インポート時に一件でも不正なデータが含まれていた場合、モデル全体のインポート処理が失敗します。(インポート時に不正なデータがあった場合、そのデータのみの登録に失敗し、他のデータは登録できるということではありません。)

旧データインポート

「モデル項目詳細定義」ダイアログの「詳細 > データ移行 > 旧データの項目名」を設定してビルドしたアプリケーションで、この旧データインポートを行うと、旧項目名を新項目名として扱い、旧データをインポートすることができます。

旧データの項目名を指定する
  1. 項目IDを変更する前にデータをエクスポートします。
  2. 項目IDを変更します。
  3. 変更した項目の「詳細 > データ移行 > 旧データの項目名」に変更前の項目IDを設定します。
  4. ビルドし、アプリケーションを起動します。
  5. システム管理者でログオンします。
  6. インポートエクスポート画面で、1. を対象データに指定して「旧データインポート」ボタンを押し、インポートします。
  7. 項目IDを変更した項目に変更前のデータがインポートされたことを確認してください。

この設定とは別に、XSLT を使って項目名を変換する方法もあります。[詳細...]

モデルを追加した後にインポートを行う場合の注意点 8.4.0

運用後にモデル定義を追加した場合、インポート時に「すべてを選択する」を行うとトラブルになることがあります。 図7 の運用フローは、追加したマスタモデル情報が消去されてしまう例を示しています。

運用に際しては、必要に応じてインポートするモデルを取捨選択するようにしてください。

誤って初期データを上書き消去してしまった運用フロー

[初期データ]を選択する 8.4.0

インポートフォルダ名に用意された "[初期データ]" を指定すると、開発途中で追加された選択肢モデルの初期データをインポートすることができます。

詳細

開発の途中で用意した選択肢モデルは、ビルドを行うことで WEB-INF/export/init にインポート用のファイルが用意されます。"[初期データ]" はこのフォルダからインポートするものです。

インポート時に独自のSQLを実行する

データのインポートのあと、独自の SQL を自動実行させることができます。例えばビューの作成や、順序の作成、特別なインデックスの作成などがあります。

詳細は「インポートとエクスポート機能活用ガイド(R7) > 設定ファイル > 拡張ファイル initdb_ex.xml」をお読みください。

削除

フォルダ(またはzipファイル)を選択し、「削除」ボタンを押下することで、対象フォルダ(またはzipファイル)を削除することができます。

削除

ダウンロード

対象となるzipファイルを選択し、「ダウンロード」ボタンを押下することで、このファイルをダウンロードすることができます。

ダウンロード

データのバックアップ

エクスポートしたデータは $(インストールフォルダ)\export フォルダに保存されています。

exportフォルダ

データはエクスポート処理の時に表示されたフォルダ名称にて保存されています。フォルダ内にはモデル名別にフォルダが作成されており、その中には1レコード1XMLファイルの状態で保存されています。

データをバックアップする時には、対象となるフォルダをすべて別の媒体(別のハードディスクやDVD,BD等)へコピーしてください。

ファイル型項目の扱い

「ファイル型」の項目でアップロードしたファイルは、upload_dir フォルダに保存されています。export フォルダではありません。
バックアップ時は、この upload_dir フォルダも対象としてください。(このフォルダは、実際にファイル型項目に値を登録したときに作成されます。インストール直後は存在しません。)

ジョブによる実行(大量データを扱う)

対象データが大量の場合、処理が完了する前にタイムアウト(無通信状態が一定時間続いたときに強制的に接続が解除される仕組み)によって結果表示画面を閲覧できなくなることがあります。

この場合は「インポートジョブを即時実行する」機能をお使いください。

プリンシパル 8.4.0

本機能は "システム管理者" または "インポートエクスポート" プリンシパルをもったアカウントで利用できます。[プリンシパルの詳細...]

仕様

自動的に用意されるインポートフォルダ

「data_init」と「data_build」が自動で用意されます。

data_init

ビルド時に生成されます。アカウントやマスタモデルのデータなど最低限のデータのみが含まれています。データベースを初期状態に戻したい、といった場合に用いることができます。

data_build

内蔵 DB 使用かつ差分ビルド時に用意されます。差分ビルドを行う直前のデータが保持されています。差分ビルド後、この data_build を指定してインポートすると、ビルド前の状態に戻すことができます。

ビルドエラーとなった場合、data_build は用意されません。
ビルドの前後でモデル定義の変更が生じない場合、data_build は用意されません。(例 フルビルド後、モデル定義を変更せず、差分ビルドを行なった、など)

対象外となるモデル

システムが内部で管理する、次のモデルはインポートエクスポートの対象外となります。(常に最新の状態となっている必要があるためです。)

  • jfcmodel
  • jfcmodel4dm
  • jfclicenseholder

ジョブスケジュールのインポート

ジョブスケジュールをインポートすると、「有効」となっているジョブは自動的に有効状態となります。指定時間になるとジョブが開始されます。

プリンシパルのインポート

プリンシパルは「アカウント」モデルをインポートすることで反映されます。[詳細...]

フォルダ名の規則

インポートとエクスポートの対象となるフォルダは、"モデルID/XMLファイル" と、モデルIDの名前のフォルダの中に、個々のXMLファイルが格納されるようになっています。このルールを遵守してください。

内部の処理で、読み込んだ xml ファイルの一つ上のフォルダをモデルID名と解釈しています。

選択肢モデルの読み込みルール8.3.0

過去のエクスポートデータをインポートしたとき、その時点で含まれていなかった選択肢モデル(DB保存あり)のデータは、初期データ(data_init)から自動的にインポートされます。

"含まれていない" とは、インポートしようとしているエクスポートデータに選択肢モデルのエクスポートデータがないということです。これは、対応するモデルのディレクトリがない場合や、ディレクトリ内にファイルが存在しない場合を指します。
R8.2.3までは、手動で行う必要があります。

トラブルシューティング

「管理と運用 > トラブルシューティング」をお読みください。

関連するページ