====================================================================
File ESTHDAMA.TXT - Da aggiornare ( un po' vecchiotto)

Help della procedura ESP0DAMA - EASY-WIN (ES/Lupo-ICLVB) Data Manager

Un sincero ringraziamento ai frequentatori del NewsGroup
it.comp.lang.visual-basic che hanno utilizzato questa procedura
segnalando anomalie e suggerendo migliorie.
Una particolare citazione per (in ordine sparso):
	Ugo M., David R., BlackMagic, Andrea M., Domenico P.,
	Samuele B., Sauro V., emmexx, termoPilucco, Albe V, Alletun 
====================================================================

FUNZIONI PROPRIE DEL DATABASE

Accesso e Db
'DAO' (versone 3.6 in abbinamento con Jet 4.00) per database tipo Accesso 97 e 2000.
'ADO' (versone 2.7 o superiore in abbinamento con il provider Jet 3.51 per database Access 97 o 4.00 per database Access 97 o 2000); per database SQL Server in abbinamento con provider sqloledb o msdasql.

Nome del server SQL
Nome del Server SQL richiesto nel caso di database ADO + SQL Server.

Provider
'Jet 3.51' - opzione in caso di database ADO per Access 97.
'Jet 4.00' - opzione in caso di database ADO per Access 97 o 2000; default per database ADO per Access 97 o 2000.
Per database ADO SQL Server; 'sqloledb' default (OLE); 'msdasql' opzione (ODBC).

L.cursore
Valido esclusivamente in ambiente ADO; default lato 'Server'; opzione lato 'Client'.

Tipo cursore (DAO/ADO)
'FrwOnly' cursore a scorrimento solo avanti; opzione sconsigliata per entrambi gli ambienti.
'Dyna/Key' cursore a chiavi; default e consigliato in DAO.
'Snap./Static' cursore statico; default e consigliato in ADO.
'Dynamic' cursore dinamico che mostra ogni modifica disponibile solo in ADO; utilizzo sconsigliato.

Bottone 'N' per esporre la finestra alle dimensioni di progetto e centrata nel video.

Bottone 'Opz' per esporre la finestra di ulteriori opzioni disponibili. Opzioni previste:
-parametro 'La ricerca del database parte sempre e comunque dalla cartella 'C:\' (anche se esiste la cartella '?:\Easywins\Easywin\Files'; consente di attivare la ricerca dei database dalla cartella 'C:\' anzich che dalla cartella '?:\Easywins\Easywin\Files'; il medesimo risultato pu essere ottenuto attivando la ricerca con il bottone 'Database' tenendo contemporaneamente premuto il tasto Ctrl e/o Shift; 
-parametro 'In apertura tabella chiede il numero massimo di records da restituire (Top)'; con parametro attivato  richiesto, all'atto dell'apertura di una tabella, il numero massimo di record da restituire (Top); se non attivato sono restituiti tutti i record; le pagine di griglia esposte sono sempre di 100 righe con possilit di accesso alle pagine seguenti e precedenti, alla prima e all'ultima o desiderata da indicare.
-parametro 'In apertura tabella chiede i campi da esporre'; con parametro attivato  richiesto quali campi di tabella esporre nella sequenza di colonne desiderata;
-parametro 'In apertura tabella chiede i campi da considerare per ordinare i records'; con parametro attivato  richiesto in funzione di quali colonne procedere all'ordinamento dei record esposti; in forma normale si intende ordinamento crescente, attivando la colonna di selezione con il pulsante destro del mouse l'ordinamento e decrescente;
-parametro 'Dimensiona le colonne della griglia tenendo conto anche dei titoli'; per considerare nel dimensionamento delle colonne oltre alla dimensione del contenuto anche la dimensione del titolo;
-parametro 'In fase di variazione di una cella della griglia (record/campo) seleziona l'intero contenuto'.

CheckBox 'Varia' per consentire la variazione dei contenuti del database aperto (modificare celle, eliminare righe, creare nuove righe, etc.). L'attivazione della funzione  soggetta alla conoscenza di una chiave di accesso variabile. Il fondo giallo sull'oggetto indica che  stata correttamente inserita la chiave di accesso di attivazione. Il parametro pu essere attivato indifferentemente prima o dopo l'apertura del database. Si rammenti comunque che ad ogni apertura del database il CheckBox viene disattivato.

Bottone '?' per accedere a queste note operative.

Bottone 'Database' per accedere alla funzione sfoglia per individuare il database da aprire; per ambiente DAO e ADO con database tipo access sono ricercati i database tipo *.MDB; per ambiente ADO con database tipo SQL Server sono ricercati i database tipo *.MDF. In funzione dello stato del parametro opzionale 'La ricerca del database parte sempre e comunque da C:\',  proposta la ricerca a partire dalla cartella '?:\Easywins\Easywin\Files' o dalla cartella 'C:\'; premendo contemporaneamente al bottone i tasti Ctrl e/o Shift la ricerca  proposta dalla cartella 'C:\'. 

Bottone 'Apri Db' per aprire il database indicato.

Bottone 'Crea Db' per creare il database indicato; occorre indicare il percorso e il nome completo di estensione (.MDB in ambiente ACCESS, .MDF in ambiente SQL Server).

CheckBox 'Esp.aut.' per l'espansione automatica dei nodi del database aperto; con il parametro attivato lo spostamento effettuato nella struttura del database con il puntatore del mouse o con le frecce verticali causa l'espansione dell'eventuale nodo incontrato e la chiusura di quello precedentemente aperto. L'espansione di un nodo pu essere ottenuta anche con il click sul simbolo '+', con il doppio click sulla cartella e con la barra spaziatrice.

FUNZIONI PROPRIE DELLA TABELLA DI DATABASE

CheckBox 'Ordina c.t.'; con il parametro disattivato visualizza i campi di tabella in ordine fisico, viceversa in ordine alfabetico. In ambiente ADO tale CheckBox  disattivato e i campi saranno sempre ordinati alfabeticamente.

Bottone 'Apri Tabella' per eseguire l'esposizione della tabella selezionata.

Bottone 'Crea Tab' per creare una nuova tabella per il database corrente;  necessario attivare il CheckBox 'Varia' ed evidenziare nella struttura il nome del database.

Bottone 'Crea Campo' per creare un nuovo campo della tabella corrente;  necessario attivare il CheckBox 'Varia' ed evidenziare nella struttura il nome della tabella.

Bottone 'Crea Indice' per creare un nuovo indice della tabella corrente;  necessario attivare il CheckBox 'Varia' ed evidenziare nella struttura il nome della tabella.

Bottone 'Rinomina' per rinominare, se possibile, l'informazione selezionata; pu essere usato per rinominare una tabella, un campo e un indice;  necessario attivare il CheckBox 'Varia' ed evidenziare nella struttura il nome dell'informazione da rinominare (tabella, campo, indice). Si raccomanda estrema cautela.

Bottone 'Elimina' per eliminare in forma definitiva, se possibile, l'informazione selezionata; pu essere usato per eliminare l'intero database, una tabella, un campo o un indice;  necessario attivare il CheckBox 'Varia' ed evidenziare nella struttura l'oggetto da eliminare (database, tabella, campo, indice). Si raccomanda estrema cautela.

Bottone 'Nt' per evidenziare o nascondere (X) le note (interne) relative all'informazione selezionata.

FUNZIONI PROPRIE DEI COMANDI SQL

In alternativa al comando 'Apri Tabella' possono essere eseguiti dei comandi SQL con la possibilit  di inserire all'interno degli stessi selezioni.
La funzione 'Apri Tabella' corrisponde al comando SQL 'SELECT TOP n * FROM tabella'; il comando pu essere integrato con l'indicazione delle colonne da esporre indicandole esplicitamente al posto della sigla '*', con l'indicazione della colonna di ordinamento (ORDER BY), con l'inserimento di condizioni (WHERE abbinato a '=' o LIKE). I comandi SQL possono contenere istruzioni di variazione (UPDATE), cancellazione (DELETE), inserimento (INSERT).

Bottone 'Esegui' per elaborare il comando SQL impostato; se il comando contiene l'istruzione SELECT si ottiene l'esposizione di una griglia.
Bottone 'Ex' per visualizzare una serie di esempi di comandi SQL.
Bottone 'Salva' per memorizzare su file il comando SQL impostato (comunicare la destinazione e il nome del file). 
Bottone 'Recupera' per importare da file un comando SQL precedentemente salvato (comunicare residenza e nome del file). 

FUNZIONI PROPRIE DEI RECORD DI TABELLA VISUALIZZATI

La griglia visualizzata  caratterizzata da una prima colonna, titolata (N), dove  riportato il numero progressivo di esposizione della riga e, se la variazione  consentita, un CheckBox per la spuntatura della riga stessa. Sono esposte di seguito le colonne come fisicamente inserite nella tabella o secondo il metodo di esposizione impostato.
Per spuntare una riga  necessario cliccare sull'apposito oggetto di spunta;  possibile con il bottone 'Spunta tutti' attivare la spuntatura per tutte le righe esposte; per togliere la spuntatura ad una riga  necessario cliccare sull'apposito oggetto di spunta precedentemente attivato;  possibile con il bottone 'Nessuna Spunta' togliere la spuntatura per tutte le righe esposte. Effettuando l'esposizione di un'altra pagina sono perse le spuntature effettuate.

Bottone 'Elimina spuntati' per eliminare le righe di griglia attualmente spuntate. 
Bottone 'Aggiungi record' per creare un nuovo record (riga) in tabella (griglia); per passare dall'inserimento di un campo al seguente utilizzare il tasto 'Invio' o il mouse. Terminato l'inserimento di tutti i campi definiti confermare con il Bottone 'Registra Variaz.'; per non registrare il record usare il bottone 'Elimina Variaz.'.
 
Opzione 'Tutti (spuntati e non)' per esporre tutte le righe della pagina esposta indipendentemente dalla spuntatura; di fianco al parametro  indicato il numero delle righe che compongono la pagina.
Opzione 'Solo spuntati' per esporre solo le righe spuntate della pagina esposta; di fianco al parametro  indicato il numero delle righe spuntate.
Opzione 'Solo non spuntati' per esporre solo le righe non spuntate della pagina esposta; di fianco al parametro  indicato il numero delle righe non spuntate.

Bottone 'Prima pagina' consente di tornare all'esposizione della prima pagina della tabella, concordemente alle scelte di ordinamento effettuate.
Bottone 'Pag.Precedente' consente di esporre la pagina precedente quella esposta;
Bottone 'Pag.Seguente' consente di esporre la pagina seguente quella esposta.
Bottone 'Ultima pagina' consente l'esposizione dell'ultima pagina della tabella, concordemente alle scelte di ordinamento effettuate.
Bottone 'Vai a pagina' consente di indicare il numero della pagina desiderata.

Il passaggio all'esposizione di altra pagina causa la perdita dei segnali di spunta eventualmente attivati.

Per modificare un record occorre evidenziare la riga; con il bottone 'Elimina Record' si propone l'eliminazione, con il bottone 'Varia Record' si propone la modifica. Per passare dalla variazione di un campo al seguente utilizzare il tasto 'Invio' o il mouse. Terminata la variazione dei campi desiderati confermare con il bottone 'Registra Variaz.'; per non registrare le variazioni usare il bottone 'Elimina Variaz.'.

Bottone 'Aggiorna il gruppo di records col comando SQL' per rinfrescare l'esposizione dei dati in funzione delle scelte operate e delle modifiche eseguite.

Bottone 'Visualizza il comando SQL' per visualizzare la struttura del comando SQL che condiziona l'esposizione della griglia. Il comando SQL pu essere contestualmente modificato.

CARATTERISTICHE GENERALI

Su ogni controllo (se previsto da progetto) e' possibile battere i tasti Ctrl+Shift+B per cambiare il colore di sfondo (BackColor) e i tasti Ctrl+Shift+F per cambiare il carattere (Font) e il colore di primo piano (ForeColor).

Il font/carattere del TextBox per l'input delle variazioni (txt_input) verr regolarmente acquisito, ma verr perso al primo spostamento di cella in quanto viene sempre automaticamente assegnato al font normale della griglia. Quindi non viene nemmeno depositato fra i parametri di preferenza (ESP0DATA.INI)

Rammentare che il controllo che espone la struttura del database (del tipo TreeView) non consente l'assegnazione dei colori di fondo e di primo piano.
Inoltre, sempre per tale controllo, la propriet Bold (Grassetto) eventualmente assegnata al carattere, viene ignorata in fase di preparazione perch non sarebbe pi possibile evidenziare determinate informazioni all'interno della struttura. Tale propriet viene invece regolarmente acquisita se esplicitamente assegnata (Ctrl+Shift+F) e mantenuta per l'intera sessione, perdendo per le differenziazioni accennate.

Se le variazioni sono abilitate, non sar possibile spostare le colonne trascinandone il titolo.

Il colore rosso (vbRed) viene usato per evidenziare (specialmente quando si abbandona la riga evidenziata, l'evidenziazione infatti impedisce la riproduzione del colore) i valori (se modificati rispetto all'originale) delle colonne. Si sconsiglia quindi di cambiare il colore di primo piano in rosso. Gli stessi campi saranno anche posti a grassetto o non grassetto, al contrario del font della listview. Questo per non funziona bene se il font originale della listview  grassetto, ovvero il non grassetto pur assegnato da procedura, non viene eseguito e quindi il carattere resta grassetto.

Per annullare le variazioni fatte a una riga  sufficiente cliccare su un'altra riga e rispondere adeguatamente. Se la riga visualizzata  una sola, cliccare nella colonna N o, se visibile, in una zona oltre la fine della riga. Rispondere adeguatamente.

In variazione occorre necessariamente rispettare il formato dei dati esposti (non viene adottato alcun metodo esplicito di formattazione, tutto quindi dipende dai settaggi del pannello di controllo, come separatore date, separatore interi/decimali, lingua per Vero/Falso oppure True/False), quindi, per esempio, se il separatore interi/decimali  la virgola, i numeri con decimali andranno scritti utilizzando la virgola, se le date vengono esposte (sempre per esempio) nella forma GG/MM/AAAA, nella stessa forma (e con identico separatore) andranno impostate. L'unica parziale eccezione  per i campi di tipo Boolean: Il valore Vero pu essere indifferentemente essere esposto e impostato (non importa il maiuscolo/minuscolo) come Vero, True o un valore numerico qualsiasi diverso da 0, anche negativo. Analogamente, il valore Falso pu essere indifferentemente essere esposto e impostato come Falso, False o 0 e, ancora, con una qualsiasi stringa di caratteri il cui valore per la sola parte numerica risulti nullo (viene adottata la funzione Val). Il valore Falso non viene mai esposto (cella vuota), cos come i vari campi di tipo numeri con valore nullo o data con i primi due caratteri assenti o pari a "00". Per vedere i valori assunti da un record dopo la sua registrazione pu essere necessario aggiornare per ricomporre la griglia.

NOTE AGGIUNTE, DA RIORGANIZZARE

'Un nuovo bottone "Opz" consente di aprire la nuova finestra delle possibili opzioni
'(Non c'era piu' spazio sulla finestra principale, dove e' rimasta solo la "Varia").
'Questa nuova finestra e' normalmente ridimensionabile e il suo stato verra' mantenuto
'per l'intera sessione di lavoro, ma al successivo avvio della procedura la finestra
'verra' inizialmente esposta, centrata, con le sue dimensioni di progetto

'Nuova opzione per indicare se (anche se la cartella "?:\Easywins\Easywin\Files" esiste)
'la cartella iniziale di ricerca debba essere sempre C:\
'Tale opzione e' superabile (anche se non attivata) in "tempo reale"
'premendo Ctrl e/o Shift quando si clicca sul bottone "Database"

'Nuova opzione per poter chiedere i campi da esporre in fase di apertura tabella
'Funziona come quella per indicare i campi di ordinamento (non usa il pulsante destro)
'E' molto utile non solo per esporre solo i campi interessanti, ma anche per stabilirne
'la sequenza desiderata (colonne)

'Tutti i campi esplicitamente indicati per l'esposizione e/o l'ordinamento
'(questi anche se implicitamente recuperati dal primo indice con chiave Unique),
'ora vengono racchiusi fra parentesi quadre (necessarie se il nome del campo contiene spazi)
'Anche il nome della tabella viene racchiuso fra parentesi quadre.
'I campi indicati vengono inoltre ignorati se gia' presenti nell'elenco corrente.
'Si rammenti che (per esempio con un comando SQL composto a mano) se un campo viene
'selezionato piu' volte, assumera' (con archivi di tipo Access) nelle sue ripetizioni
'il "nome" Expr1000, Expr1001, etc. (con archivi SQL Server viene ripetuto il nome),
'ma potrebbero sorgere problemi in fase di variazione/annullamento
'(con certezza in caso di aggiunta) dei records

'Tolto il limite (anche in variazione) dei 1000 records.

'Inseriti i bottoni per scorrere le pagine della griglia.
'Ogni pagina espone un numero massimo (fisso) di records.
'Attualmente e' stato fissato a 100 e non e' modificabile dall'operatore
'Si rammenti che ogni spostamento sulle pagine (come l'aggiornamento del recordset)
'perde tutte le eventuali spunte, ovvero queste sono valide e stabili solo
'all'interno della pagina corrente. I bottoni di "Tutti spuntati" e "Nessuno spuntato"
'lavorano ora esclusivamente sulla pagina corrente

'Il comando SQL visibile nella finestra della griglia ora viene esposto
'solo cliccando esplicitamente sull'apposito bottone.
'Usando tale bottone in modo esplicito per visualizzare il comando SQL
'il TextBox che lo contiene si dimensiona per l'effettiva delle righe
'piu' una fittizia, ma, al massimo, a 1/6 dell'altezza della finestra.

'Disponibile la funzione di creazione e eliminazine di un Database

'Ora il nome del database e' sempre completo di percorso e nome con estensione
'anche nel caso di database di tipo SQL Server. Viene inoltre controllato
'che i database di tipo Access abbiano un'estensione ".MDB" e quelli di
'tipo SQL Server abbiano un'estensione ".MDF"

'Disponibile la funzione di creazione tabella
'e creazione/aggiunta campo in tabella

'260802

'Disponibili le funzioni di eliminazione database,
'tabella, campo di tabella, indice di tabella

'Disponibili le funzioni di Rinominazione di tabella, campo, indice

'Disponibile la funzione di Creazione Indice.

'270802
'Per eliminare un database, una tabella o un campo
'   vengono chieste delle ripetute conferme esplicite
'Quando si crea un campo o un indice l'apposita sezione si apre automaticamente
'Quando si deve indicare il campo di un indice in creazione,
'   la sezione campi tabella viene aperta automaticamente
'Quando si clicca esplicitamente sul bottone "Apri Database" il checkbox "Varia"
'   viene disattivato

'270802/2
'Ora l'accesso all'ultima pagina espone i records effettivi, come
'   se il recordset venisse scorso pagina per pagina
'E disponibile il bottone "Vai a pagina..."

'280802
'Quando si clicca sul bottone "Database" ed e' prevista la verifica della
'   presenza della cartella ":?\EASYWINS\EASYWIN" ora, per consentire l'accesso
'   all'eventuale Server, si cerca prima la cartella ?:\EASYWIN e poi,
'   se non trovata, la cartella "?:\EASYWINS\EASYWIN"
'       Se trovata, in un caso o nell'altro,
'       si accodera' "\FILES" o "\FILES_SQL" per iniziare la ricerca

'280802/2
'Se il checkbox "Varia" e' attivato, ora e' possibile
'   accedere alla finestra della griglia e delle variazioni
'   per poter aggiungere records (senza dover necessariamente
'   utilizzare un comando SQL del tipo INSERT)
'Il numero di records per pagina e' ora parametrizzabile
'   nella finestra opzioni.
'   Il suo valore (se <=0 o numericamente intraducibile viene considerato 100)
'       verra' applicato per ogni nuova pagina al momento della
'       sua apertura. Le pagine (liste) gia' aperte manterranno
'       il numero di righe per pagina ad esse assegnato in fase di apertura.

'040902
'Possibilit di duplicare un database (per SQL Server si da' per scontato
'   che il file di log abbia nome pari al file MDF con aggiunta _LOG
'   e estensione .LDF e risieda nella stessa cartella del file MDF)

'170902
'In apertura di un database, viene verificato se e' protetto
'   da password. Se si' la password viene richiesta.
'Aggiunte le funzioni di Riparazione/Compattazione e Variazione Password

'161002
'Inseriti (finestra opzioni) i secondi di Timeout (solo per ADO) per
'   ConnectionTimeout e CommandTimeout

'241002
'Aggiunta gestione files DBASE (DBF) versione 3,4,5
'   Le chiavi vengono ora depositate in maiuscolo perche', per esempio, creando un campo in una tabella di un DBF
'   il nome della tabella (anche del campo) viene trasformato da minuscolo a maiuscolo e quindi la chiave (la proprieta'
'   Key di TreeView e ListView e' Case sensitive) non verrebbe piu' trovata. Per analoghi motivi sono stati disabilitati
'   i tasti per creare e eliminare un indice in DBF.

'211102
'Pubblicazione sul SC

'211102
'Corretto errore runtime 5 che si verificava scegliendo ADO, cliccando su "Database" e poi chiudendo la finestra (Vedi FUOCO_A)

'Fra le opzioni c' ora un nuovo checkbox (significativo solo per SQL Server) che consente di indicare se si prevede l'autenticazione SQL Server. Se disattivato (default) si intende autenticazione da Sistema Operativo. In memoria sono previste due nuove variabili: sql_server_uid e sql_server_pwd. Queste vengono richieste e posizionate (se il checkbox  attivato e se sql_server_uid="") quando si apre un database SQL Server e restano valide per l'intera sessione di lavoro. Possono essere esplicitamente riposizionate facendo click destro sul bottone "Apri Db". OK, lo so, la pwd  in chiaro mentre la si digita,  un semplice InputBox. L'attivazione del checkbox e la presenza (<>"") di sql_server_uid modifica la composizione dell stringa di connessione (D_RICAVA_STRINGA_CONNESSIONE)

'231102
'Con msdasql non viene supportata la propriet catalogo.Tables(n_tabella).Indexes(n_indice).Columns.Count.
'Disabilitata composizione (elenco) indici e creazione se msdasql e apposita opzione globale attivata (indici_con_msdasql)

'261102
'Pubblicazione di questa versione (Aggiornamento) sul SC

'071202
'Esposizione numero tabelle (visualizzate/totali) del database e numero campi e indici per ogni tabella

'071202
'Cliccando sul checkbox "DBF" il database eventualmente aperto ora viene chiuso

'121202
'Aggiunta richiesta (solo per DAO+Access) di OrdinalPosition (Ordine) in fase di creazione campo (escluso DBF e SQL Server). Solo con DAO  ora possibile cambiare l'OrdinalPosition cliccando sul bottone "Rinomina", confermare (o variare) il nome e assegnare il nuovo OrdinalPosition. Si rammenta che a parit di OrdinalPosition vale l'ordine alfabetico del nome del campo.

'251202
'Ora viene riconosciuto anche il comando ALTER

'
'030203
'Messa variabile globale per gestire o meno il file di LOG

'190203
'Ora espone il tipo di cursore ottenuto (solo in ADO). Si rammenta che se una tabella non ha un indice con chiave univoca, per un database di tipo SQL Server il cursore ottenuto, comunque si apra la tabella, sar di tipo Dynamic

'020303
'Fra le informazioni del recordset composto (o del comando SQL eseguito), viene ora esposto anche il tempo impiegato (secondi, arrotondato al terzo decimale)

'050303
'In fase di aggiunta di un record, cliccando su un'altra riga esistente nella griglia si verificava un errore

'220303
'Il comando SQL che inizia con Select e contiene " INTO " ora viene inteso come comando (prima, erroneamente, veniva inteso come Select classica) e regolarmente eseguito, anche in DAO

'230303
'In DAO + Access, rinominando un campo viene anche chiesto (proponendo l'attuale) il numero di OrdinalPosition che il campo stesso (anche se non rinominato) deve assumere. Se il numero indicato  diverso dal precedente (proposto) verranno adeguati i numeri di OrdinalPosition di tutti i campi della tabella (rispettando l'ordine richiesto per lo specifico campo) da 0 e senza lasciare buchi. Volendo riordinare tutti i campi senza necessariamente spostare l'ordine di un campo, rinominare l'ultimo campo dell'elenco, confermare il nome (si tratta di una "falsa" rinominazione) e porre il numero di OrdinalPosition pari a quello proposto + 1.

'240303
'Disponibile bottone per creare un file di testo con l'intera struttura (analitica o sintetica) del database

'280303
'I database aperti vengono ora mantenuti, in ordine cronologico inverso di apertura, in apposito combobox (al posto di un ex textbox), sempre con nome txt_database. Volendo azzerare l'elenco usare l'apposita funzione (5) dal bottone "Varie Db" oppure agire direttamente (e pi analiticamente) sul file ESP0DAMA.INI eliminando le righe con Tag "DATABASE_N=..."

'290303
'Data questa versione (aggiornamento) al WM del SC

'310303
'Creazione di un file di testo con i contenuti del recordset corrente

'090403
'Aggiunta opzione che consente di formattare i numeri esposti. La variazione degli stessi pu usare sia il separatore fra le migliaia che quello fra i decimali, ma, come prima, coerentemente con le impostazioni correnti.

'100403
'Aggiunta opzione per totalizzare i vari campi numerici (riga "T"), progressivamente per ogni pagina

'100403
'Inviata questa versione (aggiornamento) al WM del SC (e a D.P.)

'100403
'La costante (vedi ESBPDAMA.BAS) totali_ForeColor consente di indicare il colore per i totali. Allo scopo di favorire la leggibilit della riga totali (specialmente se molto lunga), gli stessi ora prevedono uno "0" esplicito per colonne numeriche con totale nullo e "-" per tutte le altre. 

'100403
'Inviata questa versione (aggiornamento) al WM del SC

'100403
'Vengono totalizzati anche i campi Boolean

'110403
'Creazione file ASCII per il contenuto del recordset: Possibilit di escludere descrizioni e indicare il separatore fra i campi. 

'140403
'Prevedendo i totalizzatori si verificava un errore aggiungendo un record a un recordset vuoto.

'160403
'Prevedendo i totalizzatori si poteva verificare un errore in corrispondenza di campi a Null

'180403
Con ADO viene rifiutato un campo Memo in una Order By composta dall'operatore (se tale opzione  attiva in fase di apertura di una tabella). Inoltre, in fase di creazione di un indice, viene rifiutato un campo Memo e, per SQL Server, anche un campo Boolean/Bit.

'180403
'Creazione file ASCII per il contenuto del recordset: Possibilit di considerare tutte le tabelle del database, non solo il recordset corrente. 

'180403
'Per ADO vengono ora esposte anche tutte le Extended Properties (Propriet Estese)

'180403
'L'indicazione di Richiesto/Obbligatorio nella creazione di un campo di tabella veniva ignorata

'180403
'Fra le propriet dei campi viene ora esposto esplicitamente se AutoIncrementante (tranne che per ADO+SQL Server perch tale propriet non  reperibile dal Catalog/ADOX, le mie considerazioni per quelli di ADO e magari quelli di SQL Server, stanno nel codice) e, solo per DAO, se l'ordinamento di un campo in indice  dbDescending

'180403
'Poteva verificarsi un errore se ci si muoveva velocemente fra le pagine di un recordset quando previsti i totali

'180403
'Lo scorrimento di un recordset ... non scorrevole poteva risultare anomalo e anche provocare errori

'190403
'Da un'idea di Sauro (da lui gi realizzata e qui ripresa, ristrutturata ed estesa)  ora prevista una nuova opzione che consente di attivare una finestra di scelte in fase di duplicazione di un database, allo scopo di scegliere le tabelle di cui duplicare i contenuti, oltre a poter indicare alcune propriet dei campi. Tale possibilit viene estesa anche a database di tipo DBF per i quali l'unica funzione disponibile  ora "Duplica". Tale funzione, per ogni tipo di database origine, consente inoltre (per Access e SQL Server solo se l'opzione che attiva la finestra di scelte di duplicazione  attiva) di decidere il tipo di database di destinazione (Access o SQL Server). Un database di tipo DBF non  quindi duplicabile su altro DBF, ma solo su Access o SQL Server.

'200403
'Inviata questa versione a Sauro

'200403
'Inserito frm_testata che racchiude i vari controlli in testa. Viene reso invisibile (non pi solo btn_varie_db) all'apertura del database per evitare che in tale fase vengano attivati altri controlli.

'230403
'Inserita opzione che consente di mostrare i campi a Null con la scritta "Null". Se tale opzione  disattivata i campi non verranno esposti. Eventuali totali di colonne numeriche con tutte le righe a Null, verranno esposti come "Vuoto". Pare che i campi boolean non possano (se non in SQL Server, campi Bit) essere assegnati a Null. Per inserire un valore Null occorre digitare (rispettando il minuscolo e senza ") "*null*"

'280403
'In fase di duplicazione (con opzioni) del database  ora possibile creare solo le tabelle indicate per il trasferimento dei records.

'290403
'Disponibile la duplicazione con opzioni da Access/DBF a SQL Server e da SQL Server a SQL Server e Access

'030503
'Inviata questa versione (aggiornamento) al WM del SC

'040803
'Test per unita' cartella_normale_database e richiesta di alternativa se indisponibile (su indicazione di S.B. e inviato ZIP allo stesso)

'050803
'Le funzioni di generazione file di testo (bottone ">F") per il database e per il recordset corrente (o tutti) ora presumono l'impostazione, se prevista, della chiave di accesso (non necessariamente il checkbox "Varia" attivato). Il file di testo per il/i recordset ora chiede se convertire i pesi decimali 0-31, 127-144, 147-159 (pesi non gestiti da Windows, stando alla guida di VB, cercare "Ascii") in "{nnn}". Serve, soprattutto, a mantenere la leggibilita' e per evitare che il file di testo generato venga "troncato" (se letto, per esempio, con una "stringa=Input$(LOF(canale),#canale)" da VB) a causa della presenza di Nulls (0) o Ctrl+Z/EOF=26. Se la risposta a tale richiesta e' affermativa, verra' chiesto se effettuare la trasformazione per tutti i pesi (0-255).

'120803
'Ora vengono riconosciuti anche i comandi CREATE e DROP

'120803
'Segnalava errore in creazione campi di tipo solo DAO (per esempio dbBinary), in quanto non trovava " - eccetera" dopo la descrizione principale nel combobox

'070903
'Ctrl+Shift+T sulla griglia (listview) del recordset ricompone lo stesso totalizzando i campi numerici, anche se l'apposita opzione non  attivata.

'070903
'Corretto un errore per il quale, se l'opzione di formattazione dei campi numerici era disattivata, il totale dei campi Boolean era negativo.

'110903
'Inviata questa versione (aggiornamento) al WM del SC

'120903
'L'InputBox usato per chiedere il numero della funzione (bottone "Varie Db") poteva non esporre l'intero elenco/messaggio (Prompt) se una riga  pi lunga dello spazio internamente dedicato in larghezza e non contiene spazi tali da poter andare a capo. Ho tolto il percorso e nome del database.
'170903 Ripristinata la riga del percorso e nome del database e accodato al messaggio complessivo un vbCrLf

'290903
'Quando si duplicano i records delle tabelle (funzione Duplica con opzioni)  ora possibile indicare di non duplicare i records contenenti Null in uno o pi campi

'271003
'In presenza di campo di tipo non gestito (per esempio Binary, OLE, etc.) si verificava un errore in esposizione. Ora espone "Tipo non gestito". Inoltre ora in fase di registrazione di un record variato, tali campi non vengono assegnati, ovvero vengono lasciati come in originale.

'031203
'Inserito bottone "T" per mostrare tabella codici 0-255 Decimali, Ascii, Esadecimali, Ottali. Cliccando sullo stesso col pulsante destro del mouse sar possibile impostare anche il font (inizialmente Courier New 10 o l'ultimo impostato)

'051203
'"Rinumerati" i vari comandi esplicitamente riconosciuti (la Select pura continua a rendere 0) e previsto il numero 99 per un comando diverso dalla Select pura e non esplicitamente riconosciuto. Verr eseguito come tale.

'101203
'Un comando del tipo "Select#campo from Tabella" con un Invio (vbCrLf) al posto di # veniva inteso come un comando strutturale e non come una Select in quanto lo spazio cercato per determinare il tipo di comando non veniva trovato subito dopo la Select. Ora tutti i vbCrLf vengono preventivamente cambiati in uno spazio.

'101203
'Inseriti messaggi (solo se database di tipo Access, sia per DAO che per ADO) che indicano che una chiave di indice pur dichiarata NON Univoca/Unique, verr forzata a Univoca/Unique se dichiarata Primaria/Primary.

'271203
'Nei comandi SQL quanto compreso fra ++ e -- viene inteso come commento e totalmente ignorato. Se a un ++ non segue un -- tutto quanto segue ++ verr inteso come commento.

'301203
'Previste due nuove opzioni: "Non dimensiona le colonne della griglia, usa il dimensionamento automatico" (in alternativa a "Dimensiona le colonne della griglia tenendo conto anche dei titoli") e "Mantiene la larghezza delle colonne della griglia fra una pagina e l'altra"

'301203
'Inviata questa versione (aggiornamento) al SC

'311203
'I caratteri di inizio e fine commento sono ora disponibili come costanti (crt_commento_inizio e crt_commento_fine) nel modulo di personalizzazione (ESBPDAMA.BAS) e posizionati, rispettivamente, a -- e ++ (quindi al contrario della nota del 271203).

'020104
'Il tempo impiegato per l'esecuzione di comandi SQL (strutturali o di recupero dati) poteva essere erroneamente incrementato dai tempi di attesa per eventuali MsgBox esposti in funzione delle circostanze. Ora riguardano l'effettiva e reale esecuzione del comando.

'020104
'Il testo che precede il comando SQL nella finestra di esposizione dei risultati ora usa i caratteri di inizio e fine commento, non pi i segni >. Come prima, l'operatore pu modificare il comando liberamente (ovviamente mantenendo i caratteri di inizio e fine commento o eliminando integralmente la parte commentata) agendo dopo i caratteri di fine commento. Eventuali interlinee prima dell'effettivo comando SQL verranno sostituite con due (subito dopo i caratteri di fine commento), quelle interne al comando SQL verranno mantenute.

'050104
'E' disponibile una nuova opzione "Accetta database SQL Server senza percorso (solo nome)" che, se attivata, consente di indicare (ovviamente con ADO e SQL Server) il solo nome del database, senza il suo percorso. Non saranno disponibili le funzioni di creazione e duplicazione.
Se questa opzione  attiva, sar abilitata anche la nuova opzione "Per SQL Server il bottone 'Database' elenca/chiede il nome dei databases, non il percorso". Se questa opzione  attiva, cliccando sul bottone "Database" verr eseguita la sp_databases e l'elenco dei soli nomi dei databases ottenuto esposto in un listbox. Il database pu essere scelto e aperto con doppio click sul suo nome. Ogni selezione riporter il nome nell'apposita zona di indicazione del database. Il listbox verr eliminato accedendo a qualsiasi altro controllo.

'050104
'Quando un comando SQL genera errore viene ora chiesto se mettere il comando SQL stesso negli appunti. Pu essere particolarmente utile quando si modifica il comando SQL dalla finestra che espone il recordset (comunque ottenuto). Il comando modificato non viene mantenuto e se genera errore verrebbe definitivamente perso in quanto la finestra si chiude. Rispondendo affermativamente alla nuova domanda, pu essere messo negli appunti e convenientemente recuperato ove si desidera.

'050104
'Eventuali tabelle collegate ad altre residenti su database non disponibili/accessibili provocavano un errore in fase di apertura del database e la procedura si chiudeva. Ora l'eventuale errore viene segnalato, ma la procedura non si chiude. Nel caso di DAO+Access il database non viene aperto. In ADO+Access non viene comunicato alcun errore, ma dalla tabella collegata e inaccessibile non si ricavano informazioni, per esempio i campi.
'Per Access (DAO o ADO) e per tabella  collegata viene ora esposta una riga informativa di propriet (prima dei campi) che riporta le informazioni del database di destinazione.

'120104
'La procedura andava in errore aprendo un database Access con ADO+Jet351. Inoltre, in tali condizioni, non ho trovato una costante che indichi se un campo Long (adInteger)  autoincrementante. Ho usato 2^1=2 su Attributes che se alto indica campo normale, se basso indica campo autoincrementante. Con lo stesso metodo viene esposto se un campo  autoincrementante con ADO+SQL Server. Prima tale informazione era omessa.

'240104
'Ora (solo per Access, in DAO o ADO) vengono anche visualizzate le Query (Procedures/Views in ADO) presenti nel database. Possono anche essere eseguite cliccando sulla propriet SQL e poi sul bottone Apri Query. Non ho capito come mai le query del file ATECOFIN2004.mdb in DAO vengono eseguite senza problemi e in ADO vanno tutte in errore... mah!

'250104
'Se il database  di tipo Access, cliccando col pulsante destro del mouse sul bottone "Salva" (abilitato quando il comando SQL  aperto e non vuoto)  possibile salvare il comando stesso come Query. Il bottone "Elimina"  ora attivo anche per le query. Si rammenta che in un database non possono esistere Tabelle o Queries con identico nome.

'240204
'La funzione "Ripara e Compatta" (solo per database di tipo Access) ora chiede (solo se la versione del database e' inferiore alla 2000) la versione del database riparato e compattato (invariata o 2000). Se si converte a 2000, verra' chiesta conferma al fatto che non sara' piu' possibile tornare a versioni precedenti, non almeno con questa procedura.

'250204
'In DAO+Access viene ora esposta (se disponibile) la Properties("AccessVersion") che dovrebbe valere "1.0" per access 1.0, "2.0" per access 2.0, "06.68" per Access 95, "07.53" per Access 97, "08.50" per Access 2000 e "09.50" per Access XP/2002. Tale proprieta' non appare sempre disponibile, ovvero lo e' se il database viene creato con MsAccess (non lo e' se un database viene creato, pur in DAO, con la CreateDatabase e nemmeno con la CompactDatabase e, ancora, nemmeno con Visdata adeguato a DAO 3.6). Se la proprieta' fosse disponibile, lo e' (cosi' pare) anche in scrittura e, per database di versione 2000, potrebbe essere forzata (la DAO/Compactdatabase non cambia tale proprieta' anche se si trasforma un database in versione 97 in uno in versione 2000) a "08.50", risolvendo cosi' il problema di database in versione 2000 creati con la CreateDatabase (dbVersion40) che non vengono aperti con MsAccess 2000 o 2002. Forzando tale proprieta' a "08.50" i database in versione 2000 possono essere letti anche da MsAccess 2000 e XP/2002.

'250204
'Ora e' possibile (solo per DAO+Access) assegnare anche la Properties("AccessVersion") in fase di creazione di un database, duplicazione e compattazione. Tale proprieta', se assente, viene esplicitamente aggiunta (grazie a termoPilucco, c/o ICLVB).
Attualmente si prevedono solo due versioni di database: 97 ("07.53") e 2000 ("08.50").
Si noti che se la proprieta' e' assente il database viene comunque aperto da MsAccess, se la proprieta' e' presente, allora deve essere coerente con la sua Version (Access97: Version="3" e AccessVersion="07.53", Access2000: Version="4" e AccessVersion="08.50"). 
C'e' una nuova e apposita opzione che occorre attivare solo se NON si vuole che la proprieta' AccessVersion venga variata/creata, ovvero per mantenere il comportamento di prima. 

'250204
'Inviata questa versione (aggiornamento) al WM del Sito Comune di ICLVB

'090304
'Per Access (DAO o ADO) e per tabella  collegata, oltre alla riga informativa di propriet (prima dei campi) che riporta le informazioni del database di destinazione, viene ora esposta un'altra riga che riporta il nome della tabella di destinazione.

'100304
'L'apertura (in ADO) di un database con una tabella collegata a un database con percorso inesistente (non semplicemente inesistente il database di destinazione) provocava un errore e il programma si fermava. E' stato aggiunto un controllo d'errore.

'100304
'Inviata questa versione (solo sorgente) a emmexx

'100304
'Icona diversa per tabelle collegate

'160304
'Cliccando col pulsante destro del mouse nella parte sinistra della finestra principale (Struttura del database) il testo corrispondente all'elemento selezionato verr messo negli appunti di Windows. Se l'operazione viene eseguita tenenendo premuto il tasto Shift, il testo verra' accodato agli appunti attuali, anteponendo allo stesso un vbCrLf.

'160304
'Siccome la propriet ConnectionString di ADO pubblica in bella vista anche le eventuali passwords (sic!), la procedura cambia nelle combinazioni "PASSWORD=xxx;" e "PWD=xxx;" (maiuscole e/o minuscole) trovate in ConnectionStrig le "xxx" in "???". La stessa cosa e' stata fatta anche per le proprieta' estese che contengono nel nome "PASSWORD" e di type=adBSTR.

'170304
'Inviata questa versione (aggiornamento) al WM del Sito Comune di ICLVB

'220304
'Aggiunta opzione per gestire l'attivazione del checkbox SQL Server se si attiva l'opzione ADO

'240304
'La riga in testa che riporta il percorso e nome del database cita anche, in coda, la sua dimensione in Mb. Ci avviene solo se il percorso/nome corrisponde a un file fisico.

'240304
'I caratteri di inizio e fine commento (default rispettivamente -- e ++) ora possono essere assegnati dalla finestra delle opzioni e variati secondo necessit. Poteva accadere, infatti, che i caratteri di inizio/fine commento prima prestabiliti venissero citati nel contesto di un comando SQL e quindi mal interpretati. Per esempio: Select * From Tabella Where Campo='----'

'030404
'Le proprieta' di una tabella collegata venivano erroneamente accodate alle informazioni della tabella precedente in elenco. Inoltre, cliccando su tali proprieta', si attivavano i bottoni di azione previsti per una tabella.

'030404
'Inviata questa versione (aggiornamento) al WM del Sito Comune di ICLVB

'100404
'E' ora possibile personalizzare le icone utilizzate dalla procedura indicandone il nome.estensione del file (non il percorso) nella finestra delle opzioni. Viene usata una casella combinata a immagini (ImageCombo). I file delle icone (consigliate 16x16) devono risiedere nella stessa cartella dell'applicazione ESP0DAMA.EXE (App.Path). Se il file di un'icona non viene indicato (campo vuoto) o non esiste (il campo relativo sar svuotato) verr utilizzata l'icona di progetto (controllo ImageList ESF0DAMA.il). Le eventuali variazioni effettuate nella finestra delle opzioni (e quindi le nuove icone specificate) verranno considerate solo al successivo riavvio della procedura.

'160404
'Aggiunta un'opzione che indica se controllare o meno che un file di tipo Access abbia l'estensione .MDB

'190404
'Possibilit di creare/vedere la propriet "Description" per database di tipo Access, con DAO o ADO. La propriet pu essere assegnata in fase di creazione del campo. Pu essere cambiata dopo che il campo e' stato creato cliccando sul bottone "Rinomina", confermare (o variare) il nome del campo, confermare (o variare) OrdinalPosition (solo per DAO) e confermare o variare la Description. Campo vuoto (o bottone Annulla) per eliminare la Description stessa.

'190404
'Aprendo un file di tipo DBF si verificava un errore perch si tentava di recuperare la lunghezza del file ... ehm ... cartella :-(

'200404
'(Da un'idea di emmexx): I vari comandi SQL eseguiti (anche se errati, ma se diversi dai precedenti) vengono ora archiviati in ordine cronologico in un vettore di sessione (v_sql_sessione). L'elenco dei comandi SQL eseguiti pu essere ottenuto cliccando sul bottone "." posto appena prima del bottone "Esegui". I comandi verranno esposti in un listbox con eventuale barra di scorrimento orizzontale (eventuali vbCrLf verranno sostituiti con spazio) e potranno essere selezionati (per essere messi nel textbox del comando SQL) con doppio click o col tasto spazio. E' possibile chiudere il listbox selezionando il primo elemento o premendo il tasto Escape o il tasto Tab (LostFocus).

'200404
'Due nuove opzioni consentono di indicare se, all'abbandono della procedura, salvare automaticamente i comandi SQL di sessione (se presenti) o, se l'opzione precedente non e' attivata, se chiedere se effettuare il salvataggio. Se entrambe le opzioni sono disattivate i comandi SQL di sessione non verranno salvati. Se se ne prevede il salvataggio (automatico o a richiesta con risposta affermativa) i comandi SQL verranno salvati nella cartella di residenza di ESP0DAMA.EXE (App.Path) con nomi "ESP0DAMA_SQL_aaaammgg_hhmmss_nnnn.SQL", dove "aaaammgg" indica la data di sistema (Date) e "hhmmss" l'ora di sistema (Time). "nnnn" e' un numero progressivo che va da 0001 al numero dei comandi SQL diversi eseguiti nella sessione di lavoro. Se i file con tali nomi esistono gia', verranno preventivamente cancellati. 

'200404
'Inviata questa versione a emmexx

'200404
'Il file ESP0DAMA.LOG (se previsto) ora viene creato/gestito nella cartella di residenza di ESP0DAMA.EXE (App.Path)

'200404
'Il file ESP0DAMA.INI ora puo' essere creato/cercato/gestito nella cartella di residenza di ESP0DAMA.EXE (App.Path) ponendo a 1 la costante "usa_app_path_per_ini" in ESBPDAMA.BAS. Ponendo tale costante a 0 il file verr creato/cercato/gestito (come prima) nella partizione principale del drive indicato nella costante "cartella_database_normale_costante", sempre in ESBPDAMA.BAS.

'200404
'I file SQL salvati/recuperati esplicitamente possono essere ora salvati/recuperati nella cartella di residenza di ESP0DAMA.EXE (App.Path) ponendo a 1 la costante "usa_app_path_per_sql" in ESBPDAMA.BAS. Ponendo tale costante a 0 i file SQL verrano salvati/recuperati (come prima) nella cartella indicata nella costante "cartella_database_normale_costante", sempre in ESBPDAMA.BAS. I file SQL di sessione verranno in ogni caso salvati (se desiderato) nella cartella App.Path. La Tag "FILE_SQL" (corrispondente all'ultimo file SQL salvato/recuperato) in ESP0DAMA.INI non viene pi gestita.

'210404
'Possibilit di creare tabelle collegate, solo da e per database di tipo Access (DAO e ADO).

'210404
'Pubblicata questa versione su http://lupo-iclvb.port5.com/

'220404
'La listview che si apre per elencare un set di records ora sposta la finestra del 90% a destra o a sinistra ogni volta che si preme il tasto freccia a destra o freccia a sinistra. Se insieme al tasto freccia si preme anche Shift e/o Ctrl il comportamento sar quello normale, quindi con spostamento molto ridotto. Usando il mouse si otterra' uno spostamento del 100% se si clicca in qualunque punto bianco (non quindi sulla barretta di spostamento/trascinamento) della barra di scorrimento orizzontale in basso.

'220404
'Pubblicata questa versione su http://lupo-iclvb.port5.com/

'230404
'Abbandonando il combobox col tasto Invio ora il fuoco va sul bottone di apertura del database. Un altro invio lo attiver.

'230404
'La ricerca dei percorsi/nomi dei database da aggiungere nel combo ora viene fatta trasformando in maiuscolo, per evitare duplicati.

'230404
'Se la costante funzione_varie_6 (in ESBPDAMA.BAS) e' definita e diversa da 0, fra le funzioni varie (se database di tipo Access con percorso/nome contenente ESD00COM) verr aggiunta la "6 - Rende attiva la postazione 2". Questa (chiaramente per uso specifico e senza richiesta di chiave) apre la tabella TERMINALI e posiziona a 1 (Vero) il campo TERMINALE_ATTIVO per il record con TERMINALE=2.

'260404
'Nelle funzioni varie (bottone Varie) e' disponibile la funzione 7 che consente di eliminare tutti i files con nome "ESP0DAMA_SQL_aaaammgg_hhmmss_nnnn.SQL" presenti nella cartella di residenza di ESP0DAMA.EXE (App.Path)

'060504
'Rinominando un campo e cliccando sul bottone "Annulla" alla richiesta del nuovo nome si verificava un errore 3265. Ora, nelle stesse condizioni, la procedura di rinominazione viene interrotta.

'060504
'Tolto tutto da http://lupo-iclvb.port5.com/

'250604
'I vari comandi SQL salvati dalla procedura "sporcavano" la cartella che ospita la stessa. Ora vengono salvati all'interno della cartella ESP0DAMA_SQL che viene automaticamente creata (sin dall'avvio della procedura) nella cartella che ospita l'applicativo. Le funzioni di eliminazione dei comandi SQL, salva e recupera comando SQL sono state adeguate di conseguenza.

=======================================================
Fine del file ESTHDAMA.TXT
