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 経由で UserID またはパスワードを使用して新しい接続を作成します。

<add name="MyCRMServer"
 connectionString="
  AuthType=OAuth;
  Username=jsmith;
  Password=passcode;
  Url=https://contoso:8080/Test;
  AppId=00001111-aaaa-2222-bbbb-3333cccc4444;
  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=00001111-aaaa-2222-bbbb-3333cccc4444;
  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