テンプレート処理中にエラーが発生しました。 
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@2ad66ae2"; 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> 
フィードバックを送信

マイクロサービスクライアント拡張プロジェクトの展開と管理

Kyleは、 マイクロサービスのクライアント拡張 を使用して、ユーザーから提出されたフィードバックを追跡するためのカスタムアプリケーションの開発を始めたいと考えている。

Liferayのサンプルワークスペース から Spring Boot を使ってマイクロサービスクライアント拡張のサンプルを試すことから始めます。

サンプルワークスペースのダウンロード

クライアント拡張用のサンプル・ワークスペースをお使いのマシンにダウンロードし、解凍します：

curl -o com.liferay.sample.workspace-latest.zip https://repository.liferay.com/nexus/service/local/artifact/maven/content\?r\=liferay-public-releases\&g\=com.liferay.workspace\&a\=com.liferay.sample.workspace\&\v\=LATEST\&p\=zip

unzip com.liferay.sample.workspace-latest.zip

ワークスペースを解凍したら、 client-extensions/liferay-sample-etc-spring-boot/ フォルダを開いて先に進みます。

サンプルのSpring Bootプロジェクトを設定する

サンプルのSpring Bootプロジェクトでは、 application.properties ファイルを使って、対象のLiferayインスタンスのドメインなど重要な値を登録しています。 デプロイする前にSpring Bootプロジェクトを設定する。

  1. ダウンロードしたサンプルのSpring Bootプロジェクトで、 src/main/resources/application.properties ファイルを開く。

  2. com.liferay.lxc.dxp.domains と com.liferay.lxc.dxp.mainDomain のプロパティを、UATサイトのドメインを使って追加する（例： uat.delectablebonsai.com）：

    com.liferay.lxc.dxp.domains=YOUR DOMAIN
com.liferay.lxc.dxp.mainDomain=YOUR DOMAIN

  3. https プロトコル用のプロパティを追加する：

    com.liferay.lxc.dxp.server.protocol=https

これでプロジェクトはLXCインスタンス用に正しく設定され、デプロイする準備ができた。

プロジェクトのビルドとデプロイ

サンプルのSpring Bootプロジェクトのフォルダからプロジェクトをビルドし、LXCインスタンスにデプロイする。

  1. このコマンドを実行すると、プロジェクトがデプロイ可能な クライアント拡張機能のパッケージ化 にビルドされます：

    ../../gradlew clean build

    クライアント拡張との連携 で定義されているため）、デプロイに必要なすべてのコンポーネントを含むLUFFAを dist/ フォルダに生成します。

  2. CLIツールを使用して、ビルドされたLUFFAをデプロイします：

    lcp deploy --extension dist/liferay-sample-etc-spring-boot.zip

    プロンプトが表示されたら、UATクライアントの拡張環境に対応する番号を選択します。

プロジェクトをデプロイするUATクライアント拡張環境の番号を入力します。

クライアントエクステンションはUAT環境にデプロイされ、遅延後にクラウドコンソールに表示されます。 Readyステータスは、サービスコンテナが実行され、Spring Bootアプリケーションが起動すると表示される。

Spring Bootサーバーが起動したことをコンソールで確認する。

オブジェクトデータの追加

オブジェクト はLiferayのデータをクライアント拡張機能で永続化し、操作するための理想的な方法です。

デプロイしたプロジェクトの マイクロサービスのクライアント拡張 のいずれかを呼び出す アクション を持つオブジェクト定義を作成します。

オブジェクト定義の作成

  1. UATのLiferayインスタンスにログインします。

  2. アプリケーションメニュー ( Applications menu ) → コントロールパネル → オブジェクト を開きます。

  3. Objects（オブジェクト）ページで、 Add（ Add icon ）をクリックし、New Custom Object（新規カスタムオブジェクト）フォームに必要事項を記入する：

    • ラベル : フィードバック入力

    • Plural Label : フィードバック入力

    • オブジェクト名 : FeedbackInput

    フィードバック入力オブジェクト定義の基本情報を入力します。

  4. ［Save］ をクリックします。

    オブジェクト定義はドラフトとして作成されるが、オブジェクト・アクション・クライアント拡張を使用するには、フィールドとアクションが必要である。

ブール値フィールドの追加

  1. Objects List の Feedback Input オブジェクト定義 をクリックして編集します。

  2. Fields タブをクリックする。

  3. Add( Add icon ) をクリックし、New Field フォームに記入する：

    • ラベル : 参考になりましたか？

    • フィールド名 : 役に立つ

    • タイプ : ブーリアン

  4. ［Save］ をクリックします。

クライアント拡張機能を呼び出すアクションを追加し、公開する

  1. Actions タブをクリックする。

  2. Add( Add icon ) をクリックする。

  3. アクションの基本情報フォームに記入する：

    • アクション・ラベル : 新しいフィードバック

    • アクション名 : NewFeedback

  4. アクションビルダー タブをクリックします。

  5. Trigger ドロップダウンメニューで、 On After Add を選択する。

  6. Actionドロップダウンメニューで、 object-action-executor[function#liferay-sample-etc-spring-boot-object-action-1]を選択します。

    最初のSpring Bootオブジェクトアクションクライアント拡張のオブジェクトアクション実行者エントリを選択します。

  7. ［Save］ をクリックします。

  8. オブジェクト定義の Details タブに戻り、 Publish をクリックします。

これでオブジェクト定義がパブリッシュされ、それを使ってオブジェクト・データを送信できるようになった。

オブジェクト・データの提出

新しいオブジェクト定義を使ってフォームを追加し、オブジェクトのアクションをテストできるようにしましょう。

  1. サイトのホームページに戻る。

  2. ページ上部の Edit( Edit icon ) をクリックします。

  3. 画面左側のフラグメントのリストで、 Form Container フラグメントをページにドラッグします。

    フォームコンテナのフラグメントをページにドラッグして、オブジェクト定義にマッピングできるフォームを作成します。

  4. Form Container のドロップダウンメニューで、新しい Feedback Input オブジェクト定義 を選択します。

  5. ページ上部の Publish をクリックします。

オブジェクトの 役に立つ 入力が、シンプルなフォームのチェックボックスになりました。

このフォームは、"役に立ちましたか？"のチェックボックス1つとともにページに表示される。

  1. Submit ボタンをクリックしてください。

フォームを送信するとオブジェクトエントリーが作成され、デプロイしたオブジェクトアクションクライアントエクステンションが呼び出されます。

クラウド・コンソールで結果を調べる

オブジェクトアクションをトリガーしたので、Spring Bootアプリケーションのロギングをチェックして、呼び出しが成功したことを確認します。

  1. クラウド・コンソールにログインし、UAT環境に移動します。

  2. Services をクリックすると、デプロイされたマイクロサービスの全リストが表示されます。

  3. liferaysampleetcspringboot サービスを選択する。

サービスのページにはデフォルトでLogsタブが表示され、Spring BootアプリケーションのログがLiferayから送られてきたオブジェクトデータを出力しているのを見ることができます。

Liferayがオブジェクトアクションクライアントエクステンションをトリガーした結果をログで確認してください。

これで、オブジェクト・アクションが正常に動作しているのがわかるだろう。

マイクロサービスを削除する

カイルはこのオブジェクトアクションをカスタマイズしてみるつもりだが、何を追加するか考える間、このバージョンをUAT環境にデプロイする必要はない。

サンプルのマイクロサービスを使い終わったら、コンソールからサービスを削除してください。

  1. サービスのページで、右上の Actions( Actions menu ) をクリックし、 Delete Service をクリックします。

  2. liferaysampleetcspringboot と入力し、削除の影響を確認する。

    サービス名を入力すると、削除ボタンが有効になります。

  3. Delete Service をクリックする。

    クライアント拡張サービスを削除すると、オブジェクト定義のアクションへのリンクも切断されます。 通常は、現在使用していないオブジェクトアクションも削除しますが、今回は、次の練習のために再作成するステップを省くために、そのままにしておきます。

遅延の後、サービスは削除され、クラウド・コンソールから消えます。

これでサンプルのSpring BootアプリケーションのUATテストは成功です。

次ページ： コンソールでのトラブルシューティング.

関連コンセプト