4.14. インポート/エクスポートを行う¶
インポート/エクスポートは、以下の情報をファイルに保存、またはファイルから読み取ってIM-Workflowに登録する機能です。
- コンテンツ定義
- ルート定義
- フロー定義
- 案件プロパティ定義
- ルール定義
- メール定義
- IMBox定義
- 一覧表示パターン定義
- フローグループ定義
- 管理グループ定義
- 代理管理者設定
- メッセージ定義
マスタ定義や権限者設定のバックアップ、別のintra-mart環境のIM-Workflowから各種マスタ定義をコピーをする場合に使用します。
注意
- コンテンツ定義
- ルート定義
- フロー定義
上記の情報はバージョン情報を持っていますが、インポート・エクスポートの単位は定義内のバージョン情報を包括した１定義単位です。
バージョン単位でのインポート・エクスポートを行うことはできないので注意してください。
注意
- 「 IM-Workflow 仕様書 」-「 バージョンの設定 」
4.14.1. インポートを活用する¶
「サイトマップ」「ワークフロー」→「ワークフロー管理者」→「インポート／エクスポート」→「インポート」をクリックします。
インポートするファイルのチェックボックスをオンにします。
「データ選択へ」をクリックします。
コラム
インポート対象は、ストレージサービスの以下のパス配下に配置されているファイルです。「%PUBLIC_STORAGE_PATH%/im_workflow/data/<テナントID>/import_export/」画面下部からローカルのインポートファイルをアップロードしてインポートを行うこともできます。（ローカルからのアップロードを有効にするためには、ワークフローパラメータの設定が必要です。ワークフローパラメータの詳細は、別紙「 IM-Workflow 仕様書 」を参照してください。）
「インポート」をクリックします。
すべてのマスタ定義をインポートする場合は、「全選択」をクリックしてください。インポート可能なマスタ定義が全てチェック状態に変わります。最初の状態に戻す場合は、「全解除」をクリックしてください。選択されているマスタ定義のチェックが全て解除されます。キーが重複する場合（例えば、コンテンツ定義で同じコンテンツIDが複数存在する場合）は、片方の定義を選択状態にすると、残りの定義は選択できません。コラム
インポート処理中に「閉じる」をクリックすると、途中でインポート処理を中止することができます。ただし、中止までにインポートされたマスタ定義はロールバックされません。インポートすることができました。
全てのマスタ定義が問題なくインポートされた場合は、インポート実行結果に「正常終了」が表示されます。インポート時に問題があったマスタ定義は、赤字で問題の内容が表示されます。赤字で表示された定義情報については登録されていません。黒字で表示された定義情報については登録されています。コラム
インポートの仕様については、別紙「 IM-Workflow 仕様書 」を参照してください。
コラム
インポート対象のファイルは、インポート後も削除しません。インポート／エクスポートファイル削除ジョブは、猶予期間を経過したインポート対象のファイルを削除できます。詳細は以下のドキュメントを参照してください。
- 「 IM-Workflow 仕様書 」-「 インポート／エクスポートファイル削除 」
注意
インポート時に特に発生しやすい問題の内容と対処方法は以下の通りです。
- ＜定義名＞に登録されている＜キー＞が存在しないため、登録できません。
- ルート定義情報のインポートに失敗しています。
ルート定義のXMLファイルの保存に失敗しました。
インポートしようとしたルート定義のXMLファイルがすでに存在しています。インポートを行う前に、ルートXMLファイルを削除してください。%PUBLIC_STORAGE_PATH%/im_workflow/data/<テナントID>/<ワークフローパラメータのマスタディレクトリ(master-file-dir)>/route/<ルートID>
4.14.2. エクスポートを活用する¶
「サイトマップ」→「ワークフロー」→「ワークフロー管理者」→「インポート／エクスポート」→「エクスポート」をクリックします。
エクスポートしたい定義を選択します。
フローグループ定義で「フローとの関連付け情報を含める」のチェックを外すと、フローグループ定義に関連付けられたフローのリンク情報をファイルに含めずに出力することができます。
管理グループ定義で「フロー、ルート、コンテンツ、メッセージ、メール、IMBoxとの関連付け情報を含める」のチェックを外すと、管理グループ定義に関連付けられたフロー、ルート、コンテンツ、メッセージ、メール、IMBoxのリンク情報をファイルに含めずに出力することができます。
コラム
エクスポート処理中に「閉じる」をクリックすると、途中でエクスポート処理を中止することができます。エクスポート処理を中止すると、それまで出力されていたファイルは削除されます。エクスポートすることができました。
全てのマスタ定義が問題なくエクスポートされた場合は、エクスポート実行結果に「正常終了」が表示されます。エクスポート時に問題があったマスタ定義は、赤字で問題の内容が表示されます。赤字で表示された定義情報については出力されていません。また、出力されたファイルの名称が「出力ファイル名」として表示されます。コラム
エクスポートしたファイルは、ストレージサービスの以下のパス配下に出力されます。「%PUBLIC_STORAGE_PATH%/im_workflow/data/<テナントID>/import_export/」エクスポートしたファイルをローカルにダウンロードしたい場合には、エクスポート結果のファイル名をクリックします。（ローカルへのダウンロードを有効にするためには、ワークフローパラメータの設定が必要です。ワークフローパラメータの詳細は、別紙「 IM-Workflow 仕様書 」を参照してください。）
コラム
インポート／エクスポートファイル削除ジョブは、猶予期間を経過したエクスポートファイルを削除できます。詳細は以下のドキュメントを参照してください。
- 「 IM-Workflow 仕様書 」-「 インポート／エクスポートファイル削除 」
注意
出力されたファイルの内容は直接変更しないようにしてください。