Zusammenführen von Tabellenzeilen über die Web-API

Wenn Sie doppelte Datensätze finden, können Sie sie mit Merge Action zusammenführen.

Hinweis

Es können nur die folgenden Entitätstypen zusammengeführt werden:

• account

• contact

• lead: Verfügbar mit Dynamics 365 for Sales

• incident: Verfügbar mit Dynamics 365 für Dienste

  Siehe Zusammenführungsverhalten für Vorfall

Aktion „Zusammenführen“

Zusammenführen ist eine ungebundene Aktion, die vier Parameter akzeptiert:

Name	Typ	Beschreibung	Optional
Target	crmbaseentity	Das Ziel des Zusammenführungsvorgangs.	Nein
Subordinate	crmbaseentity	Der Entitätsdatensatz, aus dem Daten zusammengeführt werden sollen.	Nein
UpdateContent	crmbaseentity	Zusätzliche Entitätsattribute, die während des Zusammenführungsvorgangs festgelegt werden sollen.	Ja
PerformParentingChecks	Boolesch	Gibt an, ob überprüft werden soll, ob die übergeordneten Informationen für die beiden Entitätsdatensätze unterschiedlich sind.	Nein

Beim Zusammenführen werden alle nützlichen Daten aus dem Subordinate-Datensatz in den Target-Datensatz verschoben. Alle vorhandenen Daten im Target-Datensatz werden nicht überschrieben. Dann wird der Subordinate-Datensatz deaktiviert. Zum Ausführen dieses Vorgangs muss der Aufrufer Berechtigungen und Zugriffsrechte für die Datensätze verfügen, die als Target und Subordinate angegeben sind.

Nutzen Sie eine POST-Anfrage, um eine Daten zum Zusammenführen von Datensätzen zu senden. In diesem Beispiel werden zwei Kontoentitätsdatensätze zusammengeführt, während die accountnumber-Eigenschaft des Datensatzes, der nach dem Zusammenführen bestehen bleibt, aktualisiert wird.

Anforderung:

POST [Organization URI]/api/data/v9.0/Merge HTTP/1.1
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{
  "Target": {
    "name": "Account 1",
    "accountid": "bb8055c0-aea6-ea11-a812-000d3a55d474",
    "@odata.type": "Microsoft.Dynamics.CRM.account"
  },
  "Subordinate": {
    "name": "Account 2",
    "accountid": "c38055c0-aea6-ea11-a812-000d3a55d474",
    "@odata.type": "Microsoft.Dynamics.CRM.account"
  },
  "UpdateContent": {
    "accountnumber": "1234",
    "@odata.type": "Microsoft.Dynamics.CRM.account"
  },
  "PerformParentingChecks": false
}

Wichtig

Weil die Target-, Subordinate- und UpdateContent-Eigenschaftstypen nicht explizit durch den Parameter definiert werden, müssen Sie die @odata.type-Anmerkung zur Angabe des Typs einschließen.

Antwort:

HTTP/1.1 204 No Content
OData-Version: 4.0

Zusammenführungsverhalten für Vorfall

Das Zusammenführungsverhalten für die Tabelle incident (Fall) Tabelle unterscheidet sich von account-, contact- oder lead-Tabellen.

• Die UpdateContent-Parameterdaten werden nicht verwendet.

• Die Zusammenführung wird im Sicherheitskontext des Benutzers durchgeführt

  Zusammenführungsvorgänge für andere Tabellen werden mit einem Systembenutzer-Sicherheitskontext ausgeführt. Da Zusammenführungsvorgänge für Vorfälle im Sicherheitskontext des Benutzers ausgeführt werden, muss der Benutzer über die Sicherheitsberechtigungen verfügen, um alle Aktionen auszuführen, wie beispielsweise erneutes Überordnen zugehöriger Datensätze, die bei der Zusammenführung erfolgen.

  Wenn der Benutzer, der Datensätze zusammenführt, nicht über Berechtigungen für alle im Zusammenführungsvorgang enthaltenen Aktionen verfügt, schlägt der Zusammenführungsvorgang fehl und wird auf den ursprünglichen Zustand zurückgesetzt.

Siehe auch

Web-API-Aktionen verwenden
Doppelte Datensätze zusammenführen
MergeRequest Class
Verwaltungshandbuch: Datenzusammenführung
Dynamics 365 for Service: Fälle zusammenführen

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).