No utilice el punto de conexión OData v2.0

Categoría: Compatibilidad

Potencial de impacto: alto

Síntomas

No hay síntomas inmediatos, pero el código que usa este punto de conexión dejará de funcionar cuando se elimine el punto de conexión obsoleto.

Planeamos eliminar este punto de conexión el 11 de noviembre de 2022. Anuncio de la fecha de eliminación del servicio OData v2.0

Instrucciones

Debe cambiar cualquier código que dependa de la Organización Data Service (OData v2.0) para usar el punto de conexión de la API web Dataverse (OData v4.0) en su lugar.

Para aplicaciones basadas en modelos, debe usar Xrm.WebApi (referencia de API de cliente), que proporciona acceso a la API web Dataverse para extensiones del lado del cliente que utilizan recursos web de JavaScript.

Patrones problemáticos

El servicio de datos de la Organización Data Service usa este punto de conexión: /XRMServices/2011/OrganizationData.svc. Debes buscar cualquier código activo usando este punto de conexión.

Dynamics CRM SDK proporcionó una biblioteca de JavaScript de ejemplo como un recurso web de JavaScript denominado sample_/Scripts/SDK.REST.js, que se puede encontrar aquí. El Xrm.WebApi (referencia de API de cliente) proporciona funciones similares para crear, actualizar, eliminar y recuperar registros.

El punto de conexión de la Organización Data Service también es usado a veces por scripts de PowerShell usando Invoke-WebRequest.

Información adicional

Organization Data Service es un OData v2.0 punto de conexión introducido con Dynamics CRM 2011. Quedó en desuso con Dynamics 365 Customer Engagement v8.0. También conocido como el punto de conexión OData o punto de conexión REST cuando se publicó, este punto de conexión solo ofrece la posibilidad de realizar operaciones de creación, recuperación, actualización y eliminación en tablas.

Nota

Ambos son puntos de conexión de OData, pero existen diferencias en cómo se implementan. No espere que el código existente funcione solo con cambios menores.

Algunas de las principales diferencias se describen a continuación.

Nombre de recurso

Los nombres de los recursos de la API web para las tablas se basan en EntitySetName. Los nombres de los servicios de datos de la organización tenían Set adjunto al SchemaName. Por ejemplo:

Web API	Servicio de datos de la organización
cuentas	AccountSet
contactos	ContactSet
Tareas de	TaskSet

Nombre de columna

Los nombres de las columnas en la API web están todos en minúsculas con la extensión LogicalName. Con la Organización Data Service, los nombres de columna usan SchemaName.

Métodos HTTP

Organización Data Service usa MERGE o PUT en vez de PATCH.

Formato de datos

La Organización Data Service es compatible con JSON y ATOM. ATOM es un formato basado en XML que generalmente se usa para fuentes RSS. La API web solo es compatible con JSON.

Límites en el número de registros devueltos

La Organización Data Service solo devolverá 50 registros a la vez y no proporciona una forma de especificar el tamaño máximo de página.

La API web permite establecer un tamaño máximo de página y devolverá hasta 5000 registros. Más información: Límites en el número de filas de tabla (entidades) devueltas.

Documentación heredada

La documentación que describe la Organización Data Service está disponible aquí: Microsoft Dynamics SDK de 2015: use OData punto de conexión con recursos web.

Consulte también

Cómo utilizar Application Insights para identificar el uso del punto de conexión OrganizationData.svc, cuyo retiro está previsto para noviembre de 2022 (Foro de la comunidad)
Cómo utilizar Solution Checker para identificar el uso del punto de conexión OrganizationData.svc, cuyo retiro está previsto para noviembre de 2022 (Foro de la comunidad)
Usar la API web de Microsoft Dataverse