الملحق أ: تعيين البيانات
تُستخدم الواجهات البرمجية للتطبيقات لخدمة REST لأوراكل فيوجن الخاصة بجهات الاتصال والحسابات للتكامل مع الواجهة البرمجية للتطبيق لخدمة REST لمزامنة معلومات الشخص في نظام معلومات عملاء الخدمات والمرافق من أوراكل.
يتم تخزين معرف الشخص من نظام معلومات عملاء الخدمات والمرافق من أوراكل كقيمة مرجع النظام المصدر مع نظام مصدر نظام معلومات العملاء في سجل الطرف في فيوجن. يتم تخزين رقم الطرف في فيوجن كقيمة خاصية الشخص في نظام معلومات العملاء بنوع الخاصية C1-EXCID لمعرف الاتصال الخارجي.
يتم تضمين تعيينات عناصر البيانات للأسماء ونقاط الاتصال وقيم الخواص التي تتم مزامنتها بين نظام معلومات عملاء الخدمات والمرافق من أوراكل وتجارب العملاء للخدمات والمرافق لأوراكل في الجدول التالي.
تفاصيل تعيين البيانات
يُقدم هذا الجدول تفاصيل تعيين البيانات:
الجدول أ-1: تفاصيل تعيين البيانات
| واجهة REST API لـ Fusion | الواجهة البرمجية للتطبيق لنموذج بيانات صناعة المرافق | واجهة برمجة تطبيقات REST لـ CIS | الوصف | تعيينات البيانات |
|---|---|---|---|---|
| /contacts | /utilitiesCustomer/v1/individual | /customer/v-model/cxPersons | جهة الاتصال هي فرد يُعتبر عميلاً أو جهة اتصال لعميل أو عميلاً محتملاً أو أي فرد آخر تربطه علاقة عمل. | تتم مزامنة جهات الاتصال التي تمثل عملاء مرتبطين بحسابات الفوترة في نظام معلومات العملاء فقط. |
| /accounts | /utilitiesCommercial/v1/organization | /customer/v-model/cxPersons | الحساب هو كيان عمل أو تنظيم له علاقة كعميل أو عميل محتمل للمبيعات. | تتم مزامنة الحسابات التي تمثل عملاء مرتبطين بحسابات الفوترة في نظام معلومات العملاء فقط. |
| PartyId | معرف المفتاح الفريد لجهة الاتصال أو الحساب أو السجل. | |||
| SourceSystem | sourceSystem | اسم النظام المصدر الخارجي الذي يتم فيه دمج طرف الاتصال. | قيمة "نظام معلومات العملاء" في فيوجن. | |
| SourceSystemReferenceValue | sourceSystemReferenceValue | personId | المعرف الفريد لسجل جهة الاتصال أو طرف الحساب من النظام المصدر الخارجي كما هو محدد في السمة SourceSystem. معرف الشخص هو قيمة فريدة لمعرف المفتاح المخصص بواسطة النظام لسجل الشخص في نظام معلومات العملاء. | |
| رقم الطرف | cxContactId | رقم طرف سجل العميل في فيوجن. هذا هو معرف المفتاح البديل لطرف جهة الاتصال المستخدم في معلمات المسار لسجل حساب أو جهة اتصال في فيوجن. | يتم تخزين رقم الطرف في فيوجن كقيمة الخاصية في نظام معلومات العملاء بنوع الخاصية C1-EXCID لمعرف الاتصال الخارجي. | |
| personOrBusiness | يشير إلى ما إذا كان الكيان شخصًا أو شركة، ويؤثر على المراجعة في نظام معلومات العملاء. | يتم دمج قيمة "P" مع فرد utilitiesCustomer كجهة اتصال في فيوجن. يتم دمج قيمة "B" مع تنظيم utilitiesCommercial كحساب في فيوجن. | ||
| primaryName | primaryName | الاسم الأساسي للشخص هو المرسل إليه في فاتورة الشخص ومراسلاته الأخرى ما لم يتم تجاوزه باسم مراسلة بديل. | ||
| الاسم الأول | firstName | firstName | لا ينطبق الاسم الأول لفرد على تنظيم. | |
| اسم العائلة | lastName | اسم العائلة | لا ينطبق اسم العائلة لفرد على تنظيم. | |
| نقاط الاتصال | contactPoint | contactDetails | تسجل نقاط اتصال الشخص معلومات الاتصال، مثل أرقام الهواتف وعناوين البريد الإلكتروني وعناوين URL ومعرفات برامج المراسلة، وما إلى ذلك. يتم دمج نقاط الاتصال النشطة والمعتمدة فقط. | |
| ContactPointId | المعرف | معرّف جهة الاتصال الخارجي | المعرف الفريد لسجل نقطة الاتصال. | |
| ContactPointType | pointType | نوع نقطة الاتصال. البحث القياسي في فيوجن COMMUNICATION_TYPE وإدارة نظام معلومات العملاء القابلة للتكوين لأنواع اتصالات الشخص. أمثلة على القيم: PHONE، EMAIL، INSTANT_MESSAGING، WEB، SMS، TLX، EDI، EFT. يحتوي نظام معلومات العملاء على بحث قابل للتوسيع C1-CommRoutingMethodLookup بقيم CSS (مستخدم الخدمة الذاتية) وEMAIL وFAX وPHONE. |
تكوين المرفق: communicationType مثال: "ccsValue": "FAX"، "faValue": "TLX" |
|
|
عنوان البريد الإلكتروني رقم الهاتف عنوان URL |
القيمة | contactDetailValue | تحتوي على قيم محددة لمعلومات الاتصال، مثل رقم الهاتف أو عنوان البريد الإلكتروني أو عنوان URL بالتنسيق المرتبط. | |
| غرض البريد الإلكتروني | personContactType | يحدد الغرض من استخدام نقطة اتصال البريد الإلكتروني. البحث القياسي في فيوجن CONTACT_POINT_PURPOSE. أمثلة على القيم: PERSONAL، BUSINESS، COLLECTIONS، ASSISTANT، إلخ. |
تكوين المرافق: EMAIL_Purpose مثال: "ccsValue": "PRIMARYEMAIL"، "faValue": "PERSONAL" |
|
| الغرض من رقم الهاتف | personContactType | يحدد الغرض من استخدام نقطة اتصال البريد الإلكتروني. البحث القياسي في فيوجن CONTACT_POINT_PURPOSE. أمثلة على القيم: PERSONAL، BUSINESS، COLLECTIONS، ASSISTANT، إلخ. |
تكوين المرافق: PHONE_Purpose مثال: "ccsValue": "CELLPHONE"، "faValue": "PERSONAL" |
|
| WebPurpose | personContactType | يحدد الغرض من استخدام نقطة اتصال الويب. البحث القياسي في فيوجن CONTACT_POINT_PURPOSE_WEB. أمثلة على القيم: HOMEPAGE، RSS_FEED، إلخ. |
تكوين المرافق: WEB_Purpose مثال: "ccsValue": "WEB"، "faValue": "HOMEPAGE" |
|
| تحويلة الهاتف | تحويلة الهاتف | contactDetailValueExtension | إذا كان موجودًا، فهذا هو امتداد معلومات الاتصال عندما يكون توجيه الاتصال هو الهاتف أو الفاكس. | |
| SourceSystem | اسم النظام المصدر الخارجي الذي يتم فيه دمج نقطة الاتصال. | قيمة "CIS" | ||
| SourceSystemReferenceValue | contactPointId | المعرف الفريد لنقطة الاتصال من النظام المصدر الخارجي المحدد في السمة SourceSystem. معرف نقطة الاتصال هو قيمة معرف فريد مخصص بواسطة النظام في نظام معلومات العملاء. | ||
| علامة رئيسية | primaryFlag | تفاصيل الاتصال الأساسية | يشير إلى نقطة الاتصال المفضلة. | |
| الحالة | الحالة | يشير إلى ما إذا كانت نقطة الاتصال نشطة أم غير نشطة. يُظهر تاريخ انتهاء فيوجن أنه نشط بتاريخ مستقبلي في السنة 4712 وتاريخ قديم في السنة 1900 على أنه غير نشط. | ||
| الخصائص | يدعم نظام معلومات عملاء الخدمات والمرافق من أوراكل تكوين أنواع الخواص لتخزين البيانات الإضافية في كائنات سجل الشخص. يمكن ربط مجموعة البيانات هذه بسمات الطرف في فيوجن كجزء من سجلات جهة الاتصال أو الحساب. | |||
| characteristicType | هذا حقل موسع في نظام معلومات عملاء الخدمات والمرافق من أوراكل يتم تكوينه وفقًا للتنفيذ حسب الحاجة لتخزين القيم الإضافية. |
تقوم موفقات إطار عمل تجارب عملاء الصناعات بربط خواص نظام معلومات العملاء بسمات فيوجن المعينة. تكوين المرافق: الخصائص أمثلة: "ccsValue": "C2MBTHDT"، "faValue": "DateOfBirth" |
||
| characteristicValue | هذه سمة بيانات قابلة للتوسيع، وتُخزن قيم أزواج النوع/القيمة المحددة في التنفيذ. |