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.