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.

Algunos escenarios de desarrollo requieren el uso del SDK de Dataverse 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 el código mediante el SDK de .NET Framework y Dataverse.

Obtener los ensamblados del SDK

Utilice el SDK para ensamblados de .NET en aplicaciones basadas en .NET Framework o .NET Core. Para el desarrollo exclusivo para .NET Framework, obtenga los ensamblados del SDK en el paquete NuGet Microsoft.CrmSdk.CoreAssemblies. Para el desarrollo con .NET Framework o .NET Core, obtenga los ensamblados del SDK en el paquete NuGet Microsoft.PowerPlatform.Dataverse.Client.

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

Interactuar con el servicio de organización

En esta sección se tratan algunos conceptos clave sobre el uso de clases del SDK proporcionadas para conectarse a los servicios web y realizar operaciones.

Establecimiento de 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. El SDK incluye dos implementaciones de esta interfaz: CrmServiceClient y ServiceClient. Para el desarrollo de aplicaciones nuevas, use la ServiceClient clase que admite tecnologías de autenticación más recientes (MSAL) y tenga algunas características más no 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 con 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 SDK de Dataverse para .NET, se inician operaciones de servicio web mediante el envío de mensajes o solicitudes de mensaje 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.

Información sobre el punto de conexión SOAP obsoleto

Microsoft introdujo el punto de conexión de servicio de la organización, conocido como punto de conexión SOAP, en 2011. Este endpoint está obsoleto. Esto significa que sigue funcionando y recibiendo soporte hasta que Microsoft lo retire. Microsoft anunció también que actualizarán el SDK para .NET ensamblados para que sigan funcionando después de quitar el punto de conexión. Esto significa que el SDK actualizado de ensamblados de .NET estará disponible antes de que se quite 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 acceden al servicio Organización mediante el SDK para .NET y omiten el punto de conexión y su protocolo. Para obtener más información, consulte Transición de aplicaciones 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