Usar los servicios web de Dynamics 365 Customer Engagement (on-premises)

Los servicios web proporcionan API que usará para escribir programas para Dynamics 365 Customer Engagement (on-premises). 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 Customer Engagement (on-premises). 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 Customer Engagement (on-premises) y futuras versiones de Dynamics 365 Customer Engagement (on-premises). Use la API web para cualquier proyecto que tenga acceso a los datos de Dynamics 365 Customer Engagement (on-premises) 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 Customer Engagement (on-premises). 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 Customer Engagement.

Servicio de 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 Customer Engagement (on-premises). 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 que permite el acceso al 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 como llamadas ya que se transferirá automáticamente del extremo de 2011 SOAP para usar la API web. Esta actualización será en su mayoría transparente para usted y solo requerirá que reemplace los ensamblajes SDK de la carpeta en tiempo de ejecución de su aplicación con ensamblajes revisados. Para obtener detalles adicionales e información nueva sobre el desarrollo de .NET Core, consulte Aplicaciones de transición a Dataverse ServiceClient.

Ver Elegir su estilo de desarrollo 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. Puede seguir usando el servicio de organización para admitir cualquier funcionalidad que desee implementar para organizaciones que usen versiones más antiguas de Dynamics 365 Customer Engagement (on-premises) lanzadas antes de que estuviera disponible la API web.

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: Usar el servicio de organización de Dynamics 365 Customer Engagement (on-premises)

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 en Dynamics 365 Customer Engagement (on-premises). 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 de 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 Customer Engagement (on-premises) es una aplicación multiempresa. Esto significa que una única implementación puede hospedar múltiples instancias de Customer Engagement (on-premises), cada una con sus propios datos, cada una disponible mediante una URL diferente. Además, especialmente cuando los Dynamics 365 Servers 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 utilizar la API Web de OData V4 o la API de ensamblado del SDK basado en SOAP para acceder al servicio web de detección. Aunque las dos APIS ofrecen una funcionalidad similar, 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 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.

Consultar también

Autenticar usuarios en Dynamics 365 Customer Engagement
Autenticar usuarios en Dynamics 365 Customer Engagement (on-premises)
Usar servicios web de Dynamics 365 Customer Engagement
Crear aplicaciones cliente de Windows mediante las herramientas XRM
Manual para desarrolladores de aplicaciones basadas en modelos