{"title":"gníomhartha riaracháin","version":"5.2","locale":"ga","docname":"ref/contrib/admin/actions","url":"/ga/5.2/ref/contrib/admin/actions/","canonical":"https://djangodocs.dev/ga/5.2/ref/contrib/admin/actions/","summary":"Is é sreabhadh oibre bunúsach riaracháin Django, go hachomair, “roghnaigh réad, ansin athraigh é.” Oibríonn sé seo go maith le haghaidh formhór na gcásanna úsáide.…","html":"

gníomhartha riaracháinLink to this heading#

\n

Is é sreabhadh oibre bunúsach riaracháin Django, go hachomair, “roghnaigh réad, ansin athraigh é.” Oibríonn sé seo go maith le haghaidh formhór na gcásanna úsáide. Mar sin féin, más gá duit an t-athrú céanna a dhéanamh ar go leor rudaí ag an am céanna, is féidir leis an sreabhadh oibre seo a bheith an-teannach.

\n

Sna cásanna seo, ligeann riarachán Django duit “gníomhartha” a scríobh agus a chlárú - feidhmeanna a ghlaofar le liosta rudaí a roghnaítear ar leathanach an liosta athraithe.

\n

Má fhéachann tú ar aon liosta athraithe sa riarachán, feicfidh tú an ghné seo i ngníomh; Seolann Django le gníomh “scrios rudaí roghnaithe” atá ar fáil do gach samhail. Mar shampla, seo an modúl úsáideora ó aip ionsuite Django: mod: django.contrib.auth:

\n\"/ga/5.2/_images/admin-actions.png\"\n\n

Léigh ar aghaidh chun a fháil amach conas do ghníomhartha féin a chur leis an liosta seo.

\n
\n

Gníomhartha scríLink to this heading#

\n

Is é an bealach is éasca le gníomhartha a mhíniú trí shampla, mar sin déanaimis tumadh isteach.

\n

Cás úsáide coitianta do ghníomhartha riaracháin is ea an mórchnuashonrú ar mhúnla. Samhlaigh feidhmchlár nuachta le samhail Airteagal:

\n
Code
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
\n

Tasc coitianta a d'fhéadfaimis a dhéanamh le samhail mar seo ná stádas alt a nuashonrú ó “dréacht” go “foilsithe”. D'fhéadfaimis é seo a dhéanamh go héasca san riarachán alt amháin ag an am, ach dá dteastaíonn uainn grúpa alt a fhoilsiú go mór, bheadh sé deacair. Mar sin, déanaimis gníomh a scríobh a ligeann dúinn stádas alt a athrú go “foilsithe.”

\n
\n

Feidhmeanna gníomhaíochtaLink to this heading#

\n

Ar dtús, beidh orainn feidhm a scríobh a ghlaofar nuair a spreagtar an gníomh ón riarachán. Is feidhmeanna rialta iad feidhmeanna gníomhaíochta a thógann trí argóint:

\n\n

Ní bheidh an: class: ModelAdmin nó an réad iarratais ag teastáil ó ár bhfeidhm foilsithe seo, ach úsáidfimid an tacar ceisteanna:

\n
Code
def make_published(modeladmin, request, queryset):\n    queryset.update(status="p")\n
\n\n

Sin i ndáiríre gach rud atá ann chun gníomh a scríobh! Mar sin féin, glacfaimid céim roghnach ach úsáideach amháin eile agus tabharfaimid teideal “deas” don ghníomh sa riarachán. De réir réamhshocraithe, bheadh an gníomh seo le feiceáil ar an liosta gníomhaíochta mar “Déan foilsithe” - ainm na feidhme, le spásanna ina ionad béim. Tá sé sin go breá, ach is féidir linn ainm níos fearr, níos cairdiúla don duine a sholáthar tríd an maisitheoir: func: ~django.contrib.admin.action a úsáid ar an bhfeidhm ``make_published ``:

\n
Code
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")\n
\n\n
\n
\n

Gníomhartha a chur leis an:class: ModelAdminLink to this heading#

\n

Ansin, beidh orainn ár n:class: ModelAdmin a chur ar an eolas faoin ngníomh. Oibríonn sé seo díreach cosúil le haon rogha cumraíochta eile. Mar sin, bheadh cuma ar an admin.py` iomlán leis an ngníomh agus a chlárú:

\n
Code
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
\n

Tabharfaidh an cód sin liosta athraithe riaracháin dúinn a bhfuil cuma mar seo air:

\n\"/ga/5.2/_images/adding-actions-to-the-modeladmin.png\"\n

Sin go léir atá ann i ndáiríre! Má tá tú ag iarraidh do ghníomhartha féin a scríobh, tá a fhios agat anois go leor chun tosú. Clúdaíonn an chuid eile den doiciméad seo teicnící níos airde.

\n
\n
\n

Earráidí láimhseála i ngnLink to this heading#

\n

Má tá coinníollacha earráide intuartha ann a d'fhéadfadh tarlú agus do ghníomh á reáchtáil, ba cheart duit an t-úsáideoir a chur ar an eolas go grásta faoin bhfadhb. Ciallaíonn sé seo eisceachtaí a láimhseáil agus úsáid: meth: django.contrib.admin.modeladmin.message_user chun cur síos atá cairdiúil don úsáideoir ar an bhfadhb sa fhreagra a thaispeáint.

\n
\n
\n
\n

Teicnící gníomhaíochta chunLink to this heading#

\n

Tá cúpla rogha agus féidearthachtaí breise ann is féidir leat leas a bhaint as le haghaidh roghanna níos airde.

\n
\n

Gníomhartha cosúil:class: ModelAdmin modhannaLink to this heading#

\n

Taispeánann an sampla thuas an gníomh make_published a shainmhínítear mar fheidhm. Tá sé sin go breá, ach níl sé foirfe ó thaobh dearaidh cód: ós rud é go bhfuil an gníomh ceangailte go docht leis an réad Airteagal, tá sé ciallmhar an gníomh a cheangal leis an réad ``ArticleAdMin` féin.

\n

Is féidir leat é a dhéanamh mar seo:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    ...\n\n    actions = ["make_published"]\n\n    @admin.action(description="Mark selected stories as published")\n    def make_published(self, request, queryset):\n        queryset.update(status="p")\n
\n

Tabhair faoi deara ar dtús gur bhogamar make_published isteach i modh agus athainmníomar an paraiméadar modeladmin ``go `self, agus sa dara háit gur chuireamar an teaghrán `make_published'` anois i ``actions in ionad tagairt feidhme díreach. Insíonn sé seo la:class: ModelAdmin breathnú suas ar an ngníomh mar mhodh.

\n

Tugann gníomhartha a shainmhíniú mar mhodhanna rochtain níos idiomatiúla don ghníomhaíocht ar an: class: ModelAdmin féin, rud a ligeann don ghníomh aon cheann de na modhanna a sholáthraíonn an riarachán a ghlaoch.

\n

Mar shampla, is féidir linn féin a úsáid chun teachtaireacht a splancadh chuig an úsáideoir in iúl dóibh gur éirigh leis an ngníomh:

\n
Code
from django.contrib import messages\nfrom django.utils.translation import ngettext\n\n\nclass ArticleAdmin(admin.ModelAdmin):\n    ...\n\n    def make_published(self, request, queryset):\n        updated = queryset.update(status="p")\n        self.message_user(\n            request,\n            ngettext(\n                "%d story was successfully marked as published.",\n                "%d stories were successfully marked as published.",\n                updated,\n            )\n            % updated,\n            messages.SUCCESS,\n        )\n
\n

Déanann sé seo an gníomh a mheaitseáil leis an méid a dhéanann an riarachán féin tar éis gníomh a dhéanamh go rathúil:

\n\"/ga/5.2/_images/actions-as-modeladmin-methods.png\"\n
\n
\n

Gníomhartha a sholáthraíonn leathanaighLink to this heading#

\n

De réir réamhshocraithe, tar éis gníomh a dhéanamh atreoraítear an t-úsáideoir ar ais chuig an leathanach liosta athraithe bunaidh. Mar sin féin, beidh ar roinnt gníomhartha, go háirithe cinn níos casta, leathanaigh idirmheánacha a thabhairt ar ais. Mar shampla, iarrann an gníomh scriosta ionsuite deimhniú sula ndéanann siad na rudaí roghnaithe a scriosadh.

\n

Chun leathanach idirghabhála a sholáthar, cuir ar ais an:class: ~django.http.httpResponse (nó fo-aicme) ó do ghníomhaíocht. Mar shampla, d'fhéadfá feidhm onnmhairiúcháin a scríobh a úsáideann django's:doc: feidhmeanna sraitheach chun roinnt rudaí roghnaithe a dhumpáil mar </topics/serialization> JSON:

\n
Code
from django.core import serializers\nfrom django.http import HttpResponse\n\n\ndef export_as_json(modeladmin, request, queryset):\n    response = HttpResponse(content_type="application/json")\n    serializers.serialize("json", queryset, stream=response)\n    return response\n
\n

Go ginearálta, ní mheastar gur smaoineamh iontach é rud éigin mar an méid thuas. An chuid is mó den am, is é an cleachtas is fearr ná filleadh an:class: ~django.http.http.HttpResponsereDirect agus an t-úsáideoir a atreorú chuig radharc a scríobh tú, ag dul ar liosta na rudaí roghnaithe sa teaghrán ceisteanna GET. Ligeann sé seo duit loighic idirghníomhú casta a sholáthar ar na leathanaigh idir Mar shampla, más mian leat feidhm easpórtála níos iomláine a sholáthar, ba mhaith leat ligean don úsáideoir formáid a roghnú, agus b'fhéidir liosta réimsí le cur san onnmhairiú. Is é an rud is fearr le déanamh ná gníomh beag a scríobh a atreoraíonn chuig do radharc saincheaptha onnmhairithe:

\n
Code
from django.contrib.contenttypes.models import ContentType\nfrom django.http import HttpResponseRedirect\n\n\ndef export_selected_objects(modeladmin, request, queryset):\n    selected = queryset.values_list("pk", flat=True)\n    ct = ContentType.objects.get_for_model(queryset.model)\n    return HttpResponseRedirect(\n        "/export/?ct=%s&ids=%s"\n        % (\n            ct.pk,\n            ",".join(str(pk) for pk in selected),\n        )\n    )\n
\n

Mar a fheiceann tú, tá an gníomh sách gearr; bheadh an loighic chasta go léir i do dhearcadh onnmhairithe. Bheadh sé seo déileáil le rudaí de chineál ar bith, dá bhrí sin an gnó leis an “ContentType”.

\n

Fágtar an dearcadh seo a scríobh mar chleachtadh don léitheoir.

\n
\n
\n

Gníomhartha a chur ar fáil ar fud an suíomhLink to this heading#

\n
\n
\nAdminSite.add_action(action, name=None)Link to this definition#
\n

Is fearr roinnt gníomhartha má chuirtear iad ar fáil dó* aon réad ar shuíomh riaracháin - is iarrthóir maith a bheadh an gníomh onnmhairithe a shainmhínítear thuas. Is féidir leat gníomh a chur ar fáil ar fud an domhain ag baint úsáid:meth: `adminsite.add_action () `. Mar shampla:

\n
Code
from django.contrib import admin\n\nadmin.site.add_action(export_selected_objects)\n
\n

Fágann sé seo an gníomh export_selected_objects ar fáil ar fud an domhain mar ghníomh darb ainm “export_selected_objects”. Is féidir leat ainm a thabhairt go sainráite don ghníomh -- go maith más mian leat go cláraitheach níos déanaí:ref: bain an gníomh <disabling-admin-actions>-- tríd an dara argóint a rith chuig:meth: adminsite.add_action ():

\n
Code
admin.site.add_action(export_selected_objects, "export_selected")\n
\n
\n\n
\n
\n

Gníomhartha díchumasaitheLink to this heading#

\n

Uaireanta ní mór duit gníomhartha áirithe a dhíchumasú - go háirithe iad siú:ref: cláraithe ar fud an láithreáin <adminsite-actions>- le haghaidh rudaí áirithe. Tá cúpla bealach ann is féidir leat gníomhartha a dhíchumasú:

\n
\n

Gníomh ar fud an láithreáin a dhíchumasúLink to this heading#

\n
\n
\nAdminSite.disable_action(name)Link to this definition#
\n

Más gá duit a: ref: gníomh ar fud an láithreáin `a dhíchumasú is féidir leat glaoch ar: <adminsite-actions>meth: `adminsite.disable_action ().

\n

Mar shampla, is féidir leat an modh seo a úsáid chun an gníomh ionsuite “scrios rudaí roghnaithe” a bhaint:

\n
Code
admin.site.disable_action("delete_selected")\n
\n

Nuair a bheidh an méid thuas déanta agat, ní bheidh an gníomh sin ar fáil ar fud an láithreáin a thuilleadh.

\n

Más gá duit, áfach, gníomh faoi mhíchumas domhanda a athchumasú do mhúnla áirithe amháin, liostaigh é go sainráite i do liosta ``ModelAdmin.Actions`:

\n
Code
# Globally disable delete selected\nadmin.site.disable_action("delete_selected")\n\n\n# This ModelAdmin will not have delete_selected available\nclass SomeModelAdmin(admin.ModelAdmin):\n    actions = ["some_other_action"]\n    ...\n\n\n# This one will\nclass AnotherModelAdmin(admin.ModelAdmin):\n    actions = ["delete_selected", "a_third_action"]\n    ...\n
\n
\n\n
\n
\n

Gach gníomh a dhíchumasú le haghaidh áirithe: class: ModelAdminLink to this heading#

\n

Más mian leat mórghníomhaíochtaí no ar fáil le haghaidh tugadh: class: ModelAdmin, socraí:attr: ModelAdmin.actions go None:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    actions = None\n
\n

<adminsite-actions>Insíonn sé seo la:class: ModelAdmin gan aon ghníomhartha a thaispeáint ná a cheadú, lena n-áirítear aon ghníomhartha: ref: `láithreáin ghníomhartha `.

\n
\n
\n

gníomhartha a chumasú nó a dhíchumasúLink to this heading#

\n
\n
\nModelAdmin.get_actions(request)Link to this definition#
\n

Faoi dheireadh, is féidir leat gníomhartha a chumasú nó a dhíchumasú go coinníollach ar aghaidh iarratais (agus dá bhrí sin in aghaidh an úsáideora) trí:meth: ModelAdmin.get_actions a ró-dhiaidh.

\n

Tugann sé seo foclóir gníomhartha ceadaithe ar ais. Is ainmneacha gníomhaíochta iad na heochracha, agus is iad na luachanna (feidhm, ainm, gearr_description) tuples.

\n

Mar shampla, mura dteastaíonn uait ach go mbeidh úsáideoirí a dtosaíonn a n-ainmneacha le 'J' in ann rudaí a scriosadh ar an mórchóir:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    ...\n\n    def get_actions(self, request):\n        actions = super().get_actions(request)\n        if request.user.username[0].upper() != "J":\n            if "delete_selected" in actions:\n                del actions["delete_selected"]\n        return actions\n
\n
\n\n
\n
\n
\n

Ceadanna a shocrú le haghaidh gníomharLink to this heading#

\n

Féadfaidh gníomhartha a n-infhaighteacht a theorannú d'úsáideoirí a bhfuil ceadanna sonracha acu tríd an bhfeidhm ghníomhaíochta a fhilleadh leis an maisitheoir: func: ~django.contrib.admin.action agus an argóint ceadúna a rith:

\n
Code
@admin.action(permissions=["change"])\ndef make_published(modeladmin, request, queryset):\n    queryset.update(status="p")\n
\n

Ní bheidh an gníomh ``make_published () ``ar fáil ach d'úsáideoirí a rachaidh an seice:meth: .modeladmin.has_change_permission.

\n

Má tá níos mó ná cead amháin ag ceadúnaí, beidh an gníomh ar fáil chomh fada agus a rachaidh an t-úsáideoir ceann amháin de na seiceálacha ar a laghad.

\n

Is iad na luachanna atá ar fáil le haghaidh `ceadui' agus na seiceálacha modh comhfhreagracha:

\n\n

Is féidir leat aon luach eile a shonrú chomh fada agus a chuireann tú modh comhfhreagrach hais_ <value>_cead (féin, iarraidh) ``i bhfeidhm ar an `ModelAdmin.

\n

Mar shampla:

\n
Code
from django.contrib import admin\nfrom django.contrib.auth import get_permission_codename\n\n\nclass ArticleAdmin(admin.ModelAdmin):\n    actions = ["make_published"]\n\n    @admin.action(permissions=["publish"])\n    def make_published(self, request, queryset):\n        queryset.update(status="p")\n\n    def has_publish_permission(self, request):\n        """Does the user have the publish permission?"""\n        opts = self.opts\n        codename = get_permission_codename("publish", opts)\n        return request.user.has_perm("%s.%s" % (opts.app_label, codename))\n
\n
\n
\n
\n

An maisitheoir gníomhaLink to this heading#

\n
\n
\naction(*, permissions=None, description=None)Link to this definition#
\n

Is féidir an maisitheoir seo a úsáid chun tréithe sonracha a shocrú ar fheidhmeanna gníomhaíochta saincheaptha is féidir a úsáid le:attr: ~django.contrib.admin.modelAdmin.actions:

\n
Code
@admin.action(\n    permissions=["publish"],\n    description="Mark selected stories as published",\n)\ndef make_published(self, request, queryset):\n    queryset.update(status="p")\n
\n

Tá sé seo comhionann le roinnt tréithe (leis na hainmneacha bunaidh, níos faide) a shocrú go díreach ar an bhfeidhm:

\n
Code
def make_published(self, request, queryset):\n    queryset.update(status="p")\n\n\nmake_published.allowed_permissions = ["publish"]\nmake_published.short_description = "Mark selected stories as published"\n
\n

Níl sé éigeantach an maisitheoir seo a úsáid chun feidhm ghníomhaíochta a dhéanamh, ach d'fhéadfadh sé a bheith úsáideach é a úsáid gan argóintí mar mharcóir i do fhoinse chun cuspóir na feidhme a aithint:

\n
Code
@admin.action\ndef make_inactive(self, request, queryset):\n    queryset.update(is_active=False)\n
\n

Sa chás seo ní chuirfidh sé aon tréithe leis an bhfeidhm.

\n

Tá tuairiscí gníomhaíochta %-formáidithe agus d'fhéadfadh go mbeadh '% (verbose_name) s' agus `% (verbose_name_plural) s' iontu, a chuirtear na samhlacha 's:attr: ~django.db.models.options.verbose_name agus:attr: ~django.db.models.options.options.Verbose_Ainm_Plural.

\n
\n\n
","rootId":"admin-actions","toc":[{"title":"Gníomhartha scrí","anchor":"writing-actions","children":[{"title":"Feidhmeanna gníomhaíochta","anchor":"writing-action-functions","children":[]},{"title":"Gníomhartha a chur leis an:class: ModelAdmin","anchor":"adding-actions-to-the-modeladmin","children":[]},{"title":"Earráidí láimhseála i ngn","anchor":"handling-errors-in-actions","children":[]}]},{"title":"Teicnící gníomhaíochta chun","anchor":"advanced-action-techniques","children":[{"title":"Gníomhartha cosúil:class: ModelAdmin modhanna","anchor":"actions-as-modeladmin-methods","children":[]},{"title":"Gníomhartha a sholáthraíonn leathanaigh","anchor":"actions-that-provide-intermediate-pages","children":[]},{"title":"Gníomhartha a chur ar fáil ar fud an suíomh","anchor":"making-actions-available-site-wide","children":[]},{"title":"Gníomhartha díchumasaithe","anchor":"disabling-actions","children":[{"title":"Gníomh ar fud an láithreáin a dhíchumasú","anchor":"disabling-a-site-wide-action","children":[]},{"title":"Gach gníomh a dhíchumasú le haghaidh áirithe: class: ModelAdmin","anchor":"disabling-all-actions-for-a-particular-modeladmin","children":[]},{"title":"gníomhartha a chumasú nó a dhíchumasú","anchor":"conditionally-enabling-or-disabling-actions","children":[]}]},{"title":"Ceadanna a shocrú le haghaidh gníomhar","anchor":"setting-permissions-for-actions","children":[]}]},{"title":"An maisitheoir gníomha","anchor":"the-action-decorator","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/5.2/ref/contrib/"},{"docname":"ref/contrib/admin/index","title":"Suíomh riaracháin Django","url":"/ga/5.2/ref/contrib/admin/"}],"prev":{"docname":"ref/contrib/admin/index","title":"Suíomh riaracháin Django","url":"/ga/5.2/ref/contrib/admin/"},"next":{"docname":"ref/contrib/admin/filters","title":"ModelAdmin Scagairí Liosta","url":"/ga/5.2/ref/contrib/admin/filters/"},"formats":{"html":"/ga/5.2/ref/contrib/admin/actions/","markdown":"/ga/5.2/ref/contrib/admin/actions.md","json":"/ga/5.2/ref/contrib/admin/actions.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/admin/actions.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/contrib/admin/actions/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}