Baza wiedzy 2.0

Wprowadzenie

Ten artykuł zawiera dokumentację dla Baza wiedzy 2.0 (oficjalnie wydana w lutym 2023, dostępna od wersji 12.6 i wyższej), która jest następcą starszej (niezależnej) wtyczki - Baza wiedzy.

Baza wiedzy 2.0 to natywnie zintegrowane rozwiązanie Easy Redmine BlueSpice, na którym jest zbudowany MediaWikii opracowany przez naszego partnera technologicznego Witaj świecie!. Jest to naprawdę dedykowana aplikacja do dzielenia się wiedzą, która działa w synergii z możliwościami współpracy zespołowej Easy Redmine.

Dane z oryginalnej wtyczki można przenieść do wersji KB 2.0.

Konfigurowanie KB 2.0

Z technicznego punktu widzenia KB 2.0 to oddzielnie działająca aplikacja, która jest ściśle powiązana z Easy Redmine. Rozumiejąc potencjalne problemy dla administratorów aplikacji, dołożyliśmy wszelkich starań, aby było to jak najbardziej płynne.

Chmura

Dla użytkowników Cloud cały proces jest automatyczny. Instancja KB 2.0 jest automatycznie ustanawiana i podłączana do Easy Redmine. Kiedy zdecydujesz się go przetestować lub użyć w produkcji, działa on tak samo, jak każda inna standardowa funkcjonalność - dodatek jest aktywowany (znajdziesz nową pozycję w menu WIĘCEJ) i możesz od razu zacząć z niego korzystać.

serwer

Rozwiązanie serwerowe KB 2.0 jest dostarczane jako obraz platformy Docker. Po uruchomieniu go w swojej infrastrukturze połączysz go z Easy Redmine za pośrednictwem interfejsu użytkownika w administracji ER.

Przeczytaj szczegółową instrukcję instalacji tutaj.

Próby

Aktualizacja KB 2.0 nie jest dostępna w zwykłych aplikacjach próbnych. Aby to przetestować, skontaktuj się ze swoim menedżerem konta lub Łatwe wsparcie.

Live demo

Dostępne jest wspólne demo na żywo pod adresem https://demo-kb.easysoftware.com/ (menedżer / easy848). Dane w tej aplikacji są regularnie udostępniane i resetowane.

Administracja w Easy Redmine

Aby uzyskać dostęp do administracji KB 2.0, przejdź do Administracja >> Wtyczki >> Baza wiedzy 2.0 - Edytuj

Ustawienia dostawcy BS oauth2 dla interfejsu API

Ta część dotyczy ogólnego połączenia między ER i KB. Jak wspomniano powyżej, w chmurze jest generowany automatycznie.

Sprawdź powinien być pierwszą rzeczą, którą testujesz, jeśli czujesz, że KB nie działa (na przykład wyszukiwanie KB nie zwraca wyników). Ważne jest również, aby zawsze klikać Sprawdź w przypadku jakichkolwiek zmian w ustawieniach.

Łatwe ustawienia dostawcy Oauth2 dla SSO

SSO jest generowane automatycznie zarówno w rozwiązaniu chmurowym, jak i serwerowym. Istnieją ważne informacje, które mogą potencjalnie debugować problemy z dostępem od ER do KB.

Zaktualizuj uprawnienia w BS dla wszystkich użytkowników

Przycisk służy tylko do sytuacji awaryjnych. Mechanizm, który za tym stoi, działa automatycznie.

Przykład: Kiedy obniżasz czyjeś pozwolenie od zarządzanie do widok, rozpowszechnienie tej zmiany w KB może zająć nawet godzinę. Jeśli nie chcesz czekać na automatyczną propagację zmiany, po prostu kliknij ten przycisk.

Role i uprawnienia

Istnieją trzy poziomy dostępu, które są konfigurowane w Easy Redmine.

 

W Role i uprawnienia znajdziesz sekcję dla KB 2.0

• Wyświetl artykuły — użytkownik w roli z tym uprawnieniem może tylko czytać strony
  
• Zarządzaj artykułami — użytkownik w roli z tym uprawnieniem jest „edytorem” w KB 2.0, co oznacza, że ​​może tworzyć i edytować strony, a także zezwalać na inne (nieadministracyjne) operacje.
  
• Administrator w ER ma również dostęp do administracji KB 2.0
  

Migracja z oryginalnej bazy wiedzy

Jeśli nigdy nie korzystałeś z oryginalnej wersji, możesz bezpiecznie zignorować ten rozdział.

Jeśli korzystasz z oryginalnej Bazy wiedzy i planujesz migrację do wersji KB 2.0, oznacza to, że masz zainstalowane (aktywowane) obie wersje. W takim przypadku znajdziesz dodatkową sekcję Administracja >> Wtyczki >> Baza wiedzy 2.0 - Edytuj

Co się dzieje po kliknięciu przycisku:

1. Oryginalne wpisy wiedzy są weryfikowane pod kątem tego, czy można je bezproblemowo migrować
2. Bezproblemowo migrowane posty są migrowane
3. „Problematyczne” posty są wymienione i pozostawione do Twojej decyzji

Co znaczy problematyczny?

Niektóre tytuły stron (nazwa wpisu wiedzy), które były dozwolone w oryginalnej bazie wiedzy, są niedozwolone lub mają specjalne znaczenie. W rezultacie albo zostałyby przekształcone podczas migracji, albo przeniosłyby zawartość w nieoczekiwany sposób.

Szczegółowe informacje na temat wszystkich specjalnych lub nielegalnych znaków tytułowych są dostępne tutaj:
https://www.mediawiki.org/wiki/Manual:Page_title
https://www.mediawiki.org/wiki/Manual:%24wgLegalTitleChars

W praktyce przykładem specjalnego znaku funkcjonalnego jest ukośnik „/”, taki jak tytuł: Jak utworzyć/zaktualizować zadanie. W KB 2.0 "/" reprezentuje ogranicznik podstrony. Oznaczałoby to, że migracja zaimportuje stronę: Jak stworzyć i jego podstronę zadanie aktualizacji. Co z pewnością nie jest tym, czego oczekujesz lub chcesz. W takim przypadku wolisz edytować tytuł wpisu wiedzy na Jak utworzyć lub zaktualizować zadanie.

Po edycji tytułu kliknij Zweryfikuj i przeprowadź migrację ponownie, ta strona nie będzie już wyświetlana jako problematyczna, ale bezpośrednio przeniesiona.

Innym przykładem są po prostu niedozwolone znaki, takie jak „>” lub „&”, które mogą zostać usunięte lub zastąpione przez migrację. To zależy od konkretnej sytuacji. Zalecamy również zmianę tych tytułów zamiast importowania bez weryfikacji.

Migruj bez sprawdzania poprawności

Jeśli istnieją artykuły, które nie przeszły walidacji, ten przycisk pozwoli ci przenieść te, które przeszły pomyślnie, i zignorować resztę.

Dostęp do KB 2.0

Od strony Easy Redmine dostęp do KB 2.0 można uzyskać za pośrednictwem różnych punktów dotykowych.

Więcej menu

Podobnie jak w przypadku wielu innych funkcji, KB 2.0 można również wprowadzić za pomocą menu Więcej. Znajdziesz go w sekcji dodatków. Kliknięcie tutaj przeniesie Cię do strony głównej KB 2.0.

Pasek boczny (pasek usług)

Podobnie jak w oryginale, KB 2.0 ma widżet wyszukiwania na zawsze obecnym prawym pasku. Ikona jest nieco inna, aby uniknąć zamieszania w okresie przejściowym, kiedy możesz mieć aktywowane oba KB.

Po prostu wyszukaj słowo kluczowe. Klikając na wynik, zostaniesz przekierowany do artykułu w aplikacji KB 2.0.

To wyszukiwanie przegląda całą zindeksowaną zawartość w KB 2.0.

Powiązane artykuły na temat zadania

Gdy zadanie ma powiązane artykuły, uzyskasz do nich dostęp bezpośrednio ze szczegółów zadania. Wyszukiwarka dostępna w tej sekcji przeszukuje tylko artykuł tytuły, a nie cała treść.

Praca w KB 2.0

Ponieważ KB 2.0 jest oddzielną aplikacją, posiada również własną instrukcję obsługi dostępną pod adresem: https://knowledge-base.easysoftware.com

Podręcznik sam w sobie jest zaimplementowaną instancją. Składa się z 4 głównych książek i przeprowadzi Cię przez pierwsze kroki oraz przybliży najważniejsze obszary organizacyjne i administracyjne. Pamiętaj, że nie ma pośpiechu we wdrażaniu całego systemu dzielenia się wiedzą. Zrób to krok po kroku, aby najpierw w pełni zrozumieć podstawową logikę, zanim przeniesiesz ją do swojej organizacji.

Łatwe relacje danych Redmine + KB 2.0

Easy Redmine zawiera projekty i zadania (mówiąc bardzo prosto), KB 2.0 zawiera artykuły (znowu uproszczone sformułowanie). Przyjrzyjmy się, jak się przeplatają.

Zadanie - artykuł

Najbardziej naturalne połączenie, jakie przychodzi na myśl, występuje między najczęściej używanymi bytami.

Przy każdym zadaniu znajdziesz sekcję do wyszukiwania artykułów merytorycznych, aby połączyć je z zadaniem za pomocą jednego kliknięcia. To wyszukiwanie przechodzi tylko przez artykuł tytuły, a nie cała treść.

Odłączenie odbywa się jak zwykle za pomocą przycisku rozłącz

Tak to wygląda od strony artykułu wiedzy.

Projekt - artykuł

Artykuły merytoryczne można powiązać z projektami od strony KB 2.0

Artykuł osadzony na stronie Easy

Ciekawą opcją jest osadzenie artykułu na dowolnej dostosowywanej stronie w Easy Redmine, takiej jak Przegląd strona projektu.

Moduł strony nosi nazwę Artykuł wiedzy. Po prostu wyszukaj artykuł, wybierz go i zapisz stronę. To wyszukiwanie przegląda całą zindeksowaną zawartość w KB 2.0.

Profesjonalna realizacja

Zgodnie ze standardami solidnych systemów korporacyjnych, Baza Wiedzy 2.0 może być również wyposażona w dedykowanego konsultanta, który przeprowadzi Cię przez wdrożenie odzwierciedlające specyfikę Twojego biznesu. Zapytaj swojego menedżera konta lub dział pomocy o tę opcję.

Easy Software może śmiało polecić profesjonalne wdrożenie w oparciu o własne doświadczenia z tą usługą świadczoną dla nas przez naszego Partnera, autora aplikacji.