ドキュメントAEM GuidesAEM Guides ドキュメント

バージョン管理 id181GB000XY4

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 経験者
  • 管理者

バージョン管理は、あらゆるコンテンツ管理システムにおける重要な側面です。 これにより、特定の時点でのデジタルアセットのスナップショットを作成できます。 デジタルアセットのバージョンを設定しておくと、必要なバージョンのアセットを復元して更新できます。 通常、アセットのバージョンを作成する場合、必要なアセットをチェックアウトしてチェックインします。

管理者は、ユーザーがファイルをチェックアウトせずに編集することを制限するルールを適用できます。 同様に、データの損失を回避するために、チェックアウトされたすべてのファイルがチェックインされて戻されていることを確認できます。

複数のユーザーが使用する環境では、ユーザーがシステムからファイルを削除しないようにすることも重要です。 この要件は、他のユーザーによってチェックアウトされているファイルに対してより重要です。 チェックアウトされたファイルがユーザーによって誤ってシステムから削除されるのを防ぐために、AEM Guidesでは次の設定を使用できます。 チェックアウトしたファイルに加えて、参照を含むファイルや他のファイルから参照されるファイルの削除をコントロールすることもできます。

アップロードしたファイルの新しいバージョンを作成

NOTE
この設定は、ファイルのアップロード時にのみ適用されます。

「アップロードしたファイルの新しいバージョンを作成 オプションを有効にするには、次の手順を実行します。

  1. 設定の上書きの手順に従って、設定ファイルを作成します。

  2. 設定ファイルで、「アップロードしたファイルの新しいバージョンを作成」オプションを設定するために、次の\（プロパティ\）の詳細を指定します。

    table 0-row-3 1-row-3
    PID プロパティキー プロパティの値
    com.adobe.fmdita.confi g.ConfigManager create.ver.new.content ブール値\（true/false\）.
    デフォルト値: true
NOTE
このオプションを選択すると、新しいバージョン管理メカニズムが実行され、以降のアップロードのデフォルトのアップロード動作は上書きされます。これにより、アップロードされたファイルの内容が新しいバージョンとして保存されます。 このオプションの選択を解除すると、AEM GuidesではAEMのデフォルトのバージョン管理メカニズムが使用されます。

チェックアウトされたファイルの編集を許可するように設定を構成する

AEM Guides Web エディタを使用すると、DITA トピックを作成および更新できます。 Web エディターを設定して、リポジトリからチェックアウトされたドキュメントのみを編集できます。 これにより、別のライターが編集するために開いたトピックを、他のライターが誤って上書きしないようにします。 編集用にトピックを開くと、作成者はファイルを閉じるときにファイルをチェックインできます。

もう 1 つの重要なルールは、チェックアウトされたファイルがシステムにチェックインされることを確認することです。 これにより、ユーザーがチェックインせずに誤ってファイルを閉じてしまうことを防ぐことができます。

設定の上書きの手順に従って、設定ファイルを作成します。 チェックアウトされたファイルの編集を設定するために、設定ファイルに次の\（property\）の詳細を指定します。

PID
プロパティキー
プロパティの値
com.adobe.fmdita.xmleditor.config.XmlEditorConfig
xmleditor.autocheckout
ブール値\（true/false\）.
デフォルト値: false

また、を設定すると、チェックアウトしたファイルを保存したりリポジトリにチェックインしたりせずに閉じたときに、常に警告メッセージを表示することができます。

PID
プロパティキー
プロパティの値
com.adobe.fmdita.xmleditor.config.XmlEditorConfig
xmleditor.checkin
ブール値\（true/false\）.
デフォルト値: false
NOTE
この機能のオン/オフに関係なく、トピック プレビューでは常に [ チェックアウト ] および [ チェックイン ] オプションが使用できます。

チェックアウトしたファイルをアップロード時に上書き

NOTE
この設定は、Assets UI からファイルを作成する場合にのみ適用され、WebDAV ツールを使用してファイルをアップロードする場合には適用されません。

ユーザーがアップロード時に、自分または他のユーザーによってチェックアウトされたファイルを上書きできるようにするには、次の手順を実行します。

  1. 設定の上書きの手順に従って、設定ファイルを作成します。
  2. 設定ファイルに次の\（property\）の詳細を入力して、「アップロード時にチェックアウトされたファイルを上書き オプションを設定します。
PID
プロパティキー
プロパティの値
com.adobe.fmdita.confi g.ConfigManager
overwrite.checkout.onupload
ブール値\（true/false\）.
デフォルト値: false
NOTE
デフォルトでは、このオプションはオフになっています。 このオプションを選択すると、チェックアウトされたファイルを上書きできます。 このオプションを選択しない場合、ユーザーまたは他のユーザーによってチェックアウトされているファイルは上書きされません。

チェックアウトしたファイルの削除を禁止する

設定の上書きの手順に従って、設定ファイルを作成します。 設定ファイルで、チェックアウトされたファイルをユーザーが誤って削除するのを防ぐために、次の\（property\）詳細を指定します。

PID
プロパティキー
プロパティの値
com.adobe.fmdita.xmleditor.config.XmlEditorConfig
xmleditor.preventcheckedoutcontentdeletion
ブール値\（true/false\）。
デフォルト値: true

参照ファイルの削除を防ぐ

管理者は、AEM リポジトリからファイルを削除できるユーザーを制御できます。 特に、ファイルに参照が含まれていたり、他のファイルによって参照されている場合は、そのようなファイルを削除できるユーザーを定義できます。

この設定を使用すると、すべてのユーザーによるファイルの削除を許可または禁止したり、特定のユーザーグループによるファイルの削除のみを許可したりできます。 ファイルの削除が許可されている場合は、次のプロセスに従います。

  • すべての参照元ファイルと参照元ファイルを含むフォルダーを削除すると、すべてのファイルが削除されます。 プロセスでは、まず参照を含まないすべてのファイルが削除され、次に参照を含むファイルまたは参照されているファイルが削除されます。

  • フォルダを削除するときに、フォルダ内のファイルがそのフォルダの外部にあるファイルによって参照されている場合は、ファイルを削除する前に参照を削除するよう求められます。

設定の上書きの手順に従って、設定ファイルを作成します。 設定ファイルで、参照を含むファイルまたは他のファイルによって参照されているファイルを誰が削除できるかを定義するために、次の\（property\）詳細を指定します。

PID
プロパティキー
プロパティの値
com.adobe.fmdita.config.ConfigManager
block.unsafe.delete
使用可能な値：
- allow_unsafe_delete_for_all
- allow_unsafe_delete_for_delete_assets_group
- block_unsafe_delete_for_all
デフォルト値:allow_unsafe_delete_for_delete_assets_group
これらの定数の詳細を以下に示します。

削除のアクセス権を付与するユーザーに応じて、次のいずれかの定数を指定します。

  • allow_unsafe_delete_for_all：すべてのユーザーにファイルの削除権限を付与します。 この場合、ファイル\（s\）に参照が含まれていたり、他のファイルによって参照されている場合は、そのファイル\（s\）を強制的に削除することもできます。 ファイルを削除する前に、参照を含むプロンプトが表示されます。削除操作をキャンセルし、参照を削除して、最後にファイルを削除できます。 または、参照を削除せずにファイル\（s\）を強制的に削除できます。

  • allow_unsafe_delete_for_delete_assets_group：管理者または delete-assets グループに属するユーザーは、ファイルを削除できます。 他のユーザーが参照を含むファイルを削除しようとすると、すべての参照が削除されるまで、そのようなファイルを削除することはできません。 次のスクリーンショットは、権限を持たないユーザーがファイルを削除しようとすると表示されます。

  • block_unsafe_delete_for_all: ファイル\（s\）への参照とファイルからの参照が削除されるまで、すべてのユーザー\（Administrators\）がファイルを削除することを許可しません。

古いバージョンの DITA ファイルをパージする

コンテンツを更新して新しいバージョンを作成すると、以前のバージョンの DITA ファイルがリポジトリに保持されます。 DITA ファイル用に作成されるバージョンの数が多いと、リポジトリの容量が大量に消費される可能性があります。 AEM Guidesでは、リポジトリから削除する必要がある古いバージョンを設定できます。

管理者権限がある場合は、指定された URL を使用してこのユーティリティにアクセスできます。

<server folder path> /libs/fmdita/clientlibs/xmleditor_version_purge/page.html

指定した基準のいずれかを満たす DITA ファイルのバージョンは維持され、パージされません。

  • ファイルの最初のバージョン
  • ベースラインに含まれる
  • あらゆる翻訳またはレビューワークフローに含まれる
  • ラベルが適用されています
  • 定義された年齢またはバージョン数の条件を満たしています

古いバージョンをパージするには、次の手順を実行します。

  1. パージするファイルに関する次の詳細を入力します。

  2. ​

    • 最新バージョンから保持するバージョンの数：保持し、パージしないバージョンの数を入力します。 例えば、「5」と入力した場合、最後の 5 つのバージョンが保持され、その前のバージョンは、他のパージ条件が満たされた場合にパージの対象として認定されます。

  • 期間内に作成されたバージョンを保持\（日数\）: バージョンの最長有効期間を日数で入力します。 指定された日数より古いバージョンは、他のパージ条件が満たされた場合にパージの対象となります。 例えば、100 と入力した場合、100 日前に作成されたすべてのバージョンは、他のパージ条件が満たされた場合にパージの対象となります。

  • パス：ファイルをパージするファイルまたはフォルダーのパスを選択します。

    note note
    NOTE
    パージできるのは DITA ファイルのみです。

  1. Preview Purge Report をクリックします。

    note note
    NOTE
    パージタスクは一度に 1 つしか存在できません。 処理中のバージョンがある場合は、別のバージョンのパージ操作を開始することはできません。

    バージョンのパージレポートが生成されます。

  2. バージョンのパージレポートをダウンロードして、パージされるファイルとバージョンを確認します。

  3. パージをキャンセル または パージを開始 を選択できます。

    パージステータスが表示されます。

    バージョンのパージレポートをダウンロード をクリックして、パージされたバージョンを表示します。 このレポートには、すべてのバージョンのパージのステータスと、特定のバージョンが保持された理由またはパージされた理由が表示されます。

NOTE
レポートは次の場所にダウンロードされます：/var/dxml/versionpurge
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178