版本管理 id181GB000XY4

版本控制是任何内容管理系统的一个重要方面。 它允许您在特定时间点创建数字资产的快照。 有了数字资产的版本,您可以恢复并更新资产的所需版本。 通常,要创建任何资源的版本,您需要签出并签入所需的资源。

作为管理员,您可以强制实施规则,以限制用户在不签出文件的情况下编辑文件。 同样,您可以确保所有签出的文件都签回以避免任何数据丢失。

在多用途环境中,确保用户不会从系统中删除文件也很重要。 对于其他用户签出的文件,此要求更为重要。 为了防止用户意外从系统中删除已签出的文件,AEM Guides提供了可供您使用的配置。 除了已检出文件之外,您还可以控制删除包含引用或从其他文件引用的文件。

为上载的文件创建新版本

NOTE
此配置仅在上传文件时适用。

要启用​ 为上载的文件创建新版本 ​选项,请执行以下步骤:

  1. 使用配置覆盖中提供的说明创建配置文件。

  2. 在配置文件中,提供以下(property)详细信息以配置​ 为上载的文件创建新版本 ​选项:

    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编辑器配置为仅允许编辑已从存储库中签出的那些文档。 这可确保没有其他编写器意外覆盖由其他编写器打开进行编辑的主题。 打开主题进行编辑后,作者可以在关闭文件时签入文件。

另一条重要规则是确保已签出的文件被签回系统。 这样可防止用户在不重新签入文件的情况下意外关闭文件。

使用配置覆盖中提供的说明创建配置文件。 在配置文件中,提供以下(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:授予所有用户删除文件的权限。 在这种情况下,如果文件包含引用或被其他文件引用,则也可以强制删除此类文件。 在删除文件之前,将显示一个包含引用的提示,您可以取消删除操作,删除引用,最后删除文件。 或者,也可以强制删除文件而不删除参照。

  • allow_unsafe_delete_for_delete_assets_group:允许管理员或属于​ delete-assets ​组的用户删除文件。 如果任何其他用户尝试删除包含任何引用的文件,则在删除所有引用之前,不允许他们删除此类文件。 当没有权限的用户尝试删除文件时,将显示以下屏幕截图。

  • block_unsafe_delete_for_all:不允许所有用户\(包括管理员\)删除文件,除非删除对文件的引用和来自文件的引用。

清除旧版本的DITA文件

当您更新内容并创建新版本时,存储库中会维护以前版本的DITA文件。 可能会在一段时间内为您的DITA文件创建多个版本,这些版本可能会共同占用存储库中的大量空间。 AEM Guides允许您配置应从存储库中删除的旧版本。

如果您具有管理权限,则可以使用给定的URL访问此实用程序:

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

符合任何给定标准的DITA文件的版本将得到维护且不清除:

  • 是文件的第一个版本
  • 包含在基线中
  • 包含在任何翻译或审阅工作流中
  • 应用了标签
  • 符合定义的版本年龄或版本号标准

执行以下步骤以清除旧版本:

  1. 输入要清除的文件的以下详细信息:

    • 从最新版本中保留的版本数:输入应保留而不清除的版本数。 例如,如果输入5,则会保留最后5个版本,并且如果满足其他清除条件,则符合清除条件的版本中之前的版本将被清除。
  • 保留在时间跨度\(以天为单位\) ​内创建的版本:输入版本的最长存在时间(以天为单位)。 如果满足其他清除条件,则符合清除指定天数之前的版本的资格。 例如,如果输入100,则符合其他清除条件时,所有在100天之前创建的版本都将被清除。

  • 路径:选择要清除其文件的文件或文件夹的路径。

    note note
    NOTE
    只能清除DITA文件。
  1. 单击​ 预览清除报告

    note note
    NOTE
    一次只能有一个清除任务。 如果正在执行另一个版本清除操作,则无法启动该操作。

    生成版本清除报告。

  2. 下载版本清除报告,并检查要清除的文件和版本。

  3. 您可以选择​ 取消清除 ​或​ 开始清除

    将显示清除状态。

    单击​ 下载版本清除报告 ​以查看清除的版本。 此报表提供所有版本的清除状态,以及保留特定版本或清除该版本的原因。

NOTE
在以下位置下载报告: /var/dxml/versionpurge
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178