Verwaltung und Anpassung des Knowledge Base-Widgets

Du kannst jedes Knowledge Base-Widget anpassen, um das Nutzererlebnis zu verbessern.

Bearbeiten eines Widgets

1. Melden Sie sich im Knowledge base portal an und wählen Sie Ihr Wunschprojekt aus.

2. Navigiere zu Connections () > Wissensdatenbank-Widget in der linken Navigationsleiste. Du wirst eine Liste bestehender Widgets sehen.

3. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

   

Styling des Widgets

Im Reiter Konfigurieren & Verbinden erweitern Sie das Akkordeon des Style-Widgets .

Die folgenden Widget-Anpassungsoptionen stehen zur Verfügung:

• Widget-Farbe

• Widget-Symbol

• Widget-Position

• Begrüßungsbotschaft

• Widget ausblenden

• Meistgesuchte Artikel ausblenden

Widget-Farbe

Du kannst eine Theme-Farbe für das Widget wählen, die auch die Symbolfarbe festlegt.

1. Klicken Sie auf Farbe ändern , um die Farbpalette zu öffnen.

2. Wählen Sie eine Farbe mit dem Picker aus oder geben Sie einen Hex-, RGB- oder HSL-Code ein.

Widget-Symbol

Ähnlich können Sie unter dem Bereich der Widget-Farbe das Symbol durch ein Bild oder ein verfügbares Symbol ersetzen.

1. Klicken Sie auf das Symbol "Ändern".

2. Wählen Sie aus dem Tab Icon Set oder fügen Sie ein Bild unter Bild einfügen ein:

   1. Von URL: Fügen Sie den Bildlink ein und klicken Sie auf Einfügen.

   2. Vom Gerät: Klicken Sie auf Bild hochladen und wählen Sie eine Datei aus.

3. Klicke auf Standard, um zum ursprünglichen Symbol zurückzusetzen.

Widget-Position

Kontrollieren Sie, wo das Widget auf Ihrer Website erscheint:

• Wähle links oder rechts.

• Stellen Sie die Werte für Seitenabstand und Unterabstand ein, um das Widget zu positionieren.

Begrüßungsbotschaft

Fügen Sie eine kurze Nachricht hinzu, um die Leser zu begrüßen, bevor sie mit dem Widget interagieren. Die Nachricht erscheint als Chatblase über dem Widget-Symbol und hilft ihnen, das Widget zu erkennen und einfach auf Hilfeinhalte zuzugreifen.

HINWEIS

Die Begrüßungsnachricht hat ein Limit von 50 Zeichen.

Widget ausblenden

Standardmäßig ist der Umschalter "Verbergen " deaktiviert, sodass das Knowledge Base-Widget auf der Seite sichtbar bleibt. Um das Widget auszublenden, aktivieren Sie einfach den Umschalter "Widget ausblenden ".

Meistgesuchte Artikel ausblenden

Aktivieren Sie den Schalter "Meistgesuchte Artikel ausblenden ", um die obersten Suchartikel auszublenden.

HINWEIS

Das Aktivieren des Umschalters "Meistgesuchte Artikel ausblenden " deaktiviert die URL-Zuordnung für das Widget.

Sobald deine Änderungen vorgenommen sind, klicke neben dem Widget-Namensfeld auf Speichern .

HINWEIS

Die Autosave-Option ist für die Navigation zwischen den Wissensdatenbank-Widget-Tabs verfügbar.

Inhaltszugriff für das Knowledge Base-Widget

Du kannst den Inhaltszugriff in deinem Knowledge Base-Widget konfigurieren, selbst wenn JWT für das Widget aktiviert ist. Das gibt Ihnen mehr Flexibilität bei der Kontrolle, was Ihre Endnutzer sehen können.

Um den Inhaltszugriff mit aktiviertem JWT zu konfigurieren:

1. Navigiere zu Connections () > Wissensdatenbank-Widget in der linken Navigationsleiste.

2. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

3. Im Reiter "Konfigurieren & verbinden " erweitern Sie den Bereich Inhaltszugriff .

4. Die verfügbaren Filterstufen sind:

   • Projekt

   • Arbeitsbereich

   • Kategorie

5. Wählen Sie die gewünschten Arbeitsbereiche, Sprachen und Kategorien aus, die im Widget angezeigt werden.

6. Klicken Sie auf Fertig und dann auf Speichern , um die Änderungen anzuwenden.

Validierung der Inhaltsberechtigungen von Lesergruppen

• Wenn sich ein Reader anmeldet, prüft das System, ob die Berechtigungen seiner Lesergruppen mit den Inhaltszugriffsfiltern des Widgets übereinstimmen. Nur die sich schneidenden Berechtigungen zwischen den Widget-Level-Einstellungen und den Lesergruppen-Einstellungen werden zur Validierung berücksichtigt.

• Dies stellt sicher, dass Nutzer nur die Artikel sehen, für die sie autorisiert sind, sowohl auf Widget-Ebene als auch in Lesergruppen-Berechtigungen.

• Die gleiche Validierung wird angewendet, wenn Leser auf interne Links klicken, die auf beliebige Artikel- oder Kategorielinks innerhalb des Widgets zielen. Das Widget überprüft die konfigurierten Inhaltszugriffsfilter, den Arbeitsbereich und die Lesergruppenberechtigungen, bevor der Zielinhalt geladen wird. Wenn der verlinkte Inhalt außerhalb des erlaubten Umfangs liegt, zeigt das Widget einen Restricted Access Zustand an, anstatt den Artikel zu rendern.

VORSICHT

Änderungen am Inhaltszugriff wirken sich direkt auf deine URL-Zuordnung aus.

Wenn du die Filtereinstellungen des Widgets änderst, kann das bestehende URL-Mapping entfernt werden, was zu defekten Links führt.

Beispiel 1:
Sie haben den Filter-Widget-Inhalt auf Projektebene gesetzt und eine URL-Zuordnung konfiguriert, die eine Liste von Artikeln aus Kategorie A in Workspace V1 enthält. Wenn Sie die Filtereinstellungen so aktualisieren, dass nur noch die Kategorien B und C im selben Arbeitsbereich angezeigt werden, wird die vorherige URL-Zuordnung ungültig – da die ursprünglich zugeordneten Artikel aus Kategorie A im Widget nicht mehr verfügbar sind.

Sie können URL-Zuordnungen nur anhand von Artikeln konfigurieren, die im aktuellen Filter-Widget-Inhalt enthalten sind.

Beispiel 2:
Wenn das Widget so gefiltert ist, dass Inhalte nur aus Workspace V1 angezeigt werden, können Sie keine URL-Zuordnung für einen Artikel in Workspace V2 erstellen.

Hinzufügen benutzerdefinierter Links

Du kannst benutzerdefinierte Links zum Knowledge Base-Widget hinzufügen. Die Links erscheinen in der Reihenfolge, in der sie erstellt wurden. Nutzen Sie diese Option, um Endnutzer auf bestimmte Seiten oder Ressourcen zu verweisen. Alle vom Widget geöffneten Links werden immer in einem neuen Browser-Tab geöffnet.

 HINWEIS

Interne Artikel- und Kategorienlinks folgen den Widget-Navigationsregeln, die auf Arbeitsflächentyp, Inhaltszugriffsbereich und Lesergruppenberechtigungen basieren. Siehe den FAQ-Abschnitt für weitere Details.

Um einen benutzerdefinierten Link hinzuzufügen:

1. Navigiere zu  Connections () > Wissensdatenbank-Widget in der linken Navigationsleiste.

2. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

3. Im Reiter "Konfigurieren & verbinden " erweitern Sie das Akkordeon "Verknüpfungen hinzufügen "

4. Im Feld Abschnittstitel geben Sie den gewünschten Titel für diesen Abschnitt ein. Das wird im Widget angezeigt.

5. Unter dem Abschnittstitel wählen Sie für jeden Link das gewünschte Symbol, den Linktext (der im Widget erscheint) und den Ziellink aus.

   Beispiel:

   • Ikone:

   • Linktext: Kontaktieren Sie uns

   • Link: support@document360.com

     HINWEIS

   Du kannst eine mailto: im Linkfeld verwenden. Zum Beispiel: Mailto:<youremail@somedomain.com>

6. Klicken Sie auf Hinzufügen, und der Link wird hinzugefügt. Wiederhole die Schritte, um zusätzliche Links hinzuzufügen.

7. Zum Bearbeiten klicken Sie auf das Bearbeiten ()-Symbol. Klicken Sie zum Speichern und zum Entfernen.

8. Klicken Sie auf das Löschen ()-Symbol neben den Links, um sie zu löschen.

9. Wenn du fertig bist, klicke auf Speichern , um die Änderungen zu speichern.

   

Domänenbeschränkung

Document360 erlaubt es, das Knowledge Base-Widget auf bestimmte Domänen zu beschränken. Sobald eine Domain zur Widget-Sicherheitsliste hinzugefügt wurde, muss jedes Projektmitglied, das das Knowledge Base-Widget auf einer anderen Domain installieren möchte, diese Domain im Bereich Widget-Sicherheit hinzufügen.

Wenn keine Domains zur Liste hinzugefügt werden, kann das Knowledge Base-Widget uneingeschränkt in jede SaaS-Anwendung oder öffentliche Website eingebettet werden.

 HINWEIS

Der API-Schlüssel des Knowledge Base-Widgets ist im Klartext im JavaScript-Code des Widgets sichtbar und kann nicht verschlüsselt werden. Die Konfiguration vertrauenswürdiger Domains ist die empfohlene Methode, um unbefugte Nutzung Ihres Widgets zu verhindern. Sobald Domains hinzugefügt wurden, lädt das Widget nur noch auf diesen angegebenen Domains; jeder Versuch, es in eine nicht gelistete Domain einzubetten, wird blockiert. Wenn keine vertrauenswürdigen Domains konfiguriert sind, kann das Widget in jede beliebige Domain eingebettet werden, was das Risiko unbefugter Nutzung erhöht.

Beschränke das Knowledge Base-Widget auf eine bestimmte Domäne

Um Ihr Knowledge Base-Widget auf eine bestimmte Domäne zu beschränken,

1. Navigiere zu Connections () > Wissensdatenbank-Widget in der linken Navigationsleiste.

2. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

3. Im Reiter "Konfigurieren & verbinden " erweitern Sie das Widget-Sicherheitsakkordeon . Du kannst die Liste der zuvor hinzugefügten Domains finden (falls vorhanden).

4. Gib die Domain ein, in der das Knowledge Base-Widget angezeigt werden soll.

5. Klicken Sie auf Hinzufügen und klicken Sie auf Speichern , um Änderungen anzuwenden.

   

HINWEIS

Das "www" ist kein gültiger Teil deiner Domain. Füge nur das hinzu, was nach dem Internet kommt. in deiner URL.

Beispiel: document360.com

• Wildcard-Notation wird nicht unterstützt. Du kannst ** nicht verwenden. domain.com , alle Unterdomänen gleichzeitig zuzulassen.

• URL-Pfade werden nicht unterstützt. Einträge wie domain.com/path/page sind nicht gültig.

• Das Hinzufügen der Elterndomäne reicht aus. Wenn du group.docuware.cloud hinzufügst, werden alle Unterdomänen darunter (z. B. team1.group.docuware.cloud) automatisch erlaubt, ohne dass sie einzeln hinzugefügt werden müssen.

• Wenn die Liste leer bleibt, kann das Widget ohne Einschränkung in jede Domain oder Subdomain eingebettet werden.

Hinzufügen eines Ticket-Deflektors im Knowledge Base-Widget

Du kannst einen Ticket-Deflektor integrieren, um Support-Anfragen abzulenken. Um einen Ticket-Deflektor zu Ihrem Knowledge Base-Widget hinzuzufügen, folgen Sie den folgenden Schritten:

1. Navigiere zu Connections () > Knowledge Base-Widget in der linken Navigationsleiste.

   Die Liste der Widgets wird angezeigt.

2. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

3. Im Reiter "Konfigurieren & verbinden " erweitern Sie das Ticket-Deflektor-Akkordeon .

4. Schalte den Show-Ticket-Deflektor ein.

5. Wählen Sie den gewünschten Ticket-Deflektor aus dem Dropdown-Menü.

6. Falls erforderlich, bearbeite das Menü-Namensfeld .

7. Klicken Sie auf Speichern , um Änderungen anzuwenden.

   

   Das Widget enthält nun den ausgewählten Ticket-Deflektor.

Fehlerbehebung

Dieser Abschnitt bietet Schritt-für-Schritt-Anleitungen, um häufige Herausforderungen anzugehen, denen Sie beim Verwalten oder Zugriff auf Ihr Knowledge Base-Widget begegnen können.

Das Widget-Symbol ist auch nach der Zuordnung zu einem Button sichtbar

Selbst nachdem das Knowledge Base-Widget einem benutzerdefinierten Button zugeordnet wurde, erscheint das Standard-Widget-Icon weiterhin auf der Knowledge Base-Website. Das passiert, weil das Widget-Skript die Standard-Symbolanzeige enthält und sie beim Tastenauslösen nicht automatisch versteckt wird.

Schritte zur Lösung:

1. Navigiere zu Connections () > Knowledge Base-Widget in der linken Navigationsleiste, und eine Liste der erstellten Widgets erscheint.

2. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

3. Im Reiter Konfigurieren & Verbinden erweitern Sie das Akkordeon des Style-Widgets .

4. Suchen Sie den Umschalter "Blenden" und stellen Sie sicher, dass er aktiviert ist.

5. Klicken Sie auf Speichern , um die Änderungen anzuwenden.

   Aktualisieren Sie Ihre Wissensdatenbank, um die Änderungen zu sehen.

Danach ist das Widget-Symbol auf der Seite nicht mehr sichtbar, funktioniert aber weiterhin wie erwartet, wenn es über deinen benutzerdefinierten Button ausgelöst wird.

HINWEIS

Wenn du auch URL-Mappings zur Steuerung der Widget-Sichtbarkeit verwendest, siehe Anpassen des Knowledge Base-Widgets mit benutzerdefiniertem CSS/JavaScript für erweiterte Versteckoptionen. und a l

Der Bereich "Meistgesuchte Artikel" ist auf der Knowledge Base-Seite nicht sichtbar

Der Bereich für die meistgesuchten Artikel und die zugeordnete Liste der Artikel für eine bestimmte URL erscheinen nicht im Knowledge Base-Widget.

Dieses Problem tritt typischerweise auf, wenn in den Widget-Stileinstellungen der Umschalter "Meistgesuchte Artikel ausblenden " aktiviert ist. Das Aktivieren dieser Option verbirgt sowohl den Bereich für die meistgesuchten Artikel als auch jede zugeordnete Artikelliste, die mit einer bestimmten URL verknüpft ist.

Schritte zur Lösung:

1. Fahre mit der Maus über das gewünschte Widget und klicke auf das Edit ()-Symbol.

2. Im Reiter Konfigurieren & Verbinden erweitern Sie das Akkordeon des Style-Widgets .

3. Finden Sie den Schalter "Meistgesuchte Artikel verstecken " und stellen Sie sicher, dass er deaktiviert ist.

4. Klicken Sie auf Speichern , um die Änderungen anzuwenden.

   Aktualisieren Sie die Knowledge Base-Seite und überprüfen Sie, ob die meistgesuchten Artikel und die Liste der zugeordneten Artikel jetzt sichtbar sind.

HINWEIS

Wenn das Problem auch nach dem Deaktivieren des Umschalters weiterhin besteht, überprüfen Sie die Artikel-zu-URL-Zuordnungen noch einmal und überprüfen Sie andere Anzeigeeinstellungen innerhalb der Widget-Konfiguration.

Artikellinks im Widget leiten die Nutzer zur KB-Website um, anstatt sie innerhalb des Widgets zu öffnen

Artikellinks im Widget folgen dem Navigationsverhalten basierend auf dem Zielinhaltstyp und dem Zugriffsbereich des Widgets.

• Interne Links zu Artikeln in Standard-Arbeitsbereichen öffnen sich im Widget.

• Interne Links zu Artikeln in anderen Standard-Arbeitsbereichen öffnen sich ebenfalls im Widget, wenn Zielarbeitsfläche, Sprache und Kategorie in die Inhaltszugriffsfilter des Widgets aufgenommen werden.

• Links zur API-Dokumentation öffnen sich immer in einem neuen Browser-Tab.

• Wenn der Zielartikel durch Lesergruppenberechtigungen oder Widget-Filter eingeschränkt ist, zeigt das Widget einen eingeschränkten Zugriffszustand an.

• Wenn der Ziellink nicht aufgelöst werden kann, zeigt das Widget einen Fallback-Zustand an, ohne dass rohe Fehler offengelegt werden.

 HINWEIS

Das Widget akzeptiert die Einstellung "Im neuen Tab öffnen " für Links mit derselben Domain nicht. Sie öffnen sich immer innerhalb des Widgets.

<div style="font-family:Arial, sans-serif;font-size:14px;color:#333333;line-height:1.6;">
  <p>
    The <strong>test line</strong>
  </p>
</div>