介绍

创意团队经常需要在不为每台工作站安装原始创作软件的情况下审阅大型图像和设计资产。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 选项。
存储保护、保留、清理和合规仍是完整应用架构的责任。

常见问题

Q: 如果我的工作流程需要一种当前功能页面上没有的格式怎么办？
A: 请与 Doconut 确认支持，并在决定采用该工作流程之前测试代表性文件。

在提交之前

审查当前的 Doconut 查看器并使用代表性的创意资产进行测试，在投入生产工作流程之前。