在网站运营中，如何高效地呈现内容列表，使用户能够快速找到他们最感兴趣或最有价值的信息，是一个重要的课题。安企CMS（AnQiCMS）提供了灵活的文档列表功能，让我们可以轻松实现内容列表按多种条件降序排列，例如按发布时间、浏览量或更新时间。这不仅能优化用户体验，也有助于提升内容的曝光度和互动性。
安企CMS文档列表排序的核心：archive/list 接口
安企CMS的文档列表功能主要通过 /api/archive/list 接口来实现。这个接口非常强大，它允许我们通过传递不同的参数来获取各种定制化的文档列表。实现按发布时间、浏览量或更新时间降序排列的关键，就在于该接口的 order 参数。
order 参数接受一个字符串，用于指定排序的字段和方向。为了实现降序排列，也就是让最新、最热门或最近更新的文档排在前面，我们只需要在排序字段后面加上 desc（表示 descending，降序）即可。
接下来，我们来看看如何针对不同的需求设置这个 order 参数。
按发布时间降序排列（最新发布优先）
如果您希望用户打开网站或某个栏目时，首先看到的是最新发布的内容，那么按发布时间降序排列是**选择。
在安企CMS中，文档的发布时间对应的是 created_time 字段。这个字段存储的是文档创建时的时间戳。
要实现最新发布的文档优先显示，您只需在调用 /api/archive/list 接口时，将 order 参数设置为：
order=created_time desc
这样，系统会根据文档的发布时间从新到旧进行排列，确保最新的文章、产品或其他类型的内容第一时间呈现在用户眼前。
按浏览量降序排列（热门内容优先）
用户对内容的关注度，往往可以通过浏览量直观体现。如果您的目标是突出那些最受欢迎、访问量最大的文章或产品，形成一个“热门榜单”或“大家都在看”的区域，那么按照浏览量降序排列就非常适合。
安企CMS的文档数据中包含了 views 字段，它记录了每篇文档的浏览次数。
要实现按浏览量从高到低排序，您可以在 order 参数中这样设置：
order=views desc
配置后，那些浏览量越高的文档会排在列表的越靠前位置，有助于引导新用户发现高质量或受关注的内容。
按更新时间降序排列（最新修订优先）
对于一些需要持续更新、内容时效性较强的文档，例如技术教程、法规解读或者产品说明等，用户可能更关心文档的最新修订状态。此时，按照更新时间降序排列能够让用户快速获取到最新的信息。
安企CMS提供了 updated_time 字段，它记录了文档最近一次被修改的时间戳。
要实现按更新时间从新到旧排序，您应该将 order 参数设置为：
order=updated_time desc
通过这种方式，即使文档发布已久，只要其内容有更新，就能重新获得曝光机会，确保用户总能接触到最新版本的信息。
实践中的应用
在实际的网站开发中，前端开发者或模板制作者会在调用 /api/archive/list 接口时，灵活组合这些排序参数以及其他筛选条件（如 moduleId、categoryId、limit、page 等）。例如，在一个新闻中心页面，您可能需要获取文章模型（moduleId=1）下某个分类（categoryId=5）的最新发布文章列表，并且每页显示10条，请求参数组合起来可能就是：
/api/archive/list?moduleId=1&categoryId=5&order=created_time desc&type=page&page=1&limit=10
通过这样的组合，安企CMS能够帮助我们构建出高度定制化且用户体验友好的内容展现形式，让网站内容管理变得更加得心应手。
常见问题 (FAQ)
Q1: 能否同时使用多个排序条件？比如先按发布时间降序，再按浏览量降序？
A: 根据安企CMS的文档说明，order 参数目前支持指定一个排序字段和方向。如果需要实现更复杂的复合排序逻辑（例如，在发布时间相同的情况下，再按浏览量排序），可能需要在前端获取数据后，在您的代码中进行二次排序处理。建议您在有此需求时，优先咨询安企CMS的技术支持，看是否有更高级的后端排序规则或未来的支持计划。
Q2: 除了降序排列，如何实现升序排列？
A: 如果您希望内容列表按时间、浏览量等从小到大（或从旧到新）的顺序显示，只需将 order 参数中的 desc 改为 asc（表示 ascending，升序）即可。例如，order=created_time asc 会将最旧的文档排在前面。
Q3: 如果我想排序的字段不在 id、views、created_time、updated_time 中怎么办？
A: 安企CMS的 archive/list 接口在 order 参数的说明中明确列出了支持的排序字段。如果您想根据自定义字段进行排序，需要确保该自定义字段已被系统配置为可排序字段。通常情况下，只有系统内置或经过特殊配置的字段才支持直接通过 order 参数排序。对于未列出的自定义字段，最直接的办法是在获取到文档列表数据后，在前端代码中进行排序处理。