![\"/zh-hans/4.1/_images/admin-actions.png\"](\"/zh-hans/4.1/_images/admin-actions.png\")
\n\n编写动作Link to this heading#
\n解释动作的最简单的方法就是举例说明，所以让我们潜心研究。
\n管理动作的一个常见用例是模型的批量更新。想象一下，一个新闻应用程序有一个 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\n我们可能会用这样的模型来执行一个常见的任务，就是将一篇文章的状态从 “草稿” 更新为 “已发布”。我们可以很容易地在管理员中一次只发布一篇文章，但如果我们想批量发布一组文章，就会很繁琐。所以，让我们编写一个动作，让我们可以把一篇文章的状态改为 “已发布”。
\n编写动作函数Link to this heading#
\n首先，我们需要写一个函数，当管理触发动作时就会被调用。动作函数是常规函数，它有三个参数：
\n- \n
当前
ModelAdmin\n一个代表当前请求的
HttpRequest， \n一个包含用户所选择的对象集合的
QuerySet。 \n
我们的 publish-these-articles 函数不需要 ModelAdmin 或请求对象，但我们将使用此查询集：
def make_published(modeladmin, request, queryset):\n queryset.update(status='p')\n其实这就是写一个动作的全部内容了！然而，我们将再采取一个可选的但很有用的步骤，在管理中给这个动作一个 “漂亮” 的标题。默认情况下，这个操作会在操作列表中显示为 “Make published” —— 函数名称，下划线用空格代替。这很好，但我们可以通过在 make_published 函数上使用 action() 装饰器来提供一个更好的、更人性化的名称：
from django.contrib import admin\n\n...\n\n@admin.action(description='Mark selected stories as published')\ndef make_published(modeladmin, request, queryset):\n queryset.update(status='p')\n在 ModelAdmin 中添加动作Link to this heading#
\n接下来，我们需要通知我们的 ModelAdmin 的动作。这就像其他配置选项一样。因此，完整的 admin.py 中包含了动作及其注册的内容，看起来是这样的：
from django.contrib import admin\nfrom myapp.models import Article\n\n@admin.action(description='Mark selected stories as published')\ndef make_published(modeladmin, request, queryset):\n queryset.update(status='p')\n\nclass ArticleAdmin(admin.ModelAdmin):\n list_display = ['title', 'status']\n ordering = ['title']\n actions = [make_published]\n\nadmin.site.register(Article, ArticleAdmin)\n这段代码会给我们一个管理变更列表，看起来像这样：
\n![\"/zh-hans/4.1/_images/adding-actions-to-the-modeladmin.png\"](\"/zh-hans/4.1/_images/adding-actions-to-the-modeladmin.png\")
\n这其实就是全部的内容了！如果你渴望编写自己的动作，你现在已经知道了足够的知识，可以开始了。本文档的其余部分涵盖了更多的高级技术。
\n处理动作中的错误Link to this heading#
\n如果在运行你的动作时可能出现可预见的错误情况，你应该优雅地告知用户问题。这意味着处理异常，并使用 django.contrib.admin.ModelAdmin.message_user() 在响应中显示一个用户友好的问题描述。
![\"/zh-hans/4.1/_images/actions-as-modeladmin-methods.png\"](\"/zh-hans/4.1/_images/actions-as-modeladmin-methods.png\")
\n