2016-10-19 03:11:36 +00:00
|
|
|
# Copyright (C) 2012-2016 Zammad Foundation, http://zammad-foundation.org/
|
2013-06-12 15:59:58 +00:00
|
|
|
|
2013-01-01 20:29:26 +00:00
|
|
|
class History < ApplicationModel
|
2014-10-17 12:15:54 +00:00
|
|
|
load 'history/assets.rb'
|
2013-08-19 06:29:49 +00:00
|
|
|
include History::Assets
|
|
|
|
|
2012-04-10 14:06:46 +00:00
|
|
|
self.table_name = 'histories'
|
2015-04-27 13:42:53 +00:00
|
|
|
belongs_to :history_type, class_name: 'History::Type'
|
|
|
|
belongs_to :history_object, class_name: 'History::Object'
|
|
|
|
belongs_to :history_attribute, class_name: 'History::Attribute'
|
2013-06-12 15:59:58 +00:00
|
|
|
# before_validation :check_type, :check_object
|
|
|
|
# attr_writer :history_type, :history_object
|
2012-04-10 14:06:46 +00:00
|
|
|
|
2015-05-08 13:47:27 +00:00
|
|
|
# rubocop:disable Style/ClassVars
|
2012-11-07 23:47:05 +00:00
|
|
|
@@cache_type = {}
|
|
|
|
@@cache_object = {}
|
|
|
|
@@cache_attribute = {}
|
2015-05-08 13:47:27 +00:00
|
|
|
# rubocop:enable Style/ClassVars
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-14 08:05:42 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
add a new history entry for an object
|
|
|
|
|
|
|
|
History.add(
|
2016-01-26 14:25:32 +00:00
|
|
|
history_type: 'updated',
|
|
|
|
history_object: 'Ticket',
|
|
|
|
history_attribute: 'state',
|
|
|
|
o_id: ticket.id,
|
|
|
|
id_to: 3,
|
|
|
|
id_from: 2,
|
|
|
|
value_from: 'open',
|
|
|
|
value_to: 'pending reminder',
|
|
|
|
created_by_id: 1,
|
|
|
|
created_at: '2013-06-04 10:00:00',
|
|
|
|
updated_at: '2013-06-04 10:00:00'
|
2013-06-14 08:05:42 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
=end
|
|
|
|
|
|
|
|
def self.add(data)
|
2012-07-10 08:09:58 +00:00
|
|
|
|
2013-09-29 16:40:42 +00:00
|
|
|
# return if we run import mode
|
2014-11-24 23:31:16 +00:00
|
|
|
return if Setting.get('import_mode') && !data[:id]
|
2013-09-29 16:40:42 +00:00
|
|
|
|
2012-07-10 08:09:58 +00:00
|
|
|
# lookups
|
2012-11-07 23:47:05 +00:00
|
|
|
if data[:history_type]
|
2016-01-26 14:25:32 +00:00
|
|
|
history_type = type_lookup(data[:history_type])
|
2012-07-10 08:09:58 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
if data[:history_object]
|
2016-01-26 14:25:32 +00:00
|
|
|
history_object = object_lookup(data[:history_object])
|
2012-07-10 08:09:58 +00:00
|
|
|
end
|
|
|
|
related_history_object_id = nil
|
|
|
|
if data[:related_history_object]
|
2016-01-26 14:25:32 +00:00
|
|
|
related_history_object = object_lookup(data[:related_history_object])
|
2012-07-10 08:09:58 +00:00
|
|
|
related_history_object_id = related_history_object.id
|
|
|
|
end
|
|
|
|
history_attribute_id = nil
|
|
|
|
if data[:history_attribute]
|
2016-01-26 14:25:32 +00:00
|
|
|
history_attribute = attribute_lookup(data[:history_attribute])
|
2012-07-10 08:09:58 +00:00
|
|
|
history_attribute_id = history_attribute.id
|
|
|
|
end
|
|
|
|
|
|
|
|
# create history
|
2012-12-24 13:55:43 +00:00
|
|
|
record = {
|
2015-04-27 13:42:53 +00:00
|
|
|
id: data[:id],
|
|
|
|
o_id: data[:o_id],
|
|
|
|
history_type_id: history_type.id,
|
|
|
|
history_object_id: history_object.id,
|
|
|
|
history_attribute_id: history_attribute_id,
|
|
|
|
related_history_object_id: related_history_object_id,
|
|
|
|
related_o_id: data[:related_o_id],
|
|
|
|
value_from: data[:value_from],
|
|
|
|
value_to: data[:value_to],
|
|
|
|
id_from: data[:id_from],
|
|
|
|
id_to: data[:id_to],
|
|
|
|
created_at: data[:created_at],
|
|
|
|
created_by_id: data[:created_by_id]
|
2012-12-24 13:55:43 +00:00
|
|
|
}
|
|
|
|
history_record = nil
|
|
|
|
if data[:id]
|
2016-01-26 14:25:32 +00:00
|
|
|
history_record = History.find_by(id: data[:id])
|
2012-12-24 13:55:43 +00:00
|
|
|
end
|
|
|
|
if history_record
|
|
|
|
history_record.update_attributes(record)
|
|
|
|
else
|
|
|
|
record_new = History.create(record)
|
2013-05-27 07:25:34 +00:00
|
|
|
if record[:id]
|
|
|
|
record_new.id = record[:id]
|
|
|
|
end
|
2012-12-24 13:55:43 +00:00
|
|
|
record_new.save
|
|
|
|
end
|
2012-07-10 08:09:58 +00:00
|
|
|
end
|
|
|
|
|
2013-06-14 08:05:42 +00:00
|
|
|
=begin
|
|
|
|
|
|
|
|
remove whole history entries of an object
|
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
History.remove('Ticket', 123)
|
2013-06-14 08:05:42 +00:00
|
|
|
|
|
|
|
=end
|
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.remove(requested_object, requested_object_id)
|
|
|
|
history_object = History::Object.find_by(name: requested_object)
|
2013-09-28 00:07:11 +00:00
|
|
|
return if !history_object
|
2013-06-04 12:52:56 +00:00
|
|
|
History.where(
|
2015-04-27 13:42:53 +00:00
|
|
|
history_object_id: history_object.id,
|
|
|
|
o_id: requested_object_id,
|
2013-06-04 12:52:56 +00:00
|
|
|
).destroy_all
|
2012-07-10 08:09:58 +00:00
|
|
|
end
|
|
|
|
|
2013-06-14 08:05:42 +00:00
|
|
|
=begin
|
|
|
|
|
2013-09-28 00:07:11 +00:00
|
|
|
return all history entries of an object
|
2013-06-14 08:05:42 +00:00
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
history_list = History.list('Ticket', 123)
|
2013-06-14 08:05:42 +00:00
|
|
|
|
2013-10-22 06:43:49 +00:00
|
|
|
returns
|
|
|
|
|
|
|
|
history_list = [
|
|
|
|
{ ... },
|
|
|
|
{ ... },
|
|
|
|
{ ... },
|
|
|
|
{ ... },
|
|
|
|
]
|
|
|
|
|
|
|
|
return all history entries of an object and it's related history objects
|
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
history_list = History.list('Ticket', 123, true)
|
2013-10-22 06:43:49 +00:00
|
|
|
|
|
|
|
returns
|
|
|
|
|
|
|
|
history_list = [
|
|
|
|
{ ... },
|
|
|
|
{ ... },
|
|
|
|
{ ... },
|
|
|
|
{ ... },
|
|
|
|
]
|
|
|
|
|
|
|
|
return all history entries of an object and it's assets
|
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
history = History.list('Ticket', 123, nil, true)
|
2013-10-22 06:43:49 +00:00
|
|
|
|
|
|
|
returns
|
|
|
|
|
|
|
|
history = {
|
2016-01-26 14:25:32 +00:00
|
|
|
list: list,
|
|
|
|
assets: assets,
|
2013-10-22 06:43:49 +00:00
|
|
|
}
|
|
|
|
|
2013-06-14 08:05:42 +00:00
|
|
|
=end
|
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.list(requested_object, requested_object_id, related_history_object = nil, assets = nil)
|
2012-07-10 08:09:58 +00:00
|
|
|
if !related_history_object
|
2016-01-26 14:25:32 +00:00
|
|
|
history_object = object_lookup(requested_object)
|
|
|
|
history = History.where(history_object_id: history_object.id)
|
|
|
|
.where(o_id: requested_object_id)
|
2016-01-15 17:22:57 +00:00
|
|
|
.order('created_at ASC, id ASC')
|
2012-07-10 08:09:58 +00:00
|
|
|
else
|
2016-01-26 14:25:32 +00:00
|
|
|
history_object_requested = object_lookup(requested_object)
|
|
|
|
history_object_related = object_lookup(related_history_object)
|
2012-07-10 08:09:58 +00:00
|
|
|
history = History.where(
|
2013-09-30 00:03:37 +00:00
|
|
|
'((history_object_id = ? AND o_id = ?) OR (history_object_id = ? AND related_o_id = ? ))',
|
2013-06-12 15:59:58 +00:00
|
|
|
history_object_requested.id,
|
|
|
|
requested_object_id,
|
|
|
|
history_object_related.id,
|
|
|
|
requested_object_id,
|
2015-04-30 17:51:31 +00:00
|
|
|
)
|
2016-01-15 17:22:57 +00:00
|
|
|
.order('created_at ASC, id ASC')
|
2012-07-10 08:09:58 +00:00
|
|
|
end
|
2013-10-22 06:43:49 +00:00
|
|
|
asset_list = {}
|
2013-09-29 16:40:42 +00:00
|
|
|
list = []
|
|
|
|
history.each do |item|
|
2013-10-22 06:43:49 +00:00
|
|
|
|
|
|
|
if assets
|
2016-01-26 14:25:32 +00:00
|
|
|
asset_list = item.assets(asset_list)
|
2013-10-22 06:43:49 +00:00
|
|
|
end
|
|
|
|
|
2013-09-29 16:40:42 +00:00
|
|
|
data = item.attributes
|
2016-01-26 14:25:32 +00:00
|
|
|
data['object'] = object_lookup_id(data['history_object_id']).name
|
|
|
|
data['type'] = type_lookup_id(data['history_type_id']).name
|
2013-09-29 16:40:42 +00:00
|
|
|
data.delete('history_object_id')
|
|
|
|
data.delete('history_type_id')
|
|
|
|
|
|
|
|
if data['history_attribute_id']
|
2016-01-26 14:25:32 +00:00
|
|
|
data['attribute'] = attribute_lookup_id(data['history_attribute_id']).name
|
2013-09-29 16:40:42 +00:00
|
|
|
end
|
|
|
|
data.delete('history_attribute_id')
|
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
data.delete('updated_at')
|
2015-05-07 10:11:45 +00:00
|
|
|
if data['id_to'].nil? && data['id_from'].nil?
|
2016-01-26 14:25:32 +00:00
|
|
|
data.delete('id_to')
|
|
|
|
data.delete('id_from')
|
2013-09-29 16:40:42 +00:00
|
|
|
end
|
2015-05-07 10:11:45 +00:00
|
|
|
if data['value_to'].nil? && data['value_from'].nil?
|
2016-01-26 14:25:32 +00:00
|
|
|
data.delete('value_to')
|
|
|
|
data.delete('value_from')
|
2013-09-29 16:40:42 +00:00
|
|
|
end
|
2015-04-30 17:47:49 +00:00
|
|
|
if !data['related_history_object_id'].nil?
|
2016-01-26 14:25:32 +00:00
|
|
|
data['related_object'] = object_lookup_id(data['related_history_object_id']).name
|
2013-09-29 16:40:42 +00:00
|
|
|
end
|
2016-01-26 14:25:32 +00:00
|
|
|
data.delete('related_history_object_id')
|
2013-09-29 16:40:42 +00:00
|
|
|
|
2015-05-07 10:11:45 +00:00
|
|
|
if data['related_o_id'].nil?
|
2016-01-26 14:25:32 +00:00
|
|
|
data.delete('related_o_id')
|
2013-09-29 16:40:42 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-09-29 16:40:42 +00:00
|
|
|
list.push data
|
|
|
|
end
|
2013-10-22 06:43:49 +00:00
|
|
|
if assets
|
|
|
|
return {
|
2015-04-27 13:42:53 +00:00
|
|
|
list: list,
|
|
|
|
assets: asset_list,
|
2013-10-22 06:43:49 +00:00
|
|
|
}
|
|
|
|
end
|
2013-09-29 16:40:42 +00:00
|
|
|
list
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.type_lookup_id(id)
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# use cache
|
|
|
|
return @@cache_type[ id ] if @@cache_type[ id ]
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# lookup
|
2016-01-26 14:25:32 +00:00
|
|
|
history_type = History::Type.lookup(id: id)
|
2013-06-12 15:59:58 +00:00
|
|
|
@@cache_type[ id ] = history_type
|
2015-04-30 17:20:27 +00:00
|
|
|
history_type
|
2013-06-12 15:59:58 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.type_lookup(name)
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# use cache
|
|
|
|
return @@cache_type[ name ] if @@cache_type[ name ]
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# lookup
|
2016-01-26 14:25:32 +00:00
|
|
|
history_type = History::Type.lookup(name: name)
|
2013-06-12 15:59:58 +00:00
|
|
|
if history_type
|
2012-11-07 23:47:05 +00:00
|
|
|
@@cache_type[ name ] = history_type
|
|
|
|
return history_type
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# create
|
|
|
|
history_type = History::Type.create(
|
2015-04-27 13:42:53 +00:00
|
|
|
name: name
|
2013-06-12 15:59:58 +00:00
|
|
|
)
|
|
|
|
@@cache_type[ name ] = history_type
|
2015-04-30 17:20:27 +00:00
|
|
|
history_type
|
2013-06-12 15:59:58 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.object_lookup_id(id)
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# use cache
|
|
|
|
return @@cache_object[ id ] if @@cache_object[ id ]
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# lookup
|
2016-01-26 14:25:32 +00:00
|
|
|
history_object = History::Object.lookup(id: id)
|
2013-06-12 15:59:58 +00:00
|
|
|
@@cache_object[ id ] = history_object
|
2015-04-30 17:20:27 +00:00
|
|
|
history_object
|
2013-06-12 15:59:58 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.object_lookup(name)
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# use cache
|
|
|
|
return @@cache_object[ name ] if @@cache_object[ name ]
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# lookup
|
2016-01-26 14:25:32 +00:00
|
|
|
history_object = History::Object.lookup(name: name)
|
2013-06-12 15:59:58 +00:00
|
|
|
if history_object
|
2012-11-07 23:47:05 +00:00
|
|
|
@@cache_object[ name ] = history_object
|
|
|
|
return history_object
|
|
|
|
end
|
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# create
|
|
|
|
history_object = History::Object.create(
|
2015-04-27 13:42:53 +00:00
|
|
|
name: name
|
2013-06-12 15:59:58 +00:00
|
|
|
)
|
|
|
|
@@cache_object[ name ] = history_object
|
2015-04-30 17:20:27 +00:00
|
|
|
history_object
|
2013-06-12 15:59:58 +00:00
|
|
|
end
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.attribute_lookup_id(id)
|
2013-09-29 16:40:42 +00:00
|
|
|
|
|
|
|
# use cache
|
|
|
|
return @@cache_attribute[ id ] if @@cache_attribute[ id ]
|
|
|
|
|
|
|
|
# lookup
|
2016-01-26 14:25:32 +00:00
|
|
|
history_attribute = History::Attribute.lookup(id: id)
|
2013-09-29 16:40:42 +00:00
|
|
|
@@cache_attribute[ id ] = history_attribute
|
2015-04-30 17:20:27 +00:00
|
|
|
history_attribute
|
2013-09-29 16:40:42 +00:00
|
|
|
end
|
|
|
|
|
2016-01-26 14:25:32 +00:00
|
|
|
def self.attribute_lookup(name)
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# use cache
|
|
|
|
return @@cache_attribute[ name ] if @@cache_attribute[ name ]
|
2012-11-07 23:47:05 +00:00
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# lookup
|
2016-01-26 14:25:32 +00:00
|
|
|
history_attribute = History::Attribute.lookup(name: name)
|
2013-06-12 15:59:58 +00:00
|
|
|
if history_attribute
|
2012-11-07 23:47:05 +00:00
|
|
|
@@cache_attribute[ name ] = history_attribute
|
|
|
|
return history_attribute
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
2013-06-12 15:59:58 +00:00
|
|
|
# create
|
|
|
|
history_attribute = History::Attribute.create(
|
2015-04-27 13:42:53 +00:00
|
|
|
name: name
|
2013-06-12 15:59:58 +00:00
|
|
|
)
|
|
|
|
@@cache_attribute[ name ] = history_attribute
|
2015-04-30 17:20:27 +00:00
|
|
|
history_attribute
|
2013-06-12 15:59:58 +00:00
|
|
|
end
|
|
|
|
|
2013-01-01 20:29:26 +00:00
|
|
|
class Object < ApplicationModel
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
2013-01-01 20:29:26 +00:00
|
|
|
class Type < ApplicationModel
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
2013-01-01 20:29:26 +00:00
|
|
|
class Attribute < ApplicationModel
|
2012-04-10 14:06:46 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
end
|