Beispiel: Verwenden der Duplikaterkennung für die Erstellung und Aktualisierung von Datensätzen

Dieses Beispiel zeigt, wie Sie die Duplikaterkennung zur Erstellung und Aktualisierung von Tabellendatensätzen aufrufen.

SDK für .NET: Beispielcode für das Verwenden der Duplikaterkennung für die Erstellung und Aktualisierung von Datensätzen

Wie man dieses Beispiel ausführt

1. Um eine lokale Kopie zu erhalten, laden Sie den Beispielbericht herunter, oder klonen Sie ihn.
2. (Optional) Bearbeiten Sie die dataverse/App.config-Datei so, dass sie eine Verbindungszeichenfolge festlegt, aus der die Microsoft Dataverse-Instanz hervorgeht, zu der Sie eine Verbindung herstellen möchten.
3. Um das Beispiel auszuführen, öffnen Sie die Beispiellösung in Visual Studio, und drücken Sie F5. Nachdem Sie in der dataverse/App.config-Datei eine Verbindungszeichenfolge angegeben haben, nutzen alle Beispiele, die Sie ausführen, diese Verbindungsdaten.

Wenn Sie in der dataverse/App.config-Datei keine Verbindungszeichenfolge angeben, wird bei jeder Ausführung eines Beispiels ein Dialogfeld geöffnet, in dem Sie eingeben müssen, zu welcher Dataverse-Instanz Sie eine Verbindung herstellen und welche Anmeldeinformationen Sie verwenden möchten. Vorherige Verbindungen werden im Dialogfeld zwischengespeichert, sodass Sie aus zuvor verwendeten Verbindungen auswählen können.

Diejenigen Beispiele aus dem Bericht, die zu ihrer Ausführung eine Verbindung zu einer Instanz von Dataverse benötigen, enthalten eine verknüpfte Referenz zur dataverse/App.config-Datei.

Funktionsweise

Die DuplicateRule-Methode ist dazu vorgesehen, in einem Szenario verwendet zu werden, in dem sie Daten enthält, die zur Erstellung einer Duplikaterkennungsregel benötigt werden.

Wie dieses Beispiel funktioniert

Um das unter Was macht dieses Beispiel, beschriebene Szenario zu simulieren, geht das Beispiel wie folgt vor:

Einrichten

1. Prüft auf aktuelle Version der Organisation.
2. Die Account-Methode erstellt einen Firmendatensatz.
3. Die DuplicateRule-Methode erstellt eine Duplikaterkennungsregel.
4. Die DuplicateRuleCondition-Methode erstellt Bedingungen einer Duplikaterkennungsregel.
5. Die PublishDuplicateRuleRequest-Methode veröffentlicht die Duplikaterkennungsregel, die früher erstellt wurde. Sie müssen warten, bis der Veröffentlichungsvorgang abgeschlossen ist. Daher fragen wir weiterhin den Status der Regel ab, bis sie Published wird.

Demonstrieren

1. Die Account-Methode erstellt einen Firmendatensatz.
2. Die CreateRequest-Methode erzeugt eine Operation durch Unterdrückung der Dublettenerkennung.
3. Die UpdateRequest-Methode aktualisiert den abgerufenen Firmendatensatz mit der neuen Kontonummer.

Bereinigung

Zeigt eine Option zum Löschen aller im Beispiel erstellten Daten an. Das Löschen ist optional, falls Sie die Daten überprüfen möchten, die durch das Beispiel erstellt wurden. Sie können die Daten manuell löschen, um das gleiche Ergebnis zu erzielen.

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