Použití URL s daty x-callback ve Zkratkách
Zkratky podporují URL s daty x-callback, což umožňuje předat volající aplikaci odezvu (callback), jakmile je interakce dokončena. Zkratky můžete naimportovat a spustit z URL s daty x-callback s použitím týchž parametrů, které byly popsány v části Spuštění zkratky pomocí schématu URL a Import zkratky s použitím schématu URL. Tady je příklad:
shortcuts://x-callback-url/run-shortcut?name=Calculate Tip&input=text&text=24.99&x-success=...&x-cancel=...
Prostřednictím standardu x-callback-url lze zadat následující doplňkové parametry:
x-success (volitelné): URL, které se otevře, pokud je interakce úspěšná – například po naimportování nebo dokončení zpracování zkratky. Jakmile je zkratka spuštěna, je k URL připojen parametr
result, obsahující textový výstup zkratky.x-cancel (volitelné): URL, které se otevře, když je interakce zrušena uživatelem.
x-error (volitelné): URL, které se otevře, když se interakce nezdaří následkem chyby. K URL je připojen parametr
errorMessageobsahující popis chyby.
Pomocí parametru x-success můžete zadat URL, které se otevře, pokud je zpracování zkratky úspěšně dokončeno. Tento parametr lze použít v kombinaci s vícekrokovým kontrolním seznamem úloh v aplikaci OmniFocus, v níž otevřete x-callback-url pro spuštění zkratky, návrat do seznamu a přechod na následující úlohu prostřednictvím URL.
Pomocí parametru x-cancel můžete zadat URL pro nepředvídané události, které se spustí v případě, že se zpracování zkratky před dokončením zastaví. Vzhledem k tomu, že zpracování zkratky nebylo dokončeno, není z ní k dispozici žádný výstup.
Pomocí parametru x-error můžete zadat URL pro nepředvídané události, které se spustí, když se při zpracování zkratky vyskytne chyba a zpracování se nedokončí. V takovém případě můžete spustit jiné URL umožňující potíže vyřešit.