DOCS

Anketleri tamamla

Anketleri tamamla

Clarify, öğe verilerinizden yapabileceği şeyleri önceden doldurur; siz kalanını onaylarsınız veya düzeltir, sonra sonlandırırsınız.

GraphQL

Hangi programların geçerli olduğunu öğrendikten sonra (bkz. Uyum gereksinimlerini kontrol et), önerilen akış üç çağrıdır:

  1. Çıkarsama - complianceQuestionnaireInfer yanıtları önceden doldurulmuş olarak bir oturum açar.
  2. İnceleme ve düzeltme - questionnaireAnswersSubmit kargo görevlisinin anlaşmadığı herhangi bir şeyi değiştirmek ve kalanını yanıtlamak için.
  3. Onaylama - questionnaireSessionAttest kabul etmek ve sonlandırmak için.

Zaten her yanıta sahipseniz, bunun yerine bir çağrıda tam bir yanıt gönderebilirsiniz — aşağıdaki Tam bir yanıt gönder konusuna bakın.

Kapsamlar

Okuma COMPLIANCE_READ kapsamını gerektirir; yanıtları göndermek COMPLIANCE_WRITE gerektirir. Bkz. OAuth.

Yanıt değerleri JSON kodlanmıştır

Her yanıt value, JSON kodlanmış bir dizedir: bir boole "true" olur, bir seç veya metin değeri "\"cosmetic\"" gibi alıntılanır, çok seçmeli "[\"a\",\"b\"]" olur ve bir sayı "42" olur.

Çıkarımsama ve önceden doldurma 

complianceQuestionnaireInfer, öğeleriniz için geçerli programları çözer, bir oturum açar ve soruları öğe verilerinizden önceden yanıtlar. Her önceden doldurulmuş yanıt provenance: INFERRED ve bir confidence puanı vardır.

Çıkarımı rehberlik etmek için intendedUse geçin — vitrin akışları CONSUMER göndermeli.

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}

Her satırın state sizi neler beklediğini söyler:

  • READY_TO_ATTEST - her gerekli soru yanıtlanmıştır. Doğrudan Onaylama (aşağı) bölümüne gidin.
  • PARTIAL - bazı yanıtlar önceden doldurulmuştur, ancak gerekli sorular kalır. Bunları currentQuestion konumunda yanıtlayın.
  • NOT_INFERRED - hiçbir şey önceden doldurulamaz; bunu adi bir anket olarak yanıtlayın.

Mevcut bir yanıt tarafından zaten karşılanan programlar atlanır ve alreadySatisfied konumunda döndürülür (yukarıda atlanmıştır).

İnceleme ve düzeltme 

Oturum önceden doldurulmuş yanıtlar — sonlandırılmış bir yanıt değil tutmaktadır. Her yanıt için, kargo görevlisi şunlardan biri yapar:

  • kabul eder — bunu dokunmadan bırakır ve INFERRED kalır, veya
  • düzeltirquestionnaireAnswersSubmit ile yeni bir değer gönderir, bu MANUAL olur.

Bir yanıt veya bir kerede birkaç yanıt gönderin. Clarify currentQuestion öğesini bir sonraki kalan soruya ilerletir ve hiçbiri kalmazsa, satırın yanıtını sonlandırır (responseId doldurulur).

Kabul edilen yanıtlar saklanır, atılmaz

Bir yanıtı düzeltmek yalnızca o yanıtı geçersiz kılar. Sonlandırılan yanıt tam kümesini tutar — kabul edilen yanıtlar INFERRED kalır, düzeltmeler MANUAL olur — bu nedenle yapay zekâ tarafından sağlananlar ile bir kişinin değiştirdiği şeyler arasındaki kaydı her zaman tutarsınız.

Örneğin, kargo görevlisi çıkarılan intended_use kabul eder ancak contains_color_additives değerini düzeltir, bu nedenle yalnızca o yanıtı gönderir:

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}

Onaylama 

Bir satır READY_TO_ATTEST olduğunda — her gerekli yanıt zaten önceden doldurulmuştur ve kargo görevlisi anlaşıyor — questionnaireSessionAttest ile bir çağrıda kabul edin. Bu her uygun satırı sonlandırır veya yalnızca ilettiğiniz lineIds sonlandırır.

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

Devam eden bir oturumu atmak için questionnaireSessionAbandon(id: ID!) çağrısını yapın.

Tam bir yanıt gönder 

Zaten her yanıta sahipseniz — örneğin bir CATALOG_ITEM için yeniden kullanılabilir bir yanıt seti — oturumu atla ve doğrudan questionnaireResponseSubmit ile gönder. Bu, aynı öğe ve program için önceki herhangi bir yanıtın yerini alır.

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}

Çıkarsama olmadan yanıtlamayı tercih edersiniz? questionnaireSessionStart seçtiğiniz programlar için bir oturum açar ve ardından yukarıdaki aynı İnceleme ve düzeltme ve Onaylama çağrılarını kullanırsınız.

Yanıtları ve hazırlığı okuyun 

Sonlandırılmış bir kaydı questionnaireResponse(id) ile getirin ve tüm bir konteyner dosya alma için hazırsa containerComplianceReadiness ile kontrol edin — ready yalnızca true olur her satır tam bir yanıta sahip olduğunda.

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

Sonraki adımlar 

Bu sayfa faydalı mıydı?