Microsoft Dynamics CRM 2015 へのより簡単な接続

[アーティクル]
07/06/2017

公開日: 2016年11月

対象: Dynamics CRM 2015

Microsoft Dynamics CRM 2015 および Microsoft Dynamics CRM Online 2015 更新プログラムの Developer Extensions は、接続文字列という概念を使用して Microsoft Dynamics 365 サーバーに接続します。これは、Microsoft SQL Server で使用される接続文字列の概念と似ています。接続文字列は、ADO.NET フレームワークに含まれており、最大限のセキュリティを得るために構成セクションを暗号化する機能も含めて、構成ファイルでのネイティブサポートも提供されています。これにより、Microsoft Dynamics 365 接続を展開時に構成し、アプリケーションにハードコーディングしない堅牢なモデルの使用が促進されます。そのため、Developer Extensions for Microsoft Dynamics 365 のすべての API は、CrmConnection オブジェクトと一緒に機能します。このオブジェクトは、このトピックで説明するように、接続文字列を使用してサーバーに接続する CrmOrganizationServiceContext クラスによって内部的に使用されます。

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

<connectionStrings>
  <add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>

セキュリティメモ
app.config ファイルまたは web.config ファイルにアカウントパスワードなどの機密情報を追加する場合は、適切なセキュリティ対策を講じてその情報を保護してください。

このトピックの内容

接続文字列の作成

接続文字列パラメーター

接続文字列の例

接続文字列の作成

接続文字列は、CrmConnection オブジェクトをインスタンス化するために使用されます。このオブジェクトを使用して、OrganizationService オブジェクトまたは CrmOrganizationServiceContext オブジェクトをインスタンス化できます。

//Use the Microsoft Dynamics CRM Online connection string from the app.config file named "CRMOnline".
var connection = new CrmConnection("CRMOnline");
var service = new OrganizationService(connection);
var context = new CrmOrganizationServiceContext(connection);

CrmConnection は、app.config ファイルと別に作成することもできます。次のようにインラインで作成できます。

var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");

接続文字列パラメーター

接続文字列の基本形式は OLEDB 接続文字列と同じです。これは、セミコロンで区切られた一連の名前/値のペアです。次の表は、任意の受注で入力できる、サポートされるパラメーターを一覧表示しています。

パラメーター名	内容
Server, Url, or Service Uri	Microsoft Dynamics 365 サーバーの URL を指定します。 URL には http または https を指定でき、ポートがポート 80 の http またはポート 443 の https である場合は、ポートはオプショナルです。典型的なサーバー URL の形式は、http:// crm-server: port/organization-name または Microsoft Dynamics CRM Onlinehttps:// organization-name.crm.dynamics.com です。組織名は必須です。
Domain	ユーザーの資格情報を検証するドメインを指定します。
Username or User ID	資格情報に関連付けられたユーザーの ID 名を指定します。
Password	資格情報に関連付けられたユーザー名のパスワードを指定します。
Device ID or Device User Name	ユーザー定義の Microsoft アカウントデバイス ID を指定します。空でない任意の文字列を指定できます。このデバイス ID は、最初に認証が実行されるときにデバイスパスワードと一緒に登録されます。デバイス ID とパスワードが以前に登録された値と一致しない場合、認証は失敗します。デバイス ID は CRM Onlineのみ適用されます。
Device Password	ユーザー定義の Microsoft アカウントデバイスパスワードを指定します。 6 文字以上で指定する必要があります。このパスワードは、最初に認証が実行されるときにデバイス ID と一緒に登録されます。デバイス ID とパスワードが以前に登録された値と一致しない場合、認証は失敗します。デバイスパスワードは CRM Onlineのみ適用されます。
Timeout	Timeout クラスの OrganizationServiceProxy プロパティに渡されます。
Home Realm Uri	HomeRealmUri クラスの OrganizationServiceProxy プロパティに渡されます。
Proxy Types Enabled	既定値は True で、このパラメーターにより、OrganizationService はベースの Entity タイプではなくプロキシタイプを返すことができます。
Proxy Types Assembly	Microsoft.Xrm.Client.CodeGeneration 拡張機能を指定した、CrmSvcUtil.exe ツールを使用して生成した、Microsoft Dynamics 365 からのプロキシタイプを含むアセンブリを指定します。
Caller ID	CallerId クラスの OrganizationServiceProxy プロパティに渡されます。
Service Configuration Instance Mode	Static、PerName、PerRequest、または PerInstance に設定できます。PerName は既定値です。IServiceConfiguration<TService> は OrganizationService に対して作成される回数を最適化し、接続文字列ごとに 1 つだけ作成されるようにします。その他のプロジェクトオプションの詳細については、「instanceMode 属性を指定する」を参照してください。
User Token Expiry Window	新しいユーザートークンを取得するときのオフセットとして使用される TimeSpan を指定します (形式は hh:mm:ss)。たとえば、このパラメーターを「00:10:00」に設定すると、新しいユーザートークンは実際にトークンの期限が切れる 10 分前に取得されます。

接続文字列の例

次の例は、統合設置型認証を使用する接続文字列を示します。

Url=http://crm.contoso.com/xrmContoso;

次の例は、Active Directory 認証を使用する接続文字列を示します。

Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode

次の例は、Microsoft アカウントを使用して Microsoft Dynamics CRM Online に接続するための接続文字列を示します。

Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode

次の例は、Microsoft Online Services を使用して Microsoft Dynamics CRM Online に接続するための接続文字列を示します。

Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;

次の方法で共有

Microsoft Dynamics CRM 2015 へのより簡単な接続

このトピックの内容

接続文字列の作成

接続文字列パラメーター

接続文字列の例

関連項目

その他のリソース