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

[アーティクル]
04/08/2022

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

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

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

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

注意

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

前提条件

Visual Studio (2019 推奨)
インターネット接続
Dataverse インスタンスに有効なユーザーアカウント
- ユーザー名
- パスワード
接続に使用する Dataverse 環境への URL
Visual C# 言語の基本的な理解

Visual Studio プロジェクトの作成

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

注意

このスクリーンショットは、OrgServiceQuickStart という名前を示していますが、必要に応じてプロジェクトとソリューションに名前を指定することを選択できます。
Solution Explorer で、作成したプロジェクトを右クリックして、コンテキストメニューで NuGet パッケージの管理... を選択します。
Microsoft.CrmSdk.XrmTooling.CoreAssembly NuGet パッケージの最新バージョンを参照して、インストールします。

注意

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

Program.cs を編集する

Program.cs の一番上にステートメントを使用してこれらを追加する
```
using Microsoft.Crm.Sdk.Messages;
using Microsoft.Xrm.Tooling.Connector;
```

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 = OAuth;
    UserName = {userName};
    Password = {password};
    AppId = 51f81489-12ee-4a9e-aaae-a2591f45987d;
    RedirectUri = app://58145B91-0C36-4500-8554-080854F2AC97;
    LoginPrompt=Auto;
    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();
    }
}

環境に情報を追加するには、次の値を編集します。 設定>カスタマイズ>開発者リソース の 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>";

プログラムを実行する

F5 キーを押してプログラムを実行します。出力は次のように表示されます。
```
Your UserId is 969effb0-98ae-478c-b547-53a2968c2e75
Press any key to exit.
```

ご報告:

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

次の手順

これらの記事では、 Dataverse テーブルでの作業方法について説明します。

組織サービスを使用したエンティティクラスの操作
 組織サービスを使用したテーブル行の作成
 組織サービスを使用したテーブル行の取得
 組織サービスを使用したテーブル行の更新と削除
 組織サービスを使用したテーブル行の関連付けと関連付け解除

注意

ドキュメントの言語設定についてお聞かせください。簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。個人データは収集されません (プライバシーステートメント)。

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