カスタムデータソースを使用する

データ ソース の管理対象 NetScaler インスタンスに加えて、入力データが複数の構成の作成に繰り返し使用される場合は、カスタム データ ソースを定義して使用できます。 NetScaler コンソールの入力データをデータ ソースとして保存できます。 また、StyleBook ユーザーが繰り返し入力する必要なく、このデータを使用できるように StyleBook を変更することもできます。

StyleBook 定義でカスタム データ ソースを使用する前に、次の操作を行ってカスタム データ ソースを定義します。

  1. データ ソース タイプを追加します。

  2. データ ソース タイプの下にコレクション スキーマを追加します。

  3. データ ソースを追加します。

  4. コレクションデータを追加します。

データ ソースを追加したら、そのデータ ソースを StyleBook 定義で使用できます。 詳細については、 StyleBook 定義のカスタム データ ソースの使用を参照してください。

データソースの種類を追加する

データの取得元を区別するために、データ ソース タイプを指定します。

  1. アプリケーション > 構成 > データ ソースで。

  2. データ ソース タイプ を選択し、 追加をクリックします。

  3. データ ソース タイプの 名前 と 説明 を指定します。

  4. 続行 をクリックして、 データ ソース タイプを保存します。 変更を保存せずにワークフローを終了するには、[ 閉じる ] をクリックします。

データソースの種類

この例では、データ ソース タイプは 環境に設定されています。 このタイプは、アプリケーション環境をデータ ソースとして定義するために使用できます。

データソースタイプにコレクションスキーマを追加する

データ ソース タイプを追加した後、”“データ ソース タイプのコレクション スキーマ** を追加する画面が表示されます。

  1. 追加をクリックします。

  2. コレクション スキーマの コレクション名 を指定します。

  3. 説明を入力します。

  4. 必要に応じて、 属性の詳細 の下に属性 (名前とそのタイプ) を追加します。

  5. 作成をクリックします。

コレクションタイプ

この例では、 App-virtual-servers コレクション スキーマには 4 つの属性があります。 したがって、保存するコレクションには、設定されたデータ型のこれらの属性が必要です。

データソースを追加する

特定のデータ ソース タイプに対してデータ ソースを定義します。

  1. アプリケーション > 構成 > データ ソースに移動します。

  2. タブ データ ソース を選択し、 追加をクリックします。

  3. 名前を指定します。

  4. データ ソース タイプを選択し、 説明を入力します。

  5. 続行 をクリックして、 データ ソースを保存します。 変更を保存せずにワークフローを終了するには、[ 閉じる ] をクリックします。

カスタムデータソース

この例では、 実稼働環境 がデータ ソースとして追加されます。

コレクションデータを追加する

データソースを追加した後、 データソース のデータを入力する画面が表示されます。 コレクション スキーマのリストを表示できます。

  1. コレクション データを追加する コレクション スキーマ を選択します。

  2. コレクションデータの管理をクリックします。

  3. コレクションにデータを追加します。 データを1つずつ追加するか、CSV ファイルをアップロードすることができます。 CSV ファイルをアップロードするときは、列名がコレクション スキーマの属性名と一致していることを確認してください。

  4. OKをクリックします。

コレクション

コレクションなしでカスタムデータソースを使用する

次の パラメータ セクションでは、コレクションなしで StyleBook 定義でカスタム データ ソースを定義する方法について説明します。

パラメータ:
    -  名前: selected-environment
      ラベル: カスタムデータソース環境を選択
      タイプ: datum
      必須: true
      データソース:
        タイプ: "Environment"
<!--NeedCopy-->

構成パックの GUI には適用可能なデータ ソースが表示され、StyleBook ユーザーはそのいずれかを選択して構成パックを作成できます。

コレクションなしのカスタムデータソース

この例では、 Production データ ソースを使用してデータを取得します。

環境 データ ソース タイプで、 アプリ仮想サーバー コレクション タイプにアクセスするには、次の式を使用します。

$parameters.selected-environment.collections.App-virtual-servers
<!--NeedCopy-->

例スニペット:

コンポーネント:
  -
    名前: lbvserver-comp
    タイプ: ns::lbvserver
    繰り返し: $parameters.selected-environment.collections.App-virtual-servers
    繰り返し項目: app
    プロパティ:
      名前: $app.attributes.Name + "-lb"
      ipv46: ip($app.attributes.IPv46 )
      ポート: $app.attributes.Port
      サービスタイプ: $app.attributes.Protocol
    コンポーネント:

      -
        名前: servicegroup-comp
        タイプ: ns::servicegroup
        プロパティ:
          サービスグループ名: $parent.properties.name + "-svcgrp"
          サービスタイプ: $parent.properties.servicetype

        コンポーネント:
          -
            名前: lbvserver-svg-binding
            タイプ: ns::lbvserver_servicegroup_binding
            プロパティ:
              名前: $parent.parent.properties.name
              サービスグループ名: $parent.properties.servicegroupname
<!--NeedCopy-->

コレクションでカスタムデータソースを使用する

次の パラメータ セクションでは、StyleBook 定義でカスタム データ ソースを定義する方法について説明します。 これにより、StyleBook ユーザーはコレクションの特定のアイテムを選択できるようになります。

パラメータ:
  -  名前: selected-app-vserver
    ラベル: データソースからコレクションを選択します
    タイプ: datum
    必須: true
    データソース:
      タイプ: 環境
      コレクション: App-virtual-servers
<!--NeedCopy-->

この例では、 データ パラメータを使用してカスタム データ ソースを定義します。 これは、 Production データ ソースを使用して、 App-virtual-servers コレクション スキーマからデータを取得します。

環境 データ ソース タイプで、 アプリ仮想サーバー コレクションからプロトコルにアクセスするには、次の式を使用します。

$parameters.selected-app-vserver.attributes.プロトコル
<!--NeedCopy-->

例スニペット:

コンポーネント:
  -  名前: lbvserver-comp
    タイプ: ns::lbvserver
    プロパティ:
      名前: $parameters.selected-app-vserver.attributes.Name
      ipv46: $parameters.selected-app-vserver.attributes.IPv46
      ポート: $parameters.selected-app-vserver.attributes.Port
      サービスタイプ: $parameters.selected-app-vserver.attributes.Protocol
<!--NeedCopy-->

パラメータ セクションでコレクション タイプを定義すると、StyleBook ユーザーはデータ ソースとコレクションを選択できます。

コレクションから複数の項目を選択する:

次のパラメータ セクションを使用すると、StyleBook ユーザーはコレクションの複数の項目を選択できます。

パラメータ:
  -  名前: selected-app-vservers
    ラベル: コレクションから app-vservers を選択します
    タイプ: datum[]
    必須: true
    データソース:
      タイプ: 環境
      コレクション: App-virtual-servers
 <!--NeedCopy-->

この例では、datum パラメータを使用してカスタム データ ソース配列を定義します。 ユーザーは、単一のデータ ソースまたは複数のデータ ソースから、「App-virtual-servers」コレクションから 1 つ以上の項目を選択できます。

以下のコード スニペットは、選択した項目とその属性にアクセスする方法を示しています。

コンポーネント:
  -
   名前: lbvserver-comp
   タイプ: ns::lbvserver
   繰り返し:
   繰り返しリスト: $parameters.selected-app-vservers
   繰り返し項目: vserverObj
    プロパティ:
      名前: $vserverObj.attributes.Name
      ipv46: $vserverObj.attributes.IPv46
      ポート: $vserverObj.attributes.Port
      サービスタイプ: $vserverObj.attributes.プロトコル
<!--NeedCopy-->

コレクションデータのフィルタリング:

次のパラメータ セクションでは、StyleBook 定義のカスタム データ ソース コレクションにフィルターを指定する方法について説明します。 これにより、StyleBook ユーザーはフィルタリングされたコレクションから特定のアイテムを選択できるようになります。

パラメーター:
  -  名前: selected-app-vserver
    ラベル: データソースからコレクションを選択します
    タイプ: datum
    必須: true
    データソース:
      タイプ: 環境
      コレクション: App-virtual-servers
      コレクションフィルター:
        プロトコル: SSL
<!--NeedCopy-->

この例では、datum パラメータを使用してカスタム データ ソースを定義します。 環境タイプのデータ ソースを使用して、App-virtual-servers コレクション スキーマからフィルター処理されたデータを取得します。

StyleBook ユーザーが仮想サーバーを選択すると、前のセクションで説明したのと同じ方法で、選択したアイテムの任意の属性にアクセスできるようになります。