Print-Element programmieren

Dateien / Methoden

view config.json

config.json

{
    "coreType": "print-core",
    "friendlyName": {
        "de": "Name",
        "en": "Name"
    },
    "extra": {
        "print": {
            "source": "EntityIdentifier",
            "template": "TemplateIdentifier",
            "types": [
                "element"
            ],
            "children": [],
            "parents": [
                "content",
                "container",
                "column"
            ],
            "variants": [
                "content-neutral"
            ]
        }
    }
}

Die config.json dient zur Konfiguration des Elements im Context des PrintDesigners. Damit das Element gefunden wird, muss eine config.json mit den coreType print-core in dem view-Ordner (src/View/MyView/views/myviewelement/config.json) existierten.

Die Konfiguration für die Print-Themen werden in extra→print erwartet.

Key	Beschreibung
source	(optional) Hier wird der EntityIdentifier der Tabelle für den Quelldatensatz erwartet. Es wird davon ausgegangen, dass das Plugin selbst diese Entity in Lib/Entity definiert.
template	(optional) Es kann eine Datensatzvorlage für dieses Element hinterlegt werden. Falls dieser Key befüllt wurde, wird beim Modal für das Erstellen auch die Option angeboten, den Datensatz mit der Datensatzvorlage neu anzulegen.
types	Keywords, die von children und parents verwendet werden können. Diese Option beschreibt das Element. Gebräuchliche Keywords sind: element → ein Inhaltselement ohne Kindelement. Zum Beispiel Text, Bild oder Abstand. container → Ein Element, welcher Unterelemente wie Spalten erlaubt. Zum Beispiel Container. column → Eine Element, welches nur in einen Container platziert werden darf. Zum Beispiel Spalte. page → Ein Element, welches auf oberster Ebene erlaubt ist und direkt zum Inhalt (PrintPage) verknüpft werden darf. Zum Beispiel die Seitenbereiche Kopfbereich, Seiteninhalt oder Fußbereich.
children	Keywords, die definieren, welche Elemente als Kinder des Elements erlaubt werden.
parents	Keywords, die definieren, in welches Element das Element erlaubt wird.
variants	Die css-Variante für den designer-node aus, zum Beispiel, admin-styleguide/component/designer-core/_layout.scss. Gängige Varianten sind: header-primary, header-secondary content-default, content-neutral

Source

Für die Daten des Views sollte eine Entity erstellt werden. Beim Erstellen eines Elements werden dann die Datensätze aus dieser Tabelle zur Auswahl angeboten. Mit dieser Entity wird dann auch beim Verarbeiten des Views gearbeitet.

Hinweis: Im cms werden diese Daten in einer Structure.json definiert und dann in der odm-Spalte des Views gespeichert. Hier wird stattdessen eine tatsächliche Entity erwartet.

Template

Es kann eine Datensatzvorlage für dieses Element hinterlegt werden. Der eingetragene Identifier für das Template sollt dann auch ein Template definiert haben und dieses in der widget.json hinterlegt sein.

Template in widget.json

// Auf Tabellenebene
"configuration": {
    "FrameworkTemplateTemplate": {
        "TemplateIdentifier": "definition:plugin/remote/brandbox/print-layout-standard/src/View/MyView/Lib/Structure/MyViewemplateDefinition.json"
    }
},