共同編集の管理

To see your collaborative editing and Synchrony setup, head to Administration menu , then General Configuration > Collaborative editing. 

編集モードの変更 

編集モードは、サイトのすべてのユーザーの編集エクスペリエンスを決定します。共同編集を有効化または無効化するには、次の手順を実行します。  

編集モードを変更するには、次の手順を実行します。

1. Go to Administration menu , then General Configuration > Collaborative editing. 
2. [モードを変更してください] を選択します。
3. [オン] または [オフ] を選択し、[変更] を選択します。 

編集モードの変更は簡単な操作ではありません。各モードの動作を理解しておくことをおすすめします。 

モードを変更した場合の既存の下書きへの影響

ユーザーは、自分のプロファイルの [下書き] ページから、既存の個人用下書きと共有下書きにいつでもアクセスできます。下書きの編集を再開できるかどうかは、編集のモードによって異なります。 

共同編集が有効化されている場合、ユーザーは個人用下書きまたは共有下書きの編集を破棄または再開できます。個人用下書きは、ユーザーが編集を再開すると共有下書きに変換されます。 

共同編集が無効化されている場合、ユーザーは個人用下書きの編集を破棄または再開できます。既存の共有下書きの編集を再開することはできませんが、それらの下書きの内容を表示し、コピーすることはできます。

共有下書きは、共同編集が有効かつ以下の場合に、ユーザーの [下書き] ページにのみ表示されます。 

• 下書きを作成したが、まだ公開していない
• 公開済みのページを編集したが、その変更内容を公開していない

同時編集の上限

最大 12 人のユーザーが同時にページを編集することができます。つまり、すでに 12 人のユーザーがページを編集している場合、新しいユーザーはエディタを開くことができず、それらのユーザーがエディタを離れるまで待つ必要があります。  

Administrators can increase or decrease this limit using a system property. If you experience performance issues when many people are editing, you might want to decrease this limit. 

監査に関する考慮事項

弊社では、一部のお客さまにとって監査が主要な考慮事項であることを理解しています。現時点で、共同編集に関連する緻密な監査機能は提供していません。 すべてのページ変更は、それぞれの変更を行ったユーザーではなく、そのページの公開者に帰属します。

お客様のサイトでこれが問題になる場合、現時点ではサイトの共同編集をオフにすることをおすすめします。 

未公開の下書きのバージョン履歴は保存不可

共同編集は常に保存されていますが、未公開の変更のバージョンは保存されません。古いページ バージョンを復元する場合、既存の公開済みバージョンへのロールバックのみが可能です。未公開の変更は、旧バージョンを復元すると失われます。 

匿名ユーザーが行った編集の可視化

匿名ユーザーにページの追加権限を付与し、さらに Confluence の使用グローバル権限が付与されている場合、以下に注意する必要があります。 

ページのすべての未公開の変更を匿名ユーザーが行った場合、エディタを閉じたときやページを公開した際にアラートは送信されません。つまり、ログイン済みのユーザーはページへの変更を認識せずにそれらを意図せず公開してしまう可能性があります。 

変更自体はページに表示されますが、変更を加えたユーザーがログインしていない場合、通常の警告ダイアログは表示されません。

ログイン済みのユーザーと匿名ユーザーの両方による未公開の変更があった場合、警告メッセージが表示されますが、ログイン済みのユーザーのみがダイアログに表示されます。そのダイアログの変更を表示すると、すべてのユーザー (匿名を含む) による変更が含まれます。 

プロキシと SSL の考慮事項 

Synchrony に接続する方法は、環境によって異なります。ほとんどの Confluence サイトはリバース プロキシの背後で (多くの場合は SSL とともに) 実行されています。ここでは、自身の環境に適した設定を特定するのに役立つ情報や、サイトで共同編集を使用するために環境で必要な変更について説明します。 

SSL

Synchrony は別の JVM で実行されており、直接 HTTPS 接続をサポートしていません。リバース プロキシを使用しない場合、Tomcat で SSL を終了する必要があります。リバース プロキシやロード バランサを使用する場合、リバース プロキシやロード バランサで SSL を終了する必要があります。 

See Possible Confluence and Synchrony Configurations for detailed diagrams and examples. 

プロキシ

リバース プロキシの背後で Confluence を実行している場合、「Confluence および Synchrony で利用可能な設定」で、Confluence および Synchrony セットアップがプロキシに与える影響についてのガイダンスをご確認ください。 

See Possible Confluence and Synchrony Configurations for detailed diagrams and examples, plus links to example proxy configuration files. 

WebSocket

最善の結果を得られるよう、ロード バランサとプロキシで WebSocket 接続を許可する必要があります。ユーザーが WebSocket に接続できない場合、Confluence は XHR (XML HTTP Request) にフォールバックして、正常にページを編集できるようにします。 

XHR fallback is enabled by default, but can be disabled using a system property (passed to Confluence) if necessary. You shouldn't need to change this. 

Synchrony 設定の変更

Confluence UI を使用して Synchrony 設定を変更することはできません。ほとんどの場合、デフォルト設定に変更を加える必要はありません。

Synchrony を実行するポートや利用可能なメモリの最大量を変更する必要がある場合は、システム プロパティや start-synchrony スクリプト (独自の Synchrony クラスタを実行している場合) で行うことができます。 

See Configuring Synchrony for more information. 

Synchrony の起動と停止

Synchrony が Confluence で管理されている場合 (推奨)、Confluence は起動時に Synchrony を自動的に立ち上げます。また、Confluence の共同編集管理画面から Synchrony を再起動することもできます。 

Synchrony をクラスター内でスタンドアロンで実行している場合は、start-synchrony.sh または start-synchrony.bat スクリプトを Synchrony ノードごとに使用します。プロセス ID (PID) ファイルが Synchrony ディレクトリ内に作成されます。 

Synchrony を停止するには、同様に stop-synchrony.sh または stop-synchrony.bat を実行します。これにより、Synchrony ディレクトリで開始スクリプトが作成した PID ファイルが破壊されます。start-synchrony スクリプトで PID ファイルの保存先をカスタマイズした場合、stop-synchrony スクリプトでもこれを更新する必要があります。 

Synchrony を起動できない場合、Synchrony ディレクトリに既存の PID ファイルがないことを確認します。 

Synchrony の監視

To check if Synchrony is running, go to Administration menu , then General Configuration > Collaborative editing. 

Confluence をクラスタで実行している場合は、クラスタリング画面から各ノードの Synchrony のステータスを確認できます。

Go to Administration menu , then General Configuration > Clustering, then on each node select Collaborative editing. You can access all nodes in this way, you don't need to hit a specific node in your browser. 

ここから、Synchrony のステータス、モード、および Confluence が接続している URL を確認できます。Confluence で Synchrony を管理すると次のように表示されます。 

すべての Confluence ノードで同じ Synchrony モードを使用する必要があります。たとえば、1 つのノードでは管理された Synchrony を使用し、別のノードではスタンドアロンの Synchrony クラスターに接続するようなことはできません。 

You can track the connection state between Confluence and Synchrony by using the Synchrony connectivity health check that comes with the ATST plugin 1.53.2 and later. Learn more about the health check

Synchrony ログにアクセスする 

Synchrony が Confluence で管理されている場合 (推奨)、Synchrony ログは、Confluence アプリケーション ログとともに <local-home>/logs directory に保存されます。 

スタンドアロンの Synchrony をクラスタで実行している場合、Synchrony ログは、各ノード (開始および終了スクリプトを実行する場所) の Synchrony ディレクトリに保存されます。 

To learn how to change the logging level, see Configuring Synchrony. 

Synchrony データの管理

各ページとブログ投稿には独自の Synchrony 変更履歴があり、そのページまたはブログ投稿に対するすべての編集のグラフが含まれます。ビジーな Confluence サイトでは、Synchrony の変更履歴を格納するデータベース テーブルが非常に急速に成長することがあります。変更履歴にはすべての変更が格納されるため、関連するページが削除された後でも、個人を特定できる情報が保持されることがあります。 

We provide two scheduled jobs for removing Synchrony data:

• Synchrony データのエビクション (ソフト)
• Synchrony データのエビクション (ハード)

ソフト エビクション ジョブは、バックグラウンドで定期的に実行されます。ハード エビクション ジョブは、Synchrony データをより積極的に削除する必要がある場合に使用でき、デフォルトでは無効になっています。

See How to remove Synchrony data for more information on how these jobs work.