De Knowledge Base-widget beheren en aanpassen

Plannen die de kennisbank ondersteunen

De widget in de kennisbank aanpassen

U kunt elke kennisbankwidget aanpassen om de gebruikerservaring te verbeteren.

1. Log in op de Knowledge base portal en selecteer het gewenste project.

2. Navigeer naar de Knowledge Base-widget () in de linkernavigatiebalk. Er wordt een lijst met gemaakte widgets weergegeven.

3. Beweeg de muisaanwijzer over de gewenste widget en klik op het pictogram Bewerken ().

4. Vouw op het tabblad Configureren en verbinden de accordeon van de stijlwidget uit.

5. De volgende opties voor het aanpassen van widgets zijn beschikbaar:

   • Widget color

   • Widget icoon

   • Widget positie

   • Widget verbergen

   • Hide most searched articles

Widget kleur

U kunt een themakleur voor de widget kiezen, waarmee ook de pictogramkleur wordt ingesteld.

1. Klik op Kleur wijzigen om het kleurenpalet te openen.

2. Selecteer een kleur met behulp van de kiezer of voer een hex-, RGB- of HSL-code in.

Widget icoon

Op dezelfde manier kunt u onder het kleurgedeelte van de widget het pictogram vervangen door een afbeelding of een beschikbaar pictogram.

1. Klik op het pictogram Wijzigen.

2. Kies op het tabblad Pictogrammenset of voeg een afbeelding in onder Afbeelding invoegen:

   1. Van URL: Plak de afbeeldingslink en klik op Invoegen.

   2. Vanaf apparaat: Klik op Een afbeelding uploaden en selecteer een bestand.

3. Klik op Standaard om terug te keren naar het oorspronkelijke pictogram.

Widget positie

Bepaal waar de widget op je site wordt weergegeven:

• Kies Links of Rechts.

• Stel de waarden voor Zijafstand en Bodemafstand in om de widget te positioneren .

Widget verbergen

Standaard is de wisselknop Widget verbergen uitgeschakeld, zodat de Knowledge base-widget zichtbaar blijft op de site. Als u de widget wilt verbergen, schakelt u de schakelaar Widget verbergen in.

Verberg de meest gezochte artikelen

Schakel de schakelaar Meest gezochte artikelen verbergen in om de sectie met de belangrijkste zoekartikelen te verbergen.

NOTITIE

Als u de wisselknop Meest gezochte artikelen verbergen inschakelt, wordt de URL-toewijzingsfunctionaliteit voor de widget uitgeschakeld.

Zodra uw wijzigingen zijn aangebracht, klikt u op Opslaan naast het veld Widgetnaam.

NOTITIE

De optie voor automatisch opslaan is beschikbaar voor navigatie tussen de tabbladen van de Knowledge Base-widget.

Toegang tot inhoud voor de Knowledge Base-widget

Mogelijk wilt u alleen bepaalde artikelen weergeven of sommige artikelen verbergen op uw kennisbanksite. U kunt dit effectief doen met de optie voor toegang tot inhoud .

Toegang tot inhoud beperken in een Knowledge Base-widget

De toegang tot inhoud in een Knowledge Base-widget beperken:

1. Navigeer naar de Knowledge Base-widget () in de linkernavigatiebalk.

2. Plaats de muisaanwijzer op een widget en klik op het pictogram Bewerken ().

3. Vouw op het tabblad Configuratie en verbinding de sectie Toegang tot inhoud uit.

4. Je hebt drie opties:

   1. Project

   2. Werkruimte

   3. Categorie

Project

Alle artikelen in de Knowledge Base worden weergegeven in de Widget. Standaard is Project geselecteerd.

Werkruimte

Geef alleen specifieke werkruimten of talen weer:

1. Selecteer Werkruimte > Kies werkruimte

2. Vink de gewenste werkruimte(n)/taal/talen aan

3. Klik op Gereed

4. Klik op Opslaan om de wijzigingen toe te passen

U wilt bijvoorbeeld een andere werkruimte met een specifieke taal selecteren.

Categorie

Geef alleen specifieke categorieën weer:

1. Selecteer Categorie > Kies Categorie

2. Selecteer categorieën uit de huidige of andere werkruimten

3. Klik op Gereed

4. Klik op Opslaan om de wijzigingen toe te passen

U kunt de gewenste categorieën in de widget laten verschijnen.

U wilt bijvoorbeeld alleen de verkoopcategorieën in de widget weergeven.

VOORZICHTIGHEID

Wijzigingen die worden aangebracht in de toegang tot content, hebben rechtstreeks invloed op je URL-toewijzing.

Als u de filterinstellingen van de widget wijzigt, kan de bestaande URL-toewijzing worden verwijderd en resulteren in verbroken links.

Voorbeeld 1:
U hebt de inhoud van de filterwidget op projectniveau ingesteld en een URL-toewijzing geconfigureerd die een lijst met artikelen uit categorie A in Workspace V1 bevat. Als u de filterinstellingen bijwerkt om alleen de categorieën B en C in dezelfde werkruimte weer te geven, wordt de vorige URL-toewijzing ongeldig, omdat de oorspronkelijk toegewezen artikelen uit categorie A niet meer beschikbaar zijn in de widget.

U kunt URL-toewijzingen alleen configureren met behulp van artikelen die zijn opgenomen in de huidige inhoud van de filterwidget.

Voorbeeld 2:
Als de widget is gefilterd om alleen inhoud uit Workspace V1 weer te geven, kunt u geen URL-toewijzing maken voor een artikel in Workspace V2.

Aangepaste links toevoegen

U kunt aangepaste koppelingen toevoegen aan de Knowledge Base-widget. De links worden weergegeven in de volgorde waarin ze zijn gemaakt. Gebruik deze optie om eindgebruikers naar specifieke pagina's of bronnen te leiden.

Een aangepaste link toevoegen:

1. Navigeer naar de Knowledge Base-widget () in de linkernavigatiebalk.

2. Beweeg de muisaanwijzer over de gewenste widget en klik op het pictogram Bewerken ().

3. Vouw op het tabblad Configureren en verbinden de accordeon Koppelingen toevoegen uit

4. Voer in het veld Sectietitel de gewenste titel voor die sectie in. Dit verschijnt in de widget.

5. Kies onder de titel van de sectie voor elke link het gewenste pictogram, de linktekst (die in de widget verschijnt) en de bestemmingslink.

   Voorbeeld:

   • Icoon:

   • Tekst link: Neem contact met ons op

   • Verbinden: support@document360.com

   NOTITIE

   U kunt een gebruiken mailto: in het koppelingsveld. Bijvoorbeeld: mailto:<youremail@somedomain.com>

6. Klik op Toevoegen en de link wordt toegevoegd. Op dezelfde manier kunt u meerdere links toevoegen.

7. Als u wilt bewerken, klikt u op het pictogram Bewerken (). Klik om op te slaan en te verwijderen.

8. Klik op het pictogram Verwijderen () naast de koppelingen om de koppelingen te verwijderen.

9. Als u klaar bent, klikt u op Opslaan om de wijzigingen op te slaan.

Domein beperking

Met Document360 kunt u de Knowledge Base-widget beperken tot specifieke domeinen. Zodra een domein is toegevoegd aan de lijst met widgetbeveiliging, moet elk projectlid dat de Knowledge Base-widget op een ander domein wil installeren, dat domein toevoegen aan de sectie Widgetbeveiliging .

Als er geen domeinen aan de lijst worden toegevoegd, kan de Knowledge base-widget zonder beperking worden ingesloten in elke SaaS-applicatie of openbare website.

De Knowledge Base-widget beperken tot een specifiek domein

Als u uw Knowledge Base-widget wilt beperken tot een specifiek domein,

1. Navigeer naar de Knowledge Base-widget () in de linkernavigatiebalk.

2. Beweeg de muisaanwijzer over de gewenste widget en klik op het pictogram Bewerken ().

3. Vouw op het tabblad Configureren en verbinden de Widget-beveiligingsaccordeon uit. U kunt de lijst met eerder toegevoegde domeinen vinden (indien toegevoegd).

4. Voer het domein in waar u de Knowledge Base-widget wilt weergeven.

5. Klik op Toevoegen en klik op Opslaan.

NOTITIE

De "www" is geen geldig onderdeel van uw domein. Voeg alleen toe wat na de www komt. in uw URL.

Voorbeeld: document360.com

Een ticketdeflector toevoegen in de Knowledge Base-widget

U kunt een Ticket Deflector integreren om ondersteuningsvragen te helpen voorkomen. Volg de onderstaande stappen om een ticketdeflector toe te voegen aan uw Knowledge Base-widget:

1. Navigeer naar de Knowledge Base-widget () in de linkernavigatiebalk.

   De lijst met widgets wordt weergegeven.

2. Beweeg de muisaanwijzer over de gewenste widget en klik op het pictogram Bewerken ().

3. Vouw in het tabblad Configureren en verbinden de accordeon Ticketdeflector uit.

4. Schakel de schakelaar voor de deflector van het showticket in.

5. Selecteer de gewenste ticketdeflector in de vervolgkeuzelijst.

6. Bewerk indien nodig het veld Menunaam .

7. Klik op Opslaan.

   De ticketdeflector is toegevoegd aan de Knowledge base-widget.

Verificatie van Knowledge base-widgets beveiligen met JWT

U kunt een authenticatieconfiguratie voor de widget implementeren met behulp van JWT, waardoor een veilige omgeving voor privé- en gemengde projecten wordt gegarandeerd.

1. Navigeer naar de Knowledge Base-widget () in de linkernavigatiebalk.

   De lijst met widgets verschijnt.

2. Beweeg de muisaanwijzer over de gewenste widget en klik op het pictogram Bewerken ().

3. Navigeer op het tabblad Configureren en verbinden naar de JWT-accordeon en schakel de JWT-schakelaar Inschakelen in.

1. Klant-ID: De klant-ID is de ID van uw project.

2. Widget-ID: Aangezien er meerdere widgets kunnen bestaan, wordt een widget-ID verstrekt voor hun unieke doeleinden.

3. Token eindpunt: Een token-eindpunt is een HTTP-eindpunt waarmee u een toegangstoken kunt verkrijgen op basis van een autorisatiecode.

4. Geheim van de klant: Klik op Regenereren om het clientgeheim te genereren. U moet dit opslaan voor toekomstige doeleinden en hetzelfde clientgeheim zal in de toekomst van toepassing zijn op alle widgets.

NOTITIE

Het clientgeheim is vereist voor JWT-widgets die u kunt maken. Houd er rekening mee dat deze informatie niet wordt opgeslagen in Document360.

e. URL autoriseren: Plak de geautoriseerde URL van de webpagina van uw kennisbankwidget.

5. Klik op Opslaan.

Sluit de geautoriseerde URL in uw code in en plak deze in het scriptgedeelte op uw webpagina. Hiermee wordt een veilige, geverifieerde widget geïmplementeerd die ongeoorloofde toegang door derden voorkomt.

Het authenticatie-eindpunt implementeren

[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 });
    }
}

NOTITIE

U moet de door komma's gescheiden lezergroep-id's opnemen als beveiligingsgroep-id's om de KB-widget te configureren en weer te geven.

Probleemoplossing

In dit gedeelte vindt u stapsgewijze richtlijnen voor het aanpakken van veelvoorkomende uitdagingen die u kunt tegenkomen bij het beheren of openen van uw Knowledge Base-widget.

Het widgetpictogram is zichtbaar, zelfs na toewijzing aan een knop

Zelfs nadat de Knowledge Base-widget is toegewezen aan een aangepaste knop, blijft het standaardwidgetpictogram verschijnen op de Knowledge Base-site. Dit gebeurt omdat het widgetscript de standaardpictogramweergave bevat en het niet automatisch wordt verborgen bij het gebruik van een knoptrigger.

Stappen om op te lossen:

1. Navigeer naar de Knowledge Base-widget () in de linkernavigatiebalk.

2. Beweeg de muisaanwijzer over de gewenste widget en klik op het pictogram Bewerken ().

3. Vouw de accordeon van de widget Stijl uit en schakel de schakelaar Widget verbergen in.

4. Klik op Opslaan om de wijzigingen toe te passen.

   Vernieuw uw Knowledge Base-site om de wijzigingen te zien.

Als u klaar bent, is het widgetpictogram niet langer zichtbaar op de site, maar het zal nog steeds functioneren zoals verwacht wanneer het wordt geactiveerd via uw aangepaste knop.

NOTITIE

Als u ook URL-toewijzingen gebruikt om de zichtbaarheid van widgets te beheren, raadpleegt u De Knowledge Base-widget aanpassen met behulp van aangepaste CSS/JavaScript voor geavanceerde weergaveopties.