مسارات العمل

​

عرّف سير عمل

import {
  defineWorkflow,
  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
} from 'twenty-sdk/define';

const COMPANY = STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier;
const SCORE_COMPANY_FUNCTION = '0f6c0b3e-8a4f-4f0e-9d0a-3c1e5b7a2d41';

const SCORE_NEW_COMPANIES = {
  workflow: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e81',
  trigger: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e82',
  score: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e83',
  save: 'c2a4e6f8-1b3d-4f5a-8c7e-9d0b2a4c6e84',
};

export default defineWorkflow({
  universalIdentifier: SCORE_NEW_COMPANIES.workflow,
  name: 'Score new companies',
  version: {
    trigger: {
      universalIdentifier: SCORE_NEW_COMPANIES.trigger,
      type: 'DATABASE_EVENT',
      settings: {
        objectUniversalIdentifier: COMPANY,
        action: 'created',
      },
      nextStepIds: [SCORE_NEW_COMPANIES.score],
    },
    steps: [
      {
        universalIdentifier: SCORE_NEW_COMPANIES.score,
        name: 'Score the company',
        type: 'LOGIC_FUNCTION',
        logicFunctionUniversalIdentifier: SCORE_COMPANY_FUNCTION,
        input: { companyName: '{{trigger.properties.after.name}}' },
        nextStepIds: [SCORE_NEW_COMPANIES.save],
      },
      {
        universalIdentifier: SCORE_NEW_COMPANIES.save,
        name: 'Save the score',
        type: 'UPDATE_RECORD',
        input: {
          objectUniversalIdentifier: COMPANY,
          objectRecordId: '{{trigger.recordId}}',
          objectRecord: { leadScore: `{{${SCORE_NEW_COMPANIES.score}.score}}` },
          fieldsToUpdate: ['leadScore'],
        },
        nextStepIds: [],
      },
    ],
  },
});

• يحتاج سير العمل والمشغّل وكل خطوة إلى universalIdentifier خاص بها. حافظ على استقرارها عبر الإصدارات: فهي الطريقة التي يطابق بها Twenty سير العمل المثبّت عند التثبيت التالي.
• يربط nextStepIds الرسم البياني. يشير المشغّل إلى الخطوات الأولى، وتشير كل خطوة إلى الخطوات التي تُنفَّذ بعدها.
• تقرأ الخطوة مخرجات سابقة باستخدام {{trigger.\<path>}} أو {{\<step universalIdentifier>.\<path>}}.
• يتحقق البناء من التعريف بالكامل: إذ تؤدي أنواع المشغّلات أو الخطوات غير المدعومة، وروابط الخطوات المعطّلة، والمراجع إلى خطوات غير معروفة إلى فشله.

​

الإشارة إلى كيانات أخرى

• الكائنات والحقول: الخاصة بتطبيقك، أو القياسية عبر STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS. يفترض المثال أعلاه أن التطبيق يعرّف أيضًا حقل رقم leadScore في الشركة باستخدام defineField(): إذ تفشل عملية التثبيت إذا كتبت خطوة سجل في حقل مفقود من مساحة العمل.
• دوال المنطق: الخاصة بتطبيقك، والمعروضة باعتبارها إجراء سير عمل باستخدام workflowActionTriggerSettings. يمكن لتطبيق Custom المخصص لمساحة العمل أيضًا الإشارة إلى إجراءات سير العمل الخاصة بالتطبيقات الأخرى المثبتة في مساحة العمل، تمامًا كما يمكن لسير العمل المنشأة في التطبيق ذلك.
• الوكلاء: الخاصة بتطبيقك، من defineAgent().

​

المشغلات

​

الخطوات

• تأخذ خطوات السجل objectUniversalIdentifier بدلًا من اسم كائن.
• تشير عوامل التصفية والفرز إلى الحقول باستخدام fieldMetadataUniversalIdentifier.
• تسمي حقول النموذج من النوع RECORD كائنها باستخدام settings.objectUniversalIdentifier. توفّر الحقول من النوعين SELECT وMULTI_SELECT خيارات حقل موجود من النوع نفسه، تمت تسميته باستخدام settings.selectedFieldUniversalIdentifier.
• لتشغيل التعليمات البرمجية الخاصة بك، استخدم خطوة LOGIC_FUNCTION. خطوة التعليمات البرمجية في المنشئ غير متاحة.
• لا تعمل خطوات البريد الإلكتروني والتقويم إلا إذا كان دور تطبيقك يتضمن علامة الإذن المطابقة: SystemPermissionFlag.SEND_EMAIL_TOOL لـ SEND_EMAIL وDRAFT_EMAIL، وSystemPermissionFlag.CREATE_CALENDAR_EVENT_TOOL لـ CREATE_CALENDAR_EVENT. تمنحها مساحة العمل عند تثبيت التطبيق، ويمكن للخطوة بعد ذلك استخدام أي حساب متصل في مساحة العمل، مثل سير عمل تم إنشاؤه في التطبيق.
• معرّفات الحسابات المتصلة محلية لكل مساحة عمل، لذا لا تضمّن أحدها بصورة ثابتة. مرّر الحساب كمتغير. تتطلب خطوات البريد الإلكتروني أيضًا معرّف عضو مساحة العمل، مثل {{trigger.properties.after.assigneeId}}، والذي يُحل إلى أول حساب لذلك العضو قادر على الإرسال.

​

بعد التثبيت

• يصبح سير العمل نشطًا بمجرد تثبيت التطبيق، وتظهر عمليات تشغيله مع عمليات تشغيل سير العمل الأخرى في مساحة العمل.
• يؤدي تثبيت إصدار جديد من التطبيق إلى تحديث سير العمل في مكانه.
• لا يمكن للمستخدمين تعديل سير عمل مثبّت. لتخصيص أحدها، ينسخونه: وتكون النسخة ملكًا لهم لتعديلها.