Unofficial Content

Description

 Represents a user of the organization.

Properties

Property Type Access Description
Id WorkflowUserId Read Identifier (Login)
Name WorkflowName Read/ Write Name
Email WorkflowEmail Read/ Write E-mail address
Password WorkflowPassword Write Password
Workload Numeric Read Number of pending tasks
isConnected Boolean Read Indicates if the user is connected
isBlocked Boolean Read Indicates if the user is blocked
isOutOfOffice Boolean Read Indicates if the user is out of office
Roles Collection (WorkflowRole) Read Associated functional roles
OrganizationalUnits Collection (WorkflowOrganizationalUnits) Read Associated User Organizational Units
Error WorkflowError Read Error
Access Level (*) WorkflowAccessLevel Read User Access Level
Restrictions (Deprecated) Collection (WorkflowRestriction) Read Associated restrictions

(*) It only applies to GXflow 8.0.

Methods

  • GetWorklist

 This method allows recovering the user Worklist matching the specified filter and in the specified order.

 GetWorklist (filter): Collection (WorkflowWorkitem)

Name Type Movement Description
filter WorkflowFilter Valid Filters: From, To, State, ProcessInstance, Subject, ProcessDefinition, Activity, User, Role, Priority, WithWarning, Relevant Data Input Filter

 Note: (*) (**)

  •  GetWorklistOrderBy

This method allows recovering the user Worklist matching the specified filter and in the specified order.

 GetWorklistOrderBy (filter, order): Collection (WorkflowWorkitem)

Name Type Movement Description
filter WorkflowFilter Valid Filters: From, To, State, ProcessInstance, Subject, ProcessDefinition, Activity, User, Role, Priority, WithWarning Input Filter
order Numeric (WorkflowOrder.ID_ASC,  WorkflowOrder.ID_DESC,  WorkflowOrder.CREATED_ASC,  WorkflowOrder.CREATED_DESC,  WorkflowOrder.PRIORITY_ASC,  WorkflowOrder.PRIORITY_DESC,  WorkflowOrder.STATE_ASC,  WorkflowOrder.STATE_DESC,  WorkflowOrder.WITH_WARNING_ASC,  WorkflowOrder.WITH_WARNING_DESC,  WorkflowOrder.SUBJECT_ASC,  WorkflowOrder.SUBJECT_DESC,  WorkflowOrder.ENDED_ASC,  WorkflowOrder.ENDED_DESC) Input Order

 Note: (*) (**)

  •  ListCreatableProcessDefinitions

 This method returns a collection with the processes definitions based on which the user may create new instances matching the specified filters.

 ListCreatableProcessDefinitions (filter): Collection (WorkflowProcessDefinition)

Name Type Movement Description
filter WorkflowFilter Valid Filters: Name Input Filter

 Note: (*)

  •  ListCreatableProcessDefinitionsOrderBy

 This method returns a collection with the process definitions based on which the user may create new instances matching the specified filters in the specified order.

ListCreatableProcessDefinitionsOrderBy (filter, order): Collection (WorkflowProcessDefinition)

Name Type Movement Description
filter WorkflowFilter Valid Filters: Name Input Filter
order Numeric (WorkflowOrder.ID_ASC,  WorkflowOrder.ID_DESC,  WorkflowOrder.NAME_ASC,  WorkflowOrder.NAME_DESC) Input Order

 Note: (*)

  • GetOrganizationalUnitRoles

 This method allows to get the roles associated to an organziational unit.

 GetOrganizationalUnitRoles (organizationalUnit): Collection (WorkflowRole)

Name Type Movement Description
organizationalUnit WorkflowOrganizationalUnit Input Reference Organizational Unit

 

  •  AssignRole

 This method allows to assing a role to the user.

 AssignRole (role)

Name Type Movement Description
role WorkflowRole Input Rol to be added

 

  • AssignRoleToOrganizationalUnit 

 This method allows to assign organizational units to a role.

 AssignRoleToOrganizationalUnit (organizationalUnit, role)

Name Type Movement Description
organizationalUnit WorkflowOrganizationalUnit Input Organizational Unit
Role WorkflowRole Input Rol to be added

 

  • UnassignRole

 This method allows to unassing a role to the user.

 UnassignRole (role)

Name Type Movement Description
Role WorkflowRole Input Rol to be eliminated

  

  • UnassignRoleFromOrganizationalUnit

 This method allows to unassign roles from an organizational unit.

 UnassignRoleFromOrganizationalUnit (organizationalUnit) 

Name Type Movement Description
organizationalUnit WorkflowOrganizationalUnit Input Organizational Unit to be eliminated

  

  •  AssignOrganizationalUnit

 This method allows to assign organizational units to the user.

 AssignOrganizationalUnit (organizationalUnit) 

Name Type Movement Description
organizationalUnit WorkflowOrganizationalUnit Input Organizational Unit to be added

 

  •  UnassignOrganizationalUnit

 This method allows to unassign organizational units to the user.

 UnassignOrganizationalUnit (organizationalUnit) 

Name Type Movement Description
organizationalUnit WorkflowOrganizationalUnit Input Organizational Unit to be eliminated

  

  • RebuildWorklist

 This method allows rebuilding the worklist of a user.

 RebuildWorklist ()

 

  • Block

 Locks the user

 Block ()

 

  •  Unblock

 Unlocks the user

 Unblock ()

 

  •  ResetPassword

This method allows to change the password to a fixed password : "1234".

 ResetPassword ()

 

  •  ResetPasswordByMail

This method generates a random password and emails it to the user.

 ResetPasswordByMail ()

 

  • ChangePassword

 This method allows to update the user password.

 ChangePassword (currentPassword, newPassword)

Name Type Movement Description
currentPassword Character Input Actual Password
newPassword Character Input New Password

 

  •  AddRole (Deprecated)

 This method allows adding a functional role to the user.

 AddRole (role) 

Name Type Movement Description
role WorkflowRole Input Rol to be added

 

  •  RemoveRole (Deprecated)

 This method allows dissociating a functional role from the user.

 RemoveRole (role) 

Name Type Movement Description
role WorkflowRole Input Rol to be eliminated

 

  •  AddRestriction (Deprecated)

 This method allows adding a restriction to the user or to a specific role of the user (in case this role is specified).

 AddRestriction(restriction, role) 

Name Type Movement Description
restriction WorkflowRestriction Input Restricción a agregar
role 0 / WorkflowRole Input If the value is 0, the restriction is added to user (applies to all the user roles). If not the restriction is added to the rol specified.

 

  •  RemoveRestriction (Deprecated)

 This method allows removing a restriction from the user or from a specific user role (in case this role is specified).

 RemoveRestriction (restriction, role) 

Name Type Movement Description
restriction WorkflowRestriction Input Restriction to be eliminated
role 0 / WorkflowRole Input  If the value is 0, the restriction is eliminated at user level. If not the restriction is eliminated to the rol specified.

 

  • SetOutOfOffice

 This method allows to update the user`s availability status.

 SetOutOfOffice (startDate, ReturnDate, message, substitute) 

Name Type Movement Description
startDate Date Input Indicates when starts being out of the office
returnDate Date Input Indicates when returns to the office
message WorkflowMessage  Input Allows to leave a message
substitute WorkflowUser Input Indicates who is the substitute

 

  •  DisableOutOfOffice

 This method allows to set the user`s status "in office"

 DisableOutOfOffice ()

 

(*) Depends on Fetch and Max Fetch properties.

(**)  It only applies to Connected User 

 

See Also





Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant