custom_field.rb
281 lines
| 8.4 KiB
| text/x-ruby
|
RubyLexer
|
r5152 | # Redmine - project management software | ||
|
r12461 | # Copyright (C) 2006-2014 Jean-Philippe Lang | ||
|
r330 | # | ||
# 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. | ||||
|
r6393 | # | ||
|
r330 | # 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. | ||||
|
r6393 | # | ||
|
r330 | # 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. | ||||
class CustomField < ActiveRecord::Base | ||||
|
r8063 | include Redmine::SubclassFactory | ||
|
r330 | has_many :custom_values, :dependent => :delete_all | ||
|
r11782 | has_and_belongs_to_many :roles, :join_table => "#{table_name_prefix}custom_fields_roles#{table_name_suffix}", :foreign_key => "custom_field_id" | ||
|
r888 | acts_as_list :scope => 'type = \'#{self.class}\'' | ||
|
r330 | serialize :possible_values | ||
|
r12125 | store :format_store | ||
|
r6393 | |||
|
r330 | validates_presence_of :name, :field_format | ||
|
r1729 | validates_uniqueness_of :name, :scope => :type | ||
|
r590 | validates_length_of :name, :maximum => 30 | ||
|
r12125 | validates_inclusion_of :field_format, :in => Proc.new { Redmine::FieldFormat.available_formats } | ||
|
r8597 | validate :validate_custom_field | ||
|
r11782 | |||
|
r8071 | before_validation :set_searchable | ||
|
r12125 | before_save do |field| | ||
field.format.before_custom_field_save(field) | ||||
end | ||||
|
r10937 | after_save :handle_multiplicity_change | ||
|
r11782 | after_save do |field| | ||
if field.visible_changed? && field.visible | ||||
field.roles.clear | ||||
end | ||||
end | ||||
|
r6792 | |||
|
r10722 | scope :sorted, lambda { order("#{table_name}.position ASC") } | ||
|
r11782 | scope :visible, lambda {|*args| | ||
user = args.shift || User.current | ||||
if user.admin? | ||||
# nop | ||||
elsif user.memberships.any? | ||||
where("#{table_name}.visible = ? OR #{table_name}.id IN (SELECT DISTINCT cfr.custom_field_id FROM #{Member.table_name} m" + | ||||
" INNER JOIN #{MemberRole.table_name} mr ON mr.member_id = m.id" + | ||||
" INNER JOIN #{table_name_prefix}custom_fields_roles#{table_name_suffix} cfr ON cfr.role_id = mr.role_id" + | ||||
" WHERE m.user_id = ?)", | ||||
true, user.id) | ||||
else | ||||
where(:visible => true) | ||||
end | ||||
} | ||||
|
r10689 | |||
|
r11811 | def visible_by?(project, user=User.current) | ||
visible? || user.admin? | ||||
end | ||||
|
r12125 | def format | ||
@format ||= Redmine::FieldFormat.find(field_format) | ||||
end | ||||
|
r10413 | def field_format=(arg) | ||
# cannot change format of a saved custom field | ||||
|
r12125 | if new_record? | ||
@format = nil | ||||
super | ||||
end | ||||
|
r10413 | end | ||
|
r8071 | def set_searchable | ||
|
r981 | # make sure these fields are not searchable | ||
|
r12125 | self.searchable = false unless format.class.searchable_supported | ||
|
r8601 | # make sure only these fields can have multiple values | ||
|
r12125 | self.multiple = false unless format.class.multiple_supported | ||
|
r983 | true | ||
|
r330 | end | ||
|
r6393 | |||
|
r8597 | def validate_custom_field | ||
|
r12125 | format.validate_custom_field(self).each do |attribute, message| | ||
errors.add attribute, message | ||||
|
r330 | end | ||
|
r6393 | |||
|
r6178 | if regexp.present? | ||
begin | ||||
Regexp.new(regexp) | ||||
rescue | ||||
errors.add(:regexp, :invalid) | ||||
end | ||||
end | ||||
|
r6393 | |||
|
r12125 | if default_value.present? | ||
validate_field_value(default_value).each do |message| | ||||
errors.add :default_value, message | ||||
end | ||||
|
r8597 | end | ||
|
r330 | end | ||
|
r6393 | |||
|
r12125 | def possible_custom_value_options(custom_value) | ||
format.possible_custom_value_options(custom_value) | ||||
end | ||||
def possible_values_options(object=nil) | ||||
if object.is_a?(Array) | ||||
object.map {|o| format.possible_values_options(self, o)}.reduce(:&) || [] | ||||
|
r5152 | else | ||
|
r12125 | format.possible_values_options(self, object) || [] | ||
|
r5152 | end | ||
end | ||||
|
r6393 | |||
|
r12125 | def possible_values | ||
values = super() | ||||
if values.is_a?(Array) | ||||
values.each do |value| | ||||
value.force_encoding('UTF-8') if value.respond_to?(:force_encoding) | ||||
|
r9346 | end | ||
|
r12125 | values | ||
else | ||||
[] | ||||
|
r5152 | end | ||
end | ||||
|
r6393 | |||
|
r2265 | # Makes possible_values accept a multiline string | ||
def possible_values=(arg) | ||||
if arg.is_a?(Array) | ||||
|
r9346 | super(arg.compact.collect(&:strip).select {|v| !v.blank?}) | ||
|
r2265 | else | ||
self.possible_values = arg.to_s.split(/[\n\r]+/) | ||||
end | ||||
end | ||||
|
r6393 | |||
|
r2998 | def cast_value(value) | ||
|
r12125 | format.cast_value(self, value) | ||
|
r2998 | end | ||
|
r6393 | |||
|
r9974 | def value_from_keyword(keyword, customized) | ||
possible_values_options = possible_values_options(customized) | ||||
if possible_values_options.present? | ||||
keyword = keyword.to_s.downcase | ||||
|
r10763 | if v = possible_values_options.detect {|text, id| text.downcase == keyword} | ||
if v.is_a?(Array) | ||||
v.last | ||||
else | ||||
v | ||||
end | ||||
end | ||||
|
r9974 | else | ||
keyword | ||||
end | ||||
end | ||||
|
r11124 | |||
|
r2255 | # Returns a ORDER BY clause that can used to sort customized | ||
# objects by their value of the custom field. | ||||
|
r9888 | # Returns nil if the custom field can not be used for sorting. | ||
|
r2255 | def order_statement | ||
|
r8601 | return nil if multiple? | ||
|
r12125 | format.order_statement(self) | ||
|
r2255 | end | ||
|
r330 | |||
|
r9888 | # Returns a GROUP BY clause that can used to group by custom value | ||
# Returns nil if the custom field can not be used for grouping. | ||||
|
r11124 | def group_statement | ||
|
r9888 | return nil if multiple? | ||
|
r12125 | format.group_statement(self) | ||
|
r9890 | end | ||
def join_for_order_statement | ||||
|
r12125 | format.join_for_order_statement(self) | ||
|
r9890 | end | ||
|
r12206 | def visibility_by_project_condition(project_key=nil, user=User.current, id_column=nil) | ||
|
r11782 | if visible? || user.admin? | ||
"1=1" | ||||
elsif user.anonymous? | ||||
"1=0" | ||||
else | ||||
project_key ||= "#{self.class.customized_class.table_name}.project_id" | ||||
|
r12206 | id_column ||= id | ||
|
r11958 | "#{project_key} IN (SELECT DISTINCT m.project_id FROM #{Member.table_name} m" + | ||
|
r11782 | " INNER JOIN #{MemberRole.table_name} mr ON mr.member_id = m.id" + | ||
" INNER JOIN #{table_name_prefix}custom_fields_roles#{table_name_suffix} cfr ON cfr.role_id = mr.role_id" + | ||||
|
r12206 | " WHERE m.user_id = #{user.id} AND cfr.custom_field_id = #{id_column})" | ||
|
r11782 | end | ||
end | ||||
def self.visibility_condition | ||||
if user.admin? | ||||
"1=1" | ||||
elsif user.anonymous? | ||||
"#{table_name}.visible" | ||||
else | ||||
|
r11958 | "#{project_key} IN (SELECT DISTINCT m.project_id FROM #{Member.table_name} m" + | ||
|
r11782 | " INNER JOIN #{MemberRole.table_name} mr ON mr.member_id = m.id" + | ||
" INNER JOIN #{table_name_prefix}custom_fields_roles#{table_name_suffix} cfr ON cfr.role_id = mr.role_id" + | ||||
" WHERE m.user_id = #{user.id} AND cfr.custom_field_id = #{id})" | ||||
end | ||||
end | ||||
|
r888 | def <=>(field) | ||
position <=> field.position | ||||
end | ||||
|
r6393 | |||
|
r9890 | # Returns the class that values represent | ||
def value_class | ||||
|
r12125 | format.target_class if format.respond_to?(:target_class) | ||
|
r9890 | end | ||
|
r2255 | def self.customized_class | ||
self.name =~ /^(.+)CustomField$/ | ||||
|
r11935 | $1.constantize rescue nil | ||
|
r2255 | end | ||
|
r6393 | |||
|
r330 | # to move in project_custom_field | ||
def self.for_all | ||||
|
r10690 | where(:is_for_all => true).order('position').all | ||
|
r330 | end | ||
|
r6393 | |||
|
r330 | def type_name | ||
nil | ||||
end | ||||
|
r8597 | |||
|
r8601 | # Returns the error messages for the given value | ||
|
r8597 | # or an empty array if value is a valid value for the custom field | ||
|
r12125 | def validate_custom_value(custom_value) | ||
value = custom_value.value | ||||
|
r8597 | errs = [] | ||
|
r8601 | if value.is_a?(Array) | ||
if !multiple? | ||||
errs << ::I18n.t('activerecord.errors.messages.invalid') | ||||
end | ||||
if is_required? && value.detect(&:present?).nil? | ||||
errs << ::I18n.t('activerecord.errors.messages.blank') | ||||
end | ||||
else | ||||
if is_required? && value.blank? | ||||
errs << ::I18n.t('activerecord.errors.messages.blank') | ||||
end | ||||
|
r12125 | end | ||
|
r12663 | errs += format.validate_custom_value(custom_value) | ||
|
r8597 | errs | ||
end | ||||
|
r12125 | # Returns the error messages for the default custom field value | ||
def validate_field_value(value) | ||||
validate_custom_value(CustomValue.new(:custom_field => self, :value => value)) | ||||
end | ||||
|
r8597 | # Returns true if value is a valid value for the custom field | ||
def valid_field_value?(value) | ||||
validate_field_value(value).empty? | ||||
end | ||||
|
r9980 | def format_in?(*args) | ||
args.include?(field_format) | ||||
end | ||||
|
r8597 | protected | ||
|
r10937 | # Removes multiple values for the custom field after setting the multiple attribute to false | ||
# We kepp the value with the highest id for each customized object | ||||
def handle_multiplicity_change | ||||
if !new_record? && multiple_was && !multiple | ||||
ids = custom_values. | ||||
|
r11124 | where("EXISTS(SELECT 1 FROM #{CustomValue.table_name} cve WHERE cve.custom_field_id = #{CustomValue.table_name}.custom_field_id" + | ||
" AND cve.customized_type = #{CustomValue.table_name}.customized_type AND cve.customized_id = #{CustomValue.table_name}.customized_id" + | ||||
|
r10937 | " AND cve.id > #{CustomValue.table_name}.id)"). | ||
pluck(:id) | ||||
if ids.any? | ||||
custom_values.where(:id => ids).delete_all | ||||
end | ||||
end | ||||
end | ||||
|
r330 | end | ||
|
r12396 | |||
require_dependency 'redmine/field_format' | ||||