FileMaker 8. Guida per sviluppatori ODBC e JDBC

Transcript

1 FileMaker 8 Guida per sviluppatori ODBC e JDBC

2 Filemaker, Inc. Tutti i diritti riservati. FileMaker, Inc Patrick Henry Drive Santa Clara, California FileMaker è un marchio di FileMaker, Inc., registrato negli Stati Uniti e in altri Paesi. ScriptMaker e il logo della cartella di file sono marchi di FileMaker, Inc. 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 nel documento Riconoscimenti fornito insieme con questo software. Per ulteriori informazioni, visitare il sito Web all indirizzo Edizione: 01

3 Sommario Capitolo 1 Introduzione 7 Informazioni su questa guida 7 Utilizzo di ODBC e JDBC con FileMaker 8 Uso di un file di database FileMaker come origine dati 8 Requisiti di rete 9 Uso di FileMaker Pro come applicazione client 9 Aggiornamento di file di versioni precedenti 10 Se un file di database FileMaker è stato condiviso in precedenza come origine dati 10 Se FileMaker Pro è stato usato come client per accedere ad un origine dati 10 Capitolo 2 Uso di ODBC per condividere dati FileMaker 11 Informazioni su ODBC 11 Uso del driver client ODBC 12 Accesso a un file di database FileMaker - introduzione 13 Accesso a un file di database FileMaker da un applicazione Windows 14 Installazione del driver client ODBC (Windows) 14 Specifica delle proprietà del driver client ODBC per un DSN FileMaker (Windows) 14 Verifica dell accesso attraverso ODBC (Windows) 15 Accesso ad un file di database FileMaker da un applicazione Mac OS 16 Installazione del driver client ODBC (Mac OS) 16 Configurazione del driver client ODBC (Mac OS) 16 Specifica delle proprietà del driver client ODBC per un DSN FileMaker (Mac OS) 17 Verifica dell accesso attraverso ODBC (Mac OS) 17 Capitolo 3 Uso di JDBC per condividere dati FileMaker 19 Informazioni su JDBC 19 Uso del driver client JDBC 19 Installazione del driver client JDBC 20 Driver client JDBC 20 Uso di un URL JDBC per collegarsi al database 20 Specificazione delle proprietà del driver nel nome secondario dell URL 22 Verifica accesso tramite JDBC 23

4 4 Guida per sviluppatori JDBC e ODBC FileMaker Capitolo 4 Standard supportati 25 Supporto caratteri Unicode 25 Istruzioni e clausole SQL 25 Istruzione SELECT 25 Istruzione DELETE 29 Istruzione INSERT 29 Istruzione UPDATE 30 Istruzione CREATE TABLE 31 Istruzione ALTER TABLE 31 Istruzione CREATE INDEX 32 Istruzione DROP INDEX 32 Clausola FROM 33 Clausola WHERE 33 Clausola GROUP BY 33 Clausola HAVING 34 Operatore UNION 34 Clausola ORDER BY 35 Clausola FOR UPDATE 35 Funzioni aggregate SQL 35 Espressioni SQL 36 Nomi di campo 36 Costanti e letterali 37 Notazione esponenziale/scientifica 37 Operatori numerici 38 Operatori alfabetici 38 Operatori data 38 Operatori relazionali 39 Operatori logici 40 Funzioni 41 Precedenza degli operatori 43 Funzioni di Catalogo ODBC 44 Funzioni Meta Data JDBC 44

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

6 6 Guida per sviluppatori JDBC e ODBC FileMaker

7 Capitolo 1 Introduzione Benvenuti alla Guida per sviluppatori ODBC e JDBCdi FileMaker. 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 supportano gli standard industriali per ODBC, JDBC e SQL (Structured Query Language), quando vengono utilizzati con FileMaker Pro e FileMaker Server Advanced. È possibile utilizzare FileMaker Pro, FileMaker Pro Advanced o FileMaker Server Advanced, per creare e testare la soluzione di database. È quindi possibile condividere la soluzione FileMaker come origine dati con applicazioni compatibili con ODBC e JDBC, oppure accedere ad altre origini dati ODBC usando la propria soluzione FileMaker come applicazione client. Informazioni su questa guida 1 Questo documento contiene le informazioni su come accedere ai dati e su come condividerli usando ODBC e JDBC solo con FileMaker Pro 8, FileMaker Pro 8 Advanced e FileMaker Server 8 Advanced. Per informazioni sull uso di ODBC e JDBC con le versioni precedenti di FileMaker Pro scaricare la documentazione relativa dal sito 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 Per informazioni dettagliate sulle funzioni di FileMaker Pro, tra cui l accesso ad altre origini dati tramite ODBC, consultare la Guida di FileMaker Pro. 1 Nella documentazione di FileMaker Pro l espressione pubblicazione sul Web viene utilizzata per indicare i database ai quali gli utenti possono accedere via Internet o Intranet usando un browser Web. 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. 1 In questa Guida il termine FileMaker Server indica FileMaker Server 8 Advanced, che permette di condividere file di database FileMaker con altre applicazioni mediante ODBC e JDBC. Importante È possibile scaricare i file PDF della documentazione di FileMaker 8 da Anche eventuali aggiornamenti a questa documentazione sono disponibili sul sito

8 8 Guida per sviluppatori JDBC e ODBC FileMaker Utilizzo di ODBC e JDBC con FileMaker 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. Tutte le applicazioni che supportano ODBC e JDBC riconoscono un sottogruppo base di istruzioni SQL. Lavorando con SQL, è possibile 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'). Uso di un file di database FileMaker come origine dati È possibile utilizzare FileMaker Server per ospitare un file di database FileMaker come origine dati, condividendo i dati con altre applicazioni tramite ODBC e JDBC. Filemaker Server consente 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). È possibile utilizzare FileMaker Pro per ospitare un file di database FileMaker come origine dati, condividendo i dati con applicazioni client tramite ODBC e JDBC. FileMaker Pro consente fino ad un massimo di cinque connessioni e supporta soltanto l accesso locale (sullo stesso computer). Il componente plug-in xdbc di cui si ha bisogno per condividere i dati con le altre applicazioni, è installato automaticamente con FileMaker Server e FileMaker Pro. Per accedere ad un file di database FileMaker ospitato, è necessario installare il corrispondente driver client ODBC o JDBC. I driver client possono essere installati con un altro programma sul CD di FileMaker nella cartella \xdbc. È anche possibile scaricare le versioni aggiornate dei driver client e la documentazione di FileMaker 8 in formato PDF dal sito Se il file di database FileMaker viene ospitato usando FileMaker Server, rendere i driver client disponibili per gli utenti remoti. Se la soluzione del database FileMaker utilizza più di un file del database, tutti i file devono essere sullo stesso computer. Talvolta le applicazioni client usano una terminologia diversa per accedere ad un origine dati. 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 4, Standard supportati, descrive le istruzioni SQL supportate dai driver client ODBC e JDBC quando vengono utilizzati con FileMaker Pro e FileMaker Server. Per ulteriori informazioni sulla creazione di query SQL, consultare un manuale di terze parti.

9 Capitolo 1 Introduzione 9 Importante Se si disattiva la condivisione ODBC/JDBC dopo averla attivata, l origine dati ospitata da FileMaker Server 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. Se il file del database FileMaker è ospitato su Mac OS X 10.3, riavviare FileMaker Pro o FileMaker Server prima di riattivare la condivisione ODBC/JDBC (non è necessario riavviarli in Mac OS X 10.4). Vedere la guida Installazione dei driver client ODBC e JDBC FileMaker per installare i file dei driver necessari per accedere all origine dati FileMaker. Limitazioni con strumenti di terze parti Installazione guidata Microsoft Query 1 In un origine dati FileMaker non è possibile accedere a nomi di colonne o tabelle contenenti caratteri ASCII superiori o a doppio byte. Utilizzare invece Microsoft Query e inserire manualmente i caratteri racchiusi tra virgolette doppie. Microsoft Access 1 In un origine dati FileMaker non è possibile accedere a nomi di colonne o tabelle contenenti caratteri ASCII superiori o a doppio byte. 1 Non è possibile collegarsi ad un origine dati FileMaker; tuttavia, è possibile importarla. Requisiti di rete Se si usa FileMaker Server 8 per ospitare un file di database FileMaker come origine dati in una rete, è necessaria una rete TCP/IP. FileMaker Pro 8 supporta soltanto l accesso locale (sullo stesso computer). Uso di FileMaker Pro come applicazione client È possibile usare FileMaker Pro come applicazione client ODBC, che interagisce con origini dati sullo stesso computer o in una rete. Limitazioni con strumenti di terze parti Microsoft SQL Server 1 Se si esportano dati decimali, dati a virgola mobile, dati valutari o dati numerici in un file di database FileMaker, nel database deve essere selezionata l opzione del campo ad immissione automatica Valore calcolato. Questa riduce a zero il numero di posizioni decimali utilizzando la funzione Tronca (nome campo;0). Se si deseleziona l opzione nel database creato e si ripete quindi l esportazione, l opzione del campo ad immissione automatica rimane deselezionata.

10 10 Guida per sviluppatori JDBC e ODBC FileMaker Aggiornamento di file di versioni precedenti FileMaker Pro 8 può aprire i file creati con versioni precedenti di FileMaker. Per informazioni vedere la guida Conversione di database FileMaker da versioni precedenti. Nota FileMaker Server 8 può ospitare i file dei database di FileMaker Pro 8 e di FileMaker Pro 7v3. Filemaker Server 8 non può ospitare o convertire le versioni precedenti dei file di database FileMaker Pro. Se un file di database FileMaker è stato condiviso in precedenza come origine dati Se nelle precedenti versioni è stato utilizzato LDAC (Local Data Access Companion) o 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). Quindi è necessario abilitare la condivisione ODBC/JDBC sull host FileMaker Server o FileMaker Pro: FileMaker Pro (Windows): Scegliere il menu Modifica > Condivisione > ODBC/JDBC e impostare la Condivisione ODBC/JDBC su Attiva. FileMaker Pro (Mac OS): Selezionare il menu di FileMaker Pro > Condivisione > ODBC/JDBC e impostare Condivisione ODBC/JDBC su Attiva. 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. Nota Nelle versioni precedenti di FileMaker Server e FileMaker Pro, per configurare un driver per l accesso tramite ODBC era sufficiente creare un solo DSN (Data Source Name) per l applicazione host. Il DSN unico consentiva di accedere a qualsiasi file di database FileMaker come origine dati. A partire da FileMaker Server 7 e FileMaker Pro 7, è necessario 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). Se FileMaker Pro è stato usato come client per accedere ad un origine dati I driver configurati per accedere all origine dati dovrebbero ancora funzionare. Vedere odbc per i collegamenti con i produttori di terze parti che forniscono i driver aggiornati. Inoltre, il sistema operativo Windows comprende alcuni driver client, come il driver SQL Server. Importante Su Mac OS, i driver iodbc OpenLink sono in conflitto con quelli forniti in versioni precedenti di FileMaker. Se si installano i driver iodbc OpenLink non è più possibile utilizzare i driver Text, Oracle o SQL Server forniti con le versioni precedenti di FileMaker Pro. Per ulteriori dettagli sull uso di FileMaker Pro per accedere ad altre origini dati tramite ODBC vedere la Guida di FileMaker Pro.

11 Capitolo 2 Uso di ODBC per condividere dati FileMaker Utilizzare il driver client ODBC per collegarsi ad un origine dati di FileMaker da un altra applicazione. L applicazione che usa il driver client ODBC può accedere direttamente ai dati in un file di database FileMaker. In Windows, il driver client FileMaker ODBC è DataDirect 32-BIT SequeLink 5.4. In Mac OS, il driver client ODBC FileMaker è ivslk18.dylib. È inoltre possibile utilizzare FileMaker Pro come applicazione client che interagisce con i record di un altra origine dati tramite ODBC usando SQL. Per ulteriori dettagli sull accesso ad un origine dati tramite ODBC, vedere la Guida 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 i fogli elettronici, gli elaboratori di testo e gli 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 il capitolo 4, 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 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.

12 12 Guida per sviluppatori JDBC e ODBC FileMaker Componenti ODBC Applicazione client Driver Manager Oracle Driver ODBC Driver ODBC SQL Server Driver client ODBC Oracle Microsoft SQL Server 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 dovranno 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 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.

13 Capitolo 2 Uso di ODBC per condividere dati FileMaker 13 Accesso a un file di database FileMaker - introduzione 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 (via FileMaker Server Admin) o FileMaker Pro. FileMaker Server Admin (Windows): Scegliere il menu Azione > Proprietà scheda Client > fare clic su Attiva Servizi client, quindi selezionareconsenti connessioni ODBC e JDBC. FileMaker Server Admin (Mac OS): Fare clic sul pulsante Configura, poi fare clic sulla scheda Client, quindi selezionare Consenti connessioni ODBC e JDBC. FileMaker Pro (Windows): Scegliere il menu Modifica > Condivisione > ODBC/JDBC e impostare la Condivisione ODBC/JDBC su Attiva. FileMaker Pro (Mac OS): Selezionare il menu di FileMaker Pro > Condivisione > ODBC/JDBC e impostare Condivisione ODBC/JDBC su Attiva. 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. 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. 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). 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. Importante Se il file del database FileMaker è ospitato su Mac OS, i driver client non possono accedere a nomi di database o di tabelle che contengono caratteri ASCII superiori, a doppio byte o giapponesi. 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 al file 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.

14 14 Guida per sviluppatori JDBC e ODBC FileMaker Accesso a un file di database FileMaker da un applicazione Windows Installazione del driver client ODBC (Windows) Il driver client ODBC può essere installato con un programma separato, disponibile nel CD della Pubblicazione immediata Web FileMaker Server e nel CD FileMaker Pro nella cartella \xdbc\odbc Client Driver Installer. È inoltre possibile scaricare l ultima versione del driver client ODBC e i file PDF della documentazione ODBC FileMaker da Per le istruzioni di installazione, vedere Installazione dei driver client ODBC e JDBC FileMaker, disponibile come documento PDF sul CD nella cartella FileMaker Pro \xdbc\documentazione elettronica e nella cartella \Italiano Extra\Documentazione elettronica dove è stato installato FileMaker Server. 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 (nelle versioni precedenti di FileMaker Server e FileMaker Pro, si creava soltanto un DSN per tutti i file di database FileMaker ospitati dall applicazione). Il DSN identifica il driver client ODBC FileMaker, l applicazione host (FileMaker Server o FileMaker Pro) 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. 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. Se si stanno modificando le proprietà di un origine dati esistente, selezionare l origine dati, fare clic su Configura e passare al punto Scegliere DataDirect 32-BIT SequeLink 5.4 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 driver 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 del 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).

15 Capitolo 2 Uso di ODBC per condividere dati FileMaker 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 ). Se si esegue la connessione ad un file di database FileMaker ospitato da FileMaker Server in rete, digitare l indirizzo IP di FileMaker Server. 8. Per Porta SequeLink Server, digitare Per Origine dati server, digitare il nome del file del database FileMaker che si sta utilizzando come origine dati (non digitare l estensione del file). Se è stata attivata la condivisione mediante ODBC/JDBC nell applicazione host FileMaker Pro o FileMaker Server, fare clic sul pulsante a destra di Origine dati server per visualizzare i nomi dei file di database FileMaker correntemente aperti tra i quali si può scegliere. Se il nome del database contiene spazi, sostituirlo con i caratteri di escape %20. Ad esempio, serverdatasource=my%20database. 10. Fare clic su OK per salvare le informazioni sull origine dati. Se si sta condividendo un altro file di database FileMaker, ritornare al passo 3 e configurare il file di database come origine dati. 11. Fare clic su OK per chiudere la finestra di dialogo Amministrazione origine dati ODBC. Importante Per configurare un origine dati FileMaker, è necessario specificare 2399 come porta SequeLink Server. Verifica dell accesso attraverso ODBC (Windows) Per verificare che il driver client ODBC sia stato configurato correttamente per l accesso all origine dati di 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.4 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).

16 16 Guida per sviluppatori JDBC e ODBC FileMaker 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. Accesso ad un file di database FileMaker da un applicazione Mac OS Per costruire applicazioni personalizzate utilizzare la versione delle intestazioni e delle librerie iodbc. Le applicazioni costruite con la versione 3.51 possono non essere in grado di caricare il driver client. Installazione del driver client ODBC (Mac OS) Il driver client ODBC può essere installato con un programma separato, disponibile nel CD della Pubblicazione Web Immediata in FileMaker Server e nel CD FileMaker Pro nella cartella \xdbc\odbc Client Driver. È inoltre possibile scaricare l ultima versione del driver client ODBC e i file PDF della documentazione ODBC FileMaker da Per installare il driver client ODBC, copiare il file SequeLink.bundle sulla libreria di sistema o su quella utente. Se non si ha una cartella /ODBC, crearla manualmente: Libreria Sistema Utente Copiare SequeLink.bundle su questa cartella: /Libreria/ODBC /Utenti/<utente>/Libreria/ODBC Per ulteriori informazioni, vedere Installazione dei driver client ODBC e JDBC FileMaker, disponibile sul CD nella cartella FileMaker Pro \xdbc\documentazione elettronica e nella cartella \Italiano Extra\Documentazione elettronica in cui è stato installato FileMaker Server. Configurazione del driver client ODBC (Mac OS) Configurare il driver client utilizzando ODBC Administrator insieme al software che gestisce il driver iodbc raccomandato per l applicazione client. Se è necessario OpenLink ODBC Administrator, questo può essere scaricato insieme a ODBC-JDBC Lite Bridge disponibile sul sito web OpenLink. Il driver client è stato testato con i seguenti Amministratori ODBC: 1 OpenLink ODBC Administrator (disponibile dal software OpenLink) 1 Apple ODBC Administrator (disponibile con Mac OS 10.3)

17 Capitolo 2 Uso di ODBC per condividere dati FileMaker 17 Nel configurare il driver client sarà richiesta una breve descrizione e il percorso per il 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/ivslk18.dylib /Utenti/<utente>/Libreria/ODBC/SequeLink.bundle/Contents/MacOS/ ivslk18.dylib L ODBC Administrator 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 (nelle versioni precedenti di FileMaker Server e FileMaker Pro, si creava soltanto un DSN per tutti i file di database FileMaker ospitati dall applicazione). Il DSN identifica il driver ODBC FileMaker, la posizione dell applicazione host e il file del database FileMaker a cui si sta accedendo come origine dati. Importante Il driver client ODBC per Mac OS non supporta caratteri ASCII superiori, a 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 al file 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. Sarà inoltre necessario specificare 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 ) 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. Porta Digitare ServerDataSource Digitare il nome del file del database FileMaker che si sta utilizzando come origine dati (non digitare l estensione del file). Se il nome del database contiene spazi, sostituirlo con i caratteri di escape %20. Ad esempio, ServerDataDource=MY%20DATABASE. I caratteri a doppio byte non sono supportati. Importante Se si cerca di aggiungere un DSN con iodbc Administrator e si riceve il messaggio Impossibile caricare driver o libreria di installazione traduttore, scaricare e installare ODBC-JDBC Lite Bridge (m6i5jzzz.dmg) dal sito web di OpenLink. Il file scaricato fornisce un ODBC Administrator che permette di creare con successo un DSN. Per link a ulteriori informazioni dettagliate, vedere Verifica dell accesso attraverso ODBC (Mac OS) OpenLink ODBC Administrator permette di verificare che il driver client ODBC sia stato configurato correttamente per accedere all origine dati FileMaker.

18 18 Guida per sviluppatori JDBC e ODBC FileMaker

19 Capitolo 3 Uso di JDBC per condividere dati FileMaker I programmatori Java possono usare il driver client JDBC con qualsiasi strumento RAD (Rapid Application Development) 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 del 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. protocollo DBMS proprietario Applicazione Java Driver JDBC Computer client FileMaker 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 JDBC driver manager; inoltre è necessario specificare l URL esatto di JDBC nell applicazione o nell applet. È necessario l URL di JDBC per effettuare la connessione al database.

20 20 Guida per sviluppatori JDBC e ODBC FileMaker Installazione del driver client JDBC Il driver client JDBC può essere installato con un programma separato, disponibile nel CD della Pubblicazione Web Immediata di FileMaker Server e nel CD FileMaker Pro nella cartella \xdbc\jdbc Client Driver Installer. Il driver è compresso come file di archivio Java con estensione.jar e contiene una raccolta di file di classi. È inoltre possibile scaricare l ultima versione del driver client JDBC (per Windows o Mac OS) e la documentazione di FileMaker JDBC in formato PDF da Per le istruzioni di installazione, vedere Installazione dei driver client ODBC e JDBC FileMaker, disponibile come documento PDF sul CD nella cartella FileMaker Pro \xdbc\documentazione elettronica e nella cartella \Italiano Extra\Documentazione elettronica dove è stato installato FileMaker Server. Driver client JDBC Il driver del client JDBC fornisce supporto parziale per la specifica JDBC 3.0. Per i collegamenti ad ulteriori informazioni dettagliate, vedere Vedere anche il SequeLink Developer s Reference disponibile su Il driver client JDBC è progettato per lavorare con Java Development Kit (JDK) 1.4. È 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.

21 Capitolo 3 Uso di JDBC per condividere dati FileMaker 21 Registrazione del driver client JDBC e connessione ad un origine dati FileMaker (un esempio) Ecco un esempio di JDBCTest che: 1. Registra il driver client JDBC in JDBC driver manager 2. Stabilisce una connessione con l origine dati FileMaker (l URL JDBC è jdbc:sequelink:// :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.getConnection("Jdbc:sequelink:// :2399; user=some user;password=some password",nomeutente, password); } catch(exception e) { system.out.println(e); } // avviso connessione SQLWarning warning = null; try { warning = con.getwarnings(); if (warning == null) { System.out.println("Nessun messaggio d'avviso"); return; } while (warning!= null) { System.out.println("Avviso: "+ messaggio d'avviso); warning = warning.getnextwarning(); } } catch (Exception e) { } Sysem.out.println(e); } } Nota Questo esempio non è stato progettato per essere compilato.

22 22 Guida per sviluppatori JDBC e ODBC 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:// :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:// :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:// :2399;serverdatasource=publications Se il nome del database contiene spazi, sostituirli con i caratteri di escape %20. Esempio: jdbc:sequelink:// :2399;serverdatasource=my%20database 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>; HPassword=<password>; Nota Se la soluzione database FileMaker utilizza molti file di database FileMaker, creare un ulteriore file di database che contenga tutti i riferimenti necessari al file esterno, ricorrenze tabella e 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.

23 Capitolo 3 Uso di JDBC per condividere dati FileMaker 23 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 informazioni vedere il file PDF Installazione dei driver client ODBC e JDBC FileMaker. È possibile scaricare i PDF aggiornati relativi alla documentazione di FileMaker 8 JDBC da 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 (nel file di database FileMaker). 1 Per l applicazione host di FileMaker Pro o FileMaker Server è stata configurata la condivisione tramite ODBC/JDBC. 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 ed esempi sull uso di Java e JDBC per lo scambio dei dati in generale o per la pubblicazione dei dati di FileMaker sul Web vedere il sito

24 24 Guida per sviluppatori JDBC e ODBC FileMaker

25 Capitolo 4 Standard supportati In questo capitolo sono descritti le istruzioni e i costrutti SQL supportati dai driver client ODBC e JDBC FileMaker. Utilizzare i driver client per accedere alla soluzione del database FileMaker da un applicazione compatibile con ODBC o JDBC. La soluzione di database FileMaker può essere ospitata da FileMaker Pro o da FileMaker Server. Il driver client ODBC supporta ODBC 3.5 Level 1 con alcune funzioni del Level 2. Il driver client JDBC fornisce supporto parziale per la specifica di JDBC 3.0; vedere per collegamenti a ulteriori informazioni dettagliate e il SequeLink Developer s Reference disponibile su 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, delle tabelle e 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 e clausole SQL I driver client ODBC e JDBC supportano le seguenti istruzioni SQL: SELECT DELETE INSERT UPDATE CREATE TABLE ALTER TABLE CREATE INDEX DROP INDEX 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 i 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.

26 26 Guida per sviluppatori JDBC e ODBC 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 possibile confusione 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 il settore alias 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, IMP.COGNOME o I.COGNOME, dove I è l alias della tabella IMP. 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 Utilizzare questa clausola SQL FROM WHERE GROUP BY HAVING UNION ORDER BY FOR UPDATE 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 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. Bloccare i record della tabella di database selezionati tramite l istruzione SELECT. Nota Se si vogliono recuperare i dati da una tabella senza colonne, l istruzione SELECT non viene eseguita.

27 Capitolo 4 Standard supportati 27 Esempi L esempio che segue recupera i nomi dei dipendenti con stipendio uguale o superiore a Euro: SELECT cognome,nome FROM dip WHERE stipendio >= L esempio che segue utilizza la clausola ORDER BY per disporre i record in ordine ascendente in base sia al cognome che al nome: SELECT id_dip, cognome, nome FROM dip ORDER BY cognome, nome Altri esempi: Usando costante di testo costante numerica costante di data costante di ora costante Indicatore data e ora colonna di testo colonna numerica colonna data colonna ora colonna Indicatore data e ora colonna a BLOB carattere jolly* Esempio SQL SELECT 'CatDog' FROM Venditori SELECT 999 FROM Venditori SELECT DATE ' ' FROM Venditori SELECT TIME '02:49:03' FROM Venditori SELECT TIMESTAMP ' :49:03' FROM Venditori SELECT Nome_Azienda FROM Dati_Vendite SELECT DISTINCT NomeAzienda FROM Dati _Vendite SELECT Quantità FROM Dati_Vendite SELECT DISTINCT Quantità FROM Dati_Vendite SELECT Data_Vendita FROM Dati_Vendite SELECT DISTINCT Data_Vendita FROM Dati_Vendite SELECT Ora_Vendita FROM Dati_Vendite SELECT DISTINCT Ora_Vendita FROM Dati_Vendite SELECT IndicatoreDataOra_Vendita FROM Dati_Vendite SELECT DISTINCT IndicatoreDataOra_Vendita FROM Dati_Vendite SELECT Brochure_Società FROM Dati _Vendite SELECT RicavaCome(Logo_Società, 'JPEG')FROM Dati _Vendite SELECT * FROM Venditori SELECT DISTINCT * FROM Venditori a. Un BLOB è un campo Contenitore di un file di database FileMaker. Note sugli esempi Una costante è un valore letterale univoco che è possibile includere in un istruzione SELECT, mentre una colonna è il riferimento ad un campo nel file di database FileMaker (il campo può contenere molti valori diversi). Il carattere jolly asterisco (*) rappresenta qualsiasi carattere. Per l esempio SELECT * FROM Venditori, il risultato comprende tutte le righe nella tabella Venditori. Per l esempio SELECT DISTINCT * FROM Venditori, il risultato è costituito da tutte le righe uniche nella tabella Venditori (senza duplicati). Nota Le istruzioni SELECT* su database più grandi potrebbero non funzionare correttamente. Per evitare possibile confusione non inserire caratteri jolly e specificare i nomi di tabelle e colonne (senza alias).

28 28 Guida per sviluppatori JDBC e ODBC FileMaker Recupero dei contenuti di un campo Contenitore: Funzione CAST() e funzione RicavaCome() È possibile recuperare dati binari, informazioni di riferimento al file o dati di un tipo specifico di file da un campo Contenitore. Per recuperare i dati binari utilizzare un istruzione SELECT standard. Ad esempio: SELECT Brochure_Società FROM Dati_Vendite Se esistono file o dati JPEG, l istruzione SELECT recupera i dati in forma binaria; in caso contrario, l istruzione SELECT restituisce < zero>. Per recuperare le informazioni di riferimento al file (come il percorso file), utilizzare la funzione CAST con un istruzione SELECT. Ad esempio: SELECT CAST(Brochure_Società AS VARCHAR(NNN))FROM Dati_Vendite In questo esempio se: 1 È stato inserito un file nel campo Contenitore utilizzando FileMaker Pro, ma è stato memorizzato solo un riferimento al file, l istruzione SELECT recupera le informazioni di riferimento al file come SQL_VARCHAR. 1 Sono stati inseriti i contenuti di un file nel campo Contenitore utilizzando FileMaker Pro, l istruzione SELECT recupera il nome del file. 1 È stato importato un file nel campo Contenitore da un altra applicazione, l istruzione SELECT visualizza '?' (il file viene visualizzato come Senza nome.dat in FileMaker Pro). Per recuperare i dati di un tipo specifico di file da un campo Contenitore utilizzare la funzione RicavaCome e specificare il tipo del file. Ad esempio: SELECT RicavaCome(Logo_Società, 'JPEG')FROM Dati_Vendite I tipi di file possibili (sensibili a e minuscole) che è possibile recuperare da un campo Contenitore in un file di database FileMaker sono: Tipo Tipo di file Descrizione di file Descrizione 'BMPf' Bitmap 'PCD ' Kodak PhotoCD 'EMBO' Dati Contenitore OLE 'PDF ' Portable Document Format 'EMF+' Windows Enhanced Metafile Plus 'PICT' Mac OS (non ha un intestazione basata su file di 512 byte) 'EPS ' PostScript incorporato 'PNGf' Formato immagine Bitmap 'FILE' Risultato di un comando Inserisci file 'PNTG' MacPaint 'FPix' Flash (FPX) 'qtif' File immagine QuickTime 'FORK' Fork di risorse (Mac OS) '.SGI' Formato generico bitmap 'GIFf' Graphics Interchange Format 'snd ' Suono standard (formato non elaborato Mac OS) 'JPEG' Immagini fotografiche 'TIFF' Formato raster del file per immagini digitali 'JP2' JPEG 2000 'TPIC' Targa 'META' Windows Metafile (avanzato) 'XMLO' Oggetti del formato.