Script FileMaker e FileMaker Data API

Uno script FileMaker è costituito da una o più istruzioni (istruzioni di script) definite per automatizzare operazioni ripetitive o particolarmente complesse. Se utilizzati con FileMaker Data API, gli script FileMaker possono consentire ai servizi Web di eseguire più operazioni o una serie di operazioni. Vedere Esecuzione di script FileMaker.

Per visualizzare le istruzioni di script supportate da FileMaker Data API, nell'Area di lavoro script di FileMaker Pro, fare clic sul pulsante Compatibilità e selezionare FileMaker Data API. Le istruzioni di script non disattivate sono supportate da FileMaker Data API. Alcune istruzioni di script funzionano diversamente o potrebbero non essere supportate in FileMaker Data API. Vedere Creazione e modifica degli script nella Guida di FileMaker Pro.

Gli script eseguiti da FileMaker Data API non possono eseguire script in altri file FileMaker, a meno che i file siano ospitati sullo stesso host. Gli altri file FileMaker devono avere il privilegio esteso fmrest attivato.

In FileMaker Pro, i trigger degli script possono essere attivati sia dagli script che dalle operazioni dell'utente (come ad esempio facendo clic su un campo). Nelle soluzioni FileMaker Data API, invece, i trigger di script possono essere attivati solo dagli script. Per informazioni sui trigger di script, vedere Impostazione dei trigger di script nella Guida di FileMaker Pro.

Note 

  • Considerare la quantità di dati e il numero di record che uno script potrebbe restituire e definire gli script di conseguenza. In FileMaker Pro, uno script può restituire tutti i record di una tabella o del gruppo trovato corrente. Tuttavia, se uno script restituisce tutti i record di una tabella, un servizio Web può esaurire la memoria nel tentativo di elaborarli.

  • Nelle soluzioni FileMaker Data API, il trigger di script SuAperturaPrimaFinestra non è attivato. Il trigger di script SuChiusuraUltimaFinestra è attivato solo quando uno script chiude l'ultima finestra virtuale. È possibile eseguire gli script manualmente utilizzando lo script endpoint API o includendo i parametri script.prerequest, script.presort e i parametri di script nel corpo della richiesta.

  • Utilizzare gli account e i privilegi per limitare il gruppo di script eseguibili da un servizio Web. Verificare che gli script contengano solo istruzioni di script compatibili con il Web e fornire l'accesso solo agli script che possono essere utilizzati da un servizio Web.

  • Considerare gli effetti degli script che eseguono una combinazione di istruzioni controllate dai privilegi di accesso. Ad esempio, se uno script contiene un'istruzione per eliminare i record e il servizio Web non esegue l'accesso con un account che consente tale operazione, lo script non eseguirà l'istruzione di script Elimina record. Tuttavia, l’esecuzione dello script potrebbe continuare, provocando risultati imprevisti.

  • In FileMaker Pro, utilizzare l'Area di lavoro script per garantire privilegi di accesso completo a uno script per permettere allo script di eseguire operazioni a cui non si desidera consentire l'accesso ai singoli utenti. Ad esempio, è possibile impedire agli utenti di eliminare i record con i rispettivi account e privilegi, ma consentire loro di eseguire uno script che elimini determinati record alle condizioni definite nello script.

  • Gli endpoint FileMaker Data API salvano immediatamente le modifiche ai dati, ma gli script potrebbero lasciare i record non salvati. Ad esempio, una sessione potrebbe eseguire uno script che modifica un record, ma non lo salva; la sessione successiva restituirebbe quindi un errore quando si tenta di modificare lo stesso record. Oppure, all'interno di una singola sessione, uno script potrebbe modificare un record, quindi creare una nuova finestra e richiamare un secondo script che tenta di modificare lo stesso record. Assicurarsi di verificare i risultati degli script e che non vi siano errori negli script.

  • Tutti gli script che modificano i dati devono includere l'istruzione di script Salva record/richieste perché le modifiche apportate ai dati non sono accessibili finché i dati non vengono salvati sul server. Sono incluse istruzioni di script come Taglia, Copia e Incolla. Molte azioni ad istruzione singola devono essere convertite in script per includere l’istruzione Salva record/richieste. Quando si progettano script che verranno eseguiti da un servizio Web, includere l'istruzione Salva record/richieste al termine di uno script per assicurarsi che vengano salvate tutte le modifiche.

  • Aprire tutti gli script che potrebbero essere eseguiti dagli utenti Web e assicurarsi che vengano eseguiti correttamente quando il database è ospitato come una soluzione FileMaker Data API. Verificare che lo script utilizzi solo istruzioni di script supportate da FileMaker Data API, come descritto in precedenza.