英語で読む

次の方法で共有

データを作成するために XRM ツールを使用する

  • [アーティクル]

CrmServiceClient クラス、または ServiceClient クラスで新しいデータと関連付けを作成するには、7 つの方法を使用できます。 XRM ツール API を使用する作成操作には、ペイロード データが必要です。 データ ペイロードは Dictionary<string, CrmDataTypeWrapper> オブジェクトの形式を取ります。 CrmDataTypeWrapper を使用して、参照するデータ ポイントに対してどのような処理を適用する必要があるか、インターフェイスに通知します。 データを作成する方法の一部がこのトピックに記載されています。

CreateNewRecord

このメソッドは、Microsoft Dataverse で任意のテーブル データ型を作成するために使用します。 これを使用するには、レコードを作成するテーブルのスキーマ名を知っている必要があり、それに渡すデータ ペイロードを構築する必要があります。 この例では、取引先企業レコードを作成します。

ServiceClient クラスを使用する場合、CRUDExtentions 名前空間で CreateNewRecord のメソッドを見つけることができます。

CrmServiceClient svc = new CrmServiceClient("connectionstring");
// ServiceClient svc = new ServiceClient("connectionstring");
 
// Verify that you are connected  
if (svc != null && svc.IsReady)  
{  
    // Create an account record  
    Dictionary<string, CrmDataTypeWrapper> inData = new Dictionary<string, CrmDataTypeWrapper>();  
    inData.Add("name", new CrmDataTypeWrapper("Sample Account Name", CrmFieldType.String));  
    inData.Add("address1_city", new CrmDataTypeWrapper("Redmond", CrmFieldType.String));  
    inData.Add("telephone1", new CrmDataTypeWrapper("555-0160", CrmFieldType.String));  
    accountId = ctrl.CrmConnectionMgr.svc.CreateNewRecord("account", inData);  
  
    // Verify if the account is created.  
    if (accountId != Guid.Empty)  
    {  
        Console.WriteLine(“Account created.”);  
    }  
}  
else  
{  
    // Display the last error.  
    Console.WriteLine("An error occurred: {0}", svc.LastCrmError);  
  
    // Display the last exception message if any.   
    Console.WriteLine(svc.LastCrmException.Message);  
    Console.WriteLine(svc.LastCrmException.Source);  
    Console.WriteLine(svc.LastCrmException.StackTrace);  
  
    return;  
}

アプリケーション コードでの接続文字列の使用については、次の重要な情報をお読みください。

重要

Microsoft では、利用可能な最も安全な認証フローを使用することをお勧めします。 この記事で説明する認証フローは、アプリケーションに対する非常に高い信頼を必要とし、他のフローには存在しないリスクを伴います。 このフローは、マネージド ID など、他のより安全なフローが実行できない場合にのみ使用してください。

この例では、indata という名前のデータ ペイロード オブジェクトを作成しました。 次に、一般的な構文を使ってそれを設定します crmFieldName , new CrmDataTypeWrapper(data,CrmFieldType)。 作成する値を取得するために indata オブジェクトを設定後、CreateNewRecord メソッドを呼び出して、アカウントとデータ ペイロード (indata) のテーブル論理名を指定しました。

注意

XRM ツールを使用してテーブル レコードを作成し、CreateRequest メッセージを ExecuteCrmOrganizationRequest メソッドを使用して実行することもできます。 詳細: ExecuteCrmOrganizationRequest メソッドでメッセージを使用する

CreateAnnotation

このメソッドは、メモ オブジェクトを作成して、任意のテーブル レコードに添付するために使用します。 最初のパスのメモのためのすべての変数を設定できますが、情報カテゴリとメモ テキスト フィールドのみに入力する必要があります。 実際には、これは通常、システムで生成されたメモをテーブルに添付したり、Dataverse に保存されているファイルをテーブルに添付したりする場合に使用します。 さらに、ユーザーにメモを作成するための独自の UI を提供する場合、これは、そのメモを Dataverse の所有者テーブルに添付する方法です。 この例では、前の例に続き、新しく作成された取引先企業に対してメモを作成します。

ServiceClient クラスを使用する場合、CRUDExtentions 名前空間で CreateAnnotation のメソッドを見つけることができます。

CrmServiceClient svc = new CrmServiceClient(connectionstring);  
// ServiceClient svc = new ServiceClient("connectionstring");

// Verify that you are connected.  
if (svc != null && svc.IsReady)  
{  
    // Create and attach a note.  
    inData.Clear();   
    inData.Add("subject", new CrmDataTypeWrapper("This is a NOTE from the API" , CrmFieldType.String));
    inData.Add("notetext", new CrmDataTypeWrapper("This is text that will go in the body of the note" , CrmFieldType.String));  
    Guid noteID = svc.CreateAnnotation("account", accountId, inData);  
}  
else  
{  
    // Display the last error.  
    Console.WriteLine("An error occurred: {0}", svc.LastCrmError);  
  
    // Display the last exception message if any.  
    Console.WriteLine(svc.LastCrmException.Message);  
    Console.WriteLine(svc.LastCrmException.Source);  
    Console.WriteLine(svc.LastCrmException.StackTrace);  
  
    return;  
}

参照

XRM ツール API を使用して Dataverse でアクションを実行