.NET 用 SDK を使用した重複データの検出

Microsoft Dataverse .NET 用 SDK を使用すると、重複行を検出してデータの整合性を維持できます。 コードを使用した重複データの検出の詳細については、コードを使用した重複データの検出 を参照してください。

行を作成または更新する前に、RetrieveDuplicatesRequest メッセージを使用して重複を検出します

RetrieveDuplicatesRequest クラスを使用してテーブルの行を作成または更新する前に、テーブルの行が重複しているかどうか、または重複するかどうかをプログラムで確認することができます。

var account = new Account();
account.Name = "Sample Account";

var request = new RetrieveDuplicatesRequest()
{
    BusinessEntity = account,
    MatchingEntityName = account.LogicalName,
    PagingInfo = new PagingInfo() { PageNumber = 1, Count = 50 }
};

var response = (RetrieveDuplicatesResponse)svc.Execute(request);

if (response.DuplicateCollection.Entities.Count >= 1)
{
    Console.WriteLine("{0} Duplicate rows found.", response.DuplicateCollection.Entities.Count);
}

SuppressDuplicateDetection パラメーターを使用して、行の作成または更新時にエラーをスローします

作成した新しい行が重複行であると判断されたときにプラットフォームにエラーをスローさせる場合、または重複データ検出ルールが評価されるように既存の行を更新する場合は、IOrganizationService.Execute で CreateRequest または UpdateRequest クラスを使用する必要があります メソッドと、false に設定されている SuppressDuplicateDetection パラメーターを適用します。

次のコードは、以下が true である場合に、InvalidOperationException の例外を A record was not created or updated because a duplicate of the current record already exists. メッセージと共にスローします:

• 重複データ検出が、行が作成または更新されるときに環境に対して有効です。
• 取引先企業テーブルで重複データ検出が有効です
• アカウント名の値が既存の行と完全に一致するかどうかを確認する重複データ検出ルールが公開されています
• Sample Account という名前の既存の取引先企業がある

var account = new Account();
account.Name = "Sample Account";

var request = new CreateRequest();
request.Target = account;
request.Parameters.Add("SuppressDuplicateDetection", false);

try
{
    svc.Execute(request);
}
catch (FaultException<OrganizationServiceFault> ex)
{
    switch (ex.Detail.ErrorCode)
    {
        case -2147220685:
            throw new InvalidOperationException(ex.Detail.Message);
        default:
            throw ex;
    }
}

関連項目

Web API を使用した重複データの検出