Difference between revisions of "Task Delegations"

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


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.
===== Introduction =====
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'''.


'''How it Works'''
===== Managing Delegation =====
Delegated tasks 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 all see all tasks owned by others that are delegated to you.
#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'''.


'''To create or edit a Delegation Rule:'''
===== Acting as a Delegate User =====
# Go to '''{Login Name} > Personal Settings > Task Delegations'''
#In the title bar, point to settings icon and click '''Access Management''' under '''Administration'''.
# Select an existing rule or click '''[New Delegation Rule]'''  
#In '''Access Management''', click '''Users'''.
# Fill in the settings.
#Click any user in the '''Name column'''.
# Click '''[Save]'''.
#Click '''Edit'''.
#Select '''Act as delegation proxy''' checkbox.
#Click '''Save'''.


;Settings:
===== To Proxy Login =====
:;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.
#In the title bar, point to the logged-in user and click '''Become Delegate'''.
#Select the '''Principal User'''.
#Select '''Delegation Role'''.
#Click '''Submit'''


:;To User: The user who is to be assigned the tasks. All tasks that meet the conditions specified in this rule appear in the that user's list of tasks.
===== Web.xml changes required =====
 
:{|
:;Application: The application in which the user's Tasks are delegated.
<pre>
:: Use this setting to fully or partially disengage a user from an application, by delegating all tasks they own in that application.
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/
:: (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.)
<servlet>
 
        <servlet-name>delegateeLogin</servlet-name>
:;Role: {{TBD|}}
        <servlet-class>com.es.relationals.DelegateeLogin</servlet-class>
:: Use this setting to transition a user out of a role, by delegating tasks visible to that role.
</servlet>
:: For example, a manager/agent could transfer agent tasks, while retaining manager tasks.
<servlet-mapping>
:: Alternatively, manager tasks and agent tasks could be delegated to different people.
    <servlet-name>delegateeLogin</servlet-name>
 
    <url-pattern>/delegateeLogin</url-pattern>
:;From Date: The date at which tasks owned by the From User are visible in the To User's task list.
</servlet-mapping>
::{{TBD|Inclusive?}}
</pre>
 
|}
:;To Date: The date at which tasks owned by the From User are no longer visible in the To User's task list.
::{{TBD|Inclusive?}}

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>