إضافة Business Central لإعداد RapidStart CRM

الخطوات الرئيسية

1. إنشاء أو استخدام بيئة موجودة مفعلة بـ Dataverse.
2. تثبيت RapidStart CRM من AppSource على البيئة المفعلة بـ Dataverse.
3. الحصول على معرف نظام شركة Business Central.
4. تكوين التكامل من داخل Business Central.
5. التحقق من دور مستخدم تطبيق تكامل Business Central
6. إعداد تعيين السجلات
7. ربط البيئات (اختياري)
8. تثبيت الإضافة الخاصة بـ Business Central لـ RapidStart CRM من AppSource على البيئة المفعلة بـ Dataverse.
9. إكمال في تطبيق إعدادات RapidStart

قبل أن تبدأ

تأكد من هذه المتطلبات قبل بدء إعداد إضافة Business Central:

• يجب أن يكون Business Central و Dataverse في نفس مستأجر Microsoft Entra لجداول Business Central الافتراضية.
• استخدام مسؤول إعداد بشري لديه الأذونات المطلوبة لـ Business Central ووصول مسؤول نظام Dataverse أثناء الإعداد.
• تأكد من تثبيت RapidStart CRM في بيئة Dataverse التي تخطط للاتصال بها.

الخطوة 3: الحصول على معرف الشركة

للحصول على معرف شركتك، ابحث عن الشركات في Business Central. حدد الشركة المستهدفة واضغط على Ctrl+Alt+F1 لفتح فحص الصفحة. انسخ المعرف المعروض واحفظه للاستخدام لاحقًا.

الخطوة 4: تكوين التكامل من داخل Business Central

قم بتسجيل الدخول إلى بيئة Business Central التي تريد الاتصال بها.

لاحظ اسم بيئة Business Central في شريط العنوان. قد يظهر عنوان URL أيضًا اسم عرض الشركة، لكنك قد قمت بالفعل بالتقاط معرف نظام الشركة GUID في الخطوة السابقة.

انسخ اسم بيئة Business Central إلى نفس الملاحظات حيث حفظت معرف نظام الشركة GUID.

1. انقر على الترس
2. حدد “إعداد مساعد”

قم بالتمرير لأسفل إلى قسم “الاتصال بأنظمة أخرى” وانقر على “إعداد اتصال بـ Dataverse”.

1. حدد لتمكين مزامنة البيانات
2. حدد لتمكين الجداول الافتراضية والأحداث
3. انقر “التالي”

اقبل الشروط وانقر “التالي”

اقبل الاتصال بـ Dataverse “السماح دائمًا”، وانقر موافق

حدد البيئة المفعلة بـ Dataverse المستهدفة، وانقر “موافق”

تأكد من صحة البيئة، ثم انقر على الرابط لتسجيل الدخول إلى بيئة Dataverse. بعد تسجيل الدخول انقر “التالي”

حدد ملكية الفريق الموصى بها، وقم بالتبديل إلى الإكمال بدون مزامنة (سنقوم بذلك لاحقًا) وانقر “التالي”

1. انقر على الرابط لتثبيت تطبيق جدول الأعمال الافتراضي لـ Business Central
2. انقر “التالي” (سيفتح تبويب جديد لـ AppSource)

انقر على زر “الحصول عليه الآن” (هذه الإضافة مجانية)، وستفتح الصفحة التالية:

1. حدد البيئة المستهدفة (حيث قمت بتثبيت RapidStart CRM).
2. وافق على الشروط.
3. انقر “تثبيت”.

سترى أن الحل “قيد التثبيت”. قد يستغرق الأمر عدة دقائق لإكماله. انقر “تحديث” من حين لآخر حتى ترى أنه “مثبت”، ثم عد إلى تبويب متصفح Business Central للمتابعة.

انقر “تحديث”

سترى أن تطبيق الجداول الافتراضية قد تم تثبيته بنجاح. انقر “إنهاء”

بعد بضع دقائق ستظهر هذه الصفحة. حدد تبويب الجداول الافتراضية ثم “الجداول الافتراضية المتاحة”

1. ابدأ بتحديد سطر “العنصر”
2. انقر “تمكين” (سيؤدي ذلك إلى إنشاء الجدول الافتراضي في Dataverse للعناصر)
3. انتظر حتى ترى مربع “مرئي” محدد. قد تحتاج إلى التحديث عدة مرات.

كرر هذه الخطوات لـ: salesInvoice، salesInvoiceLine، salesOrder، salesOrderLine، salesQuote، salesQuoteLine، salesShipment، و salesShipmentLine. سيستغرق الأمر عدة دقائق لكل واحد لتمكينه.

قم بتغيير الترتيب حسب مرئي/تنازلي، وتأكد من رؤية جميع هذه الجداول. لا تضف المزيد من الجداول الافتراضية في هذا الوقت. يمكنك ترك الشاشة كما هي (سنعود إليها) وفتح تبويب جديد.

الخطوة 5: التحقق من مستخدم تطبيق تكامل Business Central

إذا ظهرت أذونات مزامنة Business Central-Dataverse تالفة، افتح إعداد اتصال Dataverse في Business Central واستخدم إعادة نشر حل التكامل. هذا يعيد حل التكامل من Microsoft وينشر دور أمان تكامل Business Central.

تابع فقط بعد نجاح اختبار الاتصال وحصول مستخدم تطبيق تكامل Business Central على دور تكامل Dataverse لـ Business Central من Microsoft.

الخطوة 6: إعداد تعيين السجلات والربط

تعيينات المرجع لتكوينها قبل العميل

• العملة: عملة Business Central → عملة المعاملة في Dataverse. يجب أن يكون الاتجاه من Business Central إلى Dataverse. تأكد من تمكين تعيينات الحقول التالية: الرمز → رمز العملة، الرمز → رمز العملة، والوصف → اسم العملة.
• تأكد من أن تعيين العميل يحتوي على رمز العملة → العملة. قم بمزامنة العملات قبل العملاء. يجب أن تتفق العملة الأساسية لـ Dataverse والعملة المحلية لـ Business Central، ويجب أن توجد أسعار الصرف المطلوبة.
• شروط الدفع: قم بمزامنتها مع شروط دفع الحساب قبل اختبار العميل.
• طريقة الشحن: قم بمزامنتها مع شروط شحن الحساب قبل اختبار العميل.
• وكيل الشحن: قم بمزامنتها مع طريقة شحن الحساب قبل اختبار العميل.

سياسة إنشاء العملاء

قم بتعيين العميل إلى ثنائي الاتجاه إذا كان يمكن إنشاء الحسابات/الشركات على أي من الجانبين. ثم اختر سياسة مزامنة السجلات المرتبطة فقط كقرار نشر العميل:

الإنشاء والاقتران التلقائي للعملاء

1. إذا اختار العميل الإنشاء التلقائي الأصلي، قم بضبط CUSTOMER على Bidirectional و Sync. Only Coupled Records على إيقاف. احتفظ بـ Sync New Account to BC مغلقًا.
2. اترك Disable Event-driven Synch. Job Rescheduling غير محدد.
3. تأكد من أن الفلتر في جدول تكامل CUSTOMER يحتوي على Company System ID المحدد. قم بتضمين 00000000-0000-0000-0000-000000000000 فقط عندما يتم دعم صفوف Dataverse القديمة أو غير المعينة عن عمد.
4. تأكد من وجود مهمة مزامنة التكامل CUSTOMER وأن الفاصل الزمني لها يلبي احتياجات العميل. يعتبر On Hold with Inactivity Timeout حالة متوقعة بين عمليات التشغيل؛ فاصل زمني 30 دقيقة ليس في الوقت الفعلي.
5. قبل المزامنة العامة، قم بربط السجلات الموجودة بالفعل على كلا الجانبين يدويًا، أو راجع معايير ونتائج الاقتران المستند إلى التطابق بعناية. لا يحدد الإنشاء التلقائي كل زوج موجود بأمان.

يستخدم الاقتران GUID التكامل، وليس رقم العميل Business Central. الرقم مفيد للعرض والبحث؛ لعرضه في Dataverse، تحقق من تعيين حقل CUSTOMER من Business Central رقم. إلى Dataverse رقم الحساب..

التحقق من صحة قيم الخيارات

يجب أن تتطابق معرفات قيم التعداد في Business Central المستخدمة لشروط الدفع، طريقة الشحن، ووكيل الشحن مع معرفات الخيارات المقابلة في Dataverse. النص المعروض أو تسمية الرمز وحدها ليست كافية. لا تصلح المزامنة الكاملة عدم تطابق المعرف عندما يحتوي Business Central على قيم تعداد مخصصة غير موجودة في Dataverse.

1. قم بتشغيل مزامنة السجلات المعدلة لشروط الدفع، طريقة الشحن، ووكيل الشحن.
2. افحص تعيين خيارات Dataverse وسجل أخطاء المزامنة قبل اختبار العميل.
3. إذا لم تكن المعرفات متوافقة، استخدم الافتراضي الآمن على تعيينات حقل العميل: رمز شروط الدفع → شروط الدفع = FromIntegrationTable; رمز طريقة الشحن → العنوان 1: شروط الشحن = FromIntegrationTable; رمز وكيل الشحن → العنوان 1: طريقة الشحن = FromIntegrationTable.
4. قم بتغيير تلك الحقول الثلاثة إلى ثنائي الاتجاه فقط بعد أن يضيف المطور معرفات الخيارات المطابقة على كلا الجانبين.
5. لا تخترع أو تعيد ترقيم معرفات الخيارات أثناء الإعداد. يجب أن تستخدم القيم المخصصة في Dataverse وامتدادات التعداد في Business Central نفس المعرفات بالضبط.

بالنسبة لتعيينات الحقول CUSTOMER هذه، يعني FromIntegrationTable Dataverse → Business Central فقط. يحافظ هذا على إنشاء الحساب/العميل ثنائي الاتجاه مع منع معرفات الخيار Business Central غير المتطابقة من حجب Business Central → Dataverse الإنشاء.

عد إلى تبويب Business Central في متصفحك الذي تركناه مفتوحًا.

1. انقر على تبويب “التكامل”
2. ثم “تعيينات جدول التكامل”

قرار العميل: الاحتفاظ بـ مندوبو المبيعات إذا كان العميل يريد مزامنة مستخدم Dataverse القياسية إلى مندوب مبيعات Business Central من Microsoft. احذف أو قم بتعطيل هذا التعيين فقط عندما لا يتم استخدام تلك المزامنة القياسية عن قصد.

1. حدد الاتصال
2. حدد الربط
3. ثم انقر “الربط القائم على المطابقة”.
4. قم بمطابقة ما سبق وانقر موافق

1. حدد العملة
2. حدد الربط
3. ثم انقر “الربط القائم على المطابقة”.
4. قم بمطابقة ما سبق وانقر موافق

بالنسبة لـ CUSTOMER، اختر تعيين/حقول، ثم تحرير القائمة. قم بتفعيل التعيين من Business Central رقم. إلى Dataverse رقم الحساب. إذا كان يجب أن يظهر رقم العميل في حساب Dataverse. هذا لا يستبدل اقتران التكامل-GUID.

لا يزال بالنسبة للعميل، حدد الربط/الربط القائم على المطابقة. قم بالمطابقة باستخدام حقول معرف العميل/الحساب الموضحة في لقطة الشاشة، وتأكد من أن الحقول المطابقة تحدد نفس العميل بشكل فريد على كلا الجانبين.

بالنسبة لشروط الدفع، حدد الربط/الربط القائم على المطابقة. قم بمطابقة سجلات شروط الدفع في Business Central مع قيم خيارات شروط الدفع المقابلة في Dataverse بواسطة المعرفات المكونة.

بالنسبة لطريقة الشحن، حدد الربط/الربط القائم على المطابقة. قم بمطابقة طرق الشحن في Business Central مع قيم خيارات شروط الشحن المقابلة في Dataverse بواسطة المعرفات المكونة.

بالنسبة لوكيل الشحن، حدد الربط/الربط القائم على المطابقة. قم بمطابقة وكلاء الشحن في Business Central مع قيم خيارات طريقة الشحن المقابلة في Dataverse بواسطة المعرفات المكونة.

بالنسبة للمورد حدد تعيين/الحقول
1. حدد “تحرير القائمة”
2. و “تمكين” رقم الحساب.

لا يزال بالنسبة للمورد، حدد الربط/الربط القائم على المطابقة. قم بالمطابقة باستخدام حقول معرف المورد/الحساب الموضحة في لقطة الشاشة، وتأكد من أن الحقول المطابقة تحدد نفس المورد بشكل فريد على كلا الجانبين.

الخطوة 7: ربط البيئات (اختياري)

لمنع شخص ما من حذف البيئات عن طريق الخطأ، يمكنك ربطها. ابدأ مرة أخرى في Business Central.

1. حدد رمز التروس
2. ثم حدد مركز الإدارة

حدد رابط البيئة المستهدفة

انقر على “ربط” وحدد بيئة Dataverse الخاصة بك

الخطوة 8: تثبيت الإضافة الخاصة بـ Business Central لـ RapidStart CRM من AppSource

انقر هذا الرابط لفتح AppSource من Microsoft وتأكد من أنك مسجل الدخول بحساب عملك.

حدد “الحصول عليه الآن” لبدء التثبيت.

1. حدد البيئة التي قمت بتثبيت حل الجداول الافتراضية فيها.
2. وافق على الشروط.
3. انقر تثبيت. لاحظ أن التثبيت قد يستغرق عدة دقائق.

سترى أن الحل “قيد التثبيت”. قد يستغرق الأمر عدة دقائق لإكماله. انقر “تحديث” من حين لآخر حتى ترى أنه “مثبت”.

الخطوة 9: الإكمال في تطبيق إعدادات RapidStart

انتقل إلى RapidStart CRM وحدد تطبيق إعدادات RapidStart.

يمكنك فتح تطبيق إعدادات RapidStart من منتقي التطبيقات في RapidStart CRM، أو من بوابة الصانع:
1. حدد التطبيقات في الشريط الجانبي.
2. انقر على أيقونة التشغيل لتطبيق إعدادات RapidStart.

1. تأكد من أنك في تطبيق إعدادات RapidStart.
2. حدد “التطبيقات والإضافات” في الشريط الجانبي.
3. انقر “تكوين” لإضافة Business Central.

افتح Connections أولاً. لا تظهر AppSource مطالبة تعيين الاتصال المستخدمة أثناء استيراد الحل اليدوي. يقوم المعالج بالإبلاغ عن حالة الاتصال ولكنه لا ينشئ الاتصالات أو يربط مراجع الاتصال.

1. في Connections ، اختر Configure لمراجع اتصال Microsoft Dataverse . يؤدي ذلك إلى فتح Power Apps.
2. اختر نفس بيئة Dataverse، ثم افتح Solutions → RapidStart BC Addon → Connection references . خصص اتصالًا صالحًا لمرجع Microsoft Dataverse واحفظ.
3. كرر Configure لمراجع اتصال Dynamics 365 Business Central . في Power Apps، خصص اتصال Business Central صالح لذلك المرجع واحفظ.
4. ارجع إلى معالج RapidStart Settings واختر Refresh . تحقق من ارتباط كلا المرجعين باتصالات حية.
5. لا يزال في Connections ، احفظ BC Environment كاسم بيئة Business Central و BC Company System ID كـ Company System ID GUID تم التقاطها في الخطوة 3، وليس اسم الشركة القابل للتحرير.
6. عند إظهار الاتصالات والإعدادات المطلوبة جاهزة، افتح Automations وقم بتمكين التدفقات الموصى بها. اترك Sync New Account to BC و Sync New Contact to BC مغلقًا إلا إذا اختار العميل تلك المسارات الإنشائية. إذا كانت مزامنة CUSTOMER الأصلية تملك إنشاء العميل، فاحتفظ بـ Sync New Account to BC مغلقًا.

التحقق قبل الطرح

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

1. تأكيد بيئة Dataverse الهدف، بيئة Business Central، و Company System ID؛ تحقق من اتصال Dataverse من Business Central.
2. تأكد من مالك الإنشاء. للإنشاء التلقائي الأصلي، قم بإيقاف Sync New Account to BC قبل الاختبار.
3. قم بتكوين ومزامنة CURRENCY و PAYMENT TERMS و SHIPMENT METHOD و SHIPPING AGENT. تحقق من Dataverse Option Mapping وأخطاء المزامنة. إذا لم تكن معرفات الخيارات متوافقة، استخدم FromIntegrationTable لتعيينات حقل الخيارات الثلاثة CUSTOMER الموضحة في الخطوة 6.
4. تحقق من أن CUSTOMER هو Bidirectional وتأكد من سياسة Sync. Only Coupled Records المختارة. للإنشاء التلقائي، اضبطه على إيقاف وأبقِ Disable Event-driven Synch. Job Rescheduling غير محدد.
5. راجع فلاتر شركة CUSTOMER، تأكد من وجود إدخال قائمة انتظار المهام، ولاحظ الفاصل الزمني للمزامنة. قم بربط الأزواج الموجودة المعروفة يدويًا؛ راجع نتائج الاقتران المستند إلى التطابق قبل قبولها.
6. قم بتشغيل Synchronize Modified Records ، وليس المزامنة الكاملة، لأول اختبار مراقب. راجع Integration Synchronization Jobs وحل الفشل قبل توسيع النطاق.
7. إنشاء حساب Dataverse ذو اسم فريد يفي بفلاتر CUSTOMER، بدون رقم عميل Business Central. قم بتشغيل المزامنة أو انتظر. تأكد من إنشاء عميل Business Central برقم عميل مخصص و Coupled to Dataverse = Yes .
8. قم بتغيير حقل واحد المحدد في حساب Dataverse؛ قم بتشغيل المزامنة التالية أو انتظرها وتحقق من تحديث العميل المقترن Business Central.
9. قم بإنشاء عميل Business Central ذو اسم فريد يفي بالفلاتر. تأكد من إنشاء الحساب المقترن Dataverse؛ قم بتغيير حقل واحد في Business Central وتحقق من تحديث Dataverse.
10. اختبر عميلاً بعملة غير أساسية. تأكد من أن تعيين العملة ومعدلات الصرف صالحة.
11. اختبر إنشاء اقتباس فقط بعد اقتران الحساب بعميل Business Central صالح.
12. قم بإجراء مزامنة كاملة فقط بعد مراجعة الفلاتر والبيانات المرجعية وتعيينات الخيارات والأزواج الموجودة وسجلات الأخطاء.

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

معرفات الاتصال المفقودة

قم بإصلاح مراجع الاتصال في Power Apps: اختر نفس بيئة Dataverse، ثم Solutions → RapidStart BC Addon → Connection references . خصص واحفظ اتصالات Microsoft Dataverse و Dynamics 365 Business Central صالحة. ارجع إلى معالج RapidStart Settings واختر Refresh ، ثم قم بتمكين التدفق المطلوب مرة أخرى تحت Automations . لا يقوم المعالج بإصلاح روابط الاتصال. إعادة إنشاء اتصال بمفرده ليس كافيًا إذا لا تزال إشارته تشير إلى الاتصال القديم.

أخطاء تعيين العملة

خطأ: Table CRM Transactioncurrency must be mapped to table Currency to transfer value between fields TransactionCurrencyId and Currency Code.

مرجع تعيين CUSTOMER عملة Dataverse، ولكن تعيين CURRENCY أو تعيين حقل الشفرة → رمز العملة مفقود أو مُعطّل أو لم يقم بمزامنة العملة المشار إليها.

1. استعد أو أنشئ تعيين CURRENCY واضبط اتجاهها لـ Business Central إلى Dataverse .
2. قم بتمكين الشفرة → رمز العملة وقم بمزامنة العملات.
3. تأكد من وجود عملة العميل في Dataverse، ثم أعد محاولة مزامنة CUSTOMER.

عدم تطابق الخيارات

مثال: The value 100000003 of 'paymenttermscode' on record of type 'account' is outside the valid range. Accepted Values: 1,2,3,4.

Business Central أرسل تعريف خيارات دفع مخصص غير موجود في حساب خيارات الدفع Dataverse.

1. قارن بين Dataverse Option Mapping مع معرفات خيار Dataverse الصالحة.
2. إذا كان الخيار يجب أن يتزامن في كلا الاتجاهين، اطلب من المطور إضافة خيارات Dataverse وقيم توسيع Business Central مع معرفات رقمية مطابقة. لا تخترع أو تغير أرقام المعرفات أثناء الإعداد.
3. بخلاف ذلك، اضبط تعيين حقل رمز شروط الدفع لـ CUSTOMER إلى FromIntegrationTable . طبق نفس الفحص على طريقة الشحن ووكيل الشحن.
4. أعد محاولة عميل واحد وتأكد من أن إجراء Business Central حساب يفتح الحساب المقترن Dataverse.

الربط يشير إلى سجلات محذوفة

إذا ظهر سجل مرتبط ولكن المزامنة تشير إلى سجل محذوف أو مفقود، قم بإزالة الربط القديم في Business Central وأنشئ ربطًا جديدًا للحساب أو الاتصال الصحيح في Dataverse قبل إعادة تشغيل المزامنة.

مراجع Microsoft

• مزامنة Business Central و Dataverse
• جدولة مهام المزامنة
• إعداد اتصال Dataverse
• التعامل مع القيم الاختيارية Dataverse المفقودة