Usar los servicios web de Microsoft Dynamics 365
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Los servicios web proporcionan API que usará para escribir programas para Microsoft Dynamics 365 (en línea y local). Este tema presenta los servicios web disponibles y proporciona información básica para entenderlos y compararlos.
En este tema
Web API
Servicio de la organización
Servicio de datos de la organización
Servicios web de detección
Servicio web de implementación
Web API
La API web es nueva para Microsoft Dynamics 365 (en línea y local) y proporcionará paridad con el servicio de la Organization.
Nota
Para esta versión inicial hay varios problemas que se resolverán antes de que se alcance la paridad completa. Para obtener información sobre problemas pendientes, vea Limitaciones de la API web de Microsoft Dynamics 365.
En comparación con el servicio Organization, la Web API proporciona una mejor compatibilidad en una gran variedad de lenguajes de programación, de plataformas, y de dispositivos. La Web API 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 Web API se basa en estándares abiertos, no se requiere usar bibliotecas de cliente específicas de Microsoft Dynamics 365. 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 Web API reemplazará el servicio Organization y el servicio Organization Data pero ambos servicios web existentes estarán disponibles para habilitar una transición gradual a una sola Web API. La Web API debe ser la primera opción para el nuevo desarrollo que admitirá Microsoft Dynamics 365 y futuras versiones de Microsoft Dynamics 365 (online). Use la Web API para cualquier proyecto que tenga acceso a los datos de Microsoft Dynamics 365 con código que no se ejecute en el servidor, incluidas XmlHttpRequests desde recursos web y scripts de formularios que se ejecutan en aplicaciones clientes de Microsoft Dynamics 365. En este momento no puede usar con facilidad la Web API que se ejecuta en el servidor, como en los complementos o ensamblados de flujo de trabajo.
Más información:Use la API web de Microsoft Dynamics 365.
Servicio de la organización
El servicio Organization, también conocido como “extremo SOAP”, ha estado disponible desde Microsoft Dynamics CRM 2011. Es el servicio web con el que ya están familiarizado la mayoría de los programadores que trabajan con Microsoft Dynamics 365. El servicio Organization está optimizado para uso con .NET. El SDK de Microsoft Dynamics 365 proporciona un conjunto de ensamblados y herramientas para permitir generar clases y proxys con establecimiento inflexible que agilizan el proceso de desarrollo y disfrutan de una mejor experiencia de desarrollo mediante Microsoft Visual Studio. 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 Organization para admitir cualquier funcionalidad que desee implementar para organizaciones que usen versiones de Microsoft Dynamics 365 lanzadas antes de Microsoft Dynamics 365.
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 Organization. Los parámetros de entrada y de salida usan clases específicas definidas con los ensamblados que admiten el servicio Organization.
Más información:Usar el servicio de la organización de Microsoft Dynamics 365
Servicio de datos de la organización
El servicio Organization Data, también conocido como “extremo OData" o "REST”, también ha estado disponible desde Microsoft 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 Microsoft Dynamics 365. El servicio Organization Data 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 Organization, 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 SDK de Microsoft Dynamics 365 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 Microsoft Dynamics CRM 2015 en Usar el extremo OData con recursos web.
Servicios web de detección
Microsoft Dynamics 365 es una aplicación multiempresa. Esto significa que una única implementación puede hospedar múltiples instancias de Dynamics 365, cada una con sus propios datos, cada una disponible mediante una URLdiferente. Además, especialmente cuando los servidores Microsoft Dynamics 365 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 Web API Discovery o el servicio web IDiscoveryService. El servicio Web API Discovery proporciona las mismos ventajas que la Web API, 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:Detecte la dirección URL de su organización con la API web. o Descubra la dirección URL de su organización mediante la utilización del servicio de organización
Servicio web de implementación
Para Dynamics 365 (local) 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.
Más información:Introducción al servicio web de implementación.
Ver también
Conectarse a Microsoft Dynamics 365
Autenticar usuarios en Microsoft Dynamics 365
Use Microsoft Dynamics 365 web services
Crear aplicaciones cliente de Windows mediante las herramientas XRM
Escriba aplicaciones modernas y móviles
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright