صادرات SwiftObjects به فایل‌های اکسل با استفاده از کتابخانه رایگان سوئیفت

کتابخانه منبع باز سوئیفت که به توسعه‌دهندگان نرم‌افزار امکان تبدیل اشیاء سوئیفت به فایل‌های حرفه‌ای اکسل (.xlsx) با استایل سفارشی را می‌دهد.

Objects2XLSX چیست؟

برنامه‌های مدرن iOS، macOS و Swift سمت سرور اغلب نیاز دارند داده‌های ساختاریافته را به صفحات گسترده Microsoft Excel صادر کنند. چه در حال تولید گزارش‌های فروش، فهرست‌های موجودی، صورت‌های مالی یا داشبوردهای تحلیلی باشید، ایجاد فایل‌های Excel حرفه‌ای به صورت دستی می‌تواند به سرعت پیچیده شود. Objects2XLSX یک کتابخانه منبع باز Swift است که برای حل این مشکل طراحی شده است. این کتابخانه به توسعه‌دهندگان امکان می‌دهد اشیاء Swift را به‌صورت مستقیم به کتاب‌کارهای Excel (.xlsx) تبدیل کنند، با استفاده از یک API تمیز، ایمن از نظر نوع و اعلانی. به‌جای نوشتن دستی ردیف‌ها و ستون‌ها، توسعه‌دهندگان به سادگی نحوه نگاشت مدل‌های Swift خود به ستون‌های صفحه‌گسترده را تعریف می‌کنند و بقیه کار را کتابخانه انجام می‌دهد.

این کتابخانه از قالب‌بندی حرفه‌ای، چندین برگه کاری، گزارش‌گیری پیشرفت و طیف گسترده‌ای از انواع داده‌های Swift پشتیبانی می‌کند و آن را به راه‌حلی عالی برای تولید گزارش و برنامه‌های تجاری تبدیل می‌سازد. بر اساس مستندات پروژه، Objects2XLSX بر ایمنی نوع، استایل‌دهی، چندین برگه کاری و تولید اکسل با عملکرد بالا تمرکز دارد. Objects2XLSX بخش زیادی از کدهای تکراری که به‌طور سنتی برای تولید اکسل لازم بودند، حذف می‌کند. به‌جای ایجاد دستی سلول‌ها، قالب‌بندی برگه‌های کاری و مدیریت تبدیل داده‌ها، توسعه‌دهندگان مستقیماً با اشیاء Swift کار می‌کنند. برخی موارد استفاده رایج شامل صادرات سوابق مشتریان، ایجاد گزارش‌های مالی، مدیریت موجودی، صادرات داده‌های کارمندان، تحلیل‌های تجاری، گزارش‌گیری فروش، سیستم‌های نمره‌دهی آموزشی و داشبوردهای اداری است.

Previous Next

شروع کار با Objects2XLSX

روش پیشنهادی برای نصب Objects2XLSX استفاده از Swift Package Manager (SPM) یا CocoaPods است. لطفاً برای نصب روان، دستور زیر را اجرا کنید.

نصب Objects2XLSX از طریق 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

نصب Objects2XLSX از طریق GitHub:

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

می‌توانید آن را مستقیماً از GitHub دانلود کنید.

ساخت کتاب کار به صورت اعلامی با سوئیفت

ساخت جدول‌های چندبرگه‌ای در گذشته نیاز به اسکریپت‌های منطق تو در تو و گام‌به‌گام داشت که مقیاس‌پذیر یا بازسازی آن‌ها دشوار بود. Objects2XLSX از لایهٔ سینتکس اعلان‌گر استفاده می‌کند که زبان‌های دامنه‌خاص مدرن (DSLها) را شبیه‌سازی می‌کند. این امکان را به مهندسان می‌دهد تا دقیقاً بگویند چه برگه‌ها، ستون‌ها و روابط ساختاری باید داخل یک wrapper کتاب‌کار وجود داشته باشد، به‌صورت یک سلسله‌مراتب بصری و تمیز. این پیکربندی به‌طور قابل‌توجهی نگهداری طولانی‌مدت کد را بهینه می‌کند و بازبینی‌های مشترک کد را ساده‌تر می‌سازد.

چگونه ساخت کتاب کار به صورت اعلامی را با API سوئیفت انجام دهیم؟

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
}

اعمال استایل حرفه‌ای اکسل با سوئیفت

گزارش‌های حرفه‌ای به بیش از داده‌های خام نیاز دارند. کتابخانهٔ منبع باز Objects2XLSX قابلیت‌های گستردهٔ استایل‌دهی را فراهم می‌کند و به توسعه‌دهندگان اجازه می‌دهد فونت‌ها، رنگ‌ها، حاشیه‌ها، ترازها و ظاهر سلول‌ها را سفارشی کنند. این باعث می‌شود به‌راحتی جدول‌های آماده برای کسب‌وکار تولید شوند بدون اینکه پس از آن برای قالب‌بندی دستی Excel را باز کنید. سیستم استایل‌دهی طوری طراحی شده است که کتاب‌کارهای صیقلی تولید کند که برای ارائه‌ها، گزارش‌گیری و جریان‌های کاری سازمانی مناسب باشند.

چگونه استایل سفارشی را از طریق کتابخانه 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 }

اعمال استایل حرفه‌ای اکسل با سوئیفت

گزارش‌های حرفه‌ای بیش از داده‌های خام نیاز دارند. کتابخانه منبع باز Objects2XLSX قابلیت‌های گسترده‌ای برای استایل‌دهی فراهم می‌کند که به توسعه‌دهندگان اجازه می‌دهد فونت‌ها، رنگ‌ها، حاشیه‌ها، ترازها و ظاهر سلول‌ها را سفارشی کنند. این امکان را می‌دهد تا به راحتی صفحات گسترده آماده کسب‌وکار تولید شوند بدون اینکه پس از آن برای قالب‌بندی دستی Excel را باز کنید. سیستم استایل‌دهی به گونه‌ای طراحی شده است که کتاب‌های کاری صیقلی مناسب برای ارائه‌ها، گزارش‌گیری و جریان‌های کاری سازمانی تولید کند.

چگونه استایل سفارشی را از طریق کتابخانه 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 }

پیگیری پیشرفت برای صادرات بزرگ

تولید کتاب‌های کاری Excel حاوی هزاران رکورد ممکن است زمان قابل توجهی ببرد. Objects2XLSX شامل قابلیت‌های ردیابی پیشرفت است که به توسعه‌دهندگان اجازه می‌دهد عملیات صادرات را به‌صورت زمان واقعی نظارت کنند. این ویژگی به‌ویژه در برنامه‌های دسکتاپ و سیستم‌های سازمانی مفید است که کاربران انتظار بازخورد بصری در طول فرآیندهای طولانی تولید گزارش را دارند.

 فارسی