Référence: Consultez cet article pour choisir les champs d'action et les champs de commande appropriés dans un « custo-manifest ».
Vous pouvez vous référer à cet article pour choisir les champs d'action racine et les champs de commande appropriés dans un custo-manifest. Vous découvrirez comment Rainbow utilise chaque champ et quels champs dépendent de la famille de points d'extension.
Champs d’action racine
| Champ | Description |
|---|---|
nom |
Texte affiché dans Rainbow : libellé du bouton, titre du widget ou entrée de menu. Facultatif pour les événements automatiques. |
icône / iconId
|
URL de l’icône, chemin d’accès à la ressource intégrée ou identifiant d’icône intégré. Obligatoire pour la plupart des points d’extension des boutons. |
info-bulle |
Info-bulle affichée lorsque l'on survole un bouton. |
command |
Objet obligatoire décrivant ce que Rainbow doit exécuter ou appeler. |
responseType |
Format d'affichage des résultats visibles : markdown, json ou adaptiveCard. |
displayJsonField |
Lorsqu’une réponse REST est au format JSON, ce champ identifie la propriété contenant le Markdown à afficher. |
adaptiveCardTemplate |
Modèle d’Adaptive Card intégré. |
adaptiveCardTemplateJsonField |
Champ JSON contenant le modèle Adaptive Card renvoyé par le service REST. |
adaptiveCardContentJsonField |
Champ JSON contenant les données utilisées pour remplir le modèle Adaptive Card. |
adaptiveCardSubmitUrl |
URL REST appelée via une requête POST lorsqu’une action « Action.Submit » de l’Adaptive Card est déclenchée. |
L'objet « command »
« command » : {
« url » : « https://api.example.com/customer »,
« params » : « email=${contact.email} »,
« commandType » : « rest »,
« method » : « GET »,
"header": ["Authorization: Bearer TOKEN"],
"bodyParameters": {
"user": "${localUser.email}"
}
}| Champ | Quand l’utiliser |
|---|---|
url |
Obligatoire. URL Web, point de terminaison REST, chemin d’accès à un fichier local ou chemin d’accès à une ressource intégrée. |
params |
Paramètres de requête facultatifs. Les variables sont prises en charge. |
commandType |
Facultatif. Les valeurs courantes sont « rest » et « file ». Si ce paramètre est omis, le comportement dépend du point d'extension. |
method |
Pour les commandes REST. Valeurs prises en charge : GET et POST. |
header |
Pour les commandes REST. Tableau de chaînes d’en-têtes HTTP. |
paramètres du corps |
Pour les commandes REST POST. Objet JSON envoyé en tant que corps de la requête. Les variables sont prises en charge. |
Champs secondaires
| Champ | Utilisé avec | Objectif |
|---|---|---|
AnswerOnClick |
Bouton « Appel entrant » | Répondre à l'appel lorsque l'on clique sur le bouton. |
NoShortNumber |
Événements PBX | Utilisez le numéro de téléphone complet à la place du numéro abrégé lorsque cela est pertinent. |
RaiseChangeCall |
Événements PBX | Contrôle le comportement lié au changement d'état d'un appel pour des flux de travail de Téléphonie spécifiques. |
Fenêtre contextuelle |
actions-dans-la-fenêtre-principale |
Ouvre l'application dans une fenêtre de navigateur au lieu de l'intégrer dans Rainbow. |
égalementPourLesÉquipes |
Points d’extension de l’interface graphique | Rendre l'extension accessible pour Teams lorsque cela est pris en charge. |
urlConfig |
Cas d'utilisation des widgets/cadres | URL utilisée pour configurer le widget ou l'application intégrée. |
firstNameJsonField |
Extraction des données de contact | Champ contenant un prénom dans une réponse JSON. |
lastNameJsonField |
Extraction des données de contact | Champ contenant un nom de famille dans une réponse JSON. |
companyJsonField |
Extraction des données de contact | Champ contenant le nom d’une compagnie dans une réponse JSON. |
Commandes de fichier et ressources intégrées
Sur Rainbow Desktop, la valeur commandType : « file » permet d’exécuter une application ou un script local. Sur Rainbow Web, l’exécution native n’est pas disponible ; les cas d’utilisation basés sur des fichiers doivent s’appuyer sur les ressources intégrées dans le fichier ZIP du manifeste.
« command » : {
« commandType » : « file »,
« url » : « ${custo.path}\display.html »
}
Avertissement: n’utilisez pas de chemins absolus spécifiques à une machine dans les manifestes de production. Utilisez
${custo.path} et intégrez les ressources requises dans une archive ZIP dans la mesure du possible.