7.3 旧バージョンと非互換の変更¶

このドキュメントは、サードパーティのLiferay開発者またはユーザーとの既存の機能、API、または契約に違反する変更の時系列リストを示しています。私たちはこれらの混乱を最小限にするために最善を尽くしていますが、時には避けられないこともあります。

このファイルに記載されている変更の種類の一部を次に示します。

削除または置換される機能
旧バージョンと非互換の変更：パブリックJavaまたはJavaScript APIの変更
テンプレートで利用可能なコンテキスト変数の変更
Liferayテーマおよびポートレットで利用可能なCSSクラスの変更
設定の変更：portal.properties、system.propertiesなどの設定ファイルの変更
実行要件：Javaバージョン、Java EEバージョン、ブラウザーバージョンなど
非推奨またはサポート終了：たとえば、次のバージョンで特定の機能またはAPIが停止されると警告している

旧バージョンと非互換の変更リスト¶

Liferay FontAwesomeはデフォルトで含まれなくなりました。¶

日付： 2019年8月21日
JIRAチケット：LPS-100021

変更点¶

Font Awesome、Glyphicon、およびカスタムLiferayアイコンのアイコンフォントが含まれていたLiferay FontAwesomeは、デフォルトでは含まれなくなりました。

影響を受ける人¶

これは、これらのアイコンフォント自体を含まないテーマが適用されているページまたはサイトに影響します。これらのアイコンフォントを使用するページやサイトのコンテンツやコードは機能しなくなります。

コードの更新方法¶

アイコンフォントの使用方法に応じて、いくつかの方法があります。

liferay-ui:icon使用の場合¶

<liferay-ui:icon iconCssClass="icon-user">を <liferay-ui:icon icon="user" markupView="lexicon" />と置き換える

JavaScriptで生成されたアイコンの場合¶

FontAwesomeアイコンhtmlを手動で生成する場合は、Liferay.Util.getLexiconIconTpl('user') APIを使用できます。たとえば、前の呼び出しは、ユーザーのsvgアイコンのHTMLコードを返します。

JSP内の直接HTMLの場合¶

JSPでアイコンを直接使用している開発者は、上記で説明したようにliferay-ui:iconタグ、もしくはclay:iconタグを使って、代わりにsvgベースのアイコンを生成できます。

非制御コードの場合¶

アイコンフォントを使用するコンテンツにアクセスできない場合、またはコードやコンテンツを更新したくない場合は、フォントをテーマに含めることができます。

7.2のアップグレードプロセス中、テーマアップグレードアシスタントは、FontAwesomeをテーマの一部として維持するよう開発者に促します。アイコンフォントが既に含まれているテーマは影響を受けず、7.3でも引き続き機能します。

変更が行われた理由¶

この変更は、不要なファイルを提供しないことで帯域幅を節約し、サイトのパフォーマンスを向上させるために行われました。

liferay.frontend.ProgressBarを削除¶

日付： 2019年8月28日
JIRAチケット：LPS-100122

変更点¶

従来の動作の一時的なブリッジとして使用されていたレガシーのmetal+soy liferay.frontend.ProgressBarコンポーネントが削除されました。

影響を受ける人¶

これは、liferay.frontend.ProgressBarに依存するすべてのコードに影響します。これは通常、{call liferay.frontend.ProgressBar /}としてsoyを介して行われます。

コードの更新方法¶

liferay.frontend.ProgressBarコンポーネントを直接置き換えるものはありません。それに依存するコンポーネントがある場合は、古い実装のコピーを同じ場所に配置して、モジュール内でローカルに使用できます。

変更が行われた理由¶

liferay.frontend.ProgressBarコンポーネントは7.2で非推奨になり、使用されなくなりました。

AssetCategoryのツリーパスが左右のカテゴリーIDに置き換わりました¶

日付： 2019年10月08日
JIRAチケット：LPS-102671

変更点¶

AssetCategoryの左右のカテゴリーIDが削除され、単一のツリーパスに置き換えられました。

影響を受ける人¶

これは、AssetCategoryおよび関連するAPIで左右のカテゴリーIDを使用するすべてのユーザーに影響します。

左右のカテゴリーIDは、主にAssetCategoryの内部階層ツリーに使用されていました。

削除されたAssetCategoryLocalService::rebuildTree(long groupId, boolean force)を除いて、既存のAssetCategoryサービスAPIは同じままです。

次のメソッドはAssetCategoryUtilから削除されました。

countAncestors
countDescendants
getAncestors
getDescendants

左右のカテゴリーIDに関連するメソッドはAssetEntryQueryから削除されました。

G_P_N_Vで終わるFinderメソッドは、P_N_Vで終わるメソッドに置き換えられました。

コードの更新方法¶

左右のカテゴリーIDの場合¶

左右のカテゴリーIDを使用している場合は、次のオプションを検討してください。

新しいツリーパスを使用するようにコードを調整する
サービスAPIを使用して同じ目標を達成できるかどうかを検討する

たとえば、category.getLeftCategoryId()およびcategory.getRightCategoryId()を介してカテゴリーIDを使用する代わりに、category.getTreePath()介してツリーパスを取得できます。次に、ツリーパスを使用します。

参考までに、このスニペットAssetCategoryLocalServiceは、カテゴリを追加するときにツリーパスを設定します。

if (parentCategory == null) {
    category.setTreePath("/" + categoryId + "/");
}
else {
    category.setTreePath(
        parentCategory.getTreePath() + categoryId + "/");
}

7.3.0-ga1 - AssetCategoryLocalServiceImpl.java#L122-L128 を参照してください。

AssetCategoryLocalService#rebuildTree(long, boolean)の場合¶

AssetCategoryLocalService#rebuildTree(long, boolean)の呼び出しは不要な場合があります。このメソッドは主に、現在は置き換えられている内部階層ツリーの実装を維持するために使用されていました。

既存のコードを再評価して、rebuildTreeメソッドの呼び出しがまだ必要かどうかを確認することを検討してください。

AssetCategoryUtilおよびAssetEntryQueryの場合¶

AssetCategoryUtilおよびAssetEntryQueryから削除されたメソッドを使用する場合は、次の提案を検討してください。

既存のコードを再評価する
既存のサービスAPIが同じ目標を達成できるかどうかを検討する

G P N_Vを含むFinderメソッドの場合¶

G_P_N_Vで終わるAssetCategory Finderメソッドを使用する場合は、代わりにP_N_Vで終わるメソッドを使用してください。

変更が行われた理由¶

この変更は、AssetCategoryの階層ツリーの実装を改善するために行われました。

liferay.frontend.Sliderを削除¶

日付： 2019年10月10日
JIRAチケット：LPS-100124

変更点¶

従来の動作の一時的なブリッジとして使用されていたレガシーのmetal+soy liferay.frontend.Sliderコンポーネントが削除されました。

影響を受ける人¶

これは、liferay.frontend.Sliderに依存するすべてのコードに影響します。これは通常、{call liferay.frontend.Slider /}としてsoyを介して行われます。

コードの更新方法¶

liferay.frontend.Sliderコンポーネントを直接置き換えるものはありません。それに依存するコンポーネントがある場合は、古い実装のコピーを同じ場所に配置して、モジュール内でローカルに使用できます。

変更が行われた理由¶

liferay.frontend.Sliderコンポーネントは7.2で非推奨になり、使用されなくなりました。

com.liferay.asset.taglib.servlet.taglib.soy.AssetTagsSelectorTagを削除¶

日付： 2019年10月15日
JIRAチケット：LPS-100144

変更点¶

Javaクラスcom.liferay.asset.taglib.servlet.taglib.soy.AssetTagsSelectorTagが削除されました。

影響を受ける人¶

これは、このクラスを直接インスタンス化または拡張するコードに影響します。

コードの更新方法¶

削除されたクラスを直接置き換えるものはありません。それに依存するコードがある場合は、古い実装を独自のプロジェクトにコピーし、ローカルバージョンに依存するように依存関係を変更する必要があります。

変更が行われた理由¶

asset:asset-tags-selector とそのコンポーネントはReactに移行され、古いタグとそのsoyインフラストラクチャーが不要になりました。

削除されたポータルプロパティuser.groups.copy.layouts.to.user.personal.site¶

日付： 2019年12月26日
JIRAチケット：LPS-106339

変更点¶

ポータルプロパティ user.groups.copy.layouts.to.user.personal.site とそれに関連付けられた動作が削除されました。

影響を受ける人¶

これは、ユーザーグループページをユーザーの個人サイトにコピーするために、 user.groups.copy.layouts.to.user.personal.site プロパティを true に設定したすべてのユーザーに影響します。

コードの更新方法¶

このプロパティを直接置き換えるものはありません。動作に依存している場合は、 UserGroupLocalServiceImpl#copyUserGroupLayouts の古い実装を独自のプロジェクトにコピーできます。

変更が行われた理由¶

このプロパティに関連付けられた動作は、6.2以降廃止されました。

EXTプラグインの自動デプロイのサポートを削除¶

日付： 2019年12月31日
JIRAチケット：LPS-106008

変更点¶

Auto Deployerを使用して（ liferay-home/deploy folderを介して）EXTプラグインをデプロイするためのサポートは削除されました。デプロイフォルダーにコピーされたEXTプラグインは認識されなくなりました。

影響を受ける人¶

これは、Auto Deployerを介してEXTプラグインをデプロイするすべてのユーザーに影響します。

コードの更新方法¶

削除された機能を直接置き換えるものはありません。 EXTプラグインがある場合は、手動でデプロイするか、 ant direct-deploy 使用する必要があります。

変更が行われた理由¶

この機能は7.1以降廃止されました。

OSGi構成プロパティautoUpgradeを置換¶

日付： 2020年1月3日
JIRAチケット：LPS-102842

変更点¶

com.liferay.portal.upgrade.internal.configuration.ReleaseManagerConfiguration.configで定義されたOSGiプロパティautoUpgradeは、ポータルプロパティupgrade.database.auto.runに置き換えられました。

モジュールのアップグレードプロセスのみを制御していた古いプロパティとは異なり、新しいプロパティはコアアップグレードプロセスにも影響します。デフォルト値は falseなので、起動時またはモジュールのデプロイ時にアップグレードプロセスは実行されません。モジュールのアップグレードプロセスは、Gogo シェルコンソールを介して、またはサーバーがダウンしているときはデータベースアップグレードツールを介していつでも実行できます。

このプロパティは、portal-developer.propertiesでtrueに設定されています

影響を受ける人¶

この変更は、サーバーの起動時またはモジュールの展開時にアップグレードを自動的に実行することを期待しているすべての環境に影響します。 upgrade.database.auto.runをtrueに設定することは、本番環境では推奨されません。ただし、サーバーの起動時にアップグレードする必要がある場合は、最初にLiferayデータベースとファイルストア（ドキュメントライブラリ）をバックアップします。

upgrade.database.auto.runをfalse（デフォルト値）に設定したが、データベースのアップグレードが必要な場合、Liferayは必要なアップグレードに関する情報を出力し、起動を停止します。データベースのアップグレードは通常、メジャー/マイナーのLiferayリリースで必要であり、初期のCE Portal GAリリースおよび特定のサービスパック（例外的な場合）で必要になる場合があります。フィックスパックではデータベースのアップグレードは必要ありません。起動時に、Liferayは保留中のマイクロ変更に関する情報を出力します。いつでもGogo シェルコンソールとリリースノートを使用して、このような変更を確認し、実行するかどうかを決定できます。

コードの更新方法¶

この変更はコードには影響しません。

変更が行われた理由¶

この変更は、コアとモジュール間の自動アップグレード機能を統合するために行われました。本番環境での起動時に新しいアップグレードプロセスが実行されないように、デフォルト値も変更されました。

SingleVMPoolUtilとMultiVMPoolUtilのクラスを削除しました。¶

日付： 2020年1月7日
JIRAチケット：LPS-106315

変更点¶

SingleVMPoolUtil および MultiVMPoolUtil クラスは削除されました。

影響を受ける人¶

これは、これらの削除されたクラスを使用している人に影響します。

コードの更新方法¶

PortalCacheHelperUtil の代わりに、 SingleVMPoolUtil または MultiVMPoolUtilを使用します。例えば、 SQLQueryTableNamesUtil をご覧ください。

変更が行われた理由¶

SingleVMPoolUtil と MultiVMPoolUtil クラスは、もともと LPS-84138 で非推奨とされていたものです。クラスは廃止されました。

キャッシュブートストラップ機能を削除¶

日付： 2020年1月8日
JIRAチケット：LPS-96563

変更点¶

キャッシュブートストラップ機能は削除されました。これらのプロパティは、キャッシュブートストラップを有効化/構成するために使用できなくなりました。

ehcache.bootstrap.cache.loader.enabled
ehcache.bootstrap.cache.loader.properties.default
ehcache.bootstrap.cache.loader.properties.${specific.cache.name}

影響を受ける人¶

これは、上記のプロパティを使用するすべてのユーザーに影響します。

コードの更新方法¶

削除された機能を直接置き換えるものはありません。それに依存するコードがある場合は、自分で実装する必要があります。

変更が行われた理由¶

この変更は、セキュリティの問題を回避するために行われました。

liferay-frontend:cards-treeviewタグを削除¶

日付： 2020年1月10日
JIRAチケット：LPS-106899

変更点¶

liferay-frontend:cards-treeview タグが削除されました。

影響を受ける人¶

これは、JSPのタグ、またはSOY（閉鎖テンプレート）テンプレート内のそのコンポーネントの一部を使用するすべてのユーザーに影響します。

コードの更新方法¶

削除された機能を直接置き換えるものはありません。それに依存するコードがある場合は、自分で実装する必要があります。

変更が行われた理由¶

この変更は、タグが主に内部で使用されたために行われました。

liferay-frontend:contextual-sidebarタグを削除¶

日付： 2020年1月10日
JIRAチケット：LPS-100146

変更点¶

liferay-frontend:contextual-sidebar タグが削除されました。

影響を受ける人¶

これは、SOY（閉鎖テンプレート）テンプレート内のjspまたはそのコンポーネントの一部からのタグを使用するすべてのユーザーに影響します。

コードの更新方法¶

削除された機能を直接置き換えるものはありません。それに依存するコードがある場合は、自分で実装する必要があります。

変更が行われた理由¶

この変更は、タグが主に内部で使用されたために行われました。

Portal Vulcan APIのアクションの追加メソッドを削除¶

日付： 2020年1月22日
JIRAチケット：LPS-98387

変更点¶

署名String, Class, GroupedModel, String, UriInfoおよびString, Class, Long, String, String, Long, UriInfoを持つaddActionメソッドが削除されました。

影響を受ける人¶

これは、削除されたaddActionメソッドを使用しているユーザー、またはcompileOnly group: "com.liferay", name: "com.liferay.portal.vulcan.api", version: "[1.0.0, 2.0.0)"などの依存関係があるユーザーに影響します。

コードの更新方法¶

署名String, Class, GroupedModel, String, Object, UriInfoまたはString, Class, Long, String, String, Object, Long, UriInfoでaddActionメソッドを使用します。

変更が行われた理由¶

これらのメソッドは、クリーンアップリファクタリングの一部として削除されました。

変更されたコントロールメニューとプロダクトメニューの配置¶

日付： 2020年2月4日
JIRAチケット：LPS-107487

変更点¶

コントロールとプロダクトメニューの配置と構造は、いくつかのアクセシビリティの問題と一般的な視覚的な不具合に対処するために変更されました。

これらの変更は、コントロールメニューとプロダクトメニューに適用されています。

プロダクトメニューはコントロールメニューの外に移動されました
コントロールメニューは、動作を制御するために position:sticky を使用するようになりました。
コントロールメニュー内のメニューのスタイルは、新しいスティッキー動作を考慮して更新されました

影響を受ける人¶

これは、カスタマイズされた portlet.ftl テンプレートを使用したカスタムコントロールパネルテーマを使用している開発者、またはスティッキーバーとして動作し、 * ControlMenuEntry APIを使用して含まれているカスタムメニューを開発した開発者に影響を与える可能性があります。

コードの更新方法¶

コントロールパネルのテーマ¶

カスタムのコントロールパネルテーマを使用する開発者は、（存在する場合）呼び出しを portlet.ftlポートレットセクションの上の @ liferay.control_menu マクロに移動する必要があります。

前：

<section class="portlet" id="portlet_${htmlUtil.escapeAttribute(portletDisplay.getId())}">
    ${portletDisplay.writeContent(writer)}
</section>

<#if portletDisplay.isStateMax()>
    <@liferay.control_menu />
</#if>

後：

<#if portletDisplay.isStateMax()>
    <@liferay.control_menu />
</#if>

<section class="portlet" id="portlet_${htmlUtil.escapeAttribute(portletDisplay.getId())}">
    ${portletDisplay.writeContent(writer)}
</section>

カスタムスティッキーバー¶

* ControlMenuEntry APIを使用してカスタムのスティッキーバーを組み込んだ開発者は、コントロールメニューに新しく組み込まれた拡張ポイントを使用して、コンポーネントを挿入できます。

メニューを挿入するコードを DynamicInclude コンポーネントに移動し、適切な位置に登録します。

コントロールメニューの前に次を使用します。: com.liferay.product.navigation.taglib#/page.jsp#pre
コントロールメニューの後に次を使用します： com.liferay.product.navigation.taglib#/page.jsp#post

変更が行われた理由¶

この変更は、アクセシビリティを向上させ、上位に配置されたメニューの配置と制御に必要なロジックを簡素化するために行われました。一般的な視覚的な不具合を回避する、より正確で期待されるマークアップを提供します。

jQueryはデフォルトで含まれなくなりました¶

日付： 2020年2月4日
JIRAチケット：LPS-95726

変更点¶

以前は、デフォルトで jQuery がすべてのページに含まれており、グローバル window.$ およびスコープ付き AUI.$ 変数を介して使用可能になりました。この変更後、 jQuery はデフォルトで含まれなくなり、それらの変数は 未定義です。

影響を受ける人¶

これは、カスタムスクリプトで AUI.$ または window.$ を使用した開発者に影響します。

コードの更新方法¶

コードで使用する独自のバージョンのJQueryを提供するサードパーティライブラリを追加するための戦略のいずれかを使用します。

さらに、一時的な対策として、［システム設定］ → ［サードパーティー］ → ［jQuery］の［JQueryを有効にする］プロパティを［true］に設定することで、以前の動作に戻すことができます。

変更が行われた理由¶

この変更は、ほとんどの場合未使用で冗長なすべてのページに追加のライブラリコードをバンドルして提供することを回避するために行われました。

サーバー側の並列レンダリングはサポートされなくなりました¶

日付： 2020年3月16日
JIRAチケット：LPS-110359

変更点¶

プレフィックス layout.parallel.render が付いたプロパティは削除されました。つまり、AJAXレンダリングが有効な場合にのみ、並列レンダリングがサポートされます。

影響を受ける人¶

これは、削除されたプロパティを使用するすべてのユーザーに影響します。

コードの更新方法¶

プロパティファイルから、プレフィックス layout.parallel.render プロパティを削除します。

変更が行われた理由¶

この機能は廃止されました。

ContentField値のプロパティ名をcontentFieldValueに変更¶

日付： 2020年3月18日
JIRAチケット：LPS-106886

変更点¶

Headless Delivery APIで、ContentFieldスキーマ内のプロパティ名のvalueがcontentFieldValueに変更されました。

影響を受ける人¶

これは、ContentField valueプロパティ名に応じてRESTクライアントに影響します。

コードを更新するにはどうすればよいですか？¶

RESTクライアントでプロパティ名をcontentFieldValueに変更します。

変更が行われた理由¶

この変更により、{schemaName}+Valueと呼ばれるHeadless APIのすべての値プロパティ名との整合性が復元されます。

liferay-editor-image-uploaderプラグインを削除しました¶

日付： 2020年3月27日
JIRAチケット：LPS-110734

変更点¶

liferay-editor-image-uploader AUIプラグインが削除されました。そのコードは、AlloyEditorとCKEditorで使用されるaddimages CKEditorプラグインにマージされました。

影響を受ける人¶

これは、プラグインを直接使用するカスタムソリューションに影響します。

コードを更新するにはどうすればよいですか？¶

liferay-editor-image-uploaderプラグインに直接置き換わるものはありません。それに依存するコンポーネントがある場合は、古い実装のコピーを同じ場所に配置して、モジュール内でローカルに使用できます。

なぜこの変更が行われたのですか？¶

この変更により、CKEditorでの画像のドラッグアンドドロップ処理が可能になり、Alloy EditorとCKEditorの両方に共通の画像アップローダが提供されます。

TinyMCEエディターはデフォルトでバンドルされなくなりました¶

日付： 2020年3月27日
JIRAチケット：LPS-110733

変更点¶

7.3以降では、CKEditorがデフォルトであり、WYSIWYGエディターのみがサポートされています。

影響を受ける人¶

これはTinyMCEを使用するすべてのユーザーに影響します。

コードを更新するにはどうすればよいですか？¶

TinyMCEを使用するようにLiferayポータルを構成している場合は、これらの構成を削除できます。それでもTinyMCEを使用したい場合は、次の手順を実行する必要があります。

構成を保持します。
ブラウザで https://repository.liferay.com/nexus/index.html を開きます。
com.liferay.frontend.editor.tinymce.webを検索します。
com.liferay.frontend.editor.tinymce.web モジュールの.jarファイルをダウンロードします。
ダウンロードした.jarファイルをliferay-portalインスタレーションにデプロイします。

なぜこの変更が行われたのですか？¶

この変更は、1つのエディターを中心にリッチテキストコンテンツを作成するためのすべてのUXを統合して、よりまとまりのある包括的なエクスペリエンスを提供するために行われました。

Simple Editorはデフォルトでバンドルされなくなりました¶

日付： 2020年3月27日
JIRAチケット：LPS-110734

変更点¶

7.3以降では、CKEditorがデフォルトであり、WYSIWYGエディターのみがサポートされています。

影響を受ける人¶

これは、LiferayフロントエンドエディターのシンプルなWebモジュールを使用するすべてのユーザーに影響します。

コードを更新するにはどうすればよいですか？¶

Simple Editorを使用するようにLiferay Portalを構成している場合は、これらの構成を削除できます。 Simple Editorを引き続き使用する場合は、次の手順を実行する必要があります。

構成を保持します。
ブラウザで https://repository.liferay.com/nexus/index.html を開きます。
com.liferay.frontend.editor.simple.web検索します。
com.liferay.frontend.editor.simple.web モジュールの.jarファイルをダウンロードします。
ダウンロードした.jarファイルをliferay-portalインストールにデプロイします。

なぜこの変更が行われたのですか？¶

asset.vocabulary.defaultが言語キーを保持するようになりました¶

日付： 2020年4月28日
JIRAチケット：LPS-112334

変更点¶

asset.vocabulary.default が言語キーになり、固定値 トピックではなくなりました。

影響を受ける人¶

これは、プロパティを上書きするすべてのユーザーに影響します。

コードを更新するにはどうすればよいですか？¶

プロパティが上書きされない場合は、コードを変更する必要はありません。プロパティが上書きされ、指定されたキーが見つからない場合、提供されたテキストはデフォルトの語彙の名前として使用されます。

変更が行われた理由¶

この変更はユーザーがすべての言語でデフォルトの語彙の名前を変更する必要がないように行われました。

Liferay.Pollerがデフォルトで初期化されなくなりました¶

日付： 2020年5月19日
JIRAチケット：LPS-112942

変更点¶

グローバルAUI Liferay.Pollerユーティリティは廃止され、デフォルトでは初期化されなくなりました。

影響を受ける人¶

これは、Liferay.Pollerに依存するすべてのコードに影響します。これは通常、JSPでLiferay.Poller.init()を呼び出すことによって行われます。

コードの更新方法¶

Liferay.Pollerユーティリティに直接置き換わるものはありません。 Liferay.Pollerを初期化する必要がある場合は、以下のコードを使用するようにJSPを更新してください。

<%@ page import="com.liferay.petra.encryptor.Encryptor" %>

<%-- For access to `company` and `themeDisplay`. --%>
<liferay-theme:defineObjects>

<aui:script use="liferay-poller">
    <c:if test="<%= themeDisplay.isSignedIn() %>">
        Liferay.Poller.init({
            encryptedUserId:
                '<%= Encryptor.encrypt(company.getKeyObj(), String.valueOf(themeDisplay.getUserId())) %>',
        });
    </c:if>
</aui:script>

変更が行われた理由¶

Liferay.Pollerコンポーネントは、アーカイブされているチャットアプリケーションでのみ使用されていました。デフォルトで初期化をスキップすると、一般的なケースでページの読み込みが合理化されます。

ContentTransformerListenerはデフォルト設定で無効になっています¶

日付： 2020年5月25日
JIRAチケット：LPS-114239

変更点¶

ContentTransformerListener はデフォルト設定で無効になりました。

影響を受ける人¶

これは、ContentTransformerListenerによって提供されるレガシーなWebコンテンツ機能を使用しているLiferay Portalのインストールに影響します。例えば、別のWebコンテンツ内にWebコンテンツを埋め込む、レガシーなエディット・イン・プレース・インフラストラクチャ、トークンの置換(@article_group_id@, @articleId;elementName@)などです。

コードの更新方法¶

コードを更新する必要はありません。それでも ContentTransformerListener を使用したい場合は、システム設定で［Content & Data］ → ［Webコンテンツ］ → ［仮想インスタンススコープ］ → ［Webコンテンツ］の［Enable ContentTransformerListener］プロパティを使用して有効にすることができます。

変更が行われた理由¶

ContentTransformerListenerは、記事要素の文字列処理にコストがかかるため、パフォーマンスを向上させるために無効化されました（記事フィールドに対してHtmlUtil.stripCommentsとHtmlUtil.stripHtmlを呼び出しています）。

Liferay.BrowserSelectors.runが呼び出されなくなりました¶

日付： 2020年5月26日
JIRAチケット：LPS-112983

変更点¶

Liferay.BrowserSelectors.run()関数はページで呼び出されなくなり、その結果、開始<html>タグから一部のCSSクラスが削除されます。これらの多くは、代わりに <body> 要素に追加されています。

影響を受ける人¶

これは、 <html> 要素のこれらのCSSクラスに依存するすべてのコードに影響します。

aol
camino
edgeHTML or edge
firefox
flock
gecko
icab
ie, ie6, ie7, ie9, or ie11
js
konqueror
mac
mozilla
netscape
opera
presto
safari
保護
touch
trident
webkit
win

コードの更新方法¶

Liferay.BrowserSelectors.run()関数に直接置き換わるものはありませんが、CSSとJavaScriptを調整して、代わりに<body>要素の新しいクラスをターゲットにすることができます。これらのクラスは、現在使用しているブラウザーを反映するために <body> 要素に追加されます。

chrome
edge
firefox
ie
モバイル
その他

または、Liferay.BrowserSelectors.run()を呼び出して、以下のコードで古いクラスを<html>要素に適用することもできます。

<aui:script use="liferay-browser-selectors">
    Liferay.BrowserSelectors.run();
</aui:script>

変更が行われた理由¶

一部のクラスが古いブラウザを参照していたクラスは、Alloy UIに依存するレガシーJavaScriptを介して上位 <html> 要素に追加されていました。古いブラウザー参照を削除するこの変更は、サーバー側で行われるようになり、ページの読み込み時間が改善されました。

ブロッキングキャッシュのサポートを削除¶

日付： 2020年6月17日
JIRAチケット：LPS-115687

変更点¶

ブロッキングキャッシュのサポートが削除されました。これらのプロパティは、ブロッキングキャッシュを有効にするために使用できなくなりました。

ehcache.blocking.cache.allowed
permissions.object.blocking.cache
value.object.entity.blocking.cache

影響を受ける人¶

これは、上記のプロパティを使用するすべてのユーザーに影響します。

コードの更新方法¶

削除された機能を直接置き換えるものはありません。それに依存するコードがある場合は、自分で実装する必要があります。

変更が行われた理由¶

この変更は、ブロッキングキャッシュを有効にしてはならないため、パフォーマンスを向上させるために行われました。

各エンティティモデルのキャッシュプロパティ設定のサポートを削除¶

日付： 2020年6月24日
JIRAチケット：LPS-116049

変更点¶

エンティティのこれらのキャッシュプロパティを設定するためのサポートが削除されました：

value.object.entity.cache.enabled*
value.object.finder.cache.enabled*
value.object.column.bitmask.enabled*

たとえば、次のプロパティはエンティティcom.liferay.portal.kernel.model.Userに対するものです。

value.object.entity.cache.enabled.com.liferay.portal.kernel.model.User
value.object.finder.cache.enabled.com.liferay.portal.kernel.model.User
value.object.column.bitmask.enabled.com.liferay.portal.kernel.model.User

影響を受ける人¶

これは、エンティティに対して上記のプロパティを使用するすべてのユーザーに影響します。

コードの更新方法¶

削除された機能を直接置き換えるものはありません。エンティティからこれらのプロパティを削除する必要があります。

変更が行われた理由¶

これらのプロパティはエンティティには役に立たないため、この変更が行われました。

ポータルプロパティの名前を"module.framework.properties.felix.fileinstall.\ "から"module.framework.properties.file.install. "に変更¶

日付： 2020年7月13日
JIRAチケット：LPS-115016

変更点¶

"module.framework.properties.felix.fileinstall"で始まるポータルプロパティの名前が "module.framework.properties.file.install"で始まるように変更されました。

影響を受ける人¶

これは、module.framework.properties.felix.fileinstall.*ポータルプロパティ設定をオーバーライドしているすべてのユーザーに影響します。

コードの更新方法¶

module.framework.properties.felix.fileinstall.*で始まるプロパティの名前をmodule.framework.properties.file.install.*で始まる名前に変更します。

変更が行われた理由¶

この変更は、Apache Felix ファイルインストールのインライン化を反映するために行われました。 Liferayは現在、この機能を管理および保守しています。

Elasticsearchの動的データマッピングフィールドをネストされたドキュメントに変更¶

日付： 2020年7月27日
JIRAチケット：LPS-103224

変更点¶

ddm__keyword__およびddm__text__で始まるElasticsearchの動的データマッピングフィールドは、新しいネストされたドキュメントddmFieldArrayに移動されました。

ddmFieldArrayには、次のフィールドを持ついくつかのエントリーがあります。

ddmFieldName：動的データマッピング・ストラクチャーフィールド名が含まれます。この名前は、DDMIndexer.encodeNameメソッドを使用して生成されます。
ddmFieldValue *：インデックス付きデータが含まれます。このフィールドの名前は、DDMIndexer.getValueFieldNameを使用して生成され、フィールドのデータ型と言語によって異なります。
ddmValueFieldName：インデックス付きデータが格納されているインデックスフィールド名が含まれます。

Solr検索エンジンを使用している場合、この変更は適用されません。

影響を受ける人¶

これは、ddm__keyword__*およびddm__text__*フィールドを使用してElasticsearchインデックスでクエリを実行するカスタム開発を行っているすべてのユーザーに影響します。

コードを更新するにはどうすればよいですか？¶

Elasticsearchクエリで新しいネストされたドキュメントddmFieldArrayを使用する必要があります。

Liferayコードにはいくつかの例があります。たとえば、 DDMIndexerImpl と AssetHelperImpl はDDM_FIELD_ARRAY定数を使用します。

システム設定からレガシー動作を復元し、ddm__keyword__*およびddm__text__*フィールドを引き続き使用することもできます。

［システム設定］ → ［動的データマッピング］ → ［動的データマッピング Web インデクサー］に移動します。
［旧形式の動的データマッピングインデックスフィールドを有効にする］を選択します。
完全なインデックスの再構築を実行します。

なぜこの変更が行われたのですか？¶

この変更は、動的データマッピング・ストラクチャーの数が多すぎる場合に発生するElasticsearchエラーで 合計フィールド数の制限を超えない ようにするために行われました。

Lexiconアイコンパスの移動¶

日付： 2020年8月17日
JIRAチケット：LPS-115812

変更点¶

LexiconアイコンのパスがthemeDisplay.getPathThemeImages() + "/lexicon/icons.svgからthemeDisplay.getPathThemeImages() + "/clay/icons.svgに変更されました

影響を受ける人¶

これは、Lexiconアイコンパスを直接使用するカスタムソリューションに影響します。 lexiconパスにアイコンを作成するためのGradleタスクは削除されます。

コードを更新するにはどうすればよいですか？¶

lexiconの代わりにclayを参照するようにパスを更新します

なぜこの変更が行われたのですか？¶

この変更は、アイコンスプライトマップへの参照を統合するために行われました。

DDM永続性クラスからclassNameId関連のメソッドを削除¶

日付： 2020年8月18日
JIRAチケット：LPS-108525

変更点¶

countByClassNameId、findByClassNameId、およびremoveByClassNameIdメソッドは、次のクラスから削除されました。

com.liferay.dynamic.data.mapping.service.persistence.DDMStructureLinkPersistence
com.liferay.dynamic.data.mapping.service.persistence.DDMStructureLinkUtil
com.liferay.dynamic.data.mapping.service.persistence.DDMStructurePersistence
com.liferay.dynamic.data.mapping.service.persistence.DDMStructureUtil
com.liferay.dynamic.data.mapping.service.persistence.DDMTemplateLinkPersistence
com.liferay.dynamic.data.mapping.service.persistence.DDMTemplateLinkUtil

影響を受ける人¶

これは、これらのメソッドのいずれかを使用するすべてのユーザーに影響します。

コードを更新するにはどうすればよいですか？¶

他のファインダーとカウンターのメソッドを使用できます。

なぜこの変更が行われたのですか？¶

これらのメソッドは、 LPS-108525 のソリューションの一部として削除されました。

com.liferay.dynamic.data.mapping.util.BaseDDMDisplayメソッドを削除¶

日付： 2020年8月18日
JIRAチケット：LPS-103549

変更点¶

isShowAddStructureButtonメソッドを削除しました。

影響を受ける人¶

これは、このメソッドを使用するすべてのユーザーに影響します。

コードを更新するにはどうすればよいですか？¶

このメソッドの代わりにisShowAddButton(Group scopeGroup)メソッドを使用できます。

変更が行われた理由¶

このメソッドは、クリーンアップリファクタリングの一部として削除されました。

ポータルプロパティview.count.enabledおよびbuffered.increment.enabledを置き換え¶

日付： 2020年10月1日
JIRAチケット：LPS-120626 および LPS-121145

変更点¶

ビューカウントをグローバルに、またはエンティティ専用に有効にしたり無効にしたりする機能は、ポータルプロパティから削除され、システム設定として構成されるようになりました。ビューカウントは、UIの［システム設定］ → ［Infrastructure］ → ［View Count］で構成するか、com.liferay.view.count.configuration.ViewCountConfiguration.configという名前の構成ファイルを使用して構成できます。

ポータルプロパティの変更は次のとおりです。

buffered.increment.enabledポータルプロパティが削除されました。ビューカウントのグローバルな有効化と無効化は、［View Count］ページのenabledプロパティを使用して実行されるようになりました。

特定のエンティティに対しビューカウント動作を無効にすることは、ポータルプロパティで行われなくなりました。たとえば、7.3ではview.count.enabled[SomeEntity]=false、7.2ではbuffered.increment.enabled[SomeEntity]=falseを設定していましたが、現在は［View Count］ページのDisabled Class Name値リストにエンティティクラス名を追加することで実行されます。

影響を受ける人¶

これは、ポータルプロパティview.count.enabled=falseまたはbuffered.increment.enabled=falseを設定しているすべてのユーザーに影響します。

これは、ポータルプロパティ設定view.count.enabled[SomeEntity]=false（7.3の初期バージョン）またはbuffered.increment.enabled[SomeEntity]=false（7.2ポータル）を使用して、一部のエンティティ（SomeEntityなど）のビューカウントを無効にしているすべてのユーザーに影響します。

コードの更新方法¶

view.count.enabledまたはbuffered.increment.enabledポータルプロパティと、view.count.enabled[SomeEntity]=falseまたはbuffered.increment.enabled[SomeEntity]=falseなどのエンティティ固有のプロパティを削除します。

システム設定または構成ファイルを使用して、ビューカウントの動作を構成します。

［システム設定］ → ［Infrastructure］ → ［View Count］で、enabledをfalseに設定してグローバルにビューカウントを無効にするか、enabledをtrueに設定してグローバルにビューカウントを有効にし、エンティティクラス名をDisabled Class Name値リストに追加して特定のエンティティのビューカウントを無効にします。

構成ファイルを使用するには、システム設定でビューカウントを構成し、設定を保存して、com.liferay.view.count.configuration.ViewCountConfiguration.configファイルにエクスポートします。次に、ファイルを[Liferay Home]/osgi/configsフォルダに配置して、構成をデプロイします。

変更が行われた理由¶

この変更は、ビューカウント動作の管理を容易にするために行われました。

ポータルプロパティ"module.framework.properties.file.install.optionalImportRefreshScope"を削除¶

日付： 2020年10月11日
JIRAチケット：LPS-122008

変更点¶

ポータルプロパティmodule.framework.properties.file.install.optionalImportRefreshScopeは削除されました。ファイルのインストールでは、更新が必要なオプションのパッケージを含むバンドルをスキャンするときに、管理対象バンドルのみがチェックされるようになりました。

影響を受ける人¶

これは、ポータルプロパティmodule.framework.properties.file.install.optionalImportRefreshScopeを設定しているすべてのユーザーに影響します。

コードを更新するにはどうすればよいですか？¶

module.framework.properties.file.install.optionalImportRefreshScopeプロパティを削除します。他の動作を使用するようにファイルのインストールを構成することはできません。

なぜこの変更が行われたのですか？¶

代替動作が望まれるケースはほとんどありません。ファイルのインストールは、バンドルをLiferayにインストールする主な方法であるため、バンドル管理のデフォルトになりました。古い機能とその分岐ロジックを削除すると、コードの保守性と可読性が向上します。