نصوص النموذج (Form Scripts)

نصوص النموذج

نصوص النموذج (Form Scripts) هي كود JavaScript يعمل من جانب العميل (client-side) ويعزز تجربة المستخدم (UX) للنماذج الخاصة بك.

لنفترض أنك تريد إنشاء عضوية لعضو. للقيام بذلك، يجب عليك الانتقال إلى قائمة Library Membership، وإنشاء نموذج جديد، واختيار العضو والحقول الأخرى ثم الحفظ.

وبالمثل، عندما تريد إنشاء معاملة لعضو، يجب عليك إنشاء نموذج Library Transaction جديد.

يمكننا جعل هذه العملية أسهل. اكتب الكود التالي في ملف library_member.js:

library_member.js

frappe.ui.form.on('Library Member', {
    refresh: function(frm) {
        // زر لإنشاء عضوية جديدة
        frm.add_custom_button('إنشاء عضوية', () => {
            frappe.new_doc('Library Membership', {
                library_member: frm.doc.name // تعيين العضو الحالي تلقائيًا
            })
        })

        // زر لإنشاء معاملة جديدة
        frm.add_custom_button('إنشاء معاملة', () => {
            frappe.new_doc('Library Transaction', {
                library_member: frm.doc.name // تعيين العضو الحالي تلقائيًا
            })
        })
    }
});

الآن، قم بتحديث الصفحة وانتقل إلى نموذج Library Member. يجب أن ترى زرين في أعلى اليمين. انقر عليهما لتجربتهما. سيقومان تلقائيًا بتعيين Library Member في كل من تلك المستندات، مما يجعل العملية أسهل.

<اسم الصورة>

لقد تعرفنا فقط على الأساسيات هنا. يمكنك فعل المزيد باستخدام نصوص النموذج. تعلم المزيد عن واجهة برمجة التطبيقات (API) في وثائق واجهة برمجة تطبيقات نصوص النموذج.