![](https://help.apple.com/assets/5B296C8B680CE27831E138C3/5B296C8E680CE27831E138D3/he_IL/c10e8a839dc838a25d0feb0e9e428a0a.png)
שימוש ב-x-callback-url ב״קיצורים״
״קיצורים״ תומך ב-x-callback-url, וכך מאפשר ליישום שמתקשר לקבל תגובה (התקשרות חזרה) לאחר שאינטראקציה מסוימת הושלמה. ניתן לייבא ולהפעיל קיצורים מ-x-callback-url באמצעות אותם פרמטרים שנידונו בהפעלת קיצור באמצעות סכמת כתובת אינטרנט ויבוא קיצור באמצעות סכמת כתובת אינטרנט. לדוגמה:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
לפי סטנדרט ה-x-callback-url, ניתן לספק את הפרמטרים הנוספים הבאים:
x-success (לא חובה): כתובת אינטרנט שנפתחת כשהאינטראקציה מוצלחת - לדוגמה, לאחר שקיצור מיובא או מסיים לפעול. אם הקיצור פועל, פרמטר בשם
תוצאה
מתווסף לכתובת האינטרנט ומכיל את הפלט המילולי של הקיצור.x-cancel (לא חובה): כתובת אינטרנט שנפתחת כשהאינטראקציה מבוטלת על-ידי המשתמש/ת.
x-error (לא חובה): כתובת אינטרנט שנפתחת כשהאינטראקציה נכשלת עקב שגיאה. פרמטר בשם
errorMessage
מתווסף לכתובת האינטרנט ומכיל תיאור של השגיאה.
באמצעות x-success
, ניתן לספק כתובת אינטרנט שנפתחת אחרי שהקיצור מסיים פעולתו בהצלחה. ניתן להשתמש באפשרות זו בשילוב עם רשימה מרובת שלבים של מטלות לביצוע ב-OmniFocus, ובה הינך פותח/ת את x-callback-url להפעלת הקיצור, חוזר/ת לרשימה וממשיך למטלה הבאה דרך כתובת אינטרנט.
באמצעות x-cancel
, ניתן לספק כתובת אינטרנט חלופית להפעלה אם הקיצור עוצר לפני שהוא מסיים את פעולתו. מאחר שהקיצור לא השלים את פעולתו, הוא לא סיפק פלט כלשהו.
באמצעות x-error
, ניתן לספק כתובת אינטרנט חלופית להפעלה אם הקיצור נתקל בשגיאה בעת הפעולה ואינו יכול לסיימה. במקרה זה, ניתן לפתוח כתובת אינטרנט אחרת על-מנת לטפל בבעיה.