Использование x-callback-url в программе «Быстрые команды»
Программа «Быстрые команды» поддерживает x-callback-url, что позволяет вызывающей программе получить ответ (callback) по завершении определенного типа взаимодействия. Можно использовать x-callback-url для импорта и запуска быстрых команд, задавая значения для тех же параметров, которые описаны в разделах Запуск быстрой команды с использованием схемы URL и Импорт быстрой команды с использованием схемы URL. Пример:
shortcuts://x-callback-url/run-shortcut?name=Расчет%20чаевых&input=text&text=24,99&x-success=...&x-cancel=...
Согласно стандарту x-callback-url, можно также указать значения для следующих дополнительных параметров:
x-success (необязательно). URL-адрес, который открывается в случае успешного завершение взаимодействия — например, после импорта быстрой команды или завершения ее выполнения. При выполнении быстрой команды параметр
result
добавляется в конец URL-адреса. Значение этого параметра — текст, получаемый в выходных данных быстрой команды.x-cancel (необязательно). URL-адрес, который открывается, когда взаимодействие отменяется пользователем.
x-error (необязательно). URL-адрес, который открывается, когда во время взаимодействия происходит сбой в результате ошибки. Параметр
errorMessage
добавляется в конец URL-адреса. Значение этого параметра — описание произошедшей ошибки.
Используя параметр x-success
, можно указать URL-адрес, который откроется, когда выполнение быстрой команды завершится успешно. Эту возможность можно использовать в сочетании с многоступенчатыми контрольными списками задач в программе OmniFocus, работая в которой, можно открыть x-callback-url, чтобы запустить быструю команду, вернуться к списку и перейти к следующей задаче через URL-адрес.
Используя параметр x-cancel
, можно указать «экстренный» URL-адрес, который откроется, если быстрая команда прервется до своего полного выполнения. В этом случае выходных данных от быстрой команды получен не будет, так как она не выполняется полностью.
Используя параметр x-error
, можно указать «экстренный» URL-адрес, который откроется, если выполнение быстрой команды не удастся завершить из-за возникшей ошибки. В таком случае чтобы обойти проблему, Вы сможете открыть другой URL-адрес.