安全电子印章通用属性

注意： 本节所介绍的属性同时适用于服务器版和单机版电子印章。

IsForceCheckSecSignCertCRLOnline

说明：
布尔型；可读写；读取/设置是否强制在线验证安全电子印章绑定的数字证书的CRL列表。

语法：

javascript

// 设置
Obj.IsForceCheckSecSignCertCRLOnline = true;  // 或 false

// 读取
var forceCheckCRL = Obj.IsForceCheckSecSignCertCRLOnline;

使用示例：

javascript

// 启用强制在线CRL验证
Obj.IsForceCheckSecSignCertCRLOnline = true;

// 禁用强制在线CRL验证
Obj.IsForceCheckSecSignCertCRLOnline = false;

console.log("强制CRL验证状态:", Obj.IsForceCheckSecSignCertCRLOnline);

功能说明：

true：强制在线验证证书的CRL（证书撤销列表）
false：不强制在线验证CRL

SetMultiSecSignPosition

说明：
数值型；可读写；读取/设置单侧骑缝章和对称骑缝章在页面上的上中下位置，而不必弹出位置选择对话框。

语法：

javascript

// 设置
Obj.SetMultiSecSignPosition = 0;  // 0, 1, 或 2

// 读取
var position = Obj.SetMultiSecSignPosition;

位置选项：

0：页面偏上
1：页面居中
2：页面偏下

使用示例：

javascript

// 设置骑缝章位置为页面偏上
Obj.SetMultiSecSignPosition = 0;

// 设置骑缝章位置为页面居中
Obj.SetMultiSecSignPosition = 1;

// 设置骑缝章位置为页面偏下
Obj.SetMultiSecSignPosition = 2;

// 完整使用示例
Obj.SetMultiSecSignPosition = 2;  // 骑缝章页面位置：页面偏下
Obj.AddSideSecSignFromEKEY("ntko", 1);

注意：
该属性必须在盖章方法之前设置
该属性必须搭配2015年9月25日以后发布的电子印章版本

IsAddRandomOffsetForMultiSecSign

说明：
数值型；可读写；读取/设置单侧骑缝章和对称骑缝章在页面上的上中下垂直位置是否产生随机偏移。

语法：

javascript

// 设置
Obj.IsAddRandomOffsetForMultiSecSign = true;  // 或 false

// 读取
var randomOffset = Obj.IsAddRandomOffsetForMultiSecSign;

使用示例：

javascript

// 启用随机偏移
Obj.IsAddRandomOffsetForMultiSecSign = true;

// 禁用随机偏移
Obj.IsAddRandomOffsetForMultiSecSign = false;

// 完整使用示例
Obj.SetMultiSecSignPosition = 2;  // 骑缝章页面位置：页面偏下
Obj.IsAddRandomOffsetForMultiSecSign = true;  // 启用随机偏移
Obj.AddSideSecSignFromEKEY("ntko", 1);

注意：
该属性必须在盖章方法之前设置
该属性必须搭配2015年9月25日以后发布的电子印章版本

MultiSecSignMarginSize

说明：
整型；可读写；读取/设置骑缝章签章的打印边距，单位为毫米，取值范围0-10。

语法：

javascript

// 设置
Obj.MultiSecSignMarginSize = 5;  // 0-10

// 读取
var marginSize = Obj.MultiSecSignMarginSize;

使用示例：

javascript

// 设置边距为5毫米
Obj.MultiSecSignMarginSize = 5;

// 设置边距为0毫米（无边距）
Obj.MultiSecSignMarginSize = 0;

// 设置边距为10毫米（最大边距）
Obj.MultiSecSignMarginSize = 10;

console.log("当前边距设置:", Obj.MultiSecSignMarginSize, "毫米");

注意： 该属性必须在盖章方法之前设置

IsAddSignToOddForMultiSecSign

说明：
布尔型；可读写；读取/设置加盖骑缝章时是否在奇数页签章。

语法：

javascript

// 设置
Obj.IsAddSignToOddForMultiSecSign = true;  // 或 false

// 读取
var addToOdd = Obj.IsAddSignToOddForMultiSecSign;

使用示例：

javascript

// 在奇数页签章
Obj.IsAddSignToOddForMultiSecSign = true;

// 不在奇数页签章
Obj.IsAddSignToOddForMultiSecSign = false;

// 完整使用示例
Obj.IsAddSignToOddForMultiSecSign = true;
Obj.AddSideSecSignFromEKEY("ntko", 1);

注意：
该属性必须在盖章方法之前设置
该属性必须搭配2017年11月28日以后发布的电子印章版本

综合使用示例

骑缝章配置

javascript

// 配置骑缝章参数
function configureMultiSecSign() {
    // 设置骑缝章位置（页面偏下）
    Obj.SetMultiSecSignPosition = 2;
    
    // 启用随机偏移
    Obj.IsAddRandomOffsetForMultiSecSign = true;
    
    // 设置边距为3毫米
    Obj.MultiSecSignMarginSize = 3;
    
    // 在奇数页签章
    Obj.IsAddSignToOddForMultiSecSign = true;
    
    console.log("骑缝章配置完成");
}

安全验证配置

javascript

// 配置安全验证参数
function configureSecurityValidation() {
    // 启用强制在线CRL验证
    Obj.IsForceCheckSecSignCertCRLOnline = true;
    
    console.log("安全验证配置完成");
}

完整盖章流程

javascript

// 完整的骑缝章盖章流程
function executeMultiSecSign() {
    try {
        // 1. 设置骑缝章位置
        Obj.SetMultiSecSignPosition = 1;  // 页面居中
        
        // 2. 设置随机偏移
        Obj.IsAddRandomOffsetForMultiSecSign = true;
        
        // 3. 设置边距
        Obj.MultiSecSignMarginSize = 2;  // 2毫米边距
        
        // 4. 设置奇数页签章
        Obj.IsAddSignToOddForMultiSecSign = true;
        
        // 5. 执行骑缝章盖章
        Obj.AddSideSecSignFromEKEY("ntko", 1);
        
        console.log("骑缝章盖章完成");
    } catch (error) {
        console.error("骑缝章盖章失败:", error.message);
    }
}

位置选择器

javascript

// 动态设置骑缝章位置
function setMultiSecSignPosition(position) {
    switch(position) {
        case 'top':
            Obj.SetMultiSecSignPosition = 0;  // 页面偏上
            break;
        case 'center':
            Obj.SetMultiSecSignPosition = 1;  // 页面居中
            break;
        case 'bottom':
            Obj.SetMultiSecSignPosition = 2;  // 页面偏下
            break;
        default:
            console.log("未知位置选项");
            return false;
    }
    
    console.log("骑缝章位置已设置为:", position);
    return true;
}

边距配置器

javascript

// 动态设置边距
function setMarginSize(size) {
    if (size >= 0 && size <= 10) {
        Obj.MultiSecSignMarginSize = size;
        console.log("边距已设置为:", size, "毫米");
        return true;
    } else {
        console.log("边距值必须在0-10毫米之间");
        return false;
    }
}

属性分类总结

分类	属性	功能	类型	取值范围
安全验证	`IsForceCheckSecSignCertCRLOnline`	强制在线CRL验证	Boolean	true/false
位置控制	`SetMultiSecSignPosition`	骑缝章位置	Integer	0-2
偏移控制	`IsAddRandomOffsetForMultiSecSign`	随机偏移	Boolean	true/false
边距控制	`MultiSecSignMarginSize`	打印边距	Integer	0-10毫米
页面控制	`IsAddSignToOddForMultiSecSign`	奇数页签章	Boolean	true/false

骑缝章位置说明

值	位置	说明
0	页面偏上	骑缝章位置在页面上方
1	页面居中	骑缝章位置在页面中间
2	页面偏下	骑缝章位置在页面下方

版本兼容性

属性	最低版本要求	说明
`SetMultiSecSignPosition`	2015年9月25日	骑缝章位置控制
`IsAddRandomOffsetForMultiSecSign`	2015年9月25日	随机偏移功能
`IsAddSignToOddForMultiSecSign`	2017年11月28日	奇数页签章功能

使用流程

1. 属性设置阶段

javascript

// 设置所有骑缝章相关属性
function setupMultiSecSignProperties() {
    // 位置设置
    Obj.SetMultiSecSignPosition = 1;  // 页面居中
    
    // 偏移设置
    Obj.IsAddRandomOffsetForMultiSecSign = true;
    
    // 边距设置
    Obj.MultiSecSignMarginSize = 3;
    
    // 页面设置
    Obj.IsAddSignToOddForMultiSecSign = true;
    
    console.log("骑缝章属性设置完成");
}

2. 安全验证阶段

javascript

// 设置安全验证
function setupSecurityValidation() {
    // 启用强制CRL验证
    Obj.IsForceCheckSecSignCertCRLOnline = true;
    
    console.log("安全验证设置完成");
}

3. 执行盖章阶段

javascript

// 执行骑缝章盖章
function executeSigning() {
    // 调用盖章方法
    Obj.AddSideSecSignFromEKEY("ntko", 1);
    
    console.log("骑缝章盖章执行完成");
}

注意事项

属性设置顺序：所有骑缝章相关属性必须在盖章方法之前设置
版本兼容性：部分属性需要特定版本的电子印章支持
边距范围：MultiSecSignMarginSize的取值范围为0-10毫米
位置选择：SetMultiSecSignPosition支持0-2三个位置选项
随机偏移：IsAddRandomOffsetForMultiSecSign可以增加签章的随机性
奇数页控制：IsAddSignToOddForMultiSecSign控制是否在奇数页签章
CRL验证：IsForceCheckSecSignCertCRLOnline影响证书验证的严格程度

错误处理

javascript

// 骑缝章配置错误处理
function handleMultiSecSignError() {
    try {
        // 设置骑缝章属性
        Obj.SetMultiSecSignPosition = 1;
        Obj.IsAddRandomOffsetForMultiSecSign = true;
        Obj.MultiSecSignMarginSize = 3;
        Obj.IsAddSignToOddForMultiSecSign = true;
        
        console.log("骑缝章配置成功");
    } catch (error) {
        console.error("骑缝章配置错误:", error.message);
        
        // 重置为默认值
        Obj.SetMultiSecSignPosition = 1;
        Obj.IsAddRandomOffsetForMultiSecSign = false;
        Obj.MultiSecSignMarginSize = 0;
        Obj.IsAddSignToOddForMultiSecSign = false;
    }
}

最佳实践

属性预设：在盖章前统一设置所有相关属性
版本检查：确保使用兼容的电子印章版本
位置规划：根据文档内容合理选择骑缝章位置
边距设置：根据打印要求设置合适的边距
安全验证：根据安全要求启用CRL验证
错误处理：实现完善的错误处理机制

安全电子印章通用属性 ​

IsForceCheckSecSignCertCRLOnline ​

SetMultiSecSignPosition ​

IsAddRandomOffsetForMultiSecSign ​

MultiSecSignMarginSize ​

IsAddSignToOddForMultiSecSign ​

综合使用示例 ​

骑缝章配置 ​

安全验证配置 ​

完整盖章流程 ​

位置选择器 ​

边距配置器 ​

属性分类总结 ​

骑缝章位置说明 ​

版本兼容性 ​

使用流程 ​

1. 属性设置阶段 ​

2. 安全验证阶段 ​

3. 执行盖章阶段 ​

注意事项 ​

错误处理 ​

最佳实践 ​

安全电子印章通用属性

IsForceCheckSecSignCertCRLOnline

SetMultiSecSignPosition

IsAddRandomOffsetForMultiSecSign

MultiSecSignMarginSize

IsAddSignToOddForMultiSecSign

综合使用示例

骑缝章配置

安全验证配置

完整盖章流程

位置选择器

边距配置器

属性分类总结

骑缝章位置说明

版本兼容性

使用流程

1. 属性设置阶段

2. 安全验证阶段

3. 执行盖章阶段

注意事项

错误处理

最佳实践