Usar el extremo de OData con recursos web
Publicado: noviembre de 2016
Se aplica a: Dynamics CRM 2015
El extremo OData con los recursos web proporciona una interfaz alternativa para trabajar con los datos de Microsoft Dynamics CRM 2015 y actualización de Microsoft Dynamics CRM Online 2015. Puede usar el extremo de OData para ejecutar las solicitudes de HTTP mediante un servicio que se basa en un identificador uniforme de recursos (URI).
En este tema
¿Qué es OData?
Implementación de Microsoft Dynamics CRM de OData
Herramientas de terceros para generar código
¿Qué es OData?
El extremo OData usa el protocolo de datos abiertos. Este protocolo implementa un patrón de diseño "RESTful". Por sus siglas en inglés, REST significa Transferencia de estado representacional.REST es un estilo arquitectónico en el que todos los recursos se direccionan mediante un URI único. En Microsoft Dynamics 365, un recurso puede ser una colección de entidades o un registro.
REST trabaja de la manera en que trabaja Internet. Puede interactuar con los recursos mediante verbos HTTP como GET, POST, MERGE, y DELETE. Las diferentes bibliotecas se pueden usar para procesar solicitudes y respuestas de HTTP.REST proporciona una interfaz estándar que pueda usar con cualquier lenguaje de programación.REST permite el procesamiento sincrónico o asincrónico de operaciones. La capacidad para realizar operaciones asincrónicas crea un REST bien adaptado para los recursos y scripts usados en Microsoft Dynamics CRM 2015 y actualización de Microsoft Dynamics CRM Online 2015.
Implementación de Microsoft Dynamics CRM de OData
Microsoft Dynamics CRM 2015 y actualización de Microsoft Dynamics CRM Online 2015 usa el marco de servicio de datos de Windows Communication Foundation (WCF) para proporcionar un extremo de Protocolo de datos abiertos (OData) que es un servicio de datos basado en REST. Este extremo se denomina Organization Data Service. En Microsoft Dynamics 365, la raíz de servicio URI es:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc
OData envía y recibe datos mediante cualquier ATOM o notación de objeto de JavaScript (JSON).ATOM es un formato basado en XML usado normalmente para fuentes RSS.JSON es un formato de texto que permite la serialización de objetos JavaScript.
Para ofrecer un conjunto coherente URIs de corresponda a las entidades que se usan en Microsoft Dynamics 365, un Entity Data Model (EDM) organiza los datos en el formulario de registros de "tipos de entidad" y las asociaciones entre ellos.
Entity Data Model (EDM) de OData
El EDM de Microsoft Dynamics 365 se describe en un documento de Metadatos de servicio de OData disponible en la siguiente ruta de acceso:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc/$metadata
Este documento XML usa un lenguaje de definición de esquema conceptual (CSDL) para describir los datos disponibles. Se descargará este documento y lo usará para generar clases con establecimiento inflexible de tipos al usar un código administrado o como una referencia para objetos disponibles cuando se usa JavaScript.
Limitaciones
El extremo OData proporciona una alternativa para el extremo de SOAP, pero actualmente hay algunas limitaciones.
Solo las acciones Crear, Recuperar, Actualizar y Eliminar pueden realizarse en los registros de la entidad.
Los mensajes que requieren el método de Execute no pueden realizarse.
Las acciones de asociación y desasociación pueden realizarse mediante propiedades de navegación.
El protocolo OData no se implementó por completo. Algunas opciones de consulta del sistema no están disponibles.
Para obtener más información, vea Opciones de la consulta del sistema OData mediante el extremo OData.No puede usar el último enlace con tiempo de ejecución con el código administrado frente a entidades, atributos o relaciones que no existían cuando se escribió el código.
Habitualmente usará clases de servicios de datos del cliente de los servicios de datos de WCF mientras programa a través del código administrado. Estas permiten realizar enlaces de tiempo de compilación de manera que pueda obtener clases con establecimiento inflexible de tipos en el tiempo de diseño. Las únicas entidades disponibles para usted son las definidas en el sistema cuando se generaron las clases. Esto quiere decir que no puede usar los enlaces de tiempo de ejecución con entidades, atributos o relaciones personalizados que no se incluyeron en las clases de datos de cliente de los servicios de datos de WCF al momento de su generación.
Herramientas de terceros para generar código
La comunidad de programadores que trabajan con Microsoft Dynamics 365 ha creado algunas herramientas que muestran cómo funciona el extremo OData y pueden generar código que puede usar. Las siguientes herramientas proporcionan capacidades de generar código para trabajar con datos de Dynamics 365 mediante el extremo de OData.
CRM REST Builder
Use esta herramienta crear solicitudes para recuperar datos y realizar operaciones con una variedad de bibliotecas de JavaScript .Gracias a Microsoft Dynamics 365 MVP Jason Lattimer por crear esta herramienta.
Diseñador de consultas OData
Incluido con el proyecto Рerramientas de Вynamics XRM, el Diseñador de consultas de OData le permite crear consultas para recuperar datos mediante el extremo de OData.Gracias a Microsoft Dynamics 365 MVP Rhett Clinton por crear esta y otras herramientas.
Ver también
Usar los datos del servicio web en los recursos web (extremo de SOAP para OData y aplicaciones modernas)
Usar el extremo de SOAP de aplicaciones modernas para aplicaciones modernas con recursos web
Recursos web para Microsoft Dynamics CRM 2015
Descargar los extremos usando la página de recursos para programadores de Microsoft Dynamics CRM 2015
Consultar datos de Microsoft Dynamics CRM 2015 utilizando el extremo de OData
Realizar las operaciones básicas de datos mediante el extremo de OData
Usar el extremo de OData con recursos web Ajax y JScript
Realice las operaciones adicionales de datos mediante el extremo de OData
Ejemplo: crear, recuperan, actualizar y eliminar el uso del extremo de OData con JavaScript y jQuery
Ejemplo: crear, recuperar, actualizar y eliminar el uso del extremo de OData con JavaScript
Ejemplo: editor de contactos de jQuery del extremo OData
Información general de Open Data Protocol
SDK de OData
Artículo técnico: Uso del conjunto de opciones con el extremo de REST - JScript
© 2017 Microsoft. Todos los derechos reservados. Copyright