Class: Tracker

Inherits:
ActiveRecord::Base
  • Object
show all
Includes:
Redmine::SafeAttributes
Defined in:
app/models/tracker.rb

Overview

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

Since:

  • 0.4.0

Constant Summary collapse

CORE_FIELDS_UNDISABLABLE =
%w(project_id tracker_id subject priority_id is_private).freeze
CORE_FIELDS =

Fields that can be disabled Other (future) fields should be appended, not inserted!

%w(assigned_to_id category_id fixed_version_id parent_issue_id start_date due_date estimated_hours done_ratio description).freeze
CORE_FIELDS_ALL =
(CORE_FIELDS_UNDISABLABLE + CORE_FIELDS).freeze

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Redmine::SafeAttributes

#delete_unsafe_attributes, #safe_attribute?, #safe_attribute_names, #safe_attributes=

Class Method Details

.core_fields(trackers) ⇒ Object

Returns the fields that are enabled for one tracker at least

Since:

  • 2.1.0



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

def self.core_fields(trackers)
  if trackers.present?
    trackers.uniq.map(&:core_fields).reduce(:|)
  else
    CORE_FIELDS.dup
  end
end

.disabled_core_fields(trackers) ⇒ Object

Returns the fields that are disabled for all the given trackers

Since:

  • 2.1.0



129
130
131
132
133
134
135
# File 'app/models/tracker.rb', line 129

def self.disabled_core_fields(trackers)
  if trackers.present?
    trackers.map(&:disabled_core_fields).reduce(:&)
  else
    []
  end
end

Instance Method Details

#<=>(tracker) ⇒ Object

Since:

  • 0.6.1



83
84
85
# File 'app/models/tracker.rb', line 83

def <=>(tracker)
  position <=> tracker.position
end

#copy_workflow_rules(source_tracker) ⇒ Object

Since:

  • 3.4.0



124
125
126
# File 'app/models/tracker.rb', line 124

def copy_workflow_rules(source_tracker)
  WorkflowRule.copy(source_tracker, nil, self, nil)
end

#core_fieldsObject

Since:

  • 2.1.0



106
107
108
# File 'app/models/tracker.rb', line 106

def core_fields
  CORE_FIELDS - disabled_core_fields
end

#core_fields=(fields) ⇒ Object

Raises:

  • (ArgumentError)

Since:

  • 2.1.0



110
111
112
113
114
115
116
117
118
119
120
121
122
# File 'app/models/tracker.rb', line 110

def core_fields=(fields)
  raise ArgumentError.new("Tracker.core_fields takes an array") unless fields.is_a?(Array)

  bits = 0
  CORE_FIELDS.each_with_index do |field, i|
    unless fields.include?(field)
      bits |= 2 ** i
    end
  end
  self.fields_bits = bits
  @disabled_core_fields = nil
  core_fields
end

#disabled_core_fieldsObject

Since:

  • 2.1.0



101
102
103
104
# File 'app/models/tracker.rb', line 101

def disabled_core_fields
  i = -1
  @disabled_core_fields ||= CORE_FIELDS.select { i += 1; (fields_bits || 0) & (2 ** i) != 0}
end

#issue_status_idsObject

Since:

  • 3.0.0



93
94
95
96
97
98
99
# File 'app/models/tracker.rb', line 93

def issue_status_ids
  if new_record?
    []
  else
    @issue_status_ids ||= WorkflowTransition.where(:tracker_id => id).distinct.pluck(:old_status_id, :new_status_id).flatten.uniq
  end
end

#issue_statusesObject

Returns an array of IssueStatus that are used in the tracker's workflows

Since:

  • 0.9.0



89
90
91
# File 'app/models/tracker.rb', line 89

def issue_statuses
  @issue_statuses ||= IssueStatus.where(:id => issue_status_ids).to_a.sort
end

#to_sObject

Since:

  • 0.6.0



81
# File 'app/models/tracker.rb', line 81

def to_s; name end