FileMaker 9. Guida ODBC e JDBC



Documenti analoghi
FileMaker 8. Installazione dei driver client FileMaker 8 ODBC e JDBC

FileMaker 12. Guida ODBC e JDBC

FileMaker Pro 13. Utilizzo di una Connessione Desktop Remota con FileMaker Pro13

FileMaker Pro 11. Esecuzione di FileMaker Pro 11 su Servizi Terminal

FileMaker 8. Guida per sviluppatori ODBC e JDBC

FileMaker 11. Guida ODBC e JDBC

FileMaker 10. Guida ODBC e JDBC

FileMaker Server 14. Guida alla configurazione dell installazione in rete

SPSS Statistics per Windows - Istruzioni di installazione per (Licenza per utenti singoli)

FileMaker Server 12. Guida alla configurazione dell installazione in rete

Istruzioni di installazione di IBM SPSS Modeler Text Analytics (licenza per sito)

SPSS Inc. Data Access Pack - Istruzioni di installazione per Windows

IBM SPSS Statistics per Windows - Istruzioni di installazione (Licenza per utenti singoli)

Istruzioni di installazione di IBM SPSS Modeler Text Analytics (utente singolo)

Laplink FileMover Guida introduttiva

IBM SPSS Statistics per Windows - Istruzioni di installazione (Licenza per sito)

FileMaker 13. Guida ODBC e JDBC

Manuale per la configurazione di AziendaSoft in rete

IBM SPSS Statistics per Windows - Istruzioni di installazione (Licenza per utenti singoli)

IBM SPSS Statistics per Windows - Istruzioni di installazione (Licenza di rete)

IBM SPSS Statistics per Mac OS - Istruzioni di installazione (Licenza per sito)

Licenza per sito Manuale dell amministratore

Che cos'è un modulo? pulsanti di opzione caselle di controllo caselle di riepilogo

Acronis License Server. Manuale utente

FileMaker 14. Guida ODBC e JDBC

Sharpdesk V3.3. Guida all installazione Versione

Database Manager Guida utente DMAN-IT-01/09/10

Capitolo 4 Pianificazione e Sviluppo di Web Part

Presentation Draw. Guida dell utilizzatore

FPf per Windows 3.1. Guida all uso

Programma di configurazione di reti NetWare

Aggiornamenti Sistema Addendum per l utente

AXWIN6 QUICK INSTALL v.3.0

Gestione delle informazioni necessarie all attività di validazione degli studi di settore. Trasmissione degli esempi da valutare.

11/02/2015 MANUALE DI INSTALLAZIONE DELL APPLICAZIONE DESKTOP TELEMATICO VERSIONE 1.0

ATOLLO BACKUP GUIDA INSTALLAZIONE E CONFIGURAZIONE

1 Introduzione Installazione Configurazione di Outlook Impostazioni manuali del server... 10

Istruzioni di installazione di IBM SPSS Modeler Text AnalyticsServer per Windows

Versione 2.0. Manuale d uso. Software per la gestione. degli applicativi Bticino. TiManager 03/07-01 PC

IBM SPSS Statistics per Windows - Istruzioni di installazione (Licenza di rete)

Installazione e caratteristiche generali 1

FileMaker Server 13. Guida alla configurazione dell'installazione in rete

Guida Google Cloud Print

Printer Driver. Questa guida descrive l installazione dei driver stampante per Windows Vista e Windows XP.

Sharpdesk V3.3. Guida all installazione Versione

Guida Google Cloud Print

Guida all installazione di Easy

Installazione del software Fiery per Windows e Macintosh

FileMaker. Guida all installazione e alle nuove caratteristiche. per FileMaker Pro 8.5 e FileMaker Pro 8.5 Advanced

FileMaker Server 11. Guida alla configurazione dell'installazione in rete

IBM SPSS Statistics - Essentials for R- Istruzioni di installazione per Windows

SCARICO DATI ONETOUCH Verio per EuroTouch Home GUIDA ALL USO

IBM SPSS Statistics per Linux - Istruzioni di installazione (Licenza per sito)

Nokia C110/C111 scheda LAN senza filo Manuale di installazione

Installazione di GFI Network Server Monitor

Software di gestione della stampante

Installazione e utilizzo di Document Distributor 1

IBM SPSS Statistics - Essentials for Python- Istruzioni di installazione per Windows

Outlook Plugin per VTECRM

PASW Statistics per Mac OS - Istruzioni di installazione (Licenza di rete)

FileMaker Server 12. Guida introduttiva

LA GESTIONE DELLE VISITE CLIENTI VIA WEB

Il tuo manuale d'uso. LEXMARK X502N

. A primi passi con microsoft a.ccepss SommarIo: i S 1. aprire e chiudere microsoft access Start (o avvio) l i b tutti i pro- grammi

LaCie Ethernet Disk mini Domande frequenti (FAQ)

Installazione MS SQL Express e utilizzo con progetti PHMI

Benvenuti! Novità di PaperPort 10

Installazione di GFI WebMonitor

Guida all installazione

TOUCH DISPLAY DOWNLOADER MANUALE DI ISTRUZIONI

Guida Google Cloud Print

Istruzioni per l uso della Guida. Icone utilizzate in questa Guida. Istruzioni per l uso della Guida. Software di backup LaCie Guida per l utente

Capitolo 1 Installazione del programma

Guida alla registrazione on-line di un DataLogger

IBM SPSS Statistics - Essentials for Python- Istruzioni di installazione per Windows

Guida alla ricerca e soluzione dei guasti HASP

GUIDA UTENTE WEB PROFILES

SCOoffice Mail Connector for Microsoft Outlook. Guida all installazione Outlook 2002

Sicurezza dei file Le protezioni nei programmi

L accesso ad una condivisione web tramite il protocollo WebDAV con Windows XP

SCOoffice Address Book. Guida all installazione

Abilitazione e uso del protocollo EtherTalk

Guida al backup e aggiornamento del programma MIDAP

Programma per l elaborazione delle buste paga. dei collaboratori domestici VERSIONE /07/2010

Riferimento rapido per l'installazione SUSE Linux Enterprise Server 11 SP1

SolidWorks Education Edition 2012 Istruzioni per l'installazione

IRSplit. Istruzioni d uso 07/10-01 PC

ACCESSO AL SISTEMA HELIOS...

Al giorno d oggi, i sistemi per la gestione di database

Sage Start Archivio file Guida. Dalla versione

BMSO1001. Orchestrator. Istruzioni d uso 02/10-01 PC

IBM SPSS Statistics per Mac OS - Istruzioni di installazione (Licenza per utenti singoli)

GUIDA UTENTE MONEY TRANSFER MANAGER

COME CREARE E COLLEGARSI AD UN DATABASE MICROSOFT SQL SERVER O SUN MYSQL

MANUALE PORTALE UTENTE IMPRENDITORE

Istruzioni per l'installazione e la disinstallazione dei driver della stampante PostScript e PCL per Windows Versione 8

Istruzioni operative instal azione FirmaVerifica3.0 Pag.1 di 27

Lezione 9. Applicazioni tradizionali

Transcript:

FileMaker 9 Guida ODBC e JDBC

2004-2007 FileMaker, Inc. Tutti i diritti riservati. FileMaker, Inc. 5201 Patrick Henry Drive Santa Clara, California 95054 FileMaker è un marchio della FileMaker, Inc., registrato negli Stati Uniti e in altri Paesi; ScriptMaker e il logo della cartella dei file sono marchi della FileMaker, Inc. Tutti gli altri marchi appartengono ai rispettivi proprietari. La documentazione di FileMaker è protetta da copyright. Non è permesso fare copie o distribuire questa documentazione senza previa autorizzazione scritta di FileMaker. È possibile utilizzare la presente documentazione soltanto unitamente a una copia del software FileMaker concessa in licenza. Tutte le persone e le società elencate negli esempi sono fittizie e ogni riferimento a persone o società esistenti è puramente casuale. Gli autori sono elencati nei documenti Riconoscimenti forniti insieme con questo software. I prodotti di terze parti sono citati unicamente a scopi informativi e non costituiscono obbligo o raccomandazione. FileMaker, Inc. non si assume alcuna responsabilità nei confronti delle prestazioni di questi prodotti. Per ulteriori informazioni, visitate il nostro sito Web all indirizzo: www.filemaker.com. Edizione: 01

Sommario Capitolo 1 Introduzione 7 Informazioni su questa guida 7 Utilizzo di un database FileMaker come origine dati 8 Accesso ad un database FileMaker Pro ospitato 8 Limitazioni con strumenti di terze parti 9 Requisiti di rete 9 Aggiornamento di file di versioni precedenti 9 Installazione dei driver correnti 9 Capitolo 2 Installazione dei driver client ODBC e JDBC FileMaker 11 Rispetto dei termini del contratto di licenza 11 Requisiti hardware e software 11 Requisiti per i driver client ODBC (Windows) 11 Requisiti per i driver client ODBC (Mac OS) 11 Requisiti per driver client JDBC 12 Requisiti di rete 12 Installazione del driver client ODBC (Windows) 12 Installazione del driver client ODBC (Mac OS) 13 Installazione del driver client JDBC (Windows e Mac OS) 13 Configurazione dei driver client 14 Operazioni successive 14 Capitolo 3 Uso di ODBC per condividere dati FileMaker 15 Informazioni su ODBC 15 Uso del driver client ODBC 16 Accesso ad un file di database FileMaker 16 Accesso a un file di database FileMaker da un applicazione Windows 17 Specifica delle proprietà del driver client ODBC per un DSN FileMaker (Windows) 17 Verifica dell accesso attraverso ODBC (Windows) 18 Accesso ad un file di database FileMaker da un applicazione Mac OS 19 Configurazione del driver client ODBC (Mac OS) 19 Specifica delle proprietà del driver client ODBC per un DSN FileMaker (Mac OS) 19

4 Guida ODBC e JDBC FileMaker Capitolo 4 Uso di JDBC per condividere dati FileMaker 21 Informazioni su JDBC 21 Uso del driver client JDBC 21 Driver client JDBC 22 Uso di un URL JDBC per collegarsi al database 22 Specificazione delle proprietà del driver nel nome secondario dell URL 24 Verifica accesso tramite JDBC 25 Capitolo 5 Standard supportati 27 Supporto caratteri Unicode 27 Istruzioni SQL 27 Istruzione SELECT 27 Clausole SQL 28 Clausola FROM 29 Clausola WHERE 29 Clausola GROUP BY 29 Clausola HAVING 30 Operatore UNION 30 Clausola ORDER BY 30 Clausola FOR UPDATE 31 Istruzione DELETE 33 Istruzione INSERT 33 Istruzione UPDATE 34 Istruzione CREATE TABLE 35 Istruzione ALTER TABLE 36 Istruzione CREATE INDEX 36 Istruzione DROP INDEX 36 Funzioni aggregate SQL 37 Espressioni SQL 38 Nomi di campo 38 Costanti e letterali 38 Notazione esponenziale/scientifica 39 Operatori numerici 39 Operatori alfabetici 39 Operatori data 39 Operatori relazionali 40 Operatori logici 41 Funzioni 41 Precedenza degli operatori 44 Funzioni di Catalogo ODBC 44 Funzioni Meta Data JDBC 45 Parole chiave SQL riservate 45

Sommario 5 Appendice A Mappatura di campi FileMaker su dati di tipo ODBC 47 Appendice B Mappatura di campi FileMaker su dati di tipo JDBC 49 Appendice C Messaggi di errore ODBC e JDBC 51 Messaggi di errore ODBC 51 Messaggi di errore driver ODBC 51 Messaggi di errore Gestione driver ODBC 51 Messaggi di errore SequeLink Client 51 Messaggi di errore SequeLink Server 52 Messaggi di errore origine dati 52 Messaggi di errore JDBC 52 Messaggi di errore driver JDBC 52 Messaggi di errore SequeLink Server 52 Messaggi di errore origine dati 53 Indice 55

6 Guida ODBC e JDBC FileMaker

Capitolo 1 Introduzione Questa Guida spiega come condividere dati FileMaker con altre applicazioni, usando ODBC (Open Database Connectivity) e JDBC (Java Database Connectivity). Questa Guida spiega inoltre in che modo i driver client ODBC e JDBC, quando usati con FileMaker Pro e FileMaker Server, supportano gli standard industriali per ODBC, JDBC e SQL (Structured Query Language). Per creare e testare le soluzioni di database, si possono utilizzare FileMaker Pro, FileMaker Pro Advanced o FileMaker Server Advanced. È quindi possibile condividere la soluzione di database FileMaker come origine dati con applicazioni compatibili con ODBC e JDBC. È necessario installare i driver ODBC e JDBC FileMaker sulla macchina in cui è installata l applicazione di terze parti. Importante Questa guida descrive l utilizzo del software FileMaker come origine dati. Per le informazioni passo dopo passo relative all utilizzo di FileMaker Pro come applicazione client ODBC, consultare la Guida di FileMaker Pro. La tabella seguente offre una panoramica su come utilizzare ODBC e JDBC con il software FileMaker. Operazione da eseguire Modalità di esecuzione Vedere Usare FileMaker Pro come origine 1. Query SQL Questa guida dati/condividere dati FileMaker Pro 2. JDBC Usare FileMaker Pro come client ODBC/accedere a dati ODBC 1. In modo interattivo attraverso il grafico delle relazioni 2. In modo statico mediante l importazione ODBC o il menu File > Apri. Inoltre, istruzione di script Importa record e istruzione di script Esegui SQL Guida di FileMaker Pro Informazioni su questa guida 1 Per informazioni sull uso di ODBC e JDBC con le versioni precedenti di FileMaker Pro,visitare il sito www.filemaker.it/downloads. 1 Per poter usare questa Guida è necessario avere conoscenze di base sull uso di ODBC e JDBC e sulla costruzione di query SQL. Per informazioni su questi argomenti consultare il materiale di riferimento relativo. 1 In questa guida il termine FileMaker Pro indica sia FileMaker Pro sia FileMaker Pro Advanced, a meno che non vengano descritte caratteristiche specifiche di FileMaker Pro Advanced. Nota È possibile scaricare la documentazione di FileMaker in formato PDF dal sito www.filemaker.it/ downloads. Eventuali aggiornamenti a questo documento sono disponibili anche dal sito Web.

8 Guida ODBC e JDBC FileMaker Utilizzo di un database FileMaker come origine dati ODBC e JDBC sono API (Application Programming Interfaces). Queste API offrono alle applicazioni client un linguaggio comune per interagire con vari servizi di database e origini dati, compresi FileMaker Pro e FileMaker Server Advanced. Tutte le applicazioni che supportano ODBC e JDBC riconoscono un sottogruppo di base di istruzioni SQL. SQL consente di utilizzare altre applicazioni (fogli di calcolo, elaboratori di testi, strumenti per la generazione di resoconti) per visualizzare, analizzare e modificare i dati di FileMaker. SQL viene fatto passare attraverso le interfacce ODBC e JDBC all host FileMaker dell origine dati, eseguendo query come ad esempio SELECT nome, cognome FROM clienti WHERE città='parigi' ed effettuando aggiornamenti come la creazione di un nuovo record con INSERT INTO clienti (nome, cognome) VALUES ('Jane','Smith'). Accesso ad un database FileMaker Pro ospitato FileMaker Server Advanced o FileMaker Pro consentono di ospitare un file di database FileMaker come origine dati, condividendo i dati con altre applicazioni usando ODBC e JDBC. La seguente tabella descrive le operazioni che possono essere effettuate con ogni prodotto FileMaker. Questo prodotto FileMaker Permette FileMaker Server Advanced Fino a 50 connessioni e supporta l accesso locale (stesso computer) e l accesso remoto (sia per middleware, come i server Web, sia per l accesso remoto dei client da applicazioni produttive desktop). FileMaker Pro Fino a cinque connessioni e supporta solo l accesso locale (stesso computer). I componenti plug-in ODBC e JDBC necessari per la condivisione dei dati con altre applicazioni sono installati con FileMaker Server Advanced e FileMaker Pro. Per accedere ad un file di database FileMaker ospitato, installare il driver client ODBC o JDBC corrispondente. Installare il driver client sulla macchina in cui è installata l applicazione di terze parti. Per informazioni sull installazione dei file driver necessari per accedere a un origine dati FileMaker, vedere il capitolo 2, Installazione dei driver client ODBC e JDBC FileMaker. Se la soluzione FileMaker utilizza più di un file di database, tutti i file devono essere sullo stesso computer. Il capitolo 5, Standard supportati, descrive le istruzioni SQL supportate dai driver client ODBC e JDBC quando vengono utilizzati con FileMaker Pro e FileMaker Server Advanced. Importante Se si disattiva la condivisione ODBC/JDBC dopo averla attivata, l origine dati ospitata da FileMaker Server Advanced o FileMaker Pro diventa immediatamente non disponibile. L amministratore del database non ha la capacità di segnalare alle applicazioni client ODBC e JDBC la disponibilità dell origine dati (l amministratore può comunicare soltanto con i client del file di database FileMaker). Non viene segnalato nessun errore; l applicazione client deve notificare agli utenti che l origine dati non è più disponibile e che le transazioni non possono essere completate. Se un applicazione client tenta di connettersi ad un file di database FileMaker non disponibile, viene visualizzato un messaggio che indica che la connessione è fallita.

Capitolo 1 Introduzione 9 Limitazioni con strumenti di terze parti 1 Creazione guidata query Microsoft: in un origine dati FileMaker non è possibile accedere a nomi di colonne o tabelle contenenti caratteri ASCII superiori o doppio byte. Utilizzare invece Microsoft Query e inserire manualmente i caratteri racchiusi tra virgolette doppie. 1 Microsoft Access: in un origine dati FileMaker non è possibile accedere a nomi di colonne o tabelle contenenti caratteri ASCII superiori o doppio byte. Requisiti di rete Se si usa FileMaker Server Advanced per ospitare un file di database FileMaker come origine dati in una rete, è necessaria una rete TCP/IP. FileMaker Pro supporta soltanto l accesso locale (sullo stesso computer). Aggiornamento di file di versioni precedenti Se nelle versioni precedenti a FileMaker Server 5.5 è stato utilizzato LDAC (Local Data Access Companion) oppure RDAC (Remote Data Access Companion) per condividere un file di database, sarà necessario apportare due modifiche. Innanzitutto, è necessario inserire gli utenti in un account con il privilegio esteso Accesso tramite ODBC/JDBC (come parte del set di privilegi dell account). Per ulteriori informazioni sulla condivisione tramite ODBC/JDBC e per la configurazione degli account e dei set di privilegi vedere la Guida di FileMaker Pro. Installazione dei driver correnti Se è stato installato il driver di una versione precedente a FileMaker Server 9 Advanced o FileMaker Pro 9, è necessario disinstallare il driver precedente e installare il driver della versione 9. Per ulteriori informazioni, vedere il capitolo 2, Installazione dei driver client ODBC e JDBC FileMaker. Nota Creare un DSN per ogni file di database FileMaker a cui si desidera accedere come origine dati. Se precedentemente è stato configurato l accesso attraverso un DSN unico, che consente alle tabelle di suddividersi in diversi file di database FileMaker, sarà necessario consolidare queste tabelle in un unico file di database (oppure creare diversi DSN).

10 Guida ODBC e JDBC FileMaker

Capitolo 2 Installazione dei driver client ODBC e JDBC FileMaker Queste istruzioni spiegano come installare i driver necessari per accedere all origine dati FileMaker da applicazioni di terze parti e da applicazioni personalizzate attraverso ODBC (Open Database Connectivity) e JDBC (Java Database Connectivity). I driver client sono disponibili nella cartella \xdbc tramite un installazione separata sul CD di FileMaker o scaricandoli da Internet. Le ultime versioni dei driver client sono anche disponibili sul sito www.filemaker.it/support/technologies. Se il file di database FileMaker verrà ospitato usando FileMaker Server Advanced, rendere i driver client disponibili per gli utenti remoti. Dopo che il driver client necessario è stato installato, è possibile configurarlo per accedere all origine dati FileMaker e costruire query SQL (Structured Query Language) per interagire con i dati. Rispetto dei termini del contratto di licenza I driver client ODBC e JDBC sono le porzioni di driver del software FileMaker che consentono alle applicazioni di terze parti o alle applicazioni personalizzate di accedere ai file FileMaker come origine dati ODBC o JDBC. Requisiti hardware e software Per installare e utilizzare i driver client ODBC e JDBC, è necessario disporre dei seguenti requisiti minimi hardware e software: Requisiti per i driver client ODBC (Windows) 1 Processore Pentium 300 MHz o superiore 1 64 MB di RAM totale per Windows 2000, 128 MB per Windows XP 1 Microsoft Data Access Components (MDAC) 2.8 SP1 1 Windows MDAC 6.0 per Vista Requisiti per i driver client ODBC (Mac OS) 1 Apple G3 o superiore (escluse le schede di aggiornamento G3) 1 128 MB di RAM totale 1 Mac OS X versione 10.3.9 o 10.4 (il software può essere utilizzato con le versioni successive certificate da FileMaker)

12 Guida ODBC e JDBC FileMaker Requisiti per driver client JDBC Le applicazioni che usano JDBC 1.22 API JDBC 2.0 Core API JDBC 2.0 Pacchetto opzionale Per sapere quale versione di Java è in esecuzione sul proprio computer, aprire una finestra di comando (Windows) o la finestra terminale (Mac OS) e digitare java -version. Requisiti di rete Se si accede ad un origine dati FileMaker ospitata su un computer diverso, è necessario accedere alla rete mediante il protocollo TCP/IP. Installazione del driver client ODBC (Windows) Se in precedenza è stato installato il driver client ODBC per Windows, disinstallarlo utilizzando la funzione per Installazione applicazioni prima di installare una versione aggiornata. Installazione del driver client ODBC: Richiedono: JCA API JDK 1.3 JDBC 3.0 API JDK 1.4 o 1.5 Per installare il driver client ODBC è necessario MDAC 2.8 SP1 (disponibile sul sito Internet www.microsoft.com). 1. Nella cartella \xdbc\odbc Client Driver Installer, fare doppio clic su Setup. Si apre la finestra DataDirect SequeLink for ODBC 5.5 InstallShield Wizard. 2. Installare il driver client ODBC seguendo le istruzioni visualizzate sullo schermo. Gli strumenti Data Source SyncTool, Data Source SyncTool Administrator e SequeLink Online Books non sono compresi nell installazione predefinita e non sono necessari per utilizzare il driver client ODBC. Per impostazione predefinita il driver client ODBC viene installato nella seguente cartella: C:\Programmi\DataDirect\slodbc55. Se si desidera è possibile scegliere un altra unità o un altra cartella. 3. Una volta completata l installazione, fare clic su Fine. JDK 1.2 compatibile con Java Virtual Machine (JVM) JDK 1.3 compatibile con JVM JDK 1.3 compatibile con JVM Sono necessarie le seguenti API, fornite con il client SequeLink Java: 1 JDBC 2.0 Pacchetto opzionale 1 JNDI 1.2 1 JTA 1.0.1 Il driver client ODBC, DataDirect 32-BIT SequeLink 5.5, è ora disponibile e permette di configurare l accesso ad un origine dati FileMaker. Nota Se si riscontrano problemi durante l installazione diretta, installare il driver usando Installazione applicazioni in Windows (selezionare il menu Start > Pannello di controllo > Installazione applicazioni).

Capitolo 2 Installazione dei driver client ODBC e JDBC FileMaker 13 Installazione del driver client ODBC (Mac OS) Se in precedenza è stato installato il driver client ODBC per Mac OS, disinstallarlo prima di installare una versione aggiornata. Installazione del driver client ODBC: Dalla cartella /xdbc/odbc Client Driver Installer, copiare il file SequeLink.bundle sul sistema o sulla libreria utente. Se non è presente una cartella /ODBC, crearne una manualmente: Copiare SequeLink.bundle Utilizzare questo percorso del driver Libreria su questa cartella: durante la configurazione: Sistema /Libreria/ODBC /Libreria/ODBC/SequeLink.bundle/Contents/MacOS/ivslk20.dylib Utente /Utenti/<utente>/Libreria/ODBC /Utenti/<utente>/Libreria/ODBC/SequeLink.bundle/Contents/ MacOS/ivslk20.dylib Questo driver client è stato testato con Amministratore ODBC 1.0.1 (disponibile con Mac OS 10.4). Importante Utilizzare Amministratore ODBC insieme al software di gestione del driver ODBC consigliato per l applicazione client specifica. Installazione del driver client JDBC (Windows e Mac OS) Il programma di installazione e il driver client JDBC funzionano sia su Windows sia su Mac OS. È necessario avere l accesso in scrittura alla cartella in cui si installa il driver client JDBC. La cartella che contiene il programma per l installazione, secondo un impostazione predefinita, è la cartella di installazione. Se in precedenza è stato installato il driver client JDBC, disinstallarlo prima di installare una versione aggiornata. Installazione del driver client JDBC: 1. Aprire la cartella \xdbc\jdbc Client Driver Installer e fare doppio clic su sljcinstaller.jar. Si apre la finestra di installazione di DataDirect SequeLink per JDBC 5.5. Nota L ambiente runtime Java deve essere associato ai file di archivio JAR. Ai file di archivio.jar possono essere associate anche altre applicazioni come ad esempio WinZip o Stuffit. In tal caso è possibile che l installazione JDBC non venga avviata. Se la finestra del programma di installazione non si apre, aprire la finestra di comando (Windows) o la finestra terminale (Mac OS) e passare alla cartella del driver client JDBC. Da qui avviare il programma di installazione digitando il seguente comando: java -jar sljcinstaller.jar. 2. Fare clic su Avanti. Leggere il contratto di licenza. 3. Se si accetta il contratto di licenza, selezionare Accetto i termini del contratto di licenza, quindi fare clic su Avanti. Viene visualizzata la finestra delle opzioni di installazione. 4. Selezionare Install Developer s Tools. Gli strumenti comprendono JDBCTest che permette di verificare le connessioni JDBC.

14 Guida ODBC e JDBC FileMaker 5. Immettere una directory d installazione. 1 Windows: inserire un percorso che comprenda il file eseguibile Java (java.exe). 1 Mac OS: inserire /Libreria/Java/Extensions (o un altra posizione compresa nel ClassPath dell applicazione java). 6. Fare clic su Avanti. 7. Confermare le selezioni per l installazione, quindi fare clic su Installa. 8. Una volta completata l installazione, fare clic su Fine. Il driver client JDBC è ora disponibile e permette di configurare l accesso ad un origine dati FileMaker. Configurazione dei driver client Prima di poter usare un applicazione client per accedere ad un origine dati di FileMaker Pro è necessario configurare un driver client per l origine dati. Le impostazioni di configurazione indicano il driver client in uso, la posizione dell origine dati e i dettagli relativi al metodo di connessione che si intende utilizzare. Importante Per configurare un driver client FileMaker, è necessario specificare 2399 come porta. Per ODBC (Windows) è necessario specificare la porta nell Amministrazione origine dati ODBC. Per ODBC (Mac OS) è necessario specificare la porta in Amministratore ODBC. Per JDBC è necessario specificare la porta nell URL JDBC. Per ulteriori informazioni sul driver client ODBC in ambiente Windows, selezionare da Windows il menu Start > Programmi > DataDirect SequeLink for ODBC 5.5 > Driver Help. Nota La guida, fornita da DataDirect Technologies, descrive alcune delle funzioni per usare i driver client ODBC e JDBC per accedere alle origini dati FileMaker. Operazioni successive Dopo aver installato e configurato un driver client è possibile costruire ed eseguire query SQL per accedere all origine dati FileMaker. Talvolta le applicazioni client usano una terminologia diversa per accedere ad un origine dati tramite ODBC. In molte applicazioni vi sono voci di menu quali Get external data o SQL query. Per ulteriori dettagli consultare la documentazione o la Guida fornite con l applicazione.

Capitolo 3 Uso di ODBC per condividere dati FileMaker Utilizzare il driver client ODBC per collegarsi a un origine dati FileMaker da un altra applicazione. L applicazione che usa il driver client ODBC può accedere direttamente ai dati in un file di database FileMaker. 1 Windows: il driver client FileMaker ODBC è DataDirect 32-BIT SequeLink 5.5. 1 Mac OS: il driver client FileMaker ODBC è ivslk20.dylib. Nota È inoltre possibile utilizzare FileMaker Pro come applicazione client che interagisce con i record di un altra origine dati tramite ODBC usando SQL. Per ulteriori informazioni sull accesso a origini dati esterne tramite ODBC vedere la Guida di FileMaker Pro. Informazioni su ODBC ODBC è un API che consente alle applicazioni di accedere ai dati da diversi sistemi di gestione di database. ODBC offre alle applicazioni client un linguaggio comune per interagire con servizi di database e origini dati. Tutte le applicazioni che supportano ODBC riconoscono un sottogruppo comune di istruzioni. SQL permette di usare altre applicazioni (come fogli di calcolo, elaboratori di testo e strumenti per la generazione di resoconti) per visualizzare, analizzare e modificare i dati FileMaker. Per le espressioni, le funzioni e le istruzioni SQL supportate dal driver client ODBC vedere la sezione Capitolo 5, Standard supportati. L applicazione può interagire direttamente con un file di database FileMaker utilizzando il driver client ODBC. Le istruzioni SQL vengono trasmesse all host del file di database FileMaker e i risultati di tali istruzioni vengono rispediti al mittente. Se si usa FileMaker Server Advanced per ospitare un file di database FileMaker come origine dati, il file di database può trovarsi su un altra macchina (la macchina server) collegata alla rete, mentre l applicazione client si trova sul proprio computer (la macchina client). Questa relazione è detta configurazione client/server. Applicazione client Gestione driver Oracle Driver ODBC Driver ODBC SQL Server Driver client ODBC Oracle Microsoft SQL Server FileMaker

16 Guida ODBC e JDBC FileMaker Uso del driver client ODBC È possibile utilizzare il driver client ODBC con qualsiasi applicazione compatibile ODBC. Condividendo il file di database FileMaker come origine dati, è possibile: 1 eseguire stampe unione con Microsoft Word 1 creare grafici con Microsoft Excel 1 spostare dati FileMaker in un DBMS, come Microsoft SQL Server 1 analizzare ulteriormente i dati di FileMaker Pro con strumenti per la generazione di query o resoconti, per creare grafici, generare query mirate ed eseguire analisi specifiche 1 creare un applicazione Microsoft Visual Basic in grado di condividere informazioni con FileMaker Pro Per condividere un file di database FileMaker come origine dati, utilizzare FileMaker Pro per definire gli account che devono avere accesso al file di database. Quindi, controllare l accesso al file di database assegnando set di privilegi agli account, compreso il privilegio esteso di accesso attraverso ODBC/JDBC. Infine, attivare la condivisione dei dati mediante ODBC/JDBC nell applicazione host FileMaker Server Advanced o FileMaker Pro. Per ulteriori dettagli vedere la Guida di FileMaker Pro o FileMaker Server. Importante Il driver client ODBC sostituisce il driver ODBC FileMaker Pro rilasciato con una versione precedente di FileMaker. Se in precedenza è stato configurato l accesso ad un origine dati FileMaker usando il vecchio driver, sarà necessario ridefinire l accesso usando e configurando il nuovo driver. Accesso ad un file di database FileMaker Da un applicazione compatibile ODBC è possibile creare query SQL per accedere ad un file di database FileMaker. Il driver client ODBC deve essere installato sul computer che genera la query SQL. Per accedere ad un file di database FileMaker: 1. In FileMaker Pro, esaminare il set di privilegi assegnato agli account che avranno accesso al file di database. Gli account a cui deve essere consentito l accesso necessitano di un set di privilegi con il privilegio esteso Accesso tramite ODBC/JDBC. 2. Attivare la condivisione dei dati tramite ODBC/JDBC nell applicazione host di FileMaker Server Advanced (mediante Admin Console di FileMaker Server) o FileMaker Pro. Admin Console di FileMaker Server: fare clic su ODBC/JDBC quindi selezionare Attiva ODBC/JDBC. FileMaker Pro: selezionare il menu File > Condivisione > ODBC/JDBC e impostare Condivisione ODBC/JDBC su Attivata. 3. Assicurarsi che il file di database FileMaker a cui si desidera accedere sia ospitato e disponibile. Se la soluzione del database FileMaker utilizza più di un file del database, tutti i file devono essere sullo stesso computer. 4. Connettersi all origine dati FileMaker. 5. Creare ed eseguire una query SQL nell applicazione client. Ogni file di database FileMaker aperto e configurato per l accesso è un origine dati separata (si crea un DSN per ogni file di database FileMaker a cui si desidera accedere come origine dati).

Capitolo 3 Uso di ODBC per condividere dati FileMaker 17 Ogni database può avere una o più tabelle. I campi FileMaker sono rappresentati sotto forma di colonne. Il nome completo del campo, compresi gli eventuali caratteri non alfanumerici, viene visualizzato come nome di colonna. Nota In Windows, Microsoft Access può importare tramite ODBC un numero massimo di 32 campi per volta da un file di database FileMaker. Se il file di database ha più di 32 campi, importarli a gruppi di 32. Accesso a un file di database FileMaker da un applicazione Windows Specifica delle proprietà del driver client ODBC per un DSN FileMaker (Windows) Creare un DSN per ogni file di database FileMaker a cui si desidera accedere come origine dati. Il DSN identifica il driver client ODBC FileMaker, la posizione dell applicazione host e il file di database FileMaker a cui si sta accedendo come origine dati. Per impostare o cambiare le proprietà del driver client ODBC: 1. Aprire il pannello di controllo Amministrazione origine dati ODBC. Nel Pannello di controllo Windows scegliere Strumenti di amministrazione > Origine dati (ODBC). In Windows XP Strumenti di amministrazione appare nella categoria Prestazioni e manutenzione. In Windows Vista Strumenti di amministrazione appare nella categoria Sistema e manutenzione. 2. Fare clic su DSN di sistema. Se è stata impostata un origine dati come DSN utente o DSN su file, fare clic sulla scheda corrispondente. 3. Fare clic su Aggiungi. Nota Se si stanno cambiando le proprietà di un origine dati esistente, selezionare l origine dati, fare clic su Configura e passare al passo passo 6. 4. Scegliere DataDirect 32-BIT SequeLink 5.5 dalla lista dei driver. Se il driver non compare in Amministrazione origine dati ODBC, cercare la voce (Predefinito) della chiave di registro HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\ODBC Drivers utilizzando Regedit (selezionare il menu Start > Esegui > Regedit). I dati per questa voce devono essere (Valore non impostato). Se invece si vede una stringa vuota, fare clic con il tasto destro del mouse su (Predefinito), selezionare Elimina e fare clic su Sì per confermare. Questo ripristina la voce su (Valore non impostato). Disinstallare e reinstallare il driver client ODBC per vederlo nell Amministrazione origine dati ODBC. 5. Fare clic su Fine. Si apre la finestra di dialogo per la configurazione ODBC DataDirect SequeLink, con la scheda Generale selezionata. 6. Per Nome origine dati, digitare un nome significativo per tutti gli altri utenti che accederanno all origine dati FileMaker. Un ulteriore Descrizione è facoltativa. Assicurarsi che l opzione Usa LDAP non sia selezionata. Il driver client ODBC non comprende.dll di traduzione (quindi se si fa clic su Traduci non sarà possibile configurare un traduttore ODBC). 7. Per SequeLink Server Host, inserire il percorso dell origine dati. Se si esegue la connessione ad un file di database FileMaker ospitato da FileMaker Pro sul proprio computer locale, digitare localhost (oppure 127.0.0.1). Se si esegue la connessione ad un file di database FileMaker ospitato da FileMaker Server in rete, digitare l indirizzo IP di FileMaker Server.

18 Guida ODBC e JDBC FileMaker 8. Per Porta SequeLink Server, digitare 2399. Importante Per configurare un origine dati FileMaker, è necessario specificare 2399 come porta SequeLink Server. 9. Per Origine dati server, digitare il nome del file di database FileMaker che si sta usando come origine dati (non digitare l estensione del file). 10. Se è stata attivata la condivisione mediante ODBC/JDBC nell applicazione host, fare clic sul pulsante a destra di Origine dati server per visualizzare i nomi dei file dei database FileMaker aperti al momento tra cui scegliere. Se il nome del database contiene spazi, sostituirli con i caratteri di escape %20. Ad esempio, serverdatasource=my%20database. 11. Fare clic su OK per salvare le informazioni sull origine dati. Se si sta condividendo un altro file di database FileMaker, ritornare al passo passo 3 e configurare il file di database come origine dati. 12. Fare clic su OK per chiudere la finestra di dialogo Amministrazione origine dati ODBC. Verifica dell accesso attraverso ODBC (Windows) Per verificare che il driver client ODBC sia stato configurato correttamente per accedere all origine dati FileMaker: 1. Aprire il pannello di controllo Amministrazione origine dati ODBC. Nel Pannello di controllo Windows scegliere Strumenti di amministrazione > Origine dati (ODBC). In Windows XP Strumenti di amministrazione appare nella categoria Prestazioni e manutenzione. 2. Fare clic su DSN di sistema. Se è stata impostata un origine dati come DSN utente o DSN su file, fare clic sulla scheda corrispondente. 3. Scegliere l origine dati FileMaker configurata. Il nome dell origine dati inserito originariamente verrà visualizzato sotto Nome e DataDirect 32-BIT SequeLink 5.5 sarà il Driver. 4. Fare clic su Configura. Si apre la finestra di dialogo per la configurazione di DataDirect SequeLink. 5. Fare clic su Connessione prova. Viene richiesto di inserire il nome utente FileMaker (in Nome utente database) e la password (in Password database). Se la connessione è OK, viene visualizzato un messaggio per indicare che la connessione di prova è stata effettuata con successo. Se la connessione fallisce: 1 Assicurarsi che il file di database FileMaker sia ospitato e disponibile. 1 Aggiornare o correggere le informazioni sulla connessione. 1 Assicurarsi che il set di privilegi usi un account FileMaker con il privilegio esteso di Accesso tramite ODBC/JDBC. 1 Verificare che per l applicazione host FileMaker Pro o FileMaker Server sia stata configurata la condivisione tramite ODBC/JDBC.

Capitolo 3 Uso di ODBC per condividere dati FileMaker 19 Accesso ad un file di database FileMaker da un applicazione Mac OS Per costruire applicazioni personalizzate utilizzare la versione 3.52.1 delle intestazioni e delle librerie ODBC. Le applicazioni costruite con la versione 3.51 possono non essere in grado di caricare il driver client. Configurazione del driver client ODBC (Mac OS) Configurare il driver client utilizzando Amministratore ODBC insieme al software che gestisce il driver ODBC raccomandato per l applicazione client. Questo driver client è stato testato con Amministratore ODBC 1.0.1 (disponibile con Mac OS 10.4). Nella configurazione del driver client, verrà richiesto di fornire una breve descrizione e il percorso del file driver: Se si è copiato SequeLink.bundle su questa libreria: /Libreria/ODBC /Utenti/<utente>/Libreria/ODBC Utilizzare questo percorso del driver durante la configurazione: /Libreria/ODBC/SequeLink.bundle/Contents/MacOS/ivslk20.dylib /Utenti/<utente>/Libreria/ODBC/SequeLink.bundle/Contents/MacOS/ ivslk20.dylib L Amministratore ODBC permette inoltre di definire, se si desidera, le parole chiave e un percorso per il file Setup, ma il driver client non richiede queste informazioni. Specifica delle proprietà del driver client ODBC per un DSN FileMaker (Mac OS) Creare un DSN per ogni file di database FileMaker a cui si desidera accedere come origine dati. Il DSN identifica il driver client ODBC FileMaker, la posizione dell applicazione host e il file di database FileMaker a cui si sta accedendo come origine dati. Importante Il driver client ODBC per Mac OS non supporta caratteri ASCII superiori, doppio byte o giapponesi nei nomi di database o di tabelle. Se il file di database FileMaker utilizza questi caratteri, creare un secondo database e utilizzare esclusivamente caratteri ASCII per i nomi di file e tabelle. Creare nel secondo database un riferimento all origine dati che contiene i dati nel file del database originale. Condividere entrambi i file con ODBC/JDBC, ma utilizzare il secondo file di database per definire il DSN. Inoltre, è necessario indicare questi valori di parole chiave per il DSN: Parola chiave Host Valore Se si esegue la connessione ad un file di database FileMaker ospitato da FileMaker Pro sul proprio computer locale, digitare localhost (oppure 127.0.0.1). Se si esegue la connessione ad un file di database FileMaker ospitato da FileMaker Server in rete, digitare l indirizzo IP o il nome host di FileMaker Server. Port Digitare 2399. ServerDataSource Digitare il nome del file di database FileMaker che si sta utilizzando come origine dati (non digitare l estensione del file). Se il nome del database contiene spazi, sostituirli con i caratteri di escape %20. Ad esempio, ServerDataDource=MY%20DATABASE. I caratteri doppio byte non sono supportati.

20 Guida ODBC e JDBC FileMaker

Capitolo 4 Uso di JDBC per condividere dati FileMaker I programmatori Java possono usare il driver client JDBC con qualsiasi strumento Rapid Application Development (RAD) per creare visivamente un applicazione o un applet Java che si connetta all origine dati FileMaker. L applicazione o l applet Java che usa il driver client JDBS può accedere direttamente ai dati in un file di database FileMaker. Informazioni su JDBC JDBC è un API Java che esegue istruzioni SQL, il linguaggio standard usato per accedere ai database relazionali. JDBC è un nome e non un acronimo, nonostante si creda comunemente che sia l acronimo di Java Database Connectivity perché è l equivalente Java di ODBC. JDBC è un interfaccia di basso livello, cioè viene usata per richiamare direttamente i comandi SQL. Può essere usata anche come base per strumenti e interfacce di livello superiore. L applicazione o l applet Java può interagire direttamente con il file di database FileMaker usando il driver client JDBC. Le istruzioni SQL vengono trasmesse all host del file di database FileMaker e i risultati di tali istruzioni vengono rispediti al mittente. Se si usa FileMaker Server come host, il file di database FileMaker usato come origine dati può trovarsi su un altro computer (il computer server) connesso alla rete, mentre l applicazione client o l applet Java si trovano sul proprio computer (computer client). Questa relazione è detta configurazione client/server. Applicazione Java Driver JDBC FileMaker Computer client Server database Uso del driver client JDBC È possibile usare il driver client JDBC con un compilatore Java o con uno strumento RAD per effettuare la connessione al database mentre si crea il codice per l applet o l applicazione Java. Una volta creato l applet o l applicazione Java, affinché questi siano in grado di comunicare con il database è necessario che il driver client JDBC sia presente con i file o compreso nel codice. Per utilizzare il driver client JDBC, l applicazione o l applet Java devono registrare il driver nel gestore driver JDBC; inoltre è necessario specificare l URL esatto di JDBC nell applicazione o nell applet. È necessario l URL di JDBC per effettuare la connessione al database.

22 Guida ODBC e JDBC FileMaker Driver client JDBC Il driver client JDBC fornisce supporto parziale per la specifica JDBC 3.0. Le seguenti funzioni non sono supportate da FileMaker: 1 Supporto del punto di salvataggio 1 Recupero di chiavi generate automaticamente 1 Trasferimento di parametri ad un oggetto istruzione richiamabile per nome 1 Supporto cursore aperto 1 Aggiornamenti interni ai dati di oggetti Blob e Clob 1 Recupero e aggiornamento dell oggetto a cui si fa riferimento mediante un oggetto Ref 1 Aggiornamento delle colonne che contengono i tipi di dati BLOB, CLOB, ARRAY e REF 1 Tipo di dati booleano 1 Tipo di dati DATALINK 1 Gruppi di trasformazione e mappatura del tipo 1 Relazione tra JDBC SPI e l architettura Connector Per ulteriori informazioni, visitare il sito www.filemaker.it/support/technologies. Per informazioni sulla compatibilità JDBC e sullo sviluppo di applicazioni JDBC per SequeLink, vedere anche SequeLink Developer s Reference disponibile sul sito www.datadirect.com. Il driver client JDBC è stato testato rispetto a Java Development Kit (JDK) 1.4 e 1.5. È un driver Type 4, un driver Java puro con protocollo originale che converte le chiamate JDBC direttamente nel protocollo di rete usato da FileMaker. Questo tipo di driver offre tutti i vantaggi Java, compresa l installazione automatica (ad esempio, lo scaricamento del driver JDBC con un applet che lo usa). Il driver funziona con JDK 1.3 e Java 2, purché si utilizzino solo chiamate JDBC 1.2 in un ambiente Java 2. La classe del driver e il punto di ingresso principale del driver sono: com.ddtek.jdbc.sequelink.sequelinkdriver Importante Il driver client JDBC sostituisce il driver JDBC FileMaker Pro rilasciato con una versione precedente di FileMaker. Se in precedenza è stato configurato l accesso ad un origine dati FileMaker usando il vecchio driver, sarà necessario ridefinire l accesso usando e configurando il nuovo driver. Uso di un URL JDBC per collegarsi al database A molte risorse Java si accede mediante gli URL (Uniform Resource Locators). Gli URL JDBC vengono utilizzati per identificare il database, in modo che il driver client JDBC possa riconoscere e stabilire una connessione con il database. L URL JDBC è composto da tre parti principali, separate dal segno di due punti: jdbc:<protocollo secondario>:<nome secondario> La prima parte nell URL JDBC è sempre il protocollo JDBC ( jdbc ). Il protocollo secondario è il nome del driver o il nome del meccanismo che supporta più driver. Per il driver client JDBC, il protocollo secondario è sequelink. Il nome secondario è l indirizzo IP della macchina che ospita l origine dati FileMaker.

Capitolo 4 Uso di JDBC per condividere dati FileMaker 23 Registrazione del driver client JDBC e connessione ad un origine dati FileMaker (un esempio) Di seguito viene illustrato uno snippet di un applicazione JDBC che: 1. Registra il driver client JDBC nel gestore di driver JDBC. 2. Stabilisce una connessione con l origine dati FileMaker (l URL JDBC è jdbc:sequelink:// 17.184.17.170:2399). 3. Restituisce codici di errore. import java.sql.*; class FMPJDBCTest { public static void main(string[ ] args) { // registra il driver client JDBC try { Driver d = (Driver)Class.forName("com.ddtek.jdbc.sequelink.SequeLinkDriver").newInstance(); } catch(exception e) { System.out.println(e); } // stabilisce una connessione con FileMaker Connection con; try { con = DriverManager.getConnction("jdbc:sequelink://17.184.17.170:2399; user=some user;password=some password;serverdatasource=database"); } catch(exception e) + ";serverdatasource=" + dbname{ System.out.println(e); } // avviso connessione + ";serverdatasource=" + dbname SQLWarning warning = null; try { warning = con.getwarnings(); if (warning == null) { System.out.println("No warnings"); return; } while (warning!= null) { System.out.println("Warning: "+warning); warning = warning.getnextwarning(); } } catch (Exception e) { } Sysem.out.println(e); } }þ Nota Questo esempio non è stato ideato per essere compilato.

24 Guida ODBC e JDBC FileMaker Specificazione delle proprietà del driver nel nome secondario dell URL Specificare le proprietà del driver (nome utente e password) nel nome secondario dell URL JDBC. Si tratta di proprietà che possono essere passate alla connessione quando si richiama il metodo DriverManager.getConnection mediante il parametro Proprietà. 1 utente: un account nel file di database FileMaker che usa un set di privilegi con il privilegio esteso Accesso tramite ODBC/JDBC 1 password: la password per l account nel file di database FileMaker Connessione URL JDBC di base Formato: jdbc:sequelink://<indirizzo IP host sequelink>:<porta> Questo è l URL per connettersi al file di database FileMaker senza password. Il numero di porta sarà sempre 2399 (non è possibile spostare la condivisione JDBC ad una porta diversa). Se si esegue la connessione URL JDBC dallo stesso computer in cui è situato il file, è possibile usare jdbc:sequelink://localhost:2399 Esempio: jdbc:sequelink://17.184.17.170:2399 Connessione URL JDBC con nome utente e password definiti nell URL Formato: jdbc:sequelink://<indirizzo IP host sequelink>:<porta>;user=<nomeutente>;password=<password> Esempio: jdbc:sequelink://17.184.17.170:2399;user=phil;password=jsp Connessione URL JDBC con il nome del database specificato nell URL Formato: jdbc:sequelink://<indirizzo IP host sequelink>:<porta>; serverdatasource=<nomedatabase> Esempio: jdbc:sequelink://17.184.17.170:2399;serverdatasource=publications Se il nome del database contiene spazi, sostituirli con i caratteri di escape %20. Esempio: jdbc:sequelink://17.184.17.170:2399;serverdatasource=my%20database

Capitolo 4 Uso di JDBC per condividere dati FileMaker 25 Connessione URL JDBC con il nome del database, il nome utente e la password specificati nell URL Formato 1 (utilizzando nome utente e password): jdbc:sequelink://<indirizzo IP host sequelink>:<porta>;serverdatasource=<nomedatabase>; DBUser=<nomeutentedatabase>; DBPassword=<passworddatabase> Formato 2 (usando nome utente e password host): jdbc:sequelink://<indirizzo IP host sequelink>:<porta>;serverdatasource=<nomedatabase>;huser=<nomeutente>;hpasswor d=<password> Se la soluzione FileMaker utilizza molti file di database FileMaker, creare un ulteriore file di database che contenga tutti i riferimenti necessari alle origini dati esterne, alle ricorrenze tabella e alle relazioni per la soluzione. Quindi definire questo file di database aggiuntivo come origine dati nell URL JDBC. Tutti i file di database FileMaker devono essere sullo stesso computer. Nota La crittografia SSL (Secure Socket Layer) non è supportata. Per creare una soluzione JDBC più sicura, configurare un ambiente come ad esempio.asp o.jsp, dove il server Web esegue l hosting tramite https e comunica con il file di database FileMaker protetto da un firewall. Verifica accesso tramite JDBC Al momento dell installazione del driver client JDBC viene offerta la possibilità di installare JDBCTest per verificare più facilmente le connessioni. Durante l installazione del driver client JDBC, selezionare Install Developer s Tools per installare JDBCTest. Per ulteriori informazioni, vedere Installazione del driver client JDBC (Windows e Mac OS) a pagina 13. Durante la verifica dell accesso ad un file di database FileMaker tramite JDBC, assicurarsi che: 1 Il file di database FileMaker sia ospitato e disponibile. 1 L account FileMaker utilizzi un set di privilegi con il privilegio esteso di Accesso tramite ODBC/JDBC. 1 Per l applicazione host FileMaker Pro o FileMaker Server Advanced sia stata configurata la condivisione tramite ODBC/JDBC. Per condividere un file di database FileMaker come origine dati, utilizzare FileMaker Pro per definire gli account che devono avere accesso al file di database. Quindi, controllare l accesso al file di database assegnando set di privilegi agli account, compreso il privilegio esteso di accesso attraverso ODBC/JDBC. Infine, attivare la condivisione dei dati mediante ODBC/JDBC nell applicazione host FileMaker Server Advanced o FileMaker Pro. Per ulteriori informazioni, vedere la Guida di FileMaker Pro. 1 La registrazione del driver client JDBC e l URL JDBC siano corretti (il driver può essere incluso nell applicazione Java o situato sul computer client). Per ulteriori informazioni sull utilizzo di JDBC per condividere i dati FileMaker, visitare il sito www.filemaker.it/ support/technologies.

26 Guida ODBC e JDBC FileMaker

Capitolo 5 Standard supportati In questo capitolo sono descritti le istruzioni e i costrutti SQL supportati dai driver client ODBC e JDBC di FileMaker. Utilizzare i driver client per accedere a una soluzione di database FileMaker da un applicazione compatibile con ODBC o JDBC. La soluzione di database FileMaker può essere ospitata da FileMaker Pro o FileMaker Server Advanced. Il driver client ODBC supporta ODBC 3.5 livello 1 con alcune funzioni del livello 2. Il driver client JDBC fornisce supporto parziale per la specifica JDBC 3.0. Per ulteriori informazioni, visitare il sito www.filemaker.it/support/technologies e consultare il SequeLink Developer s Reference disponibile sul sito www.datadirect.com. I driver client ODBC e JDBC supportano la conformità SQL-92 entry-level, con alcune funzioni intermedie SQL-92. Supporto caratteri Unicode I driver client ODBC e JDBC supportano le API Unicode. Tuttavia, se si sta creando un applicazione personalizzata che usa i driver client, usare ASCII per i nomi dei campi, i nomi delle tabelle e i nomi dei file (in caso venissero utilizzati strumenti o applicazioni di query non Unicode). Nota Per inserire e recuperare i dati Unicode utilizzare SQL_C_WCHAR (il tipo di dati SQL_C_BINARY non è supportato). Istruzioni SQL I driver client ODBC e JDBC supportano le seguenti istruzioni SQL: SELECT (vedere di seguito) DELETE (pagina 33) INSERT (pagina 33) UPDATE (pagina 34) CREATE TABLE (pagina 35) ALTER TABLE (pagina 36) CREATE INDEX (pagina 36) DROP INDEX (pagina 36) I driver client supportano anche la mappatura dei dati di tipo FileMaker su dati di tipo ODBC SQL e JDBC SQL. Per informazioni sulle conversioni dei tipi di dati vedere appendice A, Mappatura di campi FileMaker su dati di tipo ODBC e appendice B, Mappatura di campi FileMaker su dati di tipo JDBC. Per ulteriori informazioni sulla creazione di query SQL, consultare un manuale di terze parti. Nota I driver client ODBC e JDBC riconoscono solo la prima ripetizione in un campo multiplo. Inoltre, i driver non supportano portali in FileMaker Pro. Istruzione SELECT Utilizzare l istruzione SELECT per specificare le colonne richieste. Far seguire l istruzione SELECT dalle espressioni di colonna (simili ai nomi di campo) che si desidera recuperare, ad esempio cognome). Le espressioni possono includere operazioni matematiche o manipolazioni di stringhe, ad esempio STIPENDIO * 1.05.

28 Guida ODBC e JDBC FileMaker L istruzione SELECT può utilizzare varie clausole: SELECT [DISTINCT] {* espressione_colonna [[AS] alias_colonna],...} FROM nome_tabella [alias_tabella],... [ WHERE espr1 operatore_rel espr2 ] [ GROUP BY {espressione_colonna,...} ] [ HAVING espr1 operatore_rel espr2 ] [ UNION [ALL] (SELECT..). ] [ ORDER BY {espressione_ordinamento [DESC ASC]},... ] [ FOR UPDATE [OF {espressione_colonna,...}] ] Gli elementi racchiusi tra parentesi sono facoltativi. Nota Le istruzioni SELECT* su database più grandi e SELECT che utilizzano alias di tabella o letterali nella lista di proiezione potrebbero non funzionare correttamente. Per evitare possibili confusioni non inserire caratteri jolly e specificare i nomi di tabelle e colonne senza alias. alias_colonna può essere utilizzato per assegnare alla colonna un nome più descrittivo, o per abbreviare il nome di una colonna più lunga. Ad esempio per assegnare l alias settore alla colonna sett: SELECT sett AS settore FROM dip Davanti ai nomi dei campi possono essere aggiunti il nome della tabella o l alias della tabella. Ad esempio, EMP.LAST_NAME o ECOGNOME, dove E è l alias della tabella EMP (dip). L operatore DISTINCT può precedere la prima espressione di colonna. Questo operatore elimina le righe doppie dal risultato di una query. Ad esempio: SELECT DISTINCT sett FROM dip Clausole SQL I driver client ODBC e JDBC supportano le seguenti clausole SQL. Utilizzare questa clausola SQL FROM (vedere di seguito) WHERE (pagina 29) GROUP BY (pagina 29) HAVING (pagina 30) UNION (pagina 30) ORDER BY (pagina 30) FOR UPDATE (pagina 31) Per Indicare le tabelle utilizzate nell istruzione SELECT. Specificare le condizioni che i record devono soddisfare per essere recuperati, come nel caso di una richiesta di ricerca di FileMaker Pro. Specificare i nomi di uno o più campi in base a cui raggruppare i valori restituiti. Questa clausola viene utilizzata per restituire una serie di valori aggregati tramite la restituzione di una riga per ciascun gruppo, come nel caso di un riassunto parziale di FileMaker Pro. Specificare le condizioni per i gruppi di record, ad esempio per visualizzare solo i settori per cui l importo complessivo degli stipendi è superiore a 200.000 Euro. Questa clausola è valida solo se è già stata definita una clausola GROUP BY. Combinare i risultati di due o più istruzioni SELECT. Specificare l ordinamento dei record. Per eseguire gli aggiornamenti o le eliminazioni nella posizione attraverso i cursori SQL Nota Se si vogliono recuperare i dati da una tabella senza colonne, l istruzione SELECT non viene eseguita.

Capitolo 5 Standard supportati 29 Clausola FROM La clausola FROM indica le tabelle che vengono utilizzate nell istruzione SELECT. Il formato è: FROM nomi_tabelle [alias_tabella] nomi_tabelle può essere un nome di tabella o più nomi di tabella semplici nella directory di lavoro corrente oppure nomi di percorsi completi. alias_tabella può essere utilizzato per assegnare alla tabella un nome più descrittivo o per abbreviare un nome di tabella lungo. Davanti ai nomi dei campi possono essere aggiunti il nome della tabella o l alias della tabella. Ad esempio, nel caso di una tabella FROM dipendente E, è possibile indicare il campo COGNOME come E.COGNOME. Gli alias di tabella devono essere utilizzati se l istruzione SELECT unisce una tabella a se stessa. Ad esempio: SELECT * FROM dipendente E, dipendente F WHERE E.id_manager = F.id_dipendente Il segno uguale (=) comprende soltanto le righe corrispondenti nei risultati. Per unire più di una tabella ed eliminare tutte le righe che non hanno righe corrispondenti in entrambe le tabelle di origine, è possibile usare INNER JOIN. Ad esempio: SELECT* FROM Venditori INNER JOIN Dati_Vendite ON Venditori.ID_Venditore = Dati_Vendite.ID_Venditore Nota OUTER JOIN non è supportato attualmente. Clausola WHERE La clausola WHERE specifica le condizioni che i record devono soddisfare per essere recuperati. La clausola WHERE contiene le condizioni nella forma: WHERE espr1 operatore_rel espr2 espr1 e espr2 possono essere nomi di campo, valori costanti o espressioni. operatore_rel è l operatore relazionale che collega le due espressioni. Ad esempio, la seguente istruzione SELECT recupera i nomi dei dipendenti con stipendio uguale o superiore a 20.000 Euro. SELECT cognome,nome FROM dip WHERE stipendio >= 20000 Nota Se si utilizzano nomi completamente qualificati nella lista (proiezione) SELECT, è necessario utilizzare anche nomi completamente qualificati nella clausola WHERE correlata. Clausola GROUP BY La clausola GROUP BY specifica i nomi di uno o più campi in base a cui raggruppare i valori restituiti. Questa clausola viene utilizzata per restituire un gruppo di valori aggregati. Ha il seguente formato: GROUP BY espressioni_colonna espressioni_colonna deve corrispondere all espressione della colonna utilizzata nella clausola SELECT. Un espressione di colonna può essere costituita da uno o più nomi di campi della tabella di database separati da virgole, oppure da una o più espressioni separate da virgole.