問題

Confluence 7.0 のリリース以降、Universal Plugin Manager を通じて組み込みのシステム アプリの個々のモジュールを有効化または無効化することはできなくなりました。

アップグレード前にアプリ モジュールを無効化していて UI を通じた再有効化を行えない場合や、特定のモジュールが提供する機能の代替としてサードパーティ製アプリを使うためにそのモジュールを無効化しているような場合があります。

以下に例を示します。

• ページの編集などの特定のアクションについて通知が送信されないが、ページの作成、移動、コメントなどの通知は引き続き受信している。

• サードパーティ製のアプリまたは連携機能が同じタスクを処理しているため、重複が発生している。通知やプロフィール関連のアプリは良い例になります。

  
  

アプリを表示して個々のモジュールを展開すると、次のようになります。

診断

モジュール アプリが既知である場合は Universal Plugin Manager で状態を確認

• Universal Plugin Manager にナビゲートします。[アプリの管理] > システムでフィルタリング> アプリを展開 > モジュールの状態と key 名を確認します。

モジュールまたはアプリが未知である場合はデータベースにクエリを送信してすべてのアプリの状態を確認可能

1. 次のデータベース クエリを実行します。

    select BANDANAVALUE from BANDANA where BANDANAKEY = 'plugin.manager.state.Map';

2. 結果は次のようになります。

   <map>
     <entry>
       <string>com.atlassian.atlassian-failure-cache-plugin</string>
       <boolean>true</boolean>
     </entry>
     <entry>
       <string>confluence.extra.chart</string>
       <boolean>false</boolean>
     </entry>
   </map>

3. ここから、有効化または無効化されているアプリやモジュールを確認し、Universal Plugin Manager の確認も行うことができます。

UPM API の使用の確認

アプリ全体の場合

1. sysadmin の資格情報を使い、プラグインの JSON 表現を取得します。
   plugin.key に続く「-key」文字列にご注意ください。

   GET <base-URL>/rest/plugins/1.0/{plugin.key}-key

個々のモジュールの場合

1. sysadmin の資格情報を使い、モジュールの JSON 表現を取得します。
   plugin.key と module.key の両方に続く「-key」文字列にご注意ください。
   

   GET <base-URL>/rest/plugins/1.0/{plugin.key}-key/modules/{module.key}-key

ソリューション

アプリまたはモジュールを確認したら、Universal Plugin Manager API を使ってそれを有効化または無効化できます。

• プラグインの有効化または無効化方法

1. 次の curl コマンドを実行し、enabled を true または false. に設定します。

   curl --user "<USER>:<PASSWORD>" --location --request PUT '<baseURL>/rest/plugins/1.0/{plugin.key}-key' \
   --header 'Content-Type: application/vnd.atl.plugins.plugin+json' \
   --data-raw '{
       "enabled": false
   }'

• 単一のモジュールの有効化または無効化方法

1. 次の curl コマンドを実行し、enabled を true または false. に設定します。

   curl --user "<USER>:<PASSWORD>" --location --request PUT '<baseURL>/rest/plugins/1.0/{plugin.key}-key/modules/{module.key}-key' \
   --header 'Content-Type: application/vnd.atl.plugins.plugin.module+json' \
   --data-raw '{
       "enabled": false
   }'

例として、content notifications プラグインの page edited notification モジュールを無効化するには、次のようにします。

curl --user "<USER>:<PASSWORD>" --location --request PUT '<baseURL>/rest/plugins/1.0/com.atlassian.confluence.plugins.confluence-content-notifications-plugin-key/modules/page-edited-notification-key' \
--header 'Content-Type: application/vnd.atl.plugins.plugin.module+json' \
--data-raw '{
    "enabled": false
}'