Standardelemente
QR-Codes
Verwalten Sie QR-Codes in Vorlagen
Die QR-Code-Funktion ermöglicht die einfache Erstellung und Integration von QR-Codes oder EPC-QR-Codes in Dokumente, um schnelle Zugriffe auf weiterführende Informationen oder digitale Inhalte zu gewährleisten.
QR-Codes werden im App-Backend erstellt und mit einem eindeutigen Identifier versehen. Sie können in Vorlagen verwendet werden, um Links, Informationen oder EPC-QR-Codes für Zahlungen in Dokumente einzubinden. Weitere Informationen zur Verwendung von QR-Codes in Vorlagen finden Sie in der QR-Codes-Dokumentation.
Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:
QR-Codes können über das Backend-Interface oder programmatisch über die API erstellt werden.
QR-Codes-Liste
Die Übersicht zeigt alle verfügbaren QR-Codes mit ihren wichtigsten Eigenschaften:
ID, Identifier, Aktiv ab, QR-Datenkontext
| ID | Identifier | Gruppen-Identifier | Aktiv ab | QR-Datenkontext |
|---|---|---|---|---|
| identifier_name | Null |
ID
Eindeutige Nummer zur internen Identifikation des QR-Codes.
Identifier
Eindeutiger Name des QR-Codes für Rendering und API-Aufrufe.
Eindeutiger Name für eine optionale Gruppierung von verwandten QR-Coden. Elemente einer Gruppe werden gemeinsam verarbeitet und optionale Validatoren können dabei einzelne Elemente aktivieren oder ignorieren.
Aktiv ab
Startdatum eines QR-Codes. QR-Codes werden erst ab diesem Datum beim Rendern beachtet.
QR-Datenkontext
Der Dateneintrag des QR-Codes. Kann Text, Zahlen, Bedingungen oder andere Daten enthalten, die in Vorlagen verwendet werden.
Size und Vorlagen
| Size | Vorlagen |
|---|---|
| 150 | template_identifier |
Size
Die Größe des QR-Codes in Pixeln. Diese wird beim Rendern verwendet, um die Größe in der Vorlage zu bestimmen.
Vorlagen
Zeigt an, in welchen Vorlagen diese/s QR-Code verwendet wird. Die Zuordnung erfolgt entweder über die Vorlagen-Konfiguration im Reiter "Diagramme" oder "QR-Codes", oder über den "Vorlagen"-Reiter in der Bearbeitungsansicht des jeweiligen QR-Codes.
Aktiv, Erstellt am, Aktualisiert am
| Validatoren | Pausiert | Aktiv | Erstellt am | Aktualisiert am |
|---|---|---|---|---|
| Null | NO | Ja | ||
| missing_street | YES | Nein |
Zugewiesene Validierungsregeln für das QR-Code. Prüfen Ihre Bedingungen vor der Verarbeitung und aktivieren/deaktivieren das Rendering entsprechend.
Temporäre Deaktivierung des QR-Codes. Pausierte Elemente werden nicht verarbeitet.
Aktivierungsstatus des QR-Codes. Nur aktive Elemente werden beim Rendern berücksichtigt.
Erstellt am
Zeitstempel der QR-Code-Erstellung.
Aktualisiert am
Zeitstempel der letzten Änderung. Zeigt wann QR-Code-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 QR-Code. Ermöglicht Mandanten-spezifische Konfiguration.
Kennzeichnet QR-Code 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 QR-Code bei Callbacks übergeben und beherrscht Vorlagen-Syntax inkl. Zugriff auf Payload-Daten.
Visuelle Kennzeichnung für schnelle Identifikation des/der QR-Code. Vor allem nützlich für Dashboard-Statistiken und Charts.
QR-Code-spezifische Eigenschaften
Die folgenden Spalten enthalten QR-Code-spezifische Konfigurationswerte:
QR-Code-spezifische Eigenschaften
Diese Spalten enthalten die spezifischen Konfigurationswerte für QR-Codes:
| Margin | Dunkel | Hell | EC-Level | URL des zentralen Bildes |
|---|---|---|---|---|
| 4 | M | Null |
Margin
Der Rand des QR-Codes in Modulen (Standard: 4).
Dunkel
Die Farbe der dunklen Module des QR-Codes (Standard: #000000).
Hell
Die Farbe der hellen Module des QR-Codes (Standard: #FFFFFF).
EC-Level
Der Fehlerkorrektur-Level (L, M, Q, H) – bestimmt die Fehlertoleranz des QR-Codes.
URL des zentralen Bildes
Optionales Bild, das in der Mitte des QR-Codes angezeigt wird.
| Größenverhältnis des zentralen Bildes | Bildunterschrift | Schriftfamilie der Bildunterschrift | Schriftgröße der Bildunterschrift | Farben der Bildunterschrift |
|---|---|---|---|---|
| 0.3 | Null | sans-serif | 10 |
Größenverhältnis des zentralen Bildes
Verhältnis der Bildgröße zur QR-Code-Größe (z. B. 0.3 = 30 %).
Bildunterschrift
Optionaler Text unter dem QR-Code.
Schriftfamilie der Bildunterschrift
Schriftart für die Bildunterschrift (Standard: sans-serif).
Schriftgröße der Bildunterschrift
Schriftgröße in Pixeln (Standard: 10).
Farben der Bildunterschrift
Textfarbe der Bildunterschrift (Standard: #000000).
Kontext-Aktionen
Aktions-Dropdown
Aktions-Dropdown
Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit dem jeweiligen QR-Code.
Testen
Öffnet eine QR-Code-Testumgebung zum lokalen Rendern mit bearbeitbaren Validatoren und JSON-Testdaten.
Anzeigen
Öffnet eine reine Detailansicht der kompletten Meta-Informationen und Einstellungen des QR-Code.
Ändern
Öffnet das Bearbeitungsformular für alle Einstellungen und den Upload einer neuen QR-Code-Version.
Löschen
Entfernt das QR-Code dauerhaft aus dem System. Diese Aktion kann nicht rückgängig gemacht werden.
Spalten konfigurieren
Passen Sie die Anzeige der QR-Code-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.
QR-Code erstellen
Aktions-Buttons zum Speichern und Verwalten der QR-Code-Konfiguration.
Verwenden Sie "Erstellen und weiteres Element hinzufügen" für effizientes Batch-Erstellen mehrerer Elemente.
Das Erstellungsformular für QR-Codes ist in drei Tabs unterteilt: Details für grundlegende Konfiguration, Konfiguration für QR-Code-Parameter und visuelle Einstellungen, und Vorlagen für die Zuordnung zu Vorlagen.
Eindeutige Kennung für dieses/r QR-Code 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'.
Startdatum des QR-Codes. QR-Codee 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 QR-Codee 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).
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.
QR-Codes-Integration und Workflow
QR-Codes 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 QR-Codes in .docx-Vorlagen
- QR-Code-Editor: Konfiguration im Editor testen; Testen in der Liste öffnet
?id=<Datenbank-ID>zum Bearbeiten und Speichern, Neu öffnet?create=1zum Anlegen (inkl. DOCX-Vorlagen-Zuordnung). Details zu URLs, Toolbar und nicht persistiertem JSON siehe dort.
QR-Code-Funktionen
- QR-Codes in Vorlagen: Detaillierte Erklärung der QR-Code-Verwendung in Vorlagen
- EPC-QR-Codes: Anleitung zur Erstellung von EPC-QR-Codes für Zahlungen