Ejemplo: tutorial de conexión simplificada con Microsoft Dataverse

  • Artículo

Este ejemplo de C# .NET muestra cómo conectarse al servicio web de Microsoft Dataverse mediante la clase CrmServiceClient y una cadena de conexión. El ejemplo realiza operaciones de creación, actualización, recuperación y eliminación en una tabla de Dataverse. Para obtener más información sobre CrmServiceClient, consulte Usar constructores CrmServiceClient para conectarse a Dataverse.

Nota

También puede usar ServiceClient en lugar de la clase CrmServiceClient en esta muestra.

Requisitos

  • Visual Studio 2019 o posterior
  • Entorno de prueba de Dataverse y credenciales de inicio de sesión de usuario válidas

Cómo ejecutar el ejemplo

  1. Clone el repositorio de PowerApps-Samples para que tenga una copia local.
  2. Abra el archivo dataverse\Xrm Tooling\QuickStartCS\C#\QuickStartCS.sln en Visual Studio.
  3. En el Explorador de soluciones, deberá modificar el archivo App.config con información de conexión para la instancia de Dataverse antes de ejecutar el ejemplo. Vea el ejemplo App.config a continuación.
  4. Presione F5 para compilar y ejecutar el programa.

Demostraciones

Este ejemplo autentica al usuario con los servicios web de Dataverse mediante una cadena de conexión que se pasa a la clase CrmServiceClient.

Después de obtener una referencia al servicio web de organización, el ejemplo realiza operaciones de creación, actualización, recuperación y eliminación en una tabla de account. El ejemplo también controla excepciones comunes.

Además, este ejemplo admite autenticación OAuth y el diagnóstico avanzado de conexión que se configura en el archivo App.config. Para obtener más información acerca de cómo usar diagnóstico, consulte Configurar el seguimiento de útiles de XRM.

Ejemplo de App.config

Lo siguiente muestra un app.config file de ejemplo. Para usarlo, quite los caracteres de comentario “<!- -” al principio de la línea <add name=… /> y “- ->” al final de la línea en las etiquetas XML connectionStrings. A continuación, modifique los valores de nombre de usuario, URL y contraseña de la cadena de conexión según corresponda para el entorno de prueba de Dataverse.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <connectionStrings>

  <!--<add name="Connect"
  connectionString="
  AuthType=OAuth;
  Username=jsmith@contoso.onmicrosoft.com;
  Url=https://contosotest.crm.dynamics.com;
  Password=passcode;
  AppId=51f81489-12ee-4a9e-aaae-a2591f45987d;
  RedirectUri=app://58145B91-0C36-4500-8554-080854F2AC97;
  TokenCacheStorePath=d:\MyTokenCache;
  LoginPrompt=Auto"/>-->

  </connectionStrings>
</configuration>

Consulte también

Usar cadenas de conexión en herramientas de XRM para conectarse a Dataverse

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