Partager via


Gérer l'autorisation pour créer ou modifier des éléments de travail

Vous pouvez contrôler qui est autorisé à créer ou modifier un élément de travail en appliquant l'élément VALIDUSER aux champs de noms de personnes.Lorsque vous spécifiez cet élément, vous indiquez que l'utilisateur ou le groupe d'utilisateurs peut être assigné en tant que valeur pour le champ.Vous pouvez configurer cet élément pour la prise en charge de l'attribut de group facultatif, qui spécifie que la personne assignée au champ doit être membre direct ou indirect du groupe que vous indiquez.Par défaut, tous les membres du groupe Team Foundation Valid Users peuvent être spécifiés dans le champ.

L'élément VALIDUSER est valide uniquement pour les champs de type String.Vous pouvez spécifier cette règle en tant qu'élément enfant de l'élément FIELD (Définition) ou FIELD (Flux de travail).

Dans cette rubrique

  • Champs de noms de personnes

  • Structure de syntaxe VALIDUSER

  • Attributs VALIDUSER

  • Comment éviter les erreurs de validation en permettant la conservation d'une valeur existante pour un champ

[!REMARQUE]

Pour appliquer une règle à une définition d' FIELD, utilisez l'outil en ligne de commande des witadmin pour importer et exporter la définition du type d'élément de travail.Consultez Personnaliser et gérer des types d'éléments de travail (witadmin).

Champs de noms de personnes

Vous pouvez utiliser la règle VALIDUSER uniquement lorsque vous faites référence aux champs de noms de personnes.Les champs système suivants sont des exemples de champs de noms de personnes :

  • Activé par (System.ActivatedBy)

  • Assigné à (System.AssignedTo)

  • Autorisé en tant que (System.AuthorizedAs)

  • Modifié par (System.ChangedBy)

  • Fermé par (System.ClosedBy)

  • Créé par (System.Created By)

En plus des champs système, vous pouvez créer un champ de chaîne personnalisé et l'utiliser comme champ de nom de personne.En outre, vous pouvez synchroniser les champs de noms de personnes personnalisés avec Active Directory.Pour plus d'informations, consultez Gérer des champs d'éléments de travail (witadmin).

Structure de syntaxe VALIDUSER

Lorsque vous utilisez l'élément VALIDUSER, vous pouvez spécifier qu'un champ de nom de personne doit contenir le nom d'un membre du groupe Team Foundation Valid Users ou d'un autre groupe que vous pouvez spécifier.

Vous pouvez autoriser ou restreindre l'application de la règle à l'utilisateur qui modifie l'élément de travail, en spécifiant un utilisateur ou un groupe pour les attributs for ou not, respectivement.

<VALIDUSER group="groupName" for="userName" not="userName" />

Tous les attributs sont facultatifs.Tous les attributs doivent être constitués d'une chaîne de texte qui contient entre 1 et 255 caractères.Vous pouvez utiliser des jetons pour spécifier des groupes.Pour plus d'informations, consultez Utiliser des jetons pour référencer des utilisateurs et des groupes.

[!REMARQUE]

Les champs d'éléments de travail ne distinguent pas les identités utilisateur dans les différents domaines.Par conséquent, « Example1\jaepak » et « Example2\jaepak » sont associés au même utilisateur lorsqu'ils sont entrés dans un champ qui utilise la règle VALIDUSER.En revanche, dans un autre emplacement de Visual Studio Team Foundation Server, ces identités utilisateur sont distinguées par domaine.

Retour au début

Attributs VALIDUSER

Vous pouvez spécifier s'il faut restreindre les personnes auxquelles s'applique la règle VALIDUSER.Si vous ne définissez pas l'un des attributs facultatifs, tous les utilisateurs et groupes valides dans Team Foundation Server peuvent modifier le champ.

Attribut

Description

for

Optionnel.Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle s'applique.Les noms valides sont constitués d'une chaîne de texte qui contient entre 1 et 255 caractères.

Valeur de modèle : ^[^\\]+\\[^\\]+$

Exemple de valeur de modèle : Domaine\IDutilisateur

not

Optionnel.Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle ne s'applique pas.Les noms valides sont constitués d'une chaîne de texte qui contient entre 1 et 255 caractères.

Valeur de modèle : ^[^\\]+\\[^\\]+$

Exemple de valeur de modèle : Domaine\IDutilisateur

group

Optionnel.Nom d'un groupe.Les utilisateurs peuvent spécifier des membres de ce groupe comme valeurs du champ de nom de personne.Les noms valides sont constitués d'une chaîne de texte qui contient entre 1 et 255 caractères.

Valeur de modèle : ^[^\\]+\\[^\\]+$

Exemple de valeur de modèle : Domain\GroupID

Retour au début

Comment éviter les erreurs de validation en permettant la conservation d'une valeur existante pour un champ

L'exemple suivant indique comment s'assurer que seuls les utilisateurs valides sont assignés à un élément de travail, affecter comme valeur par défaut du champ Assigné à l'utilisateur ayant créé l'élément de travail et fournir une liste de choix de noms qui inclut des membres du groupe Contributors pour le projet d'équipe.En spécifiant l'élément ALLOWEXISTINGVALUE, vous évitez les erreurs de validation éventuelles qui se produiraient lorsque les membres quitteraient l'équipe et ne seraient plus enregistrés comme collaborateurs de projet.

<FIELD name="Assigned To" refname="System.AssignedTo" type="String" syncnamechanges="true" reportable="dimension">
   <HELPTEXT>The user who is working on this work item</HELPTEXT>
   <ALLOWEXISTINGVALUE />
   <VALIDUSER />
   <ALLOWEDVALUES expanditems="true" filteritems="excludegroups">
      <LISTITEM value="Active" />
      <LISTITEM value="[project]\Contributors" />
   </ALLOWEDVALUES>
   <DEFAULT from="field" field="System.CreatedBy" />
</FIELD>

Voir aussi

Référence

Gérer des champs d'éléments de travail (witadmin)

Concepts

Utiliser des jetons pour référencer des utilisateurs et des groupes

Autres ressources

Utilisation de règles de champs