Déploiement d'un manifeste personnalisé – Aide

Cet article vous permettra de déployer un manifeste personnalisé auprès des utilisateurs de Rainbow. Vous découvrirez la différence entre le déploiement via la console d'administration et l'importation locale, le fonctionnement de la priorité de déploiement, ainsi que la procédure à suivre pour supprimer un manifeste si nécessaire.

Présentation

Un manifeste personnalisé est un fichier JSON qui personnalise l’interface de Rainbow pour vos utilisateurs : boutons d’action, appels API, applications intégrées, widgets… Une fois déployé, il est automatiquement appliqué à chaque démarrage du client Rainbow.

Conditions de licence: les extensions du manifeste personnalisé (boutons d’action, appels API, applications intégrées, widgets) nécessitent une licence « Business » ou supérieure. Seuls les événements PBX (surveillance des appels entrants/sortants) sont disponibles sans licence « Business ».

Il existe deux modes de déploiement :

Mode	Qui	Portée	Priorité
Console d'administration	Vous, depuis la console d'administration	Tous les clients utilisateurs (Web + Bureau, toutes les sessions)	A la priorité
Importation locale	Utilisateur final	Uniquement l’ordinateur ou le navigateur utilisé pour l’importation	Remplacé par le déploiement via la console d’administration de l’administrateur

Remarque: le déploiement par l’administrateur a toujours la priorité. Si un manifeste est attribué via la console, il remplace toute importation locale et l’option Importation/Exportation disparaît du client Rainbow.

Désactivation de l’importation locale: vous pouvez désactiver l’option « Import/Export » pour vos utilisateurs via les profils : Compagnie → Profils → [profil] → Autorisations → Manifeste personnalisé. Une fois désactivée, l’option disparaît du menu du client et seul le manifeste attribué depuis la console d’administration est appliqué.

Déploiement via la console d’administration

Il s’agit de la méthode recommandée pour l’environnement de production. Vous téléchargez le manifeste une seule fois, puis Rainbow l’applique automatiquement à tous les utilisateurs concernés.

Écran de configuration

Le manifeste et les domaines de confiance sont configurés au même endroit :

Compagnie → Informations → Personnalisation

Console Rainbow — Compagnie → Informations → Personnalisation

Importation dans la console

Accédez à Compagnie → Informations → Personnalisation → Custo-manifest
Cliquez sur « Importer » et sélectionnez le fichier .json ou .zip
Vérifiez que le manifeste apparaît dans la liste

Attribuer aux utilisateurs

Deux méthodes d’attribution :

Par utilisateur individuel

Accédez à Membre → Informations → Manifeste personnalisé
Sélectionnez le manifeste à appliquer

Par profil d'utilisateur

Accédez à Compagnie → Profils
Modifiez le profil → section Custo-manifest
Sélectionnez le manifeste — il s’applique à tous les membres du profil

Par provisionnement en masse (importation CSV ou synchronisation LDAP)

L’affectation du « custo-manifest » peut être incluse dans une importation CSV en masse ou dans une synchronisation LDAP
Le champ correspondant dans le fichier CSV est « selectedAppCustomisationTemplate »
Dans LDAP, l’attribut sélectionné est également « AppCustomisationTemplate »

Remarque: cette méthode est particulièrement adaptée à l’attribution d’un manifeste à un grand nombre d’utilisateurs en une seule opération.

Prise en charge par le client

Le manifeste déployé est automatiquement téléchargé au prochain démarrage du client. Aucune action n’est requise de la part de vos utilisateurs.

Web: le manifeste est chargé au début de chaque session. Une mise à jour prend donc effet lors de la prochaine connexion.

Bureau: le manifeste est téléchargé au démarrage de l’application.

Domaines de confiance

Avant le déploiement, vérifiez que toutes les origines d’URL référencées dans le manifeste sont déclarées dans :

Compagnie → Informations → Personnalisation → Domaines Custo-manifest

Sans cette déclaration, un avertissement s’affiche au moment du chargement et les extensions échouent sans message d’erreur. Consultez l’article Sécurité réseau et domaines de confiance pour les extensions Custo-manifest.

Mise à jour d’un manifeste déployé

Modifiez le manifeste

Modifiez le fichier JSON localement
Dans la console : Compagnie → Personnalisation → Custo-manifest → Remplacer
Importez la nouvelle version

L'ancienne version est remplacée. Les clients la téléchargent lors de leur prochain démarrage.

Remarque: il n’y a pas de gestion automatique des versions dans la console Rainbow. Conservez les versions précédentes localement afin de pouvoir revenir en arrière si nécessaire.

Forcer le rafraîchissement (Web)

Sur Rainbow Web, vider le cache du navigateur ou vous déconnecter puis vous reconnecter force le rechargement du manifeste.

Supprimer le manifeste

Pour supprimer le manifeste d’un de vos utilisateurs : rendez-vous dans Membre → Informations → Manifeste client et sélectionnez « Pas de manifeste ». Le client revient à son état par défaut au prochain démarrage.

Importation locale (développement et tests)

L’importation locale permet à un utilisateur de charger un manifeste directement dans son client Rainbow sans passer par la console d’administration. Elle est recommandée pour la phase de développement et les tests préalables au déploiement.

Portée limitée: un manifeste importé localement ne s’applique qu’à la machine ou au navigateur utilisé pour l’importation. Il ne suit pas l’utilisateur sur d’autres postes de travail ou lors d’autres sessions.

Importation dans Rainbow Desktop

Ouvrez Rainbow Desktop
Accédez à Paramètres → Téléphonie → Personnalisation
Cliquez sur « Importer » et sélectionnez le fichier .json ou .zip
Le manifeste est appliqué immédiatement

Pour obtenir un modèle de départ : cliquez sur « Exporter » avant toute importation — Rainbow génère un fichier d’exemple contenant tous les points d’extension pris en charge.

Importation dans Rainbow Web

L’importation locale sur Rainbow Web suit la même procédure que sur la version de bureau (menu Paramètres → Personnalisation), mais est limitée au navigateur actuellement utilisé.

Configuration héritée via l’interface de ligne de commande (CLI)

Procédure obsolète: privilégiez le déploiement via la console d’administration. Le déploiement centralisé a la priorité sur ce mode de configuration Desktop hérité et est plus facile à gérer.

Pour les anciennes intégrations de Rainbow Desktop, un manifeste pouvait être fourni au moment de l’installation à l’aide de l’option de configuration /Custom.

RainbowSetup.exe /Custom=C:\chemin\vers\manifest.json

Lorsque ce mode est utilisé, l’option Importation/Exportation est masquée pour l’utilisateur final. Si un administrateur attribue ultérieurement un manifeste via la console d’administration Rainbow, le manifeste déployé de manière centralisée prévaut.

Problèmes courants

Le manifeste n’est pas appliqué

Cause probable	Comment vérifier	Solution
Le manifeste n'est pas attribué à l'utilisateur	Console → Membre → Manifeste client	Attribuez le manifeste
Le client n'a pas été redémarré	—	Demandez à l’utilisateur de redémarrer Rainbow
JSON non valide	Outils de développement → Console → erreurs lors du chargement	Vérifiez la validité du JSON (à l’aide d’un outil en ligne ou de Rainbow Generator)
Importation locale désactivée par l’administrateur	L'option d'importation/exportation est manquante	Utilisez le déploiement par l'administrateur

Un avertissement s'affiche lors du chargement du manifeste

Le manifeste fait référence à une URL dont l'origine n'est pas déclarée dans les domaines de confiance.

Solution : déclarez l’origine dans Compagnie → Personnalisation → Domaines de manifests personnalisés.

Avertissement: le fait de fermer l’avertissement ne résout pas le problème — les extensions concernées échoueront silencieusement lors de l’exécution.

Les extensions n’apparaissent pas dans le client

Cause probable	Solution
Manifeste attribué mais client non redémarré	Redémarrez Rainbow
Point d'extension non pris en charge sur le client (Web ou bureau)	Vérifiez la compatibilité des points d'extension Web/bureau dans la documentation
Nombre maximal d’actions atteint (3 par point d’extension)	Réduisez le nombre d'actions dans le manifeste
Importation locale remplacée par le manifeste administrateur	Comportement attendu — le manifeste administrateur est prioritaire

L’importation locale n’est pas possible (option grisée ou manquante)

L’administrateur a désactivé l’importation locale via le profil. Contactez l’administrateur Rainbow pour obtenir un accès ou demander un déploiement via la console.

Liste de contrôle pour le déploiement en pré-production

Fichier JSON validé (aucune erreur de syntaxe, présence des éléments « version » : « 2 » et « jsonType »)
Manifeste testé via une importation locale sur Rainbow Desktop et Web
Toutes les origines d’URL déclarées dans les domaines du Custo-manifest
En cas de ressources locales : archive ZIP créée avec le fichier custo-manifest.json à la racine
Manifeste attribué aux bons utilisateurs ou profils dans la console