• Deutsch

      • Checkbox-Gruppe

      Einführung

      In NocoBase wird die Checkbox-Gruppe (Checkbox group) verwendet, um mehrere Werte aus einer Gruppe von Optionen auszuwählen und die Optionen direkt im Formular anzuzeigen.

      Checkbox-Gruppen eignen sich für Szenarien mit wenigen Optionen, bei denen mehrere Werte ausgewählt werden müssen. Ähnlich wie bei der Mehrfachauswahl aus einer Dropdown-Liste besteht der Hauptunterschied in der Art der Interaktion auf der Seite.

      Wenn es viele Optionen gibt, spart die Auswahl von Mehrfachauswahl aus einer Dropdown-Liste Platz. Wenn nur eine Option ausgewählt werden darf, verwenden Sie eine Radio-Button-Gruppe.

      Geeignete Einsatzszenarien

      Checkbox-Gruppen eignen sich für folgende Geschäftsszenarien:

      • Leistungsumfang und anwendbare Vertriebskanäle
      • Auswahl von Funktionsberechtigungen
      • Tags für Kundenanforderungen
      • Wenige feste Optionen zur Mehrfachauswahl

      Konfiguration erstellen

      Klicken Sie auf der Seite „Configure fields“ einer Datentabelle auf „Add field“ und wählen Sie „Checkbox-Gruppe“, um ein Feld vom Typ Checkbox-Gruppe zu erstellen. 20260709231244

      KonfigurationBeschreibung
      Field interfaceOberflächentyp des Feldes. Für eine Checkbox-Gruppe entspricht dieser checkboxGroup und legt fest, wie Werte auf der Seite eingegeben und angezeigt werden.
      Field display nameName, unter dem das Feld in der Benutzeroberfläche angezeigt wird, zum Beispiel „Leistungsumfang“, „Anwendbare Vertriebskanäle“ oder „Anforderungs-Tags“. Es wird empfohlen, einen Namen zu verwenden, den Fachanwender direkt verstehen.
      Field nameBezeichner des Feldes für interne Verweise in APIs, Beziehungsfeldern, Berechtigungen, Workflows und anderen Bereichen. Nach der Erstellung wird er normalerweise nicht mehr geändert. Er darf nur Buchstaben, Ziffern und Unterstriche enthalten und muss mit einem Buchstaben beginnen.
      Field typeDatentyp des Feldes auf Datenebene. Checkbox-Gruppen werden normalerweise als Array oder JSON gespeichert. Maßgeblich sind die Feldkonfiguration und die Fähigkeiten der Datenquelle.
      Default valueStandardwert. Beim Erstellen eines neuen Datensatzes kann dieser automatisch eingetragen werden, wenn der Benutzer keinen Wert angibt.
      Validation rulesValidierungsregeln. Üblicherweise werden hier Pflichtfeld und zulässiger Wertebereich festgelegt.
      DescriptionBeschreibung des Feldes. Hier können die Bedeutung des Feldes, Eingabeanforderungen, Datenquelle oder verantwortliche Person angegeben werden.
      Hinweis

      Der Feldname wird von Seitenblöcken, Berechtigungen, Workflows und APIs referenziert. Prüfen Sie die Benennung vor der Erstellung sorgfältig, um späteren Konfigurationsaufwand durch Änderungen zu vermeiden.

      Feldeigenschaften

      Das Feld „Checkbox-Gruppe“ verhält sich standardmäßig wie folgt:

      EigenschaftBeschreibung
      Standardmäßiges Field interfacecheckboxGroup.
      Standardmäßiges Field typearray.
      Zulässige Field typearray, json, abhängig von der tatsächlichen Feldzuordnung.
      SeitenkomponenteIm Bearbeitungsmodus wird eine Checkbox-Gruppe verwendet.
      FilterungUnterstützt die Filterung nach Datensätzen, die eine bestimmte Option enthalten.
      SortierungWird normalerweise nicht zur Sortierung verwendet.
      ValidierungUnterstützt Pflichtfeld- und Wertebereichsbeschränkungen.

      Konfiguration bearbeiten

      Klicken Sie nach der Erstellung rechts neben dem Feld auf „Edit“, um die Konfiguration des Felds „Checkbox-Gruppe“ zu bearbeiten. Die Bearbeitung dient hauptsächlich dazu, die Anzeige und Verwendung des Feldes in NocoBase anzupassen, beispielsweise durch Ändern des Anzeigenamens, der Beschreibung, des Standardwerts, der Validierungsregeln oder feldspezifischer Einstellungen.

      Wenn das Feld aus einer bereits mit der Hauptdatenbank synchronisierten Tabelle stammt, wird bei der Bearbeitung normalerweise eine Feldzuordnung vorgenommen – das Datenbankfeld wird einem Field type und einem Field interface von NocoBase zugeordnet.

      KonfigurationBearbeitbarBeschreibung
      Field display nameJaÄndert den Anzeigenamen des Feldes in der Benutzeroberfläche, nicht jedoch den Feldbezeichner.
      Field nameNeinDer Feldbezeichner kann nach der Erstellung normalerweise nicht im Bearbeitungsformular geändert werden.
      Field interfaceBedingtBei der Zuordnung von Feldern aus der Hauptdatenbank oder synchronisierten Feldern kann dieser Wert angepasst werden. Dies beeinflusst die Eingabe, Anzeige und Validierung auf der Seite.
      Field typeBedingtBei der Zuordnung von Feldern aus der Hauptdatenbank oder synchronisierten Feldern kann dieser Wert angepasst werden. Vor der Anpassung muss geprüft werden, ob vorhandene Daten mit dem neuen Typ verwendet werden können.
      Default valueJaPasst den Standardwert für neu erstellte Datensätze an.
      Validation rulesJaPasst die Validierungsregeln des Feldes an.
      DescriptionJaErgänzt die Bedeutung des Feldes, Eingabeanforderungen, Datenquelle oder verantwortliche Person.
      Hinweis

      Das Umschalten von Field type oder Field interface ist nicht gleichbedeutend mit einer einfachen Änderung des Anzeigenamens. Es beeinflusst die Speichermethode des Feldes, die Eingabekomponente, Validierungsregeln, Filterbedingungen sowie die Verwendung von Workflow-Variablen. Bei einer großen Menge vorhandener Daten muss zunächst geprüft werden, ob das Datenformat kompatibel ist.

      Feld löschen

      Klicken Sie rechts neben dem Feld auf „Delete“, um das Feld „Checkbox-Gruppe“ zu löschen. In der Hauptdatenbank können Sie außerdem mehrere Felder auswählen und gesammelt löschen.

      Beim Löschen eines neu erstellten Felds vom Typ Checkbox-Gruppe in der Hauptdatenbank werden normalerweise auch die entsprechende physische Spalte in der Datenbank und die darin vorhandenen Daten gelöscht. Beim Löschen eines aus einer Datenbank synchronisierten oder einer externen Datenquelle zugeordneten Felds hängt der Umfang der Auswirkungen von der jeweiligen Datenquelle und dem Ursprung des Felds ab.

      Warnung

      Das Löschen eines Feldes kann sich auf Seitenblöcke, Formulare, Filter, Berechtigungen, Workflows, APIs, Importe und Exporte sowie vorhandene Daten auswirken. Prüfen Sie vor dem Löschen, ob das Feld noch von geschäftlichen Konfigurationen verwendet wird.

      Verwendung in der Seitenkonfiguration

      Checkbox-Gruppen eignen sich dafür, wenige Optionen in einem Formular direkt anzuzeigen und mehrere davon auszuwählen. 20260709230421

      SzenarioVerwendung
      FormularblockZeigt alle Optionen direkt an und ermöglicht die Auswahl mehrerer Optionen.
      DetailblockZeigt mehrere Optionen als Tags oder Text an.
      FilterblockFiltert nach Datensätzen, die bestimmte Optionen enthalten.
      Workflows und BerechtigungenWerden zur Prüfung von Bedingungen wie „enthält“ oder „enthält nicht“ verwendet.