Feldspezifische Konfigurationsparameter

Das Dynamische Feld vom Typ Checkliste ist nun angelegt und kann in die Oberflächen des angegebenen Objekttyps integriert werden.

Jeder Checklistenpunkt ist ein Item. Sie können beliebig viele Items und Sub-Items erstellen. Klicken Sie dazu ggf. mehrfach auf die Plus-Schaltfläche neben Checklisteneintrag oder Sub+.

Jedes Item kann per Drag & Drop in die gewünschte Reihenfolge gezogen werden.

Hinweis: Die Konfigurationsoptionen Anzahl (min), Anzahl (max), Anzahl (Standard) usw. stehen in Checklisten nicht zur Verfügung.

Konfigurationsparameter	Beschreibung
Id	Beliebiger Wert für die interne Verarbeitung (optional). Die ID darf nur einmal in der Checkliste vorkommen. Wird keine ID eingetragen, wird sie vom System automatisch vergeben.
Titel	Der Titel kennzeichnet einen Checklisteneintrag
Beschreibung	Optional: Genauere Beschreibung des Checklisteneintrags
Fertig	Relevant für Eingabewert Text bzw. TextArea. Verfügbar nur in neu angelegten Checklisten. Wenn aktiviert, wird der Fortschritt der Checkliste weitergezählt, sobald im Eingabefeld (Text und TextArea) etwas notiert wird. Hinweis: Das Textfeld gilt als ausgefüllt, wenn die Länge des enthaltenen Strings >0 ist. Es wird nicht geprüft, ob nur Leerzeichen enthalten sind. Abgrenzung: Die Field Agent App berücksichtigt für den Checklistenfortschritt nur die Checklist-State-Werte.
Datum der letzten Änderung anzeigen	Wenn aktiviert, wird am Item das Datum der letzten Änderung angezeigt.
Eingabe	Legt fest, ob ein Auswahlfeld oder ein Textfeld zur Beantwortung des Checklistenpunkts angezeigt wird. Text: Es wird ein einzeiliges Textfeld angezeigt, in dem Nutzer kurze Informationen hinterlegen können, z. B. aufgetretene Hindernisse bei Ausführung der Arbeiten. TextArea: Es wird ein mehrzeiliges Textfeld angezeigt, in dem Nutzer längere Texte inkl. Zeilenumbrüche eintragen können.  Checklisten-Status: Es wird ein Auswahlfeld angezeigt, in welchem der Status des Checklistenpunkts ausgewählt werden kann Die Auswahlwerte können Sie selbst definieren. Klicken Sie dazu auf die Plus-Schaltfläche Es werden weitere Konfigurationsoptionen offeriert: Label: Bezeichnung des Status. Dieser wird im Dropdown als Auswahlwert angeboten Icon: Sie können dem Auswahlwert ein Icon voranstellen . Zur Auswahl stehen die KIX-Icons und eine Vielzahl an Fontawesome-Icons. Fertig: Setzen Sie ein Häkchen, wenn bei Auswahl des Wertes der Fortschritt der Checkliste weitergezählt werden soll. Dies kann für jeden Auswahlwert gesondert festgelegt werden. Ist im Checklisten-Status nichts definiert, werden folgende Auswahlwerte per Default gesetzt: OK: Erledigt / OK / Genehmigt Fortschritt wird hochgezählt NOK: Nicht OK / Nicht ausgeführt Fortschritt wird hochgezählt, da gültige Antwort pending: Warten-Status (Warten auf Rückmeldung / Zurückgestellt) Fortschritt wird nicht hochgezählt, da Schwebezustand n.a.: nicht anwendbar / keine Angabe / unzutreffend Fortschritt wird hochgezählt, da bspw. "nicht anwendbar" auch eine gültige Antwort ist. -: Unbeantwortet / keine Auswahl getroffen Fortschritt wird nicht hochgezählt
Wert	Voreingestellter Wert (optional). Mit dem angegebenen Text oder Auswahlwert wird das Feld vorbelegt. Er kann bei Verwendung der Checkliste durch den Agenten geändert werden. Bei Typ ChecklistState ist ein Auswahlwert anzugeben, welcher auch im Checklisten-Status definiert ist (z. B. pending | OK | NOK | erledigt). Anderenfalls wirdkein Wert angezeigt.
	Legt weitere Unterpunkte für einen Checklisteneintrag an und generiert damit eine hierarchische Baumstruktur der Checkliste.
	Löscht den Checklisteneintrag einschließlich eventueller Sub-Items.
	Verschiebt den Checklisteneintrag einschließlich eventueller Sub-Items nach oben bzw. unten

Checklisten können auch per Automation (Macro Action "Dynamisches Feld Setzen") erstellt oder zugewiesen werden. Auf diese Art kann ein Checklistenfeld in mehreren Ausprägungen genutzt werden und mehrfache Konfiguration wird vermieden. Das nachfolgende Beispiel zeigt den vollständigen in einer Macro Action zuzuweisenden Wert.

Beispiel eines Checklisteninhalts für das Preboarding bei Einstellung neuer Mitarbeiter (technisch)

[
   {
      "id": "100",
      "title": "Informationen zusenden",
      "description": "Vor First Day Begrüßungs- und Info-Mail zusenden/ anrufen. Wichtige Informationen bereitstellen: wo, wann, von wem erwartet, Unternehmensleitbild, Organigramm oder Kommunikationsleitfäden. Ziel: vorab allg. Fragen klären.",
      "input": "ChecklistState",
      "inputStates": [
         {
            "value": "OK",
            "order": 1,
            "icon": "kix-icon-check",
            "done": true
         },
         {
            "value": "NOK",
            "order": 1,
            "icon": "kix-icon-exclamation",
            "done": true
         },
         {
            "value": "pending",
            "order": 1,
            "icon": "fa-times",
            "done": false
         }
      ],
      "value": "-"
   },
   {
      "id": "200",
      "title": "Dokumente besorgen",
      "description": "Mitwirkung des Arbeitnehmers einfordern. Sozialversicherungsausweis, Krankenkasse, Lohnsteuerkarte, Steuer-ID. Ziel: Vermeidung organisatorischer Fragen in erster Woche.",
      "input": "ChecklistState",
      "inputStates": [
         {
            "value": "erledigt",
            "order": 1,
            "icon": "kix-icon-check",
            "done": true
         },
         {
            "value": "in Arbeit",
            "order": 1,
            "icon": "kix-icon-exclamation",
            "done": true
         },
         {
            "value": "warten auf Rückmeldung",
            "order": 1,
            "icon": "fa-times",
            "done": false
         }
      ],
      "value": "-"
   },
   {
      "id": "300",
      "title": "Ansprechpartner benennen",
      "description": "Fester Ansprechpartner, der zur Seite steht - auch bei Anfragen aller Art im Vorfeld - aka Mentor/Pate/Buddy.",
      "input": "ChecklistState",
      "inputStates": [
         {
            "value": "erledigt",
            "order": 1,
            "icon": "kix-icon-check",
            "done": true
         },
         {
            "value": "nicht erforderlich",
            "order": 1,
            "icon": "kix-icon-exclamation",
            "done": true
         },
         {
            "value": "in Klärung",
            "order": 1,
            "icon": "fa-times",
            "done": false
         }
      ],
      "value": "-",
      "sub": [
         {
            "id": "310",
            "title": "Buddy",
            "input": "Text",
            "value": ""
         }
      ]
   },
   {
      "id": "400",
      "title": "Arbeitsplatz einrichten",
      "description": "Arbeitsplatz muss am First Day eingerichtet sein. Dazu gehören: Bereitstellung Passwörter, Druckerzugang, Telefon, Bürostuhl/ Schreibtisch, sonstige Hilfsmittel. Ziel: Vermeidung technischer Blocker in erster Woche.",
      "input": "ChecklistState",
      "inputStates": [
         {
            "value": "OK",
            "order": 1,
            "icon": "kix-icon-check",
            "done": true
         },
         {
            "value": "NOK",
            "order": 1,
            "icon": "kix-icon-exclamation",
            "done": true
         },
         {
            "value": "pending",
            "order": 1,
            "icon": "fa-times",
            "done": false
         }
      ],
      "value": "-"
   },
   {
      "id": "500",
      "title": "Einarbeitungsplan erstellen",
      "description": "Muss frühzeitig, vor Arbeitsbeginn, stehen. Inhalt: detaillierten Arbeitsplan für erste Woche; Aufgaben; künftige Projekte. Ziel: Chaos und Leerlauf verhindern.",
      "input": "ChecklistState",
      "inputStates": [
         {
            "value": "OK",
            "order": 1,
            "icon": "kix-icon-check",
            "done": true
         },
         {
            "value": "NOK",
            "order": 1,
            "icon": "kix-icon-exclamation",
            "done": true
         },
         {
            "value": "pending",
            "order": 1,
            "icon": "fa-times",
            "done": false
         }
      ],
      "value": "-",
      "sub": [
         {
            "id": "510",
            "title": "URL-Einarbeitungsplan",
            "input": "Text",
            "value": ""
         }
      ]
   },
   {
      "id": "600",
      "title": "Wohnungssuche organisieren",
      "description": "Unterstütztung Auswärtiger bei Wohnungssuche, Umzug oder Behördengängen. Ziel: Vermeidung Ablenkung, Ermöglichen Konzentration auf Einarbeitung",
      "input": "ChecklistState",
      "inputStates": [
         {
            "value": "OK",
            "order": 1,
            "icon": "kix-icon-check",
            "done": true
         },
         {
            "value": "NOK",
            "order": 1,
            "icon": "kix-icon-exclamation",
            "done": true
         },
         {
            "value": "pending",
            "order": 1,
            "icon": "fa-times",
            "done": false
         }
      ],
      "value": ""
   }
][
  {
    "id": "100",
    "title": "Informationen zusenden",
    "description": "Vor First Day Begrüßungs- und Info-Mail zusenden/anrufen. Wichtige Informationen bereitstellen: wo, wann, von wem erwartet, Unternehmensleitbild, Organigramm oder Kommunikationsleitfäden. Ziel: vorab allg. Fragen klären.",
    "input": "ChecklistState",
    "value": "-"
  },
  {
    "id": "200",
    "title": "Dokumente besorgen",
    "description": "Mitwirkung des Arbeitnehmers einfordern. Sozialversicherungsausweis, Krankenkasse, Lohnsteuerkarte, Steuer-ID. Ziel: Vermeidung organisatorischer Fragen in erster Woche.",
    "input": "ChecklistState",
    "value": "-"
  },
  {
    "id": "300",
    "title": "Ansprechpartner benennen",
    "description": "Fester Ansprechpartner, der zur Seite steht - auch bei Anfragen aller Art im Vorfeld - aka Mentor/Pate/Buddy.",
    "input": "ChecklistState",
    "value": "-",
    "sub": [
      {
        "id": "310",
        "title": "Buddy",
        "input": "Text",
        "value": ""
      }
    ]
  },
  {
    "id": "400",
    "title": "Arbeitsplatz einrichten",
    "description": "Arbeitsplatz muss am First Day eingerichtet sein. Dazu gehören: Bereitstellung Passwörter, Druckerzugang, Telefon, Bürostuhl/Schreibtisch, sonstige Hilfsmittel. Ziel: Vermeidung technischer Blocker in erster Woche.",
    "input": "ChecklistState",
    "value": "-"
  },
  {
    "id": "500",
    "title": "Einarbeitungsplan erstellen",
    "description": "Muss frühzeitig, vor Arbeitsbeginn, stehen. Inhalt: detaillierten Arbeitsplan für erste Woche; Aufgaben; künftige Projekte. Ziel: Chaos und Leerlauf verhindern.",
    "input": "ChecklistState",
    "value": "-",
    "sub": [
      {
        "id": "510",
        "title": "URL-Einarbeitungsplan",
        "input": "Text",
        "value": ""
      }
    ]
  },
  {
    "id": "600",
    "title": "Wohnungssuche organisieren",
    "description": "Unterstütztung Auswärtiger bei Wohnungssuche, Umzug oder Behördengängen. Ziel: Vermeidung Ablenkung, Ermöglichen Konzentration auf Einarbeitung.",
    "input": "ChecklistState",
    "value": ""
  }
]

Das Einbinden der Tabelle in die Ticket-Oberflächen erfolgt prinzipiell wie unter Dynamische Felder in Dialogen bereitstellen beschrieben.

In KIX Pro können die Tabellen komfortabel über Aktionen und Vorlagen bereitgestellt werden.

Um die Tabelle in den Ticketdetails anzuzeigen, können Sie den nachfolgenden Codeblock in den Schlüssel ticket-details-info-card (KIX Pro: Ticket Info Widget) einfügen.

Verfahren Sie wie unter Werte Dynamischer Felder anzeigen beschrieben. Ersetzen Sie dabei die beispielhaften Bezeichnungen "Inventory" bzw. "DFInventoryList" durch die reellen Bezeichnungen.

Geben Sie als dynamic-field-value als componentID und name als componentData an.

{
  "title": "Translatable#Inventory",
  "style": "",
  "separator": true,
  "values": [
    [
     {
       "componentId": "dynamic-field-value",
       "componentData": {
         "name": "DFInventoryList"
       },
       "conditions": [
         {
           "property": "DynamicFields.DFInventoryList",
           "operator": "NE",
           "value": null,
           "useObjectService": false,
           "useDisplayValue": false
         }
       ]
      }
    ]
  ]
},

Tabellen können als Pflichtfeld deklariert werden. Aktivieren Sie das Häkchen vor dem Dynamischen Feld beim Erstellen der Aktion bzw. der Vorlage.

Ist die Tabelle als Pflichtfeld deklariert, dann darf die Tabelle keine leeren Zeilen enthalten und die Tabelle kann nicht entfernt bzw. eingeblendet werden.

Um auf die Daten der Tabelle zuzugreifen, können Sie folgende KIX Platzhalter nutzen: