Ajouter une image à l’en-tête du PDF dans le SDK Python
API pour travailler avec l’image dans l’en-tête des documents PDF en utilisant Cloud Python SDK.
Get StartedComment ajouter une image dans l'en-tête du PDF via Cloud Python SDK
Pour ajouter une image dans l’en-tête du PDF, nous utiliserons Aspose.PDF Cloud Python SDK. Ce SDK Cloud aide les programmeurs Python à développer des applications de création, d’annotation, d’édition et de conversion de PDF basées sur le cloud en utilisant le langage de programmation Python via Aspose.PDF REST API. Créez simplement un compte sur Aspose for Cloud et obtenez les informations de votre application. Une fois que vous avez l’App SID & key, vous êtes prêt à utiliser le Aspose.PDF Cloud Python SDK. Si le package python est hébergé sur Github, vous pouvez l’installer directement depuis Github :
Installation depuis Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Commande de la console du gestionnaire de packages
pip install asposepdfcloud
Étapes pour ajouter une image dans l'en-tête via Python
Les développeurs Aspose.PDF Cloud peuvent facilement charger et ajouter une image dans l’en-tête du PDF en quelques lignes de code.
- Installez Python SDK
- Téléchargez un document PDF sur le serveur Aspose Cloud
- Téléchargez le document PDF traité depuis le serveur Aspose Cloud
- Ajoutez un nouvel en-tête d’image à la page sur le document PDF
Ajouter une image dans l'en-tête du PDF en utilisant 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()
Travailler avec les en-têtes via Python SDK
Ajouter une image dans l’en-tête d’un PDF améliore le branding, la sécurité, l’esthétique et la fonctionnalité du document. C’est particulièrement précieux pour les documents d’entreprise, les rapports, les documents juridiques et les supports marketing, assurant une présentation professionnelle et bien structurée. Ajoutez l’en-tête dans les documents PDF avec Aspose.PDF Cloud Python SDK.
Avec notre SDK Python, vous pouvez
- Ajouter l’en-tête et le pied de page d’un document PDF au format texte ou image.
- Ajouter des tableaux et des tampons de texte ou d’image aux documents PDF.
- Joindre plusieurs documents PDF à un fichier existant.
- Travailler avec les pièces jointes PDF, les annotations et les champs de formulaire.
- Appliquer le chiffrement ou le déchiffrement aux documents PDF et définir un mot de passe.
- Supprimer tous les tampons et tableaux d’une page ou d’un document PDF entier.
- Supprimer un tampon ou un tableau spécifique du document PDF par son ID.
- Remplacer des occurrences simples ou multiples de texte sur une page PDF ou dans l’ensemble du document.
- Support étendu pour la conversion de documents PDF en divers autres formats de fichiers.
- Extraire divers éléments des fichiers PDF et optimiser les documents PDF.
- Vous pouvez essayer notre application gratuite pour tester la fonctionnalité.
- Ressources d'apprentissage
- Documentation
- Code Source
- Références API
- Support Produit
- Support Gratuit
- Support Payant
- Blog
- Pourquoi Aspose.PDF Cloud pour Python ?
- Liste des Clients
- Sécurité