Verwalten und Anpassen des Wissensdatenbank-Widgets

Sie können jedes Wissensdatenbank-Widget anpassen, um die Benutzererfahrung zu verbessern. Um dies zu tun,

1. Loggen Sie sich in die Knowledge base portal ein und wählen Sie Ihr gewünschtes Projekt aus.

2. Navigieren Sie in der linken Navigationsleiste zum Wissensdatenbank-Widget (). Eine Liste der erstellten Widgets wird angezeigt.

3. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

   

4. Erweitern Sie auf der Registerkarte Konfigurieren und Verbinden das Akkordeon Stil-Widget .

5. Die folgenden Optionen zur Anpassung des Widgets sind verfügbar:

   • Widget color

   • Widget-Symbol

   • Position des Widgets

   • Widget ausblenden

   • Hide most searched articles

Farbe des Widgets

Sie können eine Designfarbe für das Widget auswählen, die auch die Symbolfarbe festlegt.

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

2. Wählen Sie mit der Auswahl eine Farbe aus oder geben Sie einen Hexadezimal-, RGB- oder HSL-Code ein.

Widget-Symbol

Auf ähnliche Weise können Sie im Abschnitt "Widget-Farbe" das Symbol durch ein Bild oder ein verfügbares Symbol ersetzen.

1. Klicken Sie auf das Symbol Ändern.

2. Wählen Sie auf der Registerkarte Symbolsatz 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. Klicken Sie auf Standard , um das ursprüngliche Symbol wiederherzustellen.

Position des Widgets

Legen Sie fest, wo das Widget auf Ihrer Website angezeigt wird:

• Wählen Sie "Links " oder "Rechts" aus.

• Legen Sie die Werte für Seitenabstand und Unterer Abstand fest, um das Widget zu positionieren.

Widget ausblenden

Standardmäßig ist der Schalter Widget ausblenden deaktiviert, sodass das Widget "Wissensdatenbank" auf der Website sichtbar bleibt. Um das Widget auszublenden, aktivieren Sie einfach den Schalter Widget ausblenden .

Meistgesuchte Artikel ausblenden

Aktivieren Sie den Schalter "Am häufigsten gesuchte Artikel ausblenden ", um die am häufigsten gesuchten Artikel auszublenden.

ANMERKUNG

Wenn Sie den Schalter "Meistgesuchte Artikel ausblenden" aktivieren, wird die URL-Zuordnung für das Widget deaktiviert.

Sobald Sie Ihre Änderungen vorgenommen haben, klicken Sie neben dem Feld Widget-Name auf Speichern .

ANMERKUNG

Die Option zum automatischen Speichern ist für die Navigation zwischen den Registerkarten des Wissensdatenbank-Widgets verfügbar.

Zugriff auf Inhalte für das Wissensdatenbank-Widget

Sie können den Zugriff auf Inhalte in Ihrem Wissensdatenbank-Widget auch dann konfigurieren, wenn JWT für das Widget aktiviert ist. Dies gibt Ihnen mehr Flexibilität bei der Kontrolle, was Ihre Endbenutzer sehen können.

So konfigurieren Sie den Inhaltszugriff mit aktiviertem JWT:

1. Navigieren Sie in der linken Navigationsleiste zum Wissensdatenbank-Widget .

2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

3. Erweitern Sie auf der Registerkarte Konfigurieren und Verbinden den Abschnitt Inhaltszugriff .

4. Die verfügbaren Filterebenen sind:

   • Projekt

   • Arbeitsbereich

   • Kategorie

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

6. Klicken Sie auf "Fertig" und dann auf "Speichern ", um die Änderungen zu übernehmen.

Validierung des Inhalts von Lesergruppen während der Anmeldung

• Wenn sich ein Leser anmeldet, überprüft das System, ob seine Lesergruppenberechtigungen mit den Inhaltszugriffsfiltern des Widgets übereinstimmen. Nur die sich überschneidenden Berechtigungen zwischen den Einstellungen auf Widget-Ebene und den Einstellungen der Lesergruppe werden für die Validierung berücksichtigt.

• Dadurch wird sichergestellt, dass Benutzer nur die Beiträge sehen, für die sie autorisiert sind, und zwar sowohl in Widget-Level- als auch in Lesergruppenberechtigungen.

VORSICHT

Änderungen, die am Inhaltszugriff vorgenommen werden, wirken sich direkt auf Ihre URL-Zuordnung aus.

Wenn Sie die Filtereinstellungen des Widgets ändern, kann die vorhandene URL-Zuordnung entfernt werden, was zu fehlerhaften Links führt.

Beispiel 1:
Sie haben den Inhalt des Filter-Widgets auf Projektebene festgelegt 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 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 nicht mehr im Widget verfügbar sind.

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

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

Hinzufügen von benutzerdefinierten Links

Sie können benutzerdefinierte Links zum Wissensdatenbank-Widget hinzufügen. Die Links werden in der Reihenfolge angezeigt, in der sie erstellt wurden. Verwenden Sie diese Option, um Endbenutzer zu bestimmten Seiten oder Ressourcen zu leiten.

So fügen Sie einen benutzerdefinierten Link hinzu:

1. Navigieren Sie in der linken Navigationsleiste zum Wissensdatenbank-Widget ().

2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

3. Erweitern Sie auf der Registerkarte Konfigurieren und Verbinden das Akkordeon Links hinzufügen

4. Geben Sie im Feld Abschnittstitel den gewünschten Titel für diesen Abschnitt ein. Dies wird im Widget angezeigt.

5. Wählen Sie unter dem Abschnittstitel für jeden Link das gewünschte Symbol, den Linktext (der im Widget angezeigt wird) und den Ziellink aus.

   Beispiel:

   • Symbol:

   • Text des Links: Kontaktieren Sie uns

   • Verbinden: support@document360.com

   ANMERKUNG

   Sie können ein im mailto: Verknüpfungsfeld verwenden. Beispiel: mailto:<youremail@somedomain.com>

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

7. Um zu bearbeiten, klicken Sie auf das Symbol Bearbeiten (). Klicken Sie zum Speichern und Verwerfen.

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

9. Wenn Sie fertig sind, klicken Sie auf Speichern , um die Änderungen zu speichern.

   

Domain-Beschränkung

Mit Document360 können Sie das Widget "Wissensdatenbank" auf bestimmte Domänen beschränken. Sobald eine Domäne zur Widget-Sicherheitsliste hinzugefügt wurde, muss jedes Projektmitglied, das das Wissensdatenbank-Widget in einer anderen Domäne installieren möchte, diese Domäne zum Abschnitt "Widget-Sicherheit " hinzufügen.

Wenn der Liste keine Domänen hinzugefügt werden, kann das Wissensdatenbank-Widget ohne Einschränkungen in jede SaaS-Anwendung oder öffentliche Website eingebettet werden.

Beschränken des Wissensdatenbank-Widgets auf eine bestimmte Domäne

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

1. Navigieren Sie zum Widget Wissensdatenbank () in der linken Navigationsleiste.

2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

3. Erweitern Sie auf der Registerkarte Konfigurieren und Verbinden das Widget-Sicherheitsakkordeon . Hier finden Sie die Liste der zuvor hinzugefügten Domains (falls hinzugefügt).

4. Geben Sie die Domäne ein, in der das Wissensdatenbank-Widget angezeigt werden soll.

5. Klicken Sie auf Hinzufügen und dann auf Speichern , um die Änderungen zu übernehmen.

   

ANMERKUNG

Das "www" ist kein gültiger Teil Ihrer Domain. Fügen Sie nur hinzu, was nach dem www. in Ihrer URL.

Beispiel: document360.com

Hinzufügen eines Ticket-Deflektors im Wissensdatenbank-Widget

Sie können einen Ticket-Deflektor integrieren, um Support-Anfragen abzuwehren. Um Ihrer Wissensdatenbank-Widget einen Ticketabweiser hinzuzufügen, führen Sie die folgenden Schritte aus:

1. Navigieren Sie zum Widget Wissensdatenbank () in der linken Navigationsleiste.

   Die Liste der Widgets wird aufgelistet.

2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

3. Erweitern Sie auf der Registerkarte Konfigurieren und Verbinden das Akkordeon Ticket-Deflektor .

4. Aktivieren Sie den Schalter Ticketabweiser anzeigen .

5. Wählen Sie den gewünschten Ticketabweiser aus der Dropdown-Liste aus.

6. Bearbeiten Sie bei Bedarf das Feld Menüname .

7. Klicken Sie auf Speichern , um die Änderungen zu übernehmen.

   Das Widget enthält jetzt den ausgewählten Ticketabweiser.

   

Sichern der Authentifizierung von Wissensdatenbank-Widgets mit JWT

Sie können eine Authentifizierungskonfiguration für das Widget mit JWT implementieren, um eine sichere Umgebung für private und gemischte Projekte zu gewährleisten.

1. Navigieren Sie zum Widget Wissensdatenbank () in der linken Navigationsleiste.

   Die Liste der Widgets wird angezeigt.

2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

3. Navigieren Sie auf der Registerkarte Konfigurieren und Verbinden zum JWT-Akkordeon und aktivieren Sie den Schalter JWT-Aktivieren .

1. Client-ID: Die Client-ID ist die ID Ihres Projekts.

2. Widget-ID: Da mehrere Widgets vorhanden sein können, wird eine Widget-ID für ihre individuellen Zwecke bereitgestellt.

3. Token-Endpunkt: Ein Tokenendpunkt ist ein HTTP-Endpunkt, mit dem Sie ein Zugriffstoken mit einem Autorisierungscode abrufen können.

4. Geheimer Clientschlüssel: Klicken Sie auf Regenerieren , um den geheimen Clientschlüssel zu generieren. Sie müssen dies für zukünftige Zwecke speichern, und derselbe geheime Clientschlüssel wird in Zukunft auf alle Widgets angewendet.

ANMERKUNG

Der geheime Clientschlüssel ist für JWT-Widgets erforderlich, die Sie erstellen können. Beachten Sie, dass diese Informationen nicht in Document360 gespeichert werden.

e. URL autorisieren: Fügen Sie die autorisierte URL von der Webseite Ihres Wissensdatenbank-Widgets ein.

5. Klicken Sie auf Speichern , um die Änderungen zu übernehmen.

Betten Sie die autorisierte URL in Ihren Code ein und fügen Sie sie in den Skriptbereich auf Ihrer Webseite ein. Dadurch wird ein sicheres, authentifiziertes Widget implementiert, das den unbefugten Zugriff von Drittanbietern verhindert.

Implementieren des Authentifizierungsendpunkts

Verwenden Sie diesen C#-Codeausschnitt, um die JWT-Authentifizierung für das Wissensdatenbank-Widget zu implementieren.

[HttpGet]
[Route("authenticate")]
public async Task<IActionResult> WidgetAuthentication(string id)
{
    if (HttpContext.User.Identity.IsAuthenticated)
    {
        var clientData = new ClientDetails()
        {
            ClientId = "{Client ID}",
            Secret = "{Client secret}",
            TokenEndpoint = "{Token endpoint}",
            WidgetId = "{Widget ID}",
            SecurityGroupIds = "{Comma separated reader group IDs}", // mandatory for configuration to render KB widget
            TokenValidity = 15, // integer representing token validity in minutes
        };

        if (clientData == null)
            return NotFound();

        List<string> readerGroupids = null;
        if (!string.IsNullOrEmpty(clientData.SecurityGroupIds))
            readerGroupids = clientData.SecurityGroupIds.Split(',').Select(c => c.Trim()).ToList();

        var payload = new
        {
            username = "{Username}",
            firstName = "{First name}",
            lastName = "{Last name}",
            emailId = "{Email address}",
            readerGroupIds = readerGroupids,
            tokenValidity = clientData.TokenValidity,
            widgetId = clientData.WidgetId,
            projectId = clientData.ClientId
        };

        var payloadString = JsonConvert.SerializeObject(payload);

        var result = await client.RequestTokenAsync(new TokenRequest
        {
            Address = clientData.TokenEndpoint,
            ClientId = clientData.ClientId,
            ClientSecret = clientData.Secret,
            GrantType = "Widget",
            Parameters =
            {
                {
                    "payload",  payloadString
                },
                {
                    "id", clientData.ClientId
                },
            }
        });

        return Ok(new
        {
            accessToken = result.AccessToken,
            expiresIn = result.ExpiresIn
        });
    }
    else
    {
        return Unauthorized(new { success = false });
    }
}

ANMERKUNG

Sie müssen die durch Trennzeichen getrennten Lesergruppen-IDs als Sicherheitsgruppen-IDs einschließen, um das KB-Widget zu konfigurieren und zu rendern.

Fehlerbehebung

Dieser Abschnitt enthält eine Schritt-für-Schritt-Anleitung zur Bewältigung häufiger Herausforderungen, die bei der Verwaltung oder beim Zugriff auf Ihr Wissensdatenbank-Widget auftreten können.

Das Widget-Symbol ist auch nach der Zuordnung zu einer Schaltfläche sichtbar

Auch nach dem Zuordnen des Wissensdatenbank-Widgets zu einer benutzerdefinierten Schaltfläche wird das Standard-Widget-Symbol weiterhin auf der Wissensdatenbank-Website angezeigt. Dies liegt daran, dass das Widget-Skript die standardmäßige Symbolanzeige enthält und nicht automatisch ausgeblendet wird, wenn ein Schaltflächenauslöser verwendet wird.

Schritte zur Behebung:

1. Navigieren Sie zum Widget Wissensdatenbank () in der linken Navigationsleiste.

2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

3. Erweitern Sie auf der Registerkarte Konfigurieren und Verbinden das Akkordeon Stil-Widget .

4. Suchen Sie den Schalter Widget ausblenden und vergewissern Sie sich, dass er aktiviert ist.

5. Klicken Sie auf Speichern , um die Änderungen zu übernehmen.

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

Sobald dies erledigt ist, ist das Widget-Symbol auf der Website nicht mehr sichtbar, funktioniert aber immer noch wie erwartet, wenn es über Ihre benutzerdefinierte Schaltfläche ausgelöst wird.

ANMERKUNG

Wenn Sie auch URL-Zuordnungen verwenden, um die Sichtbarkeit von Widgets zu steuern, finden Sie unter Anpassen des Wissensdatenbank-Widgets mit benutzerdefiniertem CSS/JavaScript für erweiterte Ausblendoptionen.

Der Abschnitt "Meistgesuchte Artikel" ist auf der Wissensdatenbank-Website nicht sichtbar

Der Abschnitt "Meistgesuchte Beiträge " und die zugeordnete Liste der Beiträge für eine bestimmte URL werden nicht im Widget "Wissensdatenbank" angezeigt.

Dieses Problem tritt in der Regel auf, wenn der Schalter "Am häufigsten gesuchte Artikel ausblenden" in den Stileinstellungen des Widgets aktiviert ist. Wenn Sie diese Option aktivieren, werden sowohl der Abschnitt "Meistgesuchte Artikel" als auch alle zugeordneten Artikellisten ausgeblendet, die mit einer bestimmten URL verknüpft sind.

Schritte zur Behebung:

1. Navigieren Sie in der linken Navigationsleiste zum Wissensdatenbank-Widget ().

2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

3. Erweitern Sie auf der Registerkarte Konfigurieren und Verbinden das Akkordeon Stil-Widget .

4. Suchen Sie den Schalter "Meistgesuchte Artikel ausblenden" und stellen Sie sicher, dass er deaktiviert ist.

5. Klicken Sie auf Speichern , um die Änderungen zu übernehmen.

   Aktualisieren Sie die Wissensdatenbank-Website, und stellen Sie sicher, dass die am häufigsten gesuchten Artikel und die Liste der zugeordneten Artikel jetzt sichtbar sind.

ANMERKUNG

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

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