Usar los servicios web Dynamics 365 for Customer Engagement

Se aplica a las aplicaciones Dynamics 365 for Customer Engagement, versión 9.x

Los servicios web proporcionan API que usará para escribir programas para Dynamics 365 for Customer Engagement Customer Engagement. Este tema presenta los servicios web disponibles y proporciona información básica para entenderlos y compararlos.

API web

La API Web se introdujo con la versión 8.0 y gradualmente se ha actualizado para proporcionar paridad con el servicio de la organización. Con esta versión se logra paridad.

En comparación con el servicio de organización, la API web proporciona una mejor compatibilidad en una gran variedad de lenguajes de programación, de plataformas y de dispositivos. La API web implementa OData (Open Data Protocol) v4. OData es una norma OASIS para crear y consumir API RESTful a través de orígenes de datos enriquecidos. Puede obtener más información en los sitios web del Protocolo OData y la Norma OASIS.

Puesto que la API web se basa en estándares abiertos, no se requiere usar bibliotecas de cliente específicas de Dynamics 365 for Customer Engagement. Puede crear solicitudes HTTP para operaciones específicas o usar bibliotecas de terceros para generar clases para cualquier idioma o plataforma que desee usar. Ver una lista de bibliotecas disponibles.

Por último, la API web reemplazará el servicio de organización y el servicio de datos de organización pero ambos servicios web existentes estarán disponibles para habilitar una transición gradual a una sola API web. La API web debe ser la primera opción para el nuevo desarrollo que admitirá Dynamics 365 for Customer Engagement y futuras versiones de Dynamics 365 for Customer Engagement. Use la API web para cualquier proyecto que tenga acceso a los datos de Dynamics 365 for Customer Engagement con código que no se ejecute en el servidor, incluida los recursos web de formularios de solicitud y scripts de formularios que se ejecutan en aplicaciones clientes de Dynamics 365 for Customer Engagement. En este momento no puede usar con facilidad la API web que se ejecuta en el servidor, como en los complementos o ensamblados de flujo de trabajo. Debe continuar utilizando el servicio de la organización para estos fines.

Más información: Usar la API web de Dynamics 365 for Customer Engagement.

Servicio de la organización

El servicio de la organización ha estado disponible desde Dynamics CRM 2011. Es el servicio web con el que ya están familiarizado la mayoría de los programadores que trabajan con Dynamics 365 for Customer Engagement. El servicio de organización está optimizado para uso con .NET. Existe un conjunto de ensamblados y herramientas .NET para permitirle generar clases y proxys con establecimiento inflexible que agilizan el proceso de desarrollo y disfrutan de una mejor experiencia de desarrollo mediante Visual Studio.

Actualmente, los conjuntos de .NET para el servicio de la organización utilizan un punto de conexión del 2011 SOAP que está obsoleto. Los ensamblados del SDK migrarán eventualmente para usar internamente la API web en lugar del extremo de 2011 SOAP. Cuando esto ocurre, el código escrito mediante los ensamblados del SDK seguirá siendo admitido ya que se transferirá automáticamente del extremo de 2011 SOAP para usar la API web. Esta actualización será completamente transparente para usted; se publicarán detalles adicionales en versiones futuras del SDK.

Consulte Elegir su estilo de desarrollo de aplicaciones Dynamics 365 for Customer Engagement para obtener información sobre si desea utilizar el servicio de la organización o la API Web.

Si usted es desarrollador de .NET sin requisitos para admitir otras plataformas, no tiene que debe pasar a la API web directamente. Deberá usar el servicio de organización para admitir cualquier funcionalidad que desee implementar para organizaciones que usen versiones de Dynamics 365 for Customer Engagement lanzadas antes de Dynamics 365 for Customer Engagement.

La lógica de negocios que se ejecuta en los complementos o los ensamblados de flujo de trabajo en el servidor esperan usar el servicio de organización. Los parámetros de entrada y de salida usan clases específicas definidas con los ensamblados que admiten el servicio de organización.

Más información: Utilizar el servicio de organización del servicio Dynamics 365 for Customer Engagement

Servicio de datos de la organización

El servicio de datos de organización, también conocido como extremo “OData" o "REST", también ha estado disponible desde Dynamics CRM 2011. Este servicio implementó la norma OData v2. Aunque este servicio seguirá estando disponible tal como es en los años venideros, lo estamos sustituyendo por Dynamics 365 for Customer Engagement. El servicio de organización se ha limitado siempre a realizar operaciones de creación, lectura, actualización y eliminación y nunca admitió la posibilidad de llamar a mensajes especializados usados en el servicio de organización, por lo que nunca pudo lograr paridad con la funcionalidad del servicio de organización. Los cambios implementados en las normas OData entre v2 y v4 no permiten actualizar el servicio para cumplir los requisitos de un servicio que tenga paridad con los servicios de organización. Hemos podido aplicar muchos comentarios que recibimos sobre el servicio de datos de organización y aplicarlos para mejorar la API web.

Esta versión del Servicios web de Dynamics 365 Customer Engagement no incluye información sobre el servicio de datos de organización. Puede encontrar información sobre el servicio de datos de organización en la documentación de la versión de Dynamics CRM 2015 en Usar el extremo OData con recursos web.

Servicios web de detección

Dynamics 365 for Customer Engagement es una aplicación multiempresa. Esto significa que una única implementación puede hospedar múltiples instancias de Customer Engagement, cada una con sus propios datos, cada una disponible mediante una URL diferente. Además, especialmente cuando los servidores Dynamics 365 for Customer Engagement se hospedan en un centro de datos, el servidor específico puede cambiar cuando se mueven los recursos o se equilibra la carga. Los servicios web de detección proporcionan una forma para que un cliente detecte qué servidores y organizaciones están disponibles para que un usuario se conecte en función de su cuenta de usuario. Puede optar por usar el servicio de detección de API web o el servicio web IDiscoveryService. El servicio de detección de API web proporciona las mismas ventajas que la API web, es más fácil de consumir para una gama más amplia de lenguajes de programación, de plataformas y de dispositivos.

Más información: Detectar la dirección URL de su organización con la API web o Detectar la dirección URL de la organización con el servicio web IDiscoveryService

Servicio web de implementación

Para Dynamics 365 for Customer Engagement (on-premises) puede realizar acciones para administrar la implementación mediante programación usando el servicio web de implementación. Éstas son esencialmente las mismas operaciones que puede realizar en el servidor mediante el cliente de la herramienta de administrador de implementaciones instalado en el servidor. Puede crear, importar, o eliminar organizaciones así como aplicar algunos valores en código. Esto puede resultar útil cuando desea automatizar algunos procesos si ofrece un servicio de hospedaje o si desea automatizar la creación de entornos para prueba.

Vea también

Conectar con las aplicaciones Dynamics 365 for Customer Engagement.
Autenticar usuarios para aplicaciones Dynamics 365 for Customer Engagement
Usar los servicios web Dynamics 365 for Customer Engagement
Crear aplicaciones cliente de Windows mediante las herramientas XRM
Escriba aplicaciones modernas y móviles