kopie van
https://github.com/redmine/redmine.git
synced 2024-07-25 06:34:48 +02:00
3686b77eb6
git-svn-id: http://svn.redmine.org/redmine/trunk@21342 e93f8b46-1217-0410-a6f0-8f06a7374b81
264 regels
8.3 KiB
Ruby
264 regels
8.3 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
# Redmine - project management software
|
|
# Copyright (C) 2006-2022 Jean-Philippe Lang
|
|
#
|
|
# This program is free software; you can redistribute it and/or
|
|
# modify it under the terms of the GNU General Public License
|
|
# as published by the Free Software Foundation; either version 2
|
|
# of the License, or (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, write to the Free Software
|
|
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
|
|
class IssueRelation < ActiveRecord::Base
|
|
# Class used to represent the relations of an issue
|
|
class Relations < Array
|
|
include Redmine::I18n
|
|
|
|
def initialize(issue, *args)
|
|
@issue = issue
|
|
super(*args)
|
|
end
|
|
|
|
def to_s(*args)
|
|
map {|relation| relation.to_s(@issue)}.join(', ')
|
|
end
|
|
end
|
|
|
|
include Redmine::SafeAttributes
|
|
include Redmine::Utils::DateCalculation
|
|
|
|
belongs_to :issue_from, :class_name => 'Issue'
|
|
belongs_to :issue_to, :class_name => 'Issue'
|
|
|
|
TYPE_RELATES = "relates"
|
|
TYPE_DUPLICATES = "duplicates"
|
|
TYPE_DUPLICATED = "duplicated"
|
|
TYPE_BLOCKS = "blocks"
|
|
TYPE_BLOCKED = "blocked"
|
|
TYPE_PRECEDES = "precedes"
|
|
TYPE_FOLLOWS = "follows"
|
|
TYPE_COPIED_TO = "copied_to"
|
|
TYPE_COPIED_FROM = "copied_from"
|
|
|
|
TYPES = {
|
|
TYPE_RELATES => {:name => :label_relates_to, :sym_name => :label_relates_to,
|
|
:order => 1, :sym => TYPE_RELATES},
|
|
TYPE_DUPLICATES => {:name => :label_duplicates, :sym_name => :label_duplicated_by,
|
|
:order => 2, :sym => TYPE_DUPLICATED},
|
|
TYPE_DUPLICATED => {:name => :label_duplicated_by, :sym_name => :label_duplicates,
|
|
:order => 3, :sym => TYPE_DUPLICATES, :reverse => TYPE_DUPLICATES},
|
|
TYPE_BLOCKS => {:name => :label_blocks, :sym_name => :label_blocked_by,
|
|
:order => 4, :sym => TYPE_BLOCKED},
|
|
TYPE_BLOCKED => {:name => :label_blocked_by, :sym_name => :label_blocks,
|
|
:order => 5, :sym => TYPE_BLOCKS, :reverse => TYPE_BLOCKS},
|
|
TYPE_PRECEDES => {:name => :label_precedes, :sym_name => :label_follows,
|
|
:order => 6, :sym => TYPE_FOLLOWS},
|
|
TYPE_FOLLOWS => {:name => :label_follows, :sym_name => :label_precedes,
|
|
:order => 7, :sym => TYPE_PRECEDES, :reverse => TYPE_PRECEDES},
|
|
TYPE_COPIED_TO => {:name => :label_copied_to, :sym_name => :label_copied_from,
|
|
:order => 8, :sym => TYPE_COPIED_FROM},
|
|
TYPE_COPIED_FROM => {:name => :label_copied_from, :sym_name => :label_copied_to,
|
|
:order => 9, :sym => TYPE_COPIED_TO, :reverse => TYPE_COPIED_TO}
|
|
}.freeze
|
|
|
|
validates_presence_of :issue_from, :issue_to, :relation_type
|
|
validates_inclusion_of :relation_type, :in => TYPES.keys
|
|
validates_numericality_of :delay, :allow_nil => true
|
|
validates_uniqueness_of :issue_to_id, :scope => :issue_from_id, :case_sensitive => true
|
|
validate :validate_issue_relation
|
|
|
|
before_save :handle_issue_order
|
|
after_create :call_issues_relation_added_callback
|
|
after_destroy :call_issues_relation_removed_callback
|
|
|
|
safe_attributes 'relation_type',
|
|
'delay',
|
|
'issue_to_id'
|
|
|
|
def safe_attributes=(attrs, user=User.current)
|
|
if attrs.respond_to?(:to_unsafe_hash)
|
|
attrs = attrs.to_unsafe_hash
|
|
end
|
|
return unless attrs.is_a?(Hash)
|
|
|
|
attrs = attrs.deep_dup
|
|
if issue_id = attrs.delete('issue_to_id')
|
|
if issue_id.to_s.strip.match(/\A#?(\d+)\z/)
|
|
issue_id = $1.to_i
|
|
self.issue_to = Issue.visible(user).find_by_id(issue_id)
|
|
end
|
|
end
|
|
|
|
super(attrs)
|
|
end
|
|
|
|
def visible?(user=User.current)
|
|
(issue_from.nil? || issue_from.visible?(user)) && (issue_to.nil? || issue_to.visible?(user))
|
|
end
|
|
|
|
def deletable?(user=User.current)
|
|
visible?(user) &&
|
|
((issue_from.nil? || user.allowed_to?(:manage_issue_relations, issue_from.project)) ||
|
|
(issue_to.nil? || user.allowed_to?(:manage_issue_relations, issue_to.project)))
|
|
end
|
|
|
|
def initialize(attributes=nil, *args)
|
|
super
|
|
if new_record?
|
|
if relation_type.blank?
|
|
self.relation_type = IssueRelation::TYPE_RELATES
|
|
end
|
|
end
|
|
end
|
|
|
|
def validate_issue_relation
|
|
if issue_from && issue_to
|
|
errors.add :issue_to_id, :invalid if issue_from_id == issue_to_id
|
|
unless issue_from.project_id == issue_to.project_id ||
|
|
Setting.cross_project_issue_relations?
|
|
errors.add :issue_to_id, :not_same_project
|
|
end
|
|
if circular_dependency?
|
|
errors.add :base, :circular_dependency
|
|
end
|
|
if issue_from.is_descendant_of?(issue_to) || issue_from.is_ancestor_of?(issue_to)
|
|
errors.add :base, :cant_link_an_issue_with_a_descendant
|
|
end
|
|
end
|
|
end
|
|
|
|
def other_issue(issue)
|
|
(self.issue_from_id == issue.id) ? issue_to : issue_from
|
|
end
|
|
|
|
# Returns the relation type for +issue+
|
|
def relation_type_for(issue)
|
|
if TYPES[relation_type]
|
|
if self.issue_from_id == issue.id
|
|
relation_type
|
|
else
|
|
TYPES[relation_type][:sym]
|
|
end
|
|
end
|
|
end
|
|
|
|
def label_for(issue)
|
|
if TYPES[relation_type]
|
|
TYPES[relation_type][(self.issue_from_id == issue.id) ? :name : :sym_name]
|
|
else
|
|
:unknow
|
|
end
|
|
end
|
|
|
|
def to_s(issue=nil)
|
|
issue ||= issue_from
|
|
issue_text = block_given? ? yield(other_issue(issue)) : "##{other_issue(issue).try(:id)}"
|
|
s = []
|
|
s << l(label_for(issue))
|
|
s << "(#{l('datetime.distance_in_words.x_days', :count => delay)})" if delay && delay != 0
|
|
s << issue_text
|
|
s.join(' ')
|
|
end
|
|
|
|
def css_classes_for(issue)
|
|
"rel-#{relation_type_for(issue)}"
|
|
end
|
|
|
|
def handle_issue_order
|
|
reverse_if_needed
|
|
|
|
if TYPE_PRECEDES == relation_type
|
|
self.delay ||= 0
|
|
else
|
|
self.delay = nil
|
|
end
|
|
set_issue_to_dates
|
|
end
|
|
|
|
def set_issue_to_dates(journal=nil)
|
|
soonest_start = self.successor_soonest_start
|
|
if soonest_start && issue_to
|
|
issue_to.reschedule_on!(soonest_start, journal)
|
|
end
|
|
end
|
|
|
|
def successor_soonest_start
|
|
if (TYPE_PRECEDES == self.relation_type) && delay && issue_from &&
|
|
(issue_from.start_date || issue_from.due_date)
|
|
add_working_days((issue_from.due_date || issue_from.start_date), (1 + delay))
|
|
end
|
|
end
|
|
|
|
def <=>(relation)
|
|
r = TYPES[self.relation_type][:order] <=> TYPES[relation.relation_type][:order]
|
|
r == 0 ? id <=> relation.id : r
|
|
end
|
|
|
|
def init_journals(user)
|
|
issue_from.init_journal(user) if issue_from
|
|
issue_to.init_journal(user) if issue_to
|
|
end
|
|
|
|
private
|
|
|
|
# Reverses the relation if needed so that it gets stored in the proper way
|
|
# Should not be reversed before validation so that it can be displayed back
|
|
# as entered on new relation form.
|
|
#
|
|
# Orders relates relations by ID, so that uniqueness index in DB is triggered
|
|
# on concurrent access.
|
|
def reverse_if_needed
|
|
if TYPES.has_key?(relation_type) && TYPES[relation_type][:reverse]
|
|
issue_tmp = issue_to
|
|
self.issue_to = issue_from
|
|
self.issue_from = issue_tmp
|
|
self.relation_type = TYPES[relation_type][:reverse]
|
|
|
|
elsif relation_type == TYPE_RELATES && issue_from_id > issue_to_id
|
|
self.issue_to, self.issue_from = issue_from, issue_to
|
|
end
|
|
end
|
|
|
|
# Returns true if the relation would create a circular dependency
|
|
def circular_dependency?
|
|
case relation_type
|
|
when 'follows'
|
|
issue_from.would_reschedule? issue_to
|
|
when 'precedes'
|
|
issue_to.would_reschedule? issue_from
|
|
when 'blocked'
|
|
issue_from.blocks? issue_to
|
|
when 'blocks'
|
|
issue_to.blocks? issue_from
|
|
when 'relates'
|
|
self.class.where(issue_from_id: issue_to, issue_to_id: issue_from).present?
|
|
else
|
|
false
|
|
end
|
|
end
|
|
|
|
def call_issues_relation_added_callback
|
|
call_issues_callback :relation_added
|
|
end
|
|
|
|
def call_issues_relation_removed_callback
|
|
call_issues_callback :relation_removed
|
|
end
|
|
|
|
def call_issues_callback(name)
|
|
[issue_from, issue_to].each do |issue|
|
|
if issue
|
|
issue.send name, self
|
|
end
|
|
end
|
|
end
|
|
end
|