Beispiel: Hinzufügen eines Sicherheitsprinzipals (Benutzer oder Team) zu einer Warteschlange

Dieses Beispiel zeigt, wie einem Benutzer oder Team Zugriff auf eine Warteschlange gewährt wird. Die AddPrincipalToQueueRequest fügt den angegebenen Prinzipal der Liste der Warteschlangenmitglieder hinzu. Wenn der angegebene Sicherheitsprinzipal ein Team ist, wird jedes Teammitglied der Warteschlange hinzugefügt. Sie können das Beispiel von hier herunterladen.

Hinweis

Unsicher bei Entität vs. Tabelle? Siehe Developers: Understand terminology in Microsoft Dataverse.

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 cds/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 cds/App.config-Datei eine Verbindungszeichenfolge angegeben haben, nutzen alle Beispiele, die Sie ausführen, diese Verbindungsdaten.

Wenn Sie in der cds/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 cds/App.config-Datei.

Funktionsweise:

Die AddPrincipalToQueueRequest-Nachricht ist für die Verwendung in einem Szenario vorgesehen, in dem sie Daten enthält, die benötigt werden, um den angegebenen Prinzipal zur Liste der Warteschlangenmitglieder hinzuzufügen. Wenn der Prinzipal ein Team ist, fügen Sie jedes Teammitglied zur Warteschlange hinzu.

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 Queue-Methode erstellt eine Warteschlangeninstanz und legt deren Eigenschaftswerte fest. Die zurückgegebenen GUIDs werden in einer Variablen gespeichert.
  3. Die QueryExpression ruft die Standardunternehmenseinheit für die Erstellung eines Teams und der Rolle ab.
  4. Erstellt ein neues Beispielsteam und eine neue -Rolle, die für das Beispiel benötigt werden.
  5. Ruft prvReadQueue und prvAppendToQueue -Rechte ab.
  6. Die AddPrivilegeRoleRequest-Methode fügt der Beispielrolle die prvReadQueue sowie die prvAppendToQueue-Rechte hinzu.

Demonstrieren

Die AddPrincipalToQueueRequest-Methode fügt das Team der Warteschlange hinzu.

Bereinigung

Zeigt eine Option an, um die Beispieldaten zu löschen, die in Einrichtungerstellt wurden. Das Löschen ist optional, falls Sie die vom Beispiel erstellten Tabellen und Daten untersuchen möchten. Sie können die Datensätze 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).