×
Search
Products
orders

02 - Template-Struktur und Datenquellen

Managed: vorhandenen Master verwenden

Managed-Templates sind ADP-Slaves, keine zweite vollständige HTML-Seite innerhalb des Masters. Die Controller liefern den Projekt-/Dokumentkontext. Diese Properties dürfen nicht weggelassen oder mit frei erfundenen Werten ersetzt werden:

<master src="/admin/ecommerce/products/catalogue/master">
<property name="page_size">@page_size@</property>
<property name="orientation">@orientation@</property>
<property name="document_id">@document_id@</property>
<property name="project_id">@project_id@</property>
<property name="project_revision">@project_revision@</property>
<property name="project_title">@project_title@</property>
<property name="template_key">@template_key@</property>
<property name="patch_schema_version">@patch_schema_version@</property>
<property name="patch_context_id">@patch_context_id@</property>
<property name="project_index_url">@project_index_url@</property>
<property name="project_generate_url">@project_generate_url@</property>

Das vollständige Anschlussbeispiel enthält auch Renderer-/Layoutproperties und einen kleinen statischen Inhaltsblock. Der produktive Controller muss alle referenzierten Variablen bereitstellen. Das Beispiel erfindet keine neue products-Datenstruktur; Schleifen werden an die tatsächlich vom Controller bereitgestellten Daten angepasst.

Der Master setzt die HTML-Attribute für Dokument-/Patchidentität, data-pdf-ready, Engine und Format sowie window.publisherConfig. Er importiert das ES-Modul kontrolliert und meldet auch Bootstrapfehler. Deshalb im Slave nicht nochmals pdf-service.js als klassisches Script laden.

Inhaltskomponenten

<article class="page page-num-inc" data-component="product"
         data-component-id="category-10-product-200">
  <h2 id="product-200" data-toc="Produkt 200" data-pagecalc="dom">Produkt 200</h2>
  <div class="page-body" data-patch-id="body">
    <p data-patch-id="description">Produktbeschreibung</p>
  </div>
</article>

data-component-id ist innerhalb eines Componenttyps eindeutig. Innere data-patch-id-/data-row-id-/HTML-IDs helfen, die Zielpfade von Strukturänderungen zu entkoppeln. Keine zufälligen Laufzeit-UUIDs als stabile wiederkehrende Ziele verwenden. Dynamische Texte und Attribute mit den vorhandenen kontextgerechten Escape-Funktionen ausgeben; Rohdaten aus Uploads sind kein vertrauenswürdiges HTML.

Datenbank und Uploads

Datenbankkataloge verwenden den vorhandenen Katalogcontroller. Upload-Projekte verwenden project-data.tcl und eine passende Templatevariante. Dort sind source_content, source_type, source_filename, source_hash und die typbezogenen Raw-Aliase verfügbar. JSON/XML/CSV werden nicht automatisch auf das Produktschema abgebildet.

Die Sample-Dateien zeigen das gleiche kleine Sortiment in drei Austauschformaten. Für ein Fachtemplate werden daraus serverseitig Produkte mit stabiler ID, validiertem Preis und Text gebildet. Der konkrete Parser ist Teil des projektspezifischen Tcl-/SSR-Adapters. In dieser Dokumentation wird kein nicht vorhandener parse_csv-Helper vorausgesetzt.

Das Raw-Uploadtemplate zeigt die sichere Quelltextanzeige des vorhandenen Mastervertrags. Erst der Fachadapter macht daraus eine Preisliste oder ein Datenblatt.

Unmanaged: eigenständiges HTML

Ein lokales Dokument kann CSS/Inhalte direkt enthalten. Soll es Publisher-Patches oder Paged.js nutzen, muss es die erforderlichen Module aus einer expliziten Instanz laden oder passend mitliefern. window.publisherConfig muss vor dem Modulimport gesetzt sein. Der Unmanaged-Worker deaktiviert Live-AJAX und Editorpersistenz, stellt aber nicht von sich aus einen universellen fehlenden JS-Bootstrap bereit.

Pipeline, Unmanaged-Vertrag und Publisher-HTML-Beispiel erläutern die unterschiedlichen Startwege.


Codebasis: templates/.../html-data.plain.adp, project-data.raw.plain.adp, master.resp.adp, catalogue/project-data.tcl.