Skip to main content
أنشئ أو اجلب ملف PDF تلقائيًا وأرفقه بسجل في Twenty. يُستخدم هذا عادةً لإنشاء عروض أسعار أو فواتير أو تقارير مرتبطة بالشركات أو الفرص أو كائنات أخرى.

نظرة عامة

يستخدم سير العمل هذا المحفز اليدوي بحيث يتمكن المستخدمون من إنشاء ملف PDF عند الطلب لأي سجل محدد. تتولى الوظيفة المنطقية ما يلي:
  1. تنزيل ملف PDF من عنوان URL (من خدمة إنشاء PDF)
  2. رفع الملف إلى Twenty
  3. إنشاء مرفق مرتبط بالسجل

المتطلبات الأساسية

قبل إعداد سير العمل:
  1. أنشئ مفتاح API: انتقل إلى الإعدادات → واجهات برمجة التطبيقات ثم أنشئ مفتاح API جديدًا. ستحتاج إلى هذا الرمز لوظيفة المنطق.
  2. قم بإعداد خدمة إنشاء PDF (اختياري): إذا كنت تريد إنشاء ملفات PDF ديناميكيًا (مثل عروض الأسعار)، فاستخدم خدمة مثل Carbone أو PDFMonkey أو DocuSeal لإنشاء ملف PDF والحصول على رابط تنزيل.

إعداد خطوة بخطوة

الخطوة 1: تهيئة المشغّل

  1. انتقل إلى سير العمل وأنشئ سير عمل جديدًا
  2. اختر المحفز اليدوي
  3. اختر الكائن الذي تريد إرفاق ملفات PDF به (مثل شركة أو فرصة)
مع محفز يدوي، يمكن للمستخدمين تشغيل سير العمل هذا باستخدام زر يظهر في الجزء العلوي الأيمن بمجرد تحديد سجل - وهذا يعمل على تشغيل سير العمل لإنشاء وإرفاق PDF.

الخطوة 2: إضافة وظيفة منطقية

  1. إضافة إجراء الكود (الدالة المنطقية)
  2. أنشئ وظيفة جديدة باستخدام الكود أدناه
  3. قم بتهيئة معلمات الإدخال

معلمات الإدخال

إذا كنت تُرفِقه بكائن مختلف (شخص، فرصة، إلخ)، فأعد تسمية المعلمة وفقًا لذلك (مثلًا، personId، opportunityId) وحدّث الوظيفة المنطقية.

كود الوظيفة المنطقية

الخطوة 3: خصّص وفق حالة الاستخدام الخاصة بك

لإرفاقه بكائن مختلف

استبدل targetCompanyId بالحقل المناسب: حدّث كل من معلمة الوظيفة وكائن variables.data في عملية الـ mutation الخاصة بالمرفق.

لاستخدام رابط PDF ديناميكي

إذا كنت تستخدم خدمة إنشاء PDF، يمكنك:
  1. أولًا، أنشئ إجراء طلب HTTP لإنشاء ملف PDF
  2. مرّر رابط ملف PDF المُعاد إلى الوظيفة المنطقية كمعلمة

الخطوة 4: الاختبار والتفعيل

  1. احفظ سير العمل
  2. انتقل إلى سجل شركة
  3. انقر على قائمة واختر سير العمل الخاص بك
  4. تحقّق من قسم المرفقات في السجل للتأكد من أنه تم إرفاق ملف PDF
  5. فعّل سير العمل

الدمج مع خدمات إنشاء ملفات PDF

لإنشاء عروض أسعار أو فواتير ديناميكية:

مثال: إنشاء عرض سعر → إرفاق ملف PDF

خدمات شائعة لإنشاء ملفات PDF

  • Carbone - إنشاء مستندات يعتمد على القوالب
  • PDFMonkey - إنشاء PDF ديناميكي من القوالب
  • DocuSeal - منصة أتمتة المستندات
  • Documint - إنشاء مستندات يعتمد على واجهة برمجة التطبيقات أولًا
توفر كل خدمة API الذي يعيد رابط PDF الذي يمكنك انتقاله إلى الدالة المنطقية.

استكشاف الأخطاء وإصلاحها

ذات صلة