Support
Outils de support et de diagnostic pour le personnel Xplanis : renvoi des webhooks d'envoi via le téléversement d'un fichier CSV.
La page Support met à disposition des outils spéciaux de diagnostic et de maintenance, réservés exclusivement au personnel Xplanis disposant des droits Superadmin. Elle sert à réaliser des mesures de support ciblées en cours d'exploitation – par exemple lorsque des notifications d'envoi destinées à un système tiers connecté doivent être déclenchées à nouveau.
Remarque : Cette page n'est visible et accessible qu'aux utilisateurs disposant des droits Superadmin. Les utilisateurs réguliers ne voient pas ces fonctions.
1. Navigation
La page Support est accessible via les paramètres globaux. Elle ne s'affiche que si l'utilisateur connecté dispose de l'autorisation Superadmin requise.
2. Renvoyer les webhooks d'envoi
Cette fonction permet de déclencher à nouveau les notifications webhook pour des envois sélectionnés. Cela est utile, par exemple, lorsqu'un système tiers connecté n'a pas reçu ou traité une notification et que les informations d'envoi doivent être transmises à nouveau.
Lors du renvoi, la notification est régénérée sur la base des données d'envoi actuelles. Le message envoyé initialement n'est donc pas répété ; un nouveau message est généré avec l'état actuel de l'envoi.
Procédure
- Préparer un fichier CSV contenant les envois et déclencheurs souhaités (voir section 2.1).
- Dans la zone Support, sélectionner le fichier
.csvpréparé à l'aide du champ de sélection de fichier. - Cliquer sur le bouton « Renvoyer ».
- Attendre la fin du traitement. Pendant l'envoi, la zone est verrouillée afin qu'aucune opération en double ne puisse être déclenchée.
Une fois l'opération terminée, le nombre de notifications renvoyées est communiqué en retour.
2.1 Format du fichier CSV
Le fichier à téléverser doit être un fichier CSV comportant exactement deux colonnes. La première ligne doit contenir l'en-tête suivant :
ShipmentId,Trigger| Colonne | Signification |
|---|---|
| ShipmentId | ID unique de l'envoi pour lequel la notification doit être renvoyée |
| Trigger | Déclencheur ou événement pour lequel la notification est générée |
Chaque ligne supplémentaire décrit une notification à renvoyer.
Remarque : Les entrées saisies en double sont détectées automatiquement et traitées une seule fois.
2.2 Comportement et restrictions
- Les notifications sont traitées par lots afin de garantir un traitement fiable, même pour des volumes importants.
- Si le module de contrôle des envois est actif pour un groupe, les envois qui n'ont pas encore été contrôlés sont ignorés lors du renvoi.
- Seuls les envois trouvés dans le système sont pris en compte.
3. Télécharger un fichier CSV d'exemple
Afin de pouvoir préparer le fichier au format correct, un fichier CSV d'exemple est disponible au téléchargement. Le lien correspondant ouvre un fichier modèle dans un nouvel onglet du navigateur.
Le fichier d'exemple montre :
- la structure requise à deux colonnes avec l'en-tête
ShipmentId,Trigger, - la manière dont les différentes entrées sont saisies.
Conseil : Utilisez le fichier d'exemple comme point de départ afin d'éviter les erreurs lors de la construction de l'en-tête et des colonnes.
4. Récapitulatif : fonctions disponibles
| Fonction | Description | Condition requise |
|---|---|---|
| Renvoyer les webhooks d'envoi | Déclencher à nouveau les notifications pour les envois saisis dans le CSV avec les données actuelles | Autorisation Superadmin, fichier CSV correctement formaté |
| Télécharger un fichier CSV d'exemple | Télécharger un fichier modèle au format requis | Autorisation Superadmin |