x-callback-urlin käyttäminen Oikoteiden kanssa
Oikotiet tukee x-callback-urlia, jonka avulla kutsuva appi voi saada palautteen (takaisinkutsu), kun tietty vuorovaikutus on päättynyt. Voit tuoda ja suorittaa oikoteitä x-callback-URLin avulla käyttämällä samoja parametreja, jotka mainittiin kohdassa Oikotien suorittaminen URL-rakennetta käyttämällä ja Oikotien tuominen URL-rakennetta käyttämällä. Tässä on esimerkki:
shortcuts://x-callback-url/run-shortcut?name=Laske%20tippi&input=text&text=24.99&x-success=...&x-cancel=...
X-callback-url-standardin mukaisesti voidaan käyttää seuraavia lisäparametreja:
x-success (valinnainen): URL, joka avautuu, jos vuorovaikutus onnistuu – esimerkiksi sen jälkeen, kun oikotie on tuotu tai suoritettu. Jos oikotie on suoritettu, parametri nimeltä
resultlisätään URLiin, ja se sisältää oikotien tekstituotoksen.x-cancel (valinnainen): URL, joka avautuu, jos käyttäjä peruuttaa vuorovaikutuksen.
x-error (valinnainen): URL, joka avautuu, kun vuorovaikutus epäonnistuu virheen takia. Parametri nimeltä
errorMessagelisätään URLiin, ja se sisältää virheen kuvauksen.
Lisäparametrilla x-success voit antaa URLin, joka avautuu sen jälkeen, kun oikotie on onnistuneesti suoritettu. Tätä voi käyttää OmniFocusissa monivaiheisen tarkistuslistan yhteydessä, jossa avaat x-callback-URLin oikotien suorittamista varten, palaat listaan ja siirryt sen seuraavaan kohtaan URLin kautta.
Lisäparametrilla x-cancel voit antaa vara-URLin, joka käynnistetään, jos oikotie pysähtyy ennen loppuun suorittamista. Koska oikotie keskeytyi, se ei anna mitään tuotosta.
Lisäparametrilla x-error voit antaa vara-URLin, joka käynnistetään, jos oikotiessä tapahtuu virhe suorituksen aikana eikä sitä voida suorittaa loppuun. Tässä tapauksessa voit käynnistää toisen URLin, joka käsittelee ongelman.