Η εργασία εμφανίζεται ως ολοκληρωμένη, αλλά η λήψη είναι κενό αρχείο; Ξεχωριστή κατάσταση εκτέλεσης και παράδοσης
Το κουμπί λέει "Τέλος", αλλά όταν κάνω κλικ στη λήψη, εμφανίζεται ένα κενό αρχείο; Το πρόβλημα συχνά δεν είναι το κείμενο προτροπής, αλλά ότι το backend θυμάται μόνο ότι ο αλγόριθμος έχει εκτελεστεί, όχι εάν η παράδοση είναι έτοιμη. Μόνο με το διαχωρισμό της κατάστασης εκτέλεσης και της κατάστασης παράδοσης μπορεί το front-end να ενημερώσει τον χρήστη την πραγματική πρόοδο. Αυτό το άρθρο εξηγεί ξεκάθαρα τη διχοτόμηση.
Η σελίδα εργασιών εμφανίζει "Ολοκλήρωση", αλλά όταν κάνω κλικ στη λήψη, λαμβάνω ένα κενό αρχείο. Το πρόβλημα συχνά δεν είναι το ίδιο το κείμενο προτροπής, αλλά ότι το backend καταγράφει μόνο το τέλος της εκτέλεσης του αλγορίθμου και δεν καταγράφει εάν η παράδοση είναι έτοιμη. Αυτό το άρθρο είναι γραμμένο για προγραμματιστές που κάνουν επεξεργασία εγγράφων, ασύγχρονες εργασίες ή ενσωμάτωση μετάφρασης. Μετά την ανάγνωση, θα ξέρετε πώς να διαχωρίσετε την κατάσταση εκτέλεσης και την κατάσταση παράδοσης, έτσι ώστε η διεπαφή να μπορεί να δείχνει την πραγματική πρόοδο στον χρήστη.
Τα παραδείγματα σε αυτό το άρθρο χρησιμοποιούν συνθετικά δείγματα και ο κώδικας έχει ελεγχθεί σε ένα απομονωμένο περιβάλλον. Αυτό δεν αποτελεί εγγύηση για όλα τα πραγματικά αρχεία ή τα εφέ προϊόντος. Πριν επεξεργαστείτε σημαντικά έγγραφα, διατηρήστε τα πρωτότυπα και ελέγξτε τα σύμφωνα με τα όρια και τα στοιχεία αποδοχής στο κείμενο.
Η λήψη είναι ένα κενό αρχείο, αλλά η εργασία εμφανίζεται ως ολοκληρωμένη; Μια φράση συμπέρασμα
Πρώτα διαχωρίστε το "ολοκληρώθηκε η επεξεργασία" σε τρεις καταστάσεις: επεξεργασία, προϊόν και αποδοχή και, στη συνέχεια, αφήστε το μπροστινό μέρος να εμφανίζει μόνο την επιβεβαιωμένη κατάσταση.
| την κατάστασή σας | Συνιστώμενες πρακτικές | λόγος |
|---|---|---|
| Η εργασία έληξε, αλλά το αρχείο δεν έχει δημιουργηθεί ακόμα | Εισαγάγετε την κατάσταση "Έτοιμο προϊόν" και μπορείτε να το κατεβάσετε χωρίς να το εμφανίσετε εκ των προτέρων. | Το τέλος της επεξεργασίας σημαίνει μόνο ότι ο υπολογισμός έχει σταματήσει, αλλά δεν σημαίνει ότι υπάρχουν αρχεία που μπορούν να εντοπιστούν. |
| Το αρχείο έχει δημιουργηθεί, αλλά το περιεχόμενο δεν έχει ελεγχθεί ακόμα | Διατηρήστε "Έλεγχος αποτελεσμάτων" και περιμένετε για αποδοχή | Ετοιμότητα προϊόντος δεν σημαίνει τήρηση της συμφωνίας παράδοσης |
| Η εργασία απέτυχε | Εμφανίστε το στάδιο και τον λόγο της αποτυχίας και δώστε τις αντίστοιχες ενέργειες | Η αποτυχία θα πρέπει επίσης να έχει στάδια και δεν μπορεί να κρυφτεί με ένα περιστρεφόμενο εικονίδιο |
| Η λήψη επιστρέφει το HTTP 200 | Συνεχίστε να ελέγχετε τον τύπο, το μέγεθος, τη διαθεσιμότητα ανάλυσης και το αναμενόμενο περιεχόμενο | Το 200 μπορεί να αντιστοιχεί σε σελίδα σύνδεσης, σφάλμα JSON ή κενό έγγραφο |
Τουλάχιστον διαφοροποιήστε μεταξύ επεξεργασίας, προϊόντος και αποδοχής
Το τέλος της επεξεργασίας σημαίνει ότι ο υπολογισμός έχει σταματήσει. το προϊόν είναι έτοιμο, πράγμα που σημαίνει ότι μπορεί να εντοπιστεί το αρχείο. και ολοκληρώνεται η αποδοχή, που σημαίνει ότι ο φάκελος πληροί τη συμφωνία παράδοσης. Και τα τρία δεν συμβαίνουν απαραίτητα ταυτόχρονα.
Η αποτυχία θα πρέπει επίσης να έχει στάδια και δεν μπορεί να κρυφτεί από ένα μόνιμα περιστρεφόμενο εικονίδιο. Ο χρήστης γνωρίζει εάν παρουσιάστηκε σφάλμα κατά την επεξεργασία, τη δημιουργία ή τον έλεγχο, ώστε να γνωρίζει εάν πρέπει να περιμένει, να προσπαθήσει ξανά ή να επιδιορθώσει την είσοδο.
📊 Βασική σύγκριση
| κατάσταση | Απαντημένες ερωτήσεις | Μπορούν να υποσχεθούν στους χρήστες λήψεις; |
|---|---|---|
| Τέλος επεξεργασίας | Αν έχει σταματήσει ο υπολογισμός | δεν μπορεί |
| Το προϊόν έτοιμο | Υπάρχει κάποιο αρχείο που μπορεί να εντοπιστεί | Όχι, χρειάζεται ακόμα έλεγχος |
| Η αποδοχή ολοκληρώθηκε | Το έγγραφο πληροί τη συμφωνία παράδοσης; | Κουτί |
Αρνηθείτε ρητά την επιτυχία του άλματος
from enum import Enum
class State(Enum):
PROCESSING = "processing"
ARTIFACT_READY = "artifact_ready"
VERIFIED = "verified"
FAILED = "failed"
def transition(state, event):
allowed = {
(State.PROCESSING, "stored"): State.ARTIFACT_READY,
(State.PROCESSING, "error"): State.FAILED,
(State.ARTIFACT_READY, "checks_passed"): State.VERIFIED,
(State.ARTIFACT_READY, "error"): State.FAILED,
}
if (state, event) not in allowed:
raise ValueError("invalid state transition")
return allowed[(state, event)]
s = transition(State.PROCESSING, "stored")
assert s is State.ARTIFACT_READY
assert transition(s, "checks_passed") is State.VERIFIED
assert transition(s, "error") is State.FAILED
try:
transition(State.PROCESSING, "checks_passed")
except ValueError:
pass
else:
raise AssertionError("cannot skip artifact readiness")
Αυτό το μηχάνημα συνθετικής κατάστασης δεν περιλαμβάνει ακύρωση ουράς, έλεγχο και διαγραφή λήξης. Οι υλοποιήσεις παραγωγής θα πρέπει να κλιμακώνονται ανάλογα με την επιχείρηση, αντί να στριμώχνουν όλα τα συμβάντα σε ένα δυαδικό αρχείο "επιτυχίας/αποτυχίας".
Τα ασύγχρονα μηνύματα ενδέχεται επίσης να επαναλαμβάνονται ή να είναι εκτός λειτουργίας, απαιτώντας τη συνεργασία αριθμών έκδοσης, συναλλαγών και ανεπαρκούς επεξεργασίας. Διαφορετικά, τα παλιά μηνύματα ενδέχεται να αντικαταστήσουν τη νέα κατάσταση και η ίδια εργασία μπορεί να γραφτεί επανειλημμένα.
Οι προτροπές στο μπροστινό μέρος πρέπει να αντιστοιχούν σε γεγονότα
Κάθε κατάσταση στο μπροστινό μέρος θα πρέπει να αντιστοιχεί σε ένα γεγονός που μπορεί να επιβεβαιωθεί από το πίσω άκρο και να δώσει τις αντίστοιχες διαθέσιμες ενέργειες.
| κατάσταση | Οι χρήστες μπορούν να δουν | Διαθέσιμες ενέργειες |
|---|---|---|
| processing | Επεξεργασία | Ελέγξτε την πρόοδο ή ακυρώστε |
| artifact_ready | Έλεγχος αποτελεσμάτων | Διατίθεται χωρίς προηγούμενη δέσμευση |
| verified | Αρχείο με δυνατότητα λήψης | Λήψη και προβολή οδηγιών αποδοχής |
| failed | Στάδια και αιτίες αποτυχίας | Διορθώστε ή δοκιμάστε ξανά βάσει του λόγου |
Ακόμα κι αν η λήψη είναι επιτυχής, δεν σημαίνει ότι το περιεχόμενο είναι σωστό.
Το HTTP 200 μπορεί να επιστρέψει μια σελίδα σύνδεσης, κακό JSON ή ένα κενό έγγραφο. Η αποδοχή θα πρέπει να ελέγχει τουλάχιστον τα ακόλουθα στοιχεία:
- Τύπος: Εάν η μορφή αρχείου είναι η αναμενόμενη
- Μέγεθος: Εάν το αρχείο είναι κενό ή προφανώς μη φυσιολογικό
- Διαθεσιμότητα ανάλυσης: εάν το αρχείο μπορεί να ανοίξει και να αναλυθεί κανονικά
- Αναμενόμενο περιεχόμενο: Εάν το περιεχόμενο είναι συνεπές με τις απαιτήσεις της εργασίας
Για τη μετάφραση, η ακεραιότητα της γλώσσας και η αναθεώρηση ορολογίας αποτελούν ελέγχους υψηλότερου επιπέδου και δεν πρέπει να αντικατασταθούν από τη λέξη "το αρχείο μπορεί να ανοίξει".
Διατηρήστε την κατάσταση διαφανή κατά την ενσωμάτωση των δυνατοτήτων μετάφρασης
Μετά την πρόσβαση στο OmniDoc (πύλη προϊόντων), τα δικά σας προϊόντα θα πρέπει να διατηρούν τη δική τους κατάσταση αποθήκευσης και παράδοσης. Αφού ολοκληρωθεί η εργασία της πλατφόρμας, μπορεί να αντιστοιχιστεί πρώτα στο "Έναρξη λήψης αποτελεσμάτων" και, στη συνέχεια, θα εμφανιστεί η επιτυχία αφού επιβεβαιωθεί ότι το αρχείο είναι διαθέσιμο. Αυτό είναι περισσότερο σύμφωνο με την πραγματική εμπειρία του χρήστη παρά με την απευθείας μετάδοση μιας κατάστασης.
Αναφορές: Python enum
🎯 Ποια μέθοδος είναι κατάλληλη για εσάς;
αν……
Εάν η εργασία σας είναι απλώς υπολογισμός παρασκηνίου και δεν υπάρχει εξωτερικό αρχείο παράδοσης
Μόνο το τέλος της επεξεργασίας και τα στάδια αποτυχίας πρέπει να καταγράφονται και το προϊόν και η αποδοχή μπορούν να παραλειφθούν προσωρινά.
Εάν πρέπει να επιτρέψετε στους χρήστες να κατεβάσουν τα αποτελέσματα
Πρέπει να περιμένετε έως ότου το προϊόν είναι έτοιμο και εγκριθεί για να εμφανιστεί ως διαθέσιμο για λήψη.
Εάν έχετε πρόσβαση σε πλατφόρμα επεξεργασίας τρίτου μέρους
Αντιστοιχίστε την ολοκλήρωση της πλατφόρμας στο "Έναρξη λήψης αποτελεσμάτων" και, στη συνέχεια, εμφανίστε την επιτυχία μετά την επιβεβαίωση του αρχείου.
Εάν οι εργασίες ενδέχεται να επαναληφθούν ή να επιστραφούν εκτός λειτουργίας
Προσθέστε έναν αριθμό έκδοσης στο κράτος και βεβαιωθείτε ότι το κράτος προχωρά μόνο μέσω συναλλαγών και ανίκανης επεξεργασίας.
❓ Συχνές ερωτήσεις (FAQ)
1. Η εργασία εμφανίζεται ως ολοκληρωμένη, γιατί δεν είναι δυνατή η λήψη της ακόμα;
Επειδή το τέλος της επεξεργασίας σημαίνει μόνο ότι ο υπολογισμός έχει σταματήσει, πρέπει επίσης να επιβεβαιωθεί ότι το προϊόν είναι έτοιμο και να εγκριθεί, πράγμα που σημαίνει ότι το αρχείο πληροί τη συμφωνία παράδοσης.
2. Η λήψη επιστρέφει HTTP 200. Αυτό σημαίνει ότι δεν υπάρχει πρόβλημα με το αρχείο;
αβέβαιος. Το HTTP 200 μπορεί να επιστρέψει μια σελίδα σύνδεσης, κακό JSON ή ένα κενό έγγραφο, απαιτώντας επίσης ελέγχους για τον τύπο, το μέγεθος, τη διαθεσιμότητα ανάλυσης και το αναμενόμενο περιεχόμενο.
3. Γιατί η κατάσταση αποτυχίας έχει στάδια;
Η φάση αποτυχίας ενημερώνει τον χρήστη εάν το πρόβλημα επεξεργάζεται, δημιουργείται ή ελέγχεται, ώστε να μπορεί να αποφασίσει να περιμένει, να προσπαθήσει ξανά ή να διορθώσει την εισαγωγή.
4. Αρκεί να ανοίξει το αρχείο για εργασίες μετάφρασης;
δεν είναι αρκετό. Οι έλεγχοι ακεραιότητας γλώσσας και ορολογίας είναι έλεγχοι υψηλότερου επιπέδου και δεν πρέπει να αντικαθίστανται από τη λέξη "το αρχείο μπορεί να ανοίξει".
📝 Περίληψη
Μόνο με τον διαχωρισμό της κατάστασης εκτέλεσης και της κατάστασης παράδοσης μπορεί η διεπαφή να ενημερώσει τον χρήστη την πραγματική πρόοδο. Μόνο όταν το προϊόν είναι έτοιμο και γίνει αποδεκτό, θα πρέπει να εμφανίζεται ως διαθέσιμο για λήψη.
Δοκιμάστε το τώρα: Ανεβάστε το έγγραφο για να ξεκινήσει η μετάφραση, διατηρώντας την αρχική διάταξη


