Skip navigation links

oracle.bpel.services.workflow.user
Interface IUserMetadataService

public interface IUserMetadataService

The UserMetadataService provides methods for querying and updating workflow metadata specific to users or groups. It is used for dealing with workflow assignment rules, user views, user preferences and vacation information.

An instance of IUserMetadataService can be created by calling IWorkflowServiceClient.getUserMetadataService(). An instance of IWorkflowServiceClient can be created using the WorkflowServiceClientFactory.

All the UserMetadataService methods take IWorkflowContext as their first parameter. The IWorkflowContext object allows the UserMetdataService to validate that the method is being called by an authenticated user, and that the user has the necessary authority to perform the action being requested. The IWorkflowContext object also contains information on the user's timezone and locale. An IWorkflowContext object can be obtained by calling ITaskQueryService.authenticate(java.lang.String, java.lang.String, java.lang.String, java.lang.String) or ITaskQueryService.createContext(HttpServletRequest).

For most methods, users can only query and update their own metadata - they are not permitted to access metadata belonging to other users. In the case of metadata for groups (specifically for workflow rules), only users who are registered as the owner of that group can access the metadata. However, users with administrator privileges can usually access any user or group's metadata.

Many of the parameters and return types of the methods are JAXB model objects from the packages oracle.bpel.services.workflow.user.model, oracle.bpel.services.workflow.query.model, and oracle.bpel.services.workflow.common.model. These objects do not have public constructors. To create new instances of these objects you should use the appropriate methods on oracle.bpel.services.workflow.user.model.ObjectFactory, oracle.bpel.services.workflow.query.model.ObjectFactory or oracle.bpel.services.workflow.common.model.ObjectFactory

Many of the methods in this API use Participant objects to specify a user or group. A Participant object contains parameters that specify the user or group name, the realm (identity context) of the user, and whether the Participant is a user or group.

Since:

10.1.3.1

Nested Class Summary

static class	IUserMetadataService.UserTaskViewGrantType Enumeration specifying the different grant types that can be used when granting another user access to a UserTaskView.
static class	IUserMetadataService.UserTaskViewType Enumeration specifying the different types of view that can be defined.

Field Summary

static java.lang.String	RULE_ACTION_DELEGATE Rule action: Delegate task to specified user or group
static java.lang.String	RULE_ACTION_DYN_REASSIGN Rule action: Dynamically reasign task using dynamic assignment funtion to select user
static java.lang.String	RULE_ACTION_NOOP Rule action: No operation
static java.lang.String	RULE_ACTION_REASSIGN Rule action: Reassign task to specified user or group
static java.lang.String	RULE_ACTION_SET_OUTCOME Rule action: Set task outcome to specified value
static java.lang.String	RULE_OP_AFTER Rule condition operator: Date occured after
static java.lang.String	RULE_OP_BEFORE Rule condition operator: Date occured before
static java.lang.String	RULE_OP_BEGINS Rule condition operator: String begins with value
static java.lang.String	RULE_OP_CONTAINS Rule condition operator: String contains value
static java.lang.String	RULE_OP_ENDS Rule condition operator: String ends with value
static java.lang.String	RULE_OP_EQ Rule condition operator: equal to "=="
static java.lang.String	RULE_OP_GT Rule condition operator: greater than ">"
static java.lang.String	RULE_OP_GTE Rule condition operator: greater than or equal to ">="
static java.lang.String	RULE_OP_LT Rule condition operator: less than "<"
static java.lang.String	RULE_OP_LTE Rule condition operator: less than or equal to "<="
static java.lang.String	RULE_OP_NEQ Rule condition operator: not equal to "!="
static java.lang.String	RULE_OP_NOT_BEGINS Rule condition operator: String does not begin with value
static java.lang.String	RULE_OP_NOT_CONTAINS Rule condition operator: String does not contain value
static java.lang.String	RULE_OP_NOT_ENDS Rule condition operator: String does not end with value
static java.lang.String[]	VALID_DATE_RULE_OPS Array of valid operators for rule conditions on Date values
static java.lang.String[]	VALID_NUMBER_RULE_OPS Array of valid operators for rule conditions on number values
static java.lang.String[]	VALID_STRING_RULE_OPS Array of valid operators for rule conditions on String values

Method Summary

RuleDetail	createRule(IWorkflowContext ctx, RuleDetail rule) Creates a new rule from a RuleDetail object.
UserViewDetail	createUserTaskView(IWorkflowContext ctx, UserViewDetail view) Creates a new view from the specified UserViewDetail object.
void	decreaseRulePriority(IWorkflowContext ctx, java.lang.String ruleId) Decreases the priority of the specified rule by 1.
void	deleteRule(IWorkflowContext ctx, java.lang.String ruleId) Deletes an existing workflow rule, based on its ruleId.
void	deleteUserTaskView(IWorkflowContext ctx, java.lang.String viewId) Deletes an existing view identifies by its viewId.
GrantedViewList	getGrantedTaskViewList(IWorkflowContext ctx, Participant user) Gets the list of views that have been granted to the specified user by other users.
UserPreferences	getPublicPreferences(IWorkflowContext ctx, Participant user) Gets 'public' preferences for specified user.
RuleDetail	getRuleDetail(IWorkflowContext ctx, java.lang.String ruleId) Returns the full details for a particular rule, identified by its ruleId.
RuleList	getRuleList(IWorkflowContext ctx, Participant user) Returns a list of rules for the specified user or group, as a RuleList object.
RulesetInfo	getRuleSetInfo(IWorkflowContext ctx, Participant user) Deprecated. Rules persistence is no longer configurable, and rules are now persisted internally in the workflow database schema, so this method is now of limited use.
UserViewDetail	getStandardTaskViewDetails(IWorkflowContext ctx, java.lang.String viewId) Gets the full details for a particular standard view, identified by its viewId.
UserViewList	getStandardTaskViewList(IWorkflowContext ctx) Gets the list of standard views which ship with the product, and are available to all users.
UserViewDetail	getUserInboxView(IWorkflowContext ctx, Participant user) Deprecated.
UserPreferences	getUserPreferences(IWorkflowContext ctx, Participant user) Gets the user preferences for the specified user as a UserPreferences object.
UserViewDetail	getUserTaskViewDetails(IWorkflowContext ctx, java.lang.String viewId) Gets the full details for a particular user view, identified by its viewId.
UserViewList	getUserTaskViewList(IWorkflowContext ctx, Participant user) Gets the list of views belonging to the specified user.
VacationInfo	getVacationInfo(IWorkflowContext ctx, Participant user) Gets the current vacation information for the specified user in the form of a VacationInfo object.
void	increaseRulePriority(IWorkflowContext ctx, java.lang.String ruleId) Increases the priority of the specified rule by 1.
UserPreferences	setPublicPreferences(IWorkflowContext ctx, UserPreferences prefs) Sets 'public' preferences for specified user.
UserPreferences	setUserPreferences(IWorkflowContext ctx, UserPreferences prefs) Sets the user preferences for the specified from a UserPreferences object.
VacationInfo	setVacationInfo(IWorkflowContext ctx, VacationInfo vacationInfo) Updates the vacation information for a user using the supplied VacationInfo object.
ViewGrant	updateGrantedTaskView(IWorkflowContext ctx, ViewGrant grant) Allows a grantee to update certain information on a view that has been granted to them.
RuleDetail	updateRule(IWorkflowContext ctx, RuleDetail rule) Updates an existing workflow rule to the definition specified in a RuleDetail object.
UserViewDetail	updateUserTaskView(IWorkflowContext ctx, UserViewDetail view) Updates an existing view to the defintion specified in a UserViewDetail object.

Field Detail

RULE_ACTION_NOOP

static final java.lang.String RULE_ACTION_NOOP

Rule action: No operation

See Also:

Constant Field Values

RULE_ACTION_REASSIGN

static final java.lang.String RULE_ACTION_REASSIGN

Rule action: Reassign task to specified user or group

See Also:

Constant Field Values

RULE_ACTION_DYN_REASSIGN

static final java.lang.String RULE_ACTION_DYN_REASSIGN

Rule action: Dynamically reasign task using dynamic assignment funtion to select user

See Also:

Constant Field Values

RULE_ACTION_DELEGATE

static final java.lang.String RULE_ACTION_DELEGATE

Rule action: Delegate task to specified user or group

See Also:

Constant Field Values

RULE_ACTION_SET_OUTCOME

static final java.lang.String RULE_ACTION_SET_OUTCOME

Rule action: Set task outcome to specified value

See Also:

Constant Field Values

RULE_OP_LTE

static final java.lang.String RULE_OP_LTE

Rule condition operator: less than or equal to "<="

See Also:

Constant Field Values

RULE_OP_GTE

static final java.lang.String RULE_OP_GTE

Rule condition operator: greater than or equal to ">="

See Also:

Constant Field Values

RULE_OP_EQ

static final java.lang.String RULE_OP_EQ

Rule condition operator: equal to "=="

See Also:

Constant Field Values

RULE_OP_NEQ

static final java.lang.String RULE_OP_NEQ

Rule condition operator: not equal to "!="

See Also:

Constant Field Values

RULE_OP_LT

static final java.lang.String RULE_OP_LT

Rule condition operator: less than "<"

See Also:

Constant Field Values

RULE_OP_GT

static final java.lang.String RULE_OP_GT

Rule condition operator: greater than ">"

See Also:

Constant Field Values

RULE_OP_CONTAINS

static final java.lang.String RULE_OP_CONTAINS

Rule condition operator: String contains value

See Also:

Constant Field Values

RULE_OP_NOT_CONTAINS

static final java.lang.String RULE_OP_NOT_CONTAINS

Rule condition operator: String does not contain value

See Also:

Constant Field Values

RULE_OP_BEGINS

static final java.lang.String RULE_OP_BEGINS

Rule condition operator: String begins with value

See Also:

Constant Field Values

RULE_OP_NOT_BEGINS

static final java.lang.String RULE_OP_NOT_BEGINS

Rule condition operator: String does not begin with value

See Also:

Constant Field Values

RULE_OP_ENDS

static final java.lang.String RULE_OP_ENDS

Rule condition operator: String ends with value

See Also:

Constant Field Values

RULE_OP_NOT_ENDS

static final java.lang.String RULE_OP_NOT_ENDS

Rule condition operator: String does not end with value

See Also:

Constant Field Values

RULE_OP_BEFORE

static final java.lang.String RULE_OP_BEFORE

Rule condition operator: Date occured before

See Also:

Constant Field Values

RULE_OP_AFTER

static final java.lang.String RULE_OP_AFTER

Rule condition operator: Date occured after

See Also:

Constant Field Values

VALID_STRING_RULE_OPS

static final java.lang.String[] VALID_STRING_RULE_OPS

Array of valid operators for rule conditions on String values

VALID_DATE_RULE_OPS

static final java.lang.String[] VALID_DATE_RULE_OPS

Array of valid operators for rule conditions on Date values

VALID_NUMBER_RULE_OPS

static final java.lang.String[] VALID_NUMBER_RULE_OPS

Array of valid operators for rule conditions on number values

Method Detail

getVacationInfo

VacationInfo getVacationInfo(IWorkflowContext ctx,
                             Participant user)
                             throws WorkflowException

Gets the current vacation information for the specified user in the form of a VacationInfo object. Vacation information specifies two dates between which the user is unavailable for assignment of tasks. Dynamic Assignment functions will not assign tasks to users who are currently on vacation. If the user has defined any rules that are flagged as being vacation rules, then the start and end dates for the vacation rules will match the vacation start and end dates.

If no vacation information has been set for the user, an empty VactionInfo object is returned.

VacationInfo has the following properties:

• isOnVacation boolean true if current date is between vacation start and end date, otherwise false.
• user PrincipleRefType The user this vacation information is for.
• startDate Calendar start date for vacation period. A null startDate and null endDate indicates that there are no vacation dates currently set for the user.
• endDate Calendar end date for vacation period. A null startDate and null endDate indicates that there are no vacation dates currently set for the user.

• Parameters:

  ctx - authenticated IWorkflowContext for user

  user - Participant user to query information for

  Returns:

  empty VacationInfo object if no vacation information has been set for user, otherwise a VacationInfo object populated with vacation information.

  Throws:

  WorkflowException - if non-admin user attempts to query information for another user, or some other error condition occurs

  setVacationInfo

  VacationInfo setVacationInfo(IWorkflowContext ctx,
                               VacationInfo vacationInfo)
                               throws WorkflowException
  

  Updates the vacation information for a user using the supplied VacationInfo object. Vacation information specifies two dates between which the user is unavailable for assignment of tasks. Dynamic Assignment functions will not assign tasks to users who are currently on vacation. In addition the start and end dates of any rules for the user which are marked as being 'vacation rules' will automatically be updated so that the rule start and end dates match the vacation startand end dates.

  The method validates that both a start and end date have been specified, and that the end date occurs after the start date.

  VacationInfo has the following properties:

  • isOnVacation boolean Not used on update, is set by API when querying vacation info.
  • user PrincipleRefType The user this vacation information is for.
  • startDate Calendar start date for vacation period. Setting a null startDate and null endDate will clear existing vacation dates for the user.
  • endDate Calendar start date for vacation period. Setting a null startDate and null endDate will clear existing vacation dates for the user.

  • Parameters:

    ctx - authenticated IWorkflowContext for user

    vacationInfo - VacationInfo the vacation information to set

    Returns:

    the updated VacationInfo vacation information

    Throws:

    WorkflowException - if non-admin user attempts to update information for another user, or some other error condition occurs

    getRuleSetInfo

    RulesetInfo getRuleSetInfo(IWorkflowContext ctx,
                               Participant user)
                               throws WorkflowException
    

    Deprecated. Rules persistence is no longer configurable, and rules are now persisted internally in the workflow database schema, so this method is now of limited use.

    Returns information relating to the Oracle Business Rules rule set being used to store the rules for a particular user or group, in the form of a RulesetInfo object. This is useful if a client wants to make use of the rules SDK directly for manipulating rules, rather than using the user metadata service. A ruleset is created for each user or group that has workflow assignment rules defined.

    Parameters:

    ctx - authenticated IWorkflowContext for user.

    user - Participant user or group to get ruleset information for.

    Returns:

    RulesetInfo object containing the ruleset information

    Throws:

    WorkflowException

    getRuleList

    RuleList getRuleList(IWorkflowContext ctx,
                         Participant user)
                         throws WorkflowException
    

    Returns a list of rules for the specified user or group, as a RuleList object. The RuleList object contains a List of RuleInfoType objects. Each RuleInfoType object provides summary information about a rule. In order to retreive the full details for a particular rule, the method getRuleDetail(IWorkflowContext, String) should be used.

    The RuleInfoType object has the following properties:

    • ruleType String "USER" or "GROUP". Maintained by API.
    • ruleId String unique identifier for rule. Populated by API on rule creation. ruleId is derived from rule name, and will change if the rule name is changed.
    • ruleName String the name of rule.
    • priority int rule priority. Larger numerical value indicates higher priority. API maintains rule priorities to ensure that there is a continuous numerical sequence.
    • owner PrincipleRefType The owner (user or group) of this rule.
    • workflowId String a rule may optionally be restricted to be triggered only for tasks of a certain type by setting this property to the appropriate TaskDefintionId.
    • startDate Calendar a rule may optioanlly be restricted to only be triggered for tasks assigned after a certain date.
    • endDate Calendar a rule may optioanlly be restricted to only be triggered for tasks assigned before a certain date.
    • isVacationRule boolean if a rule is marked as a vacation rule, then the UserMetdataService will automatically synchonize the rule's start and end dates with the vacation start and end date's for the view's owner.
    • description String an optional description of the rule.
    • createdDate Calendar the date on which the rule was created. Populated automatically by the API on rule creation.
    • updatedDate Calendar the date on which the rule was last updated. Populated automatically by the API on rule creation and update.

    • Parameters:

      ctx - authenticated IWorkflowContext for user

      user - Participant user or group to get RuleList for.

      Returns:

      RuleList object containing list of summary information for each rule

      Throws:

      WorkflowException - if non-admin user attempts to retrieve information for another user, or for a group that they to not own, or some other error condition occurs

      getRuleDetail

      RuleDetail getRuleDetail(IWorkflowContext ctx,
                               java.lang.String ruleId)
                               throws WorkflowException
      

      Returns the full details for a particular rule, identified by its ruleId. Rule details are returned in the form of a RuleDetail object. See createRule(oracle.bpel.services.workflow.verification.IWorkflowContext, oracle.bpel.services.workflow.user.model.RuleDetail) for a description of the RuleDetail object.

      Parameters:

      ctx - authenticated IWorkflowContext for user

      ruleId - String a unique identitier for the rule

      Returns:

      full details for rule, as a RuleDetail object.

      Throws:

      WorkflowException - if non-admin user attempts to retrieve information for a rule belonging to another user or a group that they to not own or have not been granted, or some other error condition occurs.

      createRule

      RuleDetail createRule(IWorkflowContext ctx,
                            RuleDetail rule)
                            throws WorkflowException
      

      Creates a new rule from a RuleDetail object. A user may create rules for themselves, and for any groups that they own. Rules are evaluated when a task is assigned to that user or group - if the task meets the conditions specified in a rule, the rule is triggered, and will attempt to perform an action on the task, as specified in the RuleDetail.

      Rules are evaluated in order of their priority from highest (largest numerical value) to lowest. Only the first rule whose conditions are met will be triggered. Rules of lower priority will be ignored, even if the task also meets their conditions.

      Rules will only be evaluated if the current date is between the rule start and end date. If no rule start and end date is specfied, the rule will always be evaluated.

      If the IsVacationRule flag is set for a rule, then its start and end dates will be automatically synchronized with the user's vacation start and end dates (as configured via the setVacationInfo method in this interface). If no vacation period is currently defined for the user, then the vacation rule's start and end date's will automatically be set in the past, to ensure the rule does not get triggered

      .

      RuleDetail has the following parameters:

      • generalInfo RuleInfoType describes general information about the rule. This is the same information that is returned by the getRuleList(oracle.bpel.services.workflow.verification.IWorkflowContext, oracle.bpel.services.workflow.common.model.Participant) method. RuleInfoType has the following parameters:
        • ruleType String "USER" or "GROUP". Maintained by API.
        • ruleId String unique identifier for rule. Populated by API on rule creation. ruleId is derived from rule name, and will change if the rule name is changed.
        • ruleName String the name of rule. Mandatory.
        • priority int rule priority. Larger numerical value indicates higher priority. API maintains rule priorities to ensure that there is a continuous numerical sequence. If a rule already exists with this priority, this rule will be created with the specified priority, and other rules with the same or higher priority will have their priorities incrementented by 1 to accomodate the new rule. A rule cannot have a priority higher than the total number of rules. If a higer priority is specified, the API will reset the priority for this rule to be the same as the total number of rules.
        • owner PrincipleRefType The owner (user or group) of this rule. Mandatory.
        • workflowId String a rule may optionally be restricted to be triggered only for tasks of a certain type by setting this property to the appropriate TaskDefintionId. Note that TaskDefinitonId changes on each redeployment of a Task definition, so the rule will be restricted to Tasks created for a specific deployment of a Task definition. To have a rule apply to all deployments of a task definition, use taskNamespace instead.
        • taskNamespace String a rule may optionally be restricted to be triggered only for tasks of a certain type by setting this property to the appropriate task definition namespace. Note that task namespace is unique to a task definition type, but does not change between versions or redeployments of the Task definition, so the rule will be triggered by tasks for all versions of the Task definition. If you need to restrict the rule to a specific task definition deployment, use workflowId instead.
        • startDate Calendar a rule may optioanlly be restricted to only be triggered for tasks assigned after a certain date.
        • endDate Calendar a rule may optioanlly be restricted to only be triggered for tasks assigned before a certain date.
        • isVacationRule boolean if a rule is marked as a vacation rule, then the UserMetdataService will automatically synchonize the rule's start and end dates with the vacation start and end date's for the view's owner.
        • description String an optional description of the rule.
        • createdDate Calendar the date on which the rule was created. Populated automatically by the API on rule creation.
        • updatedDate Calendar the date on which the rule was last updated. Populated automatically by the API on rule creation and update.
      • taskTests RuleTestListType A rule may optionally specify a number of test conditions that must be satisified for the rule to be triggered. The RuleTestListType object should be populated with RuleTestType objects. Each RuleTestType defines a test against a single attribute of a Task, and can be added to the RuleTestListType by calling the method RuleTestListType.getTest().add(RuleTestType test). The properties of RuleTestType are:
        • field String used to specify which Task attribute the test is for, using dot-separators to specify the path to attributes. For example, "title", "systemAttributes.createdDate", or "systemMessageAttributes.textAttribute1". The attribute paths for a Task can be determined using the methods ITaskMetadataService.getTaskAttributes(oracle.bpel.services.workflow.verification.IWorkflowContext) or ITaskMetadataService.getTaskAttributesForTaskDefinition(oracle.bpel.services.workflow.verification.IWorkflowContext, java.lang.String).
        • operation String used to specify the operator for the test. The operator should be one of the RULE_OP constants specified in this interface. Note that certain operators are only valid for certain attribute types. The String array constants VALID_DATE_RULE_OPS, VALID_NUMBER_RULE_OPS and VALID_STRING_RULE_OPS list which operators are valid for different attribute types.
        • value String used to specify the value for the test for all attribute types other than dates.
        • dateValue Calendar used to specify the value for the test for date attribute types.
      • payloadTests Not used. Task payload tests are not currently supported. To create rules pased on a payload value, the IRuntimeConfigService can be used to create a PayloadMapping between the payload attribute and a Task flexfield. It is then possible to specify taskTests against the mapped flexfield.
      • action RuleActionType Species the action to be taken if the rule is triggered. An action must be set on the rule. The properties of RuleActionType are:
        • actionType String The actionType must be set to one of the following values:
          • IUserMetadataService.RULE_ACTION_NOOP Rule takes no action. No other fields on the RuleActionType object need to be set.
          • IUserMetadataService.RULE_ACTION_REASSIGN Rule attempts to reassign the task to another user or group. The reassign field of the RuleActionType object must be set with a RuleAssignmentType object. Only the assignee field of the RuleAssignmentType object should be set.
          • IUserMetadataService.RULE_ACTION_DYN_REASSIGN Rule attempts to reassign the task to a user selected from the specified group using the specified dynamic assignment function. The reassign field of the RuleActionType object must be set with a RuleAssignmentType object. The assignee field of the RuleAssignmentType object should be set to a group, and the dynamicAssignmentFunction field should be set to the name of the Dynamic Assignment Function to use.
          • IUserMetadataService.RULE_ACTION_DELEGATE Rule attempts to delegate the task to the specified user or group. The delegate field of the RuleActionType object must be set with a RuleAssignmentType object. The assignee field of the RuleAssignmentType object should be set to the user or group being delegated to.
          • IUserMetadataService.RULE_ACTION_SET_OUTCOME Rule attempts to set the task outcome to the specified value. The setOutcome field of the RuleActionType should be populated with the desired outcome.
        • noOperation Not used.
        • reassign RuleAssignmentType Must be set for REASSIGN and DYN_REASSIGN rule actions. The properties of RuleAssignmentType are:
          • assignee PrincipleRefType The target assignee.
          • dynamicAssignmentFunction String For DYN_REASSIGN rule action, this must be set to the Dynamic Assignment Function to be used to select a user from the group specified in the assignee property. A list of suitable Dynamic Assignment Functions can be determined from the method IRuntimeConfigService.getUserDynamicAssignmentFunctions(oracle.bpel.services.workflow.verification.IWorkflowContext).
        • delegate RuleAssignmentType Must be set for DELEGATE rule action. The properties of RuleAssignmentType are:
          • assignee PrincipleRefType The user or group to delegate the task to.
          • dynamicAssignmentFunction String Not used for DELEGATE rule action.
        • setOutcome String Must be set for SET_OUTCOME action. The outcome that the Task will be set to.

      • Parameters:

        ctx - authenticated IWorkflowContext for user.

        rule - RuleDetail object defining the rule.

        Returns:

        the created RuleDetail. The ruleId will be populated on the returned object.

        Throws:

        WorkflowException - if non-admin user attempts to create a rule for another user or for a group that they to not own, or some other error condition occurs.

        updateRule

        RuleDetail updateRule(IWorkflowContext ctx,
                              RuleDetail rule)
                              throws WorkflowException
        

        Updates an existing workflow rule to the definition specified in a RuleDetail object. See createRule(oracle.bpel.services.workflow.verification.IWorkflowContext, oracle.bpel.services.workflow.user.model.RuleDetail) for a description of how to use the RuleDetail object.

        Note that the name of a rule is used to generate its ruleId. Updating a rule name will result in its ruleId changing. The RuleDetail object returned by this method will contain the updated ruleId.

        Parameters:

        ctx - authenticated IWorkflowContext for user.

        rule - RuleDetail object defining the rule.

        Returns:

        the updated RuleDetail. The correct ruleId will be populated on the returned object.

        Throws:

        WorkflowException - if non-admin user attempts to update information for a rule belonging to another user or a group that they to not own, or some other error condition occurs.

        deleteRule

        void deleteRule(IWorkflowContext ctx,
                        java.lang.String ruleId)
                        throws WorkflowException
        

        Deletes an existing workflow rule, based on its ruleId.

        Parameters:

        ctx - authenticated IWorkflowContext for user.

        ruleId - String unique identifier for rule.

        Throws:

        WorkflowException - if non-admin user attempts to delete a a rule belonging to another user or a group that they to not own, or some other error condition occurs.

        increaseRulePriority

        void increaseRulePriority(IWorkflowContext ctx,
                                  java.lang.String ruleId)
                                  throws WorkflowException
        

        Increases the priority of the specified rule by 1. Rules are evaluated in order of their priority from highest (largest numerical value) to lowest. Only the first rule whose conditions are met will be triggered. Rules of lower priority will be ignored, even if the task also meets their conditions.

        Parameters:

        ctx - authenticated IWorkflowContext for user.

        ruleId - String unique identifier for rule.

        Throws:

        WorkflowException - if non-admin user attempts to update information for a rule belonging to another user or a group that they to not own, or some other error condition occurs.

        decreaseRulePriority

        void decreaseRulePriority(IWorkflowContext ctx,
                                  java.lang.String ruleId)
                                  throws WorkflowException
        

        Decreases the priority of the specified rule by 1. Rules are evaluated in order of their priority from highest (largest numerical value) to lowest. Only the first rule whose conditions are met will be triggered. Rules of lower priority will be ignored, even if the task also meets their conditions.

        Parameters:

        ctx - authenticated IWorkflowContext for user.

        ruleId - String unique identifier for rule.

        Throws:

        WorkflowException - if non-admin user attempts to update information for a rule belonging to another user or a group that they to not own, or some other error condition occurs.

        getStandardTaskViewList

        UserViewList getStandardTaskViewList(IWorkflowContext ctx)
                                             throws WorkflowException
        

        Gets the list of standard views which ship with the product, and are available to all users. (This list of standard views can be altered by admin users creating, updating or deleting views of type UserTaskViewType.STANDARD_VIEW.) Views are returned as a UserViewList object. The UserViewList object contains a List of ViewSummaryType objects, accessed by calling the UserViewListType.getView() method. Each ViewSummaryType object provides summary information about a view. In order to retreive the full details for a particular rule, the method getStandardTaskViewDetails(oracle.bpel.services.workflow.verification.IWorkflowContext, java.lang.String) should be used.

        ViewSummaryType has the following properties:

        • id String unique identifier for view, automatically populated by API on view creation.
        • name String the name of the view. If the WorkflowLabels.proprties resource bundle contains an entry for this standard view name, then the label from the apppropriate resource bundle for the context user will be used instead.
        • owner PrincipleRefType The owner of the view- this is set to a dummy value for standard views.
        • hidden boolean value. Can be used by UI to determine how to display the view. In the sample worklist application, views marked as "hidden" are not displayed in the list of views in the user's task listing page.
        • viewType String internal use only, will be set to IWorkflowConstants.USER_VIEW_TYPE_VIEW.
        • description String optional description of view.

        • Parameters:

          ctx - authenticated IWorkflowContext for user.

          Returns:

          UserViewList list of ViewSummaryType objects.

          Throws:

          WorkflowException - if an error occurs retrieving the standard views.

          getUserTaskViewList

          UserViewList getUserTaskViewList(IWorkflowContext ctx,
                                           Participant user)
                                           throws WorkflowException
          

          Gets the list of views belonging to the specified user. Views are returned as a UserViewList object. The UserViewList object contains a List of ViewSummaryType objects, accessed by calling the UserViewListType.getView() method. Each ViewSummaryType object provides summary information about a view. In order to retreive the full details for a particular rule, the method getUserTaskViewDetails(oracle.bpel.services.workflow.verification.IWorkflowContext, java.lang.String) should be used.

          ViewSummaryType has the following properties:

          • id String unique identifier for view, automatically populated by API on view creation.
          • name String the name of the view.
          • owner PrincipleRefType The owner of the view.
          • hidden boolean value. Can be used by UI to determine how to display the view. In the sample worklist application, views marked as "hidden" are not displayed in the list of views in the user's task listing page.
          • viewType String internal use only, will be set to IWorkflowConstants.USER_VIEW_TYPE_VIEW.
          • description String optional description of view.

          • Parameters:

            ctx - authenticated IWorkflowContext for user.

            user - Participant user to get the views for.

            Returns:

            UserViewList list of ViewSummaryType objects.

            Throws:

            WorkflowException - if non-admin user attempts to retrieve the list of views for another user, or some other error condition occurs.

            getUserInboxView

            UserViewDetail getUserInboxView(IWorkflowContext ctx,
                                            Participant user)
                                            throws WorkflowException
            

            Deprecated.

            Throws:

            WorkflowException

            getGrantedTaskViewList

            GrantedViewList getGrantedTaskViewList(IWorkflowContext ctx,
                                                   Participant user)
                                                   throws WorkflowException
            

            Gets the list of views that have been granted to the specified user by other users. Users that have been granted a view can use that view to query tasks as the owner of the view. The view owner and the grantee will see the same data when using the view. The grantee is able query, but not update view details for the granted view.

            Granted views are returned as a GrantedViewList object. The GrantedViewList object contains a List of ViewGrantType objects, accessed by calling the GrantedViewListType.getViewGrant() method. ViewGrantType has the following properties:

            • grantType String currently unused. Could be utilized by a task list UI to diferentiate between different sorts of grant in order to implement custom behavior.
            • viewId String unique identifier for the granted view.
            • grantee PrincipleRefType The user to whom the view has been granted
            • grantedName String The grantee may choose to use a different name for the view to the one chosen by the view's owner.
            • grantedDescription String The grantee may choose to use a different description for the view to the one chosen by the view's owner.
            • hidden boolean Can be used by UI to determine how to display the view. In the sample worklist application, granted views marked as "hidden" are not displayed in the list of views in the user's task listing page.
            • viewOwner PrincipleRefType The owner of the view.
            • originalName String The name of the view chosen by the owner.
            • originalDescription String The description for the view chosen by the owner.

            • Parameters:

              ctx - authenticated IWorkflowContext for user.

              user - Participant user to get the granted views for.

              Returns:

              GrantedViewList list of ViewGrantType objects.

              Throws:

              WorkflowException - if non-admin user attempts to retrieve the list of granted views for another user, or some other error condition occurs.

              getStandardTaskViewDetails

              UserViewDetail getStandardTaskViewDetails(IWorkflowContext ctx,
                                                        java.lang.String viewId)
                                                        throws WorkflowException
              

              Gets the full details for a particular standard view, identified by its viewId. View details are returned as a UserViewDetail object. See createUserTaskView(oracle.bpel.services.workflow.verification.IWorkflowContext, oracle.bpel.services.workflow.user.model.UserViewDetail) for a description of the UserViewDetail properties.

              Parameters:

              ctx - authenticated IWorkflowContext for user.

              viewId - String unique identifier for view.

              Returns:

              UserViewDetail describing standard view.

              Throws:

              WorkflowException - if error occurs retrieving view details.

              getUserTaskViewDetails

              UserViewDetail getUserTaskViewDetails(IWorkflowContext ctx,
                                                    java.lang.String viewId)
                                                    throws WorkflowException
              

              Gets the full details for a particular user view, identified by its viewId. View details are returned as a UserViewDetail object. See createUserTaskView(oracle.bpel.services.workflow.verification.IWorkflowContext, oracle.bpel.services.workflow.user.model.UserViewDetail) for a description of the UserViewDetail properties.

              Parameters:

              ctx - authenticated IWorkflowContext for user.

              viewId - String unique identifier for view.

              Returns:

              UserViewDetail describing user view.

              Throws:

              WorkflowException - if non-admin user attempts to retrieve view belonging to another user, or some other error condition occurs.

              createUserTaskView

              UserViewDetail createUserTaskView(IWorkflowContext ctx,
                                                UserViewDetail view)
                                                throws WorkflowException
              

              Creates a new view from the specified UserViewDetail object. Views provide a way for users to persist queries that return lists of tasks. A view can define which task columns should be queried, how the tasks should be filtered, and how the tasks should be ordered. Views are persisted by the API, and a view can be used to query a list of tasks using the method ITaskQueryService.queryViewTasks(oracle.bpel.services.workflow.verification.IWorkflowContext, java.lang.String, oracle.bpel.services.workflow.repos.Predicate, oracle.bpel.services.workflow.repos.Ordering, int, int).

              Users can grant other users access to their views, allowing the grantee to query the view data as if they are the view owner.

              The UserViewDetail object properties are as follows:

              • id String unique identifier for view, automatically populated by API on view creation.
              • viewType String indicates whether this view is one of the 'standard views', visible to all users, or is a personal view. Should be set to one of the String values of the enumeration IUserMetadataService.UserTaskViewType. (Either 'VIEW' or 'STANDARD_VIEW'). Only admin users can create (or update, or delete) standard views. If no value is specified, viewType will default to 'VIEW'.
              • name String name for view. In the case of standard views, this name can be used to lookup a resource string from the WorkflowLabels.properties resource bundle. When querying standard views, if such a resource string is available, the value of this field will be replaced by this resource string (in the appropriate Locale, as determined from the IWorkflowContext object). If no resource string is found, then the name of the standard view will be set to the same value as specified in this field when the view was created or updated.
              • owner PrincipleRefType The owner of the view.
              • hidden boolean value. Can be used by UI to determine how to display the view. In the sample worklist application, views marked as "hidden" are not displayed in the list of views in the user's task listing page.
              • description String optional description of view.
              • viewColumns ColumnListType specifies which task columns should be retrieved by the view. The ColumnListType object should be populated with ColumnType objects. ColumnType objects can be added to the ColumnListType by calling the method ColumnListType.getColumn().add(ColumnType column). ColumnType has the following properties:
                • columnName String The column name should be the name of a column in the WFTASK database table. A list of column names can be retrieved using the methods ITaskMetadataService.getTaskAttributes(oracle.bpel.services.workflow.verification.IWorkflowContext) or ITaskMetadataService.getTaskAttributesForTaskDefinition(oracle.bpel.services.workflow.verification.IWorkflowContext, java.lang.String).
                • displayName String The display name to use for the column. A task list UI can make use of the display name specified in the view to override the standard column header with a column header specified by the user.
              • viewOptionalInfo TaskOptionalInfoType specifies additional information that the view query will return in addtion to that which can be queried directly from task columns. The TaskOptionalInfoType object contains a List of String values, that should correspond to values determined from the ITaskQueryService.OptionalInfo enum. Values can be added to the TaskOptionalInfoType by calling the method TaskOptionalInfoType.getTaskOptionalInfo().add(String value).
              • viewPredicate TaskPredicateType specifies how the view should filter tasks. The TaskPredicateType object contains the following properties:
                • assignmentFilter String value corresponding to a value of ITaskQueryService.AssignmentFilter enum.
                • keywords String optional keyword search string. If this parameter is null, it is omitted from all query. If not null, predicates will be added to the query to perform SQL 'like' operation (of the form LIKE '%keyword%') on the following task attributes: task title, identification key, all textAttributes in task, task number (only if the keyword is a number)
                • clause Deprecated. Use the predicate property instead. This property is still available to preserve backward compatibility.
                • predicate A PredicateType object that specifies the additional conditions in the view query. The simplest way to construct a PredicateType object is to construct a Predicate, and then use the method Predicate.getPredicateType() to obtain the PredicateType object that represents the Predicate.
              • viewOrdering TaskOrderingType specifies how the Tasks selected by the view should be ordered. The TaskOrderingType object contains a List of OrderingClauseType objects. OrderingClauseTypes can be added to the TaskOrderingType by calling the method TaskOrderingType.getClause().add(OrderingClauseType clause). Each OrderingClauseType specifies a single ordering clause, using the following properties:
                • sortOrder String Should be Ordering.ASCENDING_ORDER or Ordering.DESCENDING_ORDER. Default is ascending.
                • nullFirst boolean Should null values be listed first or last.
                • column String name of column to sort on. The column name should be the a column on the WFTASK table. A list of column names can be retrieved using the methods ITaskMetadataService.getTaskAttributes(oracle.bpel.services.workflow.verification.IWorkflowContext) or ITaskMetadataService.getTaskAttributesForTaskDefinition(oracle.bpel.services.workflow.verification.IWorkflowContext, java.lang.String).
              • chart ChartType A client application may use this property to define how task counts should be aggregated when using the method ITaskQueryService.queryViewAggregatedTasks(oracle.bpel.services.workflow.verification.IWorkflowContext, java.lang.String, oracle.bpel.services.workflow.repos.Predicate, oracle.bpel.services.workflow.repos.Column, boolean, boolean). ChartType has the following properties:
                • groupByColumn String The name of the column the task counts should be grouped by.
                • selectValues ChartType.SelectValuesType optionally specifies a list of values from the groupByColumn that should be selected for aggregation. If no selectValues are selected, then all agregation is over all values of the groupBy column
                • orderByCount boolean if true, results will be ordered by the counts, if false, results will be ordered by the values of the group by column.
                • ascendingOrder boolean if true, results will be in ascending order, otherwise results will be in descending order.
              • grantees ViewGranteeListType A view can be granted to other users, allowing the grantee users to query tasks using the view. Depending on the grant type specified, grantees will either query data as the view owner (seeing the same data as the view owner sees), or query their own data, filteted by the view. Grantees are able to query, but not update the view definition. ViewGranteeListType contains a List of ViewGranteeType objects. ViewGranteeType objects can be added to the ViewGranteeListType using the method ViewGranteeListType.getGrantee().add(ViewGranteeType grantee). Each ViewGranteeType defines the grant of the view to another user, and has the following properties:
                • grantType String
                • Speicifies the type of view grant, and determines whether the grantee will see their own data, or the view owner's data when using the view. Must be set to one of the String values of the IUserMetadataService.UserTaskViewGrantType enumeration ("DATA" or "DEFINITION").
                • name String the name of the grantee.
                • realm String the name of the IdentityService realm the grantee belongs to.
                • type String currently unused. The type of grantee ("USER" or "GROUP"). Granting of views to groups is not currently supported.

              • Parameters:

                ctx - authenticated IWorkflowContext for user.

                view - UserViewDetail that defines view to be created.

                Returns:

                UserViewDetail that was created, with viewId populated.

                Throws:

                WorkflowException - if non-admin user attempts to create a view belonging to another user, or some other error condition occurs.

                updateUserTaskView

                UserViewDetail updateUserTaskView(IWorkflowContext ctx,
                                                  UserViewDetail view)
                                                  throws WorkflowException
                

                Updates an existing view to the defintion specified in a UserViewDetail object. See createUserTaskView(oracle.bpel.services.workflow.verification.IWorkflowContext, oracle.bpel.services.workflow.user.model.UserViewDetail) for a description of the UserViewDetail object.

                Parameters:

                ctx - authenticated IWorkflowContext for user.

                view - UserViewDetail that defines view to be updated.

                Returns:

                UserViewDetail that was updated.

                Throws:

                WorkflowException - if non-admin user attempts to update a view belonging to another user, or some other error condition occurs.

                deleteUserTaskView

                void deleteUserTaskView(IWorkflowContext ctx,
                                        java.lang.String viewId)
                                        throws WorkflowException
                

                Deletes an existing view identifies by its viewId.

                Parameters:

                ctx - authenticated IWorkflowContext for user.

                viewId - String unique identifier for view.

                Throws:

                WorkflowException - if non-admin user attempts to delete a view belonging to another user, or some other error condition occurs.

                updateGrantedTaskView

                ViewGrant updateGrantedTaskView(IWorkflowContext ctx,
                                                ViewGrant grant)
                                                throws WorkflowException
                

                Allows a grantee to update certain information on a view that has been granted to them. The grantee of a view may update certain properties on the ViewGrant, which affect how the view is displayed to them. They may not update the definition of the view itself. The properties they may update are:

                • grantedName String grantee may choose to use a different name for the view to the one chosen by the view's owner.
                • grantedDescription String grantee may choose to use a different description for the view to the one chosen by the view's owner.
                • hidden boolean Can be used by UI to determine how to display the view. In the sample worklist application, granted views marked as "hidden" are not displayed in the list of views in the user's task listing page.

                • Parameters:

                  ctx - authenticated IWorkflowContext for user.

                  grant - ViewGrant object containing updated properties.

                  Returns:

                  The updated ViewGrant object.

                  Throws:

                  WorkflowException - if non-admin user attempts to update a view grant granted to another user, or some other error condition occurs.

                  getUserPreferences

                  UserPreferences getUserPreferences(IWorkflowContext ctx,
                                                     Participant user)
                                                     throws WorkflowException
                  

                  Gets the user preferences for the specified user as a UserPreferences object.

                  User preferences are a set of name value pairs, stored against a specfic user. They can be used by client programs for implementing user-specific preferences. The sample worklist application uses user preferences for storing such information as what size the main application window should be, and how many rows should be returned in paging queries.

                  The UserPreferences object contains a List of UserPreferenceType objects, each of which represents a name value pair. The properties of UserPreferenceType are:

                  • user PrincipleRefType The user who set this preference.
                  • name String The name of this preference.
                  • value String The value of this preference.

                  • Parameters:

                    ctx - authenticated IWorkflowContext for user.

                    user - Participant user to get preferences for.

                    Returns:

                    UserPreferences list of UserPreferenceType objects.

                    Throws:

                    WorkflowException - if non-admin user attempts to query the preferences for another user, or some other error condition occurs.

                    setUserPreferences

                    UserPreferences setUserPreferences(IWorkflowContext ctx,
                                                       UserPreferences prefs)
                                                       throws WorkflowException
                    

                    Sets the user preferences for the specified from a UserPreferences object.

                    User preferences are a set of name value pairs, stored against a specfic user. They can be used by client programs for implementing user-specific preferences. The sample worklist application uses user preferences for storing such information as what size the main application window should be, and how many rows should be returned in paging queries.

                    The UserPreferences object contains a List of UserPreferenceType objects, each of which represents a name value pair. The properties of UserPreferenceType are:

                    • user PrincipleRefType The user who set this preference.
                    • name String The name of this preference.
                    • value String The value of this preference.

                    • Parameters:

                      ctx - authenticated IWorkflowContext for user.

                      prefs - UserPreferences list of UserPreferenceType objects.

                      Returns:

                      UserPreferences the updated User Preferences.

                      Throws:

                      WorkflowException - if non-admin user attempts to update the preferences for another user, or some other error condition occurs.

                      getPublicPreferences

                      UserPreferences getPublicPreferences(IWorkflowContext ctx,
                                                           Participant user)
                                                           throws WorkflowException
                      

                      Gets 'public' preferences for specified user. Public preferences are preferences that can be read by any user, but can only be updated by the owning user, or an admin. Public preferences are useful for specifying application preferences that apply to all users of a custom client. These custom client application preferences could be created and maintained by an admin user, and be queried by all users, using the admin user's username.

                      Parameters:

                      ctx - authenticated IWorkflowContext for user.

                      user - Participant user to get public preferences for.

                      Returns:

                      UserPreferences list of UserPreferenceType objects.

                      Throws:

                      WorkflowException - if some error condition occurs.

                      setPublicPreferences

                      UserPreferences setPublicPreferences(IWorkflowContext ctx,
                                                           UserPreferences prefs)
                                                           throws WorkflowException
                      

                      Sets 'public' preferences for specified user. Public preferences are preferences that can be read by any user, but can only be updated by the owning user, or an admin. Public preferences are useful for specifying application preferences that apply to all users.

                      Parameters:

                      ctx - authenticated IWorkflowContext for user.

                      prefs - UserPreferences list of UserPreferenceType objects.

                      Returns:

                      UserPreferences the updated public User Preferences.

                      Throws:

                      WorkflowException