<
Template Dev in ContentCreator, 2024.12
Template Dev in ContentCreator, 2024.12
Dokumentation

Benutzerdokumentation – Vorlagenentwicklung für den ContentCreator

Konzept

Die Vorlagenentwicklung für den ContentCreator richtet sich in erster Linie an Projektentwickler, die einfache Entwicklungsaufgaben schnell und bequem aus dem ContentCreator heraus erledigen wollen.

Dazu gehören vor allem kleinere Änderungen in den Formularen, das Anpassen von Regeln oder die Fehlerbehebung in den Ausgabekanälen.

Die Vorlagenentwicklung für den ContentCreator ersetzt die entsprechende Funktionalität im SiteArchitect nicht. Sie ist explizit nicht dafür gedacht, dies zu ermöglichen.

Eigenschaften in der Vorlage

Sie können die folgenden Eigenschaften einer Vorlage bearbeiten:

Überblick

Dialogfenster

Sie können die Vorlage einer Seite, einem Absatz oder eines Datensatzes über die Toolbar erreichen und bearbeiten:

Vollbild-Ansicht

Über die Hauptleiste des ContentCreators erreichen Sie die Vollbild-Ansicht der Vorlagenentwicklung für den ContentCreator. In der Vollbild-Ansicht können Sie Vorlagen anlegen und verschieben, Ordner verwalten und sämtliche Vorlagen bearbeiten, auch wenn sie nicht über die Vorschau erreichbar sind (z. B. Linkvorlagen, Formatvorlagen).

Wenn Sie an der geöffneten Vorlage Änderungen vorgenommen haben, die noch nicht gespeichert sind, wird die nächste Vorlage in einem neuen Tab geöffnet. So ist ein paralleles Bearbeiten mehrerer Vorlagen möglich.

Medien-Verwaltung

Textdateien können Sie direkt in der Medienverwaltung bearbeiten.

→ Für das Bearbeiten der Textdatei-Medien wird ein Fenster geöffnet. Hier können Sie die Datei direkt bearbeiten.

Auch das Bearbeiten von sprachabhängigen Textdatei-Medien wird unterstützt.

Aktionen

FirstSpirit Online-Hilfe

Die FirstSpirit Online-Hilfe steht Ihnen sowohl im SiteArchitect als auch in der Vorlagenentwicklung im ContentCreator zur Verfügung. Dadurch können Sie Dokumentation zu Schlüsselbegriffen in Vorlagen oder HTML-Code direkt aufrufen.

In einer Vorlage oder in einem HTML-Code:

  • Markieren Sie ein Schlüsselwort.
  • Klicken Sie mit der rechten Maustaste auf den markierten Bereich.
    → Ein Kontextmenü wird geöffnet.

    Alternativ: Drücken Sie die F1-Taste.
  • Klicken Sie auf "FirstSpirit Hilfe öffnen".
    → Die Dokumentation zum markierten Schlüsselwort wird in einem neuen Browser-Tab geöffnet.

Formular

Im Bereich Formular können Sie Formulare erstellen oder bearbeiten. Hierfür sind drei Anzeige-Arten verfügbar:

Nur GOM-UI

Parallelansicht: GOM-UI und XML-Editor

Nur XML-Editor

Die ausgewählte Ansicht wird gespeichert. Die Einstellung bezieht sich auf den aktuellen Server und wird im Browser-Cache abgelegt.

GOM-UI

In der Ansicht GOM-UI bzw. in der Parallelansicht GOM-UI und XML-Editor können Sie neue Eingabekomponenten aus der Liste Verfügbare Komponenten auf der linken Seite in das Formular auf der rechten Seite mit Drag&Drop einfügen und Eingabekomponenten innerhalb des Formulars verschieben:

Im GOM-UI können Sie nur die Bezeichnungen von Eingabekomponenten ändern:

  • Klicken Sie in der Parallelansicht GOM-UI und XML-Editor auf eine Eingabekomponente.
    → Der zur Eingabekomponente gehörende XML-Bereich wird im XML-Editor hervorgehoben.

Vorgabewerte

Sie können Vorgabewerte für Eingabekomponenten definieren und bearbeiten.

  • Rückgriffwerte werden als Vorbelegung genau dann angewendet, wenn kein Wert in der Eingabekomponente gespeichert wurde und für eine Sprache kein Vorbelegungswert definiert wurde.
  • Standardwerte können je Sprache definiert werden.

Formular-Vorschau

  • Klicken Sie auf Vorschau öffnen.
    → Ein Pop-Up wird geöffnet. Hier können Sie das Formular der Vorlage und Ihre Änderungen vor dem Speichern prüfen.

Auto-Vervollständigung im XML-Editor

  • Tippen Sie auf Strg+Leertaste, während Sie ein Formular oder eine Regel bearbeiten.
    → Code-Vorschläge mit den möglichen Eingabekomponenten und Definitions-Tags werden angezeigt und können ausgewählt werden.

Regeln

Ein Vorlagenentwickler kann über die Definition von Regeln innerhalb der (Formular)-Vorlage bestimmte Elemente oder Eigenschaften des Formulars beeinflussen und so ein „Dynamisches Formular“ erstellen.

Gängige Anwendungsfälle können mit den Regelbeispielen einfach eingepflegt werden.

Ausgabekanal

Emmet Coding für HTML-Ausgabekanäle und CSS-Medien-Dateien

Emmet coding ist eine verkürzte Syntax zum schnellen und effizienten Schreiben von HTML und CSS. Es ermöglicht Entwicklern, Code mit weniger Tastenschlägen zu erzeugen.

Beispiel:

  • Tippen Sie auf Strg+Leertaste, während Sie einen Ausgabekanal bearbeiten.
    → Code-Vorschläge zur FirstSpirit-Vorlagensprache und HTML werden angezeigt und können ausgewählt werden.

Ergebnis:

<ul id="nav">
 <li class="item1">
   <a href="">Item 1</a>
 </li> 
 <li class="item2">
   <a href="">Item 2</a>
 </li>
 <li class="item3">
   <a href="">Item 3</a>
 </li>
</ul>

Tabellenvorlagen erweitern

  • Klicken Sie im Bereich Mapping auf Neue Datenbankspalte anlegen.
    → Ein Pop-Up mit der Konfiguration der Spalte wird geöffnet.

Sie können eine Verknüpfung mit einem Formularfeld herstellen, auch wenn das Formularfeld neu hinzugefügt wurde:

  • Klicken Sie im Bereich Mapping auf Neue Datenbankspalte anlegen.
  • Wählen Sie im Feld Spaltentyp den Typ String aus.
  • Wählen Sie im Feld Formularfeld die Komponente aus, mit der die Spalte verknüpft werden soll.

Verwenden Sie zum Löschen von Spalten den SiteArchitect.

Ordner und Vorlagen verwalten

In der Vollbild-Ansicht können Sie Ordner und Vorlagen neu anlegen, duplizieren und löschen.

Sie können nur leere Ordner löschen.
Sie können Vorlagen nur löschen, wenn sie nicht verwendet werden.

Sie können Ordner und Vorlagen in dieser Ansicht mit Drag&Drop verschieben.

Referenzen öffnen

  • Wechseln Sie in den Ausgabekanal.
  • Tippen Sie auf F3.
    Alternativ: Klicken Sie auf Jump to reference im Kontextmenü.
    → Wenn Textdatei-Medien referenziert sind, wird ein Fenster geöffnet. Hier können Sie die Datei direkt bearbeiten.

Suche

In der Vollbildansicht können Sie in sämtlichen Vorlagen suchen:

  • Es wird nicht zwischen Groß- und Kleinschreibung unterschieden.
  • Eine Volltextsuche wird ausgeführt. Nur exakte Suchbegriffe werden angezeigt.
  • Wenn ein Suchergebnis den Suchtext innerhalb der Vorlage anzeigt – Formular, Regeln oder Ausgabekanäle – wird beim Anklicken des Suchergebnisses der Tab geöffnet, in dem der Suchtext vorkommt und die richtige Stelle im Tab angezeigt. Der Suchbegriff wird farbig hervorgehoben. Alle Tabs, in denen der Suchtext vorhanden ist, werden fett markiert.

Integration mit verteilter Vorlagenentwicklung

Für FirstSpirit-Projekte, die über die verteilte Vorlagenentwicklung mit Git entwickelt werden, gibt es einen zusätzlichen Funktionsumfang: In der Vollbild-Ansicht werden Informationen zum aktuellen Projekt und Links auf Bamboo-Pläne des Projekts angezeigt. Beim Ausführen dieser Bamboo-Pläne wird der Stand des FirstSpirit-Projekts auf dem Server mit dem Stand des Projekts im Git-Repository synchronisiert.

  • Im Bereich Änderungen werden Informationen zum aktuellen Projektstand im Git angezeigt.
  • Im Bereich Entwicklung & Operationen werden die Links zu Bamboo-Plänen angezeigt.

Arbeitsabläufe

Sie können Arbeitsabläufe direkt im ContentCreator sowie im SiteArchitect modellieren, bearbeiten, umbenennen, und duplizieren.

Weitere Informationen zur Bearbeitung von Arbeitsabläufen im SiteArchitect finden Sie in der FirstSpirit Entwickler Dokumentation.

Erstellung eines Arbeitsablaufs

Die Erstellung eines Arbeitsablaufs im ContentCreator ist fast identisch zur Erstellung im SiteArchitect:

  • Klicken Sie im Seitenmenü der Vorlagenentwicklung im ContentCreator (Vollbild-Ansicht) im Kontextmenü des gewünschten Arbeitsablauf-Ordners auf Neuen Arbeitsablauf anlegen.
  • Vergeben Sie einen eindeutigen Anzeige- und Referenznamen. Diese werden dem Redakteur bei der Ausführung des Arbeitsablaufs angezeigt.
  • Klicken Sie auf Speichern.

Ist ein Arbeitsablauf erstellt, können Sie diesen löschen, umbenennen, duplizieren oder sich den SiteArchitect-Link anzeigen lassen:

  • Im Seitenmenü der Vorlagenentwicklung im ContentCreator klicken Sie auf den gewünschten Arbeitsablauf.
    → Ein Kontextmenü wird geöffnet.
  • Wählen Sie die gewünschte Aktion aus.

Bearbeitung eines Arbeitsablaufs

Zur Bearbeitung eines Arbeitsablaufes im ContentCreator stehen Ihnen verschiedene Register zur Verfügung:

Nur die Verwendung des Zustandsdiagramms im ContentCreator weicht leicht von der Verwendung im SiteArchitect ab. Sie können alle anderen Registerkarten im ContentCreator und SiteArchitect identisch verwenden.
Register Zustandsdiagramm

In der Registerkarte Zustandsdiagramm, haben Sie die Möglichkeit Arbeitsabläufe mit Hilfe eines grafischen Editors zu modellieren.

Innerhalb des Editors stehen Ihnen drei Objekttypen zur Verfügung:

Modellierung eines Arbeitsablaufs mithilfe des Zustandsdiagramms:

  • Anlegen einer Aktivität oder eines Status: Klicken Sie mit der rechten Maustaste auf einen beliebigen Bereich im Editor. Es erscheint ein Kontextmenü. Über die entsprechende Option können Sie einen Status oder eine Aktivität anlegen.
  • Löschen einer Aktivität, eines Status, oder einer Transition: Klicken Sie mit der rechten Maustaste auf das gewünschte Element. Es erscheint ein Kontextmenü. Wählen Sie die entsprechende Option.
  • Bearbeiten eines Objekts: Doppelklicken Sie auf das gewünschte Objekt. Ein neues Fenster wird geöffnet.
  • Erstellen einer Transition: Klicken Sie auf das Plus-Symbol das beim Hovern über einen Status oder eine Aktivität erscheint. Halten Sie es gedrückt und ziehen Sie den erscheinenden Pfeil zum gewünschten Ziel.

Datenbank-Schemata

Sie können Datenbank-Schemata direkt im ContentCreator modellieren und bearbeiten.

Sie können Datenbank-Schemata nur im SiteArchitect löschen.

Im ContentCreator werden Tabellen eines Datenbank-Schemas in Listenform angezeigt. Informationen zur jeweiligen Tabelle werden in Tabellenform präsentiert. Der FirstSpirit Schema-Editor wird im ContentCreator nicht unterstützt.

Neues Schema anlegen

  • Klicken Sie im Seitenmenü der Vorlagenentwicklung im ContentCreator im Kontextmenü der Datenbank-Schemata auf Schema anlegen.
    Vorlagen > Datenbank-Schemata > Schema anlegen

    Alternativ: Kicken Sie auf Schema aus Datenbank erzeugen, um einen Schema-Knoten auf Basis vorhandener Tabellen und Beziehungen einer Datenbank zu erzeugen.
  • Geben Sie Referenznamen und Datenbank-Layer an.
  • Klicken Sie auf Speichern.
    → Ein neuer Schema-Knoten wurde erzeugt.

Neue Tabelle und Spalte anlegen

  • Klicken Sie auf ein Datenbank-Schema.
  • Klicken Sie auf Tabelle hinzufügen.
  • Tragen Sie einen Tabellennamen im gleichnamigen Feld ein.
  • Klicken Sie auf Übernehmen.
    → Eine neue Tabelle wird erstellt.
  • Optional: Sie können eine Tabelle umbenennen oder löschen:
  • Klicken Sie auf Spalte hinzufügen.
  • Geben Sie die notwendigen Informationen an.
  • Klicken Sie auf Übernehmen.
    → Eine neue Spalte wurde angelegt.
  • Klicken Sie auf Änderungen speichern.

Wenn das Projekt geschlossen wird, bevor Sie Ihre Änderungen speichern, werden alle Elemente, die Sie nach dem letzten Speichern hinzugefügt haben, verworfen.

Fremdschlüsselbeziehung anlegen

  • Wählen Sie eine Tabelle eines Datenbank-Schemas aus.
  • Klicken Sie auf Fremdschlüssel hinzufügen.
  • Geben Sie die notwendigen Informationen zum Erstellen einer Fremdschlüsselbeziehung an.
  • Klicken Sie auf Übernehmen, um den Vorgang abzuschließen.
    → Die Fremdschlüsselbeziehungen werden als Links gekennzeichnet. Beim Anklicken gelangen Sie zur verknüpften Tabelle.
  • Klicken Sie auf Änderungen speichern.

Datenbank-Abfragen

Im ContentCreator können Sie Datenbank-Abfragen erstellen und anpassen.

Verwendungsbeispiel: Zum Erstellen von zwei Nachrichten-Übersichtsseiten mit unterschiedlichen, dynamischen Inhalten, wird eine Datenbank-Abfrage verwendet.
Die Abfrage filtert die Tabelle "Nachrichten" nach der Kategorie "Firmennachrichten" bzw. "Branchennachrichten".

Neue Abfrage erstellen

  • Klicken Sie im Seitenmenü der Vorlagenentwicklung im ContentCreator im Kontextmenü eines Schemas auf Neue Abfrage anlegen.
    Vorlagen > Datenbank-Schemata > [Schema-Bezeichnung]
  • Wählen Sie die Ergebnistabelle aus und speichern Sie die Abfrage.
    → Die Abfrage erscheint unter dem Namen [Schema-Bezeichnung].[Referenzname] in der Menüstruktur des Schemas. Die Abfrage wird sofort geöffnet.

Abfrage bearbeiten

  • Wählen Sie im Seitenmenü der Vorlagenentwicklung im ContentCreator die benötigte Abfrage aus.
    Vorlagen > Datenbank-Schemata > [Schema-Bezeichnung]
    → Die Abfrage wird geöffnet.
  • Im Tab Bedingungen können Sie die Abfrage in der grafischen Ansicht Verknüpfungsassistent einsehen und bearbeiten.
  • Im Tab Parameter können Sie die Werte von Parametern festlegen, welche im Tab Bedingungen verwendet werden.
  • Im Tab Ergebnisse sehen Sie die Ergebnisse der Abfrage.
    Optional: Klicken Sie doppelt auf ein Ergebnis, um dessen Detailansicht zu öffnen.
    Optional: Aktivieren Sie das Häkchen Veröffentlichungsstand, um die Ergebnisse der Abfrage einzuschränken: Nur veröffentlichte Ergebnisse werden angezeigt.

In der Ansicht Quellcode im Tab Bedingungen können Sie das XML – und damit sämtliche Einstellungen der Abfrage – manuell bearbeiten.
Die Ansicht Verknüfungsassistent dient der Veranschaulichung und Erstellung einfacher Datenbank-Abfragen. Komplexe Abfragen, die nicht in der grafischen Ansicht abgebildet werden können, sollten direkt in der Ansicht Quellcode erstellt werden.

Generierungslog

In der Vollbild-Ansicht und im Dialogfenster können Sie im Tab Generierungslog Daten zur Generierung von Seiten-, Absatz- und Tabellenvorlagen einsehen.

Der Generierungslog besteht aus zwei Bereichen:

  • Rendering log
    Hier finden Sie potenzielle Formular-spezifische Fehlermeldungen und Warnungen. Über die angeführten Links gelangen Sie direkt in die entsprechende Zeile eines Formulars.
  • Profiling log
    In dieser Tabelle finden Sie Formular-spezifische Informationen zur Anzahl der Ausführungen (Count) und Render-Zeit (Total Amount, Min, Max, Average in Millisekunden). Klicken Sie auf den Formular-Namen in der Spalte Name, um direkt zum Formular zu gelangen.

Die Informationen im Generierungslog beziehen sich in der Vollbild-Ansicht auf die Formular-Vorschau, die im SiteArchitect ausgewählt ist. Im Dialogfenster beziehen sich die angezeigten Informationen auf die aktuell im ContentCreator angezeigte Vorschau.

Für Projekte mit mehr als einem Ausgangskanal können Sie die Informationen für spezifische Ausgabekanäle abrufen:

  • Öffnen Sie ein Formular in der Vorlagenentwicklung für den ContentCreator.
  • Wählen Sie den entsprechenden Ausgangskanal im Drop-Down-Menü aus.

    → Der Generierungslog wird spezifisch für den ausgewählten Ausgangskanal angezeigt.

Versionshistorie

In der Versionshistorie können Sie verschiedene Stände einer Vorlage einsehen und miteinander vergleichen.

Die Versionen werden mit einer Datums- und Zeitangabe, dem Bearbeiter und unterschiedlichen Status-Icons angezeigt:

Erste Version

Bearbeitete Version

Wiederhergestellte Version

Filtern

  • Klicken Sie auf die Checkbox Nur eigene Revisionen anzeigen.
    → Nur Versionen werden angezeigt, die Sie selbst gespeichert haben.

Vergleichen unterschiedlicher Versionen

Vergleichen mit aktueller Version

  • Klicken Sie eine Version an.
    → Die Version ist ausgewählt.
  • Klicken Sie auf den Button Mit aktuellster Version vergleichen.
    → Ein Pop-Up wird geöffnet. Die ausgewählte und die aktuelle Version werden nebeneinander angezeigt. Die Unterschiede zwischen den Versionen werden hervorgehoben.

Vergleichen zweier Versionen

  • Klicken Sie eine Version an.
    → Die Version ist ausgewählt.
  • Klicken Sie eine zweite Version an, während Sie Strg oder Shift gedrückt halten.
    → Die zweite Version ist ausgewählt.
  • Klicken Sie auf Vergleichen.
    → Ein Pop-Up wird geöffnet. Die ausgewählten Versionen werden nebeneinander angezeigt. Die Unterschiede zwischen den Versionen werden hervorgehoben.

Zum Deselektieren einer ausgewählten Version klicken Sie eine andere Version an. Alternativ: Drücken und halten Sie Strg und klicken Sie dieselbe Version nochmal an.
Im Pop-Up werden nur die Tabs angezeigt, in denen es Unterschiede zwischen den Versionen gibt.
Im Pop-Up können Sie keine Änderungen vornehmen.

Wiederherstellen einer Version

  • Fahren Sie mit der Maus über eine Version.
  • Klicken Sie auf .
  • Bestätigen Sie im Pop-Up mit Bestätigen.
    → Die Version wird in der Historie an der ersten Position und mit dem aktuellen Zeitstempel angezeigt.

Sie können das Wiederherstellen einer Version nicht rückgängig machen. Sie können aber anschließend eine andere Version wiederherstellen, die aktueller ist, als die soeben wiederhergestellte Version.

DQM-Analyse für Vorlagen

Diese Funktionalität ist lizenzabhängig. Sie können die DQM-Analyse für Vorlagen nur mit einer gültigen DQM Connect-Lizenz nutzen.

Sie können sowohl in der Vollbildansicht als auch im Dialogfenster die Vorlagen eines Projekts mit DQM analysieren. Problemstellen in Vorlagen sind somit im DQM-Report leicht ersichtlich und Sie können diese per Mausklick erreichen.

Sie können die DQM-Analyse für Vorlagen in den folgenden Bereichen ausführen:

Um eine Vorlage mit DQM in der Vollbild-Ansicht oder im Dialogfenster zu analysieren:

  • Öffnen Sie eine Vorlage in der Vorlagenentwicklung für den ContentCreator in der Vollbild-Ansicht.
    Alternativ: Öffnen Sie eine Vorlage im Dialogfenster.
  • Klicken Sie auf das DQM-Analyse-Symbol um die Analyse zu starten.
    → Einträge die mit oder gekennzeichnet sind markieren hervorhebbare Problemstellen in Vorlagen.
  • Gibt es für einen Eintrag konkrete Checkpoints, können Sie den Eintrag mit ausklappen.
    → Es werden Referenzname und Zeilennummer der betroffenen Vorlage angezeigt.
  • Klicken Sie auf den Referenznamen um direkt zur betroffenen Vorlage und Zeile zu gelangen.
    → Befinden Sie sich in der Vollbildansicht und die betroffene Vorlage ist nicht die aktuell geöffnete, wird ein neuer Tab mit der betroffenen Vorlage geöffnet. Befinden Sie sich im Dialogfenster, wird ein neues Dialogfenster geöffnet.
  • Bewegen Sie den Mauszeiger über das Symbol oder
    neben der betroffenen Zeile.
    → Es wird eine Erläuterung der Problemstellung betreffend der aktuellen Zeile angezeigt.

Um die DQM-Analyse im Report-Bereich auszuführen:

  • Öffnen Sie DQM Connect.
    → Die Analyse wird automatisch gestartet.
  • Ist ein Eintragt mit oder gekennzeichnet, klicken Sie auf .
    → Gibt es nur einen relevanten Checkpoint, wird die betroffene Stelle direkt in einem Dialogfenster geöffnet. Gibt es mehrere relevante Checkpoints, werden Referenzname und Zeilennummer angezeigt und Sie können wählen welche Stelle in einem Dialogfenster geöffnet werden soll.

Bei Medien, Datenbank-Schemata, Datenbank-Abfragen, Tabellenformatvorlagen und Skripten steht der DQM-Report nicht zur Verfügung.

Seiteninhalte