De Knowledge Base-widget beheren en aanpassen

U kunt elke kennisbankwidget aanpassen om de gebruikerservaring te verbeteren. Om dit te doen,

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 Onderste afstand 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 wisselknop Meest gezochte artikelen verbergen in om de populairste zoekartikelen te verbergen.

NOTITIE

Als u de schakelaar Meest gezochte artikelen verbergen inschakelt, wordt URL-toewijzing 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 kennisbankwidget

U kunt inhoudstoegang configureren in uw kennisbankwidget, zelfs als JWT is ingeschakeld voor de widget. Dit geeft u meer flexibiliteit bij het bepalen van wat uw eindgebruikers kunnen zien.

Inhoudstoegang configureren met JWT ingeschakeld:

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 sectie Toegang tot inhoud uit.

4. De beschikbare filterniveaus zijn:

   • Project

   • Werkruimte

   • Categorie

5. Kies de gewenste werkruimten, talen en categorieën om in de widget weer te geven.

6. Klik op Gereed en klik vervolgens op Opslaan om de wijzigingen toe te passen.

Validatie van de inhoud van de lezersgroep tijdens het inloggen

• Wanneer een lezer inlogt, valideert het systeem of de machtigingen van de lezersgroep overeenkomen met de inhoudstoegangsfilters van de widget. Alleen de kruisende machtigingen tussen de instellingen op widgetniveau en de instellingen van de lezersgroep worden in aanmerking genomen voor validatie.

• Dit zorgt ervoor dat gebruikers alleen de artikelen zien waarvoor ze zijn geautoriseerd, zowel in machtigingen op widgetniveau als in lezersgroepen.

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, wat leidt tot 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. Herhaal de stappen om extra links toe te voegen.

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 ze 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 kennisbankwidget 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 om wijzigingen toe te passen.

   

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 kennisbankwidget:

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 om wijzigingen toe te passen.

   De widget bevat nu de geselecteerde Ticket Deflector.

   

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 om wijzigingen toe te passen.

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

Gebruik dit C#-fragment om JWT-verificatie te implementeren voor de Knowledge Base-widget.

[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 op het tabblad Configureren en verbinden de accordeon van de stijlwidget uit.

4. Zoek de schakelaar Widget verbergen en zorg ervoor dat deze is ingeschakeld.

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

   Vernieuw uw kennisbanksite 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.

De sectie "Meest gezochte artikelen" is niet zichtbaar op de Knowledge Base-site

De sectie Meest gezochte artikelen en de toegewezen lijst met artikelen voor een specifieke URL worden niet weergegeven in de Knowledge Base-widget.

Dit probleem treedt meestal op wanneer de schakelknop 'Meest gezochte artikelen verbergen' is ingeschakeld in de instellingen voor de widgetstijl. Als u deze optie inschakelt, worden zowel de sectie Meest gezochte artikelen als elke toegewezen artikelenlijst die aan een specifieke URL is gekoppeld, verborgen.

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 op het tabblad Configureren en verbinden de accordeon van de stijlwidget uit.

4. Zoek de schakelaar Meest gezochte artikelen verbergen en zorg ervoor dat deze is uitgeschakeld.

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

   Vernieuw de Knowledge Base-site en controleer of de lijst met meest gezochte artikelen en de lijst met toegewezen artikelen nu zichtbaar zijn.

NOTITIE

Als het probleem zich blijft voordoen, zelfs nadat u de schakelaar hebt uitgeschakeld, controleert u de artikel-naar-URL-toewijzingen en controleert u andere weergave-instellingen in de widgetconfiguratie.

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