RM permission inheritance behaviour clarified

* read permissions not inherited to root categories, holds or items in the root of the unfiled record container .. this matches 
   the current behaviour of the file plan and is a partial work around for the issue of inheriting "path" read permissions vs actual read permissions.
 * consolidation of permission initialisation code (there is only one route now)
 * resolved RM-1317
 * unit tests
 * update server integration tests
 * knock on minor simplifications on the file plan and transfer service 
 * moved more frequently used methods into the service base to reduce unessesary service interlinking



git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/modules/recordsmanagement/HEAD@67030 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

rm-server/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanServiceImpl.java

@@ -29,18 +29,12 @@ import java.util.Set;
 
 import org.alfresco.error.AlfrescoRuntimeException;
 import org.alfresco.model.ContentModel;
-import org.alfresco.module.org_alfresco_module_rm.capability.RMPermissionModel;
-import org.alfresco.module.org_alfresco_module_rm.recordfolder.RecordFolderService;
-import org.alfresco.module.org_alfresco_module_rm.role.FilePlanRoleService;
-import org.alfresco.module.org_alfresco_module_rm.security.ExtendedReaderDynamicAuthority;
-import org.alfresco.module.org_alfresco_module_rm.security.ExtendedWriterDynamicAuthority;
-import org.alfresco.module.org_alfresco_module_rm.transfer.TransferService;
+import org.alfresco.module.org_alfresco_module_rm.security.FilePlanPermissionService;
 import org.alfresco.module.org_alfresco_module_rm.util.ServiceBaseImpl;
 import org.alfresco.repo.domain.node.NodeDAO;
 import org.alfresco.service.cmr.repository.ChildAssociationRef;
 import org.alfresco.service.cmr.repository.NodeRef;
 import org.alfresco.service.cmr.repository.StoreRef;
-import org.alfresco.service.cmr.security.PermissionService;
 import org.alfresco.service.cmr.site.SiteInfo;
 import org.alfresco.service.cmr.site.SiteService;
 import org.alfresco.service.namespace.NamespaceService;
@@ -77,157 +71,35 @@ public class FilePlanServiceImpl extends ServiceBaseImpl
     /** RM site file plan container */
     private static final String FILE_PLAN_CONTAINER = "documentLibrary";
 
+    /** node DAO */
+    private NodeDAO nodeDAO;
+    
+    /** file plan permission service */
+    private FilePlanPermissionService filePlanPermissionService;
+    
     /**
-     * NOTE:  for some reason spring couldn't cope with the circular references between these two
-     *        beans so we need to grab this one manually.
-     *
-     * @return  file plan role service
+     * @param nodeDAO   node DAO
      */
-    protected FilePlanRoleService getFilePlanRoleService()
+    public void setNodeDAO(NodeDAO nodeDAO)
     {
-        return (FilePlanRoleService)applicationContext.getBean("FilePlanRoleService");
+        this.nodeDAO = nodeDAO;
     }
-
+    
     /**
-     * @return	permission service
-     */
-    protected PermissionService getPermissionService()
-    {
-        return (PermissionService)applicationContext.getBean("permissionService");
-    }
-
-    /**
-     * @return	node DAO
-     */
-    protected NodeDAO getNodeDAO()
-    {
-        return (NodeDAO)applicationContext.getBean("nodeDAO");
-    }
-
-    /**
-     * @return	site service
+     * @return  site service
      */
     protected SiteService getSiteService()
     {
-        return (SiteService)applicationContext.getBean("SiteService");
+        return (SiteService)applicationContext.getBean("siteService");
     }
-
+    
     /**
-     * @return	record folder service
+     * @param filePlanPermissionService file plan permission service
      */
-    protected RecordFolderService getRecordFolderService()
+    public void setFilePlanPermissionService(FilePlanPermissionService filePlanPermissionService)
     {
-    	return (RecordFolderService)applicationContext.getBean("RecordFolderService");
-    }
-
-    /**
-     * @return	transfer service
-     */
-    protected TransferService getTransferService()
-    {
-    	return (TransferService)applicationContext.getBean("RmTransferService");
-    }
-
-    /**
-     * @see org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanService#getFilePlanComponentKind(org.alfresco.service.cmr.repository.NodeRef)
-     */
-    public FilePlanComponentKind getFilePlanComponentKind(NodeRef nodeRef)
-    {
-        FilePlanComponentKind result = null;
-
-        if (isFilePlanComponent(nodeRef))
-        {
-            result = FilePlanComponentKind.FILE_PLAN_COMPONENT;
-
-            if (isFilePlan(nodeRef))
-            {
-                result = FilePlanComponentKind.FILE_PLAN;
-            }
-            else if (isRecordCategory(nodeRef))
-            {
-                result = FilePlanComponentKind.RECORD_CATEGORY;
-            }
-            else if (getRecordFolderService().isRecordFolder(nodeRef))
-            {
-                result = FilePlanComponentKind.RECORD_FOLDER;
-            }
-            else if (isRecord(nodeRef))
-            {
-                result = FilePlanComponentKind.RECORD;
-            }
-            else if (instanceOf(nodeRef, TYPE_HOLD_CONTAINER))
-            {
-                result = FilePlanComponentKind.HOLD_CONTAINER;
-            }
-            else if (isHold(nodeRef))
-            {
-                result = FilePlanComponentKind.HOLD;
-            }
-            else if (getTransferService().isTransfer(nodeRef))
-            {
-                result = FilePlanComponentKind.TRANSFER;
-            }
-            else if (instanceOf(nodeRef, TYPE_DISPOSITION_SCHEDULE) || instanceOf(nodeRef, TYPE_DISPOSITION_ACTION_DEFINITION))
-            {
-                result = FilePlanComponentKind.DISPOSITION_SCHEDULE;
-            }
-            else if (instanceOf(nodeRef, TYPE_UNFILED_RECORD_CONTAINER))
-            {
-                result = FilePlanComponentKind.UNFILED_RECORD_CONTAINER;
-            }
-            else if (instanceOf(nodeRef, TYPE_UNFILED_RECORD_FOLDER))
-            {
-                result = FilePlanComponentKind.UNFILED_RECORD_FOLDER;
-            }
-        }
-
-        return result;
-    }
-
-    /**
-     * @see FilePlanService#getFilePlanComponentKindFromType(QName)
-     */
-    @Override
-    public FilePlanComponentKind getFilePlanComponentKindFromType(QName type)
-    {
-        FilePlanComponentKind result = null;
-
-        if (ASPECT_FILE_PLAN_COMPONENT.equals(type))
-        {
-            result = FilePlanComponentKind.FILE_PLAN_COMPONENT;
-        }
-        else if (dictionaryService.isSubClass(type, ASPECT_RECORD))
-        {
-            result = FilePlanComponentKind.RECORD;
-        }
-        else if (dictionaryService.isSubClass(type, TYPE_FILE_PLAN))
-        {
-            result = FilePlanComponentKind.FILE_PLAN;
-        }
-        else if (dictionaryService.isSubClass(type, TYPE_RECORD_CATEGORY))
-        {
-            result = FilePlanComponentKind.RECORD_CATEGORY;
-        }
-        else if (dictionaryService.isSubClass(type, TYPE_RECORD_FOLDER))
-        {
-            result = FilePlanComponentKind.RECORD_FOLDER;
-        }
-        else if (dictionaryService.isSubClass(type, TYPE_HOLD))
-        {
-            result = FilePlanComponentKind.HOLD;
-        }
-        else if (dictionaryService.isSubClass(type, TYPE_TRANSFER))
-        {
-            result = FilePlanComponentKind.TRANSFER;
-        }
-        else if (dictionaryService.isSubClass(type, TYPE_DISPOSITION_SCHEDULE) ||
-                 dictionaryService.isSubClass(type, TYPE_DISPOSITION_ACTION_DEFINITION))
-        {
-            result = FilePlanComponentKind.DISPOSITION_SCHEDULE;
-        }
-
-        return result;
-    }    
+        this.filePlanPermissionService = filePlanPermissionService;
+    }   
 
     /**
      * @see org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanService#getFilePlans()
@@ -249,7 +121,7 @@ public class FilePlanServiceImpl extends ServiceBaseImpl
         final Set<NodeRef> results = new HashSet<NodeRef>();
         Set<QName> aspects = new HashSet<QName>(1);
         aspects.add(ASPECT_RECORDS_MANAGEMENT_ROOT);
-        getNodeDAO().getNodesWithAspects(aspects, Long.MIN_VALUE, Long.MAX_VALUE, new NodeDAO.NodeRefQueryCallback()
+        nodeDAO.getNodesWithAspects(aspects, Long.MIN_VALUE, Long.MAX_VALUE, new NodeDAO.NodeRefQueryCallback()
         {
             @Override
             public boolean handle(Pair<Long, NodeRef> nodePair)
@@ -273,13 +145,14 @@ public class FilePlanServiceImpl extends ServiceBaseImpl
     public NodeRef getFilePlanBySiteId(String siteId)
     {
         NodeRef filePlan = null;
-
-        SiteInfo siteInfo = getSiteService().getSite(siteId);
+        SiteService siteService = getSiteService();
+        
+        SiteInfo siteInfo = siteService.getSite(siteId);
         if (siteInfo != null)
         {
-            if (getSiteService().hasContainer(siteId, FILE_PLAN_CONTAINER))
+            if (siteService.hasContainer(siteId, FILE_PLAN_CONTAINER))
             {
-                NodeRef nodeRef = getSiteService().getContainer(siteId, FILE_PLAN_CONTAINER);
+                NodeRef nodeRef = siteService.getContainer(siteId, FILE_PLAN_CONTAINER);
                 if (instanceOf(nodeRef, TYPE_FILE_PLAN))
                 {
                     filePlan = nodeRef;
@@ -398,8 +271,6 @@ public class FilePlanServiceImpl extends ServiceBaseImpl
             throw new AlfrescoRuntimeException("Unable to create file plan root container, because passed node is not a file plan.");
         }
 
-        String allRoles = getFilePlanRoleService().getAllRolesContainerGroup(filePlan);
-
         // create the properties map
         Map<QName, Serializable> properties = new HashMap<QName, Serializable>(1);
         properties.put(ContentModel.PROP_NAME, containerName);
@@ -411,19 +282,9 @@ public class FilePlanServiceImpl extends ServiceBaseImpl
                         QName.createQName(RM_URI, containerName),
                         containerType,
                         properties).getChildRef();
-
-        // set inheritance to false
-        getPermissionService().setInheritParentPermissions(container, false);
         
-        // give all roles read permissions on the container by default
-        getPermissionService().setPermission(container, allRoles, RMPermissionModel.READ_RECORDS, true);
-        
-        // setup the extended reader permissions
-        getPermissionService().setPermission(container, ExtendedReaderDynamicAuthority.EXTENDED_READER, RMPermissionModel.READ_RECORDS, true);
-        getPermissionService().setPermission(container, ExtendedWriterDynamicAuthority.EXTENDED_WRITER, RMPermissionModel.FILING, true);
-        
-        // setup the administrator permissions
-        getPermissionService().setPermission(container, "Administrator", RMPermissionModel.FILING, true);
+        // setup the permissions
+        filePlanPermissionService.setupPermissions(filePlan, container);
 
         return container;
     }

rm-server/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanPermissionService.java

@@ -34,6 +34,14 @@ public interface FilePlanPermissionService
      */
     void setupRecordCategoryPermissions(NodeRef recordCategory);
     
+    /**
+     * Setup permissions for an object within a given parent.
+     * 
+     * @param parent    parent node to inherit permissions from
+     * @param nodeRef   node ref to setup permissions on 
+     */
+    void setupPermissions(NodeRef parent, NodeRef nodeRef);
+    
     /**
      * Sets a permission on a file plan object.  Assumes allow is true.  Cascades permission down to record folder.  
      * Cascades ReadRecord up to file plan.

rm-server/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanPermissionServiceImpl.java

@@ -25,6 +25,7 @@ import java.util.Set;
 import org.alfresco.error.AlfrescoRuntimeException;
 import org.alfresco.model.ContentModel;
 import org.alfresco.module.org_alfresco_module_rm.capability.RMPermissionModel;
+import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanComponentKind;
 import org.alfresco.module.org_alfresco_module_rm.util.ServiceBaseImpl;
 import org.alfresco.repo.node.NodeServicePolicies;
 import org.alfresco.repo.policy.Behaviour.NotificationFrequency;
@@ -38,6 +39,7 @@ import org.alfresco.service.cmr.repository.ChildAssociationRef;
 import org.alfresco.service.cmr.repository.NodeRef;
 import org.alfresco.service.cmr.security.AccessPermission;
 import org.alfresco.service.cmr.security.AccessStatus;
+import org.alfresco.service.cmr.security.OwnableService;
 import org.alfresco.service.cmr.security.PermissionService;
 import org.alfresco.service.namespace.QName;
 import org.alfresco.service.namespace.RegexQNamePattern;
@@ -57,6 +59,9 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
 {
     /** Permission service */
     protected PermissionService permissionService;
+    
+    /** Ownable service */
+    protected OwnableService ownableService;
 
     /** Policy component */
     protected PolicyComponent policyComponent;
@@ -94,6 +99,14 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
     {
         this.policyComponent = policyComponent;
     }
+    
+    /**
+     * @param ownableService    ownable service
+     */
+    public void setOwnableService(OwnableService ownableService)
+    {
+        this.ownableService = ownableService;
+    }
 
     /**
      * @see org.alfresco.module.org_alfresco_module_rm.security.FilePlanPermissionService#setupRecordCategoryPermissions(org.alfresco.service.cmr.repository.NodeRef)
@@ -109,44 +122,9 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
             throw new AlfrescoRuntimeException("Unable to setup record category permissions, because node is not a record category.");
         }
 
-        // init permissions
-        initPermissions(recordCategory);
-
-        // Pull any permissions found on the parent (ie the record category)
-        final NodeRef parentNodeRef = nodeService.getPrimaryParent(recordCategory).getParentRef();
-        if (parentNodeRef != null && nodeService.exists(parentNodeRef))
-        {
-            AuthenticationUtil.runAsSystem(new AuthenticationUtil.RunAsWork<Object>()
-            {
-                public Object doWork()
-                {
-                    boolean fillingOnly = isFilePlan(parentNodeRef);
-
-                    // since this is not a root category, inherit from parent
-                    Set<AccessPermission> perms = permissionService.getAllSetPermissions(parentNodeRef);
-                    for (AccessPermission perm : perms)
-                    {
-                        if (!fillingOnly ||
-                            RMPermissionModel.FILING.equals(perm.getPermission()))
-                        {
-                            AccessStatus accessStatus = perm.getAccessStatus();
-                            boolean allow = false;
-                            if (AccessStatus.ALLOWED.equals(accessStatus))
-                            {
-                                allow = true;
-                            }
-                            permissionService.setPermission(
-                                    recordCategory,
-                                    perm.getAuthority(),
-                                    perm.getPermission(),
-                                    allow);
-                        }
-                    }
-
-                    return null;
-                }
-            });
-        }
+        // setup category permissions
+        NodeRef parentNodeRef = nodeService.getPrimaryParent(recordCategory).getParentRef();
+        setupPermissions(parentNodeRef, recordCategory);        
     }
     
     /**
@@ -225,6 +203,9 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
      */
     public void setupPermissions(final NodeRef parent, final NodeRef nodeRef)
     {
+        ParameterCheck.mandatory("parent", parent);
+        ParameterCheck.mandatory("nodeRef", nodeRef);
+        
         if (nodeService.exists(nodeRef))
         {
             // initialise permissions
@@ -232,7 +213,7 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
             
             if (nodeService.exists(parent))
             {
-                AuthenticationUtil.runAsSystem(new AuthenticationUtil.RunAsWork<Object>()
+                runAsSystem(new AuthenticationUtil.RunAsWork<Object>()
                 {
                     public Object doWork()
                     {
@@ -240,20 +221,29 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
                         Set<AccessPermission> perms = permissionService.getAllSetPermissions(parent);
                         for (AccessPermission perm : perms)
                         {
-                            if (!ExtendedReaderDynamicAuthority.EXTENDED_READER.equals(perm.getAuthority()) &&
-                                !ExtendedWriterDynamicAuthority.EXTENDED_WRITER.equals(perm.getAuthority()))
+                            // only copy filling permissions if the parent is the file plan
+                            if (!inheritFillingOnly(parent, nodeRef) ||
+                                RMPermissionModel.FILING.equals(perm.getPermission()))
                             {
-                                AccessStatus accessStatus = perm.getAccessStatus();
-                                boolean allow = false;
-                                if (AccessStatus.ALLOWED.equals(accessStatus))
+                                // don't copy the extended reader or writer permissions as they have already been set
+                                if (!ExtendedReaderDynamicAuthority.EXTENDED_READER.equals(perm.getAuthority()) &&
+                                    !ExtendedWriterDynamicAuthority.EXTENDED_WRITER.equals(perm.getAuthority()))
                                 {
-                                    allow = true;
+                                    // get the access status details
+                                    AccessStatus accessStatus = perm.getAccessStatus();
+                                    boolean allow = false;
+                                    if (AccessStatus.ALLOWED.equals(accessStatus))
+                                    {
+                                        allow = true;
+                                    }
+                                    
+                                    // set the permission on the target node
+                                    permissionService.setPermission(
+                                            nodeRef,
+                                            perm.getAuthority(),
+                                            perm.getPermission(),
+                                            allow);
                                 }
-                                permissionService.setPermission(
-                                        nodeRef,
-                                        perm.getAuthority(),
-                                        perm.getPermission(),
-                                        allow);
                             }
                         }
                         
@@ -263,6 +253,30 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
             }
         }
     }
+ 
+    /**
+     * Helper method to determine whether all or just filling permissions should be inherited.
+     * 
+     * @param parent    parent node
+     * @param child     child node
+     * @return boolean  true if inherit filling only, false otherwise
+     */
+    private boolean inheritFillingOnly(NodeRef parent, NodeRef child)
+    {
+        boolean result = false;
+        
+        // if root category or
+        // if in root of unfiled container or
+        // if in root of hold container
+        if ((isFilePlan(parent) && isRecordCategory(child)) ||
+            FilePlanComponentKind.UNFILED_RECORD_CONTAINER.equals(getFilePlanComponentKind(parent)) ||
+            FilePlanComponentKind.HOLD_CONTAINER.equals(getFilePlanComponentKind(parent)))
+        {
+            result = true;
+        }
+        
+        return result;        
+    }
 
     /**
      * Sets ups records permission when aspect is added.
@@ -274,7 +288,7 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
      */
     public void onAddRecord(final NodeRef record, final QName aspectTypeQName)
     {
-        runAs(new AuthenticationUtil.RunAsWork<Object>()
+        runAsSystem(new AuthenticationUtil.RunAsWork<Object>()
         {
             public Object doWork()
             {
@@ -286,7 +300,7 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
 
                 return null;
             }
-        }, AuthenticationUtil.getSystemUserName());
+        });
     }
 
     /**
@@ -343,7 +357,7 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
     }
 
     /**
-     * Initiliase the permissions for the given node.
+     * Init the permissions for the given node.
      *
      * @param nodeRef   node reference
      */
@@ -351,20 +365,26 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
     {
         if (nodeService.exists(nodeRef))
         {
-            runAs(new AuthenticationUtil.RunAsWork<Object>()
+            runAsSystem(new AuthenticationUtil.RunAsWork<Object>()
             {
                 public Object doWork()
                 {
                     // break inheritance
                     permissionService.setInheritParentPermissions(nodeRef, false);
+                    
+                    // clear all existing permissions
+                    permissionService.clearPermission(nodeRef, null);
 
                     // set extended reader permissions
                     permissionService.setPermission(nodeRef, ExtendedReaderDynamicAuthority.EXTENDED_READER, RMPermissionModel.READ_RECORDS, true);
                     permissionService.setPermission(nodeRef, ExtendedWriterDynamicAuthority.EXTENDED_WRITER, RMPermissionModel.FILING, true);
+                    
+                    // remove owner
+                    ownableService.setOwner(nodeRef, OwnableService.NO_OWNER);
 
                     return null;
                 }
-            }, AuthenticationUtil.getSystemUserName());
+            });
         }
     }
 
@@ -383,6 +403,7 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
             {
                 if (isFilePlan(nodeRef))
                 {
+                    // set the permission down the file plan hierarchy
                    setPermissionDown(nodeRef, authority, permission);
                 }
                 else if (isFilePlanContainer(nodeRef) ||
@@ -390,7 +411,10 @@ public class FilePlanPermissionServiceImpl extends    ServiceBaseImpl
                          isRecord(nodeRef) ||
                          isHold(nodeRef))
                 {
+                    // set read permission to the parents of the node
                     setReadPermissionUp(nodeRef, authority);
+                    
+                    // set the permission on the node and it's children
                     setPermissionDown(nodeRef, authority, permission);
                 }
                 else

rm-server/source/java/org/alfresco/module/org_alfresco_module_rm/transfer/TransferServiceImpl.java

@@ -53,7 +53,8 @@ import org.springframework.extensions.surf.util.ParameterCheck;
  * @author Tuna Aksoy
  * @since 2.2
  */
-public class TransferServiceImpl extends ServiceBaseImpl implements TransferService, RecordsManagementModel
+public class TransferServiceImpl extends ServiceBaseImpl 
+                                 implements TransferService, RecordsManagementModel
 {
     /** Transfer node reference key */
     public static final String KEY_TRANSFER_NODEREF = "transferNodeRef";
@@ -105,16 +106,6 @@ public class TransferServiceImpl extends ServiceBaseImpl implements TransferServ
         this.recordFolderService = recordFolderService;
     }
 
-    /**
-     * @see org.alfresco.module.org_alfresco_module_rm.transfer.TransferService#isTransfer(NodeRef)
-     */
-    @Override
-    public boolean isTransfer(NodeRef nodeRef)
-    {
-        ParameterCheck.mandatory("nodeRef", nodeRef);
-        return instanceOf(nodeRef, TYPE_TRANSFER);
-    }
-
     /**
      * @see org.alfresco.module.org_alfresco_module_rm.transfer.TransferService#transfer(NodeRef, boolean)
      */

rm-server/source/java/org/alfresco/module/org_alfresco_module_rm/util/ServiceBaseImpl.java

@@ -20,6 +20,8 @@ package org.alfresco.module.org_alfresco_module_rm.util;
 
 import java.util.Set;
 
+import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanComponentKind;
+import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanService;
 import org.alfresco.module.org_alfresco_module_rm.hold.HoldService;
 import org.alfresco.module.org_alfresco_module_rm.model.RecordsManagementModel;
 import org.alfresco.repo.security.authentication.AuthenticationUtil;
@@ -77,6 +79,110 @@ public class ServiceBaseImpl implements RecordsManagementModel, ApplicationConte
         this.dictionaryService = dictionaryService;
     }
     
+    /**
+     * Gets the file plan component kind from the given node reference
+     * 
+     * @see org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanService#getFilePlanComponentKind(org.alfresco.service.cmr.repository.NodeRef)
+     */
+    public FilePlanComponentKind getFilePlanComponentKind(NodeRef nodeRef)
+    {
+        FilePlanComponentKind result = null;
+
+        if (isFilePlanComponent(nodeRef))
+        {
+            result = FilePlanComponentKind.FILE_PLAN_COMPONENT;
+
+            if (isFilePlan(nodeRef))
+            {
+                result = FilePlanComponentKind.FILE_PLAN;
+            }
+            else if (isRecordCategory(nodeRef))
+            {
+                result = FilePlanComponentKind.RECORD_CATEGORY;
+            }
+            else if (isRecordFolder(nodeRef))
+            {
+                result = FilePlanComponentKind.RECORD_FOLDER;
+            }
+            else if (isRecord(nodeRef))
+            {
+                result = FilePlanComponentKind.RECORD;
+            }
+            else if (instanceOf(nodeRef, TYPE_HOLD_CONTAINER))
+            {
+                result = FilePlanComponentKind.HOLD_CONTAINER;
+            }
+            else if (isHold(nodeRef))
+            {
+                result = FilePlanComponentKind.HOLD;
+            }
+            else if (isTransfer(nodeRef))
+            {
+                result = FilePlanComponentKind.TRANSFER;
+            }
+            else if (instanceOf(nodeRef, TYPE_DISPOSITION_SCHEDULE) || instanceOf(nodeRef, TYPE_DISPOSITION_ACTION_DEFINITION))
+            {
+                result = FilePlanComponentKind.DISPOSITION_SCHEDULE;
+            }
+            else if (instanceOf(nodeRef, TYPE_UNFILED_RECORD_CONTAINER))
+            {
+                result = FilePlanComponentKind.UNFILED_RECORD_CONTAINER;
+            }
+            else if (instanceOf(nodeRef, TYPE_UNFILED_RECORD_FOLDER))
+            {
+                result = FilePlanComponentKind.UNFILED_RECORD_FOLDER;
+            }
+        }
+
+        return result;
+    }
+
+    /**
+     * Gets the file plan component kind from the given type.
+     * 
+     * @see FilePlanService#getFilePlanComponentKindFromType(QName)
+     */
+    public FilePlanComponentKind getFilePlanComponentKindFromType(QName type)
+    {
+        FilePlanComponentKind result = null;
+
+        if (ASPECT_FILE_PLAN_COMPONENT.equals(type))
+        {
+            result = FilePlanComponentKind.FILE_PLAN_COMPONENT;
+        }
+        else if (instanceOf(type, ASPECT_RECORD))
+        {
+            result = FilePlanComponentKind.RECORD;
+        }
+        else if (instanceOf(type, TYPE_FILE_PLAN))
+        {
+            result = FilePlanComponentKind.FILE_PLAN;
+        }
+        else if (instanceOf(type, TYPE_RECORD_CATEGORY))
+        {
+            result = FilePlanComponentKind.RECORD_CATEGORY;
+        }
+        else if (instanceOf(type, TYPE_RECORD_FOLDER))
+        {
+            result = FilePlanComponentKind.RECORD_FOLDER;
+        }
+        else if (instanceOf(type, TYPE_HOLD))
+        {
+            result = FilePlanComponentKind.HOLD;
+        }
+        else if (instanceOf(type, TYPE_TRANSFER))
+        {
+            result = FilePlanComponentKind.TRANSFER;
+        }
+        else if (instanceOf(type, TYPE_DISPOSITION_SCHEDULE) ||
+                 instanceOf(type, TYPE_DISPOSITION_ACTION_DEFINITION))
+        {
+            result = FilePlanComponentKind.DISPOSITION_SCHEDULE;
+        }
+
+        return result;
+    } 
+    
     /**
      * Indicates whether the given node is a file plan component or not.
      * <p>
@@ -177,6 +283,18 @@ public class ServiceBaseImpl implements RecordsManagementModel, ApplicationConte
         }
         return isHold;
     }
+    
+    /**
+     * Indicates whether the given node reference is a transfer or not.
+     * 
+     * @see org.alfresco.module.org_alfresco_module_rm.transfer.TransferService#isTransfer(NodeRef)
+     */
+    public boolean isTransfer(NodeRef nodeRef)
+    {
+        ParameterCheck.mandatory("nodeRef", nodeRef);
+        
+        return instanceOf(nodeRef, TYPE_TRANSFER);
+    }
 
     /**
      * Gets the file plan that a given file plan component resides within.
@@ -241,6 +359,26 @@ public class ServiceBaseImpl implements RecordsManagementModel, ApplicationConte
         }
         return result;
     }
+    
+    /**
+     * Utility method to quickly determine whether one class is equal to or sub of another.
+     * 
+     * @param className     class name
+     * @param ofClassName   class name to check against
+     * @return boolean      true if equal to or sub, false otherwise
+     */
+    protected boolean instanceOf(QName className, QName ofClassName)
+    {
+        ParameterCheck.mandatory("className", className);
+        ParameterCheck.mandatory("ofClassName", ofClassName);
+        boolean result = false;
+        if (ofClassName.equals(className) ||
+            dictionaryService.isSubClass(className, ofClassName))
+        {
+            result = true;
+        }
+        return result;
+    }
 
     /**
      * Utility method to get the next counter for a node.