PDF安全电子印章对象接口

概述

本节介绍软航OFFICE文档控件PDF安全电子印章对象接口，这些接口允许开发者通过PDF电子印章通用接口中的GetSign方法返回的对象来访问和操作电子印章的各种属性和方法，为PDF文档管理系统提供完整的电子印章对象控制能力。

注意： 本节所介绍的内容，是通过PDF电子印章通用接口中的GetSign方法返回的对象下的接口。

印章基本信息属性

EkeyLicUser

说明：
String型字符串；只读；返回签章时所用EKEY的授权名称。

语法：

javascript

// 读取
varObj = PdfSignObj.EkeyLicUser;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var ekeyLicUser = pdfSignObj.EkeyLicUser;
    console.log("EKEY授权名称:", ekeyLicUser);
}

EkeySN

说明：
String型字符串；只读；返回签章时所用EKEY的SN序列号。

语法：

javascript

// 读取
varObj = PdfSignObj.EkeySN;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var ekeySN = pdfSignObj.EkeySN;
    console.log("EKEY序列号:", ekeySN);
}

EkeyUser

说明：
String型字符串；只读；返回签章时所用EKEY中所存储的用户名称。

语法：

javascript

// 读取
varObj = PdfSignObj.EkeyUser;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var ekeyUser = pdfSignObj.EkeyUser;
    console.log("EKEY用户名称:", ekeyUser);
}

SignerName

说明：
String型字符串；只读；返回登录印章服务器进行签章操作的用户名。

语法：

javascript

// 读取
varObj = PdfSignObj.SignerName;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signerName = pdfSignObj.SignerName;
    console.log("签章用户名:", signerName);
}

SignName

说明：
String型字符串；只读；返回电子印章名称。

语法：

javascript

// 读取
varObj = PdfSignObj.SignName;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signName = pdfSignObj.SignName;
    console.log("电子印章名称:", signName);
}

SignSN

说明：
String型字符串；只读；返回电子印章的唯一序列号。

语法：

javascript

// 读取
varObj = PdfSignObj.SignSN;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signSN = pdfSignObj.SignSN;
    console.log("电子印章序列号:", signSN);
}

SignUserName

说明：
String型字符串；只读；返回在制作电子印章时填写的印章使用者。

语法：

javascript

// 读取
varObj = PdfSignObj.SignUserName;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signUserName = pdfSignObj.SignUserName;
    console.log("印章使用者:", signUserName);
}

印章时间信息属性

SignTime

说明：
String型字符串；只读；返回签章时间。

语法：

javascript

// 读取
varObj = PdfSignObj.SignTime;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signTime = pdfSignObj.SignTime;
    console.log("签章时间:", signTime);
}

印章位置信息属性

PageNo

说明：
数值型；只读；返回印章所在当前页的页码。

语法：

javascript

// 读取
varObj = PdfSignObj.PageNo;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var pageNo = pdfSignObj.PageNo;
    console.log("印章所在页码:", pageNo);
}

X

说明：
数值型；只读；返回签章位置X坐标。

语法：

javascript

// 读取
varObj = PdfSignObj.X;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var x = pdfSignObj.X;
    console.log("印章X坐标:", x);
}

Y

说明：
数值型；只读；返回签章位置Y坐标。

语法：

javascript

// 读取
varObj = PdfSignObj.Y;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var y = pdfSignObj.Y;
    console.log("印章Y坐标:", y);
}

印章类型信息属性

SignType

说明：
数值型；只读；返回电子印章类型。

语法：

javascript

// 读取
varObj = PdfSignObj.SignType;

返回值及代表类型如下表：

值	类型	说明
0	NtkoSecuritySignNull	空
1	NtkoSecuritySignFile	本地盖章
2	NtkoSecuritySignEkey	EKEY盖章
3	NtkoSecuritySignUrl	服务器URL盖章
4	NtkoSecuritySignHandSign	手写签名
5	NtkoSecuritySignKeyBoard	键盘批注
6	NtkoSecuritySignFingerMark	指纹签章
7	NtkoSecuritySignBarcode	公文二维码
8	NtkoSecuritySignImage	图片签章
9	NtkoSecuritySignEncryptBarcode	加密二维码

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signType = pdfSignObj.SignType;
    console.log("印章类型:", signType);
    
    // 根据印章类型执行不同操作
    switch(signType) {
        case 1:
            console.log("本地盖章");
            break;
        case 2:
            console.log("EKEY盖章");
            break;
        case 3:
            console.log("服务器URL盖章");
            break;
        case 4:
            console.log("手写签名");
            break;
        case 5:
            console.log("键盘批注");
            break;
        default:
            console.log("其他类型印章");
    }
}

MultiPageSignType

说明：
数值型；只读；返回多页签章类型。

语法：

javascript

// 读取
varObj = PdfSignObj.MultiPageSignType;

返回值及代表类型如下表：

值	类型	说明
0	NtkoSignType_single	单页签章
1	NtkoSignType_multi	校核章
2	NtkoSignType_dubleCrossPage	对称骑缝章
3	NtkoSignType_multiCrossPage	单侧骑缝章

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var multiPageSignType = pdfSignObj.MultiPageSignType;
    console.log("多页签章类型:", multiPageSignType);
    
    // 根据多页签章类型执行不同操作
    switch(multiPageSignType) {
        case 0:
            console.log("单页签章");
            break;
        case 1:
            console.log("校核章");
            break;
        case 2:
            console.log("对称骑缝章");
            break;
        case 3:
            console.log("单侧骑缝章");
            break;
        default:
            console.log("未知多页签章类型");
    }
}

印章内容信息属性

SignComment

说明：
String型字符串；只读；返回键盘批注文字内容。

语法：

javascript

// 读取
varObj = PdfSignObj.SignComment;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signComment = pdfSignObj.SignComment;
    console.log("键盘批注内容:", signComment);
}

SignUserData

说明：
String型字符串；只读；返回存储在签章中用户自定义的数据信息。

语法：

javascript

// 读取
varObj = PdfSignObj.SignUserData;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signUserData = pdfSignObj.SignUserData;
    console.log("用户自定义数据:", signUserData);
}

印章控制信息属性

PrintMode

说明：
数值型；只读；返回打印控制类型。0-不打印印章；1-打印灰色印章；2-打印原始印章。

语法：

javascript

// 读取
varObj = PdfSignObj.PrintMode;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var printMode = pdfSignObj.PrintMode;
    console.log("打印控制类型:", printMode);
    
    // 根据打印控制类型执行不同操作
    switch(printMode) {
        case 0:
            console.log("不打印印章");
            break;
        case 1:
            console.log("打印灰色印章");
            break;
        case 2:
            console.log("打印原始印章");
            break;
        default:
            console.log("未知打印控制类型");
    }
}

IsSetPrintCopy

说明：
布尔型；只读；返回是否有使用打印份数控制功能。

语法：

javascript

// 读取
varObj = PdfSignObj.IsSetPrintCopy;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var isSetPrintCopy = pdfSignObj.IsSetPrintCopy;
    console.log("是否使用打印份数控制:", isSetPrintCopy);
}

Tuomi

说明：
String型字符串；可读写；设置/读取印章是否脱密。

语法：

javascript

// 设置
PdfSignObj.Tuomi = {true|false};

// 读取
varObj = PdfSignObj.Tuomi;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    // 读取印章脱密状态
    var tuomi = pdfSignObj.Tuomi;
    console.log("印章脱密状态:", tuomi);
    
    // 设置印章脱密
    pdfSignObj.Tuomi = true;
    console.log("印章已设置为脱密");
}

服务器信息属性

SignGUID

说明：
String型字符串；只读；返回签章时在印章服务器生成的签章日志ID。

语法：

javascript

// 读取
varObj = PdfSignObj.SignGUID;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signGUID = pdfSignObj.SignGUID;
    console.log("签章日志ID:", signGUID);
}

SignServerId

说明：
数值型；只读；返回签章时登录的印章服务器的授权ID。

语法：

javascript

// 读取
varObj = PdfSignObj.SignServerId;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signServerId = pdfSignObj.SignServerId;
    console.log("印章服务器授权ID:", signServerId);
}

SignServerName

说明：
String型字符串；只读；返回签章时登录的印章服务器的名称，即信任服务器里面设置的服务器名。

语法：

javascript

// 读取
varObj = PdfSignObj.SignServerName;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var signServerName = pdfSignObj.SignServerName;
    console.log("印章服务器名称:", signServerName);
}

印章操作方法

ReMoveMe

语法：

javascript

ReMoveMe()

功能：
删除印章。

返回值：
无返回值

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    // 删除印章
    pdfSignObj.ReMoveMe();
    console.log("印章已删除");
}

已过时属性

SN（已过时）

说明：
String型字符串；只读；返回电子印章的唯一序列号。与SignSN相同。

语法：

javascript

// 读取
varObj = PdfSignObj.SN;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var sn = pdfSignObj.SN;
    console.log("电子印章序列号:", sn);
}

UNID（已过时）

说明：
String型字符串；只读；返回签章时在印章服务器生成的签章日志ID。与SignGUID相同。

语法：

javascript

// 读取
varObj = PdfSignObj.UNID;

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;
var pdfSignObj = plugInObj.GetSign(1);

if (pdfSignObj) {
    var unid = pdfSignObj.UNID;
    console.log("签章日志ID:", unid);
}

属性分类总结

分类	属性	类型	功能	说明
基本信息	`EkeyLicUser`	只读	EKEY授权名称	签章时所用EKEY的授权名称
基本信息	`EkeySN`	只读	EKEY序列号	签章时所用EKEY的SN序列号
基本信息	`EkeyUser`	只读	EKEY用户名称	签章时所用EKEY中所存储的用户名称
基本信息	`SignerName`	只读	签章用户名	登录印章服务器进行签章操作的用户名
基本信息	`SignName`	只读	印章名称	电子印章名称
基本信息	`SignSN`	只读	印章序列号	电子印章的唯一序列号
基本信息	`SignUserName`	只读	印章使用者	制作电子印章时填写的印章使用者
时间信息	`SignTime`	只读	签章时间	签章时间
位置信息	`PageNo`	只读	页码	印章所在当前页的页码
位置信息	`X`	只读	X坐标	签章位置X坐标
位置信息	`Y`	只读	Y坐标	签章位置Y坐标
类型信息	`SignType`	只读	印章类型	电子印章类型
类型信息	`MultiPageSignType`	只读	多页签章类型	多页签章类型
内容信息	`SignComment`	只读	批注内容	键盘批注文字内容
内容信息	`SignUserData`	只读	用户数据	存储在签章中用户自定义的数据信息
控制信息	`PrintMode`	只读	打印控制	打印控制类型
控制信息	`IsSetPrintCopy`	只读	打印份数控制	是否有使用打印份数控制功能
控制信息	`Tuomi`	可读写	脱密状态	印章是否脱密
服务器信息	`SignGUID`	只读	签章日志ID	签章时在印章服务器生成的签章日志ID
服务器信息	`SignServerId`	只读	服务器授权ID	签章时登录的印章服务器的授权ID
服务器信息	`SignServerName`	只读	服务器名称	签章时登录的印章服务器的名称
操作方法	`ReRemoveMe`	方法	删除印章	删除印章
已过时	`SN`	只读	印章序列号	电子印章的唯一序列号（已过时）
已过时	`UNID`	只读	签章日志ID	签章时在印章服务器生成的签章日志ID（已过时）

使用流程

1. 基本印章对象管理流程

javascript

// 基本印章对象管理流程
function basicSignObjectManagement() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 获取印章对象信息
    function getSignObjectInfo() {
        var count = plugInObj.GetSignsCount();
        console.log("文档中印章数量:", count);
        
        for (var i = 1; i <= count; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj) {
                console.log("印章" + i + "信息:");
                console.log("签章用户名:", pdfSignObj.SignerName);
                console.log("签章时间:", pdfSignObj.SignTime);
                console.log("印章类型:", pdfSignObj.SignType);
                console.log("印章位置: 第" + pdfSignObj.PageNo + "页 (" + pdfSignObj.X + ", " + pdfSignObj.Y + ")");
            }
        }
    }
    
    // 设置印章脱密
    function setSignTuomi() {
        var count = plugInObj.GetSignsCount();
        
        for (var i = 1; i <= count; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj) {
                pdfSignObj.Tuomi = true;
                console.log("印章" + i + "已设置为脱密");
            }
        }
    }
    
    return {
        getSignObjectInfo: getSignObjectInfo,
        setSignTuomi: setSignTuomi
    };
}

2. 高级印章对象管理流程

javascript

// 高级印章对象管理流程
function advancedSignObjectManagement() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 印章对象管理配置
    var signObjectConfig = {
        enableLogging: true,
        enableValidation: true,
        enableErrorHandling: true,
        enableQualityControl: true
    };
    
    // 应用印章对象配置
    function applySignObjectConfig() {
        try {
            if (signObjectConfig.enableLogging) {
                console.log("印章对象日志已启用");
            }
            
            if (signObjectConfig.enableValidation) {
                console.log("印章对象验证已启用");
            }
            
            console.log("印章对象配置应用成功");
        } catch (error) {
            console.error("印章对象配置应用失败:", error);
        }
    }
    
    // 监控印章对象状态
    function monitorSignObjectStatus() {
        var status = {
            signsCount: plugInObj.GetSignsCount(),
            signObjects: []
        };
        
        for (var i = 1; i <= status.signsCount; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj) {
                status.signObjects.push({
                    index: i,
                    signerName: pdfSignObj.SignerName,
                    signTime: pdfSignObj.SignTime,
                    signType: pdfSignObj.SignType,
                    pageNo: pdfSignObj.PageNo,
                    x: pdfSignObj.X,
                    y: pdfSignObj.Y
                });
            }
        }
        
        console.log("印章对象状态监控:", status);
        return status;
    }
    
    return {
        applySignObjectConfig: applySignObjectConfig,
        monitorSignObjectStatus: monitorSignObjectStatus
    };
}

3. 印章对象质量控制流程

javascript

// 印章对象质量控制流程
function signObjectQualityControl() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 印章对象质量控制
    function controlSignObjectQuality() {
        var signQuality = {
            totalSigns: 0,
            validSigns: 0,
            invalidSigns: 0,
            qualityScore: 0
        };
        
        signQuality.totalSigns = plugInObj.GetSignsCount();
        
        for (var i = 1; i <= signQuality.totalSigns; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj && pdfSignObj.SignerName) {
                signQuality.validSigns++;
            } else {
                signQuality.invalidSigns++;
            }
        }
        
        if (signQuality.totalSigns > 0) {
            signQuality.qualityScore = (signQuality.validSigns / signQuality.totalSigns) * 100;
        }
        
        console.log("印章对象质量控制:", signQuality);
        return signQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlSignObjectQuality();
    console.log("印章对象质量控制结果:", qualityResult);
}

完整示例

1. 基础印章对象管理

javascript

// 基础印章对象管理示例
function basicSignObjectManagement() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 获取印章对象信息
    function getSignObjectInfo() {
        var count = plugInObj.GetSignsCount();
        console.log("文档中印章数量:", count);
        
        for (var i = 1; i <= count; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj) {
                console.log("印章" + i + "信息:");
                console.log("签章用户名:", pdfSignObj.SignerName);
                console.log("签章时间:", pdfSignObj.SignTime);
                console.log("印章类型:", pdfSignObj.SignType);
            }
        }
    }
    
    // 设置印章脱密
    function setSignTuomi() {
        var count = plugInObj.GetSignsCount();
        
        for (var i = 1; i <= count; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj) {
                pdfSignObj.Tuomi = true;
                console.log("印章" + i + "已设置为脱密");
            }
        }
    }
    
    return {
        getSignObjectInfo: getSignObjectInfo,
        setSignTuomi: setSignTuomi
    };
}

2. 高级印章对象管理

javascript

// 高级印章对象管理示例
function advancedSignObjectManagement() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 印章对象管理配置
    var signObjectConfig = {
        enableLogging: true,
        enableValidation: true,
        enableErrorHandling: true,
        enableQualityControl: true
    };
    
    // 应用印章对象配置
    function applySignObjectConfig() {
        if (signObjectConfig.enableLogging) {
            console.log("印章对象日志已启用");
        }
        
        if (signObjectConfig.enableValidation) {
            console.log("印章对象验证已启用");
        }
        
        console.log("印章对象配置应用完成");
    }
    
    // 监控印章对象状态
    function monitorSignObjectStatus() {
        var status = {
            signsCount: plugInObj.GetSignsCount(),
            signObjects: []
        };
        
        for (var i = 1; i <= status.signsCount; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj) {
                status.signObjects.push({
                    index: i,
                    signerName: pdfSignObj.SignerName,
                    signTime: pdfSignObj.SignTime,
                    signType: pdfSignObj.SignType
                });
            }
        }
        
        console.log("印章对象状态:", status);
        return status;
    }
    
    return {
        applySignObjectConfig: applySignObjectConfig,
        monitorSignObjectStatus: monitorSignObjectStatus
    };
}

3. 印章对象质量控制

javascript

// 印章对象质量控制示例
function signObjectQualityControl() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 印章对象质量控制
    function controlSignObjectQuality() {
        var signQuality = {
            totalSigns: 0,
            validSigns: 0,
            invalidSigns: 0,
            qualityScore: 0
        };
        
        signQuality.totalSigns = plugInObj.GetSignsCount();
        
        for (var i = 1; i <= signQuality.totalSigns; i++) {
            var pdfSignObj = plugInObj.GetSign(i);
            if (pdfSignObj && pdfSignObj.SignerName) {
                signQuality.validSigns++;
            } else {
                signQuality.invalidSigns++;
            }
        }
        
        if (signQuality.totalSigns > 0) {
            signQuality.qualityScore = (signQuality.validSigns / signQuality.totalSigns) * 100;
        }
        
        console.log("印章对象质量控制:", signQuality);
        return signQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlSignObjectQuality();
    console.log("印章对象质量控制结果:", qualityResult);
}

注意事项

对象访问：确保在访问印章对象属性前，印章对象已正确获取
属性验证：验证印章对象属性值的有效性，避免空值或无效值
错误处理：实现完善的错误处理机制
性能考虑：避免频繁访问印章对象属性
资源管理：及时清理不需要的资源
状态同步：保持印章对象状态的一致性
用户体验：确保印章对象操作不影响用户体验

错误处理

javascript

// 印章对象错误处理
function handleSignObjectError(propertyType, error) {
    console.error("印章对象处理失败:", propertyType, error.message);
    
    switch(propertyType) {
        case 'SignerName':
            console.log("签章用户名获取失败，请检查:");
            console.log("1. 印章对象是否有效");
            console.log("2. 印章是否存在");
            console.log("3. 文档状态是否正常");
            break;
        case 'SignTime':
            console.log("签章时间获取失败，请检查:");
            console.log("1. 印章对象是否有效");
            console.log("2. 印章时间信息是否存在");
            console.log("3. 文档状态是否正常");
            break;
        case 'ReMoveMe':
            console.log("印章删除失败，请检查:");
            console.log("1. 印章对象是否有效");
            console.log("2. 印章是否可删除");
            console.log("3. 文档状态是否正常");
            break;
        default:
            console.log("未知印章对象处理失败");
    }
}

最佳实践

1. 印章对象管理最佳实践

javascript

// 印章对象管理最佳实践
function signObjectManagementBestPractice() {
    // 印章对象管理配置
    var signObjectConfig = {
        enableLogging: true,
        enableValidation: true,
        enableErrorHandling: true,
        enableQualityControl: true
    };
    
    // 应用印章对象管理配置
    function applySignObjectConfig() {
        try {
            // 设置印章对象管理处理
            if (signObjectConfig.enableLogging) {
                console.log("印章对象管理日志已启用");
            }
            
            if (signObjectConfig.enableValidation) {
                console.log("印章对象验证已启用");
            }
            
            console.log("印章对象管理配置应用成功");
        } catch (error) {
            handleSignObjectError('applySignObjectConfig', error);
        }
    }
    
    // 应用配置
    applySignObjectConfig();
}

2. 印章对象质量控制最佳实践

javascript

// 印章对象质量控制最佳实践
function signObjectQualityControlBestPractice() {
    // 印章对象质量控制
    function controlSignObjectQuality() {
        try {
            // 印章对象质量控制
            var signQuality = {
                totalSigns: 0,
                validSigns: 0,
                invalidSigns: 0,
                qualityScore: 0
            };
            
            // 计算质量分数
            if (signQuality.totalSigns > 0) {
                signQuality.qualityScore = (signQuality.validSigns / signQuality.totalSigns) * 100;
            }
            
            console.log("印章对象质量控制完成:", signQuality);
            return signQuality;
        } catch (error) {
            console.error("印章对象质量控制失败:", error.message);
            return null;
        }
    }
    
    // 执行质量控制
    var qualityResult = controlSignObjectQuality();
    console.log("印章对象质量控制结果:", qualityResult);
}

技术要点

对象访问：确保在访问印章对象属性前，印章对象已正确获取
属性验证：验证印章对象属性值的有效性，避免空值或无效值
错误处理：完善的错误处理机制
性能优化：避免频繁访问印章对象属性
资源管理：及时清理不需要的资源
状态同步：保持印章对象状态的一致性
用户体验：确保印章对象操作不影响用户体验

PDF安全电子印章对象接口 ​

概述 ​

印章基本信息属性 ​

EkeyLicUser ​

EkeySN ​

EkeyUser ​

SignerName ​

SignName ​

SignSN ​

SignUserName ​

印章时间信息属性 ​

SignTime ​

印章位置信息属性 ​

PageNo ​

X ​

Y ​

印章类型信息属性 ​

SignType ​

MultiPageSignType ​

印章内容信息属性 ​

SignComment ​

SignUserData ​

印章控制信息属性 ​

PrintMode ​

IsSetPrintCopy ​

Tuomi ​

服务器信息属性 ​

SignGUID ​

SignServerId ​

SignServerName ​

印章操作方法 ​

ReMoveMe ​

已过时属性 ​

SN（已过时） ​

UNID（已过时） ​

属性分类总结 ​

使用流程 ​

1. 基本印章对象管理流程 ​

2. 高级印章对象管理流程 ​

3. 印章对象质量控制流程 ​

完整示例 ​

1. 基础印章对象管理 ​

2. 高级印章对象管理 ​

3. 印章对象质量控制 ​

注意事项 ​

错误处理 ​

最佳实践 ​

1. 印章对象管理最佳实践 ​

2. 印章对象质量控制最佳实践 ​

技术要点 ​

PDF安全电子印章对象接口

概述

印章基本信息属性

EkeyLicUser

EkeySN

EkeyUser

SignerName

SignName

SignSN

SignUserName

印章时间信息属性

SignTime

印章位置信息属性

PageNo

X

Y

印章类型信息属性

SignType

MultiPageSignType

印章内容信息属性

SignComment

SignUserData

印章控制信息属性

PrintMode

IsSetPrintCopy

Tuomi

服务器信息属性

SignGUID

SignServerId

SignServerName

印章操作方法

ReMoveMe

已过时属性

SN（已过时）

UNID（已过时）

属性分类总结

使用流程

1. 基本印章对象管理流程

2. 高级印章对象管理流程

3. 印章对象质量控制流程

完整示例

1. 基础印章对象管理

2. 高级印章对象管理

3. 印章对象质量控制

注意事项

错误处理

最佳实践

1. 印章对象管理最佳实践

2. 印章对象质量控制最佳实践

技术要点