Korištenje x-povratni poziv-url s Prečacima na iPhoneu ili iPadu
U Prečacima je podržan x-povratni poziv-url koja omogućuje pozivnoj aplikaciji primanje odgovora (povratnog poziva) kada se dovrši određena interakcija. Prečace možete pokretati radnjom x-povratni poziv-url s pomoću istih parametara koji se spominju u odjeljku Pokrenite prečac s pomoću sheme URL-a na iPhoneu ili iPadu. Na primjer:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Prema standardu radnje x-callback-url, mogu se navesti sljedeći dodatni parametri:
x-uspjeh (opcionalno): URL koji se otvara pri uspješnoj interakciji—primjerice, nakon uvoza prečaca ili završetka provedbe prečaca. Ako se pokrene prečac, URL-u se dodaje parametar naziva
resulti sadržava tekstualne izlazne informacije prečaca.x-otkazivanje (optional): URL koji se otvara kada korisnik otkaže interakciju.
x-greška (opcionalno): URL koji se otvara kada je interakcija onemogućena zbog pojavljivanja greške. Parametar naziva
errorMessagedodaje se na URL i sadrži opis greške.
S x-success možete navesti URL koji će se otvoriti nakon uspješnog pokretanja prečaca. Može se upotrebljavati u kombinaciji s popisom za provjeru zadataka s više koraka u upravitelju zadataka, u kojemu možete otvoriti x-povratni poziv-url za pokretanje prečaca, povratak na popis i prijelaz na sljedeći zadatak putem URL-a.
S pomoću radnje x-cancel možete unijeti slučajni URL koji će se pokrenuti ako se prečac prekine prije nego što pokretanje završi. Budući da prečac nije završen, iz njega se ne dobivaju izlazne informacije.
x-error vam omogućava da navedete alternativni URL za pokretanje prečaca u slučaju da prečac naiđe na grešku dok je pokrenut i iz tog se razloga ne može do kraja provesti. U tom slučaju možete pokrenuti drugi URL kako biste riješili problem.