Traitement des RAP
Ce guide décrit les fichiers de la Procédure de Compte Retourné (RAP) que les partenaires retournent, et comment OmniRoam alerte les opérateurs à leur sujet.
Table des Matières
- Qu'est-ce qu'un fichier RAP
- Nommage des fichiers RAP
- Types de retour et gravité
- Codes d'erreur
- Surveillance et alertes RAP
- Lecture d'un fichier RAP
Qu'est-ce qu'un fichier RAP
Un partenaire valide chaque fichier TAP que OmniRoam envoie. Si le partenaire trouve des erreurs, le partenaire retourne un fichier RAP. Le fichier RAP rapporte les erreurs dans un fichier TAP spécifique. Le format RAP suit GSMA TD.32.
Un fichier RAP est le messager. Les codes d'erreur décrivent les défauts dans le fichier TAP original. OmniRoam lit le fichier RAP, ajoute une description à chaque erreur, et alerte les opérateurs.
Nommage des fichiers RAP
Un nom de fichier RAP a une longueur fixe de 17 caractères. Le nom reflète le nom du fichier TAP, mais utilise un préfixe RAP.
| Préfixe | Signification |
|---|---|
RC | Un retour contre un fichier TAP en direct (Données Facturables). |
RT | Un retour contre un fichier TAP de test (Données de Test). |
Le reste du nom contient l'expéditeur de 5 caractères, le destinataire de 5 caractères, et le numéro de séquence de 5 chiffres. OmniRoam ne lit que les fichiers qui commencent par RC ou RT comme fichiers RAP.
Types de retour et gravité
Un fichier RAP contient un ou plusieurs retours. Chaque retour a un type et une gravité.
| Type de retour | Gravité | Effet |
|---|---|---|
| Retour fatal | Critique | Le partenaire rejette l'ensemble du fichier TAP. |
| Retour sévère | Avertissement | Le partenaire rejette les enregistrements individuels, mais accepte le reste du fichier. |
| Retour manquant | Avertissement | Le partenaire signale un écart dans la séquence de fichiers. |
| Retour d'arrêt | Information | Le partenaire signale qu'il n'a reçu aucun fichier TAP pendant 7 jours ou plus. |
Traitez d'abord un retour fatal. Un retour fatal signifie que le partenaire a rejeté l'ensemble du fichier, et vous devez corriger le défaut et renvoyer.
Codes d'erreur
OmniRoam ajoute une description à chaque code d'erreur dans un fichier RAP. Les codes proviennent de GSMA TD.57. Les identifiants de chemin proviennent de TD.57 pour le fichier TAP original, et de TD.32 pour le fichier RAP.
Le tableau ci-dessous montre les codes d'erreur courants. Voir Validation TAP pour les catégories.
| Code | Description |
|---|---|
| 20 | Un élément de données requis est manquant. |
| 50 | Une erreur d'encodage RAP dans la structure ASN.1. |
| 107 | Une structure invalide. |
| 200 | Les données ne sont pas conformes à l'accord d'itinérance. |
| 250 à 257 | Un événement d'appel en double. |
| 260 | Une erreur d'âge d'appel. |
| 263 | Un format de timestamp invalide. |
Surveillance et alertes RAP
Le moniteur RAP est un processus en arrière-plan dans l'application OmniRoam. Le moniteur surveille les répertoires entrants et alerte les opérateurs d'un nouveau fichier RAP.
| Propriété | Valeur |
|---|---|
| Intervalle de scan | Toutes les 4 heures. |
| Répertoires | Le répertoire TAP entrant et le répertoire RAP. Un fichier RAP arrive avec des fichiers TAP entrants. |
| Méthode d'alerte | Email via le fournisseur d'email configuré. |
| Dé-duplication | OmniRoam enregistre chaque fichier alerté. OmniRoam n'alerte pas sur le même fichier deux fois. |
Une alerte par email nomme le type de retour, le nombre d'erreurs, et le nom du fichier. L'alerte inclut également les informations de lot et les codes d'erreur.
Définissez les destinataires des alertes et les identifiants du fournisseur d'email dans la configuration d'exécution de l'application.
Ne stockez pas les identifiants dans config.yaml.
Pour envoyer une alerte de test pour un fichier connu, utilisez POST /api/rap_files/send_alert. Voir la
Référence API HTTP.
Lecture d'un fichier RAP
L'API OmniRoam et l'interface web lisent les fichiers RAP. Une requête à GET /api/rap_files/:filename
retourne le contenu RAP analysé et enrichi au format JSON.
OmniRoam extrait ces champs d'un fichier RAP :
| Champ | Description |
|---|---|
sender | Le code TADIG du réseau qui a envoyé le fichier RAP. |
recipient | Le code TADIG du réseau qui reçoit le fichier RAP. |
roamingPartner | Le code TADIG du partenaire d'itinérance. |
rapFileSequenceNumber | Le numéro de séquence du fichier RAP. |
rapFileCreationTimeStamp | L'heure de création du fichier RAP. |
tapCurrency | La devise de règlement du fichier TAP original. |
tapDecimalPlaces | Les décimales du fichier TAP original. |
returnDetailsCount | Le nombre de retours dans le fichier RAP. |
totalSevereReturnValue | La valeur totale des retours sévères. |