CRM への接続に XRM ツールを使用

2017-07-06

公開日: 2016年11月

対象: Dynamics CRM 2015

Microsoft Dynamics 365 に接続するには、CrmServiceClient クラスのインスタンスを作成してから、接続するコンストラクターの 1 つを使用します。このクラスのオブジェクトによる各メソッド呼び出しは、アトミック単位の作業として扱われて、Microsoft Dynamics 365 へのすべての呼び出しはスレッドセーフです。

このトピックの内容

OrganizationServiceProxy を使用した CRM への接続

CRM Online への接続 (Live ID)

CRM Online への接続 (Office 365)

CRM 設置型への接続 (Active Directory)

CRM のインターネットに接続する展開 (IFD) に接続

CRM への接続 (クレームベース)

すべてのコンストラクターのオプションのパラメーター

接続状態を決定する

OrganizationServiceProxy を使用した CRM への接続

ユーザー提供の OrganizationServiceProxy インスタンスを使用して CRM に接続するには、次のコンストラクターを使用します。

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);

CRM Online への接続 (Live ID)

次のコンストラクターを使用します。

CrmServiceClient crmSvc = new CrmServiceClient("<LiveID>", "<Password>", "<CRMonlineRegion>", "<OrgName>");

<CRMonlineRegion> パラメーターの有効な値は、NorthAmerica、EMEA、APAC、SouthAmerica、Oceania、Japan、および NorthAmerica2 です。これを String.Empty に設定すると、Dynamics 365 の組織のすべての領域のサーバーが検索されます。<OrgName> パラメーターについては、一意の名前またはわかりやすい名前を指定できます。

CRM Online への接続 (Office 365)

次のコンストラクターを使用します。

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", "<Password>", "<CRMonlineRegion>", "<OrgName>", isOffice365:true);

CRM 設置型への接続 (Active Directory)

次のコンストラクターを使用します。

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”),"<Server>", "<Port>", "<OrgName>");

これにより、指定したドメインに基づいて、Active Directory 認証が実行されます。<Server> パラメーターについては、Dynamics 365 サーバーのホスト名、たとえば、crmtest を指定します。<OrgName> パラメーターについては、一意の名前またはわかりやすい名前を指定できます。

CRM のインターネットに接続する展開 (IFD) に接続

次のコンストラクターを使用します。

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>");

このメソッドは、指定されたローカルドメインに基づいて、クレームベース認証を実行します。これは、AD FS を使用する上、Dynamics 365 サーバーをクレームとして構成したユーザーにとって有用です。この場合、ユーザー人口は、Dynamics 365 サーバーと同じ AD FS ドメインに存在します。<Server> パラメーターについては、Dynamics 365 サーバーのホスト名、たとえば、crmtest を指定します。<OrgName> パラメーターについては、一意の名前またはわかりやすい名前を指定できます。

CRM への接続 (クレームベース)

次のコンストラクターを使用します。

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");

このメソッドは、指定されたホームレルムに対して、クレームベース認証を実行します。これは、AD FS を使用する上、Dynamics 365 サーバーをクレームとして構成したユーザーにとって有用です。この場合、ユーザー人口は、Dynamics 365 サーバーと同じ AD FS ドメインに存在します。<Server> パラメーターについては、Dynamics 365 サーバーのホスト名、たとえば、crmtest を指定します。<OrgName> パラメーターについては、一意の名前またはわかりやすい名前を指定できます。

すべてのコンストラクターのオプションのパラメーター

これらは、先に示した各コンストラクターで使用できるオプションのパラメーターです。

useUniqueInstance: 接続がまだアクティブの間に再呼び出しされた場合に、既存の接続を再利用するかどうかを示します。既定は false です。true に設定した場合、システムは強制的に固有の接続を作成します。
useSSL: Dynamics 365 に接続するのに SSL を使用するかどうかを指示します。既定は false です。すなわち、http:// を使用します。true に設定すると、https:// を使用します。
orgDetail: 既定値は null。設定した場合、これはクエリから探索サービスに返され、組織選択プロセスの 2 番目の足として一般に使用されます。

接続状態を決定する

接続要求が成功したかどうかを決定するには、CrmServiceClient IsReady プロパティの値を確認します。true の場合、接続が成功し、実行する準備ができています。それ以外の場合は、接続失敗の原因として、CrmServiceClient.LastCrmError プロパティと CrmServiceClient.LastCrmException プロパティの値を確認します。

次の方法で共有

CRM への接続に XRM ツールを使用

このトピックの内容

OrganizationServiceProxy を使用した CRM への接続

CRM Online への接続 (Live ID)

CRM Online への接続 (Office 365)

CRM 設置型への接続 (Active Directory)

CRM のインターネットに接続する展開 (IFD) に接続

CRM への接続 (クレームベース)

すべてのコンストラクターのオプションのパラメーター

接続状態を決定する

関連項目

その他のリソース