Attribute Definitions

Definition der einzelnen Datenfelder für Digitale Produktpässe – Typen, Optionen und Konfiguration.

Attribute Definitions bilden das Kernstück des Datenmodells. Jede Definition beschreibt ein einzelnes Datenfeld, das an einem Digitalen Produktpass gepflegt werden kann. Hier wird festgelegt, welchen Typ ein Attribut hat, ob es durchsuchbar oder sprachabhängig ist und wie es angezeigt wird.

Der Bereich befindet sich unter Admin → Data Model → Attribute Definitions (/admin/attribute-definitions).

Listenansicht

Die Listenansicht zeigt alle Definitionen mit den Spalten Label, Key, Group, Type, List, Language Dependent, Display Area, Unique, Searchable, DPP Searchable und Order. Die Tabelle ist horizontal scrollbar.

UI-Elemente der Listenansicht

ElementBeschreibung
SprachfilterOben rechts – Dropdown zur Auswahl der Anzeigesprache
SuchfeldFiltert die Definitionen nach Name oder Key
"+ New" ButtonErstellt eine neue Attributdefinition
"Display" ButtonPasst die sichtbaren Spalten an
Horizontales ScrollenDie Tabelle kann seitwärts gescrollt werden, um alle Spalten zu sehen
Edit-Icon (Stift)Pro Zeile – öffnet die Detailansicht
PaginierungAm unteren Rand (z.B. 5 Seiten bei 90 Einträgen)

Detailansicht

Die Detailansicht zeigt alle Felder einer Attributdefinition.

Felder

FeldTypPflichtBeschreibung
ID (UUID)Text (auto)Automatisch generierte ID, z.B. 6977389a11a5d2ef2db511f8
KeyText-InputJaEindeutiger technischer Schlüssel, z.B. ATTRIBUT_EF000177
GroupDropdownJaZuordnung zu einer Attribute Group. Auswahl aus allen angelegten Gruppen
TypeDropdownJaDatentyp des Attributs (siehe Tabelle unten)
Is ListCheckboxNeinWenn aktiviert: Attribut kann mehrere Werte enthalten (Array)
UniqueCheckboxNeinWenn aktiviert: Wert muss systemweit eindeutig sein
SearchableCheckboxNeinWenn aktiviert: Attribut wird in der internen Admin-Suche berücksichtigt
DPP SearchableCheckboxNeinWenn aktiviert: Attribut wird auf der öffentlichen DPP-Seite durchsuchbar
Language DependentCheckboxNeinWenn aktiviert: Wert kann pro Sprache unterschiedlich gepflegt werden
Display AreaDropdownNeinBestimmt den Anzeigebereich (siehe unten)
OrderZahl-InputNeinSortierreihenfolge innerhalb der Gruppe
Label (per language)Text-Input (pro Sprache)NeinAnzeigename pro Sprache

Verfügbare Datentypen

TypBeschreibung
textFreitextfeld für beliebige Zeichenketten
numberNumerischer Wert (Ganzzahl oder Dezimalzahl)
dateDatumswert
booleanJa/Nein-Wert (Wahrheitswert)
documentDokument-Upload (Dateien wie PDF etc.)
imageBild-Upload (Bilddateien)
linkURL/Verlinkung

Display Areas

OptionBeschreibung
Attribute ListStandardanzeige in der Attributliste des Produktpasses
Quick AccessSchnellzugriff – prominentere Darstellung für häufig benötigte Attribute

Neue Attributdefinition anlegen

  1. Klicke auf den "+ New" Button in der Listenansicht.
  2. Vergib einen eindeutigen Key (z.B. ATTRIBUT_Gewicht).
  3. Wähle die zugehörige Group aus dem Dropdown.
  4. Wähle den passenden Type (z.B. number für numerische Werte).
  5. Konfiguriere die optionalen Flags:
    • Is List – für Mehrfachwerte
    • Unique – für systemweit eindeutige Werte (z.B. Artikelnummer)
    • Searchable / DPP Searchable – für die Durchsuchbarkeit
    • Language Dependent – für mehrsprachige Werte
  6. Wähle die gewünschte Display Area.
  7. Pflege die Labels pro Sprache über den Sprachfilter.
  8. Klicke auf "Save".
Der Key kann nach dem Erstellen nicht mehr geändert werden. Verwende ein konsistentes Namensschema (z.B. ATTRIBUT_<Bezeichnung>).

Beispieldaten (Auszug)

Label (DE)KeyGroupType
ArtikelnummerATTRIBUT_ArtikelnummerStammdatenText
GTINATTRIBUT_GTINStammdatenText
Gewicht Brutto kgATTRIBUT_EF000167Technische AttributeText
ProduktdatenblattATTRIBUT_ProduktdatenblattDokumenteDocument
GPSR-SicherheitshinweiseATTRIBUT_GPSRDokumenteDocument
AnwendungsbildATTRIBUT_AnwendungBilderImage
FreistellerbildATTRIBUT_FreistellerbildBilderImage