Interface FilePlanRoleService

  • All Known Implementing Classes:
    FilePlanRoleServiceImpl

    @AlfrescoPublicApi
    public interface FilePlanRoleService
    Role service interface
    Since:
    2.1
    Author:
    Roy Wetherall
    • Method Detail

      • setupFilePlanRoles

        void setupFilePlanRoles​(NodeRef filePlan)
        Sets up the roles on a new file plan.
        Parameters:
        filePlan - file plan
      • tearDownFilePlanRoles

        void tearDownFilePlanRoles​(NodeRef filePlan)
        Tears down the roles on a file plan.
        Parameters:
        filePlan - file plan
      • getAllRolesContainerGroup

        String getAllRolesContainerGroup​(NodeRef filePlan)
        Returns the name of the container group for all roles of a specified file plan.
        Parameters:
        filePlan - file plan node reference
        Returns:
        String group name
      • getRoles

        Set<Role> getRoles​(NodeRef filePlan)
        Get all the available roles for the given records management root node (includes also the system roles)
        Parameters:
        filePlan - file plan
        Returns:
      • getRoles

        Set<Role> getRoles​(NodeRef filePlan,
                           boolean includeSystemRoles)
        Get all the available roles for the given records management root node. System roles can be filtered
        Parameters:
        filePlan - file plan
        includeSystemRoles - system roles
        Returns:
      • getRolesByUser

        Set<Role> getRolesByUser​(NodeRef filePlan,
                                 String user)
        Gets the roles for a given user (includes also the system roles)
        Parameters:
        filePlan - file plan
        user - user
        Returns:
      • getRolesByUser

        Set<Role> getRolesByUser​(NodeRef filePlan,
                                 String user,
                                 boolean includeSystemRoles)
        Gets the roles for a given user. System roles can be filtered
        Parameters:
        filePlan - file plan
        user - user
        includeSystemRoles - system roles
        Returns:
      • getRole

        Role getRole​(NodeRef filePlan,
                     String role)
        Get a role by name
        Parameters:
        filePlan - file plan
        role - role
        Returns:
      • existsRole

        boolean existsRole​(NodeRef filePlan,
                           String role)
        Indicate whether a role exists for a given records management root node
        Parameters:
        filePlan - file plan
        role - role
        Returns:
      • hasRMAdminRole

        boolean hasRMAdminRole​(NodeRef filePlan,
                               String user)
        Determines whether the given user has the RM Admin role
        Parameters:
        filePlan - filePlan
        user - user name to check
        Returns:
        true if the user has the RM Admin role, false otherwise
      • createRole

        Role createRole​(NodeRef filePlan,
                        String role,
                        String roleDisplayLabel,
                        Set<Capability> capabilities)
        Create a new role
        Parameters:
        filePlan - file plan
        role -
        roleDisplayLabel -
        capabilities -
        Returns:
      • updateRole

        Role updateRole​(NodeRef filePlan,
                        String role,
                        String roleDisplayLabel,
                        Set<Capability> capabilities)
        Update an existing role
        Parameters:
        filePlan - file plan
        role -
        roleDisplayLabel -
        capabilities -
        Returns:
      • deleteRole

        void deleteRole​(NodeRef filePlan,
                        String role)
        Delete a role
        Parameters:
        filePlan - file plan
        role - role
      • getUsersAssignedToRole

        Set<String> getUsersAssignedToRole​(NodeRef filePlan,
                                           String role)
        Gets all the users that have been directly assigned to a role.
        Parameters:
        filePlan - file plan
        role - role
        Returns:
        Set<String> set of users
      • getGroupsAssignedToRole

        Set<String> getGroupsAssignedToRole​(NodeRef filePlan,
                                            String role)
        Gets all the groups that have been directly assigned to a role.
        Parameters:
        filePlan - file plan
        role - role
        Returns:
        Set<String> set of groups
      • getAllAssignedToRole

        Set<String> getAllAssignedToRole​(NodeRef filePlan,
                                         String role)
        Gets all the groups and users that have been directly assigned to a role.
        Parameters:
        filePlan - file plan
        role - role
        Returns:
        Set<String> set of groups and users
      • assignRoleToAuthority

        void assignRoleToAuthority​(NodeRef filePlan,
                                   String role,
                                   String authorityName)
        Assign a role to an authority
        Parameters:
        filePlan - file plan
        role - role
        authorityName - authority name
      • unassignRoleFromAuthority

        void unassignRoleFromAuthority​(NodeRef filePlan,
                                       String role,
                                       String authorityName)
        Unassign a role from an authority
        Parameters:
        filePlan - file plan
        role - role
        authorityName - authority name