Znalostní báze

Úvod

Tento článek obsahuje dokumentaci pro Znalostní báze (oficiálně vydáno v únoru 2023, dostupné od verze 12.6 a vyšší), což je nástupce staršího (nezávislého) pluginu - Znalostní báze.

Knowledge Base je nativně integrované řešení Easy Redmine with BlueSpice, který je postaven na MediaWikia vyvinutý naším technologickým partnerem Ahoj světe!. Toto je skutečně specializovaná aplikace pro sdílení znalostí, která funguje v synergii s funkcemi týmové spolupráce Easy Redmine.

Data z původního pluginu lze migrovat do KB .

Nastavení KB

Z technického hlediska je KB samostatně běžící aplikace, která je úzce propojena s Easy Redmine. Pochopili jsme potenciální potíže pro administrátory aplikací a zavázali jsme se, že to bude co nejhladší.

mrak

Pro uživatele Cloudu je celý proces automatický. Instance KB se automaticky vytvoří a připojí k vašemu Easy Redmine. Když se ho rozhodnete otestovat, případně použít ve výrobě, funguje stejně jako v jakékoli jiné standardní funkcionalitě - doplněk se aktivuje (novou položku najdete v nabídce VÍCE) a můžete jej začít hned používat.

Server

Serverové řešení KB je poskytováno jako Docker image. Poté, co jej spustíte ve vaší infrastruktuře, připojíte jej k vašemu Easy Redmine prostřednictvím uživatelského rozhraní v administraci ER.

Přečtěte si prosím podrobný návod k instalaci zde.

Trials

KB není k dispozici v běžných zkušebních aplikacích. Chcete-li jej otestovat, kontaktujte svého account managera popř Snadná podpora.

Živá ukázka

K dispozici je sdílené živé demo na https://demo-kb.easysoftware.com/ (manager / easy848). Data v této aplikaci jsou sdílena a pravidelně resetována.

Správa v Easy Redmine

Pro přístup ke správě KB přejděte do Administrace >> Pluginy >> Knowledge Base - Upravit

Nastavení poskytovatele BS oauth2 pro API

Tato část je pro obecné spojení mezi ER a KB. Jak již bylo zmíněno výše, v Cloudu se generuje automaticky.

Kontrola Tlačítko by mělo být první věcí, kterou otestujete, pokud máte pocit, že KB nefunguje (například vyhledávání KB nevrací výsledky). Důležité je také vždy klikat Kontrola v případě jakýchkoli změn v nastavení.

Snadné nastavení poskytovatele oauth2 pro jednotné přihlášení

Jednotné přihlášení se generuje automaticky na cloudovém i serverovém řešení. Jsou zde důležité informace pro případné ladění problémů s přístupem z ER do KB.

Aktualizujte oprávnění na BS pro všechny uživatele

Tlačítko je pouze pro nouzové situace. Mechanismus za ním funguje automaticky.

Příklad: Když někomu snížíte oprávnění od řídit na pohled, může trvat až hodinu, než se tato změna rozšíří do KB. Pokud nechcete čekat na automatické šíření změny, stačí kliknout na toto tlačítko.

Role a oprávnění

V rámci Easy Redmine jsou nakonfigurovány tři úrovně přístupu.

 

V části Role a oprávnění najdete sekci pro KB

• Zobrazit články – Uživatel v roli s tímto povoleným oprávněním smí stránky pouze číst
  
• Spravovat články - Uživatel v roli s tímto povoleným oprávněním je "Editor" v KB , což znamená, že může vytvářet a upravovat stránky a také povolil jiné (neadministrátorské) operace.
  
• Administrátor v ER má také přístup do administrace KB
  

Migrace z původní znalostní báze

Pokud jste nikdy nepoužili původní verzi, můžete tuto kapitolu bez obav ignorovat.

Pokud používáte původní Knowledge Base a plánujete migraci na KB , znamená to, že máte obě nainstalované (aktivované). V takovém případě najdete další sekci v Administraci >> Pluginy >> Knowledge Base - Upravit

Co se stane po kliknutí na tlačítko:

1. Původní znalostní příspěvky jsou ověřeny, zda jsou bezproblémově migrovatelné
2. Bezproblémově migrovatelné příspěvky jsou migrovány
3. "Problematické" příspěvky jsou uvedeny a ponechány na vašem rozhodnutí

Co znamená problematické?

Některé názvy stránek (název znalostního příspěvku), které byly v původní KB povoleny, nejsou povoleny nebo mají zvláštní význam. V důsledku toho by byly buď transformovány během migrace, nebo by migrovaly obsah neočekávaným způsobem.

Podrobnosti o všech speciálních nebo nelegálních titulních postavách jsou k dispozici zde:
https://www.mediawiki.org/wiki/Manual:Page_title
https://www.mediawiki.org/wiki/Manual:%24wgLegalTitleChars

V praxi je příkladem speciálního funkčního znaku lomítko "/", jako je název: Jak vytvořit/aktualizovat úkol. V KB "/" představuje oddělovač pro podstránku. To by znamenalo, že migrace by importovala stránku: Jak vytvořit a její podstránka aktualizovat úkol. Což rozhodně není to, co očekáváte nebo chcete. V tomto případě byste raději upravili název znalostního příspěvku na Jak vytvořit nebo aktualizovat úkol.

Po úpravě názvu klikněte Ověřte a migrujte znovu, tato stránka již nebude uváděna jako problematická, ale přímo migrována.

Dalším příkladem jsou jednoduše nepovolené znaky, jako je ">" nebo "&", které mohou být migrací odstraněny nebo nahrazeny. Záleží na konkrétní situaci. Doporučujeme také tyto názvy raději změnit než importovat bez ověření.

Migrujte bez ověření

Pokud existují články, které neprošly ověřením, toto tlačítko vám umožní migrovat ty, které prošly a zbytek ignorovat.

Přístup k KB

Ze strany Easy Redmine lze KB přistupovat prostřednictvím různých dotykových bodů.

Více menu

Stejně jako u mnoha dalších funkcí lze KB také zadat prostřednictvím nabídky Více. Najdete ho v sekci doplňky. Kliknutím sem se dostanete na hlavní stránku KB.

Postranní panel (servisní panel)

Stejně jako v původní verzi má KB vyhledávací widget ve stále přítomné pravé liště. Ikona je trochu jiná, aby nedošlo k záměně během dočasného období, kdy můžete mít aktivované obě KB.

Jednoduše vyhledejte své klíčové slovo. Kliknutím na výsledek budete přesměrováni na článek v aplikaci KB.

Toto vyhledávání prohledá veškerý indexovaný obsah v KB.

Související články o úkolu

Pokud má úkol související články, získáte k nim přístup přímo z detailu úkolu. Vyhledávání dostupné v této sekci prohlíží pouze článek titulů, nikoli celý obsah.

Práce v KB

Vzhledem k tomu, že KB je samostatná aplikace, má také vlastní uživatelskou příručku k dispozici na adrese: https://knowledge-base.easysoftware.com

Manuál je sám o sobě implementovanou instancí. Skládá se ze 4 hlavních knih a provede vás vašimi prvními kroky a představí nejdůležitější organizační a administrativní oblasti. Pamatujte prosím, že při implementaci celého systému sdílení znalostí není žádný spěch. Postupujte krok za krokem, abyste nejprve plně porozuměli základní logice, než ji zavedete do své organizace.

Snadné datové vztahy Redmine + KB

Easy Redmine obsahuje projekty a úkoly (velmi zjednodušeně řečeno), KB obsahuje články (opět zjednodušená formulace). Podívejme se, jak se prolínají.

Úkol - článek

Nejpřirozenější spojení, které mě napadá, je mezi nejpoužívanějšími entitami.

U každého úkolu najdete sekci pro vyhledávání znalostních článků, abyste je propojili s úkolem jediným kliknutím. Toto vyhledávání probíhá pouze přes článek titulů, nikoli celý obsah.

Odpojení je jako obvykle pomocí tlačítka odpojit

Tak to vypadá ze strany znalostního článku.

Projekt - článek

Znalostní články lze propojit s projekty ze strany KB

Vložený článek na snadné stránce

Zajímavou možností je vložení článku do libovolného typu přizpůsobitelné stránky v Easy Redmine, jako je např O programu stránka projektu.

Modul stránky se nazývá Knowledge article. Stačí článek vyhledat, vybrat a stránku uložit. Toto vyhledávání prohledá veškerý indexovaný obsah v KB.

Profesionální provedení

V souladu se standardy robustních podnikových systémů může znalostní báze obsahovat také specializovaného konzultanta, který vás provede implementací odrážející specifika vašeho podnikání. Zeptejte se na tuto možnost svého správce účtu nebo podpory.

Easy Software může s jistotou doporučit profesionální implementaci na základě vlastních zkušeností s touto službou, kterou nám poskytuje náš Partner, autor aplikace.