Kunskapsbas

Beskrivning

Den här artikeln innehåller dokumentation för Kunskapsbas (officiellt släppt i februari 2023, tillgänglig från version 12.6 och högre), som är efterföljaren till ett äldre (oberoende) plugin - Kunskapsbas.

Knowledge Base är en integrerad lösning av Easy Redmine med BlueSpice, som är byggd på MediaWiki, och utvecklad av vår tekniska partner Hej världen!. Detta är en verkligt dedikerad kunskapsdelningsapplikation som fungerar i synergi med Easy Redmines teamsamarbetsmöjligheter.

Data från det ursprungliga plugin-programmet kan migreras till KB.

Konfigurera KB

Ur tekniskt perspektiv är KB en separat körande applikation som är nära kopplad till Easy Redmine. Eftersom vi förstår det potentiella krånglet för applikationsadministratörer har vi åtagit oss att göra det så smidigt som möjligt.

cloud

För molnanvändare är hela processen automatisk. KB-instansen upprättas automatiskt och ansluts till din Easy Redmine. När du bestämmer dig för att testa den, eller använda i produktion, fungerar den på samma sätt som i alla andra standardfunktioner - tillägget är aktiverat (du hittar ett nytt objekt i MER-menyn) och du kan börja använda det direkt.

server

Serverlösningen för KB tillhandahålls som en Docker-bild. När du har kört den i din infrastruktur kommer du att ansluta den till din Easy Redmine via användargränssnittet i ER-administrationen.

Läs den detaljerade installationsmanualen här..

Trials

KB är inte tillgängligt i vanliga testapplikationer. För att testa det, kontakta din kontoansvarig eller Enkel support.

Live-demo

Det finns en delad livedemo tillgänglig på https://demo-kb.easysoftware.com/ (manager / easy848). Data i denna applikation delas och återställs regelbundet.

Administration i Easy Redmine

För att komma åt administration av KB, gå till Administration >> Plugins >> Knowledge Base - Edit

BS oauth2-leverantörsinställningar för API

Denna del är för allmän koppling mellan ER och KB. Som nämnts ovan, i Cloud, genereras det automatiskt.

Kolla upp knappen bör vara det första du testar om du känner att KB inte fungerar (t.ex. KB-sökning ger inga resultat). Det är också viktigt att alltid klicka Kolla upp vid eventuella ändringar i inställningarna.

Enkla oauth2-leverantörsinställningar för SSO

SSO genereras automatiskt på Cloud såväl som Serverlösning. Det finns viktig information för att eventuellt felsöka åtkomstproblem från ER till KB.

Uppdatera behörigheter på BS för alla användare

Knappen är bara för nödsituationer. Mekanismen bakom fungerar automatiskt.

Exempel: När du sänker någons behörighet från hantera till se, kan det ta upp till en timme för den ändringen att överföras till KB. Om du inte vill vänta på den automatiska spridningen av ändringen klickar du bara på den här knappen.

Roller och behörigheter

Det finns tre åtkomstnivåer som är konfigurerade i Easy Redmine.

 

I Roller och behörigheter hittar du avsnitt för KB

• Visa artiklar - Användare i en roll med denna behörighet får endast läsa sidorna
  
• Hantera artiklar - Användare i en roll med denna behörighet tillåten är en "Editor" i KB , vilket betyder att han kan skapa och redigera sidor, och har även tillåtit andra (icke-admin) operationer.
  
• Administratör i ER har även tillgång till KB-administration
  

Migrering från den ursprungliga kunskapsbasen

Om du aldrig har använt originalversionen kan du lugnt ignorera detta kapitel.

Om du använder den ursprungliga Knowledge Base och du planerar att migrera till KB betyder det att du har båda installerade (aktiverade). I sådana fall hittar du ytterligare en sektion i Administration >> Plugins >> Knowledge Base - Edit

Vad händer efter att du klickat på knappen:

1. Originalkunskapsinlägg valideras oavsett om de är sömlöst migrerbara
2. Sömlöst migreringsbara inlägg migreras
3. "Problematiska" inlägg listas och lämnas för ditt beslut

Vad betyder problematiskt?

Vissa sidtitlar (namn på kunskapsinlägg) som var tillåtna i original KB är inte tillåtna eller har speciell betydelse. Som ett resultat skulle de antingen omvandlas under migreringen eller så skulle de migrera innehåll på ett oväntat sätt.

Detaljer om alla speciella eller olagliga titeltecken finns här:
https://www.mediawiki.org/wiki/Manual:Page_title
https://www.mediawiki.org/wiki/Manual:%24wgLegalTitleChars

I praktiken är ett exempel på ett specialfunktionellt tecken snedstreck "/", såsom titel: Hur man skapar/uppdaterar uppgift. I KB representerar "/" avgränsare för undersida. Det skulle innebära att migreringen skulle importera sidan: Hur man skapar och dess undersida uppdatera uppgift. Vilket verkligen inte är vad du förväntar dig eller vill ha. I det här fallet skulle du hellre redigera titeln på kunskapsinlägget till Hur man skapar eller uppdaterar uppgift.

När du har redigerat titeln klickar du Validera och migrera knappen igen, den här sidan kommer inte att listas som problematisk längre, utan migreras direkt.

Ett annat exempel är helt enkelt otillåtna tecken, som ">" eller "&", som kan tas bort eller ersättas av migrering. Det beror på den specifika situationen. Vi rekommenderar också att du ändrar dessa titlar istället för att importera utan validering.

Migrera utan validering

Om det finns artiklar som inte klarade valideringen, låter den här knappen migrera de som har godkänts och ignorera resten.

Åtkomst till KB

Från sidan av Easy Redmine kan KB nås via olika beröringspunkter.

Mer meny

Som med många andra funktioner kan KB också anges via menyn Mer. Du hittar den under tilläggssektionen. Genom att klicka här kommer du till huvudsidan för KB.

Sidofält (servicefält)

Precis som i originalet har KB en sökwidget i det ständigt närvarande högra fältet. Ikonen är lite annorlunda för att undvika förvirring under den tillfälliga perioden då du kan ha båda KB aktiverade.

Sök helt enkelt på ditt sökord. Genom att klicka på resultatet kommer du till artikeln i KB-applikationen.

Denna sökning går igenom allt indexerat innehåll i KB.

Relaterade artiklar om uppgift

När en uppgift har relaterade artiklar kommer du åt dem direkt från uppgiftsdetaljen. Sökningen som är tillgänglig i det här avsnittet ser endast genom artikel titlar, inte hela innehållet.

Jobbar i KB

Eftersom KB är en separat applikation har den också en egen användarmanual tillgänglig på: https://knowledge-base.easysoftware.com

Manualen är i sig en implementerad instans. Den består av 4 huvudböcker och tar dig genom dina första steg och introducerar de mest avgörande organisatoriska och administrativa områdena. Kom ihåg att det inte är bråttom att implementera ett helt kunskapsdelningssystem. Ta det steg för steg så att du först förstår den grundläggande logiken innan du rullar den till din organisation.

Easy Redmine + KB datarelationer

Easy Redmine innehåller projekt och uppgifter (mycket enkelt uttryckt), KB innehåller artiklar (igen, en förenklad formulering). Låt oss titta på hur de flätas samman.

Uppgift - artikel

Den mest naturliga kopplingen som kommer att tänka på är mellan de mest använda enheterna.

På varje uppgift hittar du en sektion för att söka kunskapsartiklar, för att länka dem till uppgiften med ett enda klick. Denna sökning går endast genom artikeln titlar, inte hela innehållet.

Avlänkning sker som vanligt med knappen för att ta bort länken

Så här ser det ut från kunskapsartikelns sida.

Projekt - artikel

Kunskapsartiklar kan kopplas till projekt från KBs sida

Inbäddad artikel på Easy-sidan

Ett intressant alternativ är att bädda in en artikel i vilken typ av anpassningsbar sida som helst i Easy Redmine, till exempel Översikt sidan i ett projekt.

Sidmodulen heter Kunskapsartikel. Sök bara i artikeln, välj den och spara sidan. Denna sökning går igenom allt indexerat innehåll i KB.

Professionellt genomförande

I enlighet med standarderna för robusta företagssystem kan Knowledge Base också komma med en dedikerad konsult som guidar dig genom implementeringen som återspeglar dina affärsspecifikationer. Fråga din kontoansvarige eller support om detta alternativ.

Easy Software kan med tillförsikt rekommendera professionell implementering baserat på vår egen erfarenhet av denna tjänst som tillhandahålls oss av vår partner, författaren till applikationen.