Compartir a través de

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 usar esto, borre los caracteres de comentario “<!- -” al principio de la línea <add name=… /> línea y el «- ->» al final de la línea dentro de 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>

Lea la siguiente información importante sobre el uso de una cadena de conexión en el código de la aplicación.

Importante

Microsoft recomienda utilizar el flujo de autenticación más seguro disponible. El flujo de autenticación descrito en este artículo requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.

Consulte también

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