![\"/fr/2.2/_images/admin-actions.png\"](\"/fr/2.2/_images/admin-actions.png\")
\n\nÉcriture d’actionsLien vers cette rubrique#
\nLa meilleure façon d’expliquer les actions est de montrer un exemple. Allons-y !
\nUn cas d’utilisation courant pour les actions d’administration est la mise à jour en vrac d’un modèle. Imaginez une application simple de nouvelles avec un modèle Article:
from django.db import models\n\nSTATUS_CHOICES = [\n ('d', 'Draft'),\n ('p', 'Published'),\n ('w', 'Withdrawn'),\n]\n\nclass Article(models.Model):\n title = models.CharField(max_length=100)\n body = models.TextField()\n status = models.CharField(max_length=1, choices=STATUS_CHOICES)\n\n def __str__(self):\n return self.title\nUne tâche courante que nous pourrions réaliser avec un tel modèle est de mettre à jour l’état d’un article de « brouillon » à « publié ». Nous pourrions facilement le faire dans l’administration un article à la fois, mais si nous voulions publier en vrac une série d’articles, ce serait fastidieux. Écrivons donc une action qui nous permet de modifier l’état d’un article à « publié ».
\nÉcriture des fonctions d’actionLien vers cette rubrique#
\nTout d’abord, nous devons écrire une fonction qui est appelée quand l’action est déclenchée depuis l’administration. Les fonctions d’action sont de simples fonctions ordinaires qui acceptent trois paramètres :
\n- \n
La classe
ModelAdminconcernée \nUn objet
HttpRequestreprésentant la requête actuelle \nUn jeu de requête
QuerySetcontenant l’ensemble des objets sélectionnés par l’utilisateur. \n
Notre fonction de publication d’articles n’aura pas besoin de la classe ModelAdmin ni de l’objet requête, mais nous allons utiliser le jeu de requête :
def make_published(modeladmin, request, queryset):\n queryset.update(status='p')\nC’est en fait tout ce qu’il y a besoin d’écrire pour une action ! Toutefois, nous allons effectuer une étape supplémentaire facultative mais utile et donner un « joli » titre à l’action dans l’interface d’administration. Par défaut, cette action apparaît dans la liste d’actions comme « Make published » – le nom de la fonction avec les soulignements remplacés par des espaces. C’est bien, mais nous pouvons fournir un nom meilleur et plus convivial en donnant à la fonction make_published un attribut short_description:
def make_published(modeladmin, request, queryset):\n queryset.update(status='p')\nmake_published.short_description = "Mark selected stories as published"\nAjout d’actions à la classe ModelAdminLien vers cette rubrique#
\nEnsuite, il faudra informer la ModelAdmin de l’action. Cela fonctionne comme n’importe quelle autre option de configuration. Ainsi, le fichier admin.py complet avec l’action et son inscription ressemblerait à :
from django.contrib import admin\nfrom myapp.models import Article\n\ndef make_published(modeladmin, request, queryset):\n queryset.update(status='p')\nmake_published.short_description = "Mark selected stories as published"\n\nclass ArticleAdmin(admin.ModelAdmin):\n list_display = ['title', 'status']\n ordering = ['title']\n actions = [make_published]\n\nadmin.site.register(Article, ArticleAdmin)\nAvec ce code, la liste d’objets à modifier dans l’interface d’administration ressemble à ceci :
\n![\"/fr/2.2/_images/adding-actions-to-the-modeladmin.png\"](\"/fr/2.2/_images/adding-actions-to-the-modeladmin.png\")
\nC’est vraiment tout ce qu’il y a à faire ! Si vous brûlez d’écrire vos propres actions, vous en savez maintenant assez pour débuter. Le reste de ce document ne couvre que des techniques plus avancées.
\nGestion des erreurs dans les actionsLien vers cette rubrique#
\nS’il y a des conditions d’erreur prévisibles qui peuvent survenir lors de l’exécution de votre action, vous devriez faire amende honorable en informant l’utilisateur du problème. Cela signifie gérer les exceptions et utiliser django.contrib.admin.ModelAdmin.message_user() pour afficher une description conviviale du problème dans la réponse.
![\"/fr/2.2/_images/actions-as-modeladmin-methods.png\"](\"/fr/2.2/_images/actions-as-modeladmin-methods.png\")
\n