kintoneのデータを新しい環境へ移行する方法
固定リンクがコピーされました
はじめに
固定リンクがコピーされました
このTipsでは、kintoneのデータを新しい環境へ移行する方法を説明します。
もとの環境からデータを取得し、新しい環境で復元することで、kintoneのデータを移行します。
あらかじめ取得が必要なデータの確認
固定リンクがコピーされました
次のデータを取得し、新しい環境に復元します。
あらかじめ確認しておきましょう。
- アプリ
- アプリの設定情報
- アプリのレコード情報
- アプリに適用したJavaScriptやCSSカスタマイズのファイル
- スペース
- スペースの設定情報
- kintone全体
- プラグイン
- kintone全体に適用したJavaScriptやCSSカスタマイズのファイル
- 連携サービスの設定
kintone上にあるデータを、一括で取得する機能はありません。
専用の連携サービスの利用、または手動での作業が必要です。
仕様上、kintoneでは取得できないデータもあります。以下を参照してください。
取得できないデータ
データの取得と復元
固定リンクがコピーされました
では次に、それぞれのデータについて、取得方法と新しい環境での復元方法を見ていきましょう。
アプリ
固定リンクがコピーされました
アプリの設定情報
| 取得 / 復元 | 方法 |
|---|---|
| 取得 | アプリの情報を、アプリテンプレートとしてファイルに書き出してダウンロードします。 手順の詳細は、次のページを参照してください。 アプリをテンプレートとしてダウンロードする｜kintone ヘルプ 
なお、スペース内アプリの設定情報は、スペーステンプレートで書き出しできます。 スペース内アプリとして引き続き利用する場合には、スペーステンプレートとして書き出してください。 スペースの設定情報 アプリテンプレートに書き出せない設定もあります。 アプリテンプレートに含まれない設定 | kintone ヘルプ
これらの設定が必要な場合には、アプリを復元した後に再設定してください。 |
| 復元 | 書き出したアプリテンプレートを、新しい環境に読み込みます。 テンプレートファイルからアプリを作成する | kintone ヘルプ
|
アプリのレコード情報
| 取得 / 復元 | 方法 |
|---|---|
| 取得 | kintoneのファイルに書き出す機能やcli-kintoneを使用して、レコードのデータをファイルに書き出します。 添付ファイルは、 kintoneのファイルに書き出す機能では書き出しできません。 添付ファイルフィールドを含むアプリを取得したい場合には、cli-kintoneを使用してください。 |
| 復元 | kintoneのファイルを読み込む機能やcli-kintoneを使用して、書き出したレコードのデータを新しい環境に読み込みます。 |
アプリに適用したJavaScriptやCSSカスタマイズのファイル
| 取得 / 復元 | 方法 |
|---|---|
| 取得 | アプリに適用したJavaScriptやCSSのカスタマイズファイルは、スペーステンプレートやアプリテンプレートとして取得したzipファイルに含まれます。 ただし、テンプレートとして書き出さずにカスタマイズファイルだけを取得したい場合には、自身でファイルをダウンロードしてください。 |
| 復元 | アプリテンプレートやスペーステンプレートで、アプリやスペースを復元すると、JavaScriptやCSSカスタマイズファイルも自動で復元されます。 手動でカスタマイズファイルをダウンロードしている場合には、作成したアプリにファイルを適用し直してください。 ただし、コード内でアプリ番号、レコード番号、APIトークン等を利用している場合、新しい環境に合わせて書き換えが必要となります。 |
スペース
固定リンクがコピーされました
スペースの設定情報
| 取得 / 復元 | 方法 |
|---|---|
| 取得 | スペースの情報を、スペーステンプレートとしてファイルに書き出してダウンロードします。 手順の詳細は、次のページを参照してください。 スペーステンプレートをファイルに書き出す | kintone ヘルプ
スペーステンプレートに書き出せない設定もあります。 スペーステンプレートに含まれないデータ | kintone ヘルプ
これらの設定が必要な場合には、スペースを復元した後に再設定してください。 |
| 復元 | 書き出したスペースのテンプレートを、新しい環境に読み込みます。 ファイルからスペーステンプレートを読み込む | kintone ヘルプ
|
kintone全体
固定リンクがコピーされました
プラグイン
| 取得 / 復元 | 方法 |
|---|---|
| 取得 | kintoneに読み込んだプラグインファイルは、取得できません。 プラグインファイルを紛失した場合には、プラグインの開発者に問い合わせてください。 また、プラグインの設定情報も取得できません。 移行前の設定情報を、メモして控えてください。 |
| 復元 |
|
kintone全体に適用したJavaScriptやCSSカスタマイズのファイル
| 取得 / 復元 | 方法 |
|---|---|
| 取得 | kintone全体のカスタマイズとして適用しているJavaScriptやCSSファイルは、次の手順で取得します。
|
| 復元 | 新しい環境で、kintone全体のカスタマイズの設定を適用し直します。 控えておいたJavaScriptファイルやCSSファイルのURLを設定し、取得したファイルを新しい環境にアップロードします。 |
連携サービスの設定
固定リンクがコピーされました
連携サービスについては、新しい環境に再設定する必要があります。
詳しくは連携サービスの開発者に問い合わせてください。
取得できないデータ
固定リンクがコピーされました
APIトークンやWebhookのURL
固定リンクがコピーされました
移行前の環境で生成したAPIトークンやWebhookのURLは、新しい環境に引き継ぐことができません。
新しい環境で生成し直してください。
これらをkintoneカスタマイズや連携で使用している場合には、生成し直した値に書き換えてください。
ファイル入出力やAPIで取得できない情報
固定リンクがコピーされました
以下の情報は、製品の仕様上、ファイル入出力やAPIでのデータ取得ができないため、移行できません。
証跡としてデータ保管が必要な場合は、元の環境で保持しておくようにしてください。
- レコードの変更履歴
- プロセス管理のステータス履歴
- 作成時に自動採番される番号・ID
- レコード番号
- スレッドID（スペース内スレッド）
- コメントID
- プロセス管理のアクション履歴ID
- 添付ファイルID
- アプリID
- スペースID
- レコードのコメント
- 定期レポート
補足
レコードのコメントは、内容の取得・登録はできますが、日時と投稿者が再現できないため完全に復元はできません。
移行後の確認とテスト
固定リンクがコピーされました
新しい環境にデータを移行した後は、データの整合性やカスタマイズ、プラグイン、連携サービスの動作確認を実施してください。
まとめ
固定リンクがコピーされました
このTipsでは、kintoneを新しい環境へ移行する際の、取得が必要なデータや復元方法について説明しました。
kintoneを新しい環境に移行する際は、手順を確認してから作業することをおすすめします。
また、プラグインや連携サービスについては、新しい環境に再設定する必要があるため、移行前に設定内容を確認してください。