Chris@1494: # Redmine - project management software Chris@1494: # Copyright (C) 2006-2014 Jean-Philippe Lang Chris@1494: # Chris@1494: # This program is free software; you can redistribute it and/or Chris@1494: # modify it under the terms of the GNU General Public License Chris@1494: # as published by the Free Software Foundation; either version 2 Chris@1494: # of the License, or (at your option) any later version. Chris@1494: # Chris@1494: # This program is distributed in the hope that it will be useful, Chris@1494: # but WITHOUT ANY WARRANTY; without even the implied warranty of Chris@1494: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Chris@1494: # GNU General Public License for more details. Chris@1494: # Chris@1494: # You should have received a copy of the GNU General Public License Chris@1494: # along with this program; if not, write to the Free Software Chris@1494: # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Chris@1494: Chris@1494: class IssueRelation < ActiveRecord::Base Chris@1494: # Class used to represent the relations of an issue Chris@1494: class Relations < Array Chris@1494: include Redmine::I18n Chris@1494: Chris@1494: def initialize(issue, *args) Chris@1494: @issue = issue Chris@1494: super(*args) Chris@1494: end Chris@1494: Chris@1494: def to_s(*args) Chris@1494: map {|relation| "#{l(relation.label_for(@issue))} ##{relation.other_issue(@issue).id}"}.join(', ') Chris@1494: end Chris@1494: end Chris@1494: Chris@1494: belongs_to :issue_from, :class_name => 'Issue', :foreign_key => 'issue_from_id' Chris@1494: belongs_to :issue_to, :class_name => 'Issue', :foreign_key => 'issue_to_id' Chris@1494: Chris@1494: TYPE_RELATES = "relates" Chris@1494: TYPE_DUPLICATES = "duplicates" Chris@1494: TYPE_DUPLICATED = "duplicated" Chris@1494: TYPE_BLOCKS = "blocks" Chris@1494: TYPE_BLOCKED = "blocked" Chris@1494: TYPE_PRECEDES = "precedes" Chris@1494: TYPE_FOLLOWS = "follows" Chris@1494: TYPE_COPIED_TO = "copied_to" Chris@1494: TYPE_COPIED_FROM = "copied_from" Chris@1494: Chris@1494: TYPES = { Chris@1494: TYPE_RELATES => { :name => :label_relates_to, :sym_name => :label_relates_to, Chris@1494: :order => 1, :sym => TYPE_RELATES }, Chris@1494: TYPE_DUPLICATES => { :name => :label_duplicates, :sym_name => :label_duplicated_by, Chris@1494: :order => 2, :sym => TYPE_DUPLICATED }, Chris@1494: TYPE_DUPLICATED => { :name => :label_duplicated_by, :sym_name => :label_duplicates, Chris@1494: :order => 3, :sym => TYPE_DUPLICATES, :reverse => TYPE_DUPLICATES }, Chris@1494: TYPE_BLOCKS => { :name => :label_blocks, :sym_name => :label_blocked_by, Chris@1494: :order => 4, :sym => TYPE_BLOCKED }, Chris@1494: TYPE_BLOCKED => { :name => :label_blocked_by, :sym_name => :label_blocks, Chris@1494: :order => 5, :sym => TYPE_BLOCKS, :reverse => TYPE_BLOCKS }, Chris@1494: TYPE_PRECEDES => { :name => :label_precedes, :sym_name => :label_follows, Chris@1494: :order => 6, :sym => TYPE_FOLLOWS }, Chris@1494: TYPE_FOLLOWS => { :name => :label_follows, :sym_name => :label_precedes, Chris@1494: :order => 7, :sym => TYPE_PRECEDES, :reverse => TYPE_PRECEDES }, Chris@1494: TYPE_COPIED_TO => { :name => :label_copied_to, :sym_name => :label_copied_from, Chris@1494: :order => 8, :sym => TYPE_COPIED_FROM }, Chris@1494: TYPE_COPIED_FROM => { :name => :label_copied_from, :sym_name => :label_copied_to, Chris@1494: :order => 9, :sym => TYPE_COPIED_TO, :reverse => TYPE_COPIED_TO } Chris@1494: }.freeze Chris@1494: Chris@1494: validates_presence_of :issue_from, :issue_to, :relation_type Chris@1494: validates_inclusion_of :relation_type, :in => TYPES.keys Chris@1494: validates_numericality_of :delay, :allow_nil => true Chris@1494: validates_uniqueness_of :issue_to_id, :scope => :issue_from_id Chris@1494: validate :validate_issue_relation Chris@1494: Chris@1494: attr_protected :issue_from_id, :issue_to_id Chris@1494: before_save :handle_issue_order Chris@1494: after_create :create_journal_after_create Chris@1494: after_destroy :create_journal_after_delete Chris@1494: Chris@1494: def visible?(user=User.current) Chris@1494: (issue_from.nil? || issue_from.visible?(user)) && (issue_to.nil? || issue_to.visible?(user)) Chris@1494: end Chris@1494: Chris@1494: def deletable?(user=User.current) Chris@1494: visible?(user) && Chris@1494: ((issue_from.nil? || user.allowed_to?(:manage_issue_relations, issue_from.project)) || Chris@1494: (issue_to.nil? || user.allowed_to?(:manage_issue_relations, issue_to.project))) Chris@1494: end Chris@1494: Chris@1494: def initialize(attributes=nil, *args) Chris@1494: super Chris@1494: if new_record? Chris@1494: if relation_type.blank? Chris@1494: self.relation_type = IssueRelation::TYPE_RELATES Chris@1494: end Chris@1494: end Chris@1494: end Chris@1494: Chris@1494: def validate_issue_relation Chris@1494: if issue_from && issue_to Chris@1494: errors.add :issue_to_id, :invalid if issue_from_id == issue_to_id Chris@1494: unless issue_from.project_id == issue_to.project_id || Chris@1494: Setting.cross_project_issue_relations? Chris@1494: errors.add :issue_to_id, :not_same_project Chris@1494: end Chris@1494: # detect circular dependencies depending wether the relation should be reversed Chris@1494: if TYPES.has_key?(relation_type) && TYPES[relation_type][:reverse] Chris@1494: errors.add :base, :circular_dependency if issue_from.all_dependent_issues.include? issue_to Chris@1494: else Chris@1494: errors.add :base, :circular_dependency if issue_to.all_dependent_issues.include? issue_from Chris@1494: end Chris@1494: if issue_from.is_descendant_of?(issue_to) || issue_from.is_ancestor_of?(issue_to) Chris@1494: errors.add :base, :cant_link_an_issue_with_a_descendant Chris@1494: end Chris@1494: end Chris@1494: end Chris@1494: Chris@1494: def other_issue(issue) Chris@1494: (self.issue_from_id == issue.id) ? issue_to : issue_from Chris@1494: end Chris@1494: Chris@1494: # Returns the relation type for +issue+ Chris@1494: def relation_type_for(issue) Chris@1494: if TYPES[relation_type] Chris@1494: if self.issue_from_id == issue.id Chris@1494: relation_type Chris@1494: else Chris@1494: TYPES[relation_type][:sym] Chris@1494: end Chris@1494: end Chris@1494: end Chris@1494: Chris@1494: def label_for(issue) Chris@1494: TYPES[relation_type] ? Chris@1494: TYPES[relation_type][(self.issue_from_id == issue.id) ? :name : :sym_name] : Chris@1494: :unknow Chris@1494: end Chris@1494: Chris@1494: def css_classes_for(issue) Chris@1494: "rel-#{relation_type_for(issue)}" Chris@1494: end Chris@1494: Chris@1494: def handle_issue_order Chris@1494: reverse_if_needed Chris@1494: Chris@1494: if TYPE_PRECEDES == relation_type Chris@1494: self.delay ||= 0 Chris@1494: else Chris@1494: self.delay = nil Chris@1494: end Chris@1494: set_issue_to_dates Chris@1494: end Chris@1494: Chris@1494: def set_issue_to_dates Chris@1494: soonest_start = self.successor_soonest_start Chris@1494: if soonest_start && issue_to Chris@1494: issue_to.reschedule_on!(soonest_start) Chris@1494: end Chris@1494: end Chris@1494: Chris@1494: def successor_soonest_start Chris@1494: if (TYPE_PRECEDES == self.relation_type) && delay && issue_from && Chris@1494: (issue_from.start_date || issue_from.due_date) Chris@1494: (issue_from.due_date || issue_from.start_date) + 1 + delay Chris@1494: end Chris@1494: end Chris@1494: Chris@1494: def <=>(relation) Chris@1494: r = TYPES[self.relation_type][:order] <=> TYPES[relation.relation_type][:order] Chris@1494: r == 0 ? id <=> relation.id : r Chris@1494: end Chris@1494: Chris@1494: private Chris@1494: Chris@1494: # Reverses the relation if needed so that it gets stored in the proper way Chris@1494: # Should not be reversed before validation so that it can be displayed back Chris@1494: # as entered on new relation form Chris@1494: def reverse_if_needed Chris@1494: if TYPES.has_key?(relation_type) && TYPES[relation_type][:reverse] Chris@1494: issue_tmp = issue_to Chris@1494: self.issue_to = issue_from Chris@1494: self.issue_from = issue_tmp Chris@1494: self.relation_type = TYPES[relation_type][:reverse] Chris@1494: end Chris@1494: end Chris@1494: Chris@1494: def create_journal_after_create Chris@1494: journal = issue_from.init_journal(User.current) Chris@1494: journal.details << JournalDetail.new(:property => 'relation', Chris@1494: :prop_key => label_for(issue_from).to_s, Chris@1494: :value => issue_to.id) Chris@1494: journal.save Chris@1494: journal = issue_to.init_journal(User.current) Chris@1494: journal.details << JournalDetail.new(:property => 'relation', Chris@1494: :prop_key => label_for(issue_to).to_s, Chris@1494: :value => issue_from.id) Chris@1494: journal.save Chris@1494: end Chris@1494: Chris@1494: def create_journal_after_delete Chris@1494: journal = issue_from.init_journal(User.current) Chris@1494: journal.details << JournalDetail.new(:property => 'relation', Chris@1494: :prop_key => label_for(issue_from).to_s, Chris@1494: :old_value => issue_to.id) Chris@1494: journal.save Chris@1494: journal = issue_to.init_journal(User.current) Chris@1494: journal.details << JournalDetail.new(:property => 'relation', Chris@1494: :prop_key => label_for(issue_to).to_s, Chris@1494: :old_value => issue_from.id) Chris@1494: journal.save Chris@1494: end Chris@1494: end