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

Factory設定の使用

ほとんどのLiferay DXPシステム設定では、1つのエントリに1つの設定セットしか許可されていません。 構成を変更するには、単一の構成フォームを更新します。これは、 影響を受ける構成スコープ全体に適用されます。 あまり一般的ではあり が、設定は同時に共存する複数のエントリをサポートします。これらはFactory設定と呼ばれます。 Factory設定の場合、各設定セットは固有の設定を提供します。 一般的な使用法は、サードパーティサーバー(LDAPやElasticsearchなど)へのシステムスコープの接続の設定です。 これらのサーバーへの接続ごとに固有の設定値が必要であるため、Factory設定を使用してそれを可能にします。

ヒント

ファクトリー構成の例: 組織タイプの追加 がサポートされており、実際の階層をモデル化したり、階層ルールを適用したりする必要がある場合に便利です。 Liferay DXPでは、各組織タイプはシステム設定のFactory設定エントリーで作成されます。

Factory設定の特定

サービスがFactory設定をサポートしている場合、そのシステム設定エントリーには追加ボタンがあります。

システム設定エントリーに追加ボタンがある場合、Factory設定をサポートしています。

新しい構成値のセットを追加するには、[追加] ボタン Add をクリックします。

Factory設定ファイル

単一インスタンス設定と同様に、システム設定インターフェイス(上記の追加ボタンを使用)または 設定ファイル介してFactory設定を設定できます。 標準の単一インスタンス設定ファイルは、設定オブジェクトの完全修飾クラス名に .config追加したものを使用します。

my.service.ServiceConfiguration.config

サービスがFactory設定をサポートしている場合は、設定の最初のインスタンス -default.configを呼び出す規則を使用します。 デフォルトの組織タイプの名前は次のようになっています。

com.liferay.organizations.internal.configuration.OrganizationTypeConfiguration~default.config

Liferay DXP/Portal バージョン 7.0-7.3 では、ファクトリー設定ファイルの名前とサブ名を区切るのにチルダ (~) を使用する代わりに、ブラウザと OS に応じてダッシュ (-) またはアンダースコア (_) を使用します。 例えば、

ダッシュ:

com.liferay.organizations.internal.configuration.OrganizationTypeConfiguration-default.config

アンダースコア:

com.liferay.organizations.internal.configuration.OrganizationTypeConfiguration_default.config

区切り文字としてはチルダが推奨されますが、ダッシュとアンダースコアも引き続きサポートされます。

次のインスタンスには、一意の サブネームデフォルト以外のもの)が含まれています。 このインスタンスを使用する必要があるときにわかりやすい名前を使用することをお勧めします。 新しい組織タイプの追加の例に従って、 リーグ タイプを、次のような構成ファイルで追加することができます。

com.liferay.organizations.internal.configuration.OrganizationTypeConfiguration~league.config
警告

サブネーム付きの設定ファイルを提供すると、たとえサービスが複数の設定項目を受け入れるように設計されていなくても、Factory設定のシナリオが強制されます。 上記のようにシステム設定UIを使用して、設定項目でFactory設定を使用することがサポートされているかどうかを確認します。

Factory設定をサポートする一部のシステム設定エントリには、デフォルトインスタンスの設定ファイルが付属していません(例:匿名ユーザーエントリー)。 Factory設定ファイルをエクスポートして .config ファイルを取得する場合、 -default.config 命名規則は使用されません。 代わりに、それが最初の出現か追加の出現かに関係なく、そのサブネームには保証された一意の識別情報が与えられます。

com.liferay.user.associated.data.web.internal.configuration.AnonymousUserConfiguration~6befcd73-7c8b-4597-b396-a18f64f8c308.config

あなたが別のシステムにデプロイするための設定ファイルをエクスポートしている場合は、最初のの後、エクスポートファイル名の一部の名前を変更して、より分かりやすいサブネームを使用できます。 注意:ファイルの名前を変更して、エクスポート元と同じシステムにデプロイすると、新しいサブネームにより、完全に新しい設定としてマークされます。 この場合、名前が変更されたインスタンスだけでなく、追加の設定インスタンスが作成されます。

警告

ファクトリ構成をサポートする構成エントリの場合、 .config ファイルの名前からサブ名を省略すると、システム設定により、この .config ファイルが対象とする構成エントリに新しいエントリを追加できなくなります。 これは、既知のバグが原因です。 詳細については、 LPS-76352 を参照してください。 不適切な名前の設定ファイルがデプロイされると、そのシステム設定エントリーから問題の設定に関するエントリーを追加することができなくなります。

エラーのある (サブネームがない) .config ファイルを展開しても、何も永続的に無効になるわけではありません。 上記の適切な規則に従ってファイル名を変更するか、完全に削除して最初からやり直します。