mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-07-31 17:39:05 +00:00
Merge RM-2526 Blended disposition schedule into release/V2.4.
This commit is contained in:
@@ -39,12 +39,6 @@
|
|||||||
|
|
||||||
<bean id="RecordsManagementServiceRegistry" class="org.alfresco.module.org_alfresco_module_rm.RecordsManagementServiceRegistryImpl" />
|
<bean id="RecordsManagementServiceRegistry" class="org.alfresco.module.org_alfresco_module_rm.RecordsManagementServiceRegistryImpl" />
|
||||||
|
|
||||||
<!-- Disposition selection strategy -->
|
|
||||||
<bean id="org_alfresco_module_rm_dispositionSelectionStrategy"
|
|
||||||
class="org.alfresco.module.org_alfresco_module_rm.disposition.DispositionSelectionStrategy" >
|
|
||||||
<property name="dispositionService" ref="dispositionService"/>
|
|
||||||
</bean>
|
|
||||||
|
|
||||||
<!-- Vital Record Service -->
|
<!-- Vital Record Service -->
|
||||||
|
|
||||||
<bean id="vitalRecordService" parent="baseService" class="org.alfresco.module.org_alfresco_module_rm.vital.VitalRecordServiceImpl">
|
<bean id="vitalRecordService" parent="baseService" class="org.alfresco.module.org_alfresco_module_rm.vital.VitalRecordServiceImpl">
|
||||||
@@ -96,9 +90,6 @@
|
|||||||
<property name="recordFolderService" ref="RecordFolderService"/>
|
<property name="recordFolderService" ref="RecordFolderService"/>
|
||||||
<property name="recordService" ref="RecordService"/>
|
<property name="recordService" ref="RecordService"/>
|
||||||
<property name="freezeService" ref="FreezeService"/>
|
<property name="freezeService" ref="FreezeService"/>
|
||||||
<property name="dispositionSelectionStrategy">
|
|
||||||
<ref local="org_alfresco_module_rm_dispositionSelectionStrategy" />
|
|
||||||
</property>
|
|
||||||
</bean>
|
</bean>
|
||||||
|
|
||||||
<bean id="DispositionService" class="org.springframework.aop.framework.ProxyFactoryBean">
|
<bean id="DispositionService" class="org.springframework.aop.framework.ProxyFactoryBean">
|
||||||
@@ -139,6 +130,7 @@
|
|||||||
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.registerDispositionProperty=RM_ALLOW
|
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.registerDispositionProperty=RM_ALLOW
|
||||||
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getDispositionProperties=RM_ALLOW
|
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getDispositionProperties=RM_ALLOW
|
||||||
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getDispositionSchedule=RM.Read.0
|
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getDispositionSchedule=RM.Read.0
|
||||||
|
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getOriginDispositionSchedule=RM.Read.0
|
||||||
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getAssociatedDispositionSchedule=RM.Read.0
|
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getAssociatedDispositionSchedule=RM.Read.0
|
||||||
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getAssociatedRecordsManagementContainer=RM_ALLOW
|
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.getAssociatedRecordsManagementContainer=RM_ALLOW
|
||||||
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.hasDisposableItems=RM_ALLOW
|
org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService.hasDisposableItems=RM_ALLOW
|
||||||
|
@@ -243,6 +243,17 @@ public interface DispositionService
|
|||||||
*/
|
*/
|
||||||
void refreshDispositionAction(NodeRef nodeRef);
|
void refreshDispositionAction(NodeRef nodeRef);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gets date of the disposition action for the given
|
||||||
|
* disposition schedule with the given action name
|
||||||
|
*
|
||||||
|
* @param record
|
||||||
|
* @param dispositionSchedule nodeRef
|
||||||
|
* @param dispositionActionName
|
||||||
|
* @return date
|
||||||
|
*/
|
||||||
|
Date getDispositionActionDate(NodeRef record, NodeRef dispositionSchedule, String dispositionActionName);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Compute the "disposition as of" date (if necessary) for a disposition action and a node.
|
* Compute the "disposition as of" date (if necessary) for a disposition action and a node.
|
||||||
*
|
*
|
||||||
@@ -253,4 +264,13 @@ public interface DispositionService
|
|||||||
*/
|
*/
|
||||||
Date calculateAsOfDate(NodeRef nodeRef, DispositionActionDefinition dispositionActionDefinition,
|
Date calculateAsOfDate(NodeRef nodeRef, DispositionActionDefinition dispositionActionDefinition,
|
||||||
boolean allowContextFromAsOf);
|
boolean allowContextFromAsOf);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gets the origin disposition schedule for the record, not the calculated one
|
||||||
|
* in case of multiple dispositions applied to record
|
||||||
|
*
|
||||||
|
* @param nodeRef record
|
||||||
|
* @return the initial disposition
|
||||||
|
*/
|
||||||
|
DispositionSchedule getOriginDispositionSchedule(NodeRef nodeRef);
|
||||||
}
|
}
|
||||||
|
@@ -36,6 +36,7 @@ import java.util.List;
|
|||||||
import java.util.Map;
|
import java.util.Map;
|
||||||
|
|
||||||
import org.alfresco.error.AlfrescoRuntimeException;
|
import org.alfresco.error.AlfrescoRuntimeException;
|
||||||
|
import org.alfresco.model.ContentModel;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementPolicies;
|
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementPolicies;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementServiceRegistry;
|
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementServiceRegistry;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.disposition.property.DispositionProperty;
|
import org.alfresco.module.org_alfresco_module_rm.disposition.property.DispositionProperty;
|
||||||
@@ -47,6 +48,7 @@ import org.alfresco.module.org_alfresco_module_rm.model.RecordsManagementModel;
|
|||||||
import org.alfresco.module.org_alfresco_module_rm.record.RecordService;
|
import org.alfresco.module.org_alfresco_module_rm.record.RecordService;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.recordfolder.RecordFolderService;
|
import org.alfresco.module.org_alfresco_module_rm.recordfolder.RecordFolderService;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.util.ServiceBaseImpl;
|
import org.alfresco.module.org_alfresco_module_rm.util.ServiceBaseImpl;
|
||||||
|
import org.alfresco.repo.dictionary.types.period.Immediately;
|
||||||
import org.alfresco.repo.policy.BehaviourFilter;
|
import org.alfresco.repo.policy.BehaviourFilter;
|
||||||
import org.alfresco.repo.policy.annotation.Behaviour;
|
import org.alfresco.repo.policy.annotation.Behaviour;
|
||||||
import org.alfresco.repo.policy.annotation.BehaviourBean;
|
import org.alfresco.repo.policy.annotation.BehaviourBean;
|
||||||
@@ -79,15 +81,26 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
/** Logger */
|
/** Logger */
|
||||||
private static final Logger LOGGER = LoggerFactory.getLogger(DispositionServiceImpl.class);
|
private static final Logger LOGGER = LoggerFactory.getLogger(DispositionServiceImpl.class);
|
||||||
|
|
||||||
|
/** Transaction mode for setting next action */
|
||||||
|
public enum WriteMode
|
||||||
|
{
|
||||||
|
/** Do not update any data. */
|
||||||
|
READ_ONLY,
|
||||||
|
/** Only set the "disposition as of" date. */
|
||||||
|
DATE_ONLY,
|
||||||
|
/**
|
||||||
|
* Set the "disposition as of" date and the name of the next action. This only happens during the creation of a
|
||||||
|
* disposition schedule impl node under a record or folder.
|
||||||
|
*/
|
||||||
|
DATE_AND_NAME
|
||||||
|
};
|
||||||
|
|
||||||
/** Behaviour filter */
|
/** Behaviour filter */
|
||||||
private BehaviourFilter behaviourFilter;
|
private BehaviourFilter behaviourFilter;
|
||||||
|
|
||||||
/** Records management service registry */
|
/** Records management service registry */
|
||||||
private RecordsManagementServiceRegistry serviceRegistry;
|
private RecordsManagementServiceRegistry serviceRegistry;
|
||||||
|
|
||||||
/** Disposition selection strategy */
|
|
||||||
private DispositionSelectionStrategy dispositionSelectionStrategy;
|
|
||||||
|
|
||||||
/** File plan service */
|
/** File plan service */
|
||||||
private FilePlanService filePlanService;
|
private FilePlanService filePlanService;
|
||||||
|
|
||||||
@@ -177,16 +190,6 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
this.freezeService = freezeService;
|
this.freezeService = freezeService;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Set the dispositionSelectionStrategy bean.
|
|
||||||
*
|
|
||||||
* @param dispositionSelectionStrategy
|
|
||||||
*/
|
|
||||||
public void setDispositionSelectionStrategy(DispositionSelectionStrategy dispositionSelectionStrategy)
|
|
||||||
{
|
|
||||||
this.dispositionSelectionStrategy = dispositionSelectionStrategy;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Behavior to initialize the disposition schedule of a newly filed record.
|
* Behavior to initialize the disposition schedule of a newly filed record.
|
||||||
*
|
*
|
||||||
@@ -276,31 +279,56 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
* @see org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService#getDispositionSchedule(org.alfresco.service.cmr.repository.NodeRef)
|
* @see org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService#getDispositionSchedule(org.alfresco.service.cmr.repository.NodeRef)
|
||||||
*/
|
*/
|
||||||
@Override
|
@Override
|
||||||
public DispositionSchedule getDispositionSchedule(NodeRef nodeRef)
|
public DispositionSchedule getDispositionSchedule(final NodeRef nodeRef)
|
||||||
{
|
{
|
||||||
DispositionSchedule di = null;
|
DispositionSchedule ds = null;
|
||||||
NodeRef diNodeRef = null;
|
NodeRef dsNodeRef = null;
|
||||||
if (isRecord(nodeRef))
|
if (isRecord(nodeRef))
|
||||||
{
|
{
|
||||||
// Get the record folders for the record
|
final NextActionFromDisposition dsNextAction = getDispositionActionByNameForRecord(nodeRef);
|
||||||
List<NodeRef> recordFolders = recordFolderService.getRecordFolders(nodeRef);
|
|
||||||
// At this point, we may have disposition instruction objects from 1..n folders.
|
if (dsNextAction != null)
|
||||||
diNodeRef = dispositionSelectionStrategy.selectDispositionScheduleFrom(recordFolders);
|
{
|
||||||
|
if (!dsNextAction.getWriteMode().equals(WriteMode.READ_ONLY))
|
||||||
|
{
|
||||||
|
final NodeRef action = dsNextAction.getNextActionNodeRef();
|
||||||
|
final String dispositionActionName = dsNextAction.getNextActionName();
|
||||||
|
final Date dispositionActionDate = dsNextAction.getNextActionDateAsOf();
|
||||||
|
|
||||||
|
AuthenticationUtil.runAsSystem(new RunAsWork<Void>()
|
||||||
|
{
|
||||||
|
@Override
|
||||||
|
public Void doWork()
|
||||||
|
{
|
||||||
|
nodeService.setProperty(action, PROP_DISPOSITION_AS_OF, dispositionActionDate);
|
||||||
|
if (dsNextAction.getWriteMode().equals(WriteMode.DATE_AND_NAME))
|
||||||
|
{
|
||||||
|
nodeService.setProperty(action, PROP_DISPOSITION_ACTION_NAME, dispositionActionName);
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
dsNodeRef = dsNextAction.getDispositionNodeRef();
|
||||||
|
}
|
||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
// Get the disposition instructions for the node reference provided
|
// Get the disposition instructions for the node reference provided
|
||||||
diNodeRef = getDispositionScheduleImpl(nodeRef);
|
dsNodeRef = getDispositionScheduleImpl(nodeRef);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (diNodeRef != null)
|
if (dsNodeRef != null)
|
||||||
{
|
{
|
||||||
di = new DispositionScheduleImpl(serviceRegistry, nodeService, diNodeRef);
|
ds = new DispositionScheduleImpl(serviceRegistry, nodeService, dsNodeRef);
|
||||||
}
|
}
|
||||||
|
|
||||||
return di;
|
return ds;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* This method returns a NodeRef
|
* This method returns a NodeRef
|
||||||
* Gets the disposition instructions
|
* Gets the disposition instructions
|
||||||
@@ -323,6 +351,28 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
return result;
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public DispositionSchedule getOriginDispositionSchedule(NodeRef nodeRef)
|
||||||
|
{
|
||||||
|
NodeRef parent = this.nodeService.getPrimaryParent(nodeRef).getParentRef();
|
||||||
|
if (parent != null)
|
||||||
|
{
|
||||||
|
if (filePlanService.isRecordCategory(parent))
|
||||||
|
{
|
||||||
|
NodeRef result = getAssociatedDispositionScheduleImpl(parent);
|
||||||
|
if (result == null)
|
||||||
|
{
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return new DispositionScheduleImpl(serviceRegistry, nodeService, result);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return getOriginDispositionSchedule(parent);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService#getAssociatedDispositionSchedule(org.alfresco.service.cmr.repository.NodeRef)
|
* @see org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService#getAssociatedDispositionSchedule(org.alfresco.service.cmr.repository.NodeRef)
|
||||||
*/
|
*/
|
||||||
@@ -629,8 +679,14 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
* @param dispositionActionDefinition disposition action definition
|
* @param dispositionActionDefinition disposition action definition
|
||||||
* @param allowContextFromAsOf true if the context date is allowed to be obtained from the disposition "as of" property.
|
* @param allowContextFromAsOf true if the context date is allowed to be obtained from the disposition "as of" property.
|
||||||
*/
|
*/
|
||||||
private void initialiseDispositionAction(NodeRef nodeRef, DispositionActionDefinition dispositionActionDefinition, boolean allowContextFromAsOf)
|
private DispositionAction initialiseDispositionAction(NodeRef nodeRef, DispositionActionDefinition dispositionActionDefinition, boolean allowContextFromAsOf)
|
||||||
{
|
{
|
||||||
|
List<ChildAssociationRef> childAssocs = nodeService.getChildAssocs(nodeRef, ASSOC_NEXT_DISPOSITION_ACTION, ASSOC_NEXT_DISPOSITION_ACTION, 1, true);
|
||||||
|
if (childAssocs != null && childAssocs.size() > 0)
|
||||||
|
{
|
||||||
|
return new DispositionActionImpl(serviceRegistry, childAssocs.get(0).getChildRef());
|
||||||
|
}
|
||||||
|
|
||||||
// Create the properties
|
// Create the properties
|
||||||
Map<QName, Serializable> props = new HashMap<QName, Serializable>(10);
|
Map<QName, Serializable> props = new HashMap<QName, Serializable>(10);
|
||||||
|
|
||||||
@@ -660,6 +716,7 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
// For every event create an entry on the action
|
// For every event create an entry on the action
|
||||||
da.addEventCompletionDetails(event);
|
da.addEventCompletionDetails(event);
|
||||||
}
|
}
|
||||||
|
return da;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -692,9 +749,16 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
}
|
}
|
||||||
else
|
else
|
||||||
{
|
{
|
||||||
// for now use 'NOW' as the default context date
|
if (period.getPeriodType().equals(Immediately.PERIOD_TYPE))
|
||||||
// TODO set the default period property ... cut off date or last disposition date depending on context
|
{
|
||||||
contextDate = new Date();
|
contextDate = (Date)nodeService.getProperty(nodeRef, ContentModel.PROP_CREATED);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
// for now use 'NOW' as the default context date
|
||||||
|
// TODO set the default period property ... cut off date or last disposition date depending on context
|
||||||
|
contextDate = new Date();
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Calculate the as of date
|
// Calculate the as of date
|
||||||
@@ -905,6 +969,7 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
// Get the current action
|
// Get the current action
|
||||||
String currentADId = (String) nodeService.getProperty(currentDispositionAction, PROP_DISPOSITION_ACTION_ID);
|
String currentADId = (String) nodeService.getProperty(currentDispositionAction, PROP_DISPOSITION_ACTION_ID);
|
||||||
currentDispositionActionDefinition = di.getDispositionActionDefinition(currentADId);
|
currentDispositionActionDefinition = di.getDispositionActionDefinition(currentADId);
|
||||||
|
|
||||||
// When the record has multiple disposition schedules the current disposition action may not be found by id
|
// When the record has multiple disposition schedules the current disposition action may not be found by id
|
||||||
// In this case it will be searched by name
|
// In this case it will be searched by name
|
||||||
if(currentDispositionActionDefinition == null)
|
if(currentDispositionActionDefinition == null)
|
||||||
@@ -999,6 +1064,24 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public Date getDispositionActionDate(NodeRef record, NodeRef dispositionSchedule, String dispositionActionName)
|
||||||
|
{
|
||||||
|
DispositionSchedule ds = new DispositionScheduleImpl(serviceRegistry, nodeService, dispositionSchedule);
|
||||||
|
List<ChildAssociationRef> assocs = nodeService.getChildAssocs(dispositionSchedule);
|
||||||
|
if (assocs != null && assocs.size() > 0)
|
||||||
|
{
|
||||||
|
for (ChildAssociationRef assoc : assocs)
|
||||||
|
{
|
||||||
|
if (assoc != null && assoc.getQName().getLocalName().contains(dispositionActionName))
|
||||||
|
{
|
||||||
|
DispositionActionDefinition actionDefinition = ds.getDispositionActionDefinition(assoc.getChildRef().getId());
|
||||||
|
return calculateAsOfDate(record, actionDefinition, true);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Helper method to determine if a node is frozen or has frozen children
|
* Helper method to determine if a node is frozen or has frozen children
|
||||||
*
|
*
|
||||||
@@ -1046,4 +1129,162 @@ public class DispositionServiceImpl extends ServiceBaseImpl
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Calculate next disposition action for a record
|
||||||
|
*
|
||||||
|
* @param record
|
||||||
|
* @return next disposition action (name, date) and the disposition associated
|
||||||
|
*/
|
||||||
|
|
||||||
|
protected NextActionFromDisposition getDispositionActionByNameForRecord(NodeRef record)
|
||||||
|
{
|
||||||
|
List<NodeRef> recordFolders = recordFolderService.getRecordFolders(record);
|
||||||
|
DispositionAction nextDispositionAction = getNextDispositionAction(record);
|
||||||
|
|
||||||
|
if (nextDispositionAction == null)
|
||||||
|
{
|
||||||
|
return getFirstDispositionAction(record, recordFolders);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return getNextDispositionAction(record, recordFolders, nextDispositionAction);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Calculate next disposition action when the record already has one
|
||||||
|
* @param recordFolders
|
||||||
|
* @param nextDispositionAction
|
||||||
|
* @return next disposition action and the associated disposition schedule
|
||||||
|
*/
|
||||||
|
private NextActionFromDisposition getNextDispositionAction(NodeRef record, List<NodeRef> recordFolders, DispositionAction nextDispositionAction)
|
||||||
|
{
|
||||||
|
String recordNextDispositionActionName = nextDispositionAction.getName();
|
||||||
|
Date recordNextDispositionActionDate = nextDispositionAction.getAsOfDate();
|
||||||
|
// We're looking for the latest date, so initially start with a very early one.
|
||||||
|
Date nextDispositionActionDate = new Date(Long.MIN_VALUE);
|
||||||
|
NodeRef dispositionNodeRef = null;
|
||||||
|
|
||||||
|
// Find the latest "disposition as of" date from all the schedules this record is subject to.
|
||||||
|
for (NodeRef folder : recordFolders)
|
||||||
|
{
|
||||||
|
NodeRef dsNodeRef = getDispositionScheduleImpl(folder);
|
||||||
|
if (dsNodeRef != null)
|
||||||
|
{
|
||||||
|
Date dispActionDate = getDispositionActionDate(record, dsNodeRef, recordNextDispositionActionName);
|
||||||
|
if (dispActionDate == null || (nextDispositionActionDate != null
|
||||||
|
&& nextDispositionActionDate.before(dispActionDate)))
|
||||||
|
{
|
||||||
|
nextDispositionActionDate = dispActionDate;
|
||||||
|
dispositionNodeRef = dsNodeRef;
|
||||||
|
if (dispActionDate == null)
|
||||||
|
{
|
||||||
|
// Treat null as the latest date possible (so stop searching further).
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (dispositionNodeRef == null)
|
||||||
|
{
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
WriteMode mode = determineWriteMode(recordNextDispositionActionDate, nextDispositionActionDate);
|
||||||
|
|
||||||
|
return new NextActionFromDisposition(dispositionNodeRef, nextDispositionAction.getNodeRef(),
|
||||||
|
recordNextDispositionActionName, nextDispositionActionDate, mode);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Determine what should be updated for an existing disposition schedule impl. We only update the date if the
|
||||||
|
* existing date is earlier than the calculated one.
|
||||||
|
*
|
||||||
|
* @param recordNextDispositionActionDate The next action date found on the record node (or folder node).
|
||||||
|
* @param nextDispositionActionDate The next action date calculated from the current disposition schedule(s)
|
||||||
|
* affecting the node.
|
||||||
|
* @return READ_ONLY if nothing should be updated, or DATE_ONLY if the date needs updating.
|
||||||
|
*/
|
||||||
|
private WriteMode determineWriteMode(Date recordNextDispositionActionDate, Date nextDispositionActionDate)
|
||||||
|
{
|
||||||
|
// Treat null dates as being the latest possible date.
|
||||||
|
Date maxDate = new Date(Long.MAX_VALUE);
|
||||||
|
Date recordDate = (recordNextDispositionActionDate != null ? recordNextDispositionActionDate : maxDate);
|
||||||
|
Date calculatedDate = (nextDispositionActionDate != null ? nextDispositionActionDate : maxDate);
|
||||||
|
|
||||||
|
// We only need to update the date if the current one is too early.
|
||||||
|
if (recordDate.before(calculatedDate))
|
||||||
|
{
|
||||||
|
return WriteMode.DATE_ONLY;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return WriteMode.READ_ONLY;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Calculate first disposition action when the record doesn't have one
|
||||||
|
* @param recordFolders
|
||||||
|
* @return next disposition action and the associated disposition schedule
|
||||||
|
*/
|
||||||
|
private NextActionFromDisposition getFirstDispositionAction(NodeRef record, List<NodeRef> recordFolders)
|
||||||
|
{
|
||||||
|
NodeRef newAction = null;
|
||||||
|
String newDispositionActionName = null;
|
||||||
|
// We're looking for the latest date, so start with a very early one.
|
||||||
|
Date newDispositionActionDateAsOf = new Date(Long.MIN_VALUE);
|
||||||
|
NodeRef dispositionNodeRef = null;
|
||||||
|
for (NodeRef folder : recordFolders)
|
||||||
|
{
|
||||||
|
NodeRef folderDS = getDispositionScheduleImpl(folder);
|
||||||
|
if (folderDS != null)
|
||||||
|
{
|
||||||
|
DispositionSchedule ds = new DispositionScheduleImpl(serviceRegistry, nodeService, folderDS);
|
||||||
|
List<DispositionActionDefinition> dispositionActionDefinitions = ds.getDispositionActionDefinitions();
|
||||||
|
|
||||||
|
if (dispositionActionDefinitions != null && dispositionActionDefinitions.size() > 0)
|
||||||
|
{
|
||||||
|
DispositionActionDefinition firstDispositionActionDef = dispositionActionDefinitions.get(0);
|
||||||
|
dispositionNodeRef = folderDS;
|
||||||
|
|
||||||
|
if (newAction == null)
|
||||||
|
{
|
||||||
|
NodeRef recordOrFolder = record;
|
||||||
|
if (!ds.isRecordLevelDisposition())
|
||||||
|
{
|
||||||
|
recordOrFolder = folder;
|
||||||
|
}
|
||||||
|
DispositionAction firstDispositionAction = initialiseDispositionAction(recordOrFolder, firstDispositionActionDef, true);
|
||||||
|
newAction = firstDispositionAction.getNodeRef();
|
||||||
|
newDispositionActionName = (String)nodeService.getProperty(newAction, PROP_DISPOSITION_ACTION_NAME);
|
||||||
|
newDispositionActionDateAsOf = firstDispositionAction.getAsOfDate();
|
||||||
|
}
|
||||||
|
else if (firstDispositionActionDef.getPeriod() != null)
|
||||||
|
{
|
||||||
|
Date firstActionDate = calculateAsOfDate(record, firstDispositionActionDef, true);
|
||||||
|
if (firstActionDate == null || (newDispositionActionDateAsOf != null
|
||||||
|
&& newDispositionActionDateAsOf.before(firstActionDate)))
|
||||||
|
{
|
||||||
|
newDispositionActionName = firstDispositionActionDef.getName();
|
||||||
|
newDispositionActionDateAsOf = firstActionDate;
|
||||||
|
if (firstActionDate == null)
|
||||||
|
{
|
||||||
|
// Treat null as the latest date possible, so there's no point searching further.
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (newDispositionActionName == null || dispositionNodeRef == null || newAction == null)
|
||||||
|
{
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return new NextActionFromDisposition(dispositionNodeRef, newAction,
|
||||||
|
newDispositionActionName, newDispositionActionDateAsOf, WriteMode.DATE_AND_NAME);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@@ -0,0 +1,80 @@
|
|||||||
|
package org.alfresco.module.org_alfresco_module_rm.disposition;
|
||||||
|
|
||||||
|
import java.util.Date;
|
||||||
|
|
||||||
|
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionServiceImpl.WriteMode;
|
||||||
|
import org.alfresco.service.cmr.repository.NodeRef;
|
||||||
|
|
||||||
|
public class NextActionFromDisposition
|
||||||
|
{
|
||||||
|
public NextActionFromDisposition(NodeRef dispositionNodeRef, NodeRef nextActionNodeRef, String nextActionName, Date nextActionDateAsOf,
|
||||||
|
WriteMode writeMode)
|
||||||
|
{
|
||||||
|
super();
|
||||||
|
this.dispositionNodeRef = dispositionNodeRef;
|
||||||
|
this.nextActionNodeRef = nextActionNodeRef;
|
||||||
|
this.nextActionName = nextActionName;
|
||||||
|
this.nextActionDateAsOf = nextActionDateAsOf;
|
||||||
|
this.writeMode = writeMode;
|
||||||
|
}
|
||||||
|
|
||||||
|
private NodeRef dispositionNodeRef;
|
||||||
|
|
||||||
|
private NodeRef nextActionNodeRef;
|
||||||
|
|
||||||
|
private String nextActionName;
|
||||||
|
|
||||||
|
private Date nextActionDateAsOf;
|
||||||
|
|
||||||
|
private WriteMode writeMode;
|
||||||
|
|
||||||
|
public WriteMode getWriteMode()
|
||||||
|
{
|
||||||
|
return writeMode;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setWriteMode(WriteMode writeMode)
|
||||||
|
{
|
||||||
|
this.writeMode = writeMode;
|
||||||
|
}
|
||||||
|
|
||||||
|
public NodeRef getNextActionNodeRef()
|
||||||
|
{
|
||||||
|
return nextActionNodeRef;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setNextActionNodeRef(NodeRef nextActionNodeRef)
|
||||||
|
{
|
||||||
|
this.nextActionNodeRef = nextActionNodeRef;
|
||||||
|
}
|
||||||
|
|
||||||
|
public NodeRef getDispositionNodeRef()
|
||||||
|
{
|
||||||
|
return dispositionNodeRef;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setDispositionNodeRef(NodeRef dispositionNodeRef)
|
||||||
|
{
|
||||||
|
this.dispositionNodeRef = dispositionNodeRef;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getNextActionName()
|
||||||
|
{
|
||||||
|
return nextActionName;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setNextActionName(String nextActionName)
|
||||||
|
{
|
||||||
|
this.nextActionName = nextActionName;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Date getNextActionDateAsOf()
|
||||||
|
{
|
||||||
|
return nextActionDateAsOf;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setNextActionDateAsOf(Date nextActionDateAsOf)
|
||||||
|
{
|
||||||
|
this.nextActionDateAsOf = nextActionDateAsOf;
|
||||||
|
}
|
||||||
|
}
|
@@ -45,12 +45,14 @@ import java.util.Set;
|
|||||||
|
|
||||||
import org.alfresco.error.AlfrescoRuntimeException;
|
import org.alfresco.error.AlfrescoRuntimeException;
|
||||||
import org.alfresco.model.ContentModel;
|
import org.alfresco.model.ContentModel;
|
||||||
|
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementServiceRegistry;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementPolicies.BeforeFileRecord;
|
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementPolicies.BeforeFileRecord;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementPolicies.OnFileRecord;
|
import org.alfresco.module.org_alfresco_module_rm.RecordsManagementPolicies.OnFileRecord;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.capability.Capability;
|
import org.alfresco.module.org_alfresco_module_rm.capability.Capability;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.capability.CapabilityService;
|
import org.alfresco.module.org_alfresco_module_rm.capability.CapabilityService;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.capability.RMPermissionModel;
|
import org.alfresco.module.org_alfresco_module_rm.capability.RMPermissionModel;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionSchedule;
|
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionSchedule;
|
||||||
|
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionScheduleImpl;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService;
|
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionService;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.dod5015.DOD5015Model;
|
import org.alfresco.module.org_alfresco_module_rm.dod5015.DOD5015Model;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanService;
|
import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanService;
|
||||||
@@ -1753,7 +1755,10 @@ public class RecordServiceImpl extends BaseBehaviourBean
|
|||||||
private void validateLinkConditions(NodeRef record, NodeRef recordFolder)
|
private void validateLinkConditions(NodeRef record, NodeRef recordFolder)
|
||||||
{
|
{
|
||||||
// ensure that the linking record folders have compatible disposition schedules
|
// ensure that the linking record folders have compatible disposition schedules
|
||||||
DispositionSchedule recordDispositionSchedule = dispositionService.getDispositionSchedule(record);
|
|
||||||
|
// get the origin disposition schedule for the record, not the calculated one
|
||||||
|
DispositionSchedule recordDispositionSchedule = dispositionService.getOriginDispositionSchedule(record);
|
||||||
|
|
||||||
if (recordDispositionSchedule != null)
|
if (recordDispositionSchedule != null)
|
||||||
{
|
{
|
||||||
DispositionSchedule recordFolderDispositionSchedule = dispositionService.getDispositionSchedule(recordFolder);
|
DispositionSchedule recordFolderDispositionSchedule = dispositionService.getDispositionSchedule(recordFolder);
|
||||||
|
@@ -1,28 +1,20 @@
|
|||||||
/*
|
/*
|
||||||
* #%L
|
* Copyright (C) 2005-2014 Alfresco Software Limited.
|
||||||
* Alfresco Records Management Module
|
*
|
||||||
* %%
|
* This file is part of Alfresco
|
||||||
* Copyright (C) 2005 - 2016 Alfresco Software Limited
|
*
|
||||||
* %%
|
|
||||||
* This file is part of the Alfresco software.
|
|
||||||
* -
|
|
||||||
* If the software was purchased under a paid Alfresco license, the terms of
|
|
||||||
* the paid license agreement will prevail. Otherwise, the software is
|
|
||||||
* provided under the following open source license terms:
|
|
||||||
* -
|
|
||||||
* Alfresco is free software: you can redistribute it and/or modify
|
* Alfresco is free software: you can redistribute it and/or modify
|
||||||
* it under the terms of the GNU Lesser General Public License as published by
|
* it under the terms of the GNU Lesser General Public License as published by
|
||||||
* the Free Software Foundation, either version 3 of the License, or
|
* the Free Software Foundation, either version 3 of the License, or
|
||||||
* (at your option) any later version.
|
* (at your option) any later version.
|
||||||
* -
|
*
|
||||||
* Alfresco is distributed in the hope that it will be useful,
|
* Alfresco is distributed in the hope that it will be useful,
|
||||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
* GNU Lesser General Public License for more details.
|
* GNU Lesser General Public License for more details.
|
||||||
* -
|
*
|
||||||
* You should have received a copy of the GNU Lesser General Public License
|
* You should have received a copy of the GNU Lesser General Public License
|
||||||
* along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
|
* along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
|
||||||
* #L%
|
|
||||||
*/
|
*/
|
||||||
package org.alfresco.module.org_alfresco_module_rm.test.integration.disposition;
|
package org.alfresco.module.org_alfresco_module_rm.test.integration.disposition;
|
||||||
|
|
||||||
@@ -44,6 +36,7 @@ import org.alfresco.module.org_alfresco_module_rm.action.impl.EditDispositionAct
|
|||||||
import org.alfresco.module.org_alfresco_module_rm.action.impl.TransferAction;
|
import org.alfresco.module.org_alfresco_module_rm.action.impl.TransferAction;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionSchedule;
|
import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionSchedule;
|
||||||
import org.alfresco.module.org_alfresco_module_rm.test.util.BaseRMTestCase;
|
import org.alfresco.module.org_alfresco_module_rm.test.util.BaseRMTestCase;
|
||||||
|
import org.alfresco.module.org_alfresco_module_rm.test.util.CommonRMTestUtils;
|
||||||
import org.alfresco.service.cmr.repository.NodeRef;
|
import org.alfresco.service.cmr.repository.NodeRef;
|
||||||
import org.alfresco.service.namespace.QName;
|
import org.alfresco.service.namespace.QName;
|
||||||
|
|
||||||
@@ -51,7 +44,7 @@ import org.alfresco.service.namespace.QName;
|
|||||||
* Update next disposition step integration tests.
|
* Update next disposition step integration tests.
|
||||||
*
|
*
|
||||||
* @author Roxana Lucanu
|
* @author Roxana Lucanu
|
||||||
* @since 2.4.1
|
* @since 2.3.1
|
||||||
*/
|
*/
|
||||||
public class UpdateNextDispositionActionTest extends BaseRMTestCase
|
public class UpdateNextDispositionActionTest extends BaseRMTestCase
|
||||||
{
|
{
|
||||||
@@ -103,11 +96,6 @@ public class UpdateNextDispositionActionTest extends BaseRMTestCase
|
|||||||
// complete record
|
// complete record
|
||||||
utils.completeRecord(record);
|
utils.completeRecord(record);
|
||||||
|
|
||||||
// set the disposition as of date to now on the record
|
|
||||||
rmActionService.executeRecordsManagementAction(record,
|
|
||||||
EditDispositionActionAsOfDateAction.NAME,
|
|
||||||
Collections.singletonMap(EditDispositionActionAsOfDateAction.PARAM_AS_OF_DATE, new Date()));
|
|
||||||
|
|
||||||
// cut off
|
// cut off
|
||||||
rmActionService.executeRecordsManagementAction(record, CutOffAction.NAME, null);
|
rmActionService.executeRecordsManagementAction(record, CutOffAction.NAME, null);
|
||||||
}
|
}
|
||||||
@@ -115,7 +103,7 @@ public class UpdateNextDispositionActionTest extends BaseRMTestCase
|
|||||||
@Override
|
@Override
|
||||||
public void then() throws Exception
|
public void then() throws Exception
|
||||||
{
|
{
|
||||||
assertTrue(nodeService.hasAspect(record, ASPECT_CUT_OFF));
|
assertTrue("Record " + record + " doesn't have the cutOff aspect.", nodeService.hasAspect(record, ASPECT_CUT_OFF));
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
@@ -128,7 +116,7 @@ public class UpdateNextDispositionActionTest extends BaseRMTestCase
|
|||||||
Map<QName, Serializable> cutOff = new HashMap<QName, Serializable>(3);
|
Map<QName, Serializable> cutOff = new HashMap<QName, Serializable>(3);
|
||||||
cutOff.put(PROP_DISPOSITION_ACTION_NAME, CutOffAction.NAME);
|
cutOff.put(PROP_DISPOSITION_ACTION_NAME, CutOffAction.NAME);
|
||||||
cutOff.put(PROP_DISPOSITION_DESCRIPTION, generate());
|
cutOff.put(PROP_DISPOSITION_DESCRIPTION, generate());
|
||||||
cutOff.put(PROP_DISPOSITION_PERIOD, PERIOD_ONE_WEEK);
|
cutOff.put(PROP_DISPOSITION_PERIOD, CommonRMTestUtils.PERIOD_IMMEDIATELY);
|
||||||
dispositionService.addDispositionActionDefinition(ds, cutOff);
|
dispositionService.addDispositionActionDefinition(ds, cutOff);
|
||||||
|
|
||||||
// create the properties for TRANSFER action and add it to the disposition action definition
|
// create the properties for TRANSFER action and add it to the disposition action definition
|
||||||
|
@@ -666,7 +666,7 @@ public class DispositionServiceImplTest extends BaseRMTestCase
|
|||||||
checkDisposableItemChanged(mhRecordFolder42);
|
checkDisposableItemChanged(mhRecordFolder42);
|
||||||
checkDisposableItemChanged(record43);
|
checkDisposableItemChanged(record43);
|
||||||
checkDisposableItemUnchanged(mhRecordFolder44);
|
checkDisposableItemUnchanged(mhRecordFolder44);
|
||||||
checkDisposableItemUnchanged(record45);;
|
checkDisposableItemUnchanged(record45);
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
@@ -274,7 +274,7 @@ public class RecordServiceImplUnitTest extends BaseUnitTest
|
|||||||
DispositionSchedule recordDispositionSchedule = mock(DispositionSchedule.class);
|
DispositionSchedule recordDispositionSchedule = mock(DispositionSchedule.class);
|
||||||
when(recordDispositionSchedule.isRecordLevelDisposition())
|
when(recordDispositionSchedule.isRecordLevelDisposition())
|
||||||
.thenReturn(true);
|
.thenReturn(true);
|
||||||
when(mockedDispositionService.getDispositionSchedule(record))
|
when(mockedDispositionService.getOriginDispositionSchedule(record))
|
||||||
.thenReturn(recordDispositionSchedule);
|
.thenReturn(recordDispositionSchedule);
|
||||||
|
|
||||||
DispositionSchedule recordFolderDispositionSchedule = mock(DispositionSchedule.class);
|
DispositionSchedule recordFolderDispositionSchedule = mock(DispositionSchedule.class);
|
||||||
|
Reference in New Issue
Block a user