Brug URL-adresse til x-callback i Genveje
Genveje understøtter x-callback-url, der giver en app, som sender et kald, mulighed for at få svar (et tilbagekald), når en bestemt interaktion er færdig. Du kan importere og afvikle genveje fra en URL-adresse til X-Callback ved at bruge de samme parametre som beskrevet i Start en genvej vha. en URL-type og Importer en genvej vha. en URL-type. Her er et eksempel:
shortcuts://x-callback-url/run-shortcut?name=Beregne%20drikkepenge&input=text&text=12,50&x-success=...&x-cancel=...
Ifølge standarden til x-callback-url kan følgende ekstra parametre anføres:
x-success (valgfrit): En URL-adresse, der åbnes, når interaktionen er gennemført, f.eks. efter en genvej er importeret, eller afviklingen af den er færdig. Hvis en genvej er afviklet, føjes en parameter med navnet
result, som indeholder genvejens tekstoutput, til URL-adressen.x-cancel (valgfrit): En URL-adresse, der åbnes, når interaktionen er annulleret af brugeren.
x-error (valgfrit): En URL-adresse, der åbnes, når interaktionen ikke kan gennemføres, fordi der opstod en fejl. En parameter med navnet
errorMessage, som indeholder en beskrivelse af fejlen, føjes til URL-adressen.
Med x-success kan du anføre en URL-adresse, der åbnes, efter afviklingen af genvejen er færdig. Den kan bruges sammen med en tjekliste i flere trin med opgaver i OmniFocus, hvor du åbner URL-adressen til X-Callback for at afvikle en genvej, vender tilbage til listen og går videre til den næste opgave via en URL-adresse.
Med x-cancel kan du anføre en URL-adresse til brug i fejlsituationer, hvor genvejen stopper, før afviklingen af den er færdig. Der kommer intet output fra genvejen, fordi den ikke blev gennemført.
Med x-error kan du anføre en URL-adresse til brug i fejlsituationer, hvor der opstår en fejl under afviklingen af genvejen, og den ikke gennemføres. I det tilfælde kan du starte en anden URL-adresse, der skal håndtere problemet.