Conditions des paramètres
Les conditions de paramètres sont utilisées pour modifier le comportement de certains paramètres dans la définition StyleBook. Les paramètres d’une définition StyleBook sont les entrées fournies pour créer un pack de configuration. Utilisez paramètres-conditions pour définir une condition de paramètre dans la définition.
Un paramètre peut avoir de nombreuses contraintes dans la définition StyleBook. Les conditions de paramètre sont utilisées pour résoudre les conflits lorsqu’un utilisateur modifie le comportement du paramètre. Par exemple, lorsqu’un utilisateur sélectionne le protocole SSL, les détails du certificat sont requis pour créer un pack de configuration. Cependant, les détails du certificat peuvent ne pas être définis comme le champ obligatoire au début.
La condition de paramètre possède les attributs suivants :
-
cible: Spécifiez le paramètre cible auquel vous souhaitez appliquer une action. Vous pouvez spécifier plusieurs paramètres cibles. -
action: Spécifiez l’action à entreprendre sur les paramètres cibles. Les conditions de paramètre prennent en charge les actions suivantes :- Augmenter les valeurs autorisées
- Afficher ou masquer les paramètres
- Définir une valeur par défaut
- Définir comme champ obligatoire
- Définir les valeurs autorisées
- Définir l’étiquette du paramètre
- Définir la description du paramètre
- Réduire ou développer le volet des paramètres
- Définir le modèle du paramètre
-
condition: Facultatif, spécifiez une condition pour appliquer une action pour les paramètres cibles spécifiés. Si vous ne spécifiez pas de condition, l’action est directement appliquée sur les paramètres cibles. -
valeur: Définissez les valeurs de l’attribut des paramètres cibles en fonction de l’action.
Note:
Actuellement, les conditions de paramètre ne peuvent pas être appliquées aux paramètres dans les objets de liste.
« augmenter-les-valeurs-autorisées »
Lorsque l’action est augment-allowed-values, le paramètre cible apparaît sous forme de menu déroulant dans l’interface graphique. Le menu déroulant est défini avec les valeurs définies dans l’attribut value de la définition StyleBook.
Exemple:
paramètres-conditions :
-
cible : $parameters.rewritepolicy.action
action : augment-allowed-values
valeur : $parameters.rewriteaction
<!--NeedCopy-->
« afficher » ou « masquer »
Lorsque l’action est afficher et que la condition spécifiée renvoie True, le paramètre cible apparaît sur l’interface graphique.
Lorsque l’action est masquer et que la condition spécifiée renvoie Vrai, le paramètre cible disparaît de l’interface graphique.
Exemple:
paramètres-conditions :
-
cible : $parameters.security-settings.cert-details
action : afficher
condition : $parameters.protocole dans ["SSL", "SSL-BRIDGE"]
<!--NeedCopy-->
Au début, les détails du certificat sont masqués pour le paramètre security-settings . Lorsqu’un utilisateur sélectionne les protocoles SSL ou SSL-Bridge, les détails du certificat s’affichent.
‘définir par défaut’
Lorsque l’action est set-default et que la condition spécifiée renvoie True, la valeur du paramètre cible est définie sur la valeur par défaut.
Exemple 1:
paramètres-conditions :
-
cible : $parameters.port
action : set-default
condition : $parameters.protocol == "SSL"
valeur : 443
-
cible : $parameters.port
action : set-default
condition : $parameters.protocol != "SSL"
valeur : 80
<!--NeedCopy-->
Exemple 2:
paramètres-conditions :
-
cible : $parameters.port
action : set-default
valeur : if-then-else($parameters.protocol == "SSL", 443, 80)
<!--NeedCopy-->
Lorsqu’un utilisateur sélectionne le protocole SSL , la valeur du port par défaut est définie sur 443. Pour les autres protocoles, la valeur du port par défaut est définie sur 80. Les exemples 1 et 2 vous donnent le même résultat.
« définir-requis »
Lorsque l’action est set-required et que la condition spécifiée renvoie True, le paramètre cible devient un champ obligatoire pour créer un pack de configuration.
paramètres-conditions :
-
cible : $parameters.security-settings.cert-details
action : set-required
condition : $parameters.protocol dans ["SSL", "SSL-BRIDGE"]
<!--NeedCopy-->
Au début, les détails du certificat peuvent ne pas être requis pour le paramètre security-settings . Lorsqu’un utilisateur sélectionne les protocoles SSL ou SSL-Bridge , les détails du certificat deviennent un champ obligatoire pour créer un pack de configuration.
‘définir-les-valeurs-autorisées’
Lorsque l’action est set-allowed-values et que la condition spécifiée renvoie True, le paramètre target vous permet de sélectionner uniquement les valeurs spécifiées.
Exemple:
paramètres-conditions :
-
cible : $parameters.app-name
action : set-allowed-values
valeur :
- "SSL"
condition : $parameters.lb-virtual-port == 443
<!--NeedCopy-->
Lorsqu’un utilisateur spécifie 443 comme port virtuel d’équilibrage de charge, le nom de l’application n’autorise que l’option SSL .
‘étiquette définie’
Lorsque l’action est set-label et que la condition spécifiée renvoie True, l’étiquette du paramètre cible change en texte spécifié.
Exemple:
paramètres-conditions :
-
cible : $parameters.app-name
action : set-label
valeur : if-then-else($parameters.lb-service-type == "TCP", "TCPApp","UDPApp")
<!--NeedCopy-->
Lorsqu’un utilisateur sélectionne le protocole d’équilibrage de charge comme TCP, l’étiquette de l’application passe à TCPApp. Si l’utilisateur sélectionne une option différente, l’étiquette de l’application passe à UDPApp.
‘description de l’ensemble’
Lorsque l’action est set-description et que la condition spécifiée renvoie True, la description du paramètre cible change en texte spécifié. Cette description apparaît dans l’info-bulle d’un paramètre cible.
Exemple:
paramètres-conditions :
-
cible : $parameters.app-name
action : set-description
valeur : if-then-else($parameters.lb-service-type == "TCP", "Sélectionnez un nom d'application TCP","Sélectionnez un nom d'application UDP")
<!--NeedCopy-->
Lorsqu’un utilisateur sélectionne le protocole d’équilibrage de charge comme TCP, l’info-bulle de l’application affiche un texte : Sélectionnez un nom d'application TCP. Si l’utilisateur sélectionne une option différente, la description de l’application affiche Sélectionnez un nom d'application UDP.
« réduire le volet » ou « développer le volet »
Lorsque l’action est collapse-pane et que la condition spécifiée renvoie True, le volet du paramètre cible se réduit dans l’interface graphique.
Lorsque l’action est expand-pane et que la condition spécifiée renvoie True, le volet du paramètre cible s’agrandit dans l’interface graphique.
Exemple:
paramètres-conditions :
-
cible : $parameters.security-settings.cert-details
action : développer le volet
condition : $parameters.protocole dans ["SSL", "SSL-BRIDGE"]
<!--NeedCopy-->
Au début, le volet des détails du certificat peut ne pas être développé pour le paramètre security-settings . Lorsqu’un utilisateur sélectionne les protocoles SSL ou SSL-Bridge , le volet des détails du certificat se développe sur l’interface graphique.
« modèle défini »
Lorsque l’action est set-pattern et que la condition spécifiée renvoie True, le champ de paramètre cible est défini sur le modèle spécifié.
Exemple:
paramètres-conditions :
-
cible : $parameters.app-name
action : set-pattern
valeur : « [az]+ »
<!--NeedCopy-->
Dans cet exemple, le nom de l’application n’autorise que les caractères alphabétiques minuscules.
Conditions de paramètres imbriqués
Dans une définition StyleBook, vous pouvez spécifier une condition de paramètre dans une condition de paramètre. Ces conditions sont appelées conditions de paramètres imbriqués et utilisent une construction de répétition pour définir ces conditions. Les conditions de paramètres imbriqués sont utiles lorsque vous souhaitez appliquer une action pour un paramètre à partir d’un autre paramètre.
Exemple:
paramètres-conditions :
-
répétition : $parameters.lbvservers
répétition-élément : lbvserver
paramètres-conditions :
-
cible : $lbvserver.port
action : définir les valeurs autorisées
condition : $lbvserver.protocol == "HTTPS"
valeur : $parameters.ssl-ports
<!--NeedCopy-->
Dans cet exemple, lorsque l’utilisateur sélectionne le protocole HTTPS pour un serveur virtuel d’équilibrage de charge, les valeurs de port sont renseignées de manière dynamique. Et cela s’applique à chaque serveur virtuel d’équilibrage de charge dans la liste.