Alfresco Records Management定时任务动作创建及属性修改咨询

一、Java Bean实现方式需修改的属性 #

1. 定时调度核心属性（Quartz集成） #

• jobDetail：关联自定义Job实现类的全路径，例如com.yourorg.alfresco.jobs.RecordDeclareJob，确保类继承org.quartz.Job并实现execute方法
• trigger：配置触发规则的关键子属性：
  • cronExpression：定义触发时间，比如工作日凌晨1点执行写0 0 1 ? * MON-FRI，特定时间段（如每月1号10点）写0 0 10 1 * ?
  • name/group：设置唯一标识，避免与其他定时任务冲突
• schedulerFactoryBean：在triggers属性中加入上述定义的trigger bean，确保任务注册到Alfresco调度器

2. 归档动作关联属性 #

• recordService：注入RM模块的org.alfresco.module.org_alfresco_module_rm.service.RecordService bean，用于执行文档转记录的核心操作
• searchQuery：配置CMIS查询语句筛选目标文档，例如SELECT * FROM cm:document WHERE cmis:lastModificationDate < TIMESTAMP '2024-01-01T00:00:00' AND NOT cmis:objectId IN (SELECT cmis:objectId FROM rma:record)
• targetRecordFolderRef：指定归档文档存放的文件计划文件夹NodeRef，需通过filePlanService获取或直接硬编码（生产环境建议配置在属性文件）

二、自定义XML脚本（Data Dictionary）方式需修改的属性 #

1. 定时触发配置（schedule节点内） #

• cron：同Java Bean的cronExpression，设置触发时间规则
• script-ref：指向Data Dictionary中脚本的完整路径，例如/Company Home/Data Dictionary/Scripts/declare-records.groovy

2. 脚本内关键配置属性 #

• search.query：编写Lucene或CMIS查询筛选待归档文档，需排除已归档记录：+TYPE:"cm:document" -ASPECT:"rma:record" +@cm\:created:[NOW-1YEAR TO NOW-30DAY]
• recordManager.declareRecord：调用RM API时，指定recordFolder参数（目标归档文件夹NodeRef），可选fileAs参数定义归档命名规则
• logger：配置日志输出，例如logger.info("Successfully declared " + nodes.size() + " documents as records")，便于排查执行情况

三、必配权限与事务属性 #

• runAsUser：Java Bean方式可配置该属性指定任务运行用户，需确保用户拥有目标文档的编辑权限和RM模块的rma:declareRecord权限
• transactionManager：Java Bean任务需关联Alfresco的事务管理器，避免操作失败导致数据不一致
• lockService：添加节点锁逻辑，防止同一文档被重复归档，例如通过lockService.lock(nodeRef, LockType.WRITE_LOCK)

内容的提问来源于stack exchange，提问作者Yahya SGHIOURI