|
|
|
Ecco qui la finestra magica dalla quale poter organizzare in maniera veramente semplice i vostri commenti e le vostre revisioni al codice da voi sviluppato. Si lo so, esiste Visual Source Safe, di certo non voglio sostituirmi ad un programma così ben pensato ma allo stesso tempo complicato, io ti offro solo la possibilità di lavorare in modo semplice. E poi VSS genera la documentazione relativa al vostro codice? Intendiamoci, il mio Add-in non crea automaticamente l'help del vostro programma ma vi permette di creare della documentazione, in formato HTML (utilizzando anche un pò di DHTML), che descrive il nome del progetto, la sua funzionalità, vi elenca i reference inclusi nel progetto, vi elenca tutti i moduli di codice presenti nel progetto e per ogni modulo l'elenco di tutte le variabili, tutti i metodi,tutte le proprietà ed a ciascun metodo o proprietà, l'elenco delle revisioni, in ordine cronologico, che voi stessi avete creato con l'Add-in. Quante volte vi siete cimentati a scrivere all'interno del codice tutte quelle righe di codice che spiegano cosa fà una cosa piuttosto di un'altra. Quante volte invece non l'avete fatto perchè il mantenimento delle informazioni risulta troppo impegnativo. E poi, com'è brutto vedere tutte quelle righe di commento nella vostra procedura. Con questo Add-in potete memorizzare tutte le revisioni al codice che volete mantenendo pulito il modulo da tutte quelle righe commentate. Si perchè non è invasivo, infatti il tutto è memorizzato in un recordset salvato su disco relativo al progetto VB. Si possono quindi gestire le stesse informazioni successivamente in modo diverso: potete importare i dati in qualsiasi DB, mandare questo file tramite e-mail a qualcun'altro, e chi più ne ha più ne metta. E' ADO che fa il gioco.
Come FunzionaUna volta installata e registrata la DLL sulla vostra macchina, lanciate l'istanza di VB aprendo il vostro progetto. Nel menù principale, alla voce Add-in, aprire l' Add-in manager e dopo aver selezionata la voce GDMakeDocument, attivare la checkbox "Loaded/Unloaded", premere ok.
A questo punto nel menu Add-in è visibile il nuovo Add-in. Selezionandolo apparirà una finestra simile all'immagine vista in testa a questo documento.
GDMD (GDMakeDocument), quando è visibile monitora il codice attivo, e se ci si sposta da una procedura all' altra le informazioni in GDMD vengono comunque aggiornate. Attivata la procedura voluta gli si puo aggiungere una descrizione (che non fa mai male) ed una eventuale revisione. Per aggiungere una descrizione, basta riempire il campo apposito. Per aggiungere una revisione basta cliccare sul bottone animato Add e subito viene aggiunto un record nel quale poter descrivere il motivo della nuova revisione. Automaticamente vengono aggiunte le informazioni riguardanti l'autore (è possibile definire questo nome nel campo Author) e la data (preimpostata di default alla data odierna). Una volta aggiunte tutte le informazioni al codice è possibile generare
la documentazione alla semplice pressione del tasto Make Inserisci tramite GDMD anche il codice per l'Error handling e Rows comment, automaticamente viene aggiunta la revisione. Inserisci anche il codice preformattato degli IF...Else...End If oppure dei Select case ... End select, vedrai come è più semplice.
L'unica cosa che devi fare adesso è mandarmi una e-mail con soggetto GDMakeDocument ed io ti risponderò mandandoti la DLL di GDMakeDocument. Richiedi l'Add-in a GianniD@Tiscalinet.it Ciao e buona fortuna. |
|
Questo sito è stato costruito con l'unico scopo di scambiare informazioni riguardanti lo sviluppo software in Visual Basic. Qui ci son passate già altre |
. Il gioco è fatto. Sotto la dir. del
progetto è sata creata una sub dir. dove si possono trovare le pagine HTML che servono.
La pagina di default, ovvero la prima da visualizzare, si chiama con lo stesso nome del
progetto attivo.