Blog do kivanio

As aventuras de um tal kivanio na TI

Rails Summit Latin America

 Acabo de disponibilizar outro plugin, o ActsAsDeleted.

Este plugin serve para que seus registros não sejam apagados do banco.

Mas como assim não apagar?

Certas aplicações necessitam que seus dados não sejam apagados quando um usuário aperta um botão delete, como é o caso no meu projeto atual, onde trabalho com muitos registros financeiros.

Estes dados simplesmente não aparecem mais no sistema, por questões de segurança, de auditoria ou simplesmente porque seu chefe quer assim.

Este plugin disponibiliza métodos para que isso seja possível facilmente, sem a necessidade de ficar criando métodos, inserindo nos models e etc.

Tudo em um só local, cool, DRY ;)

Sim existem 2 outros plugins(só achei  dois),

o acts_as_paranoid 

e o acts_as_soft_deletable

O segundo não me agradou por trabalhar com uma tabela a mais somente para guardar os registros apagados, eu prefiro tê-los na mesma tabela.

O primeiro é muito bom, trabalha com apenas um campo datetime e segue quase a mesma forma que o meu.

Porém tive alguns problemas com validação conforme explico no fim do tutorial, não sei se por que não consegui utilizar direito ou por falha do plugin, entre outras coisas que não me atendiam.

Editado - OBS: cometi um engano, o acts_as_paranoid faz validação sim, usando a mesma opção :scope é possível conseguir a validação

Eu precisava de um campo de flag que não fosse uma data, até para mostrar em possível recuperação de registro na tela do administrador, além de um campo para guardar o usuário que fez a cagada, ops, apagou o registro :D

Enfim nasceu o rebento.

Fonte no github: ActsAsDeleted

Um tutozinho:

REQUER Rails >= 2.1 

 

Instalando o plugin:

script/plugin install git://github.com/kivanio/acts_as_deleted.git

 

Exemplo

=======

 

Em sua migration:

 

class CreateCars < ActiveRecord::Migration

  def self.up

    create_table :cars do |t|

      t.string :name

      # Use "deletestamps" para criar as colunas "deleted" e "deleted_at"

      # Passando o argumento "true", será criada a coluna "deleted_id" para usar com o plugin restful-authentication

      t.deletestamps(true)

      t.timestamps

    end

  end

 

  def self.down

    drop_table :cars

  end

end

 

Em seu model:

class Car < ActiveRecord::Base

  acts_as_deleted

end

 

Depois disso em seu Controller:

class CarController < ApplicationController

  # Use o scope "without_deleted" para procurar por registros que não estão marcados como deletados.

  def index

    @cars = Car.without_deleted.find :all

  end

  # Use o scope "with_deleted" para procurar por registros marcados como deletados.

  def all

    @cars = Car.with_deleted.find :all

  end

 

  #Use apenas find para todos os registros

  def all

    @cars = car.find :all

  end

  # Em sua action destroy use o método "delete" para esconder os registros

  def destroy

   @car = Car.find(params[:id])

    if @car.delete

      flash[:notice] = 'Bye Bye Car.'

    end

    redirect_to(cars_url)

  end

  # Quando você estiver usando o plugin restful-authentication, você pode usa "delete_with_user" para gravar o usuário que apagou o registro.

  def destroy_with_user

     @car = Car.find(params[:id])

      if @car.delete_with_user(current_user.id)

        flash[:notice] = 'Bye Bye Car.'

      end

      redirect_to(cars_url)

    end

end

 

Dicas:

Para usar o validates_uniqueness_of  com este plugin, você deve usar a opção :scope do validates_uniqueness_of.

validates_uniqueness_of :name, :scope => :deleted

Será validado então "name AND deleted" ao invés de apenas "name",

assim você terá ter vários registros apagados com mesmo nome, porém apenas um não apagado com este nome.

 

 

Bem simples!

 

Gostou?

Recomende-me: http://www.workingwithrails.com/recommendation/new/person/5679-kivanio-pereira-barbosa