إعدادات العملاء القديمة
يعمل HandyCafe جنبًا إلى جنب مع تثبيتات العملاء القديمة V3 و V4 دون انقطاع. تتحكم صفحة إعدادات العملاء القديمة في ميزتين متميزتين:
- بروتوكول التشغيل. يُمكّن مستمعي الشبكة الذين يسمحون للعملاء V3 و V4 بالاتصال بهذا الخادم على منافذهم الأصلية.
- ترحيل قاعدة البيانات. يقوم بشكل اختياري باستيراد الأعضاء، التسعير، المنتجات، الطلبات، المعاملات، والسجلات من تثبيت محلي أقدم إلى قاعدة بيانات HandyCafe الجديدة. هذا متاح فقط على Windows.
الميزتان مستقلتان. يمكنك تمكين دعم التشغيل دون ترحيل البيانات، ترحيل البيانات دون تمكين دعم التشغيل، أو القيام بكليهما.
قسم بروتوكول التشغيل
تمكين دعم العملاء القدامى
مفتاح رئيسي في أعلى القسم. عند التفعيل، يبدأ الخادم ثلاثة مستمعين للشبكة:
- مستمع UDP على مجموعة البث المتعدد المُكوّنة.
- مستمع أوامر TCP على
UDP port + 2. - مستمع نقل ملفات TCP على
UDP port + 7.
إيقاف المفتاح يوقف جميع المستمعين الثلاثة بشكل ذري. يمكنك ضبط أرقام المنافذ أو الترميز أثناء التعطيل، ثم إعادة التمكين لتطبيق التغييرات.
حقول التكوين
| الحقل | الافتراضي | الوصف |
|---|---|---|
| مفتاح المصادقة | HANDYCAFE | مفتاح مشترك مكون من 10 أحرف. كل إطار وارد وصادر يحمل هذه السلسلة. يتم إسقاط الإطارات التي لا تتطابق. يجب أن يستخدم جميع عملائك القدامى نفس المفتاح. |
| IP البث المتعدد لـ UDP | 230.4.4.46 | مجموعة البث المتعدد المستخدمة لإشارات اكتشاف العملاء ولإرسال الأوامر المستندة إلى UDP. مشفر في معظم إصدارات العملاء القدامى. |
| منفذ UDP للخادم | 710 | منفذ UDP الذي يستمع عليه الخادم لإشارات وأوامر العملاء. يرسل العملاء القدامى إلى هذا المنفذ. |
| منفذ UDP للعميل | 711 | منفذ UDP الذي يستمع عليه العملاء القدامى. يرسل الخادم أوامر الإدارة أحادية البث إلى هذا المنفذ على IP العميل المكتشف. |
| الترميز | cp1254 | ترميز الأحرف لحقول السلسلة بتنسيق السلك. استخدم cp1254 للتركيبات التركية، cp1252 للتركيبات الأوروبية الغربية. القيم غير المعروفة تعود إلى cp1254 مع تحذير في سجل الخادم. |
| إصدار الخادم | 3.4.01 | سلسلة الإصدار التي يتم بثها في كل إشارة UDP. بعض العملاء القدامى يرفضون الإطارات من الإصدارات التي لا يتعرفون عليها. اضبط هذا ليتطابق مع سلسلة إصدار الخادم الأصلي لديك. |
| نوع البروتوكول | STE | اختيار تنسيق السلك. انظر مقارنة الأنواع أدناه. |
| مهلة عدم النشاط | 10 | ثوانٍ. مراقب لكل عنوان MAC. إذا لم يصل أي حركة مرور من عميل خلال هذه النافذة، يتم وضع علامة على العميل كغير متصل. فجوة 10 ثوانٍ مناسبة للعملاء القدامى الذين يرسلون إشارات كل 2 أو 3 ثوانٍ. |
المنافذ المشتقة
أسفل النموذج، تعرض الصفحة سطرًا للقراءة فقط يظهر المنافذ المشتقة لـ TCP:
منفذ أوامر TCP: 712 منفذ نقل الملفات: 717
يتم حساب هذه المنافذ من منفذ الخادم UDP. لا تقوم بتكوينها بشكل منفصل. إذا قمت بتغيير منفذ الخادم UDP إلى قيمة مختلفة، تتحرك المنافذ المشتقة معه.
نوع البروتوكول
يحدد حقل نوع البروتوكول تنسيق السلك المستخدم من قبل الخادم. اختر النوع الذي يتطابق مع كيفية بناء الخادم القديم لديك.
| النوع | متى يُستخدم |
|---|---|
| STE (الإصدار الذكي/التوربيني) | قاعدة الكود القديمة الحديثة. يضيف بادئة معلومات ترخيص بحجم 70 بايت إلى هيكل الإطار. حجم الإطار هو 1337 بايت. اختر هذا إذا كان التثبيت القديم لديك يستخدم الإصدار الذكي أو التوربيني. |
| القياسي | البناء الأساسي القديم العادي. حجم الإطار هو 1267 بايت بدون بادئة معلومات الترخيص. اختر هذا فقط إذا كان التثبيت القديم لديك إصدارًا قياسيًا بدون تسجيل ترخيص. |
اختيار النوع الخاطئ يتسبب في إسقاط الإطارات أو قراءتها بشكل خاطئ. تشمل الأعراض ظهور العملاء كمتصلين ولكنهم يتجاهلون كل الأوامر، أو بيانات الأوامر التي يتم تحريكها بإزاحة 70 بايت.
التعايش مع العملاء الحديثين
المنافذ القديمة (710، 711، 712، 717) منفصلة تمامًا عن منافذ بروتوكول HandyCafe الحديث (TCP 5001، 5002، 5003، UDP 5004). تعمل كلا مجموعتي البروتوكولات في وقت واحد دون تعارض. يمكنك مزج العملاء القدامى والجدد على نفس الشبكة المحلية وإدارتهم من نفس لوحة الإدارة.
تطبيق التغييرات
يتم حفظ كل حقل في قسم بروتوكول التشغيل باستخدام زر الحفظ العالمي في أسفل الصفحة. عند الحفظ، يقوم الخادم بـ:
- إيقاف المستمعين القدامى الثلاثة إذا كانوا يعملون.
- التحقق من صحة مفتاح المصادقة (يجب ألا يكون فارغًا).
- بناء تكوينات مستمع جديدة من الحقول المحدثة.
- إعادة تشغيل المستمعين في وقت واحد.
- إطلاق إشعار عندما يعود الثلاثة إلى العمل.
إذا كان المنفذ قيد الاستخدام بالفعل من قبل عملية أخرى، يبلغ الخادم عن خطأ ويعود المفتاح إلى وضع الإيقاف. تحقق من جدار الحماية والخدمات الأخرى باستخدام netstat واختر نطاق منافذ خالية.
قسم ترحيل قاعدة البيانات (Windows فقط)
هذه الميزة متاحة فقط عندما يعمل HandyCafe على Windows. على macOS وLinux، يظهر القسم إشعارًا: "ترحيل قاعدة البيانات مدعوم فقط على Windows."
الكشف
عند الفتح، يقوم الخادم بفحص نظامك للبحث عن تثبيت قديم. يبحث الكشف في:
- السجل ومسارات التثبيت النموذجية مثل
Program Files\HandyCafeوC:\HandyCafe. - ملف قاعدة البيانات بجانب التثبيت.
- ملفات التكوين INI في دليل التثبيت.
عندما ينجح الكشف، تعرض الصفحة:
| التسمية | المعنى |
|---|---|
| مسار التثبيت | مكان وجود التثبيت القديم على القرص. |
| مسار قاعدة البيانات | المسار الكامل لملف قاعدة البيانات القديم. |
| إصدار الخادم | تم تحليله من التكوين القديم. |
| عدد ملفات INI | عدد ملفات التكوين المكتشفة. مفيد للتحقق من اكتمال التثبيت. |
إذا لم يتم اكتشاف أي تثبيت، تعرض الصفحة "لم يتم اكتشاف أي تثبيت قديم." لا يزال بإمكانك تمكين دعم التشغيل؛ الميزة الترحيلية ببساطة ليس لديها شيء لتستورد منه.
حالة الترحيل
تتبع الصفحة تاريخ الترحيل:
| الحالة | المعنى |
|---|---|
| لم يتم | لم تقم بتشغيل ترحيل بعد. |
| قيد التقدم | يجري حاليًا تشغيل ترحيل. لا تقم بإغلاق الخادم أثناء هذه الحالة. |
| مكتمل | انتهى الترحيل الأخير بدون تحذيرات. |
| مكتمل مع تحذيرات | انتهى الترحيل الأخير ولكن تم تخطي بعض السجلات (على سبيل المثال بسبب أخطاء الترميز أو التواريخ المشوهة). راجع التحذيرات قبل المتابعة. |
| تم التراجع | تم التراجع عن الترحيل الأخير. |
بعد التشغيل الناجح الأول، يتم إعادة تسمية زر بدء الترحيل إلى إعادة تشغيل الترحيل.
ما الذي يتم ترحيله
| الجدول | الوصف |
|---|---|
| الأعضاء | سجلات العملاء مع الأسماء، معلومات الاتصال، وأرصدة الحسابات. |
| التسعير | جداول الأسعار ومعدلات الساعة بالساعة. |
| المنتجات | إدخالات كتالوج المنتجات. |
| الطلبات | تاريخ الطلبات مع مراجع الجلسات. |
| المعاملات | إدخالات دفتر الأستاذ مع الطوابع الزمنية، المبالغ، وطرق الدفع. |
| السجلات | إدخالات التدقيق والتحذير من قاعدة البيانات القديمة. |
ضمان "أمان الملفات"
تعرض الصفحة إشعارًا باللون الأزرق: "لا يتم حذف ملفات قاعدة البيانات الأصلية. يمكنك حذفها بأمان بمجرد تأكيد الترحيل." الترحيل هو للقراءة فقط على المصدر. حتى إذا قمت بتشغيل الترحيل عدة مرات، تظل قاعدة البيانات القديمة الأصلية دون تغيير. يتيح لك هذا التجربة مع الاستيراد، مراجعة الأعداد، والتراجع دون مخاطرة.
بدء، إعادة تشغيل، والتراجع
- بدء الترحيل. يفتح نافذة تقدم. تعرض النافذة المرحلة الحالية وأعداد السجلات أثناء تشغيل الاستيراد. لا تقم بإغلاق HandyCafe خلال هذا الوقت.
- إعادة تشغيل الترحيل. متاح بعد تشغيل مكتمل. يعيد تشغيل الاستيراد من البداية. يحل الاستيراد الجديد محل البيانات السابقة في HandyCafe.
- التراجع عن الترحيل. متاح بعد تشغيل مكتمل. يفتح مربع حوار تأكيد. عند التأكيد، يتم حذف كل صف مرحل من HandyCafe. لا يتم لمس المصدر القديم. بعد التراجع، تعود الحالة إلى
لم يتم.
مكتمل مع تحذيرات
إذا انتهى الترحيل بـ مكتمل مع تحذيرات، يظهر شريط أصفر مع رابط تفاصيل. انقر لتوسيع قائمة السجلات المتخطاة مع السبب. الأسباب الشائعة:
- عدم تطابق الترميز. يحتوي صف المصدر على أحرف لا يتم فك تشفيرها بشكل صحيح في الترميز المُكوّن. قم بتغيير حقل الترميز (cp1254 أو cp1252) وأعد تشغيل الترحيل.
- تواريخ مشوهة. تحتوي بعض السجلات القديمة على طوابع زمنية غير صالحة. يتم تخطي هذه حتى يتم استيراد الصفوف الصالحة.
- مفاتيح مكررة. يوجد سجل بنفس المعرف بالفعل في HandyCafe. يحافظ الترحيل على السجل الحالي ويتخطى المكرر.
نصائح
- أوقف الخادم القديم قبل تشغيل الترحيل. إذا كان النظام القديم لا يزال يكتب إلى قاعدته البيانات، قد يرى الاستيراد بيانات قديمة أو جزئية.
- طابق حقل الترميز مع اللغة المحلية القديمة قبل الترحيل الأول. تغييره بعد استيراد البيانات لن يصلح الأسماء المشوهة بالفعل.
- قم دائمًا بتشغيل ترحيل تجريبي أولاً. تحقق من أعداد السجلات تحت "آخر الأعداد" وتحقق من بعض صفوف الأعضاء والمعاملات قبل التزام الموظفين بالنظام الجديد.
- قم بتمكين دعم التشغيل واحتفظ بعملائك القدامى متصلين لفترة انتقالية. يتيح لك هذا التحقق من أن الخادم الجديد يخدمهم بشكل مماثل قبل أن تتقاعد الخادم القديم.
- إذا قمت بتغيير منفذ الخادم UDP، تذكر أن منافذ الأوامر ونقل الملفات المشتقة تتحرك معه. تحتاج قواعد جدار الحماية إلى التحديث وفقًا لذلك.