base di conoscenza

Introduzione

Questo articolo contiene la documentazione per base di conoscenza (ufficialmente rilasciato nel febbraio 2023, disponibile dalla versione 12.6 e successive), che è il successore di un vecchio plug-in (indipendente) - base di conoscenza.

Knowledge Base è una soluzione nativamente integrata di Easy Redmine con Spice Blu, su cui si basa MediaWiki, e sviluppato dal nostro partner tecnologico Ciao mondo!. Questa è un'applicazione di condivisione delle conoscenze veramente dedicata che funziona in sinergia con le capacità di cooperazione del team di Easy Redmine.

I dati dal plugin originale possono essere migrati in KB .

Configurazione della Kb

Dal punto di vista tecnico KB è un'applicazione eseguita separatamente che è strettamente connessa a Easy Redmine. Comprendendo i potenziali problemi per gli amministratori delle applicazioni, ci siamo impegnati a renderlo il più agevole possibile.

Cloud

Per gli utenti Cloud, l'intero processo è automatico. L'istanza KB viene stabilita e connessa automaticamente a Easy Redmine. Quando decidi di testarlo o di utilizzarlo in produzione, funziona allo stesso modo di qualsiasi altra funzionalità standard: il componente aggiuntivo è attivato (troverai una nuova voce nel menu ALTRO) e puoi iniziare a usarlo subito.

server

La soluzione Server di KB viene fornita come immagine Docker. Dopo averlo eseguito nella tua infrastruttura, lo collegherai a Easy Redmine tramite l'interfaccia utente nell'amministrazione ER.

Si prega di leggere il manuale di installazione dettagliato qui.

trials

KB non è disponibile nelle normali applicazioni di prova. Per testarlo, contatta il tuo account manager o Supporto facile.

Demo live

È disponibile una demo live condivisa su https://demo-kb.easysoftware.com/ (manager / easy848). I dati in questa applicazione vengono condivisi e reimpostati regolarmente.

Amministrazione in Easy Redmine

Per accedere all'amministrazione di KB, vai su Amministrazione >> Plugin >> Base di conoscenza - Modifica

Impostazioni del provider BS oauth2 per l'API

Questa parte è per il collegamento generale tra ER e KB. Come accennato in precedenza, in Cloud, viene generato automaticamente.

Vedi Il pulsante dovrebbe essere la prima cosa da testare se ritieni che KB non funzioni (ad esempio la ricerca KB non restituisce risultati). È anche importante fare sempre clic Vedi in caso di modifiche alle impostazioni.

Semplici impostazioni del provider oauth2 per SSO

L'SSO viene generato automaticamente sia sulla soluzione Cloud che Server. Sono disponibili informazioni importanti per eventualmente eseguire il debug dei problemi di accesso da ER a KB.

Aggiorna le autorizzazioni su BS per tutti gli utenti

Il pulsante è solo per situazioni di emergenza. Il meccanismo dietro di esso funziona automaticamente.

Esempio: quando riduci il permesso di qualcuno da gestire a vista, potrebbe essere necessaria fino a un'ora per la propagazione della modifica in KB. Se non si desidera attendere la propagazione automatica della modifica, è sufficiente fare clic su questo pulsante.

Ruoli e autorizzazioni

Esistono tre livelli di accesso configurati all'interno di Easy Redmine.

 

In Ruoli e autorizzazioni troverai la sezione per KB

• Visualizza articoli - L'utente in un ruolo con questa autorizzazione consentita può solo leggere le pagine
  
• Gestisci articoli: l'utente in un ruolo con questa autorizzazione consentita è un "Editor" in KB , il che significa che può creare e modificare pagine e ha consentito anche altre operazioni (non di amministratore).
  
• L'amministratore in ER ha anche accesso all'amministrazione della KB
  

Migrazione dalla Knowledge Base originale

Se non hai mai usato la versione originale, puoi tranquillamente ignorare questo capitolo.

Se stai utilizzando la Knowledge Base originale e prevedi di migrare a KB, significa che le hai installate (attivate) entrambe. In tal caso, troverai una sezione aggiuntiva in Amministrazione >> Plugin >> Base di conoscenza - Modifica

Cosa succede dopo aver fatto clic sul pulsante:

1. I post della conoscenza originali vengono convalidati se sono facilmente migrabili
2. I post facilmente migrabili vengono migrati
3. I post "problematici" vengono elencati e lasciati alla tua decisione

Cosa significa problematico?

Alcuni titoli di pagina (nome del post di conoscenza) che erano consentiti nella KB originale non sono consentiti o hanno un significato speciale. Di conseguenza, verrebbero trasformati durante la migrazione o migrerebbero il contenuto in modo imprevisto.

I dettagli su tutti i caratteri del titolo speciali o illegali sono disponibili qui:
https://www.mediawiki.org/wiki/Manual:Page_title
https://www.mediawiki.org/wiki/Manual:%24wgLegalTitleChars

In pratica, un esempio di carattere funzionale speciale è la barra "/", come il titolo: Come creare/aggiornare attività. In KB "/" rappresenta il delimitatore per la sottopagina. Ciò significherebbe che la migrazione importerebbe la pagina: Come creare e la sua sottopagina compito di aggiornamento. Che non è certamente quello che ti aspetti o vuoi. In questo caso, preferiresti modificare il titolo del post di conoscenza in Come creare o aggiornare l'attività.

Dopo aver modificato il titolo, fare clic su Convalida e migra pulsante di nuovo, questa pagina non sarà più elencata come problematica, ma migrata direttamente.

Un altro esempio sono semplicemente i caratteri non consentiti, come ">" o "&", che possono essere rimossi o sostituiti dalla migrazione. Dipende dalla situazione specifica. Ti consigliamo inoltre di modificare questi titoli piuttosto che importarli senza convalida.

Migrazione senza convalida

Se ci sono articoli che non hanno superato la convalida, questo pulsante ti consentirà di migrare quelli che hanno superato e ignorare il resto.

Accesso alla KB

Dal lato di Easy Redmine, è possibile accedere a KB tramite vari punti di contatto.

Altro menu

Come per molte altre funzionalità, anche i KB possono essere inseriti tramite il menu Altro. Lo troverai nella sezione dei componenti aggiuntivi. Cliccando qui ti porterà alla pagina principale di KB .

Barra laterale (barra di servizio)

Proprio come nell'originale, KB ha un widget di ricerca nella sempre presente barra di destra. L'icona è leggermente diversa per evitare confusione durante il periodo temporaneo in cui potresti avere entrambi i KB attivati.

Cerca semplicemente la tua parola chiave. Facendo clic sul risultato, verrai indirizzato all'articolo nell'applicazione KB.

Questa ricerca esamina tutto il contenuto indicizzato in KB .

Articoli correlati sull'attività

Quando un'attività ha articoli correlati, potrai accedervi direttamente dai dettagli dell'attività. La ricerca disponibile in questa sezione cerca solo attraverso l'articolo titoli, non l'intero contenuto.

Lavorando in KB

Poiché KB è un'applicazione separata, dispone anche di un proprio manuale utente disponibile all'indirizzo: https://knowledge-base.easysoftware.com

Il manuale stesso è un'istanza implementata. Si compone di 4 libri principali e ti guida attraverso i tuoi primi passi e introduce le aree organizzative e amministrative più cruciali. Ricorda che non c'è fretta nell'implementare un intero sistema di condivisione delle conoscenze. Seguilo passo dopo passo in modo da comprendere appieno la logica di base prima di inserirlo nella tua organizzazione.

Relazioni dati Easy Redmine + KB

Easy Redmine contiene progetti e attività (in parole povere), KB contiene articoli (di nuovo, una formulazione semplificata). Diamo un'occhiata a come si intrecciano.

Compito - articolo

La connessione più naturale che mi viene in mente è tra le entità più utilizzate.

Su ogni attività troverai una sezione per cercare articoli della conoscenza, per collegarli all'attività con un solo clic. Questa ricerca va solo attraverso l'articolo titoli, non l'intero contenuto.

Lo scollegamento avviene come al solito tramite il pulsante di scollegamento

Ecco come appare dal lato dell'articolo della conoscenza.

Progetto - articolo

Gli articoli della Knowledge Base possono essere collegati ai progetti dal lato della KB

Articolo incorporato nella pagina Easy

Un'opzione interessante è incorporare un articolo in qualsiasi tipo di pagina personalizzabile in Easy Redmine, come il Panoramica pagina di un progetto

Il modulo della pagina si chiama Articolo della conoscenza. Basta cercare l'articolo, selezionarlo e salvare la pagina. Questa ricerca esamina tutto il contenuto indicizzato in KB .

Implementazione professionale

In conformità con gli standard dei solidi sistemi aziendali, la Knowledge Base può anche essere fornita con un consulente dedicato che ti guiderà attraverso l'implementazione riflettendo le specifiche della tua azienda. Chiedi informazioni su questa opzione al tuo account manager o al supporto.

Easy Software può consigliare con fiducia l'implementazione professionale basata sulla nostra esperienza con questo servizio fornitoci dal nostro partner, l'autore dell'applicazione.