XDocs DITA CCMS 入门指南
帮助您快速理解 XDocs CCMS 的核心价值与工作流程，并能够基于 DEMO 系统完成一次完整的操作体验。
一、系统概览与访问
1.1 什么是 XDocs DITA CCMS？
XDocs DITA CCMS 是 Bluestream 推出的企业级组件内容管理系统（CCMS），专为 DITA 标准的技术文档开发而优化。核心能力覆盖内容创建、审阅、查找、更新、管理、本地化和交付全生命周期。
DITA 原生完全基于 DITA 标准，以主题为单位做结构化内容管理
全流程覆盖创作 → 审阅 → 发布管理 → 本地化 → 交付
可扩展集成提供 RESTful API，可与 PLM、CRM、TMS 等系统对接
1.2 DEMO 系统访问
重要提示：DEMO 环境仅用于培训与评估，请勿用于生产。为安全起见，本页不公开任何登录密码；系统地址、账号与密码将在培训开始时由我方单独提供。
| 项目 | 信息 |
|---|---|
| 连接方式 | Remote Desktop（RDP） |
| Host / Server | DigitalContentDemo.bluestream.com |
| User | Administrator |
| Password | 培训时单独提供（不在公开页面展示） |
登录虚拟机后，XDocs 各组件的管理员账号与初始密码同样由我方在培训时提供，首次登录后应立即修改。
1.3 Web 应用访问地址
以下地址可从本地浏览器直接访问（无需 RDP）：
| 应用 | 地址 | 用途 |
|---|---|---|
| CMAdmin | https://digitalcontentdemo.bluestream.com/cmadmin | 项目管理、用户权限、系统配置 |
| Wex | https://digitalcontentdemo.bluestream.com/wex | 基于 Web 的内容审阅与协作 |
| KB（XDelivery） | https://digitalcontentdemo.bluestream.com/kb | 文档门户发布与交付 |
| kbconfig | https://digitalcontentdemo.bluestream.com/kbconfig | 交付门户配置 |
XDelivery 门户的阅读账号与配置账号凭证，同样在培训时单独提供，并建议为每位学员建立独立账号。
二、核心工作流概览
XDocs 内容生命周期包含四个核心阶段：
创作 Create→审阅 Review→发布管理 Release→交付 Publish / Deliver＋本地化 Localize
2.1 创作阶段
- 使用 Oxygen XML Editor / Oxygen XML Author（与 XDocs 深度集成）编写 DITA 主题
- 内容以组件（Topic）为单位存储，支持跨项目复用
- 支持分支管理（Branching），隔离不同版本的内容并行开发
作者可以独立工作在各自分支上，互不干扰，最终通过合并机制统一集成。
2.2 审阅与协作阶段
- Wex 是 XDocs 的 Web 审阅模块，允许组织内任何人参与内容生命周期
- 审阅者可直接在 DITA 内容上添加批注与建议修改
- 与自动化工作流集成，可配置事件订阅与邮件通知
审阅者不需要购买额外工具，也不需要学习 DITA——Wex 提供面向业务人员的界面。
2.3 发布管理阶段
- 分支管理：从主干复制内容到发布分支，隔离稳定版本
- 版本对比：比较两个版本之间的变更
- 条件过滤：通过 DITAVAL 文件实现条件发布（按产品型号、客户类型过滤内容）
2.4 本地化工作流（重点演示场景）
XDocs 本地化模块的核心优势是建立源文件与翻译文件之间的关联，实现变更追踪与增量翻译。
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 项目初始化 | 在 CMAdmin 中创建项目，指定源语言、目标语言、主文件夹 |
| 2 | 标记 NoLocalize | 在 XDocs Explorer 中把不需翻译的文件标记为 NoLocalize |
| 3 | 创建修订 Revision | 捕获英文文件的当前版本快照 |
| 4 | 创建周期 Cycle | 为一个或多个目标语言创建翻译周期 |
| 5 | 导出周期 | 打包发送给语言服务提供商（LSP） |
| 6 | 导入翻译 | LSP 返回译文后，通过周期选项卡导入 |
| 7 | 交叉链接修复 | 运行交叉链接报告，确保译文链接指向正确 |
| 8 | 发布与 QA | 发布目标语言文档并执行质量评估 |
传统本地化最大的痛点是「文件漂移」——源文件改了，翻译文件不知道。XDocs 通过修订-周期机制建立血缘关系，只发送变更内容，大幅降低翻译成本与返工率。
三、上机操作指南（基于 DEMO）
3.1 快速上手：五步走完核心流程
- 登录系统
RDP 连接 DEMO 服务器，打开 XDocs Explorer（桌面客户端）登录；或直接用浏览器访问 CMAdmin。 - 浏览项目
在 CMAdmin 中查看已有项目，理解项目结构（主文件夹、源语言、目标语言、可交付物根目录）。 - 查看本地化状态
打开 XDocs Explorer → Localization 选项卡，运行状态报告，查看新增 / 已更改 / 未更改文件。 - 体验发布
在 XDocs Explorer 中选择一个 DITA Map，执行标准发布（PDF 或 HTML），查看输出。 - 查看交付门户
浏览器访问 KB，登录后体验文档检索、筛选与下载。
3.2 典型演示场景
| 场景 | 操作 | 讲解要点 |
|---|---|---|
| 内容复用 | 展示一个主题被多个地图引用 | Write once, publish anywhere —— 降低维护成本 |
| 本地化增量 | 展示修订-周期流程，源文件修改后只发送变更 | 只翻译变了的内容，省时省钱 |
| 多渠道发布 | 同一套内容发布为 PDF、HTML、WebHelp | 一次创作，任意格式输出 |
四、演示与沟通要点
4.1 常见问题与回答
| 问题 | 回答要点 |
|---|---|
| 我们已经有 CMS，为什么需要 CCMS？ | CMS 管的是「文档」，CCMS 管的是「内容组件」。组件级管理意味着更细粒度的复用、变更影响分析和自动化发布。 |
| 迁移成本高吗？ | 参考案例：Ricoh 在 60 天内迁移了超过 50 万份系统文件；Bluestream 与本地实施方提供专业迁移服务。 |
| 能和我们的 PLM 集成吗？ | XDocs 提供 RESTful API，支持与 PLM、CRM、TMS 等系统对接。 |
| 支持哪些输出格式？ | PDF、HTML、WebHelp、eBook，以及通过 XDelivery 门户在线交付。 |
| 权限管理怎么做？ | 基于角色 / 组的细粒度权限控制，可在文件级或文件夹级配置 Create、Read、Update、Delete 权限。 |
4.2 差异化亮点
DITA 原生不是「支持 DITA」，而是「为 DITA 而生」
Oxygen 深度集成全球主流的 XML 编辑器与 CCMS 的无缝体验
XDelivery 交付门户不仅管理内容，还能智能交付
本地化模块修订-周期机制，大幅降低翻译成本
开放 API不锁定客户，可与其他企业系统集成
五、常见问题与故障排查
| 问题 | 可能原因 | 解决方式 |
|---|---|---|
| RDP 无法连接 | 密码错误或服务器地址不对 | 确认密码是否完整（含特殊字符），检查网络与账号状态 |
| 无法访问 Web 应用 | URL 或端口错误 | 使用 HTTPS，确认域名正确 |
| 本地化选项卡不可见 | 用户权限不足 | 确认用户属于 XDocsAdmin 或 XDocsLocalizationMgr 组 |
| 发布失败 | DITA-OT 配置或插件问题 | 检查发布输出类型配置，查看日志 |
| 交叉链接报告显示异常链接 | 译文中链接仍指向英文源 | 运行交叉链接修复功能 |
六、下一步学习资源
| 资源类型 | 说明 |
|---|---|
| Bluestream 官网 | bluestream.com —— 产品文档、案例研究、Webinar 录播 |
| XDocs API 文档 | api.bluestream.com/apidoc —— 集成开发参考 |
| 知识库（KB） | DEMO 系统中的 KB 应用本身就是最好的产品展示 |
| 实施与培训服务 | 我们与 Bluestream 提供定制化 Hands-on 培训 |
| B 站视频教程 | XDocs 本地化翻译与发布工作流 · XDocs 版本管理 |
| B 站 UP 主空间 | RAYTECHBJ —— 更多 XDocs 操作视频 |
| 内部培训素材 | 本地化检查清单、发布操作笔记等内部资料，请联系我们单独获取 |
入门建议：演示的核心不是「展示所有功能」，而是「针对具体问题讲透 1–2 个场景」。建议先熟练掌握本地化工作流与多渠道发布这两个最能体现 XDocs 差异化价值的场景。
© 2026 镭内容科技 · XDocs DITA CCMS 入门指南 v2.0 · 如需现场演示或实施咨询，请联系 contact@digitalcontent.cn