Intégration Cisco WebEx

Contents

À propos de cette intégration

SAS_IntegrationNotRESTIntroduction

Il existe plusieurs moyens d’intégrer des systèmes tiers avec Product name - ev sas.png. Cela, en fonction des besoins métiers, des contraintes d’architecture et de sécurité en vigueur ainsi que des spécificités de chaque application ou service tiers. Notamment, vous pouvez utiliser les datasources REST, CSV, Online CSV ainsi que le widget Html Script.

Cette page présente un processus d’intégration type déjà mis en œuvre dans un contexte client.

Pour plus de détails sur cette intégration, veuillez contacter les départements "Consulting & Professional Services" et Support d'Logo - EasyVista.png ou vos fournisseurs de services et intégrateurs habituels.

Synthèse de l'intégration

Cette intégration permet de rediriger les utilisateurs d'applications Product name - ev sas.png vers des pages particulières du site WebEx, via un widget Button ou un widget Menu.

     Example documentation icon FR.png  Accès direct à une page WebEx pour consulter la liste des conférences déjà planifiées, planifier une conférence, joindre une conférence
 

Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Product name - ev sas - big.png

Up arrow.png

Logo - Cisco WebEx.png

N/A

Widget Menu   Apps - Widget - Menu icon.png

Widget Button   Apps - Widget - Button icon.png

Version SaaS du produit tiers

Version On-premise du produit tiers

Check icon.png

Not check icon.png

Processus d'intégration pas à pas

    Open url.png  Pour connaître les différentes possibilités d’intégrer Cisco WebEx Conferencing à des applications via des API, voir la page WebEx Developer (EN)

Cisco met à disposition des développeurs 3 API pour intégrer WebEx Web Conferencing à des applications tierces :

  • URL API : propose des fonctions pouvant être appelées par des applications tierces en s’appuyant sur http(s) ;
  • XML API : propose un ensemble de services supportant la plupart des fonctionnalités de WebEx Conferencing Services et permet de répondre à des requêtes HTTP Post d’applications tierces en XML ;
  • Téléconférence Service Provider (TSP) API : permet aux fournisseurs de services de conférences téléphoniques d’intégrer leurs services de téléconférence audio dans WebEx.
     

Cisco intègre également la fonctionnalité WebEx Common Entry Point (CEP) (ou URL Links), qui permet, depuis une application tierce, de naviguer facilement vers des pages particulières d’un site WebEx pour répondre à différents besoins.
    Example documentation icon FR.png  Voir la liste des conférences déjà planifiées ; Planifier une conférence ; Joindre une conférence

Avec cette fonctionnalité, WebEx Conferencing peut être intégré avec Product name - ev sas.png en 2 étapes simples :

Note : WebEx interdit l’affichage de WebEx CEP et de pages de sites WebEx dans des applications tierces via le paramètre X-Frame-Options SAMEORIGIN. Pour cette raison :

  • vous ne pouvez pas utiliser les widgets Html Script et Secured Html avec une balise iframe de type <iframe src="https://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MO"></iframe> pour intégrer directement des pages de votre site WebEx dans vos applications Product name - ev sas.png ;
  • cette intégration utilise donc les widgets Button et Menu : les pages de votre site WebEx sont ouvertes dans un nouvel onglet de l’instance de votre navigateur.


Étape 1: Identifier l'URL (WebEx CEP) de redirection des utilisateurs

    Open url.png  Voir les détails de la fonctionnalité WebEx Common Entry Point (CEP)

  • Les WebEx CEP fournis par Cisco permettent d’exposer ou d’inclure directement des fonctionnalités de WebEx Conferencing dans des applications tierces sans avoir à modifier leur interface, et d'utiliser URL API ou XML API.
  • La plupart des WebEx CEP incluent un frameset incluant une barre de navigation supérieure et un bandeau à gauche, et généralement le logo de votre société. 

Note : D’un point de vue conception d’applications :

  • les WebEx CEP avec frameset permettent aux utilisateurs de naviguer dans l’intégralité de l’interface de Cisco WebEx Conferencing et d’accéder directement à d’autres fonctionnalités : option à privilégier pour de grands écrans ;
  • les WebEx CEP sans frameset permettent d'intégrer une fonctionnalité unique de WebEx Conferencing (avec son interface) et prennent moins de place : option à privilégier pour de petits écrans (mobiles et smartphones) ou si vous ne souhaitez pas laisser à l’utilisateur la possibilité d’utiliser d’autres fonctionnalités.
Avec frameset Sans frameset
WebEx CEP - frameset on.png WebEx CEP - frameset off.png
  • L’URL racine pour les WebEx CEP est http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/.
        Example documentation icon FR.png  https://easyvista.webex.com/easyvista
  • 4 WebEx CEP sont particulièrement utiles et simples à utiliser :
    • My WebEx Meetings :  présente la liste des conférences planifiées de l’utilisateur (pour la date courante)
      • avec frameset : http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MO
      • sans frameset : http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MONF
    • My WebEx - Scheduling Meetings : permet à l’utilisateur de planifier une conférence ou de démarrer un meeting impromptu
          http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=CM
    • My WebEx - Joining a Meeting : permet à l’utilisateur de joindre une conférence en fournissant son numéro (meeting Key)
          http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?JM
    • My WebEx Home Page : présente la page d’accueil de votre site WebEx telle qu’elle est définie dans l’outil Site Admin
          Example documentation icon FR.png  page Démarrer une conférence
      • avec frameset : http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MH
      • sans frameset : http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MHNF

Note : Hormis le WebEx CEP Joining a Meeting, l’utilisateur doit être logué à son compte WebEx dans l’instance de son navigateur pour accéder directement à l’URL définie. S’il n’est pas logué, il est automatiquement redirigé sur la mire de login du site WebEx Conferencing défini dans le WebEx CEP.
         Example documentation icon FR.png  WebEx Conferencing - login.png


Étape 2 : Intégrer dans une application Product name - ev sas.png l’URL (WebEx CEP) choisie

Il y a plusieurs moyens d’intégrer un lien vers un WebEx CEP, dépendant de plusieurs facteurs tels que le type d’application (son ergonomie, son rôle et les fonctionnalités proposées), le nombre de WebEx CEP à intégrer, les habitudes de navigation de vos utilisateurs, etc.
Les 3 exemples d’intégration ci-dessous décrivent différentes possibilités, en utilisant l'application modèle IT Portal :


Exemple 1 : Intégrer un lien vers un WebEx CEP dans le widget Menu principal de l'application

Description : Le dernier élément de menu Knowledge Base de la page d’accueil de l'application modèle IT Portal est remplacé par un élément de menu My WebEx qui redirige l’utilisateur vers la liste de ses conférences planifiées.

Description Représentation
Clic sur l'élément My WebEx du widget Menu principal de l'application WebEx CEP - Example 1 - step 1.png
Ouverture d'un nouvel onglet du navigateur, affichant la page My WebEx Meetings du site WebEx WebEx CEP - Example 1 - step 2.png

Procédure de mise en oeuvre :

1. Allez sur Product name - ev sas.png :

  • définissez une application s'appuyant sur l'application modèle IT Portal ;
  • renommez l'élément de menu Knowledge Base en My WebEx.

2. Intégrez le lien vers le WebEx CEP My WebEx Meetings :

  • dans le volet Conception, cliquez sur le widget Menu principal de l'application ;
  • cliquez sur Apps - Edit icon.png en regard de l'élément de menu My WebEx puis, via la fenêtre de propriétés :
    • dans la zone Link Type, sélectionnez l’option Href (New Window), permettant d'ouvrir un nouvel onglet du navigateur ;
    • dans la zone Link qui s'affiche dessous, saisissez le WebEx CEP My WebEx Meetings, sous la forme http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MO ;
    • cliquez sur [ OK ].

3. Cliquez sur EVApps - GUI - Execute icon.png pour passer en mode Visualisation et testez le bon affichage et fonctionnement de votre application.

 


Exemple 2 : Intégrer plusieurs liens vers différents WebEx CEP accessibles depuis une page de l'application

Description : Le dernier élément de menu Knowledge Base de la page d’accueil de l'application modèle IT Portal est remplacé par un élément de menu My WebEx qui redirige l’utilisateur vers une page de l'application dans laquelle un widget Menu permet l'accès à différentes pages de votre site WebEx.

Description Représentation
Clic sur l'élément de menu My WebEx du widget Menu principal de l'application WebEx CEP - Example 2 - step 1.png
Ouverture de la page My WebEx (Multi Links) de l'application, contenant différents éléments de menu (images) sur lesquels l’utilisateur peut cliquer, le redirigeant vers différentes pages de votre site WebEx WebEx CEP - Example 2 - step 2.png
Clic sur l’image My WebEx - Sheduling Meetings, ouvrant la page de votre site WebEx permettant de planifier une nouvelle réunion WebEx CEP - Example 2 - step 3.png

Procédure de mise en oeuvre :

1. Allez sur Product name - ev sas.png :

  • définissez une application s'appuyant sur l'application modèle IT Portal ;
  • renommez l'élément de menu Knowledge Base en My WebEx.

2. Créez une page My WebEx (Multi Links) et intégrez les liens vers votre site WebEx :

  • dans le volet Objets, cliquez sur Apps - Add widget icon.png ; ouvrez la catégorie Basic et cliquez-glissez le widget Menu sur le volet Conception ;
  • pour chaque lien de redirection que vous souhaitez proposer :
    • dans la section Data, cliquez sur [ ADD ITEM ] ; 
    • dans la zone Label, renseignez le libellé de l'élément de menu ; cliquez sur O pour associer une icône ;
    • cliquez sur Apps - Edit icon.png puis, via la fenêtre de propriétés, intégrez le lien vers le WebEx CEP souhaité :
      • dans la zone Link Type, sélectionnez l’option Href (New Window), permettant d'ouvrir un nouvel onglet du navigateur ;
      • dans la zone Link qui s'affiche dessous, saisissez le WebEx CEP souhaité ;
                 Example documentation icon FR.png  WebEx CEP My WebEx Meetings, sous la forme http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MO
      • cliquez sur [ OK ].

3. Définissez le lien d'accès à la nouvelle page My WebEx (Multi Links) :

  • sélectionnez la page principale de l'application ; 
  • dans le volet Conception, cliquez sur le widget Menu principal ;
  • cliquez sur Apps - Edit icon.png en regard de l'élément de menu My WebEx puis, via la fenêtre de propriétés :
    • dans la zone Link Type, sélectionnez l’option Page Link, permettant d'ouvrir une page de l'application ;
    • dans la zone Select Page qui s'affiche dessous, sélectionnez la page My WebEx (Multi Links) ;
    • cliquez sur [ OK ].

4. Cliquez sur EVApps - GUI - Execute icon.png pour passer en mode Visualisation et testez le bon affichage et fonctionnement de votre application.

 

Best Practice icon.png  Pour organiser au mieux les éléments de menu dans la page, vous pouvez définir des cellules vides :

  • indiquez dans le champ Columns Number le nombre total de colonnes ;
  • pour chaque cellule vide, saisissez dans le champ Label la valeur &nbsp (identifiant un espace en code Html) ;
  • cliquez sur Apps - Edit icon.png en regard de l'élément de menu ; dans la fenêtre de propriétés, dans la zone Link Type, sélectionnez l’option Disabled permettant de désactiver le lien hypertexte rattaché à l’élément de menu.
     

Example documentation icon FR.png  Le widget Menu contient 3 colonnes :

  • les boutons actifs (1) affichent une image et pointent sur les liens des WebEx CEP ; 
  • le bouton central (2) affiche le logo Cisco WebEx et pointe sur un lien inactif ; 
  • les cellules vides (3) ont comme nom &nbsp et pointent sur un lien inactif.
             WebEx CEP - Example 2 - Best Practice.png

 


Exemple 3 : Intégrer un lien vers un WebEx CEP dans un widget Button

Description : Le widget YouTube de la page d’accueil de l'application modèle IT Portal est remplacé par un widget Button My WebEx Meetings qui redirige l’utilisateur vers la liste de ses conférences planifiées.

Description Représentation
Clic sur le bouton My WebEx Meetings de l'application WebEx CEP - Example 3 - step 1.png
Ouverture d'un nouvel onglet du navigateur, affichant la page My WebEx Meetings du site WebEx WebEx CEP - Example 3 - step 2.png

Procédure de mise en oeuvre :

1. Allez sur Product name - ev sas.png :

  • définissez une application s'appuyant sur l'application modèle IT Portal ;
  • supprimez le widget YouTube.

2. Intégrez le lien vers le WebEx CEP My WebEx Meetings :

  • dans le volet Objets, cliquez sur Apps - Add widget icon.png ; ouvrez la catégorie Basic et cliquez-glissez le widget Button sur le volet Conception, à l'emplacement libre du widget YouTube ; renommez-le en MyWebEx Meetings ;
  • dans le champ Label, renommez le bouton en My WebEx Meetings ; ajoutez éventuellement une image et appliquez le style de votre choix ;
  • dans le champ URL to Load, saisissez le WebEx CEP My WebEx Meetings, sous la forme http(s)://yourWebExHostedName.webex.com/yourWebExHostedName/e.php?AT=MO ;
  • dans le champ Target, sélectionnez l’option New Window, permettant d'ouvrir un nouvel onglet du navigateur.

3. Cliquez sur EVApps - GUI - Execute icon.png pour passer en mode Visualisation et testez le bon affichage et fonctionnement de votre application.

Tags :
Powered by XWiki © EasyVista 2022