Skip to main content

Konfigurationsbeispiele

Nachfolgend finden Sie Kurzinformationen zur Bereitstellung Dynamischer Felder in Widgets. Ausführliche Informationen zur GUI Konfiguration finden Sie im Admin Handbuch von KIX Start und KIX Pro.

Anmerkung

  • Im Self Service Portal stehen nicht alle Objekt-Attribute zur Verfügung (z. B.: verfügbar: SLA-Kriterien; nicht verfügbar: SLA-Name)

  • Für die Anzeige der Werte benötigt der Customer die entsprechenden Berechtigungen auf Objekteigenschaften (z. B. auf SLAID und SLACriteria) und Ressourcen (z. B. /system/slas).

Um in einem Objekt-Info-Widget den Wert eines Dynamischen Feldes anzuzeigen, können Sie wie folgt vorgehen:

  1. Navigieren Sie im Admin Modul des Agentenportals zu System > GUI Konfiguration > Self Service Portal

  2. Suchen und öffnen Sie den SysConfig-Schlüssel des zu bearbeitenden Kontextes (z. B.: ssp-ticket-details-context).

  3. Fügen Sie nachfolgenden Codeblock in die Konfiguration des Schlüssels ein.

    Platzieren Sie ihn innerhalb des Abschnitt rows[...] Die Platzierung bestimmt die Anordnung des Dynamischen Feldes im Widget.

    Ersetzen Sie DFName durch den Namen des Dynamischen Feldes, welches Sie einbinden möchten.

    {
      "title": "Translatable#DFName",
      "separator": true,
      "values": [
         [
           {
             "componentId": "ssp-object-detail",
             "componentData": {
                 "name": "DFName"
             },
             "conditions": [
                {
                  "property": "DynamicFields.DFName",
                  "operator": "NE",
                  "value": null
                }
             ]
           }
         ]
       ]
    },
  4. Fügen Sie den Codeblock ggf. mehrfach ein, wenn Sie weitere Dynamische Felder bereitstellen möchten und verfahren Sie wie unter Schritt 2 beschrieben.

  5. Klicken Sie abschließend auf Speichern und anschließend auf Lade Frontendkonfiguration neu.

Danach ist das Dynamische Feld in der Oberfläche integriert, sodass dessen Wert angezeigt werden kann.

Verweise:

Um im Self Service Portal einer Tabelle eine weitere Spalte für die Anzeige eines Dynamischen Feldes hinzuzufügen, können Sie wie folgt vorgehen:

  1. Navigieren Sie im Admin Modul des Agentenportals zu System > GUI Konfiguration > Self Service Portal

  2. Suchen und öffnen Sie den SysConfig-Schlüssel des zu bearbeitenden Kontextes (z. B.: ssp-ticket-details-context).

  3. Fügen Sie nachfolgenden Codeblock in die Konfiguration des Schlüssels ein.

    Der Codeblock erzeugt eine neue Spalte in der Tabelle, welche den Wert des Dynamischen Feldes anzeigt.

    Platzieren Sie ihn innerhalb des Abschnitt tableColumns[...] Die Platzierung bestimmt die Anordnung der Spalte innerhalb der Tabelle.

    Ersetzen Sie DFName durch den Namen des Dynamischen Feldes, welches Sie einbinden möchten.

    Ändern Sie optional weitere Spaltenparameter wie bspw. Spaltenbreite (Attribut size).

    {
      "id": null,
      "name": null,
      "type": null,
      "property": "DynamicFields.DFName",
      "showText": true,
      "showIcon": false,
      "showColumnTitle": true,
      "showColumnIcon": false,
      "size": 135,
      "sortable": true,
      "filterable": true,
      "hasListFilter": false,
      "dataType": "STRING",
      "resizable": true,
      "componentId": null,
      "defaultText": null,
      "translatable": false,
      "titleTranslatable": true,
      "useObjectServiceForFilter": false,
      "valid": true,
      "application": "agent-portal"
    },
  4. Fügen Sie den Codeblock ggf. mehrfach ein, wenn Sie weitere Dynamische Felder bereitstellen möchten und verfahren Sie wie unter Schritt 2 beschrieben.

  5. Klicken Sie abschließend auf Speichern und anschließend auf Lade Frontendkonfiguration neu.

Danach ist die Tabelle um die Spalte ergänzt, sodass der Wert des Dynamischen Feldes in der Tabelle angezeigt werden kann.

Hinweise
  • Möchten Sie den Fortschrittsbalken einer Checkliste anzeigen, dann notieren Sie unter componentID den Wert dynamic-field-checklist-cell.

  • Zur Darstellung eines SLA Kriteriums verwenden Sie componentID:sla-criteria-cell.

  • Für die Anzeige der SLA-Kriterien müssen die LoadingOptions für die Tickets um SLAID und SLACriteria erweitert werden:

    SSP_GUI_Konfig_Ticket_loadingOptions_SLAID.png

Verweise:

Um im Self Service Portal ein individuelles Objekt-Info-Widget zusätzlich einzubinden, können Sie wie folgt vorgehen:

  1. Navigieren Sie im Admin Modul des Agentenportals zu System > GUI Konfiguration > Self Service Portal

  2. Suchen und öffnen Sie den SysConfig-Schlüssel des zu bearbeitenden Kontextes (z. B.: ssp-ticket-details-context).

  3. Fügen Sie nachfolgenden Codeblock in die Konfiguration des Schlüssels ein.

    Platzieren Sie ihn innerhalb des Abschnitt content[...]. Die Platzierung bestimmt dieAnordnung des Widgets im Kontext.

    {
      "instanceId": "my-ticket-widget",
      "configurationId": "my-ticket-widget",
      "configuration": {
        "id": "my-ticket-widget",
        "name": "My Ticket Widget",
        "type": "Widget",
        "widgetId": "my-ticket-widget",
        "title": "Translatable#My Ticket Widget",
        "actions": [],
        "subConfigurationDefinition": null,
        "configuration": {
           "id": "4711",
           "name": "4711",
           "type": null,
           "valid": true,
           "application": "agent-portal",
           "avatar": [],
           "rows": [
             {
               "title": "Translatable#DF1",
               "separator": true,
               "values": [
                 [
                   {
                     "componentId": "dynamic-field-value",
                     "componentData": {
                       "name": "DF1"
                     },
                     "conditions": [
                       {
                         "property": "DynamicFields.DF1",
                         "operator": "NE",
                         "value": null
                       }
                     ]
                   }
                 ]
               ]
             },
             {
               "values": [
                 [
                  {
                     "componentId": "dynamic-field-value",
                     "componentData": {
                       "property": "DF2"
                     }
                  }
                 ]
               ],
               "title": "",
               "style": "",
               "separator": false  
              }
          ]
        },
        "minimized": false,
        "minimizable": true,
        "icon": "",
        "contextDependent": false,
        "contextObjectDependent": false,
        "formDependent": false,
        "formDependencyProperties": [],
        "valid": true,
        "application": "SSP"
       },
       "permissions": [],
       "size": "large"
    },
  4. Ersetzen Sie DF1 bzw. DF2 durch die Namen der Dynamischen Felder, welche im Widget angezeigt werden sollen.

    Unter conditions können Sie angeben, unter welchen Bedingungen das Feld angezeigt wird. Im o. a. Beispiel darf das DF1 nicht leer sein, damit es angezeigt wird.

  5. Sie können dem Abschnitt rows[...] weitere Dynamische Felder hinzufügen. Verwenden Sie dazu den Codeblock aus Abschnitt "Object-information-card-widget konfigurieren".

  6. Klicken Sie abschließend auf Speichern und anschließend auf Lade Frontendkonfiguration neu.

Danach enthält der Kontext ein weiteres Widget mit individueller Konfiguration.

Verweise: