نظرة عامة

ما تغطيه الطبقة المنطقية

طبقة المنطق في تطبيق Twenty هي الشيفرة التي تعمل — معالِجات TypeScript على جانب الخادم تستجيب لطلبات HTTP، وجداول كرون، وتغييرات السجلات؛ ومهارات ووكلاء الذكاء الاصطناعي التي تعمل داخل مساحة العمل؛ والاتصالات (OAuth أو مسار تسجيل دخول مخصص) التي تتيح لدوالّك العمل نيابةً عن المستخدم في خدمات الجهات الخارجية؛ وقنوات المراسلة التي تجلب صندوق وارد خارجيًا إلى Twenty.

            ┌─ HTTP route      ──┐
            │  Cron schedule     │
            │  Database event    │      ┌────────────────────┐
  triggers ─┤  AI tool call      ├─────▶│ Logic function     │
            │  Workflow action   │      │ (your handler)     │
            │  Manual exec       │      └────────────────────┘
            └────────────────────┘                │
                                                  ▼
                                  ┌────────────────────────────┐
                                  │ Twenty API (records)       │
                                  │ Third-party API            │
                                  │   (via Connection token)   │
                                  └────────────────────────────┘

في هذا القسم

الوظائف المنطقية

كتلة البناء الأساسية - الأنواع المشغلة والحمولات وعميل API المكتوب.

المهارات والوكلاء

تعليمات وكيل AI المعاد استخدامها ومساعدين مع طلبات النظام المخصص.

سير العمل

تم تثبيت سير العمل جاهز مع التطبيق الخاص بك: المشغلات والخطوات وكيفية تشغيلها.

اتصالات

OAuth يعتمد تطبيقك على خدمات الطرف الثالث - Linear، GitHub، Slack، وأكثر من ذلك.

قنوات المراسلة

جلب المحادثات من أي موفر إلى سجلات رسائل ورسائل 20 - بما في ذلك التلاعب وعدم التكرار.

البريد الوارد

انشر الرسائل في البريد الوارد للأعضاء من دوال المنطق والمكونات الأمامية.

متجر القيمة الرئيسية

حالة ثابتة بين الدالة المنطقية تعمل - المخبآت، والمؤشرات، ومطالبات المساحة المشتركة للعمل.

المهام الخلفية

أضف إلى قائمة الانتظار دالة منطقية تُشغَّل على العمال لتجاوز المهلة الزمنية لكل تشغيل.

رصيد الشحن

إعلان ما فواتير التطبيق الخاص بك من أرصدة مساحة العمل الخاصة بك.

لمحة عن أنواع المشغلات

دالة المنطق تختار واحدًا أو أكثر من المشغلات — كل إدخال أدناه هو حقل منفصل في defineLogicFunction():

المشغّل	متى يعمل	الإعداد
مسار HTTP	طلب يصل إلى نقطة نهاية `/s/\<path>` الخاصة بك	`httpRouteTriggerSettings`
كرون	عند تطابق تعبير CRON	`cronTriggerSettings`
حدث قاعدة البيانات	يتم إنشاء سجل في مساحة العمل أو تحديثه أو حذفه	`databaseEventTriggerSettings`
أداة ذكاء اصطناعي	ميزة ذكاء اصطناعي في Twenty تقرر استدعاء دالتك	`toolTriggerSettings`
إجراء سير العمل	تستدعي خطوة في سير العمل دالتك	`workflowActionTriggerSettings`

تعمل الدوال ضمن عمليات Node.js معزولة، وتصل إلى مساحة العمل عبر عميل واجهة برمجة تطبيقات مضبوط الأنواع ومحدّد النطاق بالدور المصرّح عنه في defineApplication().

خطافات وقت التثبيت — الشيفرة التي تعمل قبل التثبيت أو بعده — تشارك بيئة التشغيل هذه ولكنها تستخدم دوال تعريف خاصة بها وتوجد ضمن Config → Install Hooks.تشاركه عملية التحقق من الحالة أيضًا. يُعرّف تطبيقٌ عمليةَ تحقّق واحدةً دون مُشغِّل. افتراضيًا، يستدعي Twenty معالجه الذي لا يتطلب أي وسيطات عند فتح إعدادات تطبيق مساحة العمل. عيّن runOnUserPreferences: true لتشغيله بدلًا من ذلك على صفحة تفضيلات التطبيقات الخاصة بالعضو، مع userWorkspaceId المطلوب لديه.

المطورون

التطبيقات

واجهة برمجة التطبيقات

الاستضافة الذاتية

المساهمة

مكتبة واجهة المستخدم

ما تغطيه الطبقة المنطقية

في هذا القسم

لمحة عن أنواع المشغلات

​ما تغطيه الطبقة المنطقية

​في هذا القسم

​لمحة عن أنواع المشغلات

ما تغطيه الطبقة المنطقية

في هذا القسم

لمحة عن أنواع المشغلات