用途:把 CogniteFileViewer 集成进 Flows 应用,用于预览 CDF 中的文件。
主要能力:支持 PDF(翻页、缩放、平移、图示标注叠加);Office 文档(Word、PowerPoint、Excel、ODS、ODP、ODT、RTF、TSV,经 CDF Document Preview API 转 PDF 后渲染);图片(JPEG、PNG、WebP、SVG、TIFF,支持缩放、平移、旋转);文本(.txt、.csv、.json 以预格式化文本显示);其他类型回退到 renderUnsupported。缩放、平移与触控手势内建处理。
使用方式:按顺序执行——阅读 package.json、vite.config.ts 及目标组件;将 code/ 下全部文件复制到 src/cognite-file-viewer/;按包管理器安装依赖(pnpm add react-pdf@^9.1.1 / npm install react-pdf@^9.1.1 / yarn add react-pdf@^9.1.1);在 vite.config.ts 添加 optimizeDeps.exclude: ['pdfjs-dist'];通过 useDune() 获取 sdk 并渲染组件。组件必须设置明确高度,否则会收缩为零。
来源类型:instanceId(数据建模文件,唯一启用标注叠加)、internalId、url。优先使用 instanceId;通过 sdk.files.list() 列文件时先检查 file.instanceId。
常见限制:使用 pnpm 需将 pdfjs-dist 提升(public-hoist-pattern[]=pdfjs-dist)或直接安装;不要单独安装 pdfjs-dist,否则 Worker 版本不匹配;标注仅在数据模型中的 P&ID/图示文件上显示;切换文件时组件不会自动重置页码、缩放与旋转,需自行处理。
暂未提供:该技能的具体收费、价格与适用平台信息暂未提供。