package org.alfresco.web.bean.rules; import java.io.Serializable; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import java.util.ResourceBundle; import javax.faces.context.FacesContext; import javax.faces.model.DataModel; import javax.faces.model.ListDataModel; import javax.faces.model.SelectItem; import org.alfresco.config.Config; import org.alfresco.config.ConfigElement; import org.alfresco.config.ConfigService; import org.alfresco.model.ContentModel; import org.alfresco.repo.action.evaluator.CompareMimeTypeEvaluator; import org.alfresco.repo.action.evaluator.ComparePropertyValueEvaluator; import org.alfresco.repo.action.evaluator.HasAspectEvaluator; import org.alfresco.repo.action.evaluator.InCategoryEvaluator; import org.alfresco.repo.action.evaluator.IsSubTypeEvaluator; import org.alfresco.repo.action.executer.CheckInActionExecuter; import org.alfresco.repo.action.executer.ContentMetadataExtracter; import org.alfresco.repo.action.executer.SimpleWorkflowActionExecuter; import org.alfresco.service.cmr.action.Action; import org.alfresco.service.cmr.action.ActionCondition; import org.alfresco.service.cmr.action.ActionConditionDefinition; import org.alfresco.service.cmr.dictionary.TypeDefinition; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.rule.Rule; import org.alfresco.service.cmr.rule.RuleService; import org.alfresco.service.cmr.rule.RuleType; import org.alfresco.service.namespace.QName; import org.alfresco.web.app.Application; import org.alfresco.web.bean.actions.BaseActionWizard; import org.alfresco.web.bean.repository.Node; import org.alfresco.web.bean.repository.Repository; import org.alfresco.web.data.IDataContainer; import org.alfresco.web.data.QuickSort; import org.alfresco.web.ui.common.Utils; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; /** * Bean implementation for the "Create Rule" wizard * * @author gavinc */ public class CreateRuleWizard extends BaseActionWizard { public static final String PROP_CONDITION_NAME = "conditionName"; public static final String PROP_CONDITION_SUMMARY = "conditionSummary"; public static final String PROP_CONDITION_NOT = "notcondition"; protected RuleService ruleService; protected RulesBean rulesBean; private List modelTypes; private List mimeTypes; private List types; private List conditions; protected Map currentConditionProperties; protected List> allConditionsProperties; protected DataModel allConditionsDataModel; protected String title; protected String description; protected String type; protected String condition; protected boolean runInBackground; protected boolean applyToSubSpaces; protected boolean editingCondition; protected static final String CONDITION_PAGES_LOCATION = "/jsp/rules/"; private static final Log logger = LogFactory.getLog(CreateRuleWizard.class); // ------------------------------------------------------------------------------ // Wizard implementation @Override public void init() { super.init(); this.title = null; this.description = null; this.type = "inbound"; this.condition = null; this.applyToSubSpaces = false; this.runInBackground = false; this.conditions = null; this.allConditionsProperties = new ArrayList>(); } @Override protected String finishImpl(FacesContext context, String outcome) throws Exception { // get hold of the space the rule will apply to and make sure // it is actionable Node currentSpace = this.browseBean.getActionSpace(); // create the new rule Rule rule = this.ruleService.createRule(this.getType()); // setup the rule outcome = setupRule(context, rule, outcome); // Save the rule this.ruleService.saveRule(currentSpace.getNodeRef(), rule); if (logger.isDebugEnabled()) logger.debug("Added rule '" + this.title + "'"); return outcome; } @Override public boolean getNextButtonDisabled() { // TODO: Allow the next button state to be configured so that // wizard implementations don't have to worry about // checking step numbers boolean disabled = true; int step = Application.getWizardManager().getCurrentStep(); switch(step) { case 1: { disabled = (this.allConditionsDataModel == null || this.allConditionsDataModel.getRowCount() == 0); break; } case 2: { disabled = (this.allActionsDataModel == null || this.allActionsDataModel.getRowCount() == 0); break; } case 3: { disabled = (this.title == null || this.title.length() == 0); break; } } return disabled; } @Override public boolean getFinishButtonDisabled() { if (this.allActionsDataModel != null && this.allActionsDataModel.getRowCount() > 0 && this.allConditionsDataModel != null && this.allConditionsDataModel.getRowCount() > 0 && this.title != null && this.title.length() > 0) { return false; } else { return true; } } /** * @return Returns the summary data for the wizard. */ public String getSummary() { // create the summary using all the conditions StringBuilder conditionsSummary = new StringBuilder(); for (Map props : this.allConditionsProperties) { conditionsSummary.append(props.get(PROP_CONDITION_SUMMARY)); conditionsSummary.append("
"); } // create the summary using all the actions StringBuilder actionsSummary = new StringBuilder(); for (Map props : this.allActionsProperties) { actionsSummary.append(props.get(PROP_ACTION_SUMMARY)); actionsSummary.append("
"); } ResourceBundle bundle = Application.getBundle(FacesContext.getCurrentInstance()); String backgroundYesNo = this.runInBackground ? bundle.getString("yes") : bundle.getString("no"); String subSpacesYesNo = this.applyToSubSpaces ? bundle.getString("yes") : bundle.getString("no"); return buildSummary( new String[] {bundle.getString("rule_type"), bundle.getString("name"), bundle.getString("description"), bundle.getString("apply_to_sub_spaces"), bundle.getString("run_in_background"), bundle.getString("conditions"), bundle.getString("actions")}, new String[] {this.type, this.title, this.description, subSpacesYesNo, backgroundYesNo, conditionsSummary.toString(), actionsSummary.toString()}); } @Override protected String getErrorMessageId() { return "error_rule"; } /** * Sets up the given rule using the current state of the wizard * * @param context FacesContext * @param rule The rule to setup * @param outcome The default outcome * @return The outcome */ protected String setupRule(FacesContext context, Rule rule, String outcome) { // setup the rule and add it to the space rule.setTitle(this.title); rule.setDescription(this.description); rule.applyToChildren(this.applyToSubSpaces); rule.setExecuteAsynchronously(this.runInBackground); // add all the conditions to the rule for (Map condParams : this.allConditionsProperties) { Map repoCondParams = buildConditionParams(condParams); // add the condition to the rule ActionCondition condition = this.actionService.createActionCondition( (String)condParams.get(PROP_CONDITION_NAME)); condition.setParameterValues(repoCondParams); // specify whether the condition result should be inverted Boolean not = (Boolean)condParams.get(PROP_CONDITION_NOT); condition.setInvertCondition(((Boolean)not).booleanValue()); rule.addActionCondition(condition); } // add all the actions to the rule for (Map actionParams : this.allActionsProperties) { // use the base class version of buildActionParams(), but for this we need // to setup the currentActionProperties and action variables String actionName = (String)actionParams.get(PROP_ACTION_NAME); this.action = actionName; this.currentActionProperties = actionParams; Map repoActionParams = buildActionParams(); // add the action to the rule Action action = this.actionService.createAction(actionName); action.setParameterValues(repoActionParams); rule.addAction(action); } return outcome; } // ------------------------------------------------------------------------------ // Bean Getters and Setters /** * Returns the properties for all the conditions as a JSF DataModel * * @return JSF DataModel representing the condition properties */ public DataModel getAllConditionsDataModel() { if (this.allConditionsDataModel == null) { this.allConditionsDataModel = new ListDataModel(); } this.allConditionsDataModel.setWrappedData(this.allConditionsProperties); return this.allConditionsDataModel; } /** * Returns a list of the types available in the repository * * @return List of SelectItem objects */ public List getModelTypes() { if (this.modelTypes == null) { FacesContext context = FacesContext.getCurrentInstance(); ConfigService svc = Application.getConfigService(context); Config wizardCfg = svc.getConfig("Action Wizards"); if (wizardCfg != null) { ConfigElement typesCfg = wizardCfg.getConfigElement("types"); if (typesCfg != null) { this.modelTypes = new ArrayList(); for (ConfigElement child : typesCfg.getChildren()) { QName idQName = Repository.resolveToQName(child.getAttribute("name")); // get the display label from config String label = Utils.getDisplayLabel(context, child); // if there wasn't a client based label try and get it from the dictionary if (label == null) { TypeDefinition typeDef = this.dictionaryService.getType(idQName); if (typeDef != null) { label = typeDef.getTitle(); } else { label = idQName.getLocalName(); } } this.modelTypes.add(new SelectItem(idQName.toString(), label)); } // make sure the list is sorted by the label QuickSort sorter = new QuickSort(this.modelTypes, "label", true, IDataContainer.SORT_CASEINSENSITIVE); sorter.sort(); } else { logger.warn("Could not find types configuration element"); } } else { logger.warn("Could not find Action Wizards configuration section"); } } return this.modelTypes; } /** * Returns a list of mime types in the system * * @return List of mime types */ public List getMimeTypes() { if (this.mimeTypes == null) { this.mimeTypes = new ArrayList(50); Map mimeTypes = mimetypeService.getDisplaysByMimetype(); for (String mimeType : mimeTypes.keySet()) { this.mimeTypes.add(new SelectItem(mimeType, mimeTypes.get(mimeType))); } // make sure the list is sorted by the values QuickSort sorter = new QuickSort(this.mimeTypes, "label", true, IDataContainer.SORT_CASEINSENSITIVE); sorter.sort(); } return this.mimeTypes; } /** * @return Returns the list of selectable conditions */ public List getConditions() { if (this.conditions == null) { List ruleConditions = this.actionService.getActionConditionDefinitions(); this.conditions = new ArrayList(ruleConditions.size()); for (ActionConditionDefinition ruleConditionDef : ruleConditions) { // add to SelectItem list this.conditions.add(new SelectItem(ruleConditionDef.getName(), ruleConditionDef.getTitle())); } // make sure the list is sorted by the label QuickSort sorter = new QuickSort(this.conditions, "label", true, IDataContainer.SORT_CASEINSENSITIVE); sorter.sort(); // add the "Select a condition" entry at the beginning of the list this.conditions.add(0, new SelectItem("null", Application.getMessage(FacesContext.getCurrentInstance(), "select_a_condition"))); } return this.conditions; } /** * @return Returns the types of rules that can be defined */ public List getTypes() { if (this.types == null) { List ruleTypes = this.ruleService.getRuleTypes(); this.types = new ArrayList(ruleTypes.size()); for (RuleType ruleType : ruleTypes) { this.types.add(new SelectItem(ruleType.getName(), ruleType.getDisplayLabel())); } } return this.types; } /** * @return Gets the condition settings */ public Map getConditionProperties() { return this.currentConditionProperties; } /** * @return Returns the description. */ public String getDescription() { return description; } /** * @param description The description to set. */ public void setDescription(String description) { this.description = description; } /** * @return Returns the title. */ public String getTitle() { return title; } /** * @param title The title to set. */ public void setTitle(String title) { this.title = title; } /** * @return Returns whether the rule should run in the background */ public boolean getRunInBackground() { return this.runInBackground; } /** * @param runInBackground Sets whether the rule should run in the background */ public void setRunInBackground(boolean runInBackground) { this.runInBackground = runInBackground; } /** * @return Returns whether the rule should be applied to sub spaces i.e. if it gets inherited */ public boolean getApplyToSubSpaces() { return this.applyToSubSpaces; } /** * @param applyToSubSpaces Sets whether the rule will get applied to sub spaces */ public void setApplyToSubSpaces(boolean applyToSubSpaces) { this.applyToSubSpaces = applyToSubSpaces; } /** * @return Returns the type. */ public String getType() { return type; } /** * @param type The type to set */ public void setType(String type) { this.type = type; } /** * @return Returns the selected condition */ public String getCondition() { return this.condition; } /** * @param condition Sets the selected condition */ public void setCondition(String condition) { this.condition = condition; } // ------------------------------------------------------------------------------ // Action event handlers /** * Displays the settings page for the current condition being added (if required) */ public void promptForConditionValues() { // set the flag to show we are creating a new condition this.editingCondition = false; FacesContext context = FacesContext.getCurrentInstance(); this.returnViewId = context.getViewRoot().getViewId(); String viewId = calculateConditionViewId(this.condition); HashMap condProps = new HashMap(3); condProps.put(PROP_CONDITION_NAME, this.condition); this.currentConditionProperties = condProps; // setup any defaults for the UI or handle actions with no parameters String overridenViewId = setupUIDefaultsForCondition(condProps); if (overridenViewId != null) { viewId = overridenViewId; } if (logger.isDebugEnabled()) logger.debug("Added '" + this.condition + "' condition to list"); // reset the selected condition drop down this.condition = null; // go to the page to collect the settings goToPage(context, viewId); } /** * Sets up the context for editing existing condition values */ @SuppressWarnings("unchecked") public void editCondition() { // use the built in JSF support for retrieving the object for the // row that was clicked by the user Map conditionToEdit = (Map)this.allConditionsDataModel.getRowData(); this.condition = (String)conditionToEdit.get(PROP_CONDITION_NAME); this.currentConditionProperties = conditionToEdit; // set the flag to show we are editing a condition this.editingCondition = true; // remember the page we're on FacesContext context = FacesContext.getCurrentInstance(); this.returnViewId = context.getViewRoot().getViewId(); // refresh the wizard goToPage(context, calculateConditionViewId(this.condition)); } /** * Adds the condition just setup by the user to the list of conditions for the rule */ public void addCondition() { FacesContext context = FacesContext.getCurrentInstance(); String summary = buildConditionSummary(); if (summary != null) { this.currentConditionProperties.put(PROP_CONDITION_SUMMARY, summary); } if (this.editingCondition) { this.condition = null; } else { this.allConditionsProperties.add(this.currentConditionProperties); } // refresh the wizard goToPage(context, this.returnViewId); } /** * Removes the requested condition from the list */ public void removeCondition() { // use the built in JSF support for retrieving the object for the // row that was clicked by the user Map conditionToRemove = (Map)this.allConditionsDataModel.getRowData(); this.allConditionsProperties.remove(conditionToRemove); // reset the action drop down this.condition = null; // refresh the wizard FacesContext context = FacesContext.getCurrentInstance(); goToPage(context, context.getViewRoot().getViewId()); } /** * Cancels the addition of the condition */ public void cancelAddCondition() { if (this.editingCondition) { this.condition = null; } else { this.currentConditionProperties.clear(); } // refresh the wizard goToPage(FacesContext.getCurrentInstance(), this.returnViewId); } // ------------------------------------------------------------------------------ // Service Injection /** * @param ruleService Sets the rule service to use */ public void setRuleService(RuleService ruleService) { this.ruleService = ruleService; } /** * Sets the RulesBean instance to be used by the wizard in edit mode * * @param rulesBean The RulesBean */ public void setRulesBean(RulesBean rulesBean) { this.rulesBean = rulesBean; } // ------------------------------------------------------------------------------ // Helper methods /** * Sets up any default state required by the UI for collecting the * condition settings. The view id to use for the condition UI can also * be overridden by returing the path to the relevant JSP. * * @props The map of properties being used for the current condition * @return An optional overridden JSP to use for condition settings collection */ protected String setupUIDefaultsForCondition(HashMap props) { String overridenViewId = null; if ("no-condition".equals(this.condition)) { // there are no parameters so just add it props.put(PROP_CONDITION_SUMMARY, Application.getMessage( FacesContext.getCurrentInstance(), "condition_no_condition")); props.put(PROP_CONDITION_NOT, Boolean.FALSE); this.allConditionsProperties.add(props); // come back to the same page we're on now overridenViewId = this.returnViewId; } return overridenViewId; } /** * Builds the Map of properties for the given condition in the format the repo is expecting * * @param params The Map of properties built from the UI * @return The Map the repo is expecting */ protected Map buildConditionParams(Map params) { Map repoParams = new HashMap(params.size()); String condName = (String)params.get(PROP_CONDITION_NAME); if (ComparePropertyValueEvaluator.NAME.equals(condName)) { repoParams.put(ComparePropertyValueEvaluator.PARAM_VALUE, params.get(PROP_CONTAINS_TEXT)); } else if (InCategoryEvaluator.NAME.equals(condName)) { // put the selected category in the condition params repoParams.put(InCategoryEvaluator.PARAM_CATEGORY_VALUE, params.get(PROP_CATEGORY)); // add the classifiable aspect repoParams.put(InCategoryEvaluator.PARAM_CATEGORY_ASPECT, ContentModel.ASPECT_GEN_CLASSIFIABLE); } else if (IsSubTypeEvaluator.NAME.equals(condName)) { // add the model type repoParams.put(IsSubTypeEvaluator.PARAM_TYPE, QName.createQName((String)params.get(PROP_MODEL_TYPE))); } else if (HasAspectEvaluator.NAME.equals(condName)) { // add the aspect repoParams.put(HasAspectEvaluator.PARAM_ASPECT, QName.createQName((String)params.get(PROP_ASPECT))); } else if (CompareMimeTypeEvaluator.NAME.equals(condName)) { repoParams.put(CompareMimeTypeEvaluator.PARAM_VALUE, params.get(PROP_MIMETYPE)); } return repoParams; } /** * Returns a summary string for the current condition * * @return The summary or null if a summary could not be built */ protected String buildConditionSummary() { String summaryResult = null; String condName = (String)this.currentConditionProperties.get(PROP_CONDITION_NAME); if (condName != null) { StringBuilder summary = new StringBuilder(); String msgId = "condition_" + condName.replace('-', '_'); // JSF is putting the boolean into the map as a Boolean object so we // need to handle that - adding a converter doesn't seem to help! Boolean not = (Boolean)this.currentConditionProperties.get(PROP_CONDITION_NOT); if (not.booleanValue()) { msgId = msgId + "_not"; } if (logger.isDebugEnabled()) logger.debug("Looking up condition summary string: " + msgId); summary.append(Application.getMessage(FacesContext.getCurrentInstance(), msgId)); summary.append(" "); // define a summary to be added for each condition if (InCategoryEvaluator.NAME.equals(condName)) { String name = Repository.getNameForNode(this.nodeService, (NodeRef)this.currentConditionProperties.get(PROP_CATEGORY)); summary.append("'").append(name).append("'"); } else if (ComparePropertyValueEvaluator.NAME.equals(condName)) { summary.append("'"); summary.append(this.currentConditionProperties.get(PROP_CONTAINS_TEXT)); summary.append("'"); } else if (IsSubTypeEvaluator.NAME.equals(condName)) { // find the label used by looking through the SelectItem list String typeName = (String)this.currentConditionProperties.get(PROP_MODEL_TYPE); for (SelectItem item : this.getModelTypes()) { if (item.getValue().equals(typeName)) { summary.append("'").append(item.getLabel()).append("'"); break; } } } else if (HasAspectEvaluator.NAME.equals(condName)) { // find the label used by looking through the SelectItem list String aspectName = (String)this.currentConditionProperties.get(PROP_ASPECT); for (SelectItem item : this.getAspects()) { if (item.getValue().equals(aspectName)) { summary.append("'").append(item.getLabel()).append("'"); break; } } } else if (CompareMimeTypeEvaluator.NAME.equals(condName)) { String mimetype = (String)this.currentConditionProperties.get(PROP_MIMETYPE); for (SelectItem item : this.getMimeTypes()) { if (item.getValue().equals(mimetype)) { summary.append("'").append(item.getLabel()).append("'"); break; } } } summaryResult = summary.toString(); } return summaryResult; } /** * Calculates the viewId for the given condition id * * @param conditionId The id of the condition to generate the view id for * @return The view id */ protected String calculateConditionViewId(String conditionId) { return CONDITION_PAGES_LOCATION + conditionId + ".jsp"; } }