Bộ chuyển đổi CSV / JSON / Excel

Cơ chế hoạt động và cấu trúc dữ liệu bảng

Công cụ này thực hiện chuyển đổi qua lại giữa các định dạng CSV, JSON và Excel (XLSX). Quá trình chuyển đổi dựa trên việc ánh xạ cấu trúc dữ liệu dạng bảng, trong đó dữ liệu được tổ chức dưới dạng các hàng và cột.

Mỗi định dạng có cách biểu diễn dữ liệu đặc thù:

• CSV (Comma-Separated Values): Là định dạng văn bản thuần túy, nơi các hàng được phân tách bằng ký tự xuống dòng và các cột được phân tách bằng một ký tự đặc biệt gọi là dấu phân cách.
• JSON (JavaScript Object Notation): Là định dạng trao đổi dữ liệu có cấu trúc dưới dạng văn bản, thường biểu diễn bảng dưới dạng một mảng chứa các đối tượng hoặc mảng chứa các mảng.
• Excel (XLSX): Là định dạng tệp nén dựa trên XML của Microsoft Excel, hỗ trợ nhiều trang tính, công thức, định dạng ô và siêu dữ liệu.

Khi chuyển đổi giữa các định dạng này, công cụ áp dụng các quy tắc chuẩn hóa để đảm bảo tính toàn vẹn của cấu trúc bảng.

Quy tắc chuyển đổi và xử lý cấu trúc JSON lồng nhau

Khi chuyển đổi từ JSON sang cấu trúc bảng (CSV hoặc Excel), công cụ áp dụng các quy tắc phân tích cú pháp cụ thể để chuyển đổi dữ liệu phân cấp thành dạng phẳng:

• Mảng của các đối tượng (Arrays of objects): Mỗi đối tượng trong mảng sẽ được chuyển đổi thành một hàng trong bảng. Các khóa của đối tượng (object keys) sẽ trở thành tiêu đề của các cột.
• Khóa đối tượng lồng nhau (Nested object keys): Đối với các đối tượng chứa các đối tượng con bên trong, công cụ sẽ làm phẳng cấu trúc này bằng cách sử dụng đường dẫn dạng dấu chấm (dot paths) để tạo tên cột. Ví dụ, một khóa address chứa khóa con city sẽ được chuyển đổi thành cột có tên address.city.
• Mảng của các mảng (Arrays of arrays): Các mảng nằm trong mảng lớn sẽ được giữ nguyên cấu trúc trực tiếp dưới dạng các hàng của bảng.

Giới hạn khi chuyển đổi từ định dạng Excel

Việc chuyển đổi từ định dạng bảng tính vạn năng như Excel sang các định dạng văn bản thuần túy như CSV hoặc JSON có một số giới hạn kỹ thuật cần lưu ý:

• Giới hạn trang tính: Công cụ chỉ thực hiện chuyển đổi các giá trị từ trang tính (worksheet) đầu tiên của tệp Excel. Dữ liệu ở các trang tính phía sau sẽ không được xử lý.
• Không giữ nguyên công thức: Công cụ chỉ đọc và chuyển đổi các giá trị hiển thị được ghi nhận trong tệp. Các công thức toán học hay hàm tính toán sẽ không được thực thi hay bảo toàn.
• Không giữ nguyên định dạng: Toàn bộ định dạng kiểu dáng ô, bao gồm màu sắc, phông chữ, căn lề, viền ô hay định dạng số tùy chỉnh đều bị loại bỏ trong quá trình chuyển đổi. Kết quả đầu ra chỉ chứa dữ liệu thô.

Vai trò của dấu phân cách trong tệp CSV

Trong định dạng CSV, dấu phân cách đóng vai trò quyết định để trình phân tích cú pháp nhận diện ranh giới giữa các trường dữ liệu trong cùng một hàng. Khi chuyển đổi dữ liệu sang CSV, người dùng có thể chỉ định một trong ba loại dấu phân cách phổ biến:

• Dấu phẩy: Dấu phân cách tiêu chuẩn được sử dụng rộng rãi nhất.
• Dấu chấm phẩy: Thường được sử dụng ở các quốc gia sử dụng dấu phẩy làm dấu phân cách thập phân.
• Tab: Sử dụng ký tự tab để phân tách, tạo thành định dạng TSV (Tab-Separated Values).

Việc lựa chọn đúng dấu phân cách giúp tệp CSV đầu ra tương thích tốt nhất với phần mềm đích mà bạn sẽ nhập dữ liệu vào.

Cơ chế xử lý cục bộ và bảo mật dữ liệu

Công cụ hoạt động hoàn toàn dựa trên cơ chế xử lý phía máy khách (client-side processing). Khi bạn chọn hoặc kéo thả tệp vào công cụ, toàn bộ quá trình phân tích cú pháp, chuyển đổi cấu trúc và khởi tạo tệp tải xuống đều diễn ra trực tiếp trong trình duyệt web của bạn.

Không có bất kỳ dữ liệu nào được tải lên máy chủ BroBroGo. Điều này đảm bảo dữ liệu bảng tính của bạn không rời khỏi thiết bị cá nhân trong suốt quá trình xử lý.

Các thông báo lỗi và trạng thái hệ thống

Trong quá trình vận hành, công cụ có thể hiển thị các thông báo lỗi hoặc trạng thái cụ thể tùy thuộc vào tệp đầu vào và cấu hình lựa chọn:

• Vui lòng chọn một tệp trước. - Hiển thị khi người dùng yêu cầu chuyển đổi nhưng chưa tải tệp lên.
• Vui lòng chọn tệp CSV, JSON hoặc XLSX. - Xuất hiện khi định dạng tệp tải lên không nằm trong danh sách hỗ trợ.
• Tệp này quá lớn. Vui lòng sử dụng tệp dưới {max}. - Xuất hiện khi dung lượng tệp vượt quá giới hạn xử lý của trình duyệt.
• Vui lòng chọn một định dạng đầu ra khác. - Xuất hiện khi định dạng đầu ra trùng lặp với định dạng gốc của tệp đầu vào.
• Không thể chuyển đổi tệp này. - Lỗi chung khi quá trình chuyển đổi thất bại do sự cố không xác định.
• Không thể phân tích cú pháp tệp CSV này. - Xuất hiện khi cấu trúc tệp CSV bị lỗi hoặc không thể đọc.
• JSON này không hợp lệ hoặc không có cấu trúc dạng bảng. - Xuất hiện khi tệp JSON sai cú pháp hoặc không tuân theo cấu trúc mảng/đối tượng có thể chuyển thành bảng.
• Không thể mở tệp Excel này. - Xuất hiện khi tệp XLSX bị hỏng hoặc không đúng định dạng tiêu chuẩn.
• Tệp này không có hàng bảng nào. - Xuất hiện khi tệp nguồn trống hoặc không chứa dữ liệu hợp lệ.
• Bảng này có nhiều hơn {max} hàng. - Giới hạn số lượng hàng tối đa mà công cụ có thể xử lý.
• Bảng này có nhiều hơn {max} cột. - Giới hạn số lượng cột tối đa mà công cụ có thể xử lý.
• Đã hủy chuyển đổi. - Trạng thái khi người dùng chủ động dừng tiến trình.
• Quá trình chuyển đổi đang mất quá nhiều thời gian. Hãy thử một tệp nhỏ hơn. - Xuất hiện khi trình duyệt bị nghẽn do xử lý dữ liệu quá nặng.

Câu hỏi thường gặp

Các bảng tính của tôi có bị tải lên không? Không. Các tệp CSV, JSON và XLSX được phân tích cú pháp trực tiếp trong trình duyệt của bạn và tệp tải xuống được tạo cục bộ.

Công cụ có giữ nguyên các công thức và định dạng Excel không? Không. Công cụ này chuyển đổi các giá trị hiển thị từ trang tính (worksheet) đầu tiên thành một bảng sạch. Nó không tính toán công thức hoặc giữ nguyên định dạng kiểu dáng ô.

JSON được chuyển đổi thành bảng như thế nào? Các mảng đối tượng sẽ trở thành các hàng, các khóa đối tượng trở thành các cột, và các khóa đối tượng lồng nhau sẽ được làm phẳng bằng các đường dẫn dạng dấu chấm. Các mảng của mảng được giữ nguyên dưới dạng các hàng bảng.