Utilice el SDK para .NET

El SDK para .NET proporciona acceso a los datos comerciales, definiciones de tablas de datos (metadatos) y operaciones de datos admitidas por plataforma Dataverse.

Hay ciertos escenarios de desarrollo en los que se debe utilizar Dataverse SDK para .NET. Al escribir código personalizado para ampliar la funcionalidad de Dataverse, como al crear complementos y actividades de flujo de trabajo personalizadas, debe compilar su código utilizando .NET Framework y Dataverse SDK.

Obtención de los ensamblajes del SDK

Utilice el SDK para .NET para aplicaciones basadas en .NET Framework o .NET Core. Para el desarrollo exclusivo de .NET Framework, los ensamblados SDK están disponibles en el paquete NuGet Microsoft.CrmSdk.CoreAssemblies. Para el desarrollo exclusivo de .NET Framework o .NET Core, los ensamblados SDK están disponibles en el paquete NuGet Microsoft.PowerPlatform.Dataverse.Client.

Después de agregar el paquete NuGet a su proyecto de Visual Studio, tendrá acceso a los espacios de nombres y clases que permiten que su aplicación interactúe con los servicios web de la organización y de detección.

Interactuar con el servicio de la organización

En esta sección, cubrimos algunos conceptos clave sobre el uso de las clases SDK proporcionadas para conectarse con los servicios web y realizar operaciones.

Establecer una conexión de servicio web

La interfaz IOrganizationService proporciona una conexión con el servicio de la organización que permite que las aplicaciones trabajen con datos profesionales y definiciones de tablas y columnas. Hay dos implementaciones de esta interfaz en el SDK: CrmServiceClient y ServiceClient. Para el desarrollo de nuevas aplicaciones, debe utilizar la clase ServiceClient que admite tecnologías de autenticación más nuevas (MSAL) y tiene algunas características adicionales que no están disponibles en CrmServiceClient. Sin embargo, ambas clases de clientes son casi iguales desde la perspectiva de la API. Verá ejemplos de código en esta documentación usando cualquiera de estas clases, y es bastante fácil convertir código que usa CrmServiceClient para usar ServiceClient.

Más información: Aplicaciones de transición a Dataverse ServiceClient, Interfaz IOrganizationService

Operaciones de servicio web

En el Dataverse SDK para .NET, las operaciones del servicio web se inician enviando mensajes o solicitudes de mensajes al servicio. Cada mensaje tiene un nombre que indica el propósito del mismo, y el nombre de la clase de solicitud correspondiente se basa en ese nombre de mensaje. Por ejemplo, para crear una fila de datos en una tabla, complete una solicitud de creación con datos y haga que el cliente del servicio envíe (ejecute) esta solicitud al servicio de la organización. La operación es "crear" y la solicitud de mensaje se nombra CreateRequest. Después de ejecutar una solicitud, el servicio devuelve un objeto de clase de respuesta (por ejemplo, CreateResponse) que contiene un estado de ejecución y datos de resultados. Este patrón es el mismo para las demás operaciones que admite el servicio.

Eche un vistazo a las clases de solicitud y respuesta de mensajes disponibles en los espacios de nombres Microsoft.Xrm.Sdk.Messages y Microsoft.Crm.Sdk.Messages.

Acerca del extremo de SOAP heredado

El punto de conexión del servicio de la organización que se introdujo en 2011, conocido como punto de conexión SOAP, está obsoleto desde hace algún tiempo. Esto significa que seguirá funcionando y recibiendo soporte hasta que lo quitemos. También hemos anunciado que actualizaremos el SDK para ensamblados .NET de modo que sigan funcionando cuando hayamos quitado el punto de conexión. Esto significa que habrá SDK actualizado para ensamblados .NET disponibles antes de que se elimine el punto de conexión. Los desarrolladores deberán actualizar su código para usar estos nuevos ensamblados en algún momento en el futuro. La conclusión clave es que los desarrolladores accederán al servicio de la organización mediante el SDK para .NET e ignorarán el punto de conexión y su protocolo. Más información: Aplicaciones de transición a Dataverse ServiceClient

Dado que la API web usa un punto de conexión diferente, no se ve afectada por el desuso del punto de conexión SOAP de 2011.

Pasos siguientes

¡Escribamos algo de código! Inicio rápido: Ejemplo de SDK para .NET (C#)

Consulte también

Detectar organizaciones de usuario
Use complementos para ampliar los procesos de negocio
Extensiones de flujo de trabajo

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).