Benutzerdefinierte Datenquellen verwenden

Last published : Oct 02, 2026
Neben verwalteten NetScaler-Instanzen als Datenquelle können Sie benutzerdefinierte Datenquellen definieren und verwenden, wenn die Eingabedaten wiederholt zum Erstellen mehrerer Konfigurationen verwendet werden. Sie können die Eingabedaten in NetScaler Console als Datenquelle speichern. Und Sie können StyleBooks so ändern, dass sie diese Daten nutzen, ohne dass StyleBook-Benutzer wiederholt Eingaben machen müssen.
Bevor Sie eine benutzerdefinierte Datenquelle in Ihrer StyleBook-Definition verwenden, gehen Sie wie folgt vor, um eine benutzerdefinierte Datenquelle zu definieren:
Nach dem Hinzufügen einer Datenquelle können Sie diese Datenquelle in der StyleBook-Definition verwenden. Weitere Informationen finden Sie unter Benutzerdefinierte Datenquellen in der StyleBook-Definition verwenden.

Einen Datenquellentyp hinzufügen

Geben Sie einen Datenquellentyp an, um die Quelle zu unterscheiden, aus der Daten abgerufen werden.
  1. Unter Applications > Configuration > Data Sources.
  2. Wählen Sie Data Source Type aus und klicken Sie auf Add.
  3. Geben Sie den Namen und die Beschreibung für den Datenquellentyp an.
  4. Klicken Sie auf Proceed, um den Data Source Type zu speichern. Klicken Sie auf Close, um den Workflow ohne Speichern von Änderungen zu beenden.
Datenquellentyp
In diesem Beispiel ist der Datentyp der Datenquelle auf Umgebung festgelegt. Dieser Typ kann verwendet werden, um die Anwendungsumgebungen als Datenquellen zu definieren.

Sammlungsschema unter Datentyp der Datenquelle hinzufügen

Nach dem Hinzufügen des Datentyps der Datenquelle wird ein Bildschirm zur Ergänzung von Sammlungsschemata für ""Datentyp der Datenquelle** angezeigt.
  1. Klicken Sie auf Hinzufügen.
  2. Geben Sie den Sammlungsnamen für ein Sammlungsschema an.
  3. Geben Sie die Beschreibung ein.
  4. Fügen Sie bei Bedarf Attribute (Name und Typ) unter Attributdetails hinzu.
  5. Klicken Sie auf Erstellen.
Sammlungstyp
In diesem Beispiel hat das Sammlungsschema App-virtual-servers vier Attribute. Die Sammlung, die Sie speichern möchten, muss daher diese Attribute der festgelegten Datentypen aufweisen.

Datenquelle hinzufügen

Definieren Sie eine Datenquelle für einen bestimmten Datentyp der Datenquelle.
  1. Gehen Sie zu Anwendungen > Konfiguration > Datenquellen.
  2. Wählen Sie die Registerkarte Datenquellen aus und klicken Sie auf Hinzufügen.
  3. Geben Sie den Namen an.
  4. Wählen Sie den Datenquellentyp aus, und geben Sie die Beschreibung ein.
  5. Klicken Sie auf Weiter, um die Datenquelle zu speichern. Klicken Sie auf Schließen, um den Workflow zu beenden, ohne Änderungen zu speichern.
Benutzerdefinierte Datenquelle
In diesem Beispiel wird die Produktionsumgebung als Datenquelle hinzugefügt.

Sammlungsdaten hinzufügen

Nach dem Hinzufügen der Datenquelle wird ein Bildschirm zur Eingabe der Daten für die Datenquelle angezeigt. Sie sehen eine Liste der Sammlungsschemata.
  1. Wählen Sie das Sammlungsschema aus, dem Sie Sammlungsdaten hinzufügen möchten.
  2. Klicken Sie auf Sammlungsdaten verwalten.
  3. Fügen Sie Daten zur Sammlung hinzu. Sie können Daten einzeln hinzufügen oder eine CSV-Datei hochladen. Wenn Sie eine CSV-Datei hochladen, stellen Sie sicher, dass die Spaltennamen mit den Attributnamen des Sammlungsschemas übereinstimmen.
  4. Klicken Sie auf OK.
Sammlungen

Benutzerdefinierte Datenquelle ohne Sammlung verwenden

Der folgende parameters Abschnitt erklärt, wie eine benutzerdefinierte Datenquelle in der StyleBook-Definition ohne Sammlung definiert wird.
parameters:
    - name: selected-environment
      label: Select a custom datasource environment
      type: datum
      required: true
      data-source:
        type: "Environment"
Die GUI des Konfigurationspakets zeigt die anwendbaren Datenquellen an, und StyleBook-Benutzer können eine davon auswählen, um ein Konfigurationspaket zu erstellen.
Benutzerdefinierte Datenquelle ohne Sammlung
In diesem Beispiel wird die Production Datenquelle verwendet, um Daten abzurufen.
Im Environment Datenquellentyp verwenden Sie den folgenden Ausdruck, um auf den App-virtual-servers Sammlungstyp zuzugreifen:
$parameters.selected-environment.collections.App-virtual-servers
Beispiel-Snippet:
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

Benutzerdefinierte Datenquellen mit Sammlung verwenden

Der folgende parameters Abschnitt erklärt, wie eine benutzerdefinierte Datenquelle in der StyleBook-Definition definiert wird. Er ermöglicht StyleBook-Benutzern, ein bestimmtes Element einer Sammlung auszuwählen.
parameters:
  - name: selected-app-vserver
    label: Select a collection from the datasource
    type: datum
    required: true
    data-source:
      type: Environment
      collection: App-virtual-servers
In diesem Beispiel wird der datum Parameter verwendet, um die benutzerdefinierte Datenquelle zu definieren. Er verwendet die Production Datenquelle, um Daten aus dem App-virtual-servers Sammlungsschema abzurufen.
Im Environment Datenquellentyp verwenden Sie den folgenden Ausdruck, um auf das Protokoll aus der App-virtual-servers Sammlung zuzugreifen:
$parameters.selected-app-vserver.attributes.Protocol
Beispiel-Snippet:
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
Wenn Sie einen Sammlungstyp im parameters Abschnitt definieren, können die StyleBook-Benutzer die Datenquelle und die Sammlung auswählen.
Auswählen mehrerer Elemente aus einer Sammlung:
Der folgende Parameterabschnitt ermöglicht StyleBook-Benutzern, mehrere Elemente einer Sammlung auszuwählen.
parameters:
  - name: selected-app-vservers
    label: Select app-vservers from the collection
    type: datum[]
    required: true
    data-source:
      type: Environment
      collection: App-virtual-servers
In diesem Beispiel wird der Datumsparameter verwendet, um das benutzerdefinierte Datenquellen-Array zu definieren. Der Benutzer kann ein oder mehrere Elemente aus der Sammlung „App-virtual-servers“ aus einer einzelnen Datenquelle oder über mehrere Datenquellen hinweg auswählen.
Das folgende Code-Snippet zeigt, wie ausgewählte Elemente und ihre Attribute abgerufen werden.
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
Sammlungsdaten filtern:
Der folgende Parameterabschnitt erklärt, wie Filter für eine benutzerdefinierte Datenquellensammlung in der StyleBook-Definition angegeben werden. Er ermöglicht StyleBook-Benutzern, ein bestimmtes Element aus einer gefilterten Sammlung auszuwählen.
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
In diesem Beispiel wird der Datumsparameter verwendet, um die benutzerdefinierte Datenquelle zu definieren. Sie verwendet die Datenquelle vom Typ Umgebung, um gefilterte Daten aus dem App-virtual-servers-Sammlungsschema abzurufen.
Nachdem der StyleBook-Benutzer einen virtuellen Server ausgewählt hat, kann jedes Attribut des ausgewählten Elements auf die gleiche Weise aufgerufen werden, wie im vorherigen Abschnitt erläutert.