Macros

Une macro est un petit programme JavaScript qui s'exécute localement sur votre périphérique. Par exemple, vous pouvez programmer votre périphérique pour répondre automatiquement aux appels entrants provenant de numéros spécifiques.

Les macros peuvent exécuter des commandes API (Application Programming Interface) pour vos périphériques, ainsi que pour les systèmes tiers.

Toutes les macros actives sont exécutées dans un seul processus sur le périphérique, appelé Runtime. À partir de l'interface Web du périphérique, vous pouvez démarrer et arrêter l'exécution, selon vos besoins. L’runtime est sandboxé et le code est isolé en toute sécurité du logiciel standard du périphérique.

Vous pouvez gérer les macros à partir du Control Hub ou de l’éditeur de macros sur l’interface Web du périphérique. Pour configurer les macros à partir du Control Hub, vous devez préalablement activer le provisionnement des macros pour vos périphériques.

Dans le Control Hub, vous pouvez voir les modifications apportées aux macros dans l’historique du périphérique.

Extensions de l’IU

Une extension de l’IU est un bouton ou un panneau personnalisé que vous créez vous-même et que vous ajoutez à l’écran tactile de votre périphérique. Par exemple, ajoutez un bouton « Numéro rapide » pour appeler un numéro fréquemment utilisé, ou programmez votre périphérique pour répondre automatiquement aux appels à partir de numéros spécifiques.

Les extensions de l’IU peuvent également contrôler les périphériques tiers, tels que les lumières, les stores et les commutateurs vidéo. Lorsque le périphérique vidéo et les périphériques sont contrôlés à partir de la même interface utilisateur, vous obtenez une expérience utilisateur homogène au cours de la salle de réunion. La communication avec les systèmes de contrôle tiers est effectuée via l’API tierce.

La plate-forme ouverte vous permet de créer des personnalisations qui s’attachent à vos workflows existants ; ce qui vous permet de créer une valeur supplémentaire au-delà de l’offre principale de Webex.

Certains exemples incluent :

  • Affichage des données de serveur Web personnalisées sur l’écran principal.

  • Signaler des problèmes à un système de ticketing.

  • Collecter des données acoustiques de la salle et les envoyer à un serveur Web où elles peuvent être machuées.

  • Contrôle des périphériques tiers, tels que les lumières, les stores et les commutateurs vidéo.

Vous pouvez créer des extensions d'interface utilisateur à partir de l'éditeur d'extensions d'interface utilisateur dans l'interface Web du périphérique.

L’activation du provisionnement des macros vous permet d’accéder en lecture et en écriture aux macros périphérique par périphérique à partir du Control Hub. Une fois cette option activée, tous les périphériques enregistrés en mode partagé chargeront leurs macros dans Control Hub. Les administrateurs peuvent alors modifier le code source des macros, télécharger des copies locales et charger les macros sur d’autres périphériques.

Pour activer le provisionnement des macros, allez dans Périphériques > Paramètres > Macros dans Control Hub et basculez sur Autoriser Control Hub à gérer les macros.


  • Toutes les macros du Control Hub sont stockées et chiffrées, mais pas en utilisant la clé privée des clients, dans le Cloud Cisco. Si vos macros contiennent des données confidentielles, vous ne devez pas activer le provisionnement des macros du Control Hub.

  • Le provisionnement des macros du Control Hub ne s’applique qu’aux périphériques en mode partagé.


Vous devez préalablement activer le provisionnement des macros par le Control Hub, comme décrit ci-dessus.

Le provisionnement des macros est fourni sur une base mono-périphérique. Pour partager des macros entre des périphériques, vous pouvez télécharger une macro à partir d’un périphérique, puis la charger sur un autre périphérique.

Pour accéder aux macros des périphériques en mode partagé :

  1. À partir de l’affichage du client dans https://admin.webex.com, allez à Périphériques et sélectionnez le périphérique que vous souhaitez configurer.

  2. Allez à Configurations et sélectionnez Macros.


Panneau des macros de périphériques du Control Hub

À partir d’ici, vous pouvez :

  • Créer, modifier et supprimer des macros.

  • Charger et télécharger des macros (*.js).

  • Activer ou désactiver les macros.

  • Enregistrez vos modifications

  • Afficher les journaux de macros.


Si quelqu'un a modifié simultanément la ou les mêmes macros à partir d'un autre emplacement Web, des options vous sont présentées pour télécharger une copie de votre version, annuler votre version ou écraser l'autre version.

L’éditeur Macro fournit un éditeur de code, des outils de journalisation et des commandes pour des tests rapides des macros.


Éditeur Macro

Connectez-vous à l’interface Web du périphérique en utilisant les informations d’identification Admin et allez dans Personnalisation > Éditeur de macros. À partir d’ici, vous pouvez :

  • Créer, modifier et supprimer des macros.

  • Importer ou exporter les macros (*.js).

  • Activer ou désactiver les macros.

  • Revoir les journaux de débogage.

  • Enregistrer vos modifications (Ctrl+S)


    Si quelqu’un a modifié la même macro simultanément à partir d’un autre emplacement Web, des options vous sont présentées pour télécharger une copie de votre version, ignorer votre modification, ou ignorer l’autre version.

L’éditeur des extensions de l’IU fournit des outils pour créer :

  • Boutons d’action - Un bouton a été ajouté à la page d’accueil. Le bouton Action peut être programmé pour effectuer des actions lorsqu’un utilisateur tape dessus.

  • Panneaux - Un panneau de commandes/panneau de configuration peut contenir de nombreux éléments de l’IU (par ex. des boutons, des champs de texte, des commutateurs, des curseurs), qui peuvent tous être programmés pour effectuer des actions. Ceci peut vous permettre de combiner votre propre groupe de commandes dans un emplacement commun.

  • Applications Web – Un raccourci de l’application Web ajouté à la page d’accueil. L’application Web lancera une page Web prédéfin face à plein écran. Ceci est disponible sur tous les périphériques ayant un moteur Web (c.-à-d. les périphériques board et de série de bureau, à l’exception de DX).

Connectez-vous à l'interface Web du périphérique en utilisant les informations d'identification Admin, ControlSalle ou Intégrateur et allez dans Personnalisation > Éditeur d'extensions de l'interface utilisateur.


Éditeur d’extensions IU

À partir d’ici, vous pouvez :

  • Ajouter, charger, télécharger, ou supprimer une extension de l’IU.

  • Créer et configurer de nombreux types de commandes .

  • Configurer une extension de l’IU sur Actif(s) et Inactif(s).

  • Définir quand l’extension de l’IU sera visible.

  • Exportez vos extensions IU vers le périphérique vidéo ou un fichier sur votre ordinateur.

Pour connecter une extension de l’IU à une macro, vous devez utiliser l’ID unique pour l’élément. Par exemple, l’ID de votre bascule peut être «lights_on». Ensuite, vous écriviez une macrolights_onqui contrôle les tapes d’écran et lorsqu’il détecte que le bouton « » a été tapé, la commande désirée est émise (par ex. activer/désactiver les lumières).

Pour des exemples de connexion d'extensions d'interface utilisateur à des macros, voir ici.