クイックスタート: 組織サービス サンプル (C#)

注意

Effective November 2020:

  • Common Data Service has been renamed to Microsoft Dataverse. Learn more
  • Some terminology in Microsoft Dataverse has been updated. For example, entity is now table and field is now column. Learn more

This article will be updated soon to reflect the latest terminology.

これで、 Common Data Service を使用してデータ作業するために .NET SDK アセンブリでの作業を開始できます。

このクイックスタートでは、CrmServiceClient クラスを使用して組織サービスに接続するために最小限のコンソール アプリケーションを作成します。 コンストラクターに渡された接続文字列を使用して接続情報を渡します。

IOrganizationService.Execute メソッドを使用して、 WhoAmIRequest クラスのインスタンスを渡し、WhoAmIResponse.UserId 値を表示します。

注意

このクイックスタートの例には、エラー処理は含まれません。 これは、組織サービスに接続して使用するための最小の例です。

前提条件

  • Visual Studio (2017 推奨)
  • インターネット接続
  • Common Data Service インスタンスに有効なユーザー アカウント
    • ユーザー名
    • パスワード
  • 接続に使用したい Common Data Service 環境への URL
  • Visual C# 言語の基本的な理解

Visual Studio プロジェクトの作成

  1. .NET Framework 4.6.2 を使用して新しいコンソール アプリ (.NET Framework) を作成する

    コンソール アプリケーション プロジェクトを開始する

    注意

    このスクリーンショットは、OrgServiceQuickStart という名前を示していますが、必要に応じてプロジェクトとソリューションに名前を指定することを選択できます。

  2. Solution Explorer で、作成したプロジェクトを右クリックして、コンテキスト メニューで NuGet パッケージの管理... を選択します。

    NuGet  パッケージの追加

  3. Microsoft.CrmSdk.XrmTooling.CoreAssembly NuGet パッケージの最新バージョンを参照して、インストールします。

    Microsoft.CrmSdk.XrmTooling.CoreAssembly NuGet パッケージのインストール

注意

ライセンスの承認 ダイアログで 同意する を選択する必要があります。

Program.cs を編集する

  1. Program.cs の一番上にステートメントを使用してこれらを追加する

    using Microsoft.Crm.Sdk.Messages;
    using Microsoft.Xrm.Tooling.Connector;
    
  2. Main メソッドを次のコードで置き換えます。 AuthType のサポートされた値が、接続文字列のパラメータ に一覧表示されます。

    static void Main(string[] args)
    {            
        // e.g. https://yourorg.crm.dynamics.com
        string url = "<your environment url>";
        // e.g. you@yourorg.onmicrosoft.com
        string userName = "<your user name>";
        // e.g. y0urp455w0rd 
        string password = "<your password>";
    
        string conn = $@"
        Url = {url};
        AuthType = Office365;
        UserName = {userName};
        Password = {password};
        RequireNewInstance = True";
    
        using (var svc = new CrmServiceClient(conn))
        {
    
            WhoAmIRequest request = new WhoAmIRequest();
    
            WhoAmIResponse response = (WhoAmIResponse)svc.Execute(request);
    
            Console.WriteLine("Your UserId is {0}", response.UserId);
    
            Console.WriteLine("Press any key to exit.");
            Console.ReadLine();
        }
    }
    
  3. 環境に情報を追加するには、次の値を編集します。 設定>カスタマイズ>開発者リソース の Web アプリケーションに自分の環境 URL があります。

    // e.g. https://yourorg.crm.dynamics.com
    string url = "<your environment url>";
    // e.g. you@yourorg.onmicrosoft.com
    string userName = "<your user name>";
    // e.g. y0urp455w0rd
    string password = "<your password>";
    

プログラムを実行する

  1. F5 キーを押してプログラムを実行します。 出力は次のように表示されます。

    Your UserId is 969effb0-98ae-478c-b547-53a2968c2e75
    Press any key to exit.
    

ご報告:

組織サービスに正常に接続されました。

次の手順

これらの記事では、Common Data Service エンティティでの作業方法について説明します:

組織サービスを使用したエンティティ操作
組織サービスを使用したエンティティの作成
組織サービスを使用してエンティティを取得する
組織サービスを使用したエンティティの更新と削除
組織サービスを使用したエンティティの関連付けまたは関連付けを解除する