要約

Confluence の一部の機能はデフォルトで有効化されておらず、ダーク機能として追加されている場合があります。 

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

ダーク機能の管理

ダーク機能を管理するには Confluence 管理者である必要があります。これは次のリンクから行えます。

1. <confluence-url>/admin/darkfeatures.action に移動します。

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

ダーク機能の有効化

機能フラグを有効化するには、ダーク機能の有効化テキスト領域に入力して [送信] ボタンをクリックします。

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

1. <confluence-url>/admin/darkfeatures.action に移動します。
2. enable.legacy.edit.in.office ダーク機能フラグを追加し、[送信] を選択します。

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

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

select * from BANDANA where BANDANAKEY = 'confluence.darkfeature';

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:

• Stop the Confluence application
• Perform the following query against the database:

select * from BANDANA where BANDANAKEY = 'confluence.darkfeature';

• 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:

<string>site-wide.shared-drafts</string>

• 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.:

Update BANDANA  
set bandanavalue='<string>site-wide.shared-drafts,dark.feature.here</string>'  
where BANDANAKEY = 'confluence.darkfeature';

• • 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:

select * from BANDANA where BANDANAKEY = 'confluence.darkfeature';

• Confluence を再起動します。

ダーク機能の無効化

機能フラグを無効化するには、次の手順を実行します。

• 個々の機能フラグの横にある [削除] リンクをクリックします (以下のスクリーンショットを参照)
• 
•  次の SQL を利用してダーク機能を無効化することもできます。これを行ったあとに Confluence のキャッシュをフラッシュする必要があります。
  • Please take a backup of the DB table before  doing the deletion. Below query will delete all dark features. 

delete from BANDANA where BANDANAKEY = 'confluence.darkfeature';

• 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';