Traitement des RAP
Ce guide décrit les fichiers de la Procédure de Compte Retourné (RAP) que les partenaires renvoient, et comment OmniRoam alerte les opérateurs à leur sujet.
Table des Matières
- Ce qu'est un fichier RAP
- Nom des fichiers RAP
- Types de retour et gravité
- Codes d'erreur
- Surveillance et alertes RAP
- Prise en charge et accusé de réception des fichiers RAP
- Soumission d'un fichier TAP retourné
- Lecture d'un fichier RAP
Ce qu'est un fichier RAP
Un partenaire valide chaque fichier TAP que OmniRoam envoie. Si le partenaire trouve des erreurs, le partenaire renvoie un fichier RAP. Le fichier RAP signale 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 des défauts dans le fichier TAP original. OmniRoam lit le fichier RAP, ajoute une description à chaque erreur, et alerte les opérateurs.
Nom 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 dupliqué. |
| 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 les fichiers TAP entrants. |
| Méthode d'alerte | Email via le fournisseur de messagerie 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 informations d'identification du fournisseur de messagerie dans la configuration d'exécution de l'application.
Ne stockez pas les informations d'identification 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.
Prise en charge et accusé de réception des fichiers RAP
Lorsque config.inbound_check est défini et que le rôle exporter est activé, OmniRoam prend en charge chaque fichier RAP et accusé de réception dans le répertoire RAP entrant, une fois qu'il n'a pas changé pendant
inbound_check.settle_seconds. Le répertoire est scanné toutes les inbound_check.interval_seconds.
| Fichier | Ce que fait OmniRoam |
|---|---|
RC ou RT adressé à inbound_check.home_tadig | Conserve ce que le RAP a retourné : chaque retour fatal, manquant, et d'arrêt, et les retours sévères pour chacun de nos fichiers TAP avec le nombre d'enregistrements, la valeur, et les codes d'erreur. Écrit l'accusé de réception RAP que TD.32 exige, AC ou AT avec le numéro de séquence du RAP, dans rap_output_path dans un dossier pour le partenaire. |
AC ou AT pour un RAP que nous avons envoyé | Marque que le RAP a été accusé de réception. |
Un RAP qui ne peut pas être accusé de réception, par exemple parce que rap_output_path n'est pas défini, est réessayé
au prochain scan.
| Point de terminaison | But |
|---|---|
GET /api/rap_received | Chaque fichier RAP qu'un partenaire nous a envoyé, le plus récent en premier : ses retours, notre accusé de réception, et tout fichier TAP renvoyé. |
GET /api/rap_received/:filename | Un fichier RAP qu'un partenaire nous a envoyé. |
GET /api/rap_sent | Chaque fichier RAP que nous avons envoyé, avec l'accusé de réception du partenaire lorsqu'il est arrivé. |
Soumission d'un fichier TAP retourné
Un fichier TAP qu'un partenaire a retourné avec un retour fatal est renvoyé sous le même numéro de séquence de fichier. TD.57 exige qu'il porte le numéro de séquence du fichier RAP du RAP qui l'a retourné.
POST /api/tap_resubmit avec rap_filename, tap_sequence, et commit reconstruit le fichier à partir de la
copie que nous avons envoyée, dans tap_output_path ou son répertoire _Sent. OmniRoam ajoute le numéro de séquence du fichier RAP
et un nouveau timestamp de fichier disponible. Sans commit, la réponse est un aperçu avec le
fichier reconstruit. Avec commit, OmniRoam l'écrit dans tap_output_path pour le partenaire, où le
transfert l'envoie. La soumission nécessite le rôle exporter.
Corrigez la cause du retour fatal avant de soumettre à nouveau. OmniRoam envoie les mêmes enregistrements à nouveau.
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 | Le timestamp 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. |