frappe/webnotes/public/js/wn/model/workflow.js

// Copyright (c) 2013, Web Notes Technologies Pvt. Ltd. and Contributors
// MIT License. See license.txt 

wn.provide("wn.workflow");

wn.workflow = {
	state_fields: {},
	workflows: {},
	setup: function(doctype) {
		var wf = wn.model.get("Workflow", {document_type: doctype});
		if(wf.length) {
			wn.workflow.workflows[doctype] = wf[0];
			wn.workflow.state_fields[doctype] = wf[0].workflow_state_field;
		} else {
			wn.workflow.state_fields[doctype] = null;
		}		
	},
	get_state_fieldname: function(doctype) {
		if(wn.workflow.state_fields[doctype]===undefined) {
			wn.workflow.setup(doctype);
		}
		return wn.workflow.state_fields[doctype];
	},
	get_default_state: function(doctype) {
		wn.workflow.setup(doctype);
		return wn.model.get("Workflow Document State", {
			parent: wn.workflow.workflows[doctype].name,
			idx: 1
		})[0].state;
	},
	get_transitions: function(doctype, state) {
		wn.workflow.setup(doctype);
		return wn.model.get("Workflow Transition", {
			parent: wn.workflow.workflows[doctype].name,
			state: state
		});
	},
	get_document_state: function(doctype, state) {
		wn.workflow.setup(doctype);
		return wn.model.get("Workflow Document State", {
			parent: wn.workflow.workflows[doctype].name,
			state: state
		})[0];
	},
	get_next_state: function(doctype, state, action) {
		return wn.model.get("Workflow Transition", {
			parent: wn.workflow.workflows[doctype].name,
			state: state,
			action: action
		})[0].next_state;
	},
 	is_read_only: function(doctype, name) {
		var state_fieldname = wn.workflow.get_state_fieldname(doctype);
		if(state_fieldname) {
			if(!locals[doctype][name])
				return false;
			if(locals[doctype][name].__islocal)
				return false;
				
			var state = locals[doctype][name][state_fieldname] || 
				wn.workflow.get_default_state(doctype);

			var workflow_doc_state = wn.model.get("Workflow Document State", 
				{
					parent: wn.workflow.workflows[doctype].name, 
					state: state
				});
			var allow_edit = workflow_doc_state.length ? 
				workflow_doc_state[0].allow_edit : null;

			if(user_roles.indexOf(allow_edit)==-1) {
				return true;
			}
		}
		return false;
	},
	get_update_fields: function(doctype) {
		var update_fields = $.unique($.map(wn.model.get("Workflow Document State", 
			{parent:wn.workflow.workflows[doctype].name}), function(d) {
				return d.update_field;
			}));
		return update_fields;
	}
};