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

سيتم تناول الموضوعات التالية في هذه المقالة:

وثيقة التوقيع REST API و Python SDK

groupdocssignature-for-cloud

لتحرير التوقيعات الإلكترونية في مستند PDF ، سأستخدم Python SDK من GroupDocs.Signature Cloud API. يمكّنك من تأمين المستندات والصور إلكترونيًا لتنسيقات الملفات المدعومة من خلال تطبيق نص وختم ورمز QR والباركود والصورة والتوقيعات الرقمية. يمكنك أيضًا إنشاء أنواع مختلفة من التوقيعات والتحقق منها وحذفها والبحث فيها بسهولة. كما أنها توفر حزم SDK لـ NET و Java و PHP و Android و Ruby و Node.js باعتبارها أعضاء عائلة توقيع المستندات لواجهة برمجة التطبيقات السحابية.

يمكنك تثبيت GroupDocs.Signature Cloud على مشروع Python الخاص بك باستخدام pip (package installer for python) باستخدام الأمر التالي في وحدة التحكم:

pip install groupdocs_signature_cloud

يرجى الحصول على معرّف العميل وسر العميل من لوحة القيادة قبل البدء في اتباع الخطوات وأمثلة الكود المتاحة. أضف المعرف الخاص بك والسر في الكود كما هو موضح أدناه:

client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"

configuration = groupdocs_signature_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

قم بتحرير التواقيع في مستندات PDF الموقعة باستخدام واجهة برمجة تطبيقات REST في Python

يمكنك تحرير التوقيعات في مستندات PDF الموقعة باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل المستند

بادئ ذي بدء ، قم بتحميل مستند PDF الموقع إلى السحابة باستخدام مثال الرمز الموضح أدناه:

# تهيئة API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)

# تحميل ملفات عينة
request = groupdocs_signature_cloud.UploadFileRequest("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)

نتيجة لذلك ، فإن ملف PDF الذي تم تحميله (موقع. pdf) سيكون متاحًا في قسم الملفات من لوحة المعلومات الخاصة بك على السحابة.

قم بتحديث التواقيع في مستندات PDF الموقعة باستخدام Python

يمكنك تحديث التواقيع في ملف PDF موقع برمجيًا باتباع الخطوات المذكورة أدناه.

  • قم بإنشاء مثيل SignApi
  • قم بتعيين المسار إلى ملف PDF الموقع
  • ابحث في رمز الاستجابة السريعة عن طريق توفير خيارات SearchQRCode و SearchSettings
  • إنشاء SearchSignatureRequest
  • احصل على النتائج عن طريق استدعاء طريقة SignApi.search \ Signatures()
  • حدد UpdateOptions
  • اضبط إعدادات التحديث
  • قم بتعيين UpdateOptions إلى UpdateSettings
  • قم بإنشاء UpdateSignaturesRequest
  • احصل على النتائج عن طريق استدعاء طريقة SignApi.update \ Signatures()

يوضح مقتطف الكود التالي كيفية تحديث تواقيع QR Code في مستند PDF موقع باستخدام REST API.

# تهيئة API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

# مسار المستند الموقع
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"

# البحث عن كود qr
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'

settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo

request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)

# تحديث كود qr
opts = groupdocs_signature_cloud.UpdateOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
opts.left = 450
opts.top = 600
opts.width = 90
opts.height = 90
opts.is_signature = True

settings = groupdocs_signature_cloud.UpdateSettings()
settings.options = [opts]
settings.file_info = fileInfo

request = groupdocs_signature_cloud.UpdateSignaturesRequest(settings)
response = api.update_signatures(request)
قم بتحديث التواقيع في مستند PDF الموقع باستخدام Python

قم بتحديث التواقيع في مستند PDF الموقع باستخدام Python

قم بتنزيل الملف الموقّع

سيحفظ نموذج الكود أعلاه ملف PDF المحدث على السحابة والذي يمكن تنزيله باستخدام نموذج الكود التالي:

# تهيئة API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)

request = groupdocs_signature_cloud.DownloadFileRequest("signed.pdf", my_storage)
response = file_api.download_file(request)

# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(response, "C:\\Files\\")

ابحث عن التوقيعات الإلكترونية واستبدلها باستخدام Python

يمكنك البحث عن التوقيعات واستبدالها في مستند PDF موقع برمجيًا باتباع الخطوات الواردة أدناه.

  • قم بإنشاء مثيل SignApi
  • قم بتعيين المسار إلى ملف PDF الموقع
  • ابحث عن رمز الاستجابة السريعة
    • تحديد SearchQRCodeOptions و SearchSettings
    • إنشاء SearchSignatureRequest
    • احصل على النتائج عن طريق استدعاء طريقة SignApi.search \ Signatures()
  • احذف رمز الاستجابة السريعة الذي تم البحث عنه
    • حدد DeleteOptions و DeleteSettings
    • قم بإنشاء DeleteSignatureRequest
    • احصل على النتائج عن طريق استدعاء طريقة SignApi.delete \ Signatures()
  • التوقيع بالباركود
    • حدد SignBarcodeOptions
    • اضبط حجم وموضع الرمز الشريطي
    • تحديد SignSettings
    • قم بتعيين SignBarcodeOptions و SaveOptions إلى SignSettings
    • قم بإنشاء CreateSignaturesRequest
    • احصل على النتائج عن طريق استدعاء الأسلوب SignApi.create \ Signatures()

يوضح مقتطف الكود التالي كيفية البحث عن توقيع QR Code واستبداله بتوقيع Barcode في مستند PDF موقع باستخدام REST API. يرجى اتباع الخطوات المذكورة سابقًا لتنزيل الملف المحدث.

# تهيئة API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

# رمز qr مسار المستند الموقع
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"

# البحث عن كود qr
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'

settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo

request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)

# حذف كود qr
opts = groupdocs_signature_cloud.DeleteOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id

settings = groupdocs_signature_cloud.DeleteSettings()
settings.options = [opts]
settings.file_info = fileInfo

request = groupdocs_signature_cloud.DeleteSignaturesRequest(settings)
response = api.delete_signatures(request)

# التوقيع مع الباركود
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'

# تعيين موضع توقيع الباركود على الصفحة
opts.left = 250
opts.top = 0
opts.width = 300
opts.height = 90
opts.location_measure_type = "Pixels"
opts.size_measure_type = "Pixels"
opts.stretch = "None"
opts.rotation_angle = 0
opts.horizontal_alignment = "None"
opts.vertical_alignment = "None"
opts.margin = groupdocs_signature_cloud.Padding()
opts.margin.all = 5
opts.margin_measure_type = "Pixels"

opts.inner_margins = groupdocs_signature_cloud.Padding()
opts.inner_margins.all = 2

opts.page = 1

settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "Output\\signedBarCode_sample.pdf"
settings.file_info = fileInfo

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
ابحث عن التوقيعات واستبدلها في مستند PDF الموقع باستخدام Python

ابحث عن التوقيعات واستبدلها في مستند PDF الموقع باستخدام Python

جرب عبر الإنترنت

يرجى تجربة أداة توقيع PDF المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/signature/pdf

خاتمة

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

أنظر أيضا