Difference between revisions of "Task Delegations"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''{Login Name} > My Settings > Task Delegations'''
<includeonly>==== Delegations ====</includeonly>


===About Task Delegations===
===== Introduction =====
Delegated tasks that have a due date are visible to the assignee along with tasks they own. When viewing "My Tasks", for example, you see all tasks that were specifically assigned to you, as before, but you also see all tasks owned by others that are delegated to you.
Proxy configuration feature enables a user to perform the following configurations:
#'''Manage Delegation''' – '''Manage Delegation''' enables a '''Principal User''' to delegate '''Principal User'''’s profile to a '''Delegate User''' to work on behalf of the '''Principal User'''.
##'''Principal User''' - User delegating the profile to a '''Delegate User'''.
##'''Delegate User''' - User receiving the delegation from a '''Principal User'''.
##'''Manage Delegation''' is available to the user only when '''Manage Delegation''' permission is enabled in the user’s '''Access Profile'''. If '''Manage Delegation''' option is enabled, the user can create and manage delegations. '''Principal Users''' having '''Manage Delegation''' permission can create delegation for themselves as well as for other users reporting to the '''Principal User'''. Users having administrative permissions can enable '''Manage Delegation''' option.
#'''Act as delegate''' - '''Act as delegate proxy option''' enables the user to accept delegations. Only the users with '''Act as delegate proxy option''' can be selected for a '''Delegate User'''. Users having administrative permissions can enable '''Act as delegate proxy option'''.
#'''Proxy Login''' – '''Proxy Login''' allows the '''Delegate User''' to log in as a delegation to the '''Principal User'''. In proxy mode, the '''Delegate User''' can see only the roles assigned in the configuration and perform actions confined to the assigned roles. The '''Delegate User''' can log in as a delegation as long as the proxy assignment or delegation is active. The '''Delegate User''' actions are recorded in the audit log as "'''Delegate User''' on behalf of '''Principal User''' Modified Subject from old value to new value”. A '''Delegate User''' cannot transfer a proxy assignment to another '''Delegate User'''.
#'''Custom Access Criteria''' – '''Custom Access Criteria''' allows the user to access and manage individual records based on the data in the record, characteristics of the current user or any other information. For more information, see [[Custom Access Criteria]]. The '''Delegate User''' can perform an action mentioned in '''Access Control''' only when the '''Custom Access Criteria''' permission is allowed. For example, loggedInUser.isDelegateeLogin is a new variable that allows the '''Delegate User''' to perform actions under '''Access Control''' in '''Custom Access Criteria'''.


:'''Note:'''<br>Tasks that do not have a due date can be reassigned, but cannot be delegated. (Delegation is intended to ensure that time-dependent tasks are carried out within the required time frame.)
===== Managing Delegation =====
#In the title bar, point to the logged-in user and click '''My Settings'''.
#In '''Personal Settings''', click '''Delegations'''.
#To create a new delegation, click '''New Delegation'''.
##By default, '''Active checkbox''' is selected.
##Select the '''Principal User''' from the drop-down. The '''Principal User''' drop-down displays the users reporting to the  logged-in user.
##Select the application from the drop-down. The '''Application''' drop-down displays the applications available to the '''Principal User'''.
##Click the search icon to select the '''Delegate User'''. Delegate Users displayed depend on the '''Application''' selected and '''Act as delegate''' option enabled.
##By default, Use the delegate’s '''Access Profile''' is selected. If this option is cleared, the delegate uses '''Principal User'''’s access profile.
##Click the search icon to select the '''Delegation Roles'''. This option is available only if '''Switch Roles''' option is enabled in '''Company Information'''. If '''Switch Roles''' option is disabled, all the roles of '''Principal User''' are available by default to the '''Delegate User'''.
##Click '''Save'''.


There is also a view that is restricted to delegated tasks, and the ability to restrict record selections to Tasks that are delegated in a [[View Filters#Filter by Record Ownership|View]] or [[Report Filters#Filter by Record Ownership|Report]].
===== Acting as a Delegate User =====
#In the title bar, point to settings icon and click '''Access Management''' under '''Administration'''.
#In '''Access Management''', click '''Users'''.
#Click any user in the '''Name column'''.
#Click '''Edit'''.
#Select '''Act as delegation proxy''' checkbox.
#Click '''Save'''.


When viewing a delegated task, the summary shows who it was delegated by.
===== To Proxy Login =====
#In the title bar, point to the logged-in user and click '''Become Delegate'''.
#Select the '''Principal User'''.
#Select '''Delegation Role'''.
#Click '''Submit'''


When a delegated task is completed, the summary shows who completed it, and who it was completed "on behalf of". So if Fred's task is delegated to Mary, the completion message shows that it was completed by Mary, "on behalf of Fred".
===== Web.xml changes required =====
 
:{|
===Working with Delegated Tasks===
<pre>
 
Add the below code snippet before </web-app> tag of web.xml file under the path "$INSTALL_DIR/profiles/LJP/workspace/webapps/networking/WEB-INF/
====Creating and Editing Delegation Rules====
<servlet>
Delegation Rules make [[Tasks]] owned by one person visible to someone else. You specify the conditions that determine which tasks are delegated, and the period of time for which the delegation rule is active.
        <servlet-name>delegateeLogin</servlet-name>
 
        <servlet-class>com.es.relationals.DelegateeLogin</servlet-class>
'''To create or edit a Delegation Rule:'''
</servlet>
# Go to '''{Login Name} > My Settings > Task Delegations'''
<servlet-mapping>
# Select an existing rule or click '''[New Delegation Rule]'''
    <servlet-name>delegateeLogin</servlet-name>
# Fill in the settings.
    <url-pattern>/delegateeLogin</url-pattern>
# Click '''[Save]'''.
</servlet-mapping>
 
</pre>
====Settings====
|}
:;From User: The user who's tasks are to be delegated. If there are people who report to you, you can set up delegation rules for them, as well as for yourself. Otherwise, you can set up rules only for yourself.
 
:;To User (''assignee''): The user who is to be assigned the tasks. All tasks that meet the conditions specified in this rule appear in that user's list of tasks.
 
:;Application: The application in which the user's Tasks are delegated.
:: Use this setting to fully or partially disengage a user from an application, by delegating all tasks they own in that application.
:: (If there is a rule for each of the roles they can assume, they are fully disengaged from the application. If they can assume multiple roles, and only some are delegated, they are partially disengaged.)
 
:;Role: Select the user's role in the application. All tasks that can be seen by someone in that role are added to the assignee's view of tasks. (Although manually-created tasks are assigned to a specific user, tasks created by [[Processes]] and [[Rules]] can be assigned to a [[Role]]. With this setting, all tasks visible to that role are visible to the assignee.)
:::* Use this setting to transition a user out of a role, by delegating tasks visible to that role.
:::* For example, a manager/agent could transfer agent tasks, while retaining manager tasks.
:::* Alternatively, manager tasks and agent tasks could be delegated to different people.
 
:;From Date: Tasks with a due date on or after this date are shown in the assignee's task list.
::The delegation rule applies at midnight, at the start of that day.
 
:;To Date: Optional. If this value is not specified, the rule is open-ended.
::Otherwise, tasks with a later due date are not shown in the assignee's task list.
::The delegation rule stops at midnight, at the end of that day.

Latest revision as of 07:58, 6 August 2018


Introduction

Proxy configuration feature enables a user to perform the following configurations:

  1. Manage DelegationManage Delegation enables a Principal User to delegate Principal User’s profile to a Delegate User to work on behalf of the Principal User.
    1. Principal User - User delegating the profile to a Delegate User.
    2. Delegate User - User receiving the delegation from a Principal User.
    3. Manage Delegation is available to the user only when Manage Delegation permission is enabled in the user’s Access Profile. If Manage Delegation option is enabled, the user can create and manage delegations. Principal Users having Manage Delegation permission can create delegation for themselves as well as for other users reporting to the Principal User. Users having administrative permissions can enable Manage Delegation option.
  2. Act as delegate - Act as delegate proxy option enables the user to accept delegations. Only the users with Act as delegate proxy option can be selected for a Delegate User. Users having administrative permissions can enable Act as delegate proxy option.
  3. Proxy LoginProxy Login allows the Delegate User to log in as a delegation to the Principal User. In proxy mode, the Delegate User can see only the roles assigned in the configuration and perform actions confined to the assigned roles. The Delegate User can log in as a delegation as long as the proxy assignment or delegation is active. The Delegate User actions are recorded in the audit log as "Delegate User on behalf of Principal User Modified Subject from old value to new value”. A Delegate User cannot transfer a proxy assignment to another Delegate User.
  4. Custom Access CriteriaCustom Access Criteria allows the user to access and manage individual records based on the data in the record, characteristics of the current user or any other information. For more information, see Custom Access Criteria. The Delegate User can perform an action mentioned in Access Control only when the Custom Access Criteria permission is allowed. For example, loggedInUser.isDelegateeLogin is a new variable that allows the Delegate User to perform actions under Access Control in Custom Access Criteria.
Managing Delegation
  1. In the title bar, point to the logged-in user and click My Settings.
  2. In Personal Settings, click Delegations.
  3. To create a new delegation, click New Delegation.
    1. By default, Active checkbox is selected.
    2. Select the Principal User from the drop-down. The Principal User drop-down displays the users reporting to the logged-in user.
    3. Select the application from the drop-down. The Application drop-down displays the applications available to the Principal User.
    4. Click the search icon to select the Delegate User. Delegate Users displayed depend on the Application selected and Act as delegate option enabled.
    5. By default, Use the delegate’s Access Profile is selected. If this option is cleared, the delegate uses Principal User’s access profile.
    6. Click the search icon to select the Delegation Roles. This option is available only if Switch Roles option is enabled in Company Information. If Switch Roles option is disabled, all the roles of Principal User are available by default to the Delegate User.
    7. Click Save.
Acting as a Delegate User
  1. In the title bar, point to settings icon and click Access Management under Administration.
  2. In Access Management, click Users.
  3. Click any user in the Name column.
  4. Click Edit.
  5. Select Act as delegation proxy checkbox.
  6. Click Save.
To Proxy Login
  1. In the title bar, point to the logged-in user and click Become Delegate.
  2. Select the Principal User.
  3. Select Delegation Role.
  4. Click Submit
Web.xml changes required
Add the below code snippet before </web-app> tag of web.xml file under the path "$INSTALL_DIR/profiles/LJP/workspace/webapps/networking/WEB-INF/
<servlet>
        <servlet-name>delegateeLogin</servlet-name>
        <servlet-class>com.es.relationals.DelegateeLogin</servlet-class>
</servlet>
<servlet-mapping>
	    <servlet-name>delegateeLogin</servlet-name>
	    <url-pattern>/delegateeLogin</url-pattern>
</servlet-mapping>