Standardelemente
Bilder
Verwalten Sie Bilder, die in Vorlagen verwendet werden
Diese Seite ermöglicht das zentrale Hochladen, Verwalten und Einfügen von Grafiken, um die Gestaltung von Dokumenten und E-Mails im Output-Management zu optimieren.
Bilder werden im App-Backend hochgeladen und mit einem eindeutigen Identifier versehen. Sie können in Vorlagen verwendet werden, um Logos, Grafiken und andere visuelle Elemente zentral zu verwalten. Bilder können statisch oder dynamisch in Vorlagen eingefügt werden. Weitere Informationen zur Verwendung von Bildern in Vorlagen und 'identifier' in Bildmarken finden Sie in der Bildmanagement-Dokumentation.
Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:
Bilder können über das Backend-Interface oder programmatisch über die API erstellt werden.
Jedes Bild benötigt einen eindeutigen Identifier zur Verwendung in Vorlagen. Verwenden Sie aussagekräftige Namen wie logo oder header_image.
Bilder-Liste
Die Übersicht zeigt alle verfügbaren Bilder mit ihren wichtigsten Eigenschaften:
ID, Identifier, Aktiv ab
| ID | Identifier | Gruppen-Identifier | Aktiv ab | Wert |
|---|---|---|---|---|
| identifier_name | Null |
ID
Eindeutige Nummer zur internen Identifikation des Bilds.
Identifier
Eindeutiger Name des Bilds für Rendering und API-Aufrufe.
Eindeutiger Name für eine optionale Gruppierung von verwandten Bildn. Elemente einer Gruppe werden gemeinsam verarbeitet und optionale Validatoren können dabei einzelne Elemente aktivieren oder ignorieren.
Aktiv ab
Startdatum eines Bilds. Bilds werden erst ab diesem Datum beim Rendern beachtet.
Wert
Der Dateneintrag des Bilds. Kann Text, Zahlen, Bedingungen oder andere Daten enthalten, die in Vorlagen verwendet werden.
Verwendung des Identifiers in Vorlagen:
Der Identifier wird in Vorlagen mit den Präfixen img_ oder imgfit_ verwendet, um das Bild einzubinden. Beispiel: img_logo oder imgfit_header_image. Weitere Informationen zur Verwendung von Bild-Platzhaltern finden Sie in der Bildmanagement-Dokumentation.
Öffentlich und Bilddatei
Öffentlich
Der Controller-Schalter steuert die Sichtbarkeit des Copy public URL Buttons und kennzeichnet Bilder, die als öffentlich markiert wurden. Aktuell erfolgt die Freigabe ausschließlich über die UI; die URL kann dann manuell verwendet werden und macht das Bild für andere Webseiten oder Apps zugänglich. Für das Rendering hat der Wert keine Auswirkung.
Bilddatei
Thumbnail-Vorschau der hinterlegten Datei; ein Klick öffnet die Vollansicht.
Aktiv, Erstellt am, Aktualisiert am
| Validatoren | Pausiert | Aktiv | Erstellt am | Aktualisiert am |
|---|---|---|---|---|
| Null | NO | Ja | ||
| missing_street | YES | Nein |
Zugewiesene Validierungsregeln für das Bild. Prüfen Ihre Bedingungen vor der Verarbeitung und aktivieren/deaktivieren das Rendering entsprechend.
Temporäre Deaktivierung des Bilds. Pausierte Elemente werden nicht verarbeitet.
Aktivierungsstatus des Bilds. Nur aktive Elemente werden beim Rendern berücksichtigt.
Erstellt am
Zeitstempel der Bild-Erstellung.
Aktualisiert am
Zeitstempel der letzten Änderung. Zeigt wann Bild-Konfiguration zuletzt bearbeitet wurde.
Mandant, Standard für Umgebungs-Mandanten
| Umgebungs-Mandant | Standard für Umgebungs-Mandanten | Benutzerdefinierte ID | Farbe |
|---|---|---|---|
| (1880) Submarke 1 | NO | Null | |
| Null | YES | <<payload.value>> |
Zugeordneter Mandant des/der Bild. Ermöglicht Mandanten-spezifische Konfiguration.
Kennzeichnet Bild als Standard und vererbt (verfügbar) für alle Umgebungs-Mandanten.
Optionale benutzerdefinierte Kennung nach dem Rendering für externe Systeme. Wird als Referenzen des/der Bild bei Callbacks übergeben und beherrscht Vorlagen-Syntax inkl. Zugriff auf Payload-Daten.
Visuelle Kennzeichnung für schnelle Identifikation des/der Bild. Vor allem nützlich für Dashboard-Statistiken und Charts.
Kontext-Aktionen
Aktions-Dropdown
Aktions-Dropdown
Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit dem jeweiligen Bild.
Anzeigen
Öffnet eine reine Detailansicht der kompletten Meta-Informationen und Einstellungen des Bild.
Ändern
Öffnet das Bearbeitungsformular für alle Einstellungen und den Upload einer neuen Bild-Version.
Löschen
Entfernt das Bild dauerhaft aus dem System. Diese Aktion kann nicht rückgängig gemacht werden.
Spalten konfigurieren
Passen Sie die Anzeige der Bild-Liste für bessere Übersichtlichkeit an. Spalten können per Drag-and-Drop neu angeordnet und über Checkboxen ein-/ausgeblendet werden.
Für mich anwenden : Spalten-Konfiguration wird nur für Ihren Account gespeichert und beeinflusst andere Benutzer nicht.
Als Standard anwenden : Konfiguration wird für alle Benutzer der Instanz übernommen und als neue Standard-Ansicht gesetzt.
Bild erstellen
Aktions-Buttons zum Speichern und Verwalten der Bild-Konfiguration.
Verwenden Sie "Erstellen und weiteres Element hinzufügen" für effizientes Batch-Erstellen mehrerer Elemente.
Formularfelder
Das Formular gruppiert die wichtigsten Stammdaten und Upload-Einstellungen:
Identifier
Eindeutige Kennung für dieses/r Bild zur programmatischen Verwendung, Einbindung in Vorlagen, Lookups und API-Zugriff.
Identifiers sollten 'snake_case' sein, also klein geschrieben und Unterstriche verwenden, z.B. 'kunde_name' oder 'rechnung_nummer'.
Verwenden Sie aussagekräftige Dateinamen und Identifier, um die Verwaltung Ihrer Bilder zu erleichtern. Organisieren Sie Bilder logisch (z.B. logo_primary, logo_secondary, icon_info).
Öffentlich
Der Controller-Schalter steuert die Sichtbarkeit des Copy public URL Buttons und kennzeichnet Bilder, die als öffentlich markiert wurden. Die URL kann anschließend manuell verwendet werden. Für das Rendering hat der Wert keine Auswirkung.
Aktiv ab und Aktiv
Startdatum des Bilds. Bilde werden erst ab diesem Datum beim Rendern beachtet.
Die Aktiv-Checkbox ermöglicht eine sofortige De-/Aktivierung unabhängig vom Datum.
Vor-Terminierung: Mit diesem Feld können Bilde vor-terminiert werden. Setzen Sie ein zukünftiges Datum, um das Element automatisch ab diesem Zeitpunkt zu aktivieren.
Mehrere Elemente mit gleichem Identifier: unterschiedliches 'Aktiv ab' staffelt die Version; bei einer Anfrage gilt das aktive Element mit dem spätesten Aktiv ab (nicht Erstell- oder Änderungsdatum).
Bilddatei
Laden Sie eine neue Bilddatei hoch. Zugelassene Formate: JPG, JPEG und PNG. Es gibt keine Beschränkungen für Bildmaße oder Dateigrößen. Die Datei wird nach dem Upload in der globalen Bilderverwaltung abgelegt.
Mandant & Standard für Umgebungs-Mandanten
Zuordnung zu einem spezifischen Umgebungs-Mandanten oder Standard-Verwendung für alle Mandanten.
Markiert Element als Standard-Element, das automatisch an alle Umgebungs-Mandanten vererbt wird.
Fehlermeldung: Die Kombination "Standard für Umgebungs-Mandanten" + ausgewählter "Umgebungs-Mandant" erzeugt die Fehlermeldung: Tenant defaults can not be set on tenant assigned entities. Ein Element kann entweder für einen spezifischen Mandant ODER als Standard für alle Umgebungs-Mandanten konfiguriert werden.
Bilder-Integration und Workflow
Bilder werden in Output.Rocks in verschiedenen Bereichen verwendet und mit anderen Funktionen kombiniert. Die korrekte Integration ist entscheidend für einen effizienten Dokumentenerstellungs‑Workflow.
Verwandte Backend-Bereiche
- docx-Vorlagen: Einbindung von Bildern in .docx-Vorlagen
- Teil-Vorlagen: Einbindung von Bildern in Teil-Vorlagen
Bild-Funktionen
- Bildmanagement: Detaillierte Erklärung der Bildverwendung in Vorlagen
- Statische Bilder: Verwendung von Bildern aus der globalen Bilderverwaltung
- Dynamische Bilder: Verwendung von Bildern aus dem JSON-Payload
Use Cases
- Bildplatzhalter: Verwendung von Platzhaltern in Vorlagen
- Bild-Präfixe:
img_undimgfit_Präfixe für Bildskalierung