软航科技文档中心

Appearance

控件密钥相关属性 ​

ProductCaption ​

说明：
String型字符串；可读写；标题栏名称，标志着唯一的授权。正式版本用户请参考发布包中的使用说明。

语法：

javascript
// 设置
Obj.ProductCaption = "您的产品标题";

// 读取
var caption = Obj.ProductCaption;

使用示例：

javascript
// 设置产品标题
Obj.ProductCaption = "企业文档管理系统";

// 读取当前产品标题
var currentCaption = Obj.ProductCaption;
console.log("当前产品标题:", currentCaption);

ProductKey ​

说明：
String型字符串；可读写；密钥，标志着唯一的授权。正式版本用户请参考发布包中的使用说明。

语法：

javascript
// 设置
Obj.ProductKey = "您的产品密钥";

// 读取
var key = Obj.ProductKey;

使用示例：

javascript
// 设置产品密钥
Obj.ProductKey = "ABCD-EFGH-IJKL-MNOP";

// 读取当前产品密钥
var currentKey = Obj.ProductKey;
console.log("当前产品密钥:", currentKey);

MakerCaption ​

说明：
String型字符串；可读写；买断授权标题栏名称，标志着唯一的授权。正式版本用户请参考发布包中的使用说明。

语法：

javascript
// 设置
Obj.MakerCaption = "您的买断授权标题";

// 读取
var makerCaption = Obj.MakerCaption;

使用示例：

javascript
// 设置买断授权标题
Obj.MakerCaption = "企业版买断授权";

// 读取当前买断授权标题
var currentMakerCaption = Obj.MakerCaption;
console.log("当前买断授权标题:", currentMakerCaption);

MakerKey ​

说明：
String型字符串；可读写；买断授权密钥，标志着唯一的授权。正式版本用户请参考发布包中的使用说明。

语法：

javascript
// 设置
Obj.MakerKey = "您的买断授权密钥";

// 读取
var makerKey = Obj.MakerKey;

使用示例：

javascript
// 设置买断授权密钥
Obj.MakerKey = "WXYZ-1234-5678-9ABC";

// 读取当前买断授权密钥
var currentMakerKey = Obj.MakerKey;
console.log("当前买断授权密钥:", currentMakerKey);

综合使用示例 ​

产品授权配置 ​

javascript
// 配置产品授权信息
function configureProductLicense() {
    // 设置产品标题和密钥
    Obj.ProductCaption = "企业文档管理系统";
    Obj.ProductKey = "ABCD-EFGH-IJKL-MNOP";
    
    console.log("产品授权配置完成");
    console.log("产品标题:", Obj.ProductCaption);
    console.log("产品密钥:", Obj.ProductKey);
}

买断授权配置 ​

javascript
// 配置买断授权信息
function configureMakerLicense() {
    // 设置买断授权标题和密钥
    Obj.MakerCaption = "企业版买断授权";
    Obj.MakerKey = "WXYZ-1234-5678-9ABC";
    
    console.log("买断授权配置完成");
    console.log("买断授权标题:", Obj.MakerCaption);
    console.log("买断授权密钥:", Obj.MakerKey);
}

完整授权配置 ​

javascript
// 完整的授权配置
function configureFullLicense() {
    try {
        // 产品授权配置
        Obj.ProductCaption = "企业文档管理系统";
        Obj.ProductKey = "ABCD-EFGH-IJKL-MNOP";
        
        // 买断授权配置
        Obj.MakerCaption = "企业版买断授权";
        Obj.MakerKey = "WXYZ-1234-5678-9ABC";
        
        console.log("完整授权配置完成");
        
        // 验证配置
        validateLicenseConfiguration();
        
    } catch (error) {
        console.error("授权配置失败:", error.message);
    }
}

授权验证 ​

javascript
// 验证授权配置
function validateLicenseConfiguration() {
    var productCaption = Obj.ProductCaption;
    var productKey = Obj.ProductKey;
    var makerCaption = Obj.MakerCaption;
    var makerKey = Obj.MakerKey;
    
    console.log("授权配置验证:");
    console.log("产品标题:", productCaption || "未设置");
    console.log("产品密钥:", productKey || "未设置");
    console.log("买断授权标题:", makerCaption || "未设置");
    console.log("买断授权密钥:", makerKey || "未设置");
    
    // 检查必要的授权信息
    if (!productCaption || !productKey) {
        console.log("警告: 产品授权信息不完整");
        return false;
    }
    
    if (!makerCaption || !makerKey) {
        console.log("警告: 买断授权信息不完整");
        return false;
    }
    
    console.log("授权配置验证通过");
    return true;
}

动态授权设置 ​

javascript
// 动态设置授权信息
function setLicenseInfo(type, caption, key) {
    switch(type) {
        case 'product':
            Obj.ProductCaption = caption;
            Obj.ProductKey = key;
            console.log("产品授权已设置");
            break;
        case 'maker':
            Obj.MakerCaption = caption;
            Obj.MakerKey = key;
            console.log("买断授权已设置");
            break;
        default:
            console.log("未知授权类型");
            return false;
    }
    
    return true;
}

// 使用示例
setLicenseInfo('product', '企业文档管理系统', 'ABCD-EFGH-IJKL-MNOP');
setLicenseInfo('maker', '企业版买断授权', 'WXYZ-1234-5678-9ABC');

属性分类总结 ​

分类属性功能类型说明
产品授权ProductCaption产品标题String产品授权标题栏名称
ProductKey产品密钥String产品授权密钥
买断授权MakerCaption买断授权标题String买断授权标题栏名称
MakerKey买断授权密钥String买断授权密钥

授权类型说明 ​

授权类型标题属性密钥属性说明
产品授权ProductCaptionProductKey标准产品授权
买断授权MakerCaptionMakerKey买断式授权

使用流程 ​

1. 授权信息获取 ​

javascript
// 获取授权信息
function getLicenseInfo() {
    var licenseInfo = {
        productCaption: Obj.ProductCaption,
        productKey: Obj.ProductKey,
        makerCaption: Obj.MakerCaption,
        makerKey: Obj.MakerKey
    };
    
    console.log("当前授权信息:", licenseInfo);
    return licenseInfo;
}

2. 授权信息设置 ​

javascript
// 设置授权信息
function setLicenseInfo(licenseData) {
    if (licenseData.productCaption && licenseData.productKey) {
        Obj.ProductCaption = licenseData.productCaption;
        Obj.ProductKey = licenseData.productKey;
        console.log("产品授权已设置");
    }
    
    if (licenseData.makerCaption && licenseData.makerKey) {
        Obj.MakerCaption = licenseData.makerCaption;
        Obj.MakerKey = licenseData.makerKey;
        console.log("买断授权已设置");
    }
}

3. 授权验证 ​

javascript
// 验证授权信息
function verifyLicense() {
    var isValid = true;
    
    // 验证产品授权
    if (!Obj.ProductCaption || !Obj.ProductKey) {
        console.log("产品授权信息不完整");
        isValid = false;
    }
    
    // 验证买断授权
    if (!Obj.MakerCaption || !Obj.MakerKey) {
        console.log("买断授权信息不完整");
        isValid = false;
    }
    
    if (isValid) {
        console.log("授权验证通过");
    } else {
        console.log("授权验证失败");
    }
    
    return isValid;
}

注意事项 ​

  1. 授权信息保密：密钥信息属于敏感信息，需要妥善保管
  2. 正式版本：正式版本用户请参考发布包中的使用说明
  3. 唯一性：每个授权都是唯一的，不能重复使用
  4. 完整性：标题和密钥需要配对使用
  5. 版本兼容：不同版本的控件可能需要不同的授权格式
  6. 安全存储：建议将授权信息存储在安全的位置
  7. 错误处理：实现完善的授权验证和错误处理机制

错误处理 ​

javascript
// 授权配置错误处理
function handleLicenseError() {
    try {
        // 设置授权信息
        Obj.ProductCaption = "企业文档管理系统";
        Obj.ProductKey = "ABCD-EFGH-IJKL-MNOP";
        Obj.MakerCaption = "企业版买断授权";
        Obj.MakerKey = "WXYZ-1234-5678-9ABC";
        
        console.log("授权配置成功");
    } catch (error) {
        console.error("授权配置错误:", error.message);
        
        // 重置授权信息
        Obj.ProductCaption = "";
        Obj.ProductKey = "";
        Obj.MakerCaption = "";
        Obj.MakerKey = "";
    }
}

最佳实践 ​

  1. 授权管理：建立完善的授权信息管理系统
  2. 安全存储：将授权信息存储在安全的位置
  3. 版本控制：确保授权信息与控件版本匹配
  4. 错误处理：实现完善的授权验证和错误处理
  5. 文档记录：详细记录授权信息的使用情况
  6. 定期检查：定期检查授权信息的有效性

安全建议 ​

  1. 密钥保护：妥善保护密钥信息，避免泄露
  2. 访问控制：限制对授权信息的访问权限
  3. 加密存储：考虑对敏感信息进行加密存储
  4. 日志记录：记录授权信息的使用日志
  5. 备份管理：建立授权信息的备份机制

Copyright © 2025 软航科技