Package org.kuali.rice.kew.rule

Interface WorkflowRuleAttributeMediator

All Known Implementing Classes:
WorkflowRuleAttributeMediatorImpl
public interface WorkflowRuleAttributeMediator
Handles communication between WorkflowRuleAttributeHandlerService endpoints in order to invoke WorkflowRuleAttribute code which might be hosted from various applications.
Author:
Kuali Rice Team (rice.collab@kuali.org)

  • Method Details

    • getRuleRows

      WorkflowRuleAttributeRows getRuleRows(Map<String,String> parameters, RuleTemplateAttribute ruleTemplateAttribute)
      Returns rule row configuration for the workflow rule attribute defined on the given RuleTemplateAttribute. These are the rows which show up on the rule and rule delegation maintenance screen when creating or editing a rule or rule delegation which uses the given attribute, as well as on the inquiry for the rule.

      Will use the supplied parameters to populate the WorkflowRuleAttribute by running the validateRuleData method on that attribute. The result of this call contains any validation errors, the Row objects as constructed by the attribute, and the final values for the rule extensions after validation and processing has been executed.

      Parameters:
      parameters - a map of parameters to pass to the backend WorkflowRuleAttribute for validation, may be null or an empty map
      ruleTemplateAttribute - the RuleTemplateAttribute which defines the ExtensionDefinition for the WorkflowRuleAttribute against which to validate and retrieve the rows, as well as the required flag which should be passed to the attribute
      Returns:
      the result of validating and retrieving rule rows, will never return null

    • getRuleRows

      WorkflowRuleAttributeRows getRuleRows(Map<String,String> parameters, RuleTemplateAttributeBo ruleTemplateAttribute)
      Equivalent to getRuleRows(java.util.Map, org.kuali.rice.kew.rule.bo.RuleTemplateAttributeBo) but takes a RuleTemplateAttributeBo instead of a RuleTemplateAttribute. Exists primarily for convenience of the calling code.

    • getRoutingDataRows

      WorkflowRuleAttributeRows getRoutingDataRows(Map<String,String> parameters, RuleTemplateAttribute ruleTemplateAttribute)
      Returns rule attribute row configuration for the workflow rule attribute defined on the given RuleTemplateAttribute. These are the rows which show up on the Routing Report screen when using a RuleTemplate which includes the given RuleTemplateAttribute.

      Will use the supplied parameters to populate the WorkflowRuleAttribute by running the validateRoutingData method on that attribute. The result of this call contains any validation errors, the Row objects as constructed by the attribute, and the final values for the rule extensions after validation and processing has been executed.

      Parameters:
      parameters - a map of parameters to pass to the backend WorkflowRuleAttribute for validation, may be null or an empty map
      ruleTemplateAttribute - the RuleTemplateAttribute which defines the ExtensionDefinition for the WorkflowRuleAttribute against which to validate and retrieve the search rows, as well as the required flag which should be passed to the attribute
      Returns:
      the result of validating and retrieving rule search rows, will never return null

    • getRoutingDataRows

      WorkflowRuleAttributeRows getRoutingDataRows(Map<String,String> parameters, RuleTemplateAttributeBo ruleTemplateAttribute)
      Equivalent to getRoutingDataRows(java.util.Map, org.kuali.rice.kew.rule.bo.RuleTemplateAttributeBo) but takes a RuleTemplateAttributeBo instead of a RuleTemplateAttribute. Exists primarily for convenience of the calling code.

    • getSearchRows

      WorkflowRuleAttributeRows getSearchRows(Map<String,String> parameters, RuleTemplateAttribute ruleTemplateAttribute)
      Returns rule search row configuration for the workflow rule attribute defined on the given RuleTemplateAttribute. These are the rows which show up on the rule and rule delegation lookup screen when searching for rules or rule delegations using a RuleTemplate which includes the given RuleTemplateAttribute.

      Will use the supplied parameters to populate the WorkflowRuleAttribute by running the validateRuleData method on that attribute (or if the attribute implements WorkflowRuleSearchAttribute, will execute validateSearchData). The result of this call contains any validation errors, the Row objects as constructed by the attribute, and the final values for the rule extensions after validation and processing has been executed.

      Parameters:
      parameters - a map of parameters to pass to the backend WorkflowRuleAttribute for validation, may be null or an empty map
      ruleTemplateAttribute - the RuleTemplateAttribute which defines the ExtensionDefinition for the WorkflowRuleAttribute against which to validate and retrieve the search rows, as well as the required flag which should be passed to the attribute
      Returns:
      the result of validating and retrieving rule search rows, will never return null

    • getSearchRows

      WorkflowRuleAttributeRows getSearchRows(Map<String,String> parameters, RuleTemplateAttribute ruleTemplateAttribute, boolean required)
      Equivalent to call getSearchRows(java.util.Map, org.kuali.rice.kew.api.rule.RuleTemplateAttribute) but passes a custom value for the required flag that is passed to the attribute instead of using the one defined by the given RuleTemplateAttribute.isRequired(). The main use case for this is in the case of a lookup where it's desirable to disable required validation for search fields that have not been filled in (in that case a value of "false" would be passed as the last argument to this method).

    • getRoleNames

      List<RoleName> getRoleNames(RuleTemplateAttributeBo ruleTemplateAttribute)
      Returns the list of role names as defined on the RoleAttribute defined by the given rule template attribute. In this case that the defined rule template attribute does not represent a role attribute or does not return any role names, this method will return an empty list.
      Parameters:
      ruleTemplateAttribute - the RuleTemplateAttribute which defines the ExtensionDefinition for the RoleAttribute from which to fetch the role names