Eine Vorlage konfigurieren
Um eine Vorlage zu konfigurieren oder anzulegen, navigieren Sie zu
. Im Contentbereich wird eine Tabelle geöffnet, welche alle im System angelegten Ticketvorlagen auflistet.Klicken Sie in der Tabelle auf
oder wählen Sie eine bestehende Vorlage mit einem Klick aus . Es wird ein Assistent geöffnet, in dem Sie die Vorlage schrittweise konfigurieren können.Klicken Sie entweder auf die blauen Pfeilschaltflächen oder Punkte, um zwischen den einzelnen Schritten zu wechseln. Klicken Sie abschließend auf
, um Ihre Änderungen zu übernehmen.Tragen Sie hier die allgemeinen Informationen zur Vorlage ein.

Abb.: Konfigurationsbeispiel zur Angabe der Vorlageninformationen
Parameter | Beschreibung |
---|---|
Nutzungskontext | Der Nutzungskontext definiert, in welchem Portal die Vorlage zur Auswahl steht (Mehrfachauswahl möglich).
|
Name | Tragen Sie eine aussagekräftige Bezeichnung für die Vorlage ein. Unter dieser Bezeichnung können Agenten und Kunden später die Vorlage auswählen. |
Icon | Optional können Sie ein Icon wählen, um die Vorlage symbolisch zu kennzeichnen. Hinweis: Ein geändertes Icon wird erst nach Neuanmeldung und Aktualisierung des Browsercaches angezeigt. |
Rang | Der Rang bestimmt die Sortierreihenfolge der Vorlagen im Self Service Portal:
Im Agentenportal erfolgt die Sortierung alphanumerisch. |
Verhalten | Legen hier Sie das Verhalten der Vorlage fest:
|
Vorlagengruppe | Sie können die Vorlage einer Vorlagengruppe zuordnen und damit die Vorlagen strukturieren. Dazu müssen zuvor Vorlagengruppen angelegt sein. Bei Verwendung stehen nur Vorlagen gültiger Vorlagengruppen zur Verfügung, unabhängig davon, ob die Vorlage selbst gültig ist. |
Tags | Optional: Hinterlegen oder Auswählen von Schlagwörtern zur Kennzeichnung dieses Konfigurationsobjektes. Dient der Suche nach zusammengehörenden Konfigurationsobjekten sowie deren Konfigurationsexport. (s. auch: Tagging von Objekten). |
Kommentar | Optional: Notieren Sie eine detaillierte Beschreibung zur Vorlage. Im Agentenportal dient der Kommentar zur Unterscheidung im Admin Modul Im Self Service Portal wird der Kommentar im Label der Vorlage angezeigt. |
Schlagworte | Optional: Sie können die Vorlage mit Schlagworten versehen. Trennen Sie die einzelnen Schlagworte mit einem Leerzeichen voneinander. ![]() Die Vorlagen im Self Service Portal sind mit diesen Schlagworten gekennzeichnet. Nutzer des Self Service Portals können Vorlagen nach den Schlagworten suchen. ![]() |
Gültigkeit | Setzen Sie die Gültigkeit auf "gültig", damit die Vorlage ausgewählt werden kann. Auf "ungültig" gesetzte Vorlagen stehen in den Portalen nicht zur Auswahl. In bestehenden Tickets bleibt das verwendete Template erhalten. |
Rollen | Wählen Sie eine oder mehrere Rollen aus, von denen das Template genutzt werden kann. Das Template steht nur Mitliedern der hier ausgewählten Rollen zur Auswahl. Um Rollen abzuwählen, klicken Sie auf das kleine Kreuz neben der Rollenbezeichnung. Damit eine Vorlage im Self Service Portal zur Verfügung steht, muss die Rolle "Customer" ausgewählt sein. WichtigVergeben Sie die Berechtigung auf die Ticketvorlage niemals auf Rollen, die (explizit oder implizit) mehr als Leserechte auf Templates haben (z. B. Superuser, Admin, etc.)! Verwenden Sie die Rollen ausschließlich dazu, um Berechtigungen auf die Verwendung der Ticketvorlage zu erweitern! Hintergrund: Für die hier ausgewählten Rollen wird explizit ein "READ" für Templates (Vorlagen) gesetzt. Wählen Sie hier bspw. die Rolle "Superuser" aus, wird die UPDATE- Berechtigung für Templates überschrieben, sodass der Nutzer das Template nicht mehr bearbeiten kann. Sollte dies dennoch passieren, besteht die Möglichkeit, die Rechte in der Nutzerverwaltung manuell wieder zu ändern. |
Hier legen Sie fest, welche Eingabe- bzw. Auswahlfelder im Formular enthalten sein sollen und gestalten das Layout des Formulars. Dazu steht Ihnen ein Formulardesigner zur Verfügung, der Ihnen die visuelle Gestaltung des Formulars ermöglicht.
Alternativ können Sie den JSON-Editor im Expertenmodus nutzen.
Warnung
Verwenden Sie den Expertenmodus nur, wenn Sie ausreichende Fachkenntnisse über die KIX-Struktur und über JSON besitzen. Insbesondere, wenn Sie Änderungen an den Standardformularen vornehmen. Im Fehlerfall könnten die Formulare nicht mehr bedienbar sein.
Klicken Sie auf
, um die Eingabefelder und deren Anordnung im Formular zu konfigurieren. Der Formulardesigner wird geöffnet. Richten Sie hier eine oder mehrere Formularseiten ein und ordnen Sie auf diesen die Eingabe- und Auswahlfelder in Formulargruppen an. Das Layout der Seiten basiert auf einem zwölfspaltiges Grid (analog Bootstrap), sodass Sie die Formularfelder und Gruppen auch nebeneinander anordnen und das responsive Verhalten steuern können.Ausführliche Informationen zum Formulardesigner finden Sie hier:
Alternativ: Klicken Sie auf , um den JSON-Editor zu öffnen. Dieser bildet die vollständige und jeweils aktuelle Konfiguration des Formulars als JSON-Struktur ab. Änderungen, die im Formulardesigner vorgenommen wurden, werden sofort in die JSON-Struktur übertragen.
Weiterführende Informationen zum Expertenmodus: Expertenmodus
Klicken Sie nach dem Erstellen oder Ändern des Formulars auf
, um es bereitzustellen.Im Nutzungskontext "Agent" sind Kontakt, Kunde und Titel in der Konfiguration automatisch immer Pflichtfelder, da diese Felder zum Erstellen von Tickets benötigt werden.
Im Nutzungskontext "Customer" können Kontakt und Kunde nicht konfiguriert werden. Diese Felder stehen nicht zur Auswahl.
Ist in der Vorlage kein Kontakt konfiguriert, wird der erstellende Nutzer als Kontakt eingetragen.
Ist in der Vorlage kein Kunde konfiguriert, wird die PrimaryOrg des Kontakts als Kunde eingetragen.
Sind in der Vorlage Titel UND Artikelbetreff nicht konfiguriert bzw. angegeben, wird dieser aus
<Vorlagentitel><YYYY-MM-DD hh:mm of current time>
automatisch generiert.Für Ticket-Pflichtfelder, die in der Vorlage nicht angegeben sind, werden folgende SysConfig- Schlüssel als Fallback verwendet:
Typ: Ticket::Type::Default
Team: PostmasterDefaultTeam
Kanal: API::Operation::V1::ArticleCreate###Channel
Priorität: PostmasterDefaultPriority
Status: PostmasterDefaultState
Dynamisches Feld Betroffene Services im Self Service Portal: Es erfolgt keine Prüfung von Berechtigungen.
Das heißt: Sind Services "als festen Wert" oder "im Hintergrund" gesetzt, dann wird der Service gesetzt, auch wenn der Self Service Portal Nutzer nicht über die entsprechenden Berechtigungen verfügt.
Enthält die Vorlage keinen Tickettitel, so wird dieser automatisch gesetzt, bestehend aus: Name der verwendeten Vorlage + Datum + Uhrzeit (z. B.: "Urlaubsantrag 11.11.2022 14:15")
Tipp
Enthält die Vorlagenkonfiguration keine Angabe zum Kanal oder werden die Angaben im Hintergrund gesetzt, stehen keine ticket-/artikelspezifischen Eingabefelder zur Verfügung.
Das ermöglicht, Tickets ohne Betreff, Artikelinhalt, Anhang usw. zu erstellen, z. B. Urlaubsantrag

Abhängig vom Typ des Feldes werden in den
verschiedene Attribute unterstützt. Einige Attribute werden im Hintergrund automatisch gesetzt und sind nicht konfigurierbar. (z. B. Organisation wird automatisch entsprechend gewähltem Kontakt gesetzt.). Diese sind nachfolgend nicht aufgeführt.Spezifische Attribute für Dropdown-Felder (Status, Priorität, Bearbeiter, Verantwortlicher, Team, Typ, Organisation und Kontakt) sind:
AUTOCOMPLETE
Steuert das Autocomplete-Verhalten für die Texteingabe in Auswahlfeldern (z. B. in Referenzfeldern wie "Verwandte Tickets", "Kontakt", u.a.m.)
Definierter Wert im Parameter
charCount
Definierter Wert im Parameter:
noResultsObjectName
{ "option": "AUTOCOMPLETE", "value": { "charCount": 2, "delay": 250, "limit": 25, "noResultsObjectName": "Translatable#Contacts" } }
charCount: Legt fest, wie viele Zeichen eingegeben werden müssen, damit die Suche startet:
Default: 3
delay: Wartezeit in Millisekunden bis die Suche nach Eingabe des letzten Zeichens startet.
Der Wert kann verändert werden, wenn die Suche zu früh oder zu spät startet.
limit: Anzeigelimit. Bestimmt die Anzahl der Einträge im Auswahlfeld.
Das Limit kann bei Bedarf erhöht werden, wenn aufgrund eingeschränkter Nutzerrechte zu wenig oder keine Einträge geladen werden.
noResultsObjectName: Anzuzeigende Objekt-Bezeichnung, wenn keine Objekte gefunden wurden.
Durch ein vorangestelltes "Translatable#" wird diese Bezeichnung automatisch übersetzt, sofern Sie ein entsprechendes Pattern im Menü "Internationalisierung > Übersetzung" hinterlegt haben.
Wenn nichts angegeben ist, wird die Bezeichnung "Objekte" verwendet.
AUTOCOMPLETE_PRELOAD_PATTERN
Es wird eine Suche innerhalb der vorgeladenen Werte anhand der unter
value
eingebenen Zeichenkette durchgeführt.{ "option": "AUTOCOMPLETE_PRELOAD_PATTERN", "value": "*Meier*" }
MULTISELECT
Auswahl mehrerer Items ermöglichen
value: 1|0 oder true|false
{ "option": "MULTISELECT", "value": 1 }
FREITEXT
Eingabe von Freitext erlauben (z. B. bei E-Mail-Feldern)
value: 1|0 oder true|false
{ "option": "FREETEXT", "value": 1 }
COUNT_MIN
Mindestanzahl an Items, die gewählt sein muss.
Bei Werten >1 wird das Feld ein Pflichtfeld.
{ "option": "COUNT_MIN", "value": 1 }
COUNT_MAX
Maximalanzahl von Items, die gewählt werden dürfen (z. B. maximale Anzahl betroffener Assets)
{ "option": "COUNT_MAX", "value": 10 }
SHOW_NEW_CONTACT
Spezifische Option für das Feld "Kontakt".
Entscheidet, ob die Aktion "Neuer Kontakt" angezeigt wird.
value: 1|0 oder true|false
{ "option": "SHOW_NEW_CONTACT", "value": 1 }
USE_OBJECT_SERVICE
Spezifische Option für das Feld "Team".
Sorgt dafür, dass Teams als Baum angezeigt werden.
value: 1|0 oder true|false
{ "option": "USE_OBJECT_SERVICE", "value": 1 }