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

アーティファクトの検索

プロジェクトで外部アーティファクトを使用するには、build.gradle Gradle スクリプトでそれらの依存関係を構成する必要があります。

アーティファクトを依存関係として指定する前に、まずその属性を見つける必要があります。 アーティファクトには次の属性があります。

  • グループID ：オーサリング組織
  • アーティファクトID ：名前/識別子
  • バージョン ：リリース番号

ここでは、アーティファクト属性を見つけて依存関係を指定する方法を学習します。

コアアーティファクト属性の検索

各Liferayアーティファクトは、アーティファクトのOSGiバンドルメタデータ属性を含むMETA-INF/MANIFEST.MFファイルが含まれるJARファイルです。 たとえば、次の2つのOSGiヘッダーは、アーティファクトIDとバージョンを指定します。

Bundle-SymbolicName:  [artifact ID]
Bundle-Version: [version]
important

Liferay DXPフィックスパックのアーティファクトは、Liferay DXPインストールアーティファクトをオーバーライドします。 フィックスパックの binariesフォルダには、サブフォルダのアーティファクトが含まれています。 プロジェクトでフィックスパックによって提供されるアーティファクトが必要な場合は、依存関係を宣言するときにフィックスパックからバージョンを宣言してください。

Liferayのコアアーティファクトを見つける場所は次のとおりです。

ファイルグループIDアーティファクトIDバージョン原点
portal-kernel.jarcom.liferay.portalcom.liferay.portal.kernel（JARの MANIFEST.MFを参照）フィックスパックZIP、Liferayインストール、またはLiferay依存関係ZIP
portal-impl.jarcom.liferay.portalcom.liferay.portal.impl（JARの MANIFEST.MFを参照）フィックスパックZIPまたはLiferay .war
util-bridges.jarcom.liferay.portalcom.liferay.util.bridges（JARの MANIFEST.MFを参照）フィックスパックZIPまたはLiferay .war
util-java.jarcom.liferay.portalcom.liferay.util.java（JARの MANIFEST.MFを参照）フィックスパックZIPまたはLiferay .war
util-slf4j.jarcom.liferay.portalcom.liferay.util.slf4j（JARの MANIFEST.MFを参照）フィックスパックZIPまたはLiferay .war
util-taglibs.jarcom.liferay.portalcom.liferay.util.taglib（JARの MANIFEST.MFを参照）フィックスパックZIPまたはLiferay .war
com.liferay.* JARファイルcom.liferay（JARの MANIFEST.MFを参照）（JARの MANIFEST.MFを参照）フィックスパックZIP、Liferayインストール、Liferay依存関係ZIP、またはOSGi ZIP

次に、Liferayアプリと独立したモジュールアーティファクトの属性を見つける方法を学びます。

Liferayアプリと独立したアーティファクトの検索

コア外のモジュールの場合でも、必要なモジュールへの依存関係を指定する必要があります。 必要な依存関係を見つけるには、次の3つの方法があります。

リソースアーティファクトタイプ
アプリケーションマネージャデプロイされたモジュール
参照ドキュメントLiferayモジュール（リリースごと）
Maven Centralすべてのアーティファクトのタイプ：Liferayとサードパーティ、モジュールと非モジュール
important

com.liferayは、Liferayのすべてのアプリと独立したモジュールのグループIDです。

アプリケーションマネージャは、デプロイされたモジュールに関する最良の情報を提供します。

アプリケーションマネージャ

アプリケーションマネージャは、Liferayインスタンスにデプロイされているものを表示します。

  1. Liferayで、 グローバルメニュー（Global Menu icon）をクリックし、 ［コントロールパネル］ タブを選択します。

  2. ［System］カテゴリで、 ［App Manager］ を選択します。

  3. 表示名、シンボル名、または関連するキーワードでモジュールを検索します。 アプリの一覧からモジュールを閲覧することもできます。 閲覧するか検索するかにかかわらず、アプリマネージャーは各モジュールのアーティファクトIDとバージョン番号を表示します。

アプリケーションマネージャは、デプロイされた各モジュールのアーティファクトIDとバージョン番号を表示します。

アプリケーションマネージャは、独立モジュールを独立モジュールカテゴリに集約します。

アプリケーションマネージャは、独立したモジュールを集約します。

独立したモジュールのグループIDがわからない場合は、Felix Gogo シェルを使用して検索します。

  1. コントロールパネルの［System］カテゴリで、 ［Gogo Shell］ を選択します。 Gogo シェルコマンドプロンプトにコマンドを入力します。

  2. 表示名（Apache Aries CDIなど）またはキーワードでモジュールを検索します。 結果で、モジュールの番号をメモします。 次のステップで使用できます。 以下の例は、Liferay Announcements APIモジュール番号47を示しています。

    このGogoコマンドの結果は、モジュールの番号が `47 であることを示しています。

  3. モジュール番号を指定してheadersコマンドを使用して、マニフェストヘッダーを表示します。 Bundle-VendorまたはImplementation-Vendorの値に注目してください。 後のステップでアーティファクトグループと照合します。

    headers コマンドを実行した結果は、モジュールのベンダー名とバンドルバージョンを示しています。

  4. Maven Central または MVNRepository で、アーティファクトIDでモジュールを検索します。

  5. 手順3のBundle-VendorまたはImplementation-Vendorの名前を、アーティファクトを提供するグループと照合して、グループIDを決定します。

Liferay参照ドキュメントには、Liferayアプリのアーティファクト属性も記載されています。

参照ドキュメント

LiferayのアプリJavadocには、各アプリモジュールのアーティファクトID、バージョン番号、表示名が一覧表示されます。 これは、LiferayインスタンスにまだデプロイされていないLiferayアプリモジュールを検索するのに最適な場所です。

note

Liferayのコアアーティファクトのアーティファクト情報を見つけるには、前のセクションLiferayのコアアーティファクト属性の検索を参照してください。

JavadocでLiferayアプリモジュールの属性を見つけるには、次の手順に従います。

  1. アプリモジュールクラスのJavadocに移動します。 クラスのJavadocへのリンクがない場合は、LiferayエディションのアプリJavadocを閲覧してリンクを検索します。

    Liferay DXP : https://docs.liferay.com/dxp/apps

    Liferay Portal : https://docs.liferay.com/ce/apps

  2. クラスのパッケージ名をコピーします。

  3. ［Overview］ ページに移動します。

  4. ［Overview］ ページで、手順2でコピーしたパッケージ名を検索します。

パッケージ名の上の見出しには、モジュールのアーティファクトID、バージョン番号、表示名が表示されます。 すべてのアプリモジュールのグループIDはcom.liferayであることを思い出してください。

LiferayのアプリJavadocには、表示名に続いて、グループID、アーティファクトID、およびバージョン番号がGradleアーティファクト構文で表示されています。

note

現在、モジュールのバージョン番号はどのタグライブラリの参照ドキュメントにも含まれていません。

次に、MVNRepositoryおよびMaven Centralでアーティファクトを検索する方法を学習します。

Maven Central

タイプや原点に関係なく、ほとんどのアーティファクトは MVNRepository と MavenCentral にあります。 これらのサイトは、クラスパッケージに基づいてアーティファクトを見つけるのに役立ちます。 アーティファクトのパッケージ名の先頭にアーティファクトのIDを含めるのが一般的です。 たとえば、クラスorg.osgi.service.component.annotations.Componentに依存している場合は、Mavenサイトの1つでパッケージ名org.osgi.service.component.annotationsを検索します。

note

上記の手順に従って、必要なLiferayアーティファクトのバージョンを確認してください。

次のステップ

アーティファクトの属性がわかったので、アーティファクトへの依存関係を構成できます。 詳細については、依存関係の指定を参照してください。

関連トピック

Capability:
Development and Tooling
Resource Type:
Official Documentation
Feature:
Frameworks
Deployment Approach:
Liferay PaaS
Liferay Self-Hosted