Usar x-callback-url com a aplicação Atalhos
A aplicação atalhos suporta x-callback-url, que permite a chamada da aplicação para receber uma resposta (uma chamada de resposta) quando uma interação específica é concluída. Pode importar e executar atalhos a partir de um x-callback-url através dos mesmos parâmetros, conforme abordado em Executar um atalho através de um esquema de URL e Importar um atalho através de um esquema de URL. Eis um exemplo:
shortcuts://x-callback-url/run-shortcut?name=Calcular%20gorjeta&input=text&text=24.99&x-success=...&x-cancel=...
De acordo com a norma x-callback-url, podem ser fornecidos os seguintes parâmetros adicionais:
x-success (opcional): um URL que se abre quando a interação é bem-sucedida — por exemplo, depois de um atalho ser importado ou terminar de ser executado. Se um atalho for executado, é anexado ao URL um parâmetro com o nome
result
que contém a entrada textual do atalho.x-cancel (opcional): um URL que se abre quando a interação é cancelada pelo utilizador.
x-error (opcional): um URL que se abre quando a interação falha devido à ocorrência de um erro. É anexado ao URL um parâmetro com o nome
errorMessage
que contém ma descrição do erro.
Com x-success
, pode fornecer um URL que se abre depois de o atalho concluir a execução com êxito. Isto poderia ser usado em conjunto com uma lista de verificação por várias etapas de tarefas no OmniFocus, onde abre o x-callback-url para executar um atalho, volta à lista e Passa à tarefa seguinte através do URL.
Com x-cancel
, pode fornecer um URL de contingência é iniciado se o atalho parar antes de concluir a execução. Visto que o atalho não foi concluído, não é fornecida nenhuma saída do atalho.
Com x-error
, pode fornecer um URL de contingência é iniciado se o atalho encontrar um erro durante a execução e não for concluído. Neste caso, pode iniciar outro URL para resolver o problema.