Beispiel: Einen Datensatz einem neuen Besitzer zuweisen
Dieses Beispiel zeigt, wie ein Konto einem anderen Benutzer mithilfe der Message IOrganizationService.Update zugewiesen wird.
Dieses Beispiel verwendet die IOrganization.Update
-Methode und nicht die AssignRequest, weil es einen Aufwand gibt, spezialisierte Nachrichten zu entfernen. Mehr Informationen: Durchführen von spezialisierten Operationen mit update
Sie können das Beispiel von hier herunterladen.
Notiz
Dieses Beispiel trifft auf Dynamics 365 Customer Engagement (on-premises) und Dataverse zu.
Wie man dieses Beispiel ausführt
Um eine lokale Kopie aller Muster zu erhalten und diese zu erstellen, gehen Sie wie folgt vor:
- Um eine lokale Kopie zu erhalten, laden Sie das Beispiele-Repository herunter, oder klonen Sie es.
- (Optional) Bearbeiten Sie die dataverse/App.config-Datei so, dass sie eine Verbindungszeichenfolge festlegt, aus der die Instanz/Organisation hervorgeht, zu der Sie eine Verbindung herstellen möchten.
- 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 Instanz oder Organisation Sie eine Verbindung herstellen und welche Anmeldeinformationen Sie verwenden möchten. Dieses Dialogfeld speichert frühere Verbindungen, so dass Sie eine bereits verwendete Verbindung auswählen können.
Funktionsweise
Die Nachricht IOrganizationService.Update ist für ein Szenario gedacht, in dem sie die Daten enthält, die zur Aktualisierung eines bestehenden Datensatzes benötigt werden.
Wie dieses Beispiel funktioniert
Um das unter Was macht dieses Beispiel, beschriebene Szenario zu simulieren, geht das Beispiel wie folgt vor:
Einrichtung
- Prüft auf aktuelle Version der Organisation.
- Erstellt die für dieses Beispiel erforderlichen Daten.
Rechte und Zugriffsrechte
Um dieses Beispiel auszuführen, muss der Aufrufer über die Berechtigungen für die angegebene Entität und die Zugriffsrechte für den angegebenen Datensatz verfügen. Wenn der Anrufer beispielsweise nur über Schreib- oder Zuweisungsberechtigungen für die Entität verfügt und versucht, den Datensatz einem anderen Benutzer zuzuweisen, schlägt die Anforderung fehl. Der Anrufer muss über die Schreib- und Zuweisungsberechtigungen für die Entität verfügen, um den Datensatz einem anderen Benutzer zuweisen zu können.
Demonstrieren
- Die
Retrieve
-Methode ruft die in der Einrichtung (#setup) erstellten Kontodatensätze ab. - Die
Update
-Nachricht aktualisiert dasownerid
-Attribut für den Benutzer, dem der Datensatz gehören soll.
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.