ربط صفحة منشئ التطبيقات بسير عمل
ما الذي يفعله هذا التكامل؟
تستطيع RAPTIX ربط صفحة منشئ التطبيقات بسير عمل من عقدة البدء. عندما تحفظ التكامل، تفحص RAPTIX أدوات إدخال البيانات المدعومة في الصفحة، وتنشئ موصل سير عمل فيها أو تحدثه. كما تربط زر إرسال موجودًا أو تنشئ واحدًا عند الحاجة.
يستطيع الموصل المنشور:
- جمع القيم من أدوات إدخال البيانات المدعومة في الصفحة؛
- إضافة قيمة الكيان وسياق الملف المضبوطين؛
- بدء سير العمل المضبوط؛
- رفع الملفات المحددة بعد إنشاء مثيل سير العمل؛ و
- عرض رسالة نجاح أو فشل في الصفحة.
تغير هذه الميزة صفحة في منشئ التطبيقات، ولا تتوفر إلا لمؤسسات Enterprise.
ملاحظة انتقالية: ما زالت بعض شاشات منشئ التدفق تعرض التسمية التقنية تكامل Appsmith عبر HTTP (
Appsmith Integration (HTTP)). يسمي هذا الدليل الخيار تكامل منشئ التطبيقات. وهو ليس ميزة نموذج سير العمل الأصلي/f/:token.
قبل أن تبدأ
تأكد مما يلي:
- تملك مؤسستك وصول Enterprise؛
- تستطيع تحرير سير العمل في منشئ التدفق، ولديك صلاحية تغيير معتمدة للصفحة الهدف؛
- لا تحتوي الصفحة الهدف إلا على أدوات إدخال البيانات التي يُسمح للموصل بإرسالها؛
- أسماء الأدوات ثابتة وفريدة؛ و
- ضبط مشغل المنصة سر تكامل منشئ التطبيقات.
استخدم صفحة اختبار أو نسخة قبل النشر إلى تطبيق حي. يحدث النشر اتصال الصفحة وقد ينشر تعديلات معلقة غير مرتبطة. راجع أو امسح كل تغيير غير منشور لا يرتبط بالمهمة قبل النشر.
مهم: اختيار صفحة ليس موافقة على تغييرها. لا تستخدم النشر إلا ضمن عملية تغيير الصفحات المعتمدة في مؤسستك.
ربط الصفحة
- افتح التطبيقات، وحدد سير العمل، وافتحه في منشئ التدفق.
- افتح عقدة البدء لسير العمل.
- اختر خيار بدء تكامل منشئ التطبيقات. يحمل هذا الخيار في المنتج الحالي تسمية تكامل Appsmith عبر HTTP؛ اختره.
- اختر اتصال، ثم حدد مساحة عمل منشئ التطبيقات والتطبيق والصفحة.
- راجع مخزون الصفحة. يفحص النشر الحالي أدوات إدخال البيانات المدعومة فيها؛ لذا تأكد من أنها لا تحتوي إلا على الحقول المقصودة لسير العمل.
- حدد أداة الكيان اختياريًا. تصبح قيمتها معرّف سجل العمل للتشغيل.
- إذا عرضت الواجهة اختيار المستند الرئيسي، فسجله في تصميم سير العمل، لكن لا تعتمد عليه للحد من العناصر التي يفحصها الموصل المُنشأ حاليًا.
- فعّل إنشاء متغيرات سير العمل إذا احتاجت العُقد اللاحقة إلى قيم مسماة من الصفحة.
- اختر ما إذا كانت واجهة الصفحة تتطلب مستخدمًا مسجلًا. يُعد طلب المصادقة فحصًا في جهة العميل داخل الموصل المُنشأ، وليس حد تفويض كاملًا في الخادم. لا تعرض التكامل لمستخدمين غير موثوقين؛ استخدم نموذجًا أصليًا خاصًا للمدخلات الحساسة.
- اختر حفظ خصائص البدء.
تعرض RAPTIX ما إذا كان الموصل قد أُنشئ أو حُدث، وما إذا كان زر الإرسال أُنشئ أو رُبط. افتح الصفحة في منشئ التطبيقات وحدّثها قبل الاختبار.
اختبار التكامل
- تأكد من أن النشر حدث الصفحة المقصودة، ومن عدم نشر تغيير غير مرتبط.
- أدخل قيم اختبار مميزة في كل أداة إدخال بيانات مدعومة في الصفحة.
- أضف ملف اختبار صغيرًا إذا كانت الصفحة تحتوي على أداة ملفات.
- اختر زر الإرسال المنشور مرة واحدة.
- تأكد من أن استجابة النجاح تتضمن معرّف مثيل سير العمل.
- افتح تشغيل سير العمل في RAPTIX وتحقق من القيم المرسلة وسياق البادئ ومعرّف الكيان والمستندات.
اختبر سلوك المستخدم المسجل والجمهور المقصود للصفحة. وللمدخلات الحساسة أو الخارجية، فضّل نموذج سير عمل أصليًا بإعداد خاص أو عام مناسب.
ما الذي يحدث عند إعادة النشر؟
يؤدي حفظ التكامل نفسه مجددًا إلى استبدال بيانات الموصل المنشأة أو تحديثها، بدلًا من طلب إعداد يدوي ثانٍ. قد ينشر كل إعادة نشر الصفحة غير المنشورة كاملة. أعد النشر عندما:
- تضيف أداة إدخال بيانات مدعومة أو تزيلها أو تعيد تسميتها؛
- تغير أداة الكيان أو تصميم معالجة الملفات؛
- تغير اسم سير العمل أو إعداد البدء؛
- تغير إعداد المصادقة؛ أو
- تدوّر سر تكامل منشئ التطبيقات.
حدّث صفحة منشئ التطبيقات بعد كل نشر. لا تفترض أن صفحة مفتوحة بالفعل في علامة أخرى حمّلت الإعداد الجديد.
الأمان وسر التكامل
يستخدم اتصال منشئ التطبيقات بيانات اعتماد يضبطها مسؤول المنصة. عامل الصفحة المتصلة كنشر موثوق، ولا تنسخ بيانات الاعتماد مطلقًا إلى وثائق أو لقطات شاشة أو تذاكر أو سجلات أو إعدادات صفحة تُصان يدويًا.
لا تنشر الصفحة المتصلة لجمهور غير معتمد. للمدخلات الخارجية أو الحساسة، استخدم نموذج سير عمل أصليًا خاصًا أو عامًا خضع للمراجعة لهذا الغرض.
ترفض نقطة نهاية التكامل الطلبات:
- إذا لم يُضبط السر، تُرفض استدعاءات تكامل منشئ التطبيقات بوصفها غير متاحة؛
- إذا كان السر مفقودًا أو غير صحيح، تُرفض الاستدعاءات بوصفها ممنوعة؛ و
- بعد تغيير السر، يجب إعادة نشر كل صفحة متأثرة كي يستخدم موصلها المنشأ القيمة الجديدة.
لا يحل التحقق من بيانات الاعتماد محل وصول المستخدم والصفحة. طلب المصادقة جزء واحد من سلوك الصفحة المنشأ، ولذلك أبقِ أذونات التطبيقات وضوابط الوصول المؤسسية المعتادة مفعّلة.
استخدم نطاق مساحة RAPTIX الحالية والعناوين التي تنشئها المنصة. لا تثبت نطاق منتج متقاعدًا في برامج الصفحة النصية.
تستخدم نماذج سير العمل الأصلية في /f/:token نموذج أمان مختلفًا. تتطلب النماذج الخاصة عضو RAPTIX مسجلًا؛ وتستخدم النماذج العامة رمز مشاركة مبهمًا وتحققًا لمكافحة الروبوتات وحدود معدل وفحوص سلامة في الخادم. ولا تعتمد على سر تكامل منشئ التطبيقات. راجع نماذج سير العمل الخاصة والعامة.
استكشاف الأخطاء وإصلاحها
لا تظهر مساحات عمل أو صفحات
تأكد من استحقاق Enterprise والوصول إلى منشئ التطبيقات. لا تصبح مساحة التطبيقات الأصلية مساحة منشئ تطبيقات تلقائيًا.
يُحفظ التكامل لكن الصفحة لم تتغير
حدّث منشئ التطبيقات، وتأكد من اختيار الصفحة الصحيحة، وانشر مجددًا. تحقق من ملخص النجاح لمعرفة حالة الموصل وزر الإرسال.
زر الإرسال غير مربوط
تأكد من احتواء الصفحة على زر صالح ومن عدم تغيير أسماء الأدوات. أعد النشر بعد تصحيح الصفحة.
يعيد الإرسال «غير متاح» أو «ممنوع»
اطلب من مشغل المنصة التحقق من سر تكامل منشئ التطبيقات. إذا ضُبط أو دُوّر حديثًا، فأعد نشر الصفحة.
يبدأ سير العمل من دون القيم المتوقعة
عُد إلى عقدة البدء، واحصر كل أداة إدخال بيانات مدعومة في الصفحة، وراجع المتغيرات المنشأة، واحفظ مجددًا، ثم اختبر بقيم جديدة.