Documentation – إضافة البرامج النصية وإرسال الإجراءات

Python-Net: إضافة برنامج نصي ميداني

Thu, 11 Jun 2026 00:00:00 +0000

إضافة إجراءات جافا سكريبت إلى حقول نموذج PDF باستخدام Python

يمكّنك مقتطف الشفرة هذا من إضافة إجراءات JavaScript إلى حقل نموذج PDF موجود باستخدام مكتبة Aspose.PDF لـ Python. يفتح مستند PDF، ويعين إجراء JavaScript لحقل النموذج، ويضيف نصًا يتم تشغيله عند تشغيل الحقل. أخيرًا، يتم حفظ ملف PDF المحدث كملف جديد. استخدام المحرر السابق فئة من واجهات أسبوز.pdf الوحدة، يمكنك إرفاق JavaScript برمجيًا بحقول النموذج الموجودة:

افتح نموذج PDF موجود.
قم بتعيين إجراء JavaScript لحقل معين.
قم بإلحاق إجراء JavaScript آخر بنفس الحقل.
احفظ وثيقة PDF المعدلة.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_field_script(input_file_name, output_file_name):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()

    # Open input PDF file
    form_editor.bind_pdf(input_file_name)

    # Set JavaScript action for the field
    form_editor.set_field_script(
        "Script_Demo_Button", "app.alert('Script 1 has been executed');"
    )

    # Add JavaScript action to the field
    form_editor.add_field_script(
        "Script_Demo_Button", "app.alert('Script 2 has been executed');"
    )

    # Save output PDF file
    form_editor.save(output_file_name)

Python-Net: إزالة الإجراء الميداني

Thu, 11 Jun 2026 00:00:00 +0000

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

استخدام المحرر السابق فئة من واجهات أسبوز.pdf، يمكنك إزالة إجراءات JavaScript من حقول محددة في نموذج PDF موجود:

افتح نموذج PDF موجود.
حدد موقع حقل النموذج المسمى «Script_Demo_Button».
قم بإزالة إجراء JavaScript المرتبط بهذا الحقل.
تحقق مما إذا كانت الإزالة ناجحة.
احفظ مستند PDF المحدث.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def remove_field_script(input_file_name, output_file_name):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()

    # Open input PDF file
    form_editor.bind_pdf(input_file_name)

    # Remove JavaScript action from the field
    if not form_editor.remove_field_action("Script_Demo_Button"):
        raise Exception("Failed to remove field script")

    # Save output PDF file
    form_editor.save(output_file_name)

Python-Net: تعيين البرنامج النصي الميداني

Thu, 11 Jun 2026 00:00:00 +0000

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

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

يُطلق على حقل النموذج المستخدم في هذا المثال اسم «Script_Demo_Button»، والذي يمثل عادةً زرًا يقوم بتنفيذ البرنامج النصي المعين عند تشغيله.

استخدام المحرر السابق فئة من واجهات أسبوز.pdf الوحدة، يمكن للمطورين إدارة إجراءات JavaScript المرتبطة بحقول النموذج برمجيًا:

افتح مستند نموذج PDF موجود.
أضف إجراء JavaScript إلى حقل النموذج.
قم بتعيين (استبدال) إجراء JavaScript ببرنامج نصي جديد.
احفظ وثيقة PDF المعدلة.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def set_field_script(input_file_name, output_file_name):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()

    # Open input PDF file
    form_editor.bind_pdf(input_file_name)

    # Add JavaScript action to the field
    form_editor.add_field_script(
        "Script_Demo_Button", "app.alert('Script 1 has been executed');"
    )

    # Set JavaScript action for the field
    form_editor.set_field_script(
        "Script_Demo_Button", "app.alert('Script 2 has been executed');"
    )

    # Save output PDF file
    form_editor.save(output_file_name)

Python-Net: تعيين عنوان URL للإرسال

Thu, 11 Jun 2026 00:00:00 +0000

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

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

افتح نموذج PDF موجود.
حدد موقع حقل الزر المسمى Script_Demo_Button.
قم بتعيين عنوان URL حيث سيتم إرسال بيانات النموذج.
تحقق من تطبيق الإجراء بنجاح.
احفظ مستند PDF المحدث.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def set_submit_url(input_file_name, output_file_name):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()

    # Set license
    set_license()

    # Open input PDF file
    form_editor.bind_pdf(input_file_name)

    # Set submit URL for the button
    if not form_editor.set_submit_url(
        "Script_Demo_Button", "http://www.example.com/submit"
    ):
        raise Exception("Failed to set submit URL")

    # Save output PDF file
    form_editor.save(output_file_name)

Python-Net: تعيين علامة الإرسال

Thu, 11 Jun 2026 00:00:00 +0000

غالبًا ما تتضمن نماذج PDF أزرار الإرسال لإرسال مدخلات المستخدم إلى الخادم. تحدد علامة الإرسال تنسيق البيانات المرسلة (على سبيل المثال، XFDF، FDF، HTML).

قم بربط مستند PDF.
قم بالوصول إلى زر إرسال موجود.
قم بتعيين علامة الإرسال للتنسيق المطلوب.
احفظ مستند PDF المحدث.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def set_submit_flag(input_file_name, output_file_name):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()

    # Open input PDF file
    form_editor.bind_pdf(input_file_name)

    # Set submit flag for the form
    form_editor.set_submit_flag("Script_Demo_Button", ap.facades.SubmitFormFlag.XFDF)

    # Save output PDF file
    form_editor.save(output_file_name)