ページ編集のための取り消しの設定

OSGi サービス Day CQ WCM Undo Configuration（com.day.cq.wcm.undo.UndoConfigService）では、ページ編集のための取り消しおよびやり直しのコマンドの動作を制御するプロパティを確認できます。

デフォルトの設定

標準インストールでは、デフォルト設定はsling:OsgiConfigノードのプロパティとして定義されます。

/libs/wcm/core/config.author/com.day.cq.wcm.undo.UndoConfig

このノードには、cq.wcm.undo.whitelist プロパティと cq.wcm.undo.blacklist プロパティが含まれ、その他のプロパティではデフォルトが取得されます。

取り消しとやり直しの設定

独自のインスタンスに合わせて、これらの OSGi サービスのプロパティを設定できます。

次のリストは、Webコンソールに表示されるプロパティの後に、対応するOSGiパラメーターの名前と、説明とデフォルト値（該当する場合）を示します。

• Enable（有効）
  (
  cq.wcm.undo.enabled)

  • 説明：ページの作成者が変更内容を取り消しおよびやり直しできるかどうかを決定します。
  • デフォルト: Selected
  • 型：Boolean

• パス
  (
  cq.wcm.undo.path)

  • 説明：取り消しのバイナリデータを保持するリポジトリのパス。作成者が画像などのバイナリデータを変更すると、元のバージョンのデータがここに保持されます。バイナリデータに対する変更を取り消すと、このバイナリの取り消しデータがページに復元されます。
  • デフォルト: /var/undo
  • 型：String
  メモ

  デフォルトでは、管理者のみが/var/undoノードにアクセスできます。 作成者によるバイナリコンテンツの取り消しおよびやり直しが可能になるのは、バイナリ取り消しデータへのアクセスを許可された後のみです。

• Min.validity
  (
  cq.wcm.undo.validity)

  • 説明:バイナリの元に戻すデータが格納される最小時間（時間単位）です。この期間を過ぎると、ディスク容量を節約するために、バイナリデータは削除可能になります。
  • デフォルト: 10
  • 型：Integer

• 手順
  (
  cq.wcm.undo.steps)

  • 説明:元に戻す履歴に格納されるページアクションの最大数です。
  • デフォルト: 20
  • 型：Integer

• 永続性
  (
  cq.wcm.undo.persistence)

  • 説明:元に戻す履歴を保持するクラス。2 つの永続クラスが用意されています。

    • CQ.undo.persistence.WindowNamePersistence：window.name プロパティを使用して履歴を保持します。
    • CQ.undo.persistence.CookiePersistance:cookieを使用して履歴を保持します。

  • デフォルト: CQ.undo.persistence.WindowNamePersistence

  • 型：String

• 永続化モード
  (
  cq.wcm.undo.persistence.mode)

  • 説明:取り消し履歴が持続するタイミングを決定します。ページが編集されるごとに取り消し履歴を保持するには、このオプションをオンにします。ページの再読み込みがおこなわれるとき（ユーザーが別のページに移動するときなど）のみに保持する場合は、このオプションをオフにします。

    取り消し履歴の保持には、Web ブラウザーのリソースを使用します。ページの編集に対してユーザーのブラウザーの反応が遅い場合は、ページの再読み込み時に取り消し履歴を保持するようにしてください。

  • デフォルト: Selected

  • 型：Boolean

• Marker mode
  (
  cq.wcm.undo.markermode)

  • 説明:取り消しまたはやり直しが発生した場合に影響を受ける段落を示す視覚的キューを指定します。有効な値は次のとおりです。

    • flash：段落の選択インジケーターが一時的にフラッシュします。
    • select：段落が選択されています。

  • デフォルト: flash

  • 型：String

• 良いコンポーネント
  (
  cq.wcm.undo.whitelist)

  • 説明：取り消しコマンドややり直しコマンドの影響を及ぼしたいコンポーネントのリスト。取り消しややり直しにより正しく機能するコンポーネントパスをこのリストに追加します。アスタリスク(*)を追加してコンポーネントのグループを指定します。

    • 次の値は、基礎文字コンポーネントを指定します。

      foundation/components/text

    • 次の値は、すべての基礎コンポーネントを指定します。

      foundation/components/*

  • このリストにないコンポーネントに対して取り消しまたはやり直しが実行されると、コマンドが信頼できない可能性があることを示すメッセージが表示されます。

  • デフォルト:このプロパティには、AEMが提供する多くのコンポーネントが入力されます。

  • 型：String[]

• 不良コンポーネント
  (
  cq.wcm.undo.blacklist)

  • 説明:元に戻すコマンドの影響を受けないコンポーネントやコンポーネントのリスト。取り消しコマンドで正しく動作しないコンポーネントやコンポーネントの操作を追加します。

    • 取り消し履歴にあるコンポーネントの操作がまったく必要ない場合はコンポーネントのパスを追加します。例：collab/forum/components/post
    • 特定の操作を元に戻す履歴から省略する場合は、パスにコロン(:)と操作を追加します（他の操作は正しく機能します）。例： collab/forum/components/post:insertParagraph.
  メモ

  リストに掲載されている操作でも、取り消し履歴には追加されます。取り消し履歴の Bad Component 操作の前に存在する操作は取り消すことができません。

  • 代表的な操作名は次のとおりです。

    • insertParagraph：コンポーネントがページに追加されます。
    • removeParagraph:コンポーネントが削除されます。
    • moveParagraph：段落が別の場所に移動されます。
    • updateParagraph：段落のプロパティが変更されます。

  • デフォルト：このプロパティには、複数のコンポーネントの操作が指定されます。

  • 型：String[]