Utilizzare x-callback-url con Comandi Rapidi
Comandi Rapidi supporta lāazione x-callback-url, consentendo allāapp che sta chiamando di ricevere una risposta (una richiamata) quando unāinterazione specifica ĆØ completa. Puoi importare ed eseguire un comando da un x-callback-url utilizzando i medesimi parametri indicati in Eseguire un comando rapido utilizzando uno schema URL e Importare un comando rapido utilizzando uno schema URL. Ecco un esempio:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Per lo standard x-callback-url, possono essere forniti i seguenti parametri aggiuntivi:
x-success (facoltativo): un URL che si apre quando lāinterazione va a buon fine, ad esempio, dopo lāimportazione o il termine dellāesecuzione di un comando rapido. Se viene eseguito un comando rapido, un parametro chiamato
risultatoviene aggiunto allāURL e contiene lāoutput testuale del comando rapido.x-cancel (facoltativo): un URL che si apre quando lāinterazione viene cancellata dallāutente.
x-error (facoltativo): un URL che si apre quando lāinterazione fallisce a causa di un errore. Viene aggiunto allāURL un parametro chiamato
errorMessageche contiene una descrizione dellāerrore.
Con x-success, puoi fornire un URL che si apre dopo che il comando rapido termina lāesecuzione corretta. Lāopzione puĆ² essere usata in concomitanza con un elenco di verifica di azioni con piĆ¹ passi in OmniFocus, in cui apri x-callback-url per eseguire un comando rapido, tornare allāelenco e passare allāattivitĆ successiva tramite lāURL.
Con x-cancel, puoi fornire un URL di contingenza da lanciare nel caso in cui il comando rapido si interrompa prima di terminare lāesecuzione. Siccome il comando rapido non ĆØ stato completato, non viene fornito alcun output per il comando rapido.
Con x-error, puoi fornire un URL di contingenza da lanciare nel caso in cui il comando rapido trovi un errore durante lāesecuzione e non la porti a termine. In questo caso, puoi lanciare un URL diverso per gestire il problema.