الكائنات
AnswerWarning
تحذير مرفق بإجابة. الحقل kind قابل للتوسيع: اعرض النوع غير المعروف برسالة عامة. الأنواع:
- الأنواع chart_unavailable، وchart_type_changed، وchart_axis_categorical، وtool_not_allowed، وtool_failed، وtable_query_failed (فشل أحد استعلامات الجداول في الإجابة)، وtruncated. لا يوجد الحقل reason في هذه الأنواع.
- النوع answer_mismatch_data: رقم في الإجابة بجوار شهر يختلف عن بيانات المخطط لذلك الشهر (reason: period_value، period_missing، total_as_period، period_part)؛ أو الرقم غير موجود في بيانات الإجابة (reason: number_not_in_data)؛ أو إجابة النظرة العامة تذكر مستندًا ليس في قائمة المستندات وليس له رابط مصدر (reason: document_not_in_list)؛ أو الرقم موجود في البيانات لكن بعملة أخرى (reason: currency_mismatch، مع الحقول number وcurrency وcurrencies). الحقول: text، وexpected، وspans.
- النوع answer_source_ambiguous: البيانات مأخوذة من عدة جداول متشابهة للفترة نفسها، ولم يطلب السؤال دمجها (يسرد text الجداول).
- النوع answer_no_data_basis: إجابة فيها أرقام شهرية ليست لها بيانات جدولية، لذا لم يُتحقق من الأرقام.
- النوع currency_missing: رقم من بيانات نقدية بلا عملة، مع أن البيانات فيها عدة عملات (text، number، spans، currencies).
- النوع mixed_currency_sum: رقم في الإجابة يساوي مجموع قيم بعملات مختلفة (text، number، spans، currencies).
- النوع access_limited: استُبعدت بعض النتائج بسبب صلاحيات وصول المستخدم، لذا قد تكون الإجابة غير مكتملة (بلا حقول بيانات).
- النوع fx_rate_stale: استخدم التحويل سعر صرف أقدم من عتبة الحداثة لمصدره (rate_date، currencies).
- النوع fx_rate_missing: لم يُحوَّل مبلغ في الإجابة. قيمة reason هي no_rate_on_date (لا يوجد سعر لتاريخ صف المبلغ ضمن هامش السماح: 7 أيام، أو 31 يومًا للأسعار المرفوعة يدويًا) أو no_rate (لا توجد أسعار للزوج إطلاقًا). يسرد currencies العملات التي بلا سعر. وtext نص احتياطي بالإنجليزية فيه الأزواج والتواريخ، مثل «RUB → USD on 2026-03-04, 2026-03-05»، والأزواج المتعددة مفصولة بالرمز «; ».
- النوع restricted_unverified: سؤال في موضوع مقيَّد. لا تُعرض المقتطفات بلا فحص للصلة (بلا حقول بيانات).
- النوع enrichment_pending: في نطاق السؤال مستندات لا تزال قيد المعالجة، لذا حقولها وسجلاتها المالية ليست جاهزة. قيمة reason هي documents (سؤال عن مبالغ أو إجابة من جداول، لذا قد يكون الإجمالي غير مكتمل) أو document (سؤال عن مستند محدد لا يزال قيد المعالجة أو تعذرت معالجته). الحقل pending عدد المستندات قيد المعالجة، وcard_ids المرئية منها للمستخدم (20 على الأكثر). والحقل failed عدد المستندات التي تعذرت معالجتها، وfailed_card_ids المرئية منها (20 على الأكثر).
- النوع partial_coverage: سؤال ملف شامل أو قائمة مستندات من نوع واحد. عُثر على found مستند في النطاق، ولا يرد في الإجابة إلا shown < found، لذا قد تكون الإجابة غير مكتملة.
- النوع reconcile_unconfirmed: تقول الإجابة «متطابق» عن سؤال مطابقة، لكن المبلغ لم يُعثر عليه في مستندين مختلفين (text ملاحظة فيها مبالغ المصدرين بلغة الإجابة).
يبني العميل النص المعروض للمستخدم من kind وreason وحقول البيانات بلغة الواجهة. أما text في access_limited وrestricted_unverified وfx_rate_missing، وexpected، فنصوص احتياطية بلغة الإجابة أو بالإنجليزية.
الحقول
kindstringمطلوبreasonstringللنوع
answer_mismatch_data: رمز السبب (period_value،period_missing،total_as_period،period_part،number_not_in_data،document_not_in_list،currency_mismatch). وللنوعchart_axis_categorical:unparsed_periods. وللأنواعtool_failedوtable_query_failedوtruncated: لا يوجدreason. وللنوعينcurrency_missingوmixed_currency_sum: شرح بالإنجليزية (احتياطي؛ ويبني العميل العبارة منcurrencies). وللنوعfx_rate_missing:no_rate_on_date(لا يوجد سعر لتاريخ الصف ضمن هامش السماح) أوno_rate(لا توجد أسعار للزوج إطلاقًا).requestedstringtypestringtoolstringللنوعين
tool_failedوtool_not_allowed: اسم الأداة.textstringجزء الإجابة الذي يخصه التحذير (للنوع
answer_mismatch_data: الشهر والرقم كما كُتبا في الإجابة). وللأنواعaccess_limitedوrestricted_unverifiedوfx_rate_missing، نص احتياطي (للنوعfx_rate_missing: الأزواج والتواريخ التي بلا سعر).expectedstringما تقوله البيانات (للنوع
answer_mismatch_data: قيمة هذا الشهر وشهر هذه القيمة، أو قيمة الإجمالي).spansarray of array of integerمواضع العبارات في نص الإجابة (UTF-16، كما في سلاسل JavaScript): الرقم والشهر.
numberstringللنوع
answer_mismatch_data: الرقم كما كُتب في الإجابة. ومعperiodوother_periodوvaluesوrows، هذه هي بيانات نص التحذير بلغة الواجهة.periodstringللنوع
answer_mismatch_data: الشهر من الإجابة (YYYY-MM).other_periodstringللنوع
answer_mismatch_data: شهر البيانات الذي تساوي قيمته الرقم (YYYY-MM).valuesarray of number (double)للنوع
answer_mismatch_data: قيم البيانات للشهر، أو الإجمالي.rowsintegerللنوع
answer_mismatch_dataوالسببperiod_part: عدد الصفوف التي جُمعت في إجمالي الشهر.currencystringللنوع
answer_mismatch_dataوالسببcurrency_mismatch: عملة الرقم كما سُمّيت في الإجابة (رمز ISO 4217).currenciesarray of stringعملات البيانات (رموز ISO 4217). للسبب
currency_mismatch، العملات التي ترد بها هذه القيمة في البيانات؛ وللنوعينcurrency_missingوmixed_currency_sum، عملات القيم النقدية في بيانات الإجابة؛ وللنوعfx_rate_stale، العملات المحوَّلة بسعر قديم؛ وللنوعfx_rate_missing، العملات التي بلا سعر.rate_datestring (date)للنوع
fx_rate_stale: تاريخ السعر القديم (YYYY-MM-DD).pendingintegerللنوع
enrichment_pending: عدد المستندات في نطاق السؤال التي لا تزال قيد المعالجة.card_idsarray of stringللنوع
enrichment_pending: بطاقات هذه المستندات المرئية للمستخدم (20 على الأكثر).failedintegerللنوع
enrichment_pending: عدد المستندات في نطاق السؤال التي تعذرت معالجتها.failed_card_idsarray of stringللنوع
enrichment_pending: بطاقات المستندات التي تعذرت معالجتها والمرئية للمستخدم (20 على الأكثر).foundintegerللنوع
partial_coverage: عدد المستندات المطلوبة التي عُثر عليها في نطاق السؤال.shownintegerللنوع
partial_coverage: عدد المستندات المعثور عليها الواردة في الإجابة.