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-2021 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.

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, included, #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


156
157
158
159
160
161
162
# File 'app/models/tracker.rb', line 156

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


147
148
149
150
151
152
153
# File 'app/models/tracker.rb', line 147

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

Instance Method Details

#<=>(tracker) ⇒ Object


95
96
97
# File 'app/models/tracker.rb', line 95

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

#copy_from(arg, options = {}) ⇒ Object


83
84
85
86
87
88
89
90
91
# File 'app/models/tracker.rb', line 83

def copy_from(arg, options={})
  return if arg.blank?

  tracker = arg.is_a?(Tracker) ? arg : Tracker.find_by_id(arg.to_s)
  self.attributes = tracker.attributes.dup.except("id", "name", "position")
  self.custom_field_ids = tracker.custom_field_ids.dup
  self.project_ids = tracker.project_ids.dup
  self
end

#copy_workflow_rules(source_tracker) ⇒ Object


142
143
144
# File 'app/models/tracker.rb', line 142

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

#core_fieldsObject


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

def core_fields
  CORE_FIELDS - disabled_core_fields
end

#core_fields=(fields) ⇒ Object

Raises:

  • (ArgumentError)

128
129
130
131
132
133
134
135
136
137
138
139
140
# File 'app/models/tracker.rb', line 128

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 |= 1 << i
    end
  end
  self.fields_bits = bits
  @disabled_core_fields = nil
  core_fields
end

#disabled_core_fieldsObject


115
116
117
118
119
120
121
122
# File 'app/models/tracker.rb', line 115

def disabled_core_fields
  i = -1
  @disabled_core_fields ||=
    CORE_FIELDS.select do
      i += 1
      (fields_bits || 0) & (1 << i) != 0
    end
end

#issue_status_idsObject


105
106
107
108
109
110
111
112
113
# File 'app/models/tracker.rb', line 105

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


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

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

#to_sObject


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

def to_s; name end