Forespørsler

Beslutninger og godkjenninger

Mange forespørsler finnes for å få akkurat én ting: et ja, et nei, eller et «ikke sånn». Beslutningsspørsmålet fanger det utfallet i en form arbeidsflyten din kan forgrene seg direkte på, uten å gjette hvilket felt som holdt svaret.

Hvorfor et eget spørsmål

Hvert valg har allerede en alternativnøkkel, så en arbeidsflyt kan forgrene seg på hvilken som helst radioknapp. Det en arbeidsflyt ikke kan gjøre, er å vite, på tvers av alle skjemaer med en godkjenning, hvilken nøkkel som betyr «ja»: én forfatters radioknapp sier sign_off, en annens approved.

Beslutningsspørsmålet fastsetter navnene. Det er et enkeltvalg-spørsmål med feltnøkkelen decision, hvis tre alternativer bærer alternativnøklene approve, decline og changes. Etikettene forblir dine å omformulere og oversette; nøklene under flytter seg aldri. Når mottakeren velger ett, avsluttes forespørselen med et utfall. Enhver radioknapp med feltnøkkelen decision hvis alternativer bærer disse tre nøklene, teller — presetet setter dem bare for deg.

Legg til ett i skjemaet ditt

1
Åpne blokkmenyen
Trykk / i editoren og velg Beslutning — «Godkjenn, avslå, eller be om endringer».
2
Omformuler etikettene
Du får et spørsmål med tittelen «Godkjenner du?» med valgene Godkjenn, Avslå, og Be om endringer. Skriv om hvilke som helst av dem til din egen ordlyd — «Signer av», «Avvis», «Send tilbake for redigering». Oversett dem som ethvert annet innhold.
3
Spør hvorfor, hvis du trenger det
Et utfall alene forklarer sjelden seg selv. Legg til et langtekst-spørsmål etter det, og vis det bare for avslå og endringer med betinget logikk.
4
Publiser
Forespørsler opprettet fra denne publiserte versjonen avsluttes med et utfall. Som enhver feltnøkkel eksisterer decision først når skjemaet er publisert.

Kun presetet gir et utfall

Utfallet leses fra spørsmålet hvis feltnøkkel er decision, og bare når det valgte alternativets nøkkel er en av de tre. En radioknapp du bygger for hånd med alternativene merket Approve, Decline og Changes avleder nøyaktig disse nøklene, så den fungerer uten presetet; en radioknapp med andre etiketter fungerer når du skriver inn de tre nøklene i Nøkler-tabellen.

Slett ett av de tre alternativene, eller skriv om nøkkelen, og publisering advarer deg: «Beslutningsspørsmålet mangler et alternativ for godkjenn, avslå eller be om endringer, så forespørsler kan fullføres uten utfall.» Alle tre må være der — en beslutning som bare kan godkjenne, kan ikke avslå.
Et beslutningsspørsmål inne i en gjentakende gruppe er et vanlig spørsmål og ignoreres for utfallet.

De tre verdiene

Verdi	Standardetikett	Betyr
approve	Godkjenn	Mottakeren var enig. Kjøringen din fortsetter nedover lykkelig-sti.
decline	Avslå	De sa nei. Forespørselen fullføres fortsatt — avslag er et utfall, ikke en feil.
changes	Be om endringer	De vil ha noe endret før de er enige. Vanligvis signalet til å sende en ny forespørsel.

Disse tre verdiene er en offentlig kontrakt, som en feltnøkkel: en automatisering, en agent, og en regnearkformel leser dem alle. Legg til et fjerde alternativ, og å velge det er et vanlig svar, ikke et utfall — den forespørselen fullføres uten et utfall, i stedet for med en verdi mottakeren din aldri har hørt om.

Hvor utfallet dukker opp

Sted	Hva du får
Callback	outcome på request-blokken til request.completed-nyttelasten — fraværende når det ikke er noe utfall.
requests.get	outcome ved siden av status, pluss svarene nøkkelsatt etter feltnøkkel.
requests.list	Et outcome-filter; å sende ett antyder kun fullførte forespørsler.
Forespørsler-siden	Et Utfall-filter, og Godkjent / Avslått / Endringer forespurt på selve forespørselen.
Innsendinger	Utfallet er også et vanlig svar, under feltnøkkelen decision.

request.completed, forkortet

json

{
  "id": "evt_...",
  "type": "request.completed",
  "test": false,
  "data": {
    "request": {
      "id": "kd7...",
      "externalId": "run-42",
      "status": "completed",
      "outcome": "changes",
      "context": { "case_id": "CASE-9" }
    },
    "answers": {
      "decision": "changes",
      "reason": "Please split the line items per site."
    }
  }
}

Forgren deg på data.request.outcome. status sier om forespørselen ble fullført; outcome sier hva mottakeren bestemte. En utløpt eller kansellert forespørsel har en status og intet utfall, og det samme gjelder en fullført forespørsel på et skjema uten beslutningsspørsmål.

Fra en agent

MCP-verktøyet er editor_insertDecisionQuestion, som tar en tittel og de tre etikettene på skjemaets språk. En agent som ikke kan hoste et callback-endepunkt, poller request_get i stedet og leser outcome når statusen forlater pending. Forespørsler på MCP-serveren →

Callbacks og signeringHele nyttelasten og hvordan du verifiserer den.Forespørsler-sidenFiltrer etter utfall og følg én forespørsel.Betinget logikkSpør om en grunn kun når det trengs.SpørsmålstyperHvert annet spørsmål du kan stille.