Exemple : Ajouter un principal de sécurité (utilisateur ou équipe) à une file d’attente (liaison anticipée)

Cet exemple illustre comment donner à un utilisateur ou à une équipe un accès limité à une file d’attente. La AddPrincipalToQueueRequest ajoute le principal spécifié à la liste des membres de la file d’attente. Si le principal de sécurité admis est une équipe, chaque membre de l’équipe est ajouté à la file d’attente. Vous pouvez télécharger l’exemple ici.

Comment exécuter cet exemple

Pour obtenir une copie locale de tous les exemples et les générer, procédez comme suit :

1. Télécharger ou cloner le référentiel Exemples pour en avoir une copie locale.
2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une chaîne de connexion qui spécifie l’instance ou l’organisation à laquelle vous souhaitez vous connecter.
3. Ouvrez l’exemple de solution dans Visual Studio et appuyez sur F5 pour exécuter l’exemple. Après avoir spécifié une chaîne de connexion dans le fichier dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de chaîne de connexion dans le fichier dataverse/App.config, une boîte de dialogue s’ouvre chaque fois que vous exécutez l’exemple et vous devez entrer des informations sur l’instance ou l’organisation à laquelle vous souhaitez vous connecter et sur les informations d’identification que vous souhaitez utiliser. Cette boîte de dialogue met en cache les connexions précédentes afin que vous puissiez choisir une connexion déjà utilisée.

En quoi consiste cet exemple

Le message AddPrincipalToQueueRequest est destiné à un scénario où il contient les données nécessaires à l’ajout du principal précisé à la liste des membres de la file d’attente. Si le principal est une équipe, ajoutez chaque membre de l’équipe à la file d’attente.

Utiliser cet exemple

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l’exemple procède comme suit :

Installation

1. Vérifie la version actuelle de l’organisation.
2. La méthode Queue crée une instance de file d’attente et définit ses valeurs de propriété. Les GUID renvoyés sont stockés dans une variable.
3. L’QueryExpression extrait la division par défaut pour la création de l’équipe et du rôle.
4. Crée une équipe et le rôle d’exemple requis pour l’exemple.
5. Extrait les privilèges prvReadQueue et prvAppendToQueue.
6. La méthode AddPrivilegeRoleRequest ajoute les privilèges prvReadQueue abd prvAppendToQueue au rôle d’exemple.

Démontrer

La méthode AddPrincipalToQueueRequest ajoute l’équipe à la file d’attente.

Nettoyer

Affichez une option pour supprimer l’exemple de données dans Installation. La suppression est facultative si vous souhaitez vérifier les entités et les données créées par l’exemple. Vous pouvez supprimer manuellement l’enregistrement pour obtenir le même résultat.