Claris FileMaker
Guida ODBC e JDBC© 2004–2022 Claris International Inc. Tutti i diritti riservati.
Claris International Inc.
One Apple Park Way
Cupertino, CA 95014
Claris, Claris Connect, il logo Claris, FileMaker, FileMaker Cloud, FileMaker Go, FileMaker Pro, FileMaker Server, FileMaker WebDirecte il logo della cartella sono marchi di Claris International Inc. registrati negli Stati Uniti e in altri Paesi. Tutti gli altri marchi sono di proprietà
dei rispettivi proprietari.
La documentazione dei prodotti Claris è protetta da copyright. Non è consentito fare copie o distribuire la presente documentazione senzaprevia autorizzazione scritta di Claris. La presente documentazione può essere utilizzata esclusivamente con una copia valida delsoftware Claris concessa in licenza.
Tutte le persone, le società, gli indirizzi e-mail e gli URL elencati negli esempi sono fittizi e ogni riferimento a persone, società, indirizzi
e-mail o URL esistenti è puramente casuale. Gli autori del prodotto sono elencati nel documento Riconoscimenti fornito insieme a questo
software. Gli autori della documentazione sono elencati nei Riconoscimenti per la documentazione. I prodotti di terze parti e gli URL sono
citati unicamente a scopo informativo e non costituiscono obbligo o raccomandazione. Claris International Inc. non si assume alcuna
responsabilità in merito alle prestazioni di questi prodotti.
Per ulteriori informazioni, visitare il nostro sito Web.
Edizione: Gennaio 2022

Sommario
Capitolo 1
Introduzione
Informazioni su questa guida
Dove reperire la documentazione dei prodotti FileMaker
Panoramica di ODBC e JDBC
Utilizzo del software FileMaker come applicazione client ODBC
Importazione dei dati ODBC
Aggiunta di tabelle ODBC al grafico delle relazioni
Utilizzo di un database FileMaker Pro come origine dati
Accesso a un database FileMaker Pro ospitato
Limitazioni con strumenti di terze parti
Requisiti di rete
Aggiornamento di file di versioni precedenti

Capitolo 2
Accesso a origini dati SQL esterne
Importazione dei dati ODBC
Eseguire SQL per interagire con le origini dati tramite ODBC
Uso delle tabelle ODBC nel grafico delle relazioni
Origini dati supportate
Aggiunta di tabelle ODBC al grafico delle relazioni

Capitolo 3
Installazione dei driver client ODBC di FileMaker
Requisiti hardware e software
Requisiti di rete
Panoramica dell’architettura dei driver client ODBC (Windows)
Installazione del driver client ODBC (Windows)
Configurazione dei driver client (Windows)
Apertura dell’amministratore ODBC (Windows)
Configurazione del DSN (Windows)
Installazione del driver client ODBC (macOS)
Configurazione dei driver client (macOS)
Operazioni successive

Capitolo 4
Utilizzo di ODBC per condividere i dati FileMaker
Informazioni su ODBC
Uso del driver client ODBC
Panoramica dell’accesso a un file di database FileMaker Pro
Accesso a un file di database FileMaker Pro da un’applicazione Windows
Specifica delle proprietà del driver client ODBC per un DSN FileMaker (Windows)
Verifica dell’accesso tramite ODBC (Windows)

5
5
5
5
6
6
7
7
7
8
8
8

9
9
10
11
11
11

12
12
12
12
12
13
13
14
15
16
18

19
19
20
20
21
21
21

4

Sommario

Accesso a un file di database FileMaker Pro da un’applicazione macOS
Specifica delle proprietà del driver client ODBC per un DSN FileMaker (macOS)
Verifica dell’accesso tramite ODBC (macOS)

Capitolo 5
Installazione dei driver client JDBC di FileMaker
Requisiti software
Requisiti di rete
Installazione del driver client JDBC
Uso del driver client JDBCCapitolo 6
Utilizzo di JDBC per condividere i dati FileMaker
Informazioni su JDBC
Uso del driver client JDBC
Driver client JDBC
Uso di un URL JDBC per collegarsi al database
Specificazione delle proprietà del driver nel nome secondario dell’URL
Specifica di un valore di timeout del socket
Soluzioni con più file di database FileMaker Pro
Verifica dell’accesso tramite JDBCCapitolo 7
Informazioni di riferimento
Funzioni di catalogo ODBC
Metodi DatabaseMetaData JDBC
Mappatura di campi FileMaker Pro su dati di tipo ODBC
Mappatura di campi FileMaker Pro su dati di tipo JDBC
Tipi di dati in applicazioni a 64 bit
Messaggi di errore ODBC e JDBC
Messaggi di errore ODBC
Messaggi di errore JDBC

Indice

22
22
22

23
23
23
23
24

25
25
25
25
26
28
28
29
29

30
30
30
30
31
31
31
31
32
33

Capitolo 1
Introduzione
Questa guida descrive come utilizzare il software Claris® FileMaker® come applicazione client
ODBC e come origine dati per applicazioni ODBC (Open DataBase Connectivity) e JDBC (Java
DataBase Connectivity).

Informazioni su questa guida
Per poter usare questa Guida è necessario avere conoscenze di base sull’uso di ODBC e JDBCe sulla creazione di query SQL. Questa guida descrive le istruzioni SQL e gli standard supportati
dalla piattaforma Claris FileMaker. Per informazioni sulla creazione di query SQL, consultare un
manuale di terze parti.

Dove reperire la documentazione dei prodotti FileMaker
Per avere informazioni, visualizzare o scaricare la documentazione dei prodotti FileMaker, visitare
il Centro documentazione prodotto.

Panoramica di ODBC e JDBCODBC e JDBC sono API (Application Programming Interfaces). ODBC è un’API per applicazioni
scritte in linguaggio C, mentre JDBC è un’API analoga per il linguaggio Java. Queste API offrono
alle applicazioni client un linguaggio comune per interagire con vari servizi di database e origini
dati, compresi Claris FileMaker Pro® e Claris FileMaker Server®.
Tutte le applicazioni che supportano ODBC e JDBC riconoscono un sottogruppo fondamentale diistruzioni SQL (Structured Query Language). SQL consente di utilizzare altre applicazioni (fogli dicalcolo, elaboratori di testi, strumenti per la generazione di resoconti) per visualizzare, analizzare
e modificare i dati.
Utilizzando le API ODBC o JDBC, un’applicazione client comunica con una gestione driver che
identifica il driver client per comunicare con una origine dati.
Applicazione
clientGestionedriverDriverclientOriginedati

Il software FileMaker può agire come applicazione client o come origine dati.

Capitolo 1 | Introduzione

6

La tabella seguente offre una panoramica su come utilizzare ODBC e JDBC con il software
FileMaker.
Operazione da eseguire

Modalità di esecuzione

Prodotto

Vedere1 Utilizzare il software

1 In modo interattivo

1 Questa guida, capitolo 2
1 Guida di FileMaker Pro

1 Accedere ai dati ODBC

1 Una volta, in modo statico

1 FileMaker Pro
1 FileMaker Server
1 Claris FileMaker Cloud®

1 Utilizzare un database

1 ODBC e JDBC

1 FileMaker Pro
1 FileMaker Server

1 Questa guida, capitoli da

1 Query SQL

1 FileMaker Pro
1 FileMaker Server

1 Guida SQL di FileMaker

FileMaker comeapplicazione client ODBC
memorizzati in un’origine
dati SQL esterna

FileMaker come origine
dati

attraverso il grafico dellerelazioni
mediante importazione
ODBC o menu File >Apri. Inoltre, istruzione di
script Importa record,
istruzione di script Esegui
SQL e funzione
EseguiSQL

3a6

1 Condividere i dati diFileMaker Pro con
un’applicazione client
ODBC di terze parti

1 Utilizzare un database

FileMaker come origine
dati

1 Condividere i dati diFileMaker Pro con
un’applicazione client
ODBC di terze parti

Utilizzo del software FileMaker come applicazione client ODBC
Come applicazione client ODBC, il software FileMaker può accedere ai dati all’interno di origini
dati SQL esterne. Il software FileMaker si connette all’origine dati SQL esterna utilizzando il driverclient per l’origine dati ODBC e o importa dati ODBC o lavora con tabelle ODBC nel grafico dellerelazioni.

Importazione dei dati ODBCÈ possibile importare i dati ODBC in uno dei seguenti modi:

1 dal menu File, specificando un’origine dati ODBC e inserendo le istruzioni SQL nella finestra didialogo dell’applicazione per la generazione di query SQL fornita con FileMaker Pro

1 creando uno script FileMaker che utilizza l’istruzione di script Importa record o l’istruzione di
script Esegui SQL

Per ciascuno di questi metodi, è necessario inserire le istruzioni SQL da sé e quindi conoscere leistruzioni SQL supportate e la loro sintassi per l’origine dati ODBC. Dovendo inserire le istruzioni
SQL da sé, è possibile importare i dati ODBC da qualsiasi origine dati ODBC. Per informazioni
sulle istruzioni SQL e sulla sintassi supportata dalla piattaforma Claris FileMaker, consultare la
Guida SQL di FileMaker.

Capitolo 1 | Introduzione

7

Aggiunta di tabelle ODBC al grafico delle relazioni
Quando si aggiunge una tabella ODBC al grafico delle relazioni, è possibile collegarsi e lavorarecon i dati nelle origini dati SQL esterne in modo simile a come si lavora con i dati nel file didatabase FileMaker Pro corrente. Ad esempio, è possibile:

1 creare le tabelle nel grafico delle relazioni per origini dati ODBC
1 aggiungere campi supplementari a tabelle ODBC per effettuare calcoli o riepilogare dati nelle
tabelle ODBC

1 aggiungere, modificare ed eliminare i dati esterni in modo interattivo
1 creare relazioni tra campi in tabelle FileMaker e campi (chiamati anche “colonne”) in tabelle
ODBC

Poiché le istruzioni SQL utilizzate per comunicare con una tabella ODBC aggiunta al grafico dellerelazioni sono generate da FileMaker Pro, si è limitati a origini dati Oracle, SQL Server e MySQL
specifiche supportate da FileMaker Pro nel grafico delle relazioni.
Nota Non è possibile modificare lo schema delle origini dati ODBC esterne utilizzando
FileMaker Pro.
Il Capitolo 2 “Accesso a origini dati SQL esterne” descrive come utilizzare il software FileMaker
come applicazione client ODBC.

Utilizzo di un database FileMaker Pro come origine dati
Come origine dati, i dati FileMaker sono condivisi con applicazioni compatibili con ODBC e JDBC.
L’applicazione si collega all’origine dati FileMaker utilizzando il driver client FileMaker, crea ed
esegue le query SQL utilizzando ODBC o JDBC ed elabora i dati recuperati dalla soluzione didatabase FileMaker Pro.
Nota L’utilizzo dei database FileMaker Pro come origine dati non è supportato per i databaseospitati da FileMaker Cloud.

Accesso a un database FileMaker Pro ospitato
FileMaker Server o FileMaker Pro consentono di ospitare un file di database FileMaker Pro comeorigine 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

Connessioni illimitate 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 daapplicazioni produttive desktop).

FileMaker Pro

Fino a cinque connessioni e supporta solo l’accesso locale (stesso computer).

Se la soluzione di database FileMaker Pro utilizza più di un file di database FileMaker Pro, tutti ifile di database devono trovarsi sullo stesso computer.
Per accedere a un file di database FileMaker Pro ospitato, si deve installare il driver client ODBCo JDBC corrispondente. Installare il driver client sulla macchina in cui è installata l’applicazione diterze parti.

Capitolo 1 | Introduzione

8

Questa guida spiega in che modo i driver client ODBC e JDBC, quando utilizzati con
FileMaker Pro e FileMaker Server, supportano gli standard industriali per ODBC e JDBC.
Per conoscere le istruzioni SQL supportate dai driver client ODBC e JDBC quando utilizzati con
FileMaker Pro e FileMaker Server, consultare la Guida SQL di FileMaker.
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 è in grado di segnalare alle applicazioni client ODBC e JDBC
la disponibilità dell’origine dati (l’amministratore può comunicare solo con i client del file didatabase FileMaker Pro). 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 collegarsi a un file di database FileMaker Pro nondisponibile, viene visualizzato un messaggio che indica che la connessione non è riuscita.

Limitazioni con strumenti di terze parti
Microsoft Access: quando si utilizza Microsoft Access per visualizzare i dati in un’origine dati
FileMaker, non utilizzare i dati di un campo Riassunto. I dati del campo Riassunto non devono
essere modificati in Microsoft Access ed è possibile che il valore della data visualizzato in
Microsoft Access non sia preciso.

Requisiti di rete
Se si utilizza FileMaker Server per ospitare un file di database FileMaker Pro come origine dati in
una rete, è necessaria una rete TCP/IP. FileMaker Pro supporta solo l’accesso locale (stesso
computer).

Aggiornamento di file di versioni precedenti
Se si è installato il driver di una versione precedente di FileMaker Pro o FileMaker Server, ènecessario installare il driver per la versione corrente. Il driver per la versione corrente delsoftware FileMaker non è compatibile con le versioni precedenti.
Vedere il capitolo 3 “Installazione dei driver client ODBC di FileMaker” e il capitolo 5 “Installazione
dei driver client JDBC di FileMaker”.
Note

1 È necessario creare un DSN (Data Source Name) per ogni file di database FileMaker Pro a cui
si desidera accedere come origine dati. Se in precedenza è stato configurato l’accesso
attraverso un DSN unico, che consente alle tabelle di suddividersi in diversi file di database
FileMaker Pro, sarà necessario consolidare queste tabelle in un unico file di database (oppure
creare diversi DSN).

1 Per informazioni sull’utilizzo di ODBC e JDBC con versioni precedenti di FileMaker Pro, visitare
il Centro documentazione prodotto.

Capitolo 2
Accesso a origini dati SQL esterne
Come applicazione client ODBC, il software FileMaker può accedere ai dati all’interno di origini
dati SQL esterne. Il software FileMaker si connette all’origine dati SQL esterna utilizzando il driverclient per l’origine dati ODBC e o importa dati ODBC o lavora con tabelle ODBC nel grafico dellerelazioni.
Sia che si stiano importando dati ODBC o che si stiano utilizzando tabelle ODBC nel grafico dellerelazioni, è necessario configurare un driver per l’origine dati ODBC che si sta usando. Ad esempio,
per accedere ai record da un database Oracle è necessario configurare un driver client Oracle.

Importazione dei dati ODBC
Quando si importano i dati ODBC, è necessario un driver client ODBC configurato per l’origine
dati SQL esterna sulla macchina client.

FileMaker Pro

GestionedriverDriverclientOriginedati SQL

Dopo aver configurato un driver client ODBC, è possibile interagire con i record, importarli in un
file di database FileMaker Pro esistente o creare un nuovo file di database FileMaker Pro daun’origine dati ODBC (come database di Oracle o Microsoft Access).
Per prima cosa bisogna accedere all’origine dati da importare. Quindi si crea una query per i
record da importare dall’origine dati. Infine, se si stanno importando dati in un file esistente,associare i campi dell’origine dati a quelli nel file di database FileMaker Pro.
È possibile accedere all’origine dati ODBC attraverso il menu File, con le istruzioni di script
Importa record o Esegui SQL.
Per importare i dati ODBC, seguire questa procedura generale:
1. Installare e configurare i driver ODBC specifici per le origini dati esterne a cui si desidera
accedere.
2. Sul computer che eseguirà l’importazione ODBC, definire un DSN di sistema per ogni origine
dati ODBC a cui si desidera accedere.
3. Determinare qualsiasi considerazione aggiuntiva per le origini dati ODBC a cui si desidera
accedere (ad esempio, se agli utenti viene richiesto di indicare nome utente e password).
4. In FileMaker Pro, eseguire una delle seguenti operazioni:

1 Per eseguire l’importazione in un file FileMaker Pro esistente, selezionare il menu File >Importa record > Origine dati ODBC.

1 Per creare un file FileMaker Pro dai record dell’origine dati, selezionare il menu File > Apri.
Quindi selezionare Origine dati ODBC per Tipo file (Windows) o Mostra (macOS).

Capitolo 2 | Accesso a origini dati SQL esterne

10

5. Selezionare l’origine dati, inserire nome utente e password (se disponibili) e fare clic su OK per
aprire la finestra di dialogo dell’applicazione per la generazione di query SQL fornita con
FileMaker Pro.
6. Utilizzando la finestra di dialogo dell’applicazione per la generazione di query SQL fornita con
FileMaker Pro, è possibile creare una query. Selezionare la tabella da cui si desidera eseguire
l’importazione, quindi selezionare le colonne specifiche che si desidera utilizzare nella query
SQL. Utilizzare la scheda WHERE per creare i criteri di ricerca e la scheda ORDER BY per
specificare un criterio di ordinamento.
È anche possibile digitare un’istruzione SQL direttamente nella finestra di dialogo
dell’applicazione per la generazione di query SQL.
È possibile eseguire immediatamente la query oppure utilizzare l’istruzione di script Importa
record o Esegui SQL per eseguire una query come parte di uno script FileMaker.
Nota L’importazione ODBC, l’istruzione di script Esegui SQL e le origini dati SQL esterne nonsono supportate nelle soluzioni runtime create con FileMaker Pro.
Per informazioni sull’importazione dei dati, sull’utilizzo della finestra di dialogo dell’applicazione
per la generazione di query SQL e sulla creazione di script FileMaker, consultare la Guida diFileMaker Pro. Per informazioni sulle istruzioni SQL e sulla sintassi supportata dalla piattaforma
FileMaker, consultare la Guida SQL di FileMaker.

Eseguire SQL per interagire con le origini dati tramite ODBC
Oltre a importare dati in un file di database FileMaker Pro tramite ODBC, è anche possibileinteragire con le origini dati utilizzando le istruzioni SQL attraverso l’istruzione di script Esegui SQL
e la funzione EseguiSQL. L’istruzione di script Esegui SQL può utilizzare qualsiasi istruzione SQL
supportata dall’origine dati, come INSERT, UPDATE e DELETE. La funzione EseguiSQL supportasolo l’istruzione SELECT.
È anche possibile utilizzare istruzioni SQL che vanno oltre la semplice importazione di dati in un
file di database FileMaker Pro. Ad esempio, si potrebbero eseguire istruzioni SQL che
aggiungono record a una tabella di un database nel Server SQL, utilizzando informazioni da un
file di database FileMaker Pro.

Per informazioni sulla creazione di script FileMaker che utilizzano l’istruzione di script Esegui SQL
e la funzione EseguiSQL, consultare la Guida di FileMaker Pro. Per informazioni sulle istruzioni
SQL e sulla sintassi supportata dalla piattaforma FileMaker, consultare la Guida SQL di FileMaker.

Capitolo 2 | Accesso a origini dati SQL esterne

11

Uso delle tabelle ODBC nel grafico delle relazioni
Quando si aggiunge una tabella ODBC al grafico delle relazioni, è possibile collegarsi e lavorarecon i dati nelle origini dati SQL esterne in modo simile a come si lavora con i dati nel file didatabase FileMaker Pro corrente.
Quando si utilizzano FileMaker Pro, FileMaker Server o FileMaker Cloud come host per una
soluzione che comprende tabelle ODBC nel grafico delle relazioni, si deve configurare il driverclient ODBC per l’origine dati SQL esterna sulla macchina host.
UtenteFileMaker Pro

UtenteFileMaker Pro

Host
FileMaker
Pro, Server o
CloudGestionedriverDriverclientOriginedati SQL

UtenteFileMaker Pro

Origini dati supportate
Come applicazione client ODBC, FileMaker Pro supporta origini dati SQL esterne come Oracle,
Microsoft SQL Server e MySQL Community Edition come tabelle ODBC nel grafico delle relazioni.
Per informazioni sulle origini dati SQL esterne supportate, consultare la Knowledge Base.

Aggiunta di tabelle ODBC al grafico delle relazioni
Per impostare un database FileMaker Pro per l’accesso ai dati nelle origini dati ODBC supportate:
1. Installare e configurare i driver ODBC specifici per le origini dati esterne a cui si desidera
accedere.
2. Sul computer che ospita il file FileMaker Pro corrente, definire un DSN di sistema per ogni
origine dati ODBC a cui si desidera accedere.
3. Determinare qualsiasi considerazione aggiuntiva per le origini dati ODBC a cui si desidera
accedere (ad esempio, se agli utenti viene richiesto di indicare nome utente e password).
4. Aggiungere una o più tabelle dall’origine dati ODBC al grafico delle relazioni nel file
FileMaker Pro corrente.
5. Per visualizzare dati esterni, aggiungere i campi ai formati del file FileMaker Pro.
6. Se si desidera, aggiungere campi supplementari alle tabelle e ai formati esterni per visualizzare
i risultati di calcolo e riassunto in base ai dati memorizzati nelle origini dati ODBC esterne.
Per la descrizione dettagliata dei passi e per ulteriori informazioni sulla configurazione di un driverclient ODBC, sulla connessione alle origini dati ODBC, sulla modifica delle origini dati ODBC esull’impostazione di una tabella ODBC nel grafico delle relazioni, consultare la Guida diFileMaker Pro.

Capitolo 3
Installazione dei driver client ODBC di FileMaker
Per accedere a un file di database FileMaker Pro ospitato come origine dati ODBC, si deve installare
il driver client ODBC. Queste istruzioni spiegano come installare il driver client ODBC necessario per
accedere ai dati FileMaker da applicazioni di terze parti e applicazioni personalizzate tramite ODBC.
Installare il driver client sulla macchina in cui è installata l’applicazione di terze parti.
Come descritto di seguito, il driver client ODBC è disponibile nella cartella xDBC tramite
un’installazione separata sul disco di installazione del prodotto FileMaker o scaricandolo da Internet.
Per gli aggiornamenti dei driver client, accedere alla pagina dei download e delle risorse.
Se si utilizzerà FileMaker Server per ospitare un file di database FileMaker Pro, fare in modo che
i driver client siano disponibili per gli utenti remoti.
Dopo aver installato il driver client necessario, è possibile configurarlo per accedere ai dati
FileMaker e creare query SQL per interagire con i dati.

Requisiti hardware e software
Per installare e utilizzare i driver client ODBC, è necessario soddisfare i requisiti hardware e
software minimi descritti nei requisiti di sistema.

Requisiti di rete
Se si accederà a un’origine dati FileMaker ospitata su un altro computer, sarà necessariol’accesso alla rete tramite TCP/IP.

Panoramica dell’architettura dei driver client ODBC (Windows)
Il software FileMaker fornisce driver per client a 32 e a 64 bit per Windows per supportare
applicazioni ODBC a 32 e a 64 bit.
È necessario installare il driver client corrispondente alla propria applicazione ODBC, non al
proprio sistema operativo:

1 Se l’applicazione ODBC è un’applicazione a 32 bit, installare il driver per client a 32 bit.
1 Se l’applicazione ODBC è un’applicazione a 64 bit, installare il driver per client a 64 bit.

Installazione del driver client ODBC (Windows)
I driver per client a 32 e 64 bit Windows vengono installati come librerie separate. In una versione
a 32 bit del sistema operativo Windows, è possibile installare solo il driver per client a 32 bit. In
una versione a 64 bit del sistema operativo Windows, è possibile installare entrambi i driver per
client a 32 e a 64 bit.

Capitolo 3 | Installazione dei driver client ODBC di FileMaker

13

Installazione del driver client ODBC:
1. Eseguire una delle seguenti operazioni:

1 Se il software è stato scaricato elettronicamente, fare doppio clic sull’icona di installazione(file .exe).

1 Se si dispone di un disco di installazione, inserirlo nell’apposita unità.
2. Nella finestra FileMaker Pro o FileMaker Server, fare doppio clic sulla cartella Extra.
3. Fare doppio clic sulla cartella xDBC.
4. Nella cartella xDBC, fare doppio clic sulla cartella ODBC Client Driver Installer.
5. Nella cartella ODBC Client Driver Installer, fare doppio clic sul file di installazione del driver
desiderato.

1 Per installare il driver per client a 32 bit (fmodbc32.dll), utilizzare il relativo file di installazione:
FMODBC_Installer_Win32.msi

1 Per installare il driver per client a 64 bit (fmodbc64.dll), utilizzare il relativo file di installazione:
FMODBC_Installer_Win64.msi

6. Installare il driver client ODBC seguendo le istruzioni a video.
7. Al termine dell’installazione, fare clic su Chiudi.
Per impostazione predefinita il driver client ODBC viene installato nella seguente cartella:

1 In una versione a 32 bit del sistema operativo Windows, il driver per client a 32 bit(fmodbc32.dll) è installato sotto C:\Windows\System32

1 In una versione a 64 bit del sistema operativo Windows, il driver per client a 32 bit(fmodbc32.dll) è installato sotto C:\Windows\SysWOW64

1 In una versione a 64 bit del sistema operativo Windows, il driver per client a 64 bit(fmodbc64.dll) è installato sotto C:\Windows\System32

Il driver client ODBC, ODBC FileMaker, è ora disponibile; permette di configurare l’accesso ai
dati FileMaker.

Configurazione dei driver client (Windows)
Prima di utilizzare un’applicazione client ODBC per accedere ai dati FileMaker, è necessario
configurare un driver client per l’origine dati. Le impostazioni di configurazione indicano il driverclient in uso, la posizione dell’origine dati e i dettagli relativi al metodo di connessione che si
intende utilizzare.
Importante Quando si utilizza un driver client di FileMaker, è necessario specificare 2399 comenumero di porta.

Apertura dell’amministratore ODBC (Windows)
Per aprire l’amministratore ODBC, utilizzare il pannello di controllo Strumenti di amministrazione
nella categoria Sistema e sicurezza.
Per aprire l’amministratore ODBC a 32 bit in un sistema operativo Windows a 32 bit:Dal Pannello di controllo di Windows, aprire Strumenti di amministrazione > Origini dati (ODBC).

Capitolo 3 | Installazione dei driver client ODBC di FileMaker

14

Per aprire l’amministratore ODBC a 32 bit in un sistema operativo Windows a 64 bit:Dal Pannello di controllo di Windows, aprire Strumenti di amministrazione > Origini dati ODBC
(32 bit).
Per aprire l’amministratore ODBC a 64 bit in un sistema operativo Windows a 64 bit:Dal Pannello di controllo di Windows, aprire Strumenti di amministrazione > Origini dati ODBC
(64 bit).

Configurazione del DSN (Windows)
Per configurare il driver client ODBC:
1. Dalla finestra Amministrazione origine dati ODBC, selezionare la scheda DSN di sistema o
DSN utente. Si crea un DSN per ogni file di database FileMaker Pro a cui si desidera accederecome origine dati.
2. Fare clic su Aggiungi.
3. Selezionare ODBC FileMaker e fare clic su Fine.
4. Fare clic su Avanti.
5. Per Nome digitare un nome che sia significativo per chi accede all’origine dati FileMaker. Per
Descrizione inserire, se lo si desidera, una descrizione dell’origine dati FileMaker. Fare clic su
Avanti.
6. Per Host:

1 Se si esegue la connessione a un file di database ospitato da FileMaker Pro sul proprio
computer locale, inserire localhost o l’indirizzo IP 127.0.0.1.

1 Se si esegue la connessione a un file di database ospitato da FileMaker Server in rete,
inserire il nome di dominio specificato dal certificato SSL del server.

Se è stata attivata la condivisione mediante ODBC/JDBC nell’applicazione host, è possibile
selezionare Connettersi all’host per ottenere i nomi dei database disponibili.
Se disponibile, FileMaker xDBC Listener utilizza il certificato SSL installato nella cartella CStoresul server. Per motivi di sicurezza, indicare se stabilire una connessione quando non è
possibile verificare il certificato SSL.

1 Selezionare Connetti per consentire al processo ODBC di stabilire sempre la connessione.
1 Selezionare Connetti con avviso per consentire al processo ODBC di stabilire laconnessione, ma visualizzare anche un messaggio di avviso.

1 Selezionare Non connetterti per non stabilire la connessione e visualizzare un messaggio
di errore.

Fare clic su Avanti.
In caso contrario fare clic su Fine per salvare le informazioni sull’origine dati.

Capitolo 3 | Installazione dei driver client ODBC di FileMaker

15

7. Per Database selezionare un database dall’elenco dei database disponibili o digitare il nomedel file di database FileMaker Pro che si sta utilizzando come origine dati.
Nota Per i file di database ospitati da FileMaker Server, l’elenco dei database può essere
filtrato in base all’impostazione Filtra database. Vedere la Guida di FileMaker Server. Non èpossibile utilizzare il file di esempio FMServer_Sample per testare le connessioni ODBC.
Per fare ciò, caricare il proprio database.

1 Se è necessaria la gestione speciale di testo non inglese, fare clic su Lingue avanzate...
Per rilevare automaticamente le impostazioni della lingua, selezionare l’opzione Rileva
automaticamente impostazioni lingua per l’applicazione. Per specificare l’impostazionedella lingua, deselezionare l’opzione Rileva automaticamente impostazioni lingua perl’applicazione e selezionare l’impostazione di sistema che si desidera usare.
Per l’opzione Codifica testo multi-byte, selezionare Sistema o UTF-8. Ad esempio, alcune
applicazioni come Microsoft Excel si aspettano che il testo venga codificato con la codifica
Sistema, mentre le applicazioni Web si aspettano una codifica UTF-8. Se l’applicazione
prevede una codifica specifica, ma l’opzione indica una codifica diversa, l’applicazione
potrebbe visualizzare alcuni caratteri in modo errato. Il software FileMaker supporta caratteri
multibyte UTF-8 fino a tre byte.

1 Selezionare l’opzione Descrivere i campi testo come long varchar per risolvere i problemi
legati ai valori di campi lunghi, come i campi per i quali non è specificata una lunghezza
massima per l’importazione di Stampa unione di Microsoft Word, o i valori di campo nelle
applicazioni PHP superiori a 255 caratteri. Se non si utilizza questa opzione per i valori dicampo superiori a 255 caratteri, l’applicazione può restituire una stringa vuota (Windows) osolo 255 caratteri (macOS).

1 Per creare un file di registro per le query a esecuzione lunga, selezionare l’opzione Salva
query a esecuzione lunga in file di registro e digitare un nome per il file di registro.

Fare clic su Fine per salvare le informazioni sull’origine dati.
8. Esaminare le informazioni sul DSN FileMaker.

1 Fare clic su Test per verificare che il driver client ODBC sia stato configurato correttamente
per accedere all’origine dati FileMaker.

Se si riceve un messaggio di errore, è possibile correggere le informazioni sullaconnessione. Potrebbe inoltre essere necessario controllare che il file di database
FileMaker Pro sia ospitato e disponibile, che l’account File FileMaker specificato utilizzi un
set di privilegi con il privilegio esteso fmxdbc per l’accesso tramite ODBC/JDBC e chel’applicazione host FileMaker Server, FileMaker Pro o FileMaker Cloud sia stata predisposta
per la condivisione tramite ODBC/JDBC.

1 Fare clic su OK per salvare le informazioni sull’origine dati.

Installazione del driver client ODBC (macOS)
Il driver client è installato nella cartella /Libreria/ODBC.

Capitolo 3 | Installazione dei driver client ODBC di FileMaker

16

Installazione del driver client ODBC:
1. Eseguire una delle seguenti operazioni:

1 Se il software è stato scaricato elettronicamente, fare doppio clic sull’icona con l’immagine
del disco (file .dmg).

1 Se si dispone di un disco di installazione, inserirlo nell’apposita unità.
2. Nella finestra FileMaker Pro o FileMaker Server, fare doppio clic sulla cartella Extra.
3. Fare doppio clic sulla cartella xDBC.
4. Nella cartella xDBC, fare doppio clic sulla cartella ODBC Client Driver Installer.
5. Nella cartella ODBC Client Driver Installer, fare doppio clic su FileMaker ODBC.pkg.
6. Installare il driver client ODBC seguendo le istruzioni a video.
7. Al termine dell’installazione, fare clic su Chiudi.
Il driver client ODBC viene installato nella seguente cartella: /Libreria/ODBC
Nota Non è possibile cambiare la cartella di installazione del driver client ODBC.
Il driver client ODBC, ODBC FileMaker, è ora disponibile; permette di configurare l’accesso ai
dati FileMaker.

Configurazione dei driver client (macOS)
Prima di utilizzare un’applicazione client ODBC per accedere ai dati FileMaker, è necessario
configurare un driver client per l’origine dati. Le impostazioni di configurazione indicano il driverclient in uso, la posizione dell’origine dati e i dettagli relativi al metodo di connessione che si
intende utilizzare.
Queste istruzioni presuppongono l’installazione di ODBC Manager di Actual Technologies, unprodotto freeware non supportato da Claris®.
Importante Quando si utilizza un driver client di FileMaker, è necessario specificare 2399 comenumero di porta.
Per configurare il driver client ODBC:
1. Avviare l’utilità ODBC Manager. (ODBC Manager è installato nella cartella Utilità nella cartella
Applicazioni).
2. Selezionare la scheda DSN sistema o Utente DSN. Si crea un DSN per ogni file di database
FileMaker Pro a cui si desidera accedere come origine dati.
3. Fare clic su Aggiungi....
4. Selezionare ODBC FileMaker e fare clic su OK.
5. Fare clic su Continua.
6. Per Nome digitare un nome che sia significativo per chi accede all’origine dati FileMaker. Per
Descrizione inserire, se lo si desidera, una descrizione dell’origine dati FileMaker. Fare clic su
Continua.

Capitolo 3 | Installazione dei driver client ODBC di FileMaker

17

7. Per Host:

1 Se si esegue la connessione a un file di database ospitato da FileMaker Pro sul proprio
computer locale, inserire localhost o l’indirizzo IP 127.0.0.1.

1 Se si esegue la connessione a un file di database ospitato da FileMaker Server in rete,
inserire il nome di dominio specificato dal certificato SSL del server.

Se è stata attivata la condivisione mediante ODBC/JDBC nell’applicazione host, è possibile
selezionare Connettersi all’host per ottenere i nomi dei database disponibili.
Se disponibile, FileMaker xDBC Listener utilizza il certificato SSL installato nella cartella CStoresul server. Per motivi di sicurezza, indicare se stabilire una connessione quando non è
possibile verificare il certificato SSL.

1 Selezionare Connetti per consentire al processo ODBC di stabilire sempre la connessione.
1 Selezionare Connetti con avviso per consentire al processo ODBC di stabilire laconnessione, ma visualizzare anche un messaggio di avviso.

1 Selezionare Non connetterti per non stabilire la connessione e visualizzare un messaggio
di errore.

Fare clic su Continua.
In caso contrario fare clic su Fine per salvare le informazioni sull’origine dati.
8. Per Database selezionare un database dall’elenco dei database disponibili o digitare il nomedel file di database FileMaker Pro che si sta utilizzando come origine dati.
Nota Per i file di database ospitati da FileMaker Server, l’elenco dei database può essere
filtrato in base all’impostazione Filtra database. Consultare la Guida di FileMaker Server. Non
è possibile utilizzare il file di esempio FMServer_Sample per testare le connessioni ODBC. Per
fare ciò, caricare il proprio database.

1 Se è necessaria la gestione speciale di testo non inglese, fare clic su Lingue avanzate...
Per rilevare automaticamente le impostazioni della lingua, selezionare l’opzione Rileva
automaticamente impostazioni lingua per l’applicazione. Per specificare l’impostazionedella lingua, deselezionare l’opzione Rileva automaticamente impostazioni lingua perl’applicazione e selezionare un’impostazione di sistema.
Se l’applicazione utilizza le funzioni ODBC con buffer di caratteri di 4 byte, selezionare
l’opzione L’applicazione utilizza l’ODBC API “larga”.
Se il tipo di testo SQL_C_CHAR deve essere interpretato dal driver come SQL_C_WCHAR,
selezionare l’opzione Tratta tipi di testo come Unicode.

Capitolo 3 | Installazione dei driver client ODBC di FileMaker

18

Per l’opzione Codifica testo multi-byte, selezionare Sistema (Mac - Roman) o UTF-8. Ad
esempio, alcune applicazioni come Microsoft Excel si aspettano che il testo venga codificato
con la codifica Sistema, mentre le applicazioni Web si aspettano una codifica UTF-8. Se
l’applicazione prevede una codifica specifica, ma l’opzione indica una codifica diversa,
l’applicazione potrebbe visualizzare alcuni caratteri in modo errato. Il software FileMaker
supporta caratteri multibyte UTF-8 fino a tre byte.

1 Selezionare l’opzione Descrivere i campi testo come long varchar per risolvere i problemi

legati ai valori di campi lunghi, come i campi per i quali non è specificata una lunghezza
massima utilizzata per l’importazione di Stampa unione di Microsoft Word, o i valori di camponelle applicazioni PHP superiori a 255 caratteri.

1 Per creare un file di registro per le query a esecuzione lunga, selezionare l’opzione Salva
query a esecuzione lunga in file di registro e digitare un nome per il file di registro. Èanche possibile cambiare il valore Tempo query lunga.

Fare clic su Fine per salvare le informazioni sull’origine dati.
9. Esaminare le informazioni sul DSN FileMaker.

1 Fare clic su Test per verificare che il driver client ODBC sia stato configurato correttamente
per accedere all’origine dati FileMaker.

Se si riceve un messaggio di errore, è possibile correggere le informazioni sullaconnessione. Potrebbe inoltre essere necessario controllare che il file di database
FileMaker Pro sia ospitato e disponibile, che l’account File FileMaker specificato utilizzi un
set di privilegi con il privilegio esteso fmxdbc per l’accesso tramite ODBC/JDBC e chel’applicazione host FileMaker Server o FileMaker Pro sia stata predisposta per lacondivisione tramite ODBC/JDBC.

1 Fare clic su OK per salvare le informazioni sull’origine dati.

Operazioni successive
Dopo aver installato e configurato un driver client, è possibile creare ed eseguire query SQL per
accedere ai 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.
Vedere capitolo 4 “Utilizzo di ODBC per condividere i dati FileMaker”.

Capitolo 4
Utilizzo di ODBC per condividere i dati FileMaker
Utilizzare il driver client ODBC per collegarsi ai dati FileMaker da un’altra applicazione. L’applicazione
che utilizza il driver client ODBC può accedere direttamente ai dati in un file di database FileMaker Pro.
Il driver client ODBC FileMaker è ODBC FileMaker.
Nota È anche possibile utilizzare FileMaker Pro come applicazione client ODBC, interagendocon i record di un’altra origine dati tramite ODBC utilizzando SQL. Per ulteriori informazioni
sull’accesso a un’origine dati SQL esterna tramite ODBC, vedere il capitolo 2 “Accesso a origini
dati SQL esterne”.

Informazioni su ODBCODBC è un’API che consente alle applicazioni di accedere ai dati da diversi sistemi di gestione didatabase. ODBC offre alle applicazioni client un linguaggio comune per interagire con servizi didatabase e origini dati.
Tutte le applicazioni che supportano ODBC riconoscono un sottogruppo fondamentale di istruzioni
SQL (Structured Query Language). 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 istruzioni SQL, le funzioni e le espressioni supportate dal driverclient ODBC, vedere la Guida SQL di FileMaker.
L’applicazione può accedere ai dati in un file di database FileMaker Pro utilizzando il driver client
ODBC. Le istruzioni SQL vengono trasmesse all’host del file di database FileMaker e i risultati ditali istruzioni vengono rispediti all’applicazione. Se si utilizza FileMaker Server per ospitare un file
di database FileMaker Pro 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 sulla propria macchina(la macchina client). Questa relazione è detta configurazione client/server.
Applicazione
clientGestionedriverDriverODBC Oracle

Driver ODBC di
SQL Server

Driver client
ODBC diFileMaker

OracleMicrosoft
SQL Server

FileMaker Pro

Capitolo 4 | Utilizzo di ODBC per condividere i dati FileMaker

20

Uso del driver client ODBCIl driver client ODBC supporta ODBC 3.0 livello 1. È possibile utilizzare il driver client ODBC conqualsiasi applicazione compatibile ODBC. Condividendo il file di database FileMaker Pro comeorigine dati, è possibile:

1
1
1
1

eseguire stampe unione con Microsoft Word
creare grafici con Microsoft Excel
spostare dati FileMaker in un DBMS, come Microsoft SQL Server
analizzare ulteriormente i dati FileMaker 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 Pro 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 fmxdbc perl’accesso tramite ODBC/JDBC. Infine, attivare la condivisione dei dati tramite ODBC/JDBC perl’applicazione host. Per i dettagli nella Guida di FileMaker Pro o nella Guida di FileMaker Server,
visitare il Centro documentazione prodotto.
Importante Le versioni precedenti del driver client ODBC di FileMaker non sono compatibili conla versione corrente del software FileMaker. Per il collegamento a un file di database
FileMaker Pro è necessario installare e configurare il driver client ODBC corrispondente alla
versione del software FileMaker che si sta utilizzando.
Nota Per verificare se FileMaker XDBC Listener è in esecuzione, è possibile utilizzare
Monitoraggio Attività in macOS o Task Manager in Windows per controllare lo stato del processo
XDBC Listener. Quando questo processo viene avviato, gli viene assegnato il nome
fmxdbc_listener, utilizzato anche per registrare gli eventi.

Panoramica dell’accesso a un file di database FileMaker Pro
Da un’applicazione compatibile con ODBC, è possibile creare query SQL per accedere a un file
di database FileMaker Pro. Il driver client ODBC deve essere installato sul computer che genera
la query SQL.
Per accedere a un file di database FileMaker Pro:
1. In FileMaker Pro, rivedere i set di privilegi assegnati agli account che avranno accesso al file didatabase.
Gli account a cui deve essere consentito l’accesso necessitano di un set di privilegi con il
privilegio esteso fmxdbc per l’accesso tramite ODBC/JDBC.
2. Attivare la condivisione dei dati tramite ODBC/JDBC per l’applicazione host FileMaker Servero FileMaker Pro. Per i dettagli nella Guida di FileMaker Pro o nella Guida di FileMaker Server,
visitare il Centro documentazione prodotto.
3. Assicurarsi che il file di database FileMaker Pro a cui si desidera accedere sia ospitato e
disponibile.
Se la soluzione di database FileMaker Pro utilizza più di un file di database FileMaker Pro, tutti
i file di database devono trovarsi sullo stesso computer.

Capitolo 4 | Utilizzo di ODBC per condividere i dati FileMaker

21

4. Collegarsi ai dati FileMaker.
5. Creare ed eseguire una query SQL nell’applicazione client.
Ogni file di database FileMaker Pro aperto e configurato per l’accesso è un’origine dati
separata (si crea un DSN per ogni file di database FileMaker Pro a cui si desidera accederecome origine dati).
Ogni database può avere una o più tabelle. I campi di FileMaker Pro sono rappresentati sotto
forma di colonne. Il nome completo del campo, compresi gli eventuali caratteri non
alfanumerici, viene visualizzato come nome di colonna.

Accesso a un file di database FileMaker Pro 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 Pro a cui si desidera accedere come origine
dati. Il DSN identifica il driver client ODBC di FileMaker, la posizione dell’applicazione host
FileMaker e il file di database FileMaker Pro a cui si sta accedendo come origine dati.
Per informazioni sulla creazione di un DSN, vedere “Configurazione dei driver client (Windows)”
a pagina 13.

Verifica dell’accesso tramite ODBC (Windows)
Per verificare che il driver client ODBC sia stato configurato correttamente per l’accesso ai dati
FileMaker:
1. Aprire la finestra Amministrazione origine dati ODBC. Vedere “Apertura dell’amministratore
ODBC (Windows)” a pagina 13.
2. Selezionare la scheda DSN di sistema o DSN Utente (selezionare la scheda utilizzata durante
la configurazione).
3. Scegliere l’origine dati FileMaker configurata.
Il DSN inserito originariamente verrà visualizzato sotto Nome e ODBC FileMaker sarà il Driver.
4. Fare clic su Configura...
5. Fare clic su Avanti finché non si arriva alla pagina Conclusione.
6. Fare clic su Test.
Inserire il nome dell’account File FileMaker (in Nome utente database) e la password(in Password database).
Se viene stabilita la connessione, viene visualizzato il messaggio Test completato.
Se la connessione fallisce:

1 Assicurarsi che il file di database FileMaker Pro sia ospitato e disponibile.
1 Aggiornare o correggere le informazioni sulla connessione.
1 Assicurarsi che l’account File FileMaker utilizzi un set di privilegi con il privilegio esteso fmxdbc
per l’accesso tramite ODBC/JDBC.

1 Verificare che per l’applicazione host FileMaker Server o FileMaker Pro sia stata configurata lacondivisione tramite ODBC/JDBC.

Capitolo 4 | Utilizzo di ODBC per condividere i dati FileMaker

22

Accesso a un file di database FileMaker Pro da un’applicazione macOS
Specifica delle proprietà del driver client ODBC per un DSN FileMaker (macOS)
Creare un DSN per ogni file di database FileMaker Pro a cui si desidera accedere come origine
dati. Il DSN identifica il driver client ODBC di FileMaker, la posizione dell’applicazione host
FileMaker e il file di database FileMaker Pro a cui si sta accedendo come origine dati.
Per informazioni sulla creazione di un DSN, vedere “Configurazione dei driver client (macOS)” apagina 16.

Verifica dell’accesso tramite ODBC (macOS)
Per verificare che il driver client ODBC sia stato configurato correttamente per l’accesso all’origine
dati FileMaker:
1. Avviare l’utilità ODBC Manager. (ODBC Manager è installato nella cartella Utilità nella cartella
Applicazioni).
2. Selezionare la scheda DSN di sistema o DSN Utente (selezionare la scheda utilizzata durante
la configurazione).
3. Scegliere l’origine dati FileMaker configurata.
Il DSN inserito originariamente verrà visualizzato sotto Nome e ODBC FileMaker sarà il
Driver.
4. Fare clic su Configura...
5. Fare clic su Continua finché non si arriva alla pagina Conclusione.
6. Fare clic su Test.
Inserire il nome dell’account File FileMaker (in Nome utente database) e la password(in Password database).
Se viene stabilita la connessione, viene visualizzato il messaggio Test completato.
Se la connessione fallisce:

1 Assicurarsi che il file di database FileMaker Pro sia ospitato e disponibile.
1 Aggiornare o correggere le informazioni sulla connessione.
1 Assicurarsi che l’account File FileMaker utilizzi un set di privilegi con il privilegio esteso fmxdbc
per l’accesso tramite ODBC/JDBC.

1 Verificare che per l’applicazione host FileMaker Server o FileMaker Pro sia stata configurata lacondivisione tramite ODBC/JDBC.

Capitolo 5
Installazione dei driver client JDBC di FileMaker
Per accedere a un file di database FileMaker Pro ospitato come origine dati JDBC, si deve
installare il driver client JDBC. Queste istruzioni spiegano come installare il driver clientnecessario per accedere ai dati FileMaker da applicazioni di terze parti e applicazioni
personalizzate tramite JDBC. Installare il driver client sulla macchina in cui è installata
l’applicazione di terze parti.
Per gli aggiornamenti dei driver client, accedere alla pagina dei download e delle risorse
FileMaker.
Se si utilizzerà FileMaker Server per ospitare un file di database FileMaker Pro, fare in modo che
i driver client siano disponibili per gli utenti remoti.
Dopo aver installato il driver client necessario, è possibile configurarlo per accedere ai dati
FileMaker e creare query SQL per interagire con i dati.
Il driver client JDBC è la porzione di driver del software FileMaker che consente alle applicazioni
di terze parti o alle applicazioni personalizzate di accedere ai file FileMaker come origini dati
JDBC.

Requisiti software
Per installare e utilizzare i driver client JDBC, è necessario JDK 1.6 o successivo.
Per conoscere la versione di Java in esecuzione, aprire una finestra di comando (Windows) o lafinestra Terminale (macOS) e digitare java -version.

Requisiti di rete
Se si accederà ai dati FileMaker ospitati su un altro computer, sarà necessario l’accesso alla retetramite TCP/IP.

Installazione del driver client JDBC
È necessario avere l’accesso in scrittura alla cartella in cui si installa il driver client JDBC.
Installazione del driver client JDBC:
1. Eseguire una delle seguenti operazioni:

1 Windows: Se il software è stato scaricato elettronicamente, fare doppio clic sull’icona diinstallazione (file .exe).

1 macOS: Se il software è stato scaricato elettronicamente, fare doppio clic sull’icona con
l’immagine del disco (file .dmg).

1 Se si dispone di un disco di installazione, inserirlo nell’apposita unità.
2. Nella finestra FileMaker Pro o FileMaker Server, fare doppio clic sulla cartella Extra.
3. Fare doppio clic sulla cartella xDBC.
4. Nella cartella xDBC, fare doppio clic sulla cartella JDBC Client Driver Installer.

Capitolo 5 | Installazione dei driver client JDBC di FileMaker

24

5. Copiare il file fmjdbc.jar nella cartella adatta al proprio sistema operativo:

1 Windows: Copiare il file fmjdbc.jar nella cartella che contiene il file eseguibile Java (java.exe)o in un’altra cartella inclusa nel ClassPath dell’applicazione Java.

1 macOS: Copiare il file fmjdbc.jar nella cartella /Libreria/Java/Extensions o in un’altra cartella
inclusa nel ClassPath dell’applicazione Java.

A questo punto è possibile utilizzare il driver client JDBC per accedere ai dati FileMaker.

Uso del driver client JDBC
L’applicazione o l’applet Java devono registrare il driver client JDBC nella gestione driver JDBC;
inoltre, è necessario specificare l’URL (Uniform Resource Locator) JDBC corretto
nell’applicazione o nell’applet.
Importante La porta 2399 deve essere riservata per il driver client JDBC di FileMaker. Il numero
di porta è sempre 2399. Non è possibile spostare la condivisione JDBC su una porta diversa.
Vedere capitolo 6 “Utilizzo di JDBC per condividere i dati FileMaker”.

Capitolo 6
Utilizzo di JDBC per condividere i dati FileMaker
I programmatori Java possono utilizzare il driver client JDBC con qualsiasi strumento RAD (Rapid
Application Development) per creare visivamente un’applicazione o un’applet Java che si colleghi
a un’origine dati FileMaker. L’applicazione o l’applet Java che utilizza il driver client JDBC può
accedere direttamente ai dati in un file di database FileMaker Pro.

Informazioni su JDBCJDBC è un’API Java che esegue istruzioni SQL, il linguaggio standard usato per accedere ai
database relazionali. 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ò accedere ai dati in un file di database FileMaker Pro utilizzando
il driver client JDBC. Le istruzioni SQL vengono trasmesse all’host del file di database FileMaker
e i risultati di tali istruzioni vengono rispediti all’applicazione. Se si utilizza FileMaker Server comehost, il file di database FileMaker Pro utilizzato come origine dati può trovarsi su un’altra macchina(la macchina server) collegata alla rete, mentre l’applicazione client o l’applet Java si trovano sulla
propria macchina (la macchina 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 nella
gestione driver JDBC; inoltre è necessario specificare l’URL esatto di JDBC nell’applicazione onell’applet. È necessario l’URL di JDBC per effettuare la connessione al database.

Driver client JDBC
Il driver client JDBC fornisce un supporto parziale per la specifica JDBC 3.0. Le seguenti funzioni
non sono supportate dalla piattaforma FileMaker:

1
1
1
1

Istruzioni SAVEPOINT
recupero di chiavi generate automaticamente
trasferimento di parametri a un oggetto istruzione richiamabile per nome
cursori aperti

Capitolo 6 | Utilizzo di JDBC per condividere i dati FileMaker

1
1
1
1
1
1

26

recupero e aggiornamento dell’oggetto a cui si fa riferimento mediante un oggetto Ref
aggiornamento delle colonne contenenti tipi di dati CLOB, ARRAY e REF
tipo di dati booleanotipo di dati DATALINK
gruppi di trasformazione e la mappatura del tipo
relazioni tra JDBC SPI e l’architettura Connettore

Il driver client JDBC è stato testato rispetto a Java Development Kit (JDK) 1.6, 1.7 e 1.8. È un
driver Type4, un driver Java puro con protocollo originale che converte le chiamate JDBC
direttamente nel protocollo di rete usato da FileMaker Pro. Questo tipo di driver offre tutti i vantaggiJava, compresa l’installazione automatica (ad esempio, il download del driver JDBC con un’applet
che lo usa).
La classe e il punto di ingresso principale del driver è
com.filemaker.jdbc.Driver
Importante Il driver client JDBC sostituisce il driver JDBC FileMaker rilasciato con una versione
precedente del software FileMaker. Se in precedenza è stato configurato l’accesso a un’origine
dati FileMaker usando il vecchio driver, sarà necessario ridefinire l’accesso usando e
configurando il nuovo driver.
Nota Per verificare se FileMaker XDBC Listener è in esecuzione, è possibile utilizzare
Monitoraggio Attività in macOS o Task Manager in Windows per controllare lo stato del processo
XDBC Listener. Quando questo processo viene avviato, gli viene assegnato il nome
fmxdbc_listener, utilizzato anche per registrare gli eventi. Il processo XDBC Listener è distinto dalprocesso FileMaker Server. È possibile utilizzare la FileMaker Server Admin Console per arrestaree avviare il processo XDBC Listener. Vedere la Guida di FileMaker Server.

Uso di un URL JDBC per collegarsi al database
A molte risorse Java si accede attraverso gli URL. Gli URL JDBC vengono utilizzati per identificare
il database, in modo che il driver client JDBC possa riconoscere e stabilire una connessione conil database.
L’URL JDBC è composto da tre parti principali, separate dal segno di due punti:
jdbc:<protocollo secondario>:<nome secondario>
La prima parte dell’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 è filemaker. Il nome secondario è l’indirizzo IP della macchina cheospita l’origine dati FileMaker.
Registrazione del driver client JDBC e connessione a un’origine dati FileMaker (un esempio)
Di seguito è riportata una parte di un’applicazione client JDBC che:
1. Registra il driver client JDBC nella gestione driver JDBC
2. Stabilisce una connessione con l’origine dati FileMaker; l’URL JDBC è
jdbc:filemaker://192.168.1.1/database
3. Restituisce codici di errore

Capitolo 6 | Utilizzo di JDBC per condividere i dati FileMaker

Esempioimport java.sql.*;
class FMPJDBCTest{
public static void main(String[ ] args){// registra il driver client JDBC
try {Driver d =(Driver)Class.forName("com.filemaker.jdbc.Driver").newInstance();} catch(Exception e) {System.out.println(e);}// stabilisce una connessione con FileMaker
Connection con;
try {
con =
DriverManager.getConnection("jdbc:filemaker://192.168.1.1/mydatabase","username", "password");} catch(Exception e) {System.out.println(e);}// avviso connessione
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.

27

Capitolo 6 | Utilizzo di JDBC per condividere i dati FileMaker

28

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 Pro che utilizza un set di privilegi con il
privilegio esteso fmxdbc per l’accesso tramite ODBC/JDBC

1 password: la password per l’account nel file di database FileMaker Pro
Connessione URL JDBC con il nome del database specificato nell’URL
Formato:jdbc:filemaker://<indirizzo IP host filemaker>/<nome database>
Esempiojdbc:filemaker://192.168.1.1/pubblicazioni

Connessione URL JDBC con il nome del database, il nome utente e la password specificati nell’URL
Formato:jdbc:filemaker://<indirizzo IP host filemaker>/<nome database>?user=<nome utente
database>&password=<password database>
Esempiojdbc:filemaker://192.168.1.1/clienti?user=Riscossioni&password=admin

Nota Poiché l’utilizzo della e commerciale (&) è riservato in questa sintassi, non è possibile
utilizzare una e commerciale nel nome utente o nella password.
Esempi
Nome utente non valido:
jdbc:filemaker://hostlocale/vendite_db?user=ad&min&password=admin

Password non valida:jdbc:filemaker://hostlocale/vendite_db?user=admin1&password=ad&minSpecifica di un valore di timeout del socket
Per impedire al driver JDBC di mantenere la connessione per un tempo indeterminato, includere
il parametro SocketTimeout quando si specifica la stringa di connessione JDBC, indicando unvalore di timeout del socket in millisecondi.

Capitolo 6 | Utilizzo di JDBC per condividere i dati FileMaker

29

Esempio
Connection conn = DriverManager.getConnection ("jdbc:filemaker://192.168.1.1/customers?SocketTimeout=100", "admin","admin" );Soluzioni con più file di database FileMaker Pro
Se la soluzione di database FileMaker Pro utilizza molti file di database FileMaker Pro, creare un
file di database aggiuntivo che contenga tutti i riferimenti delle origini dati esterne, le ricorrenze ditabella e le relazioni necessari per la soluzione. Quindi definire questo file di database aggiuntivo
come origine dati nell’URL JDBC. Tutti i file di database FileMaker Pro devono trovarsi sullo
stesso computer.

Verifica dell’accesso tramite JDBC
Nota Non è possibile utilizzare il file di esempio FMServer_Sample per testare le connessioni
JDBC. Per fare ciò, caricare il proprio database.
Quando si verifica l’accesso a un file di database FileMaker Pro tramite JDBC, assicurarsi che:1 il file di database FileMaker Pro sia ospitato e disponibile
1 l’account File FileMaker utilizzi un set di privilegi con il privilegio esteso fmxdbc per l’accesso
tramite ODBC/JDBC

1 per l’applicazione host FileMaker Server o FileMaker Pro sia stata configurata la condivisione
tramite ODBC/JDBC

Per condividere un file di database FileMaker Pro come origine dati, utilizzare FileMaker Pro
per definire gli account che devono avere accesso al file di database. Quindi, controllarel’accesso al file di database assegnando set di privilegi agli account, compreso il privilegio
esteso fmxdbc per l’accesso tramite ODBC/JDBC. Infine, attivare la condivisione dei dati
tramite ODBC/JDBC per l’applicazione host. Per i dettagli nella Guida di FileMaker Pro o nella
Guida di FileMaker Server, visitare il Centro documentazione prodotto.

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).

Capitolo 7
Informazioni di riferimento
Funzioni di catalogo ODBCIl driver client ODBC supporta le seguenti funzioni di catalogo:

1 SQLTables—le informazioni di catalogo sono memorizzate e riportate come nomi di parti
singole (solo nome tabella)

1
1
1
1

SQLColumns
SQLColumnPrivileges
SQLDescribeCol
SQLGetTypeInfo

Metodi DatabaseMetaData JDBC
Il driver client JDBC supporta i seguenti metodi DatabaseMetaData:

1
1
1
1

getColumns
getColumnPrivileges
getMetaData

1 getTables
1 getTableTypes
1 getVersionColumns

getTypeInfo

Mappatura di campi FileMaker Pro su dati di tipo ODBC
La tabella di seguito mostra il modo in cui i tipi di campo FileMaker Pro vengono mappati sui dati
di tipo ODBC standard.
Tipo di campo
FileMaker

Converte nel tipo di dati
ODBC
Informazioni sul tipo di dati

Testo

SQL_VARCHAR

La lunghezza massima del testo di una colonna è di 1 milione dicaratteri, a meno che non si specifichi un valore Numero massimo
di caratteri inferiore per il campo Testo di FileMaker. FileMaker
restituisce le stringhe vuote come NULL.

NumeroSQL_DOUBLE

Il tipo campo Numero di FileMaker può contenere valori positivi onegativi, da 10-308 fino a 10+308, con max. 15 cifre significative.

Data

SQL_DATE

Ora

SQL_TIMEIl tipo di campo Ora FileMaker può contenere l’ora del giorno oppure
un intervallo di tempo. L’intervallo di tempo viene restituito comeun’ora del giorno, a meno non che sia inferiore a 0 o superiore a
24 ore (in entrambi i casi viene restituito un valore di 0).

Indicatore data e ora SQL_TIMESTAMP
contenitore (BLOB)

Calcolo

SQL_LONGVARBINARY

Da un campo Contenitore si possono recuperare dati binari,informazioni di riferimento al file o dati di un tipo specifico di file.
All’interno di un’istruzione SELECT utilizzare la funzione CAST() per
recuperare le informazioni di riferimento al file e la funzione
RicavaCome per recuperare i dati di un tipo specifico di file.
Il risultato viene mappato sul tipo di dati ODBC corrispondente.

Capitolo 7 | Informazioni di riferimento

31

La lunghezza delle stringhe è opzionale nelle dichiarazioni di tabella. Tutte le stringhe vengono
memorizzate e recuperate in Unicode.
Nota I campi multipli di FileMaker sono supportati come matrici.
Esempio
INSERT INTO mytable(repField[3]) VALUES (’this is rep 3’)
SELECT repField[1], repField[2] FROM mytable

Mappatura di campi FileMaker Pro su dati di tipo JDBC
Il driver client JDBC utilizza le seguenti mappature per convertire i dati di tipo FileMaker in dati
JDBC SQL.
Tipo di campo
FileMaker

Converte in tipo JDBC SQL

Testo

java.sql.Types.VARCHAR

Numerojava.sql.Types.DOUBLE

Data

java.sql.Types.DATE

Ora

java.sql.Types.TIME

Indicatore data e ora

java.sql.Types.TIMESTAMP

Contenitore

java.sql.Types.BLOB

Calcolo

specificato dal tipo di dati del risultato del calcolo

Il driver client JDBC converte i dati FileMaker di tipo Calcolo nel tipo JDBC SQL che corrisponde
al risultato del calcolo. Ad esempio, il driver client JDBC converte un calcolo FileMaker che
produce dati di tipo Indicatore data e ora in java.sql.Types.TIMESTAMP.

Tipi di dati in applicazioni a 64 bit
Nella versione a 32 bit dell’API ODBC, alcune funzioni utilizzavano parametri che potrebbero
trasferire valori interi o valori puntatore, a seconda del contesto. Nei sistemi operativi Windows a
64 bit, interi e puntatori non hanno le stesse dimensioni. La versione a 64 bit dell’API ODBC
utilizza tipi di dati astratti non definiti con dimensioni specifiche.
Le applicazioni che utilizzano valori a 32 bit possono bloccarsi se trasferite su un sistema
operativo a 64 bit. Le applicazioni che utilizzano tipi di dati astratti funzionano correttamente su
sistemi operativi sia a 32 che a 64 bit.

Messaggi di errore ODBC e JDBCDi seguito sono riportati i principali formati dei messaggi di errore che è possibile visualizzare
quando si utilizzano i dati FileMaker e ODBC/JDBC.

Messaggi di errore ODBC
I messaggi di errore possono essere generati da:

1 Errori driver ODBC
1 Errori della piattaforma FileMaker e FileMaker XDBC Listener

Capitolo 7 | Informazioni di riferimento

32

Messaggi di errore ODBC FileMaker
Un errore verificatosi in FileMaker xDBC Listener o nell’origine dati specifica il DSN utilizzando ilseguente formato:[FileMaker] [ODBC FileMaker] messaggio
Esempio[FileMaker] [ODBC FileMaker] Account/password non validi
Se si riceve un errore di questo tipo, significa che è stata eseguita un’operazione non valida
relativamente al sistema di database. Per ulteriori informazioni, consultare la documentazione dei
prodotti FileMaker oppure contattare l’amministratore del database.
Messaggi consecutivi di errore in colonne diverse possono visualizzare a volte un nome dicolonna non corretto.

Messaggi di errore JDBC
Il driver FileMaker JDBC genera errori per l’applicazione chiamante restituendo SQLExceptions.
I messaggi di errore possono essere generati da:

1 Errori driver JDBC
1 Errori della piattaforma FileMaker e FileMaker XDBC Listener
Messaggi di errore JDBC FileMaker
Un errore verificatosi in FileMaker xDBC Listener o nell’origine dati specifica il DSN utilizzando ilseguente formato:[FileMaker] [JDBC FileMaker] messaggio
Esempio[FileMaker] [JDBC FileMaker] Account/password non validi
Se si riceve un errore di questo tipo, significa che è stata eseguita un’operazione non valida
relativamente al sistema di database. Per ulteriori informazioni, consultare la documentazione dei
prodotti FileMaker oppure contattare l’amministratore del database.

Indice
Numeri
32 bitamministratore ODBC (Windows) 13
architettura 12
driver client (Windows) 13
64 bitamministratore ODBC (Windows) 14
architettura 12
driver client (Windows) 13
tipi di dati 31

A
accesso mediante privilegio esteso ODBC/JDBC 20
accesso remoto 7
account e privilegi 20
amministratore ODBC (macOS) 22
amministrazione origine dati ODBC
apertura 13
creazione di un DSN 14
verifica accesso ODBC 21
applicazione client, utilizzo di FileMaker Pro come 6

B
BLOB 31C
campi
mappatura JDBC 31
mappatura ODBC 30
campi multipli 31
campo Contenitore
mappatura tipo di dati JDBC 31
mappatura tipo di dati ODBC 30
chiavi generate automaticamente 25
condivisione, impostazione ODBC/JDBC 20
configurazione di un'origine dati FileMaker
per JDBC 28
per ODBC (macOS) 22
per ODBC (Windows) 21
cursori aperti in JDBC 25
cursori in JDBC 25

D
DATE 31
disattivazione di un file di database FileMaker Pro condiviso 8
DOUBLE 31
driver client JDBC
classe e punto di ingresso principale del driver 26
mappatura tipi di dati 31
registrazione con la gestione driver JDBC 26
specificazione dell'URL JDBC 26
verifica accesso 29

driver client ODBC
mappatura tipi di dati 30
verifica accesso (macOS) 22
verifica accesso (Windows) 21
driver client ODBC di FileMaker
macOS 16
Windows 13
driver, versioni compatibili 8
DSN
creazione (macOS) 22
creazione (Windows) 21
uno per file 8

F
file

impostazione dell'accesso a 20
organizzazione su un computer 7
formati dei messaggi di errore 31
funzione CAST 30
funzione di catalogo 30
funzione EseguiSQL 10
funzione RicavaCome 30
funzioni di catalogo ODBC 30

G

generatore di query SQL 6, 10
grafico delle relazioni 7I
importazione dei dati ODBC 9
impostazione di privilegi e condivisione 20
istruzione di script Esegui SQL 9, 10
istruzione di script Importa record 9, 10JJDBC
descrizione 25
driver client, descrizione 25
messaggi di errore 32
JDBC SPI 26
JDK (Java Development Kit) 26

MmacOS
creazione di un DSN 16
requisiti per driver client JDBC 23
verifica accesso ODBC 22
mappatura tipi di dati
driver client JDBC 31
driver client ODBC 30

34

mappatura tipo di dati
driver client JDBC 31
driver client ODBC 30
metodi DatabaseMetaData 30
metodi MetaData 30
metodo getColumnPrivileges 30
metodo getColumns 30
metodo getMetaData 30
metodo getTables 30
metodo getTableTypes 30
metodo getTypeInfo 30
metodo getVersionColumns 30
Microsoft Access 8
modifica dello schema 7
MySQL 11Nnomi colonna 21

O
ODBC
campi multipli 31
descrizione 19
messaggi di errore 31
ODBC Manager
creazione di un DSN 16
download 16
verifica accesso ODBC 22
Oracle 11
origine dati
configurazione per l'accesso tramite JDBC 28
configurazione per l'accesso tramite ODBC (macOS) 22
configurazione per l'accesso tramite ODBC (Windows) 21
disattivazione di un file di database FileMaker Pro
condiviso 8
un DSN per ogni file di database FileMaker Pro 8
verifica dell'accesso tramite JDBC 29
verifica dell'accesso tramite ODBC (macOS) 22
verifica dell'accesso tramite ODBC (Windows) 21
origini dati SQL esterneaccesso 9
versioni supportate 11

P
password
con JDBC 28
con ODBC 21, 22
porta 2399
richiesta per JDBC 24
richiesta per ODBC (macOS) 16
richiesta per ODBC (Windows) 13
porte richieste
per JDBC 24
per ODBC (macOS) 16
per ODBC (Windows) 13

privilegi estesi 20
privilegi, estesi 20
privilegio esteso fmxdbc 20, 28
proprietà del driverdriver client JDBC 28
driver client ODBC (macOS) 22
driver client ODBC (Windows) 21

Rregistrazione del driver client JDBC 26
requisiti di rete 8
requisiti di sistema
per driver client JDBC 23
per driver client ODBC 12
requisiti per l'installazione 12, 23
requisiti TCP/IP 8

Ssoluzioni runtime, limitazioni 10
SQL Server 11
SQL_DATE 30
SQL_DOUBLE 30
SQL_LONGVARBINARY 30
SQL_TIME 30
SQL_TIMESTAMP 30
SQL_VARCHAR 30
SQLColumnPrivileges 30
SQLColumns 30
SQLDescribeCol 30
SQLExceptions 32
SQLGetTypeInfo 30
SQLTables 30
strumenti RAD (Rapid Application Development) 25
supporto SAVEPOINT 25

T
testing accesso
driver client JDBC 29
driver client ODBC (macOS) 22
driver client ODBC (Windows) 21
TIME 31
TIMESTAMP 31
tipo di dati ARRAY 26
tipo di dati booleano 26
tipo di dati CLOB 26
tipo di dati DATALINK 26
tipo di dati REF 26

U
URL (Uniform Resource Locator) per il driver client JDBC 26
utilizzo di ODBC e JDBC con il software FileMaker 6

35

Vvalore nullo 30
VARCHAR 31
verifica accesso
driver client JDBC 29
driver client ODBC (macOS) 22
driver client ODBC (Windows) 21
versione Java 23

W
Windows
creazione di un DSN 21
requisiti per driver client JDBC 23
verifica accesso ODBC 21

X
XDBC Listenermessaggi di errore 31
utilizzo con JDBC 26
utilizzo con ODBC 20