Kestirmeler ile x-callback-url’yi kullanma
Kestirmeler, x-callback-url’yi destekleyerek, belirli bir etkileşim tamamlandığında arama uygulamasının yanıt (veya geri çağırma) almasını sağlar. URL şemasıyla kestirmeyi çalıştırma konusunda belirtilen parametreleri kullanarak bir x-callback-url’den kestirme çalıştırabilirsiniz. Örneğin:
shortcuts://x-callback-url/run-shortcut?name=Bahşiş%20Hesapla&input=text&text=24,99&x-success=...&x-cancel=...
X-callback-url standardına göre aşağıdaki ek parametreler sağlanabilir:
x-success (isteğe bağlı): Etkileşim başarılı olduğunda (ör. bir kestirme içe aktarıldıktan veya kestirmenin çalıştırılması tamamlandıktan sonra) açılan URL’dir. Kestirme çalıştırıldığında, URL’ye
resultadlı bir parametre eklenir. Bu parametre, kestirmenin metin biçimindeki çıkışını içerir.x-cancel (isteğe bağlı): Kullanıcı etkileşimden vazgeçtiğinde açılan URL’dir.
x-error (isteğe bağlı): Bir hata nedeniyle etkileşim başarısız olduğunda açılan URL’dir.
errorMessageadlı bir parametre, URL’ye eklenir. Bu parametre hata açıklamasını içerir.
x-success parametresiyle kestirme başarıyla çalıştırıldıktan sonra açılan bir URL sağlayabilirsiniz. Bu özellik, OmniFocus’ta görevlerden oluşan çok adımlı bir yapılacaklar listesiyle bağlantılı olarak kullanılabilir. Bu sayede, kestirmeyi çalıştırmak için x-callback-url’yi açıp listeye döner ve URL yoluyla bir sonraki göreve ilerlersiniz.
x-cancel parametresiyle, kestirmenin çalışmayı tamamlamadan önce durması halinde başlatılacak bir acil durum URL’si sağlayabilirsiniz. Kestirme tamamlanmadığından, kestirmeden herhangi bir çıkış sağlanmaz.
x-error parametresiyle, kestirmenin çalışma sırasında hatayla karşılaşması ve tamamlanamaması halinde başlatılacak bir acil durum URL’si sağlayabilirsiniz. Bu durumda, sorunu çözmek için farklı bir URL’yi başlatabilirsiniz.