![\"/ja/5.1/_images/admin-actions.png\"](\"/ja/5.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\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このようなモデルで行う一般的なタスクは記事のステータスを "draft "から "published "に更新することです。管理画面で一度に1つの記事を更新するのは簡単ですが、記事のグループを一括で公開するのは面倒です。そこで、記事のステータスを "published " に変更するアクションを書いてみましょう。
\nアクション関数を書くLink to this heading#
\n最初に、管理画面からアクションがトリガーされたときに呼び出される関数を書く必要があります。アクション関数は3つの引数を取る通常の関数です:
\n- \n
現在の
ModelAdmin\n現在のリクエストを表す
HttpRequest\nユーザーが選択したオブジェクトのセットを含む
QuerySet。 \n
publish-these-articles 関数は ModelAdmin やリクエストオブジェクトを必要としませんが、クエリセットを使用します:
def make_published(modeladmin, request, queryset):\n queryset.update(status="p")\nアクションの書き方はこれだけです！しかし、もう1つオプションの、しかし便利なステップを踏んで、管理画面でアクションに "素敵な "タイトルをつけましょう。デフォルトでは、このアクションは "Make published "としてアクションリストに表示されます。しかし、 make_published 関数に action() デコレータを使用することで、より良い、人にやさしい名前をつけることができます:
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")\nModelAdmin にアクションを追加するLink to this heading#
\n次に ModelAdmin にアクションを通知する必要があります。これは他の設定オプションと同じように動作します。アクションとその登録を含む admin.py は次のようになります:
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)\nこのコードによって、次のような admin チェンジリストができます:
\n![\"/ja/5.1/_images/adding-actions-to-the-modeladmin.png\"](\"/ja/5.1/_images/adding-actions-to-the-modeladmin.png\")
\n本当にそれだけです！もしあなたが自分のアクションを書きたくてうずうずしているのであれば、これで始めるのに十分な知識が得られました。このドキュメントの残りの部分では、より高度なテクニックを扱います。
\nアクション内でエラーをハンドリングするLink to this heading#
\nアクションの実行中に予見可能なエラー状態が発生した場合、ユーザに問題を潔く知らせるべきです。これは、例外のハンドリングと、 django.contrib.admin.ModelAdmin.message_user() を使用して、レスポンスに問題のユーザーフレンドリーな説明を表示することを意味します。
![\"/ja/5.1/_images/actions-as-modeladmin-methods.png\"](\"/ja/5.1/_images/actions-as-modeladmin-methods.png\")
\n