Trabajar con datos mediante código en Microsoft Dataverse
Hay varias formas diferentes de tener acceso a datos de Dataverse usando código.
- Utilice el Dataverse SDK para .NET o la API web para recuperar, agregar y modificar datos.
- Utilice búsqueda de Dataverse búsqueda de datos de Dataverse.
- Utilice el punto de conexión de Tabular Data Stream (TDS) de Dataverse a datos de consulta con SQL.
Este artículo presenta las opciones que tiene para trabajar con datos de Dataverse usando código.
Recuperar, agregar y modificar datos
Dataverse proporciona dos formas para recuperar, agregar y modificar datos: SDK para .NET y la API web. Elija la que mejor se adapte a los requisitos, sus capacidades y preferencias.
SDK para .NET
Si está trabajando con .NET, le recomendamos utilizar nuestro SDK para .NET.
- Utilice la clase ServiceClient en el paquete de DataverseServiceClient NuGet si tiene una aplicación cliente.
- Utilice el paquete Microsoft.CrmSdk.CoreAssemblies NuGet cuando esté escribiendo un complemento o un actividad de flujo de trabajo personalizado.
El SDK de Dataverse para .NET admite objetivos de compilación tanto para .NET Framework como para .NET 6+. Sin embargo, las actividades de complemento y de flujo de trabajo personalizado deben utilizar .NET Framework.
Si está utilizando nuestro módulo PowerShell o utilizando nuestro control de inicio de sesión personalizado con una aplicación cliente de Windows, utilice el Xrm.Tooling
API Web
La API web de Dataverse es un punto de conexión de RESTful de OData v4. Use la API web para cualquier lenguaje de programación que admita solicitudes HTTP y autenticación mediante OAuth 2.0, incluyendo .NET.
- Aprender a usar la API web de Dataverse
- Inicio rápido de la API web con PowerShell y Visual Studio Code
- Tutorial: Ejemplo de API Web (C#)
Buscar datos de Dataverse
La búsqueda de Dataverse ofrece resultados rápidos y completos en varias tablas, en una sola lista, ordenada por relevancia. También proporciona capacidades para admitir sugerencias y experiencias de autocompletado en aplicaciones.
La búsqueda tiene un punto de conexión nativo y hay mensajes de Dataverse que puede usar desde la API web o el SDK para .NET.
Aprender a buscar registros de Dataverse
Datos de consulta con SQL web
El conector Power Query Dataverse usa el punto de conexión de Dataverse Tabular Data Stream (TDS) para recuperar datos usando SQL de Dataverse, un subconjunto de Transact-SQL.
La recuperación de datos mediante SQL Management Studio (SSMS) es una característica en vista previa.
Aprender a usar SQL a datos de consulta
Solicitud y limitaciones de tamaño de carga útil respuesta
El tamaño máximo de carga útil para cualquier solicitud enviada a Dataverse es 128 MB. Las solicitudes con cargas útiles superiores a este límite reciben un código de estado HTTP 413 Carga útil demasiado grande en respuesta.
Hay un límite de tamaño de 1 GB en el tamaño de una respuesta que Dataverse devuelve. Pocas API o consultas son capaces de devolver tantos datos. Si encuentra este límite, debe considerar qué otras opciones están disponibles para obtener los datos en múltiples solicitudes más pequeñas.
Las cargas útiles SOAP punto de conexión obsoletas utilizan datos XML serializados que son mucho más detallados que las cargas útiles de datos JSON serializados que utiliza la API web. Es menos probable que encuentres errores en los que la solicitud o la carga útil respuesta sea demasiado grande cuando usas la API web. Aprenda sobre el SOAP heredado punto de conexión
Nota
¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)
La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).