介绍
创意团队经常需要在每台工作站上无需安装原始创作软件即可审阅大型图像和设计资产。Doconut 是一个 .NET 文档查看器 SDK，应用程序可以使用它在浏览器中显示受支持的文档和图像。其当前功能列表包括 TIFF、SVG、PSD、PNG、JPEG、BMP 和 GIF，以及 PDF、Office、CAD、电子邮件和其他业务格式。
1. 实际挑战：在 .NET Web 门户中预览复杂图像格式
设计工作室经常搭建内部门户，让客户、艺术总监和初级设计师可以上传草稿、比较修订并对最终资产进行批准。听起来很简单，对吧？但在实际操作中，仍会不断出现三个技术难题：
| 痛点 | 对设计师和摄影师的重要性 |
|---|---|
| 插件依赖 – 传统查看器依赖 Adobe Flash、ActiveX 或第三方浏览器扩展。 | 用户浪费时间安装或更新插件，企业 IT 为安全起见会阻止许多插件。 |
| 预览保真度 – 配置不当的预览管道可能会改变颜色、渐变、透明度或细节。 | 对颜色要求严格的工作需要在审阅者依赖浏览器预览前进行代表性测试。 |
| 大型或复杂资产 – TIFF 和 PSD 文件可能会给处理、内存和缩放行为带来压力。 | 团队应使用真实文件和基础设施进行测试，而不是假设统一的大小或性能限制。 |
在后端已经处理身份验证、存储和版本控制的 ASP.NET Core 或 MVC 门户中，这些问题会更加棘手。添加单独的查看器堆栈可能会带来额外的许可证、维护和安全审查。
2. 确认所需的格式和功能
不要依赖于所有专业图像格式都表现相同的笼统承诺。官方Doconut 功能页面目前列出了 TIFF/TIF、SVG、PSD、PNG、JPEG、BMP 和 GIF 等受支持的类别。
测试组织实际使用的文件，包括大尺寸、透明度、嵌入字体、多页以及损坏的文件。如果所需格式未列出，请在向用户承诺前先与 Doconut 确认支持情况。
3. 步骤指南：在 .NET 门户中嵌入 Doconut 高级图像查看器
以下是一个实用的操作指南，开发团队可以遵循它为设计师提供集成的预览体验。示例假设使用 ASP.NET Core MVC 项目，但相同的思路也适用于 WebForms、Razor Pages、React 或 Angular 前端。
3.1. 添加 Doconut 查看器库
使用来自官方下载页面的最新包和示例。记录所选版本并验证其与目标 .NET 运行时的兼容性。
3.2. 设置安全的上传端点
使用应用程序的身份验证和授权模型保护文档访问。将存储、上传验证、保留、清理以及 HTTPS 行为明确为应用程序的职责。
3.3. 构建上传表单（设计师 UI）
为当前文档和测试确认的文件类别创建 HTML 表单。accept 属性可以提升用户体验，但服务器仍需验证文件大小和内容。
3.4. 在服务器端处理上传
表单提交后，验证并将文件存储在公共目录之外。仅在服务器端授权成功后才解析以供查看。
3.5. 在预览页面渲染查看器
使用随已安装 SDK 版本提供的文档初始化查看器。不要暴露物理路径、存储凭据或不受限制的文件 URL。在宣称可用之前，确认导航、打印、注释以及特定格式的行为。
3.6. 为设计导向的 UI 定制工具栏
围绕审阅任务设计门户。仅使用已安装版本文档中提供的工具栏和 UI 定制点，并记住隐藏控件并不能替代服务器端授权。
4. 从上传到批准：端到端设计师工作流
以下工作流展示了嵌入式查看器在支持审阅的同时，原始创作工具仍负责编辑的场景。
4.1. 捕获与导出
摄影师准备受支持的审阅资产（如 TIFF、PNG 或 JPEG），并将原始来源保存在相应的资产管理系统中。
4.2. 上传至审阅门户
摄影师通过 HTTPS 端点上传资产。应用程序对其进行验证，依据组织政策存储，并授权对审阅记录的访问。
4.3. 呈现并验证预览
应用程序通过 Doconut 呈现受支持的资产。审阅者使用已确认的已安装版本功能，并在受控测试流程中将颜色关键的输出与原件进行比较。
4.4. 支持格式的图层交互
对于 SVG 或 PSD 工作流，测试代表性资产并确认可用的检查功能。未经过验证，不要假设图层交互或矢量保真度。
4.5. 协作与反馈
宿主应用程序可以在查看器旁放置自己的评论、批准控件和版本历史。如果工作流需要注释或跳转到标记区域，请使用已安装的 Doconut 版本确认这些功能。审计日志仍是应用程序的责任。
4.6. 控制导出和打印
资产获批后，应用程序记录决定，并根据其文档化政策处理任何打印、导出、保留或删除步骤。
这使审阅保持在门户内进行，而编辑和最终生产检查则交由相应的专业工具完成。
5. 将查看器扩展到其他创意场景（简要）
虽然我们重点关注平面设计师和摄影师，但 Doconut 的引擎在其他领域同样出色：
- 建筑师和工程师 可以在项目门户中预览受支持的 DWG、DXF 和 DGN 文件。
- 营销团队 可以在图像旁预览 PDF、PPTX 和 EPUB，统一审阅流程。
- 学生 在视觉艺术课程中可以上传并检查作业，而无需昂贵的软件许可证。
这些旁用例展示了单一查看器组件如何服务整个企业，但深入探讨仍聚焦于我们刚才阐述的设计工作流。
关键要点
- 浏览器查看降低了审阅者安装原始桌面创作软件的需求。
- 应用程序控制 HTTPS、授权、存储保护、保留和清理。
- 颜色关键的保真度和特定格式工具必须使用代表性资产进行测试。
- 使用已安装 Doconut 版本文档中的包和集成 API。
- 在设计角色特定控件之前，确认已安装版本的文档化工具栏和 UI 选项。
- 存储保护、保留、清理和合规仍是完整应用架构的责任。
常见问题
问：如果我的工作流需要的格式未在当前功能页面上列出怎么办？
答： 请与 Doconut 确认支持情况，并在承诺该工作流之前测试代表性文件。
准备好赋能您的创意团队了吗？
请查看当前的Doconut 查看器，并使用代表性的创意资产进行测试后，再决定投入生产工作流。