تخطّ إلى المحتوى الرئيسي

الكيانات المخصصة

تعرّف على كيفية إنشاء كائنات بيانات مخصصة وإدارتها إلى جانب كيان المستخدمين المدمج.

ما هي الكيانات المخصصة؟​

تتيح لك الكيانات المخصصة، أو الكائنات المخصصة، تعريف أي نوع من البيانات المنظمة وتخزينه في Joryio. فكّر فيها كجداول قاعدة بيانات مخصصة تنشئها من واجهة المستخدم.

حالات استخدام شائعة:

  • المنتجات - كتالوجات المنتجات والأسعار وSKU والأوصاف
  • الطلبات - سجل الطلبات وبيانات الشراء
  • المخزون - مستويات المخزون وبيانات المستودعات
  • المحتوى - المقالات والفيديوهات وأنواع المحتوى الأخرى
  • المواقع - مواقع المتاجر أو المكاتب
  • الصفقات - فرص المبيعات
  • الاشتراكات - الخطط ودرجات الاشتراك

الإمكانات الرئيسية​

تعريف مرن للمخطط​

  • عرّف حقولاً مخصصة باستخدام أكثر من 18 نوعاً من الحقول.
  • اضبط قواعد التحقق لكل حقل.
  • أضف فهارس لتحسين أداء البحث.
  • تحكم في ظهور الحقول وترتيب عرضها.

عمليات CRUD كاملة​

  • أنشئ السجلات واقرأها وحدّثها واحذفها.
  • استورد البيانات بكميات كبيرة.
  • ابحث في السجلات وصفِّها.
  • صدّر البيانات.

إمكانات متقدمة​

  • سجل التدقيق - تتبّع جميع التغييرات على السجلات.
  • الإصدارات - احتفِظ بتاريخ تعديلات السجل.
  • الحذف الناعم - علِّم السجل كمحذوف بدلاً من إزالته.
  • العلاقات - اربط الكيانات ببعضها (ميزة قادمة).

البدء​

إنشاء كيانك الأول​

  1. من القائمة الرئيسية، انتقل إلى الكيانات.
  2. انقر إنشاء كيان.
  3. اضبط الإعدادات الأساسية:
    • الاسم الظاهر، مثل Products.
    • الاسم الداخلي، مثل products - أحرف صغيرة وشرطات سفلية فقط.
    • الوصف.
    • حقل العرض: الحقل الذي يظهر في القوائم.
  4. أضف الحقول لبنية بياناتك.
  5. اضبط الإعدادات الاختيارية.
  6. انقر إنشاء.

مثال: كيان المنتجات​

أنشئ كيان Products لتخزين كتالوج المنتجات:

إعدادات الكيان:

  • الاسم الظاهر: Products
  • الاسم الداخلي: products
  • حقل العرض: name
  • الوصف: Product catalog with pricing and inventory

الحقول:

  1. SKU (String)
    • مطلوب: نعم
    • فريد: نعم
    • مفهرس: نعم
  2. الاسم (String)
    • مطلوب: نعم
    • الحد الأقصى للطول: 255
  3. الوصف (Markdown)
    • مطلوب: لا
  4. السعر (Currency)
    • مطلوب: نعم
    • الحد الأدنى: 0
  5. كمية المخزون (Integer)
    • مطلوب: نعم
    • الحد الأدنى: 0
  6. رابط الصورة (Image URL)
    • مطلوب: لا
  7. الفئة (String)
    • مفهرس: نعم
  8. نشط (Boolean)
    • القيمة الافتراضية: true

أنواع الحقول​

يدعم Joryio أكثر من 18 نوعاً من الحقول.

أنواع النص​

  • String - نص قصير، مثل الأسماء والعناوين
  • Email - عناوين بريد إلكتروني مع تحقق
  • Phone - أرقام هواتف
  • URL - عناوين ويب مع تحقق
  • Markdown - نص منسق يدعم Markdown
  • HTML - محتوى HTML خام
  • JSON - بيانات JSON منظمة

الأنواع الرقمية​

  • Number - أرقام عشرية
  • Integer - أرقام صحيحة فقط
  • Currency - قيم مالية بدقة عشرية
  • Percentage - قيم مئوية

أنواع التاريخ والوقت​

  • Date - تاريخ فقط، من دون وقت
  • DateTime - تاريخ ووقت

أنواع أخرى​

  • Boolean - قيم صحيح/خطأ
  • Image URL - روابط صور، مع معاينة مصغّرة
  • File URL - روابط ملفات

أنواع قادمة​

  • Reference - رابط إلى كيان آخر
  • Array - قيم متعددة

التحقق من الحقول​

اضبط قواعد التحقق لكل حقل.

قواعد تحقق شائعة​

  • Required - يجب أن يحتوي الحقل على قيمة.
  • Unique - لا تُسمح بقيم مكررة.
  • Min/Max - للأرقام، مثل price >= 0.
  • Min/Max Length - للنصوص، مثل SKU بين 5 و20 حرفاً.
  • Pattern - تحقق باستخدام تعبير نمطي.
  • Enum - حصر القيم في مجموعة محددة.

أمثلة​

حقل البريد الإلكتروني:

Type: Email
Required: Yes
Validation: Email format automatically validated

حقل السعر:

Type: Currency
Required: Yes
Min: 0
Max: 999999

حقل SKU:

Type: String
Required: Yes
Unique: Yes
Min Length: 5
Max Length: 20
Indexed: Yes

إدارة السجلات​

إضافة سجلات​

  1. افتح الكيان من قائمة الكيانات.
  2. انقر إضافة سجل.
  3. املأ النموذج الذي يُنشأ تلقائياً من مخططك.
  4. انقر إنشاء.

يتكيف النموذج تلقائياً مع أنواع حقولك:

  • حقول النص ← إدخالات نصية
  • الحقول الرقمية ← إدخالات رقمية
  • حقول التاريخ ← منتقيات تاريخ
  • حقول Boolean ← مربعات اختيار
  • وغير ذلك

عرض السجلات​

تظهر السجلات في جدول ديناميكي يضم عموداً لكل حقل:

  • رتّب حسب أي عمود.
  • ابحث في جميع الحقول.
  • تنقّل بين مجموعات البيانات الكبيرة بالصفحات.
  • شاهد عرضاً مناسباً لنوع الحقل، مثل التواريخ والعملات والصور.

تعديل السجلات​

  1. انقر أيقونة التعديل في السجل.
  2. عدّل الحقول.
  3. انقر تحديث.

تُتبع كل التغييرات عند تفعيل سجل التدقيق.

حذف السجلات​

  1. انقر أيقونة الحذف في السجل.
  2. أكّد الحذف.

عند تفعيل الحذف الناعم، يُعلَّم السجل كمحذوف من دون إزالته من قاعدة البيانات.

سجل التغييرات​

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

إعدادات الكيان​

سجل التدقيق​

عند تفعيله، يتتبع Joryio:

  • من أنشأ أو عدّل كل سجل.
  • ما الذي تغير.
  • وقت حدوث التغيير.

يمكن الوصول إلى سجلات التدقيق عبر API أو واجهة الإدارة.

الإصدارات​

احتفظ بتاريخ كامل لتغييرات السجل:

  • ارجع إلى إصدار سابق.
  • قارن بين الإصدارات.
  • تتبّع تطور البيانات مع مرور الوقت.

الحذف الناعم​

بدلاً من حذف السجلات نهائياً:

  • علّمها كمحذوفة باستخدام علامة.
  • احتفِظ بالبيانات لأغراض الامتثال.
  • استعد السجلات المحذوفة عند الحاجة.

السماح بالتكرارات​

يمنع النظام تكرار السجلات افتراضياً. عطّل هذا المنع للسماح بـ:

  • سجلات متعددة بالقيم نفسها.
  • سجلات الأحداث أو المعاملات مثلاً.

البحث والتصفية​

البحث​

ابحث في جميع الحقول المفهرسة:

  • بحث نصي كامل.
  • غير حساس لحالة الأحرف.
  • يدعم المطابقات الجزئية.

عوامل تصفية التحديد​

تُصفّي التحديدات السجلات بشروط لكل حقل: يساوي/لا يساوي، أكبر/أصغر من (أو يساوي)، يحتوي، موجود، وزوج القيم المتعددة واحد من / ليس واحداً من. أدخل قيماً متعددة مفصولة بفواصل، مثل ER, ICU, NICU، ويطابق السجل إذا ساوى حقله أياً منها. تتطابق القيم الرقمية سواء خُزِّنت كرقم أو كنص. يمكنك دمج الشروط باستخدام AND/OR.

عوامل التصفية عبر API​

طبّق عوامل تصفية معقدة عبر API:

{
  filter: {
    price: { $gte: 10, $lte: 100 },
    category: "Electronics",
    active: true
  },
  sort: { price: -1 },
  limit: 20
}

أداء التحديدات وتوصيات الفهارس​

تتضمن شاشة التحديدات لوحة أداء تعرض أكثر تحديداتك استخداماً وتقترح فهارس قاعدة بيانات لتسريع التحديدات التي تشغّلها كثيراً. تحمل كل توصية أولوية، ويطبّق زر إنشاء الفهارس المقترحة هذه الفهارس لتُحل التحديدات المتكررة بسرعة أكبر.

نصائح للأداء​

الفهرسة​

أضف فهارس للحقول التي تستخدمها كثيراً في:

  • البحث
  • التصفية
  • الترتيب

مثال: إذا كنت تبحث كثيراً باستخدام SKU أو تصفّي حسب الفئة، ففهرس هذين الحقلين.

ترتيب الحقول​

اضبط displayOrder للتحكم في:

  • ترتيب الحقول في النموذج.
  • ترتيب الأعمدة في الجدول.
  • تحسين تجربة المستخدم.

الحقول المخفية​

علِّم الحقول كمخفية عندما تكون:

  • داخلية فقط.
  • غير مطلوبة في العروض الافتراضية.
  • بيانات وصفية تقنية.

حالات الاستخدام​

التجارة الإلكترونية​

الكيانات:

  • المنتجات: SKU والاسم والسعر والصور
  • الطلبات: معرّف الطلب والعناصر والإجمالي والحالة
  • المخزون: المستودع والكمية والموقع
  • الفئات: الاسم والوصف والأصل

سير العمل:

  • استورد كتالوج المنتجات.
  • شغّل حملات عند انخفاض المخزون.
  • أرسل تأكيدات الطلبات.
  • خصص توصيات المنتجات.

إدارة المحتوى​

الكيانات:

  • المقالات: العنوان والمحتوى والكاتب والوسوم
  • الفيديوهات: العنوان وURL والمدة والفئة
  • الكتّاب: الاسم والنبذة والصورة

سير العمل:

  • خزّن مكتبة المحتوى.
  • أشر إلى المحتوى في حملات البريد الإلكتروني.
  • خصص توصيات المحتوى.
  • تتبع أداء المحتوى.

منصة SaaS​

الكيانات:

  • الاشتراكات: الخطة والسعر والميزات
  • الميزات: الاسم والوصف والدرجة
  • مقاييس الاستخدام: المقياس والقيمة والفترة

سير العمل:

  • تتبع حالة الاشتراك.
  • شغّل حملات ترقية.
  • راقب استخدام الميزات.
  • احسب الفوترة.

التكامل​

مع الحملات​

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

الحصول على جميع سجلات كيان:

{% assign products = 'products' | catalog %}

{% for product in products %}
  <h3>{{ product.name }}</h3>
  <p>Price: ${{ product.price }}</p>
  <img src="{{ product.image_url }}" />
{% endfor %}

الحصول على سجلات باستخدام تحديد معد مسبقاً، مع التصفية والترتيب:

{% assign featuredProducts = 'products' | catalog: 'featured_items' %}

{% for product in featuredProducts %}
  <h3>{{ product.name }}</h3>
  <p>Price: ${{ product.price }}</p>
{% endfor %}

ملاحظات:

  • من دون تحديد: يعيد حتى 50 سجلاً.
  • مع تحديد: يستخدم عوامل التصفية والترتيب والحد المضبوطة للتحديد.
  • يجب أن تتطابق أسماء الكيان والتحديد تماماً مع تعريفها في مساحة العمل.

مع Canvas، أداة بناء الرحلات​

استخدم بيانات الكيان من أجل:

  • تشغيل الرحلات.
  • إنشاء تفرعات بناءً على القيم.
  • تخصيص الرسائل.
  • تتبع التحويلات.

مع الشرائح​

قسّم المستخدمين بناءً على علاقات الكيانات:

  • المستخدمون الذين اشتروا منتجات محددة.
  • المستخدمون ذوو الاشتراكات النشطة.
  • المستخدمون في مواقع محددة.

الوصول عبر API​

يوفر النظام REST API كاملاً للوصول البرمجي:

// List entities
GET /api/entities

// Create entity
POST /api/entities
{
  "name": "products",
  "displayName": "Products",
  "fields": [...]
}

// List records
GET /api/entities/:entityId/records

// Create record
POST /api/entities/:entityId/records
{
  "sku": "PROD-001",
  "name": "Widget",
  "price": 29.99
}

راجع مرجع API للكيانات للتوثيق الكامل.

أفضل الممارسات​

تصميم المخطط​

  1. ابدأ ببساطة - أضف الحقول عند الحاجة.
  2. استخدم أسماء واضحة - اجعل أسماء الحقول مفهومة ووصفية.
  3. استخدم الفهارس بذكاء - فهرس فقط الحقول التي ستبحث أو تصفّي بها.
  4. تحقق من البيانات - اضبط قواعد تحقق مناسبة.
  5. وثّق الغرض - استخدم الأوصاف للحقول المعقدة.

جودة البيانات​

  1. افرض التفرد حيث يناسب، مثل SKU وعناوين البريد الإلكتروني.
  2. اجعل الحقول الحاسمة مطلوبة - لا تجعل كل شيء اختيارياً.
  3. اضبط قيماً افتراضية منطقية لتسهيل إدخال البيانات.
  4. تحقق من التنسيقات باستخدام أنواع الحقول المناسبة.
  5. نظّف بانتظام وأزل السجلات القديمة.

الأداء​

  1. حد من عدد السجلات - أرشف البيانات القديمة.
  2. استخدم الصفحات - لا تحمّل جميع السجلات دفعة واحدة.
  3. فهرس بشكل استراتيجي ووازن سرعة الاستعلام مع التخزين.
  4. استخدم التخزين المؤقت عند الإمكان للبيانات كثيرة الاستخدام.

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

لا يمكن إنشاء كيان​

  • تحقق من تنسيق الاسم الداخلي: أحرف صغيرة وشرطات سفلية فقط.
  • تأكد أن الاسم غير مستخدم مسبقاً.
  • تأكد من امتلاكك الصلاحية.

السجلات لا تظهر​

  • تحقق من عوامل التصفية وعبارات البحث.
  • تحقق من مساحة العمل المختارة.
  • تحقق من حالة الحذف الناعم.

استعلامات بطيئة​

  • أضف فهارس إلى الحقول المستخدمة في التصفية.
  • قلل حجم مجموعة النتائج.
  • حسّن استعلامات التصفية.

الخطوات التالية​

ميزات ذات صلة​