Microsoft Dynamics 365 Web サービスを使用した単純なプログラムの実行
公開日: 2017年1月
対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
このトピックでは、取引先企業レコードを作成し、そのレコードを取得して更新した後、削除するかどうかを確認するメッセージを表示するプログラムをコンパイルして実行する方法について説明します。
前提条件
Microsoft Dynamics CRM SDK をダウンロードします。
Microsoft Dynamics 365 または Microsoft Dynamics 365 (オンライン) にサインインできる必要があります。
Microsoft Visual Studio 2012 または 2013
Microsoft .NET Framework 4.5.2
クイック スタート サンプルのコンパイルおよび実行
SDK\SampleCode\CS\QuickStart フォルダーを見つけて開きます。
QuickStart.csproj ファイルを Visual Studio で開きます。
F5 キーを押して、プログラムをコンパイルして実行します。
各プロンプトに次の情報を入力します。
プロンプト
説明
Enter a CRM server name and port [crm.dynamics.com]
Microsoft Dynamics 365 Server の名前を入力します。 北米での既定では Microsoft Dynamics 365 (オンライン) (crm.dynamics.com) です。
例: myservername
例: myprefix.myservername:5500
例: crm5.dynamics.com
組織またはインターネット プロトコル (http または https) の名前は含めません。 これに対して後でメッセージが表示されます。
このサーバーは Secure Sockets Layer (https) 用に構成されていますか (y/n) [n]
Dynamics 365 にアクセスするために使用する URL が https:// で始まる場合は y を入力し、それ以外の場合は n と入力します。Microsoft Dynamics 365 (オンライン) のユーザーにはこのプロンプトが表示されません。
この組織は Microsoft Online Services で設定されていますか (y/n) [n]
この組織が Microsoft Online Services で設定された組織の場合は y を入力します。 その他の場合、n を入力します。
Microsoft Dynamics 365 (オンライン) ユーザーのみに対して、このプロンプトが表示されます。
Enter domain\username
Microsoft Dynamics 365 の場合は、ネットワーク ドメインとユーザー名を円記号 (\) で区切って入力します。Microsoft Dynamics 365 (オンライン) の場合は、Microsoft アカウント を入力します。
設置型、IFD の例は以下の通りです。mydomain\tadams
オンライン例は以下の通りです。terryadams@somedomain.onmicrosoft.com
ユーザー名に対して <Enter> キーのみを押した場合、保存されている資格情報が検索され、使用されます。 資格情報が保存されていない場合、プログラムは失敗します。
Enter password
パスワードを入力します。 文字はウィンドウに "*" で表示されます。 パスワードは、後で再利用できるように Microsoft Credential Manager で安全に保存されます。
Specify an organization number (1-n) [1]
組織の一覧から、所属する組織に該当する番号を入力します。 既定値は 1 です。これは一覧の最初の組織を示します。
Do you want these entity records deleted? (y/n) [y]
はいの場合は y を、いいえの場合は n と入力します。 プログラムを実行して、取引先企業レコードの作成、取得、および更新を行った後、作成したレコードを削除するか、Web アプリケーションや Outlook 用 Microsoft Dynamics 365 で表示できるように、そのまま残すことを選択することができます。
Press Enter to exit
Enter キーを押してプログラムを終了します。
次のステップ
QuickStart プログラムまたはその他の SDK コンソールベースのサンプルの大部分では、実行後に、プロンプトで入力されたサーバー、組織、およびユーザー名の情報が XML 構成ファイルに保存され、サンプルを次回実行するときに再利用されます。 これにより、追加のサンプルを実行するときに同じ情報を再入力する必要がなくなります。 2 回目以降は、次のコンソール プロンプトが表示されます。
プロンプト |
内容 |
|---|---|
Specify the saved server configuration number (1-x) [x]: |
新しいサーバー構成を作成するには、「0」を入力し、上の表に示すプロンプトに従います。 それ以外の場合は、一覧に表示された、保存されている構成の番号を入力します。 |
Enter Password: |
パスワードを入力します。 文字はウィンドウに "*" で表示されます。 前に実行したサンプルからパスワードが保存されている場合、このプロンプトは表示されません。 |
Do you want these entity records deleted? (y/n) [y] |
はいの場合は y を、いいえの場合は n と入力します。 プログラムを実行して、取引先企業レコードの作成、取得および更新を行った後、作成したレコードを削除するか、Web アプリケーションや Outlook 用 Microsoft Dynamics 365 で表示できるように、そのまま残すことを選択することができます。 |
Press Enter to exit |
Enter キーを押してプログラムを終了します。 |
この QuickStart プログラムの機能を追加または変更する場合は、CRUDOperations.cs ファイルのコードを変更できます。
QuickStart および多くの他の SDK サンプルで使用されているヘルパー コード ファイルの詳細、および必要なアセンブリ参照が追加された新しいプロジェクトを設定する方法については、「サンプルとヘルパー コードの使用」を参照してください。 サーバー構成情報の保存および再利用を処理するソース コードの詳細については、「ヘルパー コード: ServerConnection クラス」を参照してください。
QuickStart with Simplified Connection という名前の 2 つ目のサンプル プロジェクトは、Microsoft Visual Studio ソリューションに含まれています。 この 2 つ目のサンプルは、Microsoft Dynamics 365 組織 Web サービスに接続する簡単な方法を示していますが、それ以外は最初の QuickStart サンプルと似ています。 このサンプルでは、Web サービスの接続を確立するのにヘルパー コードを使用しません。
関連項目
Microsoft Dynamics 365 開発の理解に役立つチュートリアルとリソース
サンプル: Microsoft Dynamics 365 のクイック スタート
サンプル: Microsoft Dynamics 365 を使用した単純化接続のクイック スタート
サーバー上の Microsoft Dynamics 365 の拡張
Microsoft Dynamics 365 のサンプル コード ディレクトリ
xRM と SharePoint を使用して 60 分で .NET ビジネス アプリケーションを構築する
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 著作権