Agregar Imagen al Encabezado del PDF en Python SDK
API para trabajar con Imagen en el Encabezado de documentos PDF usando Cloud Python SDK.
Get StartedCómo agregar Imagen en el Encabezado del PDF a través de Cloud Python SDK
Para agregar Imagen en el Encabezado del PDF, usaremos Aspose.PDF Cloud Python SDK. Este Cloud SDK ayuda a los programadores de Python a desarrollar aplicaciones de creador, anotador, editor y convertidor de PDF basadas en la nube utilizando el lenguaje de programación Python a través de Aspose.PDF REST API. Simplemente cree una cuenta en Aspose for Cloud y obtenga la información de su aplicación. Una vez que tenga el App SID y la clave, está listo para usar el Aspose.PDF Cloud Python SDK. Si el paquete de Python está alojado en Github, puede instalarlo directamente desde Github:
Instalación desde Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Comando de la Consola del Administrador de Paquetes
pip install asposepdfcloud
Pasos para agregar Imagen en el Encabezado a través de Python
Los desarrolladores de Aspose.PDF Cloud pueden cargar y agregar fácilmente Imagen en el Encabezado del PDF en solo unas pocas líneas de código.
- Instalar Python SDK
- Subir un documento PDF al servidor de Aspose Cloud
- Descargar el documento PDF procesado del servidor de Aspose Cloud
- Adjuntar un nuevo encabezado de imagen a la página en el documento PDF
Agregar Imagen en el Encabezado del PDF usando Python
import shutil
import json
import logging
from pathlib import Path
from asposepdfcloud import ApiClient, PdfApi, ImageHeader, HorizontalAlignment, TextHorizontalAlignment
# Configure logging
logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
class Config:
"""Configuration parameters."""
CREDENTIALS_FILE = Path(r"..\\credentials.json")
LOCAL_FOLDER = Path(r"C:\Samples")
PDF_DOCUMENT_NAME = "sample.pdf"
LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
IMAGE_HEADER_FILE = "sample.png"
PAGE_NUMBER = 2 # Your document page number...
class pdfHederFooter:
"""Class for managing PDF headers and footers using Aspose PDF Cloud API."""
def __init__(self, credentials_file: Path = Config.CREDENTIALS_FILE):
self.pdf_api = None
self._init_api(credentials_file)
def _init_api(self, credentials_file: Path):
"""Initialize the API client."""
try:
with credentials_file.open("r", encoding="utf-8") as file:
credentials = json.load(file)
api_key, app_id = credentials.get("key"), credentials.get("id")
if not api_key or not app_id:
raise ValueError("init_api(): Error: Missing API keys in the credentials file.")
self.pdf_api = PdfApi(ApiClient(api_key, app_id))
except (FileNotFoundError, json.JSONDecodeError, ValueError) as e:
logging.error(f"init_api(): Failed to load credentials: {e}")
def upload_file(self, fileName: str):
""" Upload a local fileName to the Aspose Cloud server. """
if self.pdf_api:
file_path = Config.LOCAL_FOLDER / fileName
try:
self.pdf_api.upload_file(fileName, str(file_path))
logging.info(f"upload_file(): File '{fileName}' uploaded successfully.")
except Exception as e:
logging.error(f"upload_document(): Failed to upload file: {e}")
def upload_document(self):
""" Upload a PDF document to the Aspose Cloud server. """
self.upload_file(Config.PDF_DOCUMENT_NAME)
def download_result(self):
""" Download the processed PDF document from the Aspose Cloud server. """
if self.pdf_api:
try:
temp_file = self.pdf_api.download_file(Config.PDF_DOCUMENT_NAME)
local_path = Config.LOCAL_FOLDER / Config.LOCAL_RESULT_DOCUMENT_NAME
shutil.move(temp_file, str(local_path))
logging.info(f"download_result(): File successfully downloaded: {local_path}")
except Exception as e:
logging.error(f"download_result(): Failed to download file: {e}")
def append_image_header(self):
"""Append a new image header to the PDF document."""
if self.pdf_api:
new_header = ImageHeader(
background = True,
horizontal_alignment = HorizontalAlignment.CENTER,
file_name = Config.IMAGE_HEADER_FILE,
width = 24,
height = 24
)
try:
response = self.pdf_api.post_document_image_header(
Config.PDF_DOCUMENT_NAME, new_header
)
if response.code == 200:
logging.info(f"append_image_header(): Header '{new_header.file_name}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
else:
logging.error(f"append_image_header(): Failed to add header '{new_header.file_name}' to the document '{Config.PDF_DOCUMENT_NAME}'. Response code: {response.code}")
except Exception as e:
logging.error(f"append_image_header(): Error while adding header: {e}")
def append_image_heade_page(self):
"""Append a new image header to the page on PDF document."""
if self.pdf_api:
new_header = ImageHeader(
background = True,
horizontal_alignment = HorizontalAlignment.LEFT,
file_name = Config.IMAGE_HEADER_FILE,
width = 24,
height = 24
)
try:
response = self.pdf_api.post_document_image_header(
Config.PDF_DOCUMENT_NAME, new_header, start_page_number=Config.PAGE_NUMBER, end_page_number=Config.PAGE_NUMBER
)
if response.code == 200:
logging.info(f"append_image_heade_page(): Header '{new_header.file_name}' added to the page #{Config.PAGE_NUMBER}.")
else:
logging.error(f"append_image_heade_page(): Failed to add header '{new_header.file_name}' to the page #{Config.PAGE_NUMBER}. Response code: {response.code}")
except Exception as e:
logging.error(f"append_image_heade_page(): Error while adding header: {e}")
if __name__ == "__main__":
pdf_header_footer = pdfHederFooter()
pdf_header_footer.upload_document()
pdf_header_footer.upload_file(Config.IMAGE_HEADER_FILE)
pdf_header_footer.append_image_header()
pdf_header_footer.append_image_heade_page()
pdf_header_footer.download_result()
Trabajar con los Encabezados a través de Python SDK
Agregar una imagen al encabezado de un PDF mejora el branding, la seguridad, la estética y la funcionalidad del documento. Es especialmente valioso para documentos empresariales, informes, documentos legales y materiales de marketing, asegurando una presentación profesional y bien estructurada. Agregue el Encabezado en documentos PDF con Aspose.PDF Cloud Python SDK.
Con nuestro Python SDK puedes
- Agregar encabezado y pie de página del documento PDF en formato de texto o imagen.
- Agregar tablas y sellos de texto o imagen a documentos PDF.
- Adjuntar múltiples documentos PDF a un archivo existente.
- Trabajar con archivos adjuntos de PDF, anotaciones y campos de formulario.
- Aplicar cifrado o descifrado a documentos PDF y establecer una contraseña.
- Eliminar todos los sellos y tablas de una página o de todo el documento PDF.
- Eliminar un sello o tabla específico del documento PDF por su ID.
- Reemplazar una o varias instancias de texto en una página PDF o de todo el documento.
- Soporte extenso para convertir documentos PDF a varios otros formatos de archivo.
- Extraer varios elementos de archivos PDF y optimizar documentos PDF.
- Puedes probar nuestra aplicación gratuita para probar la funcionalidad.
- Recursos de Aprendizaje
- Documentación
- Código Fuente
- Referencias de API
- Soporte del Producto
- Soporte Gratis
- Soporte Pagado
- Blog
- ¿Por qué Aspose.PDF Cloud para Python?
- Lista de Clientes
- Seguridad