تكوين عنصر إستدعاء قاعدة بيانات - Tomcat JNDI لقاعدة بيانات SQL

المقدمة

يصف هذا المستند عنصر قاعدة بيانات Cisco Customer Voice Portal (CVP)، Tomcat Java Name and Directory Interface (JNDI)، لقاعدة بيانات SQL.

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

المتطلبات

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

• Cisco Unified Contact Center Enterprise (UCCE)، الإصدار 12.6.2
• Cisco Package Contact Center Enterprise (PCCE)، الإصدار 12.6.2
• CVP الإصدار 12.6.2
• Cvp Call Studio، الإصدار 12.6.2

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

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

• Cisco PCCE، الإصدار 12.6.2
• CVP الإصدار 12.6.2
• Cvp Call Studio، الإصدار 12.6.2

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

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

يوفر عنصر قاعدة البيانات إمكانية تشغيل أمر لغة استعلام مهيكل (SQL) على قواعد البيانات الخارجية ضمن تدفق إستدعاءات التطبيقات الصوتية. يتطلب العنصر JNDI أن يكون شكلت في تطبيق نادل جافا in order to عالجت قاعدة معطيات توصيل. يمكن تشغيل جملة SQL واحدة فقط لكل عنصر. هناك أربعة أنواع من الأوامر التي يمكن تنفيذها، لكن في هذا المستند يتم إستخدام الأمر الواحد فقط:

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

يمكن العثور على مزيد من المعلومات في دليل عناصر CVP VXML.

التكوين

يشرح هذا القسم كيفية إنشاء اتصال قاعدة بيانات JNDI جديد في Tomcat.

الخطوة 1. حدد إصدار بيئة وقت تشغيل Java (JRE) على خادم CVP الخاص بك.

• انقر فوق الزر ابدأ (ركن الزر الأيسر في شريط سطح المكتب)
• انقر على خيار تشغيل...
• اكتب في CMD وانقر موافق لعرض موجه الأمر DOS
• ثم اكتب في إصدار جافا

الخطوة 2. قم بتثبيت برنامج تشغيل متوافق لاتصال قاعدة بيانات Java (JDBC) باستخدام إصدار SQL. لتمكين الوصول إلى قاعدة البيانات على خادم التطبيق، يجب تثبيت برنامج تشغيل JDBC متوافق. يجب وضع برامج التشغيل هذه، التي يتم تجميعها عادة كملفات JAR، في دليل يمكن الوصول إليه من خلال واجهة مستخدم خادم التطبيق (على Tomcat، على سبيل المثال، يتم وضعها في ٪CVP_HOME٪\VXMLServer\Tomcat\lib).

يمكن العثور على برامج تشغيل مختلفة هنا.

مثال من قائمة MS المدعومة:

ملاحظة: يجب أن تكون قاعدة البيانات موجودة لهذا الاتصال للعمل. لن يقوم خادم CVP Voice XML (VXML) بإنشاء قاعدة البيانات لك. في هذا المستند، يتم إستخدام قاعدة بيانات UCCE AW كمثال وإصدار برنامج تشغيل JDBC، الإصدار 12.6، هو الذي تم تثبيته.

الخطوة 2. أضف سياق Tomcat لاتصال قاعدة البيانات بحيث يعرف خادم CVP VXML كيفية الاتصال بقاعدة البيانات. لمزيد من المعلومات، راجع https://tomcat.apache.org/tomcat-9.0-doc/jndi-datasource-examples-howto.html.

هنا مثال يستخدم SQL (تحرير سياق.xml من مجلد AUDIUM_HOME\Tomcat\conf حيث يكون AUDIUM_HOME عادة Cisco\CVP\VXMLServer):

    <Context>

    <Resource name="jdbc/<LABEL_YOU_CHOOSE>"

    auth="Container"

    type="javax.sql.DataSource"

    username="USER_NAME"

    password="USER_PW"

    driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"

    url="jdbc:sqlserver://HOSTNAME_OR_IP:PORT;DatabaseName=< DB_NAME>" />

    </Context>

يكون رقم المنفذ الافتراضي ل MS SQL هو 1433. مثال url للسياق السابق سيكون 'jdbc: sql://localhost:1433;databaseName=pcce_awdb'. 

ملاحظة: بالتناوب، يمكن تكوين <Resource> في الملف server.xml ضمن <GlobalNameResources>، و<ResourceLink> الذي تم إنشاؤه في context.xml ضمن <Context>.

للأمان المحسن، من المستحسن تعيين اسم المستخدم أو كلمة المرور باستخدام العنصر وحذف حقول اسم المستخدم وكلمة المرور يدويا من ملف context.xml.

إن زودت ال username وكلمة يكون في العنصر، ال username وكلمة في ال context.xml مبرد سيتم تجاهلت.

الخطوة 3. في ظل ظروف الحمل الثقيل، قم بتمكين تجميع اتصال قاعدة البيانات.

يقوم تجمع إتصالات قاعدة البيانات بإنشاء مجموعة إتصالات بقاعدة بيانات وإدارتها. إعادة التدوير وإعادة إستخدام الاتصالات الموجودة بالفعل بقاعدة بيانات أكثر فعالية من فتح اتصال جديد. لمزيد من المعلومات حول تجميع قاعدة بيانات Tomcat، راجع https://tomcat.apache.org/tomcat-9.0-doc/jndi-datasource-examples-howto.html.

ملاحظة: يحتوي Tomcat 8.0 على مكتبتي تجمع إتصالات: مشتركة-dbcp و tomcat-jdbc-pool. نظرا لوجود مشكلة معروفة مع مكتبة تجمع إتصالات تجمع تجمع بيانات CVP-JDBC، في حالة تعطل الاتصال بين خادم CVP VXML وخادم SQL البعيد، لا يتم إعادة إنشاء الاتصالات تلقائيا. يمكن إعادة إنشاء الاتصالات فقط بعد إعادة تشغيل خدمة VXMLServer tomcat.

لا تواجه مكتبة تجمع إتصالات COMMONS-DBCP هذه المشكلة. ال commons-dbcp استعملت مكتبة افتراضيا، وال tomcat-jdbc-pool استعملت فقط إن ال tomcat سياق.xml يحتوي مبرد هذا خط:

factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"

بسبب هذا إصدار، لا توصي Cisco باستخدام مكتبة tomcat-jdbc-pool.

الخطوة 4. قم بإعادة تشغيل خدمة CVP VXML.

الخطوة 5. في CVP Call Studio، قم بتحرير تكوين عنصر قاعدة البيانات المعني. أدخل السلسلة التي أدخلتها في <LABEL_YOU_CHOOSE> من سياق Tomcat في خاصية اسم JNDI الخاصة بعلامة التبويب "إعدادات" الخاصة بعنصر قاعدة البيانات.

ملاحظة: لا تقم بتضمين JDBC/الجزء هنا.

الخطوة 6. حفظ التطبيق ونشره وتحديثه على خادم VXML.

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

لا تتوفر حاليًا معلومات محددة لاستكشاف الأخطاء وإصلاحها لهذا التكوين.

معلومات ذات صلة

• مصفوفة دعم برنامج تشغيل Microsoft JDBC ل SQL Server: برامج تشغيل Microsoft JDBC
• دليل عنصر VXMl: دليل عنصر CVP VXML
• الدعم التقني والمستندات - Cisco Systems