软航OFFICE文档控件 国产版授权文件更新与替换部署说明

• 适用于软航OFFICE文档控件 国产版

⚠️ 重要提示

• 版本要求： 需要软航OFFICE文档控件 V6031 或后续版本才支持此授权文件更新功能
• 本文档中的 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX 为占位符，实际使用时请替换为真实的授权文件ID和版本号

📝 参考示例

以下为示例格式，实际使用时请替换为您的真实授权信息：

• 示例授权文件： A1B2C3D4-E5F6-7890-ABCD-EF1234567890-V6031.dat
• 示例授权ID： A1B2C3D4-E5F6-7890-ABCD-EF1234567890-V6031

一、授权文件信息

1. 产品授权文件：

XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX.dat

2. 授权文件 ID：

XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX

二、授权文件部署步骤

1. 文件部署

将授权文件 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX.dat 部署到调用 NTKO OFFICE 文档控件的应用服务器项目中。

建议放置位置： Web 可访问目录下，例如 /ntko/ 或 /config/

2. 访问验证

确保授权文件在浏览器中可正常访问，例如：

   http://应用项目地址/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX.dat

三、授权文件替换方法

调用 NTKO OFFICE 文档控件的 NtkoDownLoadCfgFile 方法，以替换客户端授权文件。

详细接口说明请参考开发手册：

• 《NTKO OFFICE文档控件 For Linux开发接口参考_XXX.doc》
• 软航OFFICE文档控件国产化版本开发接口

四、控件调用代码（谷歌内核部分）

新增授权属性（2025-02-14）

document.write('_NtkoAuthorizationID="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX">');

授权文件检测与替换

function NtkoDownLoadCfgFile() {
    if (obj.NtkoCfgFileID == "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX") {
        // alert("已成功替换授权文件");
        console.log("授权文件已是最新版本");
    } else {
        obj.NtkoDownLoadCfgFile("http://应用项目地址/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX-VXXXX.dat");
        console.log("开始下载并替换授权文件...");
    }
}

五、部署与使用注意事项

1. 基本要求

• 确保应用服务器可通过 HTTP 正常访问 .dat 授权文件
• 建议在控件加载后调用 NtkoDownLoadCfgFile()

2. 故障排查

若授权替换失败，请检查以下项目：

• ✅ 授权文件路径是否正确
• ✅ 控件版本与授权文件是否匹配
• ✅ 授权属性ID值与授权文件是否匹配
• ✅ 网络或权限限制是否导致访问失败

3. 安全提醒

• 授权文件ID为敏感信息，请妥善保管
• 建议定期检查授权文件的有效性
• 避免在公开代码中暴露授权文件ID

---

文档版本： V1.0
更新日期： 2025-02-14
适用范围： 软航OFFICE文档控件 国产版