A x-callback-url használata a Parancsokkal
A Parancsok támogatja az x-callback-url sémát, amellyel a meghívó alkalmazás választ (visszahívást) kaphat egy adott művelet befejezése után. Importálhat és futtathat parancsokat egy x-callback-url-ből a Parancs futtatása URL-séma használatával és Parancs importálása URL-séma használatával részben leírtakkal azonos paraméterek használatával. Egy példa:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Az x-callback-url szabványnak megfelelően a következő további paraméterek adhatók meg:
x-success (nem kötelező): A sikeres interakció esetén (például egy parancs importálása vagy futásának befejezése után) megjelenő URL. Amikor egy parancs fut, egy
resultnevű paraméter lesz hozzáfűzve az URL-hez, amely tartalmazza a parancs szöveges kimenetét.x-cancel (nem kötelező): A felhasználó által megszakított interakció esetén megjelenő URL.
x-error (nem kötelező): Hiba fellépése miatt sikertelen interakció esetén megjelenő URL. Egy
errorMessagenevű paraméter lesz hozzáadva az URL-hez, és tartalmazni fogja a hiba leírását.
Az x-success értékkel megadhat egy olyan URL-t, amely a parancs sikeres befejeződése után nyílik meg. Ez használható egy OmniFocusban lévő feladatok többlépéses ellenőrzőlistájával, amelyben megnyitja az x-callback-url-t egy parancs futtatásához, visszatér a listához, majd továbblép a következő feladatra az URL-lel.
Az x-cancel értékkel megadhat egy tartalék URL-t, amely akkor indul el, ha a parancs leáll a futás befejezése előtt. Mivel a parancs nem fejeződött be, a parancs nem adott vissza kimenetet.
Az x-error értékkel megadhat egy tartalék URL-t, amely akkor indul el, ha a parancs hibát észlel futás közben, és nem fejeződik be. Ebben az esetben használhat másik URL-t a probléma kezeléséhez.