Este plugin es muy divertido. Y todo el mundo me dice que es fant\u00e1stica la representaci\u00f3n visual del c\u00f3digo en forma de una ciudad. Ir r\u00e1pidamente a lo m\u00e1s importante es precioso cuando se debe evaluar peri\u00f3dicamente la calidad de una aplicaci\u00f3n.<\/p>\n
<\/p>\n
As\u00ed que pens\u00e9 a unos casos sencillos pero bastante usuales donde su uso ser\u00e1 de gran valor. Esto tambi\u00e9n me dar\u00e1 la oportunidad de demostrar lo f\u00e1cil que es de configurar con diferentes m\u00e9tricas o formulas.<\/p>\n
Ciudad cr\u00edtica<\/strong><\/h3>\nUn cliente me pide una auditor\u00eda de dos de sus aplicaciones. Le hago diferentes preguntas para conocer el \u201cpor qu\u00e9\u201d de esta auditor\u00eda. Puede haber varias razones, y necesito saber un poco m\u00e1s con el fin de responder con precisi\u00f3n a su petici\u00f3n.<\/p>\n
Por ejemplo: el quiere externalizar esas dos aplicaciones bastante viejas, y antes de realizar un RFP, le gustar\u00eda saber cu\u00e1l es el nivel de calidad. De hecho, es una buena idea, que le permitir\u00e1 apreciar mejor las ofertas que se presenten y precisar los costes de mantenimiento. En la actualidad, muchos proveedores est\u00e1n dispuestos a hacer cualquier cosa para conseguir un contrato. Una estimaci\u00f3n de la deuda t\u00e9cnica de estas aplicaciones le permitir\u00e1 rechazar las ofertas ‘low cost’, poco realistas.<\/p>\n
Otro caso: se le pide a un jefe de un centro de desarrollo que se encarga de una aplicaci\u00f3n. Bastante complicada a primera vista: cientos de miles de l\u00edneas de c\u00f3digo .NET, frameworks propiet\u00e1rios, sin documentaci\u00f3n, etc.. Hay de que ser un poco sospechoso. Le gustar\u00eda tener un poco de visibilidad respecto a la calidad de esta aplicaci\u00f3n y el esfuerzo para recuperar este c\u00f3digo, antes de aceptarla. O conseguir alguna informaci\u00f3n que le permite rechazarla.<\/p>\n
De hecho, este cliente utiliza una de esos proveedores ‘low cost’ y resulta un poco fastidioso: retrasos en planificaci\u00f3n, presupuestos en aumento con discusiones dif\u00edciles, muchos errores y los usuarios descontentos, algunas situaciones de crisis, degradaci\u00f3n de la imagen de TI, etc. Bueno, el est\u00e1 buscando algunos motivos para poder explicar a su proveedor de que ya, basta.<\/p>\n
Pues ahora, s\u00e9 c\u00f3mo ir a lo m\u00e1s importante. Violaciones cr\u00edticas. Mu\u00e9strele algunos buenos defectos bien horrorosos.<\/p>\n
Puse en marcha un an\u00e1lisis de c\u00f3digo con Sonar desde Jenkins. Muy sencillo: Sonar \u2013 Jenkins plugin<\/a>. Y muy rapido.<\/p>\n![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_SonarAdmin_Login.jpg\" "\\"Qual_SonarAdmin_Login\\"")
<\/a>Luego me conect\u00e9 como Admin en mi dashboard Sonar preferido:<\/p>\n![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModelTop_Add.jpg\" "\\"Qual_Sonar_CityModelTop_Add\\"")
<\/a>Entr\u00e9 en la configuraci\u00f3n de los widgets para a\u00f1adir un widget City Model Top de eXcentia.<\/p>\nCon los siguientes par\u00e1metros:<\/p>\n
![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModelTop_params.jpg\" "\\"Qual_Sonar_CityModelTop_params\\"")
<\/a><\/p>\n\n- title: Blocker<\/li>\n
- topListLength: 5. Quiero ver \u00fanicamente las 5 primeras violaciones de tipo ‘bloqueantes’.<\/li>\n
- formula: {blocker_violations}.<\/li>\n<\/ul>\n
La f\u00f3rmula corresponde al top 5 de los componentes con m\u00e1s violaciones de tipo ‘Blocker’. Las que no se quiere ver en ninguna aplicaci\u00f3n. Las que presentan m\u00e1s riesgos para los usuarios. Las que demuestran que el outsourcer produce un c\u00f3digo de la peor calidad que sea.<\/p>\n
![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModel_Add.jpg\" "\\"Qual_Sonar_CityModel_Add\\"")
<\/a> Luego voy a a\u00f1adir el widget City Model y a modificar sus par\u00e1metros. El primer campo ‘heightExp’ contiene una f\u00f3rmula para definir la altura de cada edificio seg\u00fan la talla de cada clase en n\u00famero de l\u00edneas de c\u00f3digo (Lines Of Code o LOC).<\/p>\nEsta medida utiliza una funci\u00f3n logar\u00edtmica con el fin de evitar un crecimiento demasiado r\u00e1pido y pues una diferencia de talla que har\u00eda que ciertos ‘rascacielos’ sal\u00edan del campo visual y que otros edificios parecen min\u00fasculos. Voy a modificarla con una otra m\u00e9trica: el n\u00famero de ‘violaciones’ de buenas pr\u00e1cticas, es decir el n\u00famero de defectos encontrados en el c\u00f3digo:<\/p>\n
Math.pow(Math.E – 0.25, Math.log({violations}))<\/address>\n <\/address>\n![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModel_params.jpg\" "\\"Qual_Sonar_CityModel_params\\"")
<\/a>Los otros par\u00e1metros son los siguientes:<\/p>\n\n- title: Blocker.<\/li>\n
- colorExp: num2col({blocker_violations}, 0, 1).<\/li>\n
- widthExp: {functions}.<\/li>\n<\/ul>\n
Quiero que los edificios aparezcan en rojo cuando existe por lo menos una violaci\u00f3n cr\u00edtica, de tipo ‘Blocker’. Pues la f\u00f3rmula ‘colorExp’ admite s\u00f3lo un intervalo muy estrecho de valores: verde para 0 ‘blocker’ y rojo desde que existe por lo menos un defecto bloqueante, medido por la m\u00e9trica {blocker_violations}.<\/p>\n
Una vez guardados estos valores, he aqu\u00ed lo que se parece a mi ‘Ciudad cr\u00edtica’:<\/p>\n
![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModel1.jpg\" "\\"Qual_Sonar_CityModel1\\"")
<\/a><\/p>\nNo olivdes que puedes hacer zoom en esta representaci\u00f3n o girar horizontalmente o verticalmente, lo cual nos permitir\u00e1 identificar los ‘Blockers’ de una o m\u00e1s clases.<\/p>\n
![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModel2.jpg\" "\\"Qual_Sonar_CityModel2\\"")
<\/a>Esta gran torre verde a la derecha tiene muchos defectos, pero nada cr\u00edtico. Otras clases, incluso con un mayor n\u00famero de m\u00e9todos, tienen al menos una violaci\u00f3n bloqueante.<\/p>\nEstos defectos deben ser corregidos obligatoriamente antes de que la aplicaci\u00f3n sea sometida a pruebas o instalada en el entorno de producci\u00f3n.<\/p>\n
Navegando en esta representaci\u00f3n 3D, podemos encontrar clases que de otro modo ser\u00edan indetectables de por sus peque\u00f1as dimensiones, en n\u00famero de l\u00edneas de c\u00f3digo o de m\u00e9todos o de complejidad, pero que cuentan sin embargo un bug de tipo ‘Blocker’.<\/p>\n
![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModel31.jpg\" "\\"Qual_Sonar_CityModel3\\"")
<\/a><\/p>\nPodemos ver en la parte inferior izquierda tres clases peque\u00f1as, con s\u00f3lo dos m\u00e9todos y por lo menos un fallo bloqueante.<\/p>\n
Ahora tambi\u00e9n queremos identificar las clases con un alto n\u00famero de defectos cr\u00edticos o mayores. Estas son las reglas elegidas con el cliente:<\/p>\n
\n- Una clase es de color rojo si tiene al menos una violaci\u00f3n ‘Blocker’.<\/li>\n
- Una clase es de color rojo si tiene al menos cuatro violaciones ‘Critical’. De lo contrario, el color va de verde a rojo en funci\u00f3n de una escala de 1 a 4 de estas violaciones.<\/li>\n
- Si la clase no tiene ni defecto bloqueante ni cr\u00edtico, su color se define de acuerdo con el n\u00famero de defectos ‘Major’ en una escala de 1 a 100.<\/li>\n<\/ol>\n
Entonces, en una escala de 1 a 100:<\/p>\n
\n- Una violaci\u00f3n bloqueante = 100.<\/li>\n
- 4 defectos cr\u00edticos = 100, 3 defectos cr\u00edticos = 75, 2 defectos cr\u00edticos y 1 defecto cr\u00edtico = 25.<\/li>\n
- Los defectos ‘Major’ se miden sin factor multiplicativo.<\/li>\n<\/ul>\n
Y \u00faltima regla, el color del edificio se define de acuerdo con el m\u00e1s alto de estos valores. Por ejemplo:<\/p>\n
\n- Una clase con 30 violaciones ‘Major’ sin bloqueante o cr\u00edtica tendr\u00e1 un color (de verde a rojo) igual a 30 en una escala de 1 a 100.<\/li>\n
- Una clase con 2 defectos cr\u00edticos sin ‘Blocker’ o ‘Major’ tendr\u00e1 un color igual a 50 o 2 violaciones ‘Critical’ x 25.<\/li>\n
- Una clase con 2 defectos cr\u00edticos y 30 violaciones mayores tendr\u00e1 un valor de 50 (el m\u00e1s alto de los dos valores).<\/li>\n
- Una clase con 2 defectos cr\u00edticos y 60 violaciones mayores tendr\u00e1 un valor de 60.<\/li>\n<\/ul>\n
Y aqu\u00ed est\u00e1 la f\u00f3rmula correspondiente a estas reglas:<\/p>\n
num2col(Math.max(({blocker_violations}*100), ({critical_violations}*25), {major_violations}), 0, 100)<\/address>\n <\/address>\nEl resultado:<\/p>\n
Con los siguientes par\u00e1metros:<\/p>\n La f\u00f3rmula corresponde al top 5 de los componentes con m\u00e1s violaciones de tipo ‘Blocker’. Las que no se quiere ver en ninguna aplicaci\u00f3n. Las que presentan m\u00e1s riesgos para los usuarios. Las que demuestran que el outsourcer produce un c\u00f3digo de la peor calidad que sea.<\/p>\n Esta medida utiliza una funci\u00f3n logar\u00edtmica con el fin de evitar un crecimiento demasiado r\u00e1pido y pues una diferencia de talla que har\u00eda que ciertos ‘rascacielos’ sal\u00edan del campo visual y que otros edificios parecen min\u00fasculos. Voy a modificarla con una otra m\u00e9trica: el n\u00famero de ‘violaciones’ de buenas pr\u00e1cticas, es decir el n\u00famero de defectos encontrados en el c\u00f3digo:<\/p>\n Quiero que los edificios aparezcan en rojo cuando existe por lo menos una violaci\u00f3n cr\u00edtica, de tipo ‘Blocker’. Pues la f\u00f3rmula ‘colorExp’ admite s\u00f3lo un intervalo muy estrecho de valores: verde para 0 ‘blocker’ y rojo desde que existe por lo menos un defecto bloqueante, medido por la m\u00e9trica {blocker_violations}.<\/p>\n Una vez guardados estos valores, he aqu\u00ed lo que se parece a mi ‘Ciudad cr\u00edtica’:<\/p>\n No olivdes que puedes hacer zoom en esta representaci\u00f3n o girar horizontalmente o verticalmente, lo cual nos permitir\u00e1 identificar los ‘Blockers’ de una o m\u00e1s clases.<\/p>\n Estos defectos deben ser corregidos obligatoriamente antes de que la aplicaci\u00f3n sea sometida a pruebas o instalada en el entorno de producci\u00f3n.<\/p>\n Navegando en esta representaci\u00f3n 3D, podemos encontrar clases que de otro modo ser\u00edan indetectables de por sus peque\u00f1as dimensiones, en n\u00famero de l\u00edneas de c\u00f3digo o de m\u00e9todos o de complejidad, pero que cuentan sin embargo un bug de tipo ‘Blocker’.<\/p>\n Podemos ver en la parte inferior izquierda tres clases peque\u00f1as, con s\u00f3lo dos m\u00e9todos y por lo menos un fallo bloqueante.<\/p>\n Ahora tambi\u00e9n queremos identificar las clases con un alto n\u00famero de defectos cr\u00edticos o mayores. Estas son las reglas elegidas con el cliente:<\/p>\n Entonces, en una escala de 1 a 100:<\/p>\n Y \u00faltima regla, el color del edificio se define de acuerdo con el m\u00e1s alto de estos valores. Por ejemplo:<\/p>\n Y aqu\u00ed est\u00e1 la f\u00f3rmula correspondiente a estas reglas:<\/p>\n El resultado:<\/p>\n<\/a>Luego me conect\u00e9 como Admin en mi dashboard Sonar preferido:<\/p>\n<\/a>Entr\u00e9 en la configuraci\u00f3n de los widgets para a\u00f1adir un widget City Model Top de eXcentia.<\/p>\n<\/a><\/p>\n\n
<\/a> Luego voy a a\u00f1adir el widget City Model y a modificar sus par\u00e1metros. El primer campo ‘heightExp’ contiene una f\u00f3rmula para definir la altura de cada edificio seg\u00fan la talla de cada clase en n\u00famero de l\u00edneas de c\u00f3digo (Lines Of Code o LOC).<\/p>\n<\/a>Los otros par\u00e1metros son los siguientes:<\/p>\n\n
<\/a><\/p>\n<\/a>Esta gran torre verde a la derecha tiene muchos defectos, pero nada cr\u00edtico. Otras clases, incluso con un mayor n\u00famero de m\u00e9todos, tienen al menos una violaci\u00f3n bloqueante.<\/p>\n<\/a><\/p>\n\n
\n
\n
![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModel41.jpg\" "\\"Qual_Sonar_CityModel4\\"")
<\/a><\/p>\n![\"\"](\"http:\/\/qualilogy.com\/wp-content\/uploads\/2012\/03\/Qual_Sonar_CityModel5.jpg\" "\\"Qual_Sonar_CityModel5\\"")
<\/a><\/p>\n