{"id":25483,"date":"2016-10-20T11:00:18","date_gmt":"2016-10-20T11:00:18","guid":{"rendered":"https:\/\/dev.railscarma.com\/active-admin\/"},"modified":"2024-01-10T13:03:01","modified_gmt":"2024-01-10T13:03:01","slug":"administrateur-actif","status":"publish","type":"post","link":"https:\/\/www.railscarma.com\/fr\/blog\/articles-techniques\/administrateur-actif\/","title":{"rendered":"Administrateur actif"},"content":{"rendered":"
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

La section Admin est un module commun \u00e0 la plupart des applications. Pour les applications Rails, nous avons une gemme appel\u00e9e Active Admin. Cela peut \u00eatre utilis\u00e9 pour cr\u00e9er une application \u00e0 partir de z\u00e9ro vers des interfaces d'administration avec peu d'effort.<\/p>\n

Introduction<\/strong>
\nC'est un cadre o\u00f9 toutes les t\u00e2ches administratives peuvent \u00eatre g\u00e9r\u00e9es. Il cr\u00e9e une belle interface d'administration qui vous donne acc\u00e8s \u00e0 la gestion des donn\u00e9es et peut \u00eatre facilement personnalis\u00e9e.<\/p>\n

Comment installer et configurer ?<\/strong><\/p>\n

Tout d'abord, je vais cr\u00e9er trois modules pour mon application Rails 5.<\/p>\n

Artiste, producteur et cin\u00e9ma<\/p>\n

Relations : artiste.rb has_many :producteur de films.rb has_many :films movie.rb appartient_\u00e0 :artiste appartient_\u00e0 :producteur\n<\/code><\/pre>\n
Ajoutons activeadmin au gemfile et effectuons l'installation du bundle.<\/p>\n
gem 'devise' gem 'activeadmin', github\u00a0: installation du bundle 'activeadmin'<\/code><\/pre>\n
Vous devez ajouter certaines d\u00e9pendances pour Rails 5. Ajoutez la gemme ci-dessous au fichier gem et effectuez \u00e0 nouveau l'installation du bundle.<\/p>\n
gem 'inherited_resources', github\u00a0: 'activeadmin\/inherited_resources'<\/code><\/pre>\n
Ex\u00e9cutez le g\u00e9n\u00e9rateur pour installer l'administrateur actif. Il cr\u00e9e tous les fichiers administratifs dans le r\u00e9pertoire app\/admin. Gemme d'appareil utilis\u00e9e par l'administrateur actif pour l'authentification.<\/p>\n
rails g active_admin: installer<\/code><\/pre>\n
Votre terminal vous invite \u00e0 configurer manuellement certains param\u00e8tres une fois que vous avez ex\u00e9cut\u00e9 la commande ci-dessus.<\/p>\n
Authentification ActiveAdmin<\/strong><\/p>\n
Deux param\u00e8tres sont n\u00e9cessaires pour authentifier et utiliser l'utilisateur actuel dans l'application.<\/p>\n
Pour obliger les m\u00e9thodes du contr\u00f4leur \u00e0 s'authentifier<\/p>\n
config.authentication_method = :authenticate_admin_user!<\/code><\/pre>\n
Pour acc\u00e9der \u00e0 l'utilisateur actuel \u00e0 partir des m\u00e9thodes<\/p>\n
config.current_user_method = :current_admin_user<\/code><\/pre>\n
Les deux param\u00e8tres ci-dessus peuvent \u00eatre r\u00e9gl\u00e9s sur false pour d\u00e9sactiver l'authentification.<\/p>\n
D\u00e9marrez le serveur rails et naviguez jusqu'au fichier http:\/\/localhost:3000\/admin<\/a>. Vous pouvez vous connecter en utilisant les informations d'identification suivantes.<\/p>\n
Nom d'utilisateur\u00a0: admin@example.com Mot de passe\u00a0: mot de passe<\/code><\/pre>\n
\"administrateur-actif\"<\/a><\/p>\n
Le tableau de bord d'administration s'affichera une fois que vous serez connect\u00e9 avec succ\u00e8s. Le menu sup\u00e9rieur affiche la liste des mod\u00e8les enregistr\u00e9s avec l'administrateur actif. Pour l\u2019instant, nous n\u2019avons qu\u2019un seul mod\u00e8le AdminUser. Ici, vous pouvez cr\u00e9er ou modifier des informations d'administration.<\/p>\n
Personnalisation des vues<\/strong>
\nIci, nous devons enregistrer nos mod\u00e8les aupr\u00e8s d'un administrateur actif.<\/p>\n
rails g\u00e9n\u00e8rent active_admin:resource Artiste rails g\u00e9n\u00e8rent active_admin:resource Producteur rails g\u00e9n\u00e8rent active_admin:resource Film<\/code><\/pre>\n
Avant cela, ajoutons quelques donn\u00e9es \u00e0 votre base de donn\u00e9es.<\/p>\n
Seeds.rb a1 = Artist.create !(nom : 'artiste-1') a2 = Artist.create !(nom : 'artiste-2') p1 = Producer.create !(nom : 'producteur-1') p2 = Producer.create\u00a0!(nom : 'producter-2') Movie.create !(nom : 'movie-1', ann\u00e9e_de sortie : 2014, r\u00e9alisateur : 'director-1', description : 'Lorem Ipsum est simplement un texte factice de l'impression et industrie de la composition.', artiste : a1, producteur : p1)\n<\/code><\/pre>\n
Ex\u00e9cutez l'application, vous pouvez voir les donn\u00e9es sur l'interface et vous pouvez modifier et supprimer les donn\u00e9es.<\/p>\n
Personnalisation<\/strong><\/p>\n
Par d\u00e9faut, la ressource sera affich\u00e9e dans la navigation globale. Il peut \u00eatre d\u00e9sactiv\u00e9 s'il n'est pas requis dans le menu.<\/p>\n
ActiveAdmin.register Film faire le menu fausse fin<\/code><\/pre>\n
Renommez l'\u00e9tiquette du menu avec l'\u00e9tiquette requise.<\/p>\n
ActiveAdmin.register \u00c9tiquette du menu Film\u00a0: fin de la \u00ab\u00a0Liste des films\u00a0\u00bb<\/code><\/pre>\n
La priorit\u00e9 du menu peut \u00eatre d\u00e9finie par<\/p>\n
ActiveAdmin.register Priorit\u00e9 du menu de r\u00e9alisation du film\u00a0:\u00a04 fin<\/code><\/pre>\n
Par d\u00e9faut toutes les colonnes utilis\u00e9es pour afficher. Vous pouvez r\u00e9pertorier les colonnes requises dans la m\u00e9thode d'index utilis\u00e9e pour l'affichage. Ici, j'ai supprim\u00e9 les colonnes d'horodatage du fichier admin\/movie.rb<\/p>\n
index colonne do\u00a0: colonne nom\u00a0: colonne de description\u00a0: colonne ann\u00e9e_sortie\u00a0: colonne directeur\u00a0: colonne producteur\u00a0: fin des actions de l'artiste<\/code><\/pre>\n
Vous pouvez personnaliser le nom de la colonne en sp\u00e9cifiant le nom de la colonne avant le champ dans la m\u00e9thode d'index.<\/p>\n
colonne 'Pr\u00e9nom', :name<\/code><\/pre>\n
Sur le c\u00f4t\u00e9 droit de la page, nous pouvons trouver la section des filtres. Par d\u00e9faut, l'administrateur actif d\u00e9tecte les relations d'appartenance_\u00e0. Nous pouvons personnaliser la section de filtre. <\/p>\n
filtre :producteur, :as => :check_boxes<\/code><\/pre>\n
filtre :artiste, :as => :check_boxes<\/code><\/pre>\n

\nPersonnalisation CSV <\/strong><\/p>\n
Par d\u00e9faut, l'administrateur actif t\u00e9l\u00e9chargera toutes les colonnes affich\u00e9es au format CSV. Ici, nous pouvons personnaliser les colonnes requises avec les param\u00e8tres CSV.<\/p>\n
ActiveAdmin.register Film faire csv force_quotes : true, col_sep : ';', column_names : false faire colonne :name column(:artist) { |movie| film.artiste } colonne (:producteur) { |film| film.producteur } fin fin<\/code><\/pre>\n
M\u00eame globalement, nous pouvons configurer les param\u00e8tres du CSV<\/strong><\/p>\n
# config\/initialiseurs\/active_admin.rb<\/code><\/pre>\n
# D\u00e9finir le s\u00e9parateur du g\u00e9n\u00e9rateur CSV<\/p>\n
config.csv_options = { col_sep\u00a0: ';' }<\/code><\/pre>\n
# Forcer l'utilisation des guillemets<\/p>\n
config.csv_options = { force_quotes\u00a0: vrai }<\/code><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Abonnez-vous pour les derni\u00e8res mises \u00e0 jour<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\t\t\t\t\t