Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Titel angepasst

Im Folgenden wird das Konzept hinter der Erstellung bzw. dem Vorlagenbau Bau von webbasierten webfähigen Vorlagen erklärt.

Falls Sie vorher classic-Vorlagen gebaut haben, lesen Sie hier kurz empfehlen wir Ihnen, dass Sie die Hauptunterschiede zwischen dem webfähigen und dem classic-Vorlagenbau nachdurchlesen, da sich die beiden Bauarten fundamental von einander unterscheiden: https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/293765124/Vorlagenerstellung+classic+vs.+webf+hig#Hauptunterschiede

...

Table of Contents
stylenone

...

Vorlagenerstellung: Konzept

Wie hier bereits beschrieben: bereits bei den Vorlagentypen (https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/36012061/Vorlagen+und+Vorlagentypen#Word-Vorlagen) beschrieben, werden Dokumente bei ihrer Erstellung in primedocs aus drei Ebenen zusammengestellt: dem Style, dem Layout und dem Inhalt.

Beim Erstellen von webfähigen Word-Vorlagen in primedocs stehen jedem Word-Vorlagentyp der entsprechenden Ebene gezielt Dokumentfunktionen zur Verfügung, welche . Diese Dokumentfunktionen ermöglichen die Dynamisierung der Vorlagen ermöglichen: dies Vorlage. Dies via Dateneingabemaske (Formulare (Forms)) und Felder (Fields), wobei letztere Text, Daten aus Connect- oder Select-Schnittstellen oder ganze Textabschnitte , bzw. (Textbausteine konditional ) einfügen können. So können einfache bis komplexe Anforderungen an Vorlagenstrukturen und Anwendungsfälle abgebildet werden.

Hier zu Beginn eine Übersicht aller Dokumentfunktionen pro Vorlagentyp:

Vorlagentyp

Verfügbare Dokumentfunktionen

Zweck der Dokumentfunktion

Style

Keine

Vererbt Formatvorlagen (engl.: Styles) beim Erstellen eines Dokuments

Layout

Platzhalterdefinition (PlaceholderDefinition)

Platzhalter definieren

Inhalt

Platzhalterzuordnung (PlaceholderMapping)

Die im Layout hinterlegten Platzhalter befüllen mit Daten aus anderen Dokumentfunktionen

Felder (Fields)

Verarbeiten von Daten aus Forms, Data, den globalen Konfigurationen und den globalen Übersetzungen

Formulare (Forms)

Definition der Dateneingabemaske, die beim Erstellen eines Dokuments erscheint

Data

Definition von Schemata für eine primedocs Connect Schnittstelle zur Verwendung in Fields.

...

Vorlagenerstellung: Prozess

Folgendes Vorgehen beim Erstellen von webfähigen Vorlagen hat sich bewährt:

1) Layoutvorlage erstellen

  1. In primedocs desktop eine neue Vorlage vom Typ “Layout” erstellen. Der Vorlageneditor öffnet sich.

  2. Unter “Basierend auf” im Dropdown die passende Stylevorlage auswählen. Im Idealfall gibt es nur pro primedocs-Lösung genau eine Stylevorlage.

  3. Dokumentfunktion Platzhalterdefinition anhängen

  4. Überlegen, was für dynamische Inhalte in Kopf- und Fusszeile gehören und entsprechend in der Platzhalterdefinition Platzhalter erstellen.

  5. Layoutvorlage im Word-Editor öffnen

  6. Die in der Platzhalterdefinition erstellten Platzhalter in den Kopf- und Fusszeilen platzieren. Platzhalter-Inhaltssteuerelemenete sind grün.

    image-20240906-081359.png
  7. Auf den Inhaltssteuerelementen für die Platzhalter den korrekten Style anwenden. Dieser Style wird ignoriert, wenn der Platzhalter in der Inhaltsvorlage mit einem Field vom Typ FormattedText oder WordContent gefüllt wird.

2) Inhaltsvorlage erstellen

  1. In primedocs desktop eine neue Vorlage vom Typ “Inhalt” erstellen. Der Vorlageneditor öffnet sich.

  2. Unter “Basierend auf” im Dropdown die neue Layoutvorlage auswählen.

  3. Die Dokumentfunktionen Platzhalterzuordnung (PlaceholderMapping), Formulare (Forms) und Felder (Fields) anhängen.

  4. Alle für diese Vorlage relevanten Forms-Felder (Dateneingabefelder) und Fields erstellen, die einen Platzhalter im Layout füllen sollen. Siehe dazu das Layouter-Handbuch: https://primesoft-group.atlassian.net/wiki/x/AQCRFw

  5. Platzhalterzuordnung: In der Inhaltsvorlage in der Dokumentfunktion Platzhalterzuordnung (PlaceholderMapping) jedem Platzhalter das entsprechende Forms-Feld oder Field zuordnen, mit dem der Platzhalter befüllt werden soll.

  6. Mittels “Dokument testen” prüfen, ob die korrekten Daten in der Kopf- und Fusszeile erscheinen.

  7. Inhaltsvorlage fertigstellen: Restliche Forms-Felder und Fields erstellen, die für den Inhalt der Inhaltsvorlage relevant sind - und laufend testen.