集成打印系统的相关接口

集成打印系统的相关接口

一、 DMS提供的接口

1. 关于用户认证接口

根据与客户确认情况，用户登录使用用户名、密码方式进行登录。用户认证接口暂定义为

void UserAuthentication（string account, string password）

参数说明：

account 输入参数 用户登录时在鼎盾打印客户端输入的用户帐户

password 输入参数 用户登录时在鼎盾打印客户端输入的用户密码

课题1：关于密码加密

请提供密码加密算法以及相关密钥。

2. 关于卡号认证接口

用户在刷卡器刷卡后，打印服务器获取刷卡用户的卡号，调用以下接口进行卡号认证

String CardAuthentication(string cardNo)

参数说明：

cardNo 输入参数 卡号

输出参数 该卡号对应的用户帐户

3. 关于打印任务追加接口

用户发起打印任务后，打印服务器接收到打印任务后，调用该接口将该打印任务追加到OA系统中。

该接口暂定义为：

void AddPrintTaskInfo(string account,

string taskID,

string documentName,

int copies,

int pageNumPerCopies,

string securityLevel,

string purpose,

string submitTime)

参数说明：

account 输入参数 发起打印任务的用户帐户

taskID 输入参数 打印任务ID，唯一标识一个打印任务

documentName 输入参数 文档名称

copies 输入参数 份数

pageNumPerCopies 输入参数 每份页数

securityLevel 输入参数 密级

purpose 输入参数 用途

submitTime 输入参数 打印任务发起时间，格式yyyymmdd hh24:mi:ss

4. 关于打印任务追加接口

集成打印系统的相关接口

打印任务被成功输出后，打印服务器将调用以下接口将打印任务日志同步到OA系统中。

void AddPrintTaskLog(string account,

string taskID,

string documentName,

int copies,

int pageNumPerCopies,

string securityLevel,

string purpose,

string submitTime,

string printTime,

string printerName,

int printStatus)

参数说明：

account 输入参数 发起打印任务的用户帐户

taskID 输入参数 打印任务ID，唯一标识一个打印任务

documentName 输入参数 文档名称

copies 输入参数 份数

pageNumPerCopies 输入参数 每份页数

securityLevel 输入参数 密级

purpose 输入参数 用途

submitTime 输入参数 打印任务发起时间，格式yyyymmdd hh24:mi:ss printTime 输入参数 打印任务输出时间，格式yyyymmdd hh24:mi:ss

printerName 输入参数 输出打印机名称

printStatus 输入参数 打印任务处理结果

说明：打印任务处理结果

0x00000100:正常完成打印（正常发送到打印机）

0x00000200:用户强制取消

0x00000800:审批未通过

0x00008000:由于内部处理错误被强制取消

0x00010000:获得打印机信息失败

0x00020000:打印机故障或文档错误

0x00040000:打印机故障

0x00080000:打印机拒绝

0x00100000:用户被删除

0x00200000:用户未激活

0x00400000:打印机删除

0x00800000:打印机关闭

0x01000000:SG认证被关闭

0x02000000:数据库访问错误

0x04000000:读取打印任务内容失败

0x08000000:打印失败

集成打印系统的相关接口

5. 获取当前密级设置

在发起打印任务时，系统自动（WPS文档）或手工选择文档密级，鼎盾打印服务器调用以下接口从OA

获取密级设置：

void GetSecurityLevelConfig(string securityLevelConfig)

参数说明

securityLevelConfig 输出参数 密级配置字符串，每个密级以半角逗号隔开

二、打印方提供的接口

1. 打印任务状态设置接口

打印任务添加完成后，OA系统进行审批等流程，流程完成后，调用鼎盾打印服务器接口设置打印任务状态。

void SetPrintTaskStatus(string taskID, int status)

参数说明

taskID 输入参数 打印任务ID

status 输入参数 打印任务状态

说明：打印任务状态：

0x04:待审批

0x08:待打印

0x10:打印中

0x0200:用户强制取消

0x0800:审批未通过

课题1：关于接口调用后返回失败信息

方案一：通过返回的错误码进行判断、显示。

方案二：通过异常返回错误信息。本次所有接口相关的说明均默认采用该方案进行错误处理。

PS：

1. 如打印任务发起时，还需要其他的数据，请及时说明。

2. 以上所有的接口均以WebService方式提供。