Esecuzione di uno script con un'altra richiesta

Per eseguire uno script FileMaker come parte di un'altra richiesta, includere i parametri script.prerequest, script.presort e script nel corpo della richiesta.

Parametro	Valore
`script`	Il nome dello script da eseguire dopo l'azione specificata dalla chiamata API (ricava, crea, modifica, duplica, elimina, trova) e il successivo ordinamento.
`script.param`	La stringa di testo da utilizzare come parametro per lo script riportato in `script`.
`script.prerequest`	Il nome dello script da eseguire prima dell'azione specificata dalla chiamata API e il successivo ordinamento.
`script.prerequest.param`	La stringa di testo da utilizzare come parametro per lo script riportato in `script.prerequest`.
`script.presort`	Il nome dello script da eseguire dopo l'azione specificata dalla chiamata API, ma prima del successivo ordinamento.
`script.presort.param`	La stringa di testo da utilizzare come parametro per lo script riportato in `script.presort`.

Ordine di esecuzione degli script

È possibile specificare i parametri script.prerequest, script.presort e script in una singola chiamata API. Ogni parola chiave può essere specificata solo una volta. L'host elabora questi parametri come parte della chiamata API nel seguente ordine:

Andare al formato specificato nell'URL.
Eseguire lo script riportato in script.prerequest, se specificato.
Eseguire l'azione specificata dalla chiamata API (ricava, crea, modifica, duplica, elimina, trova).
Eseguire lo script riportato in script.presort, se specificato.
Eseguire l'ordinamento specificato nella chiamata API:
- Per Ricavare una serie di record, eseguire l'ordinamento specificato dal parametro _sort.
- Per Eseguire una richiesta di ricerca, eseguire l'ordinamento specificato dal parametro sort.
Eseguire lo script riportato in script, se specificato.
Restituire il gruppo di risultati per la chiamata API, con i parametri offset e limit applicati, se specificato.

Note

Per le chiamate che utilizzano i metodi GET HTTP e DELETE HTTP, i parametri di script sono inclusi come parametri URL; vedere Ricavare un singolo record, Ricavare una serie di record ed Eliminare un record.

Ad esempio:

https://<host>/fmi/data/v1/databases/clienti/layouts/inserimento/records/14?script=AggiornaElaborazione&script.param=14
Per le chiamate che utilizzano i metodi POST HTTP e PATCH HTTP, i parametri di script sono inclusi nel corpo della richiesta; vedere Creare un record, Modificare un record ed Eseguire una richiesta di ricerca.

Ad esempio, in una richiesta di ricerca:
Copia
```
{
  "query": [
    {
      "Titolo":"Responsabile ufficio"
    }
  ],
  "script.prerequest": "Elimina duplicati",
  "script.prerequest.param": "100"
}
```
Per le chiamate che utilizzano un metodo GET HTTP, il gruppo trovato di record restituito riflette sia il risultato della chiamata API che gli effetti di eventuali script eseguiti come parte della stessa richiesta.
Per i parametri di script script.param, script.prerequest.param e script.presort.param, è possibile specificare solo una singola stringa di testo. Per trasferire più parametri, è possibile creare una stringa che delimita i parametri e fare in modo che lo script analizzi il singolo parametro. Ad esempio, trasferire "param1|param2|param3" come elenco con il carattere "|" con codifica URL: param1%7Cparam2%7Cparam3
I risultati degli script vengono restituiti utilizzando i parametri scriptResult, scriptResult.prerequest e scriptResult.presort nei dati JSON. Il risultato di uno script è il valore restituito nell'opzione Risultato testo dell'istruzione di script Esci dallo script che termina lo script. Gli errori degli script vengono restituiti utilizzando i parametri scriptError, scriptError.prerequest e scriptError.presort nei dati JSON. (Gli errori degli script non vengono restituiti utilizzando un codice di stato HTTP).