4D v15

LDAP Search

Accueil

 
4D v15
LDAP Search

LDAP Search 


 

LDAP Search ( dnRootEntry ; filtre {; scope {; attributs {; attributsEnTableau}}} ) -> Résultat 
Paramètre Type   Description
dnRootEntry  Chaîne in Distinguished Name de l'élément racine où démarrer la recherche
filtre  Chaîne in Filtre de recherche LDAP
scope  Chaîne in Champ d'action de la recherche : "base" (défaut), "one" ou "sub"
attributs  Tableau chaîne in Attribut(s) à récupérer
attributsEnTableau  Tableau booléen in Vrai = forcer le retour des attributs en tableaux, Faux = forcer le retour des attributs en variables simples
Résultat  Objet in Attributs clé/valeur

La commande LDAP Search recherche sur le server LDAP cible la première occurrence correspondant aux critères définis. Cette commande doit être exécutée dans le contexte d'une connexion serveur LDAP ouverte par la commande LDAP LOGIN dans le process courant ; sinon une erreur 1003 est retournée.

Dans dnRootEntry, passez le Distinguished Name de l'élément racine du serveur LDAP ; la recherche démarrera à partir de cet élément.

Dans filtre, passez le filtre de recherche LDAP à appliquer. Ce filtre doit être conforme à la rfc2225. Vous pouvez passer une chaîne vide "" afin de ne pas appliquer de filtre. Le joker "*" pour chercher des sous-chaînes est pris en charge.

Dans scope, passez une des constantes suivantes du thème "LDAP" :

ConstanteTypeValeurCommentaire
LDAP racine uniquementTexte"base"Chercher uniquement dans l'élément racine défini par dnRootEntry (défaut si omis)
LDAP racine et suivantTexte"one"Chercher dans l'élément racine défini par dnRootEntry et dans les branches directement suivantes sur un niveau
LDAP tous niveauxTexte"sub"Chercher dans l'élément racine défini par dnRootEntry et dans toutes les branches suivantes

Dans attributs, passez un tableau texte contenant la liste de tous les attributs LDAP à récupérer à partir des entrées trouvées. Par défaut, si ce paramètre est omis, tous les attrbiuts sont récupérés.

Note : Les noms d'attributs LDAP tiennent compte des majuscules/minuscules. Pour plus d'informations sur les attributs LDAP, vous pouvez consulter cette page qui liste tous les attributs disponibles pour MS Active Directory.

Par défaut, la commande retourne les attributs sous forme de tableau si plusieurs résultats sont trouvés, ou sous forme de variable simple si un seul résultat est trouvé. Le paramètre optionnel attributsEnTableau vous permet de "forcer" le formatage des attributs retournés en tableau ou en variable pour chaque attribut défini :

  • Lorsque vous passez true dans un élément, l'élément correspondant du paramètre attributs sera retourné en tableau. Si une seule valeur est trouvée, la commande retourne un tableau à un seul élément.
  • Lorsque vous passez false dans un élément, l'élément correspondant du paramètre attributs sera retourné en variable simple. Si plusieurs valeurs sont trouvées, la commande retourne uniquement le premier élément.

Vous souhaitez obtenir le numéro de téléphone de l'utilisateur "smith" dans l'annuaire de l'enterprise :

 ARRAY TEXT($_tabAttributes;0)
 APPEND TO ARRAY($_tabAttributes;"cn")
 APPEND TO ARRAY($_tabAttributes;"phoneNumber")
 LDAP LOGIN($url;$dn;$pwd)
 $filter:="cn=*smith*"
 $vfound:=LDAP Search($dnSearchRootEntry;$filter;LDAP all levels;$_tabAttributes)
 LDAP LOGOUT

Vous voulez obtenir un tableau de toutes les entrées trouvées pour l'attribut "memberOf" :

 C_OBJECT($entry)
 ARRAY TEXT($_tabAttributes;0)
 ARRAY BOOLEAN($_tabAttributes_asArray;0)
 APPEND TO ARRAY($_tabAttributes;"cn")
 APPEND TO ARRAY($_tabAttributes_asArray;False)
 APPEND TO ARRAY($_tabAttributes;"memberOf")
 APPEND TO ARRAY($_tabAttributes_asArray;True)
 
 LDAP LOGIN($url;$login;$pwd;LDAP password plain text)
 $entry:=LDAP Search($dnSearchRootEntry;"cn=adrien*";LDAP all levels;$_tabAttributes;$_tabAttributes_asArray)
 LDAP LOGOUT
 
 ARRAY TEXT($_arrMemberOf;0)
 OB GET ARRAY($entry;"memberOf";$_arrMemberOf)
  // $_arrMemberOf est un tableau contenant tous les groupes de l'entrée



Voir aussi  

LDAP SEARCH ALL

 
PROPRIÉTÉS 

Produit : 4D
Thème : Annuaire d'entreprise (LDAP)

 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D v15 - Mise à jour (édition R-release) ( 4D v15)

Parent de : LDAP Search ( 4D v15)