Lorixen.
AR

الطلب يفشل عند من لغة جواله عربية؟ الأرقام المرسلة للخادم

باختصار: إذا كان تطبيقك يعمل بشكل ممتاز على هواتف الفريق، ثم تصلك من بعض الزبائن طلبات فيها تاريخ «٢٠٢٦-١١-٠٨» أو سعر «12,5» يرفضها الخادم، فالسبب غالباً أن التطبيق ينسق الأرقام والتواريخ بإعدادات لغة الهاتف قبل إرسالها. توثيق أندرويد لفئة Locale يقول صراحة إن اللغة الافتراضية غير مناسبة للمخرجات التي تقرؤها الآلات، وإن بعض اللغات تستخدم أرقاماً غير ASCII. القاعدة: نسّق بلغة الزبون ما تعرضه له فقط، وأرسل إلى الخادم أرقاماً وتواريخ بصيغة ثابتة لا تتغير مع اللغة.

كيف يظهر الخطأ؟

تطبيق حجز مواعيد لمركز صيانة سيارات في عمّان. الفريق اختبره على هواتف لغتها الإنجليزية، وكل شيء يعمل. بعد الإطلاق، يبدأ بعض الزبائن بالشكوى: «اخترت موعداً وطلعلي خطأ». يفحص المطور السجلات فيجد طلبات فيها تاريخ مكتوب بالأرقام العربية المشرقية، أو وقت مثل «١٠:٣٠ م»، أو رقم كيلومترات بفاصلة. الخادم يتوقع 2026-11-08 و10:30 فيرفض.

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

ماذا يقول توثيق أندرويد؟

في قسم بعنوان الحذر من اللغة الافتراضية، يشرح توثيق Locale أن كثيراً من الدوال المساعدة تستخدم اللغة الافتراضية تلقائياً، وأن ذلك قد يسبب أخطاء خفية. اللغة الافتراضية مناسبة لعرض البيانات للمستخدم، أي تنسيق التواريخ والأرقام بالطريقة التي يتوقعها. لكنها بحسب التوثيق غير مناسبة للمخرجات التي تقرؤها الآلات، والخيار الأفضل غالباً Locale.US لأنه متاح على كل الأجهزة ولا يحمل حالات خاصة مفاجئة.

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

أين تختبئ المشكلة في الكود؟

  • String.format دون لغة: تنسيق رقم أو تاريخ بـ String.format مع تمرير القيم فقط يستخدم لغة الجهاز. في Kotlin وJava مرّر Locale.US أو Locale.ROOT صراحة لأي نص يُرسل للخادم.
  • SimpleDateFormat ونظيراتها: إنشاء منسق تاريخ دون تحديد اللغة يعطي أرقاماً وأسماء أشهر بلغة الجهاز.
  • toString للأرقام العشرية في بعض المكتبات: راجع كيف تحول الأسعار والكميات إلى نص.
  • تحويل الحروف: يذكر التوثيق أن toLowerCase وtoUpperCase دون لغة قد تعطي نتائج مختلفة في بعض اللغات، وهذا يهم إن كنت تحول رموز الكوبونات أو أسماء الحقول.

في تطبيقات الويب وجافاسكربت

المشكلة نفسها تظهر في المتصفح. دوال مثل toLocaleString وIntl.NumberFormat تنسق الأرقام بحسب اللغة، وتوثق MDN خيار numberingSystem الذي يحدد نظام الأرقام، مثل arab. هذه ممتازة للعرض، لكن لا ترسل ناتجها للخادم. للتواريخ، تذكر MDN أن toISOString تعيد صيغة مبنية على ISO 8601 بطول ثابت، وبتوقيت UTC دائماً. هذه صيغة مناسبة للإرسال، مع الانتباه إلى أنها بتوقيت UTC لا بتوقيت الأردن، فإن كان الموعد يعتمد على اليوم المحلي فأرسل التاريخ المحلي بصيغة ثابتة YYYY-MM-DD.

القاعدة العملية: طبقتان منفصلتان

فكّر في البيانات على مستويين:

  • طبقة العرض: ما يراه الزبون. هنا استخدم لغته وأرقامه المفضلة، سواء كانت غربية أو مشرقية، وتنسيق التاريخ الذي يعرفه.
  • طبقة البيانات: ما يُرسل للخادم ويُحفظ. هنا القيم أرقام حقيقية لا نصوص منسقة، والتواريخ بصيغة ISO، والأرقام العشرية بالنقطة، والأرقام بالصيغة الغربية دائماً.

لا تحول من طبقة العرض إلى طبقة البيانات بقراءة النص المعروض. احتفظ بالقيمة الأصلية في متغير، واعرض نسخة منسقة منها.

الأرقام التي يكتبها الزبون بنفسه

هناك مصدر آخر للأرقام المشرقية غير التنسيق: الزبون نفسه. لوحة المفاتيح العربية في بعض الهواتف تكتب الأرقام بالشكل المشرقي، فيصل رقم الهاتف أو رقم لوحة السيارة أو الكمية مكتوباً «٠٧٩...». هذا ليس خطأ من الزبون، ويجب ألا يُرفض. حوّل هذه الأرقام إلى غربية في التطبيق قبل التحقق والإرسال، أو على الخادم عند الاستقبال، واعرضها له كما كتبها إن أردت.

السجلات والتقارير أيضاً

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

على الخادم: كن متسامحاً في الاستقبال

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

كيف تختبر قبل الإطلاق؟

  1. غيّر لغة هاتف الاختبار إلى العربية، ومنطقته إلى الأردن.
  2. إن كان الهاتف يسمح باختيار شكل الأرقام، جرّب الشكلين.
  3. نفّذ كل عملية ترسل أرقاماً أو تواريخ: حجز، طلب، تعديل كمية، إدخال رقم سيارة أو هاتف.
  4. راقب الطلبات المرسلة للخادم، لا ما يظهر على الشاشة فقط.
  5. أضف هذه اللغة إلى قائمة أجهزة الاختبار الدائمة، حتى لا تعود المشكلة مع ميزة جديدة.

مثال توضيحي: مركز صيانة وطلبات حجز مرفوضة

لنفترض المركز المذكور راجع كود التطبيق، فوجد أن تاريخ الموعد يُنسق بـ String.format دون لغة، وأن الكيلومترات تُرسل كنص منسق. عدّل المطور كل ما يُرسل للخادم ليستخدم Locale.US وصيغة ISO للتاريخ، وأبقى التنسيق العربي للعرض فقط، وجعل الخادم يحول الأرقام المشرقية في النسخ القديمة. ثم اختبر على هاتف بلغة عربية قبل نشر التحديث.

هذا مثال توضيحي لطريقة المعالجة، دون أرقام أو نتائج مقاسة.

أسئلة شائعة

ليش الحجز بيفشل بس عند زبائن لغة جوالهم عربي؟

غالباً لأن التطبيق ينسق التاريخ أو الأرقام بلغة الهاتف ويرسلها للخادم كما هي، فيصل «٢٠٢٦» بدل 2026.

شو اللغة اللي لازم أستخدمها للإرسال؟

يقترح توثيق أندرويد Locale.US للمخرجات التي تقرؤها الآلات، لأنه متاح على كل الأجهزة وبلا حالات خاصة.

بدي الأرقام تظهر عربية للزبون، بقدر؟

نعم. نسّق للعرض بلغة الزبون، وأرسل للخادم القيم بصيغة ثابتة منفصلة.

الخادم لازم يقبل الأرقام العربية؟

يفيد أن يحولها في الاستقبال كحماية، لكن الإصلاح الحقيقي في التطبيق.

إذا كانت طلبات تطبيقك تفشل عند الزبائن الذين يستخدمون العربية، راسلنا ونتتبع التنسيق معك.

المصادر

WhatsAppاحجز مكالمة