HTML JPG PDF XML DOCX
  Product Family
PDF

Adicionar Anexos ao PDF no Python SDK

API para adicionar anexos em documentos PDF com Aspose.PDF Cloud Python SDK

Get Started

Como anexar anexos em documentos PDF usando Cloud Python SDK

Para trabalhar com anexos em documentos PDF, usaremos Aspose.PDF Cloud Python SDK Este Cloud SDK 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 no Aspose for Cloud e obtenha suas informações de aplicação. Uma vez que você tenha o App SID e a chave, 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 anexos via Python SDK

Os desenvolvedores do Aspose.PDF Cloud Python podem facilmente anexar anexos em documentos PDF. Os desenvolvedores precisam de apenas algumas linhas de código.

  1. Carregue seu Segredo de Aplicação e Chave do arquivo JSON ou defina as credenciais de outra forma
  2. Crie um objeto para conectar à API em nuvem
  3. Defina o nome com o caminho do arquivo do seu documento
  4. Realize as ações de anexar anexo
  5. Se for bem-sucedido, o PDF modificado é baixado e salvo em um arquivo especificado
  6. Se ocorrerem erros durante o processo, eles são capturados e impressos
 

Este código de exemplo mostra como anexar arquivo ao documento PDF usando 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()