在使用安企CMS（AnQiCMS）进行网站内容管理时，我们常常需要将文档列表中的特定信息提取出来并以某种格式组合，比如将一系列文档的分类ID连接成一个字符串，用于前端的动态渲染、SEO优化或特定的数据统计。虽然AnQiCMS的模板系统提供了强大的数据获取能力，但要直接在模板中实现这种“提取-组合”的逻辑，需要我们巧妙地运用其内置的标签和过滤器。

核心挑战：从列表数据中提取并拼接特定字段

AnQiCMS的模板引擎设计上追求简洁高效，它允许我们通过标签（tag）来获取数据，并通过循环（for loop）遍历列表。然而，像在编程语言中那样直接声明一个空数组，然后循环向其中添加元素并最终使用一个“join”函数进行拼接，在多数模板引擎中是难以直接实现的。我们需要一种在模板逻辑允许范围内的变通方法。

运用 AnQiCMS 模板标签：archiveList 与 for 循环

首先，要获取文档列表，我们会用到AnQiCMS的archiveList标签。这个标签能够根据我们设定的条件，例如模块ID、分类ID、排序方式等，返回一个文档对象的集合。

假设我们希望获取某个分类下的所有文档，并提取它们的分类ID。典型的archiveList用法如下：

{% archiveList archives with type="list" categoryId="1" limit="10" %}
    {# 此处将遍历返回的文档列表 #}
{% endarchiveList %}

这里，archives变量将包含一个文档对象的列表。接下来，我们需要遍历这个列表，访问每个文档对象的特定字段。AnQiCMS的模板引擎支持for循环来完成这一任务：

{% for item in archives %}
    {# 这里的 item 代表列表中的每一个文档对象 #}
    {# 我们可以通过 item.FieldName 的形式访问其属性，例如 item.CategoryId #}
{% endfor %}

巧妙结合 set 标签与 add 过滤器实现字符串拼接

现在，我们已经能够获取到每个文档的分类ID了。关键是如何将这些独立的ID值连接成一个字符串，例如“1,2,3,4,5”。AnQiCMS的模板提供了set标签用于声明和赋值变量，以及add过滤器用于字符串或数字的拼接，这正是我们实现目标的工具。

我们的思路是：

  1. 首先，使用set标签初始化一个空字符串变量，用于存储最终拼接的结果。
  2. 在for循环中，每次迭代时，将当前文档的分类ID拼接到这个字符串变量中。
  3. 为了避免字符串开头出现多余的分隔符（例如“,”），我们可以在循环中判断是否是第一个元素，对第一个元素不添加前缀分隔符。

下面是具体的实现代码：

{# 步骤1：初始化一个空字符串变量来存储所有分类ID #}
{% set allCategoryIds = "" %}

{% archiveList archives with type="list" categoryId="1" limit="5" %} {# 假设获取分类ID为1的最新5篇文档 #}
    {% for item in archives %}
        {# 步骤2：在循环中，将当前文档的分类ID拼接到 allCategoryIds 变量中 #}
        {# 步骤3：判断是否是第一个元素，以控制分隔符的添加 #}
        {% if forloop.First %}
            {# 如果是第一个元素，直接拼接分类ID，不加逗号 #}
            {% set allCategoryIds = allCategoryIds|add:item.CategoryId %}
        {% else %}
            {# 如果不是第一个元素，先拼接逗号，再拼接分类ID #}
            {% set allCategoryIds = allCategoryIds|add:","|add:item.CategoryId %}
        {% endif %}
    {% endfor %}
{% endarchiveList %}

{# 循环结束后，allCategoryIds 变量就包含了所有分类ID组成的字符串 #}
<p>所选文档的分类ID集合：{{ allCategoryIds }}</p>

代码解析：

  • {% set allCategoryIds = "" %}: 我们定义了一个名为allCategoryIds的变量，并将其初始化为空字符串。
  • {% for item in archives %}: 遍历archiveList获取到的文档列表。
  • {% if forloop.First %}: 这是AnQiCMS模板循环中一个非常有用的内置变量，它会判断当前迭代的元素是否为列表中的第一个。
  • {% set allCategoryIds = allCategoryIds|add:item.CategoryId %}:
    • item.CategoryId: 获取当前文档的分类ID。
    • |add:value: 这是AnQiCMS模板的add过滤器。它的作用是将左侧的值与右侧的值进行拼接（如果都是字符串）或相加（如果都是数字）。在这里，它会将allCategoryIds（字符串）与item.CategoryId（数字，会被隐式转换为字符串）拼接起来。
  • {% else %}{% set allCategoryIds = allCategoryIds|add:","|add:item.CategoryId %}: 如果不是第一个元素，我们先使用|add:","拼接一个逗号，然后再拼接当前的分类ID。

通过这种方式，我们最终得到的allCategoryIds变量将会是一个由逗号分隔的分类ID字符串，例如：”1,5,3,2,4”。

注意事项与**实践

  • 数据量考量： 这种在模板中动态拼接字符串的方法对于小到中等规模的数据列表（例如几十到几百条）是高效且实用的。如果文档列表非常庞大，比如上万条，那么在模板层进行大量字符串拼接可能会稍微增加服务器的渲染负担。对于极端情况，可以考虑在AnQiCMS的后台插件或自定义模块中预处理数据，直接将拼接好的字符串传递给模板。
  • 字段类型： 确保你提取的字段（例如item.CategoryId）能够被隐式转换为字符串，或者它本身就是字符串类型。数字类型通常会自动转换，其他复杂对象则可能需要进一步处理。
  • 分隔符自定义： 你可以根据需要更改代码中的,为其他任何分隔符，例如|、（空格）等。
  • 通用性： 这种方法不仅适用于提取分类ID，也可以用来提取文档ID（item.Id）、文档标题（item.Title）或其他任何可通过item.FieldName访问的字段。

总结

AnQiCMS的模板系统虽然在复杂逻辑处理上有所限制，但通过巧妙组合archiveList标签获取数据、for循环遍历、set标签赋值以及add过滤器的拼接功能，我们能够灵活地从文档列表中提取特定字段并组合成所需的字符串。这对于实现各种动态内容展示和数据处理需求都非常有帮助，也体现了AnQiCMS在内容管理方面的强大可定制性。

常见问题 (FAQ)

1. 为什么不能直接在 archiveList 标签内使用类似 SQL GROUP_CONCAT 的功能来拼接字符串？

AnQiCMS的模板系统主要用于数据的展示和渲染，而非数据库层面的复杂数据聚合操作。archiveList标签的目的是获取文档列表对象，而像`