1. 公文服务管理
1.1. 公文对象
1.1.1. 公文待签收对象实例
{
"summaryId" : -7544685618623263599,
"subject" : "测试签收标题",
"importantLevel" : 1,
"startUserId" : 1359726818181166176,
"startUserName" : "测试人员姓名",
"createPerson" : "测试人员姓名",
"issuer" : null,
"signingDate" : null,
"contentType" : 10,
"createTime" : 1573795094000,
"startTime" : 1573795440000,
"completeTime" : 1573795440000,
"summaryDeadline" : -1,
"summaryDeadlineDatetime" : null,
"summaryDeadLineName" : "无",
"summaryIsCoverTime" : false,
"summaryState" : 3,
"summaryTransferStatus" : null,
"summaryTransferStatusName" : "已结束",
"orgAccountId" : 2234457701907909455,
"orgDepartmentId" : null,
"isQuickSend" : false,
"caseId" : 770674455657362079,
"processId" : 4336604878864797075,
"templeteId" : null,
"hasArchive" : false,
"hasArchiveTxt" : null,
"archiveId" : null,
"archiveName" : null,
"govdocType" : 4,
"edocType" : 1,
"docMark" : null,
"docMark2" : null,
"serialNo" : null,
"hastenTimes" : 0,
"exchangeSendAffairId" : null,
"currentNodesInfo" : '已结束',
"printUnit" : null,
"printer" : null,
"copies" : null,
"copies2" : null,
"phone" : null,
"auditor" : null,
"review" : null,
"undertaker" : null,
"undertakenoffice" : null,
"receiveUnit" : null,
"signPerson" : "测试人员姓名",
"signMark" : null,
"distributer" : null,
"packTime" : 1573795440000,
"receiptDate" : null,
"registrationDate" : null,
"secretLevel" : null,
"urgentLevel" : null,
"unitLevel" : null,
"keepPeriod" : null,
"keepPeriodTxt" : null,
"docType" : null,
"sendType" : null,
"sendTo" : null,
"sendTo2" : null,
"sendToId" : null,
"sendToId2" : null,
"copyTo" : null,
"copyTo2" : null,
"copyToId" : null,
"copyToId2" : null,
"reportTo" : null,
"reportTo2" : null,
"reportToId" : null,
"reportToId2" : null,
"sendUnit" : null,
"sendUnit2" : null,
"sendUnitId" : null,
"sendUnitId2" : null,
"sendDepartment" : null,
"sendDepartment2" : null,
"sendDepartmentId" : null,
"sendDepartmentId2" : null,
"affairId" : 7069254775174614776,
"affairState" : 3,
"affairSubState" : 12,
"affairReadState" : 1,
"affairTrack" : 0,
"affairMemberId" : 1359726818181166176,
"affairTransactorId" : null,
"affairNodePolicy" : "oldqianshou",
"affairObjectId" : 2307995958816716320,
"affairSubObjectId" : 6732623812014751600,
"affairActivityId" : null,
"affairArchiveId" : null,
"affairSubject" : "测试签收标题",
"affairForwardMember" : null,
"affairBackFromId" : null,
"affairApp" : 4,
"affairSubApp" : 23,
"affairFinish" : false,
"affairHastenTimes" : null,
"affairIsCoverTime" : false,
"affairRemindDate" : null,
"affairDeadlineDate" : null,
"affairDeadLineName" : "无",
"affairReceiveTime" : 1573795449000,
"affairCompleteTime" : null,
"affairCreateDate" : 1573795449000,
"affairUpdateDate" : 1573795449000,
"affairExpectedProcessTime" : null,
"affairPreApprover" : null,
"affairSenderId" : 1359726818181166176,
"surplusTime" : null,
"hasAtt" : false,
"proxy" : false,
"proxyName" : null,
"agentDeal" : false,
"leaderCommondNo" : null,
"fromType" : 0,
"autoRun" : false,
"proxyMemberId" : null,
"competitionType" : 0
}
1.1.2. 公文待签收对象属性说明
参数 | 说明 |
---|---|
summaryId | 公文ID |
subject | 标题 |
importantLevel | 重要程度 |
startUserId | 发起人ID |
startUserName | 发起人姓名 |
createPerson | 拟稿人姓名 |
issuer | 签发人 |
signingDate | 签发日期 |
contentType | 正文类型 |
createTime | 创建时间 |
startTime | 拟稿日期 |
completeTime | 完成时间 |
summaryDeadline | 流程期限时间段 |
summaryDeadlineDatetime | 流程期限时间点 |
summaryDeadLineName | 流程期限描述 |
summaryIsCoverTime | 流程是否超期 |
summaryState | 流程状态 |
summaryTransferStatus | 公文交换状态 |
summaryTransferStatusName | 公文交换状态描述 |
orgAccountId | 单位ID |
orgDepartmentId | 部门ID |
isQuickSend | 是否快速发文 |
caseId | 流程实例ID |
processId | 流程ID |
templeteId | 模板ID |
hasArchive | 是否归档 |
hasArchiveTxt | 是否归档描述 |
archiveId | 归档ID |
archiveName | 归档路径 |
govdocType | 公文类型 |
edocType | 公文类别 |
docMark | 公文文号 |
docMark2 | 公文文号B |
serialNo | 内部文号 |
hastenTimes | 催办次数 |
exchangeSendAffairId | 分送affairId |
currentNodesInfo | 当前待办人 |
printUnit | 印发单位 |
printer | 打印人 |
copies | 印发分数 |
copies2 | 印发分数B |
phone | 联系电话 |
auditor | 审批人 |
review | 复核人 |
undertaker | 承办人 |
undertakenoffice | 承办机构 |
receiveUnit | 接收单位 |
signPerson | 签收人 |
signMark | 签收编号 |
distributer | 分办人 |
packTime | 分送日期 |
receiptDate | 签收日期 |
registrationDate | 登记日期 |
secretLevel | 密级 |
urgentLevel | 紧急程度 |
unitLevel | 公文级别 |
keepPeriod | 保密期限 |
keepPeriodTxt | 保密期限描述 |
docType | 公文种类 |
sendType | 行文类型 |
sendTo | 主送单位 |
sendTo2 | 主送单位B |
sendToId | 主单位ID |
sendToId2 | 主送单位B ID |
copyTo | 抄送单位 |
copyTo2 | 抄送单位B |
copyToId | 抄送单位ID |
copyToId2 | 抄送单位B ID |
reportTo | 抄报单位 |
reportTo2 | 抄报单位B |
reportToId | 抄报单位ID |
reportToId2 | 抄报单位B ID |
sendUnit | 发文单位 |
sendUnit2 | 发文单位B |
sendUnitId | 发文单位ID |
sendUnitId2 | 发文单位B ID |
sendDepartment | 发文部门 |
sendDepartment2 | 发文部门B |
sendDepartmentId | 发文部门ID |
sendDepartmentId2 | 发文部门B ID |
affairId | 事项ID |
affairState | 事项状态 |
affairSubState | 事项子状态 |
affairReadState | 事项已读状态 |
affairTrack | 跟踪类型 |
affairMemberId | 人员ID |
affairTransactorId | 处理人ID |
affairNodePolicy | 节点权限 |
affairObjectId | 主应用ID |
affairSubObjectId | 对应workitem_id |
affairActivityId | 工作流节点Id |
affairArchiveId | 归档ID |
affairSubject | 标题 |
affairForwardMember | 转发人 |
affairBackFromId | 回退、指定回退,来源人的Id |
affairApp | 应用ID |
affairSubApp | 子应用ID |
affairFinish | 是否结束 |
affairHastenTimes | 催办次数 |
affairIsCoverTime | 是否超期 |
affairRemindDate | 提醒时间 |
affairDeadlineDate | 节点期限 |
affairDeadLineName | 节点期限描述 |
affairReceiveTime | 接收时间 |
affairCompleteTime | 完成时间 |
affairCreateDate | 创建时间 |
affairUpdateDate | 更新时间 |
affairExpectedProcessTime | 预期处理时间点 |
affairPreApprover | 上一处理人 |
affairSenderId | 发起人ID |
surplusTime | 办理剩余时间 |
hasAtt | 是否有附件 |
proxy | 是否代理 |
proxyName | 代理人姓名 |
agentDeal | 被代理人自己处理 |
leaderCommondNo | 领导批示编号展示字段 |
fromType | 公文来源 |
autoRun | 是否自动发起 |
proxyMemberId | 代理ID |
competitionType | 抢单状态 |
1.1.3. 公文待登记对象实例
{
"id" : -1838887671290443796,
"identifier" : "00000000000000000000",
"recieveId" : -8038691098682897209,
"edocId" : -8969186673481202719,
"edocType" : 1,
"registerType" : 1,
"createUserId" : -3941577936688034522,
"createUserName" : "李世民",
"createTime" : 1488880575000,
"updateTime" : 1488880575000,
"sendUnit" : "V61",
"sendUnitId" : 5269865115340261356,
"sendUnitType" : 1,
"edocUnit" : "V61",
"edocUnitId" : "Account|5269865115340261356",
"edocDate" : null,
"registerUserId" : -3941577936688034522,
"registerUserName" : "李世民",
"registerDate" : "2017-03-07",
"issuerId" : -1,
"issuer" : null,
"issueDate" : null,
"signer" : null,
"distributerId" : -3941577936688034522,
"proxy" : false,
"proxyId" : null,
"proxyName" : null,
"proxyLabel" : null,
"proxyUserId" : null,
"distributer" : "李世民",
"distributeDate" : null,
"distributeState" : 1,
"distributeEdocId" : -1,
"subject" : "登记标题",
"docType" : null,
"sendType" : "",
"docMark" : "XX〔2017〕0002号",
"serialNo" : "",
"secretLevel" : "",
"urgentLevel" : "",
"keepPeriod" : null,
"sendTo" : "V61",
"sendToId" : "Account|5269865115340261356",
"copyTo" : null,
"copyToId" : null,
"keywords" : null,
"copies" : null,
"noteAppend" : null,
"attNote" : null,
"state" : 2,
"orgAccountId" : 5269865115340261356,
"recTime" : 1488880575000,
"exchangeType" : 0,
"exchangeOrgId" : 0,
"hasAttachments" : false,
"unitLevel" : null,
"exchangeSendTime" : 1488880567000,
"exchangeMode" : 0,
"attachmentList" : [ ],
"registerBody" : null,
"isRetreat" : 0,
"autoRegister" : 1,
"recieveUserId" : -3941577936688034522,
"recieveUserName" : "李世民",
"new" : false
}
1.1.4. 公文待登记对象属性说明
参数 | 说明 |
---|---|
Id | edoc_register表ID |
identifier | 标志位 |
recieveId | 标志位 |
edocId | 来文公文ID |
edocType | 登记单类型 0发文登记 1收文登记 |
registerType | 登记方式 1电子公文登记 2纸质公文登记 3纸质公文登记 |
createUserId | 创建人ID |
createUserName | 创建人 |
createTime | 创建时间 |
updateTime | 修改时间 |
sendUnit | 来文单位 |
sendUnitId | 来文单位JD |
sendUnitType | 来文类型 1内部单位 2外部单位 |
edocUnit | 成文单位 |
edocUnitId | 成文单位ID |
edocDate | 成文日期 |
registerUserId | 登记人ID |
registerUserName | 登记人 |
registerDate | 登记日期 |
issuerId | 签发人ID |
issuer | 签发人 |
issueDate | 签发日期 |
signer | 会签人 |
distributerId | 分发人ID |
distributer | 分发人 |
distributeState | 分发状态 0草稿箱 1待分发 2已分发 |
distributeEdocId | 分发关联公文ID |
subject | 标题 |
docType | 公文类型 |
sendType | 发文类型 |
docMark | 来文字号 |
serialNo | 收文编号 |
secretLevel | 文件密级 1 普通2 秘密3 机密4 绝密 |
urgentLevel | 紧急程度 1 普通2 平急3 加急4 特急5 特提 |
keepPeriod | 保密期限 |
sendTo | 主送单位 |
sendToId | 主送单位ID |
copyTo | 抄送单位 |
copyToId | 抄送单位ID |
keywords | 主题词 |
copies | 印发份数 |
noteAppend | 附注 |
attNote | 附件说明 |
state | 登记状态 0草稿箱 1待登记 2已登记 3退回给签收 4被退回 5删除 |
orgAccountId | 登记单位 |
recTime | 签收时间 |
exchangeType | 交换类型 |
exchangeOrgId | 交换单位或部门ID |
exchangeMode | 交换模式 0 - 内部(致远)公文交换, 1 - 书生公文交换 |
isRetreat | 是否被退回 0-未回退, 1-回退 |
autoRegister | 是否自动登记 0-否,1-是 |
recieveUserId | 签收人ID |
1.2. 导出公文数据接口(CAP3新公文,老企业公文)
开发者可以通过公文的summaryId和指定导出路径来获取公文信息(包括流程附件)。
注意:在V6.0及其以上版本调用此接口,在获取token时请绑定OA人员登录名。
CTPRestClient client = clientManager.getRestClient();
client.bindUser("{OA人员登录名}");
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/edoc/export
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
String[] summaryid | 是 | 公文summaryid数组 |
folder | 是 | 导出路径 |
返回说明
正常情况下,在指定的folder路径下产生公文单的HTML文件以及样式文件(包括流程附件)。
1.3. 导入公文数据接口(CAP3新公文)
开发者可以通过导入指定xml格式的公文, 转入待签收列表。
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/edoc/import
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
xmlData | 是 | 指定xml格式的公文 |
返回说明
导入正常,返回公文ID。
公文XML数据DEMO:
<?xml version="1.0" encoding="utf-8"?>
<DataPojo type="IEOrganizationInfo" version="1" isnull="false" valuecount="1">
<DataProperty propertyname="documentId" valuetype="3" value="670869647114347"/>
<DataProperty propertyname="docTitle" valuetype="1" isnull="false">标题测试V56sp1222</DataProperty>
<DataProperty propertyname="docCreateTime" valuetype="1" isnull="false">2009-09-23</DataProperty>
<DataProperty propertyname="docCreatePerson" valuetype="1" isnull="false">
<DataPojo type="PersonExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="id" valuetype="1" isnull="false" value="-2833598432627637498">-2833598432627637498</DataProperty>
<DataProperty propertyname="name" valuetype="1" isnull="false">李世民 </DataProperty>
</DataPojo>
</DataProperty>
<DataProperty propertyname="formElementList" valuetype="10" isnull="false" length="1">
<!-- 需要加入发起者单位ID,否则签收报错-->
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">sendAccountId</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">-4532703988283521957</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">sendTo</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">V56SP1</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">sendToId</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">Account|-4532703988283521957</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">docType</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">0</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">docMark</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">mark1</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">secretLevel</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">1</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">urgentLevel</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">1</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">sendUnit</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">V56SP1</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">issuer</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">issuer</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="20" isnull="false">
<DataProperty propertyname="attributeName" valuetype="1" isnull="false">createPerson</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false">李世民</DataProperty>
</DataPojo>
<DataPojo type="DocumentFormExport" version="1" valuecount="5" isnull="false" >
<DataProperty propertyname="elementName" valuetype="1" isnull="false" >印发份数</DataProperty>
<DataProperty propertyname="attributeName" valuetype="1" isnull="false" >copies</DataProperty>
<DataProperty propertyname="id" valuetype="1" isnull="false" ></DataProperty>
<DataProperty propertyname="dataType" valuetype="1" isnull="false" >int</DataProperty>
<DataProperty propertyname="value" valuetype="1" isnull="false" >9</DataProperty>
</DataPojo>
</DataProperty>
</DataPojo>
1.4. 获取公文待签收列表(Since:V61)(CAP3新公文,老企业公文)
开发者可以通过人员ID(公文交换管理员)获取公文待签收列表。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/edocResource/signed?memberId={memberId}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
memberId | 是 | 人员ID |
返回说明
请求正确,返回待签收公文JSON信息。公文待签收对象实例
1.5. 获取公文待登记列表(Since:V61)(老企业公文)
开发者可以通过人员ID(公文交换管理员)获取公文待登记列表。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/edocResource/registered?memberId={memberId}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
memberId | 是 | 人员ID |
返回说明
请求正确,返回待登记公文JSON信息。公文待登记对象实例
1.6. 导出MHT公文单(Since:V61)(CAP3新公文,老企业公文)
开发者可以公文ID(edoc_summary表ID)导出mht格式公文单。
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/edoc/id/exportmht
参数示例:
Map res = new HashMap();
String[] SummaryId={"-7993161577072146191"};
res.put("summaryid", SummaryId);
res.put("folder", "F:\UFSeeyon\folder\");
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
summaryid | 是 | edoc_summary表ID,数组 |
folder | 是 | 导出路径 |
返回说明
请求正确,在指定folder路径下产生公文单HTML与MHT文件。
1.7. 导出公文花脸与正文(Since:V61)(CAP3新公文,老企业公文)
开发者可以公文ID(edoc_summary表ID)导出公文正文与花脸。
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/edocResource/exportFile
参数示例:
Map res = new HashMap();
res.put("summaryid", 7993161577072146191);
res.put("exportType", 0);
res.put("folder", "F:\UFSeeyon\folder\");
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
summaryid | 是 | edoc_summary表ID |
folder | 是 | 导出路径 |
exportType | 是 | 0-全部;1-文单;2-正文(含花脸) |
返回说明
请求正确,在指定folder路径下产生公文单正文与花脸文件。
1.8. 公文签收回执接口(Since:V61)(老企业公文)
外部系统签收公文后向协同平台发送签收回执。
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/edoc/signedoc
参数示例:
String edocSendId="";// edocSendId对应的是edoc_exchange_send_detail表ID
Map res = new HashMap();
res.put("edocSendId", edocSendId);
Map res2 = new HashMap();
res2.put("opinion", "签收意见:OK");//签收意见
res2.put("receipient", "签收人姓名:王凯");//签收人姓名
res2.put("signUnit", "签收单位(部门)名称:政务部");//签收单位名称,如果是部门签收,则为部门名称
res.put("edocSignReceipt", res2);
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
edocSendId | 是 | edoc_exchange_send_detail表ID |
opinion | 否 | 签收意见 |
receipient | 否 | 签收人姓名 |
signUnit | 否 | 签收单位名称 |
返回说明
0未回执成功 1回执成功。