Pdf

Aspose.Cells for Python via .NET prend en charge la conversion du classeur Excel en PDF. Dans cet exemple, nous verrons la conversion complète d’un classeur Excel en PDF.

Conversion du classeur Excel en PDF

Les fichiers PDF sont largement utilisés pour échanger des documents entre les organisations, les secteurs gouvernementaux et les particuliers. Il s’agit d’un format de document standard et les développeurs de logiciels sont souvent invités à trouver un moyen de convertir des fichiers Microsoft Excel en documents PDF.

Aspose.Cells for Python via .NET prend en charge la conversion de fichiers Excel en PDF et maintient une haute fidélité visuelle dans la conversion.

Aspose.Cells for Python via .NET écrit directement les informations sur l’API et le numéro de version dans les documents de sortie. Par exemple, lors du rendu du document au format PDF, Aspose.Cells for Python via .NET remplit le champ Producteur PDF avec la valeur, par exemple ‘Aspose.Cells for Python via .NET v23.2’.

Veuillez noter que vous pouvez modifier ces informations dans les documents de sortie par la propriété PdfSaveOptions.producer.

Conversion directe

Aspose.Cells pour Python via .NET prend en charge la conversion des feuilles de calcul en PDF indépendamment d’autres logiciels. Enregistrez simplement un fichier Excel au format PDF en utilisant la méthode save de la classe Workbook. La méthode save fournit le membre d’énumération SaveFormat.PDF qui convertit les fichiers Excel natifs au format PDF.

Suivez les étapes ci-dessous pour convertir directement les feuilles de calcul Excel au format PDF :

Instanciez un objet de la classe Workbook en appelant son constructeur vide.
Vous pouvez ouvrir/charger un fichier de modèle existant ou sauter cette étape si vous créez le classeur à partir de zéro.
Effectuez un travail (saisie de données, application de formatage, définition de formules, insertion d’images ou autres objets graphiques, etc.) sur la feuille de calcul en utilisant les API Aspose.Cells for Python via .NET.
Lorsque le code de la feuille de calcul est complet, appelez la méthode save de la classe Workbook pour enregistrer la feuille de calcul.

Le format de fichier doit être PDF, choisissez PDF (une valeur prédéfinie) dans l’énumération SaveFormat pour générer le document PDF final.

	from aspose.cells import SaveFormat, Workbook

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# The path to the documents directory.
	dataDir = RunExamples.GetDataDir(".")
	# Instantiate the Workbook object
	# Open an Excel file
	workbook = Workbook(dataDir + "Book1.xls")
	# Save the document in PDF format
	workbook.save(dataDir + "output.pdf", SaveFormat.PDF)

view raw PDF-XlstoPDFDirectConversation-1.py hosted with ❤ by GitHub

Conversion avancée

Vous pouvez également choisir d’utiliser la classe PdfSaveOptions pour définir différentes propriétés pour la conversion. Le fait de définir différentes propriétés de la classe PdfSaveOptions vous donne le contrôle sur les paramètres d’impression, de police, de sécurité et de compression pour le fichier PDF de sortie. La propriété la plus importante est PdfSaveOptions.compliance qui vous permet d’enregistrer les fichiers Excel au format PDF/A conforme.

Enregistrement du classeur en fichiers conformes PDF/A

L’exemple de code ci-dessous démontre comment utiliser la classe PdfSaveOptions pour enregistrer des fichiers Excel au format PDF/A conforme.

	from aspose.cells import PdfSaveOptions, Workbook
	from aspose.cells.rendering import PdfCompliance

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# The path to the documents directory.
	dataDir = RunExamples.GetDataDir(".")
	# Instantiate new workbook
	workbook = Workbook()
	# Insert a value into the A1 cell in the first worksheet
	workbook.worksheets[0].cells.get(0, 0).put_value("Testing PDF/A")
	# Define PdfSaveOptions
	pdfSaveOptions = PdfSaveOptions()
	# Set the compliance type
	pdfSaveOptions.compliance = PdfCompliance.PDF_A1B
	# Save the file
	workbook.save(dataDir + "output.pdf", pdfSaveOptions)

view raw PDF-AdvancedConversiontoPdf-1.py hosted with ❤ by GitHub

Veuillez noter que la propriété PdfSaveOptions.compliance a été ajoutée avec la sortie d’Aspose.Cells pour Python via .NET pour .NET 5.3.0.

Définir l’heure de création du PDF

Avec la classe PdfSaveOptions, vous pouvez obtenir ou définir l’heure de création du PDF. Le code suivant démontre l’utilisation de la propriété PdfSaveOptions.created_time pour définir l’heure de création du fichier PDF.

	from aspose.cells import PdfSaveOptions, SaveFormat, Workbook
	from datetime import datetime

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	dataDir = RunExamples.GetDataDir(".")
	inputPath = dataDir + "Book1.xlsx"
	# Load excel file containing charts
	workbook = Workbook(inputPath)
	# Create an instance of PdfSaveOptions and pass SaveFormat to the constructor
	options = PdfSaveOptions(SaveFormat.PDF)
	options.created_time = datetime.now()
	# Save the workbook to PDF format while passing the object of PdfSaveOptions
	workbook.save(dataDir + "output.pdf", options)

view raw PDF-SetPDFCreationTime-1.py hosted with ❤ by GitHub

Définir l’option ContentCopyForAccessibility

Avec la classe PdfSaveOptions, vous pouvez obtenir ou définir l’option de PDF PdfSecurityOptions.accessibility_extract_content pour contrôler l’accès au contenu dans le PDF converti.

	from aspose.cells import PdfSaveOptions, SaveFormat, Workbook
	from aspose.cells.rendering.pdfsecurity import PdfSecurityOptions

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# Source directory
	sourceDir = RunExamples.Get_SourceDirectory()
	# Output directory
	outputDir = RunExamples.Get_OutputDirectory()
	inputPath = sourceDir + "BookWithSomeData.xlsx"
	# Load excel file containing some data
	workbook = Workbook(inputPath)
	# Create an instance of PdfSaveOptions and pass SaveFormat to the constructor
	pdfSaveOpt = PdfSaveOptions(SaveFormat.PDF)
	# Create an instance of PdfSecurityOptions
	securityOptions = PdfSecurityOptions()
	# Set AccessibilityExtractContent to true
	securityOptions.accessibility_extract_content = False
	# Set the securityoption in the PdfSaveOptions
	pdfSaveOpt.security_options = securityOptions
	# Save the workbook to PDF format while passing the object of PdfSaveOptions
	workbook.save(outputDir + "outFile.pdf", pdfSaveOpt)

view raw PDF-SetContentCopyForAccessibility-1.py hosted with ❤ by GitHub

Exporter les propriétés personnalisées vers un PDF

Avec la classe PdfSaveOptions, vous pouvez exporter les propriétés personnalisées du classeur source vers le PDF. L’énumérateur PdfCustomPropertiesExport est fourni pour spécifier la manière dont les propriétés sont exportées. Ces propriétés peuvent être observées dans Adobe Acrobat Reader en cliquant sur Fichier, puis sur l’option propriétés comme indiqué dans l’image suivante. Le fichier modèle “sourceWithCustProps.xlsx” peut être téléchargé ici pour les tests et le fichier PDF de sortie “outSourceWithCustProps” est disponible ici pour l’analyse.

todo:image_alt_text

	from aspose.cells import PdfSaveOptions, SaveFormat, Workbook
	from aspose.cells.rendering import PdfCustomPropertiesExport

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# Load excel file containing custom properties
	workbook = Workbook("sourceWithCustProps.xlsx")
	# Create an instance of PdfSaveOptions and pass SaveFormat to the constructor
	pdfSaveOptions = PdfSaveOptions(SaveFormat.PDF)
	# Set CustomPropertiesExport property to PdfCustomPropertiesExport.Standard
	pdfSaveOptions.custom_properties_export = PdfCustomPropertiesExport.STANDARD
	# Save the workbook to PDF format while passing the object of PdfSaveOptions
	workbook.save("outSourceWithCustProps.pdf", pdfSaveOptions)

view raw PDF-ExportCustomPropertiesToPdf-1.py hosted with ❤ by GitHub

Attributs de conversion

Nous travaillons à améliorer les fonctionnalités de conversion avec chaque nouvelle version. La conversion d’Excel en PDF d’Aspose.Cell a encore quelques limitations. MapChart n’est pas pris en charge lors de la conversion au format PDF. De plus, certains objets de dessin ne sont pas bien pris en charge.

Le tableau suivant répertorie toutes les fonctionnalités entièrement ou partiellement prises en charge lors de l’exportation au format PDF à l’aide d’Aspose.Cells pour Python via .NET. Ce tableau n’est pas final et ne couvre pas toutes les attributs de la feuille de calcul, mais identifie les fonctionnalités qui ne sont pas entièrement prises en charge ou partiellement prises en charge pour la conversion en PDF.

Élément du document	Attribut	Pris en charge	Notes
Alignement		Oui
Paramètres de fond		Oui
Bordure	Couleur	Oui
Bordure	Style de ligne	Oui
Bordure	Largeur de ligne	Oui
Données de cellule		Oui
Commentaires		Oui
Mise en forme conditionnelle		Oui
Propriétés du document		Oui
Objets de dessin		Partiellement	Les effets d’ombre et 3D pour les objets graphiques ne sont pas bien pris en charge ; WordArt et SmartArt sont partiellement pris en charge.
Police	Taille	Oui
Police	Couleur	Oui
Police	Style	Oui
Police	Souligner	Oui
Police	Effets	Oui
Images		Oui
Hyperlien		Oui
Graphiques		Partiellement	Le MapChart n’est pas pris en charge.
Cellules Fusionnées		Oui
Saut de page		Oui
Configuration de la page	En-tête/Pied de page	Oui
Configuration de la page	Marges	Oui
Configuration de la page	Orientation de la page	Oui
Configuration de la page	Taille de la page	Oui
Configuration de la page	Zone d’impression	Oui
Configuration de la page	Titres à imprimer	Oui
Configuration de la page	Mise à l’échelle	Oui
Hauteur de ligne/Largeur de colonne		Oui
Langue RTL (de droite à gauche)		Oui

Si votre feuille de calcul contient des formules, il est préférable d’appeler la méthode Workbook.calculate_formula juste avant de générer la feuille de calcul au format PDF. De cette façon, les valeurs dépendant des formules seront recalculées et les valeurs correctes seront rendues dans le PDF.

Sujets avancés

Convertir Excel en CSV, TSV et Txt HTML