Usar orígenes de datos personalizados
Además de las (/es-es/netscaler-console-service/stylebooks/manage-data-sources/built-in-datasource.html), puede definir y usar orígenes de datos personalizados si los datos de entrada se utilizan repetidamente para crear varias configuraciones. Puede guardar los datos de entrada en NetScaler Console como origen de datos. Y puede modificar StyleBooks para consumir estos datos sin necesidad de que los usuarios de StyleBook proporcionen entradas repetidamente.
Antes de usar un origen de datos personalizado en la definición de su StyleBook, haga lo siguiente para definir un origen de datos personalizado:
-
Agregar un tipo de origen de datos(#add-a-data-source-type).
-
Agregar esquema de recopilación bajo el tipo de origen de datos(#add-a-collection-schema-under-data-source-type).
-
Agregar un origen de datos(#add-a-data-source).
-
Agregar datos de recopilación(#add-a-collection-data).
Después de agregar un origen de datos, puede usarlo en la definición de StyleBook. Para obtener más información, consulte Uso de orígenes de datos personalizados en la definición de StyleBook.
Agregar un tipo de origen de datos
Especifique un tipo de origen de datos para distinguir el origen del que se recuperan los datos.
-
En Aplicaciones > Configuración > Orígenes de datos.
-
Seleccione Tipo de origen de datos y haga clic en Agregar.
-
Especifique el Nombre y la Descripción del tipo de origen de datos.
-
Haga clic en Continuar para guardar el Tipo de origen de datos. Haga clic en Cerrar para salir del flujo de trabajo sin guardar ningún cambio.
En este ejemplo, el tipo de origen de datos se establece en Entorno. Este tipo se puede utilizar para definir los entornos de aplicación como orígenes de datos.
Agregar un esquema de recopilación en el tipo de origen de datos
Después de agregar Tipo de origen de datos, se muestra una pantalla para agregar Esquemas de recopilación para ""Tipo de origen de datos**.
-
Haga clic en Agregar.
-
Especifique el Nombre de la recopilación para un esquema de recopilación.
-
Introduzca la Descripción.
-
Agregue atributos (nombre y su tipo) en Detalles del atributo según sea necesario.
-
Haga clic en Crear.
En este ejemplo, el esquema de recopilación App-virtual-servers tiene cuatro atributos. Por lo tanto, la recopilación que desea almacenar debe tener estos atributos de los tipos de datos establecidos.
Agregar un origen de datos
Defina un origen de datos para un tipo de origen de datos específico.
-
Vaya a Aplicaciones > Configuración > Orígenes de datos.
-
Seleccione la ficha Orígenes de datos y haga clic en Agregar.
-
Especifique el Nombre.
-
Seleccione el Tipo de origen de datos e introduzca la Descripción.
-
Haga clic en Continuar para guardar el Origen de datos. Haga clic en Cerrar para salir del flujo de trabajo sin guardar ningún cambio.
En este ejemplo, el entorno de producción se añade como origen de datos.
Añadir datos de recopilación
Después de añadir el Origen de datos, se muestra una pantalla para introducir los datos del Origen de datos. Puede ver una lista de Esquemas de recopilación.
-
Seleccione el Esquema de recopilación al que desea añadir datos de recopilación.
-
Haga clic en Administrar datos de recopilación.
-
Añada datos a la recopilación. Puede añadir datos uno por uno o cargar un archivo CSV. Al cargar un archivo CSV, asegúrese de que los nombres de las columnas coincidan con los nombres de los atributos del esquema de recopilación.
-
Haga clic en Aceptar.
Usar origen de datos personalizado sin recopilación
La siguiente sección
parameters explica cómo definir un origen de datos personalizado en la definición de StyleBook sin recopilación.
parameters:
- name: selected-environment
label: Select a custom datasource environment
type: datum
required: true
data-source:
type: "Environment"
La GUI del paquete de configuración muestra los orígenes de datos aplicables y los usuarios de StyleBook pueden seleccionar cualquiera de ellos para crear un paquete de configuración.
En este ejemplo, utiliza la fuente de datos
Production para recuperar datos.
En el tipo de fuente de datos
Environment, para acceder al tipo de colección App-virtual-servers, utilice la siguiente expresión:
$parameters.selected-environment.collections.App-virtual-servers
Fragmento de ejemplo:
components:
-
name: lbvserver-comp
type: ns::lbvserver
repeat: $parameters.selected-environment.collections.App-virtual-servers
repeat-item: app
properties:
name: $app.attributes.Name + "-lb"
ipv46: ip($app.attributes.IPv46 )
port: $app.attributes.Port
servicetype: $app.attributes.Protocol
components:
-
name: servicegroup-comp
type: ns::servicegroup
properties:
servicegroupname: $parent.properties.name + "-svcgrp"
servicetype: $parent.properties.servicetype
components:
-
name: lbvserver-svg-binding
type: ns::lbvserver_servicegroup_binding
properties:
name: $parent.parent.properties.name
servicegroupname: $parent.properties.servicegroupname
Usar fuentes de datos personalizadas con la colección
La siguiente sección
parameters explica cómo definir una fuente de datos personalizada en la definición de StyleBook. Permite a los usuarios de StyleBook seleccionar un elemento específico de una colección.
parameters:
- name: selected-app-vserver
label: Select a collection from the datasource
type: datum
required: true
data-source:
type: Environment
collection: App-virtual-servers
En este ejemplo, el parámetro
datum se utiliza para definir la fuente de datos personalizada. Utiliza la fuente de datos Production para recuperar datos del esquema de colección App-virtual-servers.
En el tipo de fuente de datos
Environment, para acceder al protocolo de la colección App-virtual-servers, utilice la siguiente expresión:
$parameters.selected-app-vserver.attributes.Protocol
Fragmento de ejemplo:
components:
- name: lbvserver-comp
type: ns::lbvserver
properties:
name: $parameters.selected-app-vserver.attributes.Name
ipv46: $parameters.selected-app-vserver.attributes.IPv46
port: $parameters.selected-app-vserver.attributes.Port
servicetype: $parameters.selected-app-vserver.attributes.Protocol
Cuando se define un tipo de colección en la sección
parameters, los usuarios de StyleBook pueden seleccionar la fuente de datos y la colección.
Seleccionar varios elementos de una colección:
La siguiente sección de parámetros permite a los usuarios de StyleBook seleccionar varios elementos de una colección.
parameters:
- name: selected-app-vservers
label: Select app-vservers from the collection
type: datum[]
required: true
data-source:
type: Environment
collection: App-virtual-servers
En este ejemplo, el parámetro datum se utiliza para definir la matriz de fuentes de datos personalizadas. El usuario puede seleccionar uno o varios elementos de la colección 'App-virtual-servers' de una única fuente de datos o de varias fuentes de datos.
El fragmento de código siguiente muestra la forma de acceder a los elementos seleccionados y sus atributos.
components:
-
name: lbvserver-comp
type: ns::lbvserver
repeat:
repeat-list: $parameters.selected-app-vservers
repeat-item: vserverObj
properties:
name: $vserverObj.attributes.Name
ipv46: $vserverObj.attributes.IPv46
port: $vserverObj.attributes.Port
servicetype: $vserverObj.attributes.Protocol
Filtrado de datos de colección:
La siguiente sección de parámetros explica cómo especificar filtros en una colección de fuentes de datos personalizadas en la definición de StyleBook. Permite a los usuarios de StyleBook seleccionar un elemento específico de una colección filtrada.
parameters:
- name: selected-app-vserver
label: Select a collection from the datasource
type: datum
required: true
data-source:
type: Environment
collection: App-virtual-servers
collection-filters:
Protocol: SSL
En este ejemplo, el parámetro datum se utiliza para definir el origen de datos personalizado. Utiliza el origen de datos de tipo Entorno para recuperar datos filtrados del esquema de recopilación App-virtual-servers.
Después de que el usuario de StyleBook selecciona un servidor virtual, se puede acceder a cualquier atributo del elemento seleccionado de la misma manera que se explicó en la sección anterior.