Catalogo delle capacità¶

Turbo EA viene fornito con il Business Capability Reference Catalogue — un catalogo aperto e curato di capacità di business mantenuto su github.com/vincentmakes/turbo-ea-capabilities. La pagina Catalogo delle capacità consente di consultare questo riferimento e di creare in blocco le carte BusinessCapability corrispondenti, invece di digitarle una per una.

Aprire la pagina¶

Fare clic sull'icona dell'utente nell'angolo in alto a destra dell'app, quindi su Catalogo delle capacità. La pagina è disponibile per chiunque disponga del permesso inventory.view.

Cosa si vede¶

Intestazione — la versione attiva del catalogo, il numero di capacità contenute e (per gli amministratori) i controlli per verificare e ottenere gli aggiornamenti.
Barra dei filtri — ricerca testuale completa su id, nome, descrizione e alias, oltre a chip di livello (L1 → L4), un selettore multiplo di settore e un interruttore «Mostra deprecate».
Barra delle azioni — contatori di corrispondenze, lo stepper globale di livello (apre/chiude tutti gli L1 di un livello alla volta), espandi/comprimi tutto, seleziona visibili, pulisci selezione.
Griglia di L1 — una carta per ogni capacità di primo livello. Il nome dell'L1 è inserito in una fascia di intestazione blu chiaro; le capacità figlie sono elencate sotto, indentate con una sottile linea verticale per indicare la profondità — la stessa convenzione gerarchica usata nel resto dell'app, in modo che la pagina non porti un'identità visiva propria. I nomi lunghi vanno a capo su più righe invece di essere troncati. Ogni intestazione di L1 espone inoltre il proprio stepper − / +: + apre il livello successivo dei discendenti solo per quell'L1, − chiude il livello aperto più profondo. Entrambi i pulsanti sono sempre visibili (la direzione non disponibile è disabilitata), l'azione è limitata a quel singolo L1 — gli altri rami restano fermi — e lo stepper globale in cima alla pagina non viene influenzato.

Selezionare le capacità¶

Selezionare la casella accanto a una capacità per aggiungerla alla selezione. La selezione si propaga lungo il sottoalbero in entrambe le direzioni ma non tocca mai gli antenati:

Spuntare una capacità non selezionata aggiunge essa e ogni discendente selezionabile.
Deselezionare una capacità selezionata rimuove essa e ogni discendente selezionabile.

Deselezionare un singolo figlio rimuove quindi soltanto quel figlio e ciò che sta sotto — il genitore e i fratelli restano selezionati. Deselezionare un genitore rimuove l'intero sottoalbero in un colpo solo. Per ottenere una selezione «L1 + qualche foglia», scegliere l'L1 (questo seleziona l'intero sottoalbero) e poi deselezionare le capacità L2/L3 che non si vogliono — l'L1 resta selezionato e la sua casella resta spuntata.

La pagina adotta automaticamente il tema chiaro/scuro dell'app — in modalità scura viene reso lo stesso layout neutro su carta #1e1e1e con testo e accenti color lavanda.

Le capacità che esistono già nel proprio inventario appaiono con un'icona di spunta verde invece di una casella. Non possono essere selezionate — non si potrà mai creare due volte la stessa Business Capability tramite il catalogo. La corrispondenza preferisce il marcatore attributes.catalogueId lasciato da un'importazione precedente (così la spunta verde sopravvive alle modifiche del nome visualizzato) e ricade su un confronto del nome visualizzato insensibile alle maiuscole per le carte create a mano.

Creazione massiva delle carte¶

Quando una o più capacità sono selezionate, in fondo alla pagina compare un pulsante fisso Crea N capacità. Usa il permesso ordinario inventory.create — se il proprio ruolo non consente la creazione di carte, il pulsante è disabilitato.

Alla conferma, Turbo EA:

Crea una carta BusinessCapability per ogni voce del catalogo selezionata.
Preserva automaticamente la gerarchia del catalogo — quando sia il genitore sia il figlio sono selezionati (oppure il genitore esiste già localmente), il parent_id della nuova carta figlio è collegato alla carta corretta.
Salta in silenzio le corrispondenze esistenti. La finestra di risultato mostra quante carte sono state create e quante saltate.
Marca gli attributes di ogni nuova carta con catalogueId, catalogueVersion, catalogueImportedAt e capabilityLevel, in modo da poter risalire alla loro origine.

Eseguire di nuovo la stessa importazione è sicuro — è idempotente.

Collegamento bidirezionale. La gerarchia viene riparata in entrambe le direzioni, quindi l'ordine di importazione non conta:

Selezionando solo un figlio il cui genitore di catalogo esiste già come carta, il nuovo figlio viene innestato automaticamente sotto quel genitore esistente.
Selezionando solo un genitore i cui figli di catalogo esistono già come carte, quei figli vengono ri-collegati sotto la nuova carta — indipendentemente da dove si trovino al momento (al primo livello o annidati a mano sotto un'altra carta). In fase di importazione il catalogo fa fede sulla gerarchia; se si preferisce un genitore diverso per una carta specifica, modificarla dopo l'importazione. La finestra di risultato indica quante carte sono state ri-collegate accanto ai conteggi di create e saltate.

Vista di dettaglio¶

Fare clic sul nome di una capacità per aprire una finestra di dettaglio che mostra la breadcrumb, la descrizione, il settore, gli alias, i riferimenti e una vista completamente espansa del suo sottoalbero. Le corrispondenze esistenti nel sottoalbero sono evidenziate con una spunta verde.

Aggiornare il catalogo (amministratori)¶

Il catalogo è distribuito incluso come dipendenza Python, quindi la pagina funziona offline / in deployment isolati. Gli amministratori (admin.metamodel) possono ottenere una versione più recente su richiesta:

Fare clic su Verifica aggiornamenti. Turbo EA interroga https://capabilities.turbo-ea.org/api/version.json e segnala se è disponibile una versione più recente.
In caso affermativo, fare clic sul pulsante Ottieni v… che appare. Turbo EA scarica il catalogo più recente e lo memorizza come override lato server; ha effetto immediato per tutti gli utenti.

La versione attiva del catalogo è sempre indicata nel chip di intestazione. L'override prevale sul pacchetto incluso solo quando la sua versione è strettamente maggiore — così un aggiornamento di Turbo EA che fornisce un catalogo incluso più recente continuerà a funzionare come previsto.

L'URL remoto è configurabile tramite la variabile d'ambiente CAPABILITY_CATALOGUE_URL, per i deployment self-hosted che fanno mirror interno del catalogo pubblico.