Skip to main content

Ein eigenes Widget implementieren

Sie können im Self Service Portal zusätzliche Objekt-Info-Widgets einbinden. Sie haben damit die Möglichkeit, Dynamische Felder in strukturierter Form bereitzustellen.

Die nachfolgende Anleitung fügt ein Objekt-Info-Widget (My Ticket Widget) in die Ticket Detailansicht ein. Das Widget enthält ein Dynamisches Feld (DF1). Sie können sich am Beispiel orientieren, wenn Sie anderweitig ein Objekt-Info-Widget einbinden möchten.

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

  2. Suchen und öffnen Sie den SysConfig-Schlüssel ssp-ticket-details-context.

    Alternativ: Öffnen Sie den entsprechenden Schlüssel, in welchem Sie das Dynamische Feld einfügen möchten.

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

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

    {
        "instanceId": "my-ssp-dynamic-fields-widget",    
        "configurationId": "my-ssp-dynamic-fields-widget",
        "configuration": {
        "id": "my-ssp-dynamic-fields-widget",
        "name": "Special Informations",
        "type": "Widget",
        "widgetId": "ssp-dynamic-fields-widget",    // muss ssp-dynamic-field-widgets sein
        "title": "Translatable#Special Informations",
        "actions": [],
        "subConfigurationDefinition": null,
        "configuration": {
            "id": "4711",
            "name": "4711",
            "type": null,
            "valid": true,
            "roleIds": [],
            "application": "agent-portal",
            "avatar": [],
            "rows": [
            {
                "values": [
                {
                    "text": "",
                    "style": "",
                    "componentId": "ssp-dynamic-field-value", // muss ssp-dynamic-field-value sein
                    "componentData": {
                    "name": "DFName"
                    },
                    "conditions": [
                      {
                        "property": "DynamicFields.DFName",
                        "operator": "NE",
                        "value": null
                      }
                    ],
                    "detailViewWidthFactor": "4"
                }
                ],
                "title": "",
                "style": "",
                "separator": false,
                "roleIds": []
              }
            ]
        },
        "minimized": false,
        "minimizable": true,
        "icon": "",
        "contextDependent": false,
        "contextObjectDependent": false,
        "formDependent": false,
        "formDependencyProperties": [],
        "valid": true,
        "application": "SSP",
        "roleIds": []
        },
        "permissions": [],
        "size": "large",
        "roleIds": [],
        "conditions": []
     },
  4. Ersetzen Sie DFName durch den Namen des Dynamischen Feldes, welches Sie einbinden möchten.

    Ersetzen Sie den unter instanceId, configurationId und id angegebenen Wert (my-ssp-dynamic-field-widget) durch einen selbst definierten Wert. Dieser kann beliebig sein, darf aber nur einmal im gesamten SysConfig-Schlüssel existieren.

    Ersetzen Sie den unter name und title angegebenen Wert durch einen eigenen Titel.

    Ersetzen Sie die id und den name, welche in der configuration angegeben sind (4711), durch einen selbst definierten numerischen Wert.

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

  5. Optional: Duplizieren Sie den unter values[...] angegebenen Codeblock, wenn Sie weitere Dynamische Felder hinzufügen möchten.

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

Danach enthält die Ticket Detailansicht ein weiteres Widget mit den darin definierten Dynamischen Feldern.

Verweise: