Uporaba x-povratni poziv-url s Prečacima na Macu
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 pomoću istih parametara koji se spominju u Pokretanje prečaca pomoću sheme URL-a. Na primjer:
shortcuts://x-povratni poziv-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
result
i 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
errorMessage
dodaje 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.