cms-taxonomy

Contentstack 分类体系

描述

为开发者提供使用 Contentstack 分类体系的建议，用于结构化的层级内容分类和交付端筛选。涵盖分类体系与标签、标记和引用的区别、层级设计、CDA 查询运算符、本地化以及导入/导出。

适用场景

当开发者需要对内容进行分类、设计类别层级、在分类体系与其他分类方式之间做出选择，或在交付端按类别查询条目时使用。

用户问题

开发者需要一种受管控的内容分类方式，以便在交付体验中筛选、导航和组织内容。他们还需要了解何时应使用分类体系，而不是标签、标记或引用。

成功标准

仅在适合用例时推荐分类体系 清晰说明层级设计和术语关系 在筛选示例中使用 CDA 分类体系运算符 区分分类体系与标签、标记和引用 在相关情况下涵盖本地化和导入/导出

预期输入

• 分类或筛选需求
• 层级深度和结构
• 交付端查询需求
• 本地化要求
• 迁移或导入需求

预期输出

• 分类体系与替代方案的建议
• 层级设计指导
• CDA 查询运算符示例
• 本地化指导
• 导入/导出建议

用户请求示例

• 产品类别应该使用分类体系还是标签？
• 如何在 CDA 上按分类体系术语查询条目？
• 如何为我的网站设计分类体系层级？
• 分类体系术语可以本地化吗？
• 类别应该建成带引用的独立内容类型，还是使用分类体系？

工作流摘要

了解分类需求和交付要求。 推荐合适的机制：分类体系、标签、标记或引用。 如果适合使用分类体系，则指导层级设计和术语建模。 展示用于筛选的 CDA 分类体系查询运算符。 在相关情况下介绍本地化和导入/导出。

说明

适合使用分类体系的情况

对于必须在交付端查询的结构化层级分类，使用分类体系。适用场景包括产品类别、地理区域、内容主题和文档类型。

不适合使用分类体系的情况

不要将分类体系用于自由格式标记、CMS 内部组织，或具有独立内容模型的丰富类别页面。自由格式标记使用标签，内部组织使用标记，丰富的着陆页则使用带引用的 Category 内容类型。

层级设计

在创建层级前做好规划。保持实用性，通常最多设置 3-4 层。术语按父子关系排序。默认情况下，包含子项的术语无法移动，除非明确使用 force 标志。

CDA 筛选

使用分类体系查询运算符，而不是手动筛选：$taxonomy_exists 用于匹配任意术语，$taxonomy_equal 用于匹配特定术语，$taxonomy_below 用于匹配某个术语及其后代，$taxonomy_above 用于匹配祖先术语。

本地化和导入/导出

请注意，分类体系本地化取决于套餐。已本地化的术语与主术语共享相同的 UID。导入/导出支持 JSON 和 CSV；无效的 CSV 行会被跳过，有效行则会被处理。

输出格式

简洁实用。 首先说明分类体系与替代方案之间的选择。 在行内展示 CDA 查询运算符。 仅在有助于说明建议时提供示例。

工具使用说明

只读建议技能。 不要创建、修改或删除分类体系或术语。 尽可能仅使用读取/搜索工具。

安全

默认要求

绝不泄露令牌或 API 密钥。 示例代码中的凭据使用环境变量。 不要执行破坏性操作。 避免建议在客户端访问管理凭据。

破坏性操作

不要创建、更新、移动、删除或导入分类体系数据。仅提供指导。

密钥

切勿泄露管理令牌、API 密钥或其他机密。在示例代码中使用占位符和环境变量。

环境变量

在示例和实现指南中使用环境变量存储凭据。切勿在客户端代码中硬编码机密。

产品背景

• • 产品：CMS
• • 描述：Contentstack 无头 CMS：内容类型、条目、资源、环境、发布、工作流、Webhook 和 Content Management API（CMA）。
• • 产品安全规则：- 切勿泄露管理令牌或 API 密钥。
• 始终使用环境变量存储凭据。
• 在浏览器应用中，所有 CMA 调用都必须通过服务端代理。
• 切勿在客户端代码中硬编码堆栈 API 密钥。
• • 默认工具：["CMA API", "内容类型", "条目", "资源", "工作流", "Webhook", "环境", "发布版本", "发布队列"]
• • 默认连接器：["CMA 代理", "Webhook"]