Versiones de la API web de Microsoft Dataverse

A partir de la versión v9.0 de Dynamics 365, la API web admite diferencias específicas de la versión en el mismo entorno.

Esto es diferente del comportamiento en las versiones v8.x. En las versiones anteriores, las nuevas funcionalidades estaban disponibles para cualquier versión del servicio en función de la actualización aplicada al entorno. Después de una actualización a v8.2, los servicios v8.0 y v8.1 eran idénticos. Esto fue posible porque todos los cambios fueron aditivos. No se quitó nada o se introdujeron cambios importantes. Como resultado, la versión específica a la que se hace referencia en la dirección URL del servicio para la versión 8. x no era realmente importante.

En el futuro, las funcionalidades del servicio pueden cambiar, incluidos los cambios potencialmente importantes, como la eliminación de operaciones específicas. Esto permitirá aplicar mejoras de forma continuada. En este tema se registrarán las diferencias específicas de la versión y las limitaciones en las que la API web aún no ha logrado la paridad con el SDK para .NET.

Nota:

Aunque las versiones v9.x pueden admitir diferencias específicas, no se han agregado cambios importantes a las versiones v9.0, v9.1 o v9.2. Cada una de estas versiones tiene comportamientos idénticos de api web.

Las diferencias en el comportamiento de la API se controlan más por las soluciones instaladas en el sistema en lugar de por la versión del producto. Sin embargo, si necesitamos realizar un cambio fundamental que no sea compatible con versiones anteriores, se incluirá en un nuevo número de versión.

Guía: use el número de versión que estaba activo cuando se escribió el código. No utilice automáticamente una versión más reciente sin buscar aquí las diferencias documentadas y realizar pruebas. No suponga que una versión más reciente será totalmente compatible con versiones anteriores.

Diferencias específicas de la versión de la API web

Las diferencias siguientes hacen referencia a los cambios en las versiones v8.2 y v9.0 de la API web.

Codificación para caracteres especiales en la respuesta de consulta FetchXML

Para versiones de v8.x, la respuesta de las consultas FetchXML que contienen entidades de vínculo y sus atributos contienen caracteres especiales Unicode de forma que '.' se convierte en 'x002e' y '@' se convierte en 'x0040'. Esta codificación para caracteres especiales no está presente en las respuestas de las consultas FetchXML para la versión v9.x.

Mismo nombre para la tabla y la columna

Si el nombre de una tabla (entidad) y una de sus columnas (atributos) es el mismo, "1" se anexa al nombre de atributo en instancias v8.x. Por ejemplo, si una entidad new_zipcode tiene un atributo con el nombre como new_zipcode , el nombre del atributo cambiará a new_zipcode1.

En v9.x instancias, no se añade nada al nombre del atributo.

Nuevas operaciones agregadas

Las siguientes operaciones se han agregado a la API web para la versión v9.x.

Operations	Operaciones (cont'd)	Operaciones (cont'd)
GrantAccessRequest	ModifyAccessRequest	RetrieveSharedPrincipalsAndAccessRequest

Limitaciones de la API web

La API web de Dataverse proporciona una paridad completa con las funcionalidades del SDK para .NET. En este tema, para Dataverse se describen las limitaciones que se han trasladado desde la versión v8.x de Dataverse. Para obtener versiones anteriores, consulte Limitaciones de la API web de Dynamics CRM 2016.

Nota:

Si definió una acción personalizada que incluía un valor devuelto complejo y un valor devuelto simple, una acción correspondiente no estaba disponible en la API web, pero estaba disponible mediante el servicio Organización. Un valor devuelto complejo es , EntityReferenceEntityo EntityCollection. Puede tener cualquier combinación de valores devueltos simples o un único valor devuelto complejo. Más información: Cree sus propios mensajes.

Consulte también

Usar la API web de Dataverse
Autenticación en Dataverse con la API web
Operaciones y tipos de API web
Realización de operaciones mediante la API web