Utiliser des sources de données personnalisées
En plus des instances NetScaler gérées comme source de données, vous pouvez définir et utiliser des sources de données personnalisées si les données d’entrée sont utilisées à plusieurs reprises pour créer plusieurs configurations. Vous pouvez enregistrer les données d’entrée dans la console NetScaler en tant que source de données. Et vous pouvez modifier les StyleBooks pour consommer ces données sans demander aux utilisateurs de StyleBook de fournir des entrées à plusieurs reprises.
Avant d’utiliser une source de données personnalisée dans votre définition StyleBook, procédez comme suit pour définir une source de données personnalisée :
Après avoir ajouté une source de données, vous pouvez utiliser cette source de données dans la définition StyleBook. Pour plus d’informations, voir Utiliser des sources de données personnalisées dans la définition StyleBook.
Ajouter un type de source de données
Spécifiez un type de source de données pour distinguer la source à partir de laquelle les données sont récupérées.
-
Dans Applications > Configuration > Sources de données.
-
Sélectionnez Type de source de données et cliquez sur Ajouter.
-
Spécifiez le Nom et la Description pour le type de source de données.
-
Cliquez sur Continuer pour enregistrer le Type de source de données. Cliquez sur Fermer pour quitter le flux de travail sans enregistrer les modifications.
Dans cet exemple, le type de source de données est défini sur Environnement. Ce type peut être utilisé pour définir les environnements d’application comme sources de données.
Ajouter un schéma de collection sous le type de source de données
Après avoir ajouté Type de source de données, un écran permettant d’ajouter Schémas de collection pour ““Type de source de données**” s’affiche.
-
Cliquez sur Ajouter.
-
Spécifiez le nom de collection ** pour un schéma de collection.
-
Entrez la Description.
-
Ajoutez des attributs (nom et son type) sous Détails d’attribut selon les besoins.
-
Cliquez sur Créer.
Dans cet exemple, le schéma de collection App-virtual-servers possède quatre attributs. Ainsi, la collection que vous souhaitez stocker doit avoir ces attributs des types de données définis.
Ajouter une source de données
Définissez une source de données pour un type de source de données spécifique.
-
Accédez à Applications > Configuration > Sources de données.
-
Sélectionnez l’onglet Sources de données et cliquez sur Ajouter.
-
Spécifiez le Nom.
-
Sélectionnez le type de source de données **et entrez la description**.
-
Cliquez sur Continuer pour enregistrer la Source de données. Cliquez sur Fermer pour quitter le flux de travail sans enregistrer les modifications.
Dans cet exemple, l’environnement de production ** est ajouté comme source de données.
Ajouter une collection de données
Après avoir ajouté Source de données, un écran permettant de saisir les données pour Source de données s’affiche. Vous pouvez voir une liste de Schémas de collection.
-
Sélectionnez le schéma de collection ** auquel vous souhaitez ajouter des données de collections.
-
Cliquez sur Gérer les données de collection.
-
Ajouter des données à la collection. Vous pouvez soit ajouter des données une par une, soit télécharger un fichier CSV. Lorsque vous téléchargez un fichier CSV, assurez-vous que les noms de colonnes correspondent aux noms d’attributs du schéma de collection.
-
Cliquez sur OK.
Utiliser une source de données personnalisée sans collection
La section paramètres suivante explique comment définir une source de données personnalisée dans la définition StyleBook sans collection.
paramètres :
- nom : environnement sélectionné
étiquette : sélectionner un environnement de source de données personnalisé
type : datum
requis : vrai
source de données :
type : « Environnement »
<!--NeedCopy-->
L’interface graphique du pack de configuration affiche les sources de données applicables et les utilisateurs de StyleBook peuvent sélectionner l’une d’entre elles pour créer un pack de configuration.
Dans cet exemple, il utilise la source de données Production pour récupérer les données.
Dans le type de source de données Environment , pour accéder au type de collection App-virtual-servers , utilisez l’expression suivante :
$parameters.selected-environment.collections.App-virtual-servers
<!--NeedCopy-->
Exemple d’extrait:
composants :
-
nom : lbvserver-comp
type : ns::lbvserver
répétition : $parameters.selected-environment.collections.App-virtual-servers
élément de répétition : app
propriétés :
nom : $app.attributes.Name + "-lb"
ipv46 : ip($app.attributes.IPv46 )
port : $app.attributes.Port
type de service : $app.attributes.Protocol
composants :
-
nom : servicegroup-comp
type : ns::servicegroup
propriétés :
nom du groupe de services : $parent.properties.name + "-svcgrp"
type de service : $parent.properties.servicetype
composants :
-
nom : lbvserver-svg-binding
type : ns::lbvserver_servicegroup_binding
propriétés :
nom : $parent.parent.properties.name
nom du groupe de services : $parent.properties.nom du groupe de services
<!--NeedCopy-->
Utiliser des sources de données personnalisées avec la collection
La section paramètres suivante explique comment définir une source de données personnalisée dans la définition StyleBook. Il permet aux utilisateurs de StyleBook de sélectionner un élément spécifique d’une collection.
paramètres :
- nom : selected-app-vserver
étiquette : sélectionner une collection à partir de la source de données
type : datum
requis : true
source de données :
type : environnement
collection : App-virtual-servers
<!--NeedCopy-->
Dans cet exemple, le paramètre datum est utilisé pour définir la source de données personnalisée. Il utilise la source de données Production pour récupérer les données du schéma de collection App-virtual-servers .
Dans le type de source de données Environment , pour accéder au protocole à partir de la collection App-virtual-servers , utilisez l’expression suivante :
$parameters.selected-app-vserver.attributes.Protocol
<!--NeedCopy-->
Extrait d’exemple:
composants :
- nom : lbvserver-comp
type : ns::lbvserver
propriétés :
nom : $parameters.selected-app-vserver.attributes.Name
ipv46 : $parameters.selected-app-vserver.attributes.IPv46
port : $parameters.selected-app-vserver.attributes.Port
type de service : $parameters.selected-app-vserver.attributes.Protocol
<!--NeedCopy-->
Lorsque vous définissez un type de collection dans la section paramètres , les utilisateurs de StyleBook peuvent sélectionner la source de données et la collection.
Sélection de plusieurs éléments d’une collection :
La section des paramètres suivante permet aux utilisateurs de StyleBook de sélectionner plusieurs éléments d’une collection.
paramètres :
- nom : selected-app-vservers
étiquette : sélectionner app-vservers dans la collection
type : datum[]
requis : true
source de données :
type : environnement
collection : App-virtual-servers
<!--NeedCopy-->
Dans cet exemple, le paramètre datum est utilisé pour définir le tableau de sources de données personnalisé. L’utilisateur peut sélectionner un ou plusieurs éléments de la collection « App-virtual-servers » à partir d’une seule source de données ou de plusieurs sources de données.
L’extrait de code ci-dessous décrit la manière d’accéder aux éléments sélectionnés et à leurs attributs.
composants :
-
nom : lbvserver-comp
type : ns::lbvserver
répétition :
liste-de-répétitions : $parameters.selected-app-vservers
élément-de-répétition : vserverObj
propriétés :
nom : $vserverObj.attributes.Name
ipv46 : $vserverObj.attributes.IPv46
port : $vserverObj.attributes.Port
type-de-service : $vserverObj.attributes.Protocol
<!--NeedCopy-->
Filtrage des données de la collection :
La section des paramètres suivante explique comment spécifier des filtres sur une collection de sources de données personnalisées dans la définition StyleBook. Il permet aux utilisateurs de StyleBook de sélectionner un élément spécifique dans une collection filtrée.
paramètres :
- nom : selected-app-vserver
étiquette : sélectionner une collection à partir de la source de données
type : datum
requis : true
source de données :
type : environnement
collection : App-virtual-servers
filtres de collection :
Protocole : SSL
<!--NeedCopy-->
Dans cet exemple, le paramètre datum est utilisé pour définir la source de données personnalisée. Il utilise la source de données de type Environnement pour récupérer les données filtrées du schéma de collection App-virtual-servers.
Une fois que l’utilisateur StyleBook a sélectionné un serveur virtuel, tout attribut de l’élément sélectionné est accessible de la même manière que celle expliquée dans la section précédente.