معالجة RAP

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

جدول المحتويات

• ما هو ملف RAP
• تسمية ملف RAP
• أنواع الإرجاع وشدتها
• رموز الأخطاء
• مراقبة RAP والتنبيهات
• قراءة ملف RAP

ما هو ملف RAP

يقوم الشريك بالتحقق من كل ملف TAP يرسله OmniRoam. إذا وجد الشريك أخطاء، يقوم الشريك بإرجاع ملف RAP. يُبلغ ملف RAP عن الأخطاء في ملف TAP معين. يتبع تنسيق RAP GSMA TD.32.

ملف RAP هو الرسول. تصف رموز الأخطاء العيوب في ملف TAP الأصلي. يقرأ OmniRoam ملف RAP، ويضيف وصفًا لكل خطأ، وينبه المشغلين.

تسمية ملف RAP

اسم ملف RAP له طول ثابت يبلغ 17 حرفًا. يعكس الاسم اسم ملف TAP، ولكنه يستخدم بادئة RAP.

البادئة	المعنى
RC	إرجاع ضد ملف TAP مباشر (بيانات قابلة للتحصيل).
RT	إرجاع ضد ملف TAP تجريبي (بيانات اختبار).

تحتوي بقية الاسم على 5 أحرف للمرسل، و5 أحرف للمستلم، ورقم تسلسل مكون من 5 أرقام. يقرأ OmniRoam فقط الملفات التي تبدأ بـ RC أو RT كملفات RAP.

أنواع الإرجاع وشدتها

يحتوي ملف RAP على إرجاع واحد أو أكثر. كل إرجاع له نوع وشدة.

نوع الإرجاع	الشدة	التأث��ر
إرجاع قاتل	حرج	يرفض الشريك ملف TAP بالكامل.
إرجاع شديد	تحذير	يرفض الشريك السجلات الفردية، ولكنه يقبل بقية الملف.
إرجاع مفقود	تحذير	يُبلغ الشريك عن فجوة في تسلسل الملف.
إرجاع توقف	معلومات	يُبلغ الشريك أنه لم يتلقَ ملف TAP لمدة 7 أيام أو أكثر.

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

رموز الأخطاء

يضيف OmniRoam وصفًا لكل رمز خطأ في ملف RAP. تأتي الرموز من GSMA TD.57. تأتي معرفات المسار من TD.57 لملف TAP الأصلي، ومن TD.32 لملف RAP.

تظهر الجدول أدناه رموز الأخطاء الشائعة. راجع تحقق TAP لفئات الرموز.

الرمز	الوصف
20	عنصر بيانات مطلوب مفقود.
50	خطأ في ترميز RAP في هيكل ASN.1.
107	هيكل غير صالح.
200	البيانات ليست متوافقة مع اتفاقية التجوال.
250 إلى 257	حدث مكالمة مكرر.
260	خطأ في عمر المكالمة.
263	تنسيق طابع زمني غير صالح.

مراقبة RAP والتنبيهات

مراقب RAP هو عملية خلفية في تطبيق OmniRoam. يراقب المراقب الدلائل الواردة وينبه المشغلين بوجود ملف RAP جديد.

الخاصية	القيمة
فترة المسح	كل 4 ساعات.
الدلائل	دليل TAP الوارد ودليل RAP. يصل ملف RAP مع ملفات TAP الواردة.
طريقة التنبيه	بريد إلكتروني عبر مزود البريد الإلكتروني المكون.
إزالة التكرار	يسجل OmniRoam كل ملف تم تنبيهه. لا يقوم OmniRoam بتنبيه نفس الملف مرتين.

يسمي تنبيه البريد الإلكتروني نوع الإرجاع، وعدد الأخطاء، واسم الملف. يتضمن التنب��ه أيضًا معلومات الدفعة ورموز الأخطاء.

قم بتعيين مستلمي التنبيه وبيانات اعتماد مزود البريد الإلكتروني في تكوين وقت تشغيل التطبيق. لا تخزن بيانات الاعتماد في config.yaml.

لإرسال تنبيه اختبار لملف معروف، استخدم POST /api/rap_files/send_alert. راجع مرجع HTTP API.

قراءة ملف RAP

تقرأ واجهة برمجة تطبيقات OmniRoam والواجهة الويب ملفات RAP. تعيد الطلب إلى GET /api/rap_files/:filename محتوى RAP المعالج والمُعزز بتنسيق JSON.

يستخرج OmniRoam هذه الحقول من ملف RAP:

الحقل	الوصف
sender	رمز TADIG للشبكة التي أرسلت ملف RAP.
recipient	رمز TADIG للشبكة التي تستقبل ملف RAP.
roamingPartner	رمز TADIG لشريك التجوال.
rapFileSequenceNumber	رقم تسلسل ملف RAP.
rapFileCreationTimeStamp	وقت إنشاء ملف RAP.
tapCurrency	عملة التسوية لملف TAP الأصلي.
tapDecimalPlaces	الأماكن العشرية لملف TAP الأصلي.
returnDetailsCount	عدد الإرجاعات في ملف RAP.
totalSevereReturnValue	القيمة الإجمالية للإرجاعات الشديدة.

---

• نظرة عامة