科怡档案管理软件接口数据结构和说明.doc

科怡档案管理软件接口说明科怡档案管理软件和万户协同办公系统进行数据交换，采用直接写表方式进行，数据交换过程如下：1、 协同办公系统文件归档到科怡系统时，直接写入科怡数据库is_archive的表archive_description_jh的所有字段。2、接口表archive_description_jh数据结构：序号字段名字段定义类型宽度说明1recid系统唯一关键字字符25主键：长度20位，格式为：yyyymmddhhmmss+随机数。例如201607291515045724242archive_no档号字符50格式为：全宗号+归档年度+保管期限+件号例如：内蒙古能建-2016-长期-0083maintitle题名字符255发文标题4archive_flag组卷标识字符6默认已组卷5created_date文件形成时间字符50格式为yyyymmdd，例如：201607296doc_no文件编号字符100文号，例如：内能建投办201527号7object_quantity份数整型0实际份数8security_class密级字符4默认为内部8fonds_no全宗号字符20默认为空10filing_year归档年度整型0文件年度，格式yyyy，例如：201611retention保管期限字符10默认为永久12archive_ctg_no实体分类号字符16默认为空13case_no盒号整型0默认为空14piece_no件号整型0自增顺序号15quantity页数整型0实际页数16responsibleby责任者字符200默认为空17sbt_word主题词字符100默认为空18temp_no临时号字符50默认为空19folder_location存放位置字符100默认为空20pigeonhole_date归档日期时间0格式yyyy-mm-dd 例如：2016-07-29 00:00:00.00021note备注字符255备注信息，默认由协同办公系统导入22archive_entity_status档案实体状态字符6默认为空23departname部门字符50主办部门，例如：办公室插入记录的sql语句示例如下：（在sqlserver下执行通过）INSERT INTO IS_ARCHIVE.dbo.archive_description_jh (recid ,archive_no ,maintitle ,archive_flag ,created_date ,doc_no ,object_quantity ,security_class ,fonds_no ,filing_year ,retention ,archive_ctg_no ,case_no ,piece_no ,quantity ,responsibleby ,sbt_word ,temp_no ,folder_location ,pigeonhole_date ,note ,archive_entity_status ,departname) VALUES(20160729160404379425,-2016-永久-009,关于印发内蒙古能源建设投资（集团）有限公司信息管理制度的通知,已组卷,20160729,内能建投办201527号,1,内部,NULL,2016,永久,NULL,NULL,9,6,NULL,NULL,NULL,NULL,2016-07-29 00:00:00.000,由协同办公系统导入,NULL,办公室)对应的前台界面如图：3、档案记录的原文及附件采用ftp方式上传到相应路径（ftp地址由科怡数据库获取，用户名默认为isa口令默认为isa，上传位置和文件夹名称按说明中的规则建立），档案记录附件信息写入表is_files，多个附件为多条记录。对于协同办公系统中已加密的附件，需要解密后再传入科怡系统。接口表is_files数据结构：序号字段名字段定义类型宽度说明1file_id系统唯一关键字字符25主键：长度20位，格式为：yyyymmddhhmmss+随机数。例如20160728124021508948上传的附件文件名为：file_id +后缀。例如：file_id这条记录对应的文件名为20160728124021508948.doc(.doc为文件后缀名)2tble_name表名字符50默认: archive_description_jh3field_name字段名字符50默认：recid4rec_id记录ID字符25与表archive_description_jh的字段 recid对应。以便查档案记录时，查看对应的附件。archive_description_jh中一条记录可对应is_files的多条记录。5file_name文件名字符100附件文件名：例如内蒙古能源建设档案软件合同.doc6page_no附件顺序号整型4附件顺序号，多个附件时在is_files为多条记录，顺序递增。7file_type文件类型字符10文件类型，存放文件后缀，例如：doc。8open_type打开程序字符255默认为空。9file_len文件大小浮点8度量单位为KB。例如：48表示文件大小为48KB。10file_len_compress浮点8默认为空。11file_loc文件位置字符255文件在ftp服务器上所在的路径，例如：rec_id为20160729151504572424的档案记录，其附件保存在ftp服务器的/archive_description_jh/2016/20160729151504572424/路径。12cd_mark字符100默认为空13file_cd_loc字符255默认为空14user_id用户ID字符25默认：ISA15user_name用户名字符25默认：超级用户16author_id作者ID字符25默认为空17author_name作者姓名字符25默认为空18version_no版本号整型4默认为空19zip_type整型4默认：120encrypt_type整型4默认：121os_position对应os_folder字符100由科怡数据库查询得到后写入：SELECT os_folder ,os_type ,is_osip ,is_userid ,is_password ,is_portFROM IS_ARCHIVE.dbo.is_oslistwhere os_name=default and is_isvalid=122os_type对应os_type整型423osip对应is_osip字符5024ftpuserid对应is_userid字符5025password对应is_password字符5026port对应is_port整型427backup_count整型4默认为空28is_fromcd整型4默认为空29DocDescription字符255默认为：由协同办公系统导入插入记录的sql语句示例如下：（在sqlserver下执行通过，对应的附件需要按要求上传到指定的FTP文件夹，否则附件无法查看内容）INSERT INTO IS_ARCHIVE.dbo.is_files (file_id ,tble_name ,field_name ,rec_id ,file_name ,page_no ,file_type ,open_type ,file_len ,file_len_compress ,file_loc ,cd_mark ,file_cd_loc ,user_id ,user_name ,author_id ,author_name ,version_no ,zip_type ,encrypt_type ,os_position ,os_type ,osip ,ftpuserid ,password ,port ,backup_count ,is_fromcd ,DocDescription) VALUES(20160729173358081627,archive_description_jh,recid,20160729160404379425,关于印发内蒙古能源建设投资（集团）有限公司信息管理制度的通知.doc,1,doc,NULL,198.5,NULL,/archive_description_jh/2016/20160729160404379425/,NULL,NULL,ISA,超级用户,NULL,NULL,NULL,1,1,kyyw,3,,isa,_peA,21,NULL,NULL,由协同办公系统导入)ftp附件文件操作方法：1 获取ftp地址、端口、登录用户名、口令。SELECT os_folder ,os_type ,is_osip ,is_userid ,is_password ,is_portFROM IS_ARCHIVE.dbo.is_oslistwhere os_name=default and is_isvalid=12 登录ftp服务器并建立相应目录。登录： ftp （由is_userid获取）用户名： 默认isa口令： 默认isa进入指定目录： cd /kyyw/archive_description_jh/2016 (目录规则默认/kyyw/archive_description_jh/+年号，年号为要转入科怡系统的文件年份)建立相应目录：mkdir 20160729160404379