Introduzione all’architettura di Adobe Connect Web Services

Adobe® Connect™ Web Services è il livello del servizio web sulla suite di applicazioni Adobe Connect Server.

I servizi web ti consentono di creare portali o applicazioni web che integrano la funzionalità e le informazioni di reporting di Adobe Connect con sistemi di terze parti, come portali, sistemi di gestione delle relazioni con i clienti e sistemi di pianificazione delle risorse aziendali.

Ad esempio, potresti avere un sistema centrale di gestione degli utenti, come una directory LDAP, Microsoft Active Directory o un altro sistema di terze parti, che è parte integrante dei tuoi processi aziendali.

Utilizzando i servizi web, puoi scrivere un’applicazione che sincronizza gli utenti tra il tuo sistema e Adobe Connect. L’applicazione può utilizzare la piattaforma J2EE o un’altra tecnologia di tua scelta per estrarre un elenco di utenti dalla directory, confrontarlo con un elenco di utenti Adobe Connect ed eseguire quindi gli aggiornamenti richiesti all’interno del repository degli utenti Adobe Connect, ad esempio aggiungendo o eliminando utenti o gruppi.

I flussi di dati tra le applicazioni client e Adobe Connect sono illustrati nel diagramma seguente. Le applicazioni personalizzate che scrivi utilizzano i percorsi da 1 a 2 e da A a B. Le applicazioni Adobe Connect, ad esempio Adobe Connect Meeting, Adobe Connect Training o Adobe Connect Events, possono utilizzare uno qualsiasi dei percorsi di flusso dei dati.

Il flusso di dati può essere crittografato con SSL o non crittografato.

Se il flusso di dati non è crittografato, le connessioni vengono effettuate tramite HTTP e RTMP (Real Time Messaging Protocol) di Adobe e seguono i percorsi descritti nella tabella seguente.

Se il flusso di dati è crittografato, le connessioni vengono effettuate in modo sicuro tramite HTTPS e RTMPS (Real Time Messaging Protocol over SSL), come indicato di seguito.

Applicazioni personalizzate

Adobe Connect Web Services fornisce un’API XML, quindi la tua applicazione deve essere in grado di comunicare con Adobe Connect tramite XML via HTTP o XML via HTTPS. L’applicazione chiama l’API creando un URL di richiesta e passandogli uno o più parametri, come coppie nome/valore o come documento XML. Web Services restituisce una risposta XML da cui puoi estrarre i valori.

Le applicazioni personalizzate recuperano i metadati dal database Adobe Connect. I metadati includono i nomi e gli orari delle riunioni o dei corsi, gli URL delle stanze riunioni, gli URL dei contenuti e le informazioni sui rapporti.

Il flusso di dati per un’applicazione personalizzata che recupera i metadati dal database va da un browser web client, al server applicazioni web client, all’API XML, al server applicazioni web Adobe Connect e al database SQL, quindi torna indietro.

Il flusso di dati tra un’applicazione personalizzata e Adobe Connect funziona nel modo seguente:

Applicazioni Adobe Connect

Le applicazioni Adobe Connect chiamano il server utilizzando la stessa API Web Services XML che usi da un’applicazione personalizzata.

In generale, il contenuto viene trasportato via porta HTTP 80 o HTTPS 443. Il contenuto include diapositive, pagine HTTP, file SWF e file trasferiti tramite il contenitore di condivisione file. Questi sono i numeri di porte predefiniti che puoi configurare (per ulteriori informazioni, consulta Migrazione, installazione e configurazione di Adobe Connect Server).

Le comunicazioni in streaming e in tempo reale da Adobe Media Server vengono trasportate via porta RTMP 1935. Le comunicazioni in streaming includono audio, video (webcam e FLV), condivisione di file e chat. Lo stato della riunione viene mantenuto anche sulla porta RTMP 1935.

Componenti di Adobe Connect

Adobe Connect è dotato di due componenti server e ogni server utilizza un database SQL.

Il server applicazioni web è il cervello di Adobe Connect. Contiene ed esegue tutta la logica di business necessaria per distribuire i contenuti agli utenti. Gestisce il controllo degli accessi, la sicurezza, le quote e le licenze, nonché funzioni di gestione quali il clustering, il failover e la replica.

Il server applicazioni web gestisce anche Adobe Connect Central, l’applicazione attraverso cui visualizzi e gestisci il contenuto e gli utenti dell’organizzazione, quando non utilizzi un’applicazione personalizzata o un sistema integrato di terze parti. I metadati che descrivono il contenuto e gli utenti possono essere memorizzati in database SQL duplicati singoli o multipli. Il server applicazioni web è senza stato, il che significa che il ridimensionamento è quasi lineare.

Adobe Media Server esegue lo streaming di contenuti audio, video e multimediali tramite RTMP. Quando una riunione viene registrata e riprodotta, audio e video vengono sincronizzati o il contenuto viene convertito e compresso per la condivisione dello schermo in tempo reale, è Adobe Media Server a eseguire il lavoro.

Adobe Media Server svolge inoltre un ruolo essenziale nella riduzione del carico del server mediante la memorizzazione nella cache di pagine web, flussi e dati condivisi a cui si accede di frequente.

Adobe Connect utilizza il database di Microsoft SQL Server per la memorizzazione permanente dei metadati transazionali e delle applicazioni, inclusi utenti, gruppi, contenuti e informazioni di reporting. L’API XML recupera i metadati memorizzati nel database. Il database può essere implementato con Microsoft SQL Server Desktop Engine (MSDE) o con la versione completa di Microsoft SQL Server 2005.

Esecuzione della prima chiamata API

Adobe Connect Web Services utilizza un framework servlet per gestire le richieste API XML. Nel diagramma del flusso di dati, il framework servlet è rappresentato dal componente API. Il servlet API riceve richieste XML dai client e restituisce risposte XML dal server applicazioni web e dal database.

Una richiesta all’API XML viene formattata come URL di richiesta HTTP gestito dal servlet API. Un URL di richiesta ha un nome azione e parametri in coppie nome/valore, come indicato di seguito:

Se hai accesso a un account Adobe Connect in cui puoi testare le chiamate API, puoi sperimentare. In effetti, Adobe consiglia di provare le chiamate API nel browser mentre apprendi l’API e scrivi applicazioni.

Prima di iniziare, è utile installare uno strumento che ti consenta di visualizzare le intestazioni di risposta e richiesta HTTP nel browser.

Chiamare common-info in un browser

Chiamare principal-list in un browser

Una volta ottenuto il valore del cookie BREEZESESSION da common-info, il browser lo aggiunge all’intestazione della richiesta nella richiesta successiva.

Aggiunta di filtri e ordinamenti

Molte azioni nell’API ti consentono di aggiungere un filtro per restituire solo alcuni elementi di risposta o un ordinamento per visualizzare gli elementi di risposta in un determinato ordine.

Un filtro è un parametro speciale che inizia con la parola chiave filter, seguita da un modificatore opzionale, quindi da un nome di campo e un valore. Questi sono tutti esempi di filtri:

• filter-name=jazz doe (che corrisponde ai risultati con il nome esatto jazz doe)

• filter-like-name=jazz (che corrisponde ai risultati che contengono jazz nel nome)

• filter-out-type=user (che restituisce i risultati privi di un tipo di user)

Questi sono solo alcuni tipi di filtri e ne puoi trovare altri in filter-definition. Controlla l’azione nel riferimento (in Riferimento azione) per verificare se la risposta può essere filtrata. In generale, se un’azione consente l’uso dei filtri, puoi utilizzarli su qualsiasi elemento o attributo di risposta.

Un ordinamento è un altro parametro speciale che inizia con la parola chiave sort (o sort1 o sort2), seguita da un nome di campo e da una delle parole chiave asc o desc, ad esempio:

• sort-name=asc (ordinamento crescente in base a name)

• sort-group-id=desc (ordinamento decrescente in base a group-id)

Questi sono solo alcuni esempi di ordinamento. Puoi provare gli ordinamenti nel browser oppure consulta sort-definition per ulteriori informazioni.

Eseguire una chiamata con un filtro e ordinare

Operazioni successive

A questo punto, puoi continuare a testare le chiamate nel browser e osservarne il funzionamento. È il modo migliore e più semplice per apprendere l’API XML. Se hai bisogno di ulteriori informazioni, consulta una di queste risorse:

• Il riferimento API in Riferimento azione.

• Login e richieste per informazioni su come far accedere gli utenti dalle applicazioni.

• Nozioni di base per apprendere i tre concetti fondamentali alla base dell’API.

• Riunioni se vuoi creare e gestire riunioni da un’applicazione.

• Training se stai creando un’applicazione di formazione.