بنية سير العمل
- المحفّز: وفق جدول زمني
- Code: الاستعلام عن مستودع البيانات لديك
- Code (اختياري): تنسيق البيانات كمصفوفة
- Iterator: التكرار عبر كل منتج
- Upsert Record: أنشئ أو حدّث في Twenty

الخطوة 1: جدولة المُحفّز
اضبط سير العمل ليعمل بتواتر يتوافق مع احتياجاتك من حداثة البيانات:- كل 5 دقائق لمزامنة شبه فورية
- كل ساعة للبيانات الأقل أهمية
- يوميًا للتحديثات الدفعية
الخطوة 2: الاستعلام عن مستودع البيانات لديك
أضِف إجراء Code لجلب البيانات الحديثة:الخطوة 3: تنسيق البيانات (اختياري)
إذا كان مستودعك يُرجع البيانات بتنسيق يحتاج إلى تحويل، فأضف إجراء Code آخر. تشمل التحويلات الشائعة تحويل الأنواع، وإعادة تسمية الحقول، وتنظيف البيانات.مثال: بيانات المستخدم مع حقول منطقية وحقول الحالة
مثال: بيانات المنتج مع تحويلات الأنواع
مثال: تنسيق التاريخ والعملة
التحويلات الشائعة
| تنسيق المصدر | تنسيق الهدف | كود |
|---|---|---|
"true" / "false" | true / false | v === true || v === "true" |
"123.45" | 123.45 | parseFloat(value) |
"active" | "ACTIVE" | value.toUpperCase() |
1704067200 (Unix) | تاريخ ISO | new Date(v * 1000).toISOString() |
"$1,234.56" | 1234.56 | parseFloat(v.replace(/[^0-9.-]/g, "")) |
null / undefined | "" | value || "" |
الخطوة 4: التكرار عبر المنتجات
أضِف إجراء Iterator:- المدخل:
{{code.products}}
الخطوة 5: إجراء Upsert لكل سجل
داخل المُكرِّر، أضف إجراء Upsert Record:| الإعداد | القيمة |
|---|---|
| الكائن | كائن المنتج المخصص لديك |
| المطابقة حسب | المعرّف الخارجي أو SKU (مُعرّف فريد) |
| الاسم | {{iterator.item.name}} |
| SKU | {{iterator.item.sku}} |
| السعر | {{iterator.item.price}} |
أمثلة لحالات الاستخدام
| المصدر | بيانات |
|---|---|
| نظام تخطيط موارد المؤسسة (ERP) | كتالوج المنتجات، التسعير، المخزون |
| منصة التجارة الإلكترونية | الطلبات، العملاء، تحديثات المنتجات |
| مستودع البيانات | مقاييس مجمّعة، بيانات مُثرَاة |
| نظام إدارة المخزون | مستويات المخزون، تنبيهات إعادة الطلب |