WiserTrails

Audit Trails in Harmony

Audit Trails only support Rails 3.x and 4.0 with Active Record.

You can do normal gem installation for wiser_trails:

gem install wiser_trails

or in your Gemfile:

gem 'wiser_trails', '~> 2.1.0'

Then restart your application.

Generate a migration for trails and migrate the database (in your Rails project):

rails g wiser_trails:migration
rake db:migrate

To record the Create, Update, and Delete actions, include WiserTrails::Model and add trail_it to the model you want to keep track of:

class Notes < ActiveRecord::Base
  include WiserTrails::Model
  trail_it
end

If you want to automatically send the owner of the trail, include WiserTrails::StoreController to your application_controller.rb:

class ApplicationController < ActionController::Base
  include WiserTrails::StoreController
end

Then you can specify the owner of the trail:

class Notes < ActiveRecord::Base
  include WiserTrails::Model
  trail_it owner: ->(controller, model) { controller && controller.current_user }
end

Or even the account if you're having a multi-account structure:

class Notes < ActiveRecord::Base
  include WiserTrails::Model
  trail_it
    owner: ->(controller, model) { controller && controller.current_user },
    account: ->(controller, model) { controller && controller.current_account }
end

Wiser Trails will saved ONLY the changed attributes during the update action.

  @note = Note.create(title: "New Note", content: "This is my first note.")
  # @note.old_value = {}
  # @note.new_value = {"title" => "New Note", "content" => "This is my first note."}

Then when you update the record:

  @note.update_attribute(:title, "New Title")
  # @note.old_value = {"title" => "New Note"}
  # @note.new_value = {"title" => "New Note"}

It will not save any unchanged attributes, and you can get the updated fields for displaying.

In some point, you don't want to auto-record the changes in some fields, you can use :skip_fields to do that.

class Notes < ActiveRecord::Base
  include WiserTrails::Model
  trail_it
    owner: ->(controller, model) { controller && controller.current_user },
    account: ->(controller, model) { controller && controller.current_account },
    skip_fields: ["times_viewed","last_updated_by_id"]
end

The updated_at and created_at are skipped by default.

You may want to skip the recording of the changes in some instances, you can do it using the wiser_trails_off and wiser_trails_on methods.

  Note.wiser_trails_off
  @note.update_attribute(:updated_at, Time.now)
  Note.wiser_trails_on

To record custom actions, you can manually trigger the create_activity method on the model record but this will not save the old_value:

@note.create_activity(key: 'note.published', owner: current_user)

Or even the account if you're having a multi-account structure:

@note.create_activity(key: 'note.published', owner: current_user, account: current_account)

To get the trails them you simply query the WiserTrails::Activity model in your controllers:

def index
  @trails = WiserTrails::Activity.order('id DESC')
end

Or with account:

def index
  @trails = WiserTrails::Activity.where(account: current_account)
end

You can get the owner, account, and the trackable objects from the WiserTrails::Activity:

def show
  @trail = WiserTrails::Activity.find(params[:id])
  # @trail.owner => current_user object
  # @trail.account => current_account object
  # @trail.trackable => Note object
end

You can also get the old and new object value by calling old_value or new_value:

def show
  @trail = WiserTrails::Activity.find(params[:id])
  # @trail.old_value => exact Note attributes before the trail was recorded
  # @trail.new_value => exact Note attributes after the trail was recorded
end

• 2.1.0 - Implement :skip_fields
• 2.0.0 - Store old_value and new_value
• 1.1.0 - Initial Release

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Open an issue in https://github.com/kennethjohnbalgos/wiser_trails if you need further support or want to report a bug.

The MIT License (MIT) Copyright (c)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.