دليل Definition Builder

ما هو الـ Definition؟

الـ Definition هو فحص جودة البيانات الذي أعددته في DQS. يحدّد أي كائن Salesforce يُحلَّل، وأي حقول تُشمل، وأي قدرات تُقاس، وأي عتبات تُطبَّق.

فكّر في الـ Definition كوصفة طهي. تخبر DQS بأي مكوّنات (حقول) يفحص وبأي معايير (عتبات) يطبّق. ويتّبع DQS وصفتك في كل مرة تُجري فيها فحصًا.

معالج الخطوات الخمس

يرشدك Definition Builder عبر خمس خطوات:

1. اختيار القدرات - اختر ما تريد قياسه
2. تحديد النطاق - اختر أي كائن وحقول
3. إضافة المرشّحات - ضيّق مجموعة السجلات (اختياري)
4. الإعداد - اضبط العتبات والخيارات
5. المراجعة - تحقّق وفعّل

تبني كل خطوة على سابقتها. يمكنك حفظ تقدّمك في أي خطوة والعودة لاحقًا.

الخطوة 1: اختيار القدرات

في هذه الخطوة، تختار أبعاد جودة البيانات التي تريد قياسها.

القدرات المتاحة

يعرض المعالج لوحتين:

جودة البيانات (النظافة التشغيلية)

• Completeness - هل الحقول معبّأة؟
• Validity - هل تطابق القيم الصيغ المتوقّعة؟
• Uniqueness - هل السجلات متمايزة؟
• Timeliness - هل البيانات حديثة؟
• Consistency - هل القيم موحّدة؟

الجاهزية للذكاء الاصطناعي (التحضير لـ Agentforce)

• PII Detection - هل البيانات الحساسة محمية قبل انكشافها للذكاء الاصطناعي؟

اختيار القدرات

1. انقر بطاقة قدرة لاختيارها
2. تُبرَز البطاقة وتظهر علامة اختيار
3. اختر عدّة قدرات لتحليل شامل
4. انقر مرة أخرى لإلغاء الاختيار

نصيحة: ابدأ بقدرتين إلى ثلاث في أول Definition لك. يمكنك إضافة المزيد لاحقًا.

أفضل ممارسة: ابدأ مركّزًا

اختر القدرات بناءً على هدفك المباشر:

انقر Continue عندما تنتهي من اختيار القدرات.

الخطوة 2: تحديد النطاق

في هذه الخطوة، تختار أي كائن Salesforce وحقول تريد تحليلها.

اختيار كائن

1. استخدم قائمة منسدلة لمنتقي الكائنات
2. ابحث باسم الكائن أو API name
3. انقر لاختيار الكائن

يدعم DQS الكائنات القياسية والمخصّصة. يعرض المعالج تسمية الكائن و API name لمساعدتك في اختيار الكائن الصحيح.

نصيحة: ابدأ بكائن عالي القيمة مثل Contact أو Lead أو Account. عادةً ما يكون لهذه الكائنات أكبر أثر على جودة البيانات.

اختيار الحقول

بعد اختيار كائن، يعرض المعالج الحقول المتاحة.

1. تُجمَّع الحقول حسب النوع (نص، رقم، تاريخ، إلخ)
2. انقر صفّ حقل لاختياره
3. استخدم مربّع البحث للعثور على حقول محدّدة
4. اختر عدّة حقول للتحليل

يُظهر المعالج أي القدرات تنطبق على كل حقل بناءً على نوع الحقل:

الإعداد لكل حقل

يمكنك ضبط عتبات مختلفة لكل حقل على حدة. هذا مفيد عندما:

• تحتاج الحقول الحرجة إلى عتبات أكثر صرامة
• لبعض الحقول متطلبات صيغة فريدة
• لحقول مختلفة توقعات حداثة مختلفة

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

انقر Continue عندما تنتهي من اختيار الحقول.

الخطوة 3: إضافة المرشّحات (اختياري)

تضيّق المرشّحات مجموعة السجلات التي يحلّلها DQS. هذه الخطوة اختيارية لكنها مفيدة لمجموعات البيانات الكبيرة أو حالات الاستخدام المحدّدة.

متى تستخدم المرشّحات

بناء مرشّح

1. انقر Add Condition
2. اختر حقلًا من القائمة المنسدلة
3. اختر عاملًا (equals، contains، greater than، إلخ)
4. أدخل قيمة
5. كرّر لإضافة شروط أخرى

منطق المرشّحات

استخدم منطق AND/OR لدمج الشروط:

• AND - يجب أن تتحقّق كل الشروط
• OR - يكفي أن يتحقّق أي شرط

مثال: (Status = 'Active') AND (Industry = 'Technology' OR Industry = 'Finance')

معاينة عدد السجلات

يُظهر المعالج عدد السجلات التي تطابق مرشّحك. استخدم هذا للتحقّق من أن مرشّحك يعمل كما هو متوقّع.

• العدد 0 يعني عدم وجود سجلات مطابقة (راجع مرشّحك)
• العدد المرتفع جدًا قد يحتاج إلى مزيد من الترشيح في المؤسسات الكبيرة

نصيحة: تخطَّ المرشّحات في أول Definition لك للحصول على صورة كاملة. أضِف المرشّحات لاحقًا للتحليل المستهدف.

انقر Continue للمتابعة (أو تخطَّ هذه الخطوة).

الخطوة 4: الإعداد

في هذه الخطوة، تضبط العتبات والخيارات لكل قدرة مختارة.

الإعدادات العالمية مقابل الإعدادات لكل حقل

تنطبق الإعدادات على مستويين:

1. عالمي (Global) - إعدادات افتراضية لجميع الحقول
2. لكل حقل (Per-Field) - تجاوز الإعدادات لحقول محدّدة

أعِدّ الإعدادات العالمية أولًا، ثم خصّص الحقول الفردية إذا لزم الأمر.

إعداد Completeness

مثال على الإعدادات لـ Contact:

• Threshold: 90% للحقول الاختيارية
• Threshold: 99% للحقول المطلوبة مثل Email
• Placeholders: N/A، TBD، Unknown، -، .

إعداد Validity

الأنماط المدمجة:

• Email - صيغة متوافقة مع RFC 5322
• URL - صيغة HTTP/HTTPS
• Fixed Length - عدد أحرف دقيق

إعداد Uniqueness

إعداد Timeliness

مثال على الإعدادات حسب الحقل:

• LastModifiedDate: نافذة حداثة 30 يومًا
• LastActivityDate: نافذة 90 يومًا
• BirthDate: لا حاجة لفحص الحداثة

إعداد Consistency

إعداد PII Detection

مؤشّر تكلفة المعالجة

تُظهر كل قدرة تكلفة معالجة:

ضع التكلفة في الاعتبار عند اختيار القدرات لمجموعات البيانات الكبيرة.

انقر Continue عند اكتمال الإعداد.

الخطوة 5: المراجعة

تُظهر الخطوة الأخيرة ملخّصًا لـ Definition الخاص بك.

قائمة تحقّق المراجعة

تحقّق مما يلي قبل التفعيل:

1. Object - الكائن الصحيح مختار
2. Fields - جميع الحقول المهمّة مشمولة
3. Capabilities - الفحوصات المناسبة مختارة
4. Filters - عدد السجلات يبدو صحيحًا
5. Thresholds - الإعدادات تطابق متطلباتك

ملخّص الـ Definition

يعرض الملخّص:

• اسم الـ Definition (قابل للتحرير)
• الكائن المستهدف وعدد السجلات
• القدرات المختارة مع متغيّراتها
• عدد الحقول لكل قدرة
• تكلفة المعالجة المقدّرة

تسمية الـ Definition

استخدم أسماء وصفية تشير إلى:

• الكائن الذي يُحلَّل
• الغرض أو النطاق
• المالك (اختياري)

أسماء جيدة:

• “Contact Data Quality - Sales Team”
• “Lead AI Readiness Check”
• “Account Completeness - EMEA Region”

أسماء سيئة:

• “Definition 1”
• “Test”
• “My Definition”

الحفظ والتفعيل

لديك خياران:

1. Save as Draft - الحفظ دون تفعيل (قابل للتحرير لاحقًا)
2. Activate - الحفظ والتجهيز للفحص

يمكن تحرير Definitions المسوّدة. أما Definitions النشطة فمقفلة لكنها جاهزة للتشغيل.

مثال: بناء Contact Definition

لنستعرض إنشاء Contact Data Quality Definition.

الخطوة 1: اختيار القدرات

اختر:

• Completeness (التحقّق من البيانات المفقودة)
• Validity (التحقّق من صيغ البريد الإلكتروني والهاتف)
• Timeliness (العثور على سجلات Contact المتقادمة)

الخطوة 2: تحديد النطاق

Object: Contact

الحقول:

• Email (text، email)
• Phone (phone)
• MailingCity (text)
• MailingState (text)
• MailingCountry (text)
• Title (text)
• LastActivityDate (date)

الخطوة 3: إضافة المرشّحات

الشرط: AccountId != null (Contacts المرتبطة بـ Accounts فقط)

معاينة عدد السجلات: 15,234 سجلًا

الخطوة 4: الإعداد

Completeness:

• Threshold: 90%
• Treat blanks as incomplete: Yes
• Placeholders: N/A، Unknown، TBD

Validity:

• حقل Email: نمط Email
• حقل Phone: نمط Phone (إن توفّر)

Timeliness:

• LastActivityDate: نافذة حداثة 60 يومًا
• Grace period: 14 يومًا

الخطوة 5: المراجعة

الاسم: “Contact Data Quality - Active Accounts”

الملخّص:

• 7 حقول
• 3 قدرات
• 15,234 سجلًا
• التكلفة المقدّرة: LOW

انقر Activate للإكمال.

إدارة الـ Definitions

عرض جميع الـ Definitions

من الشاشة الرئيسية لـ DQS، ترى:

• جميع Definitions الخاصة بك
• الحالة (Draft، Active، Archived)
• تاريخ آخر فحص
• إجراءات سريعة

تحرير الـ Definitions

• Draft - قابل للتحرير بالكامل
• Active - أنشئ نسخة جديدة للتحرير
• Archived - للعرض فقط

أرشفة الـ Definitions

أرشِف Definitions التي لم تعد تحتاجها:

1. انقر القائمة المنسدلة
2. اختر Archive
3. أكّد

تبقى Definitions المؤرشَفة قابلة للعرض لكنها لا تستطيع التشغيل.

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

”No fields available”

السبب: القدرات المختارة لا تطابق أنواع الحقول المتاحة.

الحل: اختر قدرات مختلفة أو اختر كائنًا بأنواع حقول متوافقة.

”0 records match filter”

السبب: شروط المرشّح مقيِّدة أكثر من اللازم.

الحل: اضبط قيم المرشّح أو أزل الشروط.

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

• تشغيل عمليات الفحص: نفّذ الـ Definition الخاص بك
• فهم النتائج: فسّر مخرجات الفحص