Usar orígenes de datos personalizados

Last published : Oct 02, 2026
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:
  1. Agregar un tipo de origen de datos(#add-a-data-source-type).
  2. Agregar esquema de recopilación bajo el tipo de origen de datos(#add-a-collection-schema-under-data-source-type).
  3. Agregar un origen de datos(#add-a-data-source).
  4. 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.
  1. En Aplicaciones > Configuración > Orígenes de datos.
  2. Seleccione Tipo de origen de datos y haga clic en Agregar.
  3. Especifique el Nombre y la Descripción del tipo de origen de datos.
  4. 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.
Tipo de origen de datos
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**.
  1. Haga clic en Agregar.
  2. Especifique el Nombre de la recopilación para un esquema de recopilación.
  3. Introduzca la Descripción.
  4. Agregue atributos (nombre y su tipo) en Detalles del atributo según sea necesario.
  5. Haga clic en Crear.
Tipo de recopilación
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.
  1. Vaya a Aplicaciones > Configuración > Orígenes de datos.
  2. Seleccione la ficha Orígenes de datos y haga clic en Agregar.
  3. Especifique el Nombre.
  4. Seleccione el Tipo de origen de datos e introduzca la Descripción.
  5. 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.
Origen de datos personalizado
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.
  1. Seleccione el Esquema de recopilación al que desea añadir datos de recopilación.
  2. Haga clic en Administrar datos de recopilación.
  3. 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.
  4. Haga clic en Aceptar.
Recopilaciones

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.
Origen de datos personalizado sin recopilació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.