Share via

  • Articolo

Riferimenti per sviluppatori

Ultima modifica dell'argomento: 2009-05-14

Il gruppo Office Communications fornisce i seguenti set di API e SDK:

  • Office Communications Server 2007 R2 Server SDK
  • Unified Communications Managed API 2.0 Core SDK
  • Unified Communications Managed API 2.0 Speech SDK
  • Attività del flusso di lavoro Windows di Microsoft Unified Communications Managed API 2.0
  • Office Communicator 2007 Automation API SDK
  • Unified Communications Client 1.0 SDK
  • Unified Communications AJAX 2007 SDK
  • API del servizio Office Live Meeting
  • API del portale di servizi di Office Live Meeting

Nelle sezioni seguenti viene fornita una panoramica di ogni set di API e SDK. Per ogni set di API e SDK sono disponibili collegamenti alla documentazione MSDN nella sezione Vedere anche alla fine di questo argomento.

Office Communications Server 2007 R2 Server SDK

Microsoft () contiene due set di API:

  • API dell'applicazione
  • API di gestione di

API dell'applicazione Communications Server

Uno sviluppatore può utilizzare l'API dell'applicazione per creare applicazioni che estendono e migliorano le funzionalità basate su SIP di . Dallo sviluppo di filtri per i messaggi personalizzati e applicazioni di routing ai modelli transazionali a thread multipli e alle funzionalità di registrazione protette, questo set di API è destinato agli sviluppatori che desiderano implementare comportamenti personalizzati per . Queste API consentono il monitoraggio e la modifica dei messaggi SIP trasmessi in e non possono essere utilizzate per creare messaggi SIP dal server. Non è ad esempio possibile scrivere applicazioni per la creazione di messaggi immediati tramite queste API.

L'API dell'applicazione fornisce un insieme di strumenti che consentono di implementare filtri per i messaggi SIP personalizzati e di inviare messaggi alle applicazioni registrate con Office Communications Server. I tre strumenti principali sono i seguenti:

  • Manifesto dell'applicazione, che definiscono i comportamenti di base del proxy e di filtro dei messaggi.
  • Linguaggio MSPL (Microsoft SIP Processing Language), che offre maggiore controllo granulare sui comportamenti del proxy e di filtro, nonché funzionalità per l'invio di messaggi specifici ad applicazioni SIP basate sulle transazioni.
  • Spazio dei nomi Microsoft.Rtc.Sip, che consente l'accesso delle applicazioni alle risorse esterne a svolgendo funzioni di routing e di filtro.

Le applicazioni che forniscono funzionalità di routing e di filtro utilizzando solo le risorse, come la presenza, fornite da possono essere create tramite MSPL. Un'applicazione per il blocco di tutti i messaggi immediati contenenti riferimenti HTTP può essere scritta interamente in MSPL.

Per le applicazioni che richiedono risorse esterne a , ad esempio informazioni relative al dominio o accesso al database, è necessario che il codice MSPL invii i messaggi SIP a un processo separato che utilizza lo spazio dei nomi Microsoft.Rtc.Sip. Per un'applicazione che consente i messaggi immediati contenenti riferimenti HTTP ai siti aziendali attendibili, ma blocca i messaggi che fanno riferimento a siti non attendibili o esterni, è necessaria un'applicazione separata in aggiunta a MSPL.

Per informazioni sugli strumenti elencati in precedenza, vedere le sezioni seguenti di questa documentazione:

  • "Manifesto dell'applicazione SIP", ovvero documenti XML che descrivono un'applicazione SIP al computer in cui è in esecuzione l'applicazione.
  • "Utilizzo dell'API per le applicazioni gestite SIP", che contiene le specifiche per la creazione di applicazioni SIP basate sulle transazioni eseguite in .
  • "Informazioni di riferimento sull'API per le applicazioni gestite SIP" in cui è inclusa la documentazione di riferimento per lo spazio dei nomi Microsoft.Rtc.Sip e altre risorse specifiche di SIP.

API di gestione di Communications Server

L'API di gestione di è costituita da un insieme di classi di Strumentazione gestione Windows (WMI) utilizzate per gestire i componenti di . WMI utilizza lo standard del settore Common Information Model (CIM) per rappresentare sistemi, applicazioni, reti, dispositivi e altri componenti gestiti. La maggior parte delle proprietà delle classi è esposta nel sistema di gestione di . È possibile accedere a tutte le proprietà utilizzando un linguaggio di scripting che supporta l'hosting di script ActiveX®, ad esempio Microsoft Visual Basic Scripting Edition (VBScript).

È possibile utilizzare gli script WMI per automatizzare le attività amministrative nella distribuzione di . È inoltre possibile utilizzare WMI per modificare o leggere le proprietà WMI in remoto, ma è necessario che il computer che esegue lo script sia un computer o che in tale computer siano installati gli strumenti di amministrazione di .

Per ulteriori informazioni su WMI, vedere Windows Management Instrumentation (WMI) nel sito MSDN.

Unified Communications Managed API 2.0 Core SDK

Microsoft Unified Communications Managed API 2.0 Core SDK è una piattaforma di codice gestito che consente l'accesso e il controllo di messaggistica immediata, telefonia, conferenza audio e video e presenza. Questo SDK è destinato a supportare lo sviluppo di applicazioni di livello intermedio per Microsoft Office Communicator e Microsoft Office Communications Server 2007 R2.

UCMA 2.0 Core SDK elimina la maggior parte dei protocolli di Office Communications Server, offrendo un'API che espone quasi tutte le funzionalità del protocollo, pur essendo più semplice da comprendere e utilizzare. Ad esempio, i contatti e i gruppi per un utente possono essere utilizzati tramite la classe ContactGroupServices. Una conferenza può essere pianificata utilizzando la classe ConferenceServices. Un utente o un'applicazione può avviare una conversazione con altri utenti o applicazioni utilizzando la classe Conversation. Un'applicazione può sottoscrivere la presenza di altri utenti o applicazioni utilizzando le classi LocalOwnerPresence e RemotePresence.

Unified Communications Managed API 2.0 Speech SDK

Microsoft Unified Communications Managed API 2.0 Speech SDK consente agli sviluppatori di compilare applicazioni per Office Communications Server che utilizzano funzionalità di riconoscimento vocale e di sintesi vocale.

Attività del flusso di lavoro Windows di Microsoft Unified Communications Managed API 2.0

Le attività del flusso di lavoro Windows di UCMA 2.0 possono essere utilizzate per compilare velocemente in OCS applicazioni di messaggistica immediata e di riconoscimento vocale abilitate per i flussi di lavoro. Possono inoltre essere utilizzate per fornire soluzioni per gli scenari più semplici, quale il routing delle chiamate, o per gli scenari complessi che caratterizzano le grandi aziende, ad esempio la collaborazione audio e l'integrazione di flussi di lavoro di processi aziendali.

Office Communicator 2007 Automation API SDK

Microsoft () contiene un insieme di tipi enumerati, eventi, oggetti e interfacce COM, nonché altre entità di programmazione correlate. consente di programmare un'istanza di () da un'applicazione di terze parti e di scrivere applicazioni che forniscono esperienze utente estese e personalizzate con .

È ad esempio possibile accedere a chiamando il metodo IMessenger::Signin. Questo processo è simile all'accesso da un'istanza di in esecuzione scegliendo Accedi dal menu Connetti. Le funzionalità di possono inoltre essere integrate in altre applicazioni ed estese o personalizzate per soddisfare particolari esigenze dell'applicazione. In un'applicazione di pianificazione è possibile utilizzare per sfruttare le funzionalità di query e gestione dei contatti, in modo da consentire agli utenti di organizzare e visualizzare i contatti o di eseguire query su di essi.

In quanto API basata su COM che supporta l'automazione, è possibile chiamare dalle applicazioni scritte in Microsoft Visual Basic®, C/C++, VBScript e molti altri linguaggi di scripting. Per motivi di protezione, alcune chiamate API sono disabilitate per i linguaggi di scripting. Per una descrizione completa di queste restrizioni, vedere le informazioni di riferimento su .

Utilizzando lo spazio dei nomi System.Runtime.Interop in .NET Framework, è anche possibile chiamare l'API dalle applicazioni scritte in uno dei linguaggi di programmazione basati su .NET, tra cui lo strumento di sviluppo Microsoft Visual C#®, Visual Basic .NET, lo strumento di sviluppo Visual J#® e altro ancora.

Unified Communications Client 1.0 SDK

Uno sviluppatore di applicazioni può creare i seguenti tipi di applicazioni API di per la collaborazione e le comunicazioni in tempo reale:

  • Un client di comunicazioni completo come Microsoft (). è infatti basato sull'API di . Questo tipo di applicazione può supportare messaggistica immediata, servizi di conferenza, trasmissione video tramite protocollo IP, VoIP e integrazione con i servizi di telefonia. È inoltre possibile utilizzare un'applicazione di questo tipo per tenere traccia della presenza dei contatti dell'utente e di altri dati specifici dell'applicazione, in quanto la piattaforma supporta un'infrastruttura generale di pubblicazione e sottoscrizione.
  • Un'applicazione orientata alle funzionalità che consente l'interoperabilità con e fornisce funzionalità potenziate o servizi personalizzati. Questo tipo di applicazione consente a un provider di servizi di sfruttare un'installazione base di esistente in un'azienda. È tuttavia necessario fare attenzione che tramite queste applicazioni non vengano pubblicati dati e create o accettate sessioni che interferiscano con .
  • Un'applicazione line-of-business (LOB) integrata che incorpora funzionalità di presenza e comunicazione in applicazioni line-of-business esistenti. In un'applicazione per la gestione delle relazioni con i clienti (CRM, Customer Relations Management) è ad esempio possibile integrare funzionalità di rilevamento della presenza per stabilire come inviare le richieste personalizzate ai rappresentanti del servizio più appropriati.

Uno sviluppatore può utilizzare l'API di per creare un'applicazione che consenta le comunicazioni in tempo reale multimodali integrate all'interno di una rete o attraverso i suoi confini. L'applicazione risultante può aiutare a fare del computer il centro delle comunicazioni aziendali in tempo reale. Le chiamate audio e video, nonché la messaggistica immediata e la collaborazione, sono integrate in un'unica sessione utente nel computer. Oltre alle sessioni di comunicazione tra computer, l'utente può anche creare chiamate da computer a telefono o da telefono a telefono oppure sessioni di messaggistica immediata di solo testo.

Le informazioni sulla presenza consentono a un utente di conoscere in tempo reale la disponibilità dei propri contatti, con l'aiuto di un server di registrazione. Un utente può pertanto utilizzare un'applicazione di questo tipo per chiamare i contatti senza dover conoscere la loro esatta posizione o scegliere il numero di telefono da chiamare. Se, ad esempio, si compone il numero dell'ufficio di un contatto e le informazioni sulla presenza indicano che il contatto è disponibile dal computer di casa, la chiamata può essere automaticamente reindirizzata verso tale posizione. Un utente può inoltre mantenere la privacy bloccando l'accesso dei chiamanti alle proprie informazioni sulla presenza.

Un esempio di questo tipo di comunicazioni in tempo reale per un'applicazione aziendale è costituito da un'esperienza di comunicazione personalizzata per gli utenti delle applicazioni create, ad esempio un'applicazione CRM che riunisce in una videoconferenza tutte le parti interessate a un'opportunità di vendita e consente di condividere i dati sul cliente.

I servizi di messaggistica immediata sono attualmente utilizzati dalla rete di servizi Internet Microsoft MSN®, da Yahoo! e da AOL, con centinaia di milioni di utenti globali.

Microsoft Unified Communications AJAX 2007 SDK

Microsoft® () è costituito dai componenti seguenti:

  • L' è un'interfaccia di programmazione delle applicazioni (API, Application Programming Interface) per . L'API è costituita da metodi ed eventi. Un client invia un metodo come richiesta a un server e riceve i dati come eventi dal server. Le richieste e gli eventi sono specificati come elemento XML. La comunicazione viene condotta principalmente come richieste HTTP POST con richieste HTTP GET in singoli scenari. A differenza delle applicazioni designate come servizi Web, Server non analizza i messaggi SOAP né fornisce un documento WSDL per l'utilizzo da parte degli strumenti di sviluppo dell'applicazione client. Questo approccio offre due vantaggi. Innanzitutto consente di evitare l'overhead creato quando il codice JavaScript deve generare o analizzare documenti SOAP di dimensioni maggiori. In secondo luogo, per utilizzare correttamente è sufficiente una conoscenza generale di XML e non è necessaria una conoscenza specifica dei messaggi SOAP.
  • Unified Communications JavaScript Libraries basate sul servizio AJAX. Si tratta di classi JavaScript che incapsulano le funzionalità più comuni necessarie di un client Unified Communications JavaScript Libraries. Le funzionalità comuni includono la creazione e il mantenimento di canali di comunicazione, l'accesso a un server, l'incorporamento della visualizzazione della presenza di un utente in una pagina Web, l'avvio di una conversazione di messaggistica immediata e così via. Utilizzando le librerie, uno sviluppatore di applicazioni può creare un client Unified Communications JavaScript Libraries semplicemente creando istanze delle librerie, impostando le proprietà appropriate e richiamando i metodi desiderati.

Server consente l'accesso alle funzionalità della piattaforma Unified Communications.

API del servizio Office Live Meeting

L' () consente l'accesso a livello di programmazione alla maggior parte delle funzionalità disponibili tramite i client Office Live Meeting basati su Windows e su Web.

La documentazione relativa all' è costituita da due parti:

  • Una guida generale che offre ai nuovi programmatori un'introduzione ai concetti di Live Meeting e dell'API, con esempi ed esercitazioni.
  • Informazioni di riferimento dettagliate sull'API, incluse informazioni su messaggi supportati pubblicamente, elementi XML costituenti, codici di errore e altre informazioni tecniche.

La documentazione relativa all'API è destinata a ingegneri, sviluppatori e programmatori che progettano, implementano e testano soluzioni per conferenze Web basate sulla tecnologia Live Meeting. È necessario conoscere i concetti di base di HTTP e XML.

Uno sviluppatore può utilizzare i servizi di Live Meeting per gestire le riunioni in linea. Le attività includono pianificazione di una riunione, invito di altre persone a una riunione, aggiunta di un account utente a un centro conferenze di Live Meeting, caricamento delle presentazioni e di altre risorse, gestione di registrazioni, preferenze degli utenti e di una rubrica, creazione di rapporti relativi alla partecipazione alle riunioni e altri dati statistici. Molte di queste attività possono essere eseguite a livello di programmazione.

È possibile accedere ai servizi di Live Meeting tramite l'interfaccia utente Web di Live Meeting o il processore API. Un utente può utilizzare l'interfaccia utente Web per eseguire tutte le attività correlate alle riunioni. Il processore API del servizio Live Meeting funge da gateway per l'accesso a livello di programmazione ai servizi di Live Meeting e per la gestione di utenti, risorse e riunioni.

API del portale di servizi di Office Live Meeting

L' () è il complemento dell' Service Pack 2.

L' (il Portale) è un'applicazione Web Microsoft Internet Information Services (IIS) che utilizza ASP.NET. Il Portale viene installato in un server Web Microsoft Windows®. Il Portale comunica con il servizio Live Meeting tramite chiamate API XML inviate in Internet.

Gli utenti possono accedere alle pagine Web del portale dai Web browser per effettuare le operazioni seguenti:

  • Creare un nuovo account di Live Meeting.
  • Accedere al servizio Live Meeting.
  • Modificare la password per l'account di Live Meeting.
  • Consentire agli utenti di accedere a contenuto relativo a Live Meeting.

I programmi o gli script che chiamano i metodi Web del Portale consentono di automatizzare la gestione degli account di Live Meeting. È possibile utilizzare i metodi Web per effettuare le operazioni seguenti:

  • Creare o eliminare un account di Live Meeting.
  • Attivare o disattivare un account di Live Meeting.
  • Modificare la password di un account di Live Meeting.
  • Ottenere lo stato di un account di Live Meeting.