\usepackage{n8n}

أتمتة إنشاء ملفات PDF من LaTeX باستخدام n8n

اربط أي مشغِّل (trigger)، سواء كان webhook أو نموذجًا أو تغييرًا في قاعدة بيانات أو جدولًا زمنيًا، بعقدة مجتمع n8n الرسمية الخاصة بـ FormaTeX. دون الحاجة إلى ربط HTTP مخصص. تصبح مستندات LaTeX جزءًا من سير عمل الأتمتة لديك.

\section{ما هو n8n}

أتمتة سير العمل للمطورين

n8n منصة مفتوحة المصدر لأتمتة سير العمل. تبني سير العمل بصريًا بربط العقد، وتؤدي كل عقدة إجراءً واحدًا، مثل استدعاء واجهة API أو قراءة قاعدة بيانات أو إرسال بريد إلكتروني. يمكن استضافة سير العمل ذاتيًا أو تشغيله على n8n Cloud.

منشئ سير عمل بصري

اربط العقد على لوحة بالسحب والإفلات. لا حاجة إلى كتابة شيفرة في معظم التكاملات، فقط اضبط كل عقدة واربطها ببعضها.

أكثر من 400 تكامل

يأتي n8n بعقد لـ Slack وGoogle Sheets وPostgres وS3 وGmail ومئات الخدمات الأخرى، بما فيها عقدة المجتمع الرسمية من FormaTeX لسير عمل LaTeX.

Self-hostable

شغّل n8n على بنيتك التحتية الخاصة باستخدام Docker Compose. تبقى بيانات سير العمل على خوادمك دون ارتباط بمزوّد SaaS.

\section{إعداد سير العمل}

ابنِ سير العمل في أربع خطوات

1

أنشئ بيانات اعتماد FormaTeX API

في n8n، انتقل إلى Credentials → New → FormaTeX API . عيّن API URL إلى https://api.formatex.io وأدخل مفتاح API. تُخزَّن بيانات الاعتماد مشفّرة في مخزن بيانات الاعتماد في n8n.

2

أضف عقدة مشغِّل

ابدأ سير العمل بالمشغِّل المناسب لحالة استخدامك. يعمل مشغِّل Webhook عندما يرسل نظام خارجي بيانات. ويولّد مشغِّل Schedule المستندات على فترات ثابتة. ويحوّل مشغِّل n8n Form إرسال نموذج ويب إلى ملف PDF فورًا.

3

اضبط عقدة FormaTeX

أضف عقدة FormaTeX واضبطها كما يلي:

  • العملية: Compile (أو Smart Compile)
  • بيانات الاعتماد: FormaTeX API
  • المُجمِّع: pdflatex / xelatex / lualatex / latexmk
  • حقل LaTeX: استخدم نصًا ثابتًا أو تعبيرات n8n
  • تنزيل PDF كبيانات ثنائية: مفعّل

في حقل LaTeX Source، استخدم تعبيرات n8n {{ $json["field"] }} لإدراج بيانات عقدة المشغِّل في مستندك:

# n8n community package
npm install n8n-nodes-formatex

# In n8n UI
Credentials:
- API URL: https://api.formatex.io
- API Key: your key

Node:
- Type: FormaTeX
- Operation: Compile
- Engine: pdflatex
- Download PDF as Binary: true
4

احفظ ملف PDF أو سلّمه

تُعيد عقدة FormaTeX بيانات ثنائية عند تفعيل ذلك. اربط عقدة Write Binary File لحفظ ملف PDF على القرص، أو عقدة AWS S3 لرفعه إلى bucket، أو عقدة Gmail لإرساله كمرفق، أو عقدة Google Drive لتخزينه في مجلد مشترك. ادمج العقد لتنفيذ ذلك كله في تشغيل واحد لسير العمل.

\section{تخزين بيانات الاعتماد}

حماية مفتاح API في n8n

لا تلصق مفتاح API مباشرةً في معلمة عقدة أو في JSON الخاص بسير العمل. يشفّر مخزن بيانات الاعتماد في n8n الأسرار أثناء التخزين باستخدام AES-256. يُشار إلى بيانات الاعتماد بالاسم ولا تظهر أبدًا في ملفات تصدير سير العمل.

n8n المستضاف ذاتيًا: تُشفَّر بيانات الاعتماد بمفتاح مشتق من N8N_ENCRYPTION_KEY في ملف البيئة لديك.
n8n Cloud: تُخزَّن بيانات الاعتماد في قاعدة بيانات مشفّرة تديرها n8n. يمكنك أيضًا تفعيل الأسرار الخارجية عبر AWS Secrets Manager أو HashiCorp Vault.
لا ترفع ملفات JSON المصدَّرة لسير عمل n8n إلى مستودع عام، فهي تشير إلى معرّفات بيانات الاعتماد التي قد تكشف الخدمات التي تتكامل معها.

\section{حالات الاستخدام}

سير عمل يمكنك بناؤه اليوم

تقارير مجدولة

شغّل سير عمل وفق جدول cron، واسحب البيانات من قاعدة بيانات أو جدول بيانات، وولّد قالب LaTeX، وأرسل ملف PDF المجمَّع بالبريد الإلكتروني إلى قائمة توزيع كل صباح اثنين.

من نموذج إلى PDF

اربط n8n Form أو webhook من Typeform بواجهة FormaTeX API. بمجرد أن يرسل المستخدم نموذجًا، يُولَّد ملف PDF مخصص ويُعاد أو يُرسل بالبريد الإلكتروني خلال ثوانٍ.

إنشاء الفواتير والعقود

راقب نظام CRM أو نظام الدفع بحثًا عن سجلات جديدة. لكل طلب جديد، ولّد قالب فاتورة LaTeX وجمّعه إلى PDF وأرفقه برسالة تأكيد تلقائيًا.

تصدير مستندات بالجملة

مرّر جدول بيانات أو استعلام قاعدة بيانات إلى حلقة في n8n. لكل صف، جمّع مستند LaTeX مخصصًا وارفع ملف PDF إلى S3 أو Google Drive في تشغيل واحد لسير العمل.

\section{تكاملات ذات صلة}

مزيد من أدلة الأتمتة وSDK

استخدم FormaTeX من أي منصة أتمتة أو لغة برمجة.

ابدأ أتمتة ملفات PDF من LaTeX باستخدام n8n

الخطة المجانية: 15 عملية تجميع مجانية عبر API شهريًا. لا حاجة إلى بطاقة ائتمان.