alsoftwork Manuale d' uso di Editor_Sdf

Transcript

1 alsoftwork Manuale d' uso di Editor_Sdf Editor_Sdf è una piccola applicazione che permette di creare file di database nel formato sdf di Sql Compact Engine, versione 3.5. Editor_Sdf serve per creare file sdf da utilizzare in sostituzione dei file mdb che venivano e vengono tuttora impiegati per il salvataggio di dati in applicazioni sviluppate in VB.Net / C#, pertanto non permette di creare relazioni fra tabelle, query o altre operazioni avanzate. Editor_Sdf è stato creato per produrre i file di database in formato sdf, nel momento in cui si è deciso di abbondonare Microsoft Jet Engine 4.0 ormai non più supportato, e passare a Sql Compact Engine disponibile sia in versione 32 che 64 bit. Pur potendo utilizzare l'ambiente di sviluppo di VisualStudio, DatabaseTool Manager di Sql Server Express o strumenti disponibili in commercio, Editor_Sdf permette di generare file sdf in maniera veloce, rapida ed autonoma. Editor_Sdf utilizza Sql Compact Engine Bit

2 Utilizzo di Editor_Sdf Questo pulsante permette di creare un nuovo database con le specifiche impostate negli appositi controlli. Questo pulsante permette di interrompere la creazione del database. Questo pulsante permette di salvare il database aperto con un nome diverso. Questo pulsante permette di chiudere il database aperto. Questo pulsante permette di selezionare un database da aprire. Questo pulsante permette di visualizzare le proprietà del database aperto. Questo pulsante visualizza la finestra di dialogo Strumenti Database. Questa casella di testo visualizza il percorso e il nome del database Creato o Aperto. Questo controllo permette di impostare la dimensione massima che può assumere il database creato. Questo controllo permette di impostare la dimensione massima del buffer di memoria oltre la quale i dati vengono passati dalla memoria al file di database sul disco fisso. Questo controllo permette di impostare la soglia per l' avvio dell'autocompressione del file di database. Questo controllo permette di impostare la modalità di apertura del database. Questo controllo permette di impostare la lingua utilizzata dal database per effettuare ricerche e confronti. (Ita. = 1040 o Eng. = 1033) Questo controllo permette di impostare la distinzione fra caratteri minuscoli e maiuscoli. Questo controllo permette di attivare o meno la crittogafia del file di database. Questa casella di testo permette di inserire la password utilizzata per proteggere il database. (La password verrà richiesta ad ogni apertura del database.)

3 Tabelle Questo controllo visualizza le tabelle contenute nel database e ne permette la selezione per apportarvi modifiche, o visualizzare tutte le colonne contenute. Questa casella di testo permette di inserire il nome da assegnare ad una nuova tabella da creare, o per rinominare la tabella selezionata.(solo caratteri e numeri) Questo pulsante permette di aggiungere una nuova tabella al database. Questo pulsante permette di rimuovere la tabella selezionata dal database. Questo pulsante permette di annullare la creazione della tabella. Questo pulsante permette di rinominare la tabella selezionata. Colonne Questa casella di testo permette di inserire il nome da assegnare alla nuova colonna da inserire nella tabella selezionata.(solo caratteri e numeri) Questo controllo permette di selezionare il tipo di dato da assegnare alla nuova colonna. Questa casella di testo permette di inserire il numero massimo di caratteri consentito per il tipo di dato nvarchar,o i Byte per il tipo di dato varbinary Questo controllo permette di selezionare la precisione per il tipo di dato numeric. (minimo 1 massimo 38) Questo controllo permette di selezionare la scala(numero di decimali) per il tipo di dato numeric.(minimo 0 massimo = Precision ) Questa casella di testo permette di inserire un valore di default se il tipo di dato selezionato lo permette.

4 Questo pulsante permette l'inserimento nella casella di testo Default Value di uno dei valori selezionati nel controllo apposito. Questo controllo rende disponibile per la selezione, i valori di default ammessi per il tipo di dato selezionato. Questo controllo abilita / disabilita la possibilità che la colonna accetti solo valori univoci. Questo controllo abilita / disabilita la possibilità che la colonna accetti valori nulli. Questo controllo crea una chiave primaria, e si abilita quando si seleziona il tipo di dato Int, "smallint, "tinyint", "bigint". Quando si crea una nuova tabella e si inserisce la prima colonna verrà richiesto di creare una chiave primaria come prima colonna.ogni tabella ammette la creazione di una sola chiave primaria, e non è più possibile eliminarla. Questo controllo permette di selezionare il valore numerico iniziale per la chiave primaria. (esempio: Seed = 10) (Default = 1) Questo controllo permette di selezionare il valore numerico di incremento per la chiave primaria. (esempio: Increment = 100) (Default = 1) Questo pulsante aggiunge la colonna definita alla tabella che si sta creando. Questo pulsante crea la tabella con tutte le colonne definite. La griglia Colonne visualizza le colonne che si creano, durante la creazione della tabella, o le colonne contenute nella tabella selezionata sia durante la modifica, sia durante l' apertura di un database. La griglia Colonne permette la selezione di colonne che si vogliono modificare, è permesso selezionare solo una colonna alla volta. ATTENZIONE: Editor_Sdf non permette di rinominare le colonne una volta create, l'unico modo di rinominare una colonna che non sia la chiave primaria, è di eliminare la colonna che si vuole rinominare, e ricrearla con il nome desiderato.

5 Questo pulsante abilita / disabilita la selezione e la modifica delle colonne. Questo pulsante rimuove dalla tabella la colonna selezionata, il tentativo di rimuovere la chiave primaria visualizza un messaggio di errore e l'annullamento dell'operazione. Questo pulsante rimuove tutte le colonne compresa la chiave primaria dalla tabella selezionata. Questo pulsante applica tutte le modifiche effettuate sulle colonne della tabella selezionata. Questa casella di testo visualizza il nome della colonna attualmente selezionata nella griglia colonne. Strumenti Database Questa finestra di dialogo rende disponibili alcuni strumenti per la manutenzione dei database creati con SQL Compact Engine 3.5.

6 Questo pulsante visualizza la finestra di dialogo che permette di selezionare il file di database a cui applicare gli strumenti di manutenzione. Questa casella di testo visualizza il nome del database selezionato. Quando il Database selezionato è protetto da password viene visualizzata questa finestra di dialogo. Proprietà Database: Questo controllo permette di impostare la dimensione massima che può assumere il database creato. Questo controllo permette di impostare la dimensione massima del buffer di memoria oltre la quale i dati vengono passati dalla memoria al file di database sul disco fisso. Questo controllo permette di impostare la soglia per l' avvio dell' autocompressione del file di database. Questo controllo permette di impostare la modalità di apertura del database. Questo controllo permette di impostare la lingua utilizzata dal database per effettuare ricerche e confronti. Questa casella di testo permette di inserire la password che sostituirà quella già presente, o non inserendo nulla, di eliminare la password presente, sproteggendo il database selezionato. Questo controllo permette di impostare la distinzione fra caratteri minuscoli e maiuscoli. Questo controllo permette di attivare o meno la crittogafia del file di database. Questo controllo permette di applicare o meno i nuovi valori delle proprietà, impostati nei controlli soprastanti, al file di database selezionato. (Le modifiche verranno applicate durante la compressione del database "Compact").

7 Strumenti Database: Questa casella di testo visualizza la versione del Database aperto. Questo pulsante permette di inserire la tabella Db_Set_Info" che contiene i settaggi del database selezionato, se questa non esiste. (Questa tabella risulta invisibile nell'editor.) Questo pulsante permette di comprimere il file di database selezionato, applicando le modifiche alle proprietà se è attivo il controllo Modifica proprietà. Questo pulsante permette di riparare se necessario il file di database selezionato, utilizzando una delle modalità selezionate nell' apposito controllo. Questo controllo permette di selezionare una delle modalità disponibili per la riparazione del file di database. Questo pulsante permette di ricuperare lo spazio inuitilizzato nel file di database. Questo pulsante permette di verificare l'integrità del file di database selezionato. Questo pulsante permette di aggiornare, se necessario il file di database selezionato dalla versione 3.1 alla versione 3.5. (Una volta aggiornato il database, non sarà più possibile aprirlo con SQL Compact versione 3.1) Questo pulsante permette di chiudere la finetra di dialogo Strumenti Database. Proprietà Database Questa finestra di dialogo visualizza le proprietà del database selezionato.

8 Apri Database Sdf Finestra di dialogo per la selezionare del file di database da aprire. Crea Database Sdf Finestra di dialogo per selezionare la directory dove creare il database con il nome inserito.

9 Salva come... Finestra di dialogo per salvare il file aperto con un nuovo nome. (Il file aperto viene chiuso e viene aperto il file creato con il nuovo nome.) Informazioni generali 1) Editor_Sdf non permette la ridenominazione delle colonne, l'unico modo per ridenominare una colonna è di eliminarla, e poi crearne una nuova con il nome desiderato. 2) Questo editor richiede la definizione di una chiave primaria(primary Key) alla creazione di ogni nuova tabella.(una volta definita la chiave primaria non è più possibile rinominarla o eliminarla.) 3) Per cambiare tipo di dato alla colonna selezionata è necessario rimuovere il valore di default, se presente selezionando Allow Null, salvare la modifica, riselezionare la colonna e cambiare il tipo di dato. 4) Questa versione di Editor_Sdf permette di creare file di database Sdf da utilizzarsi abbinati ad ADO.Net e VB.Net o C#. (Non permette la creazione di relazioni fra tabelle o altre operazioni come: definizione di colonne FOREIGN KEY, UNIQUEIDENTIFIER, Query, SQL Script, ecc.) 5) Per i nomi di tabelle e Colonne è possibile usare solo caratteri e numeri. Questo pulsante permette di visualizzare il manuale di utilizzo. Questo pulsante permette di visualizzare informazioni su Editor_Sdf. Questo pulsante permette di visualizzare la finestra di dialogo per la gestione dei dati.

10 Gestione Dati Questa finestra di dialogo permette l'inserimento e la modifica dei dati, nei campi del database selezionato. Questo pulsante permette di selezionare il file di database da editare. Questo controllo visualizza tutte le tabelle contenute nel database selezionato, e permette di selezionare la tabella che si vuole editare. Questa griglia visualizza tutti i campi contenuti nella tabella selezionata e permette di inserire e modificare i dati. Questo pulsante permette di inserire una nuova riga. Questi controlli permettono di navigare fra le varie righe della tabella, e visualizzano la riga attualmente selezionata, e il numero totale delle righe contenute nella tabella. Questo pulsante permette di copiare e inserire la riga selezionata. Questo pulsante permette di eliminare la riga selezionata. Questo pulsante permette di eliminare tutte le righe contenute nella tabella selezionata.

11 Questo pulsante permette di annullare tutte le modifiche apportate ai dati, dopo l' ultimo salvataggio. Questo pulsante permette di salvare tutte le modifiche apportate ai dati. Questo pulsante permette di attivare la visualizzazione delle proprietà della colonna, basta selezionare una cella contenuta nella colonna desiderata e verrà visualizzata la finestra di dialogo riportata sotto. Questo controllo indica se la modalità di visualizzazione delle proprietà colonna è attiva. Questa finestra di dialogo visualizza le proprietà della colonna selezionata. Questo controllo visualizza il database attualmente aperto in Gestione Database. Questo controllo visualizza informazioni sulla colonna selezionata. Le finestre di dialogo per l'inserimento assistito dei dati nella griglia si attivano selezionando con il pulsante destro del mouse la cella della griglia in cui si vuole inserire i dati. Le celle abilitate a questo sono quelle che appartengono alle colonne a cui sono stati assegnati i seguenti DataType: ntext : image: varchar: datetime: Testo e percoro file. Immagini. Immagini. Data o Data + Ora

12 Questa finestra di dialogo permette di creare, aprire file di testo, rtf, html ecc., salvare su file, ed inserire il testo nel campo selezionato all' interno della griglia. Questi menu e toolbar forniscono le funzionalità di un piccolo editor di testo. Questo pulsante apre la finestra di dialogo per l'inserimento dei nomi dei file completi di percorso. Questo pulsante permette l'inserimento del testo nel campo selezionato all'interno della griglia. Questo pulsante chude la finestra di dialogo.

13 Questa finestra di dialogo permette di selezionare il file di testo da aprire.

14 Questa finestra di dialogo permette di inserire il nome del file e relativa directory nel campo selezionato all'interno della griglia. Questo pulsante apre la finestra di dialogo per selezionare il file da caricare nella lista File. Questo pulsante elimina la riga selezionata nella lista File. Questo pulsante elimina tutte le righe dalla lista File. Questo pulsante inserisce la riga selezionata nella lista File, nel campo selezionato all'interno della griglia.

15 Questa finestra di dialogo permette di selezionare il nome del file e relativa directory.

16 Questa finestra di dialogo permette di inserire l' immagine aperta, nel campo selezionato all'interno della griglia. Questo pulsante apre la finestra di dialogo per selezionare il file immagine da aprire. Questa casella di testo mostra le dimensioni in Byte dell'immagine aperta. (Se le dimensioni in bit sono superiori a quelle massime impostate (' Length'), viene mostrato un avviso ed annullato l'inserimento dell'immagine nel database.) Questi pulsanti modificano la visualizzazione dell'immagine aperta. Queste caselle di testo mostrano le dimensioni dell'immagine aperta, e permettono di impostare le nuove dimensioni da applicare all'immagine. (Questi valori sono espressi in pixel) Questo controllo abilita / disabilita il ridimensionamento dell'immagine. Questo controllo abilita / disabilita il ridimensionamento mantenedo le proporzioni dell'immagine. Questo pulsante applica il ridimensionamento all'immagine. Questo pulsante elimina la riga selezionata nella lista file aperti. Questo pulsante inserisce l'immagine nel campo selezionato all'interno della griglia.

17 Selezionando con il tasto destro del mouse la lista delle immagini aperte, viene visualizzato questo comando che permette di eliminare tutte le righe contenute nella lista. Questa finestra di dialogo permette di selezionare una immagine da aprire. Informazioni per il DataType 'varbinary': Una immagine formato Png da 100 x 30 pixel con una profondità di colore non eccessiva ad esempio, richiede un valore pari a 3400 nel parametro 'Length' applicato al DataType 'varbinary'. (Valore massimo applicabile: 8000 pari a 7,81 Kb) La dimensione in Byte dell'immagine viene influenzata sia dalle dimensioni (Larghezza e Altezza) sia dal numero di colori utilizzato per rappresentarla. Il DataType 'varbinary' accetta qualsiasi valore o stream di byte al suo interno, ma se viene collegato ad un controllo DataGridView, che per default considera qualsiasi stream di byte come se fosse una immagine, questi cercherà di convertire in immagine il valore presente in 'varbinary', generando un errore se la conversione non riesce. Pertanto se in 'varbinary' si inseriscono dati in formato binario non si potrà utilizzare l'editor Gestione Dati incorporato in Editor_Sdf, perchè utilizza appunto un controllo DataGridView. Se comunque si ha la necessità di inserire in 'varbinary' dati in formato binario, evitare di collegarli direttamente (Binding) a controlli che non sono in grado di gestire questi dati, ma gestendoli direttamente da codice.

18 Questa finestra di dialogo permette di inserire la data o la data + ora nel campo selezionato all'interno della griglia. Questo pulsante abilita l'inserimento della data. Questo pulsante abilita l'inserimento della data + ora. Questo pulsante inserisce la data o la data + ora nel campo selezionato all'interno della griglia. (Se viene selezionata una data differente da quella corrente, viene disabilitata la possibilità di inserire l'ora.)

19 Visualizzatore Manuale di utilizzo Questa finestra di dialogo visualizza il Manuale di utilizzo di Editor_Sdf, e richiede la presenza di Acrobat Reader sul Computer utilizzato. Come fare: Creazione Nuovo Database: Prima impostare tutti i settaggi: Max. Database Size, Max Buffer Size, ecc., o utilizzare quelli di default. Inserire la Password, e selezionare Encrypt Database, se si vuole proteggere il database. Premere il pulsante: Inserire il nome da assegnare al file di Database e selezionare la Directory dove si vuole creare il Database.

20 Creazione Nuova Tabella: Inserire un nome per la nuova Tabella e premere il pulsante: Creazione Nuove Colonne: La prima colonna deve essere una chiave primaria(primary Key). Creazione Colonna Primary Key: Selezionare Data Type = int Selezionare: Il nome della colonna viene inserito in automatico, e sovrascrive quello attualmente presente nella casella di testo Name Premere il pulsante: Aggiungere le colonne desiderate impostando i vari parametri ed aggiungendole alla tabella premendo ogni volta il pulsante: Tutte le colonne aggiunte non sono ancora memorizzate in modo permanente nella tabella, per fare questo premere il pulsante: Modifica Colonne: Selezionare la Tabella che si desidera modificare, e premere il pulsante: Ora è attiva la modalità di modifica Colonne, è possibile modificare le colonne presenti, o aggiungerne di nuove. Modifica Colonne: Selezionare nella Griglia Colonne la riga desiderata, e modificare i vari parametri. (Non è permesso cambiarne il Nome.) (Per cambiare tipo di dato(data Type), bisogna prima eliminare il valore di default se presente,selezionando il pulsante: e salvando la modifica con il pulsante: Dopo è possibile impostare un nuovo Tipo di dato per la colonna selezionata. Aggiunta Colonne: Inserire il Nome per la nuova colonna, impostare il Tipo di dato, ecc. e premere il pulsante: Per salvare le modifiche effettuate alla tabella selezionata premere il pulsante:

21 Questa applicazione utilizza Sql Compact Engine 3.5 a 32 Bit. Questo software è di uso libero e gratuito ed è distribuito così com'è. La alsoftwork non é responsabile per danni o perdite di dati derivanti dalla libera scelta di utilizzare questo software gratuito. Questa applicazione può essere utilizzata e distribuita liberamente, viene distribuita sotto licenza 'Copyleft' pertanto è fatto divieto a chiunque di modificarla, venderla o distribuirla come opera propria. Per la segnalazione di errori riscontrati nel funzionamento di Editor_Sdf inviare una a: alsoftwork@libero.it alsoftwork.altervista.org