Baza Wiedzy

Wprowadzenie

Ten artykuł zawiera dokumentację dla Baza Wiedzy (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 to natywnie zintegrowane rozwiązanie Easy Redmine z 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 KB.

Konfigurowanie KB

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

Chmura

Dla użytkowników Cloud cały proces przebiega automatycznie. Instancja KB jest automatycznie ustanawiana i połączona z Twoim Easy Redmine. Jeśli zdecydujesz się go przetestować lub wykorzystać w produkcji, działa on tak samo, jak w przypadku każdej innej standardowej funkcjonalności - dodatek zostaje aktywowany (nową pozycję znajdziesz w menu WIĘCEJ) i możesz od razu zacząć z niego korzystać.

serwer

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

Przeczytaj szczegółową instrukcję instalacji tutaj.

Próby

Baza KB nie jest dostępna w zwykłych aplikacjach próbnych. Aby to przetestować, skontaktuj się ze swoim menadż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, przejdź do Administracja >> Wtyczki >> Baza wiedzy - Edycja

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.

Kontrola 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ć Kontrola 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 Rolach i uprawnieniach znajdziesz sekcję KB

• 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, co oznacza, że ​​może tworzyć i edytować strony, a także zezwolił na inne operacje (nie będące administratorami).
  
• Administrator w ER ma także dostęp do administracji KB
  

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 KB, oznacza to, że masz oba zainstalowane (aktywowane). W takim przypadku znajdziesz dodatkową sekcję w Administracja >> Wtyczki >> Baza wiedzy - Edycja

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 "/" oznacza 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ę.

Dojazd do KB

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

Więcej menu

Podobnie jak w przypadku wielu innych funkcji, do KB można również wejść poprzez menu Więcej. Znajdziesz go w sekcji dodatków. Kliknięcie tutaj przeniesie Cię na stronę główną KB.

Pasek boczny (pasek usług)

Podobnie jak w oryginale, KB posiada widżet wyszukiwania na zawsze obecnym prawym pasku. Ikona jest nieco inna, aby uniknąć zamieszania w tymczasowym okresie, gdy możesz mieć aktywowane oba KB.

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

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

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

Ponieważ KB jest odrębną 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

Easy Redmine zawiera projekty i zadania (w bardzo prosty sposób), KB 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 łączyć z projektami ze strony KB

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ł merytoryczny. Po prostu przeszukaj artykuł, wybierz go i zapisz stronę. To wyszukiwanie przegląda całą zaindeksowaną zawartość w KB.

Profesjonalna realizacja

Zgodnie ze standardami solidnych systemów korporacyjnych, w Bazie Wiedzy może znajdować się także dedykowany konsultant, który przeprowadzi Cię przez proces wdrożenia uwzględniający specyfikę Twojego biznesu. Zapytaj swojego menedżera konta lub wsparcie 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.