GroupMemberControl DataObject

GroupMemberControl est utilisé dans l'objet de données d'entrée de l'interface de programme d'application d'extraction et de mise à jour.

Dans l'API d'extraction (get), GroupMemberControl permet de lancer une requête sur les membres d'un groupe. Si vous ajoutez GroupMemberControl à l'objet de données d'entrée, les membres du groupe sont retournés. GroupMemberControl permet également d'indiquer les propriétés des membres à retourner ainsi que le niveau des membres imbriqués à retourner.

GroupMemberControl étant une extension de SearchControl, vous pouvez indiquer les propriétés afin d'obtenir uniquement les groupes qui répondent aux critères de recherche. Par exemple, vous pouvez ajouter une expression de propriété avec la valeur : "entités[@xsi:type='PersonAccount']" pour retourner uniquement les membres dont le type d'entité est PersonAccount.

La structure du graphique de données d'un objet de données GroupMemberControl dans l'API d'extraction se compose des éléments suivants :
propriétés
liste des attributs à retourner des entités qui répondent aux critères de recherche. Par exemple, vous souhaitez obtenir les attributs sn et givenName des personnes du service marketing.
searchBases
liste de bases de recherche permettant de limiter la recherche aux bases recensées.
countLimit
permet d'indiquer le nombre maximal de résultats renvoyés par l'opération de recherche.
timeLimit
Si le référentiel de profil prend en charge le délai, il indique la durée maximale de recherche en milliseconde.
expression
expression de recherche au format XPath.
level
permet d'indiquer le niveau de hiérarchie à retourner. Dans GroupMemberControl, il indique le niveau des membres imbriqués. Voir le tableau suivant.
Ce tableau répertorie les valeurs possibles du niveau :
Tableau 1. valeurs de niveau GroupMemberControl
Niveau GroupMemberControl Description
1 (par défaut) Retourne les membres immédiats uniquement.
0 Retourne tous les membres imbriqués.
La structure du graphique de données d'un objet de données GroupMemberControl dans l'API de mise à jour se compose des éléments suivants :
modifyMode
indique s'il faut utiliser le mode d'affectation, de modification ou de non affectation. Voir le tableau suivant.
Ce tableau répertorie les valeurs possibles de modifyMode :
Tableau 2. Valeurs modifyMode de GroupMemberControl
GroupMemberControl modifyMode Description
1 (par défaut) Mode affectation. Les membres contenus dans l'objet de données de groupe sont ajoutés à ce groupe en tant que membres.
2 Mode remplacement. Les membres contenus dans l'objet de données de groupe sont ajoutés au groupe en tant que membres et tous les membres existants du groupe sont supprimés.
3 Mode non affectation. Les membres contenus dans l'objet de données de groupe sont supprimés du groupe.

Définition de schéma XML

Vous trouverez ci-dessous la définition du schéma XML pour l'objet de données GroupMemberControl :
<xsd:complexType name="GroupMemberControl">
    <xsd:complexContent>
	 <xsd:extension base="GroupControl">
	 </xsd:extension>
    </xsd:complexContent>
	</xsd:complexType>

Objets de données exemple

Voici un exemple d'objet de données GroupMemberControl utilisé dans l'interface de programme d'application d'extraction. Il permet de rechercher les membres immédiats (niveau=1) du groupe. Il indique également de retourner les attributs uid, cn, o et ou des membres, le cas échéant.
    <wim:controls xsi:type="wim:GroupMemberControl" level="1">
      <wim:properties>cn</wim:properties>
      <wim:properties>uid</wim:properties>
      <wim:properties>o</wim:properties>
      <wim:properties>ou</wim:properties>
 </wim:controls>
Voici un exemple d'objet de données GroupMemberControl utilisé dans l'interface de programme d'application de mise à jour. Il indique que les membres doivent être libérés de leur affectation à un groupe.
<wim:controls xsi:type="wim:GroupMemberControl" modifyMode="3"/>


Conditions d'utilisation | Commentaires