Tổng quan

Cấu trúc của nguồn cấp dữ liệu Đặt hàng hai đầu được xác định theo giản đồ khoảng không quảng cáo quan hệ. Nguồn cấp dữ liệu hai đầu sắp xếp thứ tự bao gồm các thực thể cấp cao nhất sau đây:

Sơ đồ dưới đây cho thấy cách các thực thể Service, RestaurantMenu đại diện cho một nhà hàng:

Sơ đồ mối quan hệ lớp Thực đơn dịch vụ nhà hàng
Hình 1: Mối quan hệ tổng thể của việc sắp xếp thứ tự các thực thể nguồn cấp dữ liệu đầu cuối: Dịch vụ, Nhà hàng và Thực đơn.

Nguyên tắc chung

  • Số nhà hàng trong mỗi tệp: Mỗi tệp dữ liệu phải đại diện cho một nhà hàng với các thực thể ServiceMenu có liên quan. Sử dụng tên tệp có thể giúp bạn tìm kiếm một nhà hàng.

  • Định dạng tệp dữ liệu: Các tệp dữ liệu cần được định dạng ở các tệp JSON được phân tách bằng dòng mới (định dạng ndjson).

  • Giá trị ngày giờ và thời gian: Đối với các thuộc tính yêu cầu giá trị DateTime hoặc Time, hãy sử dụng các định dạng được chỉ định trong Định dạng ngày giờ và thời gian. Ví dụ: 2017-05-01T06:30:00+05:30 cho DateTimeT08:08:00+05:30 cho Time.

  • Mã nhận dạng: Sử dụng thuộc tính @id để xác định tất cả các thực thể duy nhất trong một loại thực thể. Độ dài tối đa là 300 ký tự. @id là giá trị nhận dạng duy nhất của thực thể thuộc loại đó, nhưng giữa các thực thể, mã nhận dạng có thể trùng lặp. Ví dụ: giả sử bạn xác định một thực thể Service có thuộc tính @id được đặt thành a16. Bạn không thể tạo một thực thể Service khác có @ida16. Tuy nhiên, bạn có thể sử dụng a16 làm giá trị @id của thực thể Menu.

  • Tạo mã nhận dạng: Giữ mã nhận dạng cố định – không sử dụng mã nhận dạng duy nhất (UUID) hoặc thay đổi/sắp xếp ngẫu nhiên mã nhận dạng giữa các lần tải nguồn cấp dữ liệu lên. Điều này giúp các vấn đề liên quan đến thực thể được hỗ trợ dễ dàng hơn.

  • Giá trị rỗng: Không dùng giá trị null thay cho đối tượng. Nếu một đối tượng là không bắt buộc, bạn phải loại đối tượng đó khỏi nguồn cấp dữ liệu.

Thư viện ứng dụng

Trình tạo mã ứng dụng khách trong phần Công cụ có sẵn để xác thực nguồn cấp dữ liệu Đặt hàng hai đầu của bạn.