ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

データ移行センター

Liferay DXP 2023.Q4+/Portal GA102+ ベータ機能

重要

現在、この機能はベータ機能フラグ (COMMERCE-8087) で保護されています。データ移行センターは現在、オブジェクト定義、オブジェクトエントリ、および API アプリケーションのインポートとエクスポートのみをサポートしています。詳細については、ベータ機能フラグをお読みください。

データ移行センターを使用すると、Liferay インストール間でオブジェクト定義とオブジェクトエントリを簡単に移動できます。

データ移行センターにアクセスするには、

グローバルメニュー () → アプリケーション → データ移行センターに移動します。
インポートとエクスポート タブをクリックすると、インポートおよびエクスポートタスクとそのステータスのリストが表示されます。以前のタスクからファイルをダウンロードするには、エクスポート/インポートタスクの横にある アクション () アイコンをクリックします。
インポートおよびエクスポートテンプレートのリストを表示するには、 テンプレート タブをクリックします。

データ移行センターでは、

オブジェクト定義のエクスポート
オブジェクト定義のインポート
オブジェクトエントリのエクスポート
オブジェクトエントリのインポート

オブジェクト定義のエクスポート

追加 () をクリックし、 ファイルのエクスポートを選択します。
(オプション) 以前に保存したテンプレートを使用する場合は、次のページでエクスポート テンプレート を選択します。
エンティティタイプとして ObjectDefinition (v1_0 - Liferay Object Admin REST) を選択します。

ObjectDefinition (v1_0 - Liferay Object Admin REST) オプションが表示されない場合は、別のエクスポートファイル形式 (JSON、JSONL、または JSONT) を選択します。
エクスポートファイル形式の 1 つを選択します。

注

データ移行センターは、オブジェクト定義のインポートに JSON および JSONL ファイル形式のみをサポートしています。

バッチクライアント拡張機能と組み合わせて使用するためにエクスポートする場合は、JSONT ファイル形式を選択します。 *.batch-engine-dat.json ファイルには JSONT が必要です。
「フィールド」セクションで、エクスポートするオブジェクト定義フィールドを選択します。

少なくとも 1 つのフィールドを選択する必要があります。
(オプション) テンプレートとして保存 をクリックして、将来使用するためにエクスポート設定を保存します。テンプレートに名前を付けて、 [保存]をクリックします。
最後に、 エクスポート をクリックして、オブジェクト定義をエクスポートします。
エクスポートタスクを表示するウィンドウが表示されます。ジョブが完了したら、 ダウンロード をクリックして、zip ファイルをローカルマシンにダウンロードします。

注

ウィンドウを閉じてもエクスポート/インポートタスクは停止しません。完了したら、「インポートとエクスポート」タブからファイルをダウンロードできます。

オブジェクト定義のインポート

追加 () をクリックし、 ファイルのインポートを選択します。
次のページで、新しいインポートタスクの名前を入力します。
(オプション) 以前に保存したテンプレートを使用する場合は、インポート テンプレート を選択します。
エンティティタイプとして ObjectDefinition (v1_0 - Liferay Object Admin REST) を選択します。
エラー発生時にインポートタスクを停止するか続行するかを指定するには、このボックスをオンにします。
[インポート戦略] で、[レコードの追加または更新] または [新しいレコードのみの追加] を選択します。

「新しいレコードの追加のみ」では、エンティティが既に存在する場合、インポートタスクはエラーで失敗します。代わりに レコードの追加または更新 を選択すると、データ移行センターによって既存のエンティティが上書きされ、存在しない場合は新しいエンティティが作成されます。
[更新戦略] で、[変更されたレコードフィールドの更新] または [レコードの上書き] を選択します。

レコードの上書きでは、エンティティ全体が更新されます。変更されたレコードフィールドを更新すると、インポートファイルで定義されたフィールドのみが更新され、残りの既存の値はそのまま残ります。
ファイル設定で、 [ファイルを選択] をクリックし、インポートするオブジェクト定義を含むファイルを見つけます。

注

データ移行センターは、オブジェクト定義のインポートに JSON および JSONL ファイル形式のみをサポートしています。
[インポートマッピング] で、[ソースファイルフィールド] の下のドロップダウンリストを選択してマッピングを変更します。
(オプション) テンプレートとして保存 をクリックして、将来使用するためにエクスポート設定を保存します。テンプレートに名前を付けて、 [保存]をクリックします。
インポートを続行するには、次へをクリックします。ポップアップウィンドウで、 インポートの開始をクリックします。
ポップアップウィンドウにインポートタスクの進行状況が表示されます。完了したら、 「閉じる 」をクリックします。

インポートタスクでエラーが発生した場合は、メインのデータ移行ページに戻り、 オプション () をクリックしてエラーレポートをダウンロードします。
インポートしたオブジェクトの定義を確認するには、 グローバルメニュー () → コントロールパネル → オブジェクト に移動します。

オブジェクトエントリのエクスポート

オブジェクトエントリをエクスポートするには、オブジェクト定義のエクスポートの場合と同じように、ほとんどのプロセスに従います。

主な違いは次のとおりです。

エンティティタイプとして ObjectDefinition (v1_0 - Liferay Object Admin REST) を選択する代わりに、エクスポートするオブジェクトを選択します (例: C_YourObject (v1_0 - Liferay Object REST))。オブジェクトの詳細については、オブジェクトの作成と管理を参照してください。
Liferay DXP 2024.Q1+/Portal GA112+ オブジェクト定義がサイトスコープの場合、リストからサイトを選択し、選択したサイトからエントリをエクスポートすることで、 スコープ を定義できます。
Liferay DXP 2024.Q1+/Portal GA112+ エクスポートファイル形式として、カンマ区切り値 (CSV) ファイルを選択できます。

生成された CSV ファイルには常にヘッダーが含まれます。

CSV 形式を使用する場合は、フィールドリストでサポートされているフィールドとエクスポート用に選択できるフィールドを確認します。

重要

CSV ファイルは現在、集計、添付ファイル、ブール値、日付、日付と時刻、小数、暗号化、数式、整数、長い整数、長いテキスト、複数選択選択リスト、選択リスト、精度小数、リッチテキスト、テキストのフィールドタイプをサポートしています。オブジェクト定義はサポートされていません。

オブジェクトエントリのインポート

オブジェクトエントリをインポートするには、オブジェクト定義のインポートの場合と同じように、ほとんどのプロセスに従います。

注

エントリをインポートする前に、オブジェクトが存在することを確認してください。

主な違いは次のとおりです。

エンティティタイプとして ObjectDefinition (v1_0 - Liferay Object Admin REST) を選択する代わりに、インポートするオブジェクトを選択します (例: C_YourObject (v1_0 - Liferay Object REST))。オブジェクトの詳細については、オブジェクトの作成と管理を参照してください。
Liferay DXP 2024.Q1+/Portal GA112+ オブジェクト定義がサイトスコープの場合、リストからサイトを選択し、選択したサイトにエントリをインポートすることで、 スコープ を定義できます。
Liferay DXP 2024.Q1+/Portal GA112+ カンマ区切り値 (CSV) ファイルからオブジェクトエントリをインポートできます。

CSV ファイルを追加し、ヘッダーがあるかどうかを構成します。

CSV セパレーター—を定義します。これは、CSV ファイル内の個々のフィールドを区切るために使用される文字です。通常、これはコンマですが、セミコロンやパイプなどの異なる文字を使用することもできます。

また、フィールド全体を囲み文字で囲む CSV 囲みも指定します。二重引用符または一重引用符を使用できます。

たとえば、区切り文字としてコンマ、囲み文字として二重引用符を定義し、"New York, USA" のようなフィールドがある場合、コンマは二重引用符で囲まれているため区切り文字とはみなされません。 2つのフィールド（「ニューヨーク」と「米国」）ではなく、1つのフィールド（「米国ニューヨーク」）のみがあります。

CSV ファイルにサポートされていないフィールドタイプが含まれている場合、ファイル形式エラーは表示されず、プロセスはエントリの読み込みを試行します。

重要

CSV ファイルは現在、次のフィールドタイプをサポートしています: dateandtime、 date、 decimal、 integer、 longint、 longtext、 precisiondecimal、 richtext、 text、および ピックリスト。