テンプレート処理中にエラーが発生しました。 
Java method "com.liferay.portal.json.JSONFactoryImpl.createJSONObject(String)" threw an exception when invoked on com.liferay.portal.json.JSONFactoryImpl object "com.liferay.portal.json.JSONFactoryImpl@51577ebb"; see cause exception in the Java stack trace.

----
FTL stack trace ("~" means nesting-related):
	- Failed at: navigationJSONObject = jsonFactoryUti...  [in template "17855804202317#32484267#LEARN-ARTICLE-NAV" at line 4, column 9]
----
1<#assign 
2	groupFriendlyURL = themeDisplay.getScopeGroup().getFriendlyURL() 
3	groupPathFriendlyURLPublic = themeDisplay.getPathFriendlyURLPublic() + groupFriendlyURL 
4	navigationJSONObject = jsonFactoryUtil.createJSONObject(navigation.getData()) 
5	navigationMenuItems = 
6		{ 
7			"Analytics Cloud": { 
8				"image": "/documents/d${groupFriendlyURL}/analytics_c-svg", 
9				"title": "Analytics Cloud", 
10				"url": "analytics-cloud" 
11			}, 
12			"Commerce": { 
13				"image": "/documents/d${groupFriendlyURL}/commerce_product-svg", 
14				"title": "Commerce", 
15				"url": "commerce" 
16			}, 
17			"DXP": { 
18				"image": "/documents/d${groupFriendlyURL}/dxp_p-svg", 
19				"title": "DXP / Portal", 
20				"url": "dxp" 
21			}, 
22			"Liferay Cloud": { 
23				"image": "/documents/d${groupFriendlyURL}/dxp_c-svg", 
24				"title": "Liferay Cloud", 
25				"url": "liferay-cloud" 
26			}, 
27			"Reference": { 
28				"image": "/documents/d${groupFriendlyURL}/reference-svg", 
29				"title": "Reference", 
30				"url": "reference" 
31			} 
32		} 
33 
34	breadcrumbJSONArray = navigationJSONObject.getJSONArray("breadcrumb") 
35	childrenJSONArray = navigationJSONObject.getJSONArray("children") 
36	parentJSONObject = navigationJSONObject.getJSONObject("parent") 
37	productJSONObject = breadcrumbJSONArray.getJSONObject(breadcrumbJSONArray.length()-1)!navigationJSONObject.getJSONObject("self") 
38	siblingsJSONArray = navigationJSONObject.getJSONArray("siblings") 
39/> 
40 
41<div class="learn-article-nav"> 
42	<#if productJSONObject?has_content && productJSONObject.getString("title")?has_content && navigationMenuItems[productJSONObject.getString("title")]?has_content && navigationMenuItems[productJSONObject.getString("title")].title?has_content> 
43		<div 
44			class="dropdown learn-article-nav-root learn-dropdown" 
45		> 
46			<div class="learn-article-nav-item"> 
47				<div class="d-flex"> 
48					<div class="learn-article-nav-image"> 
49						<img 
50							class="lexicon-icon lexicon-icon-caret-bottom product-icon" 
51							role="presentation" 
52							src='${navigationMenuItems[productJSONObject.getString("title")].image}' 
53							viewBox="0 0 512 512" 
54						/> 
55					</div> 
56 
57					<span class="learn-article-nav-text">${navigationMenuItems[productJSONObject.getString("title")].title}</span> 
58				</div> 
59 
60				<div id="dropdown-icon"> 
61					<svg 
62						class="lexicon-icon lexicon-icon-caret-bottom" 
63						role="presentation" 
64						viewBox="0 0 512 512" 
65					> 
66						<use xlink:href="/o/admin-theme/images/clay/icons.svg#caret-bottom"></use> 
67					</svg> 
68				</div> 
69			</div> 
70 
71			<ul class="dropdown-menu learn-dropdown-menu"> 
72				<#list navigationMenuItems as key, value> 
73					<li> 
74						<a 
75							class="dropdown-item learn-article-nav-item" 
76							href="/w/${navigationMenuItems[key].url}/index" 
77							tabindex="4" 
78						> 
79							<span class="d-flex"> 
80								<span class="learn-article-nav-image"> 
81									<img 
82										class="lexicon-icon lexicon-icon-caret-bottom product-icon mt-0 mr-2" 
83										role="presentation" 
84										src="${value.image}"height: 25px; margin-left: 5px; max-width: none; width: 25px; 
85										viewBox="0 0 512 512" 
86									/> 
87								</span> 
88								<span class="learn-article-nav-text">${value.title}</span> 
89							</span> 
90 
91							<#if navigationMenuItems[productJSONObject.getString("title")].url == value.url> 
92								<span> 
93									<@clay["icon"] symbol="check" /> 
94								</span> 
95							</#if> 
96						</a> 
97					</li> 
98				</#list> 
99			</ul> 
100		</div> 
101	</#if> 
102 
103	<div class="learn-article-nav-content"> 
104		<#if parentJSONObject?has_content && parentJSONObject.getString("url")?has_content> 
105			<div class="learn-article-nav-item learn-article-nav-parent liferay-nav-item p-2"> 
106				<div class="mr-2"> 
107					<a 
108						href='${parentJSONObject.getString("url")}' 
109					> 
110						<svg 
111							class="lexicon-icon lexicon-icon-angle-left" 
112							role="presentation" 
113							viewBox="0 0 512 512" 
114						> 
115							<use xlink:href="/o/admin-theme/images/clay/icons.svg#angle-left"></use> 
116						</svg> 
117					</a> 
118				</div> 
119 
120				<span>${parentJSONObject.getString("title")}</span> 
121			</div> 
122		</#if> 
123 
124		<#if childrenJSONArray.length() gt 0> 
125			<ul class="m-0 p-2"> 
126				<#list 0..childrenJSONArray.length()-1 as i> 
127					<li class="learn-article-nav-item"> 
128						<a 
129							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == childrenJSONArray.getJSONObject(i).url)?then("selected", "")}' 
130							href="${childrenJSONArray.getJSONObject(i).url}" 
131						> 
132							<span>${childrenJSONArray.getJSONObject(i).getString("title")}</span> 
133						</a> 
134					</li> 
135				</#list> 
136			</ul> 
137		<#elseif siblingsJSONArray.length() gt 0> 
138			<ul class="m-0 p-2"> 
139				<#list 0..siblingsJSONArray.length()-1 as i> 
140					<li class="learn-article-nav-item"> 
141						<a 
142							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == siblingsJSONArray.getJSONObject(i).url)?then("selected", "")}' 
143							href="${siblingsJSONArray.getJSONObject(i).url}" 
144						> 
145							<span>${siblingsJSONArray.getJSONObject(i).getString("title")}</span> 
146						</a> 
147					</li> 
148				</#list> 
149			</ul> 
150		</#if> 
151	</div> 
152</div> 
フィードバックを送信

構成とプロパティの移行

現在のDXPインストールのOSGi構成（7.0以降）とプロパティ（ポータルプロパティやシステムプロパティなど）によって、ニーズに合わせてDXPインスタンスがセットアップされます。 これらの設定を新しいDXPインスタンスで使用するには、それらを新しいLiferay Homeに移行して更新する必要があります。

概要

Liferayホームおよびアプリケーションサーバーファイルの移行

  1. バックアップからインストールに追加および編集した Liferayホームファイル および アプリケーションサーバーファイル をマージします。 ファイルには次のものが含まれる場合がありますが、これらに限定されません。

    • /license/*：アクティベーションキー。 (サブスクリプション)
    • /log/*：ログファイル。
    • /osgi/configs/*.config：OSGi設定ファイル。
    • portal-*.properties：portal-ext.propertiesのようなポータルプロパティファイル。
    • アプリケーションサーバーファイル：変更されたスクリプトと設定ファイル。
    • web.xml：ポータルWebアプリケーション記述子。

  2. 新しいインストールの［Liferay Home］/dataフォルダを、バックアップの［Liferay Home］/dataフォルダと置き換えます。

  3. ファイル ストア (ドキュメント ライブラリ)を、バックアップから新しいインストールにコピーするか、または .configファイル を介して使用するように新しいインストールを設定してセットアップします。

データベースアップグレードの設定の更新

DXPおよび一部のマーケットプレイスアプリのアップグレードプロセスでは、ポータルプロパティとOSGi構成を使用します。 カスタムコードのアップグレードプロセスでも、プロパティの更新と構成の更新が必要になる場合があります。 これらの設定と更新は、データベースのアップグレード 前 に行う必要があります。 その他の更新は、データベースのアップグレード後に行うことができます。

DXPアップグレードプロセスに必要な設定の更新は次のとおりです。

important

マーケットプレイスアプリとカスタムコードで、必要な設定の更新を確認してください。

データベースドライバー

推奨されるデータベースドライバーについては、データベースベンダーのドキュメントを確認してください。 新しいドライバーが推奨されている場合は、既存のドライバーのJARファイルを置き換え、portal-ext.propertiesファイルのjdbc.default.driverClassNameプロパティを新しいドライバークラス名で更新します。

MySQLの例：

jdbc.default.driverClassName=com.mysql.cj.jdbc.Driver

その他のドライバーの例については、 データベーステンプレート を参照してください。

ポータルプロパティの移行

important

locales ポータルプロパティをオーバーライドした場合は、アップグレードする前に新しいインストールでそれをアップグレードしてください。 これにより、すべてのロケールのデータが確実にアップグレードされます。

ここで説明するプロパティは、データベースのアップグレード後に更新できます。 プロパティの移行には、次のアクションが含まれます。

  • liferay.homeプロパティを更新する（変更している場合）
  • ブレードCLIを使用してプロパティの変更を報告する
  • プロパティをOSGi構成に変換する
  • プロパティの移行に関する特別な考慮事項

Blade CLIを使用して互換性のないプロパティを報告する

Blade CLIツールのupgradePropsコマンドは、ポータルプロパティファイル間の変更を報告します。 このツールは、次のタイプの変更を報告します。

  • 更新されていない場合に例外を発生させるプロパティ。
  • モジュールのportal.propertiesファイルに移動されたプロパティ。
  • OSGi構成に移動されたプロパティ。
  • 新しいDXPバージョンにはないプロパティ。

多くの場合、upgradePropsコマンドは、必要な更新を説明するか、プロパティの変更に関する詳細情報を参照します。

blade upgradePropsコマンドの形式：

blade upgradeProps -p {old_liferay_home_path}/portal-ext.properties -d {new_liferay_home_path}

次に、blade upgradePropsコマンドを実行した場合の出力例を示します。

...
index.search.query.suggestion.dictionary
    MODULARIZE AS OSGI - This property matches with the following OSGI config, select the most appropriate:
        - searchQueryResultWindowLimit from com.liferay.portal.search.configuration.DefaultSearchResultPermissionFilterConfiguration

index.search.spell.checker.dictionary
    KEEP - This property is still present in the new portal.properties.

sites.friendly.url.page.not.found
    KEEP - This property is still present in the new portal.properties.

web.server.protocol
    KEEP - This property is still present in the new portal.properties.
...

プロパティをOSGi構成に変換する

モジュール化された機能のプロパティが変更され、OSGi構成ファイル（OSGi構成管理）にデプロイされるようになりました。

たとえば、6.2では、Simple File Storeがこのポータルプロパティを使用して、ストアのルートディレクトリを指定していました。

dl.store.file.system.root.dir=${liferay.home}/data/document_library

これで、ストアはcom.liferay.portal.store.file.system.configuration.FileSystemStoreConfiguration.configと呼ばれる.configファイルで構成され、次のような設定でルートディレクトリを指定します。

rootDir="{document_library_path}"

.configファイルを［Liferay Home］/osgi/configsというフォルダに配置します。

tip

コントロールパネルの［System Settings］画面（［Configuration］の下）は、OSGi構成管理の値を管理します。 これらの画面は.configファイルを作成する最も正確な方法です。 設定したい機能を設定している画面を見つけて Save をクリックし、オプションボタンを使って 画面の設定をエクスポートする して .config ファイルに保存します。

プロパティの移行に関する特別な考慮事項

特定の環境、Liferayのバージョン、および機能に関連するプロパティを移行するためのリソースがあります。 便宜上、ここで呼び出しています。

  1. ファイルストア設定の更新については、Updating the File Storeで説明しています。

  2. Liferay Portal 6.1以前を使用している場合は、 Liferay Portal 6.2で導入された新しいデフォルトにプロパティを適合 させてください。

  3. シャード化された環境がある場合は、シャード化されていない環境を生成するようにアップグレードを構成します。

  4. 7.4、7.3、および7.2でのデフォルトのポータルプロパティの変更を調べます。

  5. Liferayの画像スプライトフレームワークは7.2で非推奨になり、デフォルトでは無効になっています。 フレームワークには、画像スプライト用のスキャンプラグインが必要です。 フレームワークを使用しない場合、画像スプライトをスキャンするためにフレームワークを使用する必要はありません。 フレームワークを使用する場合は、デフォルトのsprite.enabledポータルプロパティ（7.2以降）の値を、portal-ext.propertiesファイルの次の設定でオーバーライドすることにより、フレームワークを有効にします。

    sprite.enabled=true
    note

    好きなフレームワークを使用して画像スプライトを作成し、プラグインにデプロイできます。

次のステップ

Liferayの設定を新しいDXPインスタンスで使用する準備ができました。 次に、ファイルストアを更新します。