PropertyDefinitionControl
permet d'extraire la définition de propriété des propriétés spécifiées dans le
référentiel indiqué.
L'objet de données PropertyDefinitionControl est une extension de TypeControl et
est utilisé dans l'objet de données d'entrée de la méthode getSchema de SchemaService.
La structure d'un objet de données PropertyDefinitionControl se compose des éléments suivants :
- repositoryId
- permet d'indiquer l'ID du référentiel dans le fichier XML de configuration
virtual member manager. Par exemple, si un serveur LDAP est configuré dans le fichier XML de
configuration de virtual member manager avec l'ID LDAP1, vous devez associer repositoryId à LDAP1 dans PropertyDefinitionControl.
La méthode getSchema renvoie le schéma des propriétés pour le référentiel LDAP1. Si aucun repositoryId n'est indiqué dans PropertyDefinitionControl, le schéma des propriétés au niveau de virtual member manager est renvoyé.
- propertyNames
- liste des
propriétés dont l'appelant souhaite extraire la définition. Les noms de
propriété doivent être des noms de propriété habilités et contenir par
conséquent le préfixe de l'espace de nom. Si la propriété propertyNames n'est
pas spécifiée, toutes les propriétés définies pour le type d'entité indiqué
sont renvoyées.
- entityTypeName
- indique le type de l'entité. La valeur de entityTypeName est également un nom
qualifié qui signifie qu'il contient le préfixe espace de nom du type d'entité.
Définition de schéma XML
Vous
trouverez ci-dessous la définition du schéma XML pour l'objet de données PropertyDefinitionControl :
<xsd:complexType name="PropertyDefinitionControl">
<xsd:complexContent>
<xsd:extension base="TypeControl">
<xsd:sequence>
<xsd:element ref="propertyNames" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="entityTypeName" type="xsd:token"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
Objet de données exemple
Voici un exemple d'objet de données
PropertyDefinitionControl utilisé dans l'opération getSchema pour lancer une requête sur
toutes les propriétés prises en charge par le référentiel LDAP1 pour le type d'entité
PersonAccount :
<wim:controls xsi:type="wim:PropertyDefinitionControl" repositoryId="LDAP1" entityTypeName="PersonAccount"/>