تنزيل المرفق من ملف PDF باستخدام Python

يتألف ملف PDF من نصوص ورسومات وقد يحتوي على ملفات كاملة بداخله كمرفقات. وهذا يجعل تبادل مجموعات المستندات أسهل وأكثر موثوقية. توفر لك لوحة المرفقات مكانًا مركزيًا لعرض المرفقات وإدراجها وحذفها وتصديرها. يرجى أيضًا ملاحظة أنه إذا نقلت ملف PDF إلى موقع جديد، فإن المرفقات الموجودة بداخله تنتقل معه أيضًا. قد تتضمن المرفقات روابط إلى أو من المستند الأصلي أو إلى مرفقات أخرى. يرجى عدم الخلط بين التعليقات المرفقة ومرفقات الملفات.

في هذه المقالة، سنناقش التفاصيل حول كيفية قراءة المعلومات المتعلقة بالمرفقات في مستندات PDF، بالإضافة إلى كيفية تنزيل المرفقات من PDF باستخدام Python. لا يلزم تنزيل وتثبيت أي برنامج معين، كما يتم تنفيذ جميع العمليات المطلوبة في السحابة.

واجهة برمجة تطبيقات معالجة ملفات PDF
مجموعة أدوات تطوير البرامج الخاصة بلغة Python لمعالجة ملفات PDF
قراءة معلومات المرفق باستخدام الأمر cURL
تنزيل المرفق المحدد باستخدام الأمر cURL

واجهة برمجة تطبيقات معالجة ملفات PDF

Aspose.PDF Cloud هي واجهة برمجة التطبيقات المستندة إلى REST والتي توفر الإمكانيات لإنشاء وتحرير وتحويل تنسيقات مختلفة إلى PDF بالإضافة إلى عرض ملفات PDF بتنسيقات بما في ذلك XLSX وPPTX وDOCX وEPUB وHTML وJPEG، وغير ذلك الكثير. وبفضل بنية REST، يمكن الوصول إلى واجهة برمجة التطبيقات على أي منصة. وبالتالي، يمكنك تنفيذ إمكانيات معالجة PDF في تطبيقات سطح المكتب والويب والجوال والسحابة والتطبيقات الهجينة.

مجموعة أدوات تطوير البرامج الخاصة بلغة Python لمعالجة ملفات PDF

من أجل تسهيل الأمر على عملائنا بشكل أكبر، قمنا بإنشاء حزم SDK برمجة محددة حتى تحصل على جميع إمكانيات معالجة PDF باللغة التي تختارها. وبالمثل، لتسهيل الأمر على مطوري Python، قمنا بإنشاء حزمة SDK برمجة Python باسم Aspose.PDF Cloud SDK for Python وهي عبارة عن غلاف حول واجهة برمجة تطبيقات Aspose.PDF Cloud. الآن للبدء، فإن الخطوة الأولى هي التثبيت. حزمة SDK متاحة للتنزيل مجانًا عبر مستودع PIP وGitHub. الآن قم بتنفيذ الأمر التالي على المحطة الطرفية/موجه الأوامر لتثبيت أحدث إصدار من حزمة SDK على النظام.

pip install asposepdfcloud

بيئة تطوير متكاملة لـ PyCharm

إذا كنت تستخدم PyCharm IDE، فيمكنك إضافة SDK مباشرة كاعتمادية في مشروعك.

ملف ->الإعدادات ->المشروع ->مُفسِّر بايثون ->asposepdfcloud

التسمية التوضيحية — Image 1:- PyCharm settings option.

حزمة Aspose.PDF Python — الصورة 2:- حزمة Aspose.Pdf Cloud Python.

حساب لوحة معلومات السحابة المجاني

بعد التثبيت، فإن الخطوة الرئيسية التالية هي الاشتراك المجاني في خدماتنا السحابية عبر لوحة تحكم Aspose.Cloud. الغرض من هذا الاشتراك هو السماح فقط للأشخاص المصرح لهم بالوصول إلى خدمات معالجة الملفات الخاصة بنا. إذا كان لديك حساب GitHub أو Google، فما عليك سوى التسجيل أو النقر فوق الزر إنشاء حساب جديد وتقديم المعلومات المطلوبة. الآن قم بتسجيل الدخول إلى لوحة التحكم باستخدام بيانات الاعتماد وقم بتوسيع قسم التطبيقات من لوحة التحكم وانتقل لأسفل نحو قسم بيانات اعتماد العميل لرؤية تفاصيل معرف العميل والسر الخاص بالعميل.

الصورة 3:- بيانات اعتماد العميل على لوحة معلومات Aspose.Cloud.

قراءة معلومات المرفقات من ملف PDF

يرجى اتباع التعليمات أدناه لقراءة معلومات المرفقات داخل مستند PDF.

أولاً، نحتاج إلى إنشاء مثيل لفئة ApiClient مع توفير معرف العميل وسر العميل كوسائط.
ثانيًا، قم بإنشاء مثيل لفئة PdfApi والتي تأخذ كائن ApiClient كحجة إدخال.
الآن قم باستدعاء طريقة getdocumentattachments(…) من PdfApi لجلب تفاصيل مرفق PDF.

def readAttachmentDetails():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # إنشاء مثيل PdfApi أثناء تمرير PdfApiClient كحجة
        pdf_api = PdfApi(pdf_api_client)

        #source image file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # اتصل بواجهة برمجة التطبيقات لاستخراج تفاصيل المرفق
        response = pdf_api.get_document_attachments(name = input_file)
        print(response)
        # طباعة الرسالة في وحدة التحكم (اختياري)
        print('PDF Attachment details successfully retrieved !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

لمزيد من المعلومات، يمكن تنزيل مستند PDF النموذجي المستخدم في المثال أعلاه من PdfWithEmbeddedFiles.pdf.

اقرأ معلومات المرفقات المحددة

كما تسهل واجهة برمجة التطبيقات علينا قراءة معلومات المرفقات المحددة في مستند PDF. لهذا الغرض، يرجى محاولة استخدام طريقة GetDocumentAttachmentByIndex. يرجى الاطلاع أدناه على تفاصيل المرفق الأول المسترد.

{'attachment': {'check_sum': '33DCE2EE8BD095A3C4E2A67058104D35',
                'creation_date': '11/24/2008 02:02:36.000 PM',
                'description': None,
                'links': [{'href': '/PdfWithEmbeddedFiles.pdf/attachments/1',
                           'rel': 'self',
                           'title': None,
                           'type': None}],
                'mime_type': 'application/pdf',
                'modification_date': '05/03/2007 10:37:41.000 AM',
                'name': 'example1.pdf',
                'size': 10984},
 'code': 200,
 'status': 'OK'}

تنزيل المرفق المحدد من ملف PDF

يرجى اتباع التعليمات الموضحة أدناه لتنزيل المرفقات المحددة من مستند PDF.

أولاً، نحتاج إلى إنشاء مثيل لفئة ApiClient مع توفير معرف العميل وسر العميل كوسائط.
ثانيًا، قم بإنشاء مثيل لفئة PdfApi والتي تأخذ كائن ApiClient كحجة إدخال.
الآن قم باستدعاء طريقة GetDownloadDocumentAttachmentByIndex(…) لتنزيل المرفق من ملف PDF.

def downloadAttachment():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # إنشاء مثيل PdfApi أثناء تمرير PdfApiClient كحجة
        pdf_api = PdfApi(pdf_api_client)

        #source image file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # اتصل بـ API لتنزيل المرفق الأول من ملف PDF
        response = pdf_api.get_download_document_attachment_by_index(name = input_file, attachment_index=1)
        print(response)
        # طباعة الرسالة في وحدة التحكم (اختياري)
        print('PDF Attachment successfully downloaded !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

قراءة معلومات المرفق باستخدام الأمر cURL

يمكن الوصول بسهولة إلى واجهات برمجة التطبيقات REST عبر أوامر cURL ويمكننا استخدام تطبيق طرفي بسيط لتنفيذها. نظرًا لأن Aspose.PDF Cloud تم تطويره وفقًا لهندسة REST، فيمكننا أيضًا الوصول إليه عبر أوامر cURL. ومع ذلك، كشرط أساسي، نحتاج إلى إنشاء رمز ويب JSON (JWT) استنادًا إلى بيانات اعتماد العميل الفردية المحددة عبر لوحة معلومات Aspose.Cloud. هذا أمر إلزامي لأن واجهات برمجة التطبيقات الخاصة بنا لا يمكن الوصول إليها إلا من قبل المستخدمين المسجلين. يرجى تنفيذ الأمر التالي لإنشاء رمز JWT.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

الآن بعد أن أصبح لدينا رمز JWT، يمكننا تنفيذ الأمر التالي لجلب 7 معلومات حول مرفقات محددة من مستندات PDF.

curl -v -X GET "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/attachments/1" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

تنزيل المرفق المحدد باستخدام الأمر cURL

يرجى تنفيذ الأمر التالي لتنزيل المرفق الثاني لملف PDF وحفظه على محرك الأقراص المحلي.

curl -v -X GET "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/attachments/2/download" \
-H  "accept: multipart/form-data" \
-H  "authorization: Bearer <JWT Token>" \
-o Attachment.txt

خاتمة

لقد أوضحت هذه المقالة التفاصيل والخطوات حول كيفية قراءة وتنزيل المرفقات من مستندات PDF. لقد استكشفنا الخطوات باستخدام مقتطفات التعليمات البرمجية لـ Python بالإضافة إلى استخدام أوامر cURL. بصرف النظر عن معالجة المرفقات، توفر واجهة برمجة التطبيقات أيضًا مجموعة كبيرة من الميزات المتعلقة بعناصر أخرى من ملفات PDF ويمكن العثور على تفاصيلها في دليل المطور. علاوة على ذلك، تم توفير الكود المصدر الكامل لـ Aspose.PDF Cloud SDK for Python للتنزيل عبر GitHub. في حالة مواجهة أي مشكلات أثناء استخدام واجهة برمجة التطبيقات أو إذا كان لديك أي استفسارات أخرى، فلا تتردد في الاتصال بنا عبر منتدى دعم المنتج المجاني.

واجهة برمجة تطبيقات معالجة ملفات PDF#

مجموعة أدوات تطوير البرامج الخاصة بلغة Python لمعالجة ملفات PDF#

بيئة تطوير متكاملة لـ PyCharm#

حساب لوحة معلومات السحابة المجاني#

قراءة معلومات المرفقات من ملف PDF#

اقرأ معلومات المرفقات المحددة#

تنزيل المرفق المحدد من ملف PDF#

قراءة معلومات المرفق باستخدام الأمر cURL#

تنزيل المرفق المحدد باستخدام الأمر cURL#

خاتمة#

مقالات ذات صلة#