Configurer AbaReport
Afficher des rapports Abacus personnalisés dans le cockpit d’appel
Aperçu
Avec AbaReport, echo affiche les résultats de rapports Abacus personnalisés dans le cockpit d’appel. Vous configurez le rapport dans Abacus avec l’application Q948 AbaReport, puis l’ajoutez sous Paramètres → Abacus dans echo. Plusieurs rapports peuvent être configurés ; chacun apparaît dans son propre onglet du widget AbaReport.
Prérequis
- Vous disposez d’un accès administrateur aux paramètres Abacus de l’organisation dans echo.
- Un utilisateur de service Abacus a accès aux rapports et aux données nécessaires, avec un ID client et un Secret client pour accéder à l’API AbaReport.
1. Configurer le rapport dans Abacus
Ouvrez Q948 AbaReport dans Abacus et créez ou configurez le rapport à afficher dans echo.
- Définissez les données et les éventuels filtres du rapport.
- Si le résultat doit dépendre du contact sélectionné ou de la recherche, définissez des paramètres d’entrée adaptés dans le rapport.
- Configurez le rapport pour le format de sortie souhaité : JSON pour les données structurées ou texte pour le texte brut.
- Notez le nom exact du rapport et les noms de ses paramètres d’entrée.
- Testez le rapport dans Abacus avec des valeurs de paramètres représentatives et assurez-vous que l’utilisateur de service peut l’exécuter.
Les paramètres d’entrée dans echo doivent correspondre à ceux définis dans le rapport. Il n’existe pas de nom de paramètre universel : utilisez les noms de votre propre configuration Q948.
2. Ajouter le rapport dans echo
Ouvrez Paramètres → Abacus, développez la section facultative AbaReport dans les paramètres de connexion du mandant, puis saisissez l’ID client et le Secret client AbaReport. Il s’agit des identifiants de l’utilisateur de service pour l’exécution des rapports ; ils ne sont pas nécessairement identiques aux identifiants de la connexion du mandant existante.
Cliquez sur + Ajouter un rapport et remplissez les champs :
| Champ | Description |
|---|---|
| Nom d’affichage | Libellé de l’onglet du rapport dans le cockpit d’appel, p. ex. Aperçu client. |
| Nom du rapport | Nom exact du rapport configuré dans Q948 AbaReport. |
| Rendu | Affichage du résultat dans echo. Commencez par Auto ; voir les options d’affichage ci-dessous. |
| Format de sortie | json pour les résultats structurés ou txt pour le texte brut. Doit correspondre à la sortie du rapport. |
| Paramètres d’entrée | Paires nom/valeur transmises au rapport. Utilisez des valeurs fixes ou les valeurs de contexte décrites ci-dessous. |
Ajoutez d’autres rapports si nécessaire, puis cliquez sur Enregistrer pour sauvegarder les paramètres du mandant.
3. Associer les paramètres d’entrée
Pour chaque paramètre du rapport, cliquez sur + Ajouter un paramètre. Saisissez son nom exactement comme dans Abacus et choisissez une valeur :
| Valeur dans echo | Valeur transmise à Abacus |
|---|---|
company.id | ID Abacus de l’entreprise associée au contact sélectionné. |
person.id | ID Abacus de la personne associée au contact sélectionné. |
search.query | Texte de recherche actuel, sans espaces en début ni en fin. |
Texte fixe, p. ex. Open | Texte configuré, sans espaces en début ni en fin. |
Utilisez les valeurs de contexte comme valeur complète, sans accolades ni texte supplémentaire. Par exemple, si votre rapport définit un paramètre nommé SubjectNumber, saisissez SubjectNumber comme nom et company.id comme valeur. SubjectNumber n’est qu’un exemple ; remplacez-le par le nom réel du paramètre de votre rapport.
person.id. Configurez dans Q948 des valeurs par défaut ou une gestion adaptée des paramètres manquants, et testez des contacts de type entreprise et personne.Options d’affichage
| Rendu | Sortie de rapport adaptée |
|---|---|
| Auto | Choisit automatiquement un tableau pour des lignes JSON, clé/valeur pour un objet JSON, ou un affichage brut dans les autres cas. |
| Tableau | Un tableau JSON d’objets représentant des lignes, ou un objet JSON dont la propriété data contient un tel tableau. Les clés des objets deviennent les en-têtes des colonnes. |
| Clé/Valeur | Un objet JSON contenant des champs individuels, plutôt qu’un tableau de lignes. |
| Brut | Texte brut ou sortie JSON du rapport, affiché sous forme de texte. |
Pour les rapports tabulaires, choisissez le format json avec Auto ou Tableau. Pour les rapports textuels, choisissez txt avec Auto ou Brut.
Vérifier le résultat dans le cockpit d’appel
Recherchez un contact Abacus dans echo et ouvrez le cockpit d’appel. Le widget AbaReport apparaît pour les contacts provenant d’Abacus lorsque les identifiants et au moins un rapport sont configurés et que la fonction est activée. Les rapports se chargent automatiquement pour le contexte actuel du contact et de la recherche. Sélectionnez un onglet pour afficher un autre rapport.
Vérifiez que le résultat correspond au contact sélectionné, puis recommencez avec un autre contact pour contrôler l’association des paramètres.
Dépannage
| Problème | Points à vérifier |
|---|---|
| Le widget est absent | Sélectionnez un contact provenant d’Abacus. Vérifiez l’activation de la fonction, l’ID client et le Secret client AbaReport, ainsi qu’au moins un rapport avec un Nom du rapport renseigné. Vérifiez aussi que le widget AbaReport est activé dans votre disposition du cockpit. |
| Le rapport ne peut pas être chargé | Vérifiez le nom du rapport, les identifiants et les autorisations de l’utilisateur de service, ainsi que l’exécution du rapport dans Q948. Les rapports longs peuvent dépasser le délai d’exécution ; réduisez leur périmètre si nécessaire. |
| Le résultat est vide ou correspond au mauvais contact | Vérifiez les noms des paramètres, le choix entre company.id et person.id, et les filtres du rapport. Le contact sélectionné doit posséder l’ID Abacus correspondant. |
| Les données structurées ne s’affichent pas comme prévu | Vérifiez le format de sortie et la structure JSON. Choisissez Brut pour examiner la sortie reçue, ou Auto pour laisser echo choisir l’affichage. |