Aggiornamento dei plug-in

Transcript

Aggiornamento dei plug-in
FileMaker Server 11
®
Guida all'aggiornamento dei plug-in
© 2010 FileMaker, Inc. Tutti i diritti riservati.
FileMaker, Inc. 
5201 Patrick Henry Drive
Santa Clara, California 95054
FileMaker è un marchio di FileMaker, Inc. registrato negli Stati Uniti e in altri Paesi. Il logo della cartella dei file è un marchio di
FileMaker, Inc. Tutti gli altri marchi appartengono ai rispettivi proprietari.
La documentazione di FileMaker è protetta da copyright. Non è permesso fare copie o distribuire questa documentazione senza previa
autorizzazione scritta di FileMaker. È possibile utilizzare la presente documentazione soltanto unitamente a una copia del software
FileMaker concessa in licenza.
Tutte le persone, 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 sono elencati nei documenti Riconoscimenti forniti insieme con questo software.
I prodotti di terze parti e gli URL sono citati unicamente a scopo informativo e non costituiscono obbligo o raccomandazione. FileMaker,
Inc. non si assume alcuna responsabilità nei confronti delle prestazioni di questi prodotti.
Per ulteriori informazioni, visitate il nostro sito Web all'indirizzo www.filemaker.com/it/.
Edizione: 01
Sommario
Aggiornamento dei plug-in
Modalità di funzionamento dello scaricamento automatico
Il plug-in richiesto non è presente sul computer client
Il plug-in richiesto sul computer client è obsoleto
Preparazione dei plug-in Mac OS con fork di risorse in corso per l'aggiornamento automatico
Dove memorizzare i plug-in su FileMaker Server
Windows
Mac OS
Impostazione della funzione di aggiornamento automatico nel proprio database
Panoramica
Per impostare la funzione di verifica della versione dei plug-in sul proprio database
Funzioni esterne
FMSAUC_Version
FMSAUC_ FindPlugIn
FMSAUC_UpdatePlugIn
6
6
7
8
9
9
10
11
11
11
12
13
13
14
4
Guida all'aggiornamento dei plug-in di FileMaker Server
Aggiornamento dei plug-in
Questa guida spiega come utilizzare la funzione di aggiornamento automatico in FileMaker® Server.
La funzione di aggiornamento automatico garantisce che gli utenti dei database FileMaker Pro dispongano
della versione più aggiornata del software del plug-in sui loro computer. I plug-in possono essere scaricati
da FileMaker Server includendo le funzioni di aggiornamento automatico negli script definiti dall'utente
salvati con i file dei database FileMaker Pro. Di seguito viene descritta la prestazione Auto Update, viene
fornito un esempio di script e vengono descritte le relative funzioni.
Per comprendere il contenuto di questa guida è necessario conoscere le procedure per la definizione
dei campi e degli script e l'uso dei plug-in nei file di database FileMaker Pro.
Per informazioni sulla creazione di plug-in, vedere "Sviluppo di plug-in di terze parti" nella Guida allo
sviluppo FileMaker Pro Advanced . Il CD di FileMaker Pro Advanced - o il download elettronico comprendono un plug-in di esempio che è possibile modificare per includere funzioni esterne.
Quando si distribuiscono database FileMaker Pro in ambienti server/client, è possibile installare gli
eventuali plug-in richiesti dal database su ogni computer client che accede al database. Se si modifica
un plug-in, il plug-in aggiornato deve essere distribuito a tutti i computer client che accedono al database.
In una struttura di grandi dimensioni, l'aggiornamento manuale dei computer client può richiedere molto
tempo. È possibile usare la prestazione Auto Update, disponibile in FileMaker Server, per scaricare
automaticamente i file aggiornati.
L'illustrazione seguente mostra come utilizzare la funzione di aggiornamento automatico per controllare
che sui computer client e server sia presente il plug-in richiesto dal database.
Avvio
Il plug-in di
Aggiornamento
automatico è abilitato sul
computer client?
No
Errore: plug-in
mancante o disattivato
No
Il plug-in necessario
è installato sul computer
server?
Sì
Il plug-in necessario
è installato sul computer
client?
Sì
Non fare nulla
Errore: plug-in
mancante
No
Errore: plug-in
mancante
Sì
Sì
La versione del plug-in
è corretta?
No
No
La versione
del plug-in è quella
richiesta dal database?
Sì
Scaricare il plug-in sul
computer client e attivarlo
6
Guida all'aggiornamento dei plug-in di FileMaker Server
Affinché l'aggiornamento automatico funzioni correttamente, è necessario:
1. Assicurarsi che il plug-in di aggiornamento automatico sia installato e abilitato su ogni client FileMaker.
2. Impostare il database in modo che richiami le funzioni esterne fornite dal Plug-in Auto Update.
Queste funzioni verificano l'esistenza dei plug-in richiesti sui computer client e server e, se necessario,
ne effettuano lo scaricamento.
3. Ricordare all'amministratore del server di attivare l'aggiornamento automatico in FileMaker Server.
Questa funzione può essere abilitata nella Admin Console di FileMaker Server facendo clic su Server
database > scheda Client FileMaker Pro, e quindi selezionando Consenti ai client FileMaker Pro di
scaricare aggiornamenti automaticamente.
4. L'amministratore FileMaker Server deve inserire i plug-in nella cartella AutoUpdate sul computer server
per permettere agli altri utenti di scaricarli.
Nota I plug-in Mac OS devono essere convertiti in formato .tar prima di essere messi sul computer
FileMaker Server per l'aggiornamento automatico nei seguenti casi:
1 sul computer server è in esecuzione Windows
1 il plug-in ha un formato vecchio che contiene un fork di risorse (verificare con il produttore del plug-in)
Se ci si trova in uno dei casi descritti, vedere la sezione "Preparazione dei plug-in Mac OS con fork di
risorse in corso per l'aggiornamento automatico" a pagina 8.
Modalità di funzionamento dello scaricamento automatico
La funzione di aggiornamento automatico garantisce che i client dispongano dei plug-in correnti, risolvendo
due situazioni:
1 Il client apre il database per la prima volta, ma il plug-in richiesto dal database non esiste sul computer
client.
1 Il client ha già aperto il database, ma dispone di una versione obsoleta di uno dei plug-in richiesti e
necessita quindi di un aggiornamento.
Le sezioni che seguono descrivono la sequenza generale di eventi che si verificano nel caso di plug-in
mancanti o obsoleti sul computer client.
Il plug-in richiesto non è presente sul computer client
Il computer client avvia FileMaker Pro e tenta di aprire il database ospitato da FileMaker Server. Gli script
che sono stati definiti nel relativo database eseguono le funzioni esterne per la funzione di aggiornamento
automatico nell'ordine seguente:
1. Viene eseguita la funzione esterna FMSAUC_Version, che restituisce il nome e la versione del Plug-in
Auto Update disponibile sul computer client FileMaker Pro. Se non vengono restituite informazioni sul
plug-in, questo viene ritenuto mancante o disattivato sul computer client.
2. Viene eseguita la funzione esterna YourPlugIn_Version, che restituisce il nome e la versione del plug-in
del computer client che verrà usato nel database. Se non vengono restituite informazioni sulla versione
del plug-in, questo viene ritenuto mancante o disattivato sul computer client.
|
Modalità di funzionamento dello scaricamento automatico
7
3. Viene eseguita la funzione esterna FMSAUC_FindPlugIn, che ricerca le versioni del plug-in nella
cartella AutoUpdate e nella cartella predefinita del database del server. Questa funzione restituisce
una stringa, delimitata da spazi, che elenca tutte le versioni di plug-in disponibili.
4. In questa stringa viene ricercata la versione restituita dalla funzione YourPlugIn_Version.
Se YourPlugIn_Version non restituisce informazioni sulla versione, è possibile che la versione
sul server sia più recente della versione del plug-in sul computer client.
5. Se l'opzione di restituire l'ultima versione del plug-in è abilitata, la funzione esterna
FMSAUC_UpdatePlugIn inserisce il plug-in necessario nella cartella Extensions di FileMaker
dell'utente corrente come indicato di seguito:
Su questo sistema
operativo:
Il plug-in è memorizzato in questa cartella:
Windows XP
C:\Documents and Settings\nome_utente\Impostazioni locali\Dati
applicazioni\FileMaker\Extensions\
Windows Vista
C:\users\nome_utente\AppData\Local\FileMaker\Extensions\
Windows 7
C:\users\nome_utente\AppData\Local\FileMaker\Extensions\
Mac OS X
Macintosh HD/Users/nome_utente/Libreria/Application Support/FileMaker/Extensions/
All'avvio, FileMaker Pro carica prima i plug-in memorizzati nella cartella Extensions di FileMaker
dell'utente corrente. Se non trova un determinato plug-in nella cartella, FileMaker Pro lo cerca nella
cartella Extensions dell'applicazione FileMaker Pro.
Note
1 Ricercare il plug-in per nome e numero di versione, separati da uno spazio. Poiché gli spazi sono usati
come delimitatori di funzioni, i nomi e le versioni dei plug-in non possono contenere spazi incorporati.
1 Se si cerca di aggiornare la funzione di aggiornamento automatico usando la funzione stessa, l'ambiente
può diventare instabile e bloccarsi.
Il plug-in richiesto sul computer client è obsoleto
Il computer client avvia FileMaker Pro e tenta di aprire il database ospitato da FileMaker Server. Gli script
che sono stati definiti nel relativo database eseguono le funzioni esterne per la funzione di aggiornamento
automatico nell'ordine seguente:
1. Viene eseguita la funzione esterna FMSAUC_Version, che restituisce il nome e la versione del Plug-in
Auto Update disponibile sul computer client FileMaker Pro. Se non vengono restituite informazioni sul
plug-in, questo viene ritenuto mancante o disattivato sul computer client.
2. Viene eseguita la funzione esterna YourPlugIn_Version, che restituisce il nome e la versione del plug-in
del computer client che verrà usato nel database. Se non vengono restituite informazioni sulla versione
del plug-in, questo viene ritenuto mancante o disattivato sul computer client.
3. Viene eseguita la funzione esterna FMSAUC_FindPlugIn, che ricerca le versioni del plug-in nella
cartella AutoUpdate e nella cartella predefinita del database del server e restituisce una stringa che elenca
tutte le versioni disponibili del plug-in.
8
Guida all'aggiornamento dei plug-in di FileMaker Server
4. In questa stringa viene ricercata la versione restituita dalla funzione YourPlugIn_Version. In questo caso,
la versione del plug-in sul server è più recente di quella sul client, pertanto la versione sul server è
superiore rispetto alla versione del plug-in sul computer client.
5. La funzione esterna FMSAUC_UpdatePlugIn inserisce il plug-in richiesto nella cartella Extensions
di FileMaker dell'utente corrente come indicato di seguito:
Su questo sistema
operativo:
Il plug-in è memorizzato in questa cartella:
Windows XP
C:\Documents and Settings\nome_utente\Impostazioni locali\Dati
applicazioni\FileMaker\Extensions\
Windows Vista
C:\users\nome_utente\AppData\Local\FileMaker\Extensions\
Windows 7
C:\users\nome_utente\AppData\Local\FileMaker\Extensions\
Mac OS X
Macintosh HD/Users/nome_utente/Libreria/Application Support/FileMaker/Extensions/
Il plug-in obsoleto viene spostato nella cartella Extensions\Saved.
All'avvio, FileMaker Pro carica prima i plug-in memorizzati nella cartella Extensions di FileMaker
dell'utente corrente. Se non trova un determinato plug-in nella cartella, FileMaker Pro lo cerca nella
cartella Extensions dell'applicazione FileMaker Pro.
Preparazione dei plug-in Mac OS con fork di risorse in corso per
l'aggiornamento automatico
Su Mac OS FileMaker Server converte temporaneamente il plug-in Mac OS non compresso in formato .tar
per lo scaricamento sui client. Tuttavia, questa conversione automatica elimina i fork di risorse, che possono
rendere il plug-in che conteneva il fork di risorse inutilizzabile da parte del client.
I file di plug-in Mac OS che contengono un fork di risorse richiedono operazioni speciali per funzionare
correttamente con l'aggiornamento automatico:
1 È necessario comprimere manualmente il plug-in prima di metterlo su FileMaker Server.
1 Il client FileMaker Pro Mac OS che utilizza l'aggiornamento automatico con questo plug-in deve avere
StuffIt Expander installato per decomprimere automaticamente il plug-in.
Per comprimere manualmente un plug-in contenente un fork di risorse:
1. Utilizzare un'utilità di terze parti come StuffIt Standard per comprimere manualmente l'intero plug-in
di Mac OS in un file singolo come un archivio .sitx. Per comprimere i file con fork di risorse è possibile
utilizzare qualsiasi utilità poiché StuffIt Expander può decomprimere automaticamente il file di output.
2. Rinominare .tar il file compresso che termina con .sitx o con altra estensione. Ad esempio, se il plug-in
si chiama test.fmplugin e il file compresso si chiama test.fmplugin.sitx, quest'ultimo
deve essere rinominato test.fmplugin.tar.
3. Collocare il plug-in compresso sul computer server nella cartella appropriata. Vedere "Dove
memorizzare i plug-in su FileMaker Server" a pagina 9.
Importante Per espandere il plug-in compresso in modo speciale è necessario che StuffIt Expander sia
installato sul computer client Mac OS. L'aggiornamento automatico richiama automaticamente StuffIt
Expander dopo aver scaricato il plug-in.
|
Dove memorizzare i plug-in su FileMaker Server
9
Dove memorizzare i plug-in su FileMaker Server
È necessario memorizzare i plug-in nelle seguenti cartelle di un server:
Il nome della cartella
principale del plug-in deve
avere lo stesso nome del
plug-in.
Cartella AutoUpdate
La sottocartella che contiene
il plug-in deve avere lo
stesso nome del numero
della versione del plug-in
Cartella principale plug-in
Sottocartella contenente il file di plug-in
Plug-in
Struttura delle cartelle del plug-in
Windows
Per memorizzare file di plug-in su un server Windows, creare una cartella con il nome del plug-in nella
cartella AutoUpdate e una sottocartella per ogni versione del plug-in. Memorizzare il file del plug-in nella
relativa sottocartella.
Esempi:
C:\Programmi \FileMaker\FileMaker Server\Data\Databases\AutoUpdate
\FMS_Sample_PlugIn\1.0\
C:\Programmi \FileMaker\FileMaker Server\Data\Databases\AutoUpdate
\FMS_Sample_PlugIn\1.0\FMS_Sample_PlugIn.fmx
C:\Programmi \FileMaker\FileMaker Server\Data\Databases\AutoUpdate
\FMS_Sample_PlugIn\1.0\FMS_Sample_PlugIn.fmplugin.tar
C:\Programmi \FileMaker\FileMaker Server\Data\Databases\AutoUpdate
\FMS_Sample_PlugIn\2.0\FMS_Sample_PlugIn.fmx
C:\Programmi \FileMaker\FileMaker Server\Data\Databases\AutoUpdate
\FMS_Sample_PlugIn\2.0\FMS_Sample_PlugIn.fmplugin.tar
Nota Quando i plug-in Mac OS sono memorizzati su un server Windows da utilizzare con client Mac OS
devono essere memorizzati in formato .tar. Per ulteriori informazioni su come archiviare file con questo
formato avviare l'applicazione Mac OS Terminale, al prompt digitare man tar al prompt e vedere
"Preparazione dei plug-in Mac OS con fork di risorse in corso per l'aggiornamento automatico" a pagina 8.
10
Guida all'aggiornamento dei plug-in di FileMaker Server
Mac OS
Per memorizzare file di plug-in su un server Mac OS, creare una cartella con il nome del plug-in nella
cartella AutoUpdate e una sottocartella per ogni versione del plug-in. Memorizzare il file del plug-in nella
relativa sottocartella.
Esempi:
/Libreria/FileMaker Server/Data/Databases/AutoUpdate/FMS_Sample_PlugIn
/1.0/
/Libreria/FileMaker Server/Data/Databases/AutoUpdate/FMS_Sample_PlugIn
/1.0/FMS_Sample_PlugIn.fmx
/Libreria/FileMaker Server/Data/Databases/AutoUpdate/FMS_Sample_PlugIn
/1.0/FMS_Sample_PlugIn.fmplugin.tar
/Libreria/FileMaker Server/Data/Databases/AutoUpdate/FMS_Sample_PlugIn
/2.0/FMS_Sample_PlugIn.fmx
/Libreria/FileMaker Server/Data/Databases/AutoUpdate/FMS_Sample_PlugIn
/2.0/FMS_Sample_PlugIn.fmplugin.tar
Importante Per poter funzionare correttamente in Mac OS, i plug-in e le cartelle in cui sono memorizzati
devono disporre delle stesse autorizzazioni:
File o cartella
Raggruppa
Autorizzazioni
Cartella principale plug-in
fmsadmin
Lettura ed esecuzione per gruppo
Sottocartella contenente il plug-in
fmsadmin
Lettura ed esecuzione per gruppo
File plug-in
fmsadmin
Lettura ed esecuzione per gruppo
Per cambiare le autorizzazioni per i file plug-in su un server Mac OS:
1. Lanciare l'applicazione Terminale ([Unità]/Applicazioni/Utilità/Terminale).
2. Selezionare la cartella principale del file o la cartella di cui modificare le autorizzazioni ed inserire quanto
segue nella riga di comando:
chmod g+rx <nomefile o cartella>
oppure
chmod g+wrx <nomefile o cartella>
Il g+rx è necessario perché gli script e i plug-in devono avere i bit eseguibili e di lettura di gruppo
abilitati. Utilizzare il modello g+wrx per consentire anche autorizzazioni di scrittura. Alcuni plug-in
o script che utilizzano preferenze o cartelle di file aggiuntivi possono richiedere lfautorizzazione di
scrittura per tali file o cartelle.
|
Impostazione della funzione di aggiornamento automatico nel proprio database
11
Impostazione della funzione di aggiornamento automatico nel proprio
database
Sono disponibili diversi metodi per impostare la funzione di aggiornamento automatico nel proprio
database. La presente documentazione ne descrive uno che utilizza semplici istruzioni di script e campi
globali e si basa sul file di esempio denominato AutoUpdatePlugin.fp7 installato con FileMaker Server.
Panoramica
Per impostare la funzione di verifica della versione dei plug-in sul proprio database, è necessario scrivere
alcune semplici istruzioni di script che vengono eseguite ogni volta che un computer client apre il proprio
database. La prima istruzione indirizza FileMaker Pro verso un formato start-up, contenente campi globali
che memorizzano le informazioni sulla versione relative ai requisiti di plug-in del proprio database.
Questo script ne richiama un altro noto come Run Plug-in Scripts, che, a sua volta, richiama script secondari
che ricercano il plug-in richiesto sui computer server e client, raccoglie i numeri di versione dei plug-in che
esistono in queste posizioni, li confronta, e se necessario, scarica un plug-in aggiornato dal server.
Per impostare la funzione di verifica della versione dei plug-in sul proprio database
1. Aprire il database utilizzando FileMaker Pro e attivare il plug-in di aggiornamento automatico nella
finestra di dialogo Preferenze.
Nota Ricordare all'amministratore del server di attivare l'aggiornamento automatico nell'Admin Console
di FileMaker Server, Server database > scheda Client FileMaker Pro, per consentire ai client
FileMaker Pro di scaricare gli aggiornamenti automaticamente.
2. Creare un formato che contenga:
1 campi globali in cui raccogliere informazioni sulla versione di plug-in o codici risultato
1 un pulsante che esegua manualmente gli script per la creazione di un file di informazioni sulla
versione del plug-in da memorizzare sul server
Per un formato di esempio che contenga tutti i campi e i pulsanti necessari, fare riferimento al formato
STARTUP nel file di esempio AutoUpdatePlugin.fp7.
3. Scrivere uno script che utilizzi la funzione FMSAUC_Version, che restituisca il nome e la versione
del Plug-in Auto Update disponibile in FileMaker Pro. Se la stringa con il nome e la versione non viene
restituita, FileMaker Pro presuppone che il plug-in di aggiornamento automatico sia mancante oppure
non attivato sul computer client.
4. Scrivere uno script che utilizzi la funzione YourPlugIn_Version per verificare la versione del plug-in sul
computer client e inserire le informazioni sulla versione nel campo globale denominato Local_Version
nel proprio formato di aggiornamento automatico.
Per un esempio di sintassi di script, fare riferimento allo script Local Plug-in Check nel file di esempio
AutoUpdatePlugin.fp7. Nella documentazione relativa al plug-in di terze parti è necessario includere
informazioni sulla propria funzione YourPlugIn_Version.
12
Guida all'aggiornamento dei plug-in di FileMaker Server
5. Scrivere uno script che utilizzi la funzione FMSAUC_FindPlugIn per verificare la versione del plug-in
sul computer server e inserire le informazioni sulla versione nel campo globale denominato
Remote_Version nel proprio formato di aggiornamento automatico.
Per un esempio di sintassi di script, fare riferimento allo script Remote Plug-in Check nel file di esempio
AutoUpdatePlugin.fp7. Per informazioni sulla funzione FMSAUC_FindPlugIn, vedere "FMSAUC_
FindPlugIn" a pagina 13.
6. Scrivere uno script che converta le informazioni sulla versione in formato numerico e inserisca i risultati
dell'operazione in campi globali addizionali nel proprio formato di aggiornamento automatico.
La conversione in formato numerico è necessaria ai fini di un confronto delle informazioni di versione
del plug-in raccolte dai computer server e client.
Per un esempio di sintassi di script, fare riferimento allo script Get Version Numbers nel file di esempio
AutoUpdatePlugin.fp7. 
Per informazioni sulla funzione RicavaComeNumero, vedere la Guida di FileMaker Pro.
7. Scrivere uno script per scaricare il plug-in dal computer server se non ne esiste una versione sul computer
client oppure se quella esistente è obsoleta.
Per un esempio di sintassi di script, fare riferimento allo script Download Plug-In nel file di esempio
AutoUpdatePlugin.fp7. Per informazioni sulla funzione FMSAUC_UpdatePlugIn, vedere
"FMSAUC_UpdatePlugIn" a pagina 14.
8. Scrivere uno script "parent" per:
1 accertarsi che il Plug-in Auto Update esista e sia attivato sul computer client
1 eseguire gli script di verifica della versione individuale e di scaricamento scritti in precedenza
Per un esempio di sintassi di script, fare riferimento allo script Run Plug-in Scripts nel file di esempio
AutoUpdatePlugin.fp7. Per informazioni sulla funzione FMSAUC_Version, vedere
"FMSAUC_Version" a pagina 13.
Funzioni esterne
La funzione di aggiornamento automatico è costituita dalle funzioni esterne descritte di seguito.
Nota Queste funzioni sono disponibili in FileMaker Pro soltanto se il Plug-in Auto Update è installato
sul proprio computer ed attivato nella scheda Plug-In della finestra Preferenze.
Funzione
Operazione eseguita
FMSAUC_Version
Restituisce il nome e la versione del plug-in di aggiornamento automatico che esiste nella cartella
Extensions sul computer client. Se non viene restituita nessuna versione, FileMaker Pro
presuppone che il plug-in sia mancante o non abilitato sul computer client.
FMSAUC_FindPlugIn
Restituisce una stringa con l'elenco delle versioni del plug-in situate nella cartella AutoUpdate o
nella cartella predefinita del database sul computer server. Se non viene restituita nessuna stringa,
FileMaker Pro presuppone che il plug-in non esista sul computer server.
FMSAUC_UpdatePlugIn
Scarica un file di plug-in dalla cartella AutoUpdate o dalla cartella di database di default del
computer server, oppure restituisce un codice di errore se non è possibile scaricare il file.
|
Funzioni esterne
13
FMSAUC_Version
Formato
FMSAUC_Version()
Parametri
Intero costante; 0
Tipo di dati restituito
Testo
Descrizione
Questa funzione restituisce la stringa con il nome e la versione del plug-in di
aggiornamento automatico situato nella cartella Extensions dell'utente corrente
sul computer client. Se non viene trovata nessuna stringa, FileMaker Pro
presuppone che il plug-in di aggiornamento automatico sia mancante o non
abilitato sul computer client.
Esempio
FMSAUC_Version(0)
FMSAUC_ FindPlugIn
Formato
FMSAUC_FindPlugIn("nome plug-in")
Parametri
nome plug-in – il nome del file plug-in. Il parametro deve essere compreso
tra virgolette.
Tipo di dati restituito
Testo
Descrizione
Questa funzione restituisce una stringa con l'elenco delle versioni del plug-in
situate nella cartella AutoUpdate di FileMaker Server o nella cartella predefinita
del database. Se non è possibile trovare il plug-in, la funzione restituisce il
valore –1 (meno 1).
FileMaker Server ricerca il plug-in in due punti. In primo luogo, ricerca il file
nella cartella AutoUpdate situata nella stessa cartella che contiene il database
ospitato. Se non vi trova il file, cerca una cartella di aggiornamento automatico
situata nella cartella predefinita del database FileMaker Server.
Esempio
L'esempio riportato di seguito mostra come specificare la funzione esterna
FMSAUC_FindPlugIn all'interno di un'istruzione di script Imposta campo.
L'istruzione di script Imposta campo consente di restituire il risultato di un
calcolo in un campo singolo. Per ulteriori informazioni sulle istruzioni di script
e sulle funzioni di FileMaker Pro, vedere la Guida di FileMaker Pro.
Imposta campo [dbname::Remote_Version;
FMSAUC_FindPlugIn("SamplePlugIn")]
Questo esempio restituisce le versioni nel seguente formato:
1.0 1.2 1.5 2.0 3.3...
14
Guida all'aggiornamento dei plug-in di FileMaker Server
FMSAUC_UpdatePlugIn
Formato
FMSAUC_UpdatePlugIn("nome plug-in versione")
Parametri
nome versione plug-in – il nome del plug-in o del file di supporto
da scaricare e il numero della versione del plug-in. Il parametro deve essere
compreso tra virgolette.
Nota Il nome del plug-in e il numero di versione devono essere separati da uno
spazio.
Tipo di dati restituito
Testo
Descrizione
Questa funzione scarica il plug-in o il file di supporto specificato dal computer
server al computer client. FileMaker Server ricerca il plug-in in due punti.
In primo luogo, ricerca il file nella cartella AutoUpdate situata nella stessa
cartella che contiene il database ospitato. Se non vi trova il file, cerca una
cartella di aggiornamento automatico situata nella cartella predefinita del
database FileMaker Server.
Esempio
FMS_UpdatePlugIn("SamplePlugIn 1.5").
Se nella cartella Extensions del computer client esiste un file con lo stesso nome,
questo viene spostato nella cartella Extensions\Saved. Se questo file è un plug-in,
viene disattivato in FileMaker Pro prima di essere spostato. Il file appena
scaricato viene quindi copiato nella cartella Extensions FileMaker dell'utente
corrente e, se si tratta di un plug-in, attivato.
Se lo scaricamento del file ha esito positivo, la funzione restituisce il valore
0 (zero). Altrimenti, la funzione restituisce uno dei codici di errore elencati nella
seguente tabella.
Codice di
errore
Descrizione
–1
Il file da scaricare risulta mancante nella cartella temporanea
–2
Non è stato possibile creare sul computer client la cartella Extensions\Saved che contiene il backup del plug-in o del
file di supporto obsoleto
–3
Non è stato possibile eliminare il file da sostituire sul computer client dalla cartella Extensions FileMaker dell'utente
corrente
–4
Non è stato possibile spostare il file da sostituire nella cartella Extensions\Saved
–5
Il file scaricato non può essere copiato nella cartella Extensions FileMaker dell'utente corrente
–6
Il file scaricato deve essere un file plug-in
3
Il plug-in aggiornamento automatico è disabilitato nella console Admin di FileMaker Server.
5
Il file da scaricare non risulta presente nella cartella AutoUpdate sul computer FileMaker Server
6
Si è verificato un errore sul computer su cui viene eseguito FileMaker Server durante lo scaricamento del file
100
La definizione della funzione esterna per FMSAUC_UpdatePlugIn contiene un parametro non valido o vuoto
101
Il richiamo della funzione dal computer client al computer su cui viene eseguito FileMaker Server ha avuto esito
negativo. È probabile che il computer server stia utilizzando una versione precedente di FileMaker Server.
Se durante la procedura di scaricamento si verifica un errore, la funzione FMSAUC_UpdatePlugIn tenta di
ripristinare tutti i file riportandoli allo stato in cui si trovavano al momento dell'esecuzione del richiamo della
funzione. Se un plug-in esistente è stato disattivato e spostato nella cartella Extensions\Saved, viene riportato
nella cartella Extensions FileMaker dell'utente corrente e riattivato in FileMaker Pro sul computer client.