Utiliser x-callback-url avec Raccourcis
Raccourcis prend en charge x-callback-url, ce qui permet à l’app d’appel de recevoir une réponse (un rappel) lorsqu’une interaction particulière est terminée. Vous pouvez exécuter des raccourcis à partir d’une action x-callback-url en utilisant les mêmes paramètres que ceux abordés dans Exécuter un raccourci à l’aide d’un schéma d’URL. Par ex. :
shortcuts://x-callback-url/run-shortcut?name=Calculer%20le%20pourboire&input=text&text=24.99&x-success=...&x-cancel=...
Conformément à la norme x-callback-url, les paramètres supplémentaires suivants peuvent être fournis :
x-success (facultatif) : Une URL qui s’ouvre lorsque l’interaction réussit, par exemple après l’importation ou la fin de l’exécution d’un raccourci. Si un raccourci est exécuté, un paramètre appelé
résultatest ajouté à l’URL et contient la sortie textuelle du raccourci.x-cancel (facultatif) : Une URL qui s’ouvre lorsque l’interaction est annulée par l’utilisateur.
x-error (facultatif) : Une URL qui s’ouvre lorsque l’interaction échoue en raison d’une erreur. Un paramètre appelé
errorMessageest ajouté à l’URL et contient une description de l’erreur.
Avec x-success, vous pouvez fournir une URL qui s’ouvre après que la fin de l’exécution du raccourci a réussi. Cette action pourrait être utilisée en association avec une liste de pointage de tâches à plusieurs étapes dans OmniFocus, dans laquelle vous ouvririez l’action x-callback-url pour exécuter un raccourci, retourner à la liste, puis passer à la tâche suivante par l’intermédiaire de l’URL.
Avec x-cancel, vous pouvez fournir une URL d’urgence qui s’ouvrira si le raccourci s’arrête avant la fin de son exécution. Étant donné que l’exécution du raccourci n’a pas été terminée, aucune sortie du raccourci n’est fournie.
Avec x-error, vous pouvez fournir une URL d’urgence qui s’ouvrira si le raccourci rencontre une erreur lors de son exécution et s’interrompt. Dans ce cas, vous pouvez lancer une autre URL pour gérer le problème.