[PYTHON] Teilen Sie Daten mit Django (2) in projektähnliche Einheiten.

Vorwort

Dies ist eine Fortsetzung von diesem Artikel. Eine "projektähnliche Einheit" ist ein "Projekt" in einem Task-Management-Tool usw. Da das Theater verwaltet wird, entspricht die "Performance" diesem.

---> GitHub Repository (Python 3.8.1, Django 3.0.3)

Artikelinhalt

Letztes Mal haben wir "Performances" und "Performance User" erstellt und den Zugriff kontrolliert. Wir haben es auch "Benutzern einer Aufführung" ermöglicht, Daten (Akteure) hinzuzufügen, die zu dieser Aufführung gehören.

Dieses Mal möchte ich über die Schnittstelle zum Hinzufügen und Bearbeiten von Daten nachdenken, die zur Aufführung gehören.

Spezielle Ziele

Wenn Sie beispielsweise in den Daten "Charaktere" ein Feld "ForeignKey" mit dem Namen "Casting" erstellen und auf "Schauspieler" verweisen, möchten Sie nur die Schauspieler für diese Aufführung auswählen können. Durch einfaches Erstellen von "Model" und "View" wie unten gezeigt können jedoch alle Schauspieler (einschließlich Schauspieler, die zu anderen Performances gehören) als "Cast" ausgewählt werden.

models.py

from django.db import models

class Character(models.Model):
    '''Charakter
    '''
    production = models.ForeignKey(Production, verbose_name='Performance',
        on_delete=models.CASCADE)
    name = models.CharField('Rollenname', max_length=50)
    cast = models.ForeignKey(Actor, verbose_name='Casting',
        on_delete=models.SET_NULL, blank=True, null=True)

views.py

from django.contrib.auth.mixins import LoginRequiredMixin
from django.views.generic.edit import CreateView
from .models import Character

class ChrCreate(LoginRequiredMixin, CreateView):
    '''Zusätzliche Ansicht des Charakters
    '''
    model = Character
    fields = ('name', 'cast')

▲ Sie können die Schauspieler anderer Aufführungen auswählen.

Organisieren Sie, was Sie tun möchten

Erwägen Sie, einer "Aufführung" einen "Charakter" hinzuzufügen. "Charaktere" hat ein Feld namens "Casting" und "beziehen sich auf" Akteursdaten ", die zur Aufführung gehören".

Benutzeroberfläche zur Auswahl einer Besetzung

Die obige Abbildung ist "ein Beispiel, bei dem die Schauspieler anderer Aufführungen wählen können", aber mit Ausnahme dieses Problems ist die Benutzeroberfläche in Ordnung.

Validierung

In Anbetracht der Tatsache, dass die vom Webbrowser gesendete Anfrage möglicherweise manipuliert wurde, sollten nicht nur die UI-Optionen, sondern auch der "akzeptierte Wert" auf "nur den Akteur der Leistung" beschränkt werden.

Bei späterer Bearbeitung

Überlegen Sie, wann Sie die hinzugefügten "Zeichen" später bearbeiten möchten. Es wäre das ursprüngliche Mokuami, wenn die Zugehörigkeit (Performance) des Charakters, der den "Schauspieler der Performance" besetzt, geändert werden könnte. Es scheint gut zu sein, es unmöglich zu machen, die Zugehörigkeit des einmal geschaffenen "Charakters" zu ändern.

Änderungen an der Benutzeroberfläche

Diese App verwendet eine klassenbasierte Ansicht (CreateView), sodass das Formular automatisch generiert wird und Sie die Vorlage wie folgt schreiben können:

modelname_form.html

<form method="post">
    {% csrf_token %}
    <table>
        {{ form }}
    </table>
    {% if object %}
    <input type="submit" value="aktualisieren">
    {% else %}
    <input type="submit" value="hinzufügen">
    {% endif %}
</form>

Die Eingabe-Benutzeroberfläche für jedes Feld des Objekts wird in diesem Teil mit dem Namen "{{form}}" erweitert, sodass Sie es auch hier neu schreiben können. In diesem Fall müssen Sie die Auswahl "Besetzung" als "Kontext" übergeben und auch die Art und Weise, wie das Formular in die Vorlage geschrieben wird, für jedes Feld trennen.

Hier werden wir es stoppen und den Inhalt des Formulars, das im Teil {{form}} `erweitert wurde, im Voraus ändern.

Ändern Sie den Inhalt des Formulars

Eine Möglichkeit, den Inhalt eines Formulars zu ändern, besteht darin, eine Unterklasse des Formulars zu erstellen. Sie können diese jedoch auch ändern, ohne dies zu tun. Hier werden wir es in der Methode der Ansicht ändern. Wir werden später über Unterklassenformulare sprechen.

Ein Formular ist eine Art von "Kontext", der von einer Ansicht an eine Vorlage übergeben wird. Sie können also "get_context_data ()" überschreiben und wie folgt ändern: Die "ProdBaseCreateView", die die Ansicht im folgenden Code erbt, ist eine abstrakte Klasse, die die Leistungs-ID empfängt und den Zugriff steuert (siehe Vorheriger Artikel. Bitte sehen Sie. Sie müssen sich jetzt nicht zu viele Sorgen machen.

rehearsal/views/views.py

class ChrCreate(ProdBaseCreateView):
    '''Zusätzliche Ansicht des Charakters
    '''
    model = Character
    fields = ('name', 'cast')
    
    def get_context_data(self, **kwargs):
        '''Ändern Sie die an die Vorlage übergebenen Parameter
        '''
        context = super().get_context_data(**kwargs)
        
        #Zeigen Sie nur die Schauspieler der Aufführung
        actors = Actor.objects.filter(production=self.production)
        #Erstellen Sie eine Auswahl
        choices = [('', '---------')]
        choices.extend([(a.id, str(a)) for a in actors])
        #In Form setzen
        context['form'].fields['cast'].choices = choices
        
        return context

Ausführliche Erklärung

--context ['form'] ermöglicht es Ihnen, das Formular anzuzeigen, das die Ansicht an die Vorlage übergeben möchte.

• Wenn Sie in einem Feld des Formulars "Auswahl" festlegen, wird es als Auswahl angezeigt.
• Jedes Element von "Auswahl" ist ein Tupel aus "Wert" und "Anzeigezeichenfolge".
• Mit dieser App können Sie "cast" auf "leer" setzen, sodass der Wert der ersten Option leer ist.

▲ Es wurden nur die Akteure der Aufführung angezeigt, zu denen die Charaktere gehören.

Validierung

Ich sehe Informationen, dass das Festlegen von "Auswahlmöglichkeiten" in einem Feld in einem Formular automatisch andere Werte abstößt, aber als ich es tatsächlich ausprobiert habe, war dies nicht der Fall. Es kann sein, dass das Feld mit "Auswahl" "ForeignKey" war.

▲ Versuchen Sie, die Optionen in Ihrem Browser zu manipulieren.

▲ Der manipulierte Wert wurde hinzugefügt.

Ändern Sie die Validierungsergebnisse

Sie können die Methoden der Ansicht überschreiben, um die Validierungsergebnisse zu ändern. Am Ende ist es sauberer, eine Unterklasse des Formulars zu erstellen, aber zuerst machen wir es nur mit der Ansicht.

rehearsal/views/views.py

class ChrCreate(ProdBaseCreateView):

    # (Unterlassung)
    
    def form_valid(self, form):
        '''Nach bestandener Validierung
        '''
        #Die Validierung ist fehlgeschlagen, wenn die Besetzung nicht der Akteur derselben Leistung ist
        instance = form.save(commit=False)
        if instance.cast.production != self.production:
            return self.form_invalid(form)
        
        return super().form_valid(form)

form_valid () ist eine ansichtsseitige Verarbeitungsmethode, die aufgerufen wird, wenn das Formular die Validierung besteht. Wenn Sie die Methode (form_invalid ()) zwangsweise aufrufen, die aufgerufen wird, wenn die Validierung nicht bestanden wird, können Sie das Speichern verhindern.

Ausführliche Erklärung

--form.save (commit = False) ruft das Objekt ab, das das Formular speichern möchte. Wenn Sie commit = True setzen, wird es gespeichert und dann abgerufen.

• Sie können auch Objekte mit "self.object" oder "form.instance" erhalten, aber ich verstehe den Unterschied nicht wirklich. Ich wäre dankbar, wenn jemand, der das weiß, es mich wissen lassen könnte. --self.production in der if -Anweisung ist ein Attribut der Oberklasse ProdBaseCreateView dieser Ansicht, die die" Leistung "des Objekts aufweist, das Sie speichern möchten (siehe [Weitere Informationen]. Bitte lesen Sie den vorherigen Artikel](https://qiita.com/satamame/items/959e21ade18c48e1b4d6).

Der unangenehme Teil davon

Es kann unangenehm sein, form_invalid () von form_valid () wie oben aufzurufen. Wenn Sie sich die Bedeutung von "form_valid ()" als "den Ort vorstellen, an dem Sie aufgerufen werden, wenn Sie die Validierung bestehen und die Verarbeitung fortsetzen", liegt dies daran, dass ein Gefühl der Inkongruenz wie ein Akt der Überrechterung besteht. Infolgedessen wird "form_invalid ()" aufgerufen, und es scheint, dass eine solche Chabudai-Rückgabe zulässig ist.

Im schlimmsten Fall können Sie form_valid () erlauben, auch form_valid () aufzurufen, was zu einem zirkulären Aufruf führt. Wenn Sie die Regeln festlegen, z. B. die Einbahnstraße, gibt es natürlich kein Problem mit der oben genannten Methode.

Ein anderer Weg (Formularunterklasse)

Wenn Sie das Formular in Unterklassen unterteilen möchten, müssen Sie nicht einmal die get_context_data () überschreiben, die Sie unter "Ändern der Benutzeroberfläche" erstellt haben. Stattdessen überschreibt die Ansicht eine Methode namens "get_form_kwargs ()". Es ist ein Bild, das das generierte Formular selbst anpasst, anstatt das "an die Vorlage übergebene Formular" zu ändern.

Daten an Formular übergeben

Der Rückgabewert, der mit get_form_kwargs () abgerufen werden kann, ist ein Wörterbuch mit Schlüsselwortargumenten, die an den Formularkonstruktor übergeben werden. Wenn Sie diesem also einen Eintrag hinzufügen, können Sie ihn auf der Formularseite verwenden.

Das Folgende ist ein Beispiel für das Überschreiben von "get_form_kwargs ()" unter der Annahme, dass eine Klasse namens "ChrForm" definiert ist. Wenn Sie in der Ansicht "form_class" setzen, setzen Sie keine "Felder" (ich denke, dies hätte zu einem Fehler geführt).

rehearsal/views/views.py

from rehearsal.forms import ChrForm

class ChrCreate(ProdBaseCreateView):
    '''Zusätzliche Ansicht des Charakters
    '''
    model = Character
    form_class = ChrForm
    
    def get_form_kwargs(self):
        '''Ändern Sie die an das Formular übergebenen Informationen
        '''
        kwargs = super().get_form_kwargs()
        
        #Bestehen Sie die Produktion, da sie zur Validierung auf der Formularseite verwendet wird
        kwargs['production'] = self.production
        
        return kwargs

Formularseitige Implementierung

rehearsal/forms.py

from django import forms
from production.models import Production
from .models Character

class ChrForm(forms.ModelForm):
    '''Formular zum Hinzufügen / Aktualisieren von Zeichen
    '''
    class Meta:
        model = Character
        fields = ('name', 'cast')
    
    def __init__(self, *args, **kwargs):
        #Extrahieren Sie die in der Ansicht hinzugefügten Parameter
        production = kwargs.pop('production')
        
        super().__init__(*args, **kwargs)
        
        #Das Casting kann nur von Schauspielern derselben Aufführung ausgewählt werden
        queryset = Actor.objects.filter(production=production)
        self.fields['cast'].queryset = queryset

Sie setzen "Queryset" anstelle von "Auswahl" im Feld "Besetzung". Auf diese Weise können Sie Auswahlmöglichkeiten basierend auf dem von Ihnen festgelegten Abfragesatz generieren und validieren.

Wenn Sie dieses Formular erstellen, können Sie es nicht nur für die zusätzliche Ansicht, sondern auch für die Aktualisierungsansicht verwenden.

Lassen Sie uns nun die Optionen manipulieren, die wir in "Validierung" vorgenommen haben.

Bei späterer Bearbeitung

Verbieten Sie Änderungen an "Produktion" in diesen Add / Update-Ansichten, damit Sie die "Leistung" der "Charaktere" oder "Schauspieler" nicht ändern können.

Ändern Sie bearbeitbare Felder

Wenn Sie normalerweise in Django ein Formular mit "Modell" erstellen, können alle Felder bearbeitet werden. Sie müssen daher die bearbeitbaren Felder angeben.

• Wenn Sie in der Ansicht "form_class" angeben möchten, wie Sie es in der Formularunterklasse getan haben, geben Sie "Felder" in der "Meta" des Formulars an.
• Wenn Sie nicht "form_class" angeben, geben Sie "fields" in der Ansicht an.

Ich bearbeite es nicht, aber ich möchte darauf verweisen

Möglicherweise möchten Sie auch auf Felder verweisen, die Sie nicht aus Formularen oder Vorlagen bearbeiten. In beiden Fällen können Sie, wie bereits erwähnt, die Ansichten "get_context_data ()" und "get_form_kwargs ()" verwenden.

Zusammenfassung

• Ich habe mir überlegt, wie ich die "Produktion" gleich machen kann, wenn ich zwei Arten von Daten ("Charaktere" und "Schauspieler") zuordne, die beide ein "ForeignKey" -Feld namens "Produktion" (Leistung) haben.
• Obwohl es möglich war, sowohl die Benutzeroberfläche als auch die Validierung auf der Ansichtsseite zu ändern, führte die Unterklasse des Formulars zu einer saubereren Implementierung.
• Die Methode "get_context_data ()" beim Übergeben von Daten aus der Ansicht an die Vorlage wurde überschrieben.
• Die Methode "get_form_kwargs ()" beim Übergeben von Daten aus der Ansicht an das Formular wurde überschrieben.
• Um die Auswahl der Eingabewerte auf der Formularseite festzulegen, setzen Sie das Feld "Abfragesatz", und sowohl die Benutzeroberfläche als auch die Validierung folgten.

Ich habe die Fortsetzung geschrieben

• Django unterteilt Daten in Projekteinheiten (3)