rake db:migrate --trace VERSION=<SSAAMMJJHHMMSS>

rake db:rollback STEP=<nb de migrations en arrière>

rake db:migrate:redo STEP=<3>

rake db:migrate:{up, down} VERSION=<timestamp>

2.4.3.1) Manipulation des tables :

2.4.3.2) Manipulation des colonnes :

2.4.3.3) Indexes :

2.4.3.4) Migrations et associations :

2.4.3.5) Exécution de code SQL :

execute <<-SQL
ALTER TABLE products
ADD CONSTRAINT fk_products_categories
FOREIGN KEY (category_id)
REFERENCES categories(id)
SQL

execute "ALTER TABLE products DROP FOREIGN KEY fk_products_categories"

2.4.3.6) Interruption des migrations irréversibles :

raise ActiveRecord::IrreversibleMigration, "<message_explicatif>"

2.4.3.7) Rafraîchissement du cache de description tables :

<Classe_modele>.reset_column_information

• Tous les fichiers de migration créés par :

script/generate model <NomModel>

Ont un nom de la forme :

SSAAMMJJHHMMSS_create_nom_model.rb



• Lors de la génération automatique avec :

script/generate migration

Si le nom de la migration est de la forme :

"AddXXXToYYY"

ou

"RemoveXXXFromYYY"

et est suivi d'une liste de noms de colonnes avec leur type,
alors le fichier de migration généré contiendra les instructions add_column ou remove_column appropriés.
Le nom de la table (YYY) doit être au pluriel.

Exemples :


script/generate migration AddDetailsToProducts part_number:string price:decimal
script/generate migration AddPositionToDiapositives position:integer

• suppress_messages
Supprime toutes les sorties générées par ses blocs up et down.


• say(<message>, <indentation>)
Affiche en sortie le 1er paramètre, le second paramètre contrôle si il sera indenté ou pas.


• say_with_time
Affiche en sortie le 1er paramètre avec l'information du temps que cela a pris pour exécuter son bloc.
Si le bloc retourne un entier, cette méthode suppose que c'est le nombre de ligne traitées.

• Référence :
C.f.:

http://ar.rubyonrails.org/classes/Fixtures.html



• Localisation :
Les fichiers de garniture se trouvent dans :

test/fixtures

ATTENTION : ils ne sont pas forcément utilisés que pour les tests!


• Chargement d'un fichier de garnitures :

# 1) Charge une garniture depuis un fichier Ruby :
require 'active_record/fixtures'
Fixtures.create_fixtures("#{Rails.root}/test/fixtures", "operating_systems")
Fixtures.create_fixtures("#{Rails.root}/test/fixtures", "users")


# 2) Charge un fichier de garnitures dans une migration avec up and down :

#db/migrate/<fichier_de_migration>.rb
require 'active_record/fixtures'

class LoadCustomerData
	def self.up
		down
		directory = File.join(File.dirname(__FILE__), "data")
		Fixtures.create_fixtures(directory, "customers")
	end

	def self.down
		Customer.delete_all
	end
end

2.5.1.1) Utilisation de fichiers au format C.S.V. :

gem install fastercsv
#ou
rake gem:install fastercsv

#config/environment.rb :
config.gem 'fastercsv'

#dans le fichier de migration du projet :
FasterCSV.foreach("#{RAILS_ROOT}/fichier.csv") do |ligne|
	titre = ligne[0]
	next if titre == "Title"
end

db/seeds.rb

rake db:seed

#db/migrate/<fichier_de_migration>.rb

# Chargement du fichier de seed depuis une migration
Rake::Task["db:seed"].invoke

# db/seeds.rb

# 1) Charge un fichier texte depuis le fichier de Seed
require 'open-uri'
require 'active_record/fixtures'

Country.delete_all
open("http://openconcept.ca/sites/openconcept.ca/files/country_code_drupal_0.txt")
do |countries|
	countries.read.each_line do |country|
		code, name = country.chomp.split("|")
		Country.create!(:name => name, :code => code)
	end
end

# 2) génère automatiquement un grand nombre d'enregistrement
Debut=11
Fin=2000

puts "création de #{Fin - Debut + 1} photos, à partir de #{Debut}"

(Debut..Fin).each { |i|
	 if Photo.find_by_nom("photo_bis_#{i}").nil?
		puts "création de photo_bis_#{i}"
		Photo.create( :nom => "photo_bis_#{i}", :commentaire => "commentaire photo bis #{i}" )
	 else
		puts "photo_bis_#{i} existe déjà"
	 end
}

# lib/tasks/dump_load.rake
namespace :db do
  namespace :seed do
    require 'db/seed_tables'

    desc "décharge les tables contenant les données initiales dans db/<RAILS_ENV>_seed.sql. La variable SEED_TABLES doit-être définie dans db/seed_tables.rb!!!"
    task :dump => :environment do
      config = ActiveRecord::Base.configurations[RAILS_ENV]
      dump_cmd = "mysqldump --user=#{config['username']} --password=#{config['password']} #{config['database']} #{SEED_TABLES.join(" ")} > db/#{RAILS_ENV}_seed.sql"
      system(dump_cmd)
    end

    desc "charge les données initiales depuis db/<RAILS_ENV>_seed.sql dans la base courante"
    task :load => :environment do
      config = ActiveRecord::Base.configurations['test']
      system("mysql --user=#{config['username']} --password=#{config['password']} #{config['database']} < db/#{RAILS_ENV}_seed.sql")
    end
  end
end

# lib/tasks/fixtures.rake
namespace :db do
  namespace :fixtures do

    desc 'Personnalized : Create YAML test fixtures from data in an existing database. 
    Defaults to development database.  Set RAILS_ENV to override.'
    task :dump => :environment do
      puts "cette tâche apparaîtra dans (rake --tasks) du projet"

      sql  = "SELECT * FROM %s"
      skip_tables = ["schema_migrations"]
      ActiveRecord::Base.establish_connection(:development)
      (ActiveRecord::Base.connection.tables - skip_tables).each do |table_name|
        i = "000"
        j = 0

        File.open("#{RAILS_ROOT}/test/fixtures/#{table_name}.yml", 'w') do |file|
          data = ActiveRecord::Base.connection.select_all(sql % table_name)

          file.write data.inject({}) { |hash, record|
          	j += 1
            hash["#{table_name.singularize}_#{i.succ!}"] = record
            hash
          }.to_yaml

          puts "#{table_name} : [#{j}]"
        end
      end
    end
  end
end

RAILS_ENV=development rake db:fixtures:dump
RAILS_ENV=production rake db:fixtures:load

<controlleur>/new

<controlleur>/<id>

 <controlleur>/<id>/edit


<input type="hidden" name="_method" value="put" />

<a href="<controller>/<id>" onclick="if (confirm('Es-tu sûr(e)?')) { var f = document.createElement('form'); f.style.display = 'none'; this.parentNode.appendChild(f); f.method = 'POST'; f.action = this.href;var m = document.createElement('input'); m.setAttribute('type', 'hidden'); m.setAttribute('name', '_method'); m.setAttribute('value', 'delete'); f.appendChild(m);var s = document.createElement('input'); s.setAttribute('type', 'hidden'); s.setAttribute('name', 'authenticity_token'); s.setAttribute('value', 'arpS61rIZTta3ZSiNmmeO1G0NUb30szy0+7Qx9OQIHw='); f.appendChild(s);f.submit(); };return false;">Supprimer</a>

<a href="<controller>/<id>" data-confirm="Are you sure?" data-method="delete" rel="nofollow">Supprimer</a>


<input type="hidden" name="_method" value="delete" />

<classe_modele>.find_by_<nom_attribut>("<valeur_attribut>")

<classe_modele>.all

<sequence_de_modeles>.order(:<tri_selon_cet_attribut_>)

# nom_long est une méthode dynamique (à créer) du modèle (pas un attribut de la B.D.D.)
# notez le ! à la fin du sort, qui implique que la séquence elle-même est modifiée :
@all_categories.sort! { |a,b| a.nom_long <=> b.nom_long }

Reservation.find_all_by_date(Date.today, :include => [:evenement, :sessions])

Reservation.find_all_by_date(Date.today, :include => [{:evenement => :organisateur}, :sessions ])

@utilisateurs = Utilisateur.find(
	:all,
	:include => {
		:communautes => { :localisation => {} } ,
		:conditions => ["localisations.ville = ?", ville]
	}
)

• Validations
• Callbacks
• Attributs supplémentaires

has_many :<table_etrangere>, :through => :<table_intermediaire>

#models/employee.rb
class Employee < ActiveRecord::Base
	has_many :subordinates, :class_name => 'Employee', :foreign_key => 'manager_id'
	belongs_to :manager, :class_name => 'Employee'
end

#controllers/employee_controller.rb
@employee.subordinates
@employee.manager

belongs_to :follower, :class_name => "Membre", :foreign_key => "membres_follower"