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 usar la clase ServiceClient que admite las tecnologías de autenticación más recientes (MSAL) y tiene algunas características más 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 el 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 mensaje, 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. Al 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 extremo de servicio de la organización, conocido como extremo SOAP, se introdujo en 2011. Este punto de conexión está obsoleto. Esto significa que seguirá funcionando y recibiendo soporte hasta que lo quitemos. También hemos anunciado que actualizaremos los ensamblados del SDK para .NET de modo que sigan funcionando cuando hayamos quitado el punto de conexión. Esto significa que el SDK actualizado para ensamblados .NET estará disponible antes de que se quite el extremo. 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 acceden al servicio de la organización mediante el SDK para .NET e ignoran el extremo 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 esta obsolescencia 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