المحتويات

المقدمة

المتطلبات الأساسية

المتطلبات

المكونات المستخدمة

معلومات أساسية

حالة خدمة السياق

حالة خدمة السياق في الخدمة

حالة خدمة السياق من API

حالة خدمة السياق في SocialMiner

المقدمة

يوضح هذا المقال كيفية تحديد حالة خدمة السياق (CS) والخيارات المحتملة للتحقق من حالة مكونات CS في Unified Contact Center Express (UCCX) و SocialMiner (SM).

تمت المساهمة بواسطة جاينت سونيخا، مهندسي Cisco و ديريك جونسون، مهندس TAC من Cisco.

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

- إدارة UCCX

- الاجتماعية إدارة

- خدمة السياق

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج التالية:

- UCCX 11.6

- SocialMiner، الإصدار 11.6

ملاحظة: يعد SocialMiner مكونا إختياريا وليس مطلوبا لخدمة السياق.

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

معلومات أساسية

تقوم خدمة السياق بتخزين بيانات العملاء في السحابة وتسمح للوكلاء على حل UCCX بإمكانية تخزين البيانات واستخدامها من السحابة.

حالة خدمة السياق

حالة خدمة السياق في الخدمة

تتوفر حالة CS على صفحة خدمة CCX الموحدة. قم أولا بتحديد أدوات، ثم حالة خدمة السياق.

يصف هذا الجدول قيما مختلفة معروضة على واجهة حالة خدمة السياق هذه:

الحقل

القيم

مكون

يعرض هذا اسم مكون CS المحدد: UCCX/SocialMiner/Finesse

الحالة

مسجل: CS غير مسجل: CS غير مسجل

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

الحالة

عبر الإنترنت: يتم عرضه عند تسجيل CS في وضع عدم الاتصال: يتم عرضه عند عدم تسجيل CS أو عدم تكوين وكيل جاهز للتسجيل: يتم عرضه عند تكوين اتصال الوكيل أو الاتصال الخارجي

نمط

Lab: يتم إستخدام هذا الوضع لاختبار إنتاج خدمة السياق وتطويرها وتصحيح أخطائها: يتم إستخدام هذا الوضع عند نشر خدمة السياق في التطبيق NA: المعروض عندما تكون الحالة غير مسجلة أو غير معروفة

يمكن تغيير الوضع بين المختبر والإنتاج. قم أولا بتحديد النظام ثم حدد معلمات النظام

تظهر الحالة No Connectivity عندما لا يتم تكوين وكيل، أو يتم تكوين وكيل غير صحيح، أو لا يوجد اتصال إنترنت من نظام UCCX. يتطلب UCCX توفر اتصال عام بالإنترنت. تعرض هذه الصورة مثالا عندما لا يكون لنظام UCCX اتصال خارجي:

بعد تكوين وكيل HTTP، تتغير حالة جميع المكونات إلى جاهز للتسجيل مما يدل على أن النظام لديه الآن اتصال خارجي تم تكوينه بشكل صحيح من UCCX. توضح هذه الصورة حالة النظام عند توفر اتصال إنترنت عام:

حدد التسجيل في صفحة إدارة Finesse وسجل CS. توضح هذه الصورة أنه قد تم تغيير الحالة والحالة إلى مسجل وعلى الإنترنت:

حالة خدمة السياق من API

من أجل الحصول على ملخص تفصيلي لحالة كل مكون من مكونات CS، يوفر UCCX 11.6 واجهة برمجة تطبيقات Java (API). تستدعي واجهة برمجة التطبيقات هذه طريقة GetStatus للموصل لإرجاع إستجابة JavaScript Object Notation (JSON) التي توفر تفاصيل كل مكون. انقر فوق خيار التصدير المتوفر في صفحة قابلية صيانة CS وقم بتنزيل ملف الاستجابة JSON. تظهر هذه الصورة موقع خيار التصدير:

هنا مثال على إستجابة JSON التي تم إرجاعها لمكون UCCX عندما تكون CS غير متصلة:

UCCX:uccx116j1.cisco.com = {"status":{"overallStatus":"OFFLINE","successfulUpgradeCount":0,"failureUpgradeCount":0},

"config":{"staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.3-10673","state":"UNREGISTERED"},

"services":[{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"NOT_REACHABLE","latency":0}}],

"timeStamp":"2017-08-07T06:19:32.500Z"}

يصف هذا الجدول القيم الممكنة المعروضة في حقول استجابات JSON:

قسم

الحقل

القيمة

الحالة

الحالة العامة

عبر الإنترنت - في حالة وجود مجموعة بيانات اتصال وتم تسجيل الموصل (راجع حالة التكوين)

غير متصل - لم يتم تسجيل أي بيانات اتصال أو موصل

التكوين

الحالة

غير مسجل - الحالة الأولية قبل التهيئة

مسجل - تم التسجيل بنجاح (من خلال أسلوب إستدعاء init())

تم الإيقاف - تم تدمير الاتصال (عبر إستدعاء أسلوب DESTROY())

الخدمة

إختبار الاتصال.الحالة

رمز حالة إستجابة HTTP إلى إستدعاء واجهة برمجة تطبيقات Ping REST

الخدمات

الحالة

تمت التهيئة - تم تهيئة KMS

غير مهيأ - لم تتم تهيئة KMS

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

FMC:uccx116j1.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","type":"cs_mgmt","state":"REGISTERED"},"services":[{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:31.942","ping":{"status":"200","latency":2031}}],"timeStamp":"2017-08-07T16:54:54.118Z"}

UCCX:uccx116j1.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1196},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:46.016","ping":{"status":"200","latency":1059}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1092}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1185}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1180}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1170}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1214}}],"timeStamp":"2017-08-07T16:55:01.528Z"}

UCCX:uccx116j2.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1290},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:50.224","ping":{"status":"200","latency":1121}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1067}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1168}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1225}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1230}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1166}}],"timeStamp":"2017-08-07T16:55:01.582Z"}

SocialMiner:sm116.aru.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1254},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:39.628","ping":{"status":"200","latency":1127}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1028}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1175}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1174}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1128}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1179}}],"timeStamp":"2017-08-07T16:55:01.589Z"}

Finesse:uccx116j1.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http:\/\/proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1123},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:52.328","ping":{"status":"200","latency":1149}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1085}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1168}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1181}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1171}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1136}}],"timeStamp":"2017-08-07T16:55:02.099Z"}

Finesse:uccx116j2.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http:\/\/proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1196},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:51.027","ping":{"status":"200","latency":1210}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1032}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1168}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1189}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1207}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1251}}],"timeStamp":"2017-08-07T16:55:02.457Z"}

يتم إخراج JSON هذا عند تهيئة الموصل ويتضمن هذه المعلومات:

- الحالة العامة (المحددة حاليا استنادا إلى حالة الموصل)

- إصدار جرة SDK الثابتة والموسعة (مجموعة أدوات تطوير البرامج)

- نوع الموصل بحالته الحالية

- حالة القناة الآمنة الحالية (خطأ في وضع نشط أو غير مهيأ)، إذا كانت متاحة

- عدد مرات الترقية

- حالة الترقية

- آخر طابع زمني لنبضات القلب

- عنوان URL للخدمة

- معلومات الوكيل في حالة تكوين وكيل

- كائن التكوين إذا كان متوفرا

- حالة الاتصال بمختلف الخدمات الأساسية

حالة خدمة السياق في SocialMiner

تم إدخال واجهة برمجة تطبيقات في SocialMiner (SM) الإصدار 11.6 الذي يحدد حالة تكامل خدمة السياق مع SM. إستخدام مستعرض للانتقال إلى هذا الموقع على خادم SocialMiner الخاص بك: <sm-ip>:<port>/ccp-webapp/ccp/service/contextServiceStatus

هذا نموذج للمخرجات من SocialMiner بعد تسجيل CS:

{"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"0ff304fa-7ce6-470d-9fcb-f83266a06f35","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"065cce61-79de-4173-87f3-fd6fff30da11","clusterName":"ccx-context-15DC0905FC4"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1132},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-10 13:40:36.905","ping":{"status":"200","latency":1236}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":975}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1273}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1228}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1500}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1191}}],"timeStamp":"2017-08-10T08:10:43.983Z"}

إذا تم تسجيل "خدمة السياق" وكان SM قادرا على إنشاء الاتصال بسمات صالحة، تحتوي إستجابة "واجهة برمجة التطبيقات" هذه على السمة "overallStatus" ذات القيمة "online".

في حالة عدم تمكين "خدمة السياق" أو فشل SM في إنشاء اتصال، تكون للسمة globalStatus قيم أخرى غير ONLINE.

هذا مثال على الاستجابة عندما لا يتم تسجيل CS ل SM:

{"status":{"overallStatus":"OFFLINE","successfulUpgradeCount":2,"failureUpgradeCount":0},"config":{"staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10712","proxy":"http://proxy-wsa.esl.cisco.com:80","state":"STOPPED"},"services":[],"timeStamp":"2017-08-11T06:11:38.086Z"}

يؤدي هذا إلى إنهاء الخطوات لتحديد حالة "خدمة السياق".