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 () > Knowledge Base-Widget in der linken Navigationsleiste. Du siehst eine Liste bestehender Widgets.

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üge 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 leicht auf Hilfeinhalte zuzugreifen.

HINWEIS

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

Widget ausblenden

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

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 steht zur Navigation zwischenden Wissensdatenbank-Widget-Tabs zur Verfügung.

Inhaltszugriff für das Knowledge Base-Widget

Sie können den Inhaltszugriff in Ihrem 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 Leser anmeldet, prüft das System, ob die Lesergruppenberechtigungen mit den Inhaltszugriffsfiltern des Widgets übereinstimmen. Nur die sich schneidenden Berechtigungen zwischen den Widget-Ebenen-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 Kategorienlinks im Widget gezielt sind. Das Widget überprüft die konfigurierten Inhaltszugriffsfilter, den Arbeitsbereich und die Berechtigungen für Lesergruppen, bevor der Zielinhalt geladen wird. Wenn der verlinkte Inhalt außerhalb des erlaubten Umfangs liegt, zeigt das Widget einen eingeschränkten Zugriffszustand 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 Arbeitsbereich V1 enthält. Wenn Sie die Filtereinstellungen so aktualisieren, dass nur 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

Sie können 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 aus dem Widget geöffneten Links öffnen sich immer in einem neuen Browser-Tab.

 HINWEIS

Interne Artikel- und Kategorie-Links folgen den Widget-Navigationsregeln, die auf Arbeitsflächentyp, Inhaltszugriffsbereich und Lesergruppenberechtigungen basieren. Siehe den FAQ-Abschnitt für 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 Abschnittstitel-Feld geben Sie den gewünschten Titel für diesen Abschnitt ein. Dieser erscheint im Widget.

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

   Sie können ein mailto: im Linkfeld verwenden. Zum Beispiel: mailto:<youremail@somedomain.com>

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

7. Zum Bearbeiten klicken Sie auf das Symbol Bearbeiten (). 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.

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 . Sie finden die Liste der zuvor hinzugefügten Domains (falls hinzugefügt).

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 www. in deiner URL kommt.

Beispiel: document360.com

• Die Wildcard-Notation wird nicht unterstützt. Sie können *. domain.com nicht alle Unterdomänen gleichzeitig zulassen.

• 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 Sie group.docuware.cloud hinzufügen, werden alle Unterdomänen darunter (z. B. team1.group.docuware.cloud) automatisch erlaubt, ohne einzeln hinzugefügt werden zu 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

Sie können 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. Dies passiert, weil das Widget-Skript das Standard-Icon-Display enthält und es beim Verwenden eines Button-Triggers 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 der Schalter "Meistgesuchte Artikel verstecken " in den Widget-Stileinstellungen aktiviert ist. Aktiviert diese Option blendet sowohl den Bereich "Meistgesuchte Artikel" als auch jede zugeordnete Artikelliste aus, 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 berücksichtigt die Einstellung "Im neuen Tab öffnen " für Links mit derselben Domain nicht. Sie werden immer innerhalb des Widgets geöffnet.

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