class Project

File: project.rb
(C): Hipposoft 2007
Purpose: Describe the behaviour of Project objects. See below for more details.

24-Dec-2007 (ADH): Created.

Constants

USED_RANGE_COLUMN

Public Class Methods

new( params = nil, user = nil ) click to toggle source

Some default properties are dynamic, so assign these here rather than as defaults in a migration.

Parameters:

Optional hash used for instance initialisation in the traditional way
for an ActiveRecord subclass.

Optional User object. A default customer is taken from that user's
control panel data, if available.

# File app/models/project.rb, line 51
def initialize( params = nil, user = nil )
  super( params )

  if ( params.nil? )
    self.active = true
    self.code   = "PID%04d" % Project.count

    if ( user and user.control_panel )
      cp = user.control_panel
      self.customer = cp.customer if ( cp.customer and cp.customer.active )
    end
  end
end

Public Instance Methods

destroy_with_side_effects( destroy_tasks = true ) click to toggle source

As update_with_side_effects!, but destroys things rather than updating them. Pass ‘true’ to destroy associated tasks, else ‘false’. If omitted, defaults to ‘true’.

# File app/models/project.rb, line 90
def destroy_with_side_effects( destroy_tasks = true )
  if ( destroy_tasks )
    self.tasks.all.each do | task |
      task.destroy()
    end
  else
    Task.where( :project_id => self.id ).update_all( :project_id => nil )
  end

  self.destroy()
end

update_with_side_effects!( attrs, update_tasks = true ) click to toggle source

Update an object with the given attributes. This is done by a special model method because changes of the ‘active’ flag have side effects for other associated objects. THE CALLER *MUST* USE A TRANSACTION around a call to this method. There is no need to call here unless the ‘active’ flag state is changing. Pass in ‘true’ to update associated tasks, else ‘false’. If omitted, defaults to ‘true’.

# File app/models/project.rb, line 73
def update_with_side_effects!( attrs, update_tasks = true )
  active = self.active
  self.update_attributes!( attrs )

  # If the active flag has changed, deal with repercussions.

  if ( update_tasks and attrs[ :active ] != active )
    self.tasks.all.each do | task |
      task.update_with_side_effects!( { :active => attrs[ :active ] } )
    end
  end
end