الملحق أ: تعيين البيانات
تُستخدم الواجهات البرمجية للتطبيقات لخدمة REST لأوراكل فيوجن الخاصة بجهات الاتصال والحسابات للتكامل مع الواجهة البرمجية للتطبيق لخدمة REST لمزامنة معلومات الشخص في نظام معلومات عملاء الخدمات والمرافق من أوراكل.
يتم تخزين معرف الشخص من نظام معلومات عملاء الخدمات والمرافق من أوراكل كقيمة مرجع النظام المصدر مع نظام مصدر نظام معلومات العملاء في سجل الطرف في فيوجن. يتم تخزين رقم الطرف في فيوجن كقيمة خاصية الشخص في نظام معلومات العملاء بنوع الخاصية C1-EXCID لمعرف الاتصال الخارجي.
يتم تضمين تعيينات عناصر البيانات للأسماء ونقاط الاتصال وقيم الخواص التي تتم مزامنتها بين نظام معلومات عملاء الخدمات والمرافق من أوراكل وتجارب العملاء للخدمات والمرافق لأوراكل في الجدول التالي.
تفاصيل تعيين البيانات
يُقدم هذا الجدول تفاصيل تعيين البيانات:
الجدول أ-1: تفاصيل تعيين البيانات
| الواجهة البرمجية للتطبيق لخدمة REST لفيوجن | الواجهة البرمجية للتطبيق لنموذج بيانات صناعة المرافق | الواجهة البرمجية للتطبيق لخدمة REST لنظام معلومات العملاء | الوصف | تعيينات البيانات |
|---|---|---|---|---|
| /contacts | /utilitiesCustomer/v1/individual | /customer/v-model/cxPersons | جهة الاتصال هي فرد يُعتبر عميلاً أو جهة اتصال لعميل أو عميلاً محتملاً أو أي فرد آخر تربطه علاقة عمل. | تتم مزامنة جهات الاتصال التي تمثل عملاء مرتبطين بحسابات الفوترة في نظام معلومات العملاء فقط. |
| /accounts | /utilitiesCommercial/v1/organization | /customer/v-model/cxPersons | الحساب هو كيان عمل أو تنظيم له علاقة كعميل أو عميل محتمل للمبيعات. | تتم مزامنة الحسابات التي تمثل عملاء مرتبطين بحسابات الفوترة في نظام معلومات العملاء فقط. |
| PartyId | معرف المفتاح الفريد لجهة الاتصال أو الحساب أو السجل. | |||
| SourceSystem | sourceSystem | اسم النظام المصدر الخارجي الذي يتم فيه دمج طرف الاتصال. | قيمة "نظام معلومات العملاء" في فيوجن. | |
| SourceSystemReferenceValue | sourceSystemReferenceValue | personId | المعرف الفريد لسجل جهة الاتصال أو طرف الحساب من النظام المصدر الخارجي كما هو محدد في السمة SourceSystem. معرف الشخص هو قيمة فريدة لمعرف المفتاح المخصص بواسطة النظام لسجل الشخص في نظام معلومات العملاء. | |
| PartyNumber | cxContactId | رقم طرف سجل العميل في فيوجن. هذا هو معرف المفتاح البديل لطرف جهة الاتصال المستخدم في معلمات المسار لسجل حساب أو جهة اتصال في فيوجن. | يتم تخزين رقم الطرف في فيوجن كقيمة الخاصية في نظام معلومات العملاء بنوع الخاصية C1-EXCID لمعرف الاتصال الخارجي. | |
| personOrBusiness | يشير إلى ما إذا كان الكيان شخصًا أو شركة، ويؤثر على المراجعة في نظام معلومات العملاء. | يتم دمج قيمة "P" مع فرد utilitiesCustomer كجهة اتصال في فيوجن. يتم دمج قيمة "B" مع تنظيم utilitiesCommercial كحساب في فيوجن. | ||
| primaryName | primaryName | الاسم الأساسي للشخص هو المرسل إليه في فاتورة الشخص ومراسلاته الأخرى ما لم يتم تجاوزه باسم مراسلة بديل. | ||
| FirstName | firstName | firstName | لا ينطبق الاسم الأول لفرد على تنظيم. | |
| LastName | lastName | lastName | لا ينطبق اسم العائلة لفرد على تنظيم. | |
| ContactPoints | contactPoint | contactDetails | تسجل نقاط اتصال الشخص معلومات الاتصال، مثل أرقام الهواتف وعناوين البريد الإلكتروني وعناوين URL ومعرفات برامج المراسلة، وما إلى ذلك. يتم دمج نقاط الاتصال النشطة والمعتمدة فقط. | |
| ContactPointId | المعرف | contactExternalId | المعرف الفريد لسجل نقطة الاتصال. | |
| ContactPointType | pointType | نوع نقطة الاتصال. البحث القياسي في فيوجن COMMUNICATION_TYPE وإدارة نظام معلومات العملاء القابلة للتكوين لأنواع اتصالات الشخص. أمثلة على القيم: PHONE، EMAIL، INSTANT_MESSAGING، WEB، SMS، TLX، EDI، EFT. يحتوي نظام معلومات العملاء على بحث قابل للتوسيع C1-CommRoutingMethodLookup بقيم CSS (مستخدم الخدمة الذاتية) وEMAIL وFAX وPHONE. |
تكوين المرافق: communicationType مثال: "ccsValue": "FAX"، "faValue": "TLX" |
|
|
EmailAddress PhoneNumber عنوان URL |
القيمة | contactDetailValue | تحتوي على قيم محددة لمعلومات الاتصال، مثل رقم الهاتف أو عنوان البريد الإلكتروني أو عنوان URL بالتنسيق المرتبط. | |
| EmailPurpose | personContactType | يحدد الغرض من استخدام نقطة اتصال البريد الإلكتروني. البحث القياسي في فيوجن CONTACT_POINT_PURPOSE. أمثلة على القيم: PERSONAL، BUSINESS، COLLECTIONS، ASSISTANT، إلخ. |
تكوين المرافق: EMAIL_Purpose مثال: "ccsValue": "PRIMARYEMAIL"، "faValue": "PERSONAL" |
|
| PhonePurpose | 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" |
|
| PhoneExtension | phoneExtension | contactDetailValueExtension | إذا كان موجودًا، فهذا هو امتداد معلومات الاتصال عندما يكون توجيه الاتصال هو الهاتف أو الفاكس. | |
| SourceSystem | اسم النظام المصدر الخارجي الذي يتم فيه دمج نقطة الاتصال. | قيمة "نظام معلومات العملاء" | ||
| SourceSystemReferenceValue | contactPointId | المعرف الفريد لنقطة الاتصال من النظام المصدر الخارجي المحدد في السمة SourceSystem. معرف نقطة الاتصال هو قيمة معرف فريد مخصص بواسطة النظام في نظام معلومات العملاء. | ||
| PrimaryFlag | primaryFlag | contactDetailPrimary | يشير إلى نقطة الاتصال المفضلة. | |
| الحالة | الحالة | يشير إلى ما إذا كانت نقطة الاتصال نشطة أم غير نشطة. يُظهر تاريخ انتهاء فيوجن أنه نشط بتاريخ مستقبلي في السنة 4712 وتاريخ قديم في السنة 1900 على أنه غير نشط. | ||
| الخواص | يدعم نظام معلومات عملاء الخدمات والمرافق من أوراكل تكوين أنواع الخواص لتخزين البيانات الإضافية في كائنات سجل الشخص. يمكن ربط مجموعة البيانات هذه بسمات الطرف في فيوجن كجزء من سجلات جهة الاتصال أو الحساب. | |||
| characteristicType | هذا حقل موسع في نظام معلومات عملاء الخدمات والمرافق من أوراكل يتم تكوينه وفقًا للتنفيذ حسب الحاجة لتخزين القيم الإضافية. |
تقوم موفقات إطار عمل تجارب عملاء الصناعات بربط خواص نظام معلومات العملاء بسمات فيوجن المعينة. تكوين المرافق: characteristics الأمثلة: "ccsValue": "C2MBTHDT"، "faValue": "DateOfBirth" |
||
| characteristicValue | هذه سمة بيانات قابلة للتوسيع، وتُخزن قيم أزواج النوع/القيمة المحددة في التنفيذ. |