Adicionar Texto ao Cabeçalho do PDF no Python SDK
API para trabalhar com Texto no Cabeçalho de documentos PDF usando Cloud Python SDK.
Get StartedComo adicionar Texto no Cabeçalho de PDF via Cloud Python SDK
Para adicionar Texto no Cabeçalho do PDF, usaremos Aspose.PDF Cloud Python SDK. Este SDK Cloud auxilia programadores Python no desenvolvimento de aplicativos criadores, anotadores, editores e conversores de PDF baseados em nuvem usando a linguagem de programação Python via Aspose.PDF REST API. Simplesmente crie uma conta em Aspose for Cloud e obtenha suas informações de aplicativo. Uma vez que você tenha o App SID & key, você está pronto para usar o Aspose.PDF Cloud Python SDK. Se o pacote python estiver hospedado no Github, você pode instalar diretamente do Github:
Instalação do Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Comando do Console do Gerenciador de Pacotes
pip install asposepdfcloud
Passos para adicionar Texto no Cabeçalho via Python
Os desenvolvedores do Aspose.PDF Cloud podem facilmente carregar e adicionar Texto no Cabeçalho de PDF em apenas algumas linhas de código.
- Instale Python SDK
- Carregue um documento PDF no servidor da Aspose Cloud
- Baixe o documento PDF processado do servidor da Aspose Cloud
- Anexe um novo cabeçalho de texto à página no documento PDF
Adicionar Texto no Cabeçalho de PDF usando Python
import shutil
import json
import logging
from pathlib import Path
from asposepdfcloud import ApiClient, PdfApi, TextHeader, HorizontalAlignment, TextHorizontalAlignment
# Configure logging
logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
class Config:
"""Configuration parameters."""
CREDENTIALS_FILE = Path(r"C:\\Projects\\ASPOSE\\Pdf.Cloud\\Credentials\\credentials.json")
LOCAL_FOLDER = Path(r"C:\Samples")
PDF_DOCUMENT_NAME = "sample.pdf"
LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
HEADER_VALUE = "New header Value"
PAGE_NUMBER = 2
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_document(self):
""" Upload a PDF document to the Aspose Cloud server. """
if self.pdf_api:
file_path = Config.LOCAL_FOLDER / Config.PDF_DOCUMENT_NAME
try:
self.pdf_api.upload_file(Config.PDF_DOCUMENT_NAME, str(file_path))
logging.info(f"upload_document(): File {Config.PDF_DOCUMENT_NAME} uploaded successfully.")
except Exception as e:
logging.error(f"upload_document(): Failed to upload file: {e}")
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_text_header(self):
"""Append a new text header to the PDF document."""
if self.pdf_api:
new_header = TextHeader(
background = True,
horizontal_alignment = HorizontalAlignment.CENTER,
text_alignment = TextHorizontalAlignment.CENTER,
value = Config.HEADER_VALUE
)
try:
response = self.pdf_api.post_document_text_header(
Config.PDF_DOCUMENT_NAME, new_header
)
if response.code == 200:
logging.info(f"append_text_header(): Header '{new_header.value}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
else:
logging.error(f"append_text_header(): Failed to add header '{new_header.value}' to the document '{Config.PDF_DOCUMENT_NAME}'. Response code: {response.code}")
except Exception as e:
logging.error(f"append_text_header(): Error while adding header: {e}")
def append_text_header_page(self):
"""Append a new text header to the page on PDF document."""
if self.pdf_api:
new_header = TextHeader(
background = True,
horizontal_alignment = HorizontalAlignment.LEFT,
text_alignment = TextHorizontalAlignment.CENTER,
value = Config.HEADER_VALUE
)
try:
response = self.pdf_api.post_document_text_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_text_header_page(): Header '{new_header.value}' added to the page #{Config.PAGE_NUMBER}.")
else:
logging.error(f"append_text_header_page(): Failed to add header '{new_header.value}' to the document #{Config.PAGE_NUMBER}. Response code: {response.code}")
except Exception as e:
logging.error(f"append_text_header_page(): Error while adding header: {e}")
if __name__ == "__main__":
pdf_header_footer = pdfHederFooter()
pdf_header_footer.upload_document()
pdf_header_footer.append_text_header()
pdf_header_footer.append_text_header_page()
pdf_header_footer.download_result()
Trabalhar com Cabeçalho em PDF
Adicionar texto ao cabeçalho de um PDF melhora a marca, navegação, segurança e profissionalismo. Ajuda na organização de documentos, manutenção da conformidade e garantia de consistência, tornando-se um recurso valioso para documentos empresariais, jurídicos, acadêmicos e técnicos. Adicione o Cabeçalho em documentos PDF com Aspose.PDF Cloud Python SDK.
Com nossa biblioteca Python você pode:
- Combinar documentos PDF.
- Dividir arquivos PDF.
- Converter PDF para outros formatos, e vice-versa.
- Manipular Anotações.
- Trabalhar com Imagens em PDF, etc.
- Você pode experimentar nossos aplicativos gratuitos para testar a funcionalidade online.