Μετάβαση στο περιεχόμενο
Sursa Developers

Αντικείμενα

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: μια ερώτηση συγκέντρωσης στοιχείων (dossier) ή μια λίστα εγγράφων ενός τύπου. Στην εμβέλεια βρέθηκαν 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 (δεν υπάρχουν καθόλου ισοτιμίες για το ζεύγος).

  • requestedstring
  • typestring
  • toolstring

    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: πόσα από τα έγγραφα που βρέθηκαν υπάρχουν στην απάντηση.

Μέρος του

AnswerResponseChatEventDataFeedItemQuestionPayload