GroupMembershipControl est utilisé dans l'objet de données d'entrée de l'API d'extraction (get) et de mise à jour (update).
Dans l'interface de programme d'application d'extraction, GroupMembershipControl permet de lancer une requête sur les groupes auxquels appartient une entité. Si vous ajoutez GroupMembershipControl à l'objet de données d'entrée, les groupes auxquels appartient l'entité sont renvoyés. GroupMembershipControl permet également d'indiquer les propriétés des groupes à renvoyer ainsi que le niveau des groupes imbriqués à renvoyer.
GroupMembershipControl é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='Groupe' et cn='Admin*']" pour renvoyer uniquement les groupes dont les propriétés "cn" commencent par "Admin".
Niveau GroupMembershipControl | Description |
---|---|
1 (par défaut) | Renvoie les groupes immédiats uniquement. |
0 | Renvoie tous les groupes imbriqués |
GroupMembershipControl modifyMode | Description |
---|---|
1 (par défaut) | Mode affectation. Les groupes contenus dans l'objet de données d'entité ajoutent l'entité en tant que membre. |
2 | Mode remplacement. Les groupes contenus dans l'objet de données d'entité ajoutent l'entité en tant que membre et tous les membres existants sont supprimés. |
3 | Mode non affectation. Les groupes contenus dans l'objet de données d'entité suppriment l'entité de leurs membres. |
data object <xsd:complexType name="GroupMembershipControl">
<xsd:complexContent>
<xsd:extension base="GroupControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:GroupMembershipControl" level="1">
<wim:properties>cn</wim:properties>
<wim:properties>displayName</wim:properties>
</wim:controls>
<wim:controls xsi:type="wim:GroupMembershipControl" modifyMode="3"/>