ページの先頭行へ戻る
Systemwalker Runbook Automation Studio利用ガイド
Systemwalker

6.4.12 [CSV形式データの抽出]フィルター

列の並べ替えや、列、行、ブロックの選択など運用操作部品の結果やフィルター出力を表として操作します。

[区切り文字]

データを値(列)に分割するための文字を選択します。

  • カンマ  (デフォルト)

  • タブ

  • 半角空白

[囲み文字]

値の囲み文字を以下から選択します。

  • ダブルクォーテーション  (デフォルト)

  • シングルクォーテーション

[最初の行をヘッダとして扱う]

最初の行をヘッダとして扱う場合に選択します。[最初の行をヘッダとして扱う]を選択すると最初の行はソートの対象外となります。デフォルトはオフ。

[ヘッダを削除する]

ヘッダ行を削除する場合に選択します。デフォルトはオフ。

[最初の行をヘッダとして扱う]が選択された場合にのみ選択可能です。

[ソート条件]

"ソート条件" をクリックすると、ソート条件の設定項目が展開(表示)されます。

対象列

列で並べ替えを行うには、[対象列]フィールドにソート対象の列番号(1~)を入力します。[対象列]フィールドが空の場合はソートは行いません。ソート対象の列は最大3つまで指定することができます。対象列1から対象列2、対象列3の順にソートが実行されます。

すべてのフィールドの初期値は空です。初期状態では対象列1のフィールドのみ入力可能です。対象列2および対象列3のフィールドは入力不可(グレーアウト)。対象列1のフィールドに値が入力された場合、対象列2のフィールドが入力可能となります。また、対象列2のフィールドに値が入力された場合、対象列3のフィールドが入力可能となります。

昇順

列を昇順で並び替える場合に選択します。(デフォルト)

降順

降順で並び替える場合に選択します。

数値として扱う

ソートを行う際に値を数値として評価する場合に選択します。数値として評価する値が空または値に数字以外の文字が含まれている場合、フィルターの実行はエラーとなります。デフォルトはオフ。

[抽出する行]

抽出する行の開始位置と終了位置を以下の形式で入力します。デフォルトは空です。

"@{uda:変数名}" または "@{:ノード名:実行結果}" と指定することで、変数や実行結果の値を指定することができます。指定可能な変数のタイプは、STRING/INTEGER のみです。

[変数の参照]ボタンをクリックし、[変数の参照]ダイアログから変数を選択することができます。また、[実行結果の参照]ボタンをクリックし、[実行結果の参照]ダイアログから実行結果を選択することができます。

書式(開始行-終了行)

選択される行

なし

すべての行

1-10

1行目から10行目

-10

1行目から10行目

1-

1行目から最終行

  • ハイフン(-)のみ、またはハイフン(-)が2つ以上ある場合、フィルターの実行はエラーとなります。

  • ハイフン(-)、数字(0-9)以外の文字が入力された場合、フィルターの実行はエラーとなります。

  • "@{uda:変数名}" または "@{:ノード名:実行結果}" が複数指定された場合、フィルターの実行はエラーとなります。

[抽出する列]

抽出する列を以下の形式で入力します。デフォルトは空です。

"@{uda:変数名}" または "@{:ノード名:実行結果}" と指定することで、変数や実行結果の値を指定することができます。指定可能な変数のタイプは、STRING/INTEGER のみです。

[変数の参照]ボタンをクリックし、[変数の参照]ダイアログから変数を選択することができます。また、[実行結果の参照]ボタンをクリックし、[実行結果の参照]ダイアログから実行結果を選択することができます。

書式

選択される列

なし

すべての列

1,3

1列目(最左端)と3列目

1-3

1列目(最左端)~3列目

2-

2列目から最終列(最右端)

-10

1列目(最左端)~10列目

1-3,6-8

1列目(最左端)から3列目と6列目から8列目

  • ハイフン(-)のみ、ハイフン(-)が連続(--)している場合、フィルターの実行はエラーとなります。

  • ハイフン(-)、カンマ(,)、数字(0-9)以外の文字が入力された場合、フィルターの実行はエラーとなります。

  • カンマ(,)のみ、カンマ(,)が連続(,,)している場合、フィルターの実行はエラーとなります。

  • 同じ列が複数指定された場合、最初の指定が有効となります。たとえば、"1-5,2" は、"1,2,3,4,5"と指定した場合と同じになります。

  • 指定された番号の列が存在しない場合、フィルターの実行はエラーとなります。

  • "@{uda:変数名}" または "@{:ノード名:実行結果}" が複数指定された場合、フィルターの実行はエラーとなります。

注意

フィルターのテストにおける注意点

  • [抽出する行]フィールドに "@{uda:変数名}" または "@{:ノード名:実行結果}" を指定した場合、変数(UDA)または実行結果には空文字列が設定されているものとして動作します。※すべての行が抽出されます。

  • [抽出する列]フィールドに "@{uda:変数名}" または "@{:ノード名:実行結果}" を指定した場合、変数(UDA)または実行結果には空文字列が設定されているものとして動作します。※すべての列が抽出されます。

【例1】

入力:

"サーバ名","管理者","連絡先"
"Server-C","User2","1111-2222"
"Server-A","User1","1111-1111"
"Server-B","User3","2222-1111"
"Server-A","User2","1111-2222"

区切り文字:

カンマ

囲み文字:

ダブルクォーテーション

最初の行をヘッダとして扱う:

オン

ヘッダを削除する:

オン

ソート条件(対象列1):

1列目、昇順

ソート条件(対象列2):

2列目、降順

抽出する行:

未入力

抽出する列:

未入力

結果:

Server-A,User2,1111-2222
Server-A,User1,1111-1111
Server-B,User3,2222-1111
Server-C,User2,1111-2222