معالجة RAP
تصف هذه الدليل ملفات إجراء الحسابات المرتجعة (RAP) التي يعيدها الشركاء، وكيف يقوم OmniRoam بتنبيه المشغلين بشأنها.
جدول المحتويات
- ما هو ملف RAP
- تسمية ملف RAP
- أنواع الإرجاع والشدة
- رموز الأخطاء
- مراقبة RAP والتنبيهات
- استلام والاعتراف بملفات RAP
- إعادة تقديم ملف TAP المرتجع
- قراءة ملف 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. راجع مرجع API HTTP.
استلام والاعتراف بملفات RAP
عندما يتم تعيين config.inbound_check وتفعيل دور exporter، يستقبل OmniRoam كل ملف RAP واعتراف في دليل RAP الوارد، بمجرد أن لا يتغير لمدة inbound_check.settle_seconds. يتم مسح الدليل كل inbound_check.interval_seconds.
| الملف | ماذا يفعل OmniRoam |
|---|---|
RC أو RT موجه إلى inbound_check.home_tadig | يحتفظ بما أعاده RAP: كل إرجاع قاتل، مفقود، وتوقف، والإرجاعات الشديدة لكل من ملفات TAP الخاصة بنا مع عدد السجلات، القيمة، ورموز الأخطاء. يكتب الاعتراف بملف RAP الذي يتطلبه TD.32، AC أو AT مع رقم تسلسل RAP، إلى rap_output_path في مجلد للشريك. |
AC أو AT لملف RAP أرسلناه | يحدد أن RAP قد تم الاعتراف به. |
ملف RAP الذي لا يمكن الاعتراف به، على سبيل المثال لأن rap_output_path غير محدد، يتم المحاولة مرة أخرى في المسح التالي.
| نقطة النهاية | الغرض |
|---|---|
GET /api/rap_received | كل ملف RAP أرسله لنا الشريك، الأحدث أولاً: إرجاعاته، اعترافنا، وأي ملف TAP تم إرساله مرة أخرى. |
GET /api/rap_received/:filename | ملف RAP واحد أرسله لنا الشريك. |
GET /api/rap_sent | كل ملف RAP أرسلناه، مع اعتراف الشريك عند وصوله. |
إعادة تقديم ملف TAP المرتجع
يتم إرسال ملف TAP الذي أعاده الشريك مع إرجاع قاتل مرة أخرى تحت نفس رقم تسلسل الملف. يتطلب TD.57 أن يحمل رقم تسلسل ملف RAP الذي أعاده.
POST /api/tap_resubmit مع rap_filename، tap_sequence، وcommit يعيد بناء الملف من النسخة التي أرسلناها، في tap_output_path أو دليل _Sent الخاص به. يضيف OmniRoam رقم تسلسل ملف RAP وطابع زمني جديد متاح للملف. بدون commit، تكون الاستجابة معاينة مع الملف المعاد بناؤه. مع commit، يكتب OmniRoam إلى tap_output_path للشريك، حيث يتم إرساله. تتطلب إعادة التقديم دور exporter.
قم بإصلاح سبب الإرجاع القاتل قبل إعادة التقديم. يرسل OmniRoam نفس السجلات مرة أخرى.
قراءة ملف 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 | القيمة الإجمالية للإرجاعات الشديدة. |