CAST AIP - Configuració

Usar els manuals disponibles a Documentació i manuals de CAST

Les tasques de configuració d’una anàlisi d’una aplicació amb l’eina CAST estan descrites en el manual d’usuari de CAST ( CAST documentació del producte) a l’apartat “Guides –> Generating AD data with the CAST Management Studio”.

Es recomana seguir les pautes que es descriuran a continuació per configurar els diferents anàlisi del codi font amb CAST.

Creació esquemes inicials

Realitzar una sola vegada, no per cada aplicació.

Definir mitjançant CAST Server Manager, per a cada lot, els 3 esquemes següents:

  • BBDD Management amb el nom: LOTAxx_MNGT
  • BBDD Local amb el nom: LOTAxx_01_LOCAL
  • BBDD Central amb el nom: LOTAxx_01_CENTRAL

on LOTAxx és el nom del lot (p.e. LOTA04), i ID és un número seqüencial incremental de 2 dígits, començant per 0.

En el cas que per motiu de volum de dades, rendiment de les anàlisis o millora de l’administració, calgui crear més BBDD centrals i/o locals per lot, caldrà incrementar el codi ID, per exemple LOTA04_02_LOCAL.

En el cas que es requereixi, es poden definir més d’una base de dades Management. En aquest cas a partir de la segona base de dades es recomana la següent nomenclatura: LOTAxx_ID_MNGT on LOTAxx és el nom del lot (p.e. LOTA04), ID és un codi incremental que comença pel 02 (p.e. LOTA04_02_MNGT).

Crear estructura de directoris

Per a cada anàlisi, emmagatzemar les dades seguint una estructura de carpetes a partir del directori E:\Axx\App, on

  • Axx, correspon al lot. Exemple: A01
  • App, correspon al nom de l’aplicació amb la nomenclatura 9999_XXXXXXXX:

    • 9999 es correspon al codi numèric de l’aplicació (codi de diàleg de l’aplicació) i ha de tenir una longitud de 4 dígits.
    • XXXXXXXX es correspon a l’acrònim o nom curt de l’aplicació, entre 3 i 8 caràcters alfanumèrics. En el cas de no disposar d’acrònim d’aplicació s’haurà de sol·licitar a l’usuari o al responsable de la solució. Per a codis numèrics amb longituds inferiors a 4, omplir amb zeros per l’esquerra.

    Exemple: 0044_ARF

cast-config-4

Nota: En el cas de Windows es pot assignar una unitat virtual (E:) a qualsevol carpeta (SUBST E: “Nom_carpeta”)

Dins a cada carpeta s’inclouran 2 subcarpetes:

  1. Codi font i llibreries. En el cas d’aplicacions J2EE Maven, haurà de seguir la següent estructura de directoris:

    • /src: codi font
    • /lib: llibreries sense jerarquies de carpetes

    En el cas d’aplicacions J2EE No Maven i altres tecnologies, caldrà incloure codi font i llibreries amb l’estructura de directoris que el proveïdor consideri més convenient.

  2. Carpeta \CAST que inclogui dades d’exportació

Crear estructura de l’anàlisi

Consultar el manual d’usuari CAST “CAST AIP x.y Documentation –> User Guides –> Generating AD data with the CAST Management Studio –> Step 3-Defining your Application”. i definir mitjançant CAST Management Studio l’estructura de l’anàlisi amb els següents nivells jeràrquics:

  1. Delivery Unit: crear una única “Delivery Unit” amb el nom del lot (LOTAxx).
  2. Sistema al què pertany l’aplicació, entenent com a Sistema una agrupació d’aplicacions funcionalment relacionades. Si no aplica, el nom del “Sistema” ha de coincidir amb el .

    En el camp descripció s’ha d’informar el lot, tecnologia, proveïdor, NAQ, àmbit i codi d’aplicació indicant:

    LOT=ID_lot;TECNOLOGIA=ID_tecnologia;PROVEIDOR=ID_proveïdor; NAQ=ID_NAQ;AMBIT=ID_ambit;CODIAPL=ID_codiaplicacio

    • LOT. Escollir un dels valors següents: ‘A01’, ‘A02’, ‘A03’, ‘A04’, ‘A05’, ‘A06’, ‘A07’, ‘A08’, ‘A09’, ‘A10’, ‘A11’
    • TECNOLOGIA. Escollir un dels valors següents: ‘.NET - Legacy’, ‘.NET - New’, ‘Borland Delphi’, ‘Business Objects’, ‘C/C++’, ‘Cobol’, ‘IBM SQL-PSM’, ‘J2EE’, ‘Java’, ‘Microsoft T-SQL’, ‘Microsoft SQL Server related languages’, ‘Oracle Forms’, ‘PL/SQL’, ‘PowerBuilder’, ‘SAP Abap’, ‘Sybase T-SQL’, ‘Tibco’, ‘Visual Basic’, ‘Web’
    • PROVEIDOR. Escollir un dels valors següents: ‘Accenture-Indra’, ‘ALTRAN’, ‘HP-VASS’, ‘IBM-INSA’, ‘Indra’, ‘Itteria’, ’T-Systems’, ‘TICxCAT’
    • NAQ. Escollir un dels valors següents: ‘Alt’, ‘Mig’, ‘Baix’
    • CODIAPL. Ficar el codi d’aplicació/diàleg

    Exemple:

    LOT=A01;TECNOLOGIA=J2EE;PROVEIDOR=T-Systems;NAQ=Alt;AMBIT=INT;CODIAPL=0342
    
  3. Mòduls de l’aplicació. Com a criteri general s’ha de definir un mòdul per a cadascuna de les tecnologies de l’aplicació.

    En el cas d’aplicacions voluminoses o si es considera adient diferenciar criteris de negoci per a realitzar valoracions independents, hi ha la possibilitat de subdividir en diversos mòduls d’arquitectura-funcionalitat.

    Segons el tipus del mòdul usar la següent nomenclatura:

    • Mòdul de base de dades: _ARQ_BD. Aquest mòdul haurà d’existir en tots els casos, a excepció de solucions amb tecnologia SAP on no caldrà que tingui definit aquest mòdul tecnològic, aquesta excepció no aplica per programes ABAP amb base de dades externes a la de SAP.

    • <nomaplicacio>_ARQ<tecnologia>

    • <nom_aplicacio>ARQ<tecnologia>_<funcionalitat> Exemples:

    Per a una aplicació voluminosa, per exemple de 900KLOC (KLOC indica milers de línies de codi), haurien de definir-se mòduls tecnològics i funcionals, amb una estructura similar a la següent

    cast-config-5

    Per a una aplicació senzilla J2EE amb BBDD Oracle de 200KLOC, haurien de definir-se dos mòduls, un per base de dades i un altre pel codi font, amb una estructura similar a la següent:

    cast-config-6

    NOTA: Per al cas en què una aplicació fa servir més d’un datasource, ha de quedar identificat d’alguna manera, Per exemple _ARQBD

Configuració dels informes

La generació dels informes del resultat de les revisions de codi es realitza amb l’eina de CAST Report Generator

CAST Report Generator és una eina que s’executa en local i accedeix a les dades dels anàlisi mitjançant protocol REST a la base de dades de CAST AIP. Cal que estiguin instal·lats, el programari CAST Report Generator en local i el servei CAST-RestAIP.war al tomcat de CAST.

Instal·lació CAST-RestAIP.war

Al següent enllaç es descriu el procediment per instal·lar el servei CAST-RestAIP.war: http://doc.castsoftware.com/display/DOC80/Installing+and+configuring+the+CAST-RestAPI.war

Instal•lació CAST Report Generator

En el paquet estàndard d’instal·lació de CAST AIP hi ha l’instal·lador de CAST Report Generator. El paquet complet està disponible a: ftp://ftp.castsoftware.com/OfficialDownload/CAST_AI_Platform/7.3.00/CAST_AIP_7.3.00.7152.zip

La versió 7.3 de CAST Report Generator és compatible amb instal·lacions CAST AIP 7.0 o posterior.