Custom Functions
Java custom functions cannot be used within a presentation parameter or in an expression editor when defining human tasks. This is not the same as the way in which you use other Java custom functions. If you wanted to use one, you would need to declare the function as being global in the Server Console; you could not refer to them in a contribution. While this works, it can be a problem as users would need to deploy and manage them independently from the package deployment process. Restated, unlike other functions, human task custom functions cannot be just included in a contribution so that a human task process can access it.
While using custom functions within a contribution appears to be a simple way of using them, this limitation prevents them from being easily used within a human task context.
This limitation exists because at runtime, the server expects the task state process to have references for custom function contributions, and this is not possible.
Human Tasks Custom Functions
b4p:getProcessStakeholders()
Description: Returns the stakeholders of the process.
b4p:getBusinessAdministrators()
Description: Returns the business administrators of the process.
b4p:getProcessInitiator()
Description: Returns the initiator of the process.
b4p:getLogicalPeopleGroup(Logical People Group Name)
Description: Returns the value of a logical people group
Parameter:
- •LogicalPeopleGroupName: The name of the logical people group (xsd:string).
b4p:getActualOwner(People Activity Name)
Description: Returns the actual owner of the task associated with the people activity.
Parameter:
PeopleActivityName: The people activity name (xsd:string).
b4p:getTaskInitiator(People Activity Name)
Description: Returns the initiator of the task. Evaluates to an empty b4p:user in case there is no initiator.
Parameter:
- •PeopleActivityName: The people activity name (xsd:string).
b4p:getTaskStakeholders(People Activity Name)
Description: Returns the stakeholders of the task. Evaluates to an empty b4p:organizationalEntity in case of an error.
Parameter:
- •PeopleActivityName: The people activity name (xsd:string).
b4p:getPotentialOwners(People Activity Name)
Description: Returns the potential owners of the task associated with the people activity.
Parameter:
- •PeopleActivityName: The people activity name (xsd:string).
b4p:getAdministrators(People Activity Name)
Description: Returns the administrators of the task associated with the people activity.
Parameter:
- •PeopleActivityName: The people activity name (xsd:string).
b4p:getTaskPriority(People Activity Name)
Description: Returns the priority of the task associated with the people activity.
Parameter:
- •PeopleActivityName: The people activity name (xsd:string).
abxb4p:getComments(People Activity Name)
Description: Returns the comments of given people activity.
Parameter:
- •PeopleActivityName: The people activity name (xsd:string).
abxb4p:getTaskId([peopleActivityName])
Description: Returns the id of the WS-HT task given the people activity name.
Parameters:
- •peopleActivityName: The people activity name (xsd:string).
abxb4p:getTaskUrl([peopleActivityName])
Description: Returns the URL to task service given the people activity name.
Parameters:
- •peopleActivityName: The people activity name (xsd:string).
abxb4p:getInboxUrl()
Description: Returns the base URL to the task service application. Useful when sending email containing an Process Central link.
WS-HT (Human Task) Custom Functions
htd:getPotentialOwners([Task Name])
Description: Returns the potential owners of the task.Evaluates to an empty htd:organizationalEntity in case of an error. If the task name is not present the current task is considered.
Parameter:
- •TaskName: The optional name of the Task to retrieve data from.
htd:getActualOwner([Task Name])
Description: Returns the actual owner of the task. Evaluates to an empty htd:user in case there is no actual owner. If the task name is not present the current task is considered.
Parameter:
- •TaskName: The optional name of the Task to retrieve data from.
htd:getTaskInitiator([Task Name])
Description: Returns the initiator of the task. Evaluates to an empty htd:user in case there is no initiator. If the task name is not present the current task is considered.
Parameter:
- •TaskName: The optional name of the Task to retrieve data from.
htd:getTaskStakeholders([Task Name])
Description: Returns the stakeholders of the task. Evaluates to an empty htd:organizationalEntity in case of an error. If the task name is not present the current task is considered.
Parameters:
- •TaskName: The optional name of the Task to retrieve data from.
htd:getBusinessAdministrators([Task Name])
Description: Returns the business administrators of the task. Evaluates to an empty htd:organizationalEntity in case of an error. If the task name is not present the current task is considered.
Parameters:
- •TaskName: The optional name of the Task to retrieve data from.
htd:getExcludedOwners([Task Name])
Description: Returns the excluded owners. Evaluates to an empty htd:organizationalEntity in case of an error. If the task name is not present the current task is considered.
Parameters:
- •TaskName: The optional name of the Task to retrieve data from.
htd:getTaskPriority([Task Name])
Description: Returns the priority of the task. Evaluates to '-1' in case of an error. If the task name is not present the current task is considered.
Parameters:
- •TaskName: The optional name of the Task to retrieve data from.
htd:getInput(Part Name, [Task Name])
Description: Returns the part of the task's input message. If the task name is not present the current task is considered.
Parameters:
- •PartName: The name of the part within the task's input message.
- •TaskName: The optional name of the Task to retrieve data from.
htd:getLogicalPeopleGroup(Logical People Group Name, [Task Name])
Description: Returns the value of a logical people group. In case of an error (e.g., when referencing a non existing logical people group) the htd:organizationalEntity contains an empty user list. If the task name is not present the current task is considered.
Parameters:
- •LogicalPeopleGroupName: The name of an in-scope logical people group.
- •TaskName: The optional name of the Task to retrieve data from.
htd:union(Set 1, Set 2)
Description: Constructs an organizationalEntity containing every user that occurs in either set1 or set2, eliminating duplicate users.
Parameters:
- •Set1: The first set - one of htd:organizationalEntity, htd:users, or htd:user.
- •Set2: The second set - one of htd:organizationalEntity, htd:users, or htd:user
htd:intersect(Set 1, Set 2)
Description: Constructs an organizationalEntity containing every user that occurs in both set1 or set2, eliminating duplicate users.
Parameters:
- •Set1: The first set - one of htd:organizationalEntity, htd:users, or htd:user.
- •Set2: The second set - one of htd:organizationalEntity, htd:users, or htd:user
htd:except(Set 1, Set 2)
Description: Constructs an organizationalEntity containing every user that occurs in set1 but not in set2.
Parameters:
- •Set1: The first set - one of htd:organizationalEntity, htd:users, or htd:user.
- •Set2: The second set - one of htd:organizationalEntity, htd:users, or htd:user.
Process Developer Extensions
abxht:getTaskId([taskName])
Description: Returns the id of the WS-HT task given the people activity name. If the task name is not present the current task is considered.
Parameter:
- •TaskName: The optional name of the task to retrieve data from.
abxht:getTaskUrl([taskName])
Description: Returns the URL to task service. If the task name is not present the current task is considered.
Parameter:
- •TaskName: The optional name of the task to retrieve data from.
abxht:getInboxUrl()
Description: Returns the base URL to the task service application.
abxht:getOutput([Part Name, [Task Name]])
Description: Returns the task’s output message. If the part name is omitted, then the first part is used. If the task name is not present, then the current task is considered.
Parameters:
- •PartName: The optional name of the part within the task’s output message.
- •TaskName: The optional name of the task to retrieve data from.