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 oder bequem im Menü System GUI Konfiguration Agentenportal | Self Service Portal.

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 im Explorer zu System > GUI Konfiguration > Agentenportal.

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

    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. 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.

  4. 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
  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.

  6. Klicken Sie abschließend auf Speichern.

  7. 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 oder bequem im Menü System > GUI Konfiguration Agentenportal | Self Service Portal.

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 im Explorer zu System > GUI Konfiguration > Agentenportal.

  2. Suchen und öffnen Sie den SysConfig-Schlüssel home-dashboard-ticket-table-new (New Tickets Table)

    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. 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.

  4. 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.

  5. Klicken Sie abschließend auf Speichern.

  6. 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 im Explorer zu System > GUI Konfiguration > Agentenportal.

  2. Suchen und öffnen Sie den SysConfig-Schlüssel Organisations 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.

Dynamische Felder können in der Kommunikationshistorie am Artikel angezeigt werden. Es ist damit möglich, zusätzliche Informationen am Artikel zu speichern und diese in der Kommunikationshistorie in der Ticket Detailansicht anzuzeigen.

df-objecttype-article_communicationWidget-de.png

Abb.: Anzeige des im Dynamischen Feld gespeicherten Wert am Artikel

Voraussetzung dafür ist, dass dem Dynamischen Feld der Objekttyp Article zugeordnet ist und dass das Dynamische Feld in eine Aktion oder Vorlage eingebunden wurde, sodass Agenten darin Informationen hinterlegen können. Beachten Sie bei der Konfiguration der Aktion/Vorlage, dass das Dynamisches Feld nur dann angezeigt wird, wenn ein Kanal ausgewählt wurde. Binden Sie daher ggf. zusätzlich das Feld "Kanal" in die Aktion/Vorlage ein.Article

Um die im Dynamischen Feld gespeicherten Werte am Artikel anzuzeigen, müssen Sie das Dynamische Feld in die Konfiguration des Communication Widgets manuell integrieren. Sie können mehrere Dynamische Felder integrieren.

Gehen Sie dazu wie folgt vor:

  1. Navigieren Sie im Explorer zu System > GUI Konfiguration > Agentenportal.

  2. Suchen und öffnen Sie den SysConfig-Schlüssel ticket-communication-widget.

    In diesem Schlüssel ist die Konfiguration für die Kommunikationshistorie in den Ticketdetails hinterlegt.

  3. Navigieren Sie im Konfigurationsschlüssel zu "articleInformationConfiguration".

  4. Fügen Sie unter "rows":[ ] nachfolgenden Code in die eckigen Klammern ein.

    {
       "title": "Translatable#Short Description",
       "style": "",
       "separator": true,
       "values": [
          {
             "componentId": "object-avatar-label",
             "componentData": {
                "property": "DynamicFields.Article-DF"
             },
             "conditions": [
                {
                   "property": "DynamicFields.Article-DF",
                   "operator": "NE",
                   "value": null
                }
             ]
          }
       ]
    }
    df-objecttype-article_communicationWidget_konfig.png

    Optional: Sie können den Codeblock mehrfach einfügen, wenn weitere Dynamische Felder angezeigt werden sollen. Trennen Sie dann die Codeblöcke mit Komma voneinander.

  5. Ersetzen Sie den im Beispiel verwendeten Namen "Article-DF" durch den Namen des Dynamischen Feldes, welches Sie einbinden möchten.

  6. Optional: Sie können die Konfiguration nach Bedarf weiter anpassen, z. B. um die Bedingungen für die Anzeige zu ändern (conditions)

  7. Klicken Sie abschließend auf Speichern.

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

Danach werden die im Dynamischen Feld gespeicherten Informationen am Artikel angezeigt.