データを作成するために 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;  
}  

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

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 でアクションを実行