Direkt zum Hauptinhalt

Ansicht erstellen

Ziel​

Eine Ansicht erstellen – eine tabellarische Liste der Datensätze einer Entität – mit den Spalten, Filtern und der Sortierung Ihrer Wahl.

Voraussetzungen​

  • Sie sind mit einer Erstellerrolle (oder als Plattformadministrator) angemeldet.
  • Die Entität ist vorhanden und enthält die Felder, die Sie anzeigen und nach denen Sie filtern möchten.

Schritte​

  1. Öffnen Sie die Entität unter Tabellen, und wechseln Sie zur Registerkarte Ansichten.
  2. Geben Sie unter Neue Ansicht einen Anzeigenamen ein (zum Beispiel Active Invoices).
  3. Geben Sie einen logischen Namen ein. Das Präfix des Herausgebers, dem die Lösung gehört, in der Sie arbeiten, wird neben dem Feld angezeigt und automatisch vorangestellt – aus invoice_active wird par_invoice_active. Das gilt auch für Standardtabellen: Eine Ansicht, die Sie für Account erstellen, heißt par_account_overview, nicht account_overview, weil Namen ohne Präfix Parsware gehören und ein selbst erfundener Name mit der nächsten Ansicht kollidieren würde, die Parsware mitliefert.
  4. Wählen Sie die anzuzeigenden Spalten aus, indem Sie jedes einzuschließende Feld aktivieren.
  5. Fügen Sie optional einen Filter hinzu (wählen Sie ein Feld, einen Operator und – sofern der Operator nicht „ist leer“/„ist nicht leer“ lautet – einen Wert) sowie eine Sortierung (wählen Sie ein Feld und ob absteigend sortiert wird).
  6. Belassen Sie den Ansichtstyp auf Liste – die Listenseite der Entität. Die anderen Typen gibt es für andere Oberflächen: siehe Nachschlageansicht erstellen und Festlegen, welche Spalten eine Suche durchsucht.
  7. Markieren Sie die Ansicht optional als Standardansicht der Entität. Eine Ansicht ist Standard für ihren eigenen Typ; eine Standard-Listenansicht und eine Standard-Nachschlageansicht bestehen also nebeneinander.
  8. Lassen Sie Zeilen-Kontrollkästchen aktiviert, es sei denn, auf diese Liste reagiert niemand – siehe unten.
  9. Wählen Sie Ansicht speichern.
  10. Die Ansicht erscheint in der Ansichtsliste der Entität, mit ihrem Typ als Spalte.

Zeilen-Kontrollkästchen – und wann Sie sie abschalten​

Zeilen tragen standardmäßig ein Kontrollkästchen, und die Befehlsleiste wirkt auf das, was angehakt ist: So weiß Bearbeiten, welchen Datensatz es öffnen soll, und Löschen, welche Datensätze es entfernen soll.

Schalten Sie Zeilen-Kontrollkästchen für eine Ansicht ab, die immer nur gelesen wird – eine Referenzliste, eine Nachschlagetabelle mit Ländercodes, ein Protokoll, das man überfliegt, ohne darauf zu reagieren. Zwei Dinge folgen daraus, beide gewollt:

  • Die Spalte mit den Kontrollkästchen verschwindet und mit ihr eine Spaltenbreite auf einem schmalen Bildschirm.
  • Bearbeiten und Löschen verschwinden aus der Befehlsleiste, weil eine Ansicht ohne Auswahl ihnen nicht mitteilen kann, auf welchen Datensatz sie wirken sollen – und eine Schaltfläche, die sich nie drücken lässt, ist schlechter als eine, die gar nicht da ist. Neu und Aktualisieren bleiben, und ein Klick auf eine Zeile öffnet weiterhin den Datensatz – diese Geste ist nicht betroffen.

Es ist eine Eigenschaft der Ansicht, nicht der Tabelle, gerade weil eine Tabelle meist beides ist: eine operative Liste, mit der Ihr Team arbeitet, und eine Referenzliste, die man nur ansieht. Geben Sie ihr zwei Ansichten, und beantworten Sie die Frage in jeder anders.

Die Ansichtstypen und wo sie verwendet werden​

Eine Ansicht ist nicht nur „die Listenseite“. Dieselbe Tabelle braucht in einer Auswahl andere Spalten als in ihrer vollständigen Liste, und nochmals andere, um festzulegen, was eine Eingabe durchsucht. Jede davon ist eine gewöhnliche Ansicht, die Sie anlegen, statt etwas, das die Plattform errät:

TypWo er verwendet wirdWas davon gelesen wird
ListeDie Listenseite der Tabelle, in einer App und im Admin Control Center.Spalten, Filter, Sortierung – alles.
NachschlagenIn der Auswahl eines Nachschlagefeld-Steuerelements und im Raster der erweiterten Suche hinter der Lupe. Siehe Nachschlageansicht erstellen.Spalten, Filter, Sortierung. Beschränken Sie sie auf zwei bis vier Spalten: Eine Auswahl ist kein Bericht.
SchnellsucheWelche Spalten eine eingegebene Suche in einem Nachschlagefeld durchsucht. Siehe Festlegen, welche Spalten eine Suche durchsucht.Nur die Spalten – Filter und Sortierung werden ignoriert, weil sie die Frage „was durchsucht die Suche“ beantwortet, nicht „was wird aufgelistet“.
Verknüpfte DatensätzeReserviert für das Unterraster auf einer Registerkarte mit verknüpften Datensätzen. Noch stellt nichts sie dar; eine Ansicht dieses Typs wird also gespeichert und validiert, aber nirgends angezeigt.Vorerst nichts.
SchnellansichtDas Raster-Widget eines Dashboards und überall sonst, wo die Oberfläche bereits einen eigenen Rahmen hat – ein Dialog, ein Seitenbereich.Spalten, Filter, Sortierung – aber dargestellt ohne Titelleiste und ohne Symbolleiste.
KarteDas Karten-Widget eines Dashboards. Ihre Spalten werden als Felder eines einzelnen Datensatzes gelesen und als Karte statt als Zeile angeordnet.Spalten, in Reihenfolge – sie bestimmen, welche Felder die Karte zeigt.

Warum die Schnellansicht ein eigener Typ ist und kein Schalter an einer Listenansicht. Eine Kachel ist vier Spalten breit, eine Listenseite zwölf, und das ist nicht dieselbe Antwort. Als eigener Typ können Sie die Spalten für beide wählen, statt dass die Plattform die eine passend zusammenstaucht. Deshalb bietet ein Raster-Widget auch zuerst Ihre Schnellansichten an: Eine Listenansicht in einer Kachel setzt einen zweiten Kopf in den, den die Kachel bereits hat.

Wenn Sie unsicher sind, ist Liste die richtige Antwort: Das ist jede Ansicht, die vor Einführung der Typen angelegt wurde, und es ist der einzige Typ, den die Navigation einer App anbietet.

Nur Listenansichten erscheinen in der Ansichtsauswahl. Auf der Listenseite einer Tabelle bietet das Dropdown unter dem Titel – mit dem Sie wechseln, welche Ansicht Sie lesen – Ihre Listenansichten an und sonst nichts. Die anderen Typen beantworten jeweils eine andere Frage (eine Nachschlageansicht ist das Innere einer Auswahl, eine Kartenansicht ist ein einzelner Datensatz); ein Wechsel dorthin von einer Listenseite würde die Seite als etwas darstellen, das sie nicht ist. Verwendet werden sie trotzdem, nur von der Oberfläche, die nach ihnen fragt. Dieselbe Regel befolgt das Formular-Dropdown der Datensatzseite, das nur Hauptformulare anbietet.

Was im Hintergrund passiert​

Die Ansichtsdefinition wird als kanonische Definition gespeichert und gegen das Ansichtsschema geprüft. Jedes Feld, auf das eine Spalte, ein Filter oder eine Sortierung verweist, muss ein echtes Feld der Entität sein; eine Ansicht, die auf ein nicht vorhandenes Feld verweist, wird abgelehnt.

Fehlerbehebung​

  • „… is not defined on this entity.“ – Ein referenziertes Feld existiert nicht; fügen Sie es der Entität hinzu, oder entfernen Sie es aus der Ansicht.
  • „… must be lower snake-case and start with the publisher prefix.“ – Korrigieren Sie den logischen Namen der Ansicht.
  • „A form or view named … already exists on this entity.“ – Wählen Sie einen anderen logischen Namen.

Verwandte Szenarien​