DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions LDAP
  • Ajout d'un nouvel objet dans un serveur LDAP
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
LDAPAjouteAttribut (Fonction)
En anglais : LDAPAddAttribute
Ajoute un attribut ou ajoute une nouvelle valeur à un attribut existant.
Cette fonction peut être utilisée aussi bien lors de la création d'un nouvel objet que lors de la modification d'un objet d'un serveur LDAP.
Exemple
// Ajout d'un utilisateur Test dans un "Active Directory"
LDAPDébutAjout("MaSessionLDAP")
LDAPAjouteAttribut("MaSessionLDAP", "objectClass", "top")
LDAPAjouteAttribut("MaSessionLDAP", "objectClass", "person")
LDAPAjouteAttribut("MaSessionLDAP", "objectClass", "organizationalPerson")
LDAPAjouteAttribut("MaSessionLDAP", "objectClass", "user")
LDAPAjouteAttribut("MaSessionLDAP", "objectCategory", ...
"CN=Person,CN=Schema,CN=Configuration,DC=societe,DC=fr")
LDAPAjouteAttribut("MaSessionLDAP", "instanceType", "4")
LDAPAjouteAttribut("MaSessionLDAP", "cn","Test")
LDAPAjouteAttribut("MaSessionLDAP", "sAMAccountName", "Test")
LDAPValideAjout("MaSessionLDAP", "cn=Test,cn=Users,dc=societe,dc=fr")
// Ajoute une valeur à un attribut. Si l'attribut n'existe pas, il est créé.
// La valeur est ajoutée aux valeurs existantes pour cet attribut
// La nouvelle valeur est dans la chaîne sNouvelleValeur
LDAPDébutModification("NomSession")
LDAPAjouteAttribut("NomSession", "NomAttribut", sNouvelleValeur)
LDAPValideModification("NomSession", "DN")
Syntaxe
<Résultat> = LDAPAjouteAttribut(<Session LDAP> , <Nom de l'attribut> , <Valeur de l'attribut>)
<Résultat> : Booléen
  • Vrai si l'ajout a été effectué,
  • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de détails sur l'erreur.
L'ajout effectif ne sera réalisé que lors de l'appel de la fonction LDAPValideAjout ou de la fonction LDAPValideModification.
<Session LDAP> : Chaîne de caractères
Nom de la session LDAP manipulée.
<Nom de l'attribut> : Chaîne de caractères
Nom de l'attribut à ajouter. Si cet attribut n'existe pas, il est automatiquement ajouté.
<Valeur de l'attribut> : Chaîne de caractères Ansi
Valeur de l'attribut ajouté ou nouvelle valeur de l'attribut.
Remarque : Pour certains attributs (définis par le schéma du serveur LDAP), il est possible d'avoir plusieurs valeurs pour un même attribut. Si une valeur existe déjà pour cet attribut, la nouvelle valeur sera ajoutée.
Remarques

Ajout d'un nouvel objet dans un serveur LDAP

Pour ajouter un nouvel objet dans un serveur LDAP, il est nécessaire de définir les différents attributs qui composent cet objet et leur valeur.
Pour optimiser la vitesse de création des objets, les attributs et leurs valeurs sont définis localement : une seule communication avec le serveur est établie lors de la validation de l'ajout. Les étapes sont les suivantes :
  1. Initialisation de l'ajout (fonction LDAPDébutAjout)
  2. Ajout des attributs et de leurs valeurs (fonction LDAPAjouteAttribut). Cet ajout peut être réalisé autant de fois que nécessaire.
  3. Association des attributs et de leurs valeurs à un objet grâce à la fonction LDAPValideAjout.
Attention :
  • Les opérations de modification étant réalisées localement avant d'être effectuées sur le serveur, il est nécessaire de respecter l'ordre logique des modifications (par exemple, il ne sera pas possible de modifier un attribut supprimé par la ligne de code précédente).
  • Pour pouvoir ajouter un attribut sur un "user" de l'Active Directory, l'attribut doit avoir été déclaré préalablement dans les paramètres de l'Active Directory comme un attribut exploitable dans la base du LDAP.
Composante : wd290com.dll
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale