PNG JPG BMP TIFF PDF
Aspose.PDF  pour Python

Remplacer les signets dans PDF dans Python SDK

Remplacer les signets d’un document PDF en utilisant Cloud Python SDK.

Get Started

Comment remplacer les signets dans PDF via Cloud Python SDK

Pour remplacer les signets d’un PDF, nous utiliserons Aspose.PDF Cloud Python SDK. Ce SDK Cloud aide les programmeurs Python à développer des applications créatrices, annotatrices, éditrices et convertisseuses 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 à essayer 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 remplacer les signets dans PDF via Python

Les développeurs Aspose.PDF Cloud peuvent facilement charger et remplacer les signets d’un PDF en quelques lignes de code.

  1. Installer Python SDK
  2. Télécharger un document PDF sur le serveur Aspose Cloud
  3. Télécharger le document PDF traité depuis le serveur Aspose Cloud
  4. Remplacer le signet dans le document PDF
 

Remplacer les signets d'un PDF en utilisant Python


    import shutil
    import json
    import logging
    from pathlib import Path
    from asposepdfcloud import ApiClient, PdfApi, Bookmark, BookmarksResponse, BookmarkResponse

    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_BOOKMARK_TITLE = "• Increased performance." #"• Productivity improvement"
        BOOKMARK_PATH = "/5"
        NEW_BOOKMARK_PAGE_NUMBER = 3

    # Configure logging
    logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")

    class PdfBookmarks:
        """Class for managing PDF bookmarkss 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("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"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"File {Config.PDF_DOCUMENT_NAME} uploaded successfully.")
                except Exception as e:
                    logging.error(f"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 show_bookmarks_array(self, bookmarks, prefix):
            for item in bookmarks.list:
                logging.info(f"{prefix} => level: '{item.level}' - action: '{item.action}' - title: '{item.title}'")
                if item.bookmarks and item.bookmarks.list and item.bookmarks.list.length > 0:
                    self.show_bookmarks_array(bookmarks=item.bookmarks, prefix=prefix)

        def get_all_bookmarks(self):
            """Get all bookmarks for a specific PDF document."""    
            if self.pdf_api:
                try:
                    response : BookmarksResponse = self.pdf_api.get_document_bookmarks( Config.PDF_DOCUMENT_NAME)
                    if response.code == 200:
                        self.show_bookmarks_array(response.bookmarks, "All")
                    else:
                        logging.error(f"Failed to get bookmarks for the document. Response code: {response.code}")
                except Exception as e:
                    logging.error(f"Error while retrieving bookmarks array: {e}")

        def get_bookmark(self):
            """Get bookmark for a specific PDF document using bookmark path."""    
            if self.pdf_api:
                try:
                    response : BookmarkResponse = self.pdf_api.get_bookmark( Config.PDF_DOCUMENT_NAME, Config.BOOKMARK_PATH)
                    if response.code == 200:
                        logging.info(f"Found bookmark => level: '{response.bookmark.level}' - action: '{response.bookmark.action}' - title: '{response.bookmark.title}'")
                        return response.bookmark
                    else:
                        logging.error(f"Failed to find bookmark for the document. Response code: {response.code}")
                        return None
                except Exception as e:
                    logging.error(f"Error while find bookmark: {e}")

        def replace_bookmark(self):
            if self.pdf_api:
                _bookmark: BookmarkResponse = self.get_bookmark()

                if not _bookmark:
                    return

                _bookmark.title = Config.NEW_BOOKMARK_TITLE

                response: BookmarkResponse = self.pdf_api.put_bookmark(
                    Config.PDF_DOCUMENT_NAME,
                    Config.BOOKMARK_PATH,
                    bookmark=_bookmark,
                )

                if response.code == 200:
                    print("Bookmark replaced successfully.")
                else:
                    print("Failed to replace Bookmark.")


    if __name__ == "__main__":
        pdf_bookmarks = PdfBookmarks()
        pdf_bookmarks.upload_document()
        pdf_bookmarks.get_all_bookmarks()
        pdf_bookmarks.replace_bookmark()
        pdf_bookmarks.download_result()
 

Avec notre bibliothèque Python, vous pouvez :

Remplacer les signets des documents PDF avec Aspose.PDF Cloud Python SDK.

  • Combiner des documents PDF.
  • Diviser des fichiers PDF.
  • Convertir PDF en d’autres formats, et vice versa.
  • Manipuler les annotations.
  • Travailler avec des images dans PDF, etc.
  • Vous pouvez essayer nos applications gratuites pour tester la fonctionnalité en ligne.