Mithilfe der Datensatzvorlagen können Datensätze auf Basis einer Strukturdefinition, Formularmaske oder auch anderen Tabelle erstellt werden. Sobald eine Datensatzvorlage für eine Datenbanktabelle defniert wurde, erscheint in der Toolbar der Datensatzliste die neue Schaltfläche " Mit Vorlage anlegen". Ein Klick auf diese Schaltfläche öffnet einen Modal mit den innerhalb der Vorlage definierten Eingabefeldern.

Zuordnen einer Datensatzvorlage

Eine Datensatzvorlage muss der gewünschten Zieltabelle über die Tabellenkonfiguration zugeordnet werden. Diese Konfiguration wird innerhalb der widget.json des Pakets hinterlegt.

Konfiguration in widget.json

{
  "name": "Example/Package",
  "tables": [
    {
      "identifier": "ExampleEntityIdentifier",
      // [...]
      "configuration": {
        // Einer der folgenden Angaben
        "FrameworkTemplateTemplate": "definition:[Pfad zur Strukturdefinition]",
        "FrameworkTemplateTemplate": "repository:[Identifikator der Tabelle]",
        "FrameworkTemplateTemplate": "mask:[ID der Formularmaske]"
      }
    }
  ],
  "relations": []
}

Definition einer Datensatzvorlage

Eine Datensatzvorlage kann eine Strukturdefinition, eine Formularmaske oder auch eine Datenbanktabelle sein. In allen Fällen muss allerdings den Eingabefeldern der Vorlage vorgegeben werden, wie diese sich in die Zieltabelle einfügen. Diese Konfiguration findet pro Eingabefeld in der entsprechend Feldkonfiguration statt.

Direkte Zuordnung von Eingabefeld aus Vorlage zu Eingabefeld in Zieltabelle

{
  "FrameworkTemplateTarget": "[Identifikator des Eingabefeldes in Zieltabelle]"
}

Zuordnung von Feldern einer Datensatzauswahl (ForeignKey) zu Feldern in Zieltabelle

{
  "FrameworkTemplateMapping": {
    "[Feld in Tabelle der Datensatzauswahl]": "[Feld in Zieltabelle]"
  }
}