Använda x-callback-url med Genvägar
Genvägar stöder x-callback-url, vilket gör så att appen som anropar kan ta emot ett svar (en callback) när en viss interaktion har slutförts. Du kan importera och köra genvägar från en x-callback-url med samma parametrar som nämns i Köra en genväg med hjälp av ett URL-schema och Importera en genväg med hjälp av ett URL-schema. Här är ett exempel:
shortcuts://x-callback-url/run-shortcut?name=Beräkna%20dricks&input=text&text=24.99&x-success=...&x-cancel=...
Enligt x-callback-url-standarden kan följande ytterligare parametrar tillhandahållas:
x-success (frivilligt): En URL som öppnas när interaktionen är slutförd, till exempel efter att en genväg har importerats eller körts. Om en genväg körs blir en parameter som heter
resultat
bifogad till URL:en och innehåller genvägens textutmatning.x-cancel (frivilligt): En URL som öppnas när interaktionen avbryts av användaren.
x-error (frivilligt): En URL som öppnas när interaktionen misslyckas eftersom ett fel inträffade. En parameter vid namn
errorMessage
bifogas i URL:en och innehåller en beskrivning av felet.
Med x-success
kan du ange en URL som öppnas efter att genvägen slutförts. Det här kan användas tillsammans med en flervalschecklista med uppgifter i OmniFocus där du öppnar x-callback-url för att köra en genväg, återgå till listan och gå vidare till nästa uppgift via URL.
Med x-cancel
kan du lägga till en beredskaps-URL som öppnas i de fall genvägen stannar innan den har kört klart. Eftersom genvägen inte slutfördes tillhandahålls ingen utmatning från genvägen.
Med x-error
kan du lägga till en beredskaps-URL som öppnas i de fall genvägen stöter på ett fel under körning och inte kan slutföras. Om så är fallet kan du öppna en annan URL för att hantera problemet.