Skip to main content

Konfiguration statischer Widgets

Sie können statische Widgets ins Home Dashboard des SSP konfigurieren und darin individuelle Informationen sowie interne und externe Hyperlinks. Das Widget Information wird in deaktiviertem Zustand ausgeliefert. Bei Bedarf können Sie dieses aktivieren und den angezeigten Inhalt anpassen.

SSP_InfoWidget.png

Abb.: Das Information Widget im Home Dashboard des SSP

Das Information Widget aktivieren

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

  2. Suchen und öffnen Sie den Konfigurationsschlüssel SSP Home Context

  3. Navigieren Sie im Abschnitt content zu "instanceID" : "ssp-common-info-widget"

  4. Ändern Sie den Parameter valid auf true.

    SSP_GUI_Konfig_statisches-InfoWidget.png

  5. Speichern Sie Ihre Änderungen mit Speichern.

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

Danach ist das Widget Information im Home Dashboard des Self Services Portal enthalten

Den Widget-Inhalt anpassen

Sie können den im Widget angezeigten Inhalt nach Erfordernis anpassen. Als Grundlage kann Ihnen die Konfiguration im SysConfig-Schlüssel ssp-home-context dienen.

Im content des SysConfig-Schlüssels sind die Widgets des Home Dashboards definiert. Im content der Widgets ist der anzuzeigende Inhalt festgelegt. Der Widget-content ist ein Array von Objekten mit folgenden Eigenschaften:

SSP_GUI_Konfig_InfoWidget_config.png

Abb.: Information Widget mit geändertem Inhalt und einer zusätzlichen Sprache

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

  2. Suchen und öffnen Sie den Konfigurationsschlüssel SSP Home Context

  3. Navigieren Sie im Abschnitt content zu "instanceID" : "ssp-common-info-widget"

    Wenn Sie ein selbst hinzugefügtes Widget ändern möchten, navigieren Sie zu diesem.

  4. Ändern Sie den Inhalt von htmlContent nach Erfordernis. Beachten Sie dabei die eingangs erwähnten Hinweise.

  5. Optional: Ändern/Ergänzen Sie die Lokalisierung, wenn Sie für KIX weitere Sprachen pflegen.

  6. Speichern Sie Ihre Änderungen mit Speichern.

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

Der geänderte Inhalt wird im Information Widget des SSP angezeigt. Die vom Nutzer eingestellte Sprache wird dabei berücksichtigt. Ggf. müssen die SSP-Nutzer ihren Browser aktualisieren.

Weitere Widgets einbinden

Sie können zusätzliche Widgets ins Home Dashboard des SSP integrieren, um bspw. die bereitzustellenden Inhalte zu kategorisieren. Die Widgets können in Zeilen und Spalten positioniert werden. Sie können festlegen, ob das Widget die volle Seitenbreite oder 1/3 der Seitenbreite einnimmt.

SSP_GUI_Konfig_InfoWidget_newWidget.png

Abb.: 2 zusätzliche Widgets im Home Dashboard des SSP

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

  2. Suchen und öffnen Sie den Konfigurationsschlüssel SSP Home Context

  3. Duplizieren Sie den Codeblock für das Information Widget. Er dient Ihnen als Grundlage für ein neues Widget.

    SSP_GUI_Konfig_InfoWidget_newWidget-duplicate.png

  4. Ändern Sie die IDs des Widgets. Jedes Widget darf im Context nur einmal existieren. Passen Sie dazu folgende Parameter an:

    • instanceID

    • configurationID

    • id

  5. Optional: Ändern Sie den title. Der title definiert den Widget-Titel.

    Verwenden Sie das Präfix Translatable#, wenn der Titel übersetzt werden soll (Translatable#myWidgetTitle)

  6. Definieren Sie für jede Sprache den im Widget anzuzeigenden Inhalt (s. Den Widget-Inhalt anpassen).

  7. Optional: Legen Sie im Parameter size die Breite des Widgets fest. Ggf. müssen Sie die anderen Widgets ebenfalls in der Breite anpassen.

    • small: 1/3 der Seitenbreite

    • large: ganze Seitenbreite

  8. Optional: Legen Sie im Parameter roleIds fest, welche Benutzerrollen die Inhalte bzw. das Widget sehen dürfen.

  9. Speichern Sie Ihre Änderungen mit Speichern.

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

Das Widget wird im Home Dashboard des SSP angezeigt. Die vom Nutzer eingestellte Sprache wird dabei berücksichtigt. Ggf. müssen die SSP-Nutzer ihren Browser aktualisieren.

Beispiel: Konfiguration eines zusätzlichen Widgets

{
      "instanceId": "ssp-common-info-widget-new",
      "configurationId": "ssp-common-info-widget-new",
      "configuration": {
        "id": "ssp-common-info-widget-new",
        "name": "Common Information Widget",
        "type": "Widget",
        "widgetId": "ssp-html-widget",
        "title": "Translatable#Contacts",
        "actions": [],
        "configuration": {
          "id": "ssp-common-info-widget-content",
          "name": "Common Information Widget Content",
          "type": "HTMLWidget",
          "application": "SSP",
          "valid": true,
          "roleIds": [],
          "content": [
            {
              "language": "en",
              "htmlContent": "<table><tr><th>Function</th><th>Name</th></tr><tr><td>Service</td><td>U. Friedrich</td></tr><tr><td>Management</td><td>A. Attalam</td></tr><tr><td>Administration</td><td>I. Linke</td></tr></table>  "
            },
            {
              "language": "de",
              "htmlContent": "<table><tr><th>Funktion</th><th>Name</th></tr><tr><td>Service</td><td>U. Friedrich</td></tr><tr><td>Management</td><td>A. Attalam</td></tr><tr><td>Administration</td><td>I. Linke</td></tr></table>"
            }
          ]
        },
        "minimized": false,
        "minimizable": true,
        "icon": "",
        "contextDependent": false,
        "contextObjectDependent": false,
        "formDependent": false,
        "formDependencyProperties": [],
        "valid": true,
        "application": "agent-portal",
        "roleIds": []
      },
      "permissions": [],
      "size": "small",
      "roleIds": [],
      "conditions": []
    },
In diesem Abschnitt: