Customer Engagement Web サービスを使用した単純なプログラムの実行

  • [アーティクル]

このトピックでは、取引先企業レコードを作成し、そのレコードを取得して更新した後、削除するかどうかを確認するメッセージを表示するプログラムをコンパイルして実行する方法について説明します。

前提条件

クイック スタート サンプルのコンパイルおよび実行

  1. ダウンロードしたファイルを展開し、\C#\QuickStart.csproj を開きます。

  2. \C#\QuickStart.csproj ファイルを Visual Studio で開きます。

  3. ソリューション エクスプローラーで QuickStart プロジェクトを右クリックして、NuGet Packages の管理... を選択します

  4. Microsoft.CrmSdk.CoreAssemblies パッケージを選択し、最新安定したバージョンに更新します。

  5. F5 キーを押して、プログラムをコンパイルして実行します。

  6. 各プロンプトに次の情報を入力します。

    プロンプト 内容
    CRM サーバーの名前とポート [crm.dynamics.com] を入力してください Dynamics 365 Server の名前を入力します。 既定値は、北米の Dynamics 365 for Customer Engagement (crm.dynamics.com) です。

    例: myservername

    例: myprefix.myservername: 5500

    例: crm5.dynamics.com

    組織またはインターネット プロトコル (http または https) の名前は含めません。 これに対して後でメッセージが表示されます。
    このサーバーは Secure Sockets Layer (https) 用に構成されていますか (y/n) [n] Dynamics 365 (online) バージョン 8.2 にアクセスするために使用する URL が https:// で始まる場合は y を入力し、それ以外の場合は n と入力します。 Dynamics 365 for Customer Engagement ユーザーには、このプロンプトが表示されません。
    この組織は Microsoft Online Services でプロビジョニングされていますか (y/n) [n] Microsoft Online Services でプロビジョニングされている組織の場合は、y を入力します。 その他の場合、n を入力します。

    Dynamics 365 for Customer Engagement ユーザーのみに対して、このプロンプトが表示されます。
    domain\username を入力してください Dynamics 365 for Customer Engagement の場合は、ネットワーク ドメインとユーザー名を円記号 (\) で区切って入力します。 Dynamics 365 for Customer Engagement (on-premises) に、Microsoft アカウントを入力します。

    On-premises/IFD Example: mydomain\tadams

    オンライン例: terryadams@somedomain.onmicrosoft.com

    ユーザー名に対して <Enter> キーのみを押した場合、保存されている資格情報が検索され、使用されます。 資格情報が保存されていない場合、プログラムは失敗します。
    パスワードを入力してください パスワードを入力します。 文字はウィンドウに “*” で表示されます。 パスワードは、後で再利用できるように Microsoft Credential Manager で安全に保存されます。
    組織番号を指定してください (1-n) [1] 組織の一覧から、所属する組織に該当する番号を入力します。 既定値は 1 です。これは一覧の最初の組織を示します。
    これらのエンティティ レコードを削除しますか? (y/n) [y] はいの場合は y を、いいえの場合は n と入力します。 プログラムを実行して、取引先企業レコードの作成、取得、および更新を行った後、作成したレコードを削除するか、アプリケーションで表示できるように、そのまま残すことを選択することができます。
    終了するには Enter キーを押します Enter キーを押してプログラムを終了します。

次の手順

QuickStart プログラムまたはその他の SDK コンソールベースのサンプルの大部分では、実行後に、プロンプトで入力されたサーバー、組織、およびユーザー名の情報が XML 構成ファイルに保存され、サンプルを次回実行するときに再利用されます。 これにより、追加のサンプルを実行するときに同じ情報を再入力する必要がなくなります。 2 回目以降は、次のコンソール プロンプトが表示されます。

プロンプト 内容
保存済みのサーバー構成番号 (1-x) [x] を指定: 新しいサーバー構成を作成するには、「0」を入力し、上の表に示すプロンプトに従います。 それ以外の場合は、一覧に表示された、保存されている構成の番号を入力します。
パスワードを入力します: パスワードを入力します。 文字はウィンドウに “*” で表示されます。 前に実行したサンプルからパスワードが保存されている場合、このプロンプトは表示されません。
これらのエンティティ レコードを削除しますか? (y/n) [y] はいの場合は y を、いいえの場合は n と入力します。 プログラムを実行して、取引先企業レコードの作成、取得および更新を行った後、作成したレコードを削除するか、Web アプリケーションや Dynamics 365 for Outlook で表示できるように、そのまま残すことを選択することができます。
終了するには Enter キーを押します Enter キーを押してプログラムを終了します。

この QuickStart プログラムの機能を追加または変更する場合は、CRUDOperations.cs ファイルのコードを変更することができます。

QuickStart および 他の多くの SDK サンプルが使用するヘルパー コード ファイルに関する詳細については、QuickStart サンプルの「SDK ヘルパー コード」フォルダにある、サーバー構成情報の保存および再利用を処理するヘルパー ソース コードを参照してください。

単純化接続の QuickStart という名前の 2 つ目のサンプル プロジェクトは、Visual Studio ソリューションに含まれています。 この 2 つ目のサンプルは、Dynamics 365 Customer Engagement (on-premises) 組織 Web サービスに接続する簡単な方法を示していますが、それ以外は最初の QuickStart サンプルと似ています。 このサンプルでは、Web サービスの接続を確立するのにヘルパー コードを使用しません。

関連項目

Dynamics 365 Customer Engagement (on-premises) の理解に役立つチュートリアル
サンプル: Dynamics 365 Customer Engagement のクイックスタート
サンプル: Dynamics 365 Customer Engagement (on-premises) を使用した単純化接続のクイック スタート
Dynamics 365 Customer Engagement (on-premises) のコードを記述する
Dynamics 365 Customer Engagement (on-premises) のサンプル コード ディレクトリ
xRM と SharePoint を使用して 60 分で .NET ビジネス アプリケーションを構築する