Task Allocation Service

The Task Allocation Service Service Type provides methods used to assign tasks to users based on round-robin algorithms, and to retrieve hierarchical manager/reports information from the user information store, which is most often Active Directory.

Service Authentication

The following Authentication Modes may be used with the Service Type:

Service Keys (Service Instance Configuration Settings)

Key Can be modified Data Type Sample Value Notes
Default User Yes Text SECURTYLABEL:DOMAIN\UserName

The DefaultUser is the user name that various methods use should there be an error in the lookup (eg: a non-existent role name, or missing manager in AD). This username prevents the process from entering an error state because no user is found. Typically, this Default User would then manually redirect the work item to the correct person.

K2Server Yes Text LOCALHOST The name of the K2 server.
K2ServerPort Yes Text 5555 Enter the K2 Server Port.
RoundRobinSO Yes Text RoundRobinSO

The name of the SmartObject to use for performing RoundRobin calculations. The standard RoundRobin SmartObject is a SmartBox SmartObject which contains the necessary properties to perform the required calculations.

You can create your own SmartObject if you wish to adjust he behavior of the round-robin algorithm and specify the name of your SmartObject here. However, the SmartObject must contain the following 3 properties (with these exact names):

  • RoleName (string) (key)
  • LastUserName (string)
  • LastDateTime (datetime)

K2LogConnection Yes Text Data Source=[SQLServerName];Initial Catalog=K2;Integrated Security=SSPI;Persist Security Info=False; SQL connection string to the K2 database.

Service Objects

The Task Allocation Service Instance creates two Service Objects.

(See the tables below for more information on the available Service Object methods)

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.