Direkt zum Hauptinhalt

Einer Entität ein Feld hinzufügen

Ziel​

Einer vorhandenen Entität ein Feld hinzufügen, damit ihre Datensätze eine weitere Angabe speichern können.

Voraussetzungen​

  • Sie sind mit einer Erstellerrolle (oder als Plattformadministrator) angemeldet.
  • Die Entität ist bereits vorhanden (siehe „Entität erstellen“).

Schritte​

  1. Öffnen Sie Tabellen, wählen Sie die Umgebung aus und wählen Sie in der Entitätsliste den Namen der Entität, um sie auf der Registerkarte Felder zu öffnen.

  2. Geben Sie den Anzeigenamen des neuen Felds ein (zum Beispiel Total).

  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 Eingabefeld angezeigt und automatisch vorangestellt – Sie tippen also nur den Rest: Aus total wird par_total.

    Das gilt auch für Standardtabellen. Account und Contact haben kein eigenes Präfix, weil Parsware sie mitliefert, aber eine Spalte, die Sie hinzufügen, gehört Ihnen: Sie heißt par_accountnumber, nicht accountnumber. Namen ohne Präfix gehören der Plattform, und ein selbst erfundener Name würde mit der nächsten Spalte kollidieren, die Parsware unter diesem Namen hinzufügt.

  4. Wählen Sie einen Datentyp. Es werden nur die Eingaben angezeigt, die für den gewählten Typ relevant sind:

    • Text – einzeiliger Text (Sie können eine Maximallänge festlegen; Standard ist 100).
    • Mehrzeiliger Text – langer Text.
    • Ganzzahl – ganze Zahlen.
    • Dezimalzahl – Festkommazahlen. Die Genauigkeit ist die Gesamtzahl der Ziffern; die Dezimalstellen geben an, wie viele davon nach dem Komma stehen. Mit 12 und 2 lassen sich also Werte bis 9.999.999.999,99 speichern, mit 2 und 2 dagegen nichts über 0,99. Standard ist 18 und 2 – genau das Richtige für Geldbeträge, sofern Sie es nicht besser wissen.
    • Boolesch – wahr/falsch.
    • Datum/Uhrzeit – ein Datum mit Uhrzeit.
    • Nachschlagefeld – ein Verweis auf den Datensatz einer anderen Entität; wählen Sie die Zielentität (die Entität selbst steht nicht zur Auswahl). Wenn Sie ein Nachschlagefeld hinzufügen, wird automatisch die 1:n-Beziehung zwischen den beiden Entitäten erstellt – Sie legen die Beziehung nicht separat an (siehe „Beziehung zwischen Entitäten erstellen“).
    • Nachschlagefeld (mehrere Tabellen) – ein Verweis auf einen Datensatz in einer von mehreren Tabellen: ein Kunde, der ein Account oder ein Contact sein kann. Aktivieren Sie mindestens zwei Tabellen; das Feld speichert dann neben der ID, in welcher Tabelle der Datensatz liegt. Es hat keinen Fremdschlüssel – das ist das Einzige, worauf es im Gegenzug verzichtet. Siehe Nachschlagefeld für mehrere Tabellen hinzufügen.
    • Automatische Nummer – eine Referenznummer, die die Plattform jedem neuen Datensatz gibt, etwa CR-2026-00417. Ihre einzige Einstellung ist das Nummernformat, mit Vorschau beim Tippen; niemand tippt den Wert, daher gibt es kein Kästchen erforderlich. Siehe Datensätze automatisch nummerieren.

  5. Markieren Sie das Feld optional als erforderlich.

  6. Wählen Sie Feld hinzufügen.

  7. Das Feld erscheint in der Feldliste der Entität, und seine Spalte existiert bereits – danach müssen Sie nichts weiter tun.

Was im Hintergrund passiert​

Das Feld wird als Metadaten der Entität gespeichert, und seine Spalte wird im selben Schritt der Datentabelle hinzugefügt. Das Feld ist also in dem Moment aktiv, in dem Sie es hinzufügen: Platzieren Sie es auf einem Formular, und App-Benutzer können es ausfüllen. Ein Nachschlagefeld verweist über den logischen Namen auf eine andere Entität und wird zu einem echten Verweis (Fremdschlüssel) auf sie.

Kann die Spalte nicht erstellt werden, wird das Feld wieder entfernt und der Fehler gemeldet – hinter einem Feld in dieser Liste steht also immer eine Spalte. Siehe Was passiert, wenn Sie eine Tabelle speichern.

Ein Feld bearbeiten​

Aktivieren Sie das Kontrollkästchen des Felds und wählen Sie Bearbeiten. Ändern können Sie:

  • Anzeigename – die Beschriftung überall, wo das Feld angezeigt wird. Umbenennen ist unbedenklich: Alles, was das Feld verwendet, verweist über seinen logischen Namen darauf, und der ändert sich nicht.
  • Erforderlich – ob das Feld auf Formularen standardmäßig erforderlich ist. Das ist eine Formular-Regel, keine Datenbankeinschränkung: Jede Spalte akzeptiert einen leeren Wert, und ein Formular kann die Einstellung für eine einzelne Platzierung trotzdem überschreiben (siehe Feld auf einem Formular als erforderlich oder schreibgeschützt festlegen). Das Einschalten macht also nie einen vorhandenen Datensatz ungültig.
  • Maximallänge (Text) bzw. Genauigkeit und Dezimalstellen (Dezimalzahl) – die Größe des Felds. Lassen Sie ein Eingabefeld leer, um den aktuellen Wert zu behalten.

Nicht ändern können Sie den logischen Namen des Felds, seinen Datentyp und – bei einem Nachschlagefeld oder einem Optionssatz-Feld – worauf es verweist. Diese Angaben werden angezeigt, sind aber gesperrt, weil alles, was das Feld verwendet, über den Namen darauf verweist und seine Spalte bereits Daten eines bestimmten Typs enthält; die Werte darin wurden gegen das aktuelle Ziel bzw. den aktuellen Satz validiert. Um eine dieser Angaben zu ändern, löschen Sie das Feld und fügen Sie es erneut hinzu.

Die Größe eines Felds zu ändern ist eine echte Änderung an der Datentabelle, weil seine Spalte bereits existiert. Ein Textfeld zu verlängern funktioniert immer. Es zu verkürzen schlägt fehl, wenn ein Datensatz bereits einen längeren Wert enthält – das Speichern meldet den Fehler, statt abzuschneiden, was jemand eingegeben hat. Vergrößern Sie das Feld stattdessen, oder bereinigen Sie zuerst die Daten.

Ein Feld löschen​

Aktivieren Sie das Kontrollkästchen des Felds und wählen Sie Löschen. Das Feld wird auch aus jedem Formular und jeder Ansicht der Tabelle entfernt, die es verwendet haben, sodass nichts auf ein Feld verweist, das nicht mehr existiert. Sie müssen nicht selbst jedes Formular und jede Ansicht aufsuchen. Wenn Sie ein Nachschlagefeld löschen, wird auch die Beziehung entfernt, die es erstellt hat – ein gelöschtes Nachschlagefeld hinterlässt also nie eine verwaiste Beziehung.

Drei Dinge, die Sie vor dem Löschen wissen sollten:

  • Ein leer gewordener Abschnitt bleibt bestehen. Nur das Feld wird entfernt – der Abschnitt, die Zeile oder die Registerkarte, in die Sie es gesetzt hatten, bleibt und steht für etwas anderes bereit.
  • Eine Ansicht ohne Spalten zeigt ersatzweise die Primärspalte der Tabelle. Eine Ansicht muss etwas anzeigen.
  • Eine Ansicht, die nach dem Feld gefiltert hat, zeigt mehr Datensätze als vorher. Der Filter verschwindet mit dem Feld, weil sich ein Filter nicht auf ein Feld anwenden lässt, das nicht mehr existiert. Wenn eine Ansicht dazu da ist, Datensätze anhand dieses Felds auszublenden, prüfen Sie sie anschließend.

Das Primärfeld der Tabelle kann nicht gelöscht werden. Die Datenspalte selbst bleibt in der Tabelle erhalten – das Löschen des Felds entfernt es aus der App, nicht die gespeicherten Daten.

Fehlerbehebung​

  • Ich habe ein Feld hinzugefügt, aber es erscheint nicht in der App. – Die Spalte existiert, sobald das Feld hinzugefügt ist, aber ein Feld wird nur dort angezeigt, wo es platziert ist. Fügen Sie es dem Formular oder der Ansicht hinzu, die Sie gerade betrachten.
  • „… must be lower snake-case and start with the publisher prefix.“ – Der logische Name des Felds muss mit {prefix}_ beginnen.
  • „… must be namespaced by your publisher's prefix.“ – Das Feld wurde ganz ohne Präfix gesendet. Nur die eigenen Standardspalten von Parsware haben kein Präfix; alles, was Sie hinzufügen, trägt das Präfix Ihres Herausgebers, auch auf einer Standardtabelle.
  • „A field named … already exists on this entity.“ – Wählen Sie einen anderen logischen Namen; Feldnamen sind innerhalb einer Entität eindeutig.
  • „The lookup target entity … was not found.“ – Erstellen Sie zuerst die Zielentität, oder korrigieren Sie das ausgewählte Ziel.
  • „Text maxLength must be between 1 and 4000.“ / „Decimal precision/scale is out of range.“ – Passen Sie die Länge bzw. Genauigkeit/Dezimalstellen an den zulässigen Bereich an.
  • Beim Speichern eines Datensatzes heißt es, eine Zahl „must have at most 0 digits before the decimal point“. – Die Genauigkeit des Felds zählt alle Ziffern, nicht die Nachkommastellen. Ein Feld für Beträge mit zwei Nachkommastellen braucht Genauigkeit 12 und 2 Dezimalstellen; Genauigkeit 2 mit 2 Dezimalstellen ist eine Spalte, die nichts über 0,99 aufnimmt. Der Datentyp lässt sich nachträglich nicht ändern, Genauigkeit und Dezimalstellen aber schon: Wählen Sie das Feld aus, drücken Sie Bearbeiten und vergrößern Sie es.
  • „Bearbeiten“ ist für ein Feld nicht verfügbar. – Bearbeiten erfordert, dass genau ein Feld ausgewählt ist, und die eigenen Systemfelder der Plattform (Erstellt am, Geändert von usw.) sind nicht bearbeitbar: Sie gehören der Plattform, nicht Ihrer Tabelle.
  • Beim Verkürzen eines Felds wird „value too long for type …“ gemeldet. – Ein Datensatz enthält bereits einen Wert, der länger ist als die neue Länge. Die Änderung wird abgelehnt, statt den Wert abzuschneiden. Vergrößern Sie das Feld stattdessen, oder kürzen Sie zuerst die betroffenen Datensätze.

Verwandte Szenarien​