Introducción a la arquitectura de servicios web de Adobe Connect

Los servicios web de Adobe® Connect™ son el nivel de servicios web del conjunto de aplicaciones de Adobe Connect Server.

Los servicios web le permiten crear portales o aplicaciones web que integran las funciones y los detalles de informes de Adobe Connect en sistemas de terceros, como portales, sistemas de gestión de relaciones con los clientes y sistemas de planificación de recursos empresariales.

Por ejemplo, puede tener un sistema central de administración de usuarios, como un directorio LDAP, Microsoft Active Directory u otro sistema de terceros, que forme parte integral de sus procesos empresariales.

Con los servicios web, puede escribir una aplicación que sincronice usuarios entre su sistema y Adobe Connect. La aplicación puede utilizar la plataforma J2EE u otra tecnología de su elección para extraer una lista de usuarios del directorio, compararla con una lista de usuarios de Adobe Connect y, a continuación, realizar las actualizaciones solicitadas dentro del repositorio de usuarios de Adobe Connect, como añadir o eliminar usuarios o grupos.

En el diagrama siguiente, se muestran los flujos de datos entre aplicaciones cliente y Adobe Connect. Las aplicaciones personalizadas que escribe utilizan las rutas de 1 a 2 y de A a B. Las aplicaciones de Adobe Connect (como Adobe Connect Meeting, Adobe Connect Training o Adobe Connect Events) pueden utilizar cualquiera de las rutas de flujo de datos.

El flujo de datos puede cifrarse con SSL o dejarse sin cifrar.

Si el flujo de datos no está cifrado, las conexiones se realizan a través de HTTP y Adobe Real Time Messaging Protocol (RTMP) y siguen las rutas descritas en la tabla siguiente.

Si el flujo de datos está cifrado, las conexiones se realizan de forma segura a través de HTTPS y RTMPS (Real Time Messaging Protocol over SSL), como se indica a continuación.

Aplicaciones personalizadas

Los servicios web de Adobe Connect proporcionan una API XML, por lo que la aplicación debe ser capaz de comunicarse con Adobe Connect mediante XML a través de HTTP o XML por HTTPS. La aplicación llama a la API mediante la creación de una dirección URL de solicitud y la transferencia de uno o más parámetros, ya sea como pares de nombre/valor o como un documento XML. Los servicios web devuelven una respuesta XML, de la que se pueden extraer valores.

Las aplicaciones personalizadas recuperan los metadatos de la base de datos de Adobe Connect. Los metadatos incluyen nombres y horas de reuniones o cursos, direcciones URL de salas de reuniones y contenido, y detalles de informes.

El flujo de datos de una aplicación personalizada que recupera metadatos de la base de datos va desde el navegador web de cliente al servidor de aplicaciones web de cliente, la API XML, el servidor de aplicaciones web de Adobe Connect y la base de datos SQL y, a continuación, empieza de nuevo desde el principio.

El flujo de datos entre una aplicación personalizada y Adobe Connect funciona así:

Aplicaciones de Adobe Connect

Las aplicaciones de Adobe Connect llaman al servidor mediante la misma API XML de servicios web que utiliza en una aplicación personalizada.

Por lo general, el contenido se transporta a través de los puertos HTTP 80 o HTTPS 443. El contenido incluye diapositivas, páginas HTTP, archivos SWF y archivos transferidos mediante el pod para compartir archivos. Estos son los números de puerto predeterminados que puede configurar (consulte Migración, instalación y configuración de Adobe Connect Server para obtener información).

Las comunicaciones transmitidas en tiempo real desde Adobe Media Server se transportan a través del puerto RTMP 1935. Las comunicaciones transmitidas incluyen audio, vídeo (cámara web y FLV), uso compartido de archivos y chat. El estado de la reunión también se conserva a través del puerto RTMP 1935.

Componentes de Adobe Connect

Adobe Connect se ha diseñado con dos componentes de servidor y cada servidor utiliza una base de datos SQL.

El servidor de aplicaciones web es el cerebro de Adobe Connect. Contiene y ejecuta toda la lógica empresarial necesaria para ofrecer contenido a los usuarios. Administra el control de acceso, la seguridad, las cuotas y las licencias, así como funciones de gestión, como tecnología de clústeres, conmutación por errores y replicación.

El servidor de aplicaciones web también gestiona Adobe Connect Central, la aplicación a través de la cual se ve y se gestiona el contenido y los usuarios de la organización cuando no se utiliza una aplicación personalizada o un sistema integrado de terceros. Los metadatos que describen el contenido y los usuarios se pueden almacenar en una o varias bases de datos SQL replicadas. El servidor de aplicaciones web no tiene estado, lo que significa que la escala es casi lineal.

Adobe Media Server transmite audio, vídeo y contenido multimedia enriquecido mediante RTMP. Cuando se graba y se reproduce una reunión, el audio y el vídeo se sincronizan o el contenido se convierte y se empaqueta para el uso compartido de pantalla en tiempo real; Adobe Media Server se encarga de esta tarea.

Adobe Media Server también desempeña un papel fundamental en la reducción de la carga del servidor mediante el almacenamiento en caché de las páginas web a las que se accede con frecuencia, las transmisiones y los datos compartidos.

Adobe Connect utiliza la base de datos Microsoft SQL Server para el almacenamiento persistente de los metadatos de aplicaciones y transacciones, incluidos los usuarios, los grupos, el contenido y los detalles de informes. La API XML recupera los metadatos almacenados en la base de datos. La base de datos se puede implementar con Microsoft SQL Server Desktop Engine (MSDE) o con la versión completa de Microsoft SQL Server 2005.

Realizar la primera llamada de API

Los servicios web de Adobe Connect utilizan una estructura de servlets para gestionar las solicitudes de la API XML. En el diagrama de flujo de datos, la estructura de servlets se representa mediante el componente de API. El servlet de API recibe solicitudes XML de los clientes y devuelve respuestas XML del servidor de aplicaciones web y de la base de datos.

Una solicitud a la API XML tiene el formato de URL de solicitud HTTP que gestiona el servlet de API. Una dirección URL de solicitud presenta un nombre de acción y parámetros en pares de nombre/valor, como se muestra a continuación:

Si tiene acceso a una cuenta de Adobe Connect en la que puede probar las llamadas de API, puede experimentar con ellas. De hecho, Adobe recomienda probar las llamadas de API en el navegador mientras aprende el uso de la API y escribe aplicaciones.

Antes de comenzar, es útil instalar una herramienta que le permita ver los encabezados de solicitud y respuesta HTTP en el navegador.

Llamar a "common-info" en un navegador

Llamar a "principal-list" en un navegador

Una vez que tenga el valor de la cookie BREEZESESSION de common-info, el navegador lo añadirá al encabezado de la solicitud en la siguiente solicitud.

Añadir filtros y ordenaciones

Muchas acciones de la API permiten añadir un filtro para devolver solo determinados elementos de respuesta o una ordenación para visualizar los elementos de respuesta en un orden determinado.

Un filtro es un parámetro especial que comienza con la palabra clave filter, seguido de un modificador opcional, y, a continuación, un nombre de campo y un valor. A continuación, se muestran ejemplos de filtros:

• filter-name=jazz doe (que proporciona los resultados con el nombre exacto jazz doe).

• filter-like-name=jazz (que proporciona los resultados que contienen jazz en el nombre).

• filter-out-type=user (que devuelve los resultados que no tienen un tipo de usuario).

Estos son solo algunos tipos de filtro; puede encontrar más información en filter-definition. Compruebe una acción en la referencia (en Action reference) para ver si su respuesta se puede filtrar. En general, si una acción permite filtros, puede utilizarlos en cualquier elemento o atributo de respuesta.

Una ordenación es otro parámetro especial que comienza con la palabra clave sort (o sort1 o sort2), seguida de un nombre de campo, y, a continuación, las palabras clave asc o desc como, por ejemplo:

• sort-name=asc (para ordenar de forma ascendente por nombre).

• sort-group-id=desc (para ordenar de forma descendente por ID de grupo).

Estos son solo algunos ejemplos. Puede probar la ordenación en el navegador o consultar sort-definition para obtener más información.

Realizar una llamada con un filtro y una ordenación

Próximos pasos

En este punto, puede continuar probando las llamadas en el navegador y observar cómo funcionan. Es la forma más eficaz y sencilla de aprender a usar la API XML. Si necesita más información, consulte cualquiera de estas fuentes:

• La referencia de API en Action reference.

• Login and requests para obtener información sobre cómo los usuarios pueden iniciar sesión desde aplicaciones.

• Basics para obtener información sobre los tres conceptos básicos de la API.

• Meetings para obtener información sobre cómo crear y gestionar reuniones desde una aplicación.

• Training para obtener información sobre cómo crear una aplicación de formación.