User Role Manager Service
The User Role Manager Service (URM) Service Type provides methods for returning user, group, role and security label information from Security Providers registered in K2. This service is mostly used internally by K2, but can also be used for task allocation or group and role membership queries. It is sometimes helpful to query user information to determine what type of information is returned by the query and subsequently used by K2 to do things like assign tasks to users. This is especially true if you have multiple identity providers that you use in your processes, for instance from AD and AAD. A service instance of this service is normally registered automatically when you install K2. You would not normally need to configure a Service Instance of this service
Service Authentication
The following Authentication Modes may be used with the Service Type:
- Impersonate
- ServiceAccount
- Single Single-on
- Static
Service Keys (Service Instance Configuration Settings)
| Key | Can be modified | Data Type | Sample Value | Notes |
|---|---|---|---|---|
| Host Server Connection String | Yes | Text | Integrated=True;IsPrimaryLogin=True; Authenticate=True; EncryptedPassword=False;Host=localhost;Port=5555 | Connection string to the K2 server |
| FindUsersDefaultFilter | Yes | Text | groupname=null;size=100 |
The groupname value must be left as is. The size value determines the number of users returned at a time. The default value is set to 100 for optimal system performance. The size value can be increased or decreased depending on the requirement. Increasing the value of this setting could negatively impact the performance of your system. |
Service Objects
The User Role Manager Service Instance creates four Service Objects: Group, Label, Role, and User. See the screen shot below for methods exposed by these Service Objects.
SmartObjects
K2 automatically generates SmartObjects for these Service Objects. SmartObjects are automatically created when selecting the Generate SmartObjects for this Service Instance check box when creating a new Service Instance. Designers may use the available Service Objects in this service to create advanced SmartObjects using the available K2 SmartObject design tools. It is recommended to use the K2 Design tools to create SmartObjects rather than generating SmartObjects, since this allows better control over the naming, behavior and design of the SmartObject and its methods and properties.