HTML
JPG
PDF
XML
DOCX
PDF
Thêm tệp đính kèm vào PDF trong Python SDK
API để thêm tệp đính kèm trong tài liệu PDF với Aspose.PDF Cloud Python SDK
Get StartedCách thêm tệp đính kèm trong tài liệu PDF bằng Cloud Python SDK
Để làm việc với tệp đính kèm trong tài liệu PDF, chúng ta sẽ sử dụng Aspose.PDF Cloud Python SDK SDK Đám mây này hỗ trợ các lập trình viên Python phát triển ứng dụng tạo, chú thích, chỉnh sửa và chuyển đổi PDF dựa trên đám mây sử dụng ngôn ngữ lập trình Python qua Aspose.PDF REST API. Chỉ cần tạo một tài khoản tại Aspose for Cloud và nhận thông tin ứng dụng của bạn. Khi bạn có App SID & key, bạn đã sẵn sàng sử dụng Aspose.PDF Cloud Python SDK. Nếu gói python được lưu trữ trên Github, bạn có thể cài đặt trực tiếp từ Github:
Cài đặt từ Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Lệnh trên Bảng điều khiển Trình quản lý Gói
pip install asposepdfcloud
Các bước thêm tệp đính kèm qua Python SDK
Các nhà phát triển Aspose.PDF Cloud Python có thể dễ dàng thêm tệp đính kèm trong tài liệu PDF. Các nhà phát triển chỉ cần một vài dòng mã.
- Tải khóa bí mật và khóa ứng dụng của bạn từ tệp JSON hoặc đặt thông tin xác thực theo cách khác
- Tạo một đối tượng để kết nối với API Đám mây
- Đặt tên với đường dẫn của tệp tài liệu của bạn
- Thực hiện các hành động thêm tệp đính kèm
- Nếu thành công, tệp PDF đã được chỉnh sửa sẽ được tải xuống và lưu vào tệp chỉ định
- Nếu có bất kỳ lỗi nào xảy ra trong quá trình, chúng sẽ được bắt và in ra
Mã mẫu này cho thấy cách thêm tệp đính kèm vào tài liệu PDF sử dụng PDF Cloud Python SDK
import shutil
import json
import logging
from pathlib import Path
from asposepdfcloud import ApiClient, PdfApi, AttachmentInfo
# 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"
NEW_ATTACHMENT_FILE = "sample_video.mp4"
NEW_ATTACHMENT_MIME = "video/mp4"
PAGE_NUMBER = 2
class PdfAttachments:
"""Class for managing PDF attachments 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_attachmnet(self):
"""Append a new attachment to the PDF document."""
if self.pdf_api:
new_attachment = AttachmentInfo(
path = Config.NEW_ATTACHMENT_FILE,
description = 'This is a sample attachment',
mime_type = Config.NEW_ATTACHMENT_MIME,
name = Config.NEW_ATTACHMENT_FILE
)
try:
response = self.pdf_api.post_add_document_attachment(Config.PDF_DOCUMENT_NAME, new_attachment)
if response.code == 200:
logging.info(f"append_attachment(): attachment '{Config.NEW_ATTACHMENT_FILE}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
else:
logging.error(f"append_attachment(): Failed to add attachment to the document. Response code: {response.code}")
except Exception as e:
logging.error(f"append_attachment(): Error while adding attachment: {e}")
if __name__ == "__main__":
pdf_attachments = PdfAttachments()
pdf_attachments.upload_document()
pdf_attachments.upload_file(Config.NEW_ATTACHMENT_FILE)
pdf_attachments.append_attachmnet()
pdf_attachments.download_result()