نظرة عامة
يستخدم سير العمل هذا المحفز اليدوي بحيث يتمكن المستخدمون من إنشاء ملف PDF عند الطلب لأي سجل محدد. تتولى الوظيفة المنطقية ما يلي:- تنزيل ملف PDF من عنوان URL (من خدمة إنشاء PDF)
- رفع الملف إلى Twenty
- إنشاء مرفق مرتبط بالسجل
المتطلبات الأساسية
قبل إعداد سير العمل:- أنشئ مفتاح API: انتقل إلى الإعدادات → واجهات برمجة التطبيقات ثم أنشئ مفتاح API جديدًا. ستحتاج إلى هذا الرمز المميز للوظيفة المنطقية.
- قم بإعداد خدمة إنشاء PDF (اختياري): إذا كنت تريد إنشاء ملفات PDF ديناميكيًا (مثل عروض الأسعار)، فاستخدم خدمة مثل Carbone أو PDFMonkey أو DocuSeal لإنشاء ملف PDF والحصول على رابط تنزيل.
إعداد خطوة بخطوة
الخطوة 1: تهيئة المشغّل
- انتقل إلى سير العمل وأنشئ سير عمل جديدًا
- اختر المحفز اليدوي
- اختر الكائن الذي تريد إرفاق ملفات PDF به (مثل شركة أو فرصة)
الخطوة 2: إضافة وظيفة منطقية
- أضف إجراء Code (وظيفة منطقية)
- أنشئ وظيفة جديدة باستخدام الكود أدناه
- قم بتهيئة معلمات الإدخال
معلمات الإدخال
| المعلمة | القيمة |
|---|---|
companyId | {{trigger.object.id}} |
إذا كنت تُرفِقه بكائن مختلف (شخص، فرصة، إلخ)، فأعد تسمية المعلمة وفقًا لذلك (مثلًا،
personId، opportunityId) وحدّث الوظيفة المنطقية.كود الوظيفة المنطقية
الخطوة 3: خصّص وفق حالة الاستخدام الخاصة بك
لإرفاقه بكائن مختلف
استبدلtargetCompanyId بالحقل المناسب:
| كائن | اسم الحقل |
|---|---|
| الشركة | targetCompanyId |
| شخص | targetPersonId |
| الفرصة | targetOpportunityId |
| كائن مخصّص | targetYourCustomObjectId |
variables.data في عملية الـ mutation الخاصة بالمرفق.
لاستخدام رابط PDF ديناميكي
إذا كنت تستخدم خدمة إنشاء PDF، يمكنك:- أولًا، أنشئ إجراء طلب HTTP لإنشاء ملف PDF
- مرّر رابط ملف PDF المُعاد إلى الوظيفة المنطقية كمعلمة
الخطوة 4: الاختبار والتفعيل
- احفظ سير العمل
- انتقل إلى سجل شركة
- انقر على قائمة ⋮ واختر سير العمل الخاص بك
- تحقّق من قسم المرفقات في السجل للتأكد من أنه تم إرفاق ملف PDF
- فعّل سير العمل
الدمج مع خدمات إنشاء ملفات PDF
لإنشاء عروض أسعار أو فواتير ديناميكية:مثال: إنشاء عرض سعر → إرفاق ملف PDF
| الخطوة | الإجراء | الغرض |
|---|---|---|
| 1 | المحفز اليدوي (الشركة) | يبدأ المستخدم التنفيذ على سجل |
| 2 | البحث عن سجل | الحصول على تفاصيل الفرصة أو بنود السطر |
| 3 | طلب HTTP | استدعِ واجهة برمجة تطبيقات إنشاء PDF باستخدام بيانات السجل |
| 4 | وظيفة بلا خادم | تنزيل وإرفاق ملف PDF المُنشأ |
خدمات شائعة لإنشاء ملفات PDF
- Carbone - إنشاء مستندات يعتمد على القوالب
- PDFMonkey - إنشاء PDF ديناميكي من القوالب
- DocuSeal - منصة أتمتة المستندات
- Documint - إنشاء مستندات يعتمد على واجهة برمجة التطبيقات أولًا
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| ”فشل تنزيل ملف PDF” | تحقق من أن رابط ملف PDF قابل للوصول ويعيد ملف PDF صالحًا |
| ”فشل الرفع” | تحقق من أن مفتاح API صالح ولديه أذونات كتابة |
| ”فشل إنشاء المرفق” | تأكد من أن اسم حقل معرّف الكائن يطابق الكائن المستهدف |