![\"/sv/6.1/_images/admin-actions.png\"](\"/sv/6.1/_images/admin-actions.png\")
\n\nSkriva åtgärderLink to this heading#
\nDet enklaste sättet att förklara åtgärder är genom exempel, så låt oss dyka ner i det.
\nEtt vanligt användningsfall för adminåtgärder är massuppdatering av en modell. Föreställ dig en nyhetsapplikation med en Artikel-modell:
from django.db import models\n\nSTATUS_CHOICES = {\n "d": "Draft",\n "p": "Published",\n "w": "Withdrawn",\n}\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\nEn vanlig uppgift som vi kan utföra med en sådan här modell är att uppdatera en artikels status från ”utkast” till ”publicerad”. Vi kan enkelt göra detta i administratören för en artikel i taget, men om vi vill masspublicera en grupp artiklar skulle det vara tråkigt. Så låt oss skriva en åtgärd som låter oss ändra en artikels status till ”publicerad”
\nSkriva handlingsfunktionerLink to this heading#
\nFörst måste vi skriva en funktion som anropas när åtgärden utlöses från administratören. Åtgärdsfunktioner är vanliga funktioner som tar tre argument:
\n- \n
Den aktuella
ModelAdmin\nEn
HttpRequestsom representerar den aktuella begäran, \nEn
QuerySetsom innehåller den uppsättning objekt som användaren har valt. \n
Vår funktion publish-these-articles kommer inte att behöva ModelAdmin eller request-objektet, men vi kommer att använda queryset:
def make_published(modeladmin, request, queryset):\n queryset.update(status="p")\nDet är faktiskt allt som krävs för att skriva en åtgärd! Vi ska dock ta ytterligare ett valfritt men användbart steg och ge åtgärden en ”fin” titel i admin. Som standard visas den här åtgärden i åtgärdslistan som ”Gör publicerad” - funktionsnamnet, med understreck ersatta av mellanslag. Det är bra, men vi kan ge ett bättre, mer människovänligt namn genom att använda action()-dekoratorn på make_published-funktionen:
from django.contrib import admin\n\n...\n\n\n@admin.action(description="Mark selected stories as published")\ndef make_published(modeladmin, request, queryset):\n queryset.update(status="p")\nLägga till åtgärder till ModelAdminLink to this heading#
\nDärefter måste vi informera vår ModelAdmin om åtgärden. Detta fungerar precis som alla andra konfigurationsalternativ. Så, den kompletta admin.py med åtgärden och dess registrering skulle se ut så här:
from django.contrib import admin\nfrom myapp.models import Article\n\n\n@admin.action(description="Mark selected stories as published")\ndef make_published(modeladmin, request, queryset):\n queryset.update(status="p")\n\n\nclass ArticleAdmin(admin.ModelAdmin):\n list_display = ["title", "status"]\n ordering = ["title"]\n actions = [make_published]\n\n\nadmin.site.register(Article, ArticleAdmin)\nDen koden kommer att ge oss en ändringslista för administratörer som ser ut ungefär så här:
\n![\"/sv/6.1/_images/adding-actions-to-the-modeladmin.png\"](\"/sv/6.1/_images/adding-actions-to-the-modeladmin.png\")
\nDet är verkligen allt som behövs! Om du är sugen på att skriva dina egna åtgärder vet du nu tillräckligt för att komma igång. Resten av det här dokumentet handlar om mer avancerade tekniker.
\nHantering av fel i åtgärderLink to this heading#
\nOm det finns förutsebara felförhållanden som kan uppstå när du kör din åtgärd, bör du på ett elegant sätt informera användaren om problemet. Detta innebär att hantera undantag och använda django.contrib.admin.ModelAdmin.message_user() för att visa en användarvänlig beskrivning av problemet i svaret.
![\"/sv/6.1/_images/actions-as-modeladmin-methods.png\"](\"/sv/6.1/_images/actions-as-modeladmin-methods.png\")
\n