Difference between revisions of "Primary role"

From SmartWiki
Jump to: navigation, search
(Undo revision 17938 by Arthur (Talk))
Line 1: Line 1:
{{UnderConstruction}}
+
A typical URL to bring a user to a SmartSimple login page will be in the following format:
 +
<nowiki>http://grants.smartsimplebk.us/s_Login.jsp?lang=1&prole=0</nowiki>
  
<nowiki>http://grants.smartsimplebk.us/s_Login.jsp?lang=1&prole=0</nowiki>
+
However, if one replaces the ''0'' in the URL's ''prole=0'' suffix with the [[roleid|role ID]] of the role they wish their login session to be constrained to, the user will be logged in and be presented with the portal view associated with that role. This method is referred to as ''passing a parameter'' with the login URL. The role ID specified in the URL is referred to as the ''primary role''.
  
This allows for the ability to silo a user into a particular portal view when they possess multiple roles with multiple different portals (i.e. access to different UTA's and views that don't work well together and need to be mutually exclusive). The login page allows you to pass in a parameter for a [[roleid|role ID]].
+
This allows for the ability to silo a user into a particular portal view when they possess multiple roles with multiple different portals.
  
 
==Returning the primary role with a variable==
 
==Returning the primary role with a variable==
Line 12: Line 13:
  
 
  Note: do not use the ''@me.'' syntax, i.e. ''@me.primaryroleid@''.
 
  Note: do not use the ''@me.'' syntax, i.e. ''@me.primaryroleid@''.
 +
 +
In the normal course, the ''@primaryroleid@'' variable will return "0". If the user has logged in using the method described above, the variable will return the [[roleid|role ID]] of the "primary role" used to log in.
  
 
<!--Related Tickets:
 
<!--Related Tickets:

Revision as of 13:54, 29 August 2013

A typical URL to bring a user to a SmartSimple login page will be in the following format: http://grants.smartsimplebk.us/s_Login.jsp?lang=1&prole=0

However, if one replaces the 0 in the URL's prole=0 suffix with the role ID of the role they wish their login session to be constrained to, the user will be logged in and be presented with the portal view associated with that role. This method is referred to as passing a parameter with the login URL. The role ID specified in the URL is referred to as the primary role.

This allows for the ability to silo a user into a particular portal view when they possess multiple roles with multiple different portals.

Returning the primary role with a variable

Use the following variable syntax to return the roleid associated with the user's primary role:

@primaryroleid@
Note: do not use the @me. syntax, i.e. @me.primaryroleid@.

In the normal course, the @primaryroleid@ variable will return "0". If the user has logged in using the method described above, the variable will return the role ID of the "primary role" used to log in.