annotate app/models/.svn/text-base/issue.rb.svn-base @ 0:513646585e45

* Import Redmine trunk SVN rev 3859
author Chris Cannam
date Fri, 23 Jul 2010 15:52:44 +0100
parents
children 40f7cfd4df19
rev   line source
Chris@0 1 # redMine - project management software
Chris@0 2 # Copyright (C) 2006-2007 Jean-Philippe Lang
Chris@0 3 #
Chris@0 4 # This program is free software; you can redistribute it and/or
Chris@0 5 # modify it under the terms of the GNU General Public License
Chris@0 6 # as published by the Free Software Foundation; either version 2
Chris@0 7 # of the License, or (at your option) any later version.
Chris@0 8 #
Chris@0 9 # This program is distributed in the hope that it will be useful,
Chris@0 10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
Chris@0 11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
Chris@0 12 # GNU General Public License for more details.
Chris@0 13 #
Chris@0 14 # You should have received a copy of the GNU General Public License
Chris@0 15 # along with this program; if not, write to the Free Software
Chris@0 16 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Chris@0 17
Chris@0 18 class Issue < ActiveRecord::Base
Chris@0 19 belongs_to :project
Chris@0 20 belongs_to :tracker
Chris@0 21 belongs_to :status, :class_name => 'IssueStatus', :foreign_key => 'status_id'
Chris@0 22 belongs_to :author, :class_name => 'User', :foreign_key => 'author_id'
Chris@0 23 belongs_to :assigned_to, :class_name => 'User', :foreign_key => 'assigned_to_id'
Chris@0 24 belongs_to :fixed_version, :class_name => 'Version', :foreign_key => 'fixed_version_id'
Chris@0 25 belongs_to :priority, :class_name => 'IssuePriority', :foreign_key => 'priority_id'
Chris@0 26 belongs_to :category, :class_name => 'IssueCategory', :foreign_key => 'category_id'
Chris@0 27
Chris@0 28 has_many :journals, :as => :journalized, :dependent => :destroy
Chris@0 29 has_many :time_entries, :dependent => :delete_all
Chris@0 30 has_and_belongs_to_many :changesets, :order => "#{Changeset.table_name}.committed_on ASC, #{Changeset.table_name}.id ASC"
Chris@0 31
Chris@0 32 has_many :relations_from, :class_name => 'IssueRelation', :foreign_key => 'issue_from_id', :dependent => :delete_all
Chris@0 33 has_many :relations_to, :class_name => 'IssueRelation', :foreign_key => 'issue_to_id', :dependent => :delete_all
Chris@0 34
Chris@0 35 acts_as_nested_set :scope => 'root_id'
Chris@0 36 acts_as_attachable :after_remove => :attachment_removed
Chris@0 37 acts_as_customizable
Chris@0 38 acts_as_watchable
Chris@0 39 acts_as_searchable :columns => ['subject', "#{table_name}.description", "#{Journal.table_name}.notes"],
Chris@0 40 :include => [:project, :journals],
Chris@0 41 # sort by id so that limited eager loading doesn't break with postgresql
Chris@0 42 :order_column => "#{table_name}.id"
Chris@0 43 acts_as_event :title => Proc.new {|o| "#{o.tracker.name} ##{o.id} (#{o.status}): #{o.subject}"},
Chris@0 44 :url => Proc.new {|o| {:controller => 'issues', :action => 'show', :id => o.id}},
Chris@0 45 :type => Proc.new {|o| 'issue' + (o.closed? ? ' closed' : '') }
Chris@0 46
Chris@0 47 acts_as_activity_provider :find_options => {:include => [:project, :author, :tracker]},
Chris@0 48 :author_key => :author_id
Chris@0 49
Chris@0 50 DONE_RATIO_OPTIONS = %w(issue_field issue_status)
Chris@0 51
Chris@0 52 attr_reader :current_journal
Chris@0 53
Chris@0 54 validates_presence_of :subject, :priority, :project, :tracker, :author, :status
Chris@0 55
Chris@0 56 validates_length_of :subject, :maximum => 255
Chris@0 57 validates_inclusion_of :done_ratio, :in => 0..100
Chris@0 58 validates_numericality_of :estimated_hours, :allow_nil => true
Chris@0 59
Chris@0 60 named_scope :visible, lambda {|*args| { :include => :project,
Chris@0 61 :conditions => Project.allowed_to_condition(args.first || User.current, :view_issues) } }
Chris@0 62
Chris@0 63 named_scope :open, :conditions => ["#{IssueStatus.table_name}.is_closed = ?", false], :include => :status
Chris@0 64
Chris@0 65 named_scope :recently_updated, :order => "#{self.table_name}.updated_on DESC"
Chris@0 66 named_scope :with_limit, lambda { |limit| { :limit => limit} }
Chris@0 67 named_scope :on_active_project, :include => [:status, :project, :tracker],
Chris@0 68 :conditions => ["#{Project.table_name}.status=#{Project::STATUS_ACTIVE}"]
Chris@0 69
Chris@0 70 before_create :default_assign
Chris@0 71 before_save :reschedule_following_issues, :close_duplicates, :update_done_ratio_from_issue_status
Chris@0 72 after_save :update_nested_set_attributes, :update_parent_attributes, :create_journal
Chris@0 73 after_destroy :destroy_children
Chris@0 74 after_destroy :update_parent_attributes
Chris@0 75
Chris@0 76 # Returns true if usr or current user is allowed to view the issue
Chris@0 77 def visible?(usr=nil)
Chris@0 78 (usr || User.current).allowed_to?(:view_issues, self.project)
Chris@0 79 end
Chris@0 80
Chris@0 81 def after_initialize
Chris@0 82 if new_record?
Chris@0 83 # set default values for new records only
Chris@0 84 self.status ||= IssueStatus.default
Chris@0 85 self.priority ||= IssuePriority.default
Chris@0 86 end
Chris@0 87 end
Chris@0 88
Chris@0 89 # Overrides Redmine::Acts::Customizable::InstanceMethods#available_custom_fields
Chris@0 90 def available_custom_fields
Chris@0 91 (project && tracker) ? project.all_issue_custom_fields.select {|c| tracker.custom_fields.include? c } : []
Chris@0 92 end
Chris@0 93
Chris@0 94 def copy_from(arg)
Chris@0 95 issue = arg.is_a?(Issue) ? arg : Issue.visible.find(arg)
Chris@0 96 self.attributes = issue.attributes.dup.except("id", "root_id", "parent_id", "lft", "rgt", "created_on", "updated_on")
Chris@0 97 self.custom_field_values = issue.custom_field_values.inject({}) {|h,v| h[v.custom_field_id] = v.value; h}
Chris@0 98 self.status = issue.status
Chris@0 99 self
Chris@0 100 end
Chris@0 101
Chris@0 102 # Moves/copies an issue to a new project and tracker
Chris@0 103 # Returns the moved/copied issue on success, false on failure
Chris@0 104 def move_to_project(*args)
Chris@0 105 ret = Issue.transaction do
Chris@0 106 move_to_project_without_transaction(*args) || raise(ActiveRecord::Rollback)
Chris@0 107 end || false
Chris@0 108 end
Chris@0 109
Chris@0 110 def move_to_project_without_transaction(new_project, new_tracker = nil, options = {})
Chris@0 111 options ||= {}
Chris@0 112 issue = options[:copy] ? self.class.new.copy_from(self) : self
Chris@0 113
Chris@0 114 if new_project && issue.project_id != new_project.id
Chris@0 115 # delete issue relations
Chris@0 116 unless Setting.cross_project_issue_relations?
Chris@0 117 issue.relations_from.clear
Chris@0 118 issue.relations_to.clear
Chris@0 119 end
Chris@0 120 # issue is moved to another project
Chris@0 121 # reassign to the category with same name if any
Chris@0 122 new_category = issue.category.nil? ? nil : new_project.issue_categories.find_by_name(issue.category.name)
Chris@0 123 issue.category = new_category
Chris@0 124 # Keep the fixed_version if it's still valid in the new_project
Chris@0 125 unless new_project.shared_versions.include?(issue.fixed_version)
Chris@0 126 issue.fixed_version = nil
Chris@0 127 end
Chris@0 128 issue.project = new_project
Chris@0 129 if issue.parent && issue.parent.project_id != issue.project_id
Chris@0 130 issue.parent_issue_id = nil
Chris@0 131 end
Chris@0 132 end
Chris@0 133 if new_tracker
Chris@0 134 issue.tracker = new_tracker
Chris@0 135 issue.reset_custom_values!
Chris@0 136 end
Chris@0 137 if options[:copy]
Chris@0 138 issue.custom_field_values = self.custom_field_values.inject({}) {|h,v| h[v.custom_field_id] = v.value; h}
Chris@0 139 issue.status = if options[:attributes] && options[:attributes][:status_id]
Chris@0 140 IssueStatus.find_by_id(options[:attributes][:status_id])
Chris@0 141 else
Chris@0 142 self.status
Chris@0 143 end
Chris@0 144 end
Chris@0 145 # Allow bulk setting of attributes on the issue
Chris@0 146 if options[:attributes]
Chris@0 147 issue.attributes = options[:attributes]
Chris@0 148 end
Chris@0 149 if issue.save
Chris@0 150 unless options[:copy]
Chris@0 151 # Manually update project_id on related time entries
Chris@0 152 TimeEntry.update_all("project_id = #{new_project.id}", {:issue_id => id})
Chris@0 153
Chris@0 154 issue.children.each do |child|
Chris@0 155 unless child.move_to_project_without_transaction(new_project)
Chris@0 156 # Move failed and transaction was rollback'd
Chris@0 157 return false
Chris@0 158 end
Chris@0 159 end
Chris@0 160 end
Chris@0 161 else
Chris@0 162 return false
Chris@0 163 end
Chris@0 164 issue
Chris@0 165 end
Chris@0 166
Chris@0 167 def status_id=(sid)
Chris@0 168 self.status = nil
Chris@0 169 write_attribute(:status_id, sid)
Chris@0 170 end
Chris@0 171
Chris@0 172 def priority_id=(pid)
Chris@0 173 self.priority = nil
Chris@0 174 write_attribute(:priority_id, pid)
Chris@0 175 end
Chris@0 176
Chris@0 177 def tracker_id=(tid)
Chris@0 178 self.tracker = nil
Chris@0 179 result = write_attribute(:tracker_id, tid)
Chris@0 180 @custom_field_values = nil
Chris@0 181 result
Chris@0 182 end
Chris@0 183
Chris@0 184 # Overrides attributes= so that tracker_id gets assigned first
Chris@0 185 def attributes_with_tracker_first=(new_attributes, *args)
Chris@0 186 return if new_attributes.nil?
Chris@0 187 new_tracker_id = new_attributes['tracker_id'] || new_attributes[:tracker_id]
Chris@0 188 if new_tracker_id
Chris@0 189 self.tracker_id = new_tracker_id
Chris@0 190 end
Chris@0 191 send :attributes_without_tracker_first=, new_attributes, *args
Chris@0 192 end
Chris@0 193 # Do not redefine alias chain on reload (see #4838)
Chris@0 194 alias_method_chain(:attributes=, :tracker_first) unless method_defined?(:attributes_without_tracker_first=)
Chris@0 195
Chris@0 196 def estimated_hours=(h)
Chris@0 197 write_attribute :estimated_hours, (h.is_a?(String) ? h.to_hours : h)
Chris@0 198 end
Chris@0 199
Chris@0 200 SAFE_ATTRIBUTES = %w(
Chris@0 201 tracker_id
Chris@0 202 status_id
Chris@0 203 parent_issue_id
Chris@0 204 category_id
Chris@0 205 assigned_to_id
Chris@0 206 priority_id
Chris@0 207 fixed_version_id
Chris@0 208 subject
Chris@0 209 description
Chris@0 210 start_date
Chris@0 211 due_date
Chris@0 212 done_ratio
Chris@0 213 estimated_hours
Chris@0 214 custom_field_values
Chris@0 215 lock_version
Chris@0 216 ) unless const_defined?(:SAFE_ATTRIBUTES)
Chris@0 217
Chris@0 218 # Safely sets attributes
Chris@0 219 # Should be called from controllers instead of #attributes=
Chris@0 220 # attr_accessible is too rough because we still want things like
Chris@0 221 # Issue.new(:project => foo) to work
Chris@0 222 # TODO: move workflow/permission checks from controllers to here
Chris@0 223 def safe_attributes=(attrs, user=User.current)
Chris@0 224 return if attrs.nil?
Chris@0 225 attrs = attrs.reject {|k,v| !SAFE_ATTRIBUTES.include?(k)}
Chris@0 226 if attrs['status_id']
Chris@0 227 unless new_statuses_allowed_to(user).collect(&:id).include?(attrs['status_id'].to_i)
Chris@0 228 attrs.delete('status_id')
Chris@0 229 end
Chris@0 230 end
Chris@0 231
Chris@0 232 unless leaf?
Chris@0 233 attrs.reject! {|k,v| %w(priority_id done_ratio start_date due_date estimated_hours).include?(k)}
Chris@0 234 end
Chris@0 235
Chris@0 236 if attrs.has_key?('parent_issue_id')
Chris@0 237 if !user.allowed_to?(:manage_subtasks, project)
Chris@0 238 attrs.delete('parent_issue_id')
Chris@0 239 elsif !attrs['parent_issue_id'].blank?
Chris@0 240 attrs.delete('parent_issue_id') unless Issue.visible(user).exists?(attrs['parent_issue_id'])
Chris@0 241 end
Chris@0 242 end
Chris@0 243
Chris@0 244 self.attributes = attrs
Chris@0 245 end
Chris@0 246
Chris@0 247 def done_ratio
Chris@0 248 if Issue.use_status_for_done_ratio? && status && status.default_done_ratio?
Chris@0 249 status.default_done_ratio
Chris@0 250 else
Chris@0 251 read_attribute(:done_ratio)
Chris@0 252 end
Chris@0 253 end
Chris@0 254
Chris@0 255 def self.use_status_for_done_ratio?
Chris@0 256 Setting.issue_done_ratio == 'issue_status'
Chris@0 257 end
Chris@0 258
Chris@0 259 def self.use_field_for_done_ratio?
Chris@0 260 Setting.issue_done_ratio == 'issue_field'
Chris@0 261 end
Chris@0 262
Chris@0 263 def validate
Chris@0 264 if self.due_date.nil? && @attributes['due_date'] && !@attributes['due_date'].empty?
Chris@0 265 errors.add :due_date, :not_a_date
Chris@0 266 end
Chris@0 267
Chris@0 268 if self.due_date and self.start_date and self.due_date < self.start_date
Chris@0 269 errors.add :due_date, :greater_than_start_date
Chris@0 270 end
Chris@0 271
Chris@0 272 if start_date && soonest_start && start_date < soonest_start
Chris@0 273 errors.add :start_date, :invalid
Chris@0 274 end
Chris@0 275
Chris@0 276 if fixed_version
Chris@0 277 if !assignable_versions.include?(fixed_version)
Chris@0 278 errors.add :fixed_version_id, :inclusion
Chris@0 279 elsif reopened? && fixed_version.closed?
Chris@0 280 errors.add_to_base I18n.t(:error_can_not_reopen_issue_on_closed_version)
Chris@0 281 end
Chris@0 282 end
Chris@0 283
Chris@0 284 # Checks that the issue can not be added/moved to a disabled tracker
Chris@0 285 if project && (tracker_id_changed? || project_id_changed?)
Chris@0 286 unless project.trackers.include?(tracker)
Chris@0 287 errors.add :tracker_id, :inclusion
Chris@0 288 end
Chris@0 289 end
Chris@0 290
Chris@0 291 # Checks parent issue assignment
Chris@0 292 if @parent_issue
Chris@0 293 if @parent_issue.project_id != project_id
Chris@0 294 errors.add :parent_issue_id, :not_same_project
Chris@0 295 elsif !new_record?
Chris@0 296 # moving an existing issue
Chris@0 297 if @parent_issue.root_id != root_id
Chris@0 298 # we can always move to another tree
Chris@0 299 elsif move_possible?(@parent_issue)
Chris@0 300 # move accepted inside tree
Chris@0 301 else
Chris@0 302 errors.add :parent_issue_id, :not_a_valid_parent
Chris@0 303 end
Chris@0 304 end
Chris@0 305 end
Chris@0 306 end
Chris@0 307
Chris@0 308 # Set the done_ratio using the status if that setting is set. This will keep the done_ratios
Chris@0 309 # even if the user turns off the setting later
Chris@0 310 def update_done_ratio_from_issue_status
Chris@0 311 if Issue.use_status_for_done_ratio? && status && status.default_done_ratio?
Chris@0 312 self.done_ratio = status.default_done_ratio
Chris@0 313 end
Chris@0 314 end
Chris@0 315
Chris@0 316 def init_journal(user, notes = "")
Chris@0 317 @current_journal ||= Journal.new(:journalized => self, :user => user, :notes => notes)
Chris@0 318 @issue_before_change = self.clone
Chris@0 319 @issue_before_change.status = self.status
Chris@0 320 @custom_values_before_change = {}
Chris@0 321 self.custom_values.each {|c| @custom_values_before_change.store c.custom_field_id, c.value }
Chris@0 322 # Make sure updated_on is updated when adding a note.
Chris@0 323 updated_on_will_change!
Chris@0 324 @current_journal
Chris@0 325 end
Chris@0 326
Chris@0 327 # Return true if the issue is closed, otherwise false
Chris@0 328 def closed?
Chris@0 329 self.status.is_closed?
Chris@0 330 end
Chris@0 331
Chris@0 332 # Return true if the issue is being reopened
Chris@0 333 def reopened?
Chris@0 334 if !new_record? && status_id_changed?
Chris@0 335 status_was = IssueStatus.find_by_id(status_id_was)
Chris@0 336 status_new = IssueStatus.find_by_id(status_id)
Chris@0 337 if status_was && status_new && status_was.is_closed? && !status_new.is_closed?
Chris@0 338 return true
Chris@0 339 end
Chris@0 340 end
Chris@0 341 false
Chris@0 342 end
Chris@0 343
Chris@0 344 # Return true if the issue is being closed
Chris@0 345 def closing?
Chris@0 346 if !new_record? && status_id_changed?
Chris@0 347 status_was = IssueStatus.find_by_id(status_id_was)
Chris@0 348 status_new = IssueStatus.find_by_id(status_id)
Chris@0 349 if status_was && status_new && !status_was.is_closed? && status_new.is_closed?
Chris@0 350 return true
Chris@0 351 end
Chris@0 352 end
Chris@0 353 false
Chris@0 354 end
Chris@0 355
Chris@0 356 # Returns true if the issue is overdue
Chris@0 357 def overdue?
Chris@0 358 !due_date.nil? && (due_date < Date.today) && !status.is_closed?
Chris@0 359 end
Chris@0 360
Chris@0 361 # Users the issue can be assigned to
Chris@0 362 def assignable_users
Chris@0 363 project.assignable_users
Chris@0 364 end
Chris@0 365
Chris@0 366 # Versions that the issue can be assigned to
Chris@0 367 def assignable_versions
Chris@0 368 @assignable_versions ||= (project.shared_versions.open + [Version.find_by_id(fixed_version_id_was)]).compact.uniq.sort
Chris@0 369 end
Chris@0 370
Chris@0 371 # Returns true if this issue is blocked by another issue that is still open
Chris@0 372 def blocked?
Chris@0 373 !relations_to.detect {|ir| ir.relation_type == 'blocks' && !ir.issue_from.closed?}.nil?
Chris@0 374 end
Chris@0 375
Chris@0 376 # Returns an array of status that user is able to apply
Chris@0 377 def new_statuses_allowed_to(user, include_default=false)
Chris@0 378 statuses = status.find_new_statuses_allowed_to(user.roles_for_project(project), tracker)
Chris@0 379 statuses << status unless statuses.empty?
Chris@0 380 statuses << IssueStatus.default if include_default
Chris@0 381 statuses = statuses.uniq.sort
Chris@0 382 blocked? ? statuses.reject {|s| s.is_closed?} : statuses
Chris@0 383 end
Chris@0 384
Chris@0 385 # Returns the mail adresses of users that should be notified
Chris@0 386 def recipients
Chris@0 387 notified = project.notified_users
Chris@0 388 # Author and assignee are always notified unless they have been locked
Chris@0 389 notified << author if author && author.active?
Chris@0 390 notified << assigned_to if assigned_to && assigned_to.active?
Chris@0 391 notified.uniq!
Chris@0 392 # Remove users that can not view the issue
Chris@0 393 notified.reject! {|user| !visible?(user)}
Chris@0 394 notified.collect(&:mail)
Chris@0 395 end
Chris@0 396
Chris@0 397 # Returns the total number of hours spent on this issue and its descendants
Chris@0 398 #
Chris@0 399 # Example:
Chris@0 400 # spent_hours => 0.0
Chris@0 401 # spent_hours => 50.2
Chris@0 402 def spent_hours
Chris@0 403 @spent_hours ||= self_and_descendants.sum("#{TimeEntry.table_name}.hours", :include => :time_entries).to_f || 0.0
Chris@0 404 end
Chris@0 405
Chris@0 406 def relations
Chris@0 407 (relations_from + relations_to).sort
Chris@0 408 end
Chris@0 409
Chris@0 410 def all_dependent_issues
Chris@0 411 dependencies = []
Chris@0 412 relations_from.each do |relation|
Chris@0 413 dependencies << relation.issue_to
Chris@0 414 dependencies += relation.issue_to.all_dependent_issues
Chris@0 415 end
Chris@0 416 dependencies
Chris@0 417 end
Chris@0 418
Chris@0 419 # Returns an array of issues that duplicate this one
Chris@0 420 def duplicates
Chris@0 421 relations_to.select {|r| r.relation_type == IssueRelation::TYPE_DUPLICATES}.collect {|r| r.issue_from}
Chris@0 422 end
Chris@0 423
Chris@0 424 # Returns the due date or the target due date if any
Chris@0 425 # Used on gantt chart
Chris@0 426 def due_before
Chris@0 427 due_date || (fixed_version ? fixed_version.effective_date : nil)
Chris@0 428 end
Chris@0 429
Chris@0 430 # Returns the time scheduled for this issue.
Chris@0 431 #
Chris@0 432 # Example:
Chris@0 433 # Start Date: 2/26/09, End Date: 3/04/09
Chris@0 434 # duration => 6
Chris@0 435 def duration
Chris@0 436 (start_date && due_date) ? due_date - start_date : 0
Chris@0 437 end
Chris@0 438
Chris@0 439 def soonest_start
Chris@0 440 @soonest_start ||= (
Chris@0 441 relations_to.collect{|relation| relation.successor_soonest_start} +
Chris@0 442 ancestors.collect(&:soonest_start)
Chris@0 443 ).compact.max
Chris@0 444 end
Chris@0 445
Chris@0 446 def reschedule_after(date)
Chris@0 447 return if date.nil?
Chris@0 448 if leaf?
Chris@0 449 if start_date.nil? || start_date < date
Chris@0 450 self.start_date, self.due_date = date, date + duration
Chris@0 451 save
Chris@0 452 end
Chris@0 453 else
Chris@0 454 leaves.each do |leaf|
Chris@0 455 leaf.reschedule_after(date)
Chris@0 456 end
Chris@0 457 end
Chris@0 458 end
Chris@0 459
Chris@0 460 def <=>(issue)
Chris@0 461 if issue.nil?
Chris@0 462 -1
Chris@0 463 elsif root_id != issue.root_id
Chris@0 464 (root_id || 0) <=> (issue.root_id || 0)
Chris@0 465 else
Chris@0 466 (lft || 0) <=> (issue.lft || 0)
Chris@0 467 end
Chris@0 468 end
Chris@0 469
Chris@0 470 def to_s
Chris@0 471 "#{tracker} ##{id}: #{subject}"
Chris@0 472 end
Chris@0 473
Chris@0 474 # Returns a string of css classes that apply to the issue
Chris@0 475 def css_classes
Chris@0 476 s = "issue status-#{status.position} priority-#{priority.position}"
Chris@0 477 s << ' closed' if closed?
Chris@0 478 s << ' overdue' if overdue?
Chris@0 479 s << ' created-by-me' if User.current.logged? && author_id == User.current.id
Chris@0 480 s << ' assigned-to-me' if User.current.logged? && assigned_to_id == User.current.id
Chris@0 481 s
Chris@0 482 end
Chris@0 483
Chris@0 484 # Saves an issue, time_entry, attachments, and a journal from the parameters
Chris@0 485 # Returns false if save fails
Chris@0 486 def save_issue_with_child_records(params, existing_time_entry=nil)
Chris@0 487 Issue.transaction do
Chris@0 488 if params[:time_entry] && params[:time_entry][:hours].present? && User.current.allowed_to?(:log_time, project)
Chris@0 489 @time_entry = existing_time_entry || TimeEntry.new
Chris@0 490 @time_entry.project = project
Chris@0 491 @time_entry.issue = self
Chris@0 492 @time_entry.user = User.current
Chris@0 493 @time_entry.spent_on = Date.today
Chris@0 494 @time_entry.attributes = params[:time_entry]
Chris@0 495 self.time_entries << @time_entry
Chris@0 496 end
Chris@0 497
Chris@0 498 if valid?
Chris@0 499 attachments = Attachment.attach_files(self, params[:attachments])
Chris@0 500
Chris@0 501 attachments[:files].each {|a| @current_journal.details << JournalDetail.new(:property => 'attachment', :prop_key => a.id, :value => a.filename)}
Chris@0 502 # TODO: Rename hook
Chris@0 503 Redmine::Hook.call_hook(:controller_issues_edit_before_save, { :params => params, :issue => self, :time_entry => @time_entry, :journal => @current_journal})
Chris@0 504 begin
Chris@0 505 if save
Chris@0 506 # TODO: Rename hook
Chris@0 507 Redmine::Hook.call_hook(:controller_issues_edit_after_save, { :params => params, :issue => self, :time_entry => @time_entry, :journal => @current_journal})
Chris@0 508 else
Chris@0 509 raise ActiveRecord::Rollback
Chris@0 510 end
Chris@0 511 rescue ActiveRecord::StaleObjectError
Chris@0 512 attachments[:files].each(&:destroy)
Chris@0 513 errors.add_to_base l(:notice_locking_conflict)
Chris@0 514 raise ActiveRecord::Rollback
Chris@0 515 end
Chris@0 516 end
Chris@0 517 end
Chris@0 518 end
Chris@0 519
Chris@0 520 # Unassigns issues from +version+ if it's no longer shared with issue's project
Chris@0 521 def self.update_versions_from_sharing_change(version)
Chris@0 522 # Update issues assigned to the version
Chris@0 523 update_versions(["#{Issue.table_name}.fixed_version_id = ?", version.id])
Chris@0 524 end
Chris@0 525
Chris@0 526 # Unassigns issues from versions that are no longer shared
Chris@0 527 # after +project+ was moved
Chris@0 528 def self.update_versions_from_hierarchy_change(project)
Chris@0 529 moved_project_ids = project.self_and_descendants.reload.collect(&:id)
Chris@0 530 # Update issues of the moved projects and issues assigned to a version of a moved project
Chris@0 531 Issue.update_versions(["#{Version.table_name}.project_id IN (?) OR #{Issue.table_name}.project_id IN (?)", moved_project_ids, moved_project_ids])
Chris@0 532 end
Chris@0 533
Chris@0 534 def parent_issue_id=(arg)
Chris@0 535 parent_issue_id = arg.blank? ? nil : arg.to_i
Chris@0 536 if parent_issue_id && @parent_issue = Issue.find_by_id(parent_issue_id)
Chris@0 537 @parent_issue.id
Chris@0 538 else
Chris@0 539 @parent_issue = nil
Chris@0 540 nil
Chris@0 541 end
Chris@0 542 end
Chris@0 543
Chris@0 544 def parent_issue_id
Chris@0 545 if instance_variable_defined? :@parent_issue
Chris@0 546 @parent_issue.nil? ? nil : @parent_issue.id
Chris@0 547 else
Chris@0 548 parent_id
Chris@0 549 end
Chris@0 550 end
Chris@0 551
Chris@0 552 # Extracted from the ReportsController.
Chris@0 553 def self.by_tracker(project)
Chris@0 554 count_and_group_by(:project => project,
Chris@0 555 :field => 'tracker_id',
Chris@0 556 :joins => Tracker.table_name)
Chris@0 557 end
Chris@0 558
Chris@0 559 def self.by_version(project)
Chris@0 560 count_and_group_by(:project => project,
Chris@0 561 :field => 'fixed_version_id',
Chris@0 562 :joins => Version.table_name)
Chris@0 563 end
Chris@0 564
Chris@0 565 def self.by_priority(project)
Chris@0 566 count_and_group_by(:project => project,
Chris@0 567 :field => 'priority_id',
Chris@0 568 :joins => IssuePriority.table_name)
Chris@0 569 end
Chris@0 570
Chris@0 571 def self.by_category(project)
Chris@0 572 count_and_group_by(:project => project,
Chris@0 573 :field => 'category_id',
Chris@0 574 :joins => IssueCategory.table_name)
Chris@0 575 end
Chris@0 576
Chris@0 577 def self.by_assigned_to(project)
Chris@0 578 count_and_group_by(:project => project,
Chris@0 579 :field => 'assigned_to_id',
Chris@0 580 :joins => User.table_name)
Chris@0 581 end
Chris@0 582
Chris@0 583 def self.by_author(project)
Chris@0 584 count_and_group_by(:project => project,
Chris@0 585 :field => 'author_id',
Chris@0 586 :joins => User.table_name)
Chris@0 587 end
Chris@0 588
Chris@0 589 def self.by_subproject(project)
Chris@0 590 ActiveRecord::Base.connection.select_all("select s.id as status_id,
Chris@0 591 s.is_closed as closed,
Chris@0 592 i.project_id as project_id,
Chris@0 593 count(i.id) as total
Chris@0 594 from
Chris@0 595 #{Issue.table_name} i, #{IssueStatus.table_name} s
Chris@0 596 where
Chris@0 597 i.status_id=s.id
Chris@0 598 and i.project_id IN (#{project.descendants.active.collect{|p| p.id}.join(',')})
Chris@0 599 group by s.id, s.is_closed, i.project_id") if project.descendants.active.any?
Chris@0 600 end
Chris@0 601 # End ReportsController extraction
Chris@0 602
Chris@0 603 # Returns an array of projects that current user can move issues to
Chris@0 604 def self.allowed_target_projects_on_move
Chris@0 605 projects = []
Chris@0 606 if User.current.admin?
Chris@0 607 # admin is allowed to move issues to any active (visible) project
Chris@0 608 projects = Project.visible.all
Chris@0 609 elsif User.current.logged?
Chris@0 610 if Role.non_member.allowed_to?(:move_issues)
Chris@0 611 projects = Project.visible.all
Chris@0 612 else
Chris@0 613 User.current.memberships.each {|m| projects << m.project if m.roles.detect {|r| r.allowed_to?(:move_issues)}}
Chris@0 614 end
Chris@0 615 end
Chris@0 616 projects
Chris@0 617 end
Chris@0 618
Chris@0 619 private
Chris@0 620
Chris@0 621 def update_nested_set_attributes
Chris@0 622 if root_id.nil?
Chris@0 623 # issue was just created
Chris@0 624 self.root_id = (@parent_issue.nil? ? id : @parent_issue.root_id)
Chris@0 625 set_default_left_and_right
Chris@0 626 Issue.update_all("root_id = #{root_id}, lft = #{lft}, rgt = #{rgt}", ["id = ?", id])
Chris@0 627 if @parent_issue
Chris@0 628 move_to_child_of(@parent_issue)
Chris@0 629 end
Chris@0 630 reload
Chris@0 631 elsif parent_issue_id != parent_id
Chris@0 632 former_parent_id = parent_id
Chris@0 633 # moving an existing issue
Chris@0 634 if @parent_issue && @parent_issue.root_id == root_id
Chris@0 635 # inside the same tree
Chris@0 636 move_to_child_of(@parent_issue)
Chris@0 637 else
Chris@0 638 # to another tree
Chris@0 639 unless root?
Chris@0 640 move_to_right_of(root)
Chris@0 641 reload
Chris@0 642 end
Chris@0 643 old_root_id = root_id
Chris@0 644 self.root_id = (@parent_issue.nil? ? id : @parent_issue.root_id )
Chris@0 645 target_maxright = nested_set_scope.maximum(right_column_name) || 0
Chris@0 646 offset = target_maxright + 1 - lft
Chris@0 647 Issue.update_all("root_id = #{root_id}, lft = lft + #{offset}, rgt = rgt + #{offset}",
Chris@0 648 ["root_id = ? AND lft >= ? AND rgt <= ? ", old_root_id, lft, rgt])
Chris@0 649 self[left_column_name] = lft + offset
Chris@0 650 self[right_column_name] = rgt + offset
Chris@0 651 if @parent_issue
Chris@0 652 move_to_child_of(@parent_issue)
Chris@0 653 end
Chris@0 654 end
Chris@0 655 reload
Chris@0 656 # delete invalid relations of all descendants
Chris@0 657 self_and_descendants.each do |issue|
Chris@0 658 issue.relations.each do |relation|
Chris@0 659 relation.destroy unless relation.valid?
Chris@0 660 end
Chris@0 661 end
Chris@0 662 # update former parent
Chris@0 663 recalculate_attributes_for(former_parent_id) if former_parent_id
Chris@0 664 end
Chris@0 665 remove_instance_variable(:@parent_issue) if instance_variable_defined?(:@parent_issue)
Chris@0 666 end
Chris@0 667
Chris@0 668 def update_parent_attributes
Chris@0 669 recalculate_attributes_for(parent_id) if parent_id
Chris@0 670 end
Chris@0 671
Chris@0 672 def recalculate_attributes_for(issue_id)
Chris@0 673 if issue_id && p = Issue.find_by_id(issue_id)
Chris@0 674 # priority = highest priority of children
Chris@0 675 if priority_position = p.children.maximum("#{IssuePriority.table_name}.position", :include => :priority)
Chris@0 676 p.priority = IssuePriority.find_by_position(priority_position)
Chris@0 677 end
Chris@0 678
Chris@0 679 # start/due dates = lowest/highest dates of children
Chris@0 680 p.start_date = p.children.minimum(:start_date)
Chris@0 681 p.due_date = p.children.maximum(:due_date)
Chris@0 682 if p.start_date && p.due_date && p.due_date < p.start_date
Chris@0 683 p.start_date, p.due_date = p.due_date, p.start_date
Chris@0 684 end
Chris@0 685
Chris@0 686 # done ratio = weighted average ratio of leaves
Chris@0 687 unless Issue.use_status_for_done_ratio? && p.status && p.status.default_done_ratio?
Chris@0 688 leaves_count = p.leaves.count
Chris@0 689 if leaves_count > 0
Chris@0 690 average = p.leaves.average(:estimated_hours).to_f
Chris@0 691 if average == 0
Chris@0 692 average = 1
Chris@0 693 end
Chris@0 694 done = p.leaves.sum("COALESCE(estimated_hours, #{average}) * (CASE WHEN is_closed = #{connection.quoted_true} THEN 100 ELSE COALESCE(done_ratio, 0) END)", :include => :status).to_f
Chris@0 695 progress = done / (average * leaves_count)
Chris@0 696 p.done_ratio = progress.round
Chris@0 697 end
Chris@0 698 end
Chris@0 699
Chris@0 700 # estimate = sum of leaves estimates
Chris@0 701 p.estimated_hours = p.leaves.sum(:estimated_hours).to_f
Chris@0 702 p.estimated_hours = nil if p.estimated_hours == 0.0
Chris@0 703
Chris@0 704 # ancestors will be recursively updated
Chris@0 705 p.save(false)
Chris@0 706 end
Chris@0 707 end
Chris@0 708
Chris@0 709 def destroy_children
Chris@0 710 unless leaf?
Chris@0 711 children.each do |child|
Chris@0 712 child.destroy
Chris@0 713 end
Chris@0 714 end
Chris@0 715 end
Chris@0 716
Chris@0 717 # Update issues so their versions are not pointing to a
Chris@0 718 # fixed_version that is not shared with the issue's project
Chris@0 719 def self.update_versions(conditions=nil)
Chris@0 720 # Only need to update issues with a fixed_version from
Chris@0 721 # a different project and that is not systemwide shared
Chris@0 722 Issue.all(:conditions => merge_conditions("#{Issue.table_name}.fixed_version_id IS NOT NULL" +
Chris@0 723 " AND #{Issue.table_name}.project_id <> #{Version.table_name}.project_id" +
Chris@0 724 " AND #{Version.table_name}.sharing <> 'system'",
Chris@0 725 conditions),
Chris@0 726 :include => [:project, :fixed_version]
Chris@0 727 ).each do |issue|
Chris@0 728 next if issue.project.nil? || issue.fixed_version.nil?
Chris@0 729 unless issue.project.shared_versions.include?(issue.fixed_version)
Chris@0 730 issue.init_journal(User.current)
Chris@0 731 issue.fixed_version = nil
Chris@0 732 issue.save
Chris@0 733 end
Chris@0 734 end
Chris@0 735 end
Chris@0 736
Chris@0 737 # Callback on attachment deletion
Chris@0 738 def attachment_removed(obj)
Chris@0 739 journal = init_journal(User.current)
Chris@0 740 journal.details << JournalDetail.new(:property => 'attachment',
Chris@0 741 :prop_key => obj.id,
Chris@0 742 :old_value => obj.filename)
Chris@0 743 journal.save
Chris@0 744 end
Chris@0 745
Chris@0 746 # Default assignment based on category
Chris@0 747 def default_assign
Chris@0 748 if assigned_to.nil? && category && category.assigned_to
Chris@0 749 self.assigned_to = category.assigned_to
Chris@0 750 end
Chris@0 751 end
Chris@0 752
Chris@0 753 # Updates start/due dates of following issues
Chris@0 754 def reschedule_following_issues
Chris@0 755 if start_date_changed? || due_date_changed?
Chris@0 756 relations_from.each do |relation|
Chris@0 757 relation.set_issue_to_dates
Chris@0 758 end
Chris@0 759 end
Chris@0 760 end
Chris@0 761
Chris@0 762 # Closes duplicates if the issue is being closed
Chris@0 763 def close_duplicates
Chris@0 764 if closing?
Chris@0 765 duplicates.each do |duplicate|
Chris@0 766 # Reload is need in case the duplicate was updated by a previous duplicate
Chris@0 767 duplicate.reload
Chris@0 768 # Don't re-close it if it's already closed
Chris@0 769 next if duplicate.closed?
Chris@0 770 # Same user and notes
Chris@0 771 if @current_journal
Chris@0 772 duplicate.init_journal(@current_journal.user, @current_journal.notes)
Chris@0 773 end
Chris@0 774 duplicate.update_attribute :status, self.status
Chris@0 775 end
Chris@0 776 end
Chris@0 777 end
Chris@0 778
Chris@0 779 # Saves the changes in a Journal
Chris@0 780 # Called after_save
Chris@0 781 def create_journal
Chris@0 782 if @current_journal
Chris@0 783 # attributes changes
Chris@0 784 (Issue.column_names - %w(id description root_id lft rgt lock_version created_on updated_on)).each {|c|
Chris@0 785 @current_journal.details << JournalDetail.new(:property => 'attr',
Chris@0 786 :prop_key => c,
Chris@0 787 :old_value => @issue_before_change.send(c),
Chris@0 788 :value => send(c)) unless send(c)==@issue_before_change.send(c)
Chris@0 789 }
Chris@0 790 # custom fields changes
Chris@0 791 custom_values.each {|c|
Chris@0 792 next if (@custom_values_before_change[c.custom_field_id]==c.value ||
Chris@0 793 (@custom_values_before_change[c.custom_field_id].blank? && c.value.blank?))
Chris@0 794 @current_journal.details << JournalDetail.new(:property => 'cf',
Chris@0 795 :prop_key => c.custom_field_id,
Chris@0 796 :old_value => @custom_values_before_change[c.custom_field_id],
Chris@0 797 :value => c.value)
Chris@0 798 }
Chris@0 799 @current_journal.save
Chris@0 800 # reset current journal
Chris@0 801 init_journal @current_journal.user, @current_journal.notes
Chris@0 802 end
Chris@0 803 end
Chris@0 804
Chris@0 805 # Query generator for selecting groups of issue counts for a project
Chris@0 806 # based on specific criteria
Chris@0 807 #
Chris@0 808 # Options
Chris@0 809 # * project - Project to search in.
Chris@0 810 # * field - String. Issue field to key off of in the grouping.
Chris@0 811 # * joins - String. The table name to join against.
Chris@0 812 def self.count_and_group_by(options)
Chris@0 813 project = options.delete(:project)
Chris@0 814 select_field = options.delete(:field)
Chris@0 815 joins = options.delete(:joins)
Chris@0 816
Chris@0 817 where = "i.#{select_field}=j.id"
Chris@0 818
Chris@0 819 ActiveRecord::Base.connection.select_all("select s.id as status_id,
Chris@0 820 s.is_closed as closed,
Chris@0 821 j.id as #{select_field},
Chris@0 822 count(i.id) as total
Chris@0 823 from
Chris@0 824 #{Issue.table_name} i, #{IssueStatus.table_name} s, #{joins} as j
Chris@0 825 where
Chris@0 826 i.status_id=s.id
Chris@0 827 and #{where}
Chris@0 828 and i.project_id=#{project.id}
Chris@0 829 group by s.id, s.is_closed, j.id")
Chris@0 830 end
Chris@0 831
Chris@0 832
Chris@0 833 end