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.