Skip to main content

Eine Vorlage konfigurieren

Um eine Vorlage zu konfigurieren oder anzulegen, navigieren Sie zu Workflow > Vorlagen. Im Contentbereich wird eine Tabelle geöffnet, welche alle im System angelegten Ticketvorlagen auflistet.

Klicken Sie in der Tabelle auf Neue Vorlage 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 Speichern, um Ihre Änderungen zu übernehmen.

Tragen Sie hier die allgemeinen Informationen zur Vorlage ein.

Vorlagen_Konfig_Vorlageninformationen.png

Abb.: Konfigurationsbeispiel zur Angabe der Vorlageninformationen

Parameter

Beschreibung

Nutzungskontext

Der Nutzungskontext definiert, in welchem Portal die Vorlage zur Auswahl steht (Mehrfachauswahl möglich).

  • Agent: Die Vorlage kann im Agentenportal ausgewählt und verwendet werden.

  • Kunde: Die Vorlage kann im Self Service Portal ausgewählt und verwendet werden

    (Rolle "Customer" erforderlich).

  • System: Die Vorlage kann von Nutzern des Agenten- oder Self Service Portals nicht genutzt werden. Sie dient der Erstellung von Tickets, welche ausschließlich durch das Backend generiert werden.

    Die Vorlage kann von Macro Actions (z.B. "Create Ticket from System Template") und anderen Automatismen genutzt werden, z. B. vom Add-on "KIX Maintenance Plan" für das automatisierte Erstellen von Tickets für Wartungsaufgaben.

    Vorlagen mit ausschließlichem Verwendungskontext "System" stehen im Agentenportal und im Self Service Portal nicht zur Verfügung.

    Systemvorlagen unterstützen die Verwendung von KIX Platzhaltern, um bei Angabe von Bezugsobjekten deren Informationen aufzulösen.

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:

  1. Vorlagen basierend auf Rang

  2. Vorlagen ohne Rang, sortiert nach Name

Im Agentenportal erfolgt die Sortierung alphanumerisch.

Verhalten

Legen hier Sie das Verhalten der Vorlage fest:

  • Neu (Default): Wählen Sie diese Option für alle Vorlagen, die nicht vom Add-on "KIX Maintenance Plan | Wartungsplan" verwendet werden.

    Möglich auch für Systemvorlagen, die bspw. von der Macro Action "Ticket Create from System Template" genutzt werden.

  • Wartung: Diese Option steht nur nach Erwerb des Add-ons "KIX Maintenance Plan | Wartungsplan" zur Auswahl.

    Wählen Sie diese Option, wenn die Vorlage vom Add-on zum generieren der Wartungs-Tickets genutzt werden soll.

    In der Konfiguration Wartungsplänen können nur Vorlagen mit Nutzungskontext "System" UND Verhalten "Wartung" ausgewählt werden.

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.

Vorlagen_Konfig_Schlagworte.png

Die Vorlagen im Self Service Portal sind mit diesen Schlagworten gekennzeichnet. Nutzer des Self Service Portals können Vorlagen nach den Schlagworten suchen.

Vorlagen_Konfig_Schlagworte-SSP.png

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.

Wichtig

Vergeben 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 Formular-Designer öffnen, 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 Expertenmodus, 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 Speichern, 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

Vorlage-ohne-Artikel_Urlaubsantrag.png

Abhängig vom Typ des Feldes werden in den Erweiterten Optionen 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.)

    Vorlagen_HinweiseErweiterteOptionen_Autocomplete.png

    1.png Definierter Wert im Parameter charCount

    2.png 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
    }