† session_get_role ( session )

Is a function to get the active role of the user connected by the session input parameter

Version

Input

parameters:

session: is the session id obtained in the session_init call

Output

parameters:

result: is an XML that contains the role list

roles

id: is the role_id

code: is the short-name of the role, this param is needed for the session_set_role () call

category: the role category

description: is the full-name of the role

ErrorMsg: any fault in the call, either in the validation of input parameters, errors in the connection to the database or any other error, this parameter returns the error message produced

Request

sample:

session_get_role_list ( “LCAAAAAAAAAAAAAAAAAAAAAAAA”);

Response

sample:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<result>

        <role>

<id>role_id</id><code>role short-name</code>

<category> CASE | PRO | MNGR | ADMIN </category>

<description>role full-name</description>

</role>

</result>

<ErrorMsg></ErrorMsg>

Notes:

Deprecated. To be replaced by session_get ()