Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
El soporte difiere 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. Este cambio permite aplicar mejoras de forma continuada. En este tema se registran 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, las versiones v9.0, v9.1 y v9.2 no incluyen cambios importantes. 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 la versión del producto. Sin embargo, si Microsoft necesita realizar un cambio fundamental que no sea compatible con versiones anteriores, incluye el cambio en un nuevo número de versión.
Guía: use el número de versión que estaba activo al escribir el código. No use automáticamente una versión más reciente sin buscar diferencias y pruebas documentadas. No suponga que una versión más reciente es totalmente compatible con versiones anteriores.
Diferencias específicas de la versión de la API web
Las siguientes diferencias 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 las versiones v8.x, la respuesta a las consultas FetchXML que contienen entidades vinculadas y sus atributos incluye 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 la respuesta a 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, el sistema anexa "1" al nombre de atributo en instancias v8.x. Por ejemplo, si una entidad new_zipcode tiene un atributo con el nombre new_zipcode, el nombre del atributo cambia a new_zipcode1.
Para las instancias v9.x, el sistema no agrega nada al nombre del atributo.
Nuevas operaciones agregadas
Las siguientes operaciones se agregan a la API web para la versión v9.x.
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 define una acción personalizada que incluye un valor devuelto complejo y un valor devuelto simple, la API web no proporciona una acción correspondiente. Sin embargo, el servicio de la organización proporciona esta acción. Un valor devuelto complejo es , EntityReferenceEntityo EntityCollection. Puede tener cualquier combinación de valores devueltos simples o un único valor devuelto complejo. Para obtener más información, vea Crear sus propios mensajes.
Consulte también
Usar la API web de Dataverse
Autenticación en Dataverse con la API web
Tipos y operaciones de API web
Realizar operaciones usando la API web