Paramètres de vues

Utilisez un paramètre de vues dans la commande set view pour spécifier un espace réservé pour une chaîne. Le DSA déterminera la valeur du paramètre de vues lors de l'appel de la vue ou après l’exécution d’une phase antérieure dans la vue par le DSA.
cad126fr
Utilisez un paramètre de vues dans la commande 
set view
 pour spécifier un espace réservé pour une chaîne. Le DSA déterminera la valeur du paramètre de vues lors de l'appel de la vue ou après l’exécution d’une phase antérieure dans la vue par le DSA.
La syntaxe d’un paramètre de vues se présente comme suit :
[$][phaseNumberList:]attributeName[substringIdentifier]
  • $
    (Facultatif) Spécifie que le DSA doit traiter cet élément en tant que paramètre de vues.
    Si le signe $ est manquant, la chaîne est considérée comme un nom d’attribut littéral et aucune substitution n’aura lieu. Dans ce cas,
    substringIdentifier
    doit être vide.
  • phaseNumberList
     :
    (Facultatif) Définit le numéro de la phase qui génère la valeur de 
    attributeName
    . Si
    phaseNumber:
    est omis, le DSA fournit la valeur d’
    attributeName
    à partir du filtre indiqué dans la commande de recherche LDAP qui a appelé la vue.
    phaseNumber
    doit être inférieur au nombre de la phase dans laquelle le paramètre est utilisé. En d'autres termes, une phase peut uniquement faire référence aux phases précédentes de la vue.
    Vous pouvez spécifier une liste de nombres de phase lors de l’utilisation de vues conditionnelles.
  • attributeName
    Spécifie l’attribut dont la valeur est utilisée pour remplacer le paramètre.
  • substringIdentifier
    (Facultatif) Spécifie une section dans une chaîne de valeurs d’attribut.
    Deux formats sont disponibles pour l’identificateur de la sous-chaîne.
    Le premier format der
    substringIdentifier
    permet d'extraire une sous-chaîne basée sur des caractères délimiteurs et se présente comme suit :
    • [
      delimiterString
      :
      substringNumber
      ]
      Les crochets et les deux points font partie de la syntaxe et sont requis si cette option est utilisée.
    • delimiterString
      Définit le délimiteur dans la chaîne de valeurs d’attribut. Il s'agit d'une chaîne littérale ; elle peut donc par exemple inclure des espaces, des guillemets et des caractères non alphanumériques. La chaîne délimiteur partitionne la valeur d’attribut en sous-chaînes.
    • substringNumber
      Spécifie la sous-chaîne à extraire à partir de la chaîne de valeurs d’attribut. Les sous-chaînes de la valeur d’attribut sont numérotées de gauche à droite à partir de un.
    Le second format de
    substringIdentifier
    permet d'extraire les principaux noms uniques à partir d’une chaîne de noms uniques, ou d'extraire les premiers caractères de la chaîne. Ce format se présente comme suit :
    • [
      numberOfDNsOrCharacters
      ]
      Les crochets font partie de la syntaxe et sont requis si cette option est utilisée.
    • numberOfDNsOrCharacters
      Spécifie le nombre de RDN ou de caractères à extraire à partir de la chaîne de valeurs d’attribut, en commençant à partir du premier caractère tout à gauche.
      Si ce paramètre est utilisé dans le cadre de la spécification de la sous-arborescence d’une phase ("subtree=..."), il renverra le nombre de RDN ; sinon, il spécifie le nombre de caractères.
Exemple : Paramètre de vue $cn
Lorsque la vue est appelée, le DSA remplace l’exemple de chaîne par la valeur de l’attribut
cn
fournie dans le filtre de la commande de recherche utilisée pour appeler la vue.
Dans cet exemple, la recherche est appelée à l'aide de la commande suivante :
ldapsearch... (cn="Smith, John")
$cn
est remplacé par la valeur suivante :
Smith, John
Exemple : Paramètre de vue $cn[,:1]
Lorsque la vue est appelée, le DSA remplace l’exemple de chaîne par les caractères précédant la première virgule dans la valeur de l’attribut cn.
Dans cet exemple, la recherche est appelée à l'aide de la commande suivante :
ldapsearch... (cn="Smith,John")
$cn[,:1]
 est remplacé par la valeur suivante :
Smith
Exemple : $cn[7]
Lorsque la vue est appelée, le DSA remplace la chaîne de l’exemple par les sept premiers caractères de la valeur de l’attribut cn.
Dans cet exemple, la recherche est appelée à l'aide de la commande suivante :
ldapsearch... (cn="Smith,John")
$cn[7]
 est remplacé par la valeur suivante :
Smith,J
Exemple : $3:cn
Immédiatement après l’exécution de la phase 3 de la vue, le DSA remplace l’exemple de chaîne par la valeur de l’attribut
cn
renvoyé par la phase 3. L’exemple de chaîne est uniquement valide dans les phases quatre et ultérieures.
Exemple : $2,3:cn
Avec $2,3:cn dans l’exemple suivant, $2:cn ou $3:cn est utilisé en fonction de la phase appelée.
if ( condition ) { (phase = 2) } else { (phase = 3) }
Exemple : sous-arborescence=$1:dn
... (phase=2 subtree = $1:dn ...
Il s’agit d’une partie de commande set view. Immédiatement après l’exécution de la phase 1, le DSA remplace la chaîne $1:dn par la valeur du nom unique de chaque résultat de recherche renvoyé dans la phase 1. Si la phase 1 renvoie plusieurs noms uniques, la phase 2 sera exécutée plusieurs fois : une fois pour chaque résultat de nom unique renvoyé par la phase 1.
Exemple : sous-arborescence=$1:dn[3]
... (phase=2 subtree = $1:dn[3] ...
Il s’agit d’une partie de commande set view. Immédiatement après l’exécution de la phase 1, le DSA remplace la chaîne $1:dn[3] par la valeur des trois premiers RDN des noms uniques de chaque résultat de recherche renvoyé dans la phase 1. Si la phase 1 renvoie plusieurs noms uniques, la phase 2 sera exécutée plusieurs fois : une fois pour chaque résultat de nom unique renvoyé par la phase 1.
Exemple : sous-arborescence="uid=$1:uids,o=Democorp,c=AU"
... (phase=2 subtree="uid=$1:uids,o=Democorp,c=AU" ...
Il s’agit d’une partie de commande set view. Immédiatement après l’exécution de la phase 1, le DSA remplace la chaîne $1:uid par la valeur des ID uniques renvoyés par la recherche de la phase 1. Si la phase 1 renvoie plusieurs noms uniques, la phase 2 sera exécutée plusieurs fois : une fois pour chaque résultat de nom unique renvoyé par la phase 1.
Par exemple, si la phase renvoie 12345 pour la valeur d’ID unique, cette partie équivaut exactement à la suivante :
... (phase=2 subtree="uid=12345,o=Democorp,c=AU" ...