Class: IssueRelation

Inherits:
ActiveRecord::Base
  • Object
show all
Defined in:
app/models/issue_relation.rb

Overview

Redmine - project management software Copyright (C) 2006-2014 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.

Defined Under Namespace

Classes: Relations

Constant Summary collapse

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

Instance Method Summary collapse

Constructor Details

#initialize(attributes = nil, *args) ⇒ IssueRelation

Returns a new instance of IssueRelation



88
89
90
91
92
93
94
95
# File 'app/models/issue_relation.rb', line 88

def initialize(attributes=nil, *args)
  super
  if new_record?
    if relation_type.blank?
      self.relation_type = IssueRelation::TYPE_RELATES
    end
  end
end

Instance Method Details

#<=>(relation) ⇒ Object



176
177
178
179
# File 'app/models/issue_relation.rb', line 176

def <=>(relation)
  r = TYPES[self.relation_type][:order] <=> TYPES[relation.relation_type][:order]
  r == 0 ? id <=> relation.id : r
end

#css_classes_for(issue) ⇒ Object



147
148
149
# File 'app/models/issue_relation.rb', line 147

def css_classes_for(issue)
  "rel-#{relation_type_for(issue)}"
end

#deletable?(user = User.current) ⇒ Boolean

Returns:

  • (Boolean)


82
83
84
85
86
# File 'app/models/issue_relation.rb', line 82

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

#handle_issue_orderObject



151
152
153
154
155
156
157
158
159
160
# File 'app/models/issue_relation.rb', line 151

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

#init_journals(user) ⇒ Object



181
182
183
184
# File 'app/models/issue_relation.rb', line 181

def init_journals(user)
  issue_from.init_journal(user) if issue_from
  issue_to.init_journal(user) if issue_to
end

#label_for(issue) ⇒ Object



131
132
133
134
135
# File 'app/models/issue_relation.rb', line 131

def label_for(issue)
  TYPES[relation_type] ?
      TYPES[relation_type][(self.issue_from_id == issue.id) ? :name : :sym_name] :
      :unknow
end

#other_issue(issue) ⇒ Object



116
117
118
# File 'app/models/issue_relation.rb', line 116

def other_issue(issue)
  (self.issue_from_id == issue.id) ? issue_to : issue_from
end

#relation_type_for(issue) ⇒ Object

Returns the relation type for issue



121
122
123
124
125
126
127
128
129
# File 'app/models/issue_relation.rb', line 121

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

#set_issue_to_datesObject



162
163
164
165
166
167
# File 'app/models/issue_relation.rb', line 162

def set_issue_to_dates
  soonest_start = self.successor_soonest_start
  if soonest_start && issue_to
    issue_to.reschedule_on!(soonest_start)
  end
end

#successor_soonest_startObject



169
170
171
172
173
174
# File 'app/models/issue_relation.rb', line 169

def successor_soonest_start
  if (TYPE_PRECEDES == self.relation_type) && delay && issue_from &&
         (issue_from.start_date || issue_from.due_date)
    (issue_from.due_date || issue_from.start_date) + 1 + delay
  end
end

#to_s(issue = nil) ⇒ Object



137
138
139
140
141
142
143
144
145
# File 'app/models/issue_relation.rb', line 137

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

#validate_issue_relationObject



97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
# File 'app/models/issue_relation.rb', line 97

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
    # detect circular dependencies depending wether the relation should be reversed
    if TYPES.has_key?(relation_type) && TYPES[relation_type][:reverse]
      errors.add :base, :circular_dependency if issue_from.all_dependent_issues.include? issue_to
    else
      errors.add :base, :circular_dependency if issue_to.all_dependent_issues.include? issue_from
    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

#visible?(user = User.current) ⇒ Boolean

Returns:

  • (Boolean)


78
79
80
# File 'app/models/issue_relation.rb', line 78

def visible?(user=User.current)
  (issue_from.nil? || issue_from.visible?(user)) && (issue_to.nil? || issue_to.visible?(user))
end