Xuất SwiftObjects sang tệp Excel qua Thư viện Swift miễn phí

Thư viện Swift mã nguồn mở cho phép các nhà phát triển phần mềm chuyển đổi các đối tượng Swift thành các tệp Excel (.xlsx) chuyên nghiệp với định dạng tùy chỉnh.

Objects2XLSX là gì?

Các ứng dụng Swift hiện đại trên iOS, macOS và phía máy chủ thường cần xuất dữ liệu có cấu trúc ra các bảng tính Microsoft Excel. Cho dù bạn đang tạo báo cáo bán hàng, danh sách tồn kho, báo cáo tài chính hay bảng điều khiển phân tích, việc tạo các tệp Excel chuyên nghiệp một cách thủ công có thể nhanh chóng trở nên phức tạp. Objects2XLSX là một thư viện Swift mã nguồn mở được thiết kế để giải quyết vấn đề này. Nó cho phép các nhà phát triển chuyển đổi các đối tượng Swift trực tiếp thành sổ làm việc Excel (.xlsx) bằng một API sạch, an toàn kiểu và khai báo. Thay vì viết thủ công các hàng và cột, các nhà phát triển chỉ cần định nghĩa cách các mô hình Swift của họ ánh xạ tới các cột bảng tính và để thư viện xử lý phần còn lại.

Thư viện hỗ trợ định dạng chuyên nghiệp, nhiều bảng tính, báo cáo tiến độ và một loạt các kiểu dữ liệu Swift, làm cho nó trở thành giải pháp xuất sắc cho việc tạo báo cáo và các ứng dụng doanh nghiệp. Theo tài liệu dự án, Objects2XLSX tập trung vào tính an toàn kiểu, kiểu dáng, nhiều bảng tính và tạo Excel hiệu suất cao. Objects2XLSX loại bỏ phần lớn mã boilerplate thường cần cho việc tạo Excel. Thay vì tạo ô thủ công, định dạng bảng tính và quản lý chuyển đổi dữ liệu, các nhà phát triển làm việc trực tiếp với các đối tượng Swift. Một số trường hợp sử dụng phổ biến bao gồm xuất hồ sơ khách hàng, tạo báo cáo tài chính, quản lý tồn kho, xuất dữ liệu nhân viên, phân tích kinh doanh, báo cáo bán hàng, hệ thống chấm điểm giáo dục và bảng điều khiển quản trị.

Previous Next

Bắt đầu với Objects2XLSX

Cách khuyến nghị để cài đặt Objects2XLSX là sử dụng Swift Package Manager (SPM) hoặc Cocoapods. Vui lòng sử dụng lệnh sau để cài đặt suôn sẻ.

Cài đặt Objects2XLSX qua Swift Package Manager

  // Add Objects2XLSX to your Package.swift dependencies:

dependencies: [ .package(url: "https://github.com/fatbobman/Objects2XLSX.git", from: "1.3.0") ]

// Import the package
import Objects2XLSX

Cài đặt Objects2XLSX qua GitHub:

 git clone https://github.com/fatbobman/Objects2XLSX.git

Bạn có thể tải xuống trực tiếp từ GitHub.

Xây dựng Workbook khai báo bằng Swift

Việc xây dựng các bảng tính đa tab trong quá khứ đòi hỏi các script logic lồng nhau, từng bước một, khó mở rộng hoặc tái cấu trúc. Objects2XLSX sử dụng lớp cú pháp khai báo mô phỏng các ngôn ngữ miền đặc thù (DSL) hiện đại. Điều này cho phép các kỹ sư xác định chính xác các sheet, cột và mối quan hệ cấu trúc cần có trong một workbook wrapper theo một cấu trúc trực quan, sạch sẽ. Cấu hình này tối ưu đáng kể việc bảo trì mã nguồn lâu dài và đơn giản hoá các buổi review code hợp tác.

Cách thực hiện xây dựng Workbook khai báo qua API Swift?

import Objects2XLSX
import Foundation

struct UserAccount: Sendable { let username: String; let rank: String }
struct LogEntry: Sendable { let timestamp: Date; let action: String }

func generateSystemWorkbook(users: [UserAccount], logs: [LogEntry]) -> Workbook {
    // Declarative assembly definition organizing multi-sheet data structures
    let workbook = Workbook(
        sheets: [
            Sheet(title: "Active Users", columns: [
                Column(header: "User Profile ID", keyPath: \.username),
                Column(header: "Access Group", keyPath: \.rank)
            ]).addRows(users),
            
            Sheet(title: "Security Audits", columns: [
                Column(header: "Event Time", keyPath: \.timestamp),
                Column(header: "Operation Details", keyPath: \.action)
            ]).addRows(logs)
        ]
    )
    return workbook
}

Áp dụng kiểu dáng Excel chuyên nghiệp bằng Swift

Các báo cáo chuyên nghiệp đòi hỏi nhiều hơn chỉ dữ liệu thô. Thư viện mã nguồn mở Objects2XLSX cung cấp khả năng định dạng phong phú, cho phép các nhà phát triển tùy chỉnh phông chữ, màu sắc, viền, căn chỉnh và giao diện ô. Điều này giúp dễ dàng tạo ra các bảng tính sẵn sàng cho doanh nghiệp mà không cần mở Excel sau đó để định dạng thủ công. Hệ thống định dạng được thiết kế để tạo ra các workbook hoàn thiện, phù hợp cho các buổi thuyết trình, báo cáo và quy trình doanh nghiệp.

Cách áp dụng kiểu dáng tùy chỉnh thông qua Thư viện Swift?

import Objects2XLSX
import CoreGraphics

// Define customized visual presets matching enterprise documentation needs
let boldHeaderStyle = Style()
    .font(.system(size: 11, weight: .bold))
    .alignment(.center)
    .background(.color(red: 0.12, green: 0.53, blue: 0.90)) // Corporate Blue

let currencyColumnStyle = Style()
    .numberFormat("$#,##0.00")
    .alignment(.right)

let customizedColumn = Column(
    header: "Gross Revenue", 
    keyPath: \FinancialRow.revenue,
    headerStyle: boldHeaderStyle,
    cellStyle: currencyColumnStyle,
    width: 22.0
)

struct FinancialRow: Sendable { let revenue: Double }

Áp dụng kiểu dáng Excel chuyên nghiệp bằng Swift

Báo cáo chuyên nghiệp đòi hỏi nhiều hơn dữ liệu thô. Thư viện mã nguồn mở Objects2XLSX cung cấp khả năng định dạng phong phú, cho phép các nhà phát triển tùy chỉnh phông chữ, màu sắc, viền, căn chỉnh và giao diện ô. Điều này giúp dễ dàng tạo ra các bảng tính sẵn sàng cho doanh nghiệp mà không cần mở Excel sau đó để định dạng thủ công. Hệ thống định dạng được thiết kế để tạo ra các workbook tinh tế, phù hợp cho các buổi thuyết trình, báo cáo và quy trình doanh nghiệp.

Cách áp dụng kiểu dáng tùy chỉnh thông qua Thư viện Swift?

import Objects2XLSX
import CoreGraphics

// Define customized visual presets matching enterprise documentation needs
let boldHeaderStyle = Style()
    .font(.system(size: 11, weight: .bold))
    .alignment(.center)
    .background(.color(red: 0.12, green: 0.53, blue: 0.90)) // Corporate Blue

let currencyColumnStyle = Style()
    .numberFormat("$#,##0.00")
    .alignment(.right)

let customizedColumn = Column(
    header: "Gross Revenue", 
    keyPath: \FinancialRow.revenue,
    headerStyle: boldHeaderStyle,
    cellStyle: currencyColumnStyle,
    width: 22.0
)

struct FinancialRow: Sendable { let revenue: Double }

Theo dõi tiến độ cho các xuất khẩu lớn

Việc tạo ra các workbook Excel chứa hàng ngàn bản ghi có thể mất thời gian đáng kể. Objects2XLSX bao gồm khả năng theo dõi tiến độ cho phép các nhà phát triển giám sát các hoạt động xuất dữ liệu trong thời gian thực. Tính năng này đặc biệt hữu ích trong các ứng dụng desktop và hệ thống doanh nghiệp, nơi người dùng mong đợi phản hồi trực quan trong quá trình tạo báo cáo kéo dài.

 Tiếng Việt