Beispiel: Zuordnen einer Sicherheitsrolle zu einem Team

Dieses Beispiel zeigt, wie einem Team mithilfe der Meldung AssignRequest eine Sicherheitsrolle zugewiesen wird. Beachten Sie, dass dieses Beispiel nicht berücksichtigt, dass einem Team oder einem Benutzer nur von deren Unternehmenseinheit eine Rolle zugewiesen werden kann. Die Rolle, die zugewiesen werden soll, ist die erste in der Sammlung, die von der Methode RetrieveMultiple zurückgegeben wird. Wenn dieser Datensatz aus einer Unternehmenseinheit stammt, die nicht zu dem anfordernden Team gehört, schlägt die Zuweisung fehl.

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:

1. Um eine lokale Kopie zu erhalten, laden Sie das Beispiele-Repository herunter, oder klonen Sie es.
2. (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.
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 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 Meldung AssignRequest soll in einem Szenario verwendet werden, in dem sie Daten enthält, die erforderlich sind, um den angegebenen Datensatz einem neuen Besitzer (Benutzer oder Team) zuzuweisen, indem das OwnerId-Attribut des Datensatzes geändert wird.

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 CreateRequiredRecords-Methode erstellt die erforderlichen Datensätze für das Beispiel.

Demonstrieren

1. Die query Methode ruft eine Rolle von Dataverse ab.
2. Die Meldung Associate weist die Rolle einem Team zu.

Bereinigung

Zeigt eine Option an, um die Beispieldaten zu löschen, die in Einrichtungerstellt wurden. Das Löschen ist optional, falls Sie die Entitäten und Daten durchsuchen möchten, die durch das Beispiel erstellt wurden. Sie können die Datensätze manuell löschen, um das gleiche Ergebnis zu erzielen.