分支
問題可以根據之前的答案而定,所以寄件人只會看到相關的內容。您無需自己評估該邏輯:在會話行上,visibleQuestions 是已根據當前答案解決的隨時可用於渲染的列表。
如果您更傾向於在客戶端渲染所有內容,該行的 questions 字段會返回完整集合,其中每個問題都有其 displayCondition,所以您可以在答案改變時在本地顯示和隱藏問題。
答案來源
每個答案都會記錄它的來源:
INFERRED- 由 Clarify 根據您的項目數據預先填入。帶有從0到1的confidence分數。MANUAL- 由人員輸入或更正。SUPPLIED- 您在請求中發送的事實(例如預期用途)。無需確認,所以不會作為問題顯示。
更正推斷的答案會將其替換為 MANUAL 答案。最終化的回應保留完整混合,所以始終有預先填入的內容和個人更改的記錄。
動態選項
大多數問題在 options 中內聯列出其選擇。有些取決於項目和之前的答案 — 這些設置 optionsSource 並將 options 留空。
對於這些問題,會話行包含一個 dependentOptions 表,涵蓋該項目的每個可達組合。查找其 parentValues 與當前答案相匹配的條目,然後顯示其 options — 無需額外的 API 調用。
{
"questionCode": "fda_product_code",
"dependsOn": ["intended_use"],
"entries": [
{
"parentValues": [{ "questionCode": "intended_use", "value": "cosmetic" }],
"options": [
{ "value": "53", "label": "Cosmetics" },
{ "value": "53A", "label": "Skin care preparations" }
]
}
]
}
預期用途
在每個項目上傳遞 intendedUse 以指導推斷。當產品本身不足以確定它時,Clarify 使用您聲明的值。
| 值↕ | 用於↕ |
|---|---|
PERSONAL | 個人消費、禮物或家庭使用(不出售)。 |
CONSUMER | 通過零售渠道銷售的一般消費者產品。 |
COMMERCIAL | 商業、製造或工業用途。 |
RESEARCH | 實驗室、測試、科學研究或臨床試驗。 |
店面和消費者結帳流程應發送 CONSUMER。
目標和容器
目標 是一組答案描述的內容:
CATALOG_ITEM- 可重複使用的產品主數據。回答一次並在多個貨件中重複使用。ITEM- 單個貨件的項目。當為ITEM回答時,傳遞其catalogItemId所以可以使用可重複使用的目錄級答案集滿足計劃。
容器 是答案被收集的分組 — DECLARATION、LANDED_COST、CONSIGNMENT 或 CONSOLIDATION。使用 containerComplianceReadiness 在您提交之前在一次調用中檢查整個容器。
運作方式
當您構建自己的 UI 或讀取回應時,了解 Clarify 問卷背後的行為很有用。