Freigeben über

Duplikaterkennung ausführen

  • Artikel

Es gibt mehrere Möglichkeiten, Duplikaterkennung auszuführen, nachdem Sie sie aktiviert und die Duplikaterkennungsregeln veröffentlicht haben.

Erkennt und ruft Duplikate für einen bestimmten Datensatz ab.

Suchen und Abrufen von Duplikaten:

  • Bevor Sie eine Tabelle erstellen
  • Für eine bestehende Tabelle
  • Für andere Tabellen, die tabellenübergreifenden Duplikatregeln entsprechen. Zum Beispiel jede Lead-Tabelle, die mit einer Kontakt-Tabelle übereinstimmt.

Optionen:

Beispiel: Duplikate erkennen für einen bestimmten Datensatz mithilfe von Internet-API

Im folgenden Beispiel wird veranschaulicht, wie Duplikate eines bestimmten Datensatzes mit RetrieveDuplicates erkannt werden.

Anforderung:

GET [Organization URI]/api/data/v9.0/RetrieveDuplicates(BusinessEntity=@p1,MatchingEntityName=@p2,PagingInfo=@p3)?@p1={'@odata.type':'Microsoft.Dynamics.CRM.account','accountid':'0d1156d2-1598-e711-80e8-00155db64062'}&@p2='account'&@p3={'PageNumber':1,'Count':50} HTTP/1.1
If-None-Match: null
OData-Version: 4.0
OData-MaxVersion: 4.0
Content-Type: application/json
Accept: application/json

Antwort:

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{
    "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#accounts",
    "value": [
        <Omitted for brevity: JSON data for any matching accounts including all properties>
    ]
}

Erkennen von Duplikaten für einen Tabellentyp

Einen asynchronen Duplikaterkennungsauftrag übermitteln, der im Hintergrund ausgeführt wird. Die Duplikate werden entsprechend der veröffentlichten Duplikatregeln für den Tabellentyp erkannt. Die erkannten Duplikate sind als DuplicateRecord Datensätze in Dynamics 365 gespeichert.

Maximal 5000 Duplikate werden durch den Duplikaterkennungsauftrag zurückgegeben.

Optionen

Beispiel: Erkennen von Duplikaten für einen Tabellentyp mithilfe der Web-API

Das folgende Beispiel zeigt, wie Sie Duplikate für einen Tabellentyp erkennen, indem Sie einen asynchronen Job mit der Aktion BulkDetectDuplicates erstellen.

Anforderung:

POST [Organization URI]/api/data/v9.0/BulkDetectDuplicates HTTP/1.1
If-None-Match: null
OData-Version: 4.0
Content-Type: application/json
Accept: application/json
OData-MaxVersion: 4.0

{
    "Query": {
        "@odata.type": "#Microsoft.Dynamics.CRM.QueryExpression",
        "EntityName": "lead"
    },
    "JobName": "jobname1",
    "SendEmailNotification": false,
    "TemplateId": "07B94C1D-C85F-492F-B120-F0A743C540E6",
    "ToRecipients": [],
    "CCRecipients": [],
    "RecurrencePattern": "",
    "RecurrenceStartTime": "2015-07-15T05:30:00Z"
}

Antwort:

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{
    "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.BulkDetectDuplicatesResponse",
    "JobId": "efaff068-7598-e711-80e8-00155db64062"
}

Die oben aufgeführte Anforderung erstellt einen asynchronen Duplikaterkennungsauftrag, dessen JobID in der Antwort wird wieder angezeigt. Die JobID, die von der obigen Anfrage zurückgegeben wird, kann verwendet werden, um doppelte Datensätze in einem Tabellentyp abzurufen, wie im folgenden Beispiel gezeigt.

Anforderung:

GET [Organization URI]/api/data/v9.0/asyncoperations(efaff068-7598-e711-80e8-00155db64062)/AsyncOperation_DuplicateBaseRecord
If-None-Match: null
OData-Version: 4.0
OData-MaxVersion: 4.0
Content-Type: application/json
Accept: application/json

Die FetchXML-Entsprechung der oben aufgeführte Anforderung wird unten gezeigt.

<fetch>
    <entity name="duplicaterecord">
        <attribute name="owninguser" />
        <attribute name="ownerid" />
        <attribute name="baserecordid" />
        <attribute name="duplicateid" />
        <attribute name="owningbusinessunit" />
        <attribute name="createdon" />
        <attribute name="asyncoperationid" />
        <filter>
            <condition attribute="asyncoperationid" operator="eq" value="efaff068-7598-e711-80e8-00155db64062" />
        </filter>
    </entity>
</fetch>

Antwort:

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{  
   "@odata.context":"[Organization URI]/api/data/v9.0/$metadata#duplicaterecords",
   "value":[  
      {  
         "owninguser":"b3ac4144-6d9a-e711-811c-000d3a75ce72",
         "_ownerid_value":"b3ac4144-6d9a-e711-811c-000d3a75ce72",
         "_baserecordid_value":"3a6fc65b-3f9c-e711-811c-000d3a75ce72",
         "duplicateid":"489a879c-019b-4c28-8539-51ebc850d18f",
         "createdon":"2017-09-19T03:34:25Z",
         "owningbusinessunit":"20a44144-6d9a-e711-811c-000d3a75ce72",
         "_asyncoperationid_value":"efaff068-7598-e711-80e8-00155db64062",
         "_duplicateruleid_value":null,
         "_duplicaterecordid_value":null
      },
      {  
         "owninguser":"b3ac4144-6d9a-e711-811c-000d3a75ce72",
         "_ownerid_value":"b3ac4144-6d9a-e711-811c-000d3a75ce72",
         "_baserecordid_value":"406fc65b-3f9c-e711-811c-000d3a75ce72",
         "duplicateid":"0a4a7dea-1488-4e05-b5eb-c2925ad2925a",
         "createdon":"2017-09-19T03:34:25Z",
         "owningbusinessunit":"20a44144-6d9a-e711-811c-000d3a75ce72",
         "_asyncoperationid_value":"efaff068-7598-e711-80e8-00155db64062",
         "_duplicateruleid_value":null,
         "_duplicaterecordid_value":null
      }
   ]
}

Die GUID des Basis-Datensatzes wird als baserecordid in Datensätzen DuplicateRecord gespeichert. duplicateid, in den oben genannten Antwort ist der eindeutige Bezeichner des doppelten Datensatzes. asyncoperationid ist der eindeutige Bezeichner des Systemauftrags, von dem dieser Datensatz erstellt wurde. Die, ownerid ist der eindeutige Bezeichner des Benutzers oder eines Teams, dem der doppelte Datensatz gehört. Siehe DuplicateRecord-Tabelle für weitere Informationen.

Hinweis

Bevor Sie Duplikaterkennungsaufträge erstellen und ausführen, stellen Sie sicher, dass die entsprechenden Duplikaterkennungsregeln vorhanden sind. Dynamics 365 enthält standardmäßige Duplikaterkennungsregeln für Firmen, Kontakte und Leads, jedoch nicht für andere Datensatztypen. Wenn das System Duplikate für andere Datensatztypen erkennen soll, müssen Sie eine neue Regel erstellen. Weitere Informationen darüber, wie eine Duplikaterkennungsregel erstellt wird, siehe Duplikaterkennungsregeln.

Duplikate erkennen bei Erstellungs- und Aktualisierungsvorgängen

Die Erkennung von Duplikaten beim Erstellen oder Aktualisieren von Datensätzen wird nur angewendet, wenn die Organisation die Duplikaterkennung aktiviert hat, die Tabelle für die Duplikaterkennung aktiviert ist und aktive Regeln für die Duplikaterkennung angewendet werden. Standardmäßig wird die Duplikaterkennung unterdrückt, wenn Sie einen Datensatz mithilfe der Web-API oder dem SDK für .NET erstellen oder aktualisieren.

Um beim Erstellen oder Aktualisieren von Datensätzen doppelte Daten zu erkennen, siehe:

Siehe auch

Duplikaterkennungsmeldungen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).