Skip to main content

Werte Dynamischer Felder anzeigen

Hinterlegt ein Agent Informationen in einem Dynamischen Feld, werden diese direkt am Objekt (Ticket, Kontakt o.a.) gespeichert. Dadurch ist es möglich, gezielt nach diesen Werten zu suchen, die Inhalte auszulesen, auszuwerten und in Übersichten, Detailansichten sowie in den Widgets der Sidebar anzuzeigen.

Für die Anzeige der Werte ist der im Dynamischen Feld definierte Objekttyp unerheblich. Somit ist es möglich, Kontaktinformationen bspw. in den Ticketdetails bereitzustellen.

Für individuelle Elemente (z. B. Name des Dynamischen Feldes) müssen Sie die Übersetzung selbst pflegen. Hinterlegen Sie dazu im Menü Internationalisierung > Übersetzungen die entsprechenden Pattern.

Die Bereitstellung eines Dynamischen Feldes in Objekt-Info-Widgets erfolgt über die Konfiguration der jeweiligen SysConfig-Schlüssel im Menü System > SysConfig .

Eine Übersicht der meistverwendeten Konfigurationsschlüssel finden Sie unter: Häufig verwendete SysConfig-SchlüsselHäufig verwendete SysConfig-Schlüssel

Im folgenden Beispiel wird die an einem Ticket hinterlegte Seriennummer in den Ticketdetails angezeigt. Voraussetzung hierfür ist, dass ein entsprechendes Dynamisches Feld im System angelegt wurde und dieses in den Dialog Neues Ticket bzw. Ticket bearbeiten integriert wurde, sodass von den Agenten die Seriennummer am Ticket hinterlegt werden konnte.

df-wert-darstellen_ergebnis.png

Abb.: Anzeige des Wertes eines Dynamischen Feldes in den Ticket-Informationen

  1. Navigieren Sie zum Menü System > SysConfig.

  2. Suchen und öffnen Sie den SysConfig-Schlüssel ticket-details-info-card

    In diesem Schlüssel ist die Konfiguration für das Widget Ticket Informationen hinterlegt.

    Alternativ: Sie können den SysConfig-Schlüssel eines anderen Object-Information-Card-Widgets verwenden, um dort den Wert des Dynamischen Feldes anzeigen zu lassen.

  3. Optional: Kopieren Sie den Quellcode im Feld Wert in einen externen JSON-Editor, um ihn besser editieren zu können. 

    df-wert-darstellen_json-editor.png
  4. Kopieren Sie den nachfolgenden Codeblock an gewünschter Stelle in einen values-Block.

    {
     "componentId": "object-avatar-label",
     "componentData": {
         "property": "DynamicFields.DFSerialNumber"
            },
         "conditions": [
            {
              "property": "DynamicFields.DFSerialNumber",
              "operator": "NE",
              "value": null
            }
         ]
    },

    Mit Ihrer Platzierung legen Sie fest, an welcher Stelle im Widget der Wert des Dynamischen Feldes positioniert wird.

    df-wert-darstellen_PlatzierungImCode.png

    Optional: Zum Einbinden mehrerer Dynamischer Felder fügen Sie den Quelltext mehrfach ein. Trennen Sie die einzelnen Codeabschnitte durch Kommas.

    Optional: Sie können unter conditions Bedingungen für die Anzeige des Dynamischen Feldes angeben. Im Beispiel wird das Dynamische Feld nur dann angezeigt, wenn es einen Wert besitzt. D. h., ist am Ticket keine Seriennummer angegeben, wird das Dynamische Feld in den Ticketdetails auch nicht angezeigt. Sind keine conditions notiert, wird das Feld immer angezeigt.

    Tipp: Die Komponente object-avatar-label liefert nur einen einzeiligen Wert. Alternativ können Sie die Komponente dynamic-field-value verwenden. Diese ermöglicht die Ausgabe von formatiertem Text, insbesondere wenn mehrzeilige Texte, Checklisten- oder Tabellenwerte angezeigt werden sollen.

  5. Optionale Variante: Sie können den Wert des Dynamischen Feldes in einem separaten Inhaltsblock anzeigen lassen.

    df-wert-darstellen_Variante.png

    Fügen Sie den nachfolgenden Codeblock unter rows[...] ein.

    Auch hier bestimmt die Platzierung im Code die Platzierung in der GUI.

    {
       "title": "Translatable#Seriennummer",
       "style": "",
       "separator": true,
       "values": [
         {
           "componentId": "dynamic-field-value",
           "componentData": {
              "name": "DFSerialNumber"
            },
           "conditions": [
              {
                "property": "DynamicFields.DFSerialNumber",
                "operator": "NE",
                "value": null
              }
           ]
         }
       ]
    },
    df-wert-darstellen_Variante_Codebsp.png
  6. Ersetzen Sie im Parameter property den im Beispiel verwendeten Namen des Dynamischen Feldes (DFSerialNumber) durch den Namen Ihres eigenen Dynamischen Feldes.

    Es ist der in der Konfiguration des Dynamischen Feldes definierte Name anzugeben.

    Verwenden Sie folgende Syntax: DynamicFields.NameDesDynamischenFeldes.

    Haben Sie mehrere Dynamische Felder eingebunden, ersetzen Sie diese Namen ebenso.

  7. Minimieren Sie im Editor den Quellcode, um unnötige Leerzeichen und Zeilenumbrüche zu entfernen und kopieren Sie ihn in die Zwischenablage.

    df-einbinden-minimieren.png
  8. Fügen Sie den Quellcode aus der Zwischenablage zurück nach KIX ins Feld Wert

  9. Klicken Sie abschließend auf Speichern.

  10. Klicken Sie im Header der SysConfig auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

In der Tabelle Neue Tickets des Home Dasboards ist nun eine zusätzliche Spalte für die Anzeige des im Dynamischen Feld gespeicherten Wertes eingefügt.

Nachfolgend finden Sie Beispiele für bereits modifizierte Konfigurationsschlüssel zu Ihrer Information.

Achtung

Beachten Sie, dass es sich hierbei lediglich um Konfigurations-Beispiele mit informativem Charakter handelt. Dennoch enthalten die Beispiele eine komplette Konfiguration des jeweiligen Schlüssels.

Wir übernehmen keine Gewähr, wenn Sie die Konfigurationen 1:1 in Ihr System übertragen.

{
   "id": "ticket-details-info-card",
   "name": "Ticket Info Widget",
   "type": "Widget",
   "widgetId": "object-information-card-widget",
   "title": "Translatable#Ticket Information",
   "actions": [],
   "subConfigurationDefinition": null,
   "configuration": {
      "id": "1692622169146",
      "name": "1692622169146",
      "type": null,
      "valid": true,
      "application": "agent-portal",
      "avatar": [],
      "rows": [
         {
            "title": "Translatable#Summary",
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "OrganisationID"
                     },
                     "routingConfiguration": {
                        "contextId": "organisation-details",
                        "objectType": "Organisation",
                        "contextMode": "DETAILS",
                        "objectIdProperty": "ID",
                        "history": false,
                        "externalLink": null,
                        "replaceObjectId": null,
                        "resetContext": true,
                        "params": null,
                        "additionalInformation": [],
                        "contextType": "MAIN"
                     },
                     "routingObjectId": "<KIX_TICKET_OrganisationID>"
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "TypeID"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ContactID"
                     },
                     "routingConfiguration": {
                        "contextId": "contact-details",
                        "objectType": "Contact",
                        "contextMode": "DETAILS",
                        "objectIdProperty": "ID",
                        "history": false,
                        "externalLink": null,
                        "replaceObjectId": null,
                        "resetContext": true,
                        "params": null,
                        "additionalInformation": [],
                        "contextType": "MAIN"
                     },
                     "routingObjectId": "<KIX_TICKET_ContactID>"
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "PriorityID"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "StateID"
                     }
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.DFSerialNumber"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.DFSerialNumber",
                           "operator": "NE",
                           "value": null
                        }
                     ]
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.CloseCode"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.CloseCode",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.AnonymiseTicket"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.AnonymiseTicket",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         },
         {
            "title": "Translatable#Description",
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "dynamic-field-value",
                     "detailViewWidthFactor": "4",
                     "componentData": {
                        "name": "WorkOrder"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.WorkOrder",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         },
         {
            "title": "Translatable#Assignees",
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "QueueID"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "LockID"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "OwnerID"
                     },
                     "conditions": [
                        {
                           "property": "OwnerID",
                           "operator": "NE",
                           "value": 1,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ResponsibleID"
                     },
                     "conditions": [
                        {
                           "property": "ResponsibleID",
                           "operator": "NE",
                           "value": 1,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         },
         {
            "title": "Translatable#Checklists",
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "text": "Mobile Processing Checklist 010",
                     "textStyle": "font-weight:bold;margin-bottom:0.5rem",
                     "icon": "kix-icon-ci",
                     "componentId": "dynamic-field-value",
                     "componentData": {
                        "name": "MobileProcessingChecklist010"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.MobileProcessingChecklist010",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ],
               [
                  {
                     "text": "Mobile Processing Checklist 020",
                     "textStyle": "font-weight:bold;margin-bottom:0.5rem",
                     "icon": "kix-icon-ci",
                     "componentId": "dynamic-field-value",
                     "componentData": {
                        "name": "MobileProcessingChecklist020"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.MobileProcessingChecklist020",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         },
         {
            "title": "Translatable#References",
            "style": "",
            "separator": false,
            "values": [
               [
                  {
                     "text": "Translatable#Affected Assets",
                     "textStyle": "font-weight:bold;margin-bottom:0.5rem",
                     "icon": "kix-icon-ci",
                     "componentId": "dynamic-field-value",
                     "componentData": {
                        "name": "AffectedAsset"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.AffectedAsset",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ],
               [
                  {
                     "text": "Translatable#Affected Services",
                     "textStyle": "font-weight:bold;margin-bottom:0.5rem",
                     "icon": "kix-icon-ci",
                     "componentId": "dynamic-field-value",
                     "componentData": {
                        "name": "AffectedServices"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.AffectedServices",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ],
               [
                  {
                     "text": "Translatable#Merged into the Ticket",
                     "textStyle": "font-weight:bold;margin-bottom:0.5rem",
                     "icon": "kix-icon-ticket",
                     "componentId": "dynamic-field-value",
                     "componentData": {
                        "name": "MergeToTicket"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.MergeToTicket",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         },
         {
            "title": " ",
            "separator": true,
            "values": [
               [
                  {
                     "text": "Translatable#Related Tickets",
                     "textStyle": "font-weight:bold;margin-bottom:0.5rem",
                     "icon": "kix-icon-ci",
                     "componentId": "dynamic-field-value",
                     "componentData": {
                        "name": "RelatedTickets"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.RelatedTickets",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         },
         {
            "title": "Translatable#Scheduling",
            "separator": false,
            "values": [
               [
                  {
                     "text": "Translatable#Accounted Time: {0}",
                     "textPlaceholder": [
                        "<KIX_TICKET_AccountedTime>"
                     ],
                     "icon": "kix-icon-time",
                     "conditions": [
                        {
                           "property": "AccountedTime",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ],
               [
                  {
                     "text": "Translatable#Pending until: {0} ({1})",
                     "textPlaceholder": [
                        "<KIX_TICKET_PendingTime>",
                        "<KIX_TICKET_UntilTime>"
                     ],
                     "icon": "kix-icon-time-wait",
                     "conditions": [
                        {
                           "property": "StateType",
                           "operator": "CONTAINS",
                           "value": "pending",
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ],
               [
                  {
                     "text": "Translatable#Plan: {0} - {1}",
                     "textPlaceholder": [
                        "<KIX_TICKET_DynamicField_PlanBegin>",
                        "<KIX_TICKET_DynamicField_PlanEnd>"
                     ],
                     "icon": "kix-icon-time-back",
                     "conditions": [
                        {
                           "property": "DynamicFields.PlanBegin",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         },
         {
            "title": "",
            "style": "",
            "separator": false,
            "values": [
               [
                  {
                     "icon": null,
                     "iconStyle": "",
                     "text": "Translatable#Created by {0} at {1}. Last change by {2} at {3}",
                     "textPlaceholder": [
                        "<KIX_TICKET_CreateBy>",
                        "<KIX_TICKET_Created>",
                        "<KIX_TICKET_ChangeBy>",
                        "<KIX_TICKET_Changed>"
                     ],
                     "textStyle": "color:#5b5b5b;font-style:italic",
                     "linkSrc": null
                  }
               ]
            ]
         }
      ]
   },
   "minimized": false,
   "minimizable": false,
   "icon": "kix-icon-ticket",
   "contextDependent": false,
   "contextObjectDependent": false,
   "formDependent": false,
   "formDependencyProperties": [],
   "valid": true,
   "application": "agent-portal"
}
{
   "id": "contact-details-info-widget",
   "name": "Contact Info Widget",
   "type": "Widget",
   "widgetId": "object-information-card-widget",
   "title": "Translatable#Contact Information",
   "actions": [],
   "subConfigurationDefinition": null,
   "configuration": {
      "id": "1691394743446",
      "name": "1691394743446",
      "type": null,
      "valid": true,
      "application": "agent-portal",
      "avatar": [],
      "rows": [
         {
            "values": [
               [
                  {
                     "componentId": "icon",
                     "componentData": {
                        "icon": {
                           "propertyBindings": [],
                           "Links": [],
                           "LinkTypeName": null,
                           "ChangeBy": null,
                           "ChangeTime": null,
                           "CreateBy": null,
                           "CreateTime": null,
                           "ValidID": 1,
                           "Comment": null,
                           "DynamicFields": [],
                           "LinkCount": 0,
                           "displayValues": [],
                           "displayIcons": [],
                           "KIXObjectType": "OBJECT_ICON",
                           "ObjectID": "<KIX_CONTACT_ID>",
                           "ObjectId": "<KIX_CONTACT_ID>",
                           "Object": "Contact",
                           "ContentType": null,
                           "Content": null,
                           "fallbackIcon": "kix-icon-man-bubble"
                        },
                        "style": "width: 5rem;height:5rem;font-size:5rem;"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Title"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Firstname"
                     }
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Lastname"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "PrimaryOrganisationID"
                     }
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ValidID"
                     }
                  }
               ]
            ],
            "title": null,
            "style": "",
            "separator": true
         },
         {
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "UserLogin"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "USER_ACCESS"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "UserLanguage"
                     }
                  }
               ]
            ],
            "title": null,
            "style": null,
            "separator": true
         },
         {
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Phone"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Mobile"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Fax"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Email"
                     },
                     "conditions": null,
                     "icon": null,
                     "iconStyle": "",
                     "text": "",
                     "textPlaceholder": null,
                     "textStyle": "",
                     "detailViewWidthFactor": "2"
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Email1"
                     },
                     "conditions": [
                        {
                           "property": "Email1",
                           "operator": "NE",
                           "value": "",
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ],
                     "icon": null,
                     "iconStyle": "",
                     "text": "",
                     "textPlaceholder": null,
                     "textStyle": "",
                     "detailViewWidthFactor": "2"
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Email2"
                     },
                     "conditions": [
                        {
                           "property": "Email2",
                           "operator": "NE",
                           "value": "",
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ],
                     "icon": null,
                     "iconStyle": "",
                     "text": "",
                     "textPlaceholder": null,
                     "textStyle": "",
                     "detailViewWidthFactor": "2"
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Email3"
                     },
                     "conditions": [
                        {
                           "property": "Email3",
                           "operator": "NE",
                           "value": "",
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ],
                     "icon": null,
                     "iconStyle": "",
                     "text": "",
                     "textPlaceholder": null,
                     "textStyle": "",
                     "detailViewWidthFactor": "2"
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Email4"
                     },
                     "conditions": [
                        {
                           "property": "Email4",
                           "operator": "NE",
                           "value": "",
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ],
                     "icon": null,
                     "iconStyle": "",
                     "text": "",
                     "textPlaceholder": null,
                     "textStyle": "",
                     "detailViewWidthFactor": "2"
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Email5"
                     },
                     "conditions": [
                        {
                           "property": "Email5",
                           "operator": "NE",
                           "value": "",
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ],
                     "icon": null,
                     "iconStyle": "",
                     "text": "",
                     "textPlaceholder": null,
                     "textStyle": "",
                     "detailViewWidthFactor": "2"
                  }
               ]
            ],
            "title": null,
            "style": null,
            "separator": true
         },
         {
            "title": "Info",
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.MyDynamicField"
                     }
                  }
               ]
            ]
         },
         {
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Street"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Zip"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "City"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Country"
                     }
                  }
               ]
            ],
            "title": null,
            "style": null,
            "separator": true
         },
         {
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "CreateTime"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "CreateBy"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ChangeTime"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ChangeBy"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.Source"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.Source",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ],
            "title": null,
            "style": null,
            "separator": true
         },
         {
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Comment"
                     }
                  }
               ]
            ]
         }
      ]
   },
   "minimized": false,
   "minimizable": true,
   "icon": null,
   "contextDependent": false,
   "contextObjectDependent": false,
   "formDependent": false,
   "formDependencyProperties": [],
   "valid": true,
   "application": "agent-portal"
}
{
   "id": "organisation-details-info-widget",
   "name": "Organisation Info Widget",
   "type": "Widget",
   "widgetId": "object-information-card-widget",
   "title": "Translatable#Organisation Information",
   "actions": [],
   "subConfigurationDefinition": null,
   "configuration": {
      "id": "1692622104699",
      "name": "1692622104699",
      "type": null,
      "valid": true,
      "application": "agent-portal",
      "avatar": [],
      "rows": [
         {
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "icon",
                     "componentData": {
                        "icon": {
                           "propertyBindings": [],
                           "Links": [],
                           "LinkTypeName": null,
                           "ChangeBy": null,
                           "ChangeTime": null,
                           "CreateBy": null,
                           "CreateTime": null,
                           "ValidID": 1,
                           "Comment": null,
                           "DynamicFields": [],
                           "LinkCount": 0,
                           "displayValues": [],
                           "displayIcons": [],
                           "KIXObjectType": "OBJECT_ICON",
                           "ObjectID": "<KIX_ORGANISATION_ID>",
                           "ObjectId": "<KIX_ORGANISATION_ID>",
                           "Object": "Organisation",
                           "ContentType": null,
                           "Content": null,
                           "fallbackIcon": "kix-icon-man-house"
                        },
                        "style": "width: 5rem;height:5rem;font-size:5rem;"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Number"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Name"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.Type"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Url"
                     }
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ValidID"
                     }
                  }
               ]
            ]
         },
         {
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Street"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Zip"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "City"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Country"
                     }
                  }
               ]
            ]
         },
         {
            "style": "",
            "title": "Info",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.MyDynamicField"
                     }
                  }
               ]
            ]
         },
         {
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "CreateTime"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "CreateBy"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ChangeTime"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ChangeBy"
                     }
                  }
               ]
            ]
         },
         {
            "style": "",
            "separator": false,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Comment"
                     }
                  }
               ]
            ]
         }
      ]
   },
   "minimized": false,
   "minimizable": true,
   "icon": null,
   "contextDependent": false,
   "contextObjectDependent": false,
   "formDependent": false,
   "formDependencyProperties": [],
   "valid": true,
   "application": "agent-portal"
}
{
   "id": "faq-article-info-widget",
   "name": "FAQ Article Info",
   "type": "Widget",
   "widgetId": "object-information-card-widget",
   "title": "Translatable#FAQ Information",
   "actions": [],
   "subConfigurationDefinition": null,
   "configuration": {
      "id": "1692622173540",
      "name": "1692622173540",
      "type": null,
      "valid": true,
      "application": "agent-portal",
      "avatar": [],
      "rows": [
         {
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "CategoryID"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "CustomerVisible"
                     }
                  },
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "DynamicFields.MyDynamicField"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.MyDynamicField",
                           "operator": "NE",
                           "value": null
                        }
                     ]
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ValidID"
                     }
                  }
               ]
            ]
         },
         {
            "style": "",
            "separator": true,
            "values": [
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Created"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "CreatedBy"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "Changed"
                     }
                  }
               ],
               [
                  {
                     "componentId": "object-avatar-label",
                     "componentData": {
                        "property": "ChangedBy"
                     }
                  }
               ]
            ]
         },
         {
            "title": "Translatable#References",
            "style": "",
            "separator": false,
            "values": [
               [
                  {
                     "text": "Translatable#Related Assets",
                     "textStyle": "font-weight:bold;margin-bottom:0.5rem",
                     "detailViewWidthFactor": "1",
                     "icon": "kix-icon-ci",
                     "componentId": "dynamic-field-value",
                     "componentData": {
                        "name": "RelatedAssets"
                     },
                     "conditions": [
                        {
                           "property": "DynamicFields.RelatedAssets",
                           "operator": "NE",
                           "value": null,
                           "useObjectService": false,
                           "useDisplayValue": false
                        }
                     ]
                  }
               ]
            ]
         }
      ]
   },
   "minimized": false,
   "minimizable": true,
   "icon": null,
   "contextDependent": false,
   "contextObjectDependent": false,
   "formDependent": false,
   "formDependencyProperties": [],
   "valid": true,
   "application": "agent-portal"
}

Die Bereitstellung eines Dynamischen Feldes in Tabellen-Widgets wie bspw. in den Tabellen des Home Dasboards oder in den Sidebar-Widgets der Ticketdetails erfolgt über die Konfiguration der jeweiligen SysConfig-Schlüssel im Menü System > SysConfig

Eine Übersicht der meistverwendeten Konfigurationsschlüssel finden Sie unter: Häufig verwendete SysConfig-SchlüsselHäufig verwendete SysConfig-Schlüssel

Im folgenden Beispiel wird die an einem Ticket hinterlegte Seriennummer in einer zusätzlichen Spalte der Tabelle Neue Tickets im Home Dashboard angezeigt. Voraussetzung hierfür ist, dass ein entsprechendes Dynamisches Feld im System angelegt und in einen Dialog integriert wurde, sodass von den Agenten die Seriennummer am Ticket hinterlegt werden konnte.

  1. Navigieren Sie zum Menü System > SysConfig.

  2. Suchen und öffnen Sie den SysConfig-Schlüssel home-dashboard-ticket-table-new

    In diesem Schlüssel ist die Konfiguration für die Tabelle Neue Tickets im Home Dashboard hinterlegt.

    Alternativ: Sie können den SysConfig-Schlüssel eines anderen Tabellen-Widgets verwenden, um dort den Wert des Dynamischen Feldes anzeigen zu lassen.

  3. Optional: Kopieren Sie den Quellcode im Feld Wert in einen externen JSON-Editor, um ihn besser editieren zu können. 

    df-wert-darstellen_json-editor.png
  4. Kopieren Sie den nachfolgenden Codeblock an gewünschter Stelle innerhalb des tableColumns-Block.

    {
          "id": null,
          "name": null,
          "type": null,
          "property": "DynamicFields.DFSerialNumber",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": true,
          "size": 225,
          "sortable": true,
          "filterable": true,
          "hasListFilter": false,
          "dataType": "STRING",
          "resizable": true,
          "componentId": null,
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true,
          "useObjectServiceForFilter": false
        },

    Mit Ihrer Platzierung legen Sie fest, an welcher Stelle in der Tabelle die Spalte für die Anzeige des Dynamische Felds eingefügt wird.

    df-wert-darstellen_tbl-widget_PlatzierungImCode.png

    Optional: Zum Einbinden mehrerer Dynamischer Felder fügen Sie den Quelltext mehrfach ein. Trennen Sie die einzelnen Codeabschnitte durch Kommas.

  5. Ersetzen Sie im Parameter property den im Beispiel verwendeten Namen des Dynamischen Feldes (DFSerialNumber) durch den Namen Ihres eigenen Dynamischen Feldes.

    Es ist der in der Konfiguration des Dynamischen Feldes definierte Name anzugeben.

    Verwenden Sie folgende Syntax: DynamicFields.NameDesDynamischenFeldes.

    Haben Sie mehrere Dynamische Felder eingebunden, ersetzen Sie diese Namen ebenso.

    Tipp: Sie können unter property auch Ticketattribute angeben (z. B. ContactID), wenn dieses anstelle des Dynamischen Feldes n der Spalte angezeigt werden soll.

    Optional: Die unter componentID angegebene Komponente steuert die Anzeige des Wertes. Geben Sie dynamic-field-checklist-cell an, wenn Sie den Fortschrittsbalken einer Checkliste anzeigen lassen möchten. Geben Sie sla-criteria-cell an, wenn das SLA-Kriterium angegeben werden soll.

  6. Minimieren Sie im Editor den Quellcode, um unnötige Leerzeichen und Zeilenumbrüche zu entfernen und kopieren Sie ihn in die Zwischenablage.

    df-einbinden-minimieren.png
  7. Fügen Sie den Quellcode aus der Zwischenablage zurück nach KIX ins Feld Wert

  8. Klicken Sie abschließend auf Speichern.

  9. Klicken Sie im Header der SysConfig auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

In der Tabelle Neue Tickets des Home Dashboards ist nun eine zusätzliche Spalte für die Anzeige des im Dynamischen Feld gespeicherten Wertes eingefügt.

Die Konfiguration einiger Tabellen ist direkt im Backend verankert. Zum Beispiel die Übersicht Organisationen im Organisationen Dashboard. Im SysConfig-Schlüssel ist daher keine sichtbare Tabellenkonfiguration enthalten.

Möchten Sie diese Tabellen individuell konfigurieren, um bspw. eine weitere Tabellenspalte hinzuzufügen, müssen Sie der Konfiguration das komplette Set an Tabellenspalten mitgeben - einschließlich der bereits im Backend existierenden Tabellenspalten.

Im folgenden Beispiel wird der Übersicht Organisationen im Organisationen Dashboard eine weitere Tabellenspalte hinzugefügt, in der die vom Agenten angegebene Kurzbezeichnung (ShortName) angezeigt wird. Voraussetzung hierfür ist, dass das Dynamisches Feld ShortName bereits angelegt und in den Dialog Organisation bearbeiten integriert ist (s. auch: Beispiel: Integration in den Dialog "Organisation bearbeiten").

  1. Navigieren Sie zum Menü System > SysConfig.

  2. Suchen und öffnen Sie den SysConfig-Schlüssel customer-dashboard-table.

    In diesem Schlüssel ist der Aufbau der Übersicht Organisationen im Organisationen Dashboard konfiguriert.

  3. Kopieren Sie den nachfolgenden Quellcode in einen externen JSON-Editor. In der maximierten Ansicht können Sie den Code leichter bearbeiten.

    {
      "id": "customer-dashboard-table",
      "name": "Organisations Table",
      "type": "Table",
      "objectType": "Organisation",
      "loadingOptions": null,
      "displayLimit": 10,
      //Definition der Tabellenspalten
      "tableColumns": [
        //Initiale Spalte "Nummer"
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "Number",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "resizable": true,
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true
        },
        // Initiale Spalte "Name"   
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "Name",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "resizable": true,
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true
        },
        // Zusätzliche Tabellenspalte für Anzeige der Kurzbezeichnung
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "DynamicFields.ShortName",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "size": 50,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "dataType": "STRING",
          "resizable": true,
          "componentId": "label-list-cell-content",
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true,
          "useObjectServiceForFilter": false
        },  // Ende der Tabellenspalte
    
        //Nachfolgend weitere initiale Tabellenspalten
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "Street",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "size": 150,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "dataType": "STRING",
          "resizable": true,
          "componentId": "label-list-cell-content",
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true,
          "useObjectServiceForFilter": false
        },
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "Zip",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "size": 30,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "dataType": "STRING",
          "resizable": true,
          "componentId": "label-list-cell-content",
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true,
          "useObjectServiceForFilter": false
        },
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "City",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "size": 100,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "dataType": "STRING",
          "resizable": true,
          "componentId": "label-list-cell-content",
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true,
          "useObjectServiceForFilter": false
        },
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "Country",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "size": 50,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "dataType": "STRING",
          "resizable": true,
          "componentId": "label-list-cell-content",
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true,
          "useObjectServiceForFilter": false
        },
        {
          "id": null,
          "name": null,
          "type": null,
          "property": "ValidID",
          "showText": true,
          "showIcon": false,
          "showColumnTitle": true,
          "showColumnIcon": false,
          "size": 50,
          "sortable": true,
          "filterable": true,
          "hasListFilter": true,
          "dataType": "STRING",
          "resizable": true,
          "componentId": "label-list-cell-content",
          "defaultText": null,
          "translatable": true,
          "titleTranslatable": true,
          "useObjectServiceForFilter": false
        }
      ],
      "tableColumnConfigurations": null,
      "enableSelection": true,
      "toggle": false,
      "headerHeight": 2.25,
      "rowHeight": 1.75,
      "emptyResultHint": "Translatable#0 data sets found.",
      "fixedFirstColumn": false,
      "additionalTableObjectsHandler": [],
      "intersection": true,
      "searchId": null
    }
  4. Entfernen Sie die Kommentare im Code und ändern Sie ggf. den unter property angegebenen Namen des Dynamischen Feldes. Geben Sie den von Ihnen verwendeten Namen an.

  5. Optional: Konfigurieren Sie den Code nach Bedarf, indem Sie beispielsweise weitere Tabellenspalten in den Code einfügen oder nicht benötigte entfernen.

    Info: Jede Tabellenspalte ist in geschweifte Klammern gesetzt. Mehrere Tabellenspalten sind durch Komma voneinander getrennt.

    Hinweis: Im Abschnitt tableColumns sind die einzelnen Tabellenspalten definiert. Sie können das Beispiel nutzen, um auch in anderen Tabellenwidgets eine Tabelle aufzubauen. Kopieren Sie dazu den kompletten Abschnitt "tableColumns": [{Spalte1},{Spalte2},{..}] und ersetzen Sie damit die Zeile "tableColumns":null in der initialen Konfiguration des entsprechenden SysConfig-Schlüssels. Ändern Sie dann die einzelnen Spalten nach Bedarf.

  6. Minimieren Sie im Editor den Quellcode, um unnötige Leerzeichen und Zeilenumbrüche zu entfernen und kopieren Sie den Quellcode in die Zwischenablage.

  7. Fügen Sie den Quellcode aus der Zwischenablage zurück ins Feld Wert des SysConfig-Schlüssels ein und übernehmen Sie die Änderungen mit Speichern.

  8. Klicken Sie im Header der SysConfig auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.