Pdf

Aspose.Cells para Python via .NET admite la conversión de libro de Excel a PDF. En este ejemplo, veremos la conversión completa de un libro de Excel a PDF.

Conversión de libro de Excel a PDF

Los archivos PDF son ampliamente utilizados para intercambiar documentos entre organizaciones, sectores gubernamentales e individuos. Es un formato de documento estándar y a menudo se pide a los desarrolladores de software que encuentren una forma de convertir archivos de Microsoft Excel en documentos PDF.

Aspose.Cells para Python via .NET admite la conversión de archivos de Excel a PDF y mantiene una alta fidelidad visual en la conversión.

Aspose.Cells for Python via .NET escribe directamente la información sobre la API y el número de versión en los documentos de salida. Por ejemplo, al convertir un Documento a PDF, Aspose.Cells for Python via .NET completa el campo Productor PDF con el valor, por ejemplo, ‘Aspose.Cells for Python via .NET v23.2’.

Tenga en cuenta que puede cambiar esta información en los Documentos de salida por medio de la propiedad PdfSaveOptions.producer.

Conversión Directa

Aspose.Cells for Python via .NET admite la conversión de hojas de cálculo a PDF de forma independiente de otro software. Simplemente guarde un archivo de Excel a PDF usando el método save de la clase Workbook. El método save proporciona el miembro de enumeración SaveFormat.PDF que convierte los archivos nativos de Excel al formato PDF.

Siga los siguientes pasos para convertir directamente las hojas de cálculo de Excel al formato PDF:

Instancia un objeto de la clase Workbook llamando a su constructor vacío.
Puede abrir/cargar un archivo de plantilla existente o saltarse este paso si está creando el libro de trabajo desde cero.
Realice cualquier tarea (ingresar datos, aplicar formato, configurar fórmulas, insertar imágenes u otros objetos de dibujo, etc.) en la hoja de cálculo usando las APIs de Aspose.Cells for Python via .NET.
Cuando el código de la hoja de cálculo esté completo, llame al método save de la clase Workbook para guardar la hoja de cálculo.

El formato de archivo debe ser PDF, así que seleccione PDF (un valor predefinido) de la enumeración SaveFormat para generar el documento 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

Conversión Avanzada

También puede optar por utilizar la clase PdfSaveOptions para establecer diferentes atributos para la conversión. Configurar diferentes propiedades de la clase PdfSaveOptions le brinda control sobre la impresión, fuente, seguridad y ajustes de compresión para el PDF de salida. La propiedad más importante es PdfSaveOptions.compliance que le permite guardar los archivos de Excel en archivos PDF/A compatibles.

Guardando el Libro de Trabajo en Archivos PDF/A Compilados

El fragmento de código proporcionado a continuación demuestra cómo utilizar la clase PdfSaveOptions para guardar archivos de Excel en formato PDF/A compatible.

	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

Tenga en cuenta que la propiedad PdfSaveOptions.compliance se agregó con el lanzamiento de Aspose.Cells for Python via .NET para .NET 5.3.0.

Establecer la Hora de Creación del PDF

Con la clase PdfSaveOptions, puede obtener o establecer la hora de creación del PDF. El siguiente código demuestra el uso de la propiedad PdfSaveOptions.created_time para establecer la hora de creación del archivo 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

Establecer la opción ContentCopyForAccessibility

Con la clase PdfSaveOptions, puede obtener o establecer la opción PdfSecurityOptions.accessibility_extract_content del PDF para controlar el acceso al contenido en el PDF convertido.

	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

Exportar Propiedades Personalizadas a PDF

Con la clase PdfSaveOptions, puede exportar las propiedades personalizadas en el libro de origen al PDF. Se proporciona el enumerador PdfCustomPropertiesExport para especificar la forma en que se exportan las propiedades. Estas propiedades se pueden observar en Adobe Acrobat Reader haciendo clic en Archivo y luego en la opción Propiedades, como se muestra en la siguiente imagen. El archivo de plantilla “sourceWithCustProps.xlsx” se puede descargar aquí para realizar pruebas y el archivo PDF de salida “outSourceWithCustProps” está disponible aquí para su análisis.

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

Atributos de Conversión

Trabajamos para mejorar las características de conversión con cada nueva versión. La conversión de Excel a PDF de Aspose.Cells todavía tiene un par de limitaciones. MapChart no es compatible al convertir a formato PDF. Además, algunos objetos de dibujo no son bien compatibles.

La tabla que sigue enumera todas las características que están totalmente o parcialmente compatibles al exportar a PDF utilizando Aspose.Cells for Python via .NET. Esta tabla no es definitiva y no cubre todos los atributos de la hoja de cálculo, pero identifica aquellas características que no son compatibles o son parcialmente compatibles con la conversión a PDF.

Elemento del Documento	Atributo	Compatible	Notas
Alineación		Sí
Configuraciones de fondo		Sí
Borde	Color	Sí
Borde	Estilo de línea	Sí
Borde	Ancho de línea	Sí
Datos de celda		Sí
Comentarios		Sí
Formato condicional		Sí
Propiedades del documento		Sí
Objetos de dibujo		Parcialmente	Las sombras y los efectos 3D para los objetos de dibujo no son bien compatibles; WordArt y SmartArt son parcialmente compatibles.
Fuente	Tamaño	Sí
Fuente	Color	Sí
Fuente	Estilo	Sí
Fuente	Subrayado	Sí
Fuente	Efectos	Sí
Imágenes		Sí
Hipervínculo		Sí
Gráficos		Parcialmente	El MapChart no es compatible.
Celdas fusionadas		Sí
Salto de página		Sí
Configuración de página	Encabezado/Pie de página	Sí
Configuración de página	Márgenes	Sí
Configuración de página	Orientación de la página	Sí
Configuración de página	Tamaño de la página	Sí
Configuración de página	Área de impresión	Sí
Configuración de página	Títulos de impresión	Sí
Configuración de página	Escalado	Sí
Altura de fila/Ancho de columna		Sí
Idioma RTL (de derecha a izquierda)		Sí

Si su hoja de cálculo contiene fórmulas, es mejor llamar al método Workbook.calculate_formula justo antes de renderizar la hoja de cálculo al formato PDF. De esta forma se asegurará de que los valores dependientes de las fórmulas se recalculen y se rendericen los valores correctos en el PDF.

Temas avanzados

Convertir Excel a CSV, TSV y Txt Convertir revisión de XLSB a XLSM