DOCS

Fullfør et spørsmål

Fullfør et spørsmål

Clarify forhåndsutfyller det den kan fra elementdataene dine; du bekrefter eller korrigerer resten, og fullfører deretter.

GraphQL

Når du vet hvilke programmer som gjelder (se Kontroller samsvarkrav), er den anbefalte flyten tre anrop:

  1. Utled - complianceQuestionnaireInfer åpner en økt med svar forhåndsutfylt fra elementdataene dine.
  2. Gjennomgå og korrigér - questionnaireAnswersSubmit for å endre noe avsender er uenig i og svar på det som er igjen.
  3. Attestér - questionnaireSessionAttest for å godta og fullføre.

Hvis du allerede har hvert svar, kan du sende inn et fullstendig svar i ett anrop i stedet — se Send inn et fullstendig svar nedenfor.

Omfang

Lesing krever COMPLIANCE_READ-omfanget; sending av svar krever COMPLIANCE_WRITE. Se OAuth.

Svarverdsier er JSON-kodet

Hvert svar value er en JSON-kodet streng: en boolsk verdi er "true", en velg- eller tekstverdi er sitert som "\"cosmetic\"", et flertallsvalg er "[\"a\",\"b\"]", og et tall er "42".

Utled og forhåndsutfyll 

complianceQuestionnaireInfer løser gjeldende programmer for elementene dine, åpner en økt, og forhåndssvar på spørsmål fra elementdataene dine. Hvert forhåndsutfylt svar har provenance: INFERRED og en confidence-poengsum.

Send intendedUse for å veilede utledning — butikkfrontflyten skal sende CONSUMER.

1mutation InferQuestionnaire($input: ComplianceQuestionnaireInferInput!) {
2 complianceQuestionnaireInfer(input: $input) {
3 session {
4 id
5 status
6 lines {
7 id
8 programId
9 status
10 currentQuestion {
11 code
12 prompt
13 answerType
14 }
15 }
16 }
17 lines {
18 lineId
19 state
20 remainingRequiredCount
21 }
22 }
23}

Hver linjes state forteller deg hva som er neste:

  • READY_TO_ATTEST - hvert påkrevd spørsmål er besvart. Gå direkte til Attestér (nedenfor).
  • PARTIAL - noen svar ble forhåndsutfylt, men påkrevde spørsmål gjenstår. Besvar dem på currentQuestion.
  • NOT_INFERRED - ingenting kunne forhåndsutfylles; besvar det som et vanlig spørsmål.

Programmer som allerede er tilfredsstilt av et eksisterende svar hoppes over og returneres i alreadySatisfied (utelatt ovenfor).

Gjennomgå og korrigér 

Økten inneholder forhåndsutfylte svar — ikke et fullført svar. For hvert svar, gjør avsender enten:

  • godtar det — lar det være urørt, og det forblir INFERRED, eller
  • korrigerer det — sender inn en ny verdi med questionnaireAnswersSubmit, som blir MANUAL.

Send inn ett svar eller flere på en gang. Clarify avanserer currentQuestion til neste gjenstående spørsmål og, når det ikke gjenstår noen, fullfører linjen svar (dens responseId blir fylt ut).

Godtatte svar beholdes, ikke forkastet

Korrigering av ett svar overstyrer bare det svaret. Det fullstendige svaret inneholder hele settet — godtatte svar forblir INFERRED, rettelser er MANUAL — slik at du alltid har en registrering over hva AI'en leverte kontra hva en person endret.

For eksempel godtar avsender det utledede intended_use men korrigerer contains_color_additives, så de sender inn bare det ene svaret:

1mutation SubmitAnswers($input: QuestionnaireAnswersSubmitInput!) {
2 questionnaireAnswersSubmit(input: $input) {
3 status
4 lines {
5 id
6 status
7 responseId
8 answers {
9 questionCode
10 value
11 provenance
12 confidence
13 }
14 }
15 }
16}

Attestér 

Når en linje er READY_TO_ATTEST — hvert påkrevd svar allerede forhåndsutfylt og avsender er enig — godta det i ett anrop med questionnaireSessionAttest. Det fullfører hver kvalifisert linje, eller bare lineIds du sender.

1mutation AttestSession($input: QuestionnaireSessionAttestInput!) {
2 questionnaireSessionAttest(input: $input) {
3 id
4 status
5 lines {
6 id
7 status
8 responseId
9 }
10 }
11}

For å forkaste en pågående økt, ring questionnaireSessionAbandon(id: ID!).

Send inn et fullstendig svar 

Hvis du allerede har hvert svar — for eksempel et gjenbrukbart svarresett for en CATALOG_ITEM — hopp over økten og send direkte med questionnaireResponseSubmit. Det erstatter evt tidligere svar for samme element og program.

1mutation SubmitResponse($input: QuestionnaireResponseSubmitInput!) {
2 questionnaireResponseSubmit(input: $input) {
3 id
4 status
5 completedAt
6 answers {
7 questionCode
8 value
9 provenance
10 }
11 }
12}

Foretrekker å svar uten utledning? questionnaireSessionStart åpner en økt for programmene du velger, og deretter bruker du de samme Gjennomgå og korrigér og Attestér anropene ovenfor.

Les svar og beredskap 

Hent en fullført record med questionnaireResponse(id), og kontroller om en hel beholder er klar til innlevering med containerComplianceReadinessready er true bare når hver linje har et fullstendig svar.

1query ContainerReadiness($containerType: ContainerType!, $containerId: ID!) {
2 containerComplianceReadiness(
3 containerType: $containerType
4 containerId: $containerId
5 ) {
6 ready
7 totalLineCount
8 outstandingLineCount
9 }
10}

Neste steg 

Bestill en demo

Var denne siden nyttig?