• Artículo

Referencias del desarrollador

Última modificación del tema: 2009-05-14

El grupo de Office Communications proporciona los conjuntos de API y SDK siguientes:

  • SDK de servidor de Office Communications Server 2007 R2
  • SDK básico de la API administrada 2.0 de comunicaciones unificadas
  • SDK de tecnologías de voz de la API 2.0 administrada de comunicaciones unificadas
  • Actividades de flujo de trabajo de Windows de la API administrada 2.0 de comunicaciones unificadas
  • SDK de la API de automatización de Office Communicator 2007
  • SDK del Cliente de comunicaciones unificadas 1.0
  • SDK de comunicaciones unificadas de AJAX 2007
  • Office Live Meeting Service API
  • Office Live Meeting Service Portal API

En las secciones siguientes se proporciona información general de cada conjunto de API y SDK. En la sección Vea también que figura al final de este tema se encuentran vínculos a la documentación de MSDN para cada conjunto de API y SDK.

SDK de servidor de Office Communications Server 2007 R2

Microsoft () contiene dos conjuntos de API:

  • API de aplicación de
  • API de administración de

API de aplicación de Communications Server

Un desarrollador puede usar la API de aplicación de para crear aplicaciones que amplíen y mejoren la funcionalidad basada en SIP de . Desde el desarrollo de aplicaciones de enrutamiento y filtrado de mensajes personalizados hasta modelos transaccionales multiproceso y funcionalidad de registro segura, este conjunto de API está destinado a los desarrolladores que desean implementar comportamientos personalizados para . Estas API pueden supervisar y cambiar los mensajes SIP cuando fluyen a través de . No se pueden utilizar para crear mensajes SIP desde el servidor. Por ejemplo, no se pueden escribir aplicaciones que creen mensajes instantáneos con estas API.

La API de aplicación de proporciona un conjunto de herramientas para implementar filtros de mensajes SIP personalizados y para enviar mensajes a aplicaciones registradas con Office Communications Server. Las tres herramientas principales son:

  • Manifiestos de aplicaciones, que definen el filtrado de mensajes básico y los comportamientos de proxy.
  • El lenguaje de procesamiento de protocolo de inicio de sesión de Microsoft (MSPL), que proporciona un mayor control sobre el filtrado y los comportamientos de proxy, así como una función para enviar mensajes específicos a aplicaciones SIP basadas en transacciones.
  • El espacio de nombres Microsoft.Rtc.Sip, que permite a las aplicaciones tener acceso a recursos externos de al realizar el enrutamiento y el filtrado.

Las aplicaciones que proporcionan el enrutamiento y el filtrado utilizando sólo los recursos, como la presencia, proporcionados por , se pueden crear utilizando MSPL. Una aplicación que bloquea todos los mensajes instantáneos que contienen referencias HTTP se puede escribir totalmente en MSPL.

Las aplicaciones que necesitan recursos externos a , como información de dominio o acceso a base de datos, necesitan que sus mensajes SIP se envíen con código MSPL a un proceso independiente que utiliza el espacio de nombres Microsoft.Rtc.Sip. Una aplicación que permite mensajes instantáneos que contienen referencias HTTP a sitios de confianza de empresa, pero que bloquea mensajes que hacen referencia a sitios que no son de confianza o a sitios externos, requiere una aplicación independiente además de MSPL.

Para obtener información sobre las herramientas enumeradas anteriormente, vea las secciones siguientes de esta documentación:

  • "Manifiestos de aplicaciones SIP" que son documentos XML que describen una aplicación SIP al equipo de en el que se ejecuta la aplicación.
  • "Utilizar la API de aplicaciones administradas SIP", que contiene las características de crear aplicaciones SIP basadas en transacciones que se ejecutan en .
  • "Referencia de API de aplicaciones administradas SIP", que contiene documentación de referencia para el espacio de nombres Microsoft.Rtc.Sip y otros recursos específicos de SIP.

API de administración de Communications Server

La API de administración de consta de un conjunto de clases WMI (Instrumental de administración de Windows) que se utilizan para administrar componentes de . WMI utiliza el estándar del sector CIM (Modelo de información común) para representar sistemas, aplicaciones, redes, dispositivos y otros componentes administrados. La mayoría de las propiedades de clases se exponen en la consola de administración de . Todas las propiedades son accesibles utilizando un lenguaje de scripting que admite host de script ActiveX®, como Microsoft Visual Basic Scripting Edition (VBScript).

Puede utilizar scripting de WMI para automatizar tareas administrativas en su implementación de . También puede utilizar WMI para leer o cambiar propiedades de WMI de forma remota, pero el equipo que ejecuta el script debe ser un equipo con o que tenga instaladas las herramientas de administrador de .

Para obtener más información acerca de WMI, vea Instrumental de administración de Windows (WMI) en MSDN.

SDK básico de la API administrada 2.0 de comunicaciones unificadas

El SDK básico de la API administrada 2.0 de comunicaciones unificadas es una plataforma de código administrado que proporciona acceso y control sobre la mensajería instantánea, telefonía, conferencia de audio y vídeo y presencia. Su finalidad es permitir el desarrollo de aplicaciones de nivel intermedio destinadas a Microsoft Office Communicator y Microsoft Office Communications Server 2007 R2.

El SDK básico de UCMA 2.0 agrupa la mayoría de los protocolos de Office Communications Server en una API que expone prácticamente todas las características del protocolo para simplificar su comprensión y utilización. Por ejemplo, los contactos y grupos de un usuario se pueden utilizar con la clase ContactGroupServices. Una conferencia se puede programar utilizando la clase ConferenceServices. Un usuario o aplicación puede iniciar una conversación con otros usuarios o aplicaciones utilizando la clase Conversation. Una aplicación puede suscribirse a la presencia de otros usuarios o aplicaciones utilizando las clases RemotePresence y LocalOwnerPresence.

SDK de tecnologías de voz de la API 2.0 administrada de comunicaciones unificadas

El SDK de tecnologías de voz de la API administrada 2.0 de comunicaciones unificadas permite a los programadores generar aplicaciones de Office Communications Server que utilicen reconocimiento de voz y características de texto a voz.

Actividades de flujo de trabajo de Windows de la API administrada 2.0 de comunicaciones unificadas

Las actividades de flujo de trabajo de Windows de UCMA 2.0 se pueden utilizar para generar rápidamente aplicaciones de voz y mensajes instantáneos habilitadas para flujo de trabajo en OCS. Sirven para proporcionar soluciones para escenarios simples como el enrutamiento de llamadas o para escenarios más complejos típicos de las grandes empresas, como la colaboración por audio y la integración de flujo de trabajo de procesos empresariales.

SDK de la API de automatización de Office Communicator 2007

Microsoft () contiene un conjunto de tipos enumerados, eventos, objetos e interfaces COM, así como otras entidades de programación relacionadas. Con , puede programar una instancia de () desde una aplicación de otro fabricante y escribir aplicaciones que proporcionen experiencias de usuario extendidas y personalizadas con .

Por ejemplo, puede iniciar sesión en llamando al método IMessenger::Signin. Esto es similar a iniciar sesión desde una instancia de en ejecución haciendo clic en Iniciar sesión en el menú Conectarse. Además, las características de se pueden integrar en otras aplicaciones y extender o personalizar para necesidades especiales de la aplicación. Una aplicación de programación puede utilizar para aprovechar sus características de consulta y administración de contactos, con el fin de que los usuarios puedan organizar, mostrar o consultar a sus contactos.

Como una API basada en COM que admite automatización, se puede llamar a desde aplicaciones escritas en Microsoft Visual Basic®, C/C++, VBScript y muchos otros lenguajes de scripting. Por razones de seguridad, algunas llamadas a API se deshabilitan para lenguajes de scripting. Para tener una descripción completa de estas restricciones, vea Referencia de .

Con la ayuda del espacio de nombres System.Runtime.Interop en .NET Framework, también se puede llamar a la API desde aplicaciones escritas en cualquiera de los lenguajes de programación basados en .NET, incluidos la herramienta de desarrollo de Microsoft Visual C#®, Visual Basic .NET, la herramienta de desarrollo de Visual J#®, y otros.

SDK del Cliente de comunicaciones unificadas 1.0

Un desarrollador de aplicaciones puede crear los tipos siguientes de aplicaciones API de para colaboraciones y comunicaciones en tiempo real:

  • Un cliente de comunicaciones completo como Microsoft (). De hecho, está integrado en la API de . Este tipo de aplicación puede admitir mensajería instantánea, conferencia, voz o vídeo sobre IP e integración de telefonía. También se puede utilizar para realizar el seguimiento de la presencia de los contactos del usuario y otros datos específicos de la aplicación debido al soporte de la plataforma de un marco de suscripción y una publicación general.
  • Una aplicación dirigida a características que interopera con y proporciona funcionalidad aumentada o servicios personalizados. Este tipo de aplicación permite a un proveedor de servicios aprovecharse de las ventajas de una base de instalación de existente dentro de una empresa. Sin embargo, estas aplicaciones deben procurar evitar la publicación de datos y la creación o aceptación de sesiones de manera que interfiera con .
  • Una aplicación de línea de negocio (LOB) integrada que incrusta funciones de presencia y comunicaciones en aplicaciones de línea de negocio existentes. Por ejemplo, una aplicación de administración de relaciones de clientes (CRM) puede integrar seguimiento de presencia para decidir cómo enviar solicitudes personalizadas a los representantes de servicio más adecuados.

Un desarrollador puede utilizar la API de para crear una aplicación que habilite comunicaciones en tiempo real multimodales integradas dentro o en los límites de la red. La aplicación resultante puede ayudar a que el equipo sea el centro para las comunicaciones de negocio en tiempo real. Las llamadas de audio y vídeo, así como la mensajería instantánea (MI) y la colaboración, están todas ellas integradas en una sesión de usuario en el equipo. Además de las sesiones de comunicaciones entre equipos, el usuario también puede crear llamadas de equipo a teléfono, llamadas de teléfono a teléfono o sesiones de mensajería instantánea de sólo texto.

La información de presencia proporciona a un usuario datos de la disponibilidad de los contactos del usuario en tiempo real, con la ayuda de un servidor de registro. Por lo tanto, un usuario puede utilizar este tipo de aplicación para llamar a los contactos sin tener que averiguar la ubicación exacta de un contacto ni elegir el número de teléfono correcto para llamar. Por ejemplo, si marca el teléfono de un contacto en su ubicación de trabajo y la información de presencia indica que está disponible en un equipo en su domicilio, la llamada se puede redirigir automáticamente a esa ubicación. Un usuario también puede mantener su confidencialidad impidiendo a los autores de llamadas el acceso a su información de presencia.

Un ejemplo de comunicaciones en tiempo real de este tipo para aplicaciones de negocio podría ser una experiencia de comunicaciones personalizadas para los usuarios de sus aplicaciones; por ejemplo, una aplicación de administración de relaciones de clientes (CRM) que sitúe a todas las partes interesadas en una oportunidad de ventas en una videoconferencia y comparta los datos sobre el cliente.

Los servicios de mensajería instantánea los utilizan actualmente la red Microsoft MSN® de servicios de Internet, Yahoo! y AOL con centenares de millones de usuarios de forma global.

SDK de comunicaciones unificadas de AJAX 2007

Microsoft® () consta de los componentes siguientes:

  • es una interfaz de programación de aplicaciones para . La API se compone de métodos y eventos. Un cliente envía un método como una solicitud a un servidor de y el cliente recibe datos como eventos del servidor. Las solicitudes y los eventos se especifican como un elemento XML. La comunicación se realiza principalmente como solicitudes POST HTTP con solicitudes GET HTTP en escenarios individuales. A diferencia de las aplicaciones diseñadas como servicios Web, el servidor de no analiza los mensajes SOAP, ni proporciona un documento WSDL para consumo de las herramientas de desarrollo de aplicaciones cliente. Este enfoque presenta dos ventajas. La primera y más importante es que evita la creación de sobrecarga cuando el código JavaScript debe generar o analizar documentos SOAP más grandes. La segunda es que un conocimiento general de XML en lugar del conocimiento específico de mensajes SOAP es suficiente para la ejecución correcta de .
  • Bibliotecas de JavaScript de comunicaciones unificadas basadas en el servicio AJAX. Estas son clases de JavaScript que encapsulan la funcionalidad necesaria utilizada normalmente de un cliente de bibliotecas de JavaScript de comunicaciones unificadas. La funcionalidad común incluye la creación y el mantenimiento de los canales de comunicación, el inicio de sesión en un servidor, la incrustación de la presentación de la presencia de un usuario en una página web, el inicio de una conversación de mensajería instantánea, etc. Mediante el uso de las bibliotecas, un desarrollador de aplicaciones puede crear un cliente de bibliotecas de JavaScript de comunicaciones unificadas con sólo crear instancias de las bibliotecas, establecer las propiedades adecuadas e invocar los métodos deseados.

El servidor de proporciona acceso a la funcionalidad de comunicaciones unificadas.

Office Live Meeting Service API

Microsoft () proporciona acceso mediante programación a la mayor parte de la funcionalidad disponible mediante los clientes de Office Live Meeting basados en web y basados en Windows.

La documentación de consta de dos partes:

  • Una guía general para introducir a los nuevos programadores en los conceptos de Live Meeting y la interfaz de programación de aplicaciones (API) con ejemplos y tutoriales.
  • Una referencia de API detallada, que incluye información sobre mensajes admitidos públicamente, elementos XML constituyentes, códigos de error y otra información técnica.

La documentación de API está dirigida a ingenieros, desarrolladores y programadores que diseñan, implementan y prueban soluciones de conferencia web basadas en la tecnología de Live Meeting. Debe estar familiarizado con los conceptos básicos de HTTP y XML.

Un desarrollador puede utilizar los servicios de Live Meeting para administrar reuniones en línea. Entre las tareas se incluyen las siguientes: programar una reunión; invitar a otras personas a participar en la reunión; agregar una cuenta de usuario a un centro de conferencias de Live Meeting; cargar presentaciones y otros recursos; administrar grabaciones, preferencias del usuario y una libreta de direcciones; crear un informe sobre la asistencia a la reunión y otras estadísticas. Muchas de estas tareas se pueden realizar mediante programación.

Se puede tener acceso a los servicios de Live Meeting mediante la interfaz de usuario basada en web de Live Meeting o el procesador API. Un usuario puede utilizar la interfaz de usuario basada en web para realizar todas las actividades relacionadas con una reunión. El procesador API del servicio de Live Meeting actúa como puerta de enlace para el acceso mediante programación a los servicios de Live Meeting y para la administración de usuarios, recursos y reuniones.

Office Live Meeting Service Portal API

Microsoft () es un complemento de Service Pack 2.

(el Portal) es una aplicación web de Microsoft Internet Information Services (IIS) que utiliza ASP.NET. El Portal se instala en un servidor web de Microsoft Windows®. El Portal se comunica con el servicio de Live Meeting mediante llamadas a API XML enviadas a través de Internet.

Los usuarios pueden usar sus exploradores web para obtener acceso a las páginas web del Portal con el fin de:

  • Crear una cuenta de Live Meeting nueva
  • Iniciar sesión en el servicio de Live Meeting
  • Cambiar la contraseña de la cuenta de Live Meeting
  • Permitir que los usuarios tengan acceso a contenido avanzado relacionado con Live Meeting

Los programas o los scripts que llaman a los métodos web del Portal pueden automatizar la administración de cuentas de Live Meeting. Use los métodos Web para:

  • Crear o eliminar una cuenta de Live Meeting
  • Activar o desactivar una cuenta de Live Meeting
  • Cambiar la contraseña de una cuenta de Live Meeting
  • Conocer el estado de una cuenta de Live Meeting.