Kiuwan - Execució d'una revisió del codi font

Prerequisit: Donar d’alta l’aplicació a analitzar

Descarregar Kiuwan Local Analyzer (KLA)

Kiuwan proporciona un analitzador de codi local que s’ha de descarregar des de la mateixa web de Kiuwan un cop l’usuari està donat d’alta a l’eina.

Per a poder descarregar KLA cal iniciar sessió a kiuwan: https://www.kiuwan.com, escollir des de l’opció del menú d’usuari Download Kiuwan Local Analyzer i instal·lar l’executable descarregat.

Primer lliurament

El primer lliurament està enfocat a establir una línia base i veure l’estat actual de l’aplicació. Cal diferenciarel primer lliurament segons l’estat en que es trobi l’aplicació:

• Nova aplicació: En aquest cas es realitzarà el primer lliurament obligatori quant el desenvolupament estigui al 20%, per tal d’establir la línia base i poder resoldre els defectes identificats en aquest moment del desenvolupament.

• En producció: En aquest cas es realitzarà el primer lliurament abans de realitzar cap modificació del codi font (implementació de nous evolutius. Cal lliurar el codi tal i com està a producció per tal d’establir la línia base de l’aplicació.

Els passos per a realitzar el primer lliurament, usant l’eina KLA són:

1.Seleccionar el tipus d’entrega que es vol realitzar. Per la primera anàlisi o lliurament escollirem sempre el tipus “BASELINE”

2.Seleccionar l’aplicació en el desplegable Aplication name

3.Escollir la ubicació del codi a analitzar.

4.Seleccionem “Continuar” i sen’s mostraran les tecnologies que ha trobat per analitzar.

5.Prémer el botó Advanced per agilitzar el procés d’anàlisi i aconseguir afinar l’indicador de codi duplicat.**

Per a cadascun dels llenguatges s’ha de modificar: número de “tokens” que considerem com a codi duplicat ( 400) i marcarem a “false” els identificadors i literals.

6.Finalmente prémer el botó Analyze

Posteriors lliuraments

Tots els lliuraments posteriors es consideren com a entregues per avaluar l’evolució dels defectes del nou codi desenvolupat.

Els passos per a realitzar lliuraments posteriors són:

1. Seleccionar el tipus d’entrega que es vol realitzar

   Cal diferenciar els 2 tipus de lliurament:

   • Partial Delivery: Es realitzarà amb les entregues parcials que es realitzin al llarg del desenvolupament de l’aplicació, obligatori realitzar un “Partial Delivery” quant s’arribi al 80% del desenvolupament per tal de veure els defectes dels nous evolutius i resoldre’ls abans de pujar a producció .

     Partial Delivery - Impacte llicència

     • Impacte en la capacitat de la llicència diària: consumeix únicament el nombre de línies noves que té l’aplicació, respecte el total de nombre de MLOCs disponibles a analitzar en 24 hores. Si en aquesta entrega hi ha línies que s’han modificat però que ja existien, no es comptabilitza com a una nova línia.

     • Impacte en la capacitat de la llicència global: consumeix únicament el nombre de línies noves que té l’aplicació, respecte el total de nombre de MLOCs disponibles de la llicència a nivell global. Si en aquesta entrega hi ha línies que s’han modificat però que ja existien, no es comptabilitza com a una nova línia.

   • Complete Delivery: Es realitzarà amb les entregues completes que es realitzin a la Pipeline, és a dir, amb l’entrega final al SIC.

     Complete Delivery - Impacte llicència

     • Impacte en la capacitat de la llicència diària: consumeix el total de nombre de línies que té tota l’aplicació, respecte el total de nombre de MLOCs disponibles a analitzar en 24 hores.
     • Impacte en la capacitat de la llicència global: consumeix únicament el nombre de línies noves que té l’aplicació, respecte el total de nombre de MLOCs disponibles de la llicència a nivell global. Si en aquesta entrega hi ha línies que s’han modificat però que ja existien, no es comptabilitza com a una nova línia.

2. Identificar informació del lliurament. Aquesta facilitarà la seva identificació al mòdul de gestió dels cicles de lliurament de Kiuwan per a consultar de manera resumida el resultat de l’entrega i poder comparar l’històric.

   • Change request: Es recomana introduir en quin evolutiu s’està treballant seguit del número de petició del CR. (ex: login_cr01)

   • Change request status: Obligatori complimentar.

     • In progress: Si el codi que s’analitza es part d’un evolutiu en progrés.
     • Resolved: Si la pujada és d’evolutius ja finalitzats.
     • Branch name: No és obligatori però es recomana introduir el nom de la branca que s’està treballant.

   • Delivery label: És obligatori introduir una etiqueta d’entrega. Cal seguir la nomenclatura de versions.

   

3. I seguir els mateixos passos que al primer lliurament.

Llistat d’errors

Si KLA troba algun inconvenient en realitzar l’anàlisi , ja hagi finalitzat o no, ho comunicarà mitjançant un codi d’error. Per a conèixer el motiu cal mirar la descripció del codi d’error:

L’anàlisi no s’ha realitzat

Codi d’Error	Error	Motiu	Responsable revisió
1	Error d’execució de l’analitzador	Error en temps d’execució (per falta de memòria, timeouts d’anàlisi, errors de la JVM, …), en resum, errors de caire tècnic.	Proveïdor
11	Configuració d’anàlisi no vàlida	Alguns paràmetres de configuració tenen un valor incorrecte	OQUAL
12	El model CQM no té configurat algun dels llenguatges a analitzar	El model especificat per a l’aplicació no té regles per a alguna de les seves tecnologies.	OQUAL
13	Timeout execució d’anàlisi	Si s’ha superat el límit LOCs analitzades en 24h, l’anàlisi local dóna un timeout però no vol dir que l’anàlisi hagi fallat sinó que es fica a la cua per executar-se de forma automàtica un cop ja no hi ha problema de límit de LOCs.	OQUAL / Proveïdor

L’anàlisi s’ha realitzat

Codi d’Error	Error	Motiu	Responsable revisió
10	Resultat KO Auditoria	El resultat de l’anàlisi no compleix els criteris d’acceptació	Proveïdor
14	L’anàlisi ha finalitzat amb un error a KIUWAN	L’anàlisi local ha finalitzat amb èxit, però s’ha produït algun error al processar l’anàlisi al núvol	Suport tècnic KIUWAN