Vorbehandlung
Eingabemasken
Verwalten und konfigurieren Sie Eingabemasken
Eingabemasken sind Web-Formulare für die interaktive Datenerfassung. Sie sind direkt mit .docx-Vorlagen verknüpft und definieren die Struktur der Formularfelder über eine JSON-Konfiguration. Mit ihnen können Sie Eingaben in ein gerendertes Dokument umwandeln.
Auf dieser Seite erstellen und verwalten Sie solche Eingabemasken-Konfigurationen.
Eine vollständige Einführung in die Verwendung von Eingabemasken finden Sie unter Masken & Formulare: Konfiguration & Beispiele.
Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:
Springe zu:
Eingabemasken können über Upload hier oder programmatisch über die API erstellt werden.
Jede Eingabemaske benötigt einen Template-Identifier zur Verknüpfung mit einer .docx-Vorlage. Die JSON-Konfiguration sollte mit der Vorlagenstruktur übereinstimmen.
Eingabemasken-Liste
Die Übersicht zeigt alle bereits erstellten Eingabemasken mit ihren wichtigsten Eigenschaften und Status-Informationen:
ID | Vorlage-Identifier | Aktiv ab | Aktiv | |
|---|---|---|---|---|
| 34 | form-to-pdf-template | 03.04.2025 | Ja | |
| 1 | test | 03.04.2025 | Ja |
ID
Eindeutige Nummer zur internen Identifikation der Eingabemaske.
Vorlage-Identifier
Verknüpfung zur .docx-Vorlage über deren Identifier. Eingabemasken haben keinen eigenen Identifier, sondern verwenden den der zugehörigen Vorlage.
Aktiv ab
Startdatum der Eingabemaske. Eingabemasken werden erst ab diesem Datum beim Rendern beachtet.
Aktiv
Status der Eingabemaske. Deaktivierte Eingabemasken werden beim Rendern nicht berücksichtigt.
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 Eingabemaske. Ermöglicht Mandanten-spezifische Konfiguration.
Kennzeichnet Eingabemaske 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 Eingabemaske bei Callbacks übergeben und beherrscht Vorlagen-Syntax inkl. Zugriff auf Payload-Daten.
Visuelle Kennzeichnung für schnelle Identifikation des/der Eingabemaske. Vor allem nützlich für Dashboard-Statistiken und Charts.
Erstellt am, Aktualisiert am
| Erstellt am | Aktualisiert am |
|---|---|
Erstellt am
Zeitstempel der Eingabemaske-Erstellung.
Aktualisiert am
Zeitstempel der letzten Änderung. Zeigt wann Eingabemaske-Konfiguration zuletzt bearbeitet wurde.
Kontext-Aktionen
Aktions-Dropdown
Aktions-Dropdown
Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit dem jeweiligen Eingabemaske.
Anzeigen
Öffnet eine reine Detailansicht der kompletten Meta-Informationen und Einstellungen des Eingabemaske.
Ändern
Öffnet das Bearbeitungsformular für alle Einstellungen und den Upload einer neuen Eingabemaske-Version.
Löschen
Entfernt das Eingabemaske dauerhaft aus dem System. Diese Aktion kann nicht rückgängig gemacht werden.
Spalten konfigurieren
Passen Sie die Anzeige der Eingabemaske-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.
Eingabemaske erstellen
'Details'-Tab
Verknüpft die Eingabemaske mit einer .docx-Vorlage. Beachten sie, dass verknüpfte Elemente in ihren Datenstrukturen bzw. Elementnamen übereinstimmen müssen.
Interne Beschreibung eines/r Eingabemaske für Identifikation und bessere Übersicht bzw. Dokumentation. Diese Beschreibung wird im Output.Rocks-Backend verwendet und nicht im Output angezeigt.
Beschreibungen sollten kurz und prägnant sein, um Übersichtlichkeit zu gewährleisten. Längere Erklärungen sollten im Feld 'Kommentar' platziert werden.
Zusätzliche Notizen und Hinweise zum/r Eingabemaske für interne Verwendung.
Startdatum des Elements. Elemente 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 Elemente 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.
'Konfiguration'-Tab
Ausführliche Hinweise und weiterführende Beispiele zur Formular-Konfiguration finden Sie unter Masken & Formulare: Konfiguration & Beispiele.
[
{
"key": "value",
"items": [1, 2, 3]
},
{
"nested": {
"property": "value"
}
}
]Definiert die Formularfelder, deren Reihenfolge, Validierung und Darstellung der Eingabemaske. Beinhaltet Tabs, Gruppen und Feld-Definitionen.
Die JSON-Konfiguration muss der Vorlagenstruktur entsprechen bzw. umgedreht. Dabei werden Felder im Objekt form zuerst als Tabs, dann als Gruppen und schließlich als Felder definiert.
Nutzt das zu rendernde Dokument zBsp. <<kundendaten.firstname>>, dann braucht die Eingabemaske eine Gruppe mit key: "kundendaten" und ein Feld mit key: "firstname":
{
"form": [
{
"tab": "Erstes Tab zum Strukturieren der Maske",
"info": "Infos zu jedem Tab werden hier eingefügt",
"warning": "Warnungen, wie diese, werden farbig hervorgehoben.",
"danger": "Kritische Informationen, wie diese, werden rot dargestellt.",
"groups": [
{
"group": "Kundendaten",
"key": "kundendaten",
"fields": [
{
"key": "firstname",
"type": "text",
"label": "Vorname",
"placeholder": "Max",
"help": "Kunden-Vorname hier eingeben",
"size": "sm",
"required": false,
"width": 6
}
]
}
]
}
]
}Verwenden Sie den Vorschau-Button um die Formularstruktur in Echtzeit zu testen, bevor Sie die Eingabemaske speichern.
Die JSON-Konfiguration muss der Vorlagenstruktur entsprechen. Die Vorschau kann dies leider nicht überprüfen und Fehler werden erst bei Render-Verarbeitung angezeigt.
Eingabemasken-Integration und Workflow
Testen Sie neue Eingabemasken visuell immer mit der Vorschau-Funktion bevor Sie sie produktiv einsetzen.
Testen Sie nach dem Speichern dann ihre JSON-Konfiguration mit einem echten Dokument, indem Sie Mit Eingabemaske rendern nutzen.
Eingabemasken werden in Output.Rocks zur interaktiven Datenerfassung verwendet und mit Vorlagen kombiniert. Die korrekte Konfiguration ist entscheidend für einen effizienten Datenerfassungs-Workflow.
Verwandte Backend-Bereiche
- Templates: .docx-Vorlagen zu denen Eingabemasken verknüpft werden
- Renderings: Verwendung von Eingabemasken zur Datenerfassung
- Testdaten: JSON-Testdaten für Eingabemasken-Validierung
Use Cases
- Eingabemasken: Vollständige Anleitung zur Erstellung und Verwendung von Eingabemasken