XRM ツールで接続文字列を使用する

Dynamics 365 Customer Engagement (on-premises) によって、XRM ツールによる接続文字列を使用したインスタンスへの接続が可能になります。 これは SQL Server で使用される接続文字列の概念と似ています。 接続文字列は、最大限のセキュリティを得るために構成セクションを暗号化する機能を含むネイティブ サポートを、構成ファイルに備えています。 これにより、インスタンスに接続する際に、アプリケーションにハード コーディングしない Dynamics 365 Customer Engagement (on-premises) 接続を展開時に構成することができます。

接続文字列の作成

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

<connectionStrings>  
    <add name="MyCRMServer" connectionString="AuthType=AD;Url=https://contoso:8080/Test;" />  
</connectionStrings>  

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

//Use the pre-configured connection string named "MyCRMServer"
CrmServiceClient crmSvc = new CrmServiceClient(ConfigurationManager.ConnectionStrings["MyCRMServer"].ConnectionString);  

CrmServiceClient オブジェクトを作成したら、そのオブジェクトを使用して Dynamics 365 Customer Engagement (on-premises) でアクションを実行することができます。 詳細: XRM ツールを使用してアクションを実行する

接続文字列パラメーター

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

接続文字列の例

次の例は Dynamics 365 Customer Engagement (on-premises) および IFD 展開に接続するための接続文字列の使用方法を示しています。 Dataverse インスタンス用の接続文字列の例が Power Apps ドキュメントで利用できるようになりました: XRM ツールで接続文字列を使用して Dataverse に接続する

統合設置型認証

<add name="MyCRMServer"
connectionString="AuthType=AD;
Url=https://contoso:8080/Test;" />  

設置型認証を使用している取引先企業

<add name="MyCRMServer"
connectionString="AuthType=AD;
Url=https://contoso:8080/Test;
Domain=CONTOSO;
Username=jsmith;
Password=passcode" />  

認証のプロンプトに Dynamics 365 Customer Engagement (on-premises) で UX と一緒に取引先企業を使用している OAuth

oAuth 経由のユーザー ID またはパスワードを使用して、新しい接続を作成します。

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

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

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

<add name="MyCRMServer"
 connectionString="
  AuthType=OAuth;
  Username=jsmith;
  Integrated Security=true;
  Url=https://contoso:8080/Test;
  AppId=51f81489-12ee-4a9e-aaae-a2591f45987d;
  RedirectUri=app://58145B91-0C36-4500-8554-080854F2AC97;
  TokenCacheStorePath=c:\MyTokenCache;
  LoginPrompt=Auto"/>  

サブ部門への委任に取引先企業を使用している IFD

<add name="MyCRMServer"
connectionString="AuthType=IFD;Url=https://contoso:8080/Test;
 HomeRealmUri=https://server-1.server.com/adfs/services/trust/mex/;
Domain=CONTOSO; 
Username=jsmith; 
Password=passcode" />  

接続状態を決定する

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

関連項目

XRM ツールを使用して Windows のクライアント アプリケーションを作成する
CrmServiceClient コンストラクターを使用した Dynamics 365 Customer Engagement (on-premises) および Dataverse への接続
XRM ツールを使用してアクションを実行する
CrmServiceClient