Confluence のダーク機能

要約

Some of the features in Confluence are not enabled by default and may be implemented as Dark Features.

Confluence の挙動のいくつかの高度な側面は、アプリケーション プロパティやシステム プロパティで制御されるために構成ページを持たない場合があります。また、いくつかの機能や挙動は通常はデフォルトでユーザーから隠されています。このようなダーク機能は Confluence 管理者がインスタンス単位で有効化できます。高度なユーザーはダーク機能を利用して特定の機能を有効化または無効化できます。

ソリューション

ダーク機能の管理

To manage Dark Features you need to be a Confluence admin. It is possible through the link mentioned below:

1. 移動 <confluence-url>/admin/darkfeatures.action

ダーク機能のビューは次のようなものです。

ダーク機能の有効化

In order to enable a feature flag, type in the Enable dark feature text area and click the Submit button.

例: Office での編集機能に戻すには、次の手順を実行します。

1. 移動 <confluence-url>/admin/darkfeatures.action

2. Add the enable.legacy.edit.in.office dark feature flag and select Submit.

これを行うには、管理者としてログインしている必要があります。ダーク機能を有効化すると、<confluence-url>/admin/darkfeatures.action ページで次のように確認できます。

管理者によって有効化されたダーク機能を DB クエリ経由で確認したい場合は次のクエリを実行してください。BANDANAVALUE 列でダーク機能の一覧を確認できます。

Database Enablement Option

An alternative method for enabling the Dark Features can be achieved directly through the database. ⚠️ As with any modifications involving the database, we strongly encourage you to capture a safety backup prior to proceeding with this method. With that in mind, we can take the following steps to enable a dark feature via the database:

• Confluence アプリを停止する

• Perform the following query against the database:

• Copy the full resulting list from the bandanvalue column. The results from my test instance, which only had the site-wide.shared-drafts feature enabled, returned this:

• Using that output of the first query (so that we make sure to include the other enabled dark features), we want to create an update statement like so using the name of the dark feature being enabled.:

• • ⚠️ The example above is factoring in the output that I mentioned in the previous bullet point, ie, the result of the query. Please replace dark.feature.here with the actual dark feature being enabled.

• Run the update query against the database

• Query the bandana table to make sure the feature is listed:

• Confluence を再起動します。

ダーク機能の無効化

To disable a feature flag:

• 個々の機能フラグの横にある [削除] リンクをクリックします (以下のスクリーンショットを参照)

• 

• 次の SQL を利用してダーク機能を無効化することもできます。これを行ったあとに Confluence のキャッシュをフラッシュする必要があります。

  • ⚠️ Please take a backup of the DB table before doing the deletion. Below query will delete all dark features.

• If you have multiple dark features enabled, you need to use the below queries.

  • select bandanavalue from BANDANA where BANDANAKEY = 'confluence.darkfeature'; --Result in my local instance <string>site-wide.shared-drafts,cql.search.screen</string> E.g. I need to remove cql.search.screen Update BANDANA set bandanavalue='<string>site-wide.shared-drafts</string>' where BANDANAKEY = 'confluence.darkfeature';