printformer Block-Attribute

Alle Blöcke

Diese Attribute werden direkt am Block (Tag in der Struktur) über Neues Attribut hinzufügen… angelegt

condition-json

Valides JSON-Format

Condition-JSON

Block wird nur angezeigt wenn Bedingungen erfüllt sind.

settings

Valides JSON-Format 

Block-Settings

Einschränkung der Editierbarkeit von Blöcken (bspw. keine verschieben eines Blocks möglich)

identifier

Attribut um den Block (in anderen Attributen) identifizieren (zuweisen) zu können

Bspw. bei verankerten Objekten wird der Identifier am Basisobjekt definiert und dann in den Werten des Attributs Anchor entsprechend eingefügt.

tags

Ein oder mehrere Tags (kommasepariert).
Das Attribut Tags hat mehrere Funktionen:

• Varianten

• Block-Bearbeitung über den Formulareditor

Eine Regel sucht Element anhand des tags und tausch die Farbe aus.

title

content-identifier

Verwendung für Template Typ Gruppe, Individualisierbares Bundle oder für Container (Artikeltemplates):
beim Template-, Layout- oder Artikeltemplatewechsel wird der Inhalt (Text oder Asset) des Blocks beibehalten (die Formatierung des Textes wird jedoch beim Wechsel nicht beibehalten).

Ein Textblock ist in mehreren Artikeltemplates enthalten und mit content-identifier getagt. Wird im Editor nun dessen Text (im Container) verändert und danach ein anderes Artikeltemplate in den Container geschoben, bleibt der bearbeitete Inhalt (Text) bestehen.

content-validation

Mittels diesem Attribut kann dem Block eine Blockinhaltsvalidierung (JSON-condition) zugewiesen werden. Als Wert wird der der Identifier der gewünschten Blockinhaltsvalidierung eingegeben.

Ein Textblock soll nicht mit der Buchstabenkombination "XX" befüllt werden, dafür wird eine entsprechende Blockinhaltsvalidierung angelegt. Wird im Editor nun "XX" in den Block eingegeben erscheint die (frei wählbare) Fehlermeldung (kurzer Pop-Up und Hinweis).

anchor

Valides JSON-Format 

Wird verwendet um den Block mit einem anderen zu verankern; die Positionierung wird durch das Basisobjekt sowie die im Attribut vergebenen Werte definiert:
ref-point-me; ref-point; ref-rect; offset; confine

Ein Logo ist mit einem Textblock verankert, sofern sich die Textmenge (und entsprechend der Textblock) vergößert, bleibt der Abstand zwischen den beiden Blöcken bestehen; das Logo rückt nach.

Assetblöcke (Bild-, PDF-Blöcke)

Diese Attribute werden direkt am Block (Tag in der Struktur) über Neues Attribut hinzufügen… angelegt

data-keys

Ein oder mehrere DataKeys (kommasepariert), anhand derer in den aktuellen Datenquellen nach Inhalten für den Block gesucht wird.

Text-Platzhalter

data-key-value

wird in Kombination mit einer Bildquelle eingesetzt, als Wert kann bspw. ein Dateiname (inkl. Suffix) oder eine URL eingesetzt werden.

Hinweise:

• der Verweis auf die Bildquelle (bspw. Systemmedien) wird entweder mittels dem Attribut media-hunter direkt am Block in der IDML gesetzt oder in der Template Konfiguration unter Content > Medienquelle.

• Bei Verwendung einer URL speichert der printformer beim ersten Öffnen des Templates das Bild aus der URL und fragt diese danach nicht mehr ab. Wird das Bild auf der Website aktualisiert bleibt die alte Version im Template bestehen.

In einen Bildblock soll ein Motiv aus einer Website eingesetzt werden.

media-hunter

external-url, custom-attribute, catalog-product-media, system-media

(Werte = Quellen: externer Link, Benutzerdefiniertes Attribut, Artikeltemplate, Systemmedien)
Attribut eines Bildblocks um nach Bildern zu suchen; definiert die Quelle des Bildes mit dem der Block gefüllt werden soll. Wird in Kombination mit den Block-Attributen data-keys oder data-key-value verwendet.
Im InDesign darf in einen mit media-hunter ausgezeichnetem Bildblock kein Default-Bild eingefügt werden, sonst reagiert der media-hunter nicht.
(Die Artikeltemplates werden bei einer Seitenplanung mit externen Produkten eingesetzt.)

Ist in einem Bildblock ein Verweis zu einer Datei der Systemmedien enthalten, muss diese Datei (bspw. Logo) bei einer Aktualisierung nur in den Systemmedien ausgetauscht werden und wird dann automatisch für alle noch nicht produzierten Templates eingesetzt.

h-align

left, center, right

Automatische horizontale Ausrichtung des Assets bei Initial- oder Medienquellenbefüllung
Standardwert: center

Wird ein Asset-Block mit einem Bild befüllt, welches eine geringere Formatbreite besitzt, dann wird es (ohne h-align) horizontal zentriert platziert.

v-align

top, center, bottom

Automatische vertikale Ausrichtung des Assets bei Initial- oder Medienquellenbefüllung
Standardwert: center

Wird ein Asset-Block mit einem Bild befüllt, welches eine geringere Formathöhe besitzt, dann wird es (ohne v-align) vertikal zentriert platziert.

upload-target

true, false

Definiert für Templates mit Verwendung = Upload den Bildblock als Ziel für die hochgeladene Datei.

Ein Template mit Verwendung Upload ist nicht als Freiformat sondern mittels IDML und PrintArea angelegt, dann kann mit diesem Attribut festgelegt werden in welcher Größe/Position die hochgeladene Datei im Template platziert wird.

Block-Settings

In dieser Kategorie handelt es sich um die BlockSettings. Die Tabelle ist eine Auflistung aller möglichen Settings auf, wie diese eingefügt werden kann mittels BlockSettings Generator oder anhand des aufgeführten Beispiels ermittelt werden.

Alle Blöcke

block-disable-interactions

true oder false

Ist dieser Wert true wird jegliche Interaktion mit dem Block und seinem Inhalt unterbunden.
Standardwert: false

Blöcke mit Text-Platzhaltern, in denen außer dem Textinhalt nichts verändert werden soll.

{
  "block-disable-interactions": true
}

block-actions

delete, move, vmove, hmove, mirror, h-mirror,
v-mirror,
resize*, rotate, duplicate, opacity, zindex, fill-color, stroke-color

(= löschen, verschieben (vertikal; horizontal), spiegeln (vertikal; horizontal), skalieren*, drehen, duplizieren, Transparenz, Ebene, Flächenfarbe, Konturfarbe)
Kommaseparierte Liste an erlaubten Blockaktionen. Ein leerer String (im BlockSettings Generator wird dazu nur die Checkbox block-actions aktiviert) verbietet alle möglichen Blockaktionen. Ist dieses Setting nicht gesetzt, sind alle Blockaktionen erlaubt.

Sofern move nicht erlaubt ist, sollte auch resize und rotate verboten werden.

Bei mehreren sich überlappenden Shapeblocks soll nur die Reihenfolge (welcher Block liegt im Vordergrund, welche Blocks dahinter) angepasst werden können, alle anderen Bearbeitungen sind gesperrt.

{
  "block-actions": ["zindex"]
}

tresize, trresize, rresize, brresize, bresize, blresize, lresize, tlresize

*für die Funktion skalieren kann zusätzlich ein Ankerpunkt gewählt werden, um die Richtung in die skaliert werden soll vorzugeben.
(t = top (oben), b = bottom (unten), r = right (rechts), l = left (links))
Bspw. ist bei brresize der Anker (Anfasser) unten rechts definiert, somit ist die Position des Objekts links oben unveränderbar.
Diese Einstellung ist nicht im JSON-Generator vorhanden (muss manuell eingegeben werden).
Standardwert: true

Bei einem Textblock soll nur die Schriftgröße veränderbar sein, der Abstand zum unterhalb des Blocks liegenden Objekts ist fest definiert.

{   
  "block-actions": ["tresize"],
  "text-format": ["fontsize"]   
}

block-map-colors

true oder false

Ist dieser Wert true, können bei SVG-Grafiken (die in der Datei enthaltenen) Farben des Elements einzeln ausgewählt und verändert werden.
Standardwert: true

In einem Template werde SVGs als Grafik-Elemente verwendet, deren Farben sollen jedoch nicht verändert werden dürfen.

{
  "block-map-colors": false
}

block-prevent-clipping

true oder false

Muss der Block vollständig auf der Seite oder innerhalb einer CCA liegen?
Standardwert: false

Um zu vermeiden, dass Elemente außerhalb des druckbaren Bereichs liegen (und somit bspw. abgeschnitten werden)

{
  "block-prevent-clipping": true
}

block-effects
(vsl. ab v3.70)

Auswahl mehrerer Effekte für einen Bildblock.

SVG-Grafik vektorisieren und in CMYK umwandeln

{
 "block-effects": ["vectorize", "color-convert"]
}

block-effects-active

Blockeffektidentifier
(Identifier, der in den Effekten im printformer definiert wurde)

Jedem Bildblock kann ein bestehender Block-Effekt zugewiesen werden, im Editor gibt es keine Möglichkeit diesen abzuwählen.

Prägung einer Grafik

{
 "block-effects-active": ["praegung"]
}

prevent-white-gaps

Wert in pt

Validierung von Bleed und Safety Distance.
Ist dieses Attribut gesetzt, erscheint im Editor jeweils eine Fehlermeldung sofern ein Element nicht komplett im Beschnitt platziert ist oder zu nah am Rand. Über den Wert lässt sich der gewünschte Sicherheitsabstand zum Rand definieren (die Größe des Beschnitts wird über die IDML definiert).

Bei einer Visitenkarte soll ein Sicherheitsabstand von 2 mm zum Rand eingehalten werden zusätzlich ist für randabfallende Elemente ein Beschnitt nötig, auf den der User hingewiesen werden soll (sofern er ihn nicht berücksichtigt)

{
  "prevent-white-gaps" : 6
}

block-scaling

size, position, font, container-content¹

Kommaseparierte Liste an erlaubten Skalierungsaktionen (Größe, Position, Schrift, Artikeltemplate¹)
Ein leerer String entspricht keinen erlaubten Skalierungsaktionen, ist dieses Setting nicht gesetzt werden alle Skalierungsaktionen angewandt.
¹Nur zur Verwendung mit einem PFContainer-Block: wird size und position ohne container-content angegeben, wird der Contaier-Block skaliert, Artikeltemplates die darin platziert werden behalten jedoch ihr urspüngliches Format.

Werden beim Öffnen des Templates neue Seitendimensionen übergeben, kann durch dieses Setting festgelegt ob die einzelnen Blöcke/Texte entsprechend des neuen Formats skaliert und/oder neu positioniert werden sollen. Bsp.: Größe und Position sollen angepasst werden, der Text jedoch nicht

{
  "block-scaling": ["size", "position"]
}

block-scaling-keep-proportions

true oder false

Werden beim Öffnen des Templates neue Seitendimensionen übergeben, kann durch dieses Setting festgelegt dass die Blöcke proportional (mit dem kleineren Skalierungsfaktor) zum neuen Format skaliert werden sollen
Standardwert: false

Bilder sollen trotz Formatanpassung nicht verzerrt werden

{
  "block-scaling-keep-proportions": true
}

block-scaling-keep-distance

boolean

Ist dieses Setting gesetzt, behält der Block immer denselben Abstand zum Formatrand ein (unabhängig von der ursprünglichen Größe), das heißt der Block wird analog zu den übergebenen Seitendimensionen skaliert.

Im Editor soll ein Sicherheitsabstand zum Formatrand angezeigt werden:

{
    "block-scaling-keep-distance": "boolean"
}

Textblöcke

text-write

true oder false

Darf Text überschrieben werden?
Standardwert: true

Vorgegebenes Wording welches nicht verändert werden soll, die Formatierung des Textes darf jedoch angepasst werden

{
  "text-write": false
}

text-format

font, fontsize, font-family, font-style, color, valign,
halign, list, script

Kommaseparierte Liste an erlaubten Formatierungsoptionen.
Ein leerer String entspricht keinen erlaubten Formatierungsoptionen.
Ist dieses Setting nicht gesetzt, sind alle Formatierungsoptionen erlaubt.
(Schriftart, Schriftgröße, Schriftfamilie, Schriftschnitt, Farbe, vertikale Ausrichtung im Textrahmen, Textausrichtung, Aufzählung, script = hochgestellt, normal, tief)

Im Text dürfen Hervorhebungen vorgenommen werden, ansonsten darf jedoch nichts umformatiert werden

{
  "text-format": ["font-style"]
}

text-select

true oder false

Inhalt des Textrahmens wird bei Aktivierung des Blocks ausgewählt.
Standardwert: false

Der textliche Inhalt eines Blocks soll komplett überschrieben werden

{
  "text-select": true
}

text-fit

true oder false

Soll die Schriftgröße des Textes automatisch verringert (auf max. 30%) werden, wenn der Inhalt nicht in den Textrahmen passt.
Standardwert: false

Kann auch in Kombination mit der BlockRestriktion text-font-size verwendet werden (dabei wird der Text nur bis zur dort definierten Mindestschriftgröße verkleinert, danach abgeschnitten).

Begrenzter Platz für eine Überschrift, Schriftgröße soll jedoch so groß wie möglich sein.

{
  "text-fit": true
}

text-grow

t, b, l, r,

Mit diesem Attribut vergrößert sich der Block automatisch sobald die Textmenge die ursprüngliche Größe des Textrahmen überschreitet.
Der jeweilige Bezugspunkt wird dabei durch den Wert (t = top; b = bottom; l = left; r = right) angegeben (bspw. wächst der Textrahmen nach rechts unten bei der Kombination br).
Sämtliche Kombinationen mit Ausnahme lr und tp sind möglich.

Die Kombination mit dem Attribut text-fit funktioniert nur sofern zusätzlich Werte für block-size-max angegeben werden. (Der Block wächst bis block-size-max erreicht wird, danach greift text-fit wieder.)
Die Blockgröße verkleinert sich durch das Löschen von Text nicht mehr. (Der Textblock kann nur verkleinert werden, wenn zunächst Text daraus gelöscht wird; ansonsten wird direkt text-fit angewandt, falls vorhanden.)

Ein Textblock soll sich max. auf eine Größe von 300x200 Pt vergrößern, sofern weiterer Text eingegeben wird soll sich dann die Schriftgröße verkleinern.

{
  "block-size-max": {        
      "width": 300,
      "height": 200
    },
    "text-grow" : "rb",
    "text-fit": true
}

Assetblöcke (Bild-, PDF-Blöcke)

use-box

trim, art, bleed, crop, media

Default: trim

Durch dieses Setting kann definiert werden welche Box der PDF beim Platzieren in einen Bildblock verwendet wird (ähnlich Import-Optionen im InDesign)

• trim = Endformat, Beschnitt entfällt (entspricht InDesign-Import-Option Beschneiden auf Zuschnitt)

• art = Platziert nur den durch ein Rechteck begrenzten Bereich der PDF-Datei, den der Ersteller der Datei als platzierbare Grafik definiert hat (entspricht InDesign-Import-Option Beschneiden auf Objekt)

• bleed = Format inkl. Anschnitt (jedoch ohne Passer- und Schneidemarken)
  (entspricht InDesign-Import-Option Beschneiden auf Anschnitt)

• crop = Ränder für den Seiteninhalt, die beim Anzeigen oder Drucken verwendet werden (entspricht InDesign-Import-Option Beschneiden auf Beschnitt)

• media = umfasst alle Rahmen und alle Elemente der PDF (entspricht InDesign-Import-Option Beschneiden auf Medien)

Hinweis: Auch bei PDF-Dateien, die als Default in der IDML bereits platziert sind, muss dieses Attribut am Block gesetzt werden, ansonsten wird die Box trim angewandt.
(Ggf. sind in der PDF-Datei nicht alle Boxen definiert.)

Eine PDF-Datei enthält Beschnitt und Schneidemarken, im Editor soll sie jedoch nur im Format inkl. Beschnitt (ohne den zusätzlichen Weißraum für die Schnittmarken) platziert werden

{
  "use-box": "bleed"
}

asset-cut-out

true oder false

Ist dieser Wert false kann der User im Editor den Bildausschnitt nicht verändern.
(Keine Controls in der Sidebar)
Standardwert: true

Bildmotiv ist bereits durch die IDML definiert, kann vom User anders platziert, aber ansonsten nicht angepasst werden.

{
  "asset-cut-out": false
}

Hinweis: Ist dieses Setting gesetzt sollte am Block kein resize erlaubt sein.

asset-fill-block

true oder false

Muss der Bildrahmen komplett ausgefüllt werden? (Ist dieser Wert true, wird die kürzere Seite des Motivs auf die Breite bzw. Höhe des Rahmens skaliert und somit ein Teil des Bildes abgeschnitten.)
Standardwert: false
(Bei einer Kombination der Attribute "asset-cut-out": false und "asset-fill-block": true ist das Motiv immer zentriert im Rahmen platziert)

Um leere Flächen im Template zu vermeiden muss der Bildplatzhalter komplett gefüllt werden

{
  "asset-fill-block": true
}

asset-replace

true oder false

Darf das Motiv im Bildrahmen ersetzt werden?
Standardwert: true

Der Ausschnitt eines Bildmotivs darf geändert werden, das Motiv an sich jedoch nicht

{
  "asset-replace": false
}

Block-Restrictions

In dieser Kategorie handelt es sich um die BlockSettings. Die Tabelle ist eine Auflistung aller möglichen Settings auf, wie diese eingefügt werden kann mittels BlockSettings Generator oder anhand des aufgeführten Beispiels ermittelt werden.

Alle Blöcke

block-size-max

width, height

Maximale Dimensionen (Breite und Höhe) des Blocks in pt.
Bei einem leeren Wert wird keine Einschränkung der jeweiligen Dimension vorgenommen. (Nicht anwendbar für ShapeBlocks, da diese im Editor generell nicht skaliert werden können)

Ein Textrahmen darf in der Höhe beliebig erweitert werden, die Breite ist jedoch begrenzt.

{
  "block-size-max": {
    "width": 150,
    "height": ""   
  }
}

block-size-min

width, height

Minimale Dimensionen (Breite und Höhe) des Blocks in pt.
Bei einem leeren Wert wird keine Einschränkung der jeweiligen Dimension vorgenommen. (Nicht anwendbar für ShapeBlocks, da diese im Editor generell nicht skaliert werden können)

Ein Textrahmen darf in der Höhe beliebig erweitert werden, die Breite ist jedoch fest definiert (Kombination mit block-size-max).

{
  "block-size-max": {
    "width": 150,
    "height": ""   
  },
  "block-size-min": {
    "width": 150,
    "height": 10  
  }
}

Textblöcke

text-font-size

min, max

Einschränkungen der Schriftgröße: minimal und maximale Größe in pt
Bei fehlendem Wert wird keine Einschränkung vorgenommen.

minimale Schriftgröße 16 pt und maximale Schriftgröße 20 pt

{
  "text-font-size": {
    "min": 16,
    "max": 20
  }
}

Kombination text-fit mit text-font-size

Werden die Attribute text-font-size und text-fit kombiniert ist zu beachten, dass sich diese Einstellungen auf den kompletten Block beziehen. Die Anpassung geht immer von der kleinsten Größe aus und die Mindest-Schriftgröße darf nicht kleiner als 30% die Default-Größe sein. (Je nach Zeilenabstand kann es zu unterschiedlichen Ergebnissen kommen.)

Assetblöcke (Bild-, PDF-Blöcke)

provider

userMedia, systemMedia, media

Durch diese Restriktion kann definiert werden aus welcher Quelle Assets in einen Bildblock geladen werden können (auschließlich Systemmedien oder auch eigene).

Für einen Bildblock steht eine Auswahl an Bildmotiven zur Verfügung, jedoch soll der User keine eigenen Motive verwenden dürfen.

{
  "provider": ["userMedia"]
}

types

image (Bilder), graphics (SVGs), pdf

Dadurch kann (unabhängig von den Medien-Restriktion der allgemeinen System-Einstellungen) festgelegt werden welche Art von Bilder (Dateiformat) in einen Bildblock geladen werden dürfen.
(Bilder umfassen JPG-, PNG-, Webp- und Tif-Dateien.)

In einen Bildblock dürfen nur vektorisierte Logos eingefügt werden

{
  "types": ["graphics"]
}

tags

freier Wert

Sofern ein Bildblock mittels Systemmedien befüllt wird, kann zusätzlich über Tags (im Attribut und am Systemmedium) bestimmt werden, welche Bilder für diesen Bildblock verwendet werden dürfen.

In einen Bildblock dürfen nur Bilder aus den Sysmtemmedien, die mit “getraenk” getagt sind eingefügt werden

{
    "tags": [
        "getraenk"
    ],
    "provider": [
        "systemMedia"
    ]
}

dpi

error, perfect

Hier kann die Mindest-Auflösung (error) in dpi sowie eine empfohlene Auflösung (perfect) für einen Bildblock festgelegt werden.

Mindest-Auflösung beträgt 150 dpi, empfohlen werden 200

{
  "dpi": {
    "error": 150,
    "perfect": 200
  }
}

Tagspezifische Attribute

PFBarcode

Attribute Barcodes

Aus Standardtext, mittels Formulareditor oder über eine Datenquelle können Codes (QR, EAN13 oder Code128) generiert werden.

PFPlaceholder

Attribute Placeholder

Text-Platzhalter, um Inhalte über den Formulareditor oder automatisiert über eine externe Datenquelle einfließen zu lassen.

PFContainer

Attribute Container

Container sind Platzhalter für Artikeltemplates. Sie können jeweils mit einem Artikeltemplate befüllt werden, für die über Attribute Einschränkungen vorgenommen werden können.

PFGridContainer

Attribute GridContainer

GridContainer sind Platzhalter die nach einer Raster-Vorgabe (Bsp. 2x3 Einheiten) mit mehreren Artikeltemplates befüllt werden können. Das Raster des Containers wird im InDesign-Dokument durch Tag und Attribut definiert.

PFPage

Attribute PFPage

Anlegen eines Druckbogens (Nutzentemplate), auf den Einzelseiten eines printformer Templates beliebig platziert werden.

PFPrintArea

Attribute PFPrintArea

Anlegen eines Druckbogens (Nutzentemplate), auf dem vordefinierte Bereiche (oder Objekte) eines anderen Templates beliebig platziert werden können.