Utilitzar x-callback-url amb l’app Dreceres
L’app dreceres és compatible amb x-callback-url, i permet a l’app que crida rebi una resposta (un callback) quan es completa una interacció determinada. Pots importar i executar dreceres des d’un x-callback-url fent servir els mateixos paràmetres explicats a Executar una drecera amb un esquema d’URL i Importar una drecera amb un esquema URL. A continuació tens un exemple:
shortcut://x-callback-url/run-shortcut?name=Calcular%20propina&input=text&text=24,99&x-success=...&x-cancel=...
D’acord amb l’estàndard x-callback-url, es poden proporcionar els següents paràmetres addicionals:
x-success (opcional): Un URL que s’obre quan la interacció es duu a terme correctament, per exemple, després que s’hagi importat una drecera o s’hagi acabat d’executar. Si s’executa una drecera, s’insereix a l’URL un paràmetre anomenat
resultatque conté la sortida textual de la drecera.x-cancel (opcional): Un URL que s’obre quan l’usuari cancel·la la interacció.
x-error (opcional): Un URL que s’obre quan la interacció falla a causa d’un error. S’insereix un paràmetre anomenat
Missatge d’errora l’URL que conté una descripció de l’error.
Amb x-success, pots proporcionar un URL que s’obri després que la drecera s’hagi acabat d’executar correctament. Això es pot fer servir amb una llista de verificació de tasques de diversos passos a OmniFocus, on obris l’URL x-callback per executar una drecera, tornis a la llista i passis a la següent tasca per mitjà de l’URL.
Amb x-cancel, pots proporcionar un URL de contingència que s’obri si l a drecera s’atura abans d’acabar d’executar‑se. Com que la drecera no s’haurà completat, no proporcionarà cap sortida.
Amb x-error, pots proporcionar un URL de contingència que s’obri si l a drecera es troba amb un error quan s’executa i no por acabar d’executar‑se. En aquest cas, pots llançar un URL diferent per gestionar el problema.