Tác vụ được hiển thị là đã hoàn thành, nhưng tệp tải xuống là một tệp trống? Trạng thái thực hiện và phân phối riêng biệt

Trang tác vụ hiển thị "Hoàn thành", nhưng khi tôi nhấp vào tải xuống, tôi nhận được một tệp trống. Vấn đề thường không phải ở bản thân văn bản nhắc nhở mà ở phần phụ trợ chỉ ghi lại phần cuối của quá trình thực thi thuật toán và không ghi lại liệu quá trình phân phối đã sẵn sàng hay chưa. Bài viết này được viết cho các nhà phát triển đang thực hiện xử lý tài liệu, các tác vụ không đồng bộ hoặc tích hợp dịch thuật. Đọc xong bạn sẽ biết cách tách biệt trạng thái thực thi và trạng thái phân phối để front end có thể hiển thị tiến trình thực sự cho người dùng.

Các ví dụ trong bài viết này sử dụng mẫu tổng hợp và mã đã được kiểm tra mẫu trong môi trường biệt lập. Điều này không thể hiện sự đảm bảo về tất cả các tệp thực hoặc hiệu ứng sản phẩm. Trước khi xử lý các văn bản quan trọng, vui lòng giữ lại bản chính và xem xét theo ranh giới và các mục chấp nhận trong văn bản.

Tệp tải xuống là một tệp trống nhưng tác vụ được hiển thị là đã hoàn thành? Một câu kết luận

Trước tiên, hãy chia "quá trình xử lý đã hoàn tất" thành ba trạng thái: đang xử lý, sản phẩm và chấp nhận, sau đó để giao diện người dùng chỉ hiển thị trạng thái đã được xác nhận.

Ít nhất hãy phân biệt giữa xử lý, sản phẩm và chấp nhận

Kết thúc quá trình xử lý có nghĩa là quá trình tính toán đã dừng lại; sản phẩm đã sẵn sàng, có nghĩa là tập tin có thể được định vị; và việc chấp nhận hoàn tất, có nghĩa là hồ sơ đáp ứng được thỏa thuận giao hàng. Cả ba điều này không nhất thiết phải xảy ra cùng một lúc.

Thất bại cũng phải có các giai đoạn và không thể bị ẩn bằng biểu tượng xoay vĩnh viễn. Người dùng biết liệu có xảy ra lỗi trong quá trình xử lý, tạo hoặc kiểm tra hay không, để họ biết nên đợi, thử lại hay sửa chữa đầu vào.

📊 So sánh cốt lõi

Từ chối rõ ràng việc nhảy thành công

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")

Máy trạng thái tổng hợp này không bao gồm việc hủy hàng đợi, xem xét và xóa hết hạn. Việc triển khai sản xuất nên mở rộng quy mô theo hoạt động kinh doanh, thay vì nhồi nhét tất cả các sự kiện vào hệ nhị phân "thành công/thất bại".

Các thông báo không đồng bộ cũng có thể bị lặp lại hoặc không theo thứ tự, đòi hỏi sự hợp tác của số phiên bản, giao dịch và xử lý bình thường. Nếu không, các tin nhắn cũ có thể ghi đè lên trạng thái mới và cùng một tác vụ có thể được ghi lại.

Lời nhắc của giao diện người dùng phải tương ứng với thực tế

Mỗi trạng thái ở mặt trước phải tương ứng với một thực tế mà mặt sau có thể xác nhận và đưa ra các hành động khả dụng tương ứng.

Ngay cả khi tải xuống thành công, điều đó không có nghĩa là nội dung đúng.

HTTP 200 có thể trả về trang đăng nhập, JSON không hợp lệ hoặc tài liệu trống. Việc chấp nhận ít nhất phải kiểm tra các mục sau:

• Type: Định dạng file có như mong đợi hay không
• Kích thước: Tệp trống hay rõ ràng là bất thường
• Tính khả dụng của phân tích cú pháp: liệu tệp có thể được mở và phân tích cú pháp bình thường hay không
• Nội dung mong đợi: Nội dung có phù hợp với yêu cầu nhiệm vụ không

Đối với bản dịch, tính toàn vẹn của ngôn ngữ và việc xem xét thuật ngữ là các bước kiểm tra cấp cao hơn và không được thay thế bằng "tệp có thể mở được".

Giữ trạng thái minh bạch khi tích hợp khả năng dịch thuật

Sau khi truy cập OmniDoc (cổng thông tin sản phẩm), các sản phẩm của bạn vẫn phải duy trì trạng thái lưu trữ và giao hàng của riêng chúng. Sau khi hoàn thành nhiệm vụ nền tảng, trước tiên nó có thể được ánh xạ tới "Bắt đầu nhận kết quả", sau đó thành công sẽ được hiển thị sau khi xác nhận rằng tệp có sẵn. Điều này phù hợp với trải nghiệm thực tế của người dùng hơn là truyền trực tiếp trạng thái.

Tham khảo: Python enum

🎯 Phương pháp nào phù hợp với bạn?

nếu bạn……

Nếu nhiệm vụ của bạn chỉ là tính toán nền và không có tệp phân phối bên ngoài

Chỉ cần ghi lại giai đoạn kết thúc quá trình xử lý và lỗi, còn sản phẩm và nghiệm thu có thể tạm thời bị bỏ qua.

Nếu cần cho phép người dùng tải kết quả

Bạn phải đợi cho đến khi sản phẩm sẵn sàng và được chấp nhận trước khi sản phẩm được hiển thị là có sẵn để tải xuống.

Nếu bạn có quyền truy cập vào nền tảng xử lý của bên thứ ba

Ánh xạ hoàn thành nền tảng tới "Bắt đầu nhận kết quả", sau đó hiển thị thành công sau khi xác nhận tệp.

Nếu nhiệm vụ có thể được lặp lại hoặc trả về không theo thứ tự

Thêm số phiên bản vào trạng thái và đảm bảo rằng trạng thái chỉ chuyển tiếp thông qua các giao dịch và xử lý bình thường.

❓ Câu hỏi thường gặp (FAQ)

1. Nhiệm vụ hiển thị là đã hoàn thành, tại sao vẫn chưa tải được?

Bởi vì kết thúc quá trình xử lý chỉ có nghĩa là quá trình tính toán đã dừng lại nên cũng cần phải xác nhận rằng sản phẩm đã sẵn sàng và được chấp nhận, nghĩa là hồ sơ đã đáp ứng được thỏa thuận giao hàng.

2. Quá trình tải xuống trả về HTTP 200. Điều này có nghĩa là không có vấn đề gì với tệp phải không?

không chắc chắn. HTTP 200 có thể trả về một trang đăng nhập, JSON không hợp lệ hoặc một tài liệu trống, đồng thời yêu cầu kiểm tra loại, kích thước, khả năng phân tích cú pháp và nội dung dự kiến.

3. Tại sao trạng thái hư hỏng lại có các giai đoạn?

Giai đoạn lỗi cho người dùng biết sự cố đang được xử lý, tạo hay kiểm tra, để họ có thể quyết định chờ, thử lại hoặc sửa dữ liệu đầu vào.

4. Có thể mở file để thực hiện tác vụ dịch thuật được không?

không đủ. Kiểm tra tính toàn vẹn của ngôn ngữ và thuật ngữ là các kiểm tra cấp cao hơn và không được thay thế bằng "tệp có thể mở được".

📝 Tóm tắt

Chỉ bằng cách tách biệt trạng thái thực thi và trạng thái phân phối, giao diện người dùng mới có thể cho người dùng biết tiến trình thực sự. Chỉ khi sản phẩm đã sẵn sàng và được chấp nhận thì nó mới được hiển thị là có sẵn để tải xuống.

Thử ngay: Tải tài liệu lên để bắt đầu dịch, giữ nguyên bố cục ban đầu