XRM ツールの接続文字列を使用して Microsoft Dataverse に接続する

XRM ツールを使用すると、接続文字列を使用して Dataverse 環境に接続できます。 この方法は、 SQL Server で使用される接続文字列の概念に似ています。 構成ファイルは、セキュリティを最大限に高めるために構成セクションを暗号化する機能など、接続文字列をネイティブにサポートします。 この機能を使用すると、デプロイ時に Dataverse 接続を構成でき、アプリケーションでハード コーディングすることはできません。

アプリケーション コードでの接続文字列の使用については、次の重要な情報をお読みください。

接続文字列の作成

次の例に示すように、プロジェクトの app.config または web.config ファイルに接続文字列を指定します。

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

接続文字列を作成した後、それを使用して CrmServiceClient オブジェクトを作成します。

//Use the connection string named "MyCDSServer"  
//from the configuration file  
CrmServiceClient svc = new CrmServiceClient(ConnectionString);  

または、 ServiceClient クラスを使用することもできます。

ServiceClient svc = new ServiceClient(ConnectionString);  

サービス クライアント オブジェクトを作成した後、そのオブジェクトを使用して Dataverse でアクションを実行します。 詳細については、「 XRM ツールを使用して Dataverse でアクションを実行する」を参照してください。

接続文字列パラメーター

接続文字列には、セミコロンで区切られた一連の名前と値のペアが含まれています。 次の表に、サポートされているパラメーターの一覧を示します。このパラメーターは任意の順序で入力できます。

接続文字列の例

次の例は、online の展開および認証シナリオに接続するための接続文字列の使用方法を示しています。 オンプレミスおよび IFD デプロイ インスタンスの接続文字列の例については、「 XRM ツールで接続文字列を使用して接続する」を参照してください。

Office365 を使用した名前付きアカウント

Office365 でユーザー名またはパスワードを使用して Dataverse への新しい接続を作成します。

<add name="MyCDSServer" 
 connectionString="
  AuthType=Office365;
  Username=jsmith@contoso.onmicrosoft.com; 
  Password=passcode;
  Url=https://contoso.crm.dynamics.com"/>  

Microsoft 365 で名前付きアカウントを使用した OAuth と、認証を促すための UX

OAuth 経由で UserId またはパスワードを使用する Dataverse に新規に接続します。

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

フォールバック UX で現在ログインしているユーザーを使用して認証を求める OAuth

OAuth 経由で現在ログインしているユーザーを使用して Dataverse への新しい接続を作成します。

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

証明書ベース認証

アプリケーションまたはクライアント ID と証明書を使用して、Dataverse への新しい接続を作成します。

<add name="MyCDSServer" 
  connectionString="
  AuthType=Certificate;
  url=https://contosotest.crm.dynamics.com;
  thumbprint={CertThumbPrintId};
  ClientId={AppId};"
  />

ClientId またはクライアント シークレット ベースの認証

アプリケーションまたはクライアント ID とクライアント シークレットを使用して、Dataverse への新しい接続を作成します。

<add name="MyCDSServer" 
  connectionString="
  AuthType=ClientSecret;
  url=https://contosotest.crm.dynamics.com;
  ClientId={AppId};
  ClientSecret={ClientSecret}"
  />

接続状態を決定する

接続要求が成功したかどうかを決定するには、CrmServiceClientIsReady プロパティの値を確認してください。 true の場合、接続は成功し、作業する準備が整います。 それ以外の場合、接続エラーの原因については CrmServiceClient .LastCrmError および CrmServiceClient.LastCrmExceptionプロパティの値を確認してください。

関連項目

XRM ツールを使用して Windows のクライアント アプリケーションを作成する
CrmServiceClient コンストラクターを使用して Dataverse に接続
XRM ツールを使用して Dataverse でアクションを実行
CrmServiceClient