Présentation de l’architecture des services Web Adobe Connect

Les services Web Adobe® Connect™ constituent la couche de services Web au-dessus de la suite d’applications Adobe Connect Server.

Les services Web vous permettent de créer des portails ou des applications web qui intègrent les fonctionnalités et les informations des rapports Adobe Connect à des systèmes tiers tels que des portails, des systèmes de gestion de la relation client et des systèmes de planification des ressources d’entreprise.

Par exemple, vous pouvez utiliser un système central de gestion des utilisateurs, par exemple un annuaire LDAP, Microsoft Active Directory ou un autre système tiers, qui fait partie intégrante de vos processus d’entreprise.

Les services Web vous permettent d’écrire une application qui synchronise les utilisateurs entre votre système et Adobe Connect. L’application peut utiliser la plate-forme J2EE ou une autre technologie de votre choix pour extraire une liste d’utilisateurs de l’annuaire, la comparer à une liste d’utilisateurs Adobe Connect, puis effectuer les mises à jour demandées dans le référentiel d’utilisateurs Adobe Connect, comme l’ajout ou la suppression d’utilisateurs ou de groupes.

Les flux de données entre les applications clientes et Adobe Connect sont présentés dans le diagramme suivant. Les applications personnalisées que vous écrivez utilisent les chemins 1 à 2 et A à B. Les applications Adobe Connect (par exemple Adobe Connect Meeting, Adobe Connect Training ou Adobe Connect Events) peuvent utiliser n’importe lequel des chemins de flux de données.

Le flux de données peut être chiffré avec SSL ou non chiffré.

Si le flux de données n’est pas chiffré, les connexions passent par HTTP et Adobe Real Time Messaging Protocol (RTMP), et empruntent les chemins décrits dans le tableau suivant.

Si le flux de données est chiffré, les connexions passent de manière sécurisée par HTTPS et RTMPS (Real Time Messaging Protocol over SSL), comme suit.

Applications personnalisées

Les services Web Adobe Connect fournissent une API XML. Votre application doit donc pouvoir communiquer avec Adobe Connect en utilisant XML par HTTP ou XML par HTTPS. Votre application appelle l’API en construisant une URL de demande et en lui transmettant un ou plusieurs paramètres, soit sous forme de paires nom/valeur, soit sous forme d’un document XML. Les services Web renvoient une réponse XML, dont vous pouvez extraire les valeurs.

Les applications personnalisées récupèrent les métadonnées de la base de données Adobe Connect. Ces métadonnées incluent les noms et heures des réunions ou des cours, les URL des salles de réunion, les URL du contenu et les informations sur les rapports.

Le flux de données d’une application personnalisée qui récupère les métadonnées de la base de données va du navigateur Web du client au serveur d’applications Web du client, en passant par l’API XML, le serveur d’applications Web Adobe Connect et la base de données SQL, et vice-versa.

Le flux de données entre une application personnalisée et Adobe Connect fonctionne comme suit :

Applications Adobe Connect

Les applications Adobe Connect appellent le serveur à l’aide de la même API XML de services Web que celle que vous utilisez à partir d’une application personnalisée.

En général, le contenu est transporté par le port HTTP 80 ou le port HTTPS 443. Le contenu inclut les diapositives, pages HTTP, fichiers SWF et fichiers transférés via le module FileShare. Il s’agit des numéros de port par défaut que vous pouvez configurer (voir Migration, installation et configuration d’Adobe Connect Server pour plus de détails).

Les communications diffusées en continu et en temps réel provenant d'Adobe Media Server sont transmises par le port RTMP 1935. Les communications diffusées en continu incluent l’audio, la vidéo (webcam et FLV), le partage de fichiers, et le chat. L’état de la réunion est également géré par le port RTMP 1935.

Composants d’Adobe Connect

Adobe Connect est conçu avec deux composants serveur, et chaque serveur utilise une base de données SQL.

Le serveur d’applications Web est l’élément central d’Adobe Connect. Il contient et exécute toute la logique nécessaire pour fournir du contenu aux utilisateurs. Il gère le contrôle d’accès, la sécurité, les quotas et les licences, ainsi que les fonctions de gestion comme la mise en cluster, le basculement et la réplication.

Le serveur d’applications Web gère également Adobe Connect Central, l’application par laquelle vous visualisez et gérez le contenu et les utilisateurs de votre entreprise, lorsque vous n'utilisez pas une application personnalisée ni un système tiers intégré. Les métadonnées décrivant le contenu et les utilisateurs peuvent être stockées dans une ou plusieurs bases de données SQL répliquées. Le serveur d’applications Web est sans état, ce qui signifie que la mise à l’échelle est presque linéaire.

Adobe Media Server diffuse des contenus audio, vidéo et multimédia à l’aide du protocole RTMP. Lorsqu’il s’agit d’enregistrer et de diffuser une réunion, de synchroniser l’audio et la vidéo ou de convertir et d’empaqueter du contenu pour le partage d’écran en temps réel, Adobe Media Server s’occupe de tout.

Adobe Media Server joue également un rôle central dans la réduction de la charge du serveur en mettant en cache les pages Web fréquemment visitées, les flux continus et les données partagées.

Adobe Connect utilise la base de données Microsoft SQL Server pour le stockage permanent des métadonnées transactionnelles et d’application, y compris les informations sur les utilisateurs, les groupes, le contenu et les rapports. L’API XML récupère les métadonnées stockées dans la base de données. La base de données peut être implémentée soit avec Microsoft SQL Server Desktop Engine (MSDE), soit avec la version complète de Microsoft SQL Server 2005.

Effectuer votre premier appel d’API

Les services Web Adobe Connect utilisent un cadre servlet pour traiter les demandes de l’API XML. Dans le diagramme de flux de données, le cadre servlet est représenté par le composant API. Le servlet API reçoit les demandes XML des clients et renvoie les réponses XML du serveur d’applications Web et de la base de données.

Une demande adressée à l’API XML est formatée comme une URL de demande HTTP que le servlet API traite. Une URL de demande comporte un nom d’action et des paramètres dans des paires nom/valeur, comme ceci :

Si vous avez accès à un compte Adobe Connect dans lequel vous pouvez tester les appels API, vous pouvez tester ces appels. En fait, Adobe recommande de tester les appels API dans le navigateur pendant que vous apprenez l’API et écrivez des applications.

Avant de commencer, il est utile d’installer un outil vous permettant de visualiser les en-têtes de demande et de réponse HTTP dans votre navigateur.

Appel à common-info dans un navigateur

Appel à principal-list dans un navigateur

Une fois que vous recevez la valeur de cookie BREEZESESSION de common-info, le navigateur l’ajoute à l’en-tête de la demande lors de votre prochaine demande.

Ajout de filtres et de tris

De nombreuses actions de l’API vous permettent d’ajouter un filtre pour ne renvoyer que certains éléments de réponse, ou un tri pour afficher les éléments de réponse dans un certain ordre.

Un filtre est un paramètre spécial qui commence par le mot-clé filter, suivi d’un modificateur facultatif, puis d’un nom de champ et d’une valeur. Voici tous les exemples de filtres :

• filter-name=jazz doe (qui correspond aux résultats avec le nom exact jazz doe)

• filter-like-name=jazz (qui correspond à tous les résultats dont le nom contient jazzin)

• filter-out-type=user (qui renvoie tous les résultats dont le type n’est pas user)

Il ne s’agit que de quelques types de filtre, et vous en trouverez d’autres dans filter-definition. Vérifiez une action dans la référence (dans Référence de l’action) pour voir si sa réponse peut être filtrée. En général, si une action autorise les filtres, vous pouvez les utiliser sur n’importe quel élément ou attribut de la réponse.

Un tri est un autre paramètre spécial qui commence par le mot-clé sort (ou sort1 ou sort2), suivi d’un nom de champ, puis d’un des mots-clés asc ou desc, par exemple :

• sort-name=asc (pour trier dans l’ordre croissant par name)

• sort-group-id=desc (pour trier dans l’ordre décroissant par group-id)

Ce ne sont que quelques exemples. Vous pouvez tester les tris dans le navigateur ou consulter sort-definition pour plus d’informations.

Passer un appel avec un filtre et un tri

Où aller maintenant ?

À ce stade, vous pouvez continuer à tester les appels dans le navigateur et à observer leur fonctionnement. Il s’agit du meilleur moyen, et le plus simple, d’apprendre l’API XML. Pour plus d’informations, consultez l’une des sources suivantes :

• Référence de l’API dans Référence de l’action.

• Login and requests (Connexion et demandes) pour obtenir des informations sur la façon de connecter des utilisateurs à partir d’applications.

• Basics (Concepts de base) pour apprendre les trois concepts de base qui sous-tendent l’API

• Meetings (Réunions) si vous souhaitez créer et gérer des réunions à partir d’une application.

• Training (Formation) si vous créez une application de formation.