Konfiguration

Das printformer Template beinhaltet Container die mittels Feed befüllt werden (bspw. Produkte). Dabei wird (ein vordefiniertes oder automatisch ausgewähltes) Artikeltemplate inkl. Platzhalter (DataKeys) in den Container eingefügt. Die Zuordnung von Textbausteinen oder Bildern für die einzelnen Platzhalter erfolgt über eine Tabelle (CSV-Datei, enthält eine Spalte zur Identifizierung der Datensätze sowie die gewünschten Inhalte) oder per API.

Screencast Feed einrichten und Medienquelle erstellen

Tutorial Feed erstellen

Upload-Dateien aufbereiten

IDML-Templates

Für einen Feed werden mindestens zwei Templates beötigt:

• ein Template mit Containern:

• (mindestens) ein Artikeltemplate mit Placeholdern für Texte und Bilder enthält:

Der Bildblock muss in der IDML-Datei leer sein – es darf kein Bild eingefügt werden, da sonst das Bild aus dem Feed nicht übernommen werden kann.
(Sofern bereits ein Bild verknüpft wurde bleibt dieses bei allen Datensätzen bestehen.)

Feed-Datei

Der Feed wird als CSV-Datei angelegt.
Diese Datei enthält alle gewünschten Inhalte, strukturiert in Spalten (Zuweisungen) und Zeilen (einzelne Inhalte).

Für jeden Text-Placeholder oder Bildblock-Placeholder aus dem Artikeltemplate muss eine eigene Spalte angelegt werden. Der Spaltentitel muss exakt dem data-key des jeweiligen Placeholders entsprechen. In den Zeilen werden die entsprechenden Inhalte eingefügt.

Bilder können auf zwei Arten eingebunden werden:

• Systemmedien: Die Bilder müssen vorher im System hochgeladen werden. In der CSV-Datei ist der vollständige Dateiname inklusive Dateiendung (z. B. bild1.jpg) anzugeben.

• Externe Links: Alternativ kann ein direkter Link zum Bild angegeben werden.

HTML-Formatierung ist möglich.
Wenn Inhalte HTML-formatiert sind, muss in der Feed-Konfiguration die Option HTML interpretieren aktiviert werden.

Die CSV muss eine Identifier-Spalte enthalten. (X)
Diese dient zur eindeutigen Zuordnung der Inhalte (z. B. über eine Artikelnummer). Jeder Eintrag in dieser Spalte muss eindeutig sein. Der Spaltentitel kann frei gewählt werden und wird später in der Konfiguration entsprechend angegeben. Aus technischen Gründen darf „id“ nicht als Spaltentitel verwendet werden.

Beispiel-CSV tabellarisch dargestellt

Verbindung CSV-Datei zu Template und Editor

Systemeinstellungen

Feed-Mapping

Als erstes wird ein Feed-Mapping (Publish > Product-Feeds > Mapping) hinzugefügt.
Hier wird festgelegt wie die einzelnen Produkte später im Menü Produkte der Sidebar des Editors dargestellt werden (s. Beispiel).

Für jedes Mapping wird eine Name vergeben.

Feed-Darstellung im Editor

Beispiel-Mapping im Editor:
Im Feed-Sidebar-Menü können mehrere Inhalte aus der CSV-Datei dargestellt werden. Zusätzlich lassen sich über Suchfelder verschiedene Filteroptionen definieren, um die Datensätze gezielt einzugrenzen.

Zuweisungen für den Editor vornehmen
Unter Zuweisung werden vordefinierte Keys hinzugefügt und jeweils einem gewünschten Value zugeordnet. Diese Keys steuern, welche Texte und Bilder in der Editor-Sidebar für die einzelnen Produkte angezeigt werden (siehe Screenshot):
1 = title
2 = subtitle
3 = shortDescription
4 = discountPrice
5 = price
6 = image

Im Feld Value wird der Spaltentitel aus der CSV eingetragen, dabei gibt es zwei Schreibweisen:

• Für Text-Platzhalter (1-5): ${pf-ca-DataKey}
  Dabei entspricht DataKey dem jeweiligen Spaltennamen in der CSV-Datei.
  (Es können auch mehrere Datakeys aus der CSV zugewiesen werden, diese werden dann kommasepariert angegeben.)

• Für das Image (6) Spaltentitel
  Beim Key images darf als Value lediglich der Spaltenname aus der CSV eingegeben werden, erhalten, ohne ${…}

Beim Key images darf als Value lediglich der Spaltenname aus der CSV eingegeben werden, erhalten, ohne ${…}

Suchfunktion für den Editor konfigurieren

Standardmäßig enthält das Produkt-Menü im Editor ein Suchfeld, in dem nach Artikelnummer, Name und Produktidentifier gesucht werden kann.
Ohne individuelle Anpassungen durchsucht dieses Feld nur die Keys title (1), subtitle (2) und shortDescription (4) nach exakten Übereinstimmungen.

Erweiterte Suchoptionen:
Zusätzlich können weitere Suchfelder definiert werden (siehe Screenshot 7 und 8).
Diese ermöglichen eine gezielte Suche und basieren jeweils auf einer einzelnen Spalte der CSV-Datei.

Hinweis zur spaltenübergreifenden Suche:
Soll eine Suche über mehrere Inhalte hinweg möglich sein (siehe Screenshot 9), muss in der CSV-Datei eine zusätzliche Spalte erstellt werden. In dieser werden alle relevanten Inhalte aus anderen Spalten zusammengeführt. Dieses Feld kann dann als Grundlage für ein übergreifendes Suchfeld im Editor genutzt werden:

Über die Feed-Einstellungen kann die Standard-Suche ausgeblendet werden, so dass im Editor nur die im Mapping angelegten Suchfelder sichtbar sind.

Die Suchart unterscheidet zwischen Fuzzy und Exact: Fuzzy ist eine Wildcardsuche nach dem Suchbegriff während Exact nur nach dem genauen Begriff sucht (bspw. Suche nach Artikel-Nr.).
Wird hier nichts angegeben werden durch das Suchfeld im Editor nur die Keys title, subtitle und shortDescription nach exakten Übereinstimmungen durchsucht (Default).

Feed einrichten

Um den Feed einzurichten (Publish > Product-Feeds > Übersicht > Feed hinzufügen) werden Name, Typ und ggf. die Mandanten eingetragen.

Allgemeine Feed Einstellungen

Konfiguration

Setting	Beschreibung	Abb.
Datei-Einstellungen
Änderungen an lokalen Produkte draftübergreifend aktualisieren	Produktanpassungen im Draft greifen auch in anderen Drafts, sobald diese Editor geöffnet oder die Print-Datei neu generiert wird.
Erstellen und verwenden von draftübergreifenden Produkten erlauben	Wenn diese Checkbox aktiviert ist, kann der Nutzer eigene Produkte im Editor erstellen und dauerhaft an seinem Profil speichern. Diese Produkte stehen ihm dann auch in neuen Drafts zur Verfügung. (Eigene Produkte beeinflussen nicht den Feed und sind sonst nur draftbezogen speicherbar.)	K
Reihen-Trennzeichen	Trennzeichen des CSV-Datei (bspw. ; )
Überschrift-Offset	in welcher Zeile stehen die Überschriften (in der Regel immer die erste Zeile, die als 0 angegeben wird)
HTML interpretieren	über die Checkbox kann bestimmt werden ob HTML* (aus der Datei) interpretiert oder entfernt werden soll
Daten löschen vor Import	Diese Checkbox muss aktiviert werden, wenn beim Ersetzen der CSV-Datei (bspw. bei einer Aktualisierung) für den Feed die bereits bestehenden Datensätze im Feed gelöscht bzw. ersetzt werden sollen oder das Polling (beim Typ FTP/sFTP; URL) aktiviert wird.
Verhalten bei Replikation des Drafts
Feed replizieren	Special-Feature: Wenn kein konkreter Anwendungsfall besteht, sollte diese Checkbox deaktiviert werden. Sie legt fest, ob beim Replizieren eines Drafts auch der zugehörige Feed kopiert wird. Ist sie aktiviert, wird ein neuer Feed erstellt und dem replizierten Draft zugewiesen. Änderungen am ursprünglichen Feed wirken sich dann nicht mehr auf den neuen Draft aus. (Bei Drafts mit Seitenplanung kann der Feed auch nachträglich geändert werden.)
Identifier-Attribute		X
Identifier-Attribute*	Spaltentitel der Identifizierungsspalte (diese Spalte dient zur Identifizierung der einzelnen Datensätze – sie ist erforderlich, um Inhalte eindeutig zuordnen zu können. Aus technischen gründen darf “id” nicht als Spaltentitel verwendet werden
Gruppenidentifiertemplate	Special-Feature
Gruppenhauptelementattribut	Special-Feature
Badge-Icon Special-Feature	Hier kann eine SVG-Datei (Skalierung 3:4) hochgeladen werden, als Auszeichnungselement bestimmter Produkte im Editor (Sidebar Tab Produkte/Platzierte Produkte, s. Screenshot unten). In der SVG-Datei kann dazu eine Spalte premium eingefügt werden, ist bei einem Produkt dieses Feld befüllt (bspw. mit ja) wird das Icon angezeigt (Leeres Feld = keine Anzeige).	L
Suche und Sortierung	Die Anzeige der Produkte (mit oder ohne Suchfilter) kann alphabetisch, nach Relevanz oder nach der Reihenfolge der CSV-Datei sortiert werden. Es können auch zusätzliche Felder eingegeben werden.

Medien

Greift der Feed auf Medien zu wird hier die Checkbox aktiviert, sowie der gewünschte Anbieter ausgewählt.

Export

Special-Feature daher nicht relevant für die Konfiguration.

Log/Produkte

Beim Speichern werden die Daten an den Feedcon geschickt. Unter Log können die Antworten vom Feedcon eingesehen werden.
Beim Status success (bedeutet der Feed wurde erfolgreich angelegt, ansonsten erscheint eine Fehlermeldung) erscheint das Menü Produkte mit einer Auflistung der Datansätze, analog zum Feed-Mapping.

Feed Typen

Typ lokal

Hier wird zunächst die Feed- (CSV-)Datei hochgeladen.

Typ URL

Hier wird die gewünschte URL (Link zur CSV bspw. https://example.com/mein-feed.csv) eingegeben.

Wird diese Konfiguration verwendet ist zu beachten, dass die URL erreichbar und mehrfach abrufbar sein muss.

Typ FTP/SFTP

Der Typ FTP/SFTP funktioniert nach dem gleichen Prinzip wie URL. Eingabe der Dateinamens (der CSV) sowie Angaben zum Automatischen Import und den FTP/SFTP-Einstellungen (Zugangsdaten und Ordnerpfad für den FTP-Server).

Automatischer Import

Wird die Polling-Checkbox aktiviert werden die Daten für den Feed (Typ FTP/SFTP oder ULR) nach dem angegebenem Intervall automatisch einmal täglich abgerufen.
Das Feld Intervall ist ein CronFeld das auch nur Cron-Eingaben akzeptiert. Der Default ist 0 1 * * * entspricht Jeden Tag um 1 Uhr Morgens.

Damit der alte Feed nicht nur erweitert, sondern ggf. gelöschte Datensätze im System ebenfalls gelöscht werden muss Daten löschen vor Import aktiviert werden.

Mapping

Unter Mapping wird das vorher erstellte FeedMapping zugewiesen.

Allgemeine Einstellungen

Weitere Einstellungsmöglichkeiten zum Product-Feed gibt es unter den allgemeinen Settings > Seitenplanung, diese können system- bzw. mandantenübergreifend eingestellt werden oder auch einzeln in der Template-Konfiguration:

Feature	Beschreibung	Abb.
CSV Export der platzierten Produkte bei Print Produktion generieren	Special-Feature
Produkt-Feed	Default Typ generic
Special-Feature	Typ configurable; Feed-Typ, durch den externe Daten geladen werden
Sichtbarkeit der Bedienelemente		Abb.
Produkt-Suche	Anzeige des Default-Suchfeldes	A
Platzierte Produkte separat anzeigen	im Produkte Menü werden nur die bereits im Editor platzierten Produkte angezeigt (über einen Regler kann die Anzeige auch auf die aktuelle Seite reduziert werden)	D
Produkte mit Original Daten vergleichen	wurden im Editor (über Produkt bearbeiten), oder am Feed, Anpassungen am Content eines Produkts vorgenommen wird dieser (in der Ansicht Platzierte Produkte) markiert. Per Klick auf das Pfeilsymbol öffnet sich der Formulareditor, die Felder mit verändertem Content sind markiert (aktive Pfeile, per Mouseover wird der ursprüngliche Inhalte angezeigt)	C
Produkt hinzufügen	im Editor kann ein neues Produkt erstellt werden; der Content wird mittels Formularfelder eingegeben. (Das Produkt wird nur am Draft gespeichert und hat keine Auswirkungen auf den Feed.)	B
	Mittels Template DataKeys kann in der Formularansicht das Label verändert oder der DataKey komplett ausgeblendet werden.
Produkt bearbeiten	Überschreiben des Contents aus dem Feed, der Content wird mittels Formularfelder eingegeben. (Die Anpassungen werden in der Datenbank gespeichert, sofern sie auch für andere Drafts angewandt werden sollen, kann in der Feed-Konfiguration, die Checkbox Änderungen an lokalen Produkte draftübergreifend aktualisieren aktiviert werden.)	E
Seite automatisch befüllen	über den Button Auswahl platzieren können alle Container einer Seite automatisch befüllt werden; die gewünschten Artikel können dazu über die Suche gefiltert werden bspw. anhand von Artikel-Nummern (Die Contents werden nacheinander zunächst in einen Container platziert bis dieser voll ist, danach wird der nächste Container befüllt. Solange bis alle Container der Seite voll sind, das kann dazu führen, dass Produkte innerhalb eines Templates doppelt platziert werden)	F
Produkt-CSV importieren Special-Feature	Möglichkeit eine neue Feed-CSV-Datei im Editor hochzuladen	G
Produktbilder aktualisieren Special-Feature	spezielles Feature, in Kombination mit Crossmedia werden über diesen Button sämtliche Bilder aus dem Feed neu importiert (die Bildreferenzen der Produkte werden gelöscht und neu geschrieben, bspw. nötig wenn Bilddateien in Crossmedia aktualisiert wurden).	H
Produktinhaltsaustausch	Produktinhaltsaustausch: durch Aktivierung dieses Menüs in der Sidebar (Starten) können Containerinhalte verschoben werden. Dabei wird der Inhalt eines Containers der ausgeschnitten/ersetzt wurde in die Zwischenablage kopiert und kann dann in der Sidebar, über das Plus-Symbol neben der Vorschau, in einen anderen (vorab durch Klick aktivierten) Container eingefügt werden. Auch eine Umsortierung der Inhalte ist möglich. Bei Artikeltemplates, die weitere Container beinhalten (Container in Container) können die Inhalte der Master-Container mittels drag&drop getauscht werden (dabei sind alle im Container platzierte Container und Produkte inbegriffen). Hinweis: Damit alle Elemente aus dem Artikeltemplate korrekt übernommen werden, müssen die beiden Container die gleiche Größe besitzen.	I + Screencast 1:27
Lokale Kopien aktualisieren	Aktivieren der Checkbox blendet im Editor-Feed-Menü einen Button ein. Wird dieser verwendet, werden alle nachträglichen Änderungen am Content (Texte und Bilder) des (im Draft verwendeten) Feeds auf sämtliche Produkte angewendet. Auch bereits platzierte und manuell angepasste Produkte, werden durch die aktuellen Feed-Daten überschrieben.	J
DataKeys sperren Special-Feature	Dadurch erscheint in der „Produkt bearbeiten“-Ansicht ein Schloss-Symbol, über das der Data-Key dieses Produkts gesperrt werden kann. Ist er gesperrt, kann der Wert nicht mehr bearbeitet werden.

Für den Feed gibt es weitere (hier nicht aufgelistete) Einstellungs-Möglichkeiten, diese gelten für einen speziellen Anwendungsfall und sind daher für den regulären Feed nicht relevant.

Übersicht Feed-Menü im Editor

Eigene Produkte

Wenn das Setting Erstellen und Verwenden von draftübergreifenden Produkten erlauben aktiviert ist, erscheint ein zusätzliches Submenü, in dem die Benutzer-Produkte gespeichert werden.
Beim Hinzufügen eines Produkts gibt es dafür eine zusätzliche Checkbox „Produkt dauerhaft speichern“, mit der das Produkt als Benutzer-Produkt aktiviert wird.

Template Konfiguration

Artikel Template

Nachdem das Artikel-Template hochgeladen wurde, muss unter Content für alle zu befüllenden Bildblöcke die jeweilige Bildquelle ausgewählt werden.
Jeder DataKey, der in der IDML einem Bildblock zugewiesen wurde, wird unter Medienquellen aufgeführt.

Mögliche Quellen:

• Externe URL

• Systemmedien

Alternativ kann in der IDML am Tag des Bildblockes das Attribut media-hunter hinzugefügt werden, s. printformer Block-Attribute | printformerBlock-Attribute-Assetblöcke-(Bild-,-PDF-Blöcke)

Master Template

Einige allgemeinen Einstellungen können hier auch templatespezifisch definiert werden. Zudem lässt sich direkt ein Feed hinterlegen.
Dazu unter Template > Editor > Seitenplanung die Option Immer eine Seitenplanung erzeugen“aktivieren und den gewünschten Feed eintragen (Dropdown erscheint nach Eingabe der ersten 3 Buchstaben):

Der hier angegebene Feed wird dann automatisch bei jedem Öffnen des Templates geladen, kann jedoch beim Öffnen oder per API, überschrieben werden.

Alternativ kann zum Testen der Feed beim Öffnen des Templates aus der Admin die Checkbox Seitenplanung erzeugen aktiviert werden:

Unter Feed wird dann jeweils der gewünschte (vorab angelegte) Feed ausgewählt.
(Special-Feature Eingabe von Project-ID, -Code oder -Name; Feed-Item-Identifer)

Pflichtprodukte definieren

Mittels Identifier aus der Feed-CSV-Datei kann festgelegt werden, welche Produkte zwingend in einem Draft platziert werden müssen: Obligatorische Feed-Item-Identifier, siehe Screenshot oben. (Per API oder beim Öffnen aus der Admin) Fehlende Pflichtprodukte können als Hinweis oder als Fehler definiert werden, über die Editor-Einstellungen Hinweise und Validierungen: Fehler bei fehlenden obligatorischen Feed-Item-Identifiern.)

Feed-Typ Lokal: Feed-Datei herunterladen bzw. austauschen

Über das Feed-Menü kann mit dem Button Datei herunterladen im jeweiligen Feed, die CSV-Datei heruntergeladen werden.

Es wird immer nur die zuletzt ins Backend hochgeladene Datei gezogen (werden über den Editor Anpassungen in den Feed übertragen, sind diese nur in der Feed-Datei der Datenbank, nicht im Adminbereich, enthalten)

Nach Überarbeitung der CSV-Datei kann diese in der Konfiguration neu hochgeladen und der Feed gespeichert werden.

Damit der alte Feed nicht nur erweitert, sondern ggf. gelöschte Datensätze im System ebenfalls gelöscht werden muss Daten löschen vor Import aktiviert werden.

In bestehenden Drafts werden Artikel die bereits platziert wurden nicht aktualisiert (nur die Datensätze die noch nicht verwendet wurden werden durch die neue Feed-Datei angepasst).

Produkte über Suche filtern und automatisch platzieren

Über das Feature Seite automatisch befüllen (das über die allgemeinen Einstellung > Seitenplanung aktiviert werden kann) müssen Produkte nicht einzeln in die Container gezogen werden.

Sobald dieses Feature aktiviert ist erscheint in Editor der Button Auswahl platzieren F. Über die Suche können die gewünschten Produkte gefiltert werden, hilfreich ist es dabei entsprechende Suchfelder über das Feed-Mapping vorab zu erstellen. Bspw. ein Suchfeld für die Spalte Artikelname (der CSV-Datei). Im Editor können dann alle gewünschten Artikel (Bestätigung mit Enter) eingegeben werden und über durch Klick auf den Button Auswahl platzieren werden sie automatisch in die zur Verfügung stehenden Container platziert.

HTML Formatierung

* Folgende Tags, Attributes und Values können vom printformer interpretiert werden:

supported tags
h1 - h5
p
br
b
strong
i
em
u
s
strike
del
ul
ol
li
super
sub

### supported css attributes and values

#### on any supported tag
    - font-family
        - postscript or family name of an available font
    - font-weight
        - bold
    - font-style
        - italic
    - text-decoration
        - underline
        - line-through
    - text-transform
        - uppercase
    - font-size
        - values in px/pt (px get converted)
    - text-align
        - left
        - center
        - right
    - color
        - hex notation: \#ffffff
        - rgb notation: rgb(x, x, x)
        - cmyk notation cmyk(x, x, x, x)
        - color names [available color names](https://www.w3schools.com/colors/colors_names.asp)
#### only on ul / ol
    - list-style-type
        - lower-alpha
        - circle
        - square
        - or any single ascii char (unicode characters will follow soon)

### supported attributes
#### html
    - ..
#### data
    - data-leading
        - values in px/pt (px get converted)
    - data-overprint-stroke
        - true / false
    - data-overprint-fill
        - true / false