1. Des produits
  2.   Tableur
  3.   Swift
  4.   Objects2XLSX
 
  

Exportez des SwiftObjects vers des fichiers Excel via une bibliothèque Swift gratuite

Bibliothèque Swift open source qui permet aux développeurs de convertir des objets Swift en fichiers Excel (.xlsx) professionnels avec un style personnalisé.

Qu'est-ce que Objects2XLSX ?

Les applications modernes iOS, macOS et Swift côté serveur ont souvent besoin d'exporter des données structurées vers des feuilles de calcul Microsoft Excel. Que vous génériez des rapports de ventes, des listes d'inventaire, des états financiers ou des tableaux de bord analytiques, créer manuellement des fichiers Excel professionnels peut rapidement devenir complexe. Objects2XLSX est une bibliothèque Swift open source conçue pour résoudre ce problème. Elle permet aux développeurs de convertir directement des objets Swift en classeurs Excel (.xlsx) grâce à une API propre, sûre au niveau des types et déclarative. Au lieu d'écrire manuellement les lignes et les colonnes, les développeurs définissent simplement comment leurs modèles Swift se mappent aux colonnes de la feuille de calcul et laissent la bibliothèque gérer le reste.

La bibliothèque prend en charge le formatage professionnel, plusieurs feuilles de calcul, le suivi de progression et une large gamme de types de données Swift, ce qui en fait une solution excellente pour la génération de rapports et les applications métier. Selon la documentation du projet, Objects2XLSX se concentre sur la sécurité des types, le style, les multiples feuilles de calcul et la génération Excel haute performance. Objects2XLSX élimine une grande partie du code répétitif traditionnellement nécessaire à la génération d'Excel. Au lieu de créer manuellement des cellules, de formater les feuilles de calcul et de gérer les conversions de données, les développeurs travaillent directement avec des objets Swift. Parmi les cas d'utilisation courants figurent l'exportation de dossiers clients, la création de rapports financiers, la gestion des stocks, l'exportation de données d'employés, l'analyse commerciale, le reporting des ventes, les systèmes de notation éducatifs et les tableaux de bord administratifs.

Previous Next

Premiers pas avec Objects2XLSX

La méthode recommandée pour installer Objects2XLSX est d'utiliser Swift Package Manager (SPM) ou Cocoapods. Veuillez utiliser la commande suivante pour une installation fluide.

Installer Objects2XLSX via 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

Installer Objects2XLSX via GitHub :

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

Vous pouvez le télécharger directement depuis GitHub.

Construction déclarative de classeur via Swift

La création de classeurs à onglets multiples nécessitait historiquement des scripts logiques imbriqués, étape par étape, difficiles à faire évoluer ou à refactoriser. Objects2XLSX utilise une couche de syntaxe déclarative qui imite les langages spécifiques à un domaine (DSL) modernes. Cela permet aux ingénieurs de spécifier exactement quelles feuilles, colonnes et relations structurelles doivent exister à l'intérieur d'un conteneur de classeur, le tout dans une hiérarchie visuelle claire. Cette configuration optimise grandement la maintenance à long terme du code et simplifie les revues de code collaboratives.

Comment réaliser la construction déclarative de classeur via l'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
}

Appliquer un style Excel professionnel via Swift

Les rapports professionnels nécessitent plus que des données brutes. La bibliothèque open source Objects2XLSX offre des capacités de style étendues, permettant aux développeurs de personnaliser les polices, les couleurs, les bordures, les alignements et l'apparence des cellules. Cela facilite la génération de classeurs prêts à l'emploi pour les entreprises sans avoir à ouvrir Excel ensuite pour un formatage manuel. Le système de style est conçu pour produire des classeurs soignés adaptés aux présentations, aux rapports et aux flux de travail d'entreprise.

Comment appliquer un style personnalisé via la bibliothèque 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 }

Appliquer un style Excel professionnel via Swift

Les rapports professionnels nécessitent plus que des données brutes. La bibliothèque open source Objects2XLSX offre de vastes capacités de style, permettant aux développeurs de personnaliser les polices, les couleurs, les bordures, les alignements et l'apparence des cellules. Cela facilite la génération de feuilles de calcul prêtes à l'emploi sans ouvrir Excel ensuite pour un formatage manuel. Le système de style est conçu pour produire des classeurs soignés adaptés aux présentations, aux rapports et aux flux de travail d'entreprise.

Comment appliquer un style personnalisé via la bibliothèque 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 }

Suivi de progression pour les exportations volumineuses

La génération de classeurs Excel contenant des milliers d'enregistrements peut prendre un temps notable. Objects2XLSX inclut des capacités de suivi de progression qui permettent aux développeurs de surveiller les opérations d'exportation en temps réel. Cette fonctionnalité est particulièrement utile dans les applications de bureau et les systèmes d'entreprise où les utilisateurs attendent un retour visuel pendant les processus de génération de rapports longs.

 Français