إرسال قالب مع متغيرات

كيفية مطابقة المعلمات

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

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

المكونات قوائم منفصلة

لا تشترك متغيرات الرأس والنص في قائمة واحدة. يحمل كل مكوّن معلماته الخاصة، ويؤدي دمجها إلى عدم تطابق العدد.

• توضع معلمات الرأس في مكوّن رأس، ويوجد مكوّن واحد منها كحد أقصى.
• توضع معلمات النص في مكوّن نص، بالترتيب.
• توضع معلمات عنوان URL للزر في مكوّن زر، مع فهرستها حسب الزر.
• يؤدي إرسال قائمة واحدة مسطحة لها جميعًا إلى إرجاع الخطأ 132000.

ضبط اللغة بشكل صحيح

يُعرّف القالب بالاسم واللغة معًا، لذا فإن الاسم نفسه بلغتين يمثل قالبين. إرسال en عندما أُنشئ القالب باستخدام en_US لا يؤدي إلى استخدام بديل، بل يفشل بالخطأ 132001، الذي يُفهم منه أن القالب غير موجود.

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

المعلمات ذات الأنواع

معظم المعلمات نص عادي. لكن بعضها ليس كذلك، وإرسالها كنص يؤدي إلى الخطأ 132012.

• تحمل معلمات العملة مبلغًا ورمز عملة وسلسلة بديلة.
• تحمل معلمات التاريخ والوقت كائنًا منظمًا مع قيمة بديلة.
• تحمل معلمات رأس الوسائط معرف وسائط أو رابطًا، لا اسم ملف.
• تظهر السلسلة البديلة إذا تعذر على تطبيق المستلم تنسيق القيمة.

ماذا يعني كل خطأ

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

يعني الخطأ 132001 أن زوج الاسم واللغة لم يُعثر عليه، لذا تحقق من اللغة أولًا. ويعني الخطأ 132000 أن العدد غير صحيح، لذا قارنه بتعريف القالب نفسه. أما الخطأ 132012 فيعني أن تنسيق القيمة غير صحيح، وغالبًا يكون السبب إرسال معلمة ذات نوع محدد كسلسلة نصية عادية.

الأخطاء الشائعة

• افتراض أن en يستخدم en_US كبديل. هذا لا يحدث، ويُفهم من الخطأ أن القالب غير موجود.
• دمج معلمات الرأس والنص في قائمة واحدة. فهما مكوّنان منفصلان.
• إرسال العملة أو التاريخ كنص عادي. للمعلمات ذات الأنواع بنية محددة.

الأسئلة الشائعة

تابع القراءة