UserRole 2.5 Update
This topic describes the function which can be used to update an user role.
Parameters
| Name | Type | Direction | Description |
|---|---|---|---|
| psAuthContext | String | InOut | Deprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services making this parameter redundant. |
| psUserRoleId | String | In | The element name of the user role (e.g. VUSERROLEADMINISTRATOR) |
| psXMLMetaData | String | In | Metadata XML structure with the metadata that will be set on the current object |
Requirements are:
- Only an 'Administrator' user can update an user role.
Note that:
- User roles can be used to define permission levels.
- The
levelattribute on theishfieldelement must be 'none'. - In order to rename the user role you can add the field
FISHUSERROLENAMEwith the new user role name topsXMLMetaData. - To deactivate the user role, add the following statement to
psXMLMetaData<ishfield name='FISHOBJECTACTIVE' level='none' ishvaluetype='element'>FALSE</ishfield>